Record index
done.index.toml
Completion receipts, namespace DN, at
.working/toml/done.index.toml.
About
A done record is a durable completion receipt, created in its single terminal
state recorded and immutable from birth. It links receipt_of to the
backlog item whose ratified completion it witnesses; a standalone receipt is legal only for
imported history with provenance.
Why
Completion needs its own artifact. If "done" were only a state flag on the backlog item, the moment of completion, who ratified it, and what it covered would be reconstructable only from history. A separate immutable receipt makes each completion a first-class, linkable fact.
Description
The shared index shape (schema = 1 plus [[record]] rows) with the
standard envelope and no type-specific extra fields. Single state recorded, no
transitions, and never proposable: a factual receipt awaits no ratification, so it carries no
/proposed qualifier.
How it works
A ratified done on a backlog item creates the receipt in the same act, one to
one. Receipts, like all records in unqualified terminal states other than the worklog, may
rotate to the calendar-year archive on manifest-declared thresholds; rotation is enumerated
relocation, never deletion, so every receipt remains resolvable forever.
Generated view
DONE.md, composed from this index, plus the optional
DONE-INDEX.md mirror; both byte-drift-gated.
Value
An audit-ready record of what was finished, when, and on whose ratification. Because a receipt exists only for a ratified completion, the DONE view helps prevent proposed or asserted completion from reading as settled fact.
Usage
- Created by:
opf init(empty index); receipts by the ratified-done transition; the importer for migrated history, with provenance. - Updated by: nothing; records are immutable. Rotation relocates aged receipts to the archive.
- Read by:
opf render(DONE.md and the mirror);opf doctor(schema, uniqueness, the one-to-one receipt link).