Grimterface: Update
Check whether the local copy of Grimoire's Tome is current, show the user what's new, and update safely.
Workflow
- From the Tome checkout, inspect state without changing anything:
git remote -vandgit fetchto see upstream.git statusandgit log HEAD..@{u} --onelineto see how far behind the checkout is and whether there are local changes.
- Read
patchNotes.md(upstream version if behind) and summarize what's new since the user's version in a few lines. - Ask whether the user wants to update. If yes:
- Clean checkout, no local changes →
git pull --ff-only. - Local changes present → explain them first; offer to stash or branch. Never discard user edits.
- Clean checkout, no local changes →
- After updating, call out anything that needs a follow-up: new skills to expose, changed
AGENTS.mdconventions, new council members, or migration notes inpatchNotes.md. - If skills are symlinked into a harness folder, new skills are picked up by adding new symlinks — offer to add them for skills the user wants.
Rules
- Non-destructive git only: no
reset --hard, nocheckout --force, no deleting local branches or edits. - If fast-forward is impossible, explain why and present options; do not resolve conflicts unprompted.
- Respect local mutations: users are encouraged to customize skills, so treat their diffs as intentional.