Epic: Dashboard & Visualization System

[prosdev]

Epic ID: DASH-1
Version: v0.7.1
Type: Epic
Priority: High

Description

Implement a comprehensive dashboard and visualization system for dev-agent that makes codebase insights visible and accessible. This includes both CLI enhancements for terminal users and a full web-based dashboard for rich interactive exploration.

Currently, dev-agent provides powerful context through MCP tools, but users have limited visibility into:

• What has been indexed (language breakdown, component counts)
• Repository health and statistics
• Package-level insights (for monorepos)
• Vector storage quality
• Index freshness and performance

This epic delivers both immediate value (enhanced CLI) and long-term capabilities (web dashboard) to address these gaps.

Goals

1. Enhanced CLI (dev stats) - Terminal-based stats with rich formatting
2. Web Dashboard - Next.js 16 app with real-time insights using Tremor components
3. Data Infrastructure - Aggregate stats during indexing for efficient display
4. Visual Intelligence - Make patterns and insights immediately visible
5. LanceDB Metrics - Show vector storage health and search quality

Acceptance Criteria

• dev stats command shows language breakdown, component types, and package-level stats
• CLI output uses rich formatting (tables, colors, sections)
• New web dashboard deployed at apps/dashboard/ using Next.js + React 19
• Dashboard displays real-time statistics via API routes
• Charts visualize language distribution and component types
• Health indicators show index status and potential issues
• Simple LanceDB metrics (coverage, search quality) displayed
• Works seamlessly with existing monorepo structure
• All new code has 85%+ test coverage
• Documentation updated with dashboard usage examples

Definition of Done

Technical Requirements:

• All code passes linting (Biome) and type checking
• Test coverage ≥85% for new code
• Integration tests for API routes
• No breaking changes to existing functionality
• Performance impact <5% on indexing operations

Documentation:

• CLI reference updated with new commands/options
• Dashboard README in apps/dashboard/
• Usage examples in main documentation site
• Architecture documentation for stats aggregation

User Experience:

• CLI output is clear and informative
• Dashboard loads in <2s on typical repositories
• Accessible UI (ARIA labels, keyboard navigation)

Deployment:

• Changesets created for all affected packages
• Version bumped appropriately (minor for new features)
• CI/CD passes all checks
• Ready for v0.7.1 release

Sub-Issues

Will be linked after creation:

• Story: Data Collection Infrastructure
• Story: Enhanced CLI Statistics
• Story: Web Dashboard Foundation
• Story: Dashboard Visual Components
• Task: Documentation
• Task: Performance Testing

Total: 6 issues