@graphpilot-oss/graphpilot 0.0.1

package/bench/score.ts

@@ -0,0 +1,59 @@
+/**
+ * Scoring: precision/recall/F1 of a returned set against ground truth.
+ *
+ * We score whether the set of names returned MATCHES the expected set,
+ * not whether it's identical — partial credit is honest. F1 is the
+ * primary metric. Per-task results show all three.
+ */
+
+export interface Scored {
+  precision: number;
+  recall: number;
+  f1: number;
+  intersectionSize: number;
+  truePositives: string[];
+  falsePositives: string[];
+  falseNegatives: string[];
+}
+
+export function score(returned: string[], groundTruth: string[]): Scored {
+  const ret = new Set(returned);
+  const gt = new Set(groundTruth);
+
+  const tp: string[] = [];
+  for (const r of ret) if (gt.has(r)) tp.push(r);
+
+  const fp: string[] = [];
+  for (const r of ret) if (!gt.has(r)) fp.push(r);
+
+  const fn: string[] = [];
+  for (const g of gt) if (!ret.has(g)) fn.push(g);
+
+  // Edge case: empty ground truth + empty return = perfect.
+  // (The recall-miss task hits this.)
+  if (gt.size === 0 && ret.size === 0) {
+    return {
+      precision: 1,
+      recall: 1,
+      f1: 1,
+      intersectionSize: 0,
+      truePositives: [],
+      falsePositives: [],
+      falseNegatives: [],
+    };
+  }
+
+  const precision = ret.size === 0 ? 0 : tp.length / ret.size;
+  const recall = gt.size === 0 ? 0 : tp.length / gt.size;
+  const f1 = precision + recall === 0 ? 0 : (2 * precision * recall) / (precision + recall);
+
+  return {
+    precision,
+    recall,
+    f1,
+    intersectionSize: tp.length,
+    truePositives: tp.sort(),
+    falsePositives: fp.sort(),
+    falseNegatives: fn.sort(),
+  };
+}

package/bench/tasks.ts

