Skip to content

I1011 — The coverage matrix reports evidence, and never a green cell without one

Generate a matrix showing, for every capability, whether it is documented, tested, enforced, benchmarked and exposed, where each cell resolves to an artifact or a relation rather than to a claim.

READY wave 2 · p0 · deep-work profile · parallel safe

Part of capability-graph — One capability graph, two projections, and no second inventory of what this repository can do.

Ready. Every dependency is done, so majordomus plan start I1011 will be accepted.

Objective

Generate a matrix showing, for every capability, whether it is documented, tested, enforced, benchmarked and exposed, where each cell resolves to an artifact or a relation rather than to a claim.

Why

This is the view that makes the graph worth building: it turns the question of what is actually finished into something a person can read in one screen. A cell that is green because metadata said so would make it worse than useless.

Current state

Benchmark coverage exists for capabilities. Documentation, tests and enforcement have no coverage view at all.

Desired state

Each cell resolves to a named artifact — a document, a test, a rule, a benchmark case — and an unresolved claim is reported as missing rather than shown as satisfied.

Scope

  • apps/majordomus-cli/src/capability/builtin/health.rs

Out of scope

  • A status a contributor can declare without an artifact behind it
  • Demanding evidence from purely descriptive metadata that has no behaviour to test

Dependencies

What waits on this

Acceptance criteria

  • Every filled cell names the artifact that supports it and can be followed to it
  • A relation that claims evidence but does not resolve is reported as a gap, and the report says which end failed
  • The policy for what evidence a kind requires is data, not a condition in the renderer, and a descriptive kind is not asked for a behavioural test
  • The matrix is available in both projections and in machine-readable form

Validation

  • cargo test --workspace --all-features
  • bin/majordomus doctor

Evidence required

  • coverage_matrix
  • no_false_green

Evidence

None recorded. Every token above needs a command or an artifact behind it before this issue can be completed; narrative is refused.

Risk

A matrix that is mostly empty on the first run will be read as an indictment rather than a baseline. It is a starting measurement, and saying so is part of shipping it.

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/I1011.yaml. Read it back with majordomus plan show I1011.