# SOURCES.md — event sources for the games still missing A source assessment for the games named in `docs/FEEDBACK.md` § P1 that still have no adapter, plus § 12, a sweep of thirteen Game8 hubs asked for separately on 2026-08-19. Written 2026-08-18. **Acted on 2026-08-19**: four of the games below were built, one turned out to be blocked rather than merely awkward, and the rest were declined. Each section keeps its original reconnaissance and carries its outcome at the top, because the reasoning is what stops the next pass re-deriving it. What changed on 2026-08-19, in one paragraph. **Built:** Girls' Frontline 2 (`iopwiki`, new parser), Stella Sora (`stellasorawiki`, new parser), Chaos Zero Nightmare (`game8`, no parser work) and Umamusume (`game8`, after widening its section and column vocabulary). **Built on 2026-08-19 after the permission was read in a browser:** Nikke, whose `robots.txt` turned out to be the standard Fandom file. **Declined:** Punishing: Gray Raven, Guardian Tales, Azur Lane and Aether Gazer, all as proposed. One thing not on the original list also came out of the pass: the **Infinity Nikki source is stale** and has no reachable replacement — see § 11. Later the same day a second, unrelated request added § 12: thirteen Game8 hubs checked for a schedule page, of which **MementoMori** needs no parser work at all and **Fire Emblem Heroes** has the best data in that sweep behind a shape the parser does not read. The other eleven are declines. Verdicts here are proposals. Once one is acted on — built or declined — the *decision* belongs in `AGENTS.md` § Scraping conduct, whose table exists so a source is not re-litigated every pass and which `.github/ISSUE_TEMPLATE/feature_request.yml` points readers at. This file is the working, not the ruling. ## Method Every page below was fetched from this machine with the refresh runner's own `User-Agent` (`gacha-event-tracker/1.0 (+https://github.com/StereotypicalCat/gacha-event-tracker)`), one or two requests per host, `robots.txt` first. No browser-shaped headers, no proxy, no JS execution — anything that only answers a browser is treated as closed, per the `uma.moe` precedent. Where an existing parser could plausibly read a page, it was run against the fetched bytes offline (`src/ingest/parsers/index.ts`) rather than guessed at. Two things this method cannot tell you, and both matter: - **Whether a host answers the GitHub Actions runner.** game8.co does not (`AGENTS.md` § Scraping conduct). The only hard evidence we hold is what CI has actually committed: `git log` on `snapshots/` shows `github-actions[bot]` landing **arknights.wiki.gg**, **endfield.wiki.gg** and **bluearchive.wiki** (Miraheze). Fandom sources have never refreshed in CI, because `robots.txt` itself is challenged from a datacentre address and the gate fails closed — and as of 2026-08-19 that challenge covers every Fandom wiki from *any* address tried here, not just CI's. Of the 2026-08-19 additions, **Stella Sora** is Miraheze and so is the one likely to refresh in CI; **IOP Wiki** is permissive but unproven; **Chaos Zero Nightmare** and **Umamusume** are game8 and therefore blind in CI by construction. - **Whether a page will still look like this in six weeks.** Each recommendation below names the assertion `canParse` should make, so a redesign fails the source loudly instead of emptying a lane. ## Where P1 stands | Game | Status | |---|---| | Arknights, Reverse: 1999, Blue Archive, Persona 5X | **Built** (2026-08-17/18) | | **Girls' Frontline 2, Stella Sora, Chaos Zero Nightmare, Umamusume** | **Built** (2026-08-19) | | Nikke | **Built** (2026-08-19), once the `robots.txt` was read in a browser — see § 3 | | Azur Lane | Declined on conduct (`azurlane.koumakan.jp` `ai-input=no`), and both Fandom alternatives are dead archives | | Punishing: Gray Raven, Guardian Tales, Aether Gazer | Declined — see §§ 6, 7, 9 | | Infinity Nikki | **Rebuilt** (2026-08-19) on `infinity-nikki.fandom.com` at day precision, replacing a Game8 page stale since August 2025 — see § 11 | | Silver Palace | Unreleased | ## Summary of findings | Game | Best source found | Parser | Refreshes in CI? | Verdict | |---|---|---|---|---| | Girls' Frontline 2 | `iopwiki.com/wiki/GFL2_Events` | new (`iopwiki`) | likely (permissive robots, unproven) | **BUILT** 2026-08-19 — best data quality of anything here | | Stella Sora | `stellasora.miraheze.org/wiki/Main_Page` | new (`stellasorawiki`) | yes (Miraheze proven) | **BUILT** 2026-08-19 — banners only, from the main page | | Nikke | `nikke-…-international.fandom.com/api.php?…page=Event` | `fandom`, third template | **no** — Fandom robots fails closed | **BUILT** 2026-08-19 — story events *and* dated pickup banners, with an evidenced reset clock | | Chaos Zero Nightmare | `game8.co/games/Chaos-Zero-Nightmare/archives/559899` | **existing** `game8` | **no** — game8 202s the runner | **BUILT** 2026-08-19 — no parser work, fixture-only lane | | Umamusume | `game8.co/games/Umamusume-Pretty-Derby/archives/536311` | `game8` + section and column vocabulary | **no** | **BUILT** 2026-08-19 — cost more than "two header words"; see § 5 | | Punishing: Gray Raven | `grayravens.com/wiki/Events` | — | — | **Decline for now** — one dated string on the whole page | | Guardian Tales | `guardian-tales.fandom.com/wiki/Events` | — | — | **Decline** — wiki stopped dating events in 2025 | | Azur Lane | none | — | — | **Still declined** — the Fandom alternatives are 2021 archives | | Aether Gazer | — | — | — | **Do not build. The game is shutting down.** | | Silver Palace | — | — | — | Unreleased; beta only | --- ## 1. Girls' Frontline 2: Exilium — BUILT 2026-08-19 **Source:** `https://iopwiki.com/wiki/GFL2_Events` (IOP Wiki, the Girls' Frontline universe wiki) **Conduct.** `robots.txt` is two lines — `User-agent: *` / `Crawl-Delay: 20` — with no `Disallow` anywhere and no named-agent block. No `Content-Signal` header. Our 6-hour floor is three orders of magnitude inside a 20s crawl delay. The response carries `Last-Modified`, so `If-Modified-Since` will do real work here. **Shape.** An `

