How adrianhajdin/cartograph works
Cartograph turns a public JavaScript or TypeScript repository into a stored, interactive dependency map. The principal workflow is repository submission, fetch and parse, persistence, then analysis viewing; the map also supports route inspection, dependency blast-radius exploration, and grounded AI explanations and chat. The parser, graph projections, and AI context builder are distinct internal layers. Relationships below are limited to excerpted imports/calls and README statements; several application actions and optional observability wiring were not sampled, so uncertain links are omitted.
Main entry points: analysis-view.tsx Analysis workspace · run.ts Analysis pipeline · page.tsx Analysis page · submit-form.tsx Submit analysis
Components 22
Product workflow
- Submit analysis
components/submit-form.tsx - Analysis pipeline
lib/pipeline/run.ts - Fetch repository
lib/pipeline/github.ts - Analysis storage
lib/pipeline/store.ts - Load analysis
lib/analysis/load.ts
Repository parsing
- AST parser
lib/parser/index.ts - Framework adapters
lib/parser/adapters
Graph analysis
- Graph projections
lib/graph/view.ts - Dependency reach
lib/graph/reach.ts - Graph insights
lib/graph/insights.ts
Map experience
- Analysis page
app/(workspace)/analyses/[id]/page.tsx - Analysis workspace
components/analysis-view.tsx - Dependency canvas
components/map/dependency-map.tsx - Module details
components/detail-pane.tsx - Route table
components/route-table.tsx - Explanation panel
components/explanation-panel.tsx
AI explanations
- Grounding context
lib/analysis/context.ts - AI tasks
lib/ai/tasks.ts
Other components
- Developer
- Public repository
- Supabase database
- OpenAI
Connections 21
- Developer → Submit analysis: submits repository
- Submit analysis → Analysis pipeline: starts analysis
- Analysis pipeline → Fetch repository: fetches source
lib/pipeline/run.ts - Analysis pipeline → AST parser: parses files
lib/pipeline/run.ts - Fetch repository → Public repository: downloads archive
- AST parser → Framework adapters: detects conventions
lib/parser/index.ts - Analysis pipeline → Analysis storage: stores results
lib/pipeline/run.ts - Analysis storage → Supabase database: persists analysis
- Analysis page → Load analysis: loads stored map
app/(workspace)/analyses/[id]/page.tsx - Load analysis → Supabase database: reads analysis
lib/analysis/load.ts - Analysis page → Analysis workspace: renders workspace
app/(workspace)/analyses/[id]/page.tsx - Analysis workspace → Graph projections: projects map
components/analysis-view.tsx - Analysis workspace → Dependency canvas: renders canvas
components/analysis-view.tsx - Analysis workspace → Module details: renders details
components/analysis-view.tsx - Analysis workspace → Route table: renders routes
components/analysis-view.tsx - Module details → Graph insights: finds insights
components/detail-pane.tsx - Analysis workspace → Dependency reach: calculates blast radius
components/analysis-view.tsx - Analysis workspace → Explanation panel: renders explanations
components/analysis-view.tsx - Explanation panel → Grounding context: requests grounded context
- Grounding context → AI tasks: builds prompt context
lib/analysis/context.ts - AI tasks → OpenAI: requests explanations