Skip to documentation
Docs navigation
Docs/Lifecycle controls are soft-state memory management
Core concepts

Lifecycle controls are soft-state memory management.

MemoGrafter can forget memories, suppress topics, restore topics, and annotate memory quality without deleting graph rows by default.

Why lifecycle is soft state

Memory can be useful, outdated, suppressed, or wrong without needing to disappear from the database. MemoGrafter keeps lifecycle as state on records so recall can stay clean while Studio and audits still have history.

Developers touch lifecycle controls when users ask to forget something, when a topic should stop appearing in active context, or when maintenance passes annotate low-quality memory.

Active memory
Forget or suppress
Filtered recall
Studio audit
Restore

Controls

forget(memoryId) marks a memory inactive for recall, grafting, absorption, and maintenance.
forgetMany(memoryIds) performs a bulk forget.
suppressTopic(topicId) hides a topic from active reads and graph expansion.
restoreTopic(topicId) makes a suppressed topic active again.

Why soft state

Snapshots and Studio can still inspect inactive rows, which is important for audit, lifecycle display, memory history, and debugging.