Problem
Crane PR update comments currently identify the pushed commit, but they do not say what the new commit did.
Example from #86:
Commit pushed: 10dd58f
Commit pushed: 5b4817b
The PR body has a useful iteration summary, but later PR update comments require reviewers to open the commit or diff to understand the new work. The comment should carry the same review-level context as the accepted iteration: what was changed, what milestone moved, and the validation/score result when available.
Desired behavior
When Crane pushes an accepted iteration commit to an existing PR, the PR update comment should include a short summary of the new commit, not only the SHA.
Suggested shape:
[bot] **Iteration 13 accepted** -- [Crane run](<run-url>)
- **Commit**: [`5b4817b`](<commit-url>)
- **Change**: Ported `internal/install/cache_pin.go` and source reference types.
- **Milestone**: Milestone 8 -- `install/` continued
- **Score**: 0.72 (best: 0.72, delta: +0.06) <!-- if available -->
- **Tests/parity**: 218/302 passing <!-- if available -->
If only a commit subject is available, include that subject. If the commit body has bullets, include up to a small bounded number of them. If the workflow also pushes a ci: trigger checks commit, ignore that commit unless it is the only new commit.
Implementation sketch
-
Update .github/workflows/crane.md in Step 5c (Accept) so existing-PR updates explicitly require a rich PR comment.
- Do not rely on the automatic
push-to-pull-request-branch safe-output comment as the only reviewer-facing update.
- After the branch push, emit an
add-comment safe output targeted at the PR with the accepted iteration summary.
- Keep the existing PR body update, but make the per-iteration comment mandatory and concrete.
-
Define one shared summary source for PR body, PR comment, migration issue comment, and repo-memory history.
- Prefer the accepted iteration summary already written to the state file / migration issue.
- Include: iteration number, milestone/current focus, concise change summary, commit SHA, run URL, score/delta/progress/parity when available, and fix-attempt count when greater than zero.
-
Strengthen the commit-message guidance in Step 5a so the commit contains enough structured detail to summarize later.
- Subject remains
[Crane: {migration-name}] Iteration <N>: <short description>.
- Body should include a compact
Changes: bullet list before Run: {run_url}.
- This gives the comment generator a fallback when score/progress fields are unavailable.
-
Bound the generated comment.
- Keep it under roughly 10 bullets or 1,000 characters.
- Never paste full diffs or long test logs.
- Link to the commit and workflow run for deeper inspection.
-
Recompile generated artifacts.
- Run
gh aw compile after editing .github/workflows/crane.md.
- Run
apm compile per repo instructions.
- Commit the regenerated
.github/workflows/crane.lock.yml and APM integration files together.
Acceptance criteria
Problem
Crane PR update comments currently identify the pushed commit, but they do not say what the new commit did.
Example from #86:
Commit pushed: 10dd58fCommit pushed: 5b4817bThe PR body has a useful iteration summary, but later PR update comments require reviewers to open the commit or diff to understand the new work. The comment should carry the same review-level context as the accepted iteration: what was changed, what milestone moved, and the validation/score result when available.
Desired behavior
When Crane pushes an accepted iteration commit to an existing PR, the PR update comment should include a short summary of the new commit, not only the SHA.
Suggested shape:
If only a commit subject is available, include that subject. If the commit body has bullets, include up to a small bounded number of them. If the workflow also pushes a
ci: trigger checkscommit, ignore that commit unless it is the only new commit.Implementation sketch
Update
.github/workflows/crane.mdin Step 5c (Accept) so existing-PR updates explicitly require a rich PR comment.push-to-pull-request-branchsafe-output comment as the only reviewer-facing update.add-commentsafe output targeted at the PR with the accepted iteration summary.Define one shared summary source for PR body, PR comment, migration issue comment, and repo-memory history.
Strengthen the commit-message guidance in Step 5a so the commit contains enough structured detail to summarize later.
[Crane: {migration-name}] Iteration <N>: <short description>.Changes:bullet list beforeRun: {run_url}.Bound the generated comment.
Recompile generated artifacts.
gh aw compileafter editing.github/workflows/crane.md.apm compileper repo instructions..github/workflows/crane.lock.ymland APM integration files together.Acceptance criteria
10dd58fcomment would say that Iteration 12 portedinstall/context.goandinstall/request.go.5b4817bcomment would say that Iteration 13 portedinstall/cache_pin.goand source-reference types.