type: meta

slug: quietcontext-token-budget

base_branch: quietcontext

gate0_mode: strict

preset: inline


type: goal

text: Ship a Codex-focused six-tool QuietContext runtime with hard MCP token budgets.


type: methodology

text: Docs first; then root-cause-driven TDD; preserve raw data in sandbox or FTS5.


type: intent

text: Keep only context-saving capability while eliminating plugin-generated token cost and narration.


type: direction

verbatim: also fix 1-8 after you finished with the docs


type: task

seat: coder

tier: medium

desc: Read docs/plans/2026-07-13-quietcontext-token-budget.md Task 1 (Canonical documentation) for the full contract. Canonicalize QuietContext docs and metadata. Acceptance: npm run test:quiet -- tests/quietcontext-surface.test.ts. Commit only: README.md, docs/, package.json, .codex-plugin/plugin.json, configs/codex/config.toml, .mcp.json.codex.example.


desc: Read docs/plans/2026-07-13-quietcontext-token-budget.md Task 2 (Token-budget regression tests) for the full contract. Add failing public-boundary tests. Acceptance: new assertions fail for expected pre-fix behavior. Commit only: tests/quietcontext-runtime.test.ts, tests/quietcontext-surface.test.ts, tests/quietcontext-token-budget.test.ts.


tier: high

desc: Read docs/plans/2026-07-13-quietcontext-token-budget.md Task 3 (Quiet runtime) for the full contract. Implement six-tool registry, budgets, deduplication, and references. Acceptance: npm run test:quiet. Commit only: src/server.ts, src/store.ts, src/types.ts, focused helpers.


desc: Read docs/plans/2026-07-13-quietcontext-token-budget.md Task 4 (Economics benchmark and release gate) for the full contract. Measure full MCP economics and define authoritative gate. Acceptance: npm test && npm run benchmark:quiet. Commit only: package.json, benchmark and test configuration files.


desc: Read docs/plans/2026-07-13-quietcontext-token-budget.md Task 5 (Final verification) for the full contract. Regenerate bundles and run complete gate. Acceptance: npm run typecheck && npm run build && npm test && npm run benchmark:quiet. Commit only: generated bundles.