Skip to content

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

Part of test-evidence — Every verifiable claim and widget resolves to revision-bound test evidence, on every surface.

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

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.

Searches the titles and descriptions of every page this site publishes.