How tarun-1009/codebase-cipher works
Codebase Cipher accepts a GitHub repository and branch, analyzes its structure and code relationships, and presents interactive results for exploration and export. The documented analysis stages include language detection, function and endpoint extraction, dependency construction, and traceability; the backend also offers AI summaries at file, folder, and repository levels, with persistent summary runs. The README describes broader parser and GitHub capabilities; several internal links below reflect those documented responsibilities, while unsampled implementation details are not expanded.
Main entry points: analyze.jsx Analyze Page · buildDependencyTree.js Dependency Builder · server.js Backend API · bottomUpSummary.js Summary Runs
Components 21
Repository Analysis UI
- Analyze Page
frontend/src/pages/analyze.jsx
Code Analysis
- Backend API
backend/server.js - Dependency Builder
backend/src/utils/buildDependencyTree.js - Language Detection
backend/src/parsers/languageDetector.js - Import Detection
backend/src/parsers/importDetector.js - Function Parsing
backend/src/parsers/functionParser.js - Endpoint Parsing
backend/src/parsers/endpointParser.js - Traceability Engine
backend/src/engines/traceabilityEngine.js
AI Summaries
- Summary Service
backend/src/services/summarise.js - Summary Runs
backend/src/services/bottomUpSummary.js - PostgreSQL
backend/prisma/schema.prisma
Analysis Results
- Repository Tree
frontend/src/components/Canvas/Tree.jsx - Dependency Graph
frontend/src/components/Canvas/DependencyGraph.jsx - Traceability Graph
frontend/src/components/Canvas/TraceabilityGraph.jsx - API Catalog
frontend/src/components/ApiCatalog/ApiCatalog.jsx - File Explorer
frontend/src/components/Sidebar/FileExplorer.jsx - Summary View
frontend/src/components/Summary/Summary.jsx - PDF Report
frontend/src/utils/generatePdfReport.js
Other components
- Developer
- GitHub
- Groq API
Connections 23
- Developer → Analyze Page: submits repository
- Analyze Page → Backend API: requests analysis
- Backend API → Dependency Builder: builds analysis
- Dependency Builder → GitHub: fetches repository
- Dependency Builder → Language Detection: detects languages
- Dependency Builder → Import Detection: detects imports
- Dependency Builder → Function Parsing: extracts functions
- Dependency Builder → Endpoint Parsing: extracts endpoints
- Dependency Builder → Traceability Engine: builds traceability
- Backend API → Summary Service: generates summaries
- Backend API → Summary Runs: builds summary runs
- Summary Runs → Summary Service: generates levels
- Summary Service → Groq API: requests summaries
- Summary Runs → PostgreSQL: persists summaries
- Summary Runs → PostgreSQL: loads summary runs
- Analyze Page → Repository Tree: renders tree
- Analyze Page → Dependency Graph: renders dependencies
- Analyze Page → Traceability Graph: renders traceability
- Analyze Page → API Catalog: renders endpoints
- Analyze Page → File Explorer: renders files
- Analyze Page → Summary View: shows summaries
- Analyze Page → PDF Report: exports report
- Summary View → Backend API: requests summaries