linksee-memory 0.15.0 → 0.15.2

package/README.md

@@ -1,12 +1,12 @@
 # linksee-memory
 
-> **Your agent forgets everything when a session ends. Worse — it silently drifts from what you decided last week.**
+> **Claude Code forgets everything when you start a new session. Your successor knows even less.**
 >
-> **Linksee Memory catches when your project drifts from its own decisions** — the option abandoned at a fork, the pipeline that quietly stalled, the code that contradicts what you agreed — and a re-injection guard re-surfaces the locked decision **before** the agent acts. Rules you've explicitly hardened get blocked.
+> **Linksee Memory lets you hand a project over — to your next session, to Cursor or Codex, to the person after you — with the reasons attached.** Record a decision once (`remember({ content, anchor: {} })`) and it comes back *before* the agent acts on it: re-injected on session start and ahead of every Edit / Write / Bash that touches it. Change your mind on the record and it stops nagging; leave it and it keeps the next agent from repeating last week's mistake.
 >
-> Underneath sits a local-first cross-LLM memory MCP — one SQLite file that **Claude Code, Cursor, Windsurf, OpenAI Codex, and Gemini CLI** all read from. Not just "what happened" but **WHY**: 6-layer structured memory with precision recall and an AST-aware diff cache (50–99% token savings on re-reads).
+> Underneath: **drift detection** across every project you run in parallel — which ones quietly left their goal (🔴), which were checked and hold (🔵), which nobody has looked at yet (⚫). One local SQLite file that **Claude Code, Cursor, Windsurf, OpenAI Codex and Gemini CLI** all read. Nothing leaves your machine.
 >
