depwire-cli 0.7.1 → 0.9.0

package/LICENSE

@@ -1,3 +1,5 @@
+SPDX-License-Identifier: BUSL-1.1
+
 Business Source License 1.1
 
 Parameters

package/README.md

@@ -1,5 +1,29 @@
 # 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" />
+  </a>
+  <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="LICENSE">
+    <img src="https://img.shields.io/badge/license-BUSL--1.1-blue.svg?style=flat-square" alt="License" />
+  </a>
+  <a href="https://github.com/depwire/depwire/stargazers">
+    <img src="https://img.shields.io/github/stars/depwire/depwire.svg?style=flat-square" alt="GitHub stars" />
+  </a>
+  <a href="https://github.com/depwire/depwire/network/members">
+    <img src="https://img.shields.io/github/forks/depwire/depwire.svg?style=flat-square" alt="GitHub forks" />
+  </a>
+</p>
+
 ![Depwire - Arc diagram visualization of the Hono framework](./assets/depwire-hero.png)
 
 **See how your code connects. Give AI tools full codebase context.**
@@ -10,11 +34,12 @@ Depwire analyzes codebases to build a cross-reference graph showing how every fi
 
 - 🎨 **Beautiful arc diagram visualization** — Interactive Harrison Bible-style graphic
 - 🤖 **MCP server for AI tools** — Cursor, Claude Desktop get full dependency context
-- 📊 **Dependency health score** — 0-100 score across 6 dimensions (coupling, cohesion, circular deps, god files, orphans, depth)
-- 📄 **Auto-generated documentation** — 12 comprehensive documents: architecture, conventions, dependencies, onboarding, file catalog, API surface, error patterns, test coverage, git history, full snapshot, TODO/FIXME inventory, and health report
+- 📊 **Dependency health score** — 0-100 score across 6 dimensions (coupling, cohesion, circular deps, god files, orphans & dead code, depth)
+- 📄 **Auto-generated documentation** — 13 comprehensive documents: architecture, conventions, dependencies, onboarding, file catalog, API surface, error patterns, test coverage, git history, full snapshot, TODO/FIXME inventory, health report, and dead code analysis
 - 🔍 **Impact analysis** — "What breaks if I rename this function?" answered precisely
+- 🧹 **Dead code detection** — Find symbols that are defined but never referenced, categorized by confidence level
 - 👀 **Live updates** — Graph stays current as you edit code
-- 🌍 **Multi-language** — TypeScript, JavaScript, Python, and Go
+- 🌍 **Multi-language** — TypeScript, JavaScript, Python, Go, and Rust
 
 ## Why Depwire?
 
@@ -34,14 +59,14 @@ Depwire fixes this by giving AI tools a complete dependency graph of your codeba
 ### Ship Better Code
 - **Impact analysis for any change** — renaming a function, moving a file, upgrading a dependency, deleting a module — know the full blast radius before you touch anything
 - **Refactor with confidence** — see every downstream consumer, every transitive dependency, 2-3 levels deep
-- **Catch dead code** — find symbols nobody references anymore
+- **Catch dead code** — find symbols nobody references anymore with confidence-based classification (high/medium/low)
 
 ### Stay in Flow
 - **Live graph, always current** — edit a file and the dependency map updates in real-time. No re-indexing, no waiting.
 - **Works locally, stays private** — zero cloud accounts, zero data leaving your machine. Just `npm install` and go.
 
-### 14 MCP Tools, Not Just Visualization
-Depwire isn't just a pretty graph. It's a full context engine with 14 tools that AI assistants call autonomously — architecture summaries, dependency tracing, symbol search, file context, health scores, temporal evolution, and more. The AI decides which tool to use based on your question.
+### 15 MCP Tools, Not Just Visualization
+Depwire isn't just a pretty graph. It's a full context engine with 15 tools that AI assistants call autonomously — architecture summaries, dependency tracing, symbol search, file context, health scores, dead code detection, temporal evolution, and more. The AI decides which tool to use based on your question.
 
 ## Installation
 
@@ -66,11 +91,13 @@ depwire viz
 depwire parse
 depwire docs
 depwire health
+depwire dead-code
 depwire temporal
 
 # Or specify a directory explicitly
 npx depwire-cli viz ./my-project
 npx depwire-cli parse ./my-project
+npx depwire-cli dead-code ./my-project
 npx depwire-cli temporal ./my-project
 
 # Temporal visualization options
@@ -139,6 +166,7 @@ Settings → Features → Experimental → Enable MCP → Add Server:
 | `get_project_docs` | Retrieve auto-generated codebase documentation |
 | `update_project_docs` | Regenerate documentation on demand |
 | `get_health_score` | Get 0-100 dependency health score with recommendations |
+| `find_dead_code` | Find dead code — symbols defined but never referenced |
 | `get_temporal_graph` | Show how the graph evolved over git history |
 
 ## Supported Languages
@@ -149,6 +177,7 @@ Settings → Features → Experimental → Enable MCP → Add Server:
 | JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | ES modules, CommonJS require(), JSX components |
 | Python | `.py` | Imports, classes, decorators, inheritance |
 | Go | `.go` | go.mod resolution, structs, interfaces, methods |
+| Rust | `.rs` | Functions, structs, enums, traits, impl blocks, use declarations |
 
 ## Visualization
 
@@ -189,6 +218,8 @@ Opens an interactive arc diagram in your browser:
 
 Visualize how your codebase architecture evolved over git history. Scrub through time with an interactive timeline slider.
 
