depwire-cli 0.6.0 → 0.6.2

package/README.md

@@ -61,26 +61,30 @@ npx depwire-cli --help
 ### CLI Usage
 
 ```bash
-# Visualization (opens in browser)
-npx depwire-cli viz ./my-project
+# Auto-detects project root from current directory
+depwire viz
+depwire parse
+depwire docs
+depwire health
 
-# Parse and export as JSON
+# Or specify a directory explicitly
+npx depwire-cli viz ./my-project
 npx depwire-cli parse ./my-project
 
 # Exclude test files and node_modules
-npx depwire-cli parse ./my-project --exclude "**/*.test.*" "**/node_modules/**"
+npx depwire-cli parse --exclude "**/*.test.*" "**/node_modules/**"
 
 # Show detailed parsing progress
-npx depwire-cli parse ./my-project --verbose
+npx depwire-cli parse --verbose
 
 # Export with pretty-printed JSON and statistics
-npx depwire-cli parse ./my-project --pretty --stats
+npx depwire-cli parse --pretty --stats
 
 # Generate codebase documentation
-npx depwire-cli docs ./my-project --verbose --stats
+npx depwire-cli docs --verbose --stats
 
 # Custom output file
-npx depwire-cli parse ./my-project -o my-graph.json
+npx depwire-cli parse -o my-graph.json
 ```
 
 ### Claude Desktop
@@ -98,16 +102,20 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
 }
 ```
 
+**Depwire auto-detects your project root. No path configuration needed.**
+
 Then in chat:
 ```
-Connect to /path/to/my/project and show me the architecture.
+Show me the architecture.
 ```
 
 ### Cursor
 
 Settings → Features → Experimental → Enable MCP → Add Server:
 - Command: `npx`
-- Args: `-y depwire-cli mcp /path/to/project`
+- Args: `-y depwire-cli mcp`
+
+**Depwire auto-detects your project root from the current working directory.**
 
 ## Available MCP Tools
 
@@ -143,20 +151,23 @@ Settings → Features → Experimental → Enable MCP → Add Server:
 ![Interactive Arc Diagram](./assets/graph.gif)
 
 ```bash
-# Open visualization on default port (3456)
+# Auto-detects project root (run from anywhere in your project)
+depwire viz
+
+# Or specify a directory explicitly
 depwire viz ./my-project
 
 # Custom port
-depwire viz ./my-project --port 8080
+depwire viz --port 8080
 
 # Exclude test files from visualization
-depwire viz ./my-project --exclude "**/*.test.*"
+depwire viz --exclude "**/*.test.*"
 
 # Verbose mode with detailed parsing logs
-depwire viz ./my-project --verbose
+depwire viz --verbose
 
 # Don't auto-open browser
-depwire viz ./my-project --no-open
+depwire viz --no-open
 ```
 
 Opens an interactive arc diagram in your browser:
@@ -177,10 +188,12 @@ Opens an interactive arc diagram in your browser:
 
 ## CLI Reference
 
-### `depwire parse <directory>`
+### `depwire parse [directory]`
 
 Parse a project and export the dependency graph as JSON.
 
+**Directory argument is optional** — Depwire auto-detects your project root by looking for `package.json`, `tsconfig.json`, `go.mod`, `pyproject.toml`, `setup.py`, or `.git`.
+
 **Options:**
 - `-o, --output <path>` — Output file path (default: `depwire-output.json`)
 - `--exclude <patterns...>` — Glob patterns to exclude (e.g., `"**/*.test.*" "dist/**"`)
@@ -190,20 +203,25 @@ Parse a project and export the dependency graph as JSON.
 
 **Examples:**
 ```bash
-# Basic parse
+# Auto-detect project root
+depwire parse
+
+# Explicit directory
 depwire parse ./src
 
 # Exclude test files and build outputs
-depwire parse ./src --exclude "**/*.test.*" "**/*.spec.*" "dist/**" "build/**"
+depwire parse --exclude "**/*.test.*" "**/*.spec.*" "dist/**" "build/**"
 
 # Full verbosity with stats
