test: cover the adr/ decision-record contract (tests/adr-contract.test.mjs)

[kubestellar-hive]

Test Improvement

Adds tests/adr-contract.test.mjs — the first test that reads adr/ at all. It asserts the contract between adr/README.md's index table and the adr/NNNN-*.md records:

• every indexed row links to a file that exists, and to one named for that row's number
• index numbers are unique
• index Status matches each record's - **Status**: header; index Title matches its H1
• every record declares a parseable - **Date**: and a Status in {Proposed, Accepted, Rejected, Superseded, Deprecated}
• every record heads itself with its own file number ("ADR 0002:" in 0002-*.md)
• every relative ./-link between files in adr/ resolves

Header assertions apply to files that head themselves as an ADR or are linked from the index, so supporting drafts filed alongside a record are not held to the ADR header block.

Two assertions are { todo: true }

main already violates them: adr/0001-stakeholder-outreach-draft.md takes the 0001- prefix without being ADR 0001, so two files claim number 0001 and one is absent from the index. each ADR number is claimed by exactly one file and every number-prefixed ADR file is listed in the index are therefore marked todo — the suite stays green, the deviation is recorded in the test file, and the fix is filed as #281 with the exact remediation. Dropping the { todo: true } flags is a one-line-each change once #281 lands; that is a docs rename, outside this lane.

Verification

• npm run test:unit: 68 tests, 66 pass, 0 fail, 2 todo (was 55 pass / 0 fail).
• Mutation-checked: flipping an index Status, and repointing an index link at a nonexistent file, each fail the expected assertions (4 failures across the two mutations); adr/README.md restored, git diff --stat clean.
• npx prettier --check clean.
• No dependency, no lockfile change, no production code.

Coverage evidence

• Unit: npm run test:unit -- --experimental-test-coverage, local clone of cncf/endusers at parent revision 00b44df after npm ci, 2026-09-18. Baseline: 55 tests, adr/ read by no test (grep -rn adr tests/ empty). This is a content-contract suite, so it adds no scripts/ line coverage.
• End-to-end: unavailable — this repository has no end-to-end or browser suite and publishes no coverage artifact from any suite (tracked in [quality] CI publishes no coverage evidence, so coverage findings cannot be verified #186). No claim is made that this path lacks end-to-end coverage.

Disjointness

Claims exactly one new file, tests/adr-contract.test.mjs, and the adr/ content cluster. No other open PR touches adr/ as a test subject: the open data-contract test PRs cover data/milestones.json (#235), data/projects-born.json (#239), data/community-roster.json (#241), data/members.json/awards.json (#253), data/community-people.json (#257), data/architectures (#260), blog/ frontmatter (#270), docusaurus.config.js/sidebars.js (#275) and package.json/CI wiring (#278). #167 edits ADR content (status/prose) but changes no filename and no index structure; the assertions here are parity assertions, which hold across that edit.

Related Issue

Closes #280

---

Filed by quality agent (hold-gated mode). Human review required.

— hive: agent=quality backend=copilot model=claude-opus-5

[kubestellar-hive]

Important

Held for human review by the hive's ACMM level gate.

This PR was opened by the "quality" agent while Hive policy required a human checkpoint for that agent. Non-outreach agents are held at ACMM L3–L5; the outreach agent is always held because it publishes project-facing communication.

Hive will automatically remove the hold label once current policy no longer requires a level hold for "quality". If this is an outreach PR, a human must review it and remove the label.