items.all

Hold every item of a list to a bar: ticked, done or N/A, specific, cited.

Captain: A ticked box is a promise. Show me the work behind it.

Quick reference

Examples

items.all=checked

Require every box to be checked — e.g. a pre-merge checklist that must be fully completed. An unchecked item ending in (N/A: <reason>) (the item does not apply here) counts as honestly disposed.

Every box ticked passes

contract.mdv.md
<!-- mdv: section required -->
## Checklist
<!-- mdv: list items.all=checked -->
- [ ] Life-support scrubbers checked
- [ ] Mission log transmitted
document.md
## Checklist

- [x] Life-support scrubbers checked
- [x] Mission log transmitted

✓ passes

An unticked box is flagged

contract.mdv.md
<!-- mdv: section required -->
## Checklist
<!-- mdv: list items.all=checked -->
- [ ] Life-support scrubbers checked
- [ ] Mission log transmitted
document.md
## Checklist

- [x] Life-support scrubbers checked
- [ ] Mission log transmitted

✗ unchecked-items warn · line 4

items.all=done-or-na

Require every item to be honestly disposed — done (checked, with evidence) or N/A (the item does not apply, with a reason). Work not done stays unticked as (not done: <reason>) and fails. A bare tick is an error; evidence too vague to check is a warning. The recommended successor to items.all=checked.

Evidence and an N/A reason pass

contract.mdv.md
<!-- mdv: section required -->
## Checklist
<!-- mdv: list items.all=done-or-na -->
- [ ] Tests run
- [ ] Screenshots
document.md
## Checklist

- [x] Tests run: `npm test`, 412 checks pass, 0 fail.
- [ ] Screenshots (N/A: CLI-only change)

✓ passes

A bare tick is flagged

contract.mdv.md
<!-- mdv: section required -->
## Checklist
<!-- mdv: list items.all=done-or-na -->
- [ ] Tests run
- [ ] Screenshots
document.md
## Checklist

- [x] Tests run
- [ ] Screenshots (N/A: CLI-only change)

✗ tick-without-evidence error · line 3

items.none=bare-tick

Forbid bare ticks: a checked item must record evidence (a bare tick is an error, vague evidence a warning), while an honest unchecked item, with or without (not done: <reason>), still passes. The gentler sibling of items.all=done-or-na.

<!-- mdv: section -->
## Changes
<!-- mdv: list items.none=bare-tick -->
- [x] Tests added or updated
  - Evidence: added `tests/retry.test.ts`; `bun test` reports 3 pass.
- [ ] Docs updated
<!-- mdv: endlist -->
<!-- mdv: endsection -->

items.all=@evidence/specific

Require every list item to be specific and checkable — verifiable claims, not token gestures. Heuristic, so it warns by default; harden with error=vague-evidence.

A checkable claim passes

contract.mdv.md
<!-- mdv: section required -->
## Changes
<!-- mdv: list items.all=@evidence/specific -->
- Ran the suite
document.md
## Changes

- Ran `npm test`; 412 nav checks pass, 0 fail.

✓ passes

A vague claim is flagged

contract.mdv.md
<!-- mdv: section required -->
## Changes
<!-- mdv: list items.all=@evidence/specific -->
- Ran the suite
document.md
## Changes

- Looks fine.

✗ vague-evidence warn · line 3

items.all=@evidence/cited

Require every list item to carry a resolvable citation (link, reference, or footnote). Deterministic, so it errors by default; soften with warn=missing-citation. A true-but-uncitable claim ends with (attested: <who/how>) instead.

<!-- mdv: section -->
## Changes
<!-- mdv: list items.all=@evidence/cited -->
- Antenna latency dropped after packet batching was enabled [1].
<!-- mdv: endlist -->
<!-- mdv: endsection -->

See also: Evidence lists

On this page