-depwire parse ./src --verbose --stats --pretty -o graph.json
+depwire parse --verbose --stats --pretty -o graph.json
 ```
 
-### `depwire viz <directory>`
+### `depwire viz [directory]`
 
 Start visualization server and open arc diagram in browser.
 
+**Directory argument is optional** — Auto-detects project root.
+
 **Options:**
 - `--port <number>` — Port number (default: 3456, auto-increments if in use)
 - `--exclude <patterns...>` — Glob patterns to exclude
@@ -212,33 +230,40 @@ Start visualization server and open arc diagram in browser.
 
 **Examples:**
 ```bash
-# Basic visualization
+# Auto-detect and visualize
+depwire viz
+
+# Explicit directory
 depwire viz ./src
 
 # Custom port without auto-open
-depwire viz ./src --port 8080 --no-open
+depwire viz --port 8080 --no-open
 
 # Exclude test files with verbose logging
-depwire viz ./src --exclude "**/*.test.*" --verbose
+depwire viz --exclude "**/*.test.*" --verbose
 ```
 
 ### `depwire mcp [directory]`
 
 Start MCP server for AI tool integration (Cursor, Claude Desktop).
 
+**Directory argument is optional** — Auto-detects project root and connects automatically.
+
 **Examples:**
 ```bash
-# Start MCP server on current directory
+# Auto-detect and connect (recommended)
 depwire mcp
 
-# Start on specific project
+# Explicit directory
 depwire mcp /path/to/project
 ```
 
-### `depwire docs <directory>`
+### `depwire docs [directory]`
 
 Generate comprehensive codebase documentation from your dependency graph.
 
+**Directory argument is optional** — Auto-detects project root.
+
 **Options:**
 - `--output <path>` — Output directory (default: `.depwire/` inside project)
 - `--format <type>` — Output format: `markdown` or `json` (default: `markdown`)
@@ -253,23 +278,26 @@ Generate comprehensive codebase documentation from your dependency graph.
 
 **Examples:**
 ```bash
-# Generate all docs (outputs to .depwire/ by default)
+# Auto-detect and generate all docs
+depwire docs
+
+# Explicit directory
 depwire docs ./my-project
 
 # Show generation progress and stats
-depwire docs ./my-project --verbose --stats
+depwire docs --verbose --stats
 
 # Regenerate existing docs
-depwire docs ./my-project --update
+depwire docs --update
 
 # Generate specific docs only
-depwire docs ./my-project --include architecture,dependencies
+depwire docs --include architecture,dependencies
 
 # Custom output directory
-depwire docs ./my-project --output ./docs
+depwire docs --output ./docs
 
 # Regenerate only conventions doc
-depwire docs ./my-project --update --only conventions
+depwire docs --update --only conventions
 ```
 
 **Generated Documents (12 total):**
@@ -291,10 +319,12 @@ depwire docs ./my-project --update --only conventions
 
 Documents are stored in `.depwire/` with `metadata.json` tracking generation timestamps for staleness detection.
 
-### `depwire health <directory>`
+### `depwire health [directory]`
 
 Analyze dependency architecture health and get a 0-100 score across 6 quality dimensions.
 
+**Directory argument is optional** — Auto-detects project root.
+
 **Options:**
 - `--json` — Output as JSON (for CI/automation)
 - `--verbose` — Show detailed per-dimension breakdown
@@ -309,14 +339,17 @@ Analyze dependency architecture health and get a 0-100 score across 6 quality di
 
 **Examples:**
 ```bash
-# Analyze current directory
-depwire health .
+# Auto-detect and analyze
+depwire health
+
+# Explicit directory
+depwire health ./my-project
 
 # Detailed breakdown
-depwire health . --verbose
+depwire health --verbose
 
 # JSON output for CI
-depwire health . --json
+depwire health --json
 ```
 
 **Output:**
@@ -345,7 +378,7 @@ Depwire gracefully handles parse errors:
 ```
 # In Claude Desktop or Cursor with Depwire MCP:
 
