| name | session-end |
| description | Close a production session — reconcile actual spend, update tracker and state, capture what was learned, and commit. Trigger - /session-end, at the end of every work session. |
Session End
1. Reconcile spend — actual, not estimated
higgsfield account transactions --size 20
higgsfield account status
Write real spend into shot_tracker.json → budget.credits_spent. If actual exceeded the estimate, say so and say why. A silent overrun is how the next estimate ends up wrong too.
2. Update the tracker
Per shot: keyframe file, clip file, job ids, credits, status. Per gate: any that changed, with who approved and when.
3. Capture what was learned
Production knowledge decays fast and is expensive to re-learn. Record anything that would change a future decision:
- Model behaviour discovered the hard way — rate limits, preset interception, silent parameter caps
- Voice and language findings — which voice, which script conventions, measured pacing
- Client preferences and rejections, with the reason
- Cost surprises
4. Update state and hand off
Write production_state.json with the next task, blocking gates, and a handoff note specific enough to resume cold.
5. Commit
git add -A
git commit -m "S<N>: <phase> — <what shipped>
- <accomplishment>
- Credits: <spent> spent, <remaining> remaining"
Verify the directory is a git repo and the scaffolding exists before claiming any of this ran. Never emit a success confirmation for a step that did not execute — a green report for work that did not happen is worse than no report.