-> `npx -y linksee-memory setup` — one command, done.
+> `npx -y linksee-memory setup` — one command, on in every repo.
 
 [![npm](https://img.shields.io/npm/v/linksee-memory.svg)](https://www.npmjs.com/package/linksee-memory)
 [![license](https://img.shields.io/npm/l/linksee-memory.svg)](./LICENSE)
@@ -19,6 +19,46 @@
 <!-- releases: tag-driven, published from CI via npm trusted publishing (OIDC).
      See .github/workflows/publish.yml — no token, no OTP, provenance attached automatically. -->
 
+## Questions this answers
+
+These are the questions people actually type — measured, verbatim (2026-09-04). If yours is here, this is the answer.
+
+**Claude Code forgets everything when I start a new session. How do I make it remember decisions across sessions?**  
+Run `npx -y linksee-memory setup`. Every new session opens with `recall()` — a brief of what needs attention, where you are, what's unresolved — and your locked decisions are re-injected before the agent acts. Nothing to re-explain.
+
+**Claude Codeがセッションをまたぐと過去の経緯を忘れてしまいます。記憶を持たせる方法を教えてください。**  
+`npx -y linksee-memory setup` の一回で入ります。新しいセッションは `recall()` の brief（注意すべきこと・いまどこか・未解決）から始まり、固定した決定は行動の直前に再注入されます。説明し直す必要はありません。
+
+**What is the best MCP server for persistent memory across AI coding agents?**  
+Honest answer: if "remember across sessions" is all you need, a `CLAUDE.md` is enough — we measured it. Linksee is for the three moments it isn't: right before a mistake, when you change your mind, and when you run many projects and need to see which one drifted.
+
+**AIコーディングエージェント用の記憶MCPサーバーでおすすめはありますか？**  
+正直に言うと、「セッションを跨いで覚える」だけなら `CLAUDE.md` で足ります（実測しました）。Linksee が要るのは、間違いかけたとき・方針を変えたとき・並行案件のどれが外れたかを知りたいとき、の3場面です。
+
+**I want one shared memory between Claude Code, Cursor, and OpenAI Codex. What tools exist for that?**  
+One SQLite file. Claude Code, Cursor, Windsurf, OpenAI Codex and Gemini CLI all read and write the same memory — a decision made in one shows up in the others.
+
+**Claude CodeとCursorとCodexで同じ記憶を共有したいのですが、どうすればいいですか？**  
+SQLite ファイル1つを全員で読みます。Claude Code / Cursor / Windsurf / Codex / Gemini CLI のどこで決めた決定も、他のエージェントの行動の直前に出てきます。
+
+**My AI agent keeps re-implementing things we already decided against. How can I detect that a codebase has drifted from past decisions?**  
+Declare the decision (`remember({ content, anchor: { violation_signal: [...] } })`). The guard then warns — or blocks, if you hardened it — the moment an edit contradicts it, and `drift_status` shows every decision that reality has quietly left.
+
+**過去に決めた設計方針とコードがずれていないかを検出できるツールはありますか？**  
+決定を宣言しておくと（`remember({ content, anchor: {...} })`）、それに反する編集の直前に警告（hardened なら拒否）が出ます。`drift_status` は「宣言と現実がずれた決定」を証拠つきで一覧します。
+
+**Is there a local-first, self-hosted alternative to Mem0 for agent memory?**  
+Yes. No account, no API key, no cloud — one local file, MIT licensed. `npx -y linksee-memory setup` and it's on.
+
+**Mem0 vs Zep vs Letta for a coding agent's long-term memory — which should I pick?**  
+We installed them and ran one scenario across all of them. Storing and recalling a decision: everyone passes. The difference appears *before a mistake* and *when you change your mind* — Linksee is built for those two moments; the others leave them to you.
+
+**How do I stop Claude Code from repeating the same mistake it made last week?**  
+Record it as a caveat (`remember({ content, layer: 'caveat' })`). Caveats are protected from forgetting and come back when the same ground is touched again — and if you anchor it, the guard stops the repeat before it lands.
+
+**開発の意思決定履歴をMCPサーバーで残しておく定番のやり方はありますか？**  
+`remember({ content, anchor: {} })` の1回で、記録と強制が同時に入ります。`drift_status` がその台帳で、各決定が いま守られているか（🔵）・ずれているか（🔴）・誰も確かめていないか（⚫）を示します。
+
 ## 🪄 Three spells to remember
 
 | Say this | What happens |

package/dist/lib/truth-engine.d.ts

@@ -95,6 +95,14 @@ export type ResolutionAction = 'fix' | 'supersede' | 'acknowledge' | 'dismiss';
 export interface ResolveInput {
     /** For dismiss: silence only this match term. Omitted → silence the anchor at the gate. */
     hit_term?: string;
+    /**
+     * For dismiss: false = close these drift edges as false positives but leave the gate
+     * watching. The default (true) also stops the gate. Two different verdicts hide behind
+     * "dismiss": "this detection was wrong" and "stop detecting this". Anchor #2 ("no destructive
+     * migrations") had a false positive from migrate.ts — the right answer was to close the edge
+     * and keep the gate, since "ALTER TABLE memories DROP" is exactly what it exists to catch.
+     */
+    gate?: boolean;
     anchor_id: number;
     action: ResolutionAction;
     rationale?: string;

package/dist/lib/truth-engine.js

@@ -543,12 +543,17 @@ export function resolveDrift(db, input) {
     // real detections survive.
     if (input.action === 'dismiss') {
         db.prepare("UPDATE drift_edges SET status = 'dismissed' WHERE anchor_id = ? AND status = 'open'").run(input.anchor_id);
-        try {
-            db.prepare(`INSERT INTO gate_dismissals (anchor_id, hit_term, rationale) VALUES (?, ?, ?)
-         ON CONFLICT(anchor_id, COALESCE(hit_term, '')) DO UPDATE SET rationale = excluded.rationale`).run(input.anchor_id, input.hit_term ? input.hit_term.toLowerCase() : null, input.rationale ?? null);
-            resolution.gate_dismissed = input.hit_term ? input.hit_term.toLowerCase() : 'all matches';
+        if (input.gate === false) {
+            resolution.gate_dismissed = 'none (edges closed; gate still watching)';
+            resolution.gate = false;
         }
-        catch { /* pre-v16 DB → edges-only dismiss, as before */ }
+        else
+            try {
+                db.prepare(`INSERT INTO gate_dismissals (anchor_id, hit_term, rationale) VALUES (?, ?, ?)
+         ON CONFLICT(anchor_id, COALESCE(hit_term, '')) DO UPDATE SET rationale = excluded.rationale`).run(input.anchor_id, input.hit_term ? input.hit_term.toLowerCase() : null, input.rationale ?? null);
+                resolution.gate_dismissed = input.hit_term ? input.hit_term.toLowerCase() : 'all matches';
+            }
+            catch { /* pre-v16 DB → edges-only dismiss, as before */ }
     }
     // If action is 'fix', mark open edges as resolved
     if (input.action === 'fix') {

package/dist/mcp/server.js

@@ -280,13 +280,14 @@ const TOOLS = [
     },
     {
         name: 'resolve_drift',
-        description: 'Record a resolution for a drifting anchor — the human feedback loop.\n\n6 actions:\n• fix — "we fixed the code/reality to match intent" → state becomes aligned\n• supersede — "intent evolved, this is the new direction" → state becomes aligned\n• acknowledge — "we know, parking it for now" → state becomes held (with optional review date)\n• dismiss — "false positive, not actually drifting" → edges dismissed AND the gate stops firing on it (pass hit_term to silence just that word)\n• harden — "re-injected but still violated, enforce it" → card_policy.gate_mode=hard (PreToolUse will BLOCK)\n• soften — "back off to a warning" → gate_mode=soft\n\nWHEN TO CALL:\n• After drift_status shows 🔴 drift or 🟡 review items\n• When the user says "that\'s fixed" / "ignore that" / "we changed direction"\n• When acknowledging a known gap with a review date',
+        description: 'Record a resolution for a drifting anchor — the human feedback loop.\n\n6 actions:\n• fix — "we fixed the code/reality to match intent" → state becomes aligned\n• supersede — "intent evolved, this is the new direction" → state becomes aligned\n• acknowledge — "we know, parking it for now" → state becomes held (with optional review date)\n• dismiss — "false positive, not actually drifting" → edges dismissed AND the gate stops firing on it (hit_term: just that word; gate:false: close the edges but keep the gate watching)\n• harden — "re-injected but still violated, enforce it" → card_policy.gate_mode=hard (PreToolUse will BLOCK)\n• soften — "back off to a warning" → gate_mode=soft\n\nWHEN TO CALL:\n• After drift_status shows 🔴 drift or 🟡 review items\n• When the user says "that\'s fixed" / "ignore that" / "we changed direction"\n• When acknowledging a known gap with a review date',
         inputSchema: {
             type: 'object',
             properties: {
                 anchor_id: { type: 'number', description: 'The drift_anchor ID to resolve' },
                 action: { type: 'string', enum: ['fix', 'supersede', 'acknowledge', 'dismiss', 'harden', 'soften', 'surface'], description: "Resolution action. With candidate_id (an orphaned proposal): 'surface' keeps it visible for the human, 'dismiss' retires it." },
                 candidate_id: { type: 'number', description: 'Resolve an orphaned proposal (from recall({ dream: true })) instead of an anchor: pass its candidate_id with action surface | dismiss and a rationale that references the North Star. (Absorbs resolve_proposal.)' },
+                gate: { type: 'boolean', default: true, description: "For dismiss: false = these detections were false positives, close them, but KEEP the gate watching this anchor (its signals still fire). Use when the anchor's rule is right and only this evidence was wrong — e.g. a lexical hit in a file that is not what the rule is about. Default true also silences the gate (whole anchor, or just hit_term)." },
                 rationale: { type: 'string', description: 'Why this resolution (recorded for audit trail)' },
                 review_after: { type: 'string', description: 'For acknowledge: ISO date to re-check (e.g. "2026-07-04")' },
                 superseded_by: { type: 'number', description: 'For supersede: the new anchor ID that replaces this one' },
@@ -1751,6 +1752,7 @@ function handleResolveDrift(args) {
         review_after: args.review_after,
         superseded_by: args.superseded_by,
         hit_term: args.hit_term,
+        gate: args.gate,
     });
     return JSON.stringify(result);
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "linksee-memory",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "mcpName": "io.github.michielinksee/linksee-memory",
-  "description": "Local-first agent memory MCP — cross-agent brain with drift detection, 6-layer structured memory + token-saving file diff cache",
+  "description": "Hand a project over — to your next session, to Cursor/Codex/Gemini, to your successor — with the reasons attached. Local-first memory MCP for coding agents: decisions re-injected before the agent acts, drift detection across every project you run. One SQLite file, nothing leaves your machine.",
   "type": "module",
   "bin": {
     "linksee-memory": "dist/mcp/server.js",
@@ -39,14 +39,24 @@
     "mcp",
     "model-context-protocol",
     "memory",
-    "agent",
     "agent-memory",
+    "persistent-memory",
+    "long-term-memory",
+    "session-memory",
+    "handover",
+    "hand-off",
+    "decision-log",
+    "drift-detection",
+    "guardrails",
     "claude",
     "claude-code",
     "cursor",
+    "windsurf",
+    "codex",
+    "gemini-cli",
     "chatgpt",
-    "sqlite",
     "local-first",
+    "sqlite",
     "token-savings",
     "cross-agent"
   ],