Skip to content

Meta-Memory

Meta-memory tracks where knowledge came from and how it changed over time.

Every node in the graph has an origin, recorded through typed edges:

EdgeMeaning
DERIVED_FROMCame from this source
EXTRACTED_FROMPulled from a document
SUPERSEDESReplaces older version
PROMOTED_FROMWas claim, became fact

You can walk the provenance chain with trace:

{
"tool": "trace",
"arguments": {
"node_id": "node_abc"
}
}

When you supersede a node, the old one doesn’t get deleted. It stays in the graph with an edge pointing to its replacement. This means you can ask questions like “what did I believe about X last Tuesday?” and get an answer.

When your understanding changes, you should record it explicitly with reflect:

{
"tool": "reflect",
"arguments": {
"observation": "Tokens refresh client-side, not server-side",
"about": ["node_old", "node_new"]
}
}

Use reflect when you update a belief, spot a contradiction, or shift your confidence in something. The history of how beliefs changed is often as valuable as the current belief.