trace-mcp 1.5.3 → 1.6.0

package/dist/cli.js

@@ -4563,7 +4563,8 @@ var TraceMcpConfigSchema = z.object({
   watch: z.object({
     enabled: z.boolean().default(true),
     debounceMs: z.number().int().min(500).max(3e4).default(2e3)
-  }).default({})
+  }).default({}),
+  children: z.array(z.string()).optional()
 });
 function loadGlobalConfigRaw() {
   if (!fs2.existsSync(GLOBAL_CONFIG_PATH)) return {};
@@ -4636,6 +4637,13 @@ function saveProjectConfig(projectRoot, config) {
   existing.projects = projects;
   fs2.writeFileSync(GLOBAL_CONFIG_PATH, JSON.stringify(existing, null, 2) + "\n");
 }
+function removeProjectConfig(projectRoot) {
+  const existing = loadGlobalConfigRaw();
+  const projects = existing.projects ?? {};
+  delete projects[projectRoot];
+  existing.projects = projects;
+  fs2.writeFileSync(GLOBAL_CONFIG_PATH, JSON.stringify(existing, null, 2) + "\n");
+}
 
 // src/server/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -5014,6 +5022,22 @@ function detectWorkspaces(rootPath) {
   if (composerResult.length > 0) return composerResult;
   return [];
 }
