v2.0.0 — MCP Only

Breaking Changes

• Removed browser mode — no more 3D visualization, Next.js, or --port flag
• Removed REST API — all 13 API routes deleted
• --mcp flag is now a no-op — MCP stdio is the default (and only) mode

What's New

• 15 MCP tools fully tested (96%+ coverage)
• CI pipeline — lint, typecheck, build, test on Node 18/20/22
• Automated npm publish on v* tags with provenance

Migration

Before:

npx codebase-intelligence ./src --mcp

After:

npx codebase-intelligence ./src

Existing .mcp.json configs with --mcp will continue to work (flag is silently ignored).

Stats

• -7,075 lines deleted (web UI, REST API, Playwright, React components)
• +1,205 lines added (MCP tests, CI workflow, coverage config)
• ~40 files deleted, 15 modified
• Package size: 51kB (down from ~1.8GB installed)

v1.1.0 — 100% MCP-REST Data Parity

What's New

New MCP Tools

• get_processes — trace execution flows from entry points through the call graph
• get_clusters — community-detected clusters of related files (Louvain algorithm)

Enhanced MCP Tools

• symbol_context — now includes pageRank, betweenness, loc, type, isDefault, complexity, and caller/callee confidence
• file_context — imports/dependents now include isTypeOnly and weight edge metadata
• analyze_forces — cohesionThreshold, tensionThreshold, escapeThreshold params now wired to filter logic
• detect_changes — includes fileRiskMetrics with blastRadius, complexity, churn per changed file

Tool Disambiguation

All 15 tool descriptions rewritten with "Use when: / Not for:" pattern for better LLM auto-selection.

Docs

• README synced: 15 MCP tools, 13 REST endpoints, symbol-level features, BM25 search, process tracing, community detection
• docs/mcp-tools.md fully rewritten with all 15 tools + prompts + resources

Data Parity

MCP tools now expose 100% of computed data (previously ~70%). Every metric, field, and data point available via REST is now accessible through MCP tools.

Tests

• 21 new tests in tests/mcp-parity.test.ts covering all new/enhanced tools

v1.0.1 — Fix npx install compatibility

Fixed npx codebase-visualizer failing silently due to preinstall: "npx only-allow pnpm" rejecting npm-based installs. Removed the guard — pnpm is enforced via packageManager field instead.

Changed Files

File	Change
package.json	Removed preinstall script that blocked npx/npm consumers, bumped version 1.0.0 → 1.0.1, scoped package name to @bntvllnt/codebase-visualizer
.gitignore	Added .npmrc to prevent committing auth tokens

v1.0.0 — 3D Codebase Visualization + MCP Server

3D interactive maps of TypeScript codebases — browser visualization + MCP server for LLM integration.

Highlights

• 10 views: Galaxy, Dep Flow, Hotspot, Focus, Module, Forces, Churn, Coverage, Symbols, Types
• 13 MCP tools with HTTP + stdio transport
• Symbol-level graph: call graph, per-symbol PageRank/betweenness, symbol search
• Group spatial clustering: cluster force, box cloud envelopes, adjustable strength slider
• Selectable groups: click groups in legend to filter/highlight, multi-select
• Agent intelligence: BM25 search, process tracing, Louvain clustering, impact analysis, rename_symbol
• Staleness detection: detects when index is outdated vs working tree
• File tree: browse and search files from sidebar

Install

npmjs.com:

pnpm add -g codebase-visualizer

GitHub Packages:

pnpm add -g @bntvllnt/codebase-visualizer --registry https://npm.pkg.github.com

Usage

# Browser visualization
codebase-visualizer ./src --port 3000

# MCP stdio (for LLMs)
codebase-visualizer ./src --mcp