| name | pharo-image-git-handoff |
| description | Reconcile live Pharo, Iceberg, Tonel, and Git state before exporting, reviewing, committing, or pushing image-side changes. Use for dirty or detached Iceberg state, linked worktrees, package-membership mismatches, and image-to-Git delivery. |
Pharo Image Git Handoff
Image objects, Tonel files, Iceberg working copies, and Git refs are distinct.
A clean Git worktree does not prove the image is clean, and an Iceberg diff does
not prove files changed on disk.
Workflow
- Inspect the image repository with Pharo MCP tools: identity, location,
branch/head, source directory, package membership, and modified packages.
- Inspect disk with read-only Git commands:
git status --short --branch,
git diff, and git remote -v.
- Export only for an intended Tonel/Git handoff. Verify repository identity and
inspect the image-side change list first.
- After export, recheck Iceberg and Git. Review every changed Tonel, project,
and documentation path.
- Commit only the intended diff. Push only when explicitly requested or
clearly approved.
Stop Before Mutation
Stop and diagnose detached or missing heads, wrong branches/remotes, duplicate
repository names, source-directory or package-membership mismatches, linked
worktree confusion, and unexplained disagreement between Git and Iceberg.
Adopt the current Git HEAD only when the image contents are known to match it.
Ask the user before resolving real divergence or discarding image changes.
Report
Report image repository state before and after export, why export was needed,
Git branch/status and diff summary, checks run, and unresolved ambiguity.