+function buildMultiRootWorkspaces(parentDir, childRoots) {
+  const workspaces = [];
+  for (const childRoot of childRoots) {
+    const relPath = path3.relative(parentDir, childRoot).replace(/\\/g, "/");
+    const childName = path3.basename(childRoot);
+    workspaces.push({ name: childName, path: relPath });
+    const subWorkspaces = detectWorkspaces(childRoot);
+    for (const sub of subWorkspaces) {
+      workspaces.push({
+        name: `${childName}/${sub.name}`,
+        path: `${relPath}/${sub.path}`
+      });
+    }
+  }
+  return workspaces;
+}
 function detectPnpmWorkspaces(rootPath) {
   const yamlPath = path3.join(rootPath, "pnpm-workspace.yaml");
   if (!fs4.existsSync(yamlPath)) return [];
@@ -7411,9 +7435,14 @@ var IndexingPipeline = class _IndexingPipeline {
     const result = this._lock.then(async () => {
       this._isIncremental = false;
       const start = Date.now();
-      this.workspaces = detectWorkspaces(this.rootPath);
-      if (this.workspaces.length > 0) {
-        logger.info({ workspaces: this.workspaces.map((w) => w.name) }, "Detected workspaces");
+      if (this.config.children?.length) {
+        this.workspaces = buildMultiRootWorkspaces(this.rootPath, this.config.children);
+        logger.info({ workspaces: this.workspaces.map((w) => w.name) }, "Multi-root workspaces");
+      } else {
+        this.workspaces = detectWorkspaces(this.rootPath);
+        if (this.workspaces.length > 0) {
+          logger.info({ workspaces: this.workspaces.map((w) => w.name) }, "Detected workspaces");
+        }
       }
       const filePaths = await this.collectFiles();
       return this.runPipeline(filePaths, force ?? false, start);
@@ -9727,6 +9756,14 @@ function buildInstructions(detectedFrameworks, verbosity) {
     "Before creating new functions/classes:",
     '- `check_duplication` { name: "functionName", kind: "function" } \u2014 checks if similar symbols already exist. Use BEFORE writing new code to avoid reinventing existing logic.',
     "",
+    "Bulk mechanical changes (adding async/await, updating patterns, fixing imports across many files):",
+    "- `apply_codemod` { pattern, replacement, file_pattern } \u2014 regex find-and-replace across files. Dry-run by default (shows preview). Two-step workflow:",
+    "  1. Call with dry_run: true (default) \u2192 review preview with context lines",
+    "  2. Call with dry_run: false \u2192 apply changes. Requires confirm_large: true if >20 files affected.",
+    "- Use `filter_content` to narrow scope to files containing a specific substring.",
+    "- Use `multiline: true` for patterns spanning multiple lines.",
+    "- NEVER use dozens of Edit calls for the same regex replacement \u2014 use apply_codemod instead.",
+    "",
     "WHEN TO USE native tools (Read/Grep/Glob):",
     "- Non-code files (.md, .json, .yaml, .toml, config) \u2192 Read/Grep",
     "- Reading a file before editing (Edit needs full content) \u2192 Read",
@@ -18903,6 +18940,7 @@ import { z as z7 } from "zod";
 // src/tools/refactoring/refactor.ts
 import fs24 from "fs";
 import path35 from "path";
+import fg4 from "fast-glob";
 function readLines2(filePath) {
   return fs24.readFileSync(filePath, "utf-8").split("\n");
 }
@@ -19236,6 +19274,193 @@ ${functionDef}`
   }
   return result;
 }
+var CODEMOD_MAX_PREVIEW = 20;
+var CODEMOD_LARGE_THRESHOLD = 20;
+var CODEMOD_CONTEXT_LINES = 2;
+var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".bmp",
+  ".ico",
+  ".svg",
+  ".webp",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".eot",
+  ".otf",
+  ".zip",
+  ".tar",
+  ".gz",
+  ".bz2",
+  ".7z",
+  ".rar",
+  ".pdf",
+  ".doc",
+  ".docx",
+  ".xls",
+  ".xlsx",
+  ".mp3",
+  ".mp4",
+  ".avi",
+  ".mov",
+  ".wav",
+  ".exe",
+  ".dll",
+  ".so",
+  ".dylib",
+  ".o",
+  ".a",
+  ".wasm",
+  ".pyc",
+  ".class"
+]);
+var SKIP_DIRS = ["node_modules", ".git", "dist", "build", "vendor", "__pycache__", ".next", ".nuxt"];
+function applyCodemod(projectRoot, pattern, replacement, filePattern, options) {
+  const result = {
+    success: false,
+    tool: "apply_codemod",
+    dry_run: options.dryRun,
+    matches: [],
+    files_modified: [],
+    total_replacements: 0,
+    total_files: 0,
+    warnings: []
+  };
+  let regex;
+  try {
+    const flags = options.multiline ? "gms" : "gm";
+    regex = new RegExp(pattern, flags);
+  } catch (e) {
+    result.error = `Invalid regex pattern: ${e.message}`;
+    return result;
+  }
+  let files;
+  try {
+    files = fg4.sync(filePattern, {
+      cwd: projectRoot,
+      ignore: SKIP_DIRS.map((d) => `**/${d}/**`),
+      onlyFiles: true,
+      absolute: false
+    });
+  } catch (e) {
+    result.error = `Invalid file pattern: ${e.message}`;
+    return result;
+  }
+  files = files.filter((f) => !BINARY_EXTENSIONS.has(path35.extname(f).toLowerCase()));
+  if (files.length === 0) {
+    result.error = `No files matched pattern: ${filePattern}`;
+    return result;
+  }
+  const allMatches = [];
+  const filesWithMatches = /* @__PURE__ */ new Set();
+  for (const relPath of files) {
+    const absPath = path35.resolve(projectRoot, relPath);
+    if (!fs24.existsSync(absPath)) continue;
+    let content;
+    try {
+      content = fs24.readFileSync(absPath, "utf-8");
+    } catch {
+      result.warnings.push(`Could not read: ${relPath}`);
+      continue;
+    }
+    if (options.filterContent && !content.includes(options.filterContent)) {
+      continue;
+    }
+    const lines = content.split("\n");
+    if (options.multiline) {
+      regex.lastIndex = 0;
+      if (!regex.test(content)) continue;
+      filesWithMatches.add(relPath);
+      regex.lastIndex = 0;
+      let matchCount = 0;
+      const matchPositions = [];
+      let m;
+      while ((m = regex.exec(content)) !== null) {
+        matchPositions.push({ index: m.index, match: m[0] });
+        matchCount++;
+        if (m[0].length === 0) {
+          regex.lastIndex++;
+        }
+      }
+      for (const pos of matchPositions.slice(0, CODEMOD_MAX_PREVIEW - allMatches.length)) {
+        const lineNum = content.slice(0, pos.index).split("\n").length;
+        const original = pos.match;
+        regex.lastIndex = 0;
+        const replaced = original.replace(regex, replacement);
+        allMatches.push({
+          file: relPath,
+          line: lineNum,
+          original: original.length > 200 ? original.slice(0, 200) + "\u2026" : original,
+          replaced: replaced.length > 200 ? replaced.slice(0, 200) + "\u2026" : replaced,
+          context_before: lines.slice(Math.max(0, lineNum - 1 - CODEMOD_CONTEXT_LINES), lineNum - 1),
+          context_after: lines.slice(lineNum, lineNum + CODEMOD_CONTEXT_LINES)
+        });
+      }
+      result.total_replacements += matchCount;
+    } else {
+      let fileMatchCount = 0;
+      for (let i = 0; i < lines.length; i++) {
+        regex.lastIndex = 0;
+        if (!regex.test(lines[i])) continue;
+        filesWithMatches.add(relPath);
+        fileMatchCount++;
+        regex.lastIndex = 0;
+        const newLine = lines[i].replace(regex, replacement);
+        if (allMatches.length < CODEMOD_MAX_PREVIEW) {
+          allMatches.push({
+            file: relPath,
+            line: i + 1,
+            original: lines[i],
+            replaced: newLine,
+            context_before: lines.slice(Math.max(0, i - CODEMOD_CONTEXT_LINES), i),
+            context_after: lines.slice(i + 1, i + 1 + CODEMOD_CONTEXT_LINES)
+          });
+        }
+      }
+      result.total_replacements += fileMatchCount;
+    }
+  }
+  result.total_files = filesWithMatches.size;
+  if (allMatches.length === 0) {
+    result.error = `No matches found for pattern in ${files.length} files`;
+    return result;
+  }
+  if (filesWithMatches.size > CODEMOD_LARGE_THRESHOLD && !options.confirmLarge) {
+    result.matches = allMatches;
+    result.warnings.push(
+      `Affects ${filesWithMatches.size} files (>${CODEMOD_LARGE_THRESHOLD}). Re-run with confirm_large: true to proceed, or narrow file_pattern.`
+    );
+    result.dry_run = true;
+    result.success = true;
+    return result;
+  }
+  if (options.dryRun) {
+    result.matches = allMatches;
+    result.success = true;
+    return result;
+  }
+  for (const relPath of filesWithMatches) {
+    const absPath = path35.resolve(projectRoot, relPath);
+    try {
+      const content = fs24.readFileSync(absPath, "utf-8");
+      const flags = options.multiline ? "gms" : "gm";
+      const freshRegex = new RegExp(pattern, flags);
+      const newContent = content.replace(freshRegex, replacement);
+      if (newContent !== content) {
+        fs24.writeFileSync(absPath, newContent, "utf-8");
+        result.files_modified.push(relPath);
+      }
+    } catch (e) {
+      result.warnings.push(`Failed to write ${relPath}: ${e.message}`);
+    }
+  }
+  result.matches = allMatches;
+  result.success = true;
+  return result;
+}
 function detectLanguage2(ext) {
   switch (ext) {
     case ".ts":
@@ -19472,6 +19697,31 @@ function registerRefactoringTools(server, ctx) {
       return { content: [{ type: "text", text: j3(result) }] };
     }
   );
+  server.tool(
+    "apply_codemod",
+    "Bulk regex find-and-replace across files. Dry-run by default \u2014 first call shows preview, second call with dry_run=false applies. Use for mechanical changes like adding async/await, renaming patterns, updating imports across many files.",
+    {
+      pattern: z7.string().min(1).max(1e3).describe("Regex pattern to match (JavaScript regex syntax)"),
+      replacement: z7.string().max(1e3).describe("Replacement string ($1, $2 for capture groups)"),
+      file_pattern: z7.string().min(1).max(512).describe('Glob pattern for files to scan (e.g. "tests/**/*.test.ts", "src/**/*.py")'),
+      dry_run: z7.boolean().default(true).describe("Preview changes without writing (default: true). Set to false to apply."),
+      confirm_large: z7.boolean().optional().describe("Required when >20 files affected. Acknowledges large-scale change."),
+      filter_content: z7.string().max(500).optional().describe("Only process files containing this substring (narrows scope)"),
+      multiline: z7.boolean().optional().describe("Enable multiline mode (dot matches newlines, patterns span lines)")
+    },
+    async ({ pattern, replacement, file_pattern, dry_run, confirm_large, filter_content, multiline }) => {
+      const result = applyCodemod(projectRoot, pattern, replacement, file_pattern, {
+        dryRun: dry_run,
+        confirmLarge: confirm_large,
+        filterContent: filter_content,
+        multiline
+      });
+      if (!result.success) {
+        return { content: [{ type: "text", text: j3(result) }], isError: true };
+      }
+      return { content: [{ type: "text", text: j3(result) }] };
+    }
+  );
 }
 
 // src/tools/register/advanced.ts
@@ -28652,6 +28902,8 @@ var KNOWN_PACKAGES = {
   "@clack/prompts": { category: "infra", priority: "medium", plugin: "clack" },
   "@clack/core": { category: "infra", priority: "medium", plugin: "clack" },
   "tree-sitter": { category: "infra", priority: "medium", plugin: "tree-sitter" },
+  "web-tree-sitter": { category: "infra", priority: "medium", plugin: "tree-sitter" },
+  "tree-sitter-wasms": { category: "infra", priority: "low", plugin: "tree-sitter" },
   "n8n-workflow": { category: "infra", priority: "high", plugin: "n8n" },
   // --- JavaScript / npm: Build tools (with plugin) ---
   "tsup": { category: "infra", priority: "low", plugin: "build-tools" },
@@ -29621,7 +29873,7 @@ function registerSessionTools(server, ctx) {
 }
 
 // src/server/server.ts
-var PKG_VERSION = true ? "1.5.3" : "0.0.0-dev";
+var PKG_VERSION = true ? "1.6.0" : "0.0.0-dev";
 function j2(value) {
   return JSON.stringify(value, (_key, val) => val === null || val === void 0 ? void 0 : val);
 }
@@ -29894,9 +30146,76 @@ function createServer2(store, registry, config, rootPath) {
 }
 
 // src/indexer/plugins/language/php/index.ts
-import { createRequire } from "module";
 import { ok as ok9, err as err12 } from "neverthrow";
 
+// src/parser/tree-sitter.ts
+import Parser from "web-tree-sitter";
+import { createRequire } from "module";
+var initPromise = null;
+var languageCache = /* @__PURE__ */ new Map();
+var parserCache = /* @__PURE__ */ new Map();
+var LANG_WASM_MAP = {
+  bash: "tree-sitter-bash.wasm",
+  c: "tree-sitter-c.wasm",
+  cpp: "tree-sitter-cpp.wasm",
+  csharp: "tree-sitter-c_sharp.wasm",
+  css: "tree-sitter-css.wasm",
+  dart: "tree-sitter-dart.wasm",
+  elisp: "tree-sitter-elisp.wasm",
+  elixir: "tree-sitter-elixir.wasm",
+  elm: "tree-sitter-elm.wasm",
+  embedded_template: "tree-sitter-embedded_template.wasm",
+  go: "tree-sitter-go.wasm",
+  html: "tree-sitter-html.wasm",
+  java: "tree-sitter-java.wasm",
+  javascript: "tree-sitter-javascript.wasm",
+  json: "tree-sitter-json.wasm",
+  kotlin: "tree-sitter-kotlin.wasm",
+  lua: "tree-sitter-lua.wasm",
+  objc: "tree-sitter-objc.wasm",
+  ocaml: "tree-sitter-ocaml.wasm",
+  php: "tree-sitter-php.wasm",
+  python: "tree-sitter-python.wasm",
+  ql: "tree-sitter-ql.wasm",
+  rescript: "tree-sitter-rescript.wasm",
+  ruby: "tree-sitter-ruby.wasm",
+  rust: "tree-sitter-rust.wasm",
+  scala: "tree-sitter-scala.wasm",
+  solidity: "tree-sitter-solidity.wasm",
+  swift: "tree-sitter-swift.wasm",
+  systemrdl: "tree-sitter-systemrdl.wasm",
+  tlaplus: "tree-sitter-tlaplus.wasm",
+  toml: "tree-sitter-toml.wasm",
+  tsx: "tree-sitter-tsx.wasm",
+  typescript: "tree-sitter-typescript.wasm",
+  vue: "tree-sitter-vue.wasm",
+  yaml: "tree-sitter-yaml.wasm",
+  zig: "tree-sitter-zig.wasm"
+};
+var _require = createRequire(import.meta.url);
+function ensureInit() {
+  if (!initPromise) {
+    initPromise = Parser.init();
+  }
+  return initPromise;
+}
+async function getParser(language) {
+  await ensureInit();
+  if (parserCache.has(language)) return parserCache.get(language);
+  const wasmFile = LANG_WASM_MAP[language];
+  if (!wasmFile) throw new Error(`Unsupported tree-sitter language: ${language}`);
+  let lang = languageCache.get(language);
+  if (!lang) {
+    const wasmPath = _require.resolve(`tree-sitter-wasms/out/${wasmFile}`);
+    lang = await Parser.Language.load(wasmPath);
+    languageCache.set(language, lang);
+  }
+  const parser = new Parser();
+  parser.setLanguage(lang);
+  parserCache.set(language, parser);
+  return parser;
+}
+
 // src/indexer/plugins/language/php/helpers.ts
 function extractNamespace(rootNode) {
   for (const child of rootNode.namedChildren) {
@@ -30152,17 +30471,6 @@ function detectMinPhpVersion(nodeTypes) {
 }
 
 // src/indexer/plugins/language/php/index.ts
-var require2 = createRequire(import.meta.url);
-var Parser = require2("tree-sitter");
-var PhpGrammar = require2("tree-sitter-php");
-var parserInstance = null;
-function getParser() {
-  if (!parserInstance) {
-    parserInstance = new Parser();
-    parserInstance.setLanguage(PhpGrammar.php);
-  }
-  return parserInstance;
-}
 var PhpLanguagePlugin = class {
   manifest = {
     name: "php-language",
@@ -30189,9 +30497,9 @@ var PhpLanguagePlugin = class {
     "8.3",
     "8.4"
   ];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser();
+      const parser = await getParser("php");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -30416,7 +30724,6 @@ var PhpLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/typescript/index.ts
-import { createRequire as createRequire2 } from "module";
 import { ok as ok10, err as err13 } from "neverthrow";
 
 // src/indexer/plugins/language/typescript/helpers.ts
@@ -30738,25 +31045,6 @@ function detectMinEsVersion(nodeTypes) {
 }
 
 // src/indexer/plugins/language/typescript/index.ts
-var require3 = createRequire2(import.meta.url);
-var Parser2 = require3("tree-sitter");
-var TsGrammar = require3("tree-sitter-typescript");
-var tsParser = null;
-var tsxParser = null;
-function getParser2(tsx) {
-  if (tsx) {
-    if (!tsxParser) {
-      tsxParser = new Parser2();
-      tsxParser.setLanguage(TsGrammar.tsx);
-    }
-    return tsxParser;
-  }
-  if (!tsParser) {
-    tsParser = new Parser2();
-    tsParser.setLanguage(TsGrammar.typescript);
-  }
-  return tsParser;
-}
 var TSX_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".jsx"]);
 var JS_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".jsx", ".mjs", ".cjs"]);
 var TypeScriptLanguagePlugin = class {
@@ -30767,11 +31055,11 @@ var TypeScriptLanguagePlugin = class {
   };
   supportedExtensions = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
   supportedVersions = ["12", "14", "16", "17", "18", "19", "20", "21", "22", "23", "24"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
       const ext = filePath.substring(filePath.lastIndexOf("."));
       const useTsx = TSX_EXTENSIONS.has(ext);
-      const parser = getParser2(useTsx);
+      const parser = await getParser(useTsx ? "tsx" : "typescript");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -31022,7 +31310,6 @@ var TypeScriptLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/vue/index.ts
-import { createRequire as createRequire3 } from "module";
 import { parse as parseSFC } from "@vue/compiler-sfc";
 import { ok as ok11, err as err14 } from "neverthrow";
 
@@ -31321,17 +31608,6 @@ function componentNameFromPath(filePath) {
 }
 
 // src/indexer/plugins/language/vue/index.ts
-var require4 = createRequire3(import.meta.url);
-var Parser3 = require4("tree-sitter");
-var TsGrammar2 = require4("tree-sitter-typescript");
-var tsParser2 = null;
-function getParser3() {
-  if (!tsParser2) {
-    tsParser2 = new Parser3();
-    tsParser2.setLanguage(TsGrammar2.typescript);
-  }
-  return tsParser2;
-}
 var VueLanguagePlugin = class {
   manifest = {
     name: "vue-language",
@@ -31339,7 +31615,7 @@ var VueLanguagePlugin = class {
     priority: 10
   };
   supportedExtensions = [".vue"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
       const sourceCode = content.toString("utf-8");
       const { descriptor, errors } = parseSFC(sourceCode, {
@@ -31378,14 +31654,14 @@ var VueLanguagePlugin = class {
         emits = extractEmits(setupContent);
         exposed = extractExposed(setupContent);
         composables = extractComposables(setupContent);
-        const setupEdges = this.parseScriptEdges(setupContent);
+        const setupEdges = await this.parseScriptEdges(setupContent);
         edges.push(...setupEdges);
       }
       if (descriptor.script) {
         const scriptContent = descriptor.script.content;
-        const scriptSymbols = this.parseScriptSymbols(scriptContent, filePath);
+        const scriptSymbols = await this.parseScriptSymbols(scriptContent, filePath);
         symbols.push(...scriptSymbols);
-        const scriptEdges = this.parseScriptEdges(scriptContent);
+        const scriptEdges = await this.parseScriptEdges(scriptContent);
         edges.push(...scriptEdges);
       }
       let templateComponents = [];
@@ -31426,9 +31702,9 @@ var VueLanguagePlugin = class {
   /**
    * Parse a script block with tree-sitter to extract import edges.
    */
-  parseScriptEdges(scriptContent) {
+  async parseScriptEdges(scriptContent) {
     try {
-      const parser = getParser3();
+      const parser = await getParser("typescript");
       const tree = parser.parse(scriptContent);
       return extractImportEdges(tree.rootNode);
     } catch {
@@ -31439,9 +31715,9 @@ var VueLanguagePlugin = class {
    * Parse a <script> block with tree-sitter to extract top-level symbols.
    * Used for Options API / non-setup scripts.
    */
-  parseScriptSymbols(scriptContent, filePath) {
+  async parseScriptSymbols(scriptContent, filePath) {
     try {
-      const parser = getParser3();
+      const parser = await getParser("typescript");
       const tree = parser.parse(scriptContent);
       const root = tree.rootNode;
       const symbols = [];
@@ -31502,7 +31778,6 @@ var VueLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/python/index.ts
-import { createRequire as createRequire4 } from "module";
 import { ok as ok12, err as err15 } from "neverthrow";
 
 // src/indexer/plugins/language/python/helpers.ts
@@ -31831,17 +32106,6 @@ function detectMinPythonVersion(nodeTypes) {
 }
 
 // src/indexer/plugins/language/python/index.ts
-var require5 = createRequire4(import.meta.url);
-var Parser4 = require5("tree-sitter");
-var PythonGrammar = require5("tree-sitter-python");
-var parserInstance2 = null;
-function getParser4() {
-  if (!parserInstance2) {
-    parserInstance2 = new Parser4();
-    parserInstance2.setLanguage(PythonGrammar);
-  }
-  return parserInstance2;
-}
 var PythonLanguagePlugin = class {
   manifest = {
     name: "python-language",
@@ -31867,9 +32131,9 @@ var PythonLanguagePlugin = class {
     "3.13",
     "3.14"
   ];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser4();
+      const parser = await getParser("python");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -32140,7 +32404,6 @@ var PythonLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/java/index.ts
-import { createRequire as createRequire5 } from "module";
 import { ok as ok13, err as err16 } from "neverthrow";
 
 // src/indexer/plugins/language/java/version-features.ts
@@ -32441,17 +32704,6 @@ function findChildByType(node, type) {
 }
 
 // src/indexer/plugins/language/java/index.ts
-var require6 = createRequire5(import.meta.url);
-var Parser5 = require6("tree-sitter");
-var JavaGrammar = require6("tree-sitter-java");
-var parserInstance3 = null;
-function getParser5() {
-  if (!parserInstance3) {
-    parserInstance3 = new Parser5();
-    parserInstance3.setLanguage(JavaGrammar);
-  }
-  return parserInstance3;
-}
 var JavaLanguagePlugin = class {
   manifest = {
     name: "java-language",
@@ -32460,9 +32712,9 @@ var JavaLanguagePlugin = class {
   };
   supportedExtensions = [".java"];
   supportedVersions = ["8", "9", "10", "11", "14", "15", "16", "17", "21", "22", "23"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser5();
+      const parser = await getParser("java");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -32806,7 +33058,6 @@ var KotlinLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/ruby/index.ts
-import { createRequire as createRequire6 } from "module";
 import { ok as ok15, err as err18 } from "neverthrow";
 
 // src/indexer/plugins/language/ruby/version-features.ts
@@ -33057,17 +33308,6 @@ function extractConstants(body, filePath, containerName, containerSymbolId, name
 }
 
 // src/indexer/plugins/language/ruby/index.ts
-var require7 = createRequire6(import.meta.url);
-var Parser6 = require7("tree-sitter");
-var RubyGrammar = require7("tree-sitter-ruby");
-var parserInstance4 = null;
-function getParser6() {
-  if (!parserInstance4) {
-    parserInstance4 = new Parser6();
-    parserInstance4.setLanguage(RubyGrammar);
-  }
-  return parserInstance4;
-}
 var RubyLanguagePlugin = class {
   manifest = {
     name: "ruby-language",
@@ -33076,9 +33316,9 @@ var RubyLanguagePlugin = class {
   };
   supportedExtensions = [".rb", ".rake"];
   supportedVersions = ["2.0", "2.3", "2.5", "2.6", "2.7", "3.0", "3.1", "3.2", "3.3"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser6();
+      const parser = await getParser("ruby");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -33215,7 +33455,6 @@ var RubyLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/go/index.ts
-import { createRequire as createRequire7 } from "module";
 import { ok as ok16, err as err19 } from "neverthrow";
 
 // src/indexer/plugins/language/go/version-features.ts
@@ -33386,17 +33625,6 @@ function extractInterfaceMethods(body, filePath, ifaceName, ifaceSymbolId) {
 }
 
 // src/indexer/plugins/language/go/index.ts
-var require8 = createRequire7(import.meta.url);
-var Parser7 = require8("tree-sitter");
-var GoGrammar = require8("tree-sitter-go");
-var parserInstance5 = null;
-function getParser7() {
-  if (!parserInstance5) {
-    parserInstance5 = new Parser7();
-    parserInstance5.setLanguage(GoGrammar);
-  }
-  return parserInstance5;
-}
 var GoLanguagePlugin = class {
   manifest = {
     name: "go-language",
@@ -33405,9 +33633,9 @@ var GoLanguagePlugin = class {
   };
   supportedExtensions = [".go"];
   supportedVersions = ["1.11", "1.13", "1.14", "1.16", "1.17", "1.18", "1.19", "1.20", "1.21", "1.22", "1.23"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser7();
+      const parser = await getParser("go");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -33957,7 +34185,6 @@ function lineAt2(source, offset) {
 }
 
 // src/indexer/plugins/language/rust/index.ts
-import { createRequire as createRequire8 } from "module";
 import { ok as ok19, err as err20 } from "neverthrow";
 
 // src/indexer/plugins/language/rust/helpers.ts
@@ -34161,17 +34388,6 @@ function extractTraitMethods(body, filePath, traitName, traitSymbolId) {
 }
 
 // src/indexer/plugins/language/rust/index.ts
-var require9 = createRequire8(import.meta.url);
-var Parser8 = require9("tree-sitter");
-var RustGrammar = require9("tree-sitter-rust");
-var parserInstance6 = null;
-function getParser8() {
-  if (!parserInstance6) {
-    parserInstance6 = new Parser8();
-    parserInstance6.setLanguage(RustGrammar);
-  }
-  return parserInstance6;
-}
 var RustLanguagePlugin = class {
   manifest = {
     name: "rust-language",
@@ -34179,9 +34395,9 @@ var RustLanguagePlugin = class {
     priority: 5
   };
   supportedExtensions = [".rs"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser8();
+      const parser = await getParser("rust");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -34463,7 +34679,6 @@ var RustLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/c/index.ts
-import { createRequire as createRequire9 } from "module";
 import { ok as ok20, err as err21 } from "neverthrow";
 
 // src/indexer/plugins/language/c/helpers.ts
@@ -34594,17 +34809,6 @@ function extractEnumConstants2(body, filePath, enumName, enumSymbolId) {
 }
 
 // src/indexer/plugins/language/c/index.ts
-var require10 = createRequire9(import.meta.url);
-var Parser9 = require10("tree-sitter");
-var CGrammar = require10("tree-sitter-c");
-var parserInstance7 = null;
-function getParser9() {
-  if (!parserInstance7) {
-    parserInstance7 = new Parser9();
-    parserInstance7.setLanguage(CGrammar);
-  }
-  return parserInstance7;
-}
 var CLanguagePlugin = class {
   manifest = {
     name: "c-language",
@@ -34612,9 +34816,9 @@ var CLanguagePlugin = class {
     priority: 5
   };
   supportedExtensions = [".c", ".h"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser9();
+      const parser = await getParser("c");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -34881,7 +35085,6 @@ var CLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/cpp/index.ts
-import { createRequire as createRequire10 } from "module";
 import { ok as ok21, err as err22 } from "neverthrow";
 
 // src/indexer/plugins/language/cpp/helpers.ts
@@ -35063,17 +35266,6 @@ function isVirtual(node) {
 }
 
 // src/indexer/plugins/language/cpp/index.ts
-var require11 = createRequire10(import.meta.url);
-var Parser10 = require11("tree-sitter");
-var CppGrammar = require11("tree-sitter-cpp");
-var parserInstance8 = null;
-function getParser10() {
-  if (!parserInstance8) {
-    parserInstance8 = new Parser10();
-    parserInstance8.setLanguage(CppGrammar);
-  }
-  return parserInstance8;
-}
 var CppLanguagePlugin = class {
   manifest = {
     name: "cpp-language",
@@ -35081,9 +35273,9 @@ var CppLanguagePlugin = class {
     priority: 5
   };
   supportedExtensions = [".cpp", ".cxx", ".cc", ".hpp", ".hxx", ".hh", ".h++"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser10();
+      const parser = await getParser("cpp");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -35500,7 +35692,6 @@ var CppLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/csharp/index.ts
-import { createRequire as createRequire11 } from "module";
 import { ok as ok22, err as err23 } from "neverthrow";
 
 // src/indexer/plugins/language/csharp/helpers.ts
@@ -35853,17 +36044,6 @@ function findChildByType2(node, type) {
 }
 
 // src/indexer/plugins/language/csharp/index.ts
-var require12 = createRequire11(import.meta.url);
-var Parser11 = require12("tree-sitter");
-var CSharpGrammar = require12("tree-sitter-c-sharp");
-var parserInstance9 = null;
-function getParser11() {
-  if (!parserInstance9) {
-    parserInstance9 = new Parser11();
-    parserInstance9.setLanguage(CSharpGrammar);
-  }
-  return parserInstance9;
-}
 var CSharpLanguagePlugin = class {
   manifest = {
     name: "csharp-language",
@@ -35883,9 +36063,9 @@ var CSharpLanguagePlugin = class {
     "12.0",
     "13.0"
   ];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser11();
+      const parser = await getParser("csharp");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -36509,7 +36689,6 @@ var DartLanguagePlugin = class {
 };
 
 // src/indexer/plugins/language/scala/index.ts
-import { createRequire as createRequire12 } from "module";
 import { ok as ok25, err as err24 } from "neverthrow";
 
 // src/indexer/plugins/language/scala/helpers.ts
@@ -36874,17 +37053,6 @@ function extractValVarName(node) {
 }
 
 // src/indexer/plugins/language/scala/index.ts
-var require13 = createRequire12(import.meta.url);
-var Parser12 = require13("tree-sitter");
-var ScalaGrammar = require13("tree-sitter-scala");
-var parserInstance10 = null;
-function getParser12() {
-  if (!parserInstance10) {
-    parserInstance10 = new Parser12();
-    parserInstance10.setLanguage(ScalaGrammar);
-  }
-  return parserInstance10;
-}
 var ScalaLanguagePlugin = class {
   manifest = {
     name: "scala-language",
@@ -36893,9 +37061,9 @@ var ScalaLanguagePlugin = class {
   };
   supportedExtensions = [".scala", ".sc"];
   supportedVersions = ["2.11", "2.12", "2.13", "3.0", "3.1", "3.2", "3.3", "3.4", "3.5"];
-  extractSymbols(filePath, content) {
+  async extractSymbols(filePath, content) {
     try {
-      const parser = getParser12();
+      const parser = await getParser("scala");
       const sourceCode = content.toString("utf-8");
       const tree = parser.parse(sourceCode);
       const root = tree.rootNode;
@@ -45363,13 +45531,9 @@ var ExpressPlugin = class {
 };
 
 // src/indexer/plugins/integration/framework/fastapi/index.ts
-import { createRequire as createRequire13 } from "module";
 import fs43 from "fs";
 import path55 from "path";
 import { ok as ok38, err as err25 } from "neverthrow";
-var require14 = createRequire13(import.meta.url);
-var Parser13 = require14("tree-sitter");
-var PythonGrammar2 = require14("tree-sitter-python");
 var HTTP_METHODS3 = /* @__PURE__ */ new Set(["get", "post", "put", "delete", "patch", "options", "head"]);
 function hasPythonDep(ctx, pkg) {
   const lowerPkg = pkg.toLowerCase();
@@ -45416,7 +45580,7 @@ var FastAPIPlugin = class {
       ]
     };
   }
-  extractNodes(filePath, content, language) {
+  async extractNodes(filePath, content, language) {
     if (language !== "python") {
       return ok38({ status: "ok", symbols: [] });
     }
@@ -45432,8 +45596,7 @@ var FastAPIPlugin = class {
       warnings: []
     };
     try {
-      const parser = new Parser13();
-      parser.setLanguage(PythonGrammar2);
+      const parser = await getParser("python");
       const tree = parser.parse(source);
       const root = tree.rootNode;
       this.extractRoutes(root, source, filePath, result);
@@ -45680,13 +45843,9 @@ var FastAPIPlugin = class {
 };
 
 // src/indexer/plugins/integration/framework/flask/index.ts
-import { createRequire as createRequire14 } from "module";
 import fs44 from "fs";
 import path56 from "path";
 import { ok as ok39, err as err26 } from "neverthrow";
-var require15 = createRequire14(import.meta.url);
-var Parser14 = require15("tree-sitter");
-var PythonGrammar3 = require15("tree-sitter-python");
 var DEFAULT_METHODS = ["GET"];
 function hasPythonDep2(ctx, pkg) {
   const lowerPkg = pkg.toLowerCase();
@@ -45732,7 +45891,7 @@ var FlaskPlugin = class {
       ]
     };
   }
-  extractNodes(filePath, content, language) {
+  async extractNodes(filePath, content, language) {
     if (language !== "python") {
       return ok39({ status: "ok", symbols: [] });
     }
@@ -45748,8 +45907,7 @@ var FlaskPlugin = class {
       warnings: []
     };
     try {
-      const parser = new Parser14();
-      parser.setLanguage(PythonGrammar3);
+      const parser = await getParser("python");
       const tree = parser.parse(source);
       const root = tree.rootNode;
       this.extractRoutes(root, source, filePath, result);
@@ -47838,13 +47996,9 @@ function extractRefs(fields, sourceModelName) {
 }
 
 // src/indexer/plugins/integration/orm/sqlalchemy/index.ts
-import { createRequire as createRequire15 } from "module";
 import fs53 from "fs";
 import path65 from "path";
 import { ok as ok43, err as err27 } from "neverthrow";
-var require16 = createRequire15(import.meta.url);
-var Parser15 = require16("tree-sitter");
-var PythonGrammar4 = require16("tree-sitter-python");
 var MODEL_BASES = /* @__PURE__ */ new Set([
   "Base",
   "DeclarativeBase",
@@ -47895,7 +48049,7 @@ var SQLAlchemyPlugin = class {
       ]
     };
   }
-  extractNodes(filePath, content, language) {
+  async extractNodes(filePath, content, language) {
     if (language !== "python") {
       return ok43({ status: "ok", symbols: [] });
     }
@@ -47913,8 +48067,7 @@ var SQLAlchemyPlugin = class {
     if (isAlembicMigration) {
       if (source.includes("op.create_table") || source.includes("op.add_column") || source.includes("op.drop_table")) {
         try {
-          const parser = new Parser15();
-          parser.setLanguage(PythonGrammar4);
+          const parser = await getParser("python");
           const tree = parser.parse(source);
           this.extractAlembicMigrations(tree.rootNode, source, filePath, result);
         } catch (e) {
@@ -47929,8 +48082,7 @@ var SQLAlchemyPlugin = class {
       return ok43({ status: "ok", symbols: [] });
     }
     try {
-      const parser = new Parser15();
-      parser.setLanguage(PythonGrammar4);
+      const parser = await getParser("python");
       const tree = parser.parse(source);
       const root = tree.rootNode;
       this.extractModels(root, source, filePath, result);
@@ -48550,27 +48702,7 @@ var RawSqlPlugin = class {
 };
 
 // src/indexer/plugins/integration/view/react/index.ts
-import { createRequire as createRequire16 } from "module";
 import { ok as ok45, err as err28 } from "neverthrow";
-var require17 = createRequire16(import.meta.url);
-var Parser16 = require17("tree-sitter");
-var TsGrammar3 = require17("tree-sitter-typescript");
-var tsParser3 = null;
-var tsxParser2 = null;
-function getParser13(tsx) {
-  if (tsx) {
-    if (!tsxParser2) {
-      tsxParser2 = new Parser16();
-      tsxParser2.setLanguage(TsGrammar3.tsx);
-    }
-    return tsxParser2;
-  }
-  if (!tsParser3) {
-    tsParser3 = new Parser16();
-    tsParser3.setLanguage(TsGrammar3.typescript);
-  }
-  return tsParser3;
-}
 var BUILTIN_HOOKS = /* @__PURE__ */ new Set([
   "useState",
   "useEffect",
@@ -48657,7 +48789,7 @@ var ReactPlugin = class {
       ]
     };
   }
-  extractNodes(filePath, content, language) {
+  async extractNodes(filePath, content, language) {
     if (!["typescript", "typescriptreact", "javascript", "javascriptreact"].includes(language)) {
       return ok45({ status: "ok", symbols: [] });
     }
@@ -48674,7 +48806,7 @@ var ReactPlugin = class {
     this.extractDirectives(source, result);
     try {
       const useTsx = /\.(tsx|jsx)$/.test(filePath);
-      const parser = getParser13(useTsx);
+      const parser = await getParser(useTsx ? "tsx" : "typescript");
       const tree = parser.parse(source);
       const root = tree.rootNode;
       for (const node of walk(root)) {
@@ -52076,21 +52208,9 @@ var TrpcPlugin = class {
 };
 
 // src/indexer/plugins/integration/api/drf/index.ts
-import { createRequire as createRequire17 } from "module";
 import fs64 from "fs";
 import path76 from "path";
 import { ok as ok52, err as err29 } from "neverthrow";
-var require18 = createRequire17(import.meta.url);
-var Parser17 = require18("tree-sitter");
-var PythonGrammar5 = require18("tree-sitter-python");
-var parserInstance11 = null;
-function getParser14() {
-  if (!parserInstance11) {
-    parserInstance11 = new Parser17();
-    parserInstance11.setLanguage(PythonGrammar5);
-  }
-  return parserInstance11;
-}
 function hasPythonDep4(rootPath, depName) {
   for (const reqFile of ["requirements.txt", "requirements/base.txt", "requirements/prod.txt"]) {
     try {
@@ -52344,7 +52464,7 @@ var DRFPlugin = class {
       ]
     };
   }
-  extractNodes(filePath, content, language) {
+  async extractNodes(filePath, content, language) {
     if (language !== "python") {
       return ok52({ status: "ok", symbols: [] });
     }
@@ -52357,7 +52477,7 @@ var DRFPlugin = class {
     };
     let tree;
     try {
-      const parser = getParser14();
+      const parser = await getParser("python");
       tree = parser.parse(source);
     } catch (e) {
       return err29(parseError(filePath, `tree-sitter parse failed: ${e}`));
@@ -52620,21 +52740,9 @@ var ZodPlugin = class {
 };
 
 // src/indexer/plugins/integration/validation/pydantic/index.ts
-import { createRequire as createRequire18 } from "module";
 import fs67 from "fs";
 import path79 from "path";
 import { ok as ok53, err as err30 } from "neverthrow";
-var require19 = createRequire18(import.meta.url);
-var Parser18 = require19("tree-sitter");
-var PythonGrammar6 = require19("tree-sitter-python");
-var parserInstance12 = null;
-function getParser15() {
-  if (!parserInstance12) {
-    parserInstance12 = new Parser18();
-    parserInstance12.setLanguage(PythonGrammar6);
-  }
-  return parserInstance12;
-}
 function hasPythonDep5(rootPath, depName) {
   for (const reqFile of ["requirements.txt", "requirements/base.txt", "requirements/prod.txt"]) {
     try {
@@ -52954,7 +53062,7 @@ var PydanticPlugin = class {
       ]
     };
   }
-  extractNodes(filePath, content, language) {
+  async extractNodes(filePath, content, language) {
     if (language !== "python") {
       return ok53({ status: "ok", symbols: [] });
     }
@@ -52966,7 +53074,7 @@ var PydanticPlugin = class {
     };
     let tree;
     try {
-      const parser = getParser15();
+      const parser = await getParser("python");
       tree = parser.parse(source);
     } catch (e) {
       return err30(parseError(filePath, `tree-sitter parse failed: ${e}`));
@@ -53492,21 +53600,9 @@ var TestingPlugin = class {
 };
 
 // src/indexer/plugins/integration/tooling/celery/index.ts
-import { createRequire as createRequire19 } from "module";
 import fs70 from "fs";
 import path82 from "path";
 import { ok as ok55, err as err31 } from "neverthrow";
-var require20 = createRequire19(import.meta.url);
-var Parser19 = require20("tree-sitter");
-var PythonGrammar7 = require20("tree-sitter-python");
-var parserInstance13 = null;
-function getParser16() {
-  if (!parserInstance13) {
-    parserInstance13 = new Parser19();
-    parserInstance13.setLanguage(PythonGrammar7);
-  }
-  return parserInstance13;
-}
 function hasPythonDep6(rootPath, depName) {
   for (const reqFile of ["requirements.txt", "requirements/base.txt", "requirements/prod.txt"]) {
     try {
@@ -53684,7 +53780,7 @@ var CeleryPlugin = class {
       ]
     };
   }
-  extractNodes(filePath, content, language) {
+  async extractNodes(filePath, content, language) {
     if (language !== "python") {
       return ok55({ status: "ok", symbols: [] });
     }
@@ -53697,7 +53793,7 @@ var CeleryPlugin = class {
     };
     let tree;
     try {
-      const parser = getParser16();
+      const parser = await getParser("python");
       tree = parser.parse(source);
     } catch (e) {
       return err31(parseError(filePath, `tree-sitter parse failed: ${e}`));
@@ -55319,6 +55415,7 @@ import path86 from "path";
 var TREE_SITTER_PACKAGES = [
   "tree-sitter",
   "web-tree-sitter",
+  "tree-sitter-wasms",
   "tree-sitter-typescript",
   "tree-sitter-javascript",
   "tree-sitter-python",
@@ -56387,8 +56484,12 @@ function clientExists(client) {
 }
 function findHookSource(scriptName) {
   const filename = `${scriptName}${HOOK_EXT}`;
+  const base = import.meta.dirname ?? ".";
   const candidates = [
-    path95.resolve(import.meta.dirname ?? ".", "..", "..", "hooks", filename),
+    path95.resolve(base, "..", "..", "hooks", filename),
+    // dev: src/init/ → ../../hooks
+    path95.resolve(base, "..", "hooks", filename),
+    // bundled: dist/ → ../hooks
     path95.resolve(process.cwd(), "hooks", filename)
   ];
   for (const c of candidates) {
@@ -57663,6 +57764,31 @@ var ROOT_MARKERS = [
   "build.gradle",
   "build.gradle.kts"
 ];
+var SKIP_DIRS2 = /* @__PURE__ */ new Set([".git", "node_modules", "vendor", ".svn", "__pycache__", ".tox"]);
+function discoverChildProjects(parentDir) {
+  const absParent = path100.resolve(parentDir);
+  if (!fs87.existsSync(absParent)) return [];
+  let entries;
+  try {
+    entries = fs87.readdirSync(absParent, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const children = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name.startsWith(".")) continue;
+    if (SKIP_DIRS2.has(entry.name)) continue;
+    const childDir = path100.join(absParent, entry.name);
+    for (const marker of ROOT_MARKERS) {
+      if (fs87.existsSync(path100.join(childDir, marker))) {
+        children.push(childDir);
+        break;
+      }
+    }
+  }
+  return children.sort();
+}
 function findProjectRoot(from) {
   let dir = path100.resolve(from ?? process.cwd());
   while (true) {
@@ -57935,10 +58061,10 @@ function saveRegistry(reg) {
   fs88.writeFileSync(tmp, JSON.stringify(reg, null, 2) + "\n");
   fs88.renameSync(tmp, REGISTRY_PATH);
 }
-function registerProject(root) {
+function registerProject(root, opts) {
   const absRoot = path101.resolve(root);
   const reg = loadRegistry2();
-  if (reg.projects[absRoot]) {
+  if (reg.projects[absRoot] && !opts) {
     return reg.projects[absRoot];
   }
   const entry = {
@@ -57946,12 +58072,30 @@ function registerProject(root) {
     root: absRoot,
     dbPath: getDbPath(absRoot),
     lastIndexed: null,
-    addedAt: (/* @__PURE__ */ new Date()).toISOString()
+    addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...opts?.type && { type: opts.type },
+    ...opts?.children && { children: opts.children }
   };
   reg.projects[absRoot] = entry;
   saveRegistry(reg);
   return entry;
 }
+function findParentProject(childRoot) {
+  const absChild = path101.resolve(childRoot);
+  const reg = loadRegistry2();
+  for (const entry of Object.values(reg.projects)) {
+    if (entry.type === "multi-root" && entry.children?.includes(absChild)) {
+      return entry;
+    }
+  }
+  return null;
+}
+function unregisterProject(root) {
+  const absRoot = path101.resolve(root);
+  const reg = loadRegistry2();
+  delete reg.projects[absRoot];
+  saveRegistry(reg);
+}
 function getProject(root) {
   const absRoot = path101.resolve(root);
   const reg = loadRegistry2();
@@ -58239,11 +58383,17 @@ function executeSteps(steps, opts) {
   }
 }
 function registerAndIndexProject(dir, opts) {
-  let projectRoot;
+  let projectRoot = null;
   try {
     projectRoot = findProjectRoot(dir);
   } catch {
-    return { target: dir, action: "skipped", detail: "Could not detect project root" };
+  }
+  if (!projectRoot) {
+    const childRoots = discoverChildProjects(dir);
+    if (childRoots.length === 0) {
+      return { target: dir, action: "skipped", detail: "Could not detect project root or child projects" };
+    }
+    return registerMultiRootProject(dir, childRoots, opts);
   }
   if (opts.dryRun) {
     return { target: projectRoot, action: "skipped", detail: "Would register and index project" };
@@ -58269,6 +58419,52 @@ function registerAndIndexProject(dir, opts) {
     detail: `Registered project: ${entry.name}`
   };
 }
+function registerMultiRootProject(parentDir, childRoots, opts) {
+  if (opts.dryRun) {
+    return {
+      target: parentDir,
+      action: "skipped",
+      detail: `Would register multi-root with ${childRoots.length} children: ${childRoots.map((r) => path102.basename(r)).join(", ")}`
+    };
+  }
+  const existing = getProject(parentDir);
+  if (existing && !opts.force) {
+    return { target: parentDir, action: "already_configured", detail: `Multi-root already registered: ${existing.name}` };
+  }
+  const allInclude = [];
+  const allExclude = [];
+  for (const childRoot of childRoots) {
+    const relPath = path102.relative(parentDir, childRoot).replace(/\\/g, "/");
+    const detection = detectProject(childRoot);
+    const config = generateConfig(detection);
+    for (const pattern of config.include) allInclude.push(`${relPath}/${pattern}`);
+    for (const pattern of config.exclude) allExclude.push(`${relPath}/${pattern}`);
+  }
+  const allProjects = listProjects();
+  const parentPrefix = parentDir + path102.sep;
+  for (const proj of allProjects) {
+    if (proj.root !== parentDir && proj.root.startsWith(parentPrefix)) {
+      if (fs89.existsSync(proj.dbPath)) fs89.unlinkSync(proj.dbPath);
+      unregisterProject(proj.root);
+      removeProjectConfig(proj.root);
+    }
+  }
+  saveProjectConfig(parentDir, {
+    root: ".",
+    include: allInclude,
+    exclude: allExclude,
+    children: childRoots
+  });
+  const dbPath = getDbPath(parentDir);
+  const db = initializeDatabase(dbPath);
+  db.close();
+  const entry = registerProject(parentDir, { type: "multi-root", children: childRoots });
+  return {
+    target: parentDir,
+    action: existing ? "updated" : "created",
+    detail: `Registered multi-root (${childRoots.length} children): ${childRoots.map((r) => path102.basename(r)).join(", ")}`
+  };
+}
 function formatClientName(name) {
   const names = {
     "claude-code": "Claude Code",
@@ -58404,8 +58600,15 @@ var addCommand = new Command3("add").description("Register a project for indexin
   let projectRoot;
   try {
     projectRoot = findProjectRoot(resolvedDir);
-  } catch (e) {
-    console.error(e instanceof Error ? e.message : String(e));
+  } catch {
+    const children = discoverChildProjects(resolvedDir);
+    if (children.length > 0) {
+      await handleMultiRoot(resolvedDir, children, opts);
+      return;
+    }
+    console.error(
+      `Could not find project root from ${resolvedDir}, and no child projects discovered in subdirectories.`
+    );
     process.exit(1);
   }
   const isInteractive = !opts.json;
@@ -58415,6 +58618,20 @@ var addCommand = new Command3("add").description("Register a project for indexin
       p2.note(`Detected project root: ${projectRoot}`, "Root");
     }
   }
+  const parentEntry = findParentProject(projectRoot);
+  if (parentEntry && !opts.force) {
+    if (opts.json) {
+      console.log(JSON.stringify({ status: "child_of_multi_root", parent: parentEntry }));
+    } else {
+      p2.note(
+        `This project is already part of multi-root index: ${parentEntry.name}
+Root: ${parentEntry.root}`,
+        "Multi-root"
+      );
+      p2.outro("Use --force to register it separately.");
+    }
+    return;
+  }
   const existing = getProject(projectRoot);
   if (existing && !opts.force) {
     if (opts.json) {
@@ -58482,6 +58699,104 @@ DB: ${shortPath4(existing.dbPath)}`, "Existing");
     p2.outro("Project registered. It will be indexed when trace-mcp serve starts.");
   }
 });
+async function handleMultiRoot(parentDir, childRoots, opts) {
+  const isInteractive = !opts.json;
+  if (isInteractive) {
+    p2.intro("trace-mcp add (multi-root)");
+    p2.note(
+      `No project root markers in ${parentDir}
+Discovered ${childRoots.length} child project(s):
+` + childRoots.map((r) => `  ${path104.basename(r)}`).join("\n"),
+      "Multi-root"
+    );
+  }
+  const existing = getProject(parentDir);
+  if (existing && !opts.force) {
+    if (opts.json) {
+      console.log(JSON.stringify({ status: "already_registered", project: existing }));
+    } else {
+      p2.note(`Already registered as multi-root: ${existing.name}`, "Existing");
+      p2.outro("Use --force to re-register.");
+    }
+    return;
+  }
+  const mergedInclude = [];
+  const mergedExclude = [];
+  const allLanguages = /* @__PURE__ */ new Set();
+  const allFrameworks = /* @__PURE__ */ new Set();
+  for (const childRoot of childRoots) {
+    const relPath = path104.relative(parentDir, childRoot).replace(/\\/g, "/");
+    const detection = detectProject(childRoot);
+    const config = generateConfig(detection);
+    for (const pattern of config.include) {
+      mergedInclude.push(`${relPath}/${pattern}`);
+    }
+    for (const pattern of config.exclude) {
+      mergedExclude.push(`${relPath}/${pattern}`);
+    }
+    for (const lang of detection.languages) allLanguages.add(lang);
+    for (const fw of detection.frameworks) allFrameworks.add(fw.name);
+  }
+  if (isInteractive) {
+    const detectedLines = [];
+    if (allLanguages.size > 0) {
+      detectedLines.push(`Languages: ${[...allLanguages].join(", ")}`);
+    }
+    if (allFrameworks.size > 0) {
+      detectedLines.push(`Frameworks: ${[...allFrameworks].join(", ")}`);
+    }
+    if (detectedLines.length > 0) {
+      p2.note(detectedLines.join("\n"), "Detected (all children)");
+    }
+  }
+  const allProjects = listProjects();
+  const cleaned = [];
+  for (const proj of allProjects) {
+    if (proj.root.startsWith(parentDir + path104.sep) || proj.root.startsWith(parentDir + "/")) {
+      if (fs91.existsSync(proj.dbPath)) {
+        fs91.unlinkSync(proj.dbPath);
+      }
+      unregisterProject(proj.root);
+      removeProjectConfig(proj.root);
+      cleaned.push(path104.basename(proj.root));
+    }
+  }
+  if (isInteractive && cleaned.length > 0) {
+    p2.note(`Removed individual indexes: ${cleaned.join(", ")}`, "Cleanup");
+  }
+  ensureGlobalDirs();
+  const configForSave = {
+    root: ".",
+    include: mergedInclude,
+    exclude: mergedExclude,
+    children: childRoots
+  };
+  saveProjectConfig(parentDir, configForSave);
+  const dbPath = getDbPath(parentDir);
+  const db = initializeDatabase(dbPath);
+  db.close();
+  const entry = registerProject(parentDir, {
+    type: "multi-root",
+    children: childRoots
+  });
+  if (opts.json) {
+    console.log(JSON.stringify({
+      status: existing ? "re-registered" : "registered",
+      type: "multi-root",
+      project: entry,
+      children: childRoots.map((r) => path104.basename(r)),
+      cleaned
+    }, null, 2));
+  } else {
+    const lines = [];
+    lines.push(`Project: ${entry.name} (multi-root)`);
+    lines.push(`Root: ${parentDir}`);
+    lines.push(`DB: ${shortPath4(dbPath)}`);
+    lines.push(`Children: ${childRoots.map((r) => path104.basename(r)).join(", ")}`);
+    p2.note(lines.join("\n"), existing ? "Re-registered" : "Registered");
+    p2.outro("Multi-root project registered. It will be indexed when trace-mcp serve starts.");
+  }
+}
 function shortPath4(p4) {
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
   if (home && p4.startsWith(home)) return "~" + p4.slice(home.length);
@@ -59594,7 +59909,7 @@ analyticsCommand.command("trends").description("Show daily usage trends: tokens,
 });
 
 // src/cli.ts
-var PKG_VERSION2 = true ? "1.5.3" : "0.0.0-dev";
+var PKG_VERSION2 = true ? "1.6.0" : "0.0.0-dev";
 function registerDefaultPlugins(registry) {
   for (const p4 of createAllLanguagePlugins()) registry.registerLanguagePlugin(p4);
   for (const p4 of createAllIntegrationPlugins()) registry.registerFrameworkPlugin(p4);