depwire-cli 0.3.0 → 0.4.0

package/dist/{chunk-C3LAKUAJ.js → chunk-X2DOGIIG.js}

@@ -54,9 +54,50 @@ function fileExists(filePath) {
 // src/parser/detect.ts
 import { extname as extname3 } from "path";
 
-// src/parser/typescript.ts
-import Parser from "tree-sitter";
-import TypeScript from "tree-sitter-typescript";
+// src/parser/wasm-init.ts
+import { Parser, Language } from "web-tree-sitter";
+import path from "path";
+import { fileURLToPath } from "url";
+import { existsSync as existsSync2 } from "fs";
+var initialized = false;
+var languages = /* @__PURE__ */ new Map();
+async function initParser() {
+  if (initialized) return;
+  await Parser.init();
+  const __dirname3 = path.dirname(fileURLToPath(import.meta.url));
+  let grammarsDir = path.join(__dirname3, "parser", "grammars");
+  if (!existsSync2(grammarsDir)) {
+    grammarsDir = path.join(path.dirname(__dirname3), "parser", "grammars");
+  }
+  if (!existsSync2(grammarsDir)) {
+    grammarsDir = path.join(__dirname3, "grammars");
+  }
+  const grammarFiles = {
+    "typescript": "tree-sitter-typescript.wasm",
+    "tsx": "tree-sitter-tsx.wasm",
+    "javascript": "tree-sitter-javascript.wasm",
+    "python": "tree-sitter-python.wasm",
+    "go": "tree-sitter-go.wasm"
+  };
+  for (const [name, file] of Object.entries(grammarFiles)) {
+    const wasmPath = path.join(grammarsDir, file);
+    const lang = await Language.load(wasmPath);
+    languages.set(name, lang);
+  }
+  initialized = true;
+}
+function getParser(language) {
+  if (!initialized) {
+    throw new Error("Parser not initialized. Call initParser() first.");
+  }
+  const lang = languages.get(language);
+  if (!lang) {
+    throw new Error(`Language '${language}' not loaded.`);
+  }
+  const parser = new Parser();
+  parser.setLanguage(lang);
+  return parser;
+}
 
 // src/parser/resolver.ts
 import { join as join2, dirname, resolve, relative as relative2 } from "path";
@@ -152,13 +193,10 @@ function resolveImportPath(importPath, fromFile, projectRoot) {
 }
 
 // src/parser/typescript.ts
-var tsParser = new Parser();
-tsParser.setLanguage(TypeScript.typescript);
-var tsxParser = new Parser();
-tsxParser.setLanguage(TypeScript.tsx);
 function parseTypeScriptFile(filePath, sourceCode, projectRoot) {
-  const parser2 = filePath.endsWith(".tsx") ? tsxParser : tsParser;
-  const tree = parser2.parse(sourceCode, null, { bufferSize: 1024 * 1024 });
+  const languageType = filePath.endsWith(".tsx") ? "tsx" : "typescript";
+  const parser = getParser(languageType);
+  const tree = parser.parse(sourceCode, null, { bufferSize: 1024 * 1024 });
   const context = {
     filePath,
     projectRoot,
@@ -613,14 +651,11 @@ var typescriptParser = {
 };
 
 // src/parser/python.ts
-import Parser2 from "tree-sitter";
-import Python from "tree-sitter-python";
 import { dirname as dirname2, join as join3 } from "path";
-import { existsSync as existsSync2 } from "fs";
-var pyParser = new Parser2();
-pyParser.setLanguage(Python);
+import { existsSync as existsSync3 } from "fs";
 function parsePythonFile(filePath, sourceCode, projectRoot) {
-  const tree = pyParser.parse(sourceCode, null, { bufferSize: 1024 * 1024 });
+  const parser = getParser("python");
+  const tree = parser.parse(sourceCode, null, { bufferSize: 1024 * 1024 });
   const context = {
     filePath,
     projectRoot,
@@ -907,13 +942,13 @@ function resolveImportPath2(moduleName, currentFile, projectRoot) {
         join3(targetDir, modulePath2, "__init__.py")
       ];
       for (const candidate of candidates2) {
-        if (existsSync2(candidate)) {
+        if (existsSync3(candidate)) {
           return candidate.substring(projectRoot.length + 1);
         }
       }
     } else {
       const initPath = join3(targetDir, "__init__.py");
-      if (existsSync2(initPath)) {
+      if (existsSync3(initPath)) {
         return initPath.substring(projectRoot.length + 1);
       }
     }
@@ -925,7 +960,7 @@ function resolveImportPath2(moduleName, currentFile, projectRoot) {
     join3(projectRoot, modulePath, "__init__.py")
   ];
   for (const candidate of candidates) {
-    if (existsSync2(candidate)) {
+    if (existsSync3(candidate)) {
       return candidate.substring(projectRoot.length + 1);
     }
   }
@@ -982,14 +1017,11 @@ var pythonParser = {
 };
 
 // src/parser/javascript.ts
-import Parser3 from "tree-sitter";
-import JavaScript from "tree-sitter-javascript";
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { join as join4, dirname as dirname3, extname as extname2 } from "path";
-var jsParser = new Parser3();
-jsParser.setLanguage(JavaScript);
 function parseJavaScriptFile(filePath, sourceCode, projectRoot) {
-  const tree = jsParser.parse(sourceCode, null, { bufferSize: 1024 * 1024 });
+  const parser = getParser("javascript");
+  const tree = parser.parse(sourceCode, null, { bufferSize: 1024 * 1024 });
   const context = {
     filePath,
     projectRoot,
@@ -1402,20 +1434,20 @@ function resolveJavaScriptImport(importPath, currentFile, projectRoot) {
     const indexFiles = ["index.js", "index.jsx", "index.mjs"];
     if (extname2(importPath)) {
       const fullPath = targetPath;
-      if (existsSync3(fullPath)) {
+      if (existsSync4(fullPath)) {
         return fullPath.substring(projectRoot.length + 1);
       }
       return null;
     }
     for (const ext of extensions) {
       const candidate = `${targetPath}${ext}`;
-      if (existsSync3(candidate)) {
+      if (existsSync4(candidate)) {
         return candidate.substring(projectRoot.length + 1);
       }
     }
     for (const indexFile of indexFiles) {
       const candidate = join4(targetPath, indexFile);
-      if (existsSync3(candidate)) {
+      if (existsSync4(candidate)) {
         return candidate.substring(projectRoot.length + 1);
       }
     }
@@ -1486,13 +1518,10 @@ var javascriptParser = {
 };
 
 // src/parser/go.ts
-import Parser4 from "tree-sitter";
-import Go from "tree-sitter-go";
-import { existsSync as existsSync4, readFileSync as readFileSync2, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync2, readdirSync as readdirSync2 } from "fs";
 import { join as join5, dirname as dirname4 } from "path";
-var parser = new Parser4();
-parser.setLanguage(Go);
 function parseGoFile(filePath, sourceCode, projectRoot) {
+  const parser = getParser("go");
   const tree = parser.parse(sourceCode, null, { bufferSize: 1024 * 1024 });
   const moduleName = readGoModuleName(projectRoot);
   const context = {
@@ -1773,7 +1802,7 @@ function readGoModuleName(projectRoot) {
   let currentDir = projectRoot;
   for (let i = 0; i < 5; i++) {
     const goModPath = join5(currentDir, "go.mod");
-    if (existsSync4(goModPath)) {
+    if (existsSync5(goModPath)) {
       try {
         const content = readFileSync2(goModPath, "utf-8");
         const lines = content.split("\n");
@@ -1804,13 +1833,13 @@ function resolveGoImport(importPath, projectRoot, moduleName) {
   }
   const segments = importPath.split("/");
   const packageDir = join5(projectRoot, ...segments);
-  if (existsSync4(packageDir)) {
+  if (existsSync5(packageDir)) {
     return findGoFilesInDir(packageDir, projectRoot);
   }
   return [];
 }
 function findGoFilesInDir(dir, projectRoot) {
-  if (!existsSync4(dir)) return [];
+  if (!existsSync5(dir)) return [];
   try {
     const files = readdirSync2(dir);
     const goFiles = files.filter((f) => f.endsWith(".go") && !f.endsWith("_test.go"));
@@ -1938,7 +1967,8 @@ function shouldParseFile(fullPath) {
     return false;
   }
 }
-function parseProject(projectRoot, options) {
+async function parseProject(projectRoot, options) {
+  await initParser();
   const files = scanDirectory(projectRoot);
   const parsedFiles = [];
   let skippedFiles = 0;
@@ -1965,14 +1995,14 @@ function parseProject(projectRoot, options) {
       if (options?.verbose) {
         console.error(`[Parser] Parsing: ${file}`);
       }
-      const parser2 = getParserForFile(file);
-      if (!parser2) {
+      const parser = getParserForFile(file);
+      if (!parser) {
         console.error(`No parser found for file: ${file}`);
         skippedFiles++;
         continue;
       }
       const sourceCode = readFileSync3(fullPath, "utf-8");
-      const parsed = parser2.parseFile(file, sourceCode, projectRoot);
+      const parsed = parser.parseFile(file, sourceCode, projectRoot);
       parsedFiles.push(parsed);
     } catch (err) {
       errorFiles++;
@@ -2044,6 +2074,43 @@ function buildGraph(parsedFiles) {
 }
 
 // src/graph/queries.ts
+function findSymbols(graph, query) {
+  if (query.includes("::")) {
+    if (graph.hasNode(query)) {
+      const attrs = graph.getNodeAttributes(query);
+      return [{
+        id: query,
+        name: attrs.name,
+        kind: attrs.kind,
+        filePath: attrs.filePath,
+        startLine: attrs.startLine,
+        endLine: attrs.endLine,
+        exported: attrs.exported,
+        scope: attrs.scope,
+        dependentCount: graph.inDegree(query)
+      }];
+    }
+  }
+  const queryLower = query.toLowerCase();
+  const results = [];
+  graph.forEachNode((nodeId, attrs) => {
+    if (attrs.name.toLowerCase() === queryLower) {
+      results.push({
+        id: nodeId,
+        name: attrs.name,
+        kind: attrs.kind,
+        filePath: attrs.filePath,
+        startLine: attrs.startLine,
+        endLine: attrs.endLine,
+        exported: attrs.exported,
+        scope: attrs.scope,
+        dependentCount: graph.inDegree(nodeId)
+      });
+    }
+  });
+  results.sort((a, b) => b.dependentCount - a.dependentCount);
+  return results;
+}
 function getDependencies(graph, symbolId) {
   if (!graph.hasNode(symbolId)) return [];
   const dependencies = [];
@@ -2360,10 +2427,10 @@ function watchProject(projectRoot, callbacks) {
 // src/viz/server.ts
 import express from "express";
 import open from "open";
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { dirname as dirname5, join as join7 } from "path";
 import { WebSocketServer } from "ws";
-var __filename = fileURLToPath(import.meta.url);
+var __filename = fileURLToPath2(import.meta.url);
 var __dirname2 = dirname5(__filename);
 var activeServer = null;
 async function findAvailablePort(startPort, maxAttempts = 10) {
@@ -2436,7 +2503,7 @@ Depwire visualization running at ${url2}`);
     onFileChanged: async (filePath) => {
       console.error(`File changed: ${filePath} \u2014 re-parsing project...`);
       try {
-        const parsedFiles = parseProject(projectRoot, options);
+        const parsedFiles = await parseProject(projectRoot, options);
         const newGraph = buildGraph(parsedFiles);
         graph.clear();
         newGraph.forEachNode((node, attrs) => {
@@ -2455,7 +2522,7 @@ Depwire visualization running at ${url2}`);
     onFileAdded: async (filePath) => {
       console.error(`File added: ${filePath} \u2014 re-parsing project...`);
       try {
-        const parsedFiles = parseProject(projectRoot, options);
+        const parsedFiles = await parseProject(projectRoot, options);
         const newGraph = buildGraph(parsedFiles);
         graph.clear();
         newGraph.forEachNode((node, attrs) => {
@@ -2471,10 +2538,10 @@ Depwire visualization running at ${url2}`);
         console.error(`Failed to update graph for ${filePath}:`, error);
       }
     },
-    onFileDeleted: (filePath) => {
+    onFileDeleted: async (filePath) => {
       console.error(`File deleted: ${filePath} \u2014 re-parsing project...`);
       try {
-        const parsedFiles = parseProject(projectRoot, options);
+        const parsedFiles = await parseProject(projectRoot, options);
         const newGraph = buildGraph(parsedFiles);
         graph.clear();
         newGraph.forEachNode((node, attrs) => {
@@ -2572,7 +2639,7 @@ async function updateFileInGraph(graph, projectRoot, relativeFilePath) {
 }
 
 // src/docs/generator.ts
-import { writeFileSync as writeFileSync2, mkdirSync, existsSync as existsSync6 } from "fs";
+import { writeFileSync as writeFileSync2, mkdirSync, existsSync as existsSync7 } from "fs";
 import { join as join10 } from "path";
 
 // src/docs/architecture.ts
@@ -2688,7 +2755,7 @@ function generateProjectSummary(graph, parseTime) {
   const fileCount = getFileCount(graph);
   const symbolCount = graph.order;
   const edgeCount = graph.size;
-  const languages = getLanguageStats(graph);
+  const languages2 = getLanguageStats(graph);
   let output = "";
   output += `- **Total Files:** ${formatNumber(fileCount)}
 `;
@@ -2698,10 +2765,10 @@ function generateProjectSummary(graph, parseTime) {
 `;
   output += `- **Parse Time:** ${parseTime.toFixed(1)}s
 `;
-  if (Object.keys(languages).length > 1) {
+  if (Object.keys(languages2).length > 1) {
     output += "\n**Languages:**\n\n";
     const totalFiles = fileCount;
-    for (const [lang, count] of Object.entries(languages).sort((a, b) => b[1] - a[1])) {
+    for (const [lang, count] of Object.entries(languages2).sort((a, b) => b[1] - a[1])) {
       output += `- ${lang}: ${count} files (${formatPercent(count, totalFiles)})
 `;
     }
@@ -3620,20 +3687,20 @@ function findLongestPaths(graph, limit) {
   }
   const allPaths = [];
   const visited = /* @__PURE__ */ new Set();
-  function dfs(file, path) {
+  function dfs(file, path2) {
     visited.add(file);
-    path.push(file);
+    path2.push(file);
     const neighbors = fileGraph.get(file);
     if (!neighbors || neighbors.size === 0) {
-      allPaths.push([...path]);
+      allPaths.push([...path2]);
     } else {
       for (const neighbor of neighbors) {
         if (!visited.has(neighbor)) {
-          dfs(neighbor, path);
+          dfs(neighbor, path2);
         }
       }
     }
-    path.pop();
+    path2.pop();
     visited.delete(file);
   }
   for (const root of roots.slice(0, 10)) {
@@ -3804,8 +3871,8 @@ function getLanguageStats2(graph) {
 }
 function generateQuickOrientation(graph) {
   const fileCount = getFileCount4(graph);
-  const languages = getLanguageStats2(graph);
-  const primaryLang = Object.entries(languages).sort((a, b) => b[1] - a[1])[0];
+  const languages2 = getLanguageStats2(graph);
+  const primaryLang = Object.entries(languages2).sort((a, b) => b[1] - a[1])[0];
   const dirs = /* @__PURE__ */ new Set();
   graph.forEachNode((node, attrs) => {
     const dir = dirname7(attrs.filePath);
@@ -4137,11 +4204,11 @@ function generateDepwireUsage(projectRoot) {
 }
 
 // src/docs/metadata.ts
-import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync4, writeFileSync } from "fs";
 import { join as join9 } from "path";
 function loadMetadata(outputDir) {
   const metadataPath = join9(outputDir, "metadata.json");
-  if (!existsSync5(metadataPath)) {
+  if (!existsSync6(metadataPath)) {
     return null;
   }
   try {
@@ -4196,7 +4263,7 @@ async function generateDocs(graph, projectRoot, version, parseTime, options) {
   const generated = [];
   const errors = [];
   try {
-    if (!existsSync6(options.outputDir)) {
+    if (!existsSync7(options.outputDir)) {
       mkdirSync(options.outputDir, { recursive: true });
       if (options.verbose) {
         console.log(`Created output directory: ${options.outputDir}`);
@@ -4303,11 +4370,11 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 // src/mcp/tools.ts
 import { dirname as dirname8, join as join12 } from "path";
-import { existsSync as existsSync8, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync5 } from "fs";
 
 // src/mcp/connect.ts
 import simpleGit from "simple-git";
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync8 } from "fs";
 import { join as join11, basename as basename3, resolve as resolve2 } from "path";
 import { tmpdir, homedir } from "os";
 function validateProjectPath(source) {
@@ -4352,7 +4419,7 @@ async function connectToRepo(source, subdirectory, state) {
       const cloneDir = join11(reposDir, projectName);
       console.error(`Connecting to GitHub repo: ${source}`);
       const git = simpleGit();
-      if (existsSync7(cloneDir)) {
+      if (existsSync8(cloneDir)) {
         console.error(`Repo already cloned at ${cloneDir}, pulling latest changes...`);
         try {
           await git.cwd(cloneDir).pull();
@@ -4379,7 +4446,7 @@ async function connectToRepo(source, subdirectory, state) {
           message: validation2.error
         };
       }
-      if (!existsSync7(source)) {
+      if (!existsSync8(source)) {
         return {
           error: "Directory not found",
           message: `Directory does not exist: ${source}`
@@ -4395,7 +4462,7 @@ async function connectToRepo(source, subdirectory, state) {
         message: validation.error
       };
     }
-    if (!existsSync7(projectRoot)) {
+    if (!existsSync8(projectRoot)) {
       return {
         error: "Project root not found",
         message: `Directory does not exist: ${projectRoot}`
@@ -4520,13 +4587,13 @@ function getToolsList() {
     },
     {
       name: "get_symbol_info",
-      description: "Look up detailed information about a symbol (function, class, variable, type, etc.) by name. Returns file location, type, line numbers, and export status.",
+      description: "Look up detailed information about a symbol (function, class, variable, type, etc.) by name. Pass a symbol name (e.g., 'Router') or a fully qualified ID (e.g., 'src/router.ts::Router') for exact matching. If multiple symbols share the same name, returns all matches for disambiguation.",
       inputSchema: {
         type: "object",
         properties: {
           name: {
             type: "string",
-            description: "The symbol name to look up (e.g., 'UserService', 'handleAuth')"
+            description: "The symbol name to look up (e.g., 'UserService') or full ID (e.g., 'src/services/UserService.ts::UserService')"
           }
         },
         required: ["name"]
@@ -4534,13 +4601,13 @@ function getToolsList() {
     },
     {
       name: "get_dependencies",
-      description: "Get all symbols that a given symbol depends on (what does this symbol use/import/call?).",
+      description: "Get all symbols that a given symbol depends on (what does this symbol use/import/call?). Pass a symbol name (e.g., 'Router') or a fully qualified ID (e.g., 'src/router.ts::Router') for exact matching. If multiple symbols share the same name, returns all matches for disambiguation.",
       inputSchema: {
         type: "object",
         properties: {
           symbol: {
             type: "string",
-            description: "Symbol name or ID to analyze"
+            description: "Symbol name (e.g., 'Router') or full ID (e.g., 'src/router.ts::Router')"
           }
         },
         required: ["symbol"]
@@ -4548,13 +4615,13 @@ function getToolsList() {
     },
     {
       name: "get_dependents",
-      description: "Get all symbols that depend on a given symbol (what uses this symbol?).",
+      description: "Get all symbols that depend on a given symbol (what uses this symbol?). Pass a symbol name (e.g., 'Router') or a fully qualified ID (e.g., 'src/router.ts::Router') for exact matching. If multiple symbols share the same name, returns all matches for disambiguation.",
       inputSchema: {
         type: "object",
         properties: {
           symbol: {
             type: "string",
-            description: "Symbol name or ID to analyze"
+            description: "Symbol name (e.g., 'Router') or full ID (e.g., 'src/router.ts::Router')"
           }
         },
         required: ["symbol"]
@@ -4562,13 +4629,13 @@ function getToolsList() {
     },
     {
       name: "impact_analysis",
-      description: "Analyze what would break if a symbol is changed, renamed, or removed. Shows direct dependents, transitive dependents (chain reaction), and all affected files. Use this before making changes to understand the blast radius.",
+      description: "Analyze what would break if a symbol is changed, renamed, or removed. Shows direct dependents, transitive dependents (chain reaction), and all affected files. Pass a symbol name (e.g., 'Router') or a fully qualified ID (e.g., 'src/router.ts::Router') for exact matching. If multiple symbols share the same name, returns all matches for disambiguation. Use this before making changes to understand the blast radius.",
       inputSchema: {
         type: "object",
         properties: {
           symbol: {
             type: "string",
-            description: "The symbol name or ID to analyze"
+            description: "Symbol name (e.g., 'Router') or full ID (e.g., 'src/router.ts::Router')"
           }
         },
         required: ["symbol"]
@@ -4790,12 +4857,39 @@ async function handleToolCall(name, args, state) {
     };
   }
 }
+function createDisambiguationResponse(matches, queryName) {
+  const suggestion = matches.length > 0 ? matches[0].id : "";
+  return {
+    ambiguous: true,
+    message: `Found ${matches.length} symbols named '${queryName}'. Please specify which one by using the full ID (e.g., '${suggestion}').`,
+    matches: matches.map((m, index) => ({
+      id: m.id,
+      kind: m.kind,
+      filePath: m.filePath,
+      line: m.startLine,
+      dependents: m.dependentCount,
+      hint: index === 0 && m.dependentCount > 0 ? "Most dependents \u2014 likely the one you want" : ""
+    })),
+    suggestion
+  };
+}
 function handleGetSymbolInfo(name, graph) {
-  const matches = searchSymbols(graph, name);
-  const exactMatches = matches.filter((m) => m.name.toLowerCase() === name.toLowerCase());
-  const results = exactMatches.length > 0 ? exactMatches : matches.slice(0, 10);
+  const matches = findSymbols(graph, name);
+  if (matches.length === 0) {
+    const fuzzyMatches = searchSymbols(graph, name).slice(0, 10);
+    return {
+      error: `Symbol '${name}' not found`,
+      suggestion: fuzzyMatches.length > 0 ? `Did you mean: ${fuzzyMatches.map((m) => m.name).join(", ")}?` : "Try using search_symbols to find available symbols",
+      fuzzyMatches: fuzzyMatches.map((m) => ({
+        id: m.id,
+        name: m.name,
+        kind: m.kind,
+        filePath: m.filePath
+      }))
+    };
+  }
   return {
-    matches: results.map((m) => ({
+    matches: matches.map((m) => ({
       id: m.id,
       name: m.name,
       kind: m.kind,
@@ -4803,19 +4897,24 @@ function handleGetSymbolInfo(name, graph) {
       startLine: m.startLine,
       endLine: m.endLine,
       exported: m.exported,
-      scope: m.scope
+      scope: m.scope,
+      dependents: m.dependentCount
     })),
-    count: results.length
+    count: matches.length
   };
 }
 function handleGetDependencies(symbol, graph) {
-  const matches = searchSymbols(graph, symbol);
+  const matches = findSymbols(graph, symbol);
   if (matches.length === 0) {
+    const fuzzyMatches = searchSymbols(graph, symbol).slice(0, 10);
     return {
       error: `Symbol '${symbol}' not found`,
-      suggestion: "Try using search_symbols to find available symbols"
+      suggestion: fuzzyMatches.length > 0 ? `Did you mean: ${fuzzyMatches.map((m) => m.name).join(", ")}?` : "Try using search_symbols to find available symbols"
     };
   }
+  if (matches.length > 1) {
+    return createDisambiguationResponse(matches, symbol);
+  }
   const target = matches[0];
   const deps = getDependencies(graph, target.id);
   const grouped = {};
@@ -4833,19 +4932,23 @@ function handleGetDependencies(symbol, graph) {
   });
   const totalCount = Object.values(grouped).reduce((sum, arr) => sum + arr.length, 0);
   return {
-    symbol: `${target.filePath}::${target.name}`,
+    symbol: target.id,
     dependencies: grouped,
     totalCount
   };
 }
 function handleGetDependents(symbol, graph) {
-  const matches = searchSymbols(graph, symbol);
+  const matches = findSymbols(graph, symbol);
   if (matches.length === 0) {
+    const fuzzyMatches = searchSymbols(graph, symbol).slice(0, 10);
     return {
       error: `Symbol '${symbol}' not found`,
-      suggestion: "Try using search_symbols to find available symbols"
+      suggestion: fuzzyMatches.length > 0 ? `Did you mean: ${fuzzyMatches.map((m) => m.name).join(", ")}?` : "Try using search_symbols to find available symbols"
     };
   }
+  if (matches.length > 1) {
+    return createDisambiguationResponse(matches, symbol);
+  }
   const target = matches[0];
   const deps = getDependents(graph, target.id);
   const grouped = {};
@@ -4863,19 +4966,23 @@ function handleGetDependents(symbol, graph) {
   });
   const totalCount = Object.values(grouped).reduce((sum, arr) => sum + arr.length, 0);
   return {
-    symbol: `${target.filePath}::${target.name}`,
+    symbol: target.id,
     dependents: grouped,
     totalCount
   };
 }
 function handleImpactAnalysis(symbol, graph) {
-  const matches = searchSymbols(graph, symbol);
+  const matches = findSymbols(graph, symbol);
   if (matches.length === 0) {
+    const fuzzyMatches = searchSymbols(graph, symbol).slice(0, 10);
     return {
       error: `Symbol '${symbol}' not found`,
-      suggestion: "Try using search_symbols to find available symbols"
+      suggestion: fuzzyMatches.length > 0 ? `Did you mean: ${fuzzyMatches.map((m) => m.name).join(", ")}?` : "Try using search_symbols to find available symbols"
     };
   }
+  if (matches.length > 1) {
+    return createDisambiguationResponse(matches, symbol);
+  }
   const target = matches[0];
   const impact = getImpact(graph, target.id);
   const directWithKinds = impact.directDependents.map((dep) => {
@@ -4898,6 +5005,7 @@ function handleImpactAnalysis(symbol, graph) {
   const summary = `Changing ${target.name} would directly affect ${impact.directDependents.length} symbol(s) and transitively affect ${transitiveFormatted.length} more, across ${impact.affectedFiles.length} file(s).`;
   return {
     symbol: {
+      id: target.id,
       name: target.name,
       filePath: target.filePath,
       kind: target.kind
@@ -5097,7 +5205,7 @@ The server will keep running until you end the MCP session or press Ctrl+C.`;
 }
 async function handleGetProjectDocs(docType, state) {
   const docsDir = join12(state.projectRoot, ".depwire");
-  if (!existsSync8(docsDir)) {
+  if (!existsSync9(docsDir)) {
     const errorMessage = `Project documentation has not been generated yet.
 
 Run \`depwire docs ${state.projectRoot}\` to generate codebase documentation.
@@ -5128,7 +5236,7 @@ Available document types:
       continue;
     }
     const filePath = join12(docsDir, metadata.documents[doc].file);
-    if (!existsSync8(filePath)) {
+    if (!existsSync9(filePath)) {
       missing.push(doc);
       continue;
     }
@@ -5159,14 +5267,14 @@ async function handleUpdateProjectDocs(docType, state) {
   const startTime = Date.now();
   const docsDir = join12(state.projectRoot, ".depwire");
   console.error("Regenerating project documentation...");
-  const parsedFiles = parseProject(state.projectRoot);
+  const parsedFiles = await parseProject(state.projectRoot);
   const graph = buildGraph(parsedFiles);
   const parseTime = (Date.now() - startTime) / 1e3;
   state.graph = graph;
   const packageJsonPath = join12(__dirname, "../../package.json");
   const packageJson = JSON.parse(readFileSync5(packageJsonPath, "utf-8"));
   const docsToGenerate = docType === "all" ? ["architecture", "conventions", "dependencies", "onboarding"] : [docType];
-  const docsExist = existsSync8(docsDir);
+  const docsExist = existsSync9(docsDir);
   const result = await generateDocs(graph, state.projectRoot, packageJson.version, parseTime, {
     outputDir: docsDir,
     format: "markdown",

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   startVizServer,
   updateFileInGraph,
   watchProject
-} from "./chunk-C3LAKUAJ.js";
+} from "./chunk-X2DOGIIG.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -100,7 +100,7 @@ program.command("parse").description("Parse a TypeScript project and build depen
   try {
     const projectRoot = resolve(directory);
     console.log(`Parsing project: ${projectRoot}`);
-    const parsedFiles = parseProject(projectRoot, {
+    const parsedFiles = await parseProject(projectRoot, {
       exclude: options.exclude,
       verbose: options.verbose
     });
@@ -145,7 +145,7 @@ program.command("query").description("Query impact analysis for a symbol").argum
       graph = importFromJSON(json);
     } else {
       console.log("Parsing project...");
-      const parsedFiles = parseProject(projectRoot);
+      const parsedFiles = await parseProject(projectRoot);
       graph = buildGraph(parsedFiles);
     }
     const matches = searchSymbols(graph, symbolName);
@@ -186,7 +186,7 @@ program.command("viz").description("Launch interactive arc diagram visualization
   try {
     const projectRoot = resolve(directory);
     console.log(`Parsing project: ${projectRoot}`);
-    const parsedFiles = parseProject(projectRoot, {
+    const parsedFiles = await parseProject(projectRoot, {
       exclude: options.exclude,
       verbose: options.verbose
     });
@@ -210,7 +210,7 @@ program.command("mcp").description("Start MCP server for AI coding tools").argum
     if (directory) {
       const projectRoot = resolve(directory);
       console.error(`Parsing project: ${projectRoot}`);
-      const parsedFiles = parseProject(projectRoot);
+      const parsedFiles = await parseProject(projectRoot);
       console.error(`Parsed ${parsedFiles.length} files`);
       const graph = buildGraph(parsedFiles);
       console.error(`Built graph: ${graph.order} symbols, ${graph.size} edges`);
@@ -273,7 +273,7 @@ program.command("docs").description("Generate comprehensive codebase documentati
       addToGitignore(projectRoot, ".depwire/");
     }
     console.log(`Parsing project: ${projectRoot}`);
-    const parsedFiles = parseProject(projectRoot, {
+    const parsedFiles = await parseProject(projectRoot, {
       exclude: options.exclude,
       verbose: options.verbose
     });

package/dist/mcpb-entry.js

@@ -6,7 +6,7 @@ import {
   startMcpServer,
   updateFileInGraph,
   watchProject
-} from "./chunk-C3LAKUAJ.js";
+} from "./chunk-X2DOGIIG.js";
 
 // src/mcpb-entry.ts
 import { resolve } from "path";
@@ -17,7 +17,7 @@ async function main() {
     try {
       const projectRoot = resolve(projectPath);
       console.error(`[MCPB] Parsing project: ${projectRoot}`);
-      const parsedFiles = parseProject(projectRoot);
+      const parsedFiles = await parseProject(projectRoot);
       console.error(`[MCPB] Parsed ${parsedFiles.length} files`);
       const graph = buildGraph(parsedFiles);
       console.error(`[MCPB] Built graph: ${graph.order} symbols, ${graph.size} edges`);

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "depwire-cli",
-  "version": "0.3.0",
-  "description": "Code cross-reference visualization and AI context engine for TypeScript. Analyzes codebases to show dependencies, enables AI tools with MCP, and renders beautiful arc diagrams.",
+  "version": "0.4.0",
+  "description": "Code cross-reference visualization and AI context engine for TypeScript, JavaScript, Python, and Go. Zero native dependencies — works on Windows, macOS, and Linux.",
   "type": "module",
   "bin": {
     "depwire": "dist/index.js"
   },
   "scripts": {
     "build": "tsup src/index.ts src/mcpb-entry.ts --format esm --dts --clean && npm run copy-static",
-    "copy-static": "mkdir -p dist/viz/public && cp -r src/viz/public/* dist/viz/public/",
+    "copy-static": "mkdir -p dist/viz/public dist/parser/grammars && cp -r src/viz/public/* dist/viz/public/ && cp src/parser/grammars/*.wasm dist/parser/grammars/",
     "dev": "tsup src/index.ts --format esm --watch",
     "start": "node dist/index.js",
     "build:mcpb": "npm run build && ./scripts/build-mcpb.sh"
@@ -59,11 +59,7 @@
     "minimatch": "^10.2.4",
     "open": "11.0.0",
     "simple-git": "3.31.1",
-    "tree-sitter": "0.21.1",
-    "tree-sitter-go": "0.21.2",
-    "tree-sitter-javascript": "0.21.4",
-    "tree-sitter-python": "0.21.0",
-    "tree-sitter-typescript": "0.23.2",
+    "web-tree-sitter": "^0.26.6",
     "ws": "8.19.0",
     "zod": "4.3.6"
   },