@leanlabsinnov/codegraph 0.1.1 → 0.1.3

package/dist/{chunk-AMJXGXLM.js → chunk-5WYXRWEY.js}

@@ -5,7 +5,7 @@ import {
 import {
   GraphDb,
   defaultDbPath
-} from "./chunk-VFE242Y7.js";
+} from "./chunk-AVP24SX5.js";
 import {
   DEFAULT_CONFIG,
   LLM_PRESETS,
@@ -374,20 +374,20 @@ function checkNodeVersion() {
     detail: `v${version} (codegraph requires >= 20)`
   };
 }
-async function checkWritable(name, path6) {
+async function checkWritable(name, path8) {
   try {
-    await mkdir2(dirname(path6), { recursive: true });
+    await mkdir2(dirname(path8), { recursive: true });
     try {
-      await access(path6, constants.W_OK);
+      await access(path8, constants.W_OK);
     } catch {
-      await access(dirname(path6), constants.W_OK);
+      await access(dirname(path8), constants.W_OK);
     }
-    return { name, status: "ok", detail: path6 };
+    return { name, status: "ok", detail: path8 };
   } catch (err) {
     return {
       name,
       status: "fail",
-      detail: `${path6} (${err instanceof Error ? err.message : String(err)})`
+      detail: `${path8} (${err instanceof Error ? err.message : String(err)})`
     };
   }
 }
@@ -433,17 +433,19 @@ async function selfTestKuzu(dbPath, embeddingDimension) {
   try {
     await db.connect();
     await db.migrate();
-    const result = await db.query("RETURN 1 AS result");
-    const vectorReady = db.hasVectorIndex();
+    const result = await db.query(
+      `RETURN array_cosine_similarity([1.0, 0.0], [1.0, 0.0]) AS similarity, true AS ok`
+    );
     await db.close();
-    if (result.data[0]?.result === 1) {
-      return {
-        name: "kuzu round-trip",
-        status: vectorReady ? "ok" : "warn",
-        detail: vectorReady ? "ok (vector index ready)" : "ok (vector extension missing; semantic search disabled)"
-      };
+    const row = result.data[0];
+    if (row?.ok !== true || typeof row.similarity !== "number") {
+      return { name: "kuzu round-trip", status: "fail", detail: "unexpected result" };
     }
-    return { name: "kuzu round-trip", status: "fail", detail: "unexpected result" };
+    return {
+      name: "kuzu round-trip",
+      status: "ok",
+      detail: "ok (brute-force semantic search ready)"
+    };
   } catch (err) {
     await db.close().catch(() => {
     });
@@ -456,7 +458,8 @@ async function selfTestKuzu(dbPath, embeddingDimension) {
 }
 
 // src/commands/index.ts
-import path5 from "path";
+import { rm } from "fs/promises";
+import path6 from "path";
 
 // ../ingestion/src/parser.ts
 import { readFile as readFile2 } from "fs/promises";
@@ -877,9 +880,11 @@ function functionFromDeclaration(node, input, source) {
   if (!nameNode) return null;
   const name = nodeText(nameNode, source);
   const line = startLine(node);
+  const isComponent = (input.language === "tsx" || input.language === "jsx") && isPascalCase(name) && containsJsx(node.childForFieldName("body"));
+  const kind = isComponent ? "Component" : "Function";
   const id = makeNodeId({
     repoId: input.repoId,
-    kind: "Function",
+    kind,
     path: input.relativePath,
     name,
     line
@@ -887,7 +892,7 @@ function functionFromDeclaration(node, input, source) {
   return {
     node: {
       id,
-      kind: "Function",
+      kind,
       repoId: input.repoId,
       name,
       path: input.relativePath,
@@ -896,7 +901,7 @@ function functionFromDeclaration(node, input, source) {
       signature: extractSignature(node, source),
       leadingComment: leadingCommentFor(parentForLeadingComment(node), source),
       isExported: isExported(node),
-      isAsync: hasAsyncModifier(node, source)
+      ...kind === "Function" ? { isAsync: hasAsyncModifier(node, source) } : {}
     }
   };
 }
@@ -966,6 +971,9 @@ function variableOrArrowFromDeclaration(node, input, source) {
   const nameNode = decl.childForFieldName("name");
   const value = decl.childForFieldName("value");
   if (!nameNode) return null;
+  if (nameNode.type !== "identifier" && nameNode.type !== "property_identifier") {
+    return null;
+  }
   const name = nodeText(nameNode, source);
   const line = startLine(decl);
   const isArrow = value?.type === "arrow_function" || value?.type === "function_expression";
@@ -1030,6 +1038,10 @@ function extractSignature(node, source) {
 function extractCalleeName(callee, source) {
   if (callee.type === "identifier") return nodeText(callee, source);
   if (callee.type === "member_expression") {
+    const object = callee.childForFieldName("object");
+    if (object && object.type === "identifier") {
+      return nodeText(object, source);
+    }
     const property = callee.childForFieldName("property");
     if (property) return nodeText(property, source);
   }
@@ -1144,7 +1156,8 @@ function resolveEdges(input) {
         repoId: input.repoId,
         fromPath: edge.fromPath ?? "",
         spec: edge.unresolvedTargetName,
-        known: input.knownFilePaths
+        known: input.knownFilePaths,
+        ...input.tsconfigPaths ? { tsconfigPaths: input.tsconfigPaths } : {}
       });
       if (!resolved) {
         dropped++;
@@ -1166,10 +1179,22 @@ function resolveEdges(input) {
   return { resolved: out, dropped };
 }
 function resolveImportPath(input) {
-  const { fromPath, spec, known } = input;
-  if (!spec.startsWith(".") && !spec.startsWith("/")) return null;
-  const baseDir = path2.posix.dirname(toPosix(fromPath));
-  const joined = path2.posix.normalize(path2.posix.join(baseDir, toPosix(spec)));
+  const { fromPath, spec, known, tsconfigPaths } = input;
+  if (spec.startsWith(".") || spec.startsWith("/")) {
+    const baseDir = path2.posix.dirname(toPosix(fromPath));
+    const joined = path2.posix.normalize(path2.posix.join(baseDir, toPosix(spec)));
+    return firstMatchingCandidate(joined, known);
+  }
+  if (tsconfigPaths) {
+    const candidates = expandAliasCandidates(spec, tsconfigPaths);
+    for (const c of candidates) {
+      const resolved = firstMatchingCandidate(c, known);
+      if (resolved) return resolved;
+    }
+  }
+  return null;
+}
+function firstMatchingCandidate(joined, known) {
   const candidates = [joined];
   const ext = path2.posix.extname(joined);
   const stem = ext ? joined.slice(0, -ext.length) : joined;
@@ -1180,12 +1205,37 @@ function resolveImportPath(input) {
   }
   return null;
 }
+function expandAliasCandidates(spec, cfg) {
+  const sortedPatterns = Object.keys(cfg.paths).sort((a, b) => b.length - a.length);
+  const out = [];
+  for (const pattern of sortedPatterns) {
+    const replacements = cfg.paths[pattern] ?? [];
+    if (pattern.endsWith("/*")) {
+      const prefix = pattern.slice(0, -1);
+      if (!spec.startsWith(prefix)) continue;
+      const tail = spec.slice(prefix.length);
+      for (const r of replacements) {
+        const rTail = r.endsWith("/*") ? r.slice(0, -1) : r.endsWith("*") ? r.slice(0, -1) : r;
+        const joined = path2.posix.normalize(
+          path2.posix.join(toPosix(cfg.baseUrl), `${rTail}${tail}`)
+        );
+        out.push(joined);
+      }
+    } else if (spec === pattern) {
+      for (const r of replacements) {
+        const joined = path2.posix.normalize(path2.posix.join(toPosix(cfg.baseUrl), r));
+        out.push(joined);
+      }
+    }
+  }
+  return out;
+}
 function toPosix(p) {
   return p.split(path2.sep).join("/");
 }
 
 // ../ingestion/src/orchestrator.ts
-import { readFile as readFile4, stat as stat2 } from "fs/promises";
+import { readFile as readFile5, stat as stat2 } from "fs/promises";
 import { cpus } from "os";
 import { join as join2 } from "path";
 import { createHash as createHash2 } from "crypto";
@@ -1224,25 +1274,127 @@ async function embedNodes(nodes, opts) {
   return result;
 }
 
-// ../ingestion/src/repo-walker.ts
-import { readFile as readFile3, readdir, stat } from "fs/promises";
+// ../ingestion/src/tsconfig.ts
+import { readFile as readFile3 } from "fs/promises";
 import path3 from "path";
+async function loadTsconfigPaths(repoRoot) {
+  for (const name of ["tsconfig.json", "jsconfig.json"]) {
+    const raw = await readIfExists(path3.join(repoRoot, name));
+    if (!raw) continue;
+    let parsed;
+    try {
+      parsed = JSON.parse(stripJsonComments(raw));
+    } catch {
+      continue;
+    }
+    const co = parsed.compilerOptions ?? {};
+    const paths = co.paths ?? {};
+    if (Object.keys(paths).length === 0) continue;
+    const baseUrl = (co.baseUrl ?? ".").trim();
+    return {
+      baseUrl: toPosix2(baseUrl),
+      paths
+    };
+  }
+  return null;
+}
+async function readIfExists(filePath) {
+  try {
+    return await readFile3(filePath, "utf8");
+  } catch {
+    return null;
+  }
+}
+function stripJsonComments(input) {
+  let out = "";
+  let i = 0;
+  let inString = false;
+  let stringChar = "";
+  while (i < input.length) {
+    const c = input[i];
+    const next = input[i + 1];
+    if (inString) {
+      out += c;
+      if (c === "\\" && next !== void 0) {
+        out += next;
+        i += 2;
+        continue;
+      }
+      if (c === stringChar) inString = false;
+      i++;
+      continue;
+    }
+    if (c === '"' || c === "'") {
+      inString = true;
+      stringChar = c;
+      out += c;
+      i++;
+      continue;
+    }
+    if (c === "/" && next === "/") {
+      while (i < input.length && input[i] !== "\n") i++;
+      continue;
+    }
+    if (c === "/" && next === "*") {
+      i += 2;
+      while (i < input.length && !(input[i] === "*" && input[i + 1] === "/")) i++;
+      i += 2;
+      continue;
+    }
+    out += c;
+    i++;
+  }
+  return removeTrailingCommas(out);
+}
+function removeTrailingCommas(s) {
+  return s.replace(/,\s*([}\]])/g, "$1");
+}
+function toPosix2(p) {
+  return p.split(path3.sep).join("/");
+}
+
+// ../ingestion/src/repo-walker.ts
+import { readFile as readFile4, readdir, stat } from "fs/promises";
+import path4 from "path";
 import ignore from "ignore";
 var ALWAYS_SKIP_DIRS = /* @__PURE__ */ new Set([
   ".git",
+  ".hg",
+  ".svn",
   "node_modules",
   ".next",
+  ".nuxt",
+  ".svelte-kit",
   "dist",
   "build",
   "out",
   ".turbo",
   ".cache",
+  ".parcel-cache",
   "coverage",
+  ".nyc_output",
   ".idea",
-  ".vscode"
+  ".vscode",
+  ".vs",
+  "venv",
+  ".venv",
+  "env",
+  "__pycache__",
+  "site-packages",
+  ".pytest_cache",
+  ".mypy_cache",
+  ".ruff_cache",
+  ".tox",
+  ".eggs",
+  "target",
+  "vendor",
+  "Pods",
+  "DerivedData",
+  ".gradle",
+  ".terraform"
 ]);
 async function walkRepo(root) {
-  const base = path3.resolve(root);
+  const base = path4.resolve(root);
   const matcher = ignore();
   await loadGitignoreInto(matcher, base);
   const out = [];
@@ -1259,7 +1411,7 @@ async function walkDir(absDir, relDir, ig, out) {
   for (const entry of entries) {
     const name = entry.name;
     const rel = relDir ? `${relDir}/${name}` : name;
-    const abs = path3.join(absDir, name);
+    const abs = path4.join(absDir, name);
     if (entry.isDirectory()) {
       if (ALWAYS_SKIP_DIRS.has(name)) continue;
       if (ig.ignores(`${rel}/`)) continue;
@@ -1273,9 +1425,9 @@ async function walkDir(absDir, relDir, ig, out) {
   }
 }
 async function loadGitignoreInto(ig, absDir) {
-  const file = path3.join(absDir, ".gitignore");
+  const file = path4.join(absDir, ".gitignore");
   try {
-    const text = await readFile3(file, "utf8");
+    const text = await readFile4(file, "utf8");
     ig.add(text);
   } catch {
   }
@@ -1305,7 +1457,7 @@ async function indexRepo(opts) {
   await runWithConcurrency(parsable, parallelism, async (entry) => {
     const abs = join2(opts.repoPath, entry.rel);
     try {
-      const source = await readFile4(abs, "utf8");
+      const source = await readFile5(abs, "utf8");
       const result = await extractFile({
         repoId: opts.repoId,
         relativePath: entry.rel,
@@ -1322,25 +1474,33 @@ async function indexRepo(opts) {
       opts.onProgress?.({ type: "parse", parsed: parsedCount, total: parsable.length });
     }
   });
+  const tsconfigPaths = await loadTsconfigPaths(opts.repoPath);
   const { resolved, dropped } = resolveEdges({
     repoId: opts.repoId,
     nodes: allNodes,
     edges: allEdges,
-    knownFilePaths
+    knownFilePaths,
+    ...tsconfigPaths ? { tsconfigPaths } : {}
   });
-  await opts.graphDb.deleteByRepo(opts.repoId);
-  await opts.graphDb.upsertNodes(allNodes);
-  await opts.graphDb.upsertEdges(resolved);
-  opts.onProgress?.({ type: "upsert", nodes: allNodes.length, edges: resolved.length });
-  let embeddingCount = 0;
+  let embeddedById = /* @__PURE__ */ new Map();
   if (!opts.skipEmbeddings && opts.router) {
     const embedded = await embedNodes(allNodes, {
       router: opts.router,
       onBatch: ({ embedded: embedded2, total }) => opts.onProgress?.({ type: "embed", embedded: embedded2, total })
     });
-    await persistEmbeddings(opts.graphDb, embedded);
-    embeddingCount = embedded.length;
+    embeddedById = new Map(embedded.map((e) => [e.id, e]));
   }
+  const nodePayload = allNodes.map((n) => {
+    const e = embeddedById.get(n.id);
+    const base = n;
+    if (!e) return base;
+    return { ...base, embedding: e.embedding, embeddingNamespace: e.embeddingNamespace };
+  });
+  await opts.graphDb.deleteByRepo(opts.repoId);
+  await opts.graphDb.upsertNodes(nodePayload);
+  await opts.graphDb.upsertEdges(resolved);
+  opts.onProgress?.({ type: "upsert", nodes: allNodes.length, edges: resolved.length });
+  const embeddingCount = embeddedById.size;
   return {
     durationMs: Date.now() - start,
     parsedFiles: parsedCount - failed,
@@ -1351,22 +1511,6 @@ async function indexRepo(opts) {
     droppedEdges: dropped
   };
 }
-async function persistEmbeddings(graphDb, embedded) {
-  if (embedded.length === 0) return;
-  const BATCH = 100;
-  for (let i = 0; i < embedded.length; i += BATCH) {
-    const batch = embedded.slice(i, i + BATCH);
-    await graphDb.query(
-      `
-        UNWIND $batch AS e
-        MATCH (n:Symbol { id: e.id })
-        SET n.embedding = e.embedding,
-            n.embeddingNamespace = e.embeddingNamespace
-      `,
-      { batch }
-    );
-  }
-}
 async function runWithConcurrency(items, concurrency, fn) {
   let cursor = 0;
   const runners = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
@@ -1385,10 +1529,10 @@ import kleur4 from "kleur";
 
 // src/repo-id.ts
 import { createHash as createHash3 } from "crypto";
-import path4 from "path";
+import path5 from "path";
 function repoIdFromPath(absPath) {
-  const base = path4.basename(path4.resolve(absPath));
-  const sha = createHash3("sha1").update(path4.resolve(absPath)).digest("hex").slice(0, 8);
+  const base = path5.basename(path5.resolve(absPath));
+  const sha = createHash3("sha1").update(path5.resolve(absPath)).digest("hex").slice(0, 8);
   const safe = base.replace(/[^A-Za-z0-9_-]/g, "_");
   return `${safe}-${sha}`;
 }
@@ -1396,7 +1540,7 @@ function repoIdFromPath(absPath) {
 // src/commands/index.ts
 async function runIndexCommand(opts) {
   const config = await loadConfig();
-  const absolutePath = path5.resolve(opts.repoPath);
+  const absolutePath = path6.resolve(opts.repoPath);
   const repoId = repoIdFromPath(absolutePath);
   const dbPath = config.data.dbPath ?? defaultDbPath();
   console.log(kleur4.dim(`repo:    ${absolutePath}`));
@@ -1434,8 +1578,10 @@ async function runIndexCommand(opts) {
       router = void 0;
     }
   }
-  let parseBar = null;
-  let embedBar = null;
+  const bars = {
+    parse: null,
+    embed: null
+  };
   const result = await indexRepo({
     repoId,
     repoPath: absolutePath,
@@ -1447,8 +1593,8 @@ async function runIndexCommand(opts) {
         console.log(kleur4.dim(`walked   ${event.files} files`));
       }
       if (event.type === "parse") {
-        if (!parseBar) parseBar = new ProgressBar("parsing", event.total);
-        parseBar.update(event.parsed);
+        if (!bars.parse) bars.parse = new ProgressBar("parsing", event.total);
+        bars.parse.update(event.parsed);
       }
       if (event.type === "upsert") {
         console.log(
@@ -1456,13 +1602,13 @@ async function runIndexCommand(opts) {
         );
       }
       if (event.type === "embed") {
-        if (!embedBar) embedBar = new ProgressBar("embedding", event.total);
-        embedBar.update(event.embedded);
+        if (!bars.embed) bars.embed = new ProgressBar("embedding", event.total);
+        bars.embed.update(event.embedded);
       }
     }
   });
-  parseBar?.done();
-  embedBar?.done();
+  bars.parse?.done();
+  bars.embed?.done();
   await graphDb.close();
   console.log();
   console.log(
@@ -1478,7 +1624,7 @@ async function runIndexCommand(opts) {
 }
 async function runStatusCommand(opts) {
   const config = await loadConfig();
-  const absolutePath = path5.resolve(opts.repoPath);
+  const absolutePath = path6.resolve(opts.repoPath);
   const repoId = repoIdFromPath(absolutePath);
   const graphDb = new GraphDb({
     dbPath: config.data.dbPath ?? defaultDbPath(),
@@ -1496,10 +1642,62 @@ async function runStatusCommand(opts) {
     throw err;
   }
 }
+async function runWipeCommand(opts) {
+  const config = await loadConfig();
+  const dbPath = config.data.dbPath ?? defaultDbPath();
+  if (opts.repoPath) {
+    const absolutePath = path6.resolve(opts.repoPath);
+    const repoId = repoIdFromPath(absolutePath);
+    if (!opts.yes) {
+      console.log(
+        kleur4.yellow(
+          `Will delete all graph rows for ${kleur4.bold(repoId)} (${absolutePath}). Pass --yes to confirm.`
+        )
+      );
+      return;
+    }
+    const spinner2 = makeSpinner(`Wiping ${repoId}`).start();
+    const graphDb = new GraphDb({
+      dbPath,
+      embeddingDimension: config.llm.embeddings.dimension
+    });
+    try {
+      await graphDb.connect();
+      await graphDb.migrate();
+      await graphDb.deleteByRepo(repoId);
+      await graphDb.close();
+      spinner2.succeed(`Removed ${repoId} from ${dbPath}`);
+    } catch (err) {
+      spinner2.fail("Wipe failed");
+      throw err;
+    }
+    return;
+  }
+  if (!opts.yes) {
+    console.log(
+      kleur4.yellow(
+        `Will delete the entire graph directory at ${kleur4.bold(dbPath)}. Pass --yes to confirm.`
+      )
+    );
+    return;
+  }
+  const spinner = makeSpinner(`Removing ${dbPath}`).start();
+  try {
+    await rm(dbPath, { recursive: true, force: true });
+    spinner.succeed(`Graph directory removed. Re-run \`codegraph index <repo>\` to rebuild.`);
+  } catch (err) {
+    spinner.fail("Wipe failed");
+    throw err;
+  }
+}
+
+// src/commands/init.ts
+import path7 from "path";
+import { confirm, password as password2, select as select2 } from "@inquirer/prompts";
 
 // ../mcp-server/dist/index.js
 import { createHash as createHash4 } from "crypto";
-import { mkdir as mkdir3, readFile as readFile5, writeFile as writeFile2 } from "fs/promises";
+import { mkdir as mkdir3, readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
 import { homedir } from "os";
 import { dirname as dirname3, resolve } from "path";
 import { randomUUID } from "crypto";
@@ -1595,8 +1793,8 @@ var affectedByTool = {
     inputSchema,
     annotations: { readOnlyHint: true, idempotentHint: true }
   },
-  handler: async ({ symbol, path: path6, depth, limit }, deps) => cachedJsonResult("affected_by", { symbol, path: path6, depth, limit }, deps, async () => {
-    const where = path6 ? "WHERE target.name = $symbol AND target.path = $path" : "WHERE target.name = $symbol";
+  handler: async ({ symbol, path: path8, depth, limit }, deps) => cachedJsonResult("affected_by", { symbol, path: path8, depth, limit }, deps, async () => {
+    const where = path8 ? "WHERE target.name = $symbol AND target.path = $path" : "WHERE target.name = $symbol";
     const rows = await deps.graph.query(
       `MATCH (target:Symbol) ${where}
          WITH target
@@ -1605,9 +1803,9 @@ var affectedByTool = {
          RETURN affected.id AS id, affected.name AS name, affected.kind AS kind,
                 affected.path AS path, distance
          ORDER BY distance ASC, affected.path ASC LIMIT $limit`,
-      { symbol, path: path6 ?? null, limit }
+      { symbol, path: path8 ?? null, limit }
     );
-    return { symbol, path: path6 ?? null, depth, count: rows.length, affected: rows };
+    return { symbol, path: path8 ?? null, depth, count: rows.length, affected: rows };
   })
 };
 var inputSchema2 = {
@@ -1624,14 +1822,14 @@ var blastRadiusTool = {
     inputSchema: inputSchema2,
     annotations: { readOnlyHint: true, idempotentHint: true }
   },
-  handler: async ({ symbol, path: path6, depth, sampleSize }, deps) => cachedJsonResult("blast_radius", { symbol, path: path6, depth, sampleSize }, deps, async () => {
-    const where = path6 ? "WHERE target.name = $symbol AND target.path = $path" : "WHERE target.name = $symbol";
+  handler: async ({ symbol, path: path8, depth, sampleSize }, deps) => cachedJsonResult("blast_radius", { symbol, path: path8, depth, sampleSize }, deps, async () => {
+    const where = path8 ? "WHERE target.name = $symbol AND target.path = $path" : "WHERE target.name = $symbol";
     const [stats] = await deps.graph.query(
       `MATCH (target:Symbol) ${where}
            WITH target
            MATCH (dependent:Symbol)-[:CALLS|IMPORTS|RENDERS*1..${depth}]->(target)
            RETURN count(DISTINCT dependent) AS total`,
-      { symbol, path: path6 ?? null }
+      { symbol, path: path8 ?? null }
     );
     const sample = await deps.graph.query(
       `MATCH (target:Symbol) ${where}
@@ -1641,11 +1839,11 @@ var blastRadiusTool = {
            RETURN dependent.id AS id, dependent.name AS name, dependent.kind AS kind,
                   dependent.path AS path, distance
            ORDER BY distance ASC, dependent.path ASC LIMIT $sampleSize`,
-      { symbol, path: path6 ?? null, sampleSize }
+      { symbol, path: path8 ?? null, sampleSize }
     );
     return {
       symbol,
-      path: path6 ?? null,
+      path: path8 ?? null,
       depth,
       totalDependents: stats?.total ?? 0,
       sample
@@ -1712,15 +1910,46 @@ var getComponentTreeTool = {
     annotations: { readOnlyHint: true, idempotentHint: true }
   },
   handler: async ({ name, depth }, deps) => cachedJsonResult("get_component_tree", { name, depth }, deps, async () => {
-    const rows = await deps.graph.query(
-      `MATCH (root:Symbol {kind: 'Component', name: $name})
-         OPTIONAL MATCH path = (root)-[:RENDERS*1..${depth}]->(child:Symbol)
-         WHERE child.kind = 'Component'
-         WITH root, collect(DISTINCT { name: child.name, id: child.id, path: child.path, depth: length(path) }) AS children
-         RETURN root.id AS rootId, root.name AS rootName, root.path AS rootPath, children`,
+    const rootRows = await deps.graph.query(
+      `MATCH (root:Symbol)
+         WHERE root.name = $name AND (root.kind = 'Component' OR root.kind = 'Function' OR root.kind = 'Class')
+         RETURN root.id AS rootId, root.name AS rootName, root.path AS rootPath, root.kind AS rootKind
+         ORDER BY CASE root.kind WHEN 'Component' THEN 0 WHEN 'Function' THEN 1 ELSE 2 END
+         LIMIT 1`,
       { name }
     );
-    return { name, depth, tree: rows[0] ?? null };
+    const root = rootRows[0];
+    if (!root) {
+      return {
+        name,
+        depth,
+        found: false,
+        root: null,
+        children: []
+      };
+    }
+    const children = await deps.graph.query(
+      `MATCH (root:Symbol {id: $rootId})
+         OPTIONAL MATCH p = (root)-[:RENDERS*1..${depth}]->(child:Symbol)
+         WITH child, min(length(p)) AS distance
+         WHERE child IS NOT NULL
+         RETURN child.id AS id, child.name AS name, child.kind AS kind,
+                child.path AS path, distance
+         ORDER BY distance ASC, child.name ASC`,
+      { rootId: root.rootId }
+    );
+    return {
+      name,
+      depth,
+      found: true,
+      root: {
+        id: root.rootId,
+        name: root.rootName,
+        path: root.rootPath,
+        kind: root.rootKind
+      },
+      children
+    };
   })
 };
 var inputSchema6 = {
@@ -1736,7 +1965,7 @@ var getDependenciesTool = {
     inputSchema: inputSchema6,
     annotations: { readOnlyHint: true, idempotentHint: true }
   },
-  handler: async ({ path: path6, depth, limit }, deps) => cachedJsonResult("get_dependencies", { path: path6, depth, limit }, deps, async () => {
+  handler: async ({ path: path8, depth, limit }, deps) => cachedJsonResult("get_dependencies", { path: path8, depth, limit }, deps, async () => {
     const rows = await deps.graph.query(
       `MATCH (root:Symbol)
          WHERE root.kind = 'File' AND root.path = $path
@@ -1746,9 +1975,9 @@ var getDependenciesTool = {
          WHERE dep IS NOT NULL
          RETURN dep.id AS id, dep.path AS path, distance
          ORDER BY distance ASC, dep.path ASC LIMIT $limit`,
-      { path: path6, limit }
+      { path: path8, limit }
     );
-    return { path: path6, depth, count: rows.length, dependencies: rows };
+    return { path: path8, depth, count: rows.length, dependencies: rows };
   })
 };
 var inputSchema7 = {
@@ -1763,15 +1992,15 @@ var getFileContextTool = {
     inputSchema: inputSchema7,
     annotations: { readOnlyHint: true, idempotentHint: true }
   },
-  handler: async ({ path: path6, symbolLimit }, deps) => cachedJsonResult("get_file_context", { path: path6, symbolLimit }, deps, async () => {
+  handler: async ({ path: path8, symbolLimit }, deps) => cachedJsonResult("get_file_context", { path: path8, symbolLimit }, deps, async () => {
     const fileRows = await deps.graph.query(
       `MATCH (f:Symbol)
          WHERE f.kind = 'File' AND f.path = $path
          RETURN f.id AS id, f.path AS path, f.name AS name LIMIT 1`,
-      { path: path6 }
+      { path: path8 }
     );
     if (fileRows.length === 0) {
-      return { path: path6, found: false };
+      return { path: path8, found: false };
     }
     const [defined, imports, exports, importers] = await Promise.all([
       deps.graph.query(
@@ -1779,30 +2008,33 @@ var getFileContextTool = {
            WHERE f.kind = 'File' AND f.path = $path
            RETURN s.id AS id, s.name AS name, s.kind AS kind, s.lineStart AS line, s.signature AS signature
            ORDER BY s.lineStart LIMIT $limit`,
-        { path: path6, limit: symbolLimit }
+        { path: path8, limit: symbolLimit }
       ),
       deps.graph.query(
+        // Kuzu drops the node variable `t` from scope after `RETURN DISTINCT`, so the
+        // ORDER BY references the projection alias instead - using `t.path` here
+        // raises a "Variable t is not in scope" binder exception.
         `MATCH (f:Symbol)-[:IMPORTS]->(t:Symbol)
            WHERE f.kind = 'File' AND t.kind = 'File' AND f.path = $path
-           RETURN DISTINCT t.path AS path ORDER BY t.path`,
-        { path: path6 }
+           RETURN DISTINCT t.path AS path ORDER BY path`,
+        { path: path8 }
       ),
       deps.graph.query(
         `MATCH (f:Symbol)-[:EXPORTS]->(s:Symbol)
            WHERE f.kind = 'File' AND f.path = $path
            RETURN s.id AS id, s.name AS name, s.kind AS kind, s.lineStart AS line
            ORDER BY s.name`,
-        { path: path6 }
+        { path: path8 }
       ),
       deps.graph.query(
         `MATCH (other:Symbol)-[:IMPORTS]->(f:Symbol)
            WHERE other.kind = 'File' AND f.kind = 'File' AND f.path = $path
-           RETURN DISTINCT other.path AS path ORDER BY other.path`,
-        { path: path6 }
+           RETURN DISTINCT other.path AS path ORDER BY path`,
+        { path: path8 }
       )
     ]);
     return {
-      path: path6,
+      path: path8,
       found: true,
       file: fileRows[0],
       definedSymbols: defined,
@@ -2005,14 +2237,16 @@ var searchSemanticTool = {
       );
     }
     const namespace = `${deps.llm.embeddingNamespace.provider}:${deps.llm.embeddingNamespace.model}:${deps.llm.embeddingNamespace.dimension}`;
+    const dim = deps.llm.embeddingNamespace.dimension;
     return cachedJsonResult("search_semantic", { description, k, namespace }, deps, async () => {
       const rows = await deps.graph.query(
-        `CALL QUERY_VECTOR_INDEX('Symbol', 'embedding_idx', $vec, $k)
-           WITH node, distance
-           WHERE node.embeddingNamespace = $ns
-           RETURN node.id AS id, node.name AS name, node.kind AS kind, node.path AS path,
-                  node.lineStart AS line, node.signature AS signature, distance AS score
-           ORDER BY distance ASC`,
+        `MATCH (s:Symbol)
+           WHERE s.embeddingNamespace = $ns
+           RETURN s.id AS id, s.name AS name, s.kind AS kind, s.path AS path,
+                  s.lineStart AS line, s.signature AS signature,
+                  array_cosine_similarity(s.embedding, CAST($vec AS FLOAT[${dim}])) AS score
+           ORDER BY score DESC
+           LIMIT $k`,
         { vec: embedding, k, ns: namespace }
       );
       return { description, k, namespace, count: rows.length, matches: rows };
@@ -2214,23 +2448,23 @@ var DEFAULT_TTL = 30;
 function defaultConfigPath() {
   return resolve(homedir(), ".codegraph", "config.json");
 }
-async function readCodegraphConfig(path6 = defaultConfigPath()) {
+async function readCodegraphConfig(path8 = defaultConfigPath()) {
   try {
-    const raw = await readFile5(path6, "utf8");
+    const raw = await readFile6(path8, "utf8");
     return JSON.parse(raw);
   } catch (err) {
     if (err.code === "ENOENT") return {};
     throw err;
   }
 }
-async function writeCodegraphConfig(config, path6 = defaultConfigPath()) {
-  await mkdir3(dirname3(path6), { recursive: true });
-  await writeFile2(path6, `${JSON.stringify(config, null, 2)}
+async function writeCodegraphConfig(config, path8 = defaultConfigPath()) {
+  await mkdir3(dirname3(path8), { recursive: true });
+  await writeFile2(path8, `${JSON.stringify(config, null, 2)}
 `, "utf8");
 }
 async function resolveServerConfig(opts) {
-  const path6 = opts.configPath ?? defaultConfigPath();
-  const fileConfig = await readCodegraphConfig(path6);
+  const path8 = opts.configPath ?? defaultConfigPath();
+  const fileConfig = await readCodegraphConfig(path8);
   const env = process.env;
   let bearerToken = opts.overrides?.bearerToken ?? fileConfig.mcpToken ?? fileConfig.server?.bearerToken ?? env.CODEGRAPH_BEARER_TOKEN ?? "";
   let created = false;
@@ -2243,7 +2477,7 @@ async function resolveServerConfig(opts) {
         mcpToken: bearerToken,
         server: { ...fileConfig.server ?? {}, bearerToken }
       },
-      path6
+      path8
     );
   }
   const config = {
@@ -2252,7 +2486,7 @@ async function resolveServerConfig(opts) {
     bearerToken,
     cacheTtlSeconds: opts.overrides?.cacheTtlSeconds ?? fileConfig.server?.cacheTtlSeconds ?? (env.CODEGRAPH_CACHE_TTL ? Number(env.CODEGRAPH_CACHE_TTL) : DEFAULT_TTL)
   };
-  return { config, configPath: path6, created };
+  return { config, configPath: path8, created };
 }
 function resolveDbPath(fileConfig) {
   return fileConfig.data?.dbPath ?? process.env.CODEGRAPH_DB_PATH ?? void 0;
@@ -2300,7 +2534,7 @@ async function startMcpServer(portOrOptions) {
 async function loadGraphClient(dbPath) {
   let mod;
   try {
-    mod = await import("./src-7P6XREHJ.js");
+    mod = await import("./src-M7HSEMBT.js");
   } catch (err) {
     throw new Error(
       `Failed to import @codegraph/graph-db. Run \`pnpm -r build\` first. Underlying error: ${err instanceof Error ? err.message : String(err)}`
@@ -2358,8 +2592,473 @@ function adaptLlmRouter(router) {
   };
 }
 
+// src/commands/init.ts
+import boxen2 from "boxen";
+import kleur5 from "kleur";
+var TOTAL_STEPS = 6;
+async function runInitCommand() {
+  printWelcome();
+  const start = await confirm({ message: "Ready to get started?", default: true });
+  if (!start) {
+    console.log(kleur5.dim("Aborted. Run `codegraph init` again any time."));
+    return;
+  }
+  runEnvCheck();
+  await runLlmSetup();
+  await runLiveTest();
+  await runIndexStep();
+  const bearerToken = await runServeStep();
+  await runClientStep(bearerToken);
+  await runCelebration();
+}
+function printWelcome() {
+  printBanner();
+  const description = [
+    kleur5.bold("CodeGraph") + " parses your JS/TS repo with tree-sitter, stores nodes (Function, Class,",
+    "Route\u2026) and edges (CALLS, IMPORTS, RENDERS\u2026) in an embedded Kuzu graph with",
+    "vector embeddings, then runs a local MCP server your AI assistant can call.",
+    "",
+    kleur5.dim("This wizard will:"),
+    `  ${kleur5.cyan("1.")} Configure an LLM provider (cloud or local)`,
+    `  ${kleur5.cyan("2.")} Verify your credentials with a live round-trip`,
+    `  ${kleur5.cyan("3.")} Index this repo into the graph`,
+    `  ${kleur5.cyan("4.")} Show you how to boot the MCP server`,
+    `  ${kleur5.cyan("5.")} Print a copy-paste config for your AI client`
+  ].join("\n");
+  process.stdout.write(
+    `${boxen2(description, {
+      padding: 1,
+      margin: { top: 0, bottom: 1, left: 0, right: 0 },
+      borderStyle: "round",
+      borderColor: "cyan",
+      title: kleur5.bold("Welcome"),
+      titleAlignment: "left"
+    })}
+`
+  );
+}
+function stepHeader(n, label) {
+  console.log();
+  console.log(
+    kleur5.cyan(`\u2500\u2500\u2500\u2500 Step ${n}/${TOTAL_STEPS}: ${kleur5.bold(label)} ${"\u2500".repeat(Math.max(4, 40 - label.length))}`)
+  );
+}
+function runEnvCheck() {
+  stepHeader(1, "Environment check");
+  const version = process.versions.node;
+  const major = Number(version.split(".")[0] ?? 0);
+  if (major < 20) {
+    console.log(`${kleur5.red("\u2717")}  node version  v${version} ${kleur5.red("(codegraph requires >= 20)")}`);
+    throw new Error(`Node ${version} is too old; install Node 20+ and re-run \`codegraph init\`.`);
+  }
+  console.log(`${kleur5.green("\u2713")}  node version  ${kleur5.dim(`v${version}`)}`);
+}
+async function runLlmSetup() {
+  stepHeader(2, "LLM setup");
+  const mode = await select2({
+    message: "How would you like to power CodeGraph?",
+    choices: [
+      {
+        name: "Cloud provider",
+        value: "cloud",
+        description: "OpenAI, Anthropic, or Google. Fastest setup, requires an API key."
+      },
+      {
+        name: "Local (Ollama)",
+        value: "local",
+        description: "Fully private. Requires Ollama running on :11434."
+      }
+    ]
+  });
+  let preset;
+  if (mode === "local") {
+    preset = "local-ollama";
+  } else {
+    preset = await select2({
+      message: "Which cloud provider?",
+      choices: [
+        {
+          name: "OpenAI",
+          value: "byo-openai",
+          description: "gpt-4o-mini + text-embedding-3-small"
+        },
+        {
+          name: "Anthropic",
+          value: "byo-anthropic",
+          description: "claude-3-5-haiku (gen) + OpenAI text-embedding-3-small (embed)"
+        },
+        {
+          name: "Google",
+          value: "byo-google",
+          description: "gemini-1.5-flash + text-embedding-004"
+        }
+      ]
+    });
+  }
+  const lookup = LLM_PRESETS[preset];
+  if (!lookup) {
+    throw new Error(`Unknown preset "${preset}".`);
+  }
+  const config = await loadConfig();
+  config.llm = { ...config.llm, ...lookup };
+  await saveConfig(config);
+  console.log();
+  console.log(`${kleur5.green("\u2713")}  preset saved   ${kleur5.dim(`"${preset}" \u2192 ${configPath()}`)}`);
+  console.log(`${kleur5.dim("   namespace      ")}${kleur5.dim(namespaceLabel(config.llm))}`);
+  if (preset === "byo-anthropic") {
+    console.log();
+    console.log(
+      kleur5.yellow(
+        "Note: Anthropic has no embedding API, so codegraph uses OpenAI embeddings."
+      )
+    );
+    console.log(
+      kleur5.yellow("You'll need both ANTHROPIC_API_KEY and OPENAI_API_KEY set.")
+    );
+    await promptApiKey("ANTHROPIC_API_KEY");
+    await promptApiKey("OPENAI_API_KEY");
+    return;
+  }
+  const envVar = apiKeyEnvVarFor2(preset);
+  if (envVar) await promptApiKey(envVar);
+}
+function apiKeyEnvVarFor2(preset) {
+  if (preset === "byo-openai" || preset === "managed-stub") return "OPENAI_API_KEY";
+  if (preset === "byo-anthropic") return "ANTHROPIC_API_KEY";
+  if (preset === "byo-google") return "GOOGLE_GENERATIVE_AI_API_KEY";
+  return null;
+}
+async function promptApiKey(envVar) {
+  console.log();
+  if (process.env[envVar]) {
+    console.log(`${kleur5.green("\u2713")}  ${envVar} ${kleur5.dim("already set in this shell")}`);
+    return;
+  }
+  const provide = await confirm({
+    message: `${envVar} is not set. Provide it now? (input will be hidden)`,
+    default: true
+  });
+  if (!provide) {
+    console.log(
+      kleur5.yellow(`! Skipped. Export ${envVar} before \`codegraph index\` or \`codegraph serve\`.`)
+    );
+    return;
+  }
+  const value = await password2({ message: `${envVar}`, mask: "*" });
+  if (!value) {
+    console.log(kleur5.yellow(`! Empty value \u2014 skipping ${envVar}.`));
+    return;
+  }
+  process.env[envVar] = value;
+  console.log();
+  console.log(kleur5.dim("Add this to your ~/.zshrc or ~/.bashrc so it persists:"));
+  console.log(`  ${kleur5.cyan(`export ${envVar}=${maskTail(value)}`)}`);
+}
+function maskTail(value) {
+  if (value.length <= 8) return "*".repeat(value.length);
+  return `${"*".repeat(value.length - 4)}${value.slice(-4)}`;
+}
+async function runLiveTest() {
+  stepHeader(3, "Verify credentials");
+  while (true) {
+    const config = await loadConfig();
+    console.log(
+      kleur5.dim(
+        `  testing ${config.llm.generation.provider}:${config.llm.generation.model} + ${config.llm.embeddings.provider}:${config.llm.embeddings.model}`
+      )
+    );
+    const spinner = makeSpinner("Calling provider").start();
+    try {
+      const router = await createLlmRouter({ config: config.llm });
+      const result = await router.selfTest();
+      spinner.succeed("LLM provider reachable");
+      console.log(
+        kleur5.dim(
+          `   embed=${result.embedLatencyMs}ms gen=${result.generateLatencyMs}ms dims=${result.embedDims}`
+        )
+      );
+      return;
+    } catch (err) {
+      spinner.fail("LLM provider unreachable");
+      console.log(kleur5.red(`   ${err instanceof Error ? err.message : String(err)}`));
+      const choice = await select2({
+        message: "What now?",
+        choices: [
+          { name: "Retry (I'll fix it in another terminal)", value: "retry" },
+          { name: "Skip \u2014 set up LLM later", value: "skip" }
+        ]
+      });
+      if (choice === "skip") {
+        console.log(
+          kleur5.yellow(
+            "! Continuing without a verified LLM. Embeddings and semantic search will fail until you fix this."
+          )
+        );
+        return;
+      }
+    }
+  }
+}
+async function runIndexStep() {
+  stepHeader(4, "Index this repo");
+  const cwd = process.cwd();
+  const display = abbreviateHome(cwd);
+  const yes = await confirm({
+    message: `Index the current directory (${display}) now?`,
+    default: true
+  });
+  if (!yes) {
+    console.log(kleur5.dim("Skipped. Run this when ready:"));
+    console.log(`  ${kleur5.cyan(`codegraph index ${display}`)}`);
+    return;
+  }
+  console.log();
+  try {
+    await runIndexCommand({ repoPath: cwd });
+  } catch (err) {
+    console.log();
+    console.log(
+      kleur5.yellow(
+        `! Index failed: ${err instanceof Error ? err.message : String(err)}`
+      )
+    );
+    console.log(
+      kleur5.dim("   You can retry later with `codegraph index <path>`. Continuing wizard.")
+    );
+  }
+}
+async function runServeStep() {
+  stepHeader(5, "Boot the MCP server");
+  const { config: serverConfig, created } = await resolveServerConfig({});
+  if (created) {
+    console.log(kleur5.dim("  generated a new bearer token for this machine"));
+  }
+  const url = `http://${serverConfig.host}:${serverConfig.port}/mcp`;
+  const body = [
+    "Open a " + kleur5.bold("new terminal") + " and run:",
+    "",
+    `    ${kleur5.cyan("codegraph serve")}`,
+    "",
+    kleur5.dim("Expected output:"),
+    kleur5.dim(`    codegraph mcp listening on ${url}`),
+    "",
+    kleur5.dim("Keep that terminal running while you use CodeGraph.")
+  ].join("\n");
+  process.stdout.write(
+    `${boxen2(body, {
+      padding: { top: 0, bottom: 0, left: 2, right: 2 },
+      margin: { top: 1, bottom: 1, left: 0, right: 0 },
+      borderStyle: "round",
+      borderColor: "cyan",
+      title: kleur5.bold("Start the server"),
+      titleAlignment: "left"
+    })}
+`
+  );
+  await confirm({
+    message: "Done \u2014 the server is running in another terminal?",
+    default: true
+  });
+  return serverConfig.bearerToken;
+}
+async function runClientStep(bearerToken) {
+  stepHeader(6, "Connect your AI client");
+  const url = "http://127.0.0.1:3748/mcp";
+  const client = await select2({
+    message: "Which AI client are you connecting?",
+    choices: [
+      { name: "Cursor", value: "cursor" },
+      { name: "Claude Code", value: "claude" },
+      { name: "Windsurf", value: "windsurf" },
+      { name: "Skip for now", value: "skip" }
+    ]
+  });
+  if (client === "skip") {
+    console.log(
+      kleur5.dim("Skipped. See docs/clients.md for per-client configuration when ready.")
+    );
+    return;
+  }
+  if (client === "cursor") {
+    const snippet = JSON.stringify(
+      {
+        mcpServers: {
+          codegraph: {
+            url,
+            headers: { Authorization: `Bearer ${bearerToken}` }
+          }
+        }
+      },
+      null,
+      2
+    );
+    const body = [
+      "Create or edit " + kleur5.cyan(".cursor/mcp.json") + " in your project root:",
+      "",
+      kleur5.green(snippet),
+      "",
+      kleur5.dim("Then open Cursor \u2192 Settings \u2192 MCP."),
+      kleur5.dim("`codegraph` should appear as connected with 10 tools.")
+    ].join("\n");
+    process.stdout.write(
+      `${boxen2(body, {
+        padding: 1,
+        margin: { top: 1, bottom: 1, left: 0, right: 0 },
+        borderStyle: "round",
+        borderColor: "magenta",
+        title: kleur5.bold("Cursor config"),
+        titleAlignment: "left"
+      })}
+`
+    );
+  } else if (client === "claude") {
+    const oneliner = [
+      "claude mcp add --transport sse codegraph \\",
+      `  ${url} \\`,
+      `  --header "Authorization: Bearer ${bearerToken}"`
+    ].join("\n");
+    const body = [
+      "Run this in your terminal:",
+      "",
+      kleur5.green(oneliner),
+      "",
+      kleur5.dim("Then type ") + kleur5.cyan("/mcp") + kleur5.dim(" in Claude Code to confirm 10 tools are listed.")
+    ].join("\n");
+    process.stdout.write(
+      `${boxen2(body, {
+        padding: 1,
+        margin: { top: 1, bottom: 1, left: 0, right: 0 },
+        borderStyle: "round",
+        borderColor: "magenta",
+        title: kleur5.bold("Claude Code config"),
+        titleAlignment: "left"
+      })}
+`
+    );
+  } else {
+    const snippet = JSON.stringify(
+      {
+        mcpServers: {
+          codegraph: {
+            serverUrl: url,
+            headers: { Authorization: `Bearer ${bearerToken}` }
+          }
+        }
+      },
+      null,
+      2
+    );
+    const body = [
+      "Edit " + kleur5.cyan("~/.codeium/windsurf/mcp_config.json") + ":",
+      "",
+      kleur5.green(snippet),
+      "",
+      kleur5.dim("Then restart Windsurf or run ") + kleur5.cyan("/refresh-tools") + kleur5.dim(" in Cascade.")
+    ].join("\n");
+    process.stdout.write(
+      `${boxen2(body, {
+        padding: 1,
+        margin: { top: 1, bottom: 1, left: 0, right: 0 },
+        borderStyle: "round",
+        borderColor: "magenta",
+        title: kleur5.bold("Windsurf config"),
+        titleAlignment: "left"
+      })}
+`
+    );
+  }
+  await confirm({
+    message: "Done \u2014 your client is configured?",
+    default: true
+  });
+}
+async function runCelebration() {
+  console.log();
+  console.log(kleur5.cyan(`\u2500\u2500\u2500\u2500 ${kleur5.bold("Almost there!")} \u2500\u2500\u2500\u2500`));
+  console.log(
+    kleur5.dim(
+      'Ask your AI assistant something like: "What files are in this repo?"'
+    )
+  );
+  console.log(
+    kleur5.dim("It should call a `codegraph_*` MCP tool to answer.")
+  );
+  console.log();
+  const choice = await select2({
+    message: "How did it go?",
+    choices: [
+      { name: "It worked!", value: "worked" },
+      { name: "Skip", value: "skip" }
+    ]
+  });
+  const header = choice === "worked" ? kleur5.green().bold("\u2713  CodeGraph is fully connected!") : kleur5.cyan().bold("\u2713  CodeGraph setup complete");
+  const body = [
+    header,
+    "",
+    "Your AI assistant can now call these tools:",
+    `  ${kleur5.cyan("\u2022")} find_callers       \u2014 what calls a function`,
+    `  ${kleur5.cyan("\u2022")} get_component_tree \u2014 render dependency tree`,
+    `  ${kleur5.cyan("\u2022")} blast_radius       \u2014 impact of a change`,
+    `  ${kleur5.cyan("\u2022")} search_semantic    \u2014 symbol search by description`,
+    `  ${kleur5.cyan("\u2022")} nl_query           \u2014 natural-language Cypher`,
+    `  ${kleur5.dim("\u2026plus 5 more (search_symbol, find_file, get_file_context,")}`,
+    `  ${kleur5.dim("    get_dependencies, affected_by)")}`,
+    "",
+    kleur5.dim("Helpful next steps:"),
+    `  ${kleur5.cyan("codegraph doctor")}   ${kleur5.dim("\u2014 verify environment + LLM + Kuzu")}`,
+    `  ${kleur5.cyan("codegraph status")} ${kleur5.dim("<path>")}  ${kleur5.dim("\u2014 node/edge counts + embedding coverage")}`,
+    "",
+    kleur5.dim("Docs: https://github.com/leanlabsinnov/codegraph")
+  ].join("\n");
+  process.stdout.write(
+    `${boxen2(body, {
+      padding: 1,
+      margin: { top: 1, bottom: 1, left: 0, right: 0 },
+      borderStyle: "round",
+      borderColor: choice === "worked" ? "green" : "cyan"
+    })}
+`
+  );
+}
+function abbreviateHome(p) {
+  const home = process.env.HOME ?? process.env.USERPROFILE;
+  if (!home) return p;
+  const rel = path7.relative(home, p);
+  if (rel.startsWith("..")) return p;
+  return rel ? `~${path7.sep}${rel}` : "~";
+}
+
 // src/commands/serve.ts
+import kleur6 from "kleur";
+function providerEnvVar2(provider) {
+  if (provider === "openai") return "OPENAI_API_KEY";
+  if (provider === "anthropic") return "ANTHROPIC_API_KEY";
+  if (provider === "google") return "GOOGLE_GENERATIVE_AI_API_KEY";
+  return null;
+}
 async function runServeCommand(opts = {}) {
+  try {
+    const config = await loadConfig();
+    const missing = [];
+    for (const provider of [
+      config.llm.generation.provider,
+      config.llm.embeddings.provider
+    ]) {
+      const envVar = providerEnvVar2(provider);
+      if (envVar && !process.env[envVar] && !missing.includes(envVar)) {
+        missing.push(envVar);
+      }
+    }
+    if (missing.length > 0) {
+      process.stderr.write(
+        `${kleur6.yellow(
+          `! ${missing.join(", ")} not set in serve's environment. Semantic search and nl_query will fail until the variable is exported before \`codegraph serve\`.`
+        )}
+`
+      );
+    }
+  } catch {
+  }
   const spinner = makeSpinner("Booting MCP server").start();
   let started;
   try {
@@ -2400,13 +3099,16 @@ shutting down (${signal})...
 // src/program.ts
 function buildProgram() {
   const program = new Command();
-  program.name("codegraph").description("Live, queryable knowledge graph for your codebase").version("0.1.0").option("--verbose", "Print full stack traces on error").hook("preAction", (thisCommand) => {
+  program.name("codegraph").description("Live, queryable knowledge graph for your codebase").version("0.1.3").option("--verbose", "Print full stack traces on error").hook("preAction", (thisCommand) => {
     const opts = thisCommand.optsWithGlobals();
     if (opts.verbose) process.env.CODEGRAPH_VERBOSE = "1";
   });
   program.on("--help", () => {
     printBanner();
   });
+  program.command("init").description("Interactive setup wizard \u2014 LLM, credentials, index, MCP, client connect").action(async () => {
+    await runInitCommand();
+  });
   program.command("index").description("Parse a JS/TS repo into the local embedded graph").argument("<path>", "Path to the repo root").option("--no-embed", "Skip the embedding pass (faster, no LLM calls)").action(async (repoPath, opts) => {
     await runIndexCommand({ repoPath, noEmbed: opts.embed === false });
   });
@@ -2423,6 +3125,12 @@ function buildProgram() {
   program.command("doctor").description("Check environment, config, LLM credentials, and Kuzu DB health").action(async () => {
     await runDoctorCommand();
   });
+  program.command("wipe").description("Delete a single repo's slice (with [path]) or the entire on-disk graph").argument("[path]", "Repo path. Omit to wipe the whole graph directory.").option("--yes", "Skip the confirmation prompt", false).action(async (repoPath, opts) => {
+    await runWipeCommand({
+      ...repoPath ? { repoPath } : {},
+      yes: opts.yes === true
+    });
+  });
   const configCmd = program.command("config").description("Manage ~/.codegraph/config.json");
   configCmd.command("show").description("Print the resolved config").action(async () => {
     await runConfigShow();
@@ -2446,4 +3154,4 @@ export {
   renderError,
   buildProgram
 };
-//# sourceMappingURL=chunk-AMJXGXLM.js.map
+//# sourceMappingURL=chunk-5WYXRWEY.js.map