depwire-cli 0.9.1 → 0.9.3

package/README.md

@@ -1,11 +1,5 @@
 # Depwire
 
-<p align="center">
-  <a href="https://glama.ai/mcp/servers/depwire/depwire">
-    <img width="380" height="200" src="https://glama.ai/mcp/servers/depwire/depwire/badge" alt="Depwire MCP server" />
-  </a>
-</p>
-
 <p align="center">
   <a href="https://www.npmjs.com/package/depwire-cli">
     <img src="https://img.shields.io/npm/v/depwire-cli.svg?style=flat-square" alt="npm version" />
@@ -13,6 +7,9 @@
   <a href="https://www.npmjs.com/package/depwire-cli">
     <img src="https://img.shields.io/npm/dm/depwire-cli.svg?style=flat-square" alt="npm downloads" />
   </a>
+  <a href="https://glama.ai/mcp/servers/depwire/depwire">
+    <img src="https://glama.ai/mcp/servers/depwire/depwire/badges/score.svg" alt="depwire/depwire MCP server" />
+  </a>
   <a href="LICENSE">
     <img src="https://img.shields.io/badge/license-BUSL--1.1-blue.svg?style=flat-square" alt="License" />
   </a>

package/dist/{chunk-UPAZDLUB.js → chunk-JICAYZUJ.js}