-"Connect to /Users/me/my-app and analyze the impact of renaming UserService to UserRepository"
+"Analyze the impact of renaming UserService to UserRepository"
 
 # Depwire responds with:
 # - All files that import UserService
@@ -357,7 +390,7 @@ Depwire gracefully handles parse errors:
 ### Understanding a New Codebase
 
 ```
-"Connect to https://github.com/t3-oss/create-t3-app and give me an architecture summary"
+"Show me the architecture summary"
 
 # Depwire responds with:
 # - Language breakdown
@@ -370,7 +403,7 @@ Depwire gracefully handles parse errors:
 
 ```bash
 # Check what your changes affect before committing
-depwire viz . --open
+depwire viz
 # Review the arc diagram — red arcs show files you touched
 ```
 

package/dist/{chunk-AFJFZXCI.js → chunk-VNUOE5VC.js}

@@ -1,7 +1,3 @@
-// src/parser/index.ts
-import { readFileSync as readFileSync3, statSync as statSync2 } from "fs";
-import { join as join6 } from "path";
-
 // src/utils/files.ts
 import { readdirSync, statSync, existsSync, lstatSync } from "fs";
 import { join, relative } from "path";
@@ -50,6 +46,42 @@ function fileExists(filePath) {
     return false;
   }
 }
+function findProjectRoot(startDir = process.cwd()) {
+  const projectMarkers = [
+    "package.json",
+    // Node.js
+    "tsconfig.json",
+    // TypeScript
+    "go.mod",
+    // Go
+    "pyproject.toml",
+    // Python (modern)
+    "setup.py",
+    // Python (legacy)
+    ".git"
+    // Any git repo
+  ];
+  let currentDir = startDir;
+  const rootDir = "/";
+  while (currentDir !== rootDir) {
+    for (const marker of projectMarkers) {
+      const markerPath = join(currentDir, marker);
+      if (existsSync(markerPath)) {
+        return currentDir;
+      }
+    }
+    const parentDir = join(currentDir, "..");
+    if (parentDir === currentDir) {
+      break;
+    }
+    currentDir = parentDir;
+  }
+  return startDir;
+}
+
+// src/parser/index.ts
+import { readFileSync as readFileSync3, statSync as statSync2 } from "fs";
+import { join as join6 } from "path";
 
 // src/parser/detect.ts
 import { extname as extname3 } from "path";
@@ -2988,8 +3020,8 @@ function calculateDepthScore(graph) {
 }
 
 // src/health/index.ts
-import { readFileSync as readFileSync4, writeFileSync, existsSync as existsSync6 } from "fs";
-import { join as join9 } from "path";
+import { readFileSync as readFileSync4, writeFileSync, existsSync as existsSync6, mkdirSync } from "fs";
+import { join as join9, dirname as dirname7 } from "path";
 function calculateHealthScore(graph, projectRoot) {
   const coupling = calculateCouplingScore(graph);
   const cohesion = calculateCohesionScore(graph);
@@ -3111,6 +3143,7 @@ function saveHealthHistory(projectRoot, report) {
   if (history.length > 50) {
     history = history.slice(-50);
   }
+  mkdirSync(dirname7(historyFile), { recursive: true });
   writeFileSync(historyFile, JSON.stringify(history, null, 2), "utf-8");
 }
 function loadHealthHistory(projectRoot) {
@@ -3127,11 +3160,11 @@ function loadHealthHistory(projectRoot) {
 }
 
 // src/docs/generator.ts
-import { writeFileSync as writeFileSync3, mkdirSync, existsSync as existsSync9 } from "fs";
+import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync2, existsSync as existsSync9 } from "fs";
 import { join as join12 } from "path";
 
 // src/docs/architecture.ts
-import { dirname as dirname7 } from "path";
+import { dirname as dirname8 } from "path";
 
 // src/docs/templates.ts
 function header(text, level = 1) {
@@ -3282,7 +3315,7 @@ function generateModuleStructure(graph) {
 function getDirectoryStats(graph) {
   const dirMap = /* @__PURE__ */ new Map();
   graph.forEachNode((node, attrs) => {
-    const dir = dirname7(attrs.filePath);
+    const dir = dirname8(attrs.filePath);
     if (dir === ".") return;
     if (!dirMap.has(dir)) {
       dirMap.set(dir, {
@@ -3307,7 +3340,7 @@ function getDirectoryStats(graph) {
   });
   const filesPerDir = /* @__PURE__ */ new Map();
   graph.forEachNode((node, attrs) => {
-    const dir = dirname7(attrs.filePath);
+    const dir = dirname8(attrs.filePath);
     if (!filesPerDir.has(dir)) {
       filesPerDir.set(dir, /* @__PURE__ */ new Set());
     }
@@ -3322,8 +3355,8 @@ function getDirectoryStats(graph) {
   graph.forEachEdge((edge, attrs, source, target) => {
     const sourceAttrs = graph.getNodeAttributes(source);
     const targetAttrs = graph.getNodeAttributes(target);
-    const sourceDir = dirname7(sourceAttrs.filePath);
-    const targetDir = dirname7(targetAttrs.filePath);
+    const sourceDir = dirname8(sourceAttrs.filePath);
+    const targetDir = dirname8(targetAttrs.filePath);
     if (sourceDir !== targetDir) {
       if (!dirEdges.has(sourceDir)) {
         dirEdges.set(sourceDir, { in: 0, out: 0 });
@@ -4304,7 +4337,7 @@ function detectCyclesDetailed(graph) {
 }
 
 // src/docs/onboarding.ts
-import { dirname as dirname8 } from "path";
+import { dirname as dirname9 } from "path";
 function generateOnboarding(graph, projectRoot, version) {
   let output = "";
   const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -4363,7 +4396,7 @@ function generateQuickOrientation(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 = dirname8(attrs.filePath);
+    const dir = dirname9(attrs.filePath);
     if (dir !== ".") {
       const topLevel = dir.split("/")[0];
       dirs.add(topLevel);
@@ -4467,7 +4500,7 @@ function generateModuleMap(graph) {
 function getDirectoryStats2(graph) {
   const dirMap = /* @__PURE__ */ new Map();
   graph.forEachNode((node, attrs) => {
-    const dir = dirname8(attrs.filePath);
+    const dir = dirname9(attrs.filePath);
     if (dir === ".") return;
     if (!dirMap.has(dir)) {
       dirMap.set(dir, {
@@ -4482,7 +4515,7 @@ function getDirectoryStats2(graph) {
   });
   const filesPerDir = /* @__PURE__ */ new Map();
   graph.forEachNode((node, attrs) => {
-    const dir = dirname8(attrs.filePath);
+    const dir = dirname9(attrs.filePath);
     if (!filesPerDir.has(dir)) {
       filesPerDir.set(dir, /* @__PURE__ */ new Set());
     }
@@ -4497,8 +4530,8 @@ function getDirectoryStats2(graph) {
   graph.forEachEdge((edge, attrs, source, target) => {
     const sourceAttrs = graph.getNodeAttributes(source);
     const targetAttrs = graph.getNodeAttributes(target);
-    const sourceDir = dirname8(sourceAttrs.filePath);
-    const targetDir = dirname8(targetAttrs.filePath);
+    const sourceDir = dirname9(sourceAttrs.filePath);
+    const targetDir = dirname9(targetAttrs.filePath);
     if (sourceDir !== targetDir) {
       if (!dirEdges.has(sourceDir)) {
         dirEdges.set(sourceDir, { in: 0, out: 0 });
@@ -4579,7 +4612,7 @@ function detectClusters(graph) {
   const dirFiles = /* @__PURE__ */ new Map();
   const fileEdges = /* @__PURE__ */ new Map();
   graph.forEachNode((node, attrs) => {
-    const dir = dirname8(attrs.filePath);
+    const dir = dirname9(attrs.filePath);
     if (!dirFiles.has(dir)) {
       dirFiles.set(dir, /* @__PURE__ */ new Set());
     }
@@ -4633,8 +4666,8 @@ function inferClusterName(files) {
   if (sortedWords.length > 0 && sortedWords[0][1] > 1) {
     return capitalizeFirst2(sortedWords[0][0]);
   }
-  const commonDir = dirname8(files[0]);
-  if (files.every((f) => dirname8(f) === commonDir)) {
+  const commonDir = dirname9(files[0]);
+  if (files.every((f) => dirname9(f) === commonDir)) {
     return capitalizeFirst2(commonDir.split("/").pop() || "Core");
   }
   return "Core";
@@ -4692,7 +4725,7 @@ function generateDepwireUsage(projectRoot) {
 }
 
 // src/docs/files.ts
-import { dirname as dirname9, basename as basename3 } from "path";
+import { dirname as dirname10, basename as basename3 } from "path";
 function generateFiles(graph, projectRoot, version) {
   let output = "";
   const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -4796,7 +4829,7 @@ function generateDirectoryBreakdown(graph) {
   const fileStats = getFileStats2(graph);
   const dirMap = /* @__PURE__ */ new Map();
   for (const file of fileStats) {
-    const dir = dirname9(file.filePath);
+    const dir = dirname10(file.filePath);
     const topDir = dir === "." ? "." : dir.split("/")[0];
     if (!dirMap.has(topDir)) {
       dirMap.set(topDir, {
@@ -5439,7 +5472,7 @@ function generateRecommendations(graph) {
 }
 
 // src/docs/tests.ts
-import { basename as basename4, dirname as dirname10 } from "path";
+import { basename as basename4, dirname as dirname11 } from "path";
 function generateTests(graph, projectRoot, version) {
   let output = "";
   const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -5468,7 +5501,7 @@ function getFileCount8(graph) {
 }
 function isTestFile(filePath) {
   const fileName = basename4(filePath).toLowerCase();
-  const dirPath = dirname10(filePath).toLowerCase();
+  const dirPath = dirname11(filePath).toLowerCase();
   if (dirPath.includes("test") || dirPath.includes("spec") || dirPath.includes("__tests__")) {
     return true;
   }
@@ -5527,12 +5560,12 @@ function generateTestFileInventory(graph) {
 }
 function matchTestToSource(testFile) {
   const testFileName = basename4(testFile);
-  const testDir = dirname10(testFile);
+  const testDir = dirname11(testFile);
   let sourceFileName = testFileName.replace(/\.test\./g, ".").replace(/\.spec\./g, ".").replace(/_test\./g, ".").replace(/_spec\./g, ".");
   const possiblePaths = [];
   possiblePaths.push(testDir + "/" + sourceFileName);
   if (testDir.endsWith("/test") || testDir.endsWith("/tests") || testDir.endsWith("/__tests__")) {
-    const parentDir = dirname10(testDir);
+    const parentDir = dirname11(testDir);
     possiblePaths.push(parentDir + "/" + sourceFileName);
   }
   if (testDir.includes("test")) {
@@ -5729,7 +5762,7 @@ function generateTestStatistics(graph) {
 `;
   const dirTestCoverage = /* @__PURE__ */ new Map();
   for (const sourceFile of sourceFiles) {
-    const dir = dirname10(sourceFile).split("/")[0];
+    const dir = dirname11(sourceFile).split("/")[0];
     if (!dirTestCoverage.has(dir)) {
       dirTestCoverage.set(dir, { total: 0, tested: 0 });
     }
@@ -5752,7 +5785,7 @@ function generateTestStatistics(graph) {
 }
 
 // src/docs/history.ts
-import { dirname as dirname11 } from "path";
+import { dirname as dirname12 } from "path";
 import { execSync } from "child_process";
 function generateHistory(graph, projectRoot, version) {
   let output = "";
@@ -6033,7 +6066,7 @@ function generateFeatureClusters(graph) {
   const dirFiles = /* @__PURE__ */ new Map();
   const fileEdges = /* @__PURE__ */ new Map();
   graph.forEachNode((node, attrs) => {
-    const dir = dirname11(attrs.filePath);
+    const dir = dirname12(attrs.filePath);
     if (!dirFiles.has(dir)) {
       dirFiles.set(dir, /* @__PURE__ */ new Set());
     }
@@ -6115,7 +6148,7 @@ function capitalizeFirst3(str) {
 }
 
 // src/docs/current.ts
-import { dirname as dirname12 } from "path";
+import { dirname as dirname13 } from "path";
 function generateCurrent(graph, projectRoot, version) {
   let output = "";
   const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -6253,7 +6286,7 @@ function generateCompleteFileIndex(graph) {
   fileInfos.sort((a, b) => a.filePath.localeCompare(b.filePath));
   const dirGroups = /* @__PURE__ */ new Map();
   for (const info of fileInfos) {
-    const dir = dirname12(info.filePath);
+    const dir = dirname13(info.filePath);
     const topDir = dir === "." ? "root" : dir.split("/")[0];
     if (!dirGroups.has(topDir)) {
       dirGroups.set(topDir, []);
@@ -7033,7 +7066,7 @@ async function generateDocs(graph, projectRoot, version, parseTime, options) {
   const errors = [];
   try {
     if (!existsSync9(options.outputDir)) {
-      mkdirSync(options.outputDir, { recursive: true });
+      mkdirSync2(options.outputDir, { recursive: true });
       if (options.verbose) {
         console.log(`Created output directory: ${options.outputDir}`);
       }
@@ -7239,7 +7272,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/mcp/tools.ts
-import { dirname as dirname13, join as join14 } from "path";
+import { dirname as dirname14, join as join14 } from "path";
 import { existsSync as existsSync11, readFileSync as readFileSync7 } from "fs";
 
 // src/mcp/connect.ts
@@ -8004,7 +8037,7 @@ function handleGetArchitectureSummary(graph) {
   const dirMap = /* @__PURE__ */ new Map();
   const languageBreakdown = {};
   fileSummary.forEach((f) => {
-    const dir = f.filePath.includes("/") ? dirname13(f.filePath) : ".";
+    const dir = f.filePath.includes("/") ? dirname14(f.filePath) : ".";
     if (!dirMap.has(dir)) {
       dirMap.set(dir, { fileCount: 0, symbolCount: 0 });
     }
@@ -8237,6 +8270,7 @@ async function startMcpServer(state) {
 }
 
 export {
+  findProjectRoot,
   parseProject,
   buildGraph,
   getImpact,

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   buildGraph,
   calculateHealthScore,
   createEmptyState,
+  findProjectRoot,
   generateDocs,
   getArchitectureSummary,
   getHealthTrend,
@@ -14,7 +15,7 @@ import {
   startVizServer,
   updateFileInGraph,
   watchProject
-} from "./chunk-AFJFZXCI.js";
+} from "./chunk-VNUOE5VC.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -212,10 +213,10 @@ var packageJsonPath = join(__dirname, "../package.json");
 var packageJson = JSON.parse(readFileSync(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").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) => {
+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) => {
   const startTime = Date.now();
   try {
-    const projectRoot = resolve(directory);
+    const projectRoot = directory ? resolve(directory) : findProjectRoot();
     console.log(`Parsing project: ${projectRoot}`);
     const parsedFiles = await parseProject(projectRoot, {
       exclude: options.exclude,
@@ -299,9 +300,9 @@ Total Transitive Dependents: ${impact.transitiveDependents.length}`);
     process.exit(1);
   }
 });
-program.command("viz").description("Launch interactive arc diagram visualization").argument("<directory>", "Project directory to visualize").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) => {
+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) => {
   try {
-    const projectRoot = resolve(directory);
+    const projectRoot = directory ? resolve(directory) : findProjectRoot();
     console.log(`Parsing project: ${projectRoot}`);
     const parsedFiles = await parseProject(projectRoot, {
       exclude: options.exclude,
@@ -321,25 +322,34 @@ program.command("viz").description("Launch interactive arc diagram visualization
     process.exit(1);
   }
 });
-program.command("mcp").description("Start MCP server for AI coding tools").argument("[directory]", "Project directory to analyze (optional - use connect_repo tool to connect later)").action(async (directory) => {
+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) => {
   try {
     const state = createEmptyState();
+    let projectRootToConnect = null;
     if (directory) {
-      const projectRoot = resolve(directory);
-      console.error(`Parsing project: ${projectRoot}`);
-      const parsedFiles = await parseProject(projectRoot);
+      projectRootToConnect = resolve(directory);
+    } else {
+      const detectedRoot = findProjectRoot();
+      const cwd = process.cwd();
+      if (detectedRoot !== cwd || existsSync(join(cwd, "package.json")) || existsSync(join(cwd, "tsconfig.json")) || existsSync(join(cwd, "go.mod")) || existsSync(join(cwd, "pyproject.toml")) || existsSync(join(cwd, "setup.py")) || existsSync(join(cwd, ".git"))) {
+        projectRootToConnect = detectedRoot;
+      }
+    }
+    if (projectRootToConnect) {
+      console.error(`Parsing project: ${projectRootToConnect}`);
+      const parsedFiles = await parseProject(projectRootToConnect);
       console.error(`Parsed ${parsedFiles.length} files`);
       const graph = buildGraph(parsedFiles);
       console.error(`Built graph: ${graph.order} symbols, ${graph.size} edges`);
       state.graph = graph;
-      state.projectRoot = projectRoot;
-      state.projectName = projectRoot.split("/").pop() || "project";
+      state.projectRoot = projectRootToConnect;
+      state.projectName = projectRootToConnect.split("/").pop() || "project";
       console.error("Starting file watcher...");
-      state.watcher = watchProject(projectRoot, {
+      state.watcher = watchProject(projectRootToConnect, {
         onFileChanged: async (filePath) => {
           console.error(`File changed: ${filePath}`);
           try {
-            await updateFileInGraph(state.graph, projectRoot, filePath);
+            await updateFileInGraph(state.graph, projectRootToConnect, filePath);
             console.error(`Graph updated for ${filePath}`);
           } catch (error) {
             console.error(`Failed to update graph: ${error}`);
@@ -348,7 +358,7 @@ program.command("mcp").description("Start MCP server for AI coding tools").argum
         onFileAdded: async (filePath) => {
           console.error(`File added: ${filePath}`);
           try {
-            await updateFileInGraph(state.graph, projectRoot, filePath);
+            await updateFileInGraph(state.graph, projectRootToConnect, filePath);
             console.error(`Graph updated for ${filePath}`);
           } catch (error) {
             console.error(`Failed to update graph: ${error}`);
@@ -374,10 +384,10 @@ program.command("mcp").description("Start MCP server for AI coding tools").argum
     process.exit(1);
   }
 });
-program.command("docs").description("Generate comprehensive codebase documentation").argument("<directory>", "Project directory to document").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) => {
+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) => {
   const startTime = Date.now();
   try {
-    const projectRoot = resolve(directory);
+    const projectRoot = directory ? resolve(directory) : findProjectRoot();
     const outputDir = options.output ? resolve(options.output) : join(projectRoot, ".depwire");
     const includeList = options.include.split(",").map((s) => s.trim());
     const onlyList = options.only ? options.only.split(",").map((s) => s.trim()) : void 0;
@@ -471,9 +481,9 @@ ${pattern}
     console.error(`Warning: Failed to update .gitignore: ${err}`);
   }
 }
-program.command("health <dir>").description("Analyze dependency architecture health (0-100 score)").option("--json", "Output as JSON").option("--verbose", "Show detailed breakdown").action(async (dir, options) => {
+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) => {
   try {
-    const projectRoot = resolve(dir);
+    const projectRoot = directory ? resolve(directory) : findProjectRoot();
     const startTime = Date.now();
     const parsedFiles = await parseProject(projectRoot);
     const graph = buildGraph(parsedFiles);

package/dist/mcpb-entry.js

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

package/package.json

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