tracker

101.1 KB

1. # STATUS — tracker.worldapi.org
3. ## 2026-10-02 — ticket #18 (mission 067, branch t18 from t26's head 10bb3f9, worktree tracker-wt18): daily sync by change lists, show record refresh, summary priority (NOT merged, NOT deployed)
5. **Built**: `deltasync.hl` (new): the daily run first reads TMDB `/tv/changes` + `/movie/changes` (since the stored day, all pages)
6. and TVmaze `/updates/shows?since=day|week|month`, one request per clock step → our changed titles (search index lookups, no scan),
7. followed first. Followed → full `syncShow` (as before); unfollowed → `syncShowDelta` (light: details + ids + poster + record + only
8. new/grown/newest seasons, no TVmaze). Full walk on: no `sync-state.txt`, gap > 14 days, failed change list (day not advanced).
9. `details.hl withDetailsFields` (title, tmdbSummary, homepage, tagline, status, genres, adult; shared with #26's completion) +
10. `applySynced` (fields + credits) replace `applyCredits` in the sync paths. TVmaze request = `/shows/<id>?embed=episodes` (summary →
11. `tvmazeSummary`, `stripHtml`). `summary` never written (sync, search import, person fill, completion); page `summaryOf`: summary >
12. tmdbSummary > tvmazeSummary. One-time boot clear of copied summaries (marker `summaries-cleared.txt`). Search: `searchTitleRenamed`,
13. `titleIdByTvmaze`. Tool: `tools/sync-tmdb.hl --delta [--since D] [--plan]`. Details: README "What it does (ticket #18)".
15. **Decisions (mine)**: (1) unfollowed changed series get the LIGHT step — the first real run with full steps blocked the server 20.8 s
16. for Today (15,716 episodes) and EastEnders (7,349) each and grew RSS to 14 GB + 2.9 GB swap; (2) TVmaze stays a followed-series thing
17. (its list only brings followed series); (3) the day stored = the day the finished run STARTED (overlapping windows, no gap); (4) light
18. step's seasons = missing, TMDB count > ours (fewer = TVmaze extras, skipped), newest; (5) a renamed title keeps its slug;
19. (6) `syncShowPart` reads only its part's seasons' episodes unless it finishes with the TVmaze merge (also speeds up #26's parts).
21. **Real data** (copy of Byrodin `storage/` 2026-10-01 ~21:45 UTC = pre-#26/#28 live data, real TMDB/TVmaze, :8750, sync-state = 2026-09-30):
22. - Change lists for one day: TMDB tv 3,088 + movie 9,559 ids (31 + 96 pages), TVmaze 312 → **336 of our titles (28 followed)**
23. (152 series / 197 movies in the first variant).
24. - Delta run (final code): `tmdb sync done: mode=delta changeRequests=128 shows=336 newSeasons=79 newEpisodes=4475 updatedEpisodes=1305
25. updatedSeasons=70 posters=1 ids=0 requests=607 tvmazeRequests=29 errors=0 … seconds=536.359`; slowest step 2.5 s; pages meanwhile
26. (`/`, `/movies`, `/shows` every 0.5 s, n=925): median 45 / p95 226 / p99 693 / max 2216 ms. Same day again (steady state):
27. `shows=336 newSeasons=0 newEpisodes=0 updatedEpisodes=0 … requests=605 tvmazeRequests=29 errors=0 seconds=511.205`, slowest 2.06 s,
28. RSS 2.18 → 5.7 GB.
29. - OLD full walk on the same copy (no state file): `mode=full shows=128 … requests=259 tvmazeRequests=128 errors=1 seconds=312.241`
30. (the error: one TLS handshake failure, transient), RSS 2.1 → 4.9 GB.
31. - First variant (full step for every title): 349 titles, 659 + 155 TVmaze requests, 755 s, 46 slow steps up to 20.8 s, RSS 14 GB.
32. - Summaries: `summaries: cleared 9647 copies of tmdbSummary, kept 24 own texts, errors 0` (one time; ~+2 GB RSS at that boot). The 24
33. kept are all FOLLOWED shows whose tmdbSummary the #9 sync changed since the migration → older TMDB texts, likely no rewrites:
34. The-Flash, Magnum-P.I., Alex-Rider, Star-Trek-Strange-New-Worlds, Star-Trek-First-Contact (its tmdbSummary is ANOTHER title's —
35. "Kabuhayang Swak na Swak": wrong tmdbId on that record), Night-Sky, Good-Omens, Quantum-Leap-2, His-Dark-Materials, Not-Dead-Yet,
36. Star-Wars-Andor, The-Rookie, Will-Trent, Unstable-2, Reacher, Wednesday, Citadel, Miracle-Workers, FUBAR, The-Night-Agent,
37. The-Wheel-of-Time, Ahsoka, Percy-Jackson-and-the-Olympians, The-Daily-Show-with-Trevor-Noah.
38. - Record refresh, first day: 24 renamed (Star Wars: Andor → Andor, The Daily Show with Trevor Noah → The Daily Show, WWE Raw → Raw,
39. 편의점 샛별이 → Backstreet Rookie, "Kaun Banega Crorepati(कौन बनेगा करोड़पति)" → "Kaun Banega Crorepati" — the old tracker's
40. "Name(original)" form goes), 79 tmdbSummary changed, 173 taglines.
41. - Screenshots (looked at): Loreana `/tmp/w067/real/{Star-Wars-Andor,Breaking-Bad,Kaun-Banega-Crorepati}-{390,1280}.png` (Andor: new
42. title; Breaking Bad: TMDB's current text after the clear), full load 134–649 ms, 0 console problems; gate `/tmp/w067-shots/`
43. (delta-show-1280, delta-movie-1280).
44. How to repeat (ports 8750–8759; ONLY `storage/`; the worktree has no `.env` → `ln -s ../tracker.worldapi.org/.env .env`, remove after):
45. ```
46. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' < /dev/null | tar xzf - -C .scratch/realdata
47. echo <yesterday> > .scratch/realdata/storage/mpackdb/sync-state.txt # none = the full walk
48. TRACKER_PORT=8750 TRACKER_SYNC=1 TRACKER_SYNC_HOUR=$(date -u +%-H) TRACKER_WATCH=0 TRACKER_BACKFILL=0 TRACKER_REPAIR=0 TRACKER_CREDITS=0 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ TRACKER_URL=http://127.0.0.1:8750 HL_HOST=127.0.0.1 ./bin/hybriel project.hl > .scratch/delta.log 2>&1 &
49. REAL_PORT=8750 REAL_LOG=.scratch/delta.log node tests/realdata-018-poll.mjs # latency until "tmdb sync done"
50. grep '^tmdb sync\|^summaries' .scratch/delta.log; RSS: grep VmRSS /proc/<pid>/status
51. REAL_TITLES=Star-Wars-Andor,Breaking-Bad REAL_OUT=/tmp/w067/real node tests/realdata-018.mjs
52. # afterwards: kill <pid>; rm -rf .scratch/realdata .scratch/realdata-sessions; rm .env
53. ```
55. **Gate** (249 → 261; 12 new #18 checks; the TVmaze episode paths are `/tvmaze/shows/<id>?embed=episodes` now; the #26 completion
56. check now expects TMDB's overview — `summary` is no longer filled by the fill/completion; the seed movie's summary is a copy of its
57. tmdbSummary; `tests/peek-shows.hl` reads records with the app stopped):
58. ```
59. TRACKER_GATE_SHOTS=/tmp/w067-shots TRACKER_GATE_PORT=8751 TRACKER_GATE_IDENT_PORT=8752 TRACKER_GATE_TMDB_PORT=8753 TRACKER_GATE_CHROME=8754-8756 node tests/browser.mjs
60. 261 passed, 0 failed
61. ```
63. **Open (for the architect)**:
64. - NOT "a handful of requests": movies change a lot on TMDB (9,559 ids/day → 96 pages) — a day = 128 change-list requests + ~480 title
65. requests + 29 TVmaze ≈ 634 (old full walk: 387) but every title stays current, followed ones only when they changed (28 vs 128).
66. Dropping unfollowed MOVIES would save ~96 pages + ~200 requests — creator's call.
67. - MEMORY: ~10 MB per synced title are never freed (Hybriel, see #28) → +3.5 GB RSS per daily run until a restart (old run +2.8 GB);
68. the live container already used 11.4 GiB. A daily restart or the runtime fix is needed either way.
69. - Titles: TMDB's en-US name replaces the migrated title (24 on day one, incl. the "Name(original)" form). If the creator wants to keep
70. some, a creator-title field like `summary` would be needed.
71. - The 24 kept "own" summaries look like older TMDB copies (list above) — clear them too? (architect's rule was "identical only").
72. - Merge: t18 is on t26's 10bb3f9; t19 (franchises) and the 062 merge also touch people.hl/search.hl/README/STATUS — expect conflicts
73. in README/STATUS only (code: people.hl 1 line, search.hl small additions).
75. ## 2026-10-01 — ticket #28 (mission 061, branch t26 on top of #26, worktree tracker-wt26): full cast + crew (NOT merged, NOT deployed)
77. **Found** (live copy 2026-10-01 ~14:40): the page showed `show.cast` — the old tracker's migrated list for 1,820 of 10,011 titles
78. (Star Trek: Picard **4**: Stewart, Ryan, Hurd, Speleers; Dune (1984) 39), nothing for the rest (Superman 1978: **0**); #26 only
79. added TMDB's first 20 to filmography titles; no crew anywhere; the daily sync and the search import never stored cast.
81. **Built**: details.hl `castOf`/`crewOf`/`mainMinOf`/`withCredits`/`applyCredits` + the credits job (`creditsQueue`/`creditsStep`,
82. project.hl `creditsTick`); tmdbsync.hl asks `external_ids,aggregate_credits|credits` in the details request it makes anyway and
83. returns it (`res.details`); search.hl `importTitle` asks once (ids + credits) and hands that answer to `syncShowWith` (one request
84. less), components/search.hl stores the credits; tools/sync-tmdb.hl too; show page: crew block (job labels) + cast `Name (Character)`
85. collapsed after 20 with a client-only "Show all (N)" (crew: 6 per job, "Show all crew (N)"), "Guest stars" label; shows.hl
86. `showBySlug` by a slug → id map. Details: README "What it does (ticket #28)".
88. **Decisions**: cast ≤ 300 (`TRACKER_CAST_MAX`; SNL 2,771 / Grey's 3,243 one-episode guests would each be a person), crew ≤ 30 per
89. job; guest = fewer than half the series' episodes (≤ 10, ≥ 1) — Picard (30 ep.): ≥ 10; composer = Original Music Composer /
90. Composer / Music; Writer, Screenplay, Story separate groups (Teleplay not shown). The credits job runs after the backfill and the
91. repair, only public titles (`adult == false`), one request per title + 260 ms, pauses above `TRACKER_CREDITS_MAX_MB` (16000).
93. **Hybriel finding (not filed; for the architect)**: the native runtime never gives back what a `fetch` body or a decoded record
94. took — repro (10 lines): a node server answering a 440 KB JSON; a .hl loop `fetch(url)` + `r.json()` 300× → RSS +2.7 GB (fetch
95. without `.json()`: +0.43 GB), sampled with `ps -o rss=`; nothing is given back while the process lives. The same
96. for `showsTable.find(null, null)`: the old `showBySlug` decoded every title per call → run 1 below grew to 20 GB in 20 min. The LIVE
97. container used **11.4 GiB** today (docker stats, before any of this). Fix in this branch: the slug map (no per-page scan) + the job's
98. RSS limit; the leak itself is Hybriel's.
100. **Real data** (copy of Byrodin `storage/` 2026-10-01 ~14:40, real TMDB/TVmaze, :8750; copy deleted):
101. - Before → after: **Star Trek: Picard 4 → 202 cast** (17 main ≥ 10 episodes incl. season-3 regulars Gates McFadden, Todd Stashwick, then
102. guests from John de Lancie (9)) + 45 crew (Created by Kurtzman, Beyer, Goldsman, Chabon; Directed by Frakes …; Written by; Story;
103. Music Jeff Russo …). **Superman (1978) 0 → 90 cast** + Directed by Richard Donner, Written by Tom Mankiewicz, Screenplay Newman /
104. Benton / Puzo / Newman, Story Puzo, Music John Williams. Dune (1984) 39 → 41. The Simpsons 6 → 300 (cap) + 67 crew.
105. - Run 1 (`TRACKER_REPAIR=1 TRACKER_CREDITS=1`): `details repair done: 557/557 … cast=30286 … seconds=800`, then the credits job
106. `start, 5867 titles`; stopped after 714 (RSS 20 GB — pages scanned every show per call, see the Hybriel finding). Run 2 (slug map,
107. light persist, `TRACKER_CREDITS_MAX_MB=16000`): resumed `start, 5153 titles` → `credits job done: 5153/5153 titles, done=5153
108. failed=0 cast=262634 crew=39624 people=104614 requests=5153 retries=0 slowestStepMs=1316 seconds=2681` (44.7 min; whole job ≈ 51
109. min); RSS 3.8 → 6.3 GB (the pause did not trigger; it is gate-tested). Next start: `credits job: start, 0 titles` / `nothing to do`.
110. - Page latency meanwhile (`/movies`, Picard, Foundation, `/` in turn every 0.5 s, n=4836): median 28 ms, p95 194, p99 436, max 1125 ms.
111. (Run 1 with the old `showBySlug`: Picard median 318 ms, max 3.8 s; during the repair median 179 ms, max 4.1 s.)
112. - After (no job running): show page full load 105–235 ms (Picard 206 ms, first after boot 2.1 s = the slug map), Picard HTML 166 kB,
113. Simpsons 364 kB; "Show all" 2–18 ms, 0 faces sent; no sideways scroll at 390. Signed-in watch click (session face re-derives the cast
114. rows too): Picard 184–200 ms (first 1.3 s), The Simpsons 276–731 ms. Boot: search index 10,011 titles / **160,084 people** (was
115. 15,157) in **4.3 s (was 0.66 s)**, RSS after boot **4.9 GB (was 1.6 GB)**.
116. - Screenshots (looked at) on Loreana `/tmp/w061/real/{Star-Trek-Picard,Superman,Dune,The-Simpsons}-{collapsed,all}-{390,1280}.png`;
117. gate `/tmp/w061/shots/credits-{movie-1280,series-collapsed-390,series-all-390,series-1280}.png`. 0 console problems.
118. How to repeat (ports 8750–8753; ONLY `storage/`; the worktree has no `.env` → `ln -s ../tracker.worldapi.org/.env .env`, remove after):
119. ```
120. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' < /dev/null | tar xzf - -C .scratch/realdata
121. TRACKER_PORT=8750 TRACKER_SYNC=0 TRACKER_WATCH=0 TRACKER_BACKFILL=1 TRACKER_REPAIR=1 TRACKER_CREDITS=1 TRACKER_CREDITS_LOG_EVERY=250 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ TRACKER_URL=http://127.0.0.1:8750 HL_HOST=127.0.0.1 ./bin/hybriel project.hl
122. # latency meanwhile: a node loop fetching /movies, /shows/Star-Trek-Picard, /shows/Foundation, / every 0.5 s until 'credits job done'
123. # (mission 061's: .scratch/w061/poll.mjs); grep '^credits job\|^details repair' in the log; RSS: ps -o rss= -p <pid>
124. REAL_TITLES=Star-Trek-Picard,Superman,Dune,The-Simpsons REAL_OUT=/tmp/w061/real node tests/realdata-028.mjs
125. # afterwards: stop the server, rm -rf .scratch/realdata .scratch/realdata-sessions; rm .env
126. ```
128. **Gate** (231 → 249; 18 new #28 checks; fake TMDB fixtures: show 1001 aggregate_credits + created_by, movie 1003 credits, import
129. 1004, Backfill Movies' credits; the sync/import request paths now carry the credits; `TRACKER_CREDITS=0` by default):
130. ```
131. TRACKER_GATE_SHOTS=/tmp/w061/shots TRACKER_GATE_PORT=8754 TRACKER_GATE_IDENT_PORT=8755 TRACKER_GATE_CHROME=8756-8758 TRACKER_GATE_TMDB_PORT=8759 node tests/browser.mjs
132. 249 passed, 0 failed
133. ```
135. **Merge notes** (main has missions 058/060 meanwhile): `components/show.hl` — header comment, statics after `genreRowsOf`
136. (`castShown`…`crewCountOf`, replacing `castRowsOf`), `completedPageOf`'s answer, members after `hasCast`, the View's crew + cast
137. blocks (replacing the old `showCast` loop), `completeTick` assignments, handlers `toggleCastAll`/`toggleCrewAll` before
138. `toggleEpisode`. `styles.hl` — the cast/crew block replaces the two `.artist-link` lines. `shows.hl` — `showBySlug`. `tmdbsync.hl` —
139. details paths + `res.details`. `search.hl` — `importTitle` (one request, `syncShowWith`). `project.hl` — `readFile` import, sync tick
140. `applyCredits`, the credits job block before the clock, the clock's tick. Gate expectations that name request paths changed (sync tool,
141. import, failed-import message). **Deploy**: repair (~557 titles, ~13 min) then credits job (~5,900 titles, ~51 min); watch RSS
142. (`docker stats`) — live already used 11.4 GiB before this.
144. **Open**: (1) merge + deploy. (2) The Hybriel leak (fetch bodies / decoded records never freed) — architect to file; the live app
145. grows with every sync/backfill too. (3) 160k people: boot +3.6 s, +3.3 GB RSS — if too much, store cast without creating people for
146. guests (link resolved on click) — not built. (4) Session faces (watch/follow clicks) re-derive the cast rows (`castRows` derives from
147. `showRow`, which reads the session): Simpsons click up to 0.7 s; deriving them from the slug would avoid it (adult pages need care).
148. (5) A followed title's credits refresh with the daily sync; others are never refreshed. (6) Cast persons' slugs as #26 (`-2` rule).
151. ## 2026-10-01 — ticket #26 (mission 059, branch t26, worktree tracker-wt26): filmography titles complete (NOT merged, NOT deployed)
153. **Found**: the person fill (#16, people.hl `addMinimalTitle`) stores only title, year/release, overview, type, tmdbId, adult, genres,
154. language and that one person as cast — no poster, seasons/episodes, imdb/tvdb/tvmaze ids, homepage/tagline/status, `tmdbSync`; the
155. show page just showed that, forever. A search import (`importTitle` + `syncShow`) has all of it except the cast. Live copy: 321 such
156. titles (6 people filled so far).
158. **Built**: `details.hl` (`completeStep`), show page loading state (skeleton poster / cast line / 3 season rows, probe → face
159. `showComplete` until done, no reload), `project.hl repairTick` (the details repair, after the adult backfill), tmdbsync.hl
160. `syncShowWith`/`syncShowPart` (sync with a given details answer, a series in parts), people.hl `castPersonId` + `minimal = true`,
161. search.hl `slugBaseOf`/`indexPerson`. Details: README "What it does (ticket #26)".
163. **Decisions**: complete = what a full import has + the cast (TMDB's first 20, billing order; series: aggregate_credits; adult
164. people left out; new people get a record + slug + search entry, their page fills on first visit). Marker `detailsAt`; incomplete =
165. `minimal` or `imported` without `tmdbSync`. Adult titles are never completed (not on open — the public face refuses them — not by
166. the repair). TMDB 404 → `detailsCheck`, not asked again. A series in steps (≤ 300 episodes per step) — the first real run did the
167. Late Show in ONE 10.7 s step, pages waited up to 10.3 s. Titles a fill adds while the app runs: completed on open or at the next
168. start (the queue is built at start).
170. **Real data** (copy of Byrodin `storage/` 2026-10-01 ~13:55, real TMDB/TVmaze, :8750, `TRACKER_BACKFILL=0`; copy deleted):
171. - Click from a person page (fill first), `node tests/realdata-026.mjs` — ms from the click: skeleton shown / complete / poster:
172. | title (person, width) | shown | complete | poster | server (log) |
173. |---|---|---|---|---|
174. | Violent Night 2, movie (Jared Harris, 390) | 186 | 712 | 765 | 1 step, 255 ms, cast 14 |
175. | Royal Kill List, series (Jared Harris, 390) | 227 | 1361 | 1363 | 3 steps, 592 ms, 1 season / 3 ep |
176. | Teen Wolf: The Movie (Tyler Hoechlin, 1280) | 216 | 662 | 662 | 1 step, 189 ms, cast 20 |
177. | Wolf Watch, series (Tyler Hoechlin, 1280) | 258 | 1316 | 1318 | 3 steps, 537 ms, 3 seasons / 28 ep |
178. | Avengers: Doomsday (Patrick Stewart, 1280) | 178 | 642 | 694 | 1 step, 247 ms |
179. | Bait, series (Patrick Stewart, 1280) | 181 | 1262 | 1263 | 3 steps, 594 ms |
180. /movies asked every 100 ms meanwhile: max 283–586 ms. Reload afterwards: complete at once, 157–205 ms full load, same parts.
181. Direct open (1280): Late Show with David Letterman 11.4 s (23 steps, 4,252 episodes), Watch What Happens Live 11.1 s (18 steps,
182. 3,220 ep); /movies meanwhile max 1.3 / 1.5 s (before the steps: one 10.7 s step).
183. - **Repair** (restart with `TRACKER_REPAIR=1` on a fresh copy): `details repair done: 321/321 titles, complete=321 failed=0 adult=0
184. newSeasons=638 newEpisodes=16528 posters=299 cast=5196 requests=787 tvmazeRequests=218 retries=0 seconds=507.248`; no slow step
185. (> 1.5 s); /movies + /shows/Foundation every 0.5 s meanwhile: n=1298, median 0.13 s, p95 0.25 s, p99 1.03 s, max 2.35 s. Next
186. start: `start, 0 incomplete titles` / `nothing to do`. (First try, one step per title: 401 titles in 628 s, max wait 10.3 s.)
187. - Screenshots (looked at) on Loreana `/tmp/w059/real/`: `{movie,series}-{skeleton,complete,reload}-{390,1280}.png`,
188. `direct-*-1280.png`, `repaired-{Licorice-Pizza,Late-Show-with-David-Letterman}-{390,1280}.png`. 0 console problems.
189. How to repeat (ports 8750–8753; ONLY `storage/`; the worktree has no `.env` → `ln -s ../tracker.worldapi.org/.env .env` for the
190. real token, remove afterwards):
191. ```
192. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' < /dev/null | tar xzf - -C .scratch/realdata
193. TRACKER_PORT=8750 TRACKER_SYNC=0 TRACKER_WATCH=0 TRACKER_BACKFILL=0 TRACKER_REPAIR=0 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ TRACKER_URL=http://127.0.0.1:8750 HL_HOST=127.0.0.1 ./bin/hybriel project.hl
194. REAL_PEOPLE=Jared-Harris:390,Tyler-Hoechlin:1280,Patrick-Stewart:1280 REAL_OUT=/tmp/w059/real node tests/realdata-026.mjs
195. REAL_PEOPLE= REAL_TITLES=Late-Show-with-David-Letterman node tests/realdata-026.mjs
196. # repair: restart with TRACKER_REPAIR=1, poll /movies, grep '^details repair' in the log (~8.5 min)
197. # count incomplete: the log line 'details repair: start, N incomplete titles' (N = 321 on 2026-10-01)
198. ```
200. **Gate** (214 → 231; 17 new #26 checks, the offline home check now expects 6 series):
201. ```
202. TRACKER_GATE_SHOTS=/tmp/w059/shots TRACKER_GATE_PORT=8754 TRACKER_GATE_IDENT_PORT=8755 TRACKER_GATE_CHROME=8756-8758 TRACKER_GATE_TMDB_PORT=8759 node tests/browser.mjs
203. 231 passed, 0 failed
204. ```
205. Gate env: `TRACKER_REPAIR=0` by default, `TRACKER_DETAILS_PART_EPISODES=1` (a season per step), the repair block sets
206. `TRACKER_REPAIR_FAST=1`. Shots `title-skeleton-1280.png`, `series-skeleton-1280.png` (looked at).
208. **Merge notes** (main has mission 058 meanwhile — #22–#25 touch `components/show.hl`): my show.hl changes are additive — an
209. import, 2 statics before "reactive members", 4 members after `adultShow`, the poster/cast/loading blocks in the View, the
210. `completeTick` handler before `toggleEpisode`, the face `showComplete` first among the faces. If 058 changes `buildRows`' signature,
211. `completedPageOf` calls `buildRows(show, null, cl)`. `tmdbsync.hl`: `syncMovie(show, res, pre)` gained a parameter, `syncShow` is
212. now `syncShowPart(showId, null, null)`. `project.hl`: 1 import, the repair block before the clock, the clock's tick. Gate: fixtures
213. (movies 2001/2004/2005/2101–2178, tv 2002, TVmaze 602, person 3010), startServer defaults, the #26 block inside #16, the repair
214. block before #10, the offline home check. **The live deploy**: the repair waits for the adult backfill (~80 min), then ~9 min.
216. **Open**: (1) merge + deploy. (2) A search import still has no cast (could use `completeStep`). (3) Client-side navigation keeps
217. the person page's scroll position on the title page (hl:web; seen on the phone shots, not new). (4) Titles added while the app runs
218. are not queued for the repair (open or next start). (5) Cast persons of a title are never refreshed; people's slugs from cast use
219. the same `-2` rule as the migration.
221. ## 2026-10-01 — ticket #17 (mission 057): season caret up/down, skeleton rows, faster opening (NOT deployed)
223. **Built** (`components/show.hl`, `styles.hl`, gate): caret DOWN closed / UP open. Opening a season: caret up + min(episodes, 8)
224. shimmering skeleton rows at once (client-side), then the sessionless face `showSeasonEpisodes(seasonId)` → `filledRows`
225. replaces them. Closing: client-only, no request. Watch state from member `watchedEpisodes` (per season `{ all, except }`).
226. Adult title pages (followers only) keep the session face `showRows(slug, collapsed)` (signature changed: no toggle inside).
227. Details: README "What it does (ticket #17)".
229. **Why it was slow** (measured): server work per open was small (probe on the copy: showBySlug 60–78 ms linear scan,
230. watchesOfUser 20 ms, watchedSet 6, episodesOfSeason 6) — but the face took `session`, so hl:web RE-MOUNTED the page on the
231. server and shipped every session-derived member (`rows` with the initial seasons!) as `sync`, which the client repainted,
232. then the handler repainted again. TRAP for future faces: a face with `session` = a full page re-render server-side + sync.
234. **Real data** (copy of Byrodin `storage/` 2026-10-01 12:25, :8730, creator az5b2, `node tests/realdata-057.mjs`, ms in the
235. page from click; 3 repeats; 390 and 1280 alike):
236. | | Daily Show S30 (142 ep) | Daily Show S28 (123) | LWT S12 (30) | LWT S10 (21) |
237. |---|---|---|---|---|
238. | before: episodes visible | 380–450 | 355–385 | 265–1093 | 235–285 |
239. | after: skeleton visible | 77–106 | 76–90 | 25–54 | 24–38 |
240. | after: episodes visible | 233–288 | 226–268 | 58–102 | 54–74 |
241. | close before → after | 420–1388 → 135–175 | 420–500 → 135–165 | 285–390 → 28–45 | 260–370 → 26–30 |
242. Skeleton rows 8 (cap) on all; faces sent: only showSeasonEpisodes, never showRows; client-filled watch state == the server's
243. rebuild (Daily Show 296 checks/121 solid, LWT 74/29). Page load unchanged (Daily Show ~310–360 ms warm both; HTML 157 → 167 kB
244. from `watchedEpisodes` — a plain id map was 274 kB, hence `{ all, except }`). Adult path checked once on a 2nd copy with LWT
245. set `adult = true` (:8728): signed out "Not found", creator opens seasons via showRows (skeleton 8, rows 300–400 ms, no dup).
246. The Daily Show's skeleton needs ~80 ms because hl:web re-renders the whole flat row list (~264 rows) on every `rows` write.
247. How to repeat (ONLY `storage/`; inner ssh with `< /dev/null`):
248. ```
249. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' < /dev/null | tar xzf - -C .scratch/realdata
250. TRACKER_PORT=8730 TRACKER_SYNC=0 TRACKER_WATCH=0 TRACKER_BACKFILL=0 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ TRACKER_URL=http://127.0.0.1:8730 HL_HOST=127.0.0.1 ./bin/hybriel project.hl
251. # session file for user 0mujqspn0aqb (mission 056 entry: name sha256(id), created/seen = now ms), id → .scratch/real-sid
252. REAL_OUT=/tmp/w057/real-after node tests/realdata-057.mjs # REAL_SHOWS, REAL_SEASONS (indexes, default 1,3), REAL_REPEAT
253. # afterwards rm -rf .scratch/realdata .scratch/realdata-sessions .scratch/real-sid
254. ```
256. **Gate** (208 → 214):
257. ```
258. TRACKER_GATE_SHOTS=/tmp/w057/shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
259. 214 passed, 0 failed
260. ```
261. Skeleton state tested with a FAKE DELAY: an init script holds the websocket frame naming `showSeasonEpisodes` back 1.5 s
262. while `window.__delayFace` is set. Shots `show-skeleton/open/closed-{390,1280}.png` looked at (Loreana /tmp/w057/shots/).
264. **Open**: (1) deploy. (2) Episode/season check clicks still use session faces that rebuild all rows (+ the re-mount sync) —
265. not measured here; the same split (client patch + a lean face) could speed them up. (3) Big-show skeleton ~80 ms (whole-list re-render in hl:web).
266. (4) The adult fallback is not in the gate (no fixture series is adult; changing seed-adult shifts many counts).
268. ## 2026-10-01 — mission 056: #16 merged into main, 3 fixes, Hybriel master 8590df63 (NOT deployed)
270. **Commits** (main, not pushed): 2c53d5e merge t16-person (worktree tracker-wt16 + branch removed; its `.scratch/w055` moved to
271. `.scratch/w055-wt16`), 2b7fdd6 header + backfill posters, f40c250 Hybriel + adult show page, + this docs commit.
272. - **Merge**: all conflicts additive. Filmography (people.hl `filmographyOf`) lists only `isPublicTitle` (`adult == false`)
273. titles whose credit is not adult — unknown hidden like the public lists.
274. - **Header** (signed out, phone): ident's "choose ident" + "Log in with ident" wrapped (73 px). Now nowrap, the phone says
275. "Log in" (`span.wide` " with ident" from 40rem): 46 px at 320/390, 54 px at 1280. TRAP: a style key twice in one block
276. REPLACES the first (a 2nd `'ident-selector::part(button)'` dropped its padding/border) — merge into one line.
277. - **Backfill**: an adult title's poster is not downloaded (flag + ids stored). Real data: posters 5,433 (was 8,740), dir
278. 269 MB (was 459 MB) → ~190 MB saved.
279. - **Hybriel** master 8590df63 (≥ 73267707: #122 18cf2fb9, #121 426944c7), sha256 `ca830ef8…`; old in `.scratch/pre-056/`.
280. Duplicate @ids on live copy: 0 in all 8 tables (episodes 232,384, shows 9,453, watches 11,663, …). Workarounds: none removed
281. (static helpers kept). SVG namespace check already in the gate (047).
282. - **Adult show page** (components/show.hl `visibleShow`/`adultHiddenFor`): `adult == true` → "Not found" for non-followers,
283. signed out too; no member carries the row (`showRow` itself is null — every member is shipped to the browser). A follower
284. sees it; Unfollow on the page hides it at once (session sync, #122; old build: only after reload). Faces showRows/
285. showToggle* refuse it. TRAP (why 054's try failed): `collapsed` derived from `found`/`showRow` (session-derived) gets
286. re-derived on the server with MOUNT state after each session face → seasons snap back, 2nd click dead. `collapsed`
287. now from the slug (`initialCollapsedOf`). Unknown (`null`) pages are not hidden.
288. - **Gate fixes**: the backfill "start" line comes with the clock's first tick, after the server answers → wait for it
289. (was a deterministic fail after the merge); every `stopServer()` first sends the tab to about:blank (websocket reconnect
290. errors failed the console check intermittently).
292. **Gate** (203 after merge → 208):
293. ```
294. TRACKER_GATE_SHOTS=/tmp/w056/shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
295. 208 passed, 0 failed
296. ```
297. Proven failing without the fix: poster check (forced download → FAIL), Unfollow-hides check on the old Hybriel (FAIL, page
298. stayed until reload). Shots `header-signed-out-{320,390,1280}.png`, `person*.png` looked at.
300. **Real data** (copy of Byrodin `storage/` 2026-10-01 09:47, :8730, real TMDB, backfill run on the copy 78 min, copy deleted):
301. ```
302. adult backfill done: 9453/9455 titles, adult=3450 notAdult=5866 unknown=137 posters=5433 ids=6459 requests=9455 errors=139 retries=2 seconds=4701.056
303. ```
304. `node tests/realdata-056.mjs` (full load ms 390/1280): `/` 426/91, `/movies` 92/90, `/movies/page/2` 93/37, `/shows` 287/41,
305. `/shows/page/2` 92/42, `/search/the` 336/126, `/search/sex` 442/91, `/person/Jared-Harris` 242/102 (first visit filled 97
306. credits, 80 added, 487 ms), `/shows/Foundation` 189/145; signed in (az5b2): `/my/shows` 650/219, `/my/movies` 41/38,
307. `/my/unwatched` 1478/1655 (repeats 1.5–2.4 s, server 1.33 s, 1,595 rows — the same with the old Hybriel), `/my/schedule`
308. 457/322, show 170/267. Header one row on every page (46/54–56 px). Adult page `/shows/This-Aint-Star-Trek-XXX`: "Not found"
309. signed out (slug not in the HTML) and for az5b2 (follows no adult title). Every link of all 251 list pages, `/`, 6 searches
310. (the, sex, porn, xxx, girl, love) and the person: 5,914 slugs → `tools/check-public-slugs.hl`: notAdult=5914, adult=0,
311. unknown=0. 0 console problems. Screenshots `/tmp/w056/real/{out,in}-*-{390,1280}.png` on Loreana (looked at).
312. How to repeat (ports 8730/8731; ONLY `storage/`; inner ssh with `< /dev/null`):
313. ```
314. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' < /dev/null | tar xzf - -C .scratch/realdata
315. TRACKER_PORT=8730 TRACKER_SYNC=0 TRACKER_WATCH=0 TRACKER_BACKFILL=1 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ TRACKER_URL=http://127.0.0.1:8730 ./bin/hybriel project.hl
316. # wait for 'adult backfill done' (~80 min); session file for user 0mujqspn0aqb as in ticket #8 (created/seen = now ms), id → .scratch/real-sid
317. REAL_PERSON=Jared-Harris REAL_SHOW=/shows/Foundation REAL_ADULT=This-Aint-Star-Trek-XXX node tests/realdata-056.mjs
318. # stop the server, then: TRACKER_STORAGE=… SLUGS=/tmp/w056/real/slugs.txt USER_ID=0mujqspn0aqb ./bin/hybriel tools/check-public-slugs.hl
319. # afterwards rm -rf .scratch/realdata .scratch/realdata-sessions .scratch/real-sid
320. ```
322. **Open**: (1) deploy: the live backfill (~80 min, now ~270 MB posters). (2) `/my/unwatched` 1.5–2.4 s full load at the 2 s
323. target (1,595 rows). (3) hl:fetch blocks the server during a slow TMDB answer (max step 5 s in this run). (4) Unfollowing an
324. adult title on its page turns the page into "Not found" at once (wanted: hidden for non-followers). (5) 137 TMDB-404 titles
325. stay hidden; adult people are not hidden; people are never refreshed.
327. ## 2026-10-01 — ticket #16 (mission 055, branch t16-person, worktree tracker-wt16): person pages
329. **Built**: `/person/<slug>` (`components/person.hl`, `people.hl`, route + `/profiles/:name` in `project.hl`, styles block, search.hl
330. `titleIdByTmdb`): photo, facts, short bio, filmography (poster, title, year, type, role; newest first; adult hidden). Incomplete
331. person → "Loading filmography…" and a step-by-step TMDB fill without reload (1 TMDB request + photo, then 40 titles per face
332. call), missing titles added as minimal records with TMDB's `adult`, person marked `filmographyAt`. Details: README "What it does
333. (ticket #16)".
335. **Decisions**: the fill is driven by the page (face `personFill` per step; first step from an invisible CSS-animation tick — hl:web
336. has no mount hook), so it needs no server timer and other requests are served between steps. No sign-in needed. Credits stored in
337. the migrated `person.shows` (+ `posterPath`, `adult`); migrated credits TMDB no longer lists are kept. Rows without our poster file
338. show TMDB's w92 thumb (like search's web rows) — posters of added titles otherwise come later (sync/backfill). Crew credits count
339. (role = job). New titles get this person in `cast` (other existing titles' `cast` is not touched). Bio clamped to 4 lines, click =
340. all. Hidden: `show.adult == true` OR the credit's TMDB `adult`.
342. **Real data** (copy of Byrodin `storage/` 2026-10-01 ~10:00, deleted afterwards; dev server :8777, signed out, `TRACKER_SYNC=0`,
343. real TMDB; `node tests/realdata-person.mjs`): cast click on the show page → person page shown / filled (ms), titles added, server log:
344. | person (show) | shown | filled | credits | added | rows | steps | TMDB request | other requests waited max |
345. |---|---|---|---|---|---|---|---|---|
346. | Tyler Hoechlin (Superman & Lois, 33 migrated credits) | 131 | 643 | 36 | 7 | 38 | 2 | 249 ms | 678 ms |
347. | Grant Gustin (The Flash) | 68 | 593 | 33 | 21 | 33 | 2 | 242 ms | 203 ms |
348. | Jared Harris (Foundation) | 85 | 869 | 97 | 80 | 97 | 4 | 287 ms | 220 ms |
349. | Niamh Algar (Raised by Wolves) | 76 | 584 | 39 | 20 | 40 | 2 | 250 ms | 209 ms |
350. | Eric Roberts (stress, direct load) | — | 3.8 s fill | 758 | 712 | 758 | 20 | 646 ms | 612 ms |
351. Second visit (complete, full load in Chrome): 41–120 ms at 390/1280, no loading, same rows; row → show page client-side 122–149 ms;
352. 0 console problems, no sideways scroll at 390. Screenshots `/tmp/w055/real/*.png` on Loreana (looked at).
353. How to repeat (ports 8777–8779; the fill WRITES — use a copy):
354. ```
355. mkdir -p .scratch/realdata && ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' | tar xzf - -C .scratch/realdata
356. TRACKER_PORT=8777 TRACKER_SYNC=0 TRACKER_WATCH=0 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ TRACKER_URL=http://127.0.0.1:8777 ./bin/hybriel project.hl
357. node tests/realdata-person.mjs # REAL_CASES='/shows/X:Person-Slug,…' for others; grep 'person fill' in the server log
358. # afterwards: stop the server, rm -rf .scratch/realdata .scratch/realdata-sessions
359. ```
361. **Gate** (167 → 186 checks):
362. ```
363. TRACKER_GATE_SHOTS=/tmp/w055/shots TRACKER_GATE_PORT=8770 TRACKER_GATE_IDENT_PORT=8771 TRACKER_GATE_CHROME=8772-8775 TRACKER_GATE_TMDB_PORT=8776 node tests/browser.mjs
364. 186 passed, 0 failed
365. ```
366. Screenshots `/tmp/w055/shots/person{,-complete}-{390,1280}.png` (looked at).
368. **Merge notes**: shared files touched additively — `project.hl` (1 import, `profilesDir`/`profileRoute` before the "old addresses"
369. block, 2 routes after `/search/:q?`), `search.hl` (`titleIdByTmdb` before "the query as it comes in the address"), `styles.hl` (one
370. block before `@media` + 2 lines at the end of it), `tests/faketmdb.mjs` (`persons`, `personRequests`, `personDelayMs`), `tests/seed-show.hl`
371. (Test Actor gets `tmdbId = 3002`, genre Drama `tmdbId = 18`, two persons), `tests/browser.mjs` (`gatePersons` fixture, a block
372. before "#10 THE INSTALLABLE APP"), README/STATUS. Mission 054 (`adult`): people.hl already reads `show.adult == true` and writes `adult`
373. on added titles; if 054 also filters the public lists, the gate's "Hidden Adult Film" (2012) leaves /movies — no gate check here counts it.
375. **Open**: the TMDB step blocks the server for its request (~0.25–0.65 s; hl:fetch is blocking). People are never refreshed after
376. complete (the ticket's "daily sync may refresh followed people later" — not built). Adult PEOPLE are not hidden (only titles). Added
377. titles have no poster file / seasons until synced. Signed-out header at 390 wraps "choose ident" / "Log in with ident" to two lines
378. (not from #16 — seen in the real-data shots, every page).
379. ## 2026-10-01 — mission 054: adult titles hidden from the public lists + the adult-flag backfill (NOT deployed)
381. **Built**: `shows.adult` true/false/null(unknown). Public lists (catalog.hl: homepage rows, `/movies`, `/shows`) and the
382. search (search.hl `titleOk`; "Fetch from web": `include_adult=false` + only results with `adult: false`) show ONLY
383. `adult == false` (shows.hl `isPublicTitle`) — unknown is hidden, so the first deploy is safe. `/my/*` and the show page
384. are not filtered (a followed adult title stays reachable). The daily sync, the search import and the backfill store
385. TMDB's flag. **Backfill** in the app (project.hl `backfillTick` → tmdbsync.hl `backfillTitle`): one title per step on a
386. 0.1 s clock shared with the daily sync (which wins), `GET /movie|tv/<id>?append_to_response=external_ids` + the poster
387. when missing, 260 ms pause per API request; 404 → `adultCheck='TMDB 404'` (hidden, never asked again); no answer/429/5xx
388. → retried (≤ 2 per start); resumes after a restart (queue = what is still unknown); log every 500 + done line. Env
389. `TRACKER_BACKFILL=0` off, `TRACKER_BACKFILL_LOG_EVERY`. Details: README "What it does (mission 054)".
391. **Decision / Hybriel finding**: hiding the SHOW PAGE from non-followers was built and dropped. `found = showRow != null &&
392. !adultHiddenFor(showRow, me)` (a static reaching mpackdb, reading `me`) → after any session face on the page
393. (`showToggleEpisode`) the browser re-derives `found` and then `rows`, whose `buildRows` reaches mpackdb → console
394. `'watchesOfUser' is a static of 'Watches' whose initializer reaches 'watchesTable', a name the realm 'client' … cannot bind`,
395. the click does nothing (gate: "ep3 solid" timeout). A plain copy in between (`hideAdult = hiddenAdult`) did not stop it.
396. So the show page of an adult title opens for anyone who has the link (it is in no list and no search).
398. **Gate** (167 → 184 checks):
399. ```
400. TRACKER_GATE_SHOTS=/tmp/w054/shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
401. (backfill second start: 8 titles left, 6.614 s; 285 pages asked during it, slowest 634 ms; adult backfill done: 8/8 titles, adult=0 notAdult=7 unknown=1 posters=7 ids=2 requests=8 errors=1 retries=0 seconds=6.714)
402. 184 passed, 0 failed
403. ```
404. New block (end of the gate, before the PWA part): `tests/seed-adult.hl` (app stopped) = 1 adult movie alice follows +
405. 14 unknown (fake TMDB: 1 adult, 1 404). Backfill off: none on `/`, `/movies` (2 pages), `/shows`, search; the adult one on
406. alice's `/my/movies` and its page; web search drops TMDB's adult result. Backfill on with 300 ms per fake answer: stopped
407. after 6 → restart asks only the other 8 (resume; mpackdb `update` survives SIGTERM without `persist`), pages < 1.2 s
408. meanwhile (slowest 634 ms), lists + search updated at once, poster served, 3rd start "nothing to do". All other fixtures
409. are `adult = false` (seed-show.hl); `startServer()` runs with `TRACKER_BACKFILL=0` unless a block switches it on; on a
410. throw the gate now prints the browser console + server log tail. Screenshot `adult-home-1280.png` (looked at).
412. **Real data** (copy of Byrodin `storage/` 2026-10-01 07:37, real TMDB, :8730, `TRACKER_SYNC=0`, deleted afterwards):
413. ```
414. adult backfill: start, 9453 titles without an adult flag (65 ms to find them)
415. adult backfill done: 9453/9454 titles, adult=3450 notAdult=5866 unknown=137 posters=8740 ids=6459 requests=9454 errors=140 retries=1 seconds=5935.021
416. ```
417. - 98.9 min, ~0.63 s per title. Adult 3,450 (3,448 movies, 2 series), not adult 5,866, unknown 137 (all TMDB 404 →
418. `adultCheck`), errors 140 = 137 × 404 + 2 poster 404 + 1 TLS "no answer" (retried OK). Posters: 126 → 8,866 files,
419. 459 MB (adult titles' posters included). A restart afterwards: `start, 0 titles` / `nothing to do`.
420. - Lists after: `/movies` 4,242 movies (177 pages), `/shows` 1,624 series (68 pages). EVERY slug on `/`, all 245 list
421. pages and 10 searches (the, sex, porn, slut, milf, girl, xxx, anal, teen, hot): 6,008 links → all `adult == false`
422. (0 others). TMDB-non-adult titles like "Porn King: The Rise & Fall of Ron Jeremy" (2022 doc) and "Slut." (2004) stay.
423. - Page latency DURING the run (curl every ~5 s, 1,155 samples each): `/` avg 0.156 s max 4.87 s, `/movies` avg 0.059
424. max 1.67, `/shows` avg 0.045 max 1.54, `/search/the` avg 0.075 max 1.33; 14 of 4,620 > 1 s. Cause: 13 steps > 1.5 s
425. (one 5.8 s) — all a slow TMDB/image answer (movies, no catalog work); hl:fetch blocks the one request loop.
426. - After: full load (Chrome, signed out) 390/1280: `/` 0.57 (cold)/0.09 s, `/movies` 0.07/0.04, `/shows` 0.04/0.04,
427. `/search/the` 0.46/0.08 s, 0 console problems. Screenshots `/tmp/w054/real/{home,movies,shows,search-the}{,-bottom}-{390,1280}.png`
428. on Loreana — looked at: no adult title or poster. Logs `/tmp/w054/real-backfill.log`, `real-latency.log`, `real-restart.log`.
430. How to repeat (ports 8730/8731; ONLY `storage/`; note the inner ssh needs `< /dev/null` inside `ssh loreana bash -s`):
431. ```
432. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' < /dev/null | tar xzf - -C .scratch/realdata
433. TRACKER_PORT=8730 TRACKER_SYNC=0 TRACKER_WATCH=0 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realsess/ TRACKER_URL=http://127.0.0.1:8730 ./bin/hybriel project.hl
434. # progress: grep 'adult backfill' in its log; afterwards stop it, rm -rf the copy + sessions
435. ```
437. **Open**: (1) deploy: the live app starts the backfill at once (~100 min, ~450 MB of posters into `storage/` → the
438. nightly backup); until it reaches a title the lists are emptier (all unknown at the first start). (2) A slow TMDB answer
439. blocks pages for its duration (max seen 4.9 s) — needs a non-blocking fetch in Hybriel or shorter timeouts (20 s now).
440. (3) Posters of adult titles are downloaded too (served only by their file name; could be skipped to save ~170 MB).
441. (4) The show page of an adult title is not hidden (Hybriel limit above). (5) 137 titles TMDB no longer has stay hidden.
442. (6) Seen in passing: signed out at 390 px the header buttons wrap to two lines (pre-existing).
444. ## 2026-10-01 — mission 053: #15 (TVmaze) and #14 (search) merged into main (with #13)
446. **Merges** (on main, never pushed): `git merge t15-tvmaze` → `03edc78`, then `git merge t14-search` → `dcc5eec`.
447. Branches t14-search / t15-tvmaze and worktrees tracker-wt14 / tracker-wt15 removed afterwards.
448. **Conflicts** (both sides kept): README (intro steps 13/14/15, "What it does" sections, Test block, Files rows merged),
449. STATUS (all entries, newest on top), `tests/realdata-check.mjs` (#13's page list + #15's env REAL_PORT/REAL_CHROME/
450. REAL_OUT/REAL_SHOW; REAL_SHOTS still works), `project.hl` (imports of both), `styles.hl` (both blocks),
451. `tests/browser.mjs` (fixtures: movie 1005 + TVmaze episode lists + thetvdb 4004→504; screenshot list = all pages).
452. **Behaviour fixes from combining**: (1) #13's 32 extra fixture titles were named "Gate …" and flooded #14's "gate"
453. search checks → renamed "Pager Movie NN / Pager Future Movie / Pager Undated Movie / Pager Older Series"
454. (`tests/seed-show.hl`). (2) `search.hl` `importTitle` now calls `catalog.hl` `refreshCatalogShow` → an imported title is
455. on /movies, /shows and the home rows at once (+1 gate check; the offline check's home Shows row is 4 tiles now).
457. **Gate**:
458. ```
459. TRACKER_GATE_SHOTS=/tmp/w053/shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
460. 167 passed, 0 failed
461. ```
462. **Real data** (copy of Byrodin `storage/` 2026-10-01, :8730, `az5b2`, `TRACKER_SYNC=0`, deleted afterwards; procedure =
463. ticket #8; session file `created`/`seen` = now ms): search index 0.58 s at boot. Server (curl): `/` 6 ms, `/movies` 11,
464. `/shows` 8, `/search/doctor%20who` 14, `/search/the` 56, `/my/shows` 178, `/my/unwatched` 1204, `/my/schedule` 252,
465. `/my/movies` 6 ms. Full load in Chrome (`REAL_OUT=/tmp/w053/real node tests/realdata-check.mjs` + a search timing),
466. 390 / 1280: `/` 1.32 (cold) / 0.08 s, `/movies` 0.11 / 0.04, `/shows` 0.10 / 0.09, `/search/doctor%20who` 1.04 (cold) /
467. 0.06, `/search/the` 0.12 / 0.66, `/my/shows` 1.27 / 0.26, `/my/unwatched` 1.39–2.0 / 1.37–1.39, `/my/schedule` 0.33 /
468. 0.27, show page 0.11 / 0.11 s; 0 console problems, no sideways scroll. Screenshots `/tmp/w053/real/` + gate shots
469. `/tmp/w053/shots/` on Loreana (looked at).
470. **Open**: `/my/unwatched` (1594 rows) is still the slowest page (server 1.2 s); not deployed; open points of #13/#14/#15
471. below stay (adult titles, imported titles not followed → no daily sync, …).
473. ## 2026-10-01 — ticket #14 (mission 052, branch t14-search, worktree tracker-wt14): search
475. **Built**: header magnifier → `/search` / `/search/<text>` (`components/search.hl`), `search.hl` (in-memory word-prefix
476. index over 9453 titles + 15157 people, built at boot; TMDB `search/multi`; `importTitle` = new show record + the daily
477. sync's `syncShow`). Signed out: search + web work, "Add" opens the sign-in modal. Details: README "What it does (ticket #14)".
479. **Decisions**: address `/search/<text>` instead of `/search?q=` (hl:web gives a page no query string; `/search?q=x` opens
480. the empty page). Min 2 letters. ≤ 30 titles + ≤ 10 people. One TMDB request per "Fetch from web" (button, not per
481. keystroke). Web list leaves out what we have by TMDB id + kind. Import is not auto-follow (so the daily sync won't
482. refresh it later — architect's call). Genres matched to ours by name; cast not imported. People link to `/person/<slug>`
483. (no page yet, like the show page's cast).
485. **Measured on Hybriel**: a module `static x = f()` is evaluated LAZILY (never, if nothing reads `x`) — the index is built
486. by `ensureIndex()` called from a `project.hl` member. Static hashes/lists in a module can be mutated in place
487. (`buckets[k].push(i)` works, 200k pushes 174 ms). The server percent-decodes the path BEFORE routing (`%2F` → 404, invalid
488. UTF-8 passes through raw); a client-side navigation hands the param still encoded. A record literal entry `id = …`
489. shadows a local `id` for later entries (bit me: `tmdbId = id` took the new 16-hex id).
491. **Real data** (copy of Byrodin `storage/` 2026-10-01 ~07:00, deleted afterwards; dev server :8770, az5b2, real TMDB):
492. index build 0.60 s at boot (log `search index: 9453 titles, 15157 people, 4180 keys, 612 ms`); `dbSearch` 0–1 ms for
493. "doctor who"/"star trek"/"sopranos", 38–44 ms for "the"/"th" (2000+ candidates); server render `/search/doctor%20who`
494. 9 ms, `/search/the` 56 ms; browser: per keystroke → results + address 56–76 ms (incl. CDP), `/search` cold 0.85 s / warm
495. 0.04 s; Fetch from web "pluribus" 0.12–0.23 s (real TMDB); Add "Pluribus (2025)" tv 225171 → `/shows/Pluribus` in
496. 0.77–1.1 s: Season 1 9 episodes, poster, TMDB/IMDb/TVDB/TVmaze, genres Drama + Sci-Fi & Fantasy; afterwards found in our
497. database and gone from the web list; 0 console problems. Screenshots `/tmp/w052-t14/real/*.png` on Loreana (looked at).
498. How to repeat (ports 8770–8772; ONLY `storage/` is copied):
499. ```
500. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' | tar xzf - -C .scratch/realdata
501. cp -r .scratch/realdata/storage .scratch/probe-store # the import WRITES — work on a second copy
502. TRACKER_PORT=8770 TRACKER_SYNC=0 TRACKER_WATCH=0 TRACKER_STORAGE=$PWD/.scratch/probe-store/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ TRACKER_URL=http://127.0.0.1:8770 ./bin/hybriel project.hl
503. # AFTER the server is up (it sweeps old session files at boot): session file name = sha256(<32-hex id>), JSON
504. # {"created":<now ms>,"data":{"tag":"t"},"id":"<id>","seen":<now ms>,"user":{"id":"0mujqspn0aqb"}}; the id into .scratch/real-sid
505. TRACKER_REAL_WEB=pluribus node tests/realdata-search.mjs # TRACKER_REAL_IMPORT=0: no import
506. # afterwards: stop the server, rm -rf .scratch/realdata .scratch/probe-store .scratch/realdata-sessions .scratch/real-sid
507. ```
509. **Gate** (111 → 136 checks):
510. ```
511. 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
512. (in-app run 5.413 s; 12 pages asked during it, slowest 1301 ms)
513. 136 passed, 0 failed
514. ```
515. Fake TMDB: `/3/search/multi` (→ `fake.searchRequests`, w92 thumbs → `fake.thumbRequests`, both kept out of
516. `fake.requests` so the sync checks are untouched); tv 1004 + movie 1005 importable, tv 1006 in the search but 404 (the
517. failed import = the hybriel#121/#122 check), TVmaze thetvdb 4004 → 504. Screenshots `/tmp/w052-t14/shots/search*.png`
518. (+ the existing ones; header still one row at 390 with the magnifier) — looked at.
520. **Merge notes** (#13 likely touches the same): `project.hl` (imports, one route, `searchIndexReady` before `server`),
521. `components/main.hl` (the magnifier inside `userBox`), `styles.hl` (one block before the `@media` block),
522. `tests/browser.mjs` (fixtures at the top, a signed-out block before the "#3 borders" checks, `search` in the 390/1280 page
523. list, a signed-in block before "#10 THE INSTALLABLE APP"), `tests/faketmdb.mjs`, README (intro, a section, Test, Files).
525. **Open**: no person page (`/person/<slug>` 404s, like the cast links). Imported titles aren't followed → not re-synced.
526. Web search is open to signed-out visitors (one TMDB request per click; no rate limit of ours). The field's autofocus is proven
527. on a full load only (real-data run: `focused: searchinput`); after the client-side click on the magnifier it is not checked,
528. and not on a real phone.
530. ## 2026-10-01 — ticket #15 (mission 052, worktree tracker-wt15, branch t15-tvmaze): TVmaze merge in the sync
532. **Built**: `tmdbsync.hl` `mergeTvmaze` (after the TMDB step, series with a tvmzId): `GET /shows/<tvmzId>/episodes`, by
533. S/E number: ADD missing episodes/seasons, FILL empty/placeholder titles + empty air dates; never overwrites a TMDB
534. value; TMDB's own placeholder ("Episode 4") no longer overwrites a real title; TMDB later adopts TVmaze rows by
535. number. `numberingAgrees` skips shows TVmaze numbers differently (≥ 80 % of shared S/E within 1 day or same title).
536. Details: README "What it does (step 15)". Tool line + totals: `tvmazeEpisodes tvmazeSeasons tvmazeFilled tvmazeSkipped`.
538. **Real data** (copy of Byrodin `storage/` 2026-10-01 ~07:00, deleted afterwards; procedure = ticket #8 below, server
539. on :8739, `REAL_PORT=8739 REAL_CHROME=8738 REAL_OUT=/tmp/w052-tvmaze/real REAL_SHOW=/shows/The-Lord-of-the-Rings-The-Rings-of-Power node tests/realdata-check.mjs`):
540. ```
541. run 1: shows=126 newEpisodes=0 updatedEpisodes=0 requests=255 tvmazeRequests=126 errors=0 tvmazeEpisodes=0 tvmazeFilled=21 tvmazeSkipped=7 seconds=178.9
542. run 2: updatedEpisodes=8 (Greek Salad "Épisode n" → "Episode n", after "Épisode" became a placeholder) tvmazeFilled=0 tvmazeSkipped=6 seconds=174.9
543. run 3: all 0, tvmazeSkipped=6, seconds=169.9 (idempotent)
544. ```
545. Filled: Rings of Power S3E1–8 real titles (TMDB "Episode n", airs 2026-11), Last Week Tonight 8x26–30. No episode
546. was missing on TMDB that day (tvmazeEpisodes=0) — the add path is proven by the gate only. Skipped (checked by hand,
547. correct): Daily Show (TVmaze seasons by year), Star Trek: Prodigy + Blood & Treasure (shifted numbering), Alex Rider,
548. Intergalactic, The Rising (other premiere dates + placeholder titles). Loads (390 / 1280): /my/shows 1.51 / 0.26 s,
549. /my/unwatched 1.46 / 1.41 s, /my/schedule 0.36 / 0.29 s, Rings of Power 0.13 / 0.13 s direct, 0 console problems.
550. Screenshots `/tmp/w052-tvmaze/real/*.png` on Loreana (looked at), logs `sync{1,2,3}.log`, `skipped*.txt`, `filled.txt`.
552. **Gate** (111 → 117 checks):
553. ```
554. TRACKER_GATE_SHOTS=/tmp/w052-tvmaze/shots TRACKER_GATE_PORT=8732 TRACKER_GATE_IDENT_PORT=8733 TRACKER_GATE_CHROME=8734-8737 TRACKER_GATE_TMDB_PORT=8738 node tests/browser.mjs
555. 117 passed, 0 failed
556. ```
557. Screenshots `tvmaze-{schedule,show}-{390,1280}.png` looked at.
559. **Open**: adds a new TVmaze-only episode on real data not yet seen live; the daily run takes ~70 s longer (1 TVmaze
560. request/series). Shows skipped by the numbering check get no TVmaze help (by design).
562. ## 2026-10-01 — ticket #13 (mission 050): homepage, /movies, /shows, /my/movies
564. **Built**: `/` (`components/home.hl`): signed in 4 icon tiles → `/my/unwatched` `/my/schedule` `/my/shows` `/my/movies`;
565. for everyone the text, "Movies" (→ `/movies`, 10 latest RELEASED movies) and "Shows" (→ `/shows`, 10 series by newest
566. released episode) as poster rows (phone: sideways scroll inside the row; ≥ 40rem grid of 5). `/movies`, `/shows`
567. (`components/movies.hl`, `allshows.hl` → shared `components/tilelist.hl`): all, 24 per page, pagination =
568. components.hybriel `pagination.hl` copied verbatim (4b4dabe). `/my/movies` (`components/mymovies.hl`); `/my/shows` is
569. series only now. `catalog.hl`: lists built once at start, `refreshCatalogShow` after each synced show (`project.hl`
570. `syncTick`), day roll on first read of a new day. `follows.hl` `insertByFollowDesc` (moved from myshows.hl),
571. `shows.hl` `allShows`/`allEpisodes`.
573. **Decisions**: page in the PATH (`/movies/page/2`), not `?page=2` as the mission said — a component can't read the
574. query (hybriel#11) and Back drops it (hl:web `popstate` uses `location.pathname`), so `?page` would mean full reloads +
575. Back to page 1. Pagination click → host: the copied component has no data out (hybriel#87 ruling: a passed function),
576. so a `pager-box { on click }` around it reads the button text — no edit of the copy. One page → no pagination.
577. /movies = ALL movies incl. future-dated (first) and undated (last); the homepage row only released ones. Series without
578. a released episode come after the others, by their own `release`. Home text says episodes come from TMDB (TVmaze is
579. only used for ids — the mission's "TMDB/TVmaze" would be wrong). Sign-in hint only when signed out.
581. **Real data** (copy of Byrodin `storage/` 2026-10-01 ~06:45, deleted; `az5b2`, :8730, procedure = ticket #8 below; the
582. session file needs `created`/`seen` = now in ms, `1` is swept at boot): boot → first answer 1.47 s (catalog build).
583. Server time (curl) 5–7 ms for `/`, `/movies`, `/movies/page/200`, `/shows`, `/shows/page/30`, `/my/movies`. Full load
584. in a FRESH Chrome per page (document + modules + socket + every poster in view), signed in / out:
586. | page | 390 in / out | 1280 in / out |
587. |---|---|---|
588. | `/` | 1.11 / 1.34 s | 1.13 / 1.29 s |
589. | `/movies` | 0.30 / 0.91 s | 0.57 / 0.57 s |
590. | `/movies/page/2` | 0.53 / 0.63 s | 1.31 / 0.50 s |
591. | `/shows` (24 real posters) | 1.07 / 1.36 s | 1.37 / 1.11 s |
592. | `/my/movies` | 0.80 / 0.66 s | 0.83 / 0.58 s |
594. Same Chrome (`node tests/realdata-check.mjs`): `/movies`, `/shows`, `/my/movies` 0.04–0.45 s; a page change by the
595. pagination 60–75 ms (client-side); Back works; no sideways scroll; 0 console problems. `refreshCatalogShow` for all
596. 126 followed shows: 0.31 s (SNL 23 ms). Screenshots `/tmp/w050/real/*-{390,1280}.png` (looked at). Not mine but seen:
597. `/my/unwatched` 1.47–1.64 s (1594 rows), `/my/shows` 1.25 s cold at 390.
599. **Gate** (111 → 135 checks):
600. ```
601. TRACKER_GATE_SHOTS=/tmp/w050/shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
602. (in-app run 5.415 s; 11 pages asked during it, slowest 1433 ms)
603. 135 passed, 0 failed
604. ```
605. **Session-sync double rows** (team lead: since hybriel 64527baa every face taking `session` also syncs the members derived
606. from session; a handler that ALSO appends the returned row shows it twice): checked — no tracker handler appends, every
607. one assigns the whole list (`rows = r.rows`) or a flag; the new #13 pages have no faces. 4 gate checks "row appears
608. once" (exact count + unique button values, 400 ms after the face for a late sync): /my/unwatched click, show page
609. expand, episode click, Follow toggles.
610. Changed existing checks: the three "page stays empty" (now home content), the in-app run expects `newEpisodes=2` (the
611. fake TMDB adds a released episode to show 2 too, to prove the in-process re-sort). Screenshots `/tmp/w050/shots/`
612. (home, movies, movies-page-2, shows-list, my-movies at 390/1280 — looked at).
614. **Open**: (1) **adult titles** — the migrated movie table has many porn titles (e.g. on /movies page 1 and 4); they
615. are on the public homepage and /movies. No `adult` flag stored; the creator/architect decides (filter via TMDB `adult`,
616. hide unfollowed movies, …). (2) Movie posters: only followed shows/movies have real posters → nearly every movie tile is
617. the placeholder until the sync covers more. (3) If `?page=N` links are wanted anyway, that needs hybriel#11's query
618. half. (4) Real-phone check after deploy.
620. ## 2026-10-01 — ticket #12 (mission 049): link icons to TMDB, IMDb, TheTVDB, TVmaze
622. **Built**: show page header badges `TMDB` `IMDb` `TVDB` `TVmaze` (`components/show.hl` `linkRows`, `shows.hl`
623. `externalLinksOf`, `styles.hl` `showLinks`/`a.extlink`: CSS-only monochrome badges, accent on hover), only for ids the
624. show has, `target=_blank rel=noopener`; a movie: TMDB (`/movie/<id>`) + IMDb. Phone: between title row and poster;
625. desktop: under the title. Sync (`tmdbsync.hl`): details request now `?append_to_response=external_ids` (no extra
626. request) → fills a MISSING imdbId/tvdbId; still no tvmzId → TVmaze `lookup/shows?imdb=`, on 404 `?thetvdb=` (550 ms
627. pause each, `pauseMsAfter` in both runners); never overwrites. Totals: `ids=`, `tvmazeRequests=`. New
628. `tools/count-external-ids.hl` (copy only).
630. **Bug found + fixed**: movies (`type = 'movie'`, 7814 rows, 1 followed: Star Trek: First Contact, tmdbId 199) were
631. synced as `/tv/199` — another title. Now `/movie/<id>?append_to_response=external_ids`: imdbId + poster only.
632. **Live data still carries the damage**: that record has `status = 'Ended'` and `tmdbSummary` = the overview of TV
633. show 199 ("Kabuhayang Swak na Swak…") — not visible (the page shows `summary`), the new sync leaves both alone; a
634. one-off fix (set `tmdbSummary = null`, `status` back) is the architect's call.
636. **Decisions**: TheTVDB link = `https://thetvdb.com/dereferrer/series/<id>` (it and `?tab=series&id=` both 301 to the
637. slug page, checked 2026-10-01); IMDb `/title/<tt>/`; TVmaze `www.tvmaze.com/shows/<id>`. Badges with text, not
638. drawn pictograms (no logos copied; legible at 0.75rem). An imdb id is only taken as `tt`+digits, a tvdb/TVmaze id
639. only as a number > 0. A show TVmaze doesn't know is asked again each daily run (2 lookups/day on real data).
641. **Real data** (copy of Byrodin `storage/` 2026-10-01 ~06:20, deleted afterwards; `tools/count-external-ids.hl`):
643. | | shows | tmdbId | imdbId | tvdbId | tvmzId |
644. |---|---|---|---|---|---|
645. | followed series, before → after 1 sync | 125 | 125 | 125 | 125 | 123 → **124** |
646. | followed movie | 1 | 1 | 1 | – | – |
647. | all series (only followed are synced) | 1639 | 1639 | 907 | 910 | 845 → 846 |
648. | all movies | 7814 | 7814 | 379 | – | – |
650. Sync: `shows=126 newSeasons=0 newEpisodes=0 updatedEpisodes=0 updatedSeasons=0 posters=1 ids=1 requests=256
651. tvmazeRequests=4 errors=0 seconds=105.6` (poster = the movie's real one; id = Greek Salad tvmz 60613; Mapping the
652. World: TVmaze knows neither tt0395050 nor tvdb 109331). TMDB's external ids match ALL 125 stored imdb/tvdb ids (0
653. differ). Show pages (az5b2, :8730): Librarians 1.08 s cold / 0.13 s, Greek Salad 0.18 s, Star Trek: First Contact
654. 0.13 s (TMDB movie/199 + IMDb, real poster now); no sideways scroll, 0 console problems. Screenshots
655. `/tmp/w049/real/*-{390,1280}.png` (looked at). Procedure = ticket #8 below (sync tool with `.env` sourced).
657. **Gate** (101 → 111 checks):
658. ```
659. TRACKER_GATE_SHOTS=/tmp/w049/shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
660. (in-app run 5.416 s; 12 pages asked during it, slowest 1323 ms)
661. 111 passed, 0 failed
662. ```
663. Fixture: show 1 imdb `tt0000001` only (TMDB says tt9999999 + tvdb 4001), show 2 tvdb `4002` only (TMDB: tt0000002 +
664. 4999), movie `gate-test-movie` (tmdb 1003, followed by a 2nd user so alice's lists are unchanged → the sync now has
665. 3 shows). Fake TVmaze: imdb tt0000001 → 501, thetvdb 4002 → 502. Screenshots `/tmp/w049/shots/` (show-*, synced-show
666. {,-390}, synced-movie{,-390} looked at). The new-tab check closes the tab at once (it would load the real site).
668. **Open**: real-phone tap test after deploy (new tab). Star Trek: First Contact's wrong `tmdbSummary`/`status`
669. (above). Unfollowed shows never get ids filled (sync covers followed only, by design).
671. ## 2026-10-01 — mission 047: re-vendor Hybriel (invisible checks), mobile first, show page additions
673. **Bug** (live, the creator: "i dont see the check marks"): after a CLIENT-SIDE navigation (and after expand/collapse
674. or a check click) the check `<svg>` was built in the XHTML namespace (circle width 0). Fixed by **re-vendoring Hybriel
675. master ff51cf46** (bin sha256 `55a724a0…c5`, README "Vendored Hybriel"; old bin/plugins in `.scratch/pre-047/`).
676. Proof the new check fails on the old build: `/tmp/w047/old-build-gate.log` (`ns: http://www.w3.org/1999/xhtml,
677. circleWidth: 0`), passes on the new one.
679. **Built**: `styles.hl` mobile first (phone base rules, one `@media (min-width: 40rem)` block; header one row at
680. 390 px; /my/unwatched + /my/schedule rows two-line on a phone). Show page: phone order title (+ Follow) → full-width
681. poster → genres/plot/cast (desktop unchanged); season caret (down/right); episodes not indented; artists orange
682. `#ce9178`; unwatched check = accent outline circle + accent check; **Follow toggle** (face `showToggleFollow`,
683. `follows.hl` `isFollowing`/`setFollowed`: new record `at = now`, unfollow deletes); signed out checks + Follow visible,
684. a click opens the sign-in modal (`components/modal.hl`, copied verbatim from components.hybriel becbd59), nothing sent.
685. Session-sync workaround in show/myshows/unwatched/schedule: `rows` reads `me` (a plain copy of `userId`), and
686. `following` goes through a LOCAL static `followingOf` — an imported mpackdb helper called directly in a member
687. initializer came back false after a client-side navigation (gate caught it; not reduced to a minimal repro yet).
689. **Duplicate @ids** (hybriel#113) on a copy of live storage (2026-10-01 04:13), `tools/count-duplicate-ids.hl` + the
690. `*.id.txt` indexes: **0 in every table** (episodes 232384, follows 128, genres 27, persons 15157, seasons 6450, shows
691. 9453, users 1, watches 11663 rows).
693. **Real data** (copy, `az5b2`, :8730, `node tests/realdata-check.mjs`, full load incl. socket + posters):
695. | page | 390 px | 1280 px |
696. |---|---|---|
697. | `/my/shows` (128) | 1.29 s (cold posters) | 0.24 s |
698. | `/my/unwatched` (1594) | 1.51 s | 1.46 s |
699. | `/my/schedule` (54) | 0.35 s | 0.32 s |
700. | `/shows/The-Librarians-The-Next-Chapter` direct / client-side | 0.14 / 0.19 s | 0.13 / 0.18 s |
702. Client-side nav, expand, collapse: 14/26/14 checks, 0 wrong namespace, 0 undrawn; header 46 px at 390, no sideways
703. scroll. Screenshots `/tmp/w047/real/*.png` (looked at). Procedure = ticket #8 below; the session id goes in
704. `.scratch/real-sid` (the script reads it); copy + sessions deleted afterwards.
706. **Gate** (76 → 101 checks):
707. ```
708. TRACKER_GATE_SHOTS=/tmp/w047/shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
709. 101 passed, 0 failed
710. ```
711. Screenshots `/tmp/w047/shots/` ({home,show,my-*}-{390,1280}.png, signed-out-modal-1280.png) — looked at.
712. Gate note: the follow test re-follows show 1, so the sync's request order between the two shows may flip (the check
713. accepts both orders) and `/my/shows` after the sync has show 1 on top.
715. **Open**: the phone poster at full width is tall (2:3 → ~550 px on a 390 phone) — as asked, the creator may want a cap.
716. The unwatched (outline + check) and watched (filled) icons differ only by fill — as asked. No navigation links to
717. the `/my/` pages yet. Real-phone check after deploy.
719. ## 2026-10-01 — ticket #10: installable app (PWA) + icons
721. **Built**: `icons/` (`icon.svg` source → `icon-192.png`, `icon-512.png`, `apple-touch-icon.png` 180; `favicon.svg`,
722. `favicon.ico` 16/32/48 — rsvg-convert + magick, commands in README "What it does (step 10)"); `project.hl`:
723. `appIcons` (192/512 × any/maskable, like calendar), `appTouchIcon`, `appFavicon`, `appThemeColor = darker.value`,
724. `appBackgroundColor = dark.value` (tokens), `offline = [ Home ]`, file routes for the icons, `/favicon.ico` now a
725. real file (was `direct = ""`); `components/main.hl` offline note + `netProbe` tick; `styles.hl` `offlineNote`,
726. `netProbe`, `@keyframes tracker-net-tick`; gate +12 checks.
728. **Decisions**: icon = a TV (antennas) with a check mark on the screen = "watched shows", green `#4ec9b0` on
729. rgb(25,30,35), all inside the maskable safe zone so one PNG serves any + maskable. Theme colour = `darker` (the header
730. bar, so the phone's status bar blends in), background = `dark`. Offline keeps only the shell/`/`; data pages get
731. hl:web's "Unavailable offline". The offline note is driven by `navigator.onLine`, read on a 1 s CSS-animation tick
732. (`animationiteration`) — hl:web has no connection-state member and no mount hook (reported as a Hybriel gap).
734. **Gate** (64 → 76 checks):
735. ```
736. TRACKER_GATE_SHOTS=/tmp/w045/shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
737. 76 passed, 0 failed
738. ```
739. Looked at: `/tmp/w045/icon-48.png`, `icon-192.png`, `icon-512.png`, `maskable-circle.png`, `small-on-white.png`
740. (favicon 16/32/48), `/tmp/w045/shots/pwa-phone-{online,offline}.png` (390 px) on Loreana.
741. Test gotcha: CDP `setOffline` only cuts the TAB — the service worker's own fetches still reach the server, so the
742. gate also stops the server before the offline reload.
744. **Open**: offline, the header's `<ident-selector>` (script from ident's origin, not cached) shows "choose ident"
745. next to "Log out". No note when the device is online but the server is down. Real-phone install test (ticket's
746. **Test**) after deploy: open https://tracker.worldapi.org → "Add to home screen".
748. ## 2026-10-01 — ticket #9: TMDB sync (new episodes + posters)
750. **Built**: `tmdbsync.hl` (`syncShow`: details + ≤ 20 seasons per request via `append_to_response`, add/update
751. seasons+episodes, poster w342), `tools/sync-tmdb.hl` (`--limit N`, paced, prints counts), the daily run in
752. `project.hl` (`syncTick` on an hl:time `every(1)` clock: at `TRACKER_SYNC_HOUR` UTC (4), once a day, ONE show
753. per tick, next show after n × 260 ms), `follows.hl` `allFollowedShowIds`, fake TMDB `tests/faketmdb.mjs`,
754. fixture shows got tmdbIds 1001/1002. Details: README "What it does (step 9)".
756. **Decisions**: match episode by tmdbId, else by S/E when the local one has no tmdbId (161 migrated); season by
757. number. Empty TMDB values never overwrite. Season 0 only if the show already has one (else specials flood
758. /my/unwatched); empty TMDB seasons not created. Own 16-hex ids for new rows (hybriel#113). Posters in
759. `storage/mpackdb/posters/` (the folder the existing `/posters/:name` route reads — inside `storage/`, so in the
760. backup) rather than a new `storage/posters/`. Shows synced = all followed (also Ended ones — updates happen).
761. Sync is off without `TMDB_READ_TOKEN` or with `TRACKER_SYNC=0`.
763. **Blocking**: `fetch()` blocks the whole hl:web process (measured: requests wait for the running step) — so the
764. run is cut into one-show steps. Real data: ~0.7 s per step average, SNL (53 seasons, 4 requests) 1.7 s; persist
765. of the 3 tables 36 ms.
767. **Real-data proof** (copy of Byrodin's `storage/` in `.scratch/realdata/`, deleted afterwards; procedure as
768. ticket #8 below; session file needs `created`/`seen` = now in ms, else the boot sweep deletes it):
769. ```
770. set -a; . ./.env; set +a
771. TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb ./bin/hybriel tools/sync-tmdb.hl --limit 128
772. tmdb sync done: shows=126 newSeasons=20 newEpisodes=800 updatedEpisodes=2651 updatedSeasons=174 posters=125 requests=380 errors=0 seconds=185.718
773. (again) shows=126 newSeasons=0 newEpisodes=0 updatedEpisodes=0 updatedSeasons=0 posters=0 requests=255 errors=0 seconds=89.888
774. ```
775. Fresh-process recount: seasons 6430 → 6450, episodes 231584 → 232384 (exactly +20/+800, no row loss), 0
776. dangling season/episode refs, 0 duplicate season numbers; 12 duplicate tmdbIds + 1 wrong parent were already in
777. the migrated data (same before/after). 126 shows (128 follows), 125 posters (one show has none on TMDB).
778. In-app daily run on the copy (TRACKER_SYNC_HOUR = current hour, real TMDB): 126 shows, 255 requests, 136 s,
779. 0 errors; `/my/shows` (signed in) polled every 0.5 s meanwhile: 181 answers, avg 0.25 s, max 4.0 s (one), then
780. 1.8/1.7/1.4 s. Full page loads after the sync (headless Chrome, load + socket + all images):
782. | page | full load | rows |
783. |---|---|---|
784. | `/my/schedule` | 0.7–0.8 s | 55 (was 0) |
785. | `/my/shows` | 1.3–1.55 s (128 real posters now, 1 placeholder) | 128 |
786. | `/my/unwatched` | 1.5 s (server 1.3 s) | 1593 (was 831) |
787. | `/shows/The-Librarians-The-Next-Chapter` | 0.33 s | poster + new S2 (12 eps) |
789. Screenshots + logs: `/tmp/w044-real/` on Loreana (`after-*.png`, `real-sync{1,2}.log`, `real-lat.txt`).
791. **Gate** (49 → 64 checks):
792. ```
793. TRACKER_GATE_SHOTS=/tmp/w044-shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 TRACKER_GATE_TMDB_PORT=8727 node tests/browser.mjs
794. (in-app run 4.405 s; 10 pages asked during it, slowest 1371 ms)
795. 64 passed, 0 failed
796. ```
797. Screenshots `/tmp/w044-shots/` (`synced-*.png` looked at: posters, S3, schedule rows fine).
799. **Deploy (architect)**: `TMDB_READ_TOKEN` must be in Byrodin's `.env` (env_file) — without it the log says
800. `tmdb sync: off (no TMDB_READ_TOKEN)`. First daily run 04:00 UTC after deploy; check `docker logs
801. tracker.worldapi.org | grep tmdb`. Or stop the container and run the tool once for an immediate catch-up.
803. **Open**: a step blocks requests up to ~2 s (a non-blocking `fetchStart` + `done()` state machine would fix it).
804. `/my/unwatched` render grew with the rows (1.3 s server, 1593 rows) — watch it against the 2 s target. A season
805. watch record stays solid when the sync adds a new episode to that season (existing season-watch semantics).
806. Dev servers get the real token from `.env` automatically → start them with `TRACKER_SYNC=0`. Shows nobody
807. follows are never synced (by design).
809. ## 2026-09-30 — ticket #8: /my/ pages, S01E01, years, speed
811. **Built**: `/my/unwatched`, `/my/schedule` (routes in `project.hl`); old `/unwatched`, `/schedule` →
812. **301** (function routes `unwatchedMoved`/`scheduleMoved`). Rows as `S01E02 · <title>` (was
813. `Ep 2 · …`), list titles with the year `Doctor Who (2005)`, show page `1 episode` singular.
814. New shared helpers in `shows.hl`: `pad2`, `episodeCode`, `showYear`, `titleWithYear`,
815. `posterUrlOf`; in `watches.hl`: `watchedSet` (used by `/my/unwatched` and the show page's
816. `buildRows`; `isWatched` stays for the single-target toggles).
818. **Decisions**: year = `year`, else `release.slice(0,4)`, else none (197 shows lack `year`, some
819. have `release = ''`). Year only in LISTS (`/my/*`), not in the show page's `h1`. The 301 drops any
820. query (the pages take none). A row whose poster FILE is missing gets `/posters/none` (one cached
821. URL) instead of `/posters/<oldId>.jpg`.
823. **Why /my/shows was ~25 s live though its data is 0.2 s**: hl:web handles ONE request at a time.
824. Measured on the copy: `/my/shows` requested 1 s into a `/unwatched` render took 13.7 s (the
825. `/unwatched` render itself 14.5 s). Every request (pages, 128 poster requests) of every visitor
826. queued behind a slow `/unwatched`. Plus 128 distinct poster URLs per load, all the placeholder.
828. **Real-data check** (copy of Byrodin's `storage/` only, `az5b2` = user `0mujqspn0aqb`, dev
829. server :8730, headless Chrome, navigate → load → websocket open, 1280×900):
831. | page | before | after |
832. |---|---|---|
833. | `/my/shows` (128 rows) | 1.2 s (server 0.19 s) | 0.6–0.8 s, 1 poster request |
834. | `/unwatched` → `/my/unwatched` (831 rows) | 14.8 s | 0.7–1.2 s (server 0.55–0.65 s) |
835. | `/schedule` → `/my/schedule` (0 rows, data not synced since 2025-12) | 0.36 s | 0.3 s |
836. | `/shows/The-Librarians-The-Next-Chapter` | 0.34 s | 0.29 s |
838. How to repeat (Loreana; never touch Byrodin's folder beyond the tar read):
839. ```
840. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' | tar xzf - -C .scratch/realdata # ONLY storage/
841. TRACKER_PORT=8730 TRACKER_WATCH=0 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ ./bin/hybriel project.hl
842. # session file: name = sha256(<32-hex id>), JSON {"created":1,"data":{"tag":"t"},"id":"<id>","seen":1,"user":{"id":"0mujqspn0aqb"}}
843. curl -s -o /dev/null -w '%{time_total}\n' -b trackersid=<id> http://127.0.0.1:8730/my/unwatched
844. # Chrome: tests/cdp.mjs launchBrowser, Network.setCookie trackersid, goto + wait __hl.socket open
845. # afterwards: stop the server, rm -rf .scratch/realdata .scratch/realdata-sessions
846. ```
847. Screenshots: `/tmp/w041-real/{before,after}-{shows,unwatched,schedule,show}.png` (Loreana).
849. **Gate** (45 → 49 checks: two 301s, the browser landing on `/my/unwatched`, "1 episode"; the
850. existing ones now expect `/my/…`, `S01E02 · Second`, `S02E01 · Season Two Opener`, titles with
851. year, `/posters/sh1.png` + `/posters/none`). Fixture: show 1 `image = 'png'` (gate writes a 1×1
852. `posters/sh1.png`), show 2 `year = null`, `release = '2025-03-01'`.
853. ```
854. TRACKER_GATE_SHOTS=/tmp/w041-shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 node tests/browser.mjs
855. 49 passed, 0 failed
856. ```
857. Screenshots `/tmp/w041-shots/` (looked at: all fine).
859. **Open**: `/my/unwatched` rebuilds all rows per check click (~0.6 s, fine). Still no navigation
860. to the `/my/` pages. The single-request server means any future slow page blocks everyone —
861. keep every page well under 1 s. `/my/schedule` stays empty until the TMDB sync step.
863. ## 2026-09-30 — ticket #7: /my/shows
865. Built `/my/shows` (`components/myshows.hl`, route in `project.hl`, styles in `styles.hl`): every
866. followed show, newest follow (`follows.at`, epoch ms) first — small poster (2.5rem, `/posters/…` +
867. placeholder like the show page), title → `/shows/<slug>`, last watched episode `SxxEyy`.
869. **Decisions**: "last episode" = highest (season, episode) among the user's EPISODE watches of that
870. show (ticket); a season watch alone doesn't count (the season check watches every episode anyway).
871. No watch → no episode element. A show without a poster name → `/posters/none` (the route's own
872. placeholder), so every row has a poster. Read-only page, no face (like `/schedule`).
874. **Reuse**: new `follows.hl` `followsOfUser` (whole records; `followedShowIds` now builds on it) and
875. `shows.hl` `episodeById` (one line); `showById`, `posterName`, `watchesOfUser` unchanged.
877. **Performance** (against a COPY of `storage/mpackdb/` in `.scratch/perf-store`, removed after; live
878. files md5-verified unchanged): the page touches only the user's follows and episode watches
879. (one fetch per watch), never all episodes of a followed show — az5b2's 128 follows → 128 rows (123
880. with an episode, e.g. `S36E11`, `S30E91`) built in **160–255 ms**. For comparison **`/unwatched`
881. takes ~15 s** on the same copy (805 rows): it fetches every episode of every followed show and
882. checks each against the user's 11,692 watches with a linear `isWatched` — not in this ticket's
883. scope, flagged below.
885. **Gate** (`tests/browser.mjs`, 38 → 45 checks; `tests/seed-show.hl` adds a 2nd show "Unwatched Gate
886. Show", no seasons/poster name, followed AFTER the first but stored after it; the first follow is now
887. dated a day back): signed out → sign-in message; signed in → newest follow first, title hrefs,
888. posters loaded (`naturalWidth > 0`), 40px wide, `S01E02` after /unwatched's click, later `S02E01`
889. (watched BEFORE season 1's bulk watch → proves highest, not most recent), none for the other show.
891. ```
892. TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 node tests/browser.mjs
893. 45 passed, 0 failed
894. ```
896. **Open**: `/unwatched` ~15 s on real data (above) — a watched-id map instead of `isWatched` per
897. episode would fix it (own ticket). No navigation links to `/my/shows` yet (homepage stays empty).
899. ## 2026-09-27 — ticket #6: /schedule
901. Built `/schedule` (`components/schedule.hl`): every episode of a show the signed-in user follows
902. that is NOT yet released (`e.release > today`), soonest first. Creator: "/schedule has a similar
903. list without check icons for the upcoming episodes of shows followed" — same row shape as
904. `/unwatched` (`components/unwatched.hl`) minus the check icon.
906. **Reuse, not copy**: imports the exact same `followedShowIds` (`follows.hl`), `showById` /
907. `seasonsOfShow` / `episodesOfSeason` (`shows.hl`) that `/unwatched` already uses — nothing new
908. added to either file. `watches.hl` is not imported at all: a row here is never watched/unwatched,
909. there is no check icon and no click, so the page needed no per-user watch state and no `on server`
910. face — the whole component is a single read-only server-side render (`rows` computed once from
911. `session`, same as every other reactive member here).
913. **Order**: soonest first, ascending by `release` (a plain `'YYYY-MM-DD'` string, ordering
914. operators confirmed working against this app's own vendored `bin/hybriel`, same as `/unwatched`'s
915. STATUS entry) — the ticket named this the architect's own reading ("the creator named the order
916. only for /unwatched"), so `insertByReleaseAsc` mirrors `/unwatched`'s `insertByReleaseDesc` with
917. the comparison flipped.
919. **`decided`**: "upcoming" = `release` strictly after today (not `>=`) — the natural complement of
920. `/unwatched`'s own `release <= today`, so every released-or-today episode is unambiguously on one
921. list, never both, never neither.
923. **Gate** (`tests/browser.mjs`, 35 → 38 checks): reused the same fixture (`tests/seed-show.hl`,
924. unchanged) — episode 3 already carried a far-future release (`2099-01-01`) for `/unwatched`'s own
925. "excludes the future one" check; `/schedule` now proves the mirror image with the same fixture:
926. signed out, no rows, the sign-in message; signed in, only that one future episode shows (the two
927. already-released ones excluded), no `button.checkicon` anywhere on the page, unaffected by any of
928. the watch toggles the other checks perform on the same fixture (run in any order — `/schedule`
929. never reads watch state).
931. ```
932. node tests/browser.mjs
933. 38 passed, 0 failed
934. ps -eo pid,args | grep [h]l-browser-tier
935. (nothing)
936. ```
938. Updated `README.md` ("What it does (step 6)", Test, Files) and this file.
940. **Open**: nothing shown on the homepage still points to `/schedule` (same as `/unwatched` before
941. it — the homepage stays empty per ticket #1's decision).
943. ## 2026-09-27 — ticket #5: /unwatched
945. Built `/unwatched`: every episode of a show the signed-in user follows that is already released
946. (`release` ≤ today, a plain `'YYYY-MM-DD'` string — migrated as-is by `tools/migrate.hl`, never
947. run through `dateOf`) and not yet watched, newest release first (creator: "/unwatched lists all
948. unwatched episodes of shows followed in release date desc order").
950. **Reuse, not copy** (the ticket's own instruction, re "the same check icon and watch logic as the
951. show page"): `watchClassOf` (watched → `'checkicon solid'`/`'checkicon regular'`) was a private
952. `static` in `components/show.hl`; moved it to `watches.hl` so both pages import the SAME
953. definition instead of each declaring their own — `show.hl` now imports it too, nothing duplicated.
954. `isWatched`/`setWatched` (already in `watches.hl`) needed no change. New `follows.hl`
955. (`followedShowIds`) and `shows.hl` `showById` (one line) round out the read-only data access this
956. page and `/schedule` (ticket #6) both need.
958. **String comparison** (`e.release <= today`, `row.release >= x.release` for the desc sort):
959. hybriel#2 ("no ordering operators on strings") is filed as still-open in this ticket's brief, but
960. its own history shows it was fixed and merged to master 2026-09-25 — confirmed directly against
961. THIS app's own vendored `bin/hybriel` (`'2020-09-03' <= '2026-09-27'` → `true`), so no numeric
962. date workaround was needed.
964. **A View text node cannot hold an inline expression** (`"Ep " + row.episodeNumber + " · " +
965. row.title` inside a tag body) — same rule as View attributes (components/show.hl's own comment:
966. "a View attribute must be a literal, a member or a field path"), just not documented for text
967. nodes anywhere yet; it silently rendered `<!-- binary_expression not rendered yet -->` instead of
968. erroring. Fixed by resolving the label into a plain field (`row.episodeLabel`) once, server-side,
969. in `unwatchedRowsOf` — the same pattern `show.hl`'s `buildRows` already uses for every other
970. ternary/concatenation. Not filed as a new Hybriel gap since it's the exact same restriction
971. already known and worked around elsewhere in this app, just not yet hit for interpolated text.
973. **Empty state**: signed out (no user, so no follows to show) and signed in with nothing unwatched
974. both render a message; used `.muted` (colorTextMuted), not `.message` (colorDanger) — the existing
975. `.message` class is for real errors (the login-failed banner), and an empty list isn't one (a
976. `decided`, small).
978. **Gate** (`tests/browser.mjs`, 29 → 35 checks): `tests/seed-show.hl` now takes an optional
979. `TRACKER_SEED_IDENTITY` and, when given, seeds a fixed user + a follow of the fixture show for it
980. — the only way to give `/unwatched` a known followed show before the browser ever signs in, since
981. the real login's `ensureUser` matches an EXISTING `users.db` row by `identity` and reuses its id
982. rather than minting a new one. The gate learns alice's per-app identity with one throwaway
983. `ident.exchange` call (consuming one code) before writing the seed. Episode 1/2 of the fixture now
984. carry a past `release` (`2020-01-01`/`2020-06-15`), episode 3 a far-future one (`2099-01-01`) —
985. proving both the release-date filter and the desc order. The new checks run signed out (no rows,
986. the sign-in message), then signed in RIGHT AFTER LOGIN, BEFORE the existing show-page checks that
987. toggle these same fixture episodes watched (order matters — otherwise `/unwatched` would already
988. be empty by the time it's tested): both unwatched episodes list newest-first, excluding the
989. future one; a click on the newest (`Second`, ep 2) removes it from the list; a reload proves the
990. watch is server-side, leaving only `Pilot` (ep 1).
992. ```
993. node tests/browser.mjs
994. 35 passed, 0 failed
995. ps -eo pid,args | grep [h]l-browser-tier
996. (nothing)
997. ```
999. Updated `README.md` ("What it does (step 5)", Test, Files) and this file.
1001. **Open**: nothing shown on the homepage still points to `/unwatched` — no navigation exists yet
1002. (the homepage stays empty per ticket #1's decision; a later step, from the creator, presumably
1003. adds it). `/schedule` (ticket #6) is next and reuses `follows.hl`/`shows.hl`/`watches.hl` the same
1004. way.
1006. ## 2026-09-27 — ticket #4: the show page, watch checks (took over a previous half-done session)
1008. Continued from an earlier session that had built the whole page — header, seasons/episodes,
1009. the click-handling redesign to a flat `rows` list rebuilt server-side (`components/show.hl`'s
1010. own header comment explains why: a nested `for` over seasons > episodes risks hybriel#86) — but
1011. left with the gate red: clicking a check never turned it solid, no console error, and the
1012. session ran out of budget before finding why.
1014. **The actual bug**: the show page's own pure helpers (`buildRows`, `genreRowsOf`, `castRowsOf`,
1015. `watchClassOf`, `initialCollapsed`) were plain instance members (`buildRows = (show, …) => {…}`,
1016. no `static`). That shape works fine as a member's own top-level initializer (`rows = found ?
1017. buildRows(showRow, watchRows, collapsed) : []` — this is how the page renders correctly on first
1018. load) but throws when the SAME function is called from inside an `on server` face
1019. (`showToggleEpisode` etc.): the server log showed `'buildRows' is not callable — it holds null`.
1020. Found by running `.scratch/debug-click.mjs` (left by the previous session) with the server's
1021. stdout/stderr captured — the browser console itself stayed silent (the face's error never
1022. reaches the client at all, a separate Hybriel gap, hybriel#92 already covers that half).
1024. Confirmed the fix by grepping other worldapi apps for the same shape:
1025. `calendar.worldapi.org/components/calendar.hl` has `static soonOf = (u) => { … upcoming(u, …) }`
1026. (an mpackdb-backed helper), called from its `on server calLoad`/`calSettingsLoad` faces, and
1027. calendar's own gate is green — so `static` is the proven-safe shape for a component's own helper
1028. that both (a) touches an mpackdb-backed import and (b) needs calling from more than one place
1029. (its own initializer AND a later face). Declared all five helpers in `show.hl` `static`; reran
1030. the gate: 29/29 green, including the season-bulk-toggle and the reload-proves-server-side checks.
1032. Filed **hybriel#115 was already open** (from the previous session, about the CLIENT bundle
1033. omitting a case for such a helper) but this session's finding is the SAME root cause reaching
1034. further than that ticket says: the plain HL interpreter on the SERVER also treats such a helper
1035. as `null` outside its own initializer, not just the JS-compiled client bundle. Left as one
1036. `issues` entry pointing at hybriel#115 rather than opening a near-duplicate ticket — the
1037. repro/observed there already generalizes (a per-instance member function wrapping an
1038. mpackdb-backed import is unreliable wherever it is called from, not just the browser).
1040. Ran `node tests/browser.mjs`: 29 passed, 0 failed (was 20 passed / 1 failed — the click timeout
1041. — before the `static` fix).
1043. **Rehearsed `tools/relink-episode-seasons.hl` against a full COPY** of the real
1044. `storage/mpackdb/` (`.scratch/relink-rehearsal/`, since removed) — the tool's own header claimed
1045. this rehearsal already existed here; it didn't (a leftover claim from the previous session), so
1046. this session actually ran it:
1048. ```
1049. relink: episodes 231584, null season before 36194, linked 36194, still null (no matching season) 0
1050. relink: episodes.db replaced with the relinked file — re-run to confirm idempotency (0 linked the second time)
1051. ```
1053. Ran a second time on the same copy straight after — idempotency confirmed:
1055. ```
1056. relink: episodes 231584, null season before 0, linked 0, still null (no matching season) 0
1057. ```
1059. All 36,194 pre-existing null-season episodes (ticket #2's count) now link to a real season by
1060. `(show, seasonNumber)`; none left over. Not run against the LIVE `storage/mpackdb/` — that needs
1061. the tracker container stopped first (hl:mpackdb does not coordinate two processes on one storage
1062. directory, hybriel#21), the architect's job per the ticket ("the architect runs it live").
1063. Updated README.md ("What it does (step 4)", Test, Files) and this file.
1065. ## 2026-09-27 — ticket #2: old data migrated (took over a previous session's rewritten tool)
1067. Continued from an earlier session that had rewritten `tools/migrate.hl` to avoid a real data-loss
1068. bug (see below) but never run it even once, and had left the real `storage/mpackdb/` holding data
1069. from the OLDER, buggy two-pass version of the tool (put a bare record, then `update()` it once the
1070. other side of a circular reference existed). Took over: moved that buggy data aside
1071. (`.scratch/pre-migrate-buggy-backup`, since removed), kept `storage/mpackdb/users.db` (step 1's
1072. login table, untouched by the migration), and ran the already-fixed tool for the first time.
1074. **The fix already on disk (kept as is):** `Show.seasons`/`Season.show` and `Show.cast`/
1075. `Person.shows` are two-way references, so the id on one side must exist before the record on the
1076. other side can be built. The old approach — `put()` a bare record, come back with `update()` once
1077. the far side's id exists — loses rows: reopening a table in a fresh process after an `update()` had
1078. touched it read back FEWER rows than were ever `put()` (seen directly: `persons.db`'s `count()`
1079. dropped 15157 → 15152 after one round of `update()` — a real `hl:mpackdb` bug, reported to Hybriel,
1080. not something an app is allowed to patch around). The fix assigns every new id itself (8 random
1081. bytes, `hl:crypto`) in one pass over each export file BEFORE building any record, so by the time a
1082. record is actually built every reference is already a known id — one `put()` per row, `update()`
1083. never called.
1085. **Run** (`tools/migrate.hl`, `TRACKER_OLD_DATA=.../old-tracker/mongo-export`,
1086. `TRACKER_STORAGE=$PWD/storage/mpackdb`):
1088. ```
1089. migrate: genres 27 new, 0 already there (old 27 -> new 27)
1090. migrate: persons 15157 new, 0 already there (old 15157 -> new 15157), show refs skipped 0
1091. migrate: shows 9453 new, 0 already there (old 9453 -> new 9453), cast refs skipped 0, genre refs skipped 0, season refs skipped 0
1092. migrate: seasons 6430 new, 0 already there (old 6430 -> new 6430), show refs skipped 0, episode refs skipped 0
1093. migrate: episodes 231584 new, 0 already there (old 231584 -> new 231584), show refs skipped 0, season refs left null (pre-existing) 1
1094. migrate: follows 128 new, 0 already there (old 128 -> new 128), show refs skipped 0
1095. migrate: watches 11692 new, 0 already there (old 11692 -> new 11692), target refs left null (pre-existing) 3
1096. migrate: 0 failed
1097. ```
1099. Every count equals the old export's own document count (`old-tracker/README-RECONSTRUCTED.md`:
1100. Show 9453, Season 6430, Episode 231584, Person 15157, Genre 27, Follow 128, Watch 11692). Ran a
1101. second time straight after (idempotency: the tool's `oldId` index finds each row again) — every
1102. table printed `0 new`, all rows `already there`, counts unchanged, 0 failed: the id-loss bug does
1103. not resurface across a real close-and-reopen.
1105. **Proof beyond the tool's own counters** (`tools/verify.hl`, new): the ticket asks for a check that
1106. does not just trust `migrate.hl`'s own "skipped" tallies. It runs against a plain filesystem COPY
1107. of `storage/mpackdb/` (hl:mpackdb rewrites a file's data on open, so the live store is never opened
1108. a second time) and independently re-derives, from the persisted records alone: every table's
1109. `count()` against the export's own document count, and — by building id sets for every table and
1110. walking every reference field (`Show.genres/cast/seasons`, `Season.show/episodes`,
1111. `Episode.show/season`, `Person.shows`, `Follow.show/user`, `Watch.target/user`) — that every
1112. non-null reference resolves to a real id. It also follows one show end to end (`Raised by Wolves`,
1113. 2 seasons, 18 episodes, 1 follow, 2 season-level watches — all cross-checked back to the show).
1115. ```
1116. $ cp -r storage/mpackdb .scratch/verify-copy && TRACKER_VERIFY_COPY=$PWD/.scratch/verify-copy ./bin/hybriel tools/verify.hl
1117. count ok genres: 27 (expected 27)
1118. count ok persons: 15157 (expected 15157)
1119. count ok shows: 9453 (expected 9453)
1120. count ok seasons: 6430 (expected 6430)
1121. count ok episodes: 231584 (expected 231584)
1122. count ok follows: 128 (expected 128)
1123. count ok watches: 11692 (expected 11692)
1124. users: 1 (expected 1, the creator)
1125. dangling references: 0 (episodes with a pre-existing null season: 36194, watches with a pre-existing null target: 3 — not dangling, the export already had no target)
1126. END-TO-END show 105ad9c91b14d663 "Raised by Wolves" seasons=2
1127. season 1 (be2965a5ab7165ca) episodes=10 show-back-ref-ok=true
1128. season 2 (0fe4e53157ed0367) episodes=8 show-back-ref-ok=true
1129. total episodes across seasons: 18
1130. follows on this show: 1, season-level watches touching it: 2
1131. VERIFY PASS
1132. ```
1134. (36194 episodes with no season = 36193 that never had one in the old export, plus the 1 the tool's
1135. own count already named as a pre-existing dangling `season` reference in the source data — neither
1136. is a reference this migration broke; `dangling references: 0` covers exactly that.)
1138. The single old user (`User.jsonl`, `[email protected]`, password not taken over) is this app's
1139. user for ident short id `az5b2` (`storage/mpackdb/users.db`, the same table step 1's login uses) —
1140. confirmed in the copy: one record, `identity=az5b2`.
1142. **Two Hybriel bugs found while building this** (both already filed as issues on this ticket by an
1143. earlier session, not re-filed): `hl:fs readFile` silently truncates at 10 MiB (worked around here
1144. with `split`, no shell, no JS, see `tools/migrate.hl`'s header comment) and `hl:mpackdb` loses rows
1145. across `update()` + reopen (the reason this tool never calls `update()`).
1147. **Open**: nothing shown yet — this ticket is data-only, on purpose (the next step, from the
1148. creator, is showing the data in the UI).
1150. ## 2026-09-27 — ticket #3: no border on the header or filled buttons
1152. Design notes from the first test (architect): "the application-header should have no bottom
1153. border" and "the buttons also no border except they are inverted". Two changes in
1154. `styles.hl`:
1156. - `applicationHeader`: dropped `borderBottom`.
1157. - `ident-selector::part(button)` (the signed-out "choose ident" button): added
1158. `border = 'none'` — the element's own CSS gave it a 1px border the same colour as its
1159. background (`--_accent`), invisible but still a real border in the computed style; this is
1160. the app-side restyling hook ident's README documents (`::part(button)`), not a change to
1161. ident's vendored `selector.js`.
1163. Left unchanged, already correct: the native `button` rule (filled, e.g. no other filled
1164. buttons on this page yet) already has `border = '0'`; `button.quiet` ("Log out") and the
1165. selector's dropdown `[part="identity"]` rows keep their border (transparent background —
1166. inverted style); `a.button` ("Log in with ident") has no border rule and browsers give `<a>`
1167. none by default. The selector's signed-in "logged in with ident" status pill
1168. (`::part(status)`) is not one of the buttons the ticket names and isn't a button element
1169. (a `<span>`) — left with its border.
1171. **Gate** (`tests/browser.mjs`, now 16 checks): added computed-style checks — the header's
1172. `borderBottomWidth` is `0px`; `#loginbutton`'s border is `0px`; the selector's
1173. `[part~="button"]` (inside its shadow root) border is `0px`; `#logout`'s border is NOT `0px`
1174. (still inverted-bordered) once signed in.
1176. ```
1177. node tests/browser.mjs
1178. 16 passed, 0 failed
1179. ```
1181. ## 2026-09-27 — ticket #1 reopened: login redone to match calendar exactly (header selector, empty page)
1183. The architect rejected the first build of ticket #1: the sign-in sat centered on the page
1184. (its own "Sign in with ident" card, identity + sign-out shown in a `homeCard`) instead of
1185. the header identity selector calendar/gitoria use, and there was no `<ident-selector>` at
1186. all. Rebuilt the login by copying calendar.worldapi.org's own files (unchanged in shape, per
1187. the architect's instruction "Copy calendar.worldapi.org's login unchanged"):
1189. - **`users.hl`** (new): the ident exchange + a `usersTable` (`storage/mpackdb/users.db`,
1190. `identity` → this app's user id), copied from calendar's `users.hl` with `TRACKER_KEY` /
1191. `TRACKER_SECRET` / `TRACKER_URL` / `TRACKER_STORAGE` in place of calendar's names (kept
1192. the names already in this app's `docker-compose.yml`/README/DECISIONS rather than
1193. switching to calendar's generic `IDENT_API_KEY`/`IDENT_API_SECRET`).
1194. - **`login.js`** (new): calendar's bridge between `<ident-selector>`'s `ident-login` DOM
1195. event and the hidden `#identcode` input, copied verbatim (creator: "login.js is correct,
1196. as thats for externals in general").
1197. - **`components/main.hl`**: now the header carries `userBox` (`<ident-selector>` + "Log in
1198. with ident" / "Log out"), the `trackerLogin`/`trackerLogOut` faces and the
1199. `trackerSignedIn`/`trackerSignedOut` client push — calendar's shell renamed to this app's
1200. event names.
1201. - **`components/home.hl`**: now truly empty (`View { home {} }`) — no sign-in link, no
1202. identity/sign-out duplicated on the page; that is entirely the header's job now.
1203. - **`components/loginfailed.hl`** (new) + **`project.hl`**: the login routes are now
1204. `/login/callback` (function route, the button's return AND the code exchange) and
1205. `/login/failed`, copied from calendar's `project.hl` (`safePath`, `failed()`,
1206. `loginCallback`) in place of the old `/login` + `/callback` + `/logout` routes; the old
1207. `/logout` POST route is gone (logout is a face, like calendar's).
1208. - **`styles.hl`**: added the header selector styles (`userBox`, `identSelector`,
1209. `ident-selector::part(...)`, sticky header) from calendar's `styles.hl`; dropped the
1210. now-unused `homeCard`/`accountBar`/`userName` rules from the rejected centered sign-in.
1212. **Gate rewritten** (`tests/browser.mjs`, 12 checks): replaced the old gate (which drove
1213. ident's full email-code UI through a vendored dev copy of ident at `.scratch/ident-dev`)
1214. with calendar's own pattern — `tests/identkit.mjs` (copied from calendar unchanged) starts a
1215. throwaway ident (a fresh copy of `/media/STORAGE/projects/ident.worldapi.org`'s code, no
1216. `.env`/storage copied, codes to a mail sink, never the live ident), signs in over its REST
1217. API and registers this app, then the gate proves the header in a real headless Chrome:
1218. signed out → `#selector` + `#loginbutton` in the header, **`main` is empty** → sign in
1219. (`/login/callback?ident_code=`, the same exchange the selector would trigger) → `#selector`
1220. shows `class="in"`, `#logout` appears, **`main` still empty** → sign out → signed out again
1221. → a reload stays signed out. No console errors.
1223. ```
1224. node tests/browser.mjs
1225. 12 passed, 0 failed
1226. ```
1228. `./deploy.sh --dry-run --target .scratch/deploy-preview --url http://127.0.0.1:0/`: gate
1229. passed as step [1/4], rsync preview held none of `storage/`, `.sessions/`, `.env`,
1230. `.scratch/`, `server.*`, logs. Removed the stale `.scratch/ident-dev` (the old gate's vendored
1231. ident copy) and `.scratch/browser-gate` (the old gate's storage) — unused by the new gate.
1233. **Still open**: the app is registered in ident's dev copies only (this gate's own throwaway
1234. ident). The LIVE ident registration (`TRACKER_KEY`/`TRACKER_SECRET` in `.env` next to
1235. `docker-compose.yml`) is the architect's first-deploy step (README "Deploy"), not built here.
1237. ## 2026-09-27 — ticket #2: data migration — blocked twice on sandbox access, nothing done
1239. Two workers in a row (`s-20260927T1029-f57b0f`, then this session) could not start: the
1240. migration source the ticket names, `/media/STORAGE/projects/old-tracker/mongo-export/*.jsonl`
1241. + its `README-RECONSTRUCTED.md`, is not reachable from this worker's sandbox. Verified fresh
1242. this session:
1244. ```
1245. $ ls -la /media/STORAGE/projects/
1246. antcolony-docs hybriel ident.worldapi.org tracker.worldapi.org # no old-tracker
1247. $ mount | grep STORAGE
1248. /dev/nvme1n1p6 on /media/STORAGE/projects/tracker.worldapi.org type btrfs (rw,...)
1249. /dev/nvme1n1p6 on /media/STORAGE/projects/hybriel type btrfs (ro,...)
1250. /dev/nvme1n1p6 on /media/STORAGE/projects/ident.worldapi.org type btrfs (ro,...)
1251. /dev/nvme1n1p6 on /media/STORAGE/projects/antcolony-docs type btrfs (ro,...)
1252. # old-tracker is not among the mounted subvolumes at all
1253. ```
1255. So this is not a data problem (the export is "complete" per the ticket) — it's the worker
1256. sandbox for this ticket that never got `old-tracker` mounted (read-only, like `hybriel` /
1257. `ident.worldapi.org` / `antcolony-docs` above). Nothing was built or changed this session:
1258. no `storage/`, no `tools/`, no id-mapping — writing the migration tool blind, guessing the
1259. JSONL shape from the ticket text alone, risks silently wrong data and was avoided on purpose
1260. (see the project's "Build it properly" rule). Filed as an antcolony issue so the next worker's
1261. sandbox includes `old-tracker` before another attempt.
1263. ## 2026-09-27 — ticket #1: the empty shell, ident login
1265. Built the app from scratch: vendored `bin/hybriel` + `plugins/` + `shared/tokens.hl` from
1266. `ident.worldapi.org` (newest local build, hybriel master 837fe120, no local patch — see
1267. README "Vendored Hybriel"). `project.hl` (routes `/login`, `/callback`, `/logout`, `/`),
1268. `components/home.hl` (the empty homepage), `components/main.hl` (shell), `styles.hl`
1269. (accent green `#4ec9b0`, per `antcolony/README.md` "look and style" / `CONCEPT.md`).
1270. `docker-compose.yml` / `Dockerfile` / `deploy.sh` following ident's own house pattern
1271. (port 45008, container `tracker.worldapi.org`).
1273. **Login**: the ident login BUTTON flow (ident.worldapi.org README "How apps use ident"),
1274. server-side exchange (`POST <ident>/api/exchange`), this app's own framework session
1275. (`session.user = { identity }`, cookie `trackersid`). ident hands over only the identity's
1276. public **short id** — no display name yet (ident#11, properties handover, is on hold) — so
1277. "your name" on the homepage is `Signed in as <shortid>`, the same identifier every other
1278. worldapi app would show; see `decided` in the report.
1280. **Lesson (Hybriel)**: a face that mutates `session.user` (e.g. `signOut`) does NOT
1281. automatically re-render the page — a component's reactive members (`signedIn`, `identity`,
1282. …) are computed once at mount from the framework's read-only session snapshot; a client
1283. handler that calls `emit server X()` must ALSO flip the affected members itself afterwards
1284. (ident's own `components/home.hl` `on doSignOut(e)` does exactly this: `emit server
1285. signOut()` then `signedIn = false` …). Missing that made the sign-out button silently do
1286. nothing client-side (the ack came back `ok:true`, the server-side session really was
1287. cleared — proven by a reload — but the DOM never updated) until copied.
1289. **Gate** (`tests/browser.mjs`, 13 checks): a fresh copy of `ident.worldapi.org`'s code (no
1290. `.env`, no `storage/`, no `.sessions/` — verified empty of secrets/data before first use)
1291. runs as this gate's own ident, on its own storage and its own mail sink (no live ident, no
1292. real mail). The gate registers this app in that dev ident once over the `/__hl/emit` API
1293. (the same one-time step a person does by hand in ident's `/apps` page), then drives the
1294. REAL login-button flow in a real headless Chrome: signed out → click "Sign in with ident" →
1295. ident's email form → the mail-sink code → the first-login optional-names form (Skip) → the
1296. one-identity choice (one click) → back on tracker, "Signed in as `<shortid>`" → "Sign out" →
1297. signed out again → a reload stays signed out. No console errors. Ran twice for stability, 0
1298. failures; no leftover Chrome/hybriel processes after either run.
1300. ```
1301. node tests/browser.mjs
1302. 13 passed, 0 failed
1303. ```
1305. `./deploy.sh --dry-run --target .scratch/deploy-preview --url http://127.0.0.1:0/` (a local
1306. directory, per ident's own convention for testing deploy.sh without touching Byrodin): gate
1307. passed, rsync preview held none of `storage/`, `.sessions/`, `.env`, `.scratch/`, `server.*`,
1308. logs — confirmed by the same grep the script refuses on.
1310. **Open**: the app is not registered with the LIVE ident yet — `TRACKER_KEY`/`TRACKER_SECRET`
1311. are unset until the architect's first deploy does that (README "Deploy"); until then
1312. `/login` on the live site answers a plain error page instead of redirecting (`/` itself
1313. still renders). This is normal for a brand-new app, the same as ident's own SMTP `.env`
1314. before its first deploy — not something this ticket's worker can set (no `.env` access,
1315. and it is a LIVE ident registration).