Skip to content

Shallow Index Default & Streamlined Server

Choose a tag to compare

@johnhuang316 johnhuang316 released this 02 Oct 02:51
· 43 commits to master since this release

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_index tool 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://project resource, legacy prompts, and auxiliary documents for a leaner runtime.

Developer Experience Improvements

  • find_files now enforces true glob semantics (single * for one segment, ** for recursive matches).
  • get_file_summary responds with a needs_deep_index hint 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

  1. After updating, call set_project_path as usual - the server will build the shallow index automatically.
  2. Run build_deep_index whenever you need symbol-level summaries (get_file_summary) or deep search capabilities.
  3. Optionally run refresh_index to 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_index call.
  • Python 3.10+ requirement unchanged; no new third-party dependencies.

Enjoy faster cold starts and a simpler interface tailored for LLM-driven workflows.