pvliesdonk / markdown-vault-mcp
Code health
This codebase scores 6.2 out of 10 for code health, which we rate fair. It also scores maintainability 7.7 and static performance 9.4 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 68 of 467 files are git hotspots, and they average 4.8 — which is where the fixes pay off most.
Do next
8 things worth doing this quarter.
Worth planning
Fix 4 broken references in
docs/design/release-migration.mdThe document points readers and agents at paths this repository no longer has.
- broken references
- 4
- first
- scripts/bump_manifests.py
Small effortFix 2 broken references in
docs/design/design.mdThe document points readers and agents at paths this repository no longer has.
- broken references
- 2
- first
- docs/superpowers/plans/2026-04-20-fastmcp-pvl-core-extraction.md
Small effortFix 2 broken references in
docs/design/release-vision.mdThe document points readers and agents at paths this repository no longer has.
- broken references
- 2
- first
- scripts/bump_manifests.py
Small effortFix 1 broken reference in
docs/releases/3.1.mdThe document points readers and agents at a path this repository no longer has.
- broken references
- 1
- first
- tests/test_config_wizard_drift.py
Small effortFix 1 broken reference in
.agents/skills/writing-release-notes/SKILL.mdThe document points readers and agents at a path this repository no longer has.
- broken references
- 1
- first
- docs/releases/next.md
Small effort
- Lines of code
- 108.6K
Recent activity
All commitsCommits
- b40ad268chore(deps): update dependency openai to v3.19.0 (#1555)3w ago
- 96be2984chore(deps): update dependency fastembed to v0.8.1 (#1554)3w ago
- 7f0f1910chore(deps): update dependency openai to v3.18.0 (#1553)3w ago
- 0bf495e0chore(copier)!: update to v9.0.0 (#1550)3w ago
- e8c63c85chore(deps): update all non-major dependencies (#1547)3w ago
- cbb41215feat(index): add a switch to skip the boot reindex (#1543)3w ago
Decisions
- Adopt template v8 and FastMCP 4 with breaking compose/deployment layout changesproposed · 3w ago
- Migrate release process: knope release-PR flow (Phase 3) and remove PSR from repositoryproposed · 3w ago
- Fix packaging scripts: handle Debian/RPM upgrade arg differences, pin VERSION in postinstall, add SHA256 integrity checkproposed · 3w ago
- Add packaging scaffold for native .deb/.rpm with systemd unit and lifecycle scriptsproposed · 3w ago
- Retain partial summaries; never include full note bodies in summariesproposed · 3w ago
- Use map-phase subagents for parallel fan-out; constrain plan/reduce to main conversationproposed · 3w ago
Everything we found
1,278 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 health762Untested hotspot · scripts/gen_config_surface.py36 findings · 8.6 deducted
- worst item is medium severity. Refactoring107register_apps+1.5 health, S effort · src/markdown_vault_mcp/_server_apps.py
- worst item is medium severity. Doc drift23docs/design/design.mdDocument names docs/superpowers/specs/2026-04-20-fastmcp-core-and-copier-template-design.md, which no longer exists.
- worst item is medium severity. Decisions109tests/test_git.py41 awaiting review · 68 hotspots ungoverned
- worst item is medium severity. Ownership276tests/test_server.py98% single-owner concentration, 38 commits in 90d
- worst item is low severity. Dead code1docs/javascripts/config-wizard/wizard.jsUnreachable symbol (100 lines)
Composition
Open the graph- python93%
- shell4%
- javascript2%
- dockerfile<1%
Explore this codebase
- Docs798 pages across 8 modules
- ChatAsk this codebase a question and get an answer with its sources.
- Files467 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 4 entry points
- Code healthPer-file scores, 1,018 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.