pin
Mark a memory as protected. MemMesh has no separate "pinned" flag — pinning is
expressed through importance + impact + confirmation, which the dream
consolidation pass treats as do-not-retire.
Pin
- Find the item (
memory_search) and read it (memory_recall). - Re-assert it at maximum durability with
memory_save(upsert on the same id):
{ "name": "memory_save",
"arguments": { "id": "<same id>", "platformId": "local", "scope": "project",
"type": "rule", "content": "<verbatim content>",
"importance": 10, "metadata": { "pinned": true, "impact": "HIGH" } } }
Setting importance: 10 and metadata.pinned: true is the signal the dream
skill checks before deleting/superseding anything.
Unpin
Re-save the same id with importance back to a normal value (≈5) and
metadata.pinned: false. The item stays in memory but becomes eligible for
consolidation again.
When to pin
Architecture decisions, security constraints, compliance rules, immutable conventions — anything where losing it silently would cause real harm. Don't pin routine preferences; let the engine manage those.