@graphpilot-oss/graphpilot 0.0.1 → 1.0.0

package/dist/indexer.js

@@ -1,6 +1,6 @@
 import fg from 'fast-glob';
 import { realpathSync } from 'node:fs';
-import { resolve, relative } from 'node:path';
+import { resolve, relative, sep } from 'node:path';
 import { parseFile } from './parser.js';
 import { extractSymbols } from './symbols.js';
 import { extractRawCalls, resolveCallEdges } from './edges.js';
@@ -61,7 +61,7 @@ export async function indexDirectory(rootPath, opts = {}) {
                 filesFailed++;
                 continue;
             }
-            if (!realFile.startsWith(realRoot)) {
+            if (realFile !== realRoot && !realFile.startsWith(realRoot + sep)) {
                 filesSkippedSymlink++;
                 continue;
             }
@@ -71,7 +71,7 @@ export async function indexDirectory(rootPath, opts = {}) {
             const fileSymbols = extractSymbols(parsed);
             const fileCalls = extractRawCalls(parsed, fileSymbols);
             if (useRelative) {
-                const rel = relative(absRoot, file);
+                const rel = relative(absRoot, file).split(sep).join('/');
                 // Track id rewrites so call edges can be remapped in lockstep.
                 const idRewrites = new Map();
                 for (const s of fileSymbols) {

package/dist/indexer.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"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"}

package/dist/init.d.ts

@@ -0,0 +1,28 @@
+export type ClientId = 'cursor' | 'claude-code' | 'cline' | 'windsurf' | 'continue';
+export interface ClientSpec {
+    name: string;
+    /** Path to the client's own MCP config — its existence signals the client is installed. */
+    configPath: string;
+    /** Relative path inside the package's examples/ dir (the routing template). */
+    templateFile: string;
+    /** Filename to write at the target repo root. */
+    outputFile: string;
+}
+export declare const CLIENTS: Record<ClientId, ClientSpec>;
+export declare const EXAMPLES_DIR: string;
+export declare function detectInstalledClients(): ClientId[];
+export interface InitOptions {
+    repoPath: string;
+    clients?: ClientId[];
+    all?: boolean;
+    dryRun?: boolean;
+    examplesDir?: string;
+    prompt?: (destPath: string) => Promise<'overwrite' | 'skip'>;
+}
+export type WriteAction = 'written' | 'skipped' | 'dry-run';
+export interface WriteResult {
+    client: ClientId;
+    action: WriteAction;
+    destPath: string;
+}
+export declare function runInit(opts: InitOptions): Promise<WriteResult[]>;

package/dist/init.js

@@ -0,0 +1,112 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { createInterface } from 'node:readline';
+function clineConfigPath() {
+    const p = platform();
+    const globalStorage = join('Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+    if (p === 'darwin')
+        return join(homedir(), 'Library', 'Application Support', globalStorage);
+    if (p === 'win32') {
+        return join(process.env['APPDATA'] ?? join(homedir(), 'AppData', 'Roaming'), globalStorage);
+    }
+    return join(homedir(), '.config', globalStorage);
+}
+export const CLIENTS = {
+    cursor: {
+        name: 'Cursor',
+        configPath: join(homedir(), '.cursor', 'mcp.json'),
+        templateFile: join('cursor', '.cursorrules'),
+        outputFile: '.cursorrules',
+    },
+    'claude-code': {
+        name: 'Claude Code',
+        configPath: join(homedir(), '.claude.json'),
+        templateFile: join('claude-code', 'claude-routing.md'),
+        outputFile: 'CLAUDE.md',
+    },
+    cline: {
+        name: 'Cline',
+        configPath: clineConfigPath(),
+        templateFile: join('cline', '.clinerules'),
+        outputFile: '.clinerules',
+    },
+    windsurf: {
+        name: 'Windsurf',
+        configPath: join(homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+        templateFile: join('windsurf', '.windsurfrules'),
+        outputFile: '.windsurfrules',
+    },
+    continue: {
+        name: 'Continue',
+        configPath: join(homedir(), '.continue', 'config.json'),
+        templateFile: join('continue', '.continuerules'),
+        outputFile: '.continuerules',
+    },
+};
+export const EXAMPLES_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'examples');
+export function detectInstalledClients() {
+    return Object.keys(CLIENTS).filter((id) => existsSync(CLIENTS[id].configPath));
+}
+async function defaultPrompt(destPath) {
+    if (!process.stdin.isTTY)
+        return 'skip';
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(`  ${destPath} already exists. Overwrite? [y/N] `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' ? 'overwrite' : 'skip');
+        });
+    });
+}
+export async function runInit(opts) {
+    const { repoPath, all = false, dryRun = false, examplesDir: exDir = EXAMPLES_DIR, prompt = defaultPrompt, } = opts;
+    let targets;
+    if (opts.clients && opts.clients.length > 0) {
+        targets = opts.clients;
+    }
+    else if (all) {
+        targets = Object.keys(CLIENTS);
+    }
+    else {
+        targets = detectInstalledClients();
+        if (targets.length === 0) {
+            process.stdout.write('No supported clients detected. Pass --all to write all rules files,\n' +
+                'or --client <name> for a specific one.\n' +
+                'Supported clients: cursor, claude-code, cline, windsurf, continue\n');
+            return [];
+        }
+        process.stdout.write(`Detected: ${targets.join(', ')}\n`);
+    }
+    const results = [];
+    for (const id of targets) {
+        const spec = CLIENTS[id];
+        const templatePath = join(exDir, spec.templateFile);
+        const destPath = join(repoPath, spec.outputFile);
+        if (!existsSync(templatePath)) {
+            process.stdout.write(`  [${spec.name}] skip — template not found: ${templatePath}\n`);
+            results.push({ client: id, action: 'skipped', destPath });
+            continue;
+        }
+        const content = readFileSync(templatePath, 'utf8');
+        if (dryRun) {
+            process.stdout.write(`  [dry-run] would write ${spec.outputFile} (${content.length} bytes)\n`);
+            results.push({ client: id, action: 'dry-run', destPath });
+            continue;
+        }
+        if (existsSync(destPath)) {
+            const decision = await prompt(destPath);
+            if (decision === 'skip') {
+                process.stdout.write(`  [${spec.name}] skipped (${spec.outputFile} already exists)\n`);
+                results.push({ client: id, action: 'skipped', destPath });
+                continue;
+            }
+        }
+        writeFileSync(destPath, content, 'utf8');
+        process.stdout.write(`  [${spec.name}] wrote ${spec.outputFile}\n`);
+        results.push({ client: id, action: 'written', destPath });
+    }
+    return results;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAchD,SAAS,eAAe;IACtB,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,MAAM,aAAa,GAAG,IAAI,CACxB,MAAM,EACN,MAAM,EACN,eAAe,EACf,wBAAwB,EACxB,UAAU,EACV,yBAAyB,CAC1B,CAAC;IACF,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,CAAC,CAAC;IAC5F,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAiC;IACnD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC;QAClD,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC;QAC5C,UAAU,EAAE,cAAc;KAC3B;IACD,aAAa,EAAE;QACb,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC;QAC3C,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC;QACtD,UAAU,EAAE,WAAW;KACxB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,eAAe,EAAE;QAC7B,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;QAC1C,UAAU,EAAE,aAAa;KAC1B;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC;QACtE,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC;QAChD,UAAU,EAAE,gBAAgB;KAC7B;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,aAAa,CAAC;QACvD,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC;QAChD,UAAU,EAAE,gBAAgB;KAC7B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAE5F,MAAM,UAAU,sBAAsB;IACpC,OAAQ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAgB;IAC3C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,EAAE,CAAC,QAAQ,CAAC,KAAK,QAAQ,oCAAoC,EAAE,CAAC,MAAM,EAAE,EAAE;YACxE,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAmBD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,EACJ,QAAQ,EACR,GAAG,GAAG,KAAK,EACX,MAAM,GAAG,KAAK,EACd,WAAW,EAAE,KAAK,GAAG,YAAY,EACjC,MAAM,GAAG,aAAa,GACvB,GAAG,IAAI,CAAC;IAET,IAAI,OAAmB,CAAC;IACxB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IACzB,CAAC;SAAM,IAAI,GAAG,EAAE,CAAC;QACf,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAe,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,sBAAsB,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uEAAuE;gBACrE,0CAA0C;gBAC1C,qEAAqE,CACxE,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,gCAAgC,YAAY,IAAI,CAAC,CAAC;YACtF,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1D,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAEnD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC,MAAM,WAAW,CACzE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1D,SAAS;QACX,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,UAAU,oBAAoB,CAAC,CAAC;gBACvF,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC1D,SAAS;YACX,CAAC;QACH,CAAC;QAED,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/interactions.d.ts

@@ -2,11 +2,12 @@
  * Append-only interaction log. One JSONL file per indexed repo:
  *   ~/.graphpilot/<repo-id>/interactions.jsonl
  *
- * Why we keep this even though v1 never reads it: see .notes/v1-mvp-revised.md
- * §4 (the moat seed). Day-1 logs become day-180 personalized ranking. A fork
- * starting fresh can't catch up.
+ * Why we keep this even though v1 never reads it: day-1 logs become day-180
+ * personalized ranking input. A fork starting fresh can't catch up — the
+ * accumulated interaction history is what makes adaptive symbol ranking
+ * possible without retraining.
  *
- * Privacy constraints (do NOT relax without revisiting .notes/security.md):
+ * Privacy constraints (do NOT relax without re-reading SECURITY.md):
  *   - Never log file contents
  *   - Cap every string field at MAX_FIELD_LEN
  *   - Strip control characters from string values

package/dist/interactions.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../src/interactions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../src/interactions.ts"],"names":[],"mappings":"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"}

package/dist/mcp.js

@@ -1,40 +1,62 @@
+import { statSync } from 'node:fs';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { resolve } from 'node:path';
+import { CallToolRequestSchema, ListToolsRequestSchema, RootsListChangedNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { GraphIndex } from './query.js';
 import { indexDirectory } from './indexer.js';
-import { loadGraph, saveGraph, repoIdFor } from './storage.js';
+import { loadGraph, saveGraph, repoIdFor, graphPath } from './storage.js';
 import { validateRootPath } from './validation.js';
-import { validateGpIndex, validateGpRecall, validateGpCallers, validateGpImpact, validateGpStats, } from './validators.js';
+import { validateGpIndex, validateGpRecall, validateGpCallers, validateGpImpact, } from './validators.js';
 import { withInteractionLog } from './interactions.js';
 import { analyzeImpact } from './impact.js';
 import { getChangedFiles, resolveIndexRoot } from './git.js';
+import { formatNoIndexError, getMcpClientRoots, resolveRepoPath, rootUriToFilesystemPath, setMcpClientRoots, } from './repo-resolve.js';
 const SERVER_NAME = 'graphpilot';
 const SERVER_VERSION = '0.0.1';
-// ----------------------------------------------------------------------------
-// Per-process cache of loaded GraphIndex by absolute repo path.
-// ----------------------------------------------------------------------------
+/** Shown on every tool's optional `path` field. */
+const PATH_FIELD_DESC = 'Repo root with a GraphPilot index. Optional: when omitted, resolves via ' +
+    'GRAPHPILOT_ROOT, MCP workspace roots, parent walk, or a single ~/.graphpilot index.';
 const indexCache = new Map();
+/** Set when buildMcpServer wires roots handlers — used for lazy roots/list. */
+let mcpServerForRoots = null;
+let rootsRefreshInflight = null;
 function getOrLoadIndex(rawPath) {
+    const requested = resolveRepoPath(rawPath);
     // Re-root to the git worktree top so MCP tool calls from a subdir of a
     // worktree still resolve to the branch-level index. Outside git this is
     // a no-op.
-    const { root } = resolveIndexRoot(rawPath ?? process.cwd());
+    const { root } = resolveIndexRoot(requested);
+    // Check whether graph.json changed since we last loaded it. Any external
+    // writer (CLI re-index, another MCP process, gp_index from a parallel
+    // session) will bump the mtime and trigger a cache miss here.
+    let currentMtimeMs = 0;
+    let currentSizeBytes = 0;
+    try {
+        const st = statSync(graphPath(root));
+        currentMtimeMs = st.mtimeMs;
+        currentSizeBytes = st.size;
+    }
+    catch {
+        // File doesn't exist yet — fall through; loadGraph will return null.
+    }
     const cached = indexCache.get(root);
-    if (cached)
-        return { idx: cached, root };
+    if (cached &&
+        currentMtimeMs !== 0 &&
+        cached.mtimeMs === currentMtimeMs &&
+        cached.sizeBytes === currentSizeBytes) {
+        return { idx: cached.idx, root };
+    }
+    // Cache miss or stale entry — (re)load from disk.
+    indexCache.delete(root);
     const graph = loadGraph(root);
     if (!graph) {
         return {
             root,
-            error: `No GraphPilot index found for ${root}.\n` +
-                `Ask the user to run \`graphpilot index ${rawPath ?? '.'}\` first, or ` +
-                `call the gp_index tool to build one.`,
+            error: formatNoIndexError(requested, root),
         };
     }
     const idx = new GraphIndex(graph);
-    indexCache.set(root, idx);
+    indexCache.set(root, { idx, mtimeMs: currentMtimeMs, sizeBytes: currentSizeBytes });
     return { idx, root };
 }
 function invalidateCache(absRoot) {
@@ -85,29 +107,17 @@ function fmtEdge(e, idx, index) {
 // Tool catalog (sent to clients via tools/list)
 // ----------------------------------------------------------------------------
 const TOOLS = [
-    {
-        name: 'gp_stats',
-        description: 'Show GraphPilot index health for a repo (symbol count, edge count, ' +
-            'when indexed). Use this to confirm the index is fresh before asking ' +
-            'structural questions.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                path: { type: 'string', description: 'Repo path. Default: cwd.' },
-            },
-            additionalProperties: false,
-        },
-    },
     {
         name: 'gp_index',
-        description: 'Index or re-index a TypeScript/JavaScript repo into GraphPilot. Call ' +
-            'this when the codebase has changed materially or when no index exists.',
+        description: 'Re-index the repo after batch edits so subsequent gp_* calls see your changes. ' +
+            'Call after any non-trivial edit session. ' +
+            'Do NOT call before every query — indexing is slow; only needed when source files changed.',
         inputSchema: {
             type: 'object',
             properties: {
                 path: {
                     type: 'string',
-                    description: 'Repo path to index. Default: cwd.',
+                    description: PATH_FIELD_DESC,
                 },
             },
             additionalProperties: false,
@@ -115,9 +125,11 @@ const TOOLS = [
     },
     {
         name: 'gp_recall',
-        description: 'Look up symbols (functions, classes, methods, types, interfaces) by ' +
-            'name. Returns kind, location, and signature. Default: exact ' +
-            'case-insensitive. Pass substring:true for partial matches.',
+        description: 'Find a symbol definition by name — returns kind, file:line, and signature. ' +
+            'ALWAYS use instead of `grep -rn "function X"` or reading files to locate a definition: ' +
+            'pre-indexed, no false positives from comments or strings, sub-millisecond. ' +
+            'Pass substring:true for partial-name searches. ' +
+            'Do NOT use for "who calls X?" — use gp_callers for that.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -137,7 +149,7 @@ const TOOLS = [
                 },
                 path: {
                     type: 'string',
-                    description: 'Repo path. Default: cwd.',
+                    description: PATH_FIELD_DESC,
                 },
             },
             required: ['query'],
@@ -146,9 +158,12 @@ const TOOLS = [
     },
     {
         name: 'gp_callers',
-        description: 'List callers of a symbol (who calls it) or callees (what it calls). ' +
-            "Use direction='callers' for impact analysis ('what breaks if I " +
-            "change this?'); direction='callees' to see what a function depends on.",
+        description: 'List every caller of a symbol (direction=callers) or everything it calls ' +
+            '(direction=callees). ALWAYS use instead of `grep -rn "X("` for "who calls X?" — ' +
+            'pre-indexed reverse map, sub-millisecond, no false positives from comments or strings. ' +
+            'Use direction=callers to find dependents before a rename; direction=callees to ' +
+            'understand what a function depends on. ' +
+            'Do NOT use for full blast-radius analysis across multiple hops — use gp_impact instead.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -173,7 +188,7 @@ const TOOLS = [
                 },
                 path: {
                     type: 'string',
-                    description: 'Repo path. Default: cwd.',
+                    description: PATH_FIELD_DESC,
                 },
             },
             required: ['symbol'],
@@ -182,15 +197,14 @@ const TOOLS = [
     },
     {
         name: 'gp_impact',
-        description: 'Analyze the BLAST RADIUS of changing a symbol. Returns direct callers, ' +
-            'transitive callers (default depth 3), tests likely affected, and ' +
-            'whether the symbol is part of the public API (exported). ' +
-            'Use this BEFORE proposing a rename, signature change, or behavior ' +
-            'change — it answers "what breaks if I change X?" in one call instead ' +
-            'of composing multiple gp_callers queries. ' +
-            'Pass `since: <commit|branch>` to restrict callers to files changed ' +
-            'since that ref — ideal for PR review ("what does this branch touch?") ' +
-            'and refactor scoping.',
+        description: 'Compute the blast radius of a rename or signature change: direct callers, ' +
+            'transitive callers up to depth 3, affected tests, and whether the symbol is ' +
+            'exported (breaking-change risk). ALWAYS call before proposing a rename, ' +
+            'signature change, or behavior change — replaces `git diff | xargs grep` with ' +
+            'a single structured answer. ' +
+            'Pass `since: <commit|branch>` to scope callers to files changed since that ref ' +
+            '(ideal for PR review or refactor scoping). ' +
+            'Do NOT use just to see direct callers; use gp_callers for that.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -206,7 +220,7 @@ const TOOLS = [
                 },
                 path: {
                     type: 'string',
-                    description: 'Repo path. Default: cwd.',
+                    description: PATH_FIELD_DESC,
                 },
                 since: {
                     type: 'string',
@@ -219,35 +233,9 @@ const TOOLS = [
         },
     },
 ];
-function handleGpStats(args) {
-    const out = getOrLoadIndex(args.path);
-    if ('error' in out) {
-        return { text: out.error, results: 0, isError: true };
-    }
-    const { idx } = out;
-    const s = idx.stats;
-    const g = idx.graph;
-    // Git provenance — surface branch + short SHA so the agent can cite
-    // the exact commit the index was built against. Omitted gracefully
-    // when the indexed root isn't a git repo.
-    const gitLines = [];
-    if (g.indexedBranch)
-        gitLines.push(`Branch:      ${g.indexedBranch}`);
-    if (g.indexedSha)
-        gitLines.push(`Commit SHA:  ${g.indexedSha.slice(0, 7)}`);
-    const text = [
-        `Repo:        ${g.rootPath}`,
-        `Repo id:     ${g.repoId}`,
-        `Indexed at:  ${g.indexedAt}`,
-        ...gitLines,
-        `Files:       ${g.filesIndexed}`,
-        `Symbols:     ${s.symbols}`,
-        `Calls:       ${s.edges} (${s.resolvedEdges} resolved)`,
-    ].join('\n');
-    return { text, results: 1 };
-}
 async function handleGpIndex(args) {
-    const requested = resolve(args.path ?? process.cwd());
+    await ensureClientRootsCached();
+    const requested = resolveRepoPath(args.path);
     const { root, redirected } = resolveIndexRoot(requested);
     const refusal = validateRootPath(root);
     if (refusal)
@@ -294,7 +282,8 @@ async function handleGpIndex(args) {
         `  Took:    ${result.durationMs}ms`;
     return { text, results: 1 };
 }
-function handleGpRecall(args) {
+async function handleGpRecall(args) {
+    await ensureClientRootsCached();
     const out = getOrLoadIndex(args.path);
     if ('error' in out) {
         return { text: out.error, results: 0, isError: true };
@@ -314,7 +303,8 @@ function handleGpRecall(args) {
     const body = matches.map((s, i) => fmtSymbol(s, idx, i)).join('\n\n');
     return { text: header + body, results: matches.length };
 }
-function handleGpCallers(args) {
+async function handleGpCallers(args) {
+    await ensureClientRootsCached();
     const out = getOrLoadIndex(args.path);
     if ('error' in out) {
         return { text: out.error, results: 0, isError: true };
@@ -423,6 +413,7 @@ function fmtImpactReport(report, idx, diff = { changedFileCount: null }) {
     return lines.join('\n');
 }
 async function handleGpImpact(args) {
+    await ensureClientRootsCached();
     const out = getOrLoadIndex(args.path);
     if ('error' in out) {
         return { text: out.error, results: 0, isError: true };
@@ -460,10 +451,57 @@ async function handleGpImpact(args) {
     return { text, results: totalResults };
 }
 // ----------------------------------------------------------------------------
+// MCP workspace roots (client → server)
+// ----------------------------------------------------------------------------
+/** Ensure roots/list has run when the client supports workspace roots. */
+async function ensureClientRootsCached() {
+    if (!mcpServerForRoots?.getClientCapabilities()?.roots)
+        return;
+    if (getMcpClientRoots().length > 0)
+        return;
+    if (!rootsRefreshInflight) {
+        rootsRefreshInflight = refreshMcpClientRoots(mcpServerForRoots).finally(() => {
+            rootsRefreshInflight = null;
+        });
+    }
+    await rootsRefreshInflight;
+}
+async function refreshMcpClientRoots(server) {
+    const caps = server.getClientCapabilities();
+    if (!caps?.roots) {
+        setMcpClientRoots([]);
+        return;
+    }
+    try {
+        const { roots } = await server.listRoots();
+        const paths = roots
+            .map((r) => rootUriToFilesystemPath(r.uri))
+            .filter((p) => p !== null);
+        setMcpClientRoots(paths);
+        if (paths.length > 0) {
+            process.stderr.write(`[graphpilot] MCP workspace roots: ${paths.join(', ')}\n`);
+        }
+    }
+    catch (err) {
+        process.stderr.write(`[graphpilot] roots/list failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        setMcpClientRoots([]);
+    }
+}
+function wireMcpClientRoots(server) {
+    mcpServerForRoots = server;
+    server.oninitialized = () => {
+        void refreshMcpClientRoots(server);
+    };
+    server.setNotificationHandler(RootsListChangedNotificationSchema, () => {
+        void refreshMcpClientRoots(server);
+    });
+}
+// ----------------------------------------------------------------------------
 // Server builder + dispatcher
 // ----------------------------------------------------------------------------
 export function buildMcpServer() {
     const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    wireMcpClientRoots(server);
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: TOOLS,
     }));
@@ -474,21 +512,12 @@ export function buildMcpServer() {
         // so the log captures even invalid-input attempts. Fall back to cwd.
         // Resolve to the worktree top so per-tool calls from a subdir land in
         // the same interaction log as the rest of the branch's work.
-        const requestedLogPath = typeof rawArgs.path === 'string' ? rawArgs.path : process.cwd();
+        const requestedLogPath = resolveRepoPath(typeof rawArgs.path === 'string' ? rawArgs.path : undefined);
         const repoRootForLog = resolveIndexRoot(requestedLogPath).root;
         return withInteractionLog(repoRootForLog, name, rawArgs, async () => {
             // Validate first
             let result;
             switch (name) {
-                case 'gp_stats': {
-                    const v = validateGpStats(rawArgs);
-                    if (!v.ok) {
-                        result = { text: `Invalid input: ${v.error}`, results: 0, isError: true };
-                        break;
-                    }
-                    result = handleGpStats(v.value);
-                    break;
-                }
                 case 'gp_index': {
                     const v = validateGpIndex(rawArgs);
                     if (!v.ok) {
@@ -504,7 +533,7 @@ export function buildMcpServer() {
                         result = { text: `Invalid input: ${v.error}`, results: 0, isError: true };
                         break;
                     }
-                    result = handleGpRecall(v.value);
+                    result = await handleGpRecall(v.value);
                     break;
                 }
                 case 'gp_callers': {
@@ -513,7 +542,7 @@ export function buildMcpServer() {
                         result = { text: `Invalid input: ${v.error}`, results: 0, isError: true };
                         break;
                     }
-                    result = handleGpCallers(v.value);
+                    result = await handleGpCallers(v.value);
                     break;
                 }
                 case 'gp_impact': {