Code health of shepherd-agents/shepherd
Repowise scores shepherd-agents/shepherd at 7.7 out of 10 for code health, which reads as good, alongside maintainability 7.8 and static performance 9.9 on the same scale. There are 3,420 open findings across the three pillars, and the lowest-scoring file is _vcscore_runtime.py at 1.0. Scores are computed from complexity, duplication, churn and git fix history, not from a linter.
Findings by severity
164 critical, 616 high, 1,083 medium, 1,345 low.
Hotspots
114 files are flagged as hotspots. The top 5:
- shepherd/packages/dialect/src/shepherd_dialect/workspace_control/workspace.py: 12 commits in the last 90 days from 3 contributors with 2 recent bug fixes
- shepherd/packages/dialect/src/shepherd_dialect/providers.py: 13 commits in the last 90 days from 2 contributors with 6 recent bug fixes
- vcs-core/packages/core/src/vcs_core/_world_storage_manager.py: 3 commits in the last 90 days from 2 contributors
- shepherd/packages/dialect/tests/test_providers.py: 10 commits in the last 90 days from 2 contributors with 6 recent bug fixes
- vcs-core/packages/core/tests/integration/session/test_seal_lifecycle.py: 5 commits in the last 90 days from 3 contributors
Lowest-scoring files
- vcs-core/packages/core/src/vcs_core/_vcscore_runtime.py: 1.0 out of 10
- vcs-core/packages/core/src/vcs_core/vcscore.py: 1.6 out of 10 with 1 bug fix in the last 180 days
- shepherd/packages/dialect/src/shepherd_dialect/providers.py: 1.6 out of 10 with 6 bug fixes in the last 180 days
- vcs-core/packages/core/src/vcs_core/_app.py: 1.7 out of 10
- vcs-core/packages/core/src/vcs_core/_vcscore_lifecycle.py: 1.8 out of 10
Checked against bug fixes
Of the 20 files Repowise scores lowest, 4 had a bug fix in the last 180 days. Across all 1,841 scored files, 1.8% had a bug fix in that window.
Dead code and refactoring
Repowise found 173 unused exports. 229 refactoring targets across 229 files would raise the score.
More on shepherd: summary and FAQ, codebase overview, architecture.
Related guide: Best dead code detection tools by language