@@ -0,0 +1,236 @@
+/**
+ * The 10-task benchmark corpus. Hand-curated against graphpilot indexing
+ * itself, so anyone can `git clone` + `pnpm install` + `pnpm bench` and
+ * see the same numbers.
+ *
+ * Each task carries its OWN ground truth so this file is the single
+ * source of truth for what "correct" means. Ground truth was computed
+ * by probing the live index at the time this file was authored; if the
+ * corpus repo (graphpilot itself) is materially edited, ground truth
+ * needs to be refreshed (see bench/README.md §Refreshing).
+ *
+ * Mix of task types is deliberate:
+ *  - 7 tasks where GraphPilot's structural index should win
+ *  - 1 task that's roughly a tie (negative result)
+ *  - 1 task where grep should outperform GraphPilot (string-literal
+ *    search). Keeping this in the corpus is what makes the benchmark
+ *    honest.
+ */
+
+export type TaskKind =
+  | 'callers' // who calls X?
+  | 'recall' // find symbol by exact name
+  | 'recall-substring' // find symbols whose name contains a fragment
+  | 'kind-filter' // find all symbols of kind=...
+  | 'impact' // blast-radius analysis
+  | 'impact-since' // differential impact: callers in changed files since a ref
+  | 'tests-affected' // which tests depend on this symbol
+  | 'recall-miss' // symbol that doesn't exist
+  | 'string-literal'; // text-only search — grep should win
+
+export interface Task {
+  id: string;
+  description: string;
+  /** What a developer / agent would naturally ask. */
+  prompt: string;
+  kind: TaskKind;
+  /** Argument to the task's natural tool (graphpilot side). */
+  query: string;
+  /**
+   * Set of expected symbol names (sorted) that the correct answer must
+   * contain. For tests-affected tasks, this is the set of test file paths.
+   */
+  groundTruth: string[];
+  /** Which side we expect to win on F1 score. */
+  expectedWinner: 'graphpilot' | 'grep' | 'tie';
+  /** Helpful for the README/results: structural vs text-only. */
+  difficulty: 'low' | 'medium' | 'high';
+}
+
+export const TASKS: Task[] = [
+  {
+    id: 't01-callers-analyzeImpact',
+    description: 'Find every function that calls analyzeImpact',
+    prompt: 'In this repo, what functions call analyzeImpact?',
+    kind: 'callers',
+    query: 'analyzeImpact',
+    groundTruth: ['handleGpImpact'],
+    expectedWinner: 'graphpilot',
+    difficulty: 'low',
+  },
+  {
+    id: 't02-callers-extractSymbols',
+    description: 'Find every direct caller of extractSymbols',
+    prompt: 'Who calls extractSymbols in this codebase?',
+    kind: 'callers',
+    query: 'extractSymbols',
+    groundTruth: ['indexDirectory', 'applyUpdate', 'symbolsOf'],
+    expectedWinner: 'graphpilot',
+    difficulty: 'low',
+  },
+  {
+    id: 't03-callers-validateRootPath',
+    description: 'Find every direct caller of validateRootPath',
+    prompt: 'Where is validateRootPath used in the codebase? List every callsite.',
+    kind: 'callers',
+    query: 'validateRootPath',
+    // Note: GraphWatcher constructor calls validateRootPath; the SymbolRecord
+    // for that constructor has name="constructor" (not "GraphWatcher").
+    groundTruth: ['cmdIndex', 'main', 'handleGpIndex', 'constructor'],
+    expectedWinner: 'graphpilot',
+    difficulty: 'medium',
+  },
+  {
+    id: 't04-recall-substring-parse',
+    description: 'Find every symbol whose name contains "parse"',
+    prompt: 'List every function, class, or interface whose name contains "parse".',
+    kind: 'recall-substring',
+    query: 'parse',
+    groundTruth: ['ParsedFile', 'getParser', 'parseFile', 'parseSource', 'parseToken'],
+    expectedWinner: 'graphpilot',
+    difficulty: 'low',
+  },
+  {
+    id: 't05-kind-filter-interfaces',
+    description: 'Enumerate all TypeScript interfaces under src/',
+    prompt: 'List every TypeScript interface defined under src/.',
+    kind: 'kind-filter',
+    query: 'interface', // means: kind === "interface"
+    groundTruth: [
+      'CallEdge',
+      'EdgeQueryOptions',
+      'Graph',
+      'GpCallersArgs',
+      'GpImpactArgs',
+      'GpIndexArgs',
+      'GpRecallArgs',
+      'GpStatsArgs',
+      'ImpactCaller',
+      'ImpactOptions',
+      'ImpactResult',
+      'IndexOptions',
+      'IndexResult',
+      'InteractionEntry',
+      'ParsedFile',
+      'RawCall',
+      'RecallOptions',
+      'SecretPattern',
+      'SymbolRecord',
+      'ToolResult',
+      'UpdateResult',
+      'ValidationContext',
+      'WatcherOptions',
+    ],
+    expectedWinner: 'graphpilot',
+    difficulty: 'medium',
+  },
+  {
+    id: 't06-impact-extractSymbols-depth2',
+    description: 'Compute blast radius of changing extractSymbols (depth 2)',
+    prompt:
+      "If I change extractSymbols's signature, what functions will I need to update? Include indirect callers up to two hops.",
+    kind: 'impact',
+    query: 'extractSymbols',
+    // Direct callers + their direct callers
+    groundTruth: [
+      // d=1
+      'indexDirectory',
+      'applyUpdate',
+      'symbolsOf',
+      // d=2 — callers of the above
+      'cmdIndex',
+      'handleGpIndex',
+      'handleEvent',
+      // symbolsOf has no callers in production code; it's only in tests
+    ],
+    expectedWinner: 'graphpilot',
+    difficulty: 'high',
+  },
+  {
+    id: 't07-tests-affected-parseFile',
+    description: 'Identify test files that exercise parseFile (directly)',
+    prompt: 'If I change the behavior of parseFile, which test files are most likely to break?',
+    kind: 'tests-affected',
+    query: 'parseFile',
+    // The test file containing symbolsOf which calls parseFile
+    groundTruth: ['tests/symbols.test.ts'],
+    expectedWinner: 'graphpilot',
+    difficulty: 'medium',
+  },
+  {
+    id: 't08-recall-substring-args',
+    description: 'Find every MCP-tool input-args interface',
+    prompt: 'List every TypeScript type whose name ends with "Args".',
+    kind: 'recall-substring',
+    query: 'Args',
+    groundTruth: ['GpCallersArgs', 'GpImpactArgs', 'GpIndexArgs', 'GpRecallArgs', 'GpStatsArgs'],
+    expectedWinner: 'graphpilot',
+    difficulty: 'low',
+  },
+  {
+    id: 't09-recall-miss',
+    description: 'Look up a symbol that does not exist (negative test)',
+    prompt: 'Find the function definitelyNotARealSymbol in this codebase.',
+    kind: 'recall-miss',
+    query: 'definitelyNotARealSymbol',
+    groundTruth: [], // empty set
+    expectedWinner: 'tie',
+    difficulty: 'low',
+  },
+  {
+    id: 't10-string-literal-MAX_FILE_BYTES',
+    description: 'Find every literal occurrence of the constant name "MAX_FILE_BYTES"',
+    prompt: 'Find every place the string "MAX_FILE_BYTES" appears in the source.',
+    kind: 'string-literal',
+    query: 'MAX_FILE_BYTES',
+    // We don't index string literals or identifier usages outside structural
+    // contexts — but for THIS specific constant the structural index has the
+    // declaration. Both should find the declaration; only grep finds every
+    // usage. We expect grep to win on recall here.
+    groundTruth: [
+      'src/validation.ts', // declared here
+      'src/parser.ts', // imported and used
+      'tests/security.test.ts', // referenced in a test
+    ],
+    expectedWinner: 'grep',
+    difficulty: 'medium',
+  },
+  {
+    id: 't11-impact-since-indexDirectory',
+    description: 'Differential impact: callers of indexDirectory changed since HEAD~1',
+    prompt:
+      'Show me callers of indexDirectory, but only those in files that have changed since HEAD~1. This is for PR review — I want to know which of my changes will be affected.',
+    kind: 'impact-since',
+    query: 'indexDirectory',
+    // Ground truth: callers of indexDirectory at all depths are
+    // [cmdIndex, handleGpIndex, applyUpdate]. On a clean repo HEAD~1
+    // should be empty or shallow-history, so we expect ~0 to all three
+    // depending on the branch state. Scorer will filter by changed files.
+    groundTruth: [], // Filled in during scoring based on actual git state
+    expectedWinner: 'graphpilot', // GraphPilot filters noise; baseline can't
+    difficulty: 'high',
+  },
+  {
+    id: 't12-evidence-anchor-resolution',
+    description: 'Evidence anchors: every tool response carries file:line @ sha citations',
+    prompt:
+      'Find every function that calls analyzeImpact. For each result, I need the exact file and line number I can jump to. Include the git SHA from when the index was built.',
+    kind: 'callers', // same tool as t01, different validation
+    query: 'analyzeImpact',
+    groundTruth: ['handleGpImpact'],
+    expectedWinner: 'graphpilot', // Only GP returns structured evidence anchors
+    difficulty: 'medium',
+  },
+  {
+    id: 't13-recall-nonexistent-with-anchor',
+    description:
+      'Anti-hallucination: looking up a symbol that does not exist returns citation proof',
+    prompt:
+      'Find the function fakeSymbolXYZ123. If it does not exist, show me the evidence — what query returned no results and why?',
+    kind: 'recall-miss',
+    query: 'fakeSymbolXYZ123',
+    groundTruth: [], // Does not exist
+    expectedWinner: 'graphpilot', // GP can cite "not in index" with proof; baseline may hallucinate
+    difficulty: 'high',
+  },
+];

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+import { resolve } from 'node:path';
+import { indexDirectory } from './indexer.js';
+import { saveGraph, loadGraph, graphPath, repoIdFor } from './storage.js';
+import { validateRootPath } from './validation.js';
+import { startMcpServer } from './mcp.js';
+import { GraphWatcher } from './watcher.js';
+import { resolveIndexRoot } from './git.js';
+const HELP = `graphpilot — structural memory for coding agents
+
+Usage:
+  graphpilot index <path>     Index a TypeScript/JavaScript repo
+  graphpilot status <path>    Show info about an indexed repo
+  graphpilot watch <path>     Watch the repo and update the index on save
+  graphpilot mcp              Start the MCP server (stdio)
+  graphpilot help             Show this help
+
+Examples:
+  graphpilot index .
+  graphpilot status .
+  graphpilot watch .          # keeps the index fresh as you edit
+  graphpilot mcp              # used by MCP clients (Claude Code, Cursor, ...)
+`;
+async function cmdIndex(pathArg, opts = {}) {
+    const requested = resolve(pathArg);
+    // Worktree-scope: by default, if the user pointed inside a git worktree
+    // we re-root to the worktree top so the index covers the full branch.
+    // Pass --no-worktree to disable.
+    const { root: absRoot, redirected } = resolveIndexRoot(requested, { disable: opts.noWorktree });
+    if (redirected) {
+        process.stdout.write(`[graphpilot] Re-rooting index to git worktree top: ${absRoot}\n` +
+            `             (Pass --no-worktree to index ${requested} directly.)\n`);
+    }
+    // T10 defence: refuse `/`, `/etc`, `~`, and friends before walking.
+    const refusal = validateRootPath(absRoot);
+    if (refusal) {
+        process.stderr.write(`Error: ${refusal}\n`);
+        return 2;
+    }
+    process.stdout.write(`Indexing ${absRoot} ...\n`);
+    const result = await indexDirectory(absRoot);
+    const graph = {
+        version: 1,
+        repoId: repoIdFor(absRoot),
+        rootPath: absRoot,
+        indexedAt: new Date().toISOString(),
+        filesIndexed: result.filesIndexed,
+        symbolCount: result.symbols.length,
+        edgeCount: result.edges.length,
+        symbols: result.symbols,
+        edges: result.edges,
+        indexedSha: result.git.sha,
+        indexedBranch: result.git.branch,
+    };
+    const saved = saveGraph(graph);
+    const resolved = result.edges.filter((e) => e.toId !== null).length;
+    // Build the git stamp line lazily — only printed when we're in a git repo.
+    let gitLine = '';
+    if (result.git.shortSha || result.git.branch) {
+        const parts = [];
+        if (result.git.branch)
+            parts.push(`branch ${result.git.branch}`);
+        if (result.git.shortSha)
+            parts.push(`sha ${result.git.shortSha}`);
+        gitLine = `  Git:        ${parts.join(' @ ')}\n`;
+    }
+    process.stdout.write(`\n✓ Remembered ${result.symbols.length} symbols, ${result.edges.length} calls ` +
+        `(${resolved} resolved) across ${result.filesIndexed} files in ${result.durationMs}ms.\n` +
+        `  Repo id:    ${graph.repoId}\n` +
+        gitLine +
+        `  Graph file: ${saved}\n` +
+        (result.filesFailed ? `  Failed:     ${result.filesFailed} file(s)\n` : ''));
+    return 0;
+}
+function cmdStatus(pathArg) {
+    const absRoot = resolve(pathArg);
+    const graph = loadGraph(absRoot);
+    if (!graph) {
+        process.stderr.write(`No index found for ${absRoot}\n` + `Run: graphpilot index ${pathArg}\n`);
+        return 1;
+    }
+    // Compose a git line if the indexed repo had provenance at the time.
+    let gitLine = '';
+    if (graph.indexedSha || graph.indexedBranch) {
+        const parts = [];
+        if (graph.indexedBranch)
+            parts.push(`branch ${graph.indexedBranch}`);
+        if (graph.indexedSha)
+            parts.push(`sha ${graph.indexedSha.slice(0, 7)}`);
+        gitLine = `Git:          ${parts.join(' @ ')}\n`;
+    }
+    process.stdout.write(`Repo id:      ${graph.repoId}\n` +
+        `Root:         ${graph.rootPath}\n` +
+        `Indexed at:   ${graph.indexedAt}\n` +
+        gitLine +
+        `Files:        ${graph.filesIndexed}\n` +
+        `Symbols:      ${graph.symbolCount}\n` +
+        `Calls:        ${graph.edgeCount ?? 0}\n` +
+        `Graph file:   ${graphPath(absRoot)}\n`);
+    return 0;
+}
+async function main() {
+    const [, , cmd, ...rest] = process.argv;
+    switch (cmd) {
+        case 'index': {
+            const noWorktree = rest.includes('--no-worktree');
+            const path = rest.find((a) => !a.startsWith('--')) ?? '.';
+            return cmdIndex(path, { noWorktree });
+        }
+        case 'status': {
+            const path = rest[0] ?? '.';
+            return cmdStatus(path);
+        }
+        case 'mcp': {
+            // Server runs until stdin closes (MCP client disconnect). Never
+            // returns under normal operation.
+            await startMcpServer();
+            return 0;
+        }
+        case 'watch': {
+            const noWorktree = rest.includes('--no-worktree');
+            const path = rest.find((a) => !a.startsWith('--')) ?? '.';
+            const requested = resolve(path);
+            const { root: absRoot, redirected } = resolveIndexRoot(requested, { disable: noWorktree });
+            if (redirected) {
+                process.stderr.write(`[graphpilot:watch] Re-rooting to worktree top: ${absRoot}\n`);
+            }
+            const refusal = validateRootPath(absRoot);
+            if (refusal) {
+                process.stderr.write(`Error: ${refusal}\n`);
+                return 2;
+            }
+            const watcher = new GraphWatcher(absRoot);
+            await watcher.start();
+            process.stderr.write(`[graphpilot:watch] Ctrl+C to stop.\n`);
+            // Hold the process open until SIGINT or stdin EOF.
+            await new Promise((res) => {
+                const finish = () => res();
+                process.once('SIGINT', finish);
+                process.once('SIGTERM', finish);
+                process.stdin.once('end', finish);
+                process.stdin.once('close', finish);
+            });
+            await watcher.stop();
+            return 0;
+        }
+        case 'help':
+        case '--help':
+        case '-h':
+        case undefined:
+            process.stdout.write(HELP);
+            return 0;
+        default:
+            process.stderr.write(`Unknown command: ${cmd}\n\n${HELP}`);
+            return 2;
+    }
+}
+main().then((code) => process.exit(code), (err) => {
+    process.stderr.write(`Error: ${err?.stack ?? err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/edges.d.ts

@@ -0,0 +1,57 @@
+import { type ParsedFile } from './parser.js';
+import type { SymbolRecord } from './symbols.js';
+/**
+ * A resolved call edge.
+ *
+ * `toId` is null when the call's target couldn't be resolved to a known symbol
+ * (e.g. it's a stdlib call like `Array.from`, a third-party import, or a
+ * dynamic dispatch we don't track in v1). `toName` is always set, so the agent
+ * still knows what was called.
+ */
+export interface CallEdge {
+    fromId: string;
+    toId: string | null;
+    toName: string;
+    file: string;
+    line: number;
+    column: number;
+}
+/**
+ * A pre-resolution call site. Same shape as CallEdge minus `toId`. Used during
+ * indexing before we have the full symbol table.
+ */
+export interface RawCall {
+    fromId: string;
+    toName: string;
+    file: string;
+    line: number;
+    column: number;
+}
+/**
+ * For every function-like symbol in `fileSymbols`, walk its body and emit a
+ * RawCall for every call/new expression directly inside it.
+ *
+ * Returns calls keyed by *line+name lookup* so resolution can happen later.
+ */
+export declare function extractRawCalls(parsed: ParsedFile, fileSymbols: SymbolRecord[]): RawCall[];
+/**
+ * Second-pass resolver. Given the full symbol table and a list of raw calls,
+ * fill in `toId` where the callee name matches a known symbol.
+ *
+ * Resolution strategy (v1 — deliberately dumb):
+ *   1. Prefer a symbol with the same name in the same file (likely the right one)
+ *   2. Otherwise pick any symbol with that name (first match — non-deterministic
+ *      across reruns of ambiguous names, but stable within a single index)
+ *   3. Otherwise leave toId null
+ *
+ * Known limitations (documented as v1 caveats):
+ *   - No import resolution: if `parseToken` is imported from another file we'll
+ *     still find it globally, but if two files both export `parseToken` we may
+ *     pick the wrong one.
+ *   - No method-of-class disambiguation: `obj.method()` resolves to the first
+ *     symbol named `method`, regardless of receiver type.
+ *   - No re-export chains.
+ *
+ * These are fine for v1; the goal is "better than grep" not "compiler-grade".
+ */
+export declare function resolveCallEdges(rawCalls: RawCall[], allSymbols: SymbolRecord[]): CallEdge[];