tracker

38.4 KB

1. # STATUS — tracker.worldapi.org
3. ## 2026-10-01 — ticket #10: installable app (PWA) + icons
5. **Built**: `icons/` (`icon.svg` source → `icon-192.png`, `icon-512.png`, `apple-touch-icon.png` 180; `favicon.svg`,
6. `favicon.ico` 16/32/48 — rsvg-convert + magick, commands in README "What it does (step 10)"); `project.hl`:
7. `appIcons` (192/512 × any/maskable, like calendar), `appTouchIcon`, `appFavicon`, `appThemeColor = darker.value`,
8. `appBackgroundColor = dark.value` (tokens), `offline = [ Home ]`, file routes for the icons, `/favicon.ico` now a
9. real file (was `direct = ""`); `components/main.hl` offline note + `netProbe` tick; `styles.hl` `offlineNote`,
10. `netProbe`, `@keyframes tracker-net-tick`; gate +12 checks.
12. **Decisions**: icon = a TV (antennas) with a check mark on the screen = "watched shows", green `#4ec9b0` on
13. rgb(25,30,35), all inside the maskable safe zone so one PNG serves any + maskable. Theme colour = `darker` (the header
14. bar, so the phone's status bar blends in), background = `dark`. Offline keeps only the shell/`/`; data pages get
15. hl:web's "Unavailable offline". The offline note is driven by `navigator.onLine`, read on a 1 s CSS-animation tick
16. (`animationiteration`) — hl:web has no connection-state member and no mount hook (reported as a Hybriel gap).
18. **Gate** (64 → 76 checks):
19. ```
20. 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
21. 76 passed, 0 failed
22. ```
23. Looked at: `/tmp/w045/icon-48.png`, `icon-192.png`, `icon-512.png`, `maskable-circle.png`, `small-on-white.png`
24. (favicon 16/32/48), `/tmp/w045/shots/pwa-phone-{online,offline}.png` (390 px) on Loreana.
25. Test gotcha: CDP `setOffline` only cuts the TAB — the service worker's own fetches still reach the server, so the
26. gate also stops the server before the offline reload.
28. **Open**: offline, the header's `<ident-selector>` (script from ident's origin, not cached) shows "choose ident"
29. next to "Log out". No note when the device is online but the server is down. Real-phone install test (ticket's
30. **Test**) after deploy: open https://tracker.worldapi.org → "Add to home screen".
32. ## 2026-10-01 — ticket #9: TMDB sync (new episodes + posters)
34. **Built**: `tmdbsync.hl` (`syncShow`: details + ≤ 20 seasons per request via `append_to_response`, add/update
35. seasons+episodes, poster w342), `tools/sync-tmdb.hl` (`--limit N`, paced, prints counts), the daily run in
36. `project.hl` (`syncTick` on an hl:time `every(1)` clock: at `TRACKER_SYNC_HOUR` UTC (4), once a day, ONE show
37. per tick, next show after n × 260 ms), `follows.hl` `allFollowedShowIds`, fake TMDB `tests/faketmdb.mjs`,
38. fixture shows got tmdbIds 1001/1002. Details: README "What it does (step 9)".
40. **Decisions**: match episode by tmdbId, else by S/E when the local one has no tmdbId (161 migrated); season by
41. number. Empty TMDB values never overwrite. Season 0 only if the show already has one (else specials flood
42. /my/unwatched); empty TMDB seasons not created. Own 16-hex ids for new rows (hybriel#113). Posters in
43. `storage/mpackdb/posters/` (the folder the existing `/posters/:name` route reads — inside `storage/`, so in the
44. backup) rather than a new `storage/posters/`. Shows synced = all followed (also Ended ones — updates happen).
45. Sync is off without `TMDB_READ_TOKEN` or with `TRACKER_SYNC=0`.
47. **Blocking**: `fetch()` blocks the whole hl:web process (measured: requests wait for the running step) — so the
48. run is cut into one-show steps. Real data: ~0.7 s per step average, SNL (53 seasons, 4 requests) 1.7 s; persist
49. of the 3 tables 36 ms.
51. **Real-data proof** (copy of Byrodin's `storage/` in `.scratch/realdata/`, deleted afterwards; procedure as
52. ticket #8 below; session file needs `created`/`seen` = now in ms, else the boot sweep deletes it):
53. ```
54. set -a; . ./.env; set +a
55. TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb ./bin/hybriel tools/sync-tmdb.hl --limit 128
56. tmdb sync done: shows=126 newSeasons=20 newEpisodes=800 updatedEpisodes=2651 updatedSeasons=174 posters=125 requests=380 errors=0 seconds=185.718
57. (again) shows=126 newSeasons=0 newEpisodes=0 updatedEpisodes=0 updatedSeasons=0 posters=0 requests=255 errors=0 seconds=89.888
58. ```
59. Fresh-process recount: seasons 6430 → 6450, episodes 231584 → 232384 (exactly +20/+800, no row loss), 0
60. dangling season/episode refs, 0 duplicate season numbers; 12 duplicate tmdbIds + 1 wrong parent were already in
61. the migrated data (same before/after). 126 shows (128 follows), 125 posters (one show has none on TMDB).
62. In-app daily run on the copy (TRACKER_SYNC_HOUR = current hour, real TMDB): 126 shows, 255 requests, 136 s,
63. 0 errors; `/my/shows` (signed in) polled every 0.5 s meanwhile: 181 answers, avg 0.25 s, max 4.0 s (one), then
64. 1.8/1.7/1.4 s. Full page loads after the sync (headless Chrome, load + socket + all images):
66. | page | full load | rows |
67. |---|---|---|
68. | `/my/schedule` | 0.7–0.8 s | 55 (was 0) |
69. | `/my/shows` | 1.3–1.55 s (128 real posters now, 1 placeholder) | 128 |
70. | `/my/unwatched` | 1.5 s (server 1.3 s) | 1593 (was 831) |
71. | `/shows/The-Librarians-The-Next-Chapter` | 0.33 s | poster + new S2 (12 eps) |
73. Screenshots + logs: `/tmp/w044-real/` on Loreana (`after-*.png`, `real-sync{1,2}.log`, `real-lat.txt`).
75. **Gate** (49 → 64 checks):
76. ```
77. 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
78. (in-app run 4.405 s; 10 pages asked during it, slowest 1371 ms)
79. 64 passed, 0 failed
80. ```
81. Screenshots `/tmp/w044-shots/` (`synced-*.png` looked at: posters, S3, schedule rows fine).
83. **Deploy (architect)**: `TMDB_READ_TOKEN` must be in Byrodin's `.env` (env_file) — without it the log says
84. `tmdb sync: off (no TMDB_READ_TOKEN)`. First daily run 04:00 UTC after deploy; check `docker logs
85. tracker.worldapi.org | grep tmdb`. Or stop the container and run the tool once for an immediate catch-up.
87. **Open**: a step blocks requests up to ~2 s (a non-blocking `fetchStart` + `done()` state machine would fix it).
88. `/my/unwatched` render grew with the rows (1.3 s server, 1593 rows) — watch it against the 2 s target. A season
89. watch record stays solid when the sync adds a new episode to that season (existing season-watch semantics).
90. Dev servers get the real token from `.env` automatically → start them with `TRACKER_SYNC=0`. Shows nobody
91. follows are never synced (by design).
93. ## 2026-09-30 — ticket #8: /my/ pages, S01E01, years, speed
95. **Built**: `/my/unwatched`, `/my/schedule` (routes in `project.hl`); old `/unwatched`, `/schedule` →
96. **301** (function routes `unwatchedMoved`/`scheduleMoved`). Rows as `S01E02 · <title>` (was
97. `Ep 2 · …`), list titles with the year `Doctor Who (2005)`, show page `1 episode` singular.
98. New shared helpers in `shows.hl`: `pad2`, `episodeCode`, `showYear`, `titleWithYear`,
99. `posterUrlOf`; in `watches.hl`: `watchedSet` (used by `/my/unwatched` and the show page's
100. `buildRows`; `isWatched` stays for the single-target toggles).
102. **Decisions**: year = `year`, else `release.slice(0,4)`, else none (197 shows lack `year`, some
103. have `release = ''`). Year only in LISTS (`/my/*`), not in the show page's `h1`. The 301 drops any
104. query (the pages take none). A row whose poster FILE is missing gets `/posters/none` (one cached
105. URL) instead of `/posters/<oldId>.jpg`.
107. **Why /my/shows was ~25 s live though its data is 0.2 s**: hl:web handles ONE request at a time.
108. Measured on the copy: `/my/shows` requested 1 s into a `/unwatched` render took 13.7 s (the
109. `/unwatched` render itself 14.5 s). Every request (pages, 128 poster requests) of every visitor
110. queued behind a slow `/unwatched`. Plus 128 distinct poster URLs per load, all the placeholder.
112. **Real-data check** (copy of Byrodin's `storage/` only, `az5b2` = user `0mujqspn0aqb`, dev
113. server :8730, headless Chrome, navigate → load → websocket open, 1280×900):
115. | page | before | after |
116. |---|---|---|
117. | `/my/shows` (128 rows) | 1.2 s (server 0.19 s) | 0.6–0.8 s, 1 poster request |
118. | `/unwatched` → `/my/unwatched` (831 rows) | 14.8 s | 0.7–1.2 s (server 0.55–0.65 s) |
119. | `/schedule` → `/my/schedule` (0 rows, data not synced since 2025-12) | 0.36 s | 0.3 s |
120. | `/shows/The-Librarians-The-Next-Chapter` | 0.34 s | 0.29 s |
122. How to repeat (Loreana; never touch Byrodin's folder beyond the tar read):
123. ```
124. ssh [email protected] 'tar czf - -C /CONTAINERS/projects/tracker.worldapi.org storage' | tar xzf - -C .scratch/realdata # ONLY storage/
125. TRACKER_PORT=8730 TRACKER_WATCH=0 TRACKER_STORAGE=$PWD/.scratch/realdata/storage/mpackdb TRACKER_SESSIONS=$PWD/.scratch/realdata-sessions/ ./bin/hybriel project.hl
126. # session file: name = sha256(<32-hex id>), JSON {"created":1,"data":{"tag":"t"},"id":"<id>","seen":1,"user":{"id":"0mujqspn0aqb"}}
127. curl -s -o /dev/null -w '%{time_total}\n' -b trackersid=<id> http://127.0.0.1:8730/my/unwatched
128. # Chrome: tests/cdp.mjs launchBrowser, Network.setCookie trackersid, goto + wait __hl.socket open
129. # afterwards: stop the server, rm -rf .scratch/realdata .scratch/realdata-sessions
130. ```
131. Screenshots: `/tmp/w041-real/{before,after}-{shows,unwatched,schedule,show}.png` (Loreana).
133. **Gate** (45 → 49 checks: two 301s, the browser landing on `/my/unwatched`, "1 episode"; the
134. existing ones now expect `/my/…`, `S01E02 · Second`, `S02E01 · Season Two Opener`, titles with
135. year, `/posters/sh1.png` + `/posters/none`). Fixture: show 1 `image = 'png'` (gate writes a 1×1
136. `posters/sh1.png`), show 2 `year = null`, `release = '2025-03-01'`.
137. ```
138. TRACKER_GATE_SHOTS=/tmp/w041-shots TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 node tests/browser.mjs
139. 49 passed, 0 failed
140. ```
141. Screenshots `/tmp/w041-shots/` (looked at: all fine).
143. **Open**: `/my/unwatched` rebuilds all rows per check click (~0.6 s, fine). Still no navigation
144. to the `/my/` pages. The single-request server means any future slow page blocks everyone —
145. keep every page well under 1 s. `/my/schedule` stays empty until the TMDB sync step.
147. ## 2026-09-30 — ticket #7: /my/shows
149. Built `/my/shows` (`components/myshows.hl`, route in `project.hl`, styles in `styles.hl`): every
150. followed show, newest follow (`follows.at`, epoch ms) first — small poster (2.5rem, `/posters/…` +
151. placeholder like the show page), title → `/shows/<slug>`, last watched episode `SxxEyy`.
153. **Decisions**: "last episode" = highest (season, episode) among the user's EPISODE watches of that
154. show (ticket); a season watch alone doesn't count (the season check watches every episode anyway).
155. No watch → no episode element. A show without a poster name → `/posters/none` (the route's own
156. placeholder), so every row has a poster. Read-only page, no face (like `/schedule`).
158. **Reuse**: new `follows.hl` `followsOfUser` (whole records; `followedShowIds` now builds on it) and
159. `shows.hl` `episodeById` (one line); `showById`, `posterName`, `watchesOfUser` unchanged.
161. **Performance** (against a COPY of `storage/mpackdb/` in `.scratch/perf-store`, removed after; live
162. files md5-verified unchanged): the page touches only the user's follows and episode watches
163. (one fetch per watch), never all episodes of a followed show — az5b2's 128 follows → 128 rows (123
164. with an episode, e.g. `S36E11`, `S30E91`) built in **160–255 ms**. For comparison **`/unwatched`
165. takes ~15 s** on the same copy (805 rows): it fetches every episode of every followed show and
166. checks each against the user's 11,692 watches with a linear `isWatched` — not in this ticket's
167. scope, flagged below.
169. **Gate** (`tests/browser.mjs`, 38 → 45 checks; `tests/seed-show.hl` adds a 2nd show "Unwatched Gate
170. Show", no seasons/poster name, followed AFTER the first but stored after it; the first follow is now
171. dated a day back): signed out → sign-in message; signed in → newest follow first, title hrefs,
172. posters loaded (`naturalWidth > 0`), 40px wide, `S01E02` after /unwatched's click, later `S02E01`
173. (watched BEFORE season 1's bulk watch → proves highest, not most recent), none for the other show.
175. ```
176. TRACKER_GATE_PORT=8720 TRACKER_GATE_IDENT_PORT=8721 TRACKER_GATE_CHROME=8722-8726 node tests/browser.mjs
177. 45 passed, 0 failed
178. ```
180. **Open**: `/unwatched` ~15 s on real data (above) — a watched-id map instead of `isWatched` per
181. episode would fix it (own ticket). No navigation links to `/my/shows` yet (homepage stays empty).
183. ## 2026-09-27 — ticket #6: /schedule
185. Built `/schedule` (`components/schedule.hl`): every episode of a show the signed-in user follows
186. that is NOT yet released (`e.release > today`), soonest first. Creator: "/schedule has a similar
187. list without check icons for the upcoming episodes of shows followed" — same row shape as
188. `/unwatched` (`components/unwatched.hl`) minus the check icon.
190. **Reuse, not copy**: imports the exact same `followedShowIds` (`follows.hl`), `showById` /
191. `seasonsOfShow` / `episodesOfSeason` (`shows.hl`) that `/unwatched` already uses — nothing new
192. added to either file. `watches.hl` is not imported at all: a row here is never watched/unwatched,
193. there is no check icon and no click, so the page needed no per-user watch state and no `on server`
194. face — the whole component is a single read-only server-side render (`rows` computed once from
195. `session`, same as every other reactive member here).
197. **Order**: soonest first, ascending by `release` (a plain `'YYYY-MM-DD'` string, ordering
198. operators confirmed working against this app's own vendored `bin/hybriel`, same as `/unwatched`'s
199. STATUS entry) — the ticket named this the architect's own reading ("the creator named the order
200. only for /unwatched"), so `insertByReleaseAsc` mirrors `/unwatched`'s `insertByReleaseDesc` with
201. the comparison flipped.
203. **`decided`**: "upcoming" = `release` strictly after today (not `>=`) — the natural complement of
204. `/unwatched`'s own `release <= today`, so every released-or-today episode is unambiguously on one
205. list, never both, never neither.
207. **Gate** (`tests/browser.mjs`, 35 → 38 checks): reused the same fixture (`tests/seed-show.hl`,
208. unchanged) — episode 3 already carried a far-future release (`2099-01-01`) for `/unwatched`'s own
209. "excludes the future one" check; `/schedule` now proves the mirror image with the same fixture:
210. signed out, no rows, the sign-in message; signed in, only that one future episode shows (the two
211. already-released ones excluded), no `button.checkicon` anywhere on the page, unaffected by any of
212. the watch toggles the other checks perform on the same fixture (run in any order — `/schedule`
213. never reads watch state).
215. ```
216. node tests/browser.mjs
217. 38 passed, 0 failed
218. ps -eo pid,args | grep [h]l-browser-tier
219. (nothing)
220. ```
222. Updated `README.md` ("What it does (step 6)", Test, Files) and this file.
224. **Open**: nothing shown on the homepage still points to `/schedule` (same as `/unwatched` before
225. it — the homepage stays empty per ticket #1's decision).
227. ## 2026-09-27 — ticket #5: /unwatched
229. Built `/unwatched`: every episode of a show the signed-in user follows that is already released
230. (`release` ≤ today, a plain `'YYYY-MM-DD'` string — migrated as-is by `tools/migrate.hl`, never
231. run through `dateOf`) and not yet watched, newest release first (creator: "/unwatched lists all
232. unwatched episodes of shows followed in release date desc order").
234. **Reuse, not copy** (the ticket's own instruction, re "the same check icon and watch logic as the
235. show page"): `watchClassOf` (watched → `'checkicon solid'`/`'checkicon regular'`) was a private
236. `static` in `components/show.hl`; moved it to `watches.hl` so both pages import the SAME
237. definition instead of each declaring their own — `show.hl` now imports it too, nothing duplicated.
238. `isWatched`/`setWatched` (already in `watches.hl`) needed no change. New `follows.hl`
239. (`followedShowIds`) and `shows.hl` `showById` (one line) round out the read-only data access this
240. page and `/schedule` (ticket #6) both need.
242. **String comparison** (`e.release <= today`, `row.release >= x.release` for the desc sort):
243. hybriel#2 ("no ordering operators on strings") is filed as still-open in this ticket's brief, but
244. its own history shows it was fixed and merged to master 2026-09-25 — confirmed directly against
245. THIS app's own vendored `bin/hybriel` (`'2020-09-03' <= '2026-09-27'` → `true`), so no numeric
246. date workaround was needed.
248. **A View text node cannot hold an inline expression** (`"Ep " + row.episodeNumber + " · " +
249. row.title` inside a tag body) — same rule as View attributes (components/show.hl's own comment:
250. "a View attribute must be a literal, a member or a field path"), just not documented for text
251. nodes anywhere yet; it silently rendered `<!-- binary_expression not rendered yet -->` instead of
252. erroring. Fixed by resolving the label into a plain field (`row.episodeLabel`) once, server-side,
253. in `unwatchedRowsOf` — the same pattern `show.hl`'s `buildRows` already uses for every other
254. ternary/concatenation. Not filed as a new Hybriel gap since it's the exact same restriction
255. already known and worked around elsewhere in this app, just not yet hit for interpolated text.
257. **Empty state**: signed out (no user, so no follows to show) and signed in with nothing unwatched
258. both render a message; used `.muted` (colorTextMuted), not `.message` (colorDanger) — the existing
259. `.message` class is for real errors (the login-failed banner), and an empty list isn't one (a
260. `decided`, small).
262. **Gate** (`tests/browser.mjs`, 29 → 35 checks): `tests/seed-show.hl` now takes an optional
263. `TRACKER_SEED_IDENTITY` and, when given, seeds a fixed user + a follow of the fixture show for it
264. — the only way to give `/unwatched` a known followed show before the browser ever signs in, since
265. the real login's `ensureUser` matches an EXISTING `users.db` row by `identity` and reuses its id
266. rather than minting a new one. The gate learns alice's per-app identity with one throwaway
267. `ident.exchange` call (consuming one code) before writing the seed. Episode 1/2 of the fixture now
268. carry a past `release` (`2020-01-01`/`2020-06-15`), episode 3 a far-future one (`2099-01-01`) —
269. proving both the release-date filter and the desc order. The new checks run signed out (no rows,
270. the sign-in message), then signed in RIGHT AFTER LOGIN, BEFORE the existing show-page checks that
271. toggle these same fixture episodes watched (order matters — otherwise `/unwatched` would already
272. be empty by the time it's tested): both unwatched episodes list newest-first, excluding the
273. future one; a click on the newest (`Second`, ep 2) removes it from the list; a reload proves the
274. watch is server-side, leaving only `Pilot` (ep 1).
276. ```
277. node tests/browser.mjs
278. 35 passed, 0 failed
279. ps -eo pid,args | grep [h]l-browser-tier
280. (nothing)
281. ```
283. Updated `README.md` ("What it does (step 5)", Test, Files) and this file.
285. **Open**: nothing shown on the homepage still points to `/unwatched` — no navigation exists yet
286. (the homepage stays empty per ticket #1's decision; a later step, from the creator, presumably
287. adds it). `/schedule` (ticket #6) is next and reuses `follows.hl`/`shows.hl`/`watches.hl` the same
288. way.
290. ## 2026-09-27 — ticket #4: the show page, watch checks (took over a previous half-done session)
292. Continued from an earlier session that had built the whole page — header, seasons/episodes,
293. the click-handling redesign to a flat `rows` list rebuilt server-side (`components/show.hl`'s
294. own header comment explains why: a nested `for` over seasons > episodes risks hybriel#86) — but
295. left with the gate red: clicking a check never turned it solid, no console error, and the
296. session ran out of budget before finding why.
298. **The actual bug**: the show page's own pure helpers (`buildRows`, `genreRowsOf`, `castRowsOf`,
299. `watchClassOf`, `initialCollapsed`) were plain instance members (`buildRows = (show, …) => {…}`,
300. no `static`). That shape works fine as a member's own top-level initializer (`rows = found ?
301. buildRows(showRow, watchRows, collapsed) : []` — this is how the page renders correctly on first
302. load) but throws when the SAME function is called from inside an `on server` face
303. (`showToggleEpisode` etc.): the server log showed `'buildRows' is not callable — it holds null`.
304. Found by running `.scratch/debug-click.mjs` (left by the previous session) with the server's
305. stdout/stderr captured — the browser console itself stayed silent (the face's error never
306. reaches the client at all, a separate Hybriel gap, hybriel#92 already covers that half).
308. Confirmed the fix by grepping other worldapi apps for the same shape:
309. `calendar.worldapi.org/components/calendar.hl` has `static soonOf = (u) => { … upcoming(u, …) }`
310. (an mpackdb-backed helper), called from its `on server calLoad`/`calSettingsLoad` faces, and
311. calendar's own gate is green — so `static` is the proven-safe shape for a component's own helper
312. that both (a) touches an mpackdb-backed import and (b) needs calling from more than one place
313. (its own initializer AND a later face). Declared all five helpers in `show.hl` `static`; reran
314. the gate: 29/29 green, including the season-bulk-toggle and the reload-proves-server-side checks.
316. Filed **hybriel#115 was already open** (from the previous session, about the CLIENT bundle
317. omitting a case for such a helper) but this session's finding is the SAME root cause reaching
318. further than that ticket says: the plain HL interpreter on the SERVER also treats such a helper
319. as `null` outside its own initializer, not just the JS-compiled client bundle. Left as one
320. `issues` entry pointing at hybriel#115 rather than opening a near-duplicate ticket — the
321. repro/observed there already generalizes (a per-instance member function wrapping an
322. mpackdb-backed import is unreliable wherever it is called from, not just the browser).
324. Ran `node tests/browser.mjs`: 29 passed, 0 failed (was 20 passed / 1 failed — the click timeout
325. — before the `static` fix).
327. **Rehearsed `tools/relink-episode-seasons.hl` against a full COPY** of the real
328. `storage/mpackdb/` (`.scratch/relink-rehearsal/`, since removed) — the tool's own header claimed
329. this rehearsal already existed here; it didn't (a leftover claim from the previous session), so
330. this session actually ran it:
332. ```
333. relink: episodes 231584, null season before 36194, linked 36194, still null (no matching season) 0
334. relink: episodes.db replaced with the relinked file — re-run to confirm idempotency (0 linked the second time)
335. ```
337. Ran a second time on the same copy straight after — idempotency confirmed:
339. ```
340. relink: episodes 231584, null season before 0, linked 0, still null (no matching season) 0
341. ```
343. All 36,194 pre-existing null-season episodes (ticket #2's count) now link to a real season by
344. `(show, seasonNumber)`; none left over. Not run against the LIVE `storage/mpackdb/` — that needs
345. the tracker container stopped first (hl:mpackdb does not coordinate two processes on one storage
346. directory, hybriel#21), the architect's job per the ticket ("the architect runs it live").
347. Updated README.md ("What it does (step 4)", Test, Files) and this file.
349. ## 2026-09-27 — ticket #2: old data migrated (took over a previous session's rewritten tool)
351. Continued from an earlier session that had rewritten `tools/migrate.hl` to avoid a real data-loss
352. bug (see below) but never run it even once, and had left the real `storage/mpackdb/` holding data
353. from the OLDER, buggy two-pass version of the tool (put a bare record, then `update()` it once the
354. other side of a circular reference existed). Took over: moved that buggy data aside
355. (`.scratch/pre-migrate-buggy-backup`, since removed), kept `storage/mpackdb/users.db` (step 1's
356. login table, untouched by the migration), and ran the already-fixed tool for the first time.
358. **The fix already on disk (kept as is):** `Show.seasons`/`Season.show` and `Show.cast`/
359. `Person.shows` are two-way references, so the id on one side must exist before the record on the
360. other side can be built. The old approach — `put()` a bare record, come back with `update()` once
361. the far side's id exists — loses rows: reopening a table in a fresh process after an `update()` had
362. touched it read back FEWER rows than were ever `put()` (seen directly: `persons.db`'s `count()`
363. dropped 15157 → 15152 after one round of `update()` — a real `hl:mpackdb` bug, reported to Hybriel,
364. not something an app is allowed to patch around). The fix assigns every new id itself (8 random
365. bytes, `hl:crypto`) in one pass over each export file BEFORE building any record, so by the time a
366. record is actually built every reference is already a known id — one `put()` per row, `update()`
367. never called.
369. **Run** (`tools/migrate.hl`, `TRACKER_OLD_DATA=.../old-tracker/mongo-export`,
370. `TRACKER_STORAGE=$PWD/storage/mpackdb`):
372. ```
373. migrate: genres 27 new, 0 already there (old 27 -> new 27)
374. migrate: persons 15157 new, 0 already there (old 15157 -> new 15157), show refs skipped 0
375. migrate: shows 9453 new, 0 already there (old 9453 -> new 9453), cast refs skipped 0, genre refs skipped 0, season refs skipped 0
376. migrate: seasons 6430 new, 0 already there (old 6430 -> new 6430), show refs skipped 0, episode refs skipped 0
377. migrate: episodes 231584 new, 0 already there (old 231584 -> new 231584), show refs skipped 0, season refs left null (pre-existing) 1
378. migrate: follows 128 new, 0 already there (old 128 -> new 128), show refs skipped 0
379. migrate: watches 11692 new, 0 already there (old 11692 -> new 11692), target refs left null (pre-existing) 3
380. migrate: 0 failed
381. ```
383. Every count equals the old export's own document count (`old-tracker/README-RECONSTRUCTED.md`:
384. Show 9453, Season 6430, Episode 231584, Person 15157, Genre 27, Follow 128, Watch 11692). Ran a
385. second time straight after (idempotency: the tool's `oldId` index finds each row again) — every
386. table printed `0 new`, all rows `already there`, counts unchanged, 0 failed: the id-loss bug does
387. not resurface across a real close-and-reopen.
389. **Proof beyond the tool's own counters** (`tools/verify.hl`, new): the ticket asks for a check that
390. does not just trust `migrate.hl`'s own "skipped" tallies. It runs against a plain filesystem COPY
391. of `storage/mpackdb/` (hl:mpackdb rewrites a file's data on open, so the live store is never opened
392. a second time) and independently re-derives, from the persisted records alone: every table's
393. `count()` against the export's own document count, and — by building id sets for every table and
394. walking every reference field (`Show.genres/cast/seasons`, `Season.show/episodes`,
395. `Episode.show/season`, `Person.shows`, `Follow.show/user`, `Watch.target/user`) — that every
396. non-null reference resolves to a real id. It also follows one show end to end (`Raised by Wolves`,
397. 2 seasons, 18 episodes, 1 follow, 2 season-level watches — all cross-checked back to the show).
399. ```
400. $ cp -r storage/mpackdb .scratch/verify-copy && TRACKER_VERIFY_COPY=$PWD/.scratch/verify-copy ./bin/hybriel tools/verify.hl
401. count ok genres: 27 (expected 27)
402. count ok persons: 15157 (expected 15157)
403. count ok shows: 9453 (expected 9453)
404. count ok seasons: 6430 (expected 6430)
405. count ok episodes: 231584 (expected 231584)
406. count ok follows: 128 (expected 128)
407. count ok watches: 11692 (expected 11692)
408. users: 1 (expected 1, the creator)
409. 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)
410. END-TO-END show 105ad9c91b14d663 "Raised by Wolves" seasons=2
411. season 1 (be2965a5ab7165ca) episodes=10 show-back-ref-ok=true
412. season 2 (0fe4e53157ed0367) episodes=8 show-back-ref-ok=true
413. total episodes across seasons: 18
414. follows on this show: 1, season-level watches touching it: 2
415. VERIFY PASS
416. ```
418. (36194 episodes with no season = 36193 that never had one in the old export, plus the 1 the tool's
419. own count already named as a pre-existing dangling `season` reference in the source data — neither
420. is a reference this migration broke; `dangling references: 0` covers exactly that.)
422. The single old user (`User.jsonl`, `[email protected]`, password not taken over) is this app's
423. user for ident short id `az5b2` (`storage/mpackdb/users.db`, the same table step 1's login uses) —
424. confirmed in the copy: one record, `identity=az5b2`.
426. **Two Hybriel bugs found while building this** (both already filed as issues on this ticket by an
427. earlier session, not re-filed): `hl:fs readFile` silently truncates at 10 MiB (worked around here
428. with `split`, no shell, no JS, see `tools/migrate.hl`'s header comment) and `hl:mpackdb` loses rows
429. across `update()` + reopen (the reason this tool never calls `update()`).
431. **Open**: nothing shown yet — this ticket is data-only, on purpose (the next step, from the
432. creator, is showing the data in the UI).
434. ## 2026-09-27 — ticket #3: no border on the header or filled buttons
436. Design notes from the first test (architect): "the application-header should have no bottom
437. border" and "the buttons also no border except they are inverted". Two changes in
438. `styles.hl`:
440. - `applicationHeader`: dropped `borderBottom`.
441. - `ident-selector::part(button)` (the signed-out "choose ident" button): added
442. `border = 'none'` — the element's own CSS gave it a 1px border the same colour as its
443. background (`--_accent`), invisible but still a real border in the computed style; this is
444. the app-side restyling hook ident's README documents (`::part(button)`), not a change to
445. ident's vendored `selector.js`.
447. Left unchanged, already correct: the native `button` rule (filled, e.g. no other filled
448. buttons on this page yet) already has `border = '0'`; `button.quiet` ("Log out") and the
449. selector's dropdown `[part="identity"]` rows keep their border (transparent background —
450. inverted style); `a.button` ("Log in with ident") has no border rule and browsers give `<a>`
451. none by default. The selector's signed-in "logged in with ident" status pill
452. (`::part(status)`) is not one of the buttons the ticket names and isn't a button element
453. (a `<span>`) — left with its border.
455. **Gate** (`tests/browser.mjs`, now 16 checks): added computed-style checks — the header's
456. `borderBottomWidth` is `0px`; `#loginbutton`'s border is `0px`; the selector's
457. `[part~="button"]` (inside its shadow root) border is `0px`; `#logout`'s border is NOT `0px`
458. (still inverted-bordered) once signed in.
460. ```
461. node tests/browser.mjs
462. 16 passed, 0 failed
463. ```
465. ## 2026-09-27 — ticket #1 reopened: login redone to match calendar exactly (header selector, empty page)
467. The architect rejected the first build of ticket #1: the sign-in sat centered on the page
468. (its own "Sign in with ident" card, identity + sign-out shown in a `homeCard`) instead of
469. the header identity selector calendar/gitoria use, and there was no `<ident-selector>` at
470. all. Rebuilt the login by copying calendar.worldapi.org's own files (unchanged in shape, per
471. the architect's instruction "Copy calendar.worldapi.org's login unchanged"):
473. - **`users.hl`** (new): the ident exchange + a `usersTable` (`storage/mpackdb/users.db`,
474. `identity` → this app's user id), copied from calendar's `users.hl` with `TRACKER_KEY` /
475. `TRACKER_SECRET` / `TRACKER_URL` / `TRACKER_STORAGE` in place of calendar's names (kept
476. the names already in this app's `docker-compose.yml`/README/DECISIONS rather than
477. switching to calendar's generic `IDENT_API_KEY`/`IDENT_API_SECRET`).
478. - **`login.js`** (new): calendar's bridge between `<ident-selector>`'s `ident-login` DOM
479. event and the hidden `#identcode` input, copied verbatim (creator: "login.js is correct,
480. as thats for externals in general").
481. - **`components/main.hl`**: now the header carries `userBox` (`<ident-selector>` + "Log in
482. with ident" / "Log out"), the `trackerLogin`/`trackerLogOut` faces and the
483. `trackerSignedIn`/`trackerSignedOut` client push — calendar's shell renamed to this app's
484. event names.
485. - **`components/home.hl`**: now truly empty (`View { home {} }`) — no sign-in link, no
486. identity/sign-out duplicated on the page; that is entirely the header's job now.
487. - **`components/loginfailed.hl`** (new) + **`project.hl`**: the login routes are now
488. `/login/callback` (function route, the button's return AND the code exchange) and
489. `/login/failed`, copied from calendar's `project.hl` (`safePath`, `failed()`,
490. `loginCallback`) in place of the old `/login` + `/callback` + `/logout` routes; the old
491. `/logout` POST route is gone (logout is a face, like calendar's).
492. - **`styles.hl`**: added the header selector styles (`userBox`, `identSelector`,
493. `ident-selector::part(...)`, sticky header) from calendar's `styles.hl`; dropped the
494. now-unused `homeCard`/`accountBar`/`userName` rules from the rejected centered sign-in.
496. **Gate rewritten** (`tests/browser.mjs`, 12 checks): replaced the old gate (which drove
497. ident's full email-code UI through a vendored dev copy of ident at `.scratch/ident-dev`)
498. with calendar's own pattern — `tests/identkit.mjs` (copied from calendar unchanged) starts a
499. throwaway ident (a fresh copy of `/media/STORAGE/projects/ident.worldapi.org`'s code, no
500. `.env`/storage copied, codes to a mail sink, never the live ident), signs in over its REST
501. API and registers this app, then the gate proves the header in a real headless Chrome:
502. signed out → `#selector` + `#loginbutton` in the header, **`main` is empty** → sign in
503. (`/login/callback?ident_code=`, the same exchange the selector would trigger) → `#selector`
504. shows `class="in"`, `#logout` appears, **`main` still empty** → sign out → signed out again
505. → a reload stays signed out. No console errors.
507. ```
508. node tests/browser.mjs
509. 12 passed, 0 failed
510. ```
512. `./deploy.sh --dry-run --target .scratch/deploy-preview --url http://127.0.0.1:0/`: gate
513. passed as step [1/4], rsync preview held none of `storage/`, `.sessions/`, `.env`,
514. `.scratch/`, `server.*`, logs. Removed the stale `.scratch/ident-dev` (the old gate's vendored
515. ident copy) and `.scratch/browser-gate` (the old gate's storage) — unused by the new gate.
517. **Still open**: the app is registered in ident's dev copies only (this gate's own throwaway
518. ident). The LIVE ident registration (`TRACKER_KEY`/`TRACKER_SECRET` in `.env` next to
519. `docker-compose.yml`) is the architect's first-deploy step (README "Deploy"), not built here.
521. ## 2026-09-27 — ticket #2: data migration — blocked twice on sandbox access, nothing done
523. Two workers in a row (`s-20260927T1029-f57b0f`, then this session) could not start: the
524. migration source the ticket names, `/media/STORAGE/projects/old-tracker/mongo-export/*.jsonl`
525. + its `README-RECONSTRUCTED.md`, is not reachable from this worker's sandbox. Verified fresh
526. this session:
528. ```
529. $ ls -la /media/STORAGE/projects/
530. antcolony-docs hybriel ident.worldapi.org tracker.worldapi.org # no old-tracker
531. $ mount | grep STORAGE
532. /dev/nvme1n1p6 on /media/STORAGE/projects/tracker.worldapi.org type btrfs (rw,...)
533. /dev/nvme1n1p6 on /media/STORAGE/projects/hybriel type btrfs (ro,...)
534. /dev/nvme1n1p6 on /media/STORAGE/projects/ident.worldapi.org type btrfs (ro,...)
535. /dev/nvme1n1p6 on /media/STORAGE/projects/antcolony-docs type btrfs (ro,...)
536. # old-tracker is not among the mounted subvolumes at all
537. ```
539. So this is not a data problem (the export is "complete" per the ticket) — it's the worker
540. sandbox for this ticket that never got `old-tracker` mounted (read-only, like `hybriel` /
541. `ident.worldapi.org` / `antcolony-docs` above). Nothing was built or changed this session:
542. no `storage/`, no `tools/`, no id-mapping — writing the migration tool blind, guessing the
543. JSONL shape from the ticket text alone, risks silently wrong data and was avoided on purpose
544. (see the project's "Build it properly" rule). Filed as an antcolony issue so the next worker's
545. sandbox includes `old-tracker` before another attempt.
547. ## 2026-09-27 — ticket #1: the empty shell, ident login
549. Built the app from scratch: vendored `bin/hybriel` + `plugins/` + `shared/tokens.hl` from
550. `ident.worldapi.org` (newest local build, hybriel master 837fe120, no local patch — see
551. README "Vendored Hybriel"). `project.hl` (routes `/login`, `/callback`, `/logout`, `/`),
552. `components/home.hl` (the empty homepage), `components/main.hl` (shell), `styles.hl`
553. (accent green `#4ec9b0`, per `antcolony/README.md` "look and style" / `CONCEPT.md`).
554. `docker-compose.yml` / `Dockerfile` / `deploy.sh` following ident's own house pattern
555. (port 45008, container `tracker.worldapi.org`).
557. **Login**: the ident login BUTTON flow (ident.worldapi.org README "How apps use ident"),
558. server-side exchange (`POST <ident>/api/exchange`), this app's own framework session
559. (`session.user = { identity }`, cookie `trackersid`). ident hands over only the identity's
560. public **short id** — no display name yet (ident#11, properties handover, is on hold) — so
561. "your name" on the homepage is `Signed in as <shortid>`, the same identifier every other
562. worldapi app would show; see `decided` in the report.
564. **Lesson (Hybriel)**: a face that mutates `session.user` (e.g. `signOut`) does NOT
565. automatically re-render the page — a component's reactive members (`signedIn`, `identity`,
566. …) are computed once at mount from the framework's read-only session snapshot; a client
567. handler that calls `emit server X()` must ALSO flip the affected members itself afterwards
568. (ident's own `components/home.hl` `on doSignOut(e)` does exactly this: `emit server
569. signOut()` then `signedIn = false` …). Missing that made the sign-out button silently do
570. nothing client-side (the ack came back `ok:true`, the server-side session really was
571. cleared — proven by a reload — but the DOM never updated) until copied.
573. **Gate** (`tests/browser.mjs`, 13 checks): a fresh copy of `ident.worldapi.org`'s code (no
574. `.env`, no `storage/`, no `.sessions/` — verified empty of secrets/data before first use)
575. runs as this gate's own ident, on its own storage and its own mail sink (no live ident, no
576. real mail). The gate registers this app in that dev ident once over the `/__hl/emit` API
577. (the same one-time step a person does by hand in ident's `/apps` page), then drives the
578. REAL login-button flow in a real headless Chrome: signed out → click "Sign in with ident" →
579. ident's email form → the mail-sink code → the first-login optional-names form (Skip) → the
580. one-identity choice (one click) → back on tracker, "Signed in as `<shortid>`" → "Sign out" →
581. signed out again → a reload stays signed out. No console errors. Ran twice for stability, 0
582. failures; no leftover Chrome/hybriel processes after either run.
584. ```
585. node tests/browser.mjs
586. 13 passed, 0 failed
587. ```
589. `./deploy.sh --dry-run --target .scratch/deploy-preview --url http://127.0.0.1:0/` (a local
590. directory, per ident's own convention for testing deploy.sh without touching Byrodin): gate
591. passed, rsync preview held none of `storage/`, `.sessions/`, `.env`, `.scratch/`, `server.*`,
592. logs — confirmed by the same grep the script refuses on.
594. **Open**: the app is not registered with the LIVE ident yet — `TRACKER_KEY`/`TRACKER_SECRET`
595. are unset until the architect's first deploy does that (README "Deploy"); until then
596. `/login` on the live site answers a plain error page instead of redirecting (`/` itself
597. still renders). This is normal for a brand-new app, the same as ident's own SMTP `.env`
598. before its first deploy — not something this ticket's worker can set (no `.env` access,
599. and it is a LIVE ident registration).