Kanshō/Memory write receipt

Memory write receipt

A durable receipt for every memory write — what was stored, why, where it landed, and whether it can be undone. Memory should never be silent.

Included in the single kansho full pack. Components are not offered as separate installs.

Reversible write

Live demo: Undo updates the visible demo state
Memory storedActivejust now

Avery prefers concise status updates during long-running tasks.

Why
Stated as a standing rule in the global playbook.
Where
User layer
Reversible

Demo state: stored

Reversible vs irreversible

Static preview: Undo requires host persistence
reversible
Memory storedActive14:02

Session lock acquired on audit.logs.

Why
Prevents two agents writing the ledger at once.
Where
Session layer
Reversible
irreversible
Memory storedActive09:14

Compliance evidence retained for 7 years.

Why
Required by org retention policy.
Where
Organization layer
Irreversible

Component documentation

Memory Write Receipt

components/memory/memory-write-receipt.tsx

Purpose

Confirms what memory was written, why, where, and whether it can be undone.

Appropriate use

Use immediately after a memory write when the user needs an auditable explanation and optional reversal.

Example

components/memory/memory-write-receipt.tsx has a representative live example in the "Reversible write" section on /components/memory-write-receipt.

States

Receipts may be reversible or irreversible and target any shared memory layer.

API and props

MemoryWriteReceipt accepts fact, reason, layer, timestamp, reversible, onUndo, and className.

Dependencies

Direct imports are React, Lucide icons, StatusPill, Tag, shared memory types, and cn.

Accessibility

Fact, reason, layer, timestamp, and reversibility are visible text; undo renders only for a reversible receipt with a callback.

Limitations

It does not perform or roll back storage, confirm undo, validate timestamps, or report pending and failed reversal.

Source

Source: components/memory/memory-write-receipt.tsx.

Full pack

components/memory/memory-write-receipt.tsx is documented at /components/memory-write-receipt and installs only through the single Kansho full pack; no individual component install is offered.