docs: converge repo context for AI agents (audit-driven tidy) - #358
Merged
Conversation
- Merge parallel-session docs WIP after quality review: docs/decisions
(ADR-0001..0015 incl. 3 new: TTFB-only timeout, atomic RPM admit,
plural tool_calls dialect), docs/architecture (5), docs/{api,
development,maintenance,operations,security,testing,upstream},
backend/internal/archtest (dependency-matrix gate), 21 package
CONTRACT.md, 2 additive test files.
- Fix review findings: modelcat fallback id, cli egress dep, registry
test-only edge, telemetry/ratelimit API sections; ADR-0004 bridge
store demoted to future work (#348); ADR-0010 PR-flow; ADR-0006/0011
symbol names + snapshot count; BOUNDARIES matrix deduped to
DEPENDENCIES; INVARIANTS gains precedence + 3 IDs (PROTO-006,
UP-005, TOKEN-006).
- AGENTS.md: entrypoint trim (convert/server maps to one-liners),
protected-trunk workflow, canonical task verify, current ground
truth (turn_spend terminal, failover knob, TTFB-only, atomic RPM,
plural dialect, loopback-only open dashboard).
- Taskfile.yml: canonical task verify / verify:full gates (proven
green locally).
- Secret scan: no known token patterns in tracked files.
The coverage test targets the parallel session's unmerged toolmap.go mappings (Kimi-CLI/Crush rows fail against main's toolmap). It stays untracked in the tree for its owning session to merge together with the implementation; CI on a clean tree is the truth.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Audit-driven convergence of the repo's documentation systems (4 parallel scouts reviewed every file against live code ground truth). No behavior changes; 37 deleted lines are duplications with content preserved at the canonical home.
Merged parallel WIP (reviewed, factual errors fixed): docs/decisions (ADR-0001..0015), docs/architecture (5), docs/{api,development,maintenance,operations,security,testing,upstream}, archtest gate, 21 package CONTRACT.md, 2 additive test files.
Fixes applied: modelcat fallback id; cli egress dep; registry test-only edge; telemetry/ratelimit API sections; ADR-0004 bridge-store demoted to #348 future work; ADR-0010 protected-trunk flow; ADR-0006/0011 symbols + snapshot count; BOUNDARIES matrix deduped; INVARIANTS precedence + PROTO-006/UP-005/TOKEN-006; AGENTS.md trim + current ground truth; Taskfile verify gates.
Verification: task verify green locally; secret scan clean; backend suite green on this tree.