juliusbrussee / caveman
markdownmain0d95a8112.2K linessynced 6h ago
Code health
7.4out of 10Good
This codebase scores 7.4 out of 10 on defect risk, which we rate good. It also scores maintainability 8.7 and static performance risk 9.6 out of 10. The three are scored separately and never blended into one number. The files you change most are the weak spot: 9 of 143 files are git hotspots, and they average 3.9.
- Lines of code
- 12.2K
Recent activity
All commitsCommits
No commits indexed yet.
Decisions
- Export spawn options so behavior is unit-testable without rerunning CLIproposed · 6h ago
- Use shell:false for POSIX spawn to avoid argv quoting surprisesproposed · 6h ago
- fix(hooks): /caveman arg whitelist + symlinked-parent ~/.claude supportproposed · 6h ago
- fix(#565): install.ps1 works when piped to iexproposed · 6h ago
- fix(opencode): real lifecycle hooks + ship caveman-compress commandproposed · 6h ago
- fix(#601): attribute session tokens to the mode active when each message happenedproposed · 6h ago
Needs attention
73 open- medium severity. ProposedExport spawn options so behavior is unit-testable without rerunning CLIAuto-proposed decision awaiting review
- medium severity. ProposedUse shell:false for POSIX spawn to avoid argv quoting surprisesAuto-proposed decision awaiting review
- medium severity. Proposedfix(hooks): /caveman arg whitelist + symlinked-parent ~/.claude supportAuto-proposed decision awaiting review
- medium severity. Proposedfix(#565): install.ps1 works when piped to iexAuto-proposed decision awaiting review
- medium severity. Proposedfix(opencode): real lifecycle hooks + ship caveman-compress commandAuto-proposed decision awaiting review
Where the risk concentrates
All 9 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 |
|---|---|---|---|---|
| install.jsbin | 98.3th | 9bug magnet | 5 | 20 |
| test_caveman_stats.jstests | 94.8th | 4bug magnet | 1bus factor 1 | 5 |
| e2e.freshinstall.test.mjstests/installer | 91.4th | 4bug magnet | 2 | 6 |
| verify_repo.pytests | 89.7th | 3 | 2bus factor 1 | 5 |
| settings.jsbin/lib | 87.9th | 3 | 2 | 5 |
Composition
Open the graphmarkdown 45%javascript 21%python 17%json 8%toml 4%Other 5%
Explore this codebase
- Docs84 pages across 60 modules
- ChatAsk this codebase a question and get an answer with its sources
- Files143 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 13 entry points
- Code healthPer-file scores, 324 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