cusp-ai-oss / kups
pythonmain9eb61ea66.7K linessynced 4h ago
Code health
8.1out of 10Excellent
This codebase scores 8.1 out of 10 on defect risk, which we rate excellent. It also scores maintainability 8.6 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: 53 of 363 files are git hotspots, and they average 6.2.
- Lines of code
- 66.7K
Recent activity
All commitsCommits
No commits indexed yet.
Decisions
- perf: Faster logging (JIT-compile leaf stacking, zstd, default chunk size to 4 MiB) (#213)proposed · 4h ago
- perf: Replace symmetric image stencil with anchored per-pair window for periodic image replication (#212)proposed · 4h ago
- refactor: Decompose neighbor list into Pipeline of selector → masks → compactor (#138)proposed · 4h ago
- refactor: Replace rh/rh_index_remap call contract with rh/for_indices keyword-only API and extract mirroring into MirrorPairEdges postprocessor (#150)proposed · 4h ago
- fix: preserve inner lens setter in Lens.nest (#179)proposed · 4h ago
- Enforce sorted primary keys in Tableproposed · 4h ago
Needs attention
71 open- medium severity. Proposedperf: Faster logging (JIT-compile leaf stacking, zstd, default chunk size to 4 MiB) (#213)Auto-proposed decision awaiting review
- medium severity. Proposedperf: Replace symmetric image stencil with anchored per-pair window for periodic image replication (#212)Auto-proposed decision awaiting review
- medium severity. Proposedrefactor: Decompose neighbor list into Pipeline of selector → masks → compactor (#138)Auto-proposed decision awaiting review
- medium severity. Proposedrefactor: Replace `rh`/`rh_index_remap` call contract with `rh`/`for_indices` keyword-only API and extract mirroring into `MirrorPairEdges` postprocessor (#150)Auto-proposed decision awaiting review
- medium severity. Proposedfix: preserve inner lens setter in Lens.nest (#179)Auto-proposed decision awaiting review
Where the risk concentrates
All 53 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 |
|---|---|---|---|---|
| cell.pysrc/kups/core | 99.7th | 2 | 2bus factor 1 | 11 |
| test_cell.pytest/core | 99.3th | 2 | 2bus factor 1 | 7 |
| integrators.pysrc/kups/md | 99.0th | 0 | 2bus factor 1 | 7 |
| common.pysrc/kups/core/neighborlist | 98.6th | 1 | 1bus factor 1 | 7 |
| ewald.pysrc/kups/potential/classical | 98.3th | 1 | 2bus factor 1 | 9 |
Composition
Open the graphpython 79%yaml 16%markdown 4%javascript 1%toml 0%Other 1%
Explore this codebase
- Docs631 pages across 6 modules
- ChatAsk this codebase a question and get an answer with its sources
- Files363 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 7 entry points
- Code healthPer-file scores, 728 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