codex-usage-tracker AGENTS.md

Codex Usage Tracker Instructions

Product and authority

This repository is replacing the released 0.28 spike with a clean, local, Codex-first workflow-observability kernel. The kernel owns exact facts, identity, ordering, deduplication, calculations, freshness, coverage, allowance, valuation, bounded queries, and stable evidence. The consuming model owns interpretation, hypotheses, prioritization, caveats, and recommendations.

Start at docs/INDEX.md. The only implementation roadmap is docs/roadmap/AGENT_FIRST_CLEAN_CUTOVER.md; its checkbox ledger is docs/roadmap/TASK_PACKETS.md. The remaining dependency graph, delegation readiness, ownership locks, and allowed parallelism are controlled by docs/roadmap/REMAINING_EXECUTION_PLAN.md. Each delegable unit has one file under docs/roadmap/tasks/. Archived documents and historical release notes are evidence, not authority.

CK-07C additionally owns docs/architecture/PLAN_OPERAND_AND_FACT_CONTRACT.md and the versioned config/agent-kernel/plan-operand-contract-v1.json. CK-07D merged the effective-dated rate-card valuation correction at e49531b. CK-07E is the admitted test-only prerequisite for independent structural and query-only database-v1 fact adapters. CK-07A consumed CK-07B through CK-07E and is complete with 80 / 80 structural-v2 variants requalified. CK-08 is complete on merge with all 21 plans and 42 variants qualified as fact-backed mechanism evidence. A downstream architecture audit found that the expected-answer lane shares production evaluation, runtime keyset pagination follows complete Python materialization, projection classification combines execution stages, and publication/evidence scale plus replacement maintainability need corrective proof. CK-08R0 froze corrective-gates-v1; CK-08R2 is complete and CK-09 remains blocked. CK-08R1A froze corrected answer meaning and recursive closure; R1C is accepted at exact main fb0c578, and R1B is accepted at exact main 9e9332b3. Final R1 requalification passed hosted CI in PR #439, squash-merged, and was exact-main verified at 0832b854. CK-07R1's separate post-terminal roadmap completion makes CK-08R4 the sole Ready packet while CK-08RG and CK-09 remain blocked. CK-QG1A removed the two R2 page-executor complexity findings without changing behavior or the frozen baseline and is accepted at exact main 30983d4; QG1 PR #392 passed hosted CI, squash-merged, and was exact-main verified at 68050b93. CK-07R1A corrected the exact hosted Python 3.14 lifecycle-tail blocker; the linked CK-07R1A0 authorities, including argv correction, are merged through 479cbdb. Coordinator disposition and clean exact-main reapplication from 6c08ecd9 derived the exact 66c015de… / f108dbb4… / 4c514889… candidate cohort. The versioned shared-successor-overlay-authority-v1 preserves accepted CK-08R1B, CK-08R1, and CK-QG1 bytes while admitting only that complete cohort as CK-07 worker_prequalification. The sole CK-07R1 v2 launch is terminal failed_after_launch; its token is consumed and non-refundable, no planner-valid receipt or output exists, and no retry, restart, replacement, or further invocation is permitted. PR #448 merged the exact deterministic planner-selected small/large correction and immutable v1/v2 terminal evidence at exact main 1d0466b1. The additive lifecycle-post-terminal-completion-authority-v1 accepts that merged deterministic evidence only for CK-07R1 roadmap dependency completion. It permanently records runtime_acceptance=not_claimed, planner-valid receipt absent, post_single_run unavailable, and final_accepted unavailable. It neither reclassifies the failed run nor changes production semantics. CK-08R4 must independently measure current merged publication behavior and must not claim the missing CK-07R1 runtime acceptance. PR #394 remains stale failed read-only. Retained R3 evidence proved the EvidenceService outer query physically unbounded; CK-08R3A owns that isolated fix and R3 awaits its accepted, merged, exact-main-verified result.