tracker

4.6 KB

1. # w052-search — tracker#14 (search), mission 008 (old 052)
3. **Branch** `t14-search` in loreana:/media/STORAGE/projects/tracker-wt14 (not pushed, not merged)
4. - `65c694a` tracker#14: search — header magnifier, /search/<text>, in-memory index, Fetch from web, Add = import via syncShow; gate +25, real-data script
5. - `b8bd115` tracker#14: README + STATUS
7. **Built**: `search.hl` (new: index, `queryOfParam`, TMDB `webSearch`, `importTitle`), `components/search.hl` (new page),
8. `components/main.hl` (magnifier in the header), `project.hl` (route `/search/:q?`, index built at boot), `styles.hl`
9. (one block), `tests/browser.mjs` + `tests/faketmdb.mjs` (fake `search/multi`, import fixtures), `tests/realdata-search.mjs` (new).
11. **Decisions**
12. - Address `/search/<text>`, NOT `/search?q=`: hl:web gives a page route params but no query string. `/search?q=x` opens the empty page.
13. - Index: every title/name → normalised words (case, apostrophes, punctuation, Latin accents; title year as a word); buckets
14. keyed by each word's first 2 and 3 letters; a query reads ONE bucket. Min 2 letters; at most 30 titles + 10 people.
15. - Web: one TMDB `search/multi` per "Fetch from web" click (not per keystroke); people dropped; titles we have (TMDB id + kind) left out.
16. - Import: one `/tv|movie/<id>` details request → new record (own 16-hex id, `oldId tmdb-tv-<id>`, slug like migrated ones,
17. genres matched by name) → `syncShow` (seasons, episodes, poster, ids) → index updated → its page opens. Not auto-followed.
18. - Signed out: search and web work; "Add" opens the sign-in modal and sends nothing.
20. **Gate**: `TRACKER_GATE_SHOTS=/tmp/w052-t14/shots TRACKER_GATE_PORT=8773 TRACKER_GATE_IDENT_PORT=8774 TRACKER_GATE_CHROME=8776-8778 TRACKER_GATE_TMDB_PORT=8779 node tests/browser.mjs`
21. → `136 passed, 0 failed` (111 + 25). Includes the hybriel#121/#122 check: a failed import, which is a session face that
22. stays on the page, leaves the DB list, the web list, the field and the `data-for` unchanged, with no row twice.
24. **Real data** (copy of the live storage, deleted afterwards; real TMDB; az5b2):
25. - Index build at boot: 0.60 s (9453 titles, 15157 people, 4180 keys).
26. - `dbSearch` time: 0–1 ms for typical queries, 38–44 ms for "the"/"th".
27. - Server render: `/search/doctor%20who` 9 ms, `/search/the` 56 ms.
28. - Browser, keystroke → results + address: 56–76 ms.
29. - `/search` page load: 0.85 s cold, 0.04 s warm.
30. - Fetch from web: 0.12–0.23 s.
31. - Import of "Pluribus" (tv 225171): 0.77–1.1 s. Season 1 with 9 episodes, poster, 4 id links, genres. Afterwards it is in
32. the DB results and gone from the web list. 0 console problems.
34. **Screenshots** (Loreana, looked at): `/tmp/w052-t14/shots/search{,-web}-{390,1280}.png`, `search-signed-out-modal-1280.png`
35. (+ all existing gate shots); real data `/tmp/w052-t14/real/search-*.png`, `imported-show-1280.png`. Note: the #15 worker
36. also writes to `/tmp/w052/real/`; my first run's search PNGs landed there too before I moved mine to `/tmp/w052-t14/`.
38. **Merge notes** (files #13 likely touches too):
39. - `project.hl`: imports, the `/search/:q?` route, `searchIndexReady = ensureIndex()` before `server`.
40. - `components/main.hl`: the magnifier inside `userBox`.
41. - `styles.hl`: one block before the `@media` block.
42. - `tests/browser.mjs`:
43. - fixtures at the top;
44. - a signed-out block before the "#3 borders" checks;
45. - `search` added to the 390/1280 page list;
46. - a signed-in block before "#10 THE INSTALLABLE APP".
47. - `tests/faketmdb.mjs`: search and thumbnail requests are recorded separately, so the existing request-count checks are untouched.
48. - README: intro, new section, Test block (the count line changed to 136), Files.
49. - STATUS: a new section on top.
51. **Open**
52. - No person page: `/person/<slug>` gives a 404, like the existing cast links.
53. - Imported titles are not followed, so the daily sync never refreshes them. Architect's call.
54. - Web search is open to signed-out visitors, with no rate limit of our own.
55. - Autofocus is proven on a full load only.
56. - Real-phone test after deploy.
58. **Hybriel findings** (no blockers; worth adding to the worker guide):
59. 1. A module `static x = f()` is evaluated lazily: never, if nothing reads `x`. Work around it with an explicit `ensure…()` call from a `project.hl` member.
60. 2. The server percent-decodes the path before routing: `%2F` gives a 404, and invalid UTF-8 (`%E0%80`) reaches the page as raw bytes. A client-side navigation hands the param still encoded, which is inconsistent. The page therefore writes `/ ? #` into the address as spaces.
61. 3. A record literal entry `id = …` shadows a local `id` for the later entries (already documented for `show`; I hit it again with `tmdbId = id`).
62. 4. Pages get no query string (`?q=`), only route params.