+![Depwire Temporal Graph](assets/depwire-temporal-hono.gif)
+
 ```bash
 # Auto-detects project root
 depwire temporal
@@ -220,6 +251,37 @@ Opens an interactive temporal visualization in your browser:
 - Auto-zoom to fit all arcs on snapshot change
 - Search to highlight specific files across time
 
+## 🪦 Dead Code Detection
+
+Find unused symbols across your codebase before they become technical debt.
+
+- Detects symbols with zero incoming references (never called, never imported)
+- Confidence scoring: **high** (definitely dead), **medium** (probably dead), **low** (might be dead)
+- Smart exclusion rules — ignores entry points, test files, barrel files, and config files to reduce false positives
+- Filter by confidence level, export as JSON for CI pipelines
+- Integrated into the health score (orphans dimension)
+- New MCP tool: `find_dead_code` — AI assistants can query dead code directly
+- New document generator: `DEAD_CODE.md` — auto-generated dead code report
+
+```bash
+depwire dead-code
+depwire dead-code --confidence high
+depwire dead-code --stats
+depwire dead-code --json
+```
+
+**Confidence Levels:**
+- 🔴 **High confidence (definitely dead)**: Not exported with zero references, or exported but never used
+- 🟡 **Medium confidence (probably dead)**: Exported from barrel files with zero dependents, or only used in test files
+- ⚪ **Low confidence (might be dead)**: Exported from package entry points, types with zero dependents, or in dynamic-use directories (routes, middleware, etc.)
+
+The dead code detector automatically excludes:
+- Entry point files (index.ts, main.ts, server.ts, etc.)
+- Test files (*.test.*, *.spec.*, __tests__/)
+- Config files (*.config.*)
+- Type declarations (*.d.ts)
+- Framework auto-loaded directories (pages/, routes/, middleware/, commands/)
+
 ## How It Works
 
 1. **Parser** — tree-sitter extracts every symbol and reference
@@ -357,6 +419,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) |
 
 Documents are stored in `.depwire/` with `metadata.json` tracking generation timestamps for staleness detection.
 
@@ -401,6 +464,56 @@ depwire health --json
 
 Health history is stored in `.depwire/health-history.json` (last 50 checks).
 
+### `depwire dead-code [directory]`
+
+Detect unused symbols across your codebase with confidence-based classification.
+
+**Directory argument is optional** — Auto-detects project root.
+
+**Options:**
+- `--confidence <level>` — Minimum confidence level to show: `high`, `medium`, `low` (default: `medium`)
+- `--include-low` — Shortcut for `--confidence low`
+- `--verbose` — Show detailed info for each dead symbol (file, line, kind, reason)
+- `--stats` — Show summary statistics
+- `--include-tests` — Include test files in analysis (excluded by default)
+- `--json` — Output as JSON for CI/automation
+
+**Confidence Levels:**
+- 🔴 **High confidence (definitely dead)**: Not exported with zero references, or exported but never used
+- 🟡 **Medium confidence (probably dead)**: Exported from barrel files with zero dependents, or only used in test files
+- ⚪ **Low confidence (might be dead)**: Exported from package entry points, types with zero dependents, or in dynamic-use directories (routes, middleware, etc.)
+
+**Examples:**
+```bash
+# Analyze dead code (default: medium confidence and above)
+depwire dead-code
+
+# Show only high-confidence dead code
+depwire dead-code --confidence high
+
+# Show all potential dead code (including low confidence)
+depwire dead-code --confidence low
+# Or use shortcut
+depwire dead-code --include-low
+
+# Detailed analysis with reasons and statistics
+depwire dead-code --verbose --stats
+
+# Include test files in analysis (excluded by default)
+depwire dead-code --include-tests
+
+# JSON output for CI/automation
+depwire dead-code --json
+```
+
+**Automatic Exclusions:**
+The dead code detector automatically excludes:
+- Entry point files (index.ts, main.ts, server.ts, etc.)
+- Test files (*.test.*, *.spec.*, __tests__/)
+- Config files (*.config.*)
+- Type declarations (*.d.ts)
+- Framework auto-loaded directories (pages/, routes/, middleware/, commands/)
+
 ### `depwire temporal [directory]`
 
 Visualize how the dependency graph evolved over git history.
@@ -500,10 +613,26 @@ See [SECURITY.md](SECURITY.md) for full details.
 
 ## Roadmap
 
-- [ ] PR Impact Visualization (GitHub Action)
-- [ ] Temporal Graph — watch your architecture evolve over git history
+### ✅ Shipped
+- [x] Arc diagram visualization
+- [x] MCP server (15 tools)
+- [x] Multi-language support (TypeScript, JavaScript, Python, Go, Rust)
+- [x] File watching + live refresh
+- [x] Auto-generated documentation (13 documents)
+- [x] Dependency health score (0-100)
+- [x] Dead code detection with confidence scoring
+- [x] Temporal graph — watch your architecture evolve over git history
+- [x] PR Impact GitHub Action (depwire-action v1.0.0)
+- [x] Auto-detect project root (no path needed)
+- [x] WASM migration (Windows support)
+
+### 🔜 Coming Next
+- [ ] New language support (C — community requested)
+- [ ] "What If" simulation — simulate refactors before touching code
 - [ ] Cross-language edge detection (API routes ↔ frontend calls)
-- [ ] Dependency health scoring
+- [ ] Cloud dashboard (first paid feature)
+- [ ] AI-suggested refactors
+- [ ] Natural language architecture queries
 - [ ] VSCode extension
 
 ## Contributing