tracker

9.0 KB

1. # Report 068 — tracker#20 typed headings + tracker#21 Series / Shows split
3. **Commit**: `1ed5457` on branch `t20` (worktree loreana:/media/STORAGE/projects/tracker-wt20, from fa1f9df). Not pushed, not merged,
4. not deployed. main and the other worktrees were not touched.
6. ## Built
7. - **#20**: every heading reads "<Type> | <name>": the type word in its colour, a muted bar, the name in white.
8. - Title page: Movie / Series / Show. Also genre and person pages.
9. - Lists `/movies`, `/series`, `/shows` show their type word; `/my/series` and `/my/shows` say "My Series" / "My Shows".
10. - The same colours on the homepage row headings, the search labels and the filmography labels.
11. - Colours: Movie yellow, Series greenDark (the accent), Show purple, Genre blue, Person orange.
12. - Franchise (blueLight) and Timeline (greenLight) are defined as CSS classes only, for t19's pages.
13. - **#21**: every TV title has a kind, `series` or `show`.
14. - Show = TMDB type Reality / Talk Show / News / Video, or one of our genres Reality / Talk / News. Everything else is a series.
15. - `kind` and `tmdbType` are stored by the daily sync, the adult backfill, the search import, and a new **kind backfill**:
16. - one TMDB request per title that has no show genre;
17. - it runs after the adult backfill and resumes after a restart;
18. - `TRACKER_KINDS=0` switches it off.
19. - Before a title has a stored kind, its genres decide.
20. - **Pages and addresses**:
21. - Lists: `/series` and `/shows` (+ `/page/N`).
22. - Title pages: `/series/<slug>`, `/shows/<slug>`, and `/movies/<slug>` (new).
23. - Old links: `/shows/<slug>` of a series → **301** `/series/<slug>`; of a movie → **301** `/movies/<slug>`.
24. - `/my/series` and `/my/shows`.
25. - Home: 5 tiles (Unwatched, Schedule, Series, Shows, Movies) and 3 rows.
26. - Every link goes through `shows.hl titlePath`: lists, search, filmography, `/my/*`, `/<shortId>`, the page an import opens.
27. - **Docs**: `docs/kinds.md` (new). README (summary, config, What it does, Test, Files). STATUS entry on top.
29. ## Decisions
30. - **Movies moved to `/movies/<slug>`.** `/shows/` now means TV shows; old movie links answer 301. This is my decision, not in
31. the ticket.
32. - **`/shows/<slug>` is a function route** (`project.hl showsRoute`). hl:web cannot redirect from a component route.
33. - For a show, the route renders the Show component itself through hl:web internals (`server.router.match`, `server.page`,
34. `hostOf`, `requestHeaders`, `sessions`).
35. - Re-check this when hl:web is re-vendored. The kinds gate covers it: hydration, a season face and Follow all work on that page.
36. - Consequence: a link to a show is a full page load. Series and movie pages are still client-side.
37. - The search's TMDB results ("Fetch from web") say **TV** instead of a kind, because TMDB's search has no TV type.
39. ## Files touched (merge notes: t26 and t19 also change show.hl, project.hl, styles.hl)
40. | File | Change |
41. |---|---|
42. | `project.hl` | imports, `showsRoute`, routes (`/movies/:slug`, `/series*`, `/shows/:slug` as a function route, `/my/:tv` instead of `/my/shows`), the kind backfill block + one clock line + one log line |
43. | `components/show.hl` | header comment, 1 import, `slugInfoOf` replaces `initialCollapsedOf`, `pageKind` / `typeText` / `typeClass` members, the h1 line |
44. | `styles.hl` | 1 import line, colour tokens after `colorGenre`, a "typed headings" block before "/shows/:slug", home h2 colours, `homeNav` 3 columns (5 in the media block) |
45. | `shows.hl` | new block "kind of a title" before `posterName` |
46. | `catalog.hl` | two TV lists (`shows` beside `series`), `rekeyed`, `latestShows`, `showsPage`, counts, `tileOf` href |
47. | `tmdbsync.hl` | 1 import, header comment, type stored in `syncShow` and `backfillTitle`, `needsKind` / `kindBackfillQueue` / `kindTitle` |
48. | `search.hl` | import, `tmdbType` / `kind` on an import, `path` in its answer |
49. | `people.hl` | import, filmography `href` / `typeLabel` / `typeClass` |
50. | `shortids.hl` | `shortIdPath` uses `titlePath` |
51. | `components/home.hl`, `myshows.hl`, `allshows.hl`, `movies.hl`, `genre.hl`, `person.hl`, `search.hl`, `mymovies.hl`, `unwatched.hl`, `schedule.hl` | headings, links, labels |
52. | `tests/browser.mjs` | URLs (`/series/`, `/movies/`, `/my/series`, `#home-series`), h1 → `type-name` selectors, 5 home tiles, web label "TV", `TRACKER_KINDS: '0'` in `startServer` |
53. | `tests/faketmdb.mjs` | `type: s.type` in TV details |
55. New files:
56. - `components/allseries.hl`
57. - `docs/kinds.md`
58. - `tests/kinds.mjs`, `tests/seed-kinds.hl`, `tests/realdata-068.mjs`
59. - `tools/count-kinds.hl`
61. ## Gates (final tree)
62. ```
63. TRACKER_GATE_SHOTS=/tmp/w068/shots TRACKER_GATE_PORT=8761 TRACKER_GATE_IDENT_PORT=8762 TRACKER_GATE_CHROME=8763-8765 TRACKER_GATE_TMDB_PORT=8766 node tests/kinds.mjs
64. 32 passed, 0 failed
65. TRACKER_GATE_SHOTS=/tmp/w068/main-shots TRACKER_GATE_PORT=8761 TRACKER_GATE_IDENT_PORT=8762 TRACKER_GATE_CHROME=8763-8765 TRACKER_GATE_TMDB_PORT=8766 node tests/browser.mjs
66. 266 passed, 0 failed
67. ```
68. - The shots directory must exist before `tests/browser.mjs` runs (`mkdir -p` first).
69. - One earlier run of browser.mjs hit an mpackdb LockTimeout in the short-id resume check right after a server stop. The rerun passed.
71. `tests/kinds.mjs` covers:
72. - Kinds from the stored data.
73. - The sync storing the type: a followed Reality title moves to `/shows` without a restart.
74. - The kind backfill: stop and resume, no title asked twice, ≥ 260 ms between requests, a 404 handled, nothing to do on the next start.
75. - Both lists, the 301s, and every heading's words and computed colours.
76. - The function-rendered show page: a season closes and opens; Follow works.
77. - Signed in: home rows and tiles, `/my/series` and `/my/shows`.
78. - Search labels and links; a talk-show import opens `/shows/<slug>`.
79. - Filmography labels.
80. - 390 / 1280 px: nothing scrolls sideways, and the long name wraps.
82. ## Real data (copy of the live `storage/`, :8760, real TMDB; copy, sessions and `.env` link removed afterwards)
83. - **Backfill**: 1,789 TV titles in **838 s**, 1,613 requests, 11 TMDB 404s, 0 retries.
84. - **Kinds**: 1,577 series and 212 shows. 176 shows came from the genre (no request), 36 from TMDB's type.
85. - **TMDB types**: Scripted 1,337, Miniseries 179, Documentary 50, Reality 16, Talk Show 15, Video 4, News 1.
86. - **Public lists**: 1,601 series / 173 shows before the backfill (genres only), **1,565 / 209** after; 4,650 movies.
87. - **Spot checks** (12 names; 10 are in our data, all correct):
88. - Show: Saturday Night Live, The Tonight Show Starring Jimmy Fallon, Last Week Tonight, Late Show with Stephen Colbert, Hot Ones.
89. - Series: Reacher, Foundation, Doctor Who, Chernobyl, Severance.
90. - **Page times during the backfill** (curl every 5 s, 156 each, avg / max):
92. | Page | avg | max |
93. |---|---|---|
94. | `/` | 0.094 s | 3.5 s |
95. | `/series` | 0.055 s | 2.6 s |
96. | `/shows` | 0.024 s | 0.21 s |
97. | `/series/Reacher` | 0.19 s | 0.48 s |
99. - 4 answers took more than 1 s, about every 170 s. The cause was not found.
100. - Idle afterwards: average 0.029 s.
101. - **Browser** (signed in as the creator, full load in ms):
103. | Page | 390 | 1280 |
104. |---|---|---|
105. | `/series/Reacher` | 290 | 243 |
106. | `/shows/Saturday-Night-Live` | 395 | 380 |
107. | movie page | 251 | 246 |
108. | `/my/series` (126 rows) | 1,410 | 384 |
109. | `/my/shows` | 220 | 217 |
110. | every list / genre / person / search | ≤ 351 | ≤ 351 |
112. - Headings and colours right, nothing scrolls sideways, 0 console problems.
114. ## Screenshots (looked at, on Loreana)
115. - Gate: `/tmp/w068/shots/{series-page,show-page,movie-page,genre,person,series-list,shows-list,movies-list,home,my-series,my-shows,search}-{390,1280}.png`
116. - Main gate: `/tmp/w068/main-shots/`
117. - Real data: `/tmp/w068/real/{home,series-list,shows-list,movies-list,series,show,movie,genre,person,my-series,my-shows,search}-{390,1280}.png`
118. - `/tmp/w068` also holds older files from other workers; mine are the names above.
120. ## Open points
121. 1. **Merge** with main (062), t19 and t26.
122. - t19's franchise pages need the typed h1 (`type-franchise` / `type-timeline`).
123. - t19's `/shows/` links should use `titlePath`. Until then they still work through the 301.
124. 2. **TMDB type "Video"** is anime OVAs here (Halo Legends, .hack//Liminality, Carnival Phantasm). The architect's rule makes them
125. Shows. Should Video become Series? (creator to decide)
126. 3. **Deploy**: the first start runs the kind backfill after the adult backfill, about 14 min.
127. 4. The 2–3.5 s answers during the backfill (probably mpackdb rewriting shows.db; not investigated).
128. 5. Titles added by the person fill get a stored kind only at the next start. Until then the genres decide.
129. 6. **Ports**: on Loreana 8765 (node pid 1047) and 8766 on the tailscale address belong to other services. My gates still ran (the
130. fake TMDB binds 127.0.0.1). Nothing of mine is left running.
132. ## Hybriel
133. - **No component-route redirect.** hl:web cannot answer 301 from a component route or fall through from a function route.
134. - Workaround: `showsRoute` renders the component through hl:web internals.
135. - Candidate for a hybriel ticket: a component route should be able to answer a redirect, or a function route should be able to
136. hand over to the next route.
137. - No other new issues.