@@ -3987,21 +3987,89 @@ function loadHealthHistory(projectRoot) {
 
 // src/dead-code/detector.ts
 import path2 from "path";
-function findDeadSymbols(graph, projectRoot, includeTests = false) {
+import { readFileSync as readFileSync7, existsSync as existsSync9 } from "fs";
+function findDeadSymbols(graph, projectRoot, includeTests = false, debug = false) {
   const deadSymbols = [];
   const context = { graph, projectRoot };
+  const stats = {
+    total: 0,
+    excludedByTestFile: 0,
+    excludedByEntryPoint: 0,
+    excludedByConfigFile: 0,
+    excludedByTypeDeclaration: 0,
+    excludedByDefaultExport: 0,
+    excludedByFrameworkDir: 0
+  };
+  const packageEntryPoints = getPackageEntryPoints(projectRoot);
+  if (debug) {
+    console.log("\n\u{1F50D} Debug: Graph Structure");
+    console.log(`Total nodes in graph: ${graph.order}`);
+    console.log(`Total edges in graph: ${graph.size}`);
+    let nodesWithZeroInDegree = 0;
+    let nodesWithZeroOutDegree = 0;
+    graph.forEachNode((node) => {
+      if (graph.inDegree(node) === 0) nodesWithZeroInDegree++;
+      if (graph.outDegree(node) === 0) nodesWithZeroOutDegree++;
+    });
+    console.log(`Nodes with inDegree=0: ${nodesWithZeroInDegree}`);
+    console.log(`Nodes with outDegree=0: ${nodesWithZeroOutDegree}`);
+    if (nodesWithZeroInDegree <= 10) {
+      console.log("\nSample nodes with inDegree=0:");
+      let count = 0;
+      graph.forEachNode((node) => {
+        if (graph.inDegree(node) === 0 && count < 10) {
+          const attrs = graph.getNodeAttributes(node);
+          const filePath = attrs.file || attrs.filePath || "unknown";
+          console.log(`  - ${attrs.name} (${attrs.kind}) in ${path2.relative(projectRoot, filePath)}`);
+          count++;
+        }
+      });
+    }
+  }
   for (const node of graph.nodes()) {
     const attrs = graph.getNodeAttributes(node);
-    if (!attrs.file || !attrs.name) continue;
+    if (!attrs.name) continue;
+    if (!attrs.file && !attrs.filePath) {
+      if (debug) {
+        console.log(`Skipping node ${attrs.name} - no file attribute`);
+      }
+      continue;
+    }
+    const filePath = attrs.file || attrs.filePath;
+    if (!isRelevantForDeadCodeDetection(attrs)) {
+      continue;
+    }
     const inDegree = graph.inDegree(node);
     if (inDegree === 0) {
-      if (shouldExclude(attrs, context, includeTests)) {
+      stats.total++;
+      const exclusionReason = shouldExclude(attrs, context, includeTests, packageEntryPoints);
+      if (exclusionReason) {
+        switch (exclusionReason) {
+          case "test":
+            stats.excludedByTestFile++;
+            break;
+          case "entry":
+            stats.excludedByEntryPoint++;
+            break;
+          case "config":
+            stats.excludedByConfigFile++;
+            break;
+          case "types":
+            stats.excludedByTypeDeclaration++;
+            break;
+          case "default":
+            stats.excludedByDefaultExport++;
+            break;
+          case "framework":
+            stats.excludedByFrameworkDir++;
+            break;
+        }
         continue;
       }
       deadSymbols.push({
         name: attrs.name,
         kind: attrs.kind || "unknown",
-        file: attrs.file,
+        file: filePath,
         line: attrs.startLine || 0,
         exported: attrs.exported || false,
         dependents: 0,
@@ -4010,38 +4078,115 @@ function findDeadSymbols(graph, projectRoot, includeTests = false) {
       });
     }
   }
-  return deadSymbols;
+  if (debug) {
+    console.log("\n\u{1F50D} Debug: Exclusion Statistics");
+    console.log(`Total symbols with 0 incoming edges: ${stats.total}`);
+    console.log(`Excluded by test file: ${stats.excludedByTestFile}`);
+    console.log(`Excluded by entry point: ${stats.excludedByEntryPoint}`);
+    console.log(`Excluded by config file: ${stats.excludedByConfigFile}`);
+    console.log(`Excluded by type declaration: ${stats.excludedByTypeDeclaration}`);
+    console.log(`Excluded by default export: ${stats.excludedByDefaultExport}`);
+    console.log(`Excluded by framework dir: ${stats.excludedByFrameworkDir}`);
+    console.log(`Remaining dead symbols: ${deadSymbols.length}
+`);
+  }
+  return { symbols: deadSymbols, stats };
+}
+function isRelevantForDeadCodeDetection(attrs) {
+  const kind = attrs.kind;
+  const relevantKinds = [
+    "function",
+    "class",
+    "interface",
+    "type",
+    "enum",
+    "const",
+    "let",
+    "var",
+    "method",
+    "property"
+  ];
+  if (!relevantKinds.includes(kind)) {
+    return false;
+  }
+  if (kind === "const" || kind === "let" || kind === "var" || kind === "variable") {
+    return attrs.exported === true;
+  }
+  return true;
+}
+function getPackageEntryPoints(projectRoot) {
+  const entryPoints = /* @__PURE__ */ new Set();
+  const packageJsonPath = path2.join(projectRoot, "package.json");
+  if (!existsSync9(packageJsonPath)) {
+    return entryPoints;
+  }
+  try {
+    const packageJson = JSON.parse(readFileSync7(packageJsonPath, "utf-8"));
+    if (packageJson.main) {
+      entryPoints.add(path2.resolve(projectRoot, packageJson.main));
+    }
+    if (packageJson.module) {
+      entryPoints.add(path2.resolve(projectRoot, packageJson.module));
+    }
+    if (packageJson.exports) {
+      const addExports = (exp) => {
+        if (typeof exp === "string") {
+          entryPoints.add(path2.resolve(projectRoot, exp));
+        } else if (typeof exp === "object") {
+          for (const key in exp) {
+            if (typeof exp[key] === "string") {
+              entryPoints.add(path2.resolve(projectRoot, exp[key]));
+            } else if (typeof exp[key] === "object") {
+              addExports(exp[key]);
+            }
+          }
+        }
+      };
+      addExports(packageJson.exports);
+    }
+  } catch (e) {
+  }
+  return entryPoints;
 }
-function shouldExclude(attrs, context, includeTests) {
-  const filePath = attrs.file;
+function shouldExclude(attrs, context, includeTests, packageEntryPoints) {
+  const filePath = attrs.file || attrs.filePath;
+  if (!filePath) {
+    return null;
+  }
   const relativePath = path2.relative(context.projectRoot, filePath);
   if (!includeTests && isTestFile(relativePath)) {
-    return true;
+    return "test";
   }
-  if (isEntryPoint(relativePath)) {
-    return true;
+  if (isRealPackageEntryPoint(filePath, packageEntryPoints)) {
+    return "entry";
   }
   if (isConfigFile(relativePath)) {
-    return true;
+    return "config";
   }
   if (isTypeDeclarationFile(relativePath)) {
-    return true;
+    return "types";
   }
   if (attrs.kind === "default") {
-    return true;
+    return "default";
   }
   if (isFrameworkAutoLoadedFile(relativePath)) {
-    return true;
+    return "framework";
+  }
+  return null;
+}
+function isRealPackageEntryPoint(filePath, packageEntryPoints) {
+  const normalizedPath = path2.normalize(filePath);
+  for (const entryPoint of packageEntryPoints) {
+    const normalizedEntry = path2.normalize(entryPoint);
+    if (normalizedPath === normalizedEntry || normalizedPath === normalizedEntry.replace(/\.(js|ts)$/, ".ts") || normalizedPath === normalizedEntry.replace(/\.(js|ts)$/, ".js")) {
+      return true;
+    }
   }
   return false;
 }
 function isTestFile(filePath) {
   return filePath.includes("__tests__/") || filePath.includes(".test.") || filePath.includes(".spec.") || filePath.includes("/test/") || filePath.includes("/tests/");
 }
-function isEntryPoint(filePath) {
-  const basename6 = path2.basename(filePath);
-  return basename6 === "index.ts" || basename6 === "index.js" || basename6 === "main.ts" || basename6 === "main.js" || basename6 === "app.ts" || basename6 === "app.js" || basename6 === "server.ts" || basename6 === "server.js";
-}
 function isConfigFile(filePath) {
   return filePath.includes(".config.") || filePath.includes("config/") || filePath.includes("vite.config") || filePath.includes("rollup.config") || filePath.includes("webpack.config");
 }
@@ -4192,17 +4337,24 @@ function displayConfidenceGroup(level, symbols, verbose, projectRoot) {
     color.bold(`
 ${emoji} ${level} CONFIDENCE `) + chalk.gray(`(${level === "HIGH" ? "definitely" : level === "MEDIUM" ? "probably" : "might be"} dead)`)
   );
-  const headers = ["Symbol", "Kind", "File", verbose ? "Reason" : ""];
-  const rows = symbols.map((symbol) => {
-    const relativePath = path4.relative(projectRoot, symbol.file);
-    return [
-      chalk.bold(symbol.name),
-      symbol.kind,
-      `${relativePath}:${symbol.line}`,
-      verbose ? symbol.reason : ""
-    ];
-  });
-  displayTable(headers, rows.filter((row) => row[3] !== ""));
+  if (verbose) {
+    const headers = ["Symbol", "Kind", "File", "Reason"];
+    const rows = symbols.map((symbol) => {
+      const relativePath = path4.relative(projectRoot, symbol.file);
+      return [
+        chalk.bold(symbol.name),
+        symbol.kind,
+        `${relativePath}:${symbol.line}`,
+        symbol.reason
+      ];
+    });
+    displayTable(headers, rows);
+  } else {
+    symbols.forEach((symbol) => {
+      const relativePath = path4.relative(projectRoot, symbol.file);
+      console.log(`  ${relativePath} :: ${symbol.name}`);
+    });
+  }
 }
 function displayTable(headers, rows) {
   if (rows.length === 0) return;
@@ -4252,9 +4404,15 @@ function analyzeDeadCode(graph, projectRoot, options = {}) {
     includeTests: options.includeTests || false,
     verbose: options.verbose || false,
     stats: options.stats || false,
-    json: options.json || false
+    json: options.json || false,
+    debug: options.debug || false
   };
-  const rawDeadSymbols = findDeadSymbols(graph, projectRoot, opts.includeTests);
+  const { symbols: rawDeadSymbols } = findDeadSymbols(
+    graph,
+    projectRoot,
+    opts.includeTests,
+    opts.debug
+  );
   const classifiedSymbols = classifyDeadSymbols(rawDeadSymbols, graph);
   const filteredSymbols = filterByConfidence(classifiedSymbols, opts.confidence);
   const totalSymbols = graph.order;
@@ -4284,7 +4442,7 @@ function filterByConfidence(symbols, minConfidence) {
 }
 
 // src/docs/generator.ts
-import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync2, existsSync as existsSync11 } from "fs";
+import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync2, existsSync as existsSync12 } from "fs";
 import { join as join14 } from "path";
 
 // src/docs/architecture.ts
@@ -7621,7 +7779,7 @@ function getTopLevelDir2(filePath) {
 }
 
 // src/docs/status.ts
-import { readFileSync as readFileSync7, existsSync as existsSync9 } from "fs";
+import { readFileSync as readFileSync8, existsSync as existsSync10 } from "fs";
 import { join as join12 } from "path";
 function generateStatus(graph, projectRoot, version) {
   let output = "";
@@ -7656,11 +7814,11 @@ function getFileCount11(graph) {
 function extractComments(projectRoot, filePath) {
   const comments = [];
   const fullPath = join12(projectRoot, filePath);
-  if (!existsSync9(fullPath)) {
+  if (!existsSync10(fullPath)) {
     return comments;
   }
   try {
-    const content = readFileSync7(fullPath, "utf-8");
+    const content = readFileSync8(fullPath, "utf-8");
     const lines = content.split("\n");
     const patterns = [
       { type: "TODO", regex: /(?:\/\/|#|\/\*)\s*TODO:?\s*(.+)/i },
@@ -8222,15 +8380,15 @@ function generateConfidenceSection(title, description, symbols, projectRoot) {
 }
 
 // src/docs/metadata.ts
-import { existsSync as existsSync10, readFileSync as readFileSync8, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync9, writeFileSync as writeFileSync2 } from "fs";
 import { join as join13 } from "path";
 function loadMetadata(outputDir) {
   const metadataPath = join13(outputDir, "metadata.json");
-  if (!existsSync10(metadataPath)) {
+  if (!existsSync11(metadataPath)) {
     return null;
   }
   try {
-    const content = readFileSync8(metadataPath, "utf-8");
+    const content = readFileSync9(metadataPath, "utf-8");
     return JSON.parse(content);
   } catch (err) {
     console.error("Failed to load metadata:", err);
@@ -8281,7 +8439,7 @@ async function generateDocs(graph, projectRoot, version, parseTime, options) {
   const generated = [];
   const errors = [];
   try {
-    if (!existsSync11(options.outputDir)) {
+    if (!existsSync12(options.outputDir)) {
       mkdirSync2(options.outputDir, { recursive: true });
       if (options.verbose) {
         console.log(`Created output directory: ${options.outputDir}`);
@@ -8501,11 +8659,11 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 // src/mcp/tools.ts
 import { dirname as dirname16, join as join17 } from "path";
-import { existsSync as existsSync14, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync11 } from "fs";
 
 // src/mcp/connect.ts
 import simpleGit from "simple-git";
-import { existsSync as existsSync12 } from "fs";
+import { existsSync as existsSync13 } from "fs";
 import { join as join15, basename as basename5, resolve as resolve2 } from "path";
 import { tmpdir, homedir } from "os";
 function validateProjectPath(source) {
@@ -8550,7 +8708,7 @@ async function connectToRepo(source, subdirectory, state) {
       const cloneDir = join15(reposDir, projectName);
       console.error(`Connecting to GitHub repo: ${source}`);
       const git = simpleGit();
-      if (existsSync12(cloneDir)) {
+      if (existsSync13(cloneDir)) {
         console.error(`Repo already cloned at ${cloneDir}, pulling latest changes...`);
         try {
           await git.cwd(cloneDir).pull();
@@ -8577,7 +8735,7 @@ async function connectToRepo(source, subdirectory, state) {
           message: validation2.error
         };
       }
-      if (!existsSync12(source)) {
+      if (!existsSync13(source)) {
         return {
           error: "Directory not found",
           message: `Directory does not exist: ${source}`
@@ -8593,7 +8751,7 @@ async function connectToRepo(source, subdirectory, state) {
         message: validation.error
       };
     }
-    if (!existsSync12(projectRoot)) {
+    if (!existsSync13(projectRoot)) {
       return {
         error: "Project root not found",
         message: `Directory does not exist: ${projectRoot}`
@@ -8874,10 +9032,10 @@ function getWeekNumber(date) {
 }
 
 // src/temporal/snapshots.ts
-import { writeFileSync as writeFileSync4, readFileSync as readFileSync9, mkdirSync as mkdirSync3, existsSync as existsSync13, readdirSync as readdirSync5 } from "fs";
+import { writeFileSync as writeFileSync4, readFileSync as readFileSync10, mkdirSync as mkdirSync3, existsSync as existsSync14, readdirSync as readdirSync5 } from "fs";
 import { join as join16 } from "path";
 function saveSnapshot(snapshot, outputDir) {
-  if (!existsSync13(outputDir)) {
+  if (!existsSync14(outputDir)) {
     mkdirSync3(outputDir, { recursive: true });
   }
   const filename = `${snapshot.commitHash.substring(0, 8)}.json`;
@@ -8887,11 +9045,11 @@ function saveSnapshot(snapshot, outputDir) {
 function loadSnapshot(commitHash, outputDir) {
   const shortHash = commitHash.substring(0, 8);
   const filepath = join16(outputDir, `${shortHash}.json`);
-  if (!existsSync13(filepath)) {
+  if (!existsSync14(filepath)) {
     return null;
   }
   try {
-    const content = readFileSync9(filepath, "utf-8");
+    const content = readFileSync10(filepath, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -9666,7 +9824,7 @@ The server will keep running until you end the MCP session or press Ctrl+C.`;
 }
 async function handleGetProjectDocs(docType, state) {
   const docsDir = join17(state.projectRoot, ".depwire");
-  if (!existsSync14(docsDir)) {
+  if (!existsSync15(docsDir)) {
     const errorMessage = `Project documentation has not been generated yet.
 
 Run \`depwire docs ${state.projectRoot}\` to generate codebase documentation.
@@ -9697,11 +9855,11 @@ Available document types:
       continue;
     }
     const filePath = join17(docsDir, metadata.documents[doc].file);
-    if (!existsSync14(filePath)) {
+    if (!existsSync15(filePath)) {
       missing.push(doc);
       continue;
     }
-    const content = readFileSync10(filePath, "utf-8");
+    const content = readFileSync11(filePath, "utf-8");
     if (docsToReturn.length > 1) {
       output += `
 
@@ -9733,9 +9891,9 @@ async function handleUpdateProjectDocs(docType, state) {
   const parseTime = (Date.now() - startTime) / 1e3;
   state.graph = graph;
   const packageJsonPath = join17(__dirname, "../../package.json");
-  const packageJson = JSON.parse(readFileSync10(packageJsonPath, "utf-8"));
+  const packageJson = JSON.parse(readFileSync11(packageJsonPath, "utf-8"));
   const docsToGenerate = docType === "all" ? ["architecture", "conventions", "dependencies", "onboarding"] : [docType];
-  const docsExist = existsSync14(docsDir);
+  const docsExist = existsSync15(docsDir);
   const result = await generateDocs(graph, state.projectRoot, packageJson.version, parseTime, {
     outputDir: docsDir,
     format: "markdown",

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   stashChanges,
   updateFileInGraph,
   watchProject
-} from "./chunk-UPAZDLUB.js";
+} from "./chunk-JICAYZUJ.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -788,7 +788,7 @@ program.command("health").description("Analyze dependency architecture health (0
     process.exit(1);
   }
 });
-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").action(async (directory, options) => {
+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) => {
   try {
     const projectRoot = directory ? resolve(directory) : findProjectRoot();
     const startTime = Date.now();
@@ -800,7 +800,8 @@ program.command("dead-code").description("Identify dead code - symbols defined b
       includeTests: options.includeTests || false,
       verbose: options.verbose || false,
       stats: options.stats || false,
-      json: options.json || false
+      json: options.json || false,
+      debug: options.debug || false
     });
     if (options.json) {
       console.log(JSON.stringify(report, null, 2));

package/dist/mcpb-entry.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "depwire-cli",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "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": {