depwire-cli 0.3.0 → 0.3.1

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

@@ -2044,6 +2044,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 = [];
@@ -4520,13 +4557,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 +4571,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 +4585,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 +4599,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 +4827,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 +4867,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 +4902,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 +4936,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 +4975,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

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   startVizServer,
   updateFileInGraph,
   watchProject
-} from "./chunk-C3LAKUAJ.js";
+} from "./chunk-LOX5NEND.js";
 
 // src/index.ts
 import { Command } from "commander";

package/dist/mcpb-entry.js

@@ -6,7 +6,7 @@ import {
   startMcpServer,
   updateFileInGraph,
   watchProject
-} from "./chunk-C3LAKUAJ.js";
+} from "./chunk-LOX5NEND.js";
 
 // src/mcpb-entry.ts
 import { resolve } from "path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "depwire-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "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.",
   "type": "module",
   "bin": {