vzwjustin / headroom-desktop
typescriptmainadebad434.6K linessynced 1mo ago
Code health
3.6out of 10Needs work
This codebase scores 3.6 out of 10 on defect risk, which we rate needs work. It also scores maintainability 5.3 and static performance risk 8.8 out of 10. The three are scored separately and never blended into one number. The files you change most are the weak spot: 13 of 87 files are git hotspots, and they average 2.1.
- Lines of code
- 34.6K
Recent activity
All commitsCommits
No commits indexed yet.
Decisions
- Fail with structured error if all fallback ports are foreign-heldproposed · 1mo ago
- Use default backend port until selection; reset atomic for testsproposed · 1mo ago
- Probe 6768 and fall back to 6769..=6790 at spawn timeproposed · 1mo ago
- Fix intercept port and dynamically select internal backend portproposed · 1mo ago
- Fallback to Sonnet-class pricing when model is unknownproposed · 1mo ago
- Heuristic per-model input-token pricing for compression estimatesproposed · 1mo ago
Needs attention
72 open- medium severity. ProposedFail with structured error if all fallback ports are foreign-heldAuto-proposed decision awaiting review
- medium severity. ProposedUse default backend port until selection; reset atomic for testsAuto-proposed decision awaiting review
- medium severity. ProposedProbe 6768 and fall back to 6769..=6790 at spawn timeAuto-proposed decision awaiting review
- medium severity. ProposedFix intercept port and dynamically select internal backend portAuto-proposed decision awaiting review
- medium severity. ProposedFallback to Sonnet-class pricing when model is unknownAuto-proposed decision awaiting review
Where the risk concentrates
All 13 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 |
|---|---|---|---|---|
| lib.rssrc-tauri/src | 98.4th | 0 | 2bus factor 1 | 60 |
| tool_manager.rssrc-tauri/src | 96.7th | 1 | 2bus factor 1 | 42 |
| state.rssrc-tauri/src | 95.1th | 0 | 2bus factor 1 | 58 |
| App.tsxsrc | 93.4th | 0 | 2bus factor 1 | 45 |
| activity_facts.rssrc-tauri/src | 91.8th | 0 | 1bus factor 1 | 20 |
Composition
Open the graphtypescript 39%rust 26%markdown 18%json 6%yaml 5%Other 6%
Explore this codebase
- Docs0 pages across 30 modules
- ChatAsk this codebase a question and get an answer with its sources
- Files87 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 33 entry points
- Code healthPer-file scores, 549 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