keygraphhq / shannon
typescriptmain00e564517.9K linessynced 1mo ago
Code health
7.6out of 10Good
This codebase scores 7.6 out of 10 on defect risk, which we rate good. It also scores maintainability 8.6 and static performance risk 9.9 out of 10. The three are scored separately and never blended into one number. The files you change most are the weak spot: 12 of 135 files are git hotspots, and they average 3.8.
- Lines of code
- 17.9K
Recent activity
All commitsCommits
No commits indexed yet.
Decisions
- Ignore EEXIST errors (race condition safe)proposed
- Concurrency Control Utilities Provides mutex implementation for preventing race conditions during coproposed
- SessionMutex - Promise-based mutex for session file operations Prevents race conditions when multiplproposed
- Behavioral heuristic for detecting spending cap. When Claude hits a spending cap, it often returns aproposed
- Consolidated billing/spending cap detection utilities. Anthropic's spending cap behavior is inconsisproposed
- Agent metrics types used across services and activities. Centralized here to avoid temporal/shared.tproposed
Needs attention
168 open- medium severity. ProposedIgnore EEXIST errors (race condition safe)Auto-proposed decision awaiting review
- medium severity. ProposedConcurrency Control Utilities Provides mutex implementation for preventing race conditions during coAuto-proposed decision awaiting review
- medium severity. ProposedSessionMutex - Promise-based mutex for session file operations Prevents race conditions when multiplAuto-proposed decision awaiting review
- medium severity. ProposedBehavioral heuristic for detecting spending cap. When Claude hits a spending cap, it often returns aAuto-proposed decision awaiting review
- medium severity. ProposedConsolidated billing/spending cap detection utilities. Anthropic's spending cap behavior is inconsisAuto-proposed decision awaiting review
Where the risk concentrates
All 12 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 |
|---|---|---|---|---|
| activities.tsapps/worker/src/temporal | 98.9th | 1 | 1bus factor 1 | 9 |
| preflight.tsapps/worker/src/services | 97.9th | 0 | 1bus factor 1 | 7 |
| docker.tsapps/cli/src | 96.8th | 1 | 1bus factor 1 | 5 |
| start.tsapps/cli/src/commands | 95.7th | 1 | 1bus factor 1 | 6 |
| setup.tsapps/cli/src/commands | 94.7th | 0 | 1bus factor 1 | 5 |
Composition
Open the graphtypescript 69%markdown 13%json 8%yaml 7%dockerfile 1%Other 1%
Explore this codebase
- Docs0 pages across 36 modules
- ChatAsk this codebase a question and get an answer with its sources
- Files135 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 8 entry points
- Code healthPer-file scores, 299 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