# sumit5213/code-mapper architecture

> Architecture diagram of the GitHub repository sumit5213/code-mapper, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sumit5213/code-mapper
- Repository: https://github.com/sumit5213/code-mapper

## Overview

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: [`components/analysis-view.tsx`](https://github.com/sumit5213/code-mapper/blob/main/components/analysis-view.tsx) (Analysis workspace), [`lib/pipeline/run.ts`](https://github.com/sumit5213/code-mapper/blob/main/lib/pipeline/run.ts) (Pipeline runner), [`lib/ai/tasks.ts`](https://github.com/sumit5213/code-mapper/blob/main/lib/ai/tasks.ts) (AI explanation tasks), [`lib/supabase/server.ts`](https://github.com/sumit5213/code-mapper/blob/main/lib/supabase/server.ts) (Analysis database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Analysis workflow"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_submit["Analysis actions<br/>[actions.ts]"]
  node_pipeline["Pipeline runner<br/>[run.ts]"]
  node_github["GitHub archive fetch<br/>[github.ts]"]
  node_analysisdb[("Analysis database<br/>[server.ts]")]
  node_progress["Run progress"]
end

subgraph group_parse["Repository parsing"]
  node_parser["AST parser<br/>[index.ts]"]
  node_frameworks["Framework adapters"]
  node_parsedmodel["Parsed graph model<br/>[types.ts]"]
  node_graphview["Graph projection<br/>[view.ts]"]
  node_folding["Directory folding<br/>[fold.ts]"]
  node_roles["Role taxonomy<br/>[roles.ts]"]
end

subgraph group_explain["AI explanations"]
  node_explanation["Explanation panel"]
  node_context["AI context builder<br/>[context.ts]"]
  node_tasks["AI explanation tasks<br/>[tasks.ts]"]
  node_prompts["AI prompts<br/>[prompts.ts]"]
  node_groq["Groq inference<br/>[client.ts]"]
end

subgraph group_display["Map experience"]
  node_analysispage["Analysis page<br/>[page.tsx]"]
  node_analysisload["Stored analysis loader<br/>[load.ts]"]
  node_analysisview["Analysis workspace<br/>[analysis-view.tsx]"]
  node_map["Interactive dependency map<br/>[dependency-map.tsx]"]
  node_maplayout["Map layout<br/>[layout.ts]"]
  node_details["File and graph details<br/>[detail-pane.tsx]"]
  node_insights["Graph insights<br/>[insights.ts]"]
end

node_user(("Repository analyst"))

node_user -->|"opens workspace"| node_dashboard
node_dashboard -.->|"starts analysis"| node_submit
node_submit -->|"submits run"| node_pipeline
node_pipeline -->|"fetches archive"| node_github
node_pipeline -->|"parses repository"| node_parser
node_parser -->|"selects adapters"| node_frameworks
node_parser -->|"produces graph data"| node_parsedmodel
node_pipeline -->|"stores results"| node_analysisdb
node_pipeline -->|"publishes status"| node_progress
node_analysispage -->|"loads analysis"| node_analysisdb
node_analysispage -->|"loads stored map"| node_analysisload
node_analysisload -->|"reads stored data"| node_analysisdb
node_analysispage -->|"renders map workspace"| node_analysisview
node_analysisview -->|"renders dependency map"| node_map
node_analysisview -->|"renders details"| node_details
node_analysisview -->|"renders explanations"| node_explanation
node_analysisview -->|"projects graph"| node_graphview
node_analysisview -->|"folds directories"| node_folding
node_map -->|"uses layout"| node_maplayout
node_map -->|"uses folded groups"| node_folding
node_details -->|"finds patterns"| node_insights
node_analysisload -->|"loads roles"| node_roles
node_explanation -->|"requests explanations"| node_tasks
node_tasks -->|"builds prompts"| node_prompts
node_tasks -->|"calls inference"| node_groq
node_context -->|"supplies context"| node_prompts
node_tasks -.->|"caches answers"| node_analysisdb
node_groq -.->|"returns explanations"| node_user

click node_dashboard "https://github.com/sumit5213/code-mapper/blob/main/app/(workspace)/dashboard/page.tsx"
click node_submit "https://github.com/sumit5213/code-mapper/blob/main/app/(workspace)/actions.ts"
click node_pipeline "https://github.com/sumit5213/code-mapper/blob/main/lib/pipeline/run.ts"
click node_github "https://github.com/sumit5213/code-mapper/blob/main/lib/pipeline/github.ts"
click node_analysisdb "https://github.com/sumit5213/code-mapper/blob/main/lib/supabase/server.ts"
click node_parser "https://github.com/sumit5213/code-mapper/blob/main/lib/parser/index.ts"
click node_frameworks "https://github.com/sumit5213/code-mapper/tree/main/lib/parser/adapters"
click node_parsedmodel "https://github.com/sumit5213/code-mapper/blob/main/lib/parser/types.ts"
click node_graphview "https://github.com/sumit5213/code-mapper/blob/main/lib/graph/view.ts"
click node_folding "https://github.com/sumit5213/code-mapper/blob/main/lib/graph/fold.ts"
click node_roles "https://github.com/sumit5213/code-mapper/blob/main/lib/roles.ts"
click node_analysispage "https://github.com/sumit5213/code-mapper/blob/main/app/(workspace)/analyses/%5Bid%5D/page.tsx"
click node_analysisload "https://github.com/sumit5213/code-mapper/blob/main/lib/analysis/load.ts"
click node_analysisview "https://github.com/sumit5213/code-mapper/blob/main/components/analysis-view.tsx"
click node_map "https://github.com/sumit5213/code-mapper/blob/main/components/map/dependency-map.tsx"
click node_maplayout "https://github.com/sumit5213/code-mapper/blob/main/components/map/layout.ts"
click node_details "https://github.com/sumit5213/code-mapper/blob/main/components/detail-pane.tsx"
click node_insights "https://github.com/sumit5213/code-mapper/blob/main/lib/graph/insights.ts"
click node_explanation "https://github.com/sumit5213/code-mapper/blob/main/components/explanation-panel.tsx"
click node_context "https://github.com/sumit5213/code-mapper/blob/main/lib/analysis/context.ts"
click node_tasks "https://github.com/sumit5213/code-mapper/blob/main/lib/ai/tasks.ts"
click node_prompts "https://github.com/sumit5213/code-mapper/blob/main/lib/ai/prompts.ts"
click node_groq "https://github.com/sumit5213/code-mapper/blob/main/lib/ai/client.ts"
click node_progress "https://github.com/sumit5213/code-mapper/blob/main/components/progress/analysis-progress.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_submit,node_pipeline,node_github,node_analysisdb,node_progress toneBlue
class node_parser,node_frameworks,node_parsedmodel,node_graphview,node_folding,node_roles toneAmber
class node_explanation,node_context,node_tasks,node_prompts,node_groq toneMint
class node_analysispage,node_analysisload,node_analysisview,node_map,node_maplayout,node_details,node_insights toneRose
class node_user toneIndigo
```

## Components

### Analysis workflow

- [Dashboard](https://github.com/sumit5213/code-mapper/blob/main/app/(workspace)/dashboard/page.tsx): `app/(workspace)/dashboard/page.tsx`
- [Analysis actions](https://github.com/sumit5213/code-mapper/blob/main/app/(workspace)/actions.ts): `app/(workspace)/actions.ts`
- [Pipeline runner](https://github.com/sumit5213/code-mapper/blob/main/lib/pipeline/run.ts): `lib/pipeline/run.ts`
- [GitHub archive fetch](https://github.com/sumit5213/code-mapper/blob/main/lib/pipeline/github.ts): `lib/pipeline/github.ts`
- [Analysis database](https://github.com/sumit5213/code-mapper/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- [Run progress](https://github.com/sumit5213/code-mapper/blob/main/components/progress/analysis-progress.tsx): `components/progress/analysis-progress.tsx`

### Repository parsing

- [AST parser](https://github.com/sumit5213/code-mapper/blob/main/lib/parser/index.ts): `lib/parser/index.ts`
- [Framework adapters](https://github.com/sumit5213/code-mapper/tree/main/lib/parser/adapters): `lib/parser/adapters`
- [Parsed graph model](https://github.com/sumit5213/code-mapper/blob/main/lib/parser/types.ts): `lib/parser/types.ts`
- [Graph projection](https://github.com/sumit5213/code-mapper/blob/main/lib/graph/view.ts): `lib/graph/view.ts`
- [Directory folding](https://github.com/sumit5213/code-mapper/blob/main/lib/graph/fold.ts): `lib/graph/fold.ts`
- [Role taxonomy](https://github.com/sumit5213/code-mapper/blob/main/lib/roles.ts): `lib/roles.ts`

### AI explanations

- [Explanation panel](https://github.com/sumit5213/code-mapper/blob/main/components/explanation-panel.tsx): `components/explanation-panel.tsx`
- [AI context builder](https://github.com/sumit5213/code-mapper/blob/main/lib/analysis/context.ts): `lib/analysis/context.ts`
- [AI explanation tasks](https://github.com/sumit5213/code-mapper/blob/main/lib/ai/tasks.ts): `lib/ai/tasks.ts`
- [AI prompts](https://github.com/sumit5213/code-mapper/blob/main/lib/ai/prompts.ts): `lib/ai/prompts.ts`
- [Groq inference](https://github.com/sumit5213/code-mapper/blob/main/lib/ai/client.ts): `lib/ai/client.ts`

### Map experience

- [Analysis page](https://github.com/sumit5213/code-mapper/blob/main/app/(workspace)/analyses/%5Bid%5D/page.tsx): `app/(workspace)/analyses/[id]/page.tsx`
- [Stored analysis loader](https://github.com/sumit5213/code-mapper/blob/main/lib/analysis/load.ts): `lib/analysis/load.ts`
- [Analysis workspace](https://github.com/sumit5213/code-mapper/blob/main/components/analysis-view.tsx): `components/analysis-view.tsx`
- [Interactive dependency map](https://github.com/sumit5213/code-mapper/blob/main/components/map/dependency-map.tsx): `components/map/dependency-map.tsx`
- [Map layout](https://github.com/sumit5213/code-mapper/blob/main/components/map/layout.ts): `components/map/layout.ts`
- [File and graph details](https://github.com/sumit5213/code-mapper/blob/main/components/detail-pane.tsx): `components/detail-pane.tsx`
- [Graph insights](https://github.com/sumit5213/code-mapper/blob/main/lib/graph/insights.ts): `lib/graph/insights.ts`

### Other components

- **Repository analyst**

## Connections

- Repository analyst → Dashboard: opens workspace (evidence: `README.md`)
- Dashboard → Analysis actions: starts analysis
- Analysis actions → Pipeline runner: submits run (evidence: `app/(workspace)/actions.ts`)
- Pipeline runner → GitHub archive fetch: fetches archive (evidence: `lib/pipeline/run.ts`)
- Pipeline runner → AST parser: parses repository (evidence: `lib/pipeline/run.ts`)
- AST parser → Framework adapters: selects adapters (evidence: `lib/parser/index.ts`)
- AST parser → Parsed graph model: produces graph data (evidence: `lib/parser/index.ts`)
- Pipeline runner → Analysis database: stores results (evidence: `lib/pipeline/run.ts`)
- Pipeline runner → Run progress: publishes status (evidence: `README.md`)
- Analysis page → Analysis database: loads analysis (evidence: `app/(workspace)/analyses/[id]/page.tsx`)
- Analysis page → Stored analysis loader: loads stored map (evidence: `app/(workspace)/analyses/[id]/page.tsx`)
- Stored analysis loader → Analysis database: reads stored data (evidence: `lib/analysis/load.ts`)
- Analysis page → Analysis workspace: renders map workspace (evidence: `app/(workspace)/analyses/[id]/page.tsx`)
- Analysis workspace → Interactive dependency map: renders dependency map (evidence: `components/analysis-view.tsx`)
- Analysis workspace → File and graph details: renders details (evidence: `components/analysis-view.tsx`)
- Analysis workspace → Explanation panel: renders explanations (evidence: `components/analysis-view.tsx`)
- Analysis workspace → Graph projection: projects graph (evidence: `components/analysis-view.tsx`)
- Analysis workspace → Directory folding: folds directories (evidence: `components/analysis-view.tsx`)
- Interactive dependency map → Map layout: uses layout (evidence: `components/map/dependency-map.tsx`)
- Interactive dependency map → Directory folding: uses folded groups (evidence: `components/map/dependency-map.tsx`)
- File and graph details → Graph insights: finds patterns (evidence: `components/detail-pane.tsx`)
- Stored analysis loader → Role taxonomy: loads roles (evidence: `lib/analysis/load.ts`)
- Explanation panel → AI explanation tasks: requests explanations (evidence: `components/explanation-panel.tsx`)
- AI explanation tasks → AI prompts: builds prompts (evidence: `lib/ai/tasks.ts`)
- AI explanation tasks → Groq inference: calls inference (evidence: `lib/ai/tasks.ts`)
- AI context builder → AI prompts: supplies context (evidence: `lib/analysis/context.ts`)
- AI explanation tasks → Analysis database: caches answers
- Groq inference → Repository analyst: returns explanations
