Skip to content

deprecate

Mark memories deprecated or link them to a replacement.

Usage

machine-memory deprecate <id|id,id,...> (--local|--remote)
machine-memory deprecate --match "old topic" --superseded-by <id> (--local|--remote)

Without --superseded-by, targeted memories receive the deprecated status. With it, they receive superseded_by and point at the canonical replacement. --updated-by records who made the change.

The command accepts either IDs or an active-memory --match query. It returns the changed rows, missing IDs for batch requests, and the count of updated memories. Output flags: --brief prints {id, status}, --json-min/--quiet print {id} for single targets and compact {deprecated_ids, not_found, count} payloads for batches.

Retiring a premise can leave other memories relying on it. The response adds review_candidates (minimal output: review_candidate_ids) for active memories that share the deprecated content’s paths, identifiers, or terms, excluding the --superseded-by replacement. Resolve each one.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close