gitoriaLog in with ident

tracker

All repositories: gitoria

ReadmeCodePull requestsReleasesTicketsSettings
Commitb105bcd8b105bcd8tracker#11: Hybriel master ff51cf46 (checks no longer vanish), mobile-first styles, carets, follow button, sign-in modal, inverted check, orange castmreb105bcd8/STATUS.md

41.8 KB

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

Branches

Latest commits

  • b105bcd8tracker#11: Hybriel master ff51cf46 (checks no longer vanish), mobile-first styles, carets, follow button, sign-in modal, inverted check, orange castmre
  • 31b758aatracker#10: installable app (manifest, service worker, offline shell), own icon + faviconmre
  • 2fa9d997tracker#9: TMDB sync (followed shows: seasons, episodes, posters), tools/sync-tmdb.hl + daily run 04:00 UTC, fake TMDB in gatemre
  • 49e1f61edeploy.sh: back up live storage/.sessions/.env before every deploy (newest 5 kept)mre
  • 54070a4etracker#8: /my/unwatched + /my/schedule (301 from old), S01E01, title (year), 1 episode, watched-set lookup (unwatched 15s -> 1s)mre
  • 3251488atracker#7: /my/shows (followed shows, newest follow first, poster, title, last watched SxxEyy); gate can take screenshots (TRACKER_GATE_SHOTS)mre
  • 44b7d9f9tracker#6: /schedule — upcoming episodes of followed shows, soonest firstmre
  • 91c9fc8ctracker#5: /unwatched — unwatched released episodes of followed shows, newest firstmre
  • a97c0295tracker#4: show page /shows/:slug (header, seasons, episodes, watch checks) + tools/relink-episode-seasons.hlmre
  • 05f407c5tracker: no border on any button except inverted ones (Log out, ident status and identities too); header brand weight 100mre
  • 17375427tracker#2: tools/migrate.hl + tools/verify.hl — old MongoDB data into mpackdb with new idsmre
  • 31aac936tracker#3: no border on the header and on filled buttons; inverted buttons keep theirsmre
  • 2ad9d29ctracker#1: login exactly like calendar (identity selector in the header, empty homepage)mre
  • 3691e176tracker#1: empty tracker with the ident login (state of 2026-09-27)mre