2233admin / headroom
pythonmainbd55a42353.9K linessynced 1mo ago
Code health
6.6out of 10Good
This codebase scores 6.6 out of 10 on defect risk, which we rate good. The files you change most are the weak spot: 252 of 1,399 files are git hotspots, and they average 4.1.
- Lines of code
- 353.9K
Recent activity
All commitsCommits
No commits indexed yet.
Decisions
- SmartCrusher ports Python entry points and mirrors behavior when subsystems are disabledproposed
- Use provider-specific live-zone dispatchers for compressionproposed
- Disable headroom logger propagation after proxy startup with log-fileproposed
- Set pytest fixtures to avoid deadlocks and flaky timeoutsproposed
- improve logging and message handling for review-3 feedbackproposed
- finish gemini-flash-latest default model sweepproposed
Needs attention
138 open- medium severity. ProposedSmartCrusher ports Python entry points and mirrors behavior when subsystems are disabledAuto-proposed decision awaiting review
- medium severity. ProposedUse provider-specific live-zone dispatchers for compressionAuto-proposed decision awaiting review
- medium severity. ProposedDisable headroom logger propagation after proxy startup with log-fileAuto-proposed decision awaiting review
- medium severity. ProposedSet pytest fixtures to avoid deadlocks and flaky timeoutsAuto-proposed decision awaiting review
- medium severity. Proposedimprove logging and message handling for review-3 feedbackAuto-proposed decision awaiting review
Where the risk concentrates
All 252 hotspotsRanked by prior bug fixes and change frequency, mined from full git history rather than from the code alone.
| File | Churn | Prior fixes | Maintainers | Commits 90d |
|---|---|---|---|---|
| server.pyheadroom/proxy | 100.0th | 107 | 39 | 164 |
| openai.pyheadroom/proxy/handlers | 99.9th | 59 | 20 | 95 |
| wrap.pyheadroom/cli | 99.9th | 48 | 21 | 84 |
| content_router.pyheadroom/transforms | 99.8th | 27 | 15 | 41 |
| anthropic.pyheadroom/proxy/handlers | 99.8th | 38 | 16 | 73 |
Composition
Open the graphpython 63%rust 13%markdown 11%typescript 7%yaml 2%Other 4%
Explore this codebase
- Docs0 pages across 121 modules
- ChatAsk this codebase a question and get an answer with its sources
- Files1,399 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 30 entry points
- Code healthPer-file scores, 6,807 open findings, coverage and refactoring targets
- Knowledge graphEntities, communities, and the paths between them
- Change couplingFiles that keep changing together, mined from commit history
- CommitsChange-risk ranked history with agent provenance
- ContributorsBus factor, per-file maintainers, and the human/agent split
- StatsSize class, origin, lifetime churn, rhythm and records
- CostsWhat indexing this snapshot cost, by model and by run