How gracy769/code_compass works
Code Compass ingests a repository from a local path, GitHub, or ZIP, discovers files, performs static analysis, and produces an interactive dashboard and Summary Explorer. The graph preserves documented analysis capabilities, including contributor analytics, dead-code candidates, semantic review, and the AI prompt. The central analysis flow is supported by the orchestrator excerpt and README; some web-server wiring is unsampled, so those connections are omitted.
Main entry points: orchestrator.py Analysis Coordinator · renderer.py HTML Renderer · cli.py CLI · worker.py Analysis Worker
Components 22
Repository Ingestion
- CLI
src/code_compass/cli.py - Web App
src/code_compass/web/app.py - Analysis Worker
src/code_compass/web/worker.py - File Discovery
src/code_compass/discovery.py - Web Security
src/code_compass/web/security.py
Static Analysis
- Analysis Coordinator
src/code_compass/analysis/orchestrator.py - Python AST Analysis
src/code_compass/analysis/python_analyzer.py - JS/TS Analysis
src/code_compass/analysis/js_analyzer.py - Analysis Results
src/code_compass/analysis/models.py - Layers and Rankings
src/code_compass/analysis/tagger.py
Analysis Insights
- Dead-Code Candidates
src/code_compass/analysis/dead_code.py - Contributor Analytics
src/code_compass/analysis/git_stats.py - Semantic Audit
src/code_compass/analysis/semantic_auditor.py - AI System Prompt
src/code_compass/analysis/prompt.py
Results and Interfaces
- HTML Renderer
src/code_compass/renderer.py - Dashboard View
src/code_compass/templates/dashboard.html.j2 - Summary View
src/code_compass/templates/summary.html.j2 - Analysis Cache
src/code_compass/cache_manager.py
Other components
- Local Repository
- GitHub Repository
- ZIP Upload
- Supabase
Connections 24
- Local Repository → CLI: analyzes path
README.md - GitHub Repository → Web App: submits repository
README.md - ZIP Upload → Web App: uploads archive
README.md - CLI → File Discovery: discovers files
src/code_compass/cli.py - CLI → Analysis Coordinator: runs analysis
src/code_compass/cli.py - CLI → HTML Renderer: renders results
src/code_compass/cli.py - Web App → Web Security: uses protections
src/code_compass/web/app.py - Web App → Analysis Worker: dispatches jobs
- Analysis Worker → File Discovery: discovers files
src/code_compass/web/worker.py - Analysis Worker → Analysis Coordinator: runs analysis
src/code_compass/web/worker.py - Analysis Worker → HTML Renderer: renders results
src/code_compass/web/worker.py - File Discovery → Analysis Coordinator: provides manifest
README.md - Analysis Coordinator → Python AST Analysis: parses Python
src/code_compass/analysis/orchestrator.py - Analysis Coordinator → JS/TS Analysis: parses JS/TS
src/code_compass/analysis/orchestrator.py - Analysis Coordinator → Analysis Results: builds result
src/code_compass/analysis/orchestrator.py - Analysis Coordinator → Layers and Rankings: classifies and ranks
src/code_compass/analysis/orchestrator.py - Analysis Coordinator → Dead-Code Candidates: finds candidates
src/code_compass/analysis/orchestrator.py - Analysis Coordinator → Contributor Analytics: collects history
src/code_compass/analysis/orchestrator.py - Analysis Coordinator → Semantic Audit: requests audit
src/code_compass/analysis/orchestrator.py - Analysis Coordinator → AI System Prompt: generates prompt
src/code_compass/analysis/orchestrator.py - Analysis Coordinator → HTML Renderer: provides results
README.md - HTML Renderer → Dashboard View: renders dashboard
src/code_compass/renderer.py - HTML Renderer → Summary View: renders explorer
src/code_compass/renderer.py - Analysis Cache → Supabase: optionally caches
src/code_compass/cache_manager.py