shepherd-agents / shepherd
Code health
Hotspots average 6.4, the place fixes pay off most.
Explore this codebase
- Code health map114hotspots across 1,841 files
- Ownership1,005sole-owned files: one author, no second reader
- Architecture12modules, 17 entry points
- Decisions520recorded, of which 0 in force and 520 background
- Refactoring229open opportunities, one per file
- TestsNo coverage report yet. Run your tests with coverage on, then add the report:
AlsoDocsChatFilesKnowledge graphChange couplingCommitsStatsCosts
Do next · 3
3 things worth doing in the week to Jul 8, the last indexed commit.
Worth planning
Start breaking up execute_sdk (CCN 65, 318 lines): first lift lines 1061-1099
shepherd/packages/providers/src/shepherd_providers/openai/provider.py:1061
execute_sdk nests deeply; easier to read and change once split, which also removes a duplicate; its file is imported by 9 files, changed 1 time in 90 days.
- gain
- up to under +0.1 health on this file(inferred)
- finding
- Nested complexity
- size
- CCN 65, 318 lines, nests 7 deep
- severity
- high
Medium effort, worth a checkStart breaking up _validate_publication_experimental_trace (CCN 43, 579 lines)
shepherd/packages/kernel-v3-reference/src/shepherd_kernel_v3_reference/trace/validate.py:2354
_validate_publication_experimental_trace nests deeply; easier to read and change once split; its file is imported by 25 files, changed 2 times in 90 days.
- gain
- up to +0.6 health on this file(inferred)
- finding
- Nested complexity
- size
- CCN 43, 579 lines, nests 6 deep
- severity
- high
Medium effort, worth a checkStart breaking up _process_message_stream (CCN 40, 212 lines): first lift lines 925-955
shepherd/packages/providers/src/shepherd_providers/claude/provider.py:925
_process_message_stream nests deeply; easier to read and change once split, which also removes a duplicate; its file is imported by 6 files, changed 1 time in 90 days.
- gain
- up to +1.0 health on this file(inferred)
- finding
- Nested complexity
- size
- CCN 40, 212 lines, nests 8 deep
- severity
- high
Medium effort, worth a check
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 effort
Everything we found
5 areas
Every detector's open count by area. The actions above are the part worth doing.
- Code health3,420 open findingsCriticalUntested hotspot · vcs-core/packages/core/src/vcs_core/_vcscore_runtime.py46 findings · 9.6 deducted
- Refactoring229 open opportunitiesMediummain+1.5 health, S effort · docs/_system/scripts/check_names.py
- Decisions0 drifting from the codeMediumshepherd/packages/dialect/src/shepherd_dialect/workspace_control/workspace.pyHigh-churn file with no governing decision
- Ownership1,005 sole-owned filesMediumshepherd/packages/dialect/src/shepherd_dialect/workspace_control/workspace.pyOne author, no second reader
- Dead code173Lowprovider_events_from_observationsUnreachable function (25 lines)