` per event, each followed by ``. All 46 of those tables share one header row, exactly: ``` Title | Period (start/end) | Server | Type | Comment ``` Cells look like this, and this is the best date material in the project after wiki.gg: ``` Amidst Wings of Gray | 2025-01-16 17:00 - 2025-02-06 02:59 (UTC) | EN | Character Event | … ``` Explicit UTC, exact precision on **both** boundaries, no timezone inference anywhere. Each period cell also carries an ICS widget with `icsStart` / `icsEnd` in `YYYYMMDDTHHMMSS` — a second, independently generated copy of the same instants, useful for cross-checking a parser rather than as the primary read. **Coverage.** 145 rows, of which 51 are `Server: EN`. A naive regex parsed **every** EN period cell — zero unparsed, which is the count check `AGENTS.md` § Silent drops asks for. Latest EN rows: | Event | Start | End | |---|---|---| | Dawnforger — Part 2 | 2026-07-16 13:00 | 2026-08-05 22:59 | | Unto the Radiance | 2026-07-16 13:00 | 2026-08-05 22:59 | | **Moonshroud Requiem** | **2026-08-06 13:00** | **2026-08-26 22:59** (live today) | **Hazards, and what to do about them.** - **CN and JP rows sit in the same tables as EN.** This is the `akwiki` CN-column problem verbatim: the Chinese schedule runs a year ahead and a CN date on a Global calendar is a confidently wrong date. The `Server` column decides — publish `EN`, skip everything else. Servers seen on the page: `CN`, `EN`, `JP`. - **`Betas` is a section, not an event type.** The page's `

