shepherd-agents / shepherd
pythonmain8e703a6378.9K linessynced 1mo ago
Code health
7.9out of 10Good
This codebase scores 7.9 out of 10 on defect risk, which we rate good. It also scores maintainability 8.0 and static performance risk 10.0 out of 10. The three are scored separately and never blended into one number. The files you change most are the weak spot: 114 of 1,841 files are git hotspots, and they average 6.4.
- Lines of code
- 378.9K
Recent activity
All commitsCommits
No commits indexed yet.
Decisions
- capabilities only accepts CommandRequest; coordinator rejects non-accepted variants. Defensive fallbproposed
- Use tr for uppercase rather than ${VAR^^} (bash 4+) so the script runs on macOS's default bash 3.2.proposed
- T3-callers: the typed ReduceRequest path passes the caller's payload through unmodified. Pre-T3 the proposed
- T1a: workspace driver only declares CommandRequest acceptance in its CapabilitySet; T1c expands acproposed
- Trust-by-default (Part A): the detector still checks the target ref (DEFAULT_GROUND_REF) even when aproposed
- Trust-by-default (Part A): the detector still flags the broken prior-lineage pin, but it is off the proposed
Needs attention
549 open- medium severity. Proposedcapabilities only accepts CommandRequest; coordinator rejects non-accepted variants. Defensive fallbAuto-proposed decision awaiting review
- medium severity. ProposedUse tr for uppercase rather than ${VAR^^} (bash 4+) so the script runs on macOS's default bash 3.2.Auto-proposed decision awaiting review
- medium severity. ProposedT3-callers: the typed ReduceRequest path passes the caller's payload through unmodified. Pre-T3 the Auto-proposed decision awaiting review
- medium severity. ProposedT1a: workspace driver only declares CommandRequest acceptance in its CapabilitySet; T1c expands ``acAuto-proposed decision awaiting review
- medium severity. ProposedTrust-by-default (Part A): the detector still checks the target ref (DEFAULT_GROUND_REF) even when aAuto-proposed decision awaiting review
Where the risk concentrates
All 114 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 |
|---|---|---|---|---|
| workspace.pyshepherd/packages/dialect/src/shepherd_dialect/workspace_control | 99.9th | 2 | 3bus factor 1 | 12 |
| providers.pyshepherd/packages/dialect/src/shepherd_dialect | 99.9th | 6 | 2bus factor 1 | 13 |
| _world_storage_manager.pyvcs-core/packages/core/src/vcs_core | 99.8th | 0 | 2 | 3 |
| test_providers.pyshepherd/packages/dialect/tests | 99.8th | 6 | 2bus factor 1 | 10 |
| test_seal_lifecycle.pyvcs-core/packages/core/tests/integration/session | 99.7th | 0 | 3 | 5 |
Composition
Open the graphpython 87%markdown 8%json 1%yaml 1%toml 1%Other 1%
Explore this codebase
- Docs0 pages across 130 modules
- ChatAsk this codebase a question and get an answer with its sources
- Files1,841 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 17 entry points
- Code healthPer-file scores, 5,249 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