Summary

• revert commit 386bb0c61806d89b1a8e8fecc78cf42260910c4f from PR fix: don't auto-create HEARTBEAT.md on workspace init #12027
• restore previous ensureAgentWorkspace behavior that writes HEARTBEAT.md during workspace init
• keep onboarding behavior consistent: HEARTBEAT.md needs to exist on workspace init as part of onboarding
• remove the fix: don't auto-create HEARTBEAT.md on workspace init #12027 changelog entry added by that PR

Verification

• pnpm test src/agents/workspace.e2e.test.ts (fails because repo test config excludes *.e2e.test.ts)
• pnpm check (currently fails on existing src/gateway/tools-invoke-http.ts TypeScript errors on main)

Greptile Overview

Greptile Summary

This PR reverts commit 386bb0c6 from #12027, restoring the original ensureAgentWorkspace behavior that auto-creates HEARTBEAT.md during workspace initialization.

Key changes:

• Restores heartbeatPath parameter in the return type of ensureAgentWorkspace
• Re-enables loading and writing the HEARTBEAT.md template during bootstrap
• Includes heartbeatPath in the isBrandNewWorkspace check
• Removes the test that verified HEARTBEAT.md was NOT created
• Removes the changelog entry from fix: don't auto-create HEARTBEAT.md on workspace init #12027

The template content (after frontmatter stripping) contains only markdown headers/comments, making it "effectively empty" per isHeartbeatContentEffectivelyEmpty(), so heartbeat API calls will still be skipped as intended. This revert appears to restore the correct default behavior where users get a documented template file with instructions.

Confidence Score: 5/5

• This PR is safe to merge - it's a clean revert that restores tested, documented behavior
• This is a straightforward revert of a recent commit that restores the previous workspace initialization behavior. The changes are minimal, well-contained, and restore documented functionality. The template that gets written is effectively empty (only contains markdown headers/comments), so the heartbeat will be correctly skipped until users add actual tasks. The revert properly undoes all aspects of the original PR including code changes, tests, and changelog entries.
• No files require special attention

_{Last reviewed commit: cd52355}