linksee-memory 0.10.0 → 0.11.0

package/dist/mcp/server.js

@@ -23,6 +23,7 @@ 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';
+import { whereAmI } from '../lib/map-view.js';
 const SERVER_VERSION = '0.10.0';
 const db = openDb();
 runMigrations(db);
@@ -158,6 +159,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 (発見→…→拡張), 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 +1252,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 +1677,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;