Skip to content

Commit d94049d

Browse files
jgravelleclaude
andauthored
release: v1.108.331 - a full re-index keeps the embedding metadata beside its vectors (#983)
Co-authored-by: Claude Opus 5.5 <[email protected]>
1 parent 6e8f9d0 commit d94049d

9 files changed

Lines changed: 33 additions & 17 deletions

File tree

‎.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
33
"name": "jcodemunch",
44
"displayName": "jCodeMunch",
5-
"version": "1.108.330",
5+
"version": "1.108.331",
66
"description": "Token-efficient MCP server for source code exploration via tree-sitter AST parsing",
77
"author": {
88
"name": "J. Gravelle",

‎CHANGELOG.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
## [Unreleased]
44

5+
## [1.108.331] - 2026-10-06 - a full re-index keeps the embedding metadata beside its vectors
6+
57
### Fixed
68

79
- **A large Vue or Svelte `<script>` is indexed in time proportional to its size (LEDGER L-115).**

‎CLAUDE.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
# jcodemunch-mcp — Project Brief
22

33
## Current State
4-
- **Version:** 1.108.330 — **The parse budget bounds a file's Python-side time** (L-116). No second thread waits on a parse: `parse_budget.checkpoint()` raises inside `parse_file` once the file's deadline (the parsing thread's own time) has passed, on every route, at any size. ⚠ One slow call (a whole-file regex, PyYAML) is not cut short (L-118), and loops are still slow BELOW the budget (L-115, L-117). Also a bare Python module name resolves to the script directory beside the importer (#972, @whakomatic; refusals and residue: L-120). Rules: the Env Vars row. Forensics: `docs/workflows/LEDGER.md`.
4+
- **Version:** 1.108.331 — **A full re-index keeps the embedding metadata beside its vectors** (#522, @lsg1103275794). `save_index` deletes the index's own `meta` keys and leaves those starting with `embedding_store.META_KEY_PREFIX`. ⚠ `embed_repo` after a full re-index no longer re-embeds everything; `force=true` does. ⚠ The semantic top-up in `search_symbols` still checks no stored model (L-121), and stale or orphan vectors survive (L-122). Also `embed_repo`'s task-type gate has THREE states (#523): `None` is never recorded and is not a change, `""` is a recorded value, and vectors with no embedding metadata at all are still rebuilt (jjg, 2026-10-06), named by `rebuild_reason`. Also a Vue or Svelte `<script>`'s comment lookup is one table per parent node, linear where it was quadratic (L-115). Forensics: `CHANGELOG.md`, `docs/workflows/LEDGER.md`.
5+
- **Prior (1.108.330):** **The parse budget bounds a file's Python-side time** (L-116): `parse_budget.checkpoint()` raises inside `parse_file` once the file's deadline has passed, and every loop on the parse path starts with one (rules: the Env Vars row; residue L-117, L-118). Also a bare Python module name resolves to the script directory beside the importer (#972, @whakomatic; L-120). Full text: `CHANGELOG.md`; verbatim in `ISSUE-HISTORY.md` (2026-10-06, release 1.108.331).
56
- **Prior (1.108.329):** **The parse budget stops a slow tree-sitter parse** (L-114): the deadline lives inside `parse_file` (`parser/parse_budget.py`), bound to every parser by `grammar_pack.get_parser` and ended by tree-sitter's own timeout (rules: the Env Vars row). Full text: `CHANGELOG.md`; verbatim in `ISSUE-HISTORY.md` (2026-10-06, release 1.108.330).
6-
- **Prior (1.108.328):** **A file a `package.json` script runs is an entry point** (L-102): `tools/_entry_points.package_json_entries` reads `scripts` as an ALLOWLIST and anything else roots NOTHING (rules: Key Files `_entry_points.py`; residue L-111). Also a repeat `index <subdir>` inside a git root is incremental (#961, @ebataeva). Full text: `CHANGELOG.md`; verbatim in `ISSUE-HISTORY.md` (2026-10-05, release 1.108.329).
7-
- **Older releases (1.108.327 and earlier):** see `CHANGELOG.md` (1.108.303-.310, 1.108.314-.315, 1.108.316 through 1.108.327 in `ISSUE-HISTORY.md`). The 1.108.182 entry ("a stall has a name and a ceiling", #375) and the 1.108.177-.181 #377 hardening arc are there in full.
8-
- **Tests:** 14783 passed, 25 skipped, **0 failed** (14808 total, +57 over the .329 line's 14751) (1.108.330, the full tier, `python .claude/hooks/run_full.py --workers 4`, on the settled tree after the bump and the rotation) **+ `uv run ruff check src/` clean**. ⚠ Prior (1.108.329): 14726 passed, 25 skipped, **0 failed** (14751 total). ⚠ Prior (1.108.328): 14684 passed, 25 skipped, **0 failed** (14709 total). ⚠ `ruff check tests/` reports 292 PRE-EXISTING errors and is NOT this project's gate; `src/` is. ⚠⚠ **THE ROTATION IS TWO EDITS, NOT ONE** — moving a release out of Current State also moves the "Older releases (X and earlier)" boundary, and `test_claude_md_rotation.py` fails naming both numbers; it caught .311's settled run at `1 failed`. ⚠⚠ **READ THE SKIP COUNT, NOT JUST THE EXIT CODE AND THE TOTAL** — a .305 reproduce came back exit 0 with the total reconciling exactly while 105 tests silently did not execute. Forensics and the correct command: **Reproducing CI's environment**. ⚠⚠ **Compare TOTALS, never passed counts, and NEVER a skip count ACROSS machines** — CI ubuntu skips 26 and windows 19 where this box skips 13, all pre-existing; **the before/after delta on the SAME job is the only signal**. ⚠⚠ **A BACKGROUND-TASK BANNER SAYING "exit code 0" IS NOT A GREEN SUITE** — one run reported exit 0 having never started pytest (`--timeout` plugin absent), and .306 had a banner say exit 0 over a log whose own `EXIT=` line said 1. **Redirect the exit code INTO the log (`{ pytest; echo "EXIT=$?"; } > log`) and grep that line**; a bare `&` does not survive the shell either. ⚠⚠ **A CONTRIBUTOR PR IS TRIAL-MERGED ONTO `main` AND RUN LOCALLY BEFORE THE MERGE** — branch-green is not merged-green and the merge base moves every release. ⚠⚠ **A reproduce that ERRORS in `tests/test_sdist_exclusions.py` is NOT environmental noise** — that file is the sdist CREDENTIAL-LEAK guard (v0.2.6), and it errors at setup when the scratch venv must fetch the build backend with DNS blocked. Re-run it explicitly; never wave it through. ⚠ Two full runs contend on the same `~/.code-index` process-lock scopes, the documented cause of .261's 47m outlier, so the 3.13 reproduce runs AFTER the local suite, never beside it.
7+
- **Older releases (1.108.328 and earlier):** see `CHANGELOG.md` (1.108.303-.310, 1.108.314-.315, 1.108.316 through 1.108.328 in `ISSUE-HISTORY.md`). The 1.108.182 entry ("a stall has a name and a ceiling", #375) and the 1.108.177-.181 #377 hardening arc are there in full.
8+
- **Tests:** 14800 passed, 25 skipped, **0 failed** (14825 total, +17 over the .330 line's 14808) (1.108.331, the full tier, `python .claude/hooks/run_full.py --workers 4`, on the settled tree after the bump and the rotation) **+ `uv run ruff check src/` clean**. ⚠ Prior (1.108.330): 14783 passed, 25 skipped, **0 failed** (14808 total). ⚠ Prior (1.108.329): 14726 passed, 25 skipped, **0 failed** (14751 total). ⚠ `ruff check tests/` reports 292 PRE-EXISTING errors and is NOT this project's gate; `src/` is. ⚠⚠ **THE ROTATION IS TWO EDITS, NOT ONE** — moving a release out of Current State also moves the "Older releases (X and earlier)" boundary, and `test_claude_md_rotation.py` fails naming both numbers; it caught .311's settled run at `1 failed`. ⚠⚠ **READ THE SKIP COUNT, NOT JUST THE EXIT CODE AND THE TOTAL** — a .305 reproduce came back exit 0 with the total reconciling exactly while 105 tests silently did not execute. Forensics and the correct command: **Reproducing CI's environment**. ⚠⚠ **Compare TOTALS, never passed counts, and NEVER a skip count ACROSS machines** — CI ubuntu skips 26 and windows 19 where this box skips 13, all pre-existing; **the before/after delta on the SAME job is the only signal**. ⚠⚠ **A BACKGROUND-TASK BANNER SAYING "exit code 0" IS NOT A GREEN SUITE** — one run reported exit 0 having never started pytest (`--timeout` plugin absent), and .306 had a banner say exit 0 over a log whose own `EXIT=` line said 1. **Redirect the exit code INTO the log (`{ pytest; echo "EXIT=$?"; } > log`) and grep that line**; a bare `&` does not survive the shell either. ⚠⚠ **A CONTRIBUTOR PR IS TRIAL-MERGED ONTO `main` AND RUN LOCALLY BEFORE THE MERGE** — branch-green is not merged-green and the merge base moves every release. ⚠⚠ **A reproduce that ERRORS in `tests/test_sdist_exclusions.py` is NOT environmental noise** — that file is the sdist CREDENTIAL-LEAK guard (v0.2.6), and it errors at setup when the scratch venv must fetch the build backend with DNS blocked. Re-run it explicitly; never wave it through. ⚠ Two full runs contend on the same `~/.code-index` process-lock scopes, the documented cause of .261's 47m outlier, so the 3.13 reproduce runs AFTER the local suite, never beside it.
99
- **Python:** >=3.10
1010
- **Tool count:** 91 visible in `full` / 94 in catalog (front door hidden; counts verified 2026-07-30 from `jcodemunch-mcp surface`, which is the only place to get them — do NOT hand-type this; +1 v1.108.111 `get_parity_map`, +1 v1.108.112 `get_decorator_census`, +1 v1.108.113 `get_architecture_metrics`); `tool_surface=counter` exposes a 3-tool front door (`order`/`menu`/`route`) instead
1111

‎ISSUE-HISTORY.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2200,3 +2200,17 @@ The 1.108.329 entry, verbatim, dropped when it was compressed to a `Prior` line:
22002200
The `Tests:` line's 1.108.327 count, verbatim:
22012201

22022202
- ⚠ Prior (1.108.327): 14213 passed, 25 skipped, **0 failed** (14238 total).
2203+
2204+
## Current State rotation (2026-10-06, release 1.108.331)
2205+
2206+
The 1.108.328 entry, verbatim as it stood in `CLAUDE.md`:
2207+
2208+
- **Prior (1.108.328):** **A file a `package.json` script runs is an entry point** (L-102): `tools/_entry_points.package_json_entries` reads `scripts` as an ALLOWLIST and anything else roots NOTHING (rules: Key Files `_entry_points.py`; residue L-111). Also a repeat `index <subdir>` inside a git root is incremental (#961, @ebataeva). Full text: `CHANGELOG.md`; verbatim in `ISSUE-HISTORY.md` (2026-10-05, release 1.108.329).
2209+
2210+
The 1.108.330 entry, verbatim, dropped when it was compressed to a `Prior` line:
2211+
2212+
- **Version:** 1.108.330 — **The parse budget bounds a file's Python-side time** (L-116). No second thread waits on a parse: `parse_budget.checkpoint()` raises inside `parse_file` once the file's deadline (the parsing thread's own time) has passed, on every route, at any size. ⚠ One slow call (a whole-file regex, PyYAML) is not cut short (L-118), and loops are still slow BELOW the budget (L-115, L-117). Also a bare Python module name resolves to the script directory beside the importer (#972, @whakomatic; refusals and residue: L-120). Rules: the Env Vars row. Forensics: `docs/workflows/LEDGER.md`.
2213+
2214+
The `Tests:` line's 1.108.328 count, verbatim:
2215+
2216+
- ⚠ Prior (1.108.328): 14684 passed, 25 skipped, **0 failed** (14709 total).

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -158,10 +158,10 @@ That's the highlight reel. The complete tour of 90+ tools, the MUNCH compact wir
158158
<!-- WHATSNEW:START -->
159159
#### What's new
160160

161+
- **[v1.108.331](https://github.com/jgravelle/jcodemunch-mcp/releases/tag/v1.108.331)** (2026-10-06) — a full re-index keeps the embedding metadata beside its vectors
161162
- **[v1.108.330](https://github.com/jgravelle/jcodemunch-mcp/releases/tag/v1.108.330)** (2026-10-06) — the parse budget bounds a file's Python-side time
162163
- **[v1.108.329](https://github.com/jgravelle/jcodemunch-mcp/releases/tag/v1.108.329)** (2026-10-05) — the parse budget stops a slow parse
163164
- **[v1.108.328](https://github.com/jgravelle/jcodemunch-mcp/releases/tag/v1.108.328)** (2026-10-04) — a file a package.json script runs is an entry point
164-
- **[v1.108.327](https://github.com/jgravelle/jcodemunch-mcp/releases/tag/v1.108.327)** (2026-10-02) — a local model path is refused when the installed sentence-transformers would run its code
165165
<!-- WHATSNEW:END -->
166166

167167
---

‎pyproject.toml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
22
name = "jcodemunch-mcp"
3-
version = "1.108.330"
3+
version = "1.108.331"
44
description = "Token-efficient MCP server for source code exploration via tree-sitter AST parsing"
55
readme = "README.md"
66
requires-python = ">=3.10"

‎server.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@
33
"name": "io.github.jgravelle/jcodemunch-mcp",
44
"title": "jCodemunch MCP",
55
"description": "Token-efficient code exploration via tree-sitter AST parsing. 70+ languages, 86-99% token savings.",
6-
"version": "1.108.330",
6+
"version": "1.108.331",
77
"packages": [
88
{
99
"registryType": "pypi",
1010
"identifier": "jcodemunch-mcp",
11-
"version": "1.108.330",
11+
"version": "1.108.331",
1212
"transport": {
1313
"type": "stdio"
1414
}

‎uv.lock‎

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎whatsnew.json‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
{
2-
"current": "1.108.330",
2+
"current": "1.108.331",
33
"entries": [
4+
{
5+
"version": "1.108.331",
6+
"date": "2026-10-06",
7+
"title": "a full re-index keeps the embedding metadata beside its vectors",
8+
"summary": "A full re-index cleared the table where the embedding store records which model, dimension and task type produced its vectors, and kept the vectors. A semantic search after a model change could then leave vectors of two widths under the new model's name, and embed_repo re-embedded the whole corpus after every full re-index. The save now keeps the embedding store's rows, so a model change after a full re-index is detected and named, and embed_repo embeds only the symbols that have no vector. Pass force=true to refresh every vector (#522, @lsg1103275794). Also: a large Vue or Svelte <script> is indexed in time proportional to its size; a 6000-function script that took over 20 seconds to parse now takes a fraction of a second, with the same symbols. Also: embed_repo no longer re-embeds a corpus for a task-type row that was never written, and names the reason when it does rebuild (#523, @lsg1103275794)."
9+
},
410
{
511
"version": "1.108.330",
612
"date": "2026-10-06",
@@ -18,12 +24,6 @@
1824
"date": "2026-10-04",
1925
"title": "a file a package.json script runs is an entry point",
2026
"summary": "find_dead_code and get_dead_code_v2 read a package.json's main, exports and bin but not its scripts, so a server started by \"start\": \"node server.js\" was reported dead at confidence 1.0 along with everything only it imports. scripts is read now, as an allowlist: a runner from a list of twelve, flags that runner is known to take, and a path that resolves to one indexed file the way that runner resolves it. Anything else roots nothing, so a wrong guess cannot hide a dead file. Also, a repeat index of a subdirectory inside a git root is incremental (#961, thanks @ebataeva)."
21-
},
22-
{
23-
"version": "1.108.327",
24-
"date": "2026-10-02",
25-
"title": "a local model path is refused when the installed sentence-transformers would run its code",
26-
"summary": "1.108.326 raised the semantic extra's floor, and a floor is install metadata: an upgrade that does not name the extra keeps an older sentence-transformers. The embedding call now checks the release it imported. When embed_model is a path that exists and the release is older than 5.6.0, the call refuses before the model is constructed and names the advisory (GHSA-jhr6-gm9c-rqjv) and the upgrade command. A Hub model name is not refused. Fusion search now says why its semantic channel did not run instead of reading the same as a repository that was never embedded."
2727
}
2828
]
2929
}

0 commit comments

Comments
 (0)