`s are `Main Events`, `Minor Events`, `Betas`, `References`. Closed beta rows are dated and would parse cleanly into a calendar of things nobody can do. Fence on the heading. - **Titles are localised per row.** The `Title` cell on a CN row is Chinese; on the EN row it is the English name. Because we only take EN rows this resolves itself, but a parser that took the section heading as the title would inherit the CN/EN slash pair (`Exotic Cadence/Amidst Wings of Gray`). Take the title from the EN row's own cell. - **`canParse` should assert the header row** — `Title` + `Period (start/end)` + `Server` — so a template change fails the source rather than emptying the lane. **Work:** new parser module `src/ingest/parsers/iopwiki.ts`, a `gfl2` `GameId`, a `GAMES` entry, one `SOURCES` entry, a fixture and a test. `Type` maps onto our `EventType` reasonably — `Character Event` → banner, `Combat Event` / `Special Event` / `Main Story Event` → event, `Popularity Contest` → other. --- ## 2. Stella Sora — BUILT 2026-08-19, from the main page and not the banner list **Source:** `https://stellasora.miraheze.org/` — a Miraheze wiki, so the same call as Blue Archive and hololive Dreams: `/wiki/` is the surface `*` is allowed, `/w/` and `/*?action=` are disallowed. CC BY-SA 4.0, no `Content-Signal`, no `Crawl-delay` for us. Miraheze is the one host family we have proof answers the CI runner. Three pages, and the difference between them is the whole finding: - **`/wiki/Events`** — a list of event names with **no dates at all**. Useless on its own. - **`/wiki/Banner_List`** — two clean tables, `Image | Name | Start | End`, with full wall clocks: `2026-08-18 03:00:00` → `2026-09-08 02:59:00`. 28 and 29 rows, current. **But the page states no timezone anywhere** — no `UTC`, no offset, nothing. This is the `bluearchive.wiki` hazard exactly (`AGENTS.md` § Blue Archive, third bullet): reading a bare wall clock as UTC invents the fact that matters, and rounding to a day does not save it because the start's day is half an event ID. - **`/wiki/Main_Page`** — a `Current Banners` module that emits the same instants as real `

