mopac-pmo/archive/TASK-20260828-1900-study-crush.md

TASK: Reference study — crush internals (PORTING-NOTES-crush.md)

Objective

Study /home/reachableceo/projects/meta/MOPAC/reference/crush. Produce /home/reachableceo/projects/meta/MOPAC/harness/docs/PORTING-NOTES-crush.md.

Deliverables (notes file, <=180 lines, dense, no fluff)

1. MCP plumbing: config format, stdio/http transports, tool registration — what to port to Go.
2. Session/persistence model: session files, --continue, resume semantics.
3. Provider layer: how providers.json/crush.json merge, model routing, retries/stream handling (note where stream-truncation errors would surface).
4. Headless mode: how crush run/--print works, exit codes.
5. OAuth flows: where they live (deferred for v1 but map the code path).
6. Top 10 packages/files worth reading in detail during build; top 5 gotchas.