Readable MCP resource responses — verified landing
The progressive response contract passed compatibility, typed-resource, pagination, input-boundary, payload-size, and full-suite verification.
Measured payloads
| Resource | Legacy compact JSON | Summary compact JSON | Reduction | Verdict |
|---|---|---|---|---|
| Plan | 4,241 bytes | 564 bytes | 86.7% | Pass |
| Sprint | 3,668 bytes | 576 bytes | 84.3% | Pass |
| Discovery | 56,470 bytes | 4,747 bytes | 91.6% | Pass |
| Audit | 18,057 bytes | 481 bytes | 97.3% | Pass |
Measurements use deterministic UTF-8 compact JSON with sorted keys against the final post-landing Reckon checkout. Summary fixtures also enforce absolute byte ceilings and proportional reductions for populated synthetic resources.
Contract verification
- Legacy
read_plan(project, slug)andaudit(project)responses remain unchanged when progressive arguments are omitted. - Typed plan, archived plan, sprint, project discovery, and audit selectors return one stable resource identity and one version token.
- Full prompts are absent from summaries and require an explicit detail/history opt-in.
- History, discovery, and audit detail pages use deterministic opaque cursors with a default limit of 25 and maximum limit of 100.
- Unsafe or oversized selectors and cursors return bounded structured errors before filesystem or decoder work.
- Storage and response schemas describe all typed resources and every summary, detail, history, raw, and schema payload.
- Sprint cards share the bounded discovery stream and named legacy project-state reads project safely from the canonical index.
- Edit success and version-conflict results name the human action and affected typed resource while retaining stable machine fields.
- FastMCP introspection confirms the new tool arguments are optional, preserving existing client schemas.
Test evidence
| Gate | Result |
|---|---|
| Focused progressive-view tests | All passing |
| Malformed selector/cursor and prerequisite-blocking regressions | 2 passed |
| Complete repository suite | 1,373 passed in 28.53 s |
| Ruff lint | Clean |
| Ruff format | Clean |
| Implementation commits | 8cc940f, c9e14f2 |
No compatibility failures, schema drift, typed-directory regressions, or concurrency-test regressions were observed.