docs: refresh knowledge base for Tiers 4-5 (code repair + triage sentinel) - #138
Merged
Conversation
…sentinel) Update-mode refresh of docs/ + AGENTS.md after the code-repair (evolution/code/) and triage-sentinel (evolution/monitor/) subsystems shipped: - codebase_info / components: expand code/ and monitor/ from 'planned, empty' stubs to their real module trees; add generate_findings_report.py; refresh LOC (~19K) and test counts (100 files / ~1,614); remove the obsolete [darwinian] extra; Tier 4/5 status to shipped with the correct engines. - index: rewrite the intro to all five surfaces; add routing rows for code repair, the sentinel, and the report renderers; list operating_the_sentinel.md. - interfaces: add the Tier-4/5 CLI reference (evolve_code, campaign, monitor). - data_models: add schemas + worked examples for the new on-disk artifacts (code-path gate_decision.json, repair_trace.json, campaign ledger/report, triage_queue.json, lineage.json/dossier.md, suite noise/discrimination sidecars). - workflows: add Workflow 14 (code repair) and Workflow 15 (triage sentinel) with validated mermaid sequence diagrams. - dependencies / AGENTS: correct stale 'Darwinian Evolver' references to the shipped test-feedback-repair engine and fix the evolver-vs-best-of-N figure. Docs-only; no source changes.
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
1 participant
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.
Update-mode refresh of the
docs/knowledge base +AGENTS.mdto cover the twosubsystems that shipped since the last structural-doc pass — Tier 4 (tool-code
repair,
evolution/code/) and Tier 5 (propose-only triage sentinel,evolution/monitor/) — plus the findings-report renderer and measurement instrumentation.What changed
codebase_info.md/components.md—code/andmonitor/expanded from"planned, empty" stubs to full per-module documentation;
generate_findings_report.pyadded; LOC (~19K) and test counts (100 files / ~1,614) refreshed; obsolete
[darwinian]extra removed; Tier 4/5 status → shipped with the correct engines.index.md— intro rewritten to all five surfaces; routing rows for code repair,the sentinel, and the report renderers;
operating_the_sentinel.mdadded to the doc list.interfaces.md— Tier-4/5 CLI reference (evolve_code,code.campaign,monitor).data_models.md— schemas + worked examples for the new on-disk artifacts(code-path
gate_decision.json,repair_trace.json, campaign ledger/report,triage_queue.json,lineage.json/dossier.md, suite noise/discrimination sidecars).workflows.md— Workflow 14 (code repair) and Workflow 15 (triage sentinel) withmermaid sequence diagrams (both validated).
dependencies.md/AGENTS.md— corrected stale "Darwinian Evolver" references tothe shipped test-feedback-repair engine; fixed the evolver-vs-best-of-N figure to match
the committed evidence (evolver 6/23 vs best-of-N 8/23); resolved an internal
contradiction in AGENTS.md (overview/tree/gotcha called Tiers 4-5 stubs).
Docs-only — no source changes.