paperclipai / paperclip
Code health
This codebase scores 6.8 out of 10 for code health, which we rate fair. It also scores maintainability 8.1 and static performance 9.6 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 548 of 5,936 files are git hotspots, and they average 4.5 — which is where the fixes pay off most.
Do next
1 thing worth doing this quarter.
Worth planning
Delete 13 unused symbols and files (97 lines)
Nothing in the graph reaches them, across 8 files; every reader and agent pays to skip them.
- symbols
- 13
- lines
- 97
- 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 38 proposed decisions
None is accepted yet, so nothing can drift from one and agents get no enforced guidance from them.
- proposed
- 38
- accepted
- 0
Medium effort
- Lines of code
- 2.3M
Recent activity
All commitsCommits
- af8439a7feat(runner): restore direct live eval campaigns and reports (#12909)4w ago
- 3796c6f2fix(connections): project GitHub identity into sandbox runners (#12907)4w ago
- 1dceee9afix(runner): persist warm Daytona workspaces (#12901)4w ago
- be407f34fix(onboarding): hide the probe's diagnostics while the hire is in flight (#12902)4w ago
- 60469a08feat(agent-login): resume an active login session and permit concurrent login terminals (#12861)4w ago
- 3ed5b7c5refactor(server): extract the active-run output watchdog into a feature module (#12853)4w ago
Decisions
- Remove retired duplex_v1 sandbox bridge transportproposed · 4w ago
- fix(adapter-utils): harden the wrapper birth-time probe with exclusive create and identity-aware cleanupproposed · 4w ago
- refactor(adapter-utils): rename EffectiveSandboxCapabilities to EffectiveExecutionCapabilitiesproposed · 4w ago
- refactor(adapter-utils): delete the dead duplex body-chunk protocol codeproposed · 4w ago
- fix(runner): persist warm Daytona workspacesproposed · 4w ago
- fix: exclude thought text from automatic issue commentsproposed · 4w ago
Everything we found
15,528 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 health9,007Untested hotspot · packages/paperclip-runner/src/drivers/codex/codex-harness-session.ts18 findings · 9.5 deducted
- worst item is medium severity. Refactoring1,381externalObjectService+1.5 health, S effort · server/src/services/external-objects.ts
- worst item is medium severity. Decisions586server/src/services/heartbeat.ts38 awaiting review · 548 hotspots ungoverned
- worst item is medium severity. Ownership4,541packages/shared/src/index.ts92% single-owner concentration, 30 commits in 90d
- worst item is low severity. Dead code13paperclipProtocolActionUnreachable function (2 lines)
Composition
Open the graphExplore this codebase
- Docs5,823 pages across 13 modules
- ChatAsk this codebase a question and get an answer with its sources.
- Files5,936 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 700 entry points
- Code healthPer-file scores, 11,121 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.