# 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.