Shallow Index Default & Streamlined Server
Highlights
- Shallow index by default: Projects initialize with the new JSON-based shallow index for rapid file discovery.
- Deep index on demand: Added the
build_deep_indextool so symbol extraction happens only when you request it. - Watcher-friendly rebuilds: File watcher callbacks now refresh the shallow index, keeping file lists current without long rebuilds.
- Server cleanup: Removed unused
structure://projectresource, legacy prompts, and auxiliary documents for a leaner runtime.
Developer Experience Improvements
find_filesnow enforces true glob semantics (single*for one segment,**for recursive matches).get_file_summaryresponds with aneeds_deep_indexhint when deep symbols are unavailable.- Index management services split shallow vs deep rebuild paths to clarify tool behavior.
- Repository docs (README, localized copies) highlight when to run
build_deep_index.
Cleanups
- Removed deprecated architecture and benchmarking documents.
- Trimmed benchmark scripts and outdated tests tied to the old SCIP experiment.
Upgrade Notes
- After updating, call
set_project_pathas usual - the server will build the shallow index automatically. - Run
build_deep_indexwhenever you need symbol-level summaries (get_file_summary) or deep search capabilities. - Optionally run
refresh_indexto refresh the shallow index if the watcher is disabled.
Compatibility
- Tool names and signatures are unchanged.
- Deep-index workflows remain available; they now require an explicit
build_deep_indexcall. - Python 3.10+ requirement unchanged; no new third-party dependencies.
Enjoy faster cold starts and a simpler interface tailored for LLM-driven workflows.