depwire-cli 0.6.1 → 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-S3RUBXRF.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";
@@ -8238,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-S3RUBXRF.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-S3RUBXRF.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.1",
+  "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": {