gitoriaLog in with ident

tracker

All repositories: gitoria

ReadmeCodePull requestsReleasesTicketsSettingsCommitdc40d859dc40d859tracker#31 (mission 026): duplicate titles merged — the 68 type+tmdbId pairs held by 157 records were the old tracker's (all migrated); merge.hl repair job (own clock, before the TMDB jobs) keeps one keeper per title (follows/watches > old short id > oldest), moves follows, watches, seasons, cast, credits, timelines, tombstones the rest (mergedInto, never deleted), slugs + short ids 301 to the keeper; stray seasons merged into their listed twin (Reacher S3 watches) or linked when watched; search import re-checks before its put; deploy.sh waits up to 90 s for 200; real copy 68 -> 0 dup ids, az5b2 follows/watches equal; gates 342/0, 32/0, 52/0mredc40d859/reports/021-tracker-delta-sync.md

4.9 KB

  1. # Report 067: tracker#18 delta sync, show record refresh, summary priority
  3. **Commit**: `f83571c` on branch `t18` (worktree loreana:/media/STORAGE/projects/tracker-wt18, from t26 head 10bb3f9). Not pushed, not merged, not deployed. main, tracker-wt26 and tracker-wt19 were not touched.
  5. ## Files (merge notes)
  6. - New: `deltasync.hl` (the plan from the change lists, `sync-state.txt`, one-time `clearCopiedSummaries`), `tests/peek-shows.hl`, `tests/realdata-018.mjs`, `tests/realdata-018-poll.mjs`.
  7. - `tmdbsync.hl`: `syncShowDelta` (the light step), `changedSeasonNumbers`, `emptyResult`. The TVmaze request is now `/shows/<id>?embed=episodes`, which also brings `tvmazeSummary` (through `stripHtml`). `syncShowPart` only reads the episodes of its own part, and takes an `only.tvmaze` flag.
  8. - `details.hl`: `withDetailsFields` (shared with #26 `firstStep`, which no longer writes `summary`) and `applySynced`.
  9. - `project.hl`: `syncTick` rewritten for planning, delta and full walk. The clock's `busy` now includes planning. Adds the boot-time summary clear.
  10. - `tools/sync-tmdb.hl`: `--delta [--since D] [--plan]`, and uses `applySynced`.
  11. - `search.hl`: `haveTvmz`/`titleIdByTvmaze`, `searchTitleRenamed` (stale entries), and import `summary = null`.
  12. - `people.hl` (1 line, `summary = null`), `shows.hl` (`summaryOf`), `components/show.hl` (uses `summaryOf`).
  13. - Tests: `tests/browser.mjs`, `tests/faketmdb.mjs` (change lists, updates, embed, summaries), `tests/seed-show.hl` (the movie's summary is a copy).
  14. - `README.md` and `STATUS.md`: expect conflicts with the t19 and 062 merges in these two docs only. The code overlaps with people.hl and search.hl are small.
  16. ## Gate
  17. `TRACKER_GATE_SHOTS=/tmp/w067-shots TRACKER_GATE_PORT=8751 TRACKER_GATE_IDENT_PORT=8752 TRACKER_GATE_TMDB_PORT=8753 TRACKER_GATE_CHROME=8754-8756 node tests/browser.mjs` → **`261 passed, 0 failed`** (249 before, plus 12 #18 checks).
  19. What the 12 checks prove:
  20. - A changed title is refreshed: renamed, with its new text and tagline.
  21. - The creator's own summary is kept.
  22. - A copied summary is cleared at the first start.
  23. - Titles that did not change are untouched (same `tmdbSync`).
  24. - An unfollowed series gets only its newest season.
  25. - Search finds a title by its new name.
  26. - A failing change list falls back to the full walk and does not advance the stored day.
  27. - More than 14 days since the last run gives the full walk.
  28. - TVmaze's text is shown when there is no other summary.
  30. ## Numbers (real data copy 2026-10-01, real TMDB and TVmaze, one day of changes)
  31. - **Changes**: TMDB tv 3,088 + movie 9,559 ids (31 + 96 pages), TVmaze 312 → **336 of our titles (28 followed)**.
  32. - **Delta run**: 128 change requests + 477 title requests + 29 TVmaze. It took **536 s** (511 s on a second run), 0 errors, slowest step 2.5 s. Pages during the run: median 45 ms, p99 693 ms, max 2.2 s.
  33. - **Old full walk** on the same copy: 128 shows, 259 + 128 TVmaze requests, **312 s**.
  34. - My first variant gave every title the full step. Today (15,716 episodes) and EastEnders (7,349) then blocked the server for 20.8 s each, and RSS reached 14 GB. That is why titles nobody follows now get the light step.
  35. - **Cleared summaries: 9,647**, 24 kept. All 24 are followed shows whose tmdbSummary the #9 sync changed after the migration, so they are probably older TMDB texts, not rewrites (list in STATUS). One of them, Star-Trek-First-Contact, has another title's tmdbSummary: wrong tmdbId on that record.
  36. - First day only: 24 titles renamed, 79 TMDB texts changed, 173 taglines, +79 seasons / +4,475 episodes. The new seasons and episodes belong to unfollowed series that were never synced since the migration.
  37. - Screenshots (I looked at them) are on Loreana in `/tmp/w067/real/` (Andor renamed; Breaking Bad shows TMDB's current text) and `/tmp/w067-shots/delta-{show,movie}-1280.png`.
  39. ## Open points
  40. - It is **not "a handful of requests"**: about 634 a day against 387 for the old run, mainly because the movie change list is 96 pages. In return every title stays current. Dropping unfollowed movies would save roughly 300 requests a day; that is the creator's call.
  41. - **Memory**: about 10 MB per synced title is never freed (the Hybriel leak described in #28). A delta run adds about 3.5 GB RSS, the old run about 2.8 GB. A daily restart or a runtime fix is needed either way. The one-time summary clear adds about 2 GB at that boot.
  42. - **Titles**: TMDB's en-US name replaces the migrated title, including the old "Name(original)" form, e.g. Kaun Banega Crorepati(कौन बनेगा करोड़पति) → Kaun Banega Crorepati. To keep a title, a creator-title field like `summary` would be needed.
  43. - The first live run after the deploy is a full walk, because there is no `sync-state.txt` yet.
  44. - **Hybriel issues**: no new tickets. Two things to know:
  45. - `mode` cannot be a top-level variable name; it is parsed as the file mode directive.
  46. - The known fetch/decode memory leak. A small HTTPS fetch alone grows RSS by about 0.57 MB per request (60 TVmaze fetches: 6 → 51 MB).

Branches

Latest commits

  • dc40d859tracker#31 (mission 026): duplicate titles merged — the 68 type+tmdbId pairs held by 157 records were the old tracker's (all migrated); merge.hl repair job (own clock, before the TMDB jobs) keeps one keeper per title (follows/watches > old short id > oldest), moves follows, watches, seasons, cast, credits, timelines, tombstones the rest (mergedInto, never deleted), slugs + short ids 301 to the keeper; stray seasons merged into their listed twin (Reacher S3 watches) or linked when watched; search import re-checks before its put; deploy.sh waits up to 90 s for 200; real copy 68 -> 0 dup ids, az5b2 follows/watches equal; gates 342/0, 32/0, 52/0mre
  • 2667da05tracker#30 (mission 025): /my/ pages from slim cached title cards, episode rows and watch sets (after the jobs /my/series 1.8 s -> 0.06 s, /my/unwatched 4.1 -> 0.18 s); timeline page shows its name once; franchise widget under the poster/title; movies with TV leftovers (First Contact) go through the details repair; tools/count-tmdb-ids.hl; gates 327/0, 52/0, 32/0mre
  • 3909810dantcolony#40: mission references in README/STATUS/docs point to the moved missionsmre
  • e63b1d28antcolony#40: history (LOG.md), worker briefs (missions/) and reports moved here from antcolony, numbered per project; old numbers in antcolony docs/mission-map.mdmre
  • 1cda451dtracker: Hybriel master 190aa11d (#127 both shapes, GC correctness fc838894) — conductor adopts despite /my/series 2.4x after jobs (memory 8.0 → 1.7 GB boot); see reports/071mre
  • c1fa2f2etracker (mission 071): Hybriel master 190aa11d measured on the real copy vs the live binary 8590df63 — NOT adopted (after the first-start jobs /my/series 2.4x slower, /series 1.6x, RSS swings 7.4-12.2 GB; fresh it is flat at 1.7-2.2 GB and /my/unwatched faster), vendor stays 8efba065, candidate kept in .scratch/w071/vendor-190aa11d; tests/kinds.mjs: collection seed off (its TMDB request broke check 1 in 1 of 4 runs); tests/realdata-071.sh + realdata-071-bench.mjs + tools/realdata-071-table.py; README + STATUS (numbers, how to repeat); gates 325/0, 32/0, 50/0mre
  • 8081350atracker docs (mission 070): README (summary, Config HL_GC_BYTES — kept at Hybriel's default, the 256 MiB setting is taken out of docker-compose.yml again: the jobs grew to 12+ GB with it too, see STATUS), Test (three gates), Deploy (first start ~50 min: kinds then seed, restart once after collections done, memory numbers), Vendored Hybriel 8efba065 + #48 audit, Files; STATUS mission 070 entry (merges, migrated counts, lambda audit, gates, RSS old vs new, how to repeat, open points); docs/kinds.md + docs/franchises.md job order; tests/realdata-070-*.sh, tools/count-migrated.hl, tools/ref-params.py, tools/lambda-audit.pymre
  • 1ad19c8ctracker: re-vendor Hybriel master 8efba065 (#126 GC by bytes, #48 lambda parameters copy) (mission 070): bin/hybriel sha256 50361e95…, plugins core crypto data fetch fs http http1 mpackdb proc smtp time web; lambda audit: 13 lambdas change a passed record/list (11 through a local alias), no caller relies on it — unchanged; 319 read-only lambda parameters get & (no copy per call: /my/schedule 2.35 → 0.46 s, /my/unwatched 13.7 → 5.7 s on the real copy); /my/unwatched one merge sort instead of n² inserts; docker-compose HL_GC_BYTES=268435456; deploy.sh runs kinds.mjs + franchises.mjs too (default ports 8700–8710); tests/realdata-070.mjs; gates browser 325/0, kinds 32/0, franchises 50/0mre
  • 46b21389tracker (mission 070, conductor): the sync never destroys migrated data — the one-time summary step MOVES a copied summary to migratedSummary (marker summaries-moved.txt) instead of clearing it; a migrated record's first title/genres/homepage/tagline TMDB replaces → migratedTitle/migratedGenres/migratedHomepage/migratedTagline, a migrated season's/episode's title/summary → migratedTitle/migratedSummary (set once); tests/peek-shows.hl prints them; gate 325/0mre
  • 749019b0Merge t19 (tracker#19 franchises + timelines) into main (mission 070): conflicts README/STATUS/show.hl/project.hl/browser.mjs/faketmdb.mjs, both sides kept; franchise/timeline pages get #20's typed heading (Franchise | …, Timeline | …), their title links via titlePath (/movies|/series|/shows); the collection seed waits for repair, kinds and credits too; franchises.mjs URLs + 2 new checks; gates browser 323/0, kinds 32/0, franchises 50/0mre
  • daf49feaMerge t20 (tracker#20 typed headings + #21 series/shows split) into main (mission 070): conflicts README/STATUS/show.hl/project.hl/search.hl/components/search.hl/browser.mjs/faketmdb.mjs, both sides kept; clock order backfill → repair → kinds → credits; withDetailsFields stores tmdbType + kind; gates: browser.mjs URLs → /series|/movies, typed h1 selectors; kinds.mjs repair/credits off, fixture name = seed name; browser 323/0, kinds 32/0mre
  • 20e09d89Merge t18 (tracker#18 delta sync) into main (mission 070): conflicts README/STATUS/show.hl/project.hl/browser.mjs, both sides kept; pageShowOf summary = summaryOfmre
  • f83571c3tracker#18 (mission 067): daily sync by change lists — TMDB /tv|movie/changes (since the stored day, paged) + TVmaze /updates/shows → only our changed titles (followed: full step, unfollowed: light step — changed seasons, no TVmaze), full walk on first run / gap > 14 days / failed list; show record refreshed (title, tmdbSummary, tagline, status, genres …; renamed titles re-indexed); summary = the creator's own text (page: summary > tmdbSummary > tvmazeSummary), one-time clear of copied summaries (9,647 on the live copy); gate 261, tests/realdata-018*.mjs, README + STATUSmre
  • 1ed5457etracker#20 + #21 (mission 068): typed headings "<Type> | <name>" in type colours; TV titles split into Series (/series) and Shows (/shows) by TMDB type + Reality/Talk/News genres — kind stored by sync/import/adult backfill + new kind backfill (resumes), /movies/<slug>, /shows/<slug> of a series/movie → 301, /my/series + /my/shows, home 5 tiles + 3 rows, search/filmography labels; gates kinds 32 + browser 266, tests/realdata-068.mjs, tools/count-kinds.hl, docs/kinds.md, README + STATUSmre
  • f2b00674Merge t26 (tracker#26 + #28) into main (mission 062): short ids for every new person (castPersonId, guest route), guest stars stored on the title and created as people only when opened (/person/tmdb/<id>?show=<id> → 302), lean watch/follow clicks (showRow a small object, cast/crew from the slug, watches cached per user, face rows only after a season toggle); gate 311, tests/realdata-062.mjs, README + STATUSmre
  • 0553b51ftracker#19 (mission 066): franchises and timelines — tables, /franchises, /franchises/<slug>, /timelines/<slug> (Timeline | Release sort, series by last episode), the Prequel | Timeline | Sequel widget with the franchise above, the creator's editor, TMDB collection seed in the app (resumes, paced); gate tests/franchises.mjs 48/0 + browser.mjs 266/0, tests/realdata-066.mjs, docs/franchises.md, README + STATUSmre
  • fa1f9dfatracker#29 (mission 063): unwatched check muted grey outline + check (accent only on hover), watched stays solid — no code regression, the accent outline read as ticked; gate checks real checks visibly (computed style + screenshot pixel) on /my/unwatched, show, movie, /my/movies; gate 266, tests/realdata-063.mjs, README + STATUSmre
  • 10bb3f93tracker#28 (mission 061): full cast (all seasons, main cast by episodes, guest stars) + crew (created by, directed by, written by, screenplay, story, music) — stored by the details completion, the daily sync, the search import (one details request) and a background credits job (resumes, RSS limit); show page collapsed after 20 with client-side Show all; showBySlug via a slug map; gate 249, tests/realdata-028.mjs, README + STATUSmre
  • d8b12d67tracker#27 (mission 060): short ids for movies, series and persons — old 702 kept (data/old-short-ids.json), new random [a-z0-9]{5} unique across both, claimed at creation, background backfill (resumes), shown under poster/photo, /<shortId> → 301; gate 259, tests/realdata-060*, README + STATUSmre
  • 25a50bc4tracker#26 (mission 059): titles from a filmography are completed — on open (skeleton, step-wise face showComplete, no reload) and by the in-app details repair (resumes, TMDB-paced, series in parts); cast from TMDB credits; gate 231, tests/realdata-026.mjs, README + STATUSmre