changelog/v<major>/<major>.<minor>.x/<version>.md for each of the 42 releases from v1.0.0 to v4.7.1, and changelog/beta/ for pre-releases (none has been published; its README says how one would be filed). CHANGELOG.md becomes the index: what the layout is, [Unreleased] exactly as it was, and a table per major version (version, date, edition) that links each file. Each file is its section, copied byte for byte except that its heading is the file's H1 (so the sub-headings move up one level, outside code fences), relative links gain ../../../ so they name the same repository paths, and the --- separators between sections are gone. Checked by reversing all three changes on every file and comparing with the original section: 40 of 40 equal. Two releases had no section: v1.0.0 (its GitHub release notes, which the changelog pointed to as "Initial stable") and v1.1.3 (its tag message). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.9 KiB
v3.2.4 – 2026-05-20 (The "Refactor + Removed-Games + Anti-Cheat Index" Edition)
Patch release on top of v3.2.3, landed as two PRs. PR #74 (cleanup): two dead scripts removed, EditGameDrawer.tsx (718 LOC) and GamesTable.tsx (568 LOC) split into focused sub-modules, two new charts (TopOfflineBar, AddedPerMonthBar) wired to a fresh /top-offline page and the existing /charts/time page. PR #75 (features): the scripts/removed_games.jsonl log now passes through a dedup_removed() filter on every write (a one-time migration trimmed 6 historical duplicates), Top Online leaderboard expanded 50 → 100 to match Top Offline, a generated games/anti-cheat-list.md plus a /charts/anti-cheat/list web page group active games by anti-cheat family, and a new /charts/delisted page renders a timeline + reason breakdown of every removed-from-catalogue title. Web app + desktop bumped 1.2.3 → 1.2.4. Repo public-facing version 3.2.3 → 3.2.4. Tag v3.2.4 is GPG-signed; companion desktop tag is desktop-v1.2.4.
🧹 Dead-script removal
scripts/discord_notify.pydeleted — superseded by thepoli0981/.githubreusable workflow; no.github/workflows/*.ymlorbash/*.shreferenced it.scripts/migrate_to_shards.pydeleted — one-shot v2.2 migration tool, completed and unreferenced. The 10-script "unreferenced in workflows" audit confirmed the other eight (check_dead_links,delete_game,normalize_genres,purge_unhealthy,top_offline,top_online,update_data,update_reviews) all have livebash/*.shwrappers and stay.
🪓 Component splits
web/src/components/games/EditGameDrawer.tsx(718 LOC) → 7 focused files underedit/:EditGameDrawer.tsxkeeps the save handler, dialog shell, view-toggle wiring.EditFormFields.tsx,EditJsonView.tsx(withJsonDiff),EditChangePreview.tsx,ViewToggle.tsxextract the four UI regions.form-utils.tsexportsgameToForm+formToPatch;types.tsre-exports theFormState+Viewtypes.
web/src/components/games/GamesTable.tsx(568 LOC) → container + 5 files undertable/:GamesTable.tsxkeeps the virtualizer (useVirtualizerownership at container level so row-height stays single-source), filters, fuzzy search, sort, and paging.columns.tsxextracts theCOLS: ColDef[]array (12 columns) +TOTAL_WIDTH+SELECT_COL_WIDTHconstants.TableHeader.tsx,TableRow.tsx(memoised withReact.memo),TableToolbar.tsx,ExportMenu.tsxextract the visual regions.
- No behaviour change — same virtual scrolling, same sort/filter wiring, same selection store.
📊 New charts
web/src/components/charts/TopOfflineBar.tsx— mirror ofTopOnlineBarbut with offline-tier thresholds (20k/1.5k/300) calibrated to thetop_offline.pyscale instead of the online-only 100k/10k/1k palette. Filterstype_game !== "online" && status === "active", top 100 bycurrent_players.web/src/pages/TopOffline.tsx— new page at/top-offline, layout mirror ofTopOnlinePage, registered inApp.tsxandSidebar.tsx(Trophy icon).web/src/components/charts/AddedPerMonthBar.tsx— aggregatesrecords[*].added_atintoYYYY-MMbuckets, renders an ECharts bar. Added as a third card to the existingcharts/Time.tsxpage alongsideReleaseYearHistogram+AddedCumulativeLine.
🗑️ Removed-games dedup
scripts/core/data_store.py— newdedup_removed(records)keeps the latest entry per appid (compared byremoved_atISO timestamp, lexicographic order matches chronological forYYYY-MM-DDTHH:MM:SSZ). Records without a resolvable appid are dropped.scripts/purge_unhealthy.py:41-43andscripts/ingest_new.py:106-108— both call sites now writededup_removed(existing + log)instead ofexisting.extend(log). Samesave_jsonlatomic-rename transaction, so partial writes can't leave duplicates.scripts/dedup_removed_games.py(new) — one-shot CLI that loads, dedups, and rewrites the file. Run once locally as part of this release; idempotent, safe to re-run.- Result: existing log trimmed
43 → 37records. Verified zero duplicate appids post-migration.
🏆 Top Online expanded 50 → 100
scripts/core/constants.py:81—TOP_ONLINE_LIMIT = 100(was 50). Top Offline already 100.games/top-online.mdregenerated with 100 rows on next workflow tick; format unchanged (10-column table preserved).web/src/pages/TopOnline.tsx—<TopOnlineBar limit={100} height={1800}>to match the new row count.- i18n strings
topOnline.{subtitle,cardTitle}updatedTop 50 → Top 100in bothen.jsonandvi.json.
🛡️ Anti-cheat list
scripts/generate_anti_cheat_list.py(new) — buckets active games by canonical AC name (ANTI_CHEAT_PATTERNSkeys), with substring-match fallback for free-text values. Unrecognised values land in anOtherbucket with a stderr warning. Outputgames/anti-cheat-list.md: H1 + TOC + per-family H2 sections, each a 6-column table sorted bycurrent_playersdesc.bash/anti_cheat.sh+.github/workflows/anti-cheat-list.yml(new) — weekly Sunday 06:00 UTC cron + manual dispatch. Uses the samedata-writeconcurrency group as the other table-generation workflows.web/src/pages/AntiCheatList.tsx(new) —/charts/anti-cheat/listpage mirrors the MD: collapsible per-family sections + sticky AC-name sidebar nav. Uses existinguseGameshook; canonicalises client-side via a TS port of the Python patterns table. i18n keysantiCheatList.*added to en + vi.
📉 Delisted charts
web/src/hooks/useRemovedGames.ts(new) — fetchesscripts/removed_games.jsonlfrom raw.githubusercontent.com, parses lines, deduplicates client-side (same logic as the Python dedup). TanStack Query with 5-minute staleTime.web/src/components/charts/DelistedTimeline.tsx(new) — ECharts stacked bar, x =YYYY-MMofremoved_at, stacked bystatus_code(not_free/unavailable/ fallbackother).web/src/components/charts/DelistedReasonBreakdown.tsx(new) — ECharts donut bystatus_code.web/src/pages/charts/Delisted.tsx(new) —/charts/delistedpage renders both charts. Sidebar nav link withWifiOfficon.web/src/components/charts/KpiCards.tsx— new optionalremovedCountprop; when set, renders a 7th "Removed (all-time)" KPI alongside the existing in-catalog "Delisted" badge. Wired fromDashboard.tsxviauseRemovedGames().data?.length. Grid bumps fromxl:grid-cols-6toxl:grid-cols-7.
📝 Docs
- README: removed the duplicate "Quick Links" section (the comprehensive 11-row "Quick links" table at the top covers everything the 4-row duplicate listed).
- README: added
🎯 Top offline (md)row to the main Quick links table. - README: version badge bumped
3.2.3→3.2.4. - i18n: combined
nav.{topOffline,antiCheatList,delisted},topOffline.*,antiCheatList.*,charts.{time.addedPerMonth,delisted.*}keys added toen.json+vi.json.