linksee-memory 0.10.0 → 0.11.1

package/dist/mcp/server.js

@@ -23,7 +23,50 @@ import { confirmForget } from './elicitation.js';
 import { getTruthView, getDecisionDetail, resolveDrift } from '../lib/truth-engine.js';
 import { declareAnchor, setNodeFields } from '../lib/drift-anchors.js';
 import { getReinjectionFriction, setGateMode } from '../lib/guard.js';
-const SERVER_VERSION = '0.10.0';
+import { whereAmI } from '../lib/map-view.js';
+import { readFileSync, existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+// Single source of truth: read our own version from package.json so the MCP
+// serverInfo can never drift from the published package version. (We catch
+// doc/code drift for a living — our own version string shouldn't drift.)
+function readServerVersion() {
+    try {
+        const here = fileURLToPath(import.meta.url);
+        // dist/mcp/server.js → ../../package.json
+        const pkgPath = join(dirname(dirname(dirname(here))), 'package.json');
+        if (existsSync(pkgPath)) {
+            return String(JSON.parse(readFileSync(pkgPath, 'utf8')).version || '0.0.0');
+        }
+    }
+    catch { /* fall through */ }
+    return '0.0.0';
+}
+const SERVER_VERSION = readServerVersion();
+// ── Subcommand dispatch ───────────────────────────────────────────────────────
+// Each CLI ships as its own bin (linksee-memory-setup, …) AND as a subcommand of
+// the main bin, so `npx -y linksee-memory <sub>` works for a cold user: npx can
+// only resolve the package name (linksee-memory), not sibling bin names like
+// linksee-memory-setup. Run as the MCP server (no subcommand / stdio) → skip this.
+const SUBCOMMANDS = {
+    setup: 'setup.js',
+    map: 'map-import.js',
+    sync: 'sync-session.js',
+    guard: 'guard-hook.js',
+    stats: 'stats.js',
+    import: 'import-sessions.js',
+    'install-skill': 'install-skill.js',
+    declare: 'declare-anchor.js',
+    detect: 'detect-drift.js',
+};
+const subcommand = process.argv[2];
+if (subcommand && Object.prototype.hasOwnProperty.call(SUBCOMMANDS, subcommand)) {
+    // Spawn the target bin as a child (shebang-safe, argv/stdio correct) and exit with its code.
+    const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', SUBCOMMANDS[subcommand]);
+    const r = spawnSync(process.execPath, [binPath, ...process.argv.slice(3)], { stdio: 'inherit' });
+    process.exit(r.status ?? (r.signal ? 1 : 0));
+}
 const db = openDb();
 runMigrations(db);
 // Auto-maintenance: consolidate stale memories on startup (non-blocking)
@@ -158,6 +201,19 @@ const TOOLS = [
             },
         },
     },
+    {
+        name: 'where_am_i',
+        description: 'Locate the current topic on the Current Truth Map and report "you are here" + blast radius — the per-turn re-anchor.\n\nReturns the matching Map node(s) + journey stage (discover → … → expand), the BLAST RADIUS (what becomes suspect if you change this — the must-stay-consistent-with / should-align-with / realizes dependents; e.g. editing the README implicates the LP), and the decision behind the node (linked anchor), if any.\n\nThree ways to call:\n• NO ARGS → auto-locates from the files you JUST edited this session (the zero-effort re-anchor — call it freely as you work).\n• query: "<topic>" → lexical locate by topic.\n• node_id: "<id>" → exact node.\n\nThis is how you avoid optimizing one node while silently breaking its neighbors (change the spec → npm/Docs/LP must move too). Matching is lexical (no embeddings).\n\nWHEN TO CALL:\n• Right after editing files — call with no args to see what you just touched + its blast radius.\n• When the topic shifts — re-anchor to the new node.\n• When the user asks "what does changing X affect?" / "where does this fit?"',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Topic to locate (e.g. "changing the telemetry contract"). Omit to auto-locate from your recent edits.' },
+                node_id: { type: 'string', description: 'Exact Map node id, if known (e.g. "readme") — bypasses lexical match' },
+                project: { type: 'string', description: 'Map project slug (defaults to the most recently imported Map)' },
+                limit: { type: 'number', description: 'Max matches (default 3)' },
+            },
+        },
+    },
     {
         name: 'check_decision',
         description: 'Deep-dive into a specific decision/anchor — its state, premises, drift edges, and pending candidates.\n\nReturns the full context for one truth-map node: what was decided, why, what reality says, whether it\'s drifting, and what actions are pending.\n\nWHEN TO CALL:\n• When the user asks about a specific decision ("what happened with X?")\n• Before resolving a drift signal — understand the full picture first\n• When reviewing premises of a decision ("is this still true?")',
@@ -1238,6 +1294,34 @@ function handleDriftStatus(args) {
         counts: view.counts,
     });
 }
+function handleWhereAmI(args) {
+    const res = whereAmI(db, {
+        query: args?.query, node_id: args?.node_id, project: args?.project, limit: args?.limit,
+    });
+    if (res.matched.length === 0) {
+        return JSON.stringify({
+            ok: true, project: res.project, located: false,
+            hint: res.project ? 'No node matched. Try a node id or a topical keyword.' : 'No Map imported yet — run linksee-memory-map.',
+        });
+    }
+    const located = res.matched.map((m) => ({
+        node: m.node.id,
+        stage: m.stage_label,
+        status: m.node.status,
+        statement: m.node.statement,
+        why: m.match_reason,
+        // the whole point: what else moves if you touch this
+        blast_radius: m.blast.map((b) => `${b.id} (${b.relation})`),
+        decision: m.anchor ? `#${m.anchor.id}: ${m.anchor.statement}` : null,
+    }));
+    const top = res.matched[0];
+    const youAreHere = `You are at "${top.node.id}"`
+        + (top.stage_label ? ` in stage 「${top.stage_label}」` : '')
+        + `. Touching it implicates ${top.blast.length} node(s)`
+        + (top.blast.length ? `: ${top.blast.map((b) => b.id).join(', ')}` : ' (isolated)')
+        + '.';
+    return JSON.stringify({ ok: true, project: res.project, located: true, you_are_here: youAreHere, job: res.job, matched: located });
+}
 function handleCheckDecision(args) {
     if (!args?.anchor_id)
         throw new Error('anchor_id is required');
@@ -1635,6 +1719,9 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             case 'drift_status':
                 text = handleDriftStatus(args);
                 break;
+            case 'where_am_i':
+                text = handleWhereAmI(args);
+                break;
             case 'check_decision':
                 text = handleCheckDecision(args);
                 break;