reference
Living

supersession

A decision that changes is recorded as a new entry, linked to the one it replaces, never edited or deleted in place.

Vinculum’s graph doesn’t rewrite history when a decision changes; it adds to it. A correction becomes its own entry, connected by a typed edge to the one it replaces, and the earlier entry stays on record, marked superseded rather than erased. A chain of three entries shows what that looks like when the rule itself gets used wrong, caught, and fixed in the open (#12977, #13058, #13059).

§01 · append-only, not overwritten

A decision that changes gets a new entry, not a rewritten one.

Most systems handle a changed decision by editing the record: the old text is overwritten, and whatever reasoning produced it goes with it. Vinculum’s graph treats a changed decision as a new event instead. The correction is written as its own entry, linked to the one it replaces by a typed edge, and the earlier entry stays in the graph, marked superseded rather than removed.

Read it back later and both entries are still there: what was believed, and what replaced it. That holds cleanly when an entry carries one fact. Entry #8972 carried two.

§02 · the complication

One entry, two facts, one correction.

A directive filed to resolve a live contradiction in the canon superseded #8972 with a corrected verdict (#12977, directive #12976). #8972 wasn’t wrong all the way through. It held a second, unrelated fact — that -p and fast-mode spawns still bill the subscription, not the API credit — and that fact had nothing to do with the correction.

Supersession, as built at the time, had one mode: mark the whole entry replaced. There was no way to correct one fact inside #8972 without invoking the same operation built for replacing it outright, so the fix that corrected the first fact took the second one down with it too.

§03 · the receipt

Three entries, caught and fixed in the open.

The correction in #12977 is what caused the gap. The fix is two further entries, filed once the gap was found, both still readable on the record next to the entries they explain. #13058 restores the surviving billing fact as its own foundational entry, so the claim stands again on its own number instead of riding inside a superseded one. #13059 ships the actual guard: a partial correction can no longer invoke the full-supersession mechanism, so fixing one fact inside an entry can’t erase a fact next to it. Both entries trace to the same investigation, #13042.

What happenedEntry
A directive resolves a canon contradiction by superseding #8972 with a corrected verdict#12977
The surviving fact #8972 also held is restored as its own entry#13058
The root cause ships: a guard so a partial correction can't take an untouched fact with it#13059

None of the three entries is hidden or renumbered to make the sequence read cleaner. #8972 still shows as superseded by #12977. #13058 and #13059 sit beside it with their own numbers, filed once the mistake surfaced rather than folded quietly back into the original.

§04 · common questions

Common questions.

What does “superseded” mean when you see it on the dashboard or in the graph?

The entry is still there and still readable. It carries a label and a typed link to whatever replaced it, and it still shows up in search. Superseded marks an entry as no longer current, not as removed.

Can an entry be deleted once it's written?

No. The graph is append-only: a correction is always a new entry, never an edit to an old one. When the mistake described above was found, it wasn’t deleted either. It was corrected by two more entries, #13058 and #13059, sitting next to it on the record.

What makes a “partial” supersession riskier than a full one?

A full supersession replaces one fact with one fact, and the mechanism matches the intent. A partial supersession corrects one fact inside an entry that holds more than one. Until #13059 shipped, the graph had no way to tell those two cases apart, so a partial correction used the full-replace mechanism and could take the untouched fact with it.

see also

Related entries.

conceptsupersession
how work gets claimed1
directives & claims