diff --git a/docs/architecture/memory-architecture.md b/docs/architecture/memory-architecture.md index 46e52a9094..5e83a0681b 100644 --- a/docs/architecture/memory-architecture.md +++ b/docs/architecture/memory-architecture.md @@ -1250,13 +1250,13 @@ Table-level retention and tiering are operator TTLs, off by default ## History, snapshot, restore and rollback -| Operation | Reads | Writes | -| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `memory.history` | `memory_versions` for one key | Nothing. | -| `memory.redact` | The row of org-wide `(memory_id, version)` (`loom.memory_revisions` under the Postgres authority), then the later versions of its key | Scrubs one historical version in place, the later versions of its key that copy its text (the live head left alone), and every profile version whose trace names the memory, live heads included. Refuses the memory's own live head (delete it first). | -| `namespace.snapshot` | Live `memory` rows, type configs, curated rows | A portable payload with `version`, `content_sha256` and the attestation columns, plus a `loom.namespace_snapshots` audit row. | -| `namespace.restore` | A snapshot payload | Rows into a target namespace (created if missing; the caller becomes admin). Idempotent per `snapshot_id`. Never strips `verified_by`. | -| `namespace.rollback` | `memory` heads and `memory_versions` at `as_of` | Each changed key's older version as a new head; keys absent at `as_of` tombstoned; embedding stubs for the worker. Dry run by default. | +| Operation | Reads | Writes | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `memory.history` | `memory_versions` for one key | Nothing. | +| `memory.redact` | The row of org-wide `(memory_id, version)` (`loom.memory_revisions` under the Postgres authority), then the later versions of its key and the `loom.shared` versions promoted from it | Scrubs one historical version in place, the later versions of its key that copy its text (the live head left alone), every profile version whose trace names the memory, live heads included, and the shared copies promoted from the key that hold the text, with their search rows. Refuses the memory's own live head (delete it first). | +| `namespace.snapshot` | Live `memory` rows, type configs, curated rows | A portable payload with `version`, `content_sha256` and the attestation columns, plus a `loom.namespace_snapshots` audit row. | +| `namespace.restore` | A snapshot payload | Rows into a target namespace (created if missing; the caller becomes admin). Idempotent per `snapshot_id`. Never strips `verified_by`. | +| `namespace.rollback` | `memory` heads and `memory_versions` at `as_of` | Each changed key's older version as a new head; keys absent at `as_of` tombstoned; embedding stubs for the worker. Dry run by default. | Rollback restores heads, not exact state. `version` is a wall-clock stamp, so the head at T is the largest version at or before T. Triples, records, summaries and aggregates diff --git a/docs/architecture/security.md b/docs/architecture/security.md index e2688123f3..ac37fc83a9 100644 --- a/docs/architecture/security.md +++ b/docs/architecture/security.md @@ -1353,24 +1353,24 @@ A redaction (`memory.redact`) scrubs the version it names, that key's derived ro every version of the user's profiles whose trace names the memory: the structured profile and the free-text fold's `consolidated_profile` name the memories they read in their trace (`profile.fold: