How jjwang1118/graphcode works
Codegraph analyzes a local Python project into one typed code knowledge graph, then serves graph and impact queries to an interactive explorer. The main path runs from a user-supplied path through safe ingestion, scanning, parsing, fact generation and name resolution, graph construction, query/view shaping and serialization, then through the API client into 2D/3D canvases. The README documents these stages and capabilities; the sampled excerpts verify key orchestration and UI edges. Other detailed internal calls are omitted where source was not sampled.
Main entry points: pipeline.py Analysis pipeline · App.tsx Explorer application · analyze.py Analyze API · client.ts API client
Components 28
Analysis backend
- Safe ingestion
backend/app/ingest/local.py - Tree scan
backend/app/scan/walk.py - Python parser
backend/app/parsers/python.py - Language registry
backend/app/languages/registry.py - Fact production
backend/app/facts/production.py - Name resolution
backend/app/resolve - Analysis pipeline
backend/app/pipeline.py - Graph construction
backend/app/graph/build.py - Graph queries
backend/app/graph/query.py - Graph views
backend/app/graph/views.py - Graph persistence
backend/app/graph/store.py - Analyze API
backend/app/api/analyze.py - Impact API
backend/app/api/impact.py
Graph explorer
- Explorer application
frontend/src/App.tsx - API client
frontend/src/api/client.ts - Graph transform
frontend/src/graph/transform.ts - Explorer controls
frontend/src/components/Sidebar.tsx - 2D canvas
frontend/src/components/GraphCanvas.tsx - 3D canvas
frontend/src/components/Graph3D.tsx - Node details
frontend/src/components/DetailBox.tsx - Graph layouts
frontend/src/graph/layouts.ts - Level selection
frontend/src/graph/levels.ts - Graph styling
frontend/src/graph/style.ts - Explorer views
frontend/src/graph/views.ts
Graph model
- Graph schema
backend/app/models/graph.py - Graph identifiers
backend/app/models/ids.py
Other components
- Explorer user
- Local project
Connections 39
- Explorer user → Explorer application: chooses path
frontend/src/App.tsx - Local project → Safe ingestion: provides path
README.md - Explorer application → API client: requests analysis
frontend/src/App.tsx - Explorer application → API client: requests impact
frontend/src/App.tsx - API client → Analyze API: posts analysis
frontend/src/api/client.ts - API client → Impact API: posts impact
frontend/src/api/client.ts - Analyze API → Safe ingestion: validates path
backend/app/api/analyze.py - Analyze API → Analysis pipeline: runs analysis
backend/app/api/analyze.py - Impact API → Analyze API: reuses graph setup
backend/app/api/impact.py - Safe ingestion → Analysis pipeline: supplies root
- Analysis pipeline → Tree scan: scans root
backend/app/pipeline.py - Analysis pipeline → Python parser: parses files
backend/app/pipeline.py - Analysis pipeline → Language registry: selects parser
backend/app/pipeline.py - Analysis pipeline → Name resolution: resolves names
backend/app/pipeline.py - Analysis pipeline → Fact production: produces graph facts
backend/app/pipeline.py - Analysis pipeline → Graph construction: builds graph
backend/app/pipeline.py - Python parser → Language registry: registered by
backend/app/languages/registry.py - Fact production → Name resolution: uses resolution
backend/app/facts/production.py - Tree scan → Graph identifiers: creates node ids
backend/app/scan/walk.py - Graph construction → Graph queries: returns CodeGraph
backend/app/graph/build.py - Graph queries → Graph views: uses tree edge rules
backend/app/graph/query.py - Analyze API → Graph views: collapses and filters
backend/app/api/analyze.py - Graph queries → Graph persistence: uses persistence
- Analysis pipeline → Graph schema: emits graph data
backend/app/pipeline.py - Graph construction → Graph schema: validates graph data
backend/app/graph/build.py - Explorer application → Graph transform: transforms impact
frontend/src/App.tsx - Analyze API → API client: returns graph document
README.md - Impact API → API client: returns impact graph
README.md - Explorer application → Explorer controls: renders controls
frontend/src/App.tsx - Explorer application → 2D canvas: renders graph
frontend/src/App.tsx - Explorer application → 3D canvas: renders graph
frontend/src/App.tsx - Graph transform → 2D canvas: supplies elements
frontend/src/components/GraphCanvas.tsx - Graph transform → 3D canvas: supplies elements
frontend/src/components/Graph3D.tsx - 2D canvas → Node details: shows details
frontend/src/components/GraphCanvas.tsx - 3D canvas → Node details: shows details
frontend/src/components/Graph3D.tsx - 2D canvas → Graph layouts: uses layout options
frontend/src/components/GraphCanvas.tsx - Explorer controls → Level selection: selects level
frontend/src/components/Sidebar.tsx - 2D canvas → Graph styling: uses visual rules
frontend/src/components/GraphCanvas.tsx - Explorer controls → Explorer views: selects view
frontend/src/components/Sidebar.tsx