Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 require-ready-label-and-ci

Greptile Summary

This PR adds release-ledger skeleton emission to the generator pipeline: WriteCLIManifest now also writes blank .printing-press-release.json and CHANGELOG.md siblings on first print, and preserves them on reprint. The publish skill's copy step is replaced with a staging + atomic mv pattern that saves existing ledger files to a temp directory before overwriting, then restores them.

• internal/pipeline/climanifest.go: New CLIReleaseManifest struct + WriteReleaseLedgerSkeleton helper that writes the blank manifest/changelog only when absent; WriteCLIManifest and (indirectly, via the same call path) RefreshCLIManifestFromSpec both pick this up.
• skills/printing-press-publish/SKILL.md: Old rm -rf … && cp -r … replaced with mktemp swap-dir + ledger preservation loop + atomic mv; a trap … EXIT cleans up both temp dirs on failure.
• Templates, golden fixtures, AGENTS.md, skills docs: Consistent "Release Ledger" guidance added across all generated and reference files.

Confidence Score: 5/5

Safe to merge — the generator and publish skill changes are well-scoped, tests cover both the fresh-print and reprint paths, and all golden fixtures are updated consistently.

The skeleton-writing logic in WriteReleaseLedgerSkeleton uses an existence check before writing, so reprints leave existing changelog history untouched. The publish skill's swap-dir + atomic mv correctly stages the full CLI (with preserved ledger files) before touching the live publish-repo directory. The contracts tests lock down the new shell patterns. No credential-path reads were introduced.

No files require special attention.

Important Files Changed

sequenceDiagram
    participant G as Generator
    participant FS as Filesystem
    participant P as Publish Skill
    participant LIB as printing-press-library

    G->>FS: write .printing-press.json
    G->>FS: stat .printing-press-release.json
    alt fresh print (file absent)
        G->>FS: write skeleton .printing-press-release.json
        G->>FS: write skeleton CHANGELOG.md
    else reprint (file present)
        G-->>FS: skip, preserve existing ledger files
    end

    P->>FS: find existing ledger files in publish repo
    P->>FS: save to RELEASE_LEDGER_TMP
    P->>FS: cp -R staged CLI to PUBLISH_SWAP_DIR
    P->>FS: restore ledger files into PUBLISH_SWAP_DIR
    P->>FS: rm -rf old slug dir
    P->>FS: mv PUBLISH_SWAP_DIR to DEST_CLI_DIR (atomic)
    P->>FS: rm -rf RELEASE_LEDGER_TMP and clear trap
    LIB->>FS: post-merge workflow stamps version and released_at

_{Reviews (2): Last reviewed commit: "feat(pipeline): emit CLI release ledger ..." | Re-trigger Greptile}

Merge Queue Status

• ✅ Entered queue — 2026-06-08 05:37 UTC · Rule: default
• ✅ Checks passed · on draft merge queue: embarking main (3a6d771) and #2859 together #2862
• ✅ Merged — 2026-06-08 05:48 UTC · at 0a3a0a1c0faa57815859f16df07bc195a1151384 · squash

This pull request spent 10 minutes 22 seconds in the queue, including 10 minutes 8 seconds running CI.