@misterhuydo/cairn-mcp 1.22.0 → 1.24.0

package/README.md

@@ -87,11 +87,40 @@ No manual steps. The index lives in `.cairn/index.db` inside your project — li
 | `cairn_checkpoint` | Save session state (auto-handled by hooks). At a stopping point, answer `would_be_lost` — the one part that git and the index cannot recover |
 | `cairn_minify` | Minify a single file on demand (fallback when hooks are not installed) |
 | `cairn_switch` | Switch active project root mid-session (use for maintenance on a sibling service) |
-| `cairn_memo` | Save a preference, decision, or discovery to the project's persistent memory |
+| `cairn_memo` | Save a preference, decision, or discovery to the project's persistent memory. `action: "reindex"` repairs an index that has lost entries (see below) |
 | `cairn_employ_memory` | Recall stored memories explicitly (call only when asked) |
 
 ---
 
+## Repairing a truncated memory index
+
+`MEMORY.md` is **shared**. Claude Code's own auto-memory writes plain pointer lines
+with no type tag, and cairn writes tagged ones. Before **v1.23.0**, cairn required
+the tag and rebuilt the whole index from the lines it could parse — so every
+Claude-written pointer was deleted the next time a memo was saved. Seen in the
+wild: an index of ~150 entries rewritten down to 3.
+
+Only the pointers were lost. The memory files themselves were never touched, so the
+index can be rebuilt from their frontmatter:
+
+```bash
+cd /path/to/project
+cairn repair-memory --dry-run   # what would be restored, writes nothing
+cairn repair-memory             # restore them
+```
+
+It is **additive**: it only adds pointers for files the index has lost, and never
+rewrites or removes a line that is already there. Entries restored from a
+Claude-written memory keep Claude's format (no type tag is invented for them). The
+previous index is kept as `MEMORY.bak` — deliberately not a `.md`, since every
+`.md` in that directory is treated as a memory. A pointer whose file is missing is
+reported but left alone. Running it twice does nothing the second time.
+
+The same repair is available in-session as `cairn_memo` with
+`action: "reindex"` (and `dry_run: true` to preview).
+
+---
+
 ## Multi-service / monorepo support
 
 Cairn understands workspace structures where multiple services or packages live under a common parent folder.