How houseofmvps/codesight works
Codesight scans a project to build compact structural context for AI coding tools. Its main workflow is project discovery, language/framework-aware extraction and detection, then formatting that context as reports, configuration, or wiki articles; developers can also query it through MCP. Separate capabilities map Markdown knowledge, inspect monorepos, and enrich scans with plugins or opt-in native AST parsers. The README documents these product branches, but sampled excerpts do not show the full detector orchestration or MCP dispatch, so those internal links are not expanded.
Main entry points: src/index.ts CLI Entry · core.ts Scan Orchestrator · scanner.ts File Scanner · plugins/index.ts Built-in Plugins
Components 22
Project Analysis
- Scan Orchestrator
src/core.ts - File Scanner
src/scanner.ts - Route Detection
src/detectors/routes.ts - Route AST
src/ast/extract-routes.ts - Schema Detection
src/detectors/schema.ts - Component Detection
src/detectors/components.ts - Dependency Graph
src/detectors/graph.ts - Test Coverage
src/detectors/coverage.ts
Analysis Extensions
- Native AST Host
src/wasm/plugin-host.ts - Built-in Plugins
src/plugins/index.ts - Terraform Plugin
src/plugins/terraform/index.ts
Context Outputs
- Context Formatter
src/formatter.ts - Wiki Generator
src/generators/wiki.ts - HTML Report
src/generators/html-report.ts - AI Config Generator
src/generators/ai-config.ts - Monorepo Scan
src/monorepo/orchestrator.ts
User Interfaces
- CLI Entry
src/index.ts - MCP Server
src/mcp-server.ts
Knowledge Mapping
- Knowledge Detector
src/detectors/knowledge.ts
Other components
- Developer
- Project Files
- AI Coding Tool
Connections 21
- Developer → CLI Entry: runs
- Project Files → File Scanner: provides files
- CLI Entry → Scan Orchestrator: starts scan
- CLI Entry → File Scanner: collects notes
- CLI Entry → Knowledge Detector: analyzes notes
- CLI Entry → Context Formatter: writes knowledge map
- Scan Orchestrator → File Scanner: scans files
- Route Detection → Route AST: uses AST extraction
- Scan Orchestrator → Native AST Host: loads native plugins
- Scan Orchestrator → Built-in Plugins: loads extensions
- Built-in Plugins → Terraform Plugin: exports opt-in
- CLI Entry → Wiki Generator: generates wiki
- CLI Entry → AI Config Generator: generates configs
- CLI Entry → HTML Report: generates report
- CLI Entry → MCP Server: starts server
- Monorepo Scan → Scan Orchestrator: scans packages
- Context Formatter → AI Coding Tool: provides context
- Wiki Generator → AI Coding Tool: provides articles
- AI Config Generator → AI Coding Tool: provides instructions
- HTML Report → Developer: shows report
- MCP Server → AI Coding Tool: serves tools