How sumit5213/code-mapper works
CodeMapper accepts a public GitHub repository, parses its source into dependency and route data, stores an analysis, and presents an interactive map with graph insights and AI explanations. The documented run includes archive ingestion, AST parsing, graph calculation, and AI categorization/explanation; the source index shows the main orchestration and UI dependencies. Several pipeline and analysis-action files were not excerpted, so some documented workflow links rely on the README rather than inspected implementation.
Main entry points: analysis-view.tsx Analysis workspace · run.ts Pipeline runner · tasks.ts AI explanation tasks · server.ts Analysis database
Components 25
Analysis workflow
- Dashboard
app/(workspace)/dashboard/page.tsx - Analysis actions
app/(workspace)/actions.ts - Pipeline runner
lib/pipeline/run.ts - GitHub archive fetch
lib/pipeline/github.ts - Analysis database
lib/supabase/server.ts - Run progress
components/progress/analysis-progress.tsx
Repository parsing
- AST parser
lib/parser/index.ts - Framework adapters
lib/parser/adapters - Parsed graph model
lib/parser/types.ts - Graph projection
lib/graph/view.ts - Directory folding
lib/graph/fold.ts - Role taxonomy
lib/roles.ts
AI explanations
- Explanation panel
components/explanation-panel.tsx - AI context builder
lib/analysis/context.ts - AI explanation tasks
lib/ai/tasks.ts - AI prompts
lib/ai/prompts.ts - Groq inference
lib/ai/client.ts
Map experience
- Analysis page
app/(workspace)/analyses/[id]/page.tsx - Stored analysis loader
lib/analysis/load.ts - Analysis workspace
components/analysis-view.tsx - Interactive dependency map
components/map/dependency-map.tsx - Map layout
components/map/layout.ts - File and graph details
components/detail-pane.tsx - Graph insights
lib/graph/insights.ts
Other components
- Repository analyst
Connections 28
- Repository analyst → Dashboard: opens workspace
README.md - Dashboard → Analysis actions: starts analysis
- Analysis actions → Pipeline runner: submits run
app/(workspace)/actions.ts - Pipeline runner → GitHub archive fetch: fetches archive
lib/pipeline/run.ts - Pipeline runner → AST parser: parses repository
lib/pipeline/run.ts - AST parser → Framework adapters: selects adapters
lib/parser/index.ts - AST parser → Parsed graph model: produces graph data
lib/parser/index.ts - Pipeline runner → Analysis database: stores results
lib/pipeline/run.ts - Pipeline runner → Run progress: publishes status
README.md - Analysis page → Analysis database: loads analysis
app/(workspace)/analyses/[id]/page.tsx - Analysis page → Stored analysis loader: loads stored map
app/(workspace)/analyses/[id]/page.tsx - Stored analysis loader → Analysis database: reads stored data
lib/analysis/load.ts - Analysis page → Analysis workspace: renders map workspace
app/(workspace)/analyses/[id]/page.tsx - Analysis workspace → Interactive dependency map: renders dependency map
components/analysis-view.tsx - Analysis workspace → File and graph details: renders details
components/analysis-view.tsx - Analysis workspace → Explanation panel: renders explanations
components/analysis-view.tsx - Analysis workspace → Graph projection: projects graph
components/analysis-view.tsx - Analysis workspace → Directory folding: folds directories
components/analysis-view.tsx - Interactive dependency map → Map layout: uses layout
components/map/dependency-map.tsx - Interactive dependency map → Directory folding: uses folded groups
components/map/dependency-map.tsx - File and graph details → Graph insights: finds patterns
components/detail-pane.tsx - Stored analysis loader → Role taxonomy: loads roles
lib/analysis/load.ts - Explanation panel → AI explanation tasks: requests explanations
components/explanation-panel.tsx - AI explanation tasks → AI prompts: builds prompts
lib/ai/tasks.ts - AI explanation tasks → Groq inference: calls inference
lib/ai/tasks.ts - AI context builder → AI prompts: supplies context
lib/analysis/context.ts - AI explanation tasks → Analysis database: caches answers
- Groq inference → Repository analyst: returns explanations