vectifyai / pageindex
Code health
This codebase scores 5.1 out of 10 for code health, which we rate needs work. It also scores maintainability 5.6 and static performance 9.7 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 19 of 140 files are git hotspots, and they average 3.7 — which is where the fixes pay off most.
Do next
1 thing worth doing in the week to Sep 29, the last indexed commit, 1 of them now.
Now
- Critical
Clean up what this week's commits left: 5 serious findings in 4 files
1 commit in the last 7 days added or worsened them, and they are still open. Start with
pageindex/flash/api.py, which has 1 critical.- serious findings
- 5
- critical
- 2
- files
- 4
Medium effort
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
- Lines of code
- 33.7K
Recent activity
All commitsCommits
- d2693d80ci(publish): gate releases on the live cloud tests again (#538)1d ago
- 619cbd89ci(publish): run the release gate without the live cloud tests (#537)3d ago
- 037a7dbaperf: summaries run deepest-first and start while expand is still deciding (#432)1w ago
- 8eff7733Anthropic lanes: send the model as written; the prefix picks the route (#443)1w ago
- 9c4c3ff2test(sdk): cover list_documents regression boundaries1w ago
- ed06ec69fix(sdk): list_documents review followups1w ago
Decisions
- Make Flash (full optimization) the default local indexing mode and tighten mode/optimize handlingproposed · 1d ago
- Introduce local mode for PageIndex SDK with Flash tree build and OpenAI-style chatproposed · 1d ago
- Route chat() through chat_completions, add Claude managed-prefix cache marking on LiteLLM routes, and document local tool/history contractproposed · 1d ago
- Ensure Responses reasoning_effort merges via caller extra_body and unset empty reasoning/model on both lanesproposed · 1d ago
- Flash PDF outline improvements with TOC fallback and toc_source labelingproposed · 1d ago
- Route chat lane through LiteLLM and fix OpenAI model failuresproposed · 1d ago
Everything we found
1,008 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 health734Nested complexity · pageindex/local_chat.py54 findings · 8.0 deducted
- worst item is medium severity. Refactoring131detect_title+1.5 health, S effort · pageindex/flash/title/detect.py
- worst item is medium severity. Decisions38pageindex/client.py19 awaiting review · 19 hotspots ungoverned
- worst item is medium severity. Ownership105pageindex/client.py96% single-owner concentration, 44 commits in 90d
Composition
Open the graphExplore this codebase
- Docs246 pages across 4 modules
- ChatAsk this codebase a question and get an answer with its sources.
- Files140 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 2 entry points
- Code healthPer-file scores, 771 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.