Skip to main content

Correct memory

Daimon never guesses a transition for you, so each change to what a briefing carries has its own command. The contract behind them is in the item lifecycle.

you want torun
close an item that is donedaimon resolve
say a carried item is still truedaimon reverify
record that an open item moved ondaimon amend propose, see decide and ratify
remove content for gooddaimon forget
lift a forget on this machinedaimon unforget
tell the next session what to do firstdaimon handoff

Both resolve and forget accept an exact id or a free-text query, and a query must match exactly one item. Add --dry-run first to see what would match.

daimon resolve: close a loop​

daimon resolve "retry policy for the payments webhook" --dry-run
daimon resolve o-3f8a2c --note "shipped exponential backoff in #212"

Resolving records an append-only event; from then on, briefings withhold the item instead of carrying it stale. The item is not deleted, its history stays searchable, and the event trail shows when and why it closed. --status accepts a free-form lifecycle status; any status starting with reopen revives the item. A status starting with forgotten: is refused: that is a tombstone, and only daimon forget writes one (it also removes the value from the files). Only daimon unforget lifts one.

daimon reverify: assert it's still true​

daimon reverify o-3f8a2c --evidence "checked the release page"

Reverify is the answer to the staleness warning: a carried item aged past the threshold, you checked the world, and it still holds. The event resets the item's last-verified stamp, so the warning clock restarts. Reverify takes exact ids only, re-asserting a claim is deliberate, so there is no fuzzy match to mis-fire.

Reverify is also the reject half of a supersession candidate (below).

Supersession candidates​

When a newer session contradicts a carried item, the briefing presents a supersession candidate: both sides, with the confirm/reject commands inline. You verify which side is true in the world, then answer with exactly those commands:

  • Confirm, daimon resolve <id>: the old item is genuinely superseded; future briefings withhold it.
  • Reject, daimon reverify <id>: the contradiction was apparent, not real; the item stands, freshly verified.

The design principle across the whole lifecycle: daimon flags, you decide. Contradiction, staleness, and removal are all surfaced with evidence and resolved by an explicit human (or explicitly-instructed agent) action , never by a silent merge.

daimon forget: remove content​

Resolve closes an item but keeps its content in history. Forget removes the content itself, and leaves a hash-only tombstone. What it removes, and the guarantee that it stays removed, are in the item lifecycle.

daimon forget o-3f8a2c --reason "contains client name"
daimon forget "wrong belief about retry nonce" --dry-run

daimon unforget: lift a forget​

daimon unforget o-3f8a2c --reason "forgot the wrong one"
daimon unforget o-3f8a2c --dry-run

Unforget takes the id the forget receipt printed, from a person at a terminal (an agent has no way to run it), and lifts the forget on every ref that carries its key. It restores nothing: the value was removed from every surface, so the lift only lets a new capture of the same claim back in. It exits 0 only when nothing else still withholds the value; if another project on this machine, a teammate's published row or a ledger it could not prove does, it says which and exits 4. A published tombstone row has no retraction, so the row you published stays and your teammates keep withholding the value until they lift it.

daimon handoff: the baton​

Checkpoints are reconstructive: extracted from the transcript, ranked, budget-trimmed, competing for slots. The moment of deliberate handoff , "next session: do THIS first, watch out for THAT", has different semantics: intentional, small, imperative, and it must never lose rank to ambient noise.

daimon handoff "Ship the release first. Beware: the cache key rotated."
daimon handoff --clear

The baton leads the next briefing, above every section:

HANDOFF (left deliberately by previous session, 2026-08-03T03:43:58Z):
→ Ship the release first. Beware: the cache key rotated.

It is stored as an event, never as a cognitive item, so it cannot enter ranking, dedup, or carry scoring, and it cannot resolve anything. One baton per project; a new one supersedes the old (the event trail keeps history). It stays active until the session that read it ends and serializes, a crashed session never consumes it. Capped small on purpose: a baton is "do X, beware Y", not a second checkpoint.