I1964 — The evidence reference is documented and held to the tree
Rewrite docs/EVIDENCE.md as the reference of the finished model, with the pipeline drawn in mermaid and a case named on every row of the matrix, and hold it to the tree with a case; cite ADR 0068, 0080 and 0087 structurally once they have landed.
BLOCKED wave 7 · p2 · implementation profile · parallel safe
Blocked. This issue cannot start until I1962, I1963 are done. The status is derived from that, not declared.
Objective
Rewrite docs/EVIDENCE.md as the reference of the finished model, with the pipeline drawn in mermaid and a case named on every row of the matrix, and hold it to the tree with a case; cite ADR 0068, 0080 and 0087 structurally once they have landed.
Why
docs/EVIDENCE.md is shared by section while the work runs, so it can describe the finished model only after the slices land, and a reference that names what the code no longer declares is a stale projection.
Current state
docs/EVIDENCE.md describes the ledger and its states; its sections are edited by I1948 and I1949 while the work runs.
Desired state
The reference names every command, capability, state and file the code declares for evidence, draws the pipeline in mermaid, and a case fails when it names something the tree does not have or omits something it does.
Scope
- docs/EVIDENCE.md
- docs/COVERAGE.md
- docs/README.md
- docs/CI.md
- docs/GITHUB_PAGES_ARCHITECTURE.md
- docs/CLAIMS.yaml
- docs/claims
- test/cases
- .ai/repo/features/evidence.md
- .ai/repo/features/coverage.md
- .ai/repo/adrs/0087-evidence-is-indexed-by-subject-and-judged-at-the-presented-revision.md
- .ai/repo/evidence/README.md
- .ai/repo/doc-command-baseline.txt
Out of scope
- A diagram in box art: a relationship is drawn in mermaid
- Accepting ADR 0087, which is the owner's act
Dependencies
- I1962BLOCKED The evidence gates read subject findings and widgets
- I1963BLOCKED Evidence is tested end to end
Acceptance criteria
- The reference names what the code declares, and the case fails on a name the tree does not have
- Every row of the matrix names a case
- The pipeline is a mermaid diagram and passes diagram-check
Validation
- bash test/run.sh 528_the_evidence_reference_is_held_to_the_tree
- scripts/ci/diagram-check
Evidence required
- reference_held_to_the_tree
Evidence
None recorded. Every token above needs a command or an artifact behind it before this issue can be completed; narrative is refused.
Timeline
- started
- —
- verified
- —
- completed
- —
Those three fields, the evidence above and the state of the dependencies are all the status is made of. There is no status field to disagree with them.
Canonical record: .ai/repo/project/issues/I1964.yaml. Read it back with majordomus plan show I1964.