alexlib / openptv2
pythonmainb229d23121.7K linessynced 2h ago
Since the previous index, 1w ago+48 files+0.5 code health+0.2 hotspot health
Code health
5.8out of 10Fair
This codebase scores 5.8 out of 10 for code health, which we rate fair. It also scores maintainability 6.2 and static performance 9.5 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 129 of 686 files are git hotspots, and they average 4.1 — which is where the fixes pay off most.
Needs attention
4,280 openEvery detector, by area of work, each leading with the worst thing in it: code health and the test-quality biomarkers, security, refactoring, documentation drift, decision records, ownership, and dead code.
- worst item is high severity. Security12.agents/cython-optimize/scripts/benchmark.py12 in the working tree, 0 in git history
- worst item is critical severity. Code health2,946Untested hotspot · notebooks/marimo_ui_calibration.py22 findings · 9.8 deducted
- worst item is medium severity. Refactoring601main+1.5 health, M effort · docs/tutorials/generate_tutorial_snapshots.py
- worst item is medium severity. Doc drift22docs/plans/2026-09-01-tracker-stress-benchmark-plan.mdDocument names docs/reports/tracker-stress-YYYY-MM-DD.md, which no longer exists.
- worst item is medium severity. Decisions155src/openptv2/autocalibration.py26 awaiting review · 129 hotspots ungoverned
- worst item is medium severity. Ownership544src/openptv2/gui/ptv.py100% single-owner concentration, 42 commits in 90d
- Lines of code
- 121.7K
Recent activity
All commitsCommits
- b229d233chore(release): bump version to 0.5.105h ago
- d1649477chore(typing): resolve mypy typing issues and format with ruff15h ago
- e6e5f557fix: make headless mypy pass2d ago
- f1124343fix(gui,docker): improve xpra container setup and experiment auto-detection2d ago
- 4b6e0f13first commit of almost working xpra version3d ago
- 58c07928docs(plans): add plan for cloud run of wp1 with bidirectional two-phase tracker3d ago
Decisions
- Restore quality-ratio and sensor-bounds semantics after correspondence optimizationproposed · 2h ago
- Cancel remaining futures and wait on exception in match_pairsproposed · 2h ago
- Deterministically sort glob candidates when resolving frame image filenamesproposed · 2h ago
- Remove redundant Cython type redeclarations to satisfy Cython 3.1 scope checksproposed · 2h ago
- Remove uv source override pointing to non-existent dev pathproposed · 2h ago
- Cython Optimization Plan — Full Compilation Pipelineproposed · 2h ago
Where the risk concentrates
All 129 hotspotsRanked by prior bug fixes and change frequency, mined from full git history rather than from the code alone.
| File | Prior fixes | Last fix | Maintainers | Commits 90d |
|---|---|---|---|---|
| autocalibration.pysrc/openptv2 | 5bug magnet | 2d ago | 1bus factor 1 | 25 |
| two_phase_tracking.pysrc/openptv2/plugins | 7bug magnet | 2d ago | 1bus factor 1 | 18 |
| ptv.pysrc/openptv2/gui | 17bug magnet | 2w ago | 1bus factor 1 | 42 |
| tracking_frame_buf.pysrc/openptv2/algorithms | 8bug magnet | 4w ago | 1bus factor 1 | 28 |
| track_kernels_track3d.pysrc/openptv2/algorithms | 5bug magnet | 3d ago | 1bus factor 1 | 21 |
Composition
Open the graphpython 79%markdown 15%
yaml 5%shell 1%json 0%Other 0%
Explore this codebase
- Docs850 pages across 9 modules
- ChatAsk this codebase a question and get an answer with its sources.
- Files686 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 8 entry points
- Code healthPer-file scores, 3,833 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.