depwire-cli 0.9.9 → 0.9.12

package/README.md

@@ -78,6 +78,30 @@ Or use directly with `npx`:
 npx depwire-cli --help
 ```
 
+## Telemetry
+
+Depwire collects **anonymous usage data** to help us understand which features are most useful and prioritize development.
+
+**What we collect:**
+- Command name (e.g. `parse`, `mcp`, `viz`)
+- Depwire version
+- Operating system (mac/linux/windows)
+- Node.js version
+
+**What we never collect:**
+- File paths or code content
+- Repo names or URLs
+- Usernames, emails, or any personal data
+
+**To opt out**, set this environment variable:
+```bash
+DEPWIRE_NO_TELEMETRY=1 depwire parse
+# Or add to your shell profile:
+export DEPWIRE_NO_TELEMETRY=1
+```
+
+Telemetry data is used solely to improve Depwire. [View our privacy policy](https://depwire.dev/privacy)
+
 ## Quick Start
 
 ### CLI Usage
@@ -401,7 +425,7 @@ depwire docs --output ./docs
 depwire docs --update --only conventions
 ```
 
-**Generated Documents (12 total):**
+**Generated Documents (13 total):**
 
 | Document | What It Contains |
 |----------|------------------|
@@ -417,7 +441,7 @@ depwire docs --update --only conventions
 | `CURRENT.md` | Complete codebase snapshot (every file, symbol, connection) |
 | `STATUS.md` | TODO/FIXME/HACK inventory with priority matrix |
 | `HEALTH.md` | Dependency health score (0-100) across 6 dimensions with recommendations |
-| `DEAD_CODE.md` | Dead code analysis — unused symbols by confidence level (high/medium/low) |
+| `DEAD_CODE.md` | Unused symbols by confidence level (high/medium/low) with smart exclusions |
 
 Documents are stored in `.depwire/` with `metadata.json` tracking generation timestamps for staleness detection.
 
@@ -625,7 +649,7 @@ See [SECURITY.md](SECURITY.md) for full details.
 - [x] WASM migration (Windows support)
 
 ### 🔜 Coming Next
-- [ ] New language support (C — community requested)
+- [ ] New language support (Java, C++, Ruby — community requested)
 - [ ] "What If" simulation — simulate refactors before touching code
 - [ ] Cross-language edge detection (API routes ↔ frontend calls)
 - [ ] Cloud dashboard (first paid feature)

package/dist/{chunk-VVYRHPAE.js → chunk-S3NZMIIU.js}

@@ -1,6 +1,7 @@
 // src/utils/files.ts
 import { readdirSync, statSync, existsSync, lstatSync } from "fs";
 import { join, relative } from "path";
