keygraphhq / shannon
Code health
This codebase scores 6.6 out of 10 for code health, which we rate fair. It also scores maintainability 8.1 and static performance 9.8 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 12 of 135 files are git hotspots, and they average 3.7 — which is where the fixes pay off most.
Do next
1 thing worth doing this quarter.
Worth planning
Delete 12 unused symbols and files (183 lines)
Nothing in the graph reaches them, across 6 files; every reader and agent pays to skip them.
- symbols
- 12
- lines
- 183
- safe to delete
- Yes(inferred)
Small effort
Improve what Repowise can see
Add a test coverage report
Without one, Repowise cannot tell tested code from untested code, so every test-related action says “unknown”.
- line coverage
- Unknown, no report
Small effortReview the 138 proposed decisions
None is accepted yet, so nothing can drift from one and agents get no enforced guidance from them.
- proposed
- 138
- accepted
- 0
Medium effort
- Lines of code
- 17.9K
Recent activity
All commitsCommits
- 00e56455feat(cli): restructure run folder and improve terminal UX (#384)3mo ago
- 5a2f78c5fix: render agent deliverables before the success commit so resume preserves them (#376)3mo ago
- 7abcc1d3docs: rename shn command references to npx @keygraph/shannon (#375)3mo ago
- 4be4853ffeat(preflight): support multi-repo targets by removing .git check (#371)3mo ago
- 63ca5604docs: extend Keygraph company/platform disambiguation to docs and llms mirrors3mo ago
- 8fb62a59docs: distinguish Keygraph the company from the Keygraph platform in README3mo ago
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
Everything we found
513 open
Every detector's open count by area, each with its worst example. An inventory, not a to-do list: the actions above are the part worth doing.
- worst item is critical severity. Code health258Untested hotspot · apps/worker/src/temporal/activities.ts30 findings · 9.6 deducted
- worst item is medium severity. Refactoring28classifyErrorForTemporal+1.3 health, S effort · apps/worker/src/services/error-handling.ts
- worst item is medium severity. Decisions150apps/worker/src/temporal/activities.ts138 awaiting review · 12 hotspots ungoverned
- worst item is medium severity. Ownership64apps/worker/src/services/preflight.ts81% single-owner concentration, 7 commits in 90d
- worst item is low severity. Dead code13validateQueueContentUnreachable function (46 lines)
Composition
Open the graphExplore this codebase
- Docs0 pages across 2 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, 258 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.