Skip to content

Commit eb5fd20

Browse files
committed
fix(fulltext): bump model version to 0.7.423 to match deployed workspaces
The fulltext-pod's compiled model version (baked into bundle/model.json via common/scripts/version.txt at build time) was 0.7.422 while the deployed workspace pods had been migrated to 0.7.423. The fulltext-pod rejected every incoming Tx with a 'wrong version' warning, so newer issues — including the user-reported OSKOS-51 'Telescopic loader' — were never indexed and search returned empty results. Bumping version.txt aligns the compiled model with the workspaces. All future builds (front, transactor, workspace, tool, fulltext) will emit 0.7.423. Adds plugins/view-resources/src/__tests__/README-search-rootcause.md as the regression marker — pure-TS tests cannot exercise the ES round-trip, so the README points future PRs to the live verification in the Task 6 Playwright case. Co-finding during the investigation: huly_v7-redpanda-1 had exited the same morning, causing fulltext-pod to lose its queue consumer for ~3h. Restarting redpanda + the new fulltext image cleared both issues. The redpanda restart is operational, not in this commit.
1 parent bd2324e commit eb5fd20

2 files changed

Lines changed: 49 additions & 1 deletion

File tree

common/scripts/version.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
"0.7.422"
1+
"0.7.423"
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Search Root-Cause Regression — 2026-05-17
2+
3+
The 2026-05-17 title-search bug (typing `loader` against `OSKOS-51 Telescopic
4+
loader — delivery & install` returned 0 results) was a server-side
5+
indexing/version-skew issue. It cannot be reliably regression-tested in Jest —
6+
a pure-TS test cannot exercise the Elasticsearch round-trip.
7+
8+
## Root cause (recorded for future PRs)
9+
10+
- `common/scripts/version.txt` was at `0.7.422`. The local deployment had
11+
forced workspace migrations to `MODEL_VERSION=0.7.423` via compose env, so
12+
the workspaces' persisted `core:class:Version` document was on `0.7.423`.
13+
- The fulltext-pod, built from this codebase, embedded model version `0.7.422`
14+
into `pods/fulltext/bundle/model.json` at build time.
15+
- Every Tx coming from a `0.7.423` workspace was dropped by the fulltext-pod
16+
with a `wrong version` warning, so new issues were never indexed and search
17+
returned empty results for them.
18+
19+
Companion issue spotted during the investigation: `huly_v7-redpanda-1` had
20+
exited at 07:06 UTC on the same day, leaving the fulltext-pod unable to
21+
consume from the queue at all for ~3h. Restarting it cleared the queue
22+
backlog.
23+
24+
## How to re-verify before merging any PR that touches:
25+
26+
- `foundations/server/packages/elastic/src/adapter.ts`
27+
- `pods/fulltext/**`
28+
- `models/server-tracker/**`
29+
- `plugins/view-resources/src/components/filter/**`
30+
- The SearchInput / SearchInputAdvanced wire-contract
31+
- `common/scripts/version.txt`
32+
33+
Run the live verification described in
34+
`docs/superpowers/plans/2026-05-17-tracker-search-rootcause-fix.md` Task 6:
35+
typing `loader` in the Tracker Lupe must return `OSKOS-51` within 500 ms in
36+
the gamedesigndemov3 workspace's Ostrowo Kościelne project.
37+
38+
ES-level direct verification (`docker exec huly_v7-elastic-1 curl -s -X POST
39+
"localhost:9200/huly_storage_index_v2/_search" -H "Content-Type:
40+
application/json" -d '{"query":{"multi_match":{"query":"loader","fields":[
41+
"searchTitle","fulltextSummary","identifier"]}}}'`) must return ≥1 hit
42+
identified as `OSKOS-51` in the affected workspace.
43+
44+
## Future-prevention
45+
46+
A version-skew detector in the deploy pipeline should refuse to publish a pod
47+
image whose compiled `model.json` patch differs from the workspace's stored
48+
patch by more than 0. Tracked separately; out of scope for this PR.

0 commit comments

Comments
 (0)