+import os from "os";
 function scanDirectory(rootDir, baseDir = rootDir) {
   const files = [];
   try {
@@ -71,9 +72,21 @@ function findProjectRoot(startDir = process.cwd()) {
     ".git"
     // Any git repo
   ];
+  const blocklist = ["Library", "System", "Applications", "usr", "bin", "etc", "var", "private"];
   let currentDir = startDir;
   const rootDir = "/";
-  while (currentDir !== rootDir) {
+  const maxDepth = 10;
+  let depth = 0;
+  const home = os.homedir();
+  while (currentDir !== rootDir && depth < maxDepth) {
+    if (currentDir === home || !currentDir.startsWith(home)) {
+      break;
+    }
+    const dirName = currentDir.split("/").pop();
+    if (dirName && blocklist.includes(dirName)) {
+      console.warn(`\u26A0\uFE0F  Skipping blocked directory: ${dirName}`);
+      break;
+    }
     for (const marker of projectMarkers) {
       const markerPath = join(currentDir, marker);
       if (existsSync(markerPath)) {
@@ -85,7 +98,9 @@ function findProjectRoot(startDir = process.cwd()) {
       break;
     }
     currentDir = parentDir;
+    depth++;
   }
+  console.warn(`\u26A0\uFE0F  No project root found within ${maxDepth} levels. Using current directory: ${startDir}`);
   return startDir;
 }
 
@@ -9211,6 +9226,10 @@ function getToolsList() {
           symbol: {
             type: "string",
             description: "Symbol name (e.g., 'Router') or full ID (e.g., 'src/router.ts::Router')"
+          },
+          file: {
+            type: "string",
+            description: "Optional: File path to disambiguate when multiple symbols have the same name (e.g., 'src/router.ts')"
           }
         },
         required: ["symbol"]
@@ -9442,7 +9461,7 @@ async function handleToolCall(name, args, state) {
             result = handleGetDependents(args.symbol, graph);
             break;
           case "impact_analysis":
-            result = handleImpactAnalysis(args.symbol, graph);
+            result = handleImpactAnalysis(args.symbol, graph, args.file);
             break;
           case "get_file_context":
             result = handleGetFileContext(args.filePath, graph);
@@ -9502,9 +9521,12 @@ async function handleToolCall(name, args, state) {
 }
 function createDisambiguationResponse(matches, queryName) {
   const suggestion = matches.length > 0 ? matches[0].id : "";
+  const exampleFile = matches.length > 0 ? matches[0].filePath : "";
   return {
     ambiguous: true,
-    message: `Found ${matches.length} symbols named '${queryName}'. Please specify which one by using the full ID (e.g., '${suggestion}').`,
+    message: `Found ${matches.length} symbols named '${queryName}'. Disambiguate by:
+1. Using full ID: '${suggestion}'
+2. Or adding file parameter: { symbol: '${queryName}', file: '${exampleFile}' }`,
     matches: matches.map((m, index) => ({
       id: m.id,
       kind: m.kind,
@@ -9614,7 +9636,7 @@ function handleGetDependents(symbol, graph) {
     totalCount
   };
 }
-function handleImpactAnalysis(symbol, graph) {
+function handleImpactAnalysis(symbol, graph, file) {
   const matches = findSymbols(graph, symbol);
   if (matches.length === 0) {
     const fuzzyMatches = searchSymbols(graph, symbol).slice(0, 10);
@@ -9623,10 +9645,21 @@ function handleImpactAnalysis(symbol, graph) {
       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);
+  let filteredMatches = matches;
+  if (file) {
+    filteredMatches = matches.filter((m) => m.filePath === file || m.filePath.endsWith(file));
+    if (filteredMatches.length === 0) {
+      return {
+        error: `Symbol '${symbol}' not found in file '${file}'`,
+        availableFiles: matches.map((m) => m.filePath),
+        suggestion: `The symbol exists in: ${matches.map((m) => m.filePath).join(", ")}`
+      };
+    }
   }
-  const target = matches[0];
+  if (filteredMatches.length > 1) {
+    return createDisambiguationResponse(filteredMatches, symbol);
+  }
+  const target = filteredMatches[0];
   const impact = getImpact(graph, target.id);
   const directWithKinds = impact.directDependents.map((dep) => {
     let relationship = "unknown";

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   stashChanges,
   updateFileInGraph,
   watchProject
-} from "./chunk-VVYRHPAE.js";
+} from "./chunk-S3NZMIIU.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -474,6 +474,28 @@ function printStats(snapshots) {
   Overall Trend: ${trend}`);
 }
 
+// src/telemetry.ts
+import os from "os";
+var TELEMETRY_URL = "https://telemetry.depwire.dev/event";
+async function trackCommand(command, version = "unknown") {
+  if (process.env.DEPWIRE_NO_TELEMETRY === "1" || process.env.DEPWIRE_NO_TELEMETRY === "true" || process.env.DO_NOT_TRACK === "1") {
+    return;
+  }
+  const payload = {
+    command,
+    version,
+    os: os.platform(),
+    node: process.version
+  };
+  fetch(TELEMETRY_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload),
+    signal: AbortSignal.timeout(2e3)
+  }).catch(() => {
+  });
+}
+
 // src/index.ts
 var __filename2 = fileURLToPath2(import.meta.url);
 var __dirname2 = dirname2(__filename2);
@@ -482,6 +504,7 @@ var packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf-8"));
 var program = new Command();
 program.name("depwire").description("Code cross-reference graph builder for TypeScript projects").version(packageJson.version);
 program.command("parse").description("Parse a TypeScript project and build dependency graph").argument("[directory]", "Project directory to parse (defaults to current directory or auto-detected project root)").option("-o, --output <path>", "Output JSON file path", "depwire-output.json").option("--pretty", "Pretty-print JSON output").option("--stats", "Print summary statistics").option("--exclude <patterns...>", 'Glob patterns to exclude (e.g., "**/*.test.*" "dist/**")').option("--verbose", "Show detailed parsing progress").action(async (directory, options) => {
+  trackCommand("parse", packageJson.version);
   const startTime = Date.now();
   try {
     const projectRoot = directory ? resolve(directory) : findProjectRoot();
@@ -521,6 +544,7 @@ Orphan Files (no cross-references): ${summary.orphanFiles.length}`);
   }
 });
 program.command("query").description("Query impact analysis for a symbol").argument("<directory>", "Project directory").argument("<symbol-name>", "Symbol name to query").action(async (directory, symbolName) => {
+  trackCommand("query", packageJson.version);
   try {
     const projectRoot = resolve(directory);
     const cacheFile = "depwire-output.json";
@@ -569,6 +593,7 @@ Total Transitive Dependents: ${impact.transitiveDependents.length}`);
   }
 });
 program.command("viz").description("Launch interactive arc diagram visualization").argument("[directory]", "Project directory to visualize (defaults to current directory or auto-detected project root)").option("-p, --port <number>", "Server port", "3333").option("--no-open", "Don't auto-open browser").option("--exclude <patterns...>", 'Glob patterns to exclude (e.g., "**/*.test.*" "dist/**")').option("--verbose", "Show detailed parsing progress").action(async (directory, options) => {
+  trackCommand("viz", packageJson.version);
   try {
     const projectRoot = directory ? resolve(directory) : findProjectRoot();
     console.log(`Parsing project: ${projectRoot}`);
@@ -591,6 +616,7 @@ program.command("viz").description("Launch interactive arc diagram visualization
   }
 });
 program.command("temporal").description("Visualize how the dependency graph evolved over git history").argument("[directory]", "Project directory to analyze (defaults to current directory or auto-detected project root)").option("--commits <number>", "Number of commits to sample", "20").option("--strategy <type>", "Sampling strategy: even, weekly, monthly", "even").option("-p, --port <number>", "Server port", "3334").option("--output <path>", "Save snapshots to custom path (default: .depwire/temporal/)").option("--verbose", "Show progress for each commit being parsed").option("--stats", "Show summary statistics at end").action(async (directory, options) => {
+  trackCommand("temporal", packageJson.version);
   try {
     const projectRoot = directory ? resolve(directory) : findProjectRoot();
     await runTemporalAnalysis(projectRoot, {
@@ -607,6 +633,7 @@ program.command("temporal").description("Visualize how the dependency graph evol
   }
 });
 program.command("mcp").description("Start MCP server for AI coding tools").argument("[directory]", "Project directory to analyze (optional - auto-detects project root or use connect_repo tool to connect later)").action(async (directory) => {
+  trackCommand("mcp", packageJson.version);
   try {
     const state = createEmptyState();
     let projectRootToConnect = null;
@@ -669,6 +696,7 @@ program.command("mcp").description("Start MCP server for AI coding tools").argum
   }
 });
 program.command("docs").description("Generate comprehensive codebase documentation").argument("[directory]", "Project directory to document (defaults to current directory or auto-detected project root)").option("-o, --output <path>", "Output directory (default: .depwire/ inside project)").option("--format <type>", "Output format: markdown | json", "markdown").option("--gitignore", "Add .depwire/ to .gitignore automatically").option("--no-gitignore", "Don't modify .gitignore").option("--include <docs>", "Comma-separated list of docs to generate (default: all)", "all").option("--update", "Regenerate existing docs").option("--only <docs>", "Used with --update, regenerate only specific docs").option("--verbose", "Show generation progress").option("--stats", "Show generation statistics at the end").option("--exclude <patterns...>", 'Glob patterns to exclude (e.g., "**/*.test.*" "dist/**")').action(async (directory, options) => {
+  trackCommand("docs", packageJson.version);
   const startTime = Date.now();
   try {
     const projectRoot = directory ? resolve(directory) : findProjectRoot();
@@ -766,6 +794,7 @@ ${pattern}
   }
 }
 program.command("health").description("Analyze dependency architecture health (0-100 score)").argument("[directory]", "Project directory to analyze (defaults to current directory or auto-detected project root)").option("--json", "Output as JSON").option("--verbose", "Show detailed breakdown").action(async (directory, options) => {
+  trackCommand("health", packageJson.version);
   try {
     const projectRoot = directory ? resolve(directory) : findProjectRoot();
     const startTime = Date.now();
@@ -789,6 +818,7 @@ program.command("health").description("Analyze dependency architecture health (0
   }
 });
 program.command("dead-code").description("Identify dead code - symbols defined but never referenced").argument("[directory]", "Project directory to analyze (defaults to current directory or auto-detected project root)").option("--confidence <level>", "Minimum confidence level to show: high, medium, low (default: medium)", "medium").option("--json", "Output as JSON (for CI/automation)").option("--verbose", "Show detailed info for each dead symbol").option("--stats", "Show summary statistics").option("--include-tests", "Include test files in analysis").option("--include-low", "Shortcut for --confidence low").option("--debug", "Show debug information (exclusion stats)").action(async (directory, options) => {
+  trackCommand("dead-code", packageJson.version);
   try {
     const projectRoot = directory ? resolve(directory) : findProjectRoot();
     const startTime = Date.now();

package/dist/mcpb-entry.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "depwire-cli",
-  "version": "0.9.9",
+  "version": "0.9.12",
   "description": "Code cross-reference visualization and AI context engine for TypeScript, JavaScript, Python, Go, Rust, and C. Zero native dependencies — works on Windows, macOS, and Linux.",
   "type": "module",
   "bin": {