` > under a spanning label row, and that row is *plausible* enough to resolve both columns at > indices no data row has. `readColumnTable` now decides the header by what it produces, trying > row 1 only when row 0 produced nothing. > - **The blast radius was measurable, and it was zero.** The worry below — that widening a parser > eight sources share starts matching tables it currently ignores — is right in principle and was > settled by measurement rather than by regenerating `.expected.json` until the tests agreed: every > pinned fixture *and* every live snapshot was parsed before and after, and no existing source's > output changed by a single event. Do that diff on any future change to `game8.ts`; it costs one > script and it is the only thing that distinguishes a safe widening from a silent one. `uma.moe` stays declined; nothing about the Turnstile gate has changed. Two other surfaces exist. **gametora.com** (`/umamusume/events/story-events`) — cleared in `AGENTS.md` already. The page embeds `__NEXT_DATA__` with a clean per-server dataset: ```json {"id":1018,"url_name":"story-event-18","name_en":"Days Flying By","start_en":1787090400, …} ``` 53 events, `start_en` epoch seconds, current through **2026-08-18** (today's event). Deterministic, no HTML parsing at all. But there is **no end timestamp in the payload** — every event would land `endsAt: null`, `endPrecision: "unknown"`. That is a correct value, not a wrong one, but a lane of start-only events answers none of the questions this app exists for. **game8.co/games/Umamusume-Pretty-Derby/archives/536311** ("List of All Banners") is a stable URL — unlike the monthly `August 2026 Release Schedule` pages (`613161`), whose URL changes every month and which a static `SOURCES` registry cannot follow. It carries: ``` Banner | Rating | Availability Seeking the Pearl (Rocket☆Star) | ★★★★☆ | 8/12/2026 - 8/21/2026 ``` Our `game8` parser returns **0 events** from it, and the reason is narrow: `COL_TITLE` is `/^(.*\b)?events?$/i` so `Banner` misses, and `COL_RANGE` knows `availability period` but not bare `Availability` or `Availability (UTC)`. Teaching it those two words is a few characters — but `game8.ts` serves eight live sources, so widening its column vocabulary can start matching tables on Genshin, HSR, ZZZ, WuWa, NTE, Nikki, P5X and Endfield that it currently ignores. If it is done, it is its own commit, with every existing `.expected.json` regenerated **and re-verified against the live pages**, not just regenerated to make the tests agree with the new behaviour. Add the game8 CI blindness on top and this is a "yes, but not next" — worth doing after GFL2 and Stella Sora, and worth doing as two commits (parser vocabulary, then the source). --- ## 6. Punishing: Gray Raven — decline for now `grayravens.com` is a Miraheze wiki and the community's officially supported fansite; conduct is fine (`/wiki/` allowed, `/w/` and `?action=` disallowed, `Crawl-delay` only for named bots). The data is the problem. `/wiki/Events` is a single patch guide — "Ongoing Events" is one version's content, written as prose. Stripped of markup, the **entire 626 KB page contains exactly one date range**: ``` Duration: July 17th to August 18th 2026. ``` Ordinal day, year on the second boundary only, one event per six-week patch. `/wiki/PGR_Roadmap` adds a `Patch | Est. Release | …` table — an estimate, and a start with no end. The Fandom wiki is worse: `Events` does not exist, `Upcoming Content` is 2025-era and says its dates are "ESTIMATED", and the search API returns nothing for `intitle:Event`. An adapter here would publish one guessed-ish event per patch. Decline, and recheck if grayravens ever puts the schedule in a table. --- ## 7. Guardian Tales — decline `guardian-tales.fandom.com/wiki/Events` fetches and parses fine. It contains **no 2026 date at all** — the newest dated entry across `Events` and `Guardian_Tales/Version_history` is 2025, and the wiki's own front page advertises 8 active users. This is the `bluearchive.fandom.com` failure in `AGENTS.md` § Scraping conduct: a source that parses cleanly to nothing live, which would put an empty lane on the calendar and report a broken source forever. The official site (`guardiantales.com`) serves no `robots.txt` (404, so no restriction) but is a Next.js SPA carrying `` with no schedule surface in the HTML. --- ## 8. Azur Lane — still no source The two Fandom wikis the community points at as alternatives to the declined `azurlane.koumakan.jp` are both dead: - **`blhx.fandom.com`** ("the authoritative database on Azur Lane's EN server"). `robots.txt` served `200` and allows `/api.php?action=`, so conduct is clear — but `Event_Calendar` and `Event_Information` both stop in **2021**. The newest event on the calendar is "Ying Swei's Spring Travels, Feb 04 2021". - **`azurlane-archive.fandom.com/wiki/Events`** has `Current Events` / `Upcoming Events` / `Previous Events` headings with nothing under any of them. The live schedule is on koumakan, which said `ai-input=no`. Nothing found here changes that verdict — worth a row in `AGENTS.md` recording that the Fandom alternatives were checked and are archives, so the next person does not check them again. --- ## 9. Aether Gazer — do not build; the game is ending Game8, published 2026-07-09, reporting the developer's own Bilibili statement: > Aether Gazer developer YongShi shared an official statement on Bilibili confirming that the game > will receive no further content updates once Version 5.2 rolls out on July 23, 2026. with a dated wind-down: refunds for unused Transfer Flowers 6 Aug – 6 Sep 2026, a final "With You" update 17 Sep 2026, and **store listings and download access removed 17 Oct 2026**. Global keeps updating only until it catches up with CN. The wiki matches. `aethergazer.miraheze.org/wiki/Event_Guide_List` is an image gallery of guide links with **no dates on it at all** — the unsupportable image-grid shape — the site was last edited 12 July 2026, and its main page carries a note from the owner about the wiki's uncertain future. A lane that will be empty by winter, built on a wiki that does not publish dates. Skip it, and record why so the request does not come back. --- ## 10. Silver Palace — unchanged Still unreleased. The Dichotomy Beta ran 23 July – 13 August 2026; no launch date announced; projections point at late 2026 / early 2027. Nothing to scrape, as `docs/FEEDBACK.md` already says. --- ## 11. Infinity Nikki — BUILT 2026-08-19, at day precision, replacing a stale source > **Outcome: option (b), chosen by the repository owner.** The lane now reads > `infinity-nikki.fandom.com` and the Game8 entry has been removed from `SOURCES` — a source whose > every row is wrong is not a second opinion. Seven current 2026 events replace five year-old ones > that had `endsAt: null` and rendered as live indefinitely. The Game8 fixture stays in > `fixtures/nikki/` as the only regression test for that parser's labelled `Start: … End: Permanent` > shape, driven through the parser directly now that no adapter routes it. > > The clock is read and discarded; the printed date is published at day precision. That invents > nothing and treats these cells exactly as every Game8 date already is. **The Blue Archive rule in > `AGENTS.md` has been narrowed to match**, because as written it forbade this: it now governs a > clock whose *server* is unknown — which is what those Blue Archive tables actually were, three of > five not saying which server they described — rather than any clock without a stated zone. What > remains forbidden is converting an unzoned clock by picking an offset, since the offset moves the > day and the start's day is half an event ID. This game already had an adapter, which is why it was not assessed on 2026-08-18. It should have been. `game8.co/games/Infinity-Nikki/archives/487445` fetched, parsed, and passed every test — and the page itself said `Last updated on: August 31, 2025`, with **zero** occurrences of the string `2026`. That is the lesson worth keeping from this section: **a stale page is not a broken one**, so nothing in the pipeline flags it. Check when a page was last updated, not only whether it parses. **The replacement.** `infinitynikki.fandom.com` 301s to `infinity-nikki.fandom.com`, whose `robots.txt` was read in a browser and is the standard Fandom file — same permission as Nikke (§ 3). The wiki is maintained: pages edited as recently as 2026-08-17, and its `Event` page mentions 2026 seven hundred and thirty-one times. ``` Current Events / Upcoming Events / Permanent Events / Past Events (h2 headings)
Event | Duration | Description | Type Deep Breakthrough July 20, 2026 04:00 – August 10, 2026 03:49 ... Double Rewards ``` **The missing fact was the timezone.** The Duration column names no zone. What the page *does* say, elsewhere and in prose: version launches dated `(UTC-7)`; `Rewards reset daily at 04:00 (Server Time)`; and durations running `04:00 → 03:59`, which only lands on a reset boundary if the column is server-local. Strong circumstantial evidence for UTC-7, and still circumstantial — which is why the clock is dropped rather than converted. Two shapes the parser handles, both of which would otherwise lose or corrupt a row: - **Titles come from a link's `title` attribute**, so they need entity-decoding by hand — an attribute never passes through `text()`, and `Alison's Travel Shop` would otherwise become the slug `alison-39-s-travel-shop`, which is a localStorage key. The ingest sanitiser catches exactly this, and a parser that needs repairing on its own fixture has a bug. - **Recurring events live on dated subpages**, so a title arrives as `Deep Breakthrough/2026-07-20` or, behind a red link, as the file name `Alison's Travel Shop 2026-08-06.png`. That date names the run rather than the event and is stripped; the start date already keys the runs apart. Asking the wiki's editors to state the zone on the Duration column would upgrade this source to exact instants, and remains the cheapest improvement available to it. ## What every one of these costs, beyond the source Adding a game is never only a `SOURCES` entry: - a `GameId` in `src/shared/schema.ts` — an enum value that becomes the first segment of every completion key for that game, forever; - a `GAMES` entry in `src/shared/games.ts` (name, short, hue, studio, `dailyTasks`), plus `resetOffsets` / `resetHourLocal` **only where the source states the clock** — Nikke's is evidenced, Stella Sora's is not stated on the page we would read; - a fixture in `fixtures//` and a test asserting parsed output, one commit per game (`docs/FEEDBACK.md` P1 step 4); - the lane arriving switched off for existing readers via `adoptNewLanes`, which is automatic but worth remembering when checking the app after a build. ## Recommended order Steps 1 through 5 were done on 2026-08-19, and step 6's declines are now written into `AGENTS.md` § Scraping conduct. What is left is one decision and two builds: Nothing is queued. Every game assessed in this file is now built or declined with its reasoning recorded, and the two decisions this pass raised — Nikke's permission and Infinity Nikki's timezone — have both been made. 2. **MementoMori** (§ 12a) — the cheapest adapter available today: a `GameId`, a `GAMES` entry, one `SOURCES` entry, a fixture and a test, with no parser change. Seven events parse out of a seven-row table and six of them are live. 3. **Fire Emblem Heroes** (§ 12b) — better data and a real cost: a ninth Game8 column shape, a single-date `MM/DD/YYYY` reader, and a decision about the 180-day rule, which one legitimate seven-month banner breaks. Two commits, parser then source, with the vocabulary widening diffed across every fixture and snapshot as Umamusume's was. Below that, in descending order of value: re-check `grayravens.com` if it ever puts its schedule in a table, and re-check Azur Lane if `koumakan` ever drops `ai-input=no`. Neither is worth a pass until something changes upstream. ## Appendix — reproducing the checks ```bash UA='gacha-event-tracker/1.0 (+https://github.com/StereotypicalCat/gacha-event-tracker)' # conduct curl -sS -A "$UA" https://iopwiki.com/robots.txt curl -sS -A "$UA" -D - -o /dev/null https://stellasora.miraheze.org/wiki/Main_Page # Content-Signal? # the pages curl -sS -A "$UA" https://iopwiki.com/wiki/GFL2_Events > gfl2.html curl -sS -A "$UA" https://stellasora.miraheze.org/wiki/Main_Page > stellasora.html curl -sS -A "$UA" 'https://nikke-goddess-of-victory-international.fandom.com/api.php?action=parse&page=Event&prop=text&formatversion=2&format=json' > nikke.json curl -sS -A "$UA" https://game8.co/games/Chaos-Zero-Nightmare/archives/559899 > czn.html # the § 12 sweep: hubs first, then the schedule page each one turned out to have. # `--rate 30/m` keeps one request every 2s to a single host, per AGENTS.md § Scraping conduct. for g in Black-Beacon Brawl-Stars Destiny-Rising Diablo-Immortal Epic-Seven \ fire-emblem-heroes Fire-Emblem-Shadows gundam-uce MementoMori \ Mongil-Star-Dive Pokemon-Champions Pokemon-UNITE Tower-of-Fantasy; do args+=(-o "hub-$g.html" "https://game8.co/games/$g") done curl -sS --rate 30/m -A "$UA" --compressed -w '%{http_code} %{url_effective}\n' "${args[@]}" # how stale is it? — the first question, and the cheapest grep -o 'Last updated on:[^<]*' mmori.html # does an existing parser read it? (offline, once a source id exists) bun run parse czn-game8-events czn.html --json ``` Facts stated above that a future reader may want to re-check, with how they were established: | Claim | How it was checked | |---|---| | game8 has no wiki hub for Nikke, GFL2, PGR, Azur Lane, Guardian Tales, Stella Sora, Aether Gazer | `HEAD https://game8.co/games/` → 404 for each, 200 for Umamusume-Pretty-Derby and Chaos-Zero-Nightmare | | The `game8` parser already reads the CZN page | ran `game8Parser.parse` against the fetched bytes: 4 events, 2 correctly skipped for a missing start | | `fandom.ts`, `akwiki`, `wikigg`, `bawiki`, `holodori` cannot read the new pages | `canParse` returned `false` for every combination tried | | CI can fetch wiki.gg and Miraheze | `git log --name-only -- snapshots/` — `github-actions[bot]` commits carry `arknights-akwiki`, `endfield-wikigg`, `ba-bawiki` | | A Fandom `robots.txt` 403 means the source is skipped, not failed | `src/ingest/robots.ts` `RobotsCache.load` — `status >= 400` other than 404/410 → `usable: false` | | All thirteen § 12 hubs exist | `GET https://game8.co/games/` → `200` for every one | | The `game8` parser already reads the MementoMori events page | ran `game8Parser.parse` against the fetched bytes: 7 events from the 7 data rows of `Current Events \| Duration` | | The FEH page is unreadable by shape, not by two header words | `columnLayout` finds no range column at all — `Availability` is a start and `End` is its own column, and `readStartEndTable` wants the rowspan `Start`/`End` pair | | Game8's structural check rejects the Pokémon UNITE page | `game8Parser.canParse` → `false`; the page has 25 `a-table` matches and zero `a-header--3` | | A hub's nav is not an index of its pages | the UNITE, Champions, Gundam and Black Beacon schedule pages exist and are linked from none of the hub navigation scanned; found by web search |