|
9 | 9 | ### Upgrade Notes |
10 | 10 | - No new dependencies; update via standard `uv sync` after pulling. |
11 | 11 | - Run `uv run pytest` to confirm the new search filter tests on your environment. |
12 | | - |
13 | | -## Shallow Index Default & Streamlined Server |
14 | | - |
15 | | -This release focuses on faster first-run experiences and a slimmer MCP surface area. |
16 | | - |
17 | | -### Highlights |
18 | | - |
19 | | -- **Shallow index by default**: Projects initialize with the new JSON-based shallow index for rapid file discovery. |
20 | | -- **Deep index on demand**: Added the `build_deep_index` tool so symbol extraction happens only when you request it. |
21 | | -- **Watcher-friendly rebuilds**: File watcher callbacks now refresh the shallow index, keeping file lists current without long rebuilds. |
22 | | -- **Server cleanup**: Removed unused `structure://project` resource, legacy prompts, and auxiliary documents for a leaner runtime. |
23 | | - |
24 | | -### Developer Experience Improvements |
25 | | - |
26 | | -- `find_files` now enforces true glob semantics (single `*` for one segment, `**` for recursive matches). |
27 | | -- `get_file_summary` responds with a `needs_deep_index` hint when deep symbols are unavailable. |
28 | | -- Index management services split shallow vs deep rebuild paths to clarify tool behavior. |
29 | | -- Repository docs (README, localized copies) highlight when to run `build_deep_index`. |
30 | | - |
31 | | -### Cleanups |
32 | | - |
33 | | -- Removed deprecated architecture and benchmarking documents. |
34 | | -- Trimmed benchmark scripts and outdated tests tied to the old SCIP experiment. |
35 | | - |
36 | | -### Upgrade Notes |
37 | | - |
38 | | -1. After updating, call `set_project_path` as usual - the server will build the shallow index automatically. |
39 | | -2. Run `build_deep_index` whenever you need symbol-level summaries (`get_file_summary`) or deep search capabilities. |
40 | | -3. Optionally run `refresh_index` to refresh the shallow index if the watcher is disabled. |
41 | | - |
42 | | -### Compatibility |
43 | | - |
44 | | -- Tool names and signatures are unchanged. |
45 | | -- Deep-index workflows remain available; they now require an explicit `build_deep_index` call. |
46 | | -- Python 3.10+ requirement unchanged; no new third-party dependencies. |
47 | | - |
48 | | -Enjoy faster cold starts and a simpler interface tailored for LLM-driven workflows. |
0 commit comments