gacha-event-tracker/TODO.md

TODO

Handoff — state on 2026-10-16

For an agent picking this up with no prior conversation. Everything below is in the repo; this note only says where to start.

• Done today, all on main and pushed: the owner's "usual repeatable events" request, in three sub-projects — built-in weekly/monthly routines with per-item tracking (spec), every-N-days cycles for tasks and built-ins (spec), and battle pass windows as feed events (spec, see its § Outcome). Plans are beside them in docs/superpowers/plans/. The redesign attempt is uncommitted and was rejected for substantial markup divergence. Start with the replacement-agent handoff. The existing plan/ledger contain superseded completion claims; no extra branch/worktree.
• Redesign rejected for markup divergence; presentation correction pending. See docs/design-reviews/2026-10-16-redesign-implementation.md. The assigned follow-up is to faithfully port the approved markup and finish the redesign. Unrelated open items below remain separate. The ones that need the owner in the game first are marked as checks.
• How the owner works (their standing instructions, also in their personal Claude settings): once they approve a design, carry it through spec → plan → execution with no extra review stops, and report the decisions made at the end. Built-in figures are verified by the owner in game before they are relied on (§ the "Confirmed in game" rule in src/shared/routines.ts); the owner chose on 2026-10-16 to merge the cycle built-ins ahead of their checks and keep the checks here. Ask before anything outward-facing; push to origin (Gitea) only.
• Practical notes from this session: the adapter-author agent (.claude/agents/) adds one source per run and correctly stops when a host's robots.txt answers Fandom's challenge (403) — the owner then reads the file in a browser and the reading is recorded in the source's comment (AGENTS.md § Scraping conduct); scheduled refreshes run with --assume-robots-on-403 for every host. endfield.wiki.gg disallows /api.php for *, so only its /wiki/ pages are open. A fresh worktree needs bun install and a copy of public/data/ (AGENTS.md § Looking at the built app).

Open items

• Redesign Settings → Your own events and games (owner, 2026-10-17: “the split-up from the mockup is nice, but I guess it needs a bigger design”). Deferred on purpose: it works as well as it does today, which is enough for now. Direction from the owner: a heading per game you created, with that game's events listed under it, taking inspiration from the Routines tab — possibly reusing the routine editor (components/redesign/RoutineDrawer.tsx, the right-docked create/edit shelf) as the base for an event editor. Not in the Round 6/7 mockups, so it needs its own short design (brainstorm → spec → plan; owner approves once, then carry it through). Keep the current behaviour (components/YourOwn.tsx) working until the replacement is accepted.
  • Owner, same day, an alternative to weigh in that design: drop the separate settings page and put an Add button on the Settings sidebar's “Your games” list, opening an event editor there (a new game, or a new event under a game).
• Make it clear which game each This week & month chip belongs to (owner, 2026-10-16: "it can become a bit unclear"). With built-ins for seven games, that row now holds many chips whose titles do not name their game — "Weekly Routine", "Weekly Challenge", "City Stamina", "Realm of Breakthrough" — and today only the chip's hue says which game it is (Dailies.tsx, the longer row; the comment above today explains why the strip has no per-game headings: they would push next to expire down the page). Hue alone is weak — some games' hues are close, and colour cannot be the only carrier of meaning for accessibility. Options to weigh in a short design: the game's short name before the title on each chip (as Your own already does), one compact game label per run of chips (the row is already in game order), or grouping by game only in this row. Keep the row short, check it in a browser at phone width, and keep the chip's accessible name naming the game (it already does).
• Sub-project 2 of the "usual repeatable events" request: N-week cycles. Built-ins today repeat weekly or monthly; many endgame modes run on longer fixed cycles. Add a period unit anchored to a known start (every N weeks or days from a dated reset). It is a stored-shape change, so it gets its own brainstorm → spec → plan (owner's process: once a design is approved, carry it through with no extra review stops, and report decisions at the end), and a schema-guardian review. Entries are verified by the owner in game, game by game, before anything is committed — the same hold sub-project 1 used.
  • Facts already gathered are in the sub-project 1 spec § Scope item 2, each with the owner's in-game reading and its UTC instant: Star Rail's Pure Fiction / Forgotten Hall / Apocalyptic Shadow (six-week cycles two weeks apart, ending 19 Oct, 2 Nov, 16 Nov 2026), Divergent Universe + Currency Wars (one 18,000-point cap per two-week period, ending 19 Oct), ZZZ's Shiyu Defense and Deadly Assault (Fridays, a week apart: 16 and 23 Oct), Wuthering Waves' Tower of Adversity (28 days, 9 Nov) and Whimpering Wastes (26 Oct), NTE's Beyond the Rails (14 days, "typically", ending 21 Oct 21:00 UTC — an Asia-server instant, possibly the same for every server) and Tycoon Incentive Fund (14 days, 26 Oct; the cap differs per player through the Puka Membership Program — base 1,000,000).
  • Still to source: cycle lengths for ZZZ's two modes and Whimpering Wastes (a timer read just after each reset gives them); Infinity Nikki's Pinnacle Contest (half-month periods) and Merit Arena (from earlier research: a new arena each Monday, six per version — no wiki page, and its weekly caps change per version).
  • Design questions to settle: a cycle that ends at one instant for every server (Beyond the Rails) vs one per server reset; a target that differs per player (the Incentive Fund) — the reader sets it, or ship the base with a note; whether "typically every 14 days" is safe to model as fixed. Shipped 2026-10-16 — see the cycle routines spec: every-N-days periods for tasks and built-ins, showCycleTasks, a built-in clock, and cycle built-ins for Star Rail, ZZZ, Wuthering Waves and NTE. Star Rail's Divergent Universe / Currency Wars pool turned out to be weekly and shipped as such.
• Confirm the cycle built-ins in game (shipped 2026-10-16 ahead of the owner's checks, by the owner's call). If one differs, correct its entry in src/shared/routines.ts and its row in the cycle routines spec § Entries together, with the note Confirmed in game, YYYY-MM-DD.
  • Star Rail: Pure Fiction, Memory of Chaos and Apocalyptic Shadow as one tick per cycle — or should they track stars? (No page states a fixed star target.)
  • Star Rail: the shared Divergent Universe / Currency Wars 18,000-point cap resets every Monday (weekly since 4.2 per Fandom's Version/4.2), not every two weeks.
  • ZZZ: Shiyu Defense showed about 14 days left after it rolled on Friday 2026-10-16.
  • Wuthering Waves: Tower of Adversity at about 24 days left on 2026-10-16 (a 28-day cycle from Monday 2026-11-09; the source says "roughly").
• Track Wuthering Waves' Whimpering Wastes (Respawning Waters: Chasm, Torrents). Not every N days, so not shipped with the cycles: gurugamer (2025-09-04) says "the last Monday of each month", lootbar (2025-12-26) "roughly 4 weeks (about 26–28 days)"; the owner's timer put the next reset on Monday 2026-10-26. Needs either a "last Monday of the month" period or a source for a fixed length, confirmed by a second in-game reset.
• Track Infinity Nikki's Pinnacle Contest, which resets on the 1st and 16th of each month (infinity-nikki.fandom.com/wiki/Mira_Crown, 2025-12-08) — a half-month period, which period.ts cannot express yet. Merit Arena has no page stating its cycle; leave it until one does.
• Small things the whole-branch reviews of sub-projects 2 and 3 found and left (2026-10-16), none a bug a reader meets today:
  • At phone width, with weekly, monthly and cycle tasks all present, the strip header's period counts wrap ("Cycles 0/8" on its own line). Dailies.tsx, the periodCounts line.
  • Copy still says "weekly and monthly" where cycles now count too: YourOwn.tsx (the tasks and built-ins headings), Controls.tsx ("Show built-in weekly and monthly tasks"), and the strip's one-time question "Track X's built-in weekly and monthly tasks?" — a yes also turns on that game's cycle built-ins. Fold into the settings rework below.
  • The header label "Cycles" against "Weekly"/"Monthly".
  • TaskForm.tsx's isDayKey checks the pattern only; the schema also refuses impossible dates. A date input cannot produce one, so the two agree in practice.
  • Editing a cycle task's length or start files its old numbers under the old start keys (kept, and restored by undoing the edit) — the same as editing a week's start day, but with no notice; CustomForms.tsx's strandedNotice could be reused.
  • fandomtable and fandomversion are kept apart per table, not per page: a page holding both kinds of table would match both parsers (none does). PassSource.title(rowName) and the "event" name heading were for Miliastra and are unused; cells, wholeDate and pageUrl are copied between fandomTable.ts and versionTable.ts.
• Rework the settings, with mockups first (owner, 2026-10-16: "we will have to do a settings rework of some kinds with some mockups"). What you see keeps gaining switches — dailies, built-ins globally and per game, standard-banner pulls, weekly / monthly tasks, and with N-week cycles a third task switch (showCycleTasks). Start with mockups the owner can compare (the brainstorming visual companion), not code; keep every pref's stored meaning (docs/DATA-MODEL.md § Client-side storage — an absent pref still means never answered). Code: src/client/components/Controls.tsx, src/client/state/usePrefs.ts.
• Find out whether NTE's Beyond the Rails ends at one instant for every server. On 2026-10-16 the owner, on Europe, read it ending Wednesday 2026-10-21 at 21:00 UTC — the Asia server's Thursday 05:00 UTC+8 reset, not Europe's 03:00 UTC. The built-in therefore rolls on Asia's clock for every reader (clock: "asia", sub-project 2). A timer read from the America server (and one from Asia, to be sure) settles it; if America rolls on its own reset, the clock is per server and the entry needs changing.
• Sub-project 3: dated battle pass and shop windows as feed events. Source and parser work (AGENTS.md § the ingest pipeline; the adapter-author agent and add-game-source skill), not built-ins. Check the feed first: Genshin's battle pass is already a feed event (`Battle Pass
  • Moontrace, de-duplicated against Fandom's Moontraceon 2026-10-14), so a new source must not add a third copy. A localbuild:static` on 2026-10-16 still showed both names — probably the locally staged feed predating that fix; confirm against the live feed.
  • Candidate sources (from research, 2026-10-14): Genshin Fandom lists Battle Pass / Moontrace and the Miliastra Pass; endfield.wiki.gg mentions the Protocol Pass.
  • End dates the owner read in game, in the sub-project 1 spec § Scope item 3: Endfield Protocol Pass (~15 Oct 00:00 CEST), Genshin Battle Pass (2 Nov 03:00 UTC), Wuthering Waves' Oscillated Coral shop (resets each version, 11 Nov ~10–11 UTC), ZZZ City Fund season (19 Oct 03:00 UTC), Infinity Nikki Mira Journey (29 Oct ~20:00 UTC). Never invent a date: an event is built only from a source that states it; these readings are for checking a parser. Shipped 2026-10-16 — see the pass windows spec: Star Rail's Nameless Honor and ZZZ's New Eridu City Fund from their Fandom history tables, and Infinity Nikki's Mira Journey from its version, on the owner's in-game confirmation. Genshin's Battle Pass and Miliastra Pass were already in the feed.
• Endfield's Protocol Pass window. The wiki says the pass runs "until the end of this version", but on 2026-10-16 no stable page dated the current version: /wiki/Version stopped at Dreamscape (ended 2026-10-14), the main page gave only Asia's start, and the per-version page (Sanctuary_of_Ink) changes URL every patch. endfield.wiki.gg's robots disallow /api.php for *, so only /wiki/ pages are open. Re-check /wiki/Version; once it dates the current version, build endfield-wikigg-protocol-pass as the spec describes.
• Wuthering Waves' Pioneer Podcast and NTE's Circle Bounty, as pass windows: no page dated them on 2026-10-16 (the pass windows spec § Not shipped has what was found). The Oscillated Coral shop shipped 2026-10-22 as three routines that reset with the version (version routines spec).
• Record Wuthering Waves 3.8's end in VERSIONS (src/shared/versions.ts) once it is announced or the shop timer shows it, with the version after it. Until then the shop routines hold their count from 11 Nov 2026 and print an estimate (~23 Dec).
• Version routine follow-ups (version routines spec § Not in this change):
  • Let readers use "next version" in their own events and routines (owner, 2026-10-22): an event of their own that ends with the version, and a task of their own that resets with it — which also lets Make it mine copy a version routine. Today { unit: "version" } is built-in only and kept out of the stored PeriodSchema on purpose (decision 8), so this changes the stored shape: an older cached bundle must skip such a record rather than refuse it, as it did for cycle tasks (DATA-MODEL § tasks). Run the change past schema-guardian.
  • Find sources for game version dates (owner, 2026-10-22), so VERSIONS stops depending on hand entry. Per game, a stable page that dates the current version's start and end — never a per-version URL, which changes every patch — checked through the add-game-source path (robots, fixture, docs/SOURCES.md entry). Leads: Nikki's Fandom Version table already parses (versionTable.ts); WuWa's Fandom Version table stopped at 3.5 and Game8 gave both 11 and 12 Nov for 3.8 (pass windows spec § Not shipped); Endfield's /wiki/Version lagged a version on 2026-10-16. A scraped end must still be a stated date, and the owner's in-game hour can refine it.
  • Move Pioneer Podcast onto the version period once the owner confirms it follows the version.
  • Version markers on the timeline, or a version row in the list or Next up — left out on the owner's call (decision 4); only if they ask.
• Give Genshin's To Temper Thyself and Journey Far a check-in goal by default, so a reader need not set it by hand. The owner asked on 2026-10-16 to "mark it as a 4/5 wk event"; earlier the same day they described it as five days out of seven, and the check-in goals spec says five of seven — confirm the count with the owner before building. Today the goal is the reader's own (progress[id].goal), set from the event's checklist; with it set, a met week stays done in the strip for the rest of the week (checked in a browser on 2026-10-16). A default must not overwrite a goal the reader already set, and the event's id changes each cycle (…:2026-08-10), so it should match by title or source, not id.
• Move NTE's Europe server to UTC+2. games.ts rolls it at 05:00 UTC+1 (04:00 UTC), per Game-Time-Master and GameWith, but the game disagrees. On 2026-10-16 the owner read: a weekly timer of 3d 2h at 00:40 UTC (→ Monday 2026-10-19 03:00 UTC); Realm of Greed's own text, "Gold Heist resets every Monday at 5:00"; and the Tycoon Incentive Fund at 10d 2h at 00:43 UTC (→ Monday 2026-10-26 03:00 UTC, the day after the clocks change). Only 05:00 on a fixed UTC+2 fits all three — 03:00 UTC all year, not a server that follows daylight saving. Fix: set resetOffsets.europe: 2 for nte with a test, as a day-key change under AGENTS.md § Event IDs, and update docs/DATA-MODEL.md's reset table and Game-Time-Master's place as the source. One NTE timer read after 2026-10-25 would confirm it (it should still land on 03:00 UTC). See the built-in routines spec. Done 2026-10-16 (resetOffsets.europe: 2); a timer read after 2026-10-25 would still confirm it.
• Confirm Infinity Nikki's Realm of Breakthrough in game: still two Phantom Trials (Wish Master Chigda, Guardian Beast Whirls), once a week each, renewed at the Monday reset? The owner could not check on 2026-10-16 ("insufficient story progress" — it unlocks after Showdown with Chigda!). Until then the entry stands on infinity-nikki.fandom.com/wiki/Realm_of_Breakthrough (as of 2026-01-01), whose "currently there are two Trials" is the oldest claim in the Nikki list. If it differs, correct routine:nikki:realm-of-breakthrough in src/shared/routines.ts and its row in the spec § Entries together, with the note Confirmed in game, YYYY-MM-DD.
• Confirm Endfield's Etchspace Salvage: Focus Commissions in game: still 3 commissions a week, and does it reset on Monday with the Weekly Routine (EU: Monday 11:00 CEST, confirmed 2026-10-14)? The owner could not check on 2026-10-14 ("due to mission progress"). Until then the entry stands on endfield.wiki.gg/wiki/Etchspace_Salvage (as of 2026-09-01), whose "weekly" is read as Monday from the wiki's own weekly-reset box. If either is wrong, correct routine:endfield:focus-commissions in src/shared/routines.ts and its row in the spec § Entries together, with the note Confirmed in game, YYYY-MM-DD.
• Support check-in goals for events that require only some of the available days (for example, five check-ins per week). Keep unfinished events in Dailies, show progress against the required count, and distinguish finishing a week from finishing the event. Shipped 2026-10-13 — see the spec.
• Rework how the What you see settings group handles its toggles, so that the daily chores and the built-in weekly tasks can each be switched globally and per game, without adding a new checkbox for every game. Shipped 2026-10-14 — see the spec.
  • Today the two are inconsistent: the daily chores have one global switch (prefs.showChores) and no per-game control, while the built-in weekly tasks have only per-game switches (prefs.routineGames), one checkbox per game that has any. With more games and more built-ins, that list of checkboxes grows without bound.
  • Wanted: one pattern for both — a global switch, with per-game exceptions reachable without a checkbox per game in the group (for example, from each game's row in the games list, or a compact per-game control that only appears when asked for).
  • Keep the existing data meaning: a reader's current answers must carry over, and an absent pref still means "never answered" (AGENTS.md § Conventions on knownGames, and docs/DATA-MODEL.md § Client-side storage). The strip's one-time question about a game's built-ins should keep answering the same setting.
  • Code: src/client/components/Controls.tsx (What you see), src/client/state/usePrefs.ts, src/shared/routines.ts (activeRoutines, routineToAsk), src/client/components/Dailies.tsx.
• hololive Dreams has not refreshed in three weeks — find out why, or find it a new source. Resolved 2026-10-14: the wiki lapsed after 19 Sep (still answering, still parsing, nothing current), and no replacement can be fetched. The source is recorded as lapsed — see docs/SOURCES.md § 16.
  • Still open: run 317 reported last confirmed never for it, while the committed meta says 2026-09-22. The CI state in the Actions cache appears to have lost that date, perhaps by restoring from a chain that never held it. It is cosmetic (the message only), but worth a look if another source shows it. The footer says (2026-10-13): "Of the games you have switched on, this one has not refreshed in over two days, so some end dates may have moved: hololive Dreams (21d 7h ago)."
  • What the repo shows: snapshots/holodori-holodoriwiki-events.meta.json was last confirmed 2026-09-22T17:28Z (content last changed 2026-09-22T05:28Z, one event parsed), and no snapshot commit has touched it since. A 304 would still have stamped a confirmation, so every cycle since then has either failed or skipped this host. The committed .state.json is older (2026-09-12) because CI keeps live state in the Actions cache, not the repo.
  • First: read the step summary and annotations of a recent refresh.yml run on Gitea for holodori-holodoriwiki-events — its lastStatus and whether it was skipped_robots, failing (and broken after three cycles), or parsing to zero. If needed, one manual dispatch with only: holodori-holodoriwiki-events and dry-run off answers it (--dry-run makes no requests).
  • Then, by cause: robots or an access block from the runner → AGENTS.md § Scraping conduct (no workarounds; a manual refresh or another source). The wiki changed shape → repair src/ingest/parsers/holodori.ts against a new fixture, keeping the old one. The wiki stopped being maintained (holodori.wiki is a Miraheze wiki) → find another source; assess it in docs/SOURCES.md as the others are.
• Give Add an event and Add a task easy-to-use templates, and give both forms a UI/UX pass. Done 2026-10-14 as examples to start from — see PRD F13 and docs/superpowers/specs/2026-10-14-form-examples-design.md.
  • Templates: one tap fills the common shapes so the reader only adjusts the details — for example a weekly points task, a monthly shop reset, a login event, a banner with a known end. A template only pre-fills fields; nothing is saved until the reader saves, and no figure is presented as sourced unless it is (the bar src/shared/routines.ts holds built-ins to).
  • UI/UX pass: both forms grew field by field (src/client/components/CustomForms.tsx EventForm, src/client/components/TaskForm.tsx). Review them as a reader would — field order, defaults, copy, validation messages, how a cadence and a measure are chosen, phone width — against docs/DESIGN.md and docs/PRODUCT.md.
• Follow up the 2026-10-18 pre-ship review of the v1→v2 reader migration. A schema-guardian review found nothing blocking: event IDs, day keys and the feed contract are unchanged, and v1 keys are never removed, so a rollback finds them byte-identical. Done 2026-10-18:
  • Start-up (finishing a pending restore, then migrating or reconciling) now runs under the reader lock every save takes (state/reader/open.ts), so a second tab's save cannot be overwritten. Where no lock exists (no Web Locks, no IndexedDB) it opens unlocked, as before.
  • The automatic backups have a size cap, AUTO_BACKUP_BYTES, like Back up now's: past it the oldest snapshots are dropped, never the newest (state/reader/backups.ts). The main save still carries legacyRaw, which reconciling and rollback need.
  • Left as they are, by the agent's call: orphaned v1 entries (marks for a deleted myevent:/mytask:, or with no resolvable game) stay out of v2 account data, as nothing can show them; they survive in legacyRaw, v2:migration-recovery and the v1 keys. After a rollback, anything done in the new build is in v2 only: stranded for the old app, not lost.
• Find why the tour's look switches snapped back and the tour restarted after Finish (owner, 2026-10-18). Not reproduced; paused by the owner. Guards are in, and the investigation so far is in the handoff → "Owner feedback on the forced tour".
• Decide where an imported v1 file's marks go when its region differs from the reader's account. Today they land in a new account:import-N, kept but out of sight (state/reader/import.ts, export.ts). Options: merge into the visible account for that game, or show the imported account as a second server. Needs the owner's call (found by the 2026-10-18 migration review).
• Get readers to try the layout choices, not just be told about them (owner, 2026-10-18). Done 2026-10-18. The tour is now forced once for everyone, including new readers and anyone who saw the earlier tour. Its "Pick a layout" and Timeline steps switch the page behind in place, and the selected look is kept. Returning readers start on Relaxed. See docs/DESIGN.md → "The tour".