rho-graph 0.1.0

package/README.md

@@ -0,0 +1,277 @@
+# rho-graph
+
+> Graph-RAG code indexer for AI agents — token-efficient code search via MCP tools backed by Neo4j
+
+Parses your codebase into a knowledge graph (functions, classes, imports, call edges) and exposes it as MCP tools that Claude Code, Cursor, and other AI agents can use instead of reading raw files. A graph traversal to find callers of a function costs a handful of tokens; reading every file to find the same thing costs thousands.
+
+---
+
+## How it works
+
+```
+Your code
+    │
+    ▼ tree-sitter (WASM, no native deps)
+Parse AST
+    │
+    ▼ extractor
+Functions · Classes · Imports · Call edges
+    │
+    ▼ graph-writer
+Neo4j property graph
+    │
+    ▼ MCP server (stdio)
+Claude Code / Cursor get 10 graph tools
+```
+
+Files are parsed with [tree-sitter](https://tree-sitter.github.io/) via WASM bindings — no native compilation required. The resulting entities are written to Neo4j with uniqueness constraints and full-text indexes so queries are fast even on large repos.
+
+Incremental indexing checks files against stored content hashes and mtimes so only changed files are re-parsed on subsequent runs.
+
+---
+
+## Supported languages
+
+TypeScript · TSX · JavaScript · Python · Go · Java · Rust · C · C++ · Ruby · GraphQL · YAML · JSON · Markdown
+
+---
+
+## Quick start
+
+```bash
+# Install globally
+npm install -g rho-graph
+
+# In your repo: start Neo4j, index, register MCP, install git hook
+rho-graph setup
+```
+
+That's it. Claude Code and Cursor will now have access to the graph tools for the current repo.
+
+**Prerequisites:** Docker (for the managed Neo4j instance) and Node.js >= 18.
+
+---
+
+## CLI reference
+
+| Command | Description |
+|---|---|
+| `setup` | One-shot: runs `init` + `install-mcp` + `install-hook` |
+| `init` | Start Neo4j (Docker) and index the current repo |
+| `index [path]` | Re-index (full or `--changed` for incremental) |
+| `status` | Show graph stats: repos, files by language, function/class counts |
+| `install-mcp` | Register the MCP server in `~/.claude/settings.json` and `~/.cursor/mcp.json` |
+| `install-hook` | Install `.git/hooks/post-commit` to auto-reindex on commit |
+| `query [cypher]` | Run a Cypher query or open an interactive REPL |
+| `visualize` | Open a browser-based graph visualization on port 3333 |
+| `mcp-serve` | Start the MCP server (called automatically by Claude Code / Cursor) |
+
+### `index` options
+
+```bash
+rho-graph index              # full reindex
+rho-graph index --changed    # only files changed since last index
+rho-graph index src/auth     # index a subtree
+```
+
+### `query` examples
+
+```bash
+# Shorthand flags
+rho-graph query --callers processPayment
+rho-graph query --dependencies src/auth/middleware.ts
+rho-graph query --structure
+
+# Raw Cypher
+rho-graph query "MATCH (f:Function) WHERE f.name STARTS WITH 'get' RETURN f.name, f.filePath LIMIT 20"
+
+# Interactive REPL
+rho-graph query
+cypher> MATCH (c:Class)-[:CONTAINS]->(f:Function) RETURN c.name, count(f) ORDER BY count(f) DESC
+```
+
+### `visualize` options
+
+```bash
+rho-graph visualize                     # full graph
+rho-graph visualize --repo my-service   # filter by repo
+rho-graph visualize --file src/api.ts   # focus on a file
+rho-graph visualize --function handleRequest
+rho-graph visualize --port 4000
+```
+
+---
+
+## MCP tools
+
+Once installed, Claude Code and Cursor have access to these tools. They are designed to be used instead of reading source files.
+
+| Tool | What it does |
+|---|---|
+| `search_code` | Full-text search across function/class names, signatures, and code snippets |
+| `get_function` | Retrieve a function's source, signature, file, and line range |
+| `get_class` | Retrieve a class definition and its members |
+| `get_file_structure` | List all functions and classes defined in a file |
+| `get_callers` | Find every function that calls a given function |
+| `get_callees` | Find every function called by a given function |
+| `get_dependencies` | Files imported by a given file |
+| `get_dependents` | Files that import a given file |
+| `get_repo_structure` | High-level view: repos, files per language |
+| `reindex` | Trigger incremental reindex from within a conversation |
+
+### Example agent workflow
+
+```
+Agent: search_code("authentication middleware")
+→ finds handleAuth in src/auth/middleware.ts
+
+Agent: get_callers("handleAuth")
+→ finds 3 routes that depend on it
+
+Agent: get_function("handleAuth", "src/auth/middleware.ts")
+→ retrieves the full source + signature
+
+Agent: get_dependencies("src/auth/middleware.ts")
+→ finds what it imports, traces the dependency chain
+```
+
+---
+
+## Graph schema
+
+**Nodes**
+
+| Label | Key properties |
+|---|---|
+| `Repository` | `path`, `name`, `lastIndexedAt` |
+| `File` | `path`, `relativePath`, `language`, `hash`, `lastModified` |
+| `Function` | `name`, `filePath`, `signature`, `snippet`, `startLine`, `endLine` |
+| `Class` | `name`, `filePath`, `snippet`, `startLine`, `endLine` |
+
+**Relationships**
+
+| Relationship | Meaning |
+|---|---|
+| `(Repository)-[:CONTAINS_FILE]->(File)` | Repo owns file |
+| `(File)-[:CONTAINS]->(Function\|Class)` | File contains top-level definition |
+| `(Class)-[:HAS_METHOD]->(Function)` | Class method |
+| `(Function)-[:CALLS]->(Function)` | Call edge |
+| `(File)-[:IMPORTS]->(File)` | Import edge |
+| `(File)-[:IMPORTS_SYMBOL]->(Function\|Class)` | Symbol-level import |
+
+**Indexes**
+
+- Uniqueness constraints on `Repository.path` and `File.path`
+- B-tree indexes on `Function.name`, `Class.name`, `File.language`
+- Full-text index (`code_search`) on `Function.name`, `Function.snippet`, `Function.docstring`, `Class.name`, `Class.snippet`, `Class.docstring`
+
+---
+
+## Configuration
+
+Config is resolved in this order (later values win):
+
+1. Built-in defaults
+2. `~/.config/rho-graph/config.json` (global)
+3. `.rho-graph.json` in the repo root (per-repo)
+4. Environment variables
+
+### Full config reference
+
+```json
+{
+  "neo4j": {
+    "uri": "bolt://localhost:7687",
+    "username": "neo4j",
+    "password": "rho-graph",
+    "managed": true
+  },
+  "index": {
+    "include": ["**/*"],
+    "exclude": ["node_modules", "dist", "vendor", ".git", "build", "__pycache__"],
+    "languages": "auto"
+  },
+  "repos": []
+}
+```
+
+`managed: true` means Neo4j is started automatically via Docker Compose. Set to `false` to connect to an existing instance.
+
+### Environment variable overrides
+
+```bash
+NEO4J_URI=bolt://my-server:7687
+NEO4J_USERNAME=neo4j
+NEO4J_PASSWORD=secret
+```
+
+### Per-repo config example
+
+```json
+{
+  "index": {
+    "include": ["src/**/*", "lib/**/*"],
+    "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+  }
+}
+```
+
+---
+
+## Bring your own Neo4j
+
+If you already have Neo4j running (local, Aura, Docker Compose, etc.):
+
+```json
+{
+  "neo4j": {
+    "uri": "bolt://localhost:7687",
+    "username": "neo4j",
+    "password": "your-password",
+    "managed": false
+  }
+}
+```
+
+The Docker Compose file is included in the package if you want to run it manually:
+
+```bash
+docker compose -f node_modules/rho-graph/docker-compose.yml up -d
+```
+
+---
+
+## Automatic reindexing
+
+The `install-hook` command writes a `post-commit` git hook that runs `rho-graph index --changed` in the background after every commit. Only files that changed (by content hash) are re-parsed, so the overhead is minimal.
+
+If you already have a `post-commit` hook, the command appends to it rather than replacing it.
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/rhofield/rho-graph
+cd rho-graph
+npm install
+
+# Start Neo4j
+docker compose up -d
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Tests
+npm test
+
+# Type check
+npm run lint
+```
+
+## License
+
+MIT

package/bin/rho-graph.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/cli/index.js";

package/dist/cli/commands/index-cmd.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerIndexCommand(program: Command): void;

package/dist/cli/commands/index-cmd.js

@@ -0,0 +1,45 @@
+import ora from "ora";
+import { resolve } from "node:path";
+import { loadConfig } from "../../config.js";
+import { createConnection } from "../../db/connection.js";
+import { indexRepository } from "../../indexer/index.js";
+export function registerIndexCommand(program) {
+    program
+        .command("index")
+        .description("Re-index the repository")
+        .option("--changed", "Only index changed files")
+        .option("--path <path>", "Index a specific path")
+        .option("--repo <repoPath>", "Index a different repository")
+        .option("--concurrency <n>", "Number of parallel parse tasks", "8")
+        .option("--max-memory <mb>", "Max buffer memory in MB before backpressure", "8192")
+        .action(async (opts) => {
+        const repoPath = resolve(opts.repo || ".");
+        const config = loadConfig(repoPath);
+        const db = createConnection(config.neo4j);
+        const spinner = ora("Parsing files...").start();
+        const result = await indexRepository(db, repoPath, config.index, {
+            changedOnly: opts.changed,
+            specificPath: opts.path,
+            concurrency: parseInt(opts.concurrency, 10),
+            maxMemoryMB: parseInt(opts.maxMemory, 10),
+            onProgress: (current, total) => {
+                spinner.text = `Parsing files... ${current}/${total}`;
+            },
+            onFlushProgress: (completed, total) => {
+                spinner.text = `Writing to database... ${completed}/${total} batches`;
+            },
+        });
+        const orphanSuffix = result.orphansRemoved > 0
+            ? ` (removed ${result.orphansRemoved} orphaned files)`
+            : "";
+        spinner.succeed(`Indexed ${result.filesIndexed} files, ${result.functionsFound} functions, ${result.classesFound} classes${orphanSuffix}`);
+        if (result.errors.length > 0) {
+            console.log(`\n${result.errors.length} files had errors:`);
+            for (const err of result.errors.slice(0, 5)) {
+                console.log(`  ${err.file}: ${err.error}`);
+            }
+        }
+        await db.close();
+    });
+}
+//# sourceMappingURL=index-cmd.js.map

package/dist/cli/commands/index-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.js","sourceRoot":"","sources":["../../../src/cli/commands/index-cmd.ts"],"names":[],"mappings":"AAEA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,yBAAyB,CAAC;SACtC,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;SAC/C,MAAM,CAAC,eAAe,EAAE,uBAAuB,CAAC;SAChD,MAAM,CAAC,mBAAmB,EAAE,8BAA8B,CAAC;SAC3D,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,EAAE,GAAG,CAAC;SAClE,MAAM,CAAC,mBAAmB,EAAE,6CAA6C,EAAE,MAAM,CAAC;SAClF,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE;YAC/D,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3C,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACzC,UAAU,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;gBAC7B,OAAO,CAAC,IAAI,GAAG,oBAAoB,OAAO,IAAI,KAAK,EAAE,CAAC;YACxD,CAAC;YACD,eAAe,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;gBACpC,OAAO,CAAC,IAAI,GAAG,0BAA0B,SAAS,IAAI,KAAK,UAAU,CAAC;YACxE,CAAC;SACF,CAAC,CAAC;QACH,MAAM,YAAY,GAChB,MAAM,CAAC,cAAc,GAAG,CAAC;YACvB,CAAC,CAAC,aAAa,MAAM,CAAC,cAAc,kBAAkB;YACtD,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,OAAO,CACb,WAAW,MAAM,CAAC,YAAY,WAAW,MAAM,CAAC,cAAc,eAAe,MAAM,CAAC,YAAY,WAAW,YAAY,EAAE,CAC1H,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,oBAAoB,CAAC,CAAC;YAC3D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function runInit(): Promise<void>;
+export declare function registerInitCommand(program: Command): void;

package/dist/cli/commands/init.js

@@ -0,0 +1,55 @@
+import ora from "ora";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadConfig } from "../../config.js";
+import { createConnection } from "../../db/connection.js";
+import { setupSchema } from "../../db/schema.js";
+import { isDockerAvailable, startNeo4j, waitForNeo4j, } from "../../docker/neo4j.js";
+import { indexRepository } from "../../indexer/index.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export async function runInit() {
+    const repoPath = resolve(".");
+    const config = loadConfig(repoPath);
+    if (config.neo4j.managed) {
+        const spinner = ora("Checking prerequisites...").start();
+        if (!isDockerAvailable()) {
+            spinner.fail("Docker is not available. Install Docker or set neo4j.managed to false.");
+            process.exit(1);
+        }
+        spinner.succeed("Docker available");
+        const neo4jSpinner = ora("Starting Neo4j...").start();
+        const composePath = resolve(__dirname, "../../../docker-compose.yml");
+        startNeo4j(composePath);
+        const ready = await waitForNeo4j(config.neo4j.uri, config.neo4j.username, config.neo4j.password);
+        if (!ready) {
+            neo4jSpinner.fail("Neo4j failed to start");
+            process.exit(1);
+        }
+        neo4jSpinner.succeed("Neo4j running");
+    }
+    const db = createConnection(config.neo4j);
+    const schemaSpinner = ora("Setting up schema...").start();
+    await setupSchema(db);
+    schemaSpinner.succeed("Schema ready");
+    const indexSpinner = ora("Indexing repository...").start();
+    const result = await indexRepository(db, repoPath, config.index, {
+        onProgress: (current, total) => {
+            indexSpinner.text = `Indexing... ${current}/${total}`;
+        },
+    });
+    indexSpinner.succeed(`Indexed ${result.filesIndexed} files, ${result.functionsFound} functions, ${result.classesFound} classes`);
+    if (result.errors.length > 0) {
+        console.log(`\n${result.errors.length} files had errors:`);
+        for (const err of result.errors.slice(0, 5)) {
+            console.log(`  ${err.file}: ${err.error}`);
+        }
+    }
+    await db.close();
+}
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Initialize Neo4j and index the current repository")
+        .action(runInit);
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

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

package/dist/cli/commands/install-hook.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function runInstallHook(): Promise<void>;
+export declare function registerInstallHookCommand(program: Command): void;

package/dist/cli/commands/install-hook.js

@@ -0,0 +1,37 @@
+import { writeFileSync, readFileSync, existsSync, chmodSync, } from "node:fs";
+import { join, resolve } from "node:path";
+import ora from "ora";
+const HOOK_CONTENT = `#!/bin/sh
+# code-graph-rag: re-index changed files after commit
+code-graph-rag index --changed &
+`;
+export async function runInstallHook() {
+    const spinner = ora("Installing git hook...").start();
+    const repoRoot = resolve(".");
+    const hookDir = join(repoRoot, ".git", "hooks");
+    if (!existsSync(join(repoRoot, ".git"))) {
+        spinner.fail("Not a git repository");
+        process.exit(1);
+    }
+    const hookPath = join(hookDir, "post-commit");
+    if (existsSync(hookPath)) {
+        const existing = readFileSync(hookPath, "utf-8");
+        if (existing.includes("code-graph-rag")) {
+            spinner.succeed("Hook already installed");
+            return;
+        }
+        writeFileSync(hookPath, existing + "\n" + HOOK_CONTENT);
+    }
+    else {
+        writeFileSync(hookPath, HOOK_CONTENT);
+    }
+    chmodSync(hookPath, 0o755);
+    spinner.succeed(`Hook installed at ${hookPath}`);
+}
+export function registerInstallHookCommand(program) {
+    program
+        .command("install-hook")
+        .description("Install git post-commit hook for automatic re-indexing")
+        .action(runInstallHook);
+}
+//# sourceMappingURL=install-hook.js.map

package/dist/cli/commands/install-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hook.js","sourceRoot":"","sources":["../../../src/cli/commands/install-hook.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,MAAM,YAAY,GAAG;;;CAGpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,OAAO,GAAG,GAAG,CAAC,wBAAwB,CAAC,CAAC,KAAK,EAAE,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAE9C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,YAAY,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,CAAC,OAAO,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,cAAc,CAAC,CAAC;AAC5B,CAAC"}

package/dist/cli/commands/install-mcp.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function runInstallMcp(): Promise<void>;
+export declare function registerInstallMcpCommand(program: Command): void;

package/dist/cli/commands/install-mcp.js

@@ -0,0 +1,32 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import ora from "ora";
+export async function runInstallMcp() {
+    const spinner = ora("Installing MCP server...").start();
+    const claudeDir = join(homedir(), ".claude");
+    const settingsPath = join(claudeDir, "settings.json");
+    if (!existsSync(claudeDir)) {
+        mkdirSync(claudeDir, { recursive: true });
+    }
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+    }
+    const mcpServers = settings.mcpServers || {};
+    mcpServers["code-graph-rag"] = {
+        command: "npx",
+        args: ["code-graph-rag", "mcp-serve"],
+        type: "stdio",
+    };
+    settings.mcpServers = mcpServers;
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    spinner.succeed("MCP server registered in ~/.claude/settings.json");
+}
+export function registerInstallMcpCommand(program) {
+    program
+        .command("install-mcp")
+        .description("Register the MCP server in Claude Code settings")
+        .action(runInstallMcp);
+}
+//# sourceMappingURL=install-mcp.js.map

package/dist/cli/commands/install-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-mcp.js","sourceRoot":"","sources":["../../../src/cli/commands/install-mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,OAAO,GAAG,GAAG,CAAC,0BAA0B,CAAC,CAAC,KAAK,EAAE,CAAC;IAExD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAEtD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,UAAU,GACb,QAAQ,CAAC,UAAsC,IAAI,EAAE,CAAC;IACzD,UAAU,CAAC,gBAAgB,CAAC,GAAG;QAC7B,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAC;QACrC,IAAI,EAAE,OAAO;KACd,CAAC;IACF,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IAEjC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,aAAa,CAAC,CAAC;AAC3B,CAAC"}

package/dist/cli/commands/query.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerQueryCommand(program: Command): void;

package/dist/cli/commands/query.js

@@ -0,0 +1,92 @@
+import { resolve } from "node:path";
+import { createInterface } from "node:readline";
+import { loadConfig } from "../../config.js";
+import { createConnection } from "../../db/connection.js";
+export function registerQueryCommand(program) {
+    program
+        .command("query [cypher]")
+        .description("Run Cypher queries against the graph (interactive REPL if no query given)")
+        .option("--callers <functionName>", "Find all callers of a function")
+        .option("--dependencies <filePath>", "Find dependencies of a file")
+        .option("--structure", "Show high-level repo structure")
+        .action(async (cypher, opts) => {
+        const repoPath = resolve(".");
+        const config = loadConfig(repoPath);
+        const db = createConnection(config.neo4j);
+        const healthy = await db.healthCheck();
+        if (!healthy) {
+            console.log("Neo4j is not running. Run `code-graph-rag init` to start it.");
+            process.exit(1);
+        }
+        if (opts.callers) {
+            cypher =
+                "MATCH (caller:Function)-[:CALLS]->(callee:Function {name: $name}) RETURN caller.name AS caller, caller.filePath AS file, caller.startLine AS line";
+        }
+        else if (opts.dependencies) {
+            cypher =
+                "MATCH (f:File)-[:IMPORTS]->(dep:File) WHERE f.relativePath = $path OR f.path ENDS WITH $path RETURN dep.relativePath AS dependency";
+        }
+        else if (opts.structure) {
+            cypher =
+                "MATCH (r:Repository)-[:CONTAINS_FILE]->(f:File) RETURN r.name AS repo, f.language AS language, count(f) AS files ORDER BY files DESC";
+        }
+        if (cypher) {
+            const params = {};
+            if (opts.callers)
+                params.name = opts.callers;
+            if (opts.dependencies)
+                params.path = opts.dependencies;
+            await runQuery(db, cypher, params);
+            await db.close();
+            return;
+        }
+        // Interactive REPL
+        console.log("code-graph-rag query REPL (type 'exit' to quit)\n");
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: "cypher> ",
+        });
+        rl.prompt();
+        rl.on("line", async (line) => {
+            const trimmed = line.trim();
+            if (trimmed === "exit" || trimmed === "quit") {
+                await db.close();
+                rl.close();
+                return;
+            }
+            if (trimmed) {
+                await runQuery(db, trimmed, {});
+            }
+            rl.prompt();
+        });
+    });
+}
+async function runQuery(db, cypher, params) {
+    const session = db.session();
+    try {
+        const result = await session.run(cypher, params);
+        if (result.records.length === 0) {
+            console.log("(no results)");
+            return;
+        }
+        const keys = result.records[0].keys;
+        console.log(keys.join("\t"));
+        console.log(keys.map(() => "---").join("\t"));
+        for (const record of result.records) {
+            const values = keys.map((k) => {
+                const v = record.get(k);
+                return typeof v === "object" ? JSON.stringify(v) : String(v);
+            });
+            console.log(values.join("\t"));
+        }
+        console.log(`\n${result.records.length} row(s)`);
+    }
+    catch (error) {
+        console.error(`Query error: ${error instanceof Error ? error.message : error}`);
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/cli/commands/query.js.map

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

package/dist/cli/commands/setup.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerSetupCommand(parent: Command): void;

package/dist/cli/commands/setup.js

@@ -0,0 +1,15 @@
+import { runInit } from "./init.js";
+import { runInstallMcp } from "./install-mcp.js";
+import { runInstallHook } from "./install-hook.js";
+export function registerSetupCommand(parent) {
+    parent
+        .command("setup")
+        .description("Full setup: init + install MCP server + install git hook")
+        .action(async () => {
+        await runInit();
+        await runInstallMcp();
+        await runInstallHook();
+        console.log("\nReady! Your AI agent now has access to graph-powered code search.");
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM;SACH,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,OAAO,EAAE,CAAC;QAChB,MAAM,aAAa,EAAE,CAAC;QACtB,MAAM,cAAc,EAAE,CAAC;QAEvB,OAAO,CAAC,GAAG,CACT,qEAAqE,CACtE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerStatusCommand(program: Command): void;