100 Commits
Author SHA1 Message Date
poli0981andClaude Opus 5.5 1323886ccc chore(deps): weekly sweep 2026-11-16, release 4.6.2 (#195)
Dependabot #190-#194 combined with Zustand 5.1.0, soupsieve 4.1, coverage 7.17.3, Ruff 0.17.5 and a cargo update (wry 0.57.2, tauri-plugin-opener 2.7.3), each past a 3-day cooldown; Wrangler 4.161.0 with regenerated Worker types; tapable held at 2.3.3. Version 4.6.2 with a short changelog entry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 07:20:14 +07:00
poli0981andClaude Fable 5.2 0e0e442de5 chore: maintenance mode, Qodana analysis; 4.6.1 (#188) [skip-discuss]
The project moves to maintenance mode (stable, feature-complete): docs, templates and badges (EN + VI). Qodana analysis in CI for the TypeScript / JavaScript, Python and Rust projects, with the findings of its first reports fixed. Version 4.6.1.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 21:44:32 +07:00
poli0981andClaude Fable 5.2 b73661b438 docs: games must be playable or downloadable on the itch.io page itself (#187)
Issue #186 suggested a game whose itch.io page has no upload and no
browser build: the game comes from a launcher on the developer's own
site, behind an account. The scraper sees no buy row and calls such a
page free, and nothing in the contributing guide or the Add Games
templates said it doesn't qualify, although the Disclaimer (§4) tells
visitors that any download happens on itch.io.

State the rule in CONTRIBUTING (EN + VI) and add a matching check to
the Add Games issue form and PR template. No policy text changes.

Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-10 22:47:04 +07:00
poli0981andClaude Opus 5.5 1f21576162 docs(a11y): record the VoiceOver test on a real iPhone (#185)
The 4.6.0 website passed the owner's VoiceOver test on an iPhone 14 Pro in Safari, Chrome and Brave; ACCESSIBILITY.md (+ VI) and CLAUDE.md record it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 16:24:26 +07:00
poli0981andClaude Opus 5.5 047d918d43 feat: accessibility statement, keyboard/screen-reader/chart/contrast fixes; 4.6.0 (#183) [skip-discuss]
Accessibility pass for the website and the apps (WCAG 2.2 AA target) and the accessibility statement: root ACCESSIBILITY.md + docs/i18n/vi/ACCESSIBILITY.md, the accessibility issue form, a default PR template; focus management, the '/' shortcut switch, chart names and data tables, contrast tokens with a CI check, Windows contrast themes; a docs sync of verified mismatches; version 4.6.0 with the two deps sweeps since 4.5.0 (#176, #182).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 14:16:50 +07:00
poli0981andClaude Opus 5.5 42d69da957 chore(deps): weekly sweep 2026-11-09 (#182)
* chore(deps): weekly sweep 2026-11-09

Dependabot #177-#181 combined, plus what Dependabot had not opened,
all past the 3-day cooldown:

- npm: TanStack Query 5.106.1, vitest + @vitest/coverage-v8 5.1.0,
  vite 8.3.6, @vitejs/plugin-react 6.2.1, Tailwind 4.3.4, eslint 10.14.0,
  knip 6.44.1, wrangler 4.158.0 (worker-configuration.d.ts regenerated),
  jose 6.2.15, globals 17.14.0, lucide-react 1.69.0
- Python (pip-tools on 3.14): soupsieve 4.0.1, coverage 7.17.2, ruff 0.17.4
- Actions: actions/setup-java v6.2.0, sonarqube-scan-action v8.4.1
- cargo: wasm-bindgen 0.2.130 family, log, mime, toml, jiff, cc and others

Held back by the cooldown: zustand 5.1.0, TanStack 5.107, jose 6.2.16,
knip 6.44.2, Tailwind 4.3.5, flate2 / uuid / smallvec / serde_spanned.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(claude): note the 2026-11-09 deps sweep

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 07:16:30 +07:00
poli0981andClaude Opus 5.5 4bbd8a967f chore(deps): weekly dependency sweep 2026-11-02 (#176)
* chore(deps): weekly dependency sweep 2026-11-02

npm (3-day cooldown applied by hand, as Dependabot does):
- react-router 8.5.1, @tanstack/react-query* 5.105.0, lucide-react 1.64.0,
  jose 6.2.14 (Dependabot #171, #172, #175)
- @types/node 26.6.6, knip 6.44.0, typescript-eslint 8.72.1 (#173, #174)
- wrangler 4.156.0 + regenerated worker-configuration.d.ts (why #173 failed)
- drop overrides.undici: wrangler 4.156's miniflare pins undici 7.30.1 itself

Also: pytest 9.2.0 + ruff 0.17.3 (pip-tools on Python 3.14),
sonarqube-scan-action v8.4.0, cargo update of crates past the cooldown
(brotli, rustix, tauri-plugin-single-instance, utf8_iter, zcheapstr).
CLAUDE.md gotcha 42 rewritten for the removed override.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: note the 2026-11-02 deps sweep in CLAUDE.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 08:07:33 +07:00
poli0981andClaude Opus 5.5 435af85983 docs(rate-limits): a WAF test that reaches the threshold (#169)
The runbook's WAF test now uses a Node fetch one-liner (connection pool):
xargs curl only reached ~20 requests/s, below the rule's 300 per 10 s.
Measured 2026-10-27: 800 requests in 4.9 s -> 111 x 200, 201 x Worker 429,
488 x WAF 1015.

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 06:19:14 +07:00
poli0981andClaude Opus 5.5 45f64e6c39 docs(rate-limits): Worker binding counts per machine; test over one connection (#168)
Measured on production after the 4.5.0 deploy: with a new connection per
request, 1,000 requests in 53 s got no 429 from RL_SITE (120/60 s); over
one keep-alive connection, 429 after ~93. The ratelimits binding counts per
machine of a data centre and syncs late, so the zone's WAF rule is the
limit that holds against floods. Verified once the owner set the rule
(300/10 s): 800 requests in 4.9 s gave 111 x 200, 201 x Worker 429 and
488 x WAF 1015, with the site answering again 10 s later.

Runbook test commands, code comments, CLAUDE.md gotcha 43, the 4.5.0
changelog entry.

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 06:17:42 +07:00
poli0981andClaude Opus 5.5 7920011c70 feat(worker): rate limits for the whole site (4.5.0) (#167)
Every request that runs the Worker is counted per client (IPv4, or IPv6
/64): RL_SITE 120/min (app pages, public /api, the old apps' /data JSON,
misses), RL_IMG 600/min (covers), RL_ADMIN 300/min (/admin + /api/admin);
RL_SUGGEST 5 and RL_GATE 20 stay on top for their POSTs. Verified bots are
not counted. Over a limit: 429 + Retry-After 60 (JSON for the API, covers,
files and /data with CORS; a script-less EN/VI page for app pages). Fails
open.

Every rate-limit namespace moves to 8801-8806 (staging 8901-8906):
namespace ids are account-wide, and other Workers on the account use
1001-1006, so RL_SUGGEST / RL_GATE shared their counters.

docs/operations.md section 1 step 15: the zone's WAF rate-limiting rule as
the first layer (Free plan: one rule, IP, 10 s; 300 requests / 10 s).

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 06:02:49 +07:00
poli0981andClaude Opus 5.5 753709e9ab chore(deps): weekly updates, close build-tool advisories (4.4.3) (#164)
The updates of Dependabot #159-#163 plus lucide-react / Zustand; wrangler 4.152 with regenerated Worker types; overrides.undici ^7.30.1 (miniflare pin, GHSA-xjj6-f33q-929c) and zod 4.6.7; knip follows CSS imports; cargo update (tauri 2.12.5, tokio 1.54.1); certifi / coverage / Ruff; actions/setup-python 7.1.0; version 4.4.3.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 14:15:45 +07:00
poli0981andClaude Opus 5.5 40b17e620d ci(sonar): analyse in GitHub Actions with test coverage (#157)
SonarQube Cloud analyses in GitHub Actions instead of Automatic
Analysis, with test coverage (sonarcloud.yml): token (skips Dependabot
and fork PRs, which get no SONAR_TOKEN) → coverage (pytest-cov and
Vitest v8, no secrets) → scan (sonarqube-scan-action v8.3.0, full
history, sonar.projectVersion from webapp/package.json).

sonar-project.properties replaces .sonarcloud.properties: tests marked
as tests, coverage exclusions for code without unit tests by design,
Python 3.14 (the analyzer has no 3.15 yet), binary images and the
SQLite migrations (claimed by the PL/SQL analyzer, which only warned)
left out.
Adds pytest-cov / coverage (dev lock recompiled on Python 3.14) and
@vitest/coverage-v8 (Dependabot group with vitest). Docs: CLAUDE.md
gotcha 41, THIRD_PARTY, dev_env, CONTRIBUTING (EN + VI).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 20:30:20 +07:00
poli0981andClaude Opus 5.5 999d0887ee Fix the SonarQube Cloud findings; release 4.4.2 (#155)
The first SonarQube Cloud scan reported 57 issues. 45 are fixed in code, the 11 on the saved itch.io test pages leave the scan via .sonarcloud.properties, and css:S8776 (Tailwind's @utility nesting) is a false positive to mark on SonarQube Cloud.

Worker: trailing slashes and the gate cookie's padding are trimmed by trimEnd() instead of /\/+$/ (quadratic on the public 404 path); the feed and collection parsers lose their backtracking regexes; compareCodeUnits keeps the code-unit sorts (the rule's localeCompare is locale-dependent); Number.*, DEFAULT_SIZES, crypto.randomUUID; i18n-edit.mjs reads stdin. Pipeline: the NSFW notices are one selector list, either class (the rule's ".a.b" would need both), each tested; plain if-guards; update_info.main returns None; no plain-http adapter; [[ ]] in cf_build_status.sh.

Supply chain: requirements*.txt are hash-locked pip-tools compiles of requirements*.in (on Python 3.14, which Dependabot reads from the header), installed with --require-hashes --only-binary :all: in block scalars; npm ci --ignore-scripts in CI and the release builds (verified by manual release runs on all platforms); npm run cf:check.

Release 4.4.2: also ships the toolchain upgrade (#149, #154) and Dependabot #141-#148, #150, #152, #153. CLAUDE.md gotchas 40 and 41.

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 18:16:12 +07:00
poli0981andClaude Opus 5.5 41ad57f229 Move the Python pin out of Dependabot's reach
Dependabot's pip updater reads .python-version and supports Python
3.10-3.14 only, so the 3.15 pin from the toolchain upgrade aborted both
the pip version updates and the pip dependency graph ("Dependabot
detected the following Python requirement for your project: '3.15.*'").

The pin now lives in .github/python-version, read only by setup-python's
python-version-file (python-ci, refresh scan + apply, update); Dependabot
falls back to its default 3.14, which every pinned package supports.
Move it back once Dependabot lists 3.15 (CLAUDE.md gotcha 39).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 08:57:03 +07:00
poli0981andClaude Opus 5.5 3e82f720dd Upgrade toolchain: TypeScript 7, Node 26, Python 3.15
TypeScript 7.0.2 (the native compiler) now runs `tsc -b` in `npm run build`.
It has no JavaScript API until 7.1, and typescript-eslint (peer
typescript <6.1) and scripts/i18n-edit.mjs need one, so the two are
installed side by side: `@typescript/native` = npm:typescript@^7.0.2
(bin tsc) and `typescript` = npm:@typescript/typescript6@^6.0.2 (the 6.0
API, bin tsc6). No tsconfig or source change: TS 7 reports 0 errors.

Node 26: webapp/.node-version 24 -> 26 (CI and both release workflows read
it), engines >=26, @types/node 26. npm 11.20 gates dependency install
scripts on `allowScripts`, so esbuild and workerd are approved by name.

Python 3.15: .python-version 3.14 -> 3.15, ruff target py315, urllib3
declared (scraper.py imports it). UTF-8 mode is the default since 3.15,
so the workflows drop PYTHONUTF8.

Dependabot: keep the `typescript` alias off new majors, group
@typescript/*, @types/node up to 26. Docs and CLAUDE.md follow (gotcha 6
rewritten, gotcha 38 for allowScripts).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 08:41:26 +07:00
poli0981andClaude Opus 5.5 f199e2ea17 Retire the browser extension's ingest API; release 4.4.1 (#138)
The browser extension (poli0981/itch-f2p-extension) and the Telegram bot (poli0981/telegram-scraper-bot) are archived. Removed: POST /api/ingest (ingest.ts, requireService, the idempotency store, RL_INGEST, ACCESS_AUD_INGEST; it never received a game), the admin's "Browser extension" auto-approve source and "Extension" queue label, and the About page's Telegram numeric-ID note. No D1 migration: the idempotency table and the 'ext' CHECK stay.

Policies (Privacy, ToS, EULA + installer RTF, Disclaimer, Security; EN + VI) drop the extension / ingest wording; Last updated 2026-10-16, LEGAL_VERSION unchanged. Docs, CLAUDE.md and pipeline comments updated.

Release 4.4.1 (also ships #131, #135, #136, #137).

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 17:56:46 +07:00
poli0981andClaude Opus 5.5 f2a5135993 v4.4.0: admin automation, bulk remove/edit, theme icon, smooth chart tabs (#133)
Admin: add games from any list or itch.io collection (Check first, batches of 200, per-game ingest tracking from scripts/state/ingest_outcomes.json), followed collections and auto-approve run by the cron in one [auto] commit, bulk remove/edit up to 100 games in one commit, New games, Activity and Settings pages. D1 migration 0002 (applied to production before this merge). Policies (ToS, Privacy, Disclaimer, EN + VI) cover approval by the maintainer's rules; LEGAL_VERSION 2026-10-13.

Web: the theme button shows the theme in use, no dark-mode flash (pre-paint script, hash in three CSPs), Charts tabs stay mounted (no rebuilt charts or replayed animations), 300 ms entrances, scrollbar gutter on mouse devices.

Release 4.4.0 (changelog also covers #130).

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 10:08:33 +07:00
poli0981andClaude Opus 5.5 ec3ff9ab3a fix(charts): phone layout of the Charts page (#130)
Below md: a one-row tab bar (the Vietnamese labels had wrapped out of the
fixed-height bar), 12px legends and 11px ticks, horizontal Languages and
Avg session bars, the reason under each recent deletion, the KPI total
across the row, a taller Genres card.

At every size: all 15 Genre labels on one line (Recharts had hidden 8,
the two largest included), pie legends in data order with muted text,
translated removal reasons (reasonKey in lib/deleted-reason), locale axis
numbers, treemap labels that fit their cells, no "(made_with[0])" in the
engine chart's description. CLAUDE.md: chart notes, gotcha 32 and the
unreleased-on-main note.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 13:02:50 +07:00
poli0981andClaude Opus 5.5 3199ec4be3 fix(pipeline): strike password-protected itch.io pages; CLAUDE.md names the new signing key (#129)
itch.io answers a password-protected game with HTTP 200 and its password form (div.game_password_page / input[name=game_password]); the refresh counted it as a parse failure forever. scraper.is_password_protected() recognises it; refresh gives a "private" strike ("Game page is password-protected", removed when seen again >= 20 h later, counted by the mass-change guard); update_info drops such links as a final outcome; the Removed page and Deletion Reasons chart label the reason (EN/VI). CLAUDE.md names the new signing key 838884804847BE7AE5FCF0A96AD1AB0921B96825; 03F965C2E2DB5C6B is revoked.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 15:40:21 +07:00
poli0981andClaude Opus 5.5 cecee9c8a1 docs: CLAUDE.md marks v4.3.0 as released, with the re-scrape outcome (#128)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 15:28:00 +07:00
poli0981andClaude Opus 5.5 9418e1d5ee chore(deps): clear the 5 Dependabot alerts; CI guard for Tauri crate/npm versions (#120)
Security (transitive npm deps; npm audit: 0): seroval 1.5.6 -> 1.6.9 (critical + high, via solid-js 1.9.17), sharp 0.35.4 -> 0.35.5 (high, via wrangler 4.149.0 / miniflare), source-map-js 1.2.1 -> 1.2.2 (high), smol-toml 1.8.0 -> 1.9.1 (medium); worker-configuration.d.ts regenerated for wrangler 4.149.

Tauri guard: Webapp CI runs `npm run check:tauri` (scripts/check-tauri-versions.mjs: Tauri crates vs their npm packages must share major.minor, as `tauri build` requires); Dependabot's cargo updates move to weekly Mondays like npm. CLAUDE.md gotcha 31.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 11:41:07 +07:00
poli0981andClaude Opus 5.5 000bbb0e9f fix(tauri): tauri-plugin-opener 2.7.0 to match @tauri-apps/plugin-opener (#119)
Dependabot moved the npm package to 2.7.0 (#109) while Cargo.lock kept the crate at 2.6.0; `tauri build` refuses mismatched major/minor versions, so every v4.3.0 release build failed before compiling. `cargo update -p tauri-plugin-opener` locks 2.7.0 and drops the windows 0.61 crates only 2.6.0 used. Checked with `npx tauri info` and `cargo check --locked`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 11:05:08 +07:00
poli0981andClaude Opus 5.5 8ba21485ff fix(workflows): force_update dispatches refresh.yml; queued runs scan the latest main (#118)
force_update.yml called refresh.yml through `uses:` and failed at startup ("workflow file issue", no annotation); it had never run since v4. It now dispatches refresh.yml with full=true (new workflow_dispatch input; refresh.yml drops workflow_call). refresh.yml's scan checks out the branch as it is when the job starts, so runs waiting in the refresh-pipeline queue see the previous run's state and consecutive force-update dispatches cover consecutive batches. Verified end to end on the branch (one URL re-scraped and applied to main as f03211d).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 10:57:39 +07:00
poli0981andClaude Opus 5.5 7f6994a9dc itch.io AI disclosure + accessibility, tagline descriptions; bump to 4.3.0 (#117) [skip-discuss]
itch.io game pages now carry an "AI Disclosure" row (AI Assisted, then what it was used for), a "Content" row ("No generative AI was used", /games/tag-no-ai) and an "Accessibility" row. The scraper reads them into three optional fields (ai_disclosure, ai_content, accessibility), which the daily refresh keeps current; description becomes the creator's tagline (og:description), else the first sentence as before; whitespace inside titles and links is collapsed. A --full re-scrape keeps a known release_date / thumbnail (itch.io shows "Published" only for a few weeks).

Web app: "Generative AI" and "Accessibility" filters on /games (?ai=, ?access=), game-page rows, three charts (Overview: Generative AI; Discovery: Accessibility Features, What AI Was Used For). EN/VI strings, docs, changelog, version 4.3.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 10:49:13 +07:00
poli0981andClaude Opus 5.5 b0ebb8e9c6 chore(wrangler): drop inherited workers_dev / preview_urls from env.staging (#110)
Both keys are inheritable in wrangler, so staging already resolves to
false from the top level (checked with unstable_readConfig). Vars,
bindings and the empty crons override stay: those are not inherited.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 08:38:25 +07:00
poli0981andClaude Opus 5.5 169f77f806 chore(deps-dev): wrangler 4.147 (undici advisories via miniflare) (#107)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 19:38:56 +07:00
poli0981andClaude Opus 5.5 605d14f022 docs: CLAUDE.md marks v4.2.0 as released (#106)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 19:32:11 +07:00
poli0981andClaude Opus 5.5 a3bfe04b40 Compact catalog packs, binary cache, themed scrollbars; bump to 4.2.0 (#103) [skip-discuss]
- Catalog packs: the build emits /data/pack/manifest-v1.json plus
  content-hashed deflate-raw packs (columns + dictionaries); the site and
  the apps read them (about 264 KB on a first visit instead of about 520 KB
  of JSON). Descriptions live in their own packs and load on demand (a game
  page: its chunk; a search: all of them).
- The IndexedDB cache is stored as compressed bytes by a small binary
  persister (replaces @tanstack/query-async-storage-persister); fflate is
  the lazy fallback where the browser has no Compression Streams.
- The readable /data/*.json goes only to apps 4.0-4.1.1 (Tauri Origin);
  everyone else gets a 410 with links to the repository
  (worker/legacy-data.ts, five positive run_worker_first entries).
- /img: exact width strings only, fallback originals and missing images
  kept at the edge for a day, failed background puts are logged.
- Themed scrollbars and a "Hide scrollbars" setting (Settings and the
  display menu); chart cards no longer block their list scrollbars.
- Policies (LEGAL_VERSION 2026-10-03): data reuse goes through the
  repository. Docs, changelog and version 4.2.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 19:19:42 +07:00
poli0981andClaude Opus 5.5 cb12c0c326 Move contact addresses to @poli0981.dev, bump to 4.1.1 (#99)
- contact@ / legal@ / privacy@ / security@ / takedown@poli0981.dev
  (Google Workspace aliases) replace the @freeitchgames.win addresses in
  the policies (EN + VI), READMEs, issue templates, security.txt and the
  installer EULA.
- Privacy Policy: Google Workspace replaces Cloudflare Email Routing as
  the email processor (provider table, transfers, contact section).
- About page: website, contact email and the poli0981.dev/links hub;
  mailto: links open without a blank tab; the apps may open mailto:.
- LEGAL_VERSION 2026-09-29, so the legal gate asks once more.
- Version 4.1.1 (about.ts, package.json, tauri.conf.json, Cargo.toml/lock).

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 23:12:08 +07:00
poli0981 08dd4b6172 Merge pull request #91: v4.1.0 — verification gate, readable chart tooltips, changelog split [skip-discuss]
Release 4.1.0: Turnstile verification gate (inert until its secrets exist), readable chart tooltips, changelog split into changelog/, legal and docs refresh.
2026-09-24 18:22:02 +07:00
poli0981andClaude Opus 5.5 e73c2ee985 chore(release): 4.1.0
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 18:07:38 +07:00
poli0981andClaude Opus 5.5 7b73db9697 docs: bring the runbook, READMEs and notes up to date
- operations.md: verification gate setup (bot token, Transform Rule,
  header check, GATE_SECRET last, smoke tests, off switch); Web Analytics
  is injected by the zone (checked live), not a build token; staging is
  deployed by hand from any branch; a release checklist replaces the
  finished v4 release order; the unused repo secrets can go.
- CLAUDE.md: gate, chart and changelog notes, three new gotchas, current
  counts, .rpm, announce-discussion.yml is local, current state.
- READMEs (EN/VI): the quick check, list layout on phones, .rpm,
  TanStack Query only, the build monitor, cf_build_status.sh.
- dev_env (EN/VI): GATE_* secrets, PKCS#1 keys work as downloaded.
- webapp/README, TAURI.md, THIRD_PARTY.md, CONTRIBUTING (EN/VI): lazy
  routes, .rpm, Cargo.lock is committed, squash or merge commit.
- _headers: caching for favicon.svg and the web manifest; comments.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 18:06:21 +07:00
poli0981andClaude Opus 5.5 251369ede6 docs(changelog): one file per minor version under changelog/
CHANGELOG.md had grown to 805 lines across four major versions. The
notes now live in changelog/<major>.x/ver<major>.<minor>.x.md (newest
first); CHANGELOG.md is the index. Each index row keeps the anchor of the
old single-file heading, so the release notes that link to
CHANGELOG.md#<entry> still land on the right row.

- Entries moved verbatim; repo-relative links rebased (../../), links to
  files deleted since are pinned to the release's tag.
- Dated 1.0.2 and 1.0.3 (both released 2026-01-01); short entries that
  point to the GitHub release for 3.0.1, 3.1.0 and 3.1.1, which never
  had one; the "gotcha #18" reference now names the gotcha instead.
- 4.1.0 notes added.
- announce-discussion.yml also watches changelog/**.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 18:01:52 +07:00
poli0981andClaude Opus 5.5 fdf0645829 docs(legal): verification cookie and Turnstile check in the policies
The Privacy Policy said the Project's code sets no cookies and that
Turnstile runs only on the Suggest page. With the verification gate:

- Privacy (EN/VI): the Turnstile check before the site loads (about once
  per 48 hours, verified bots exempt, /data open), the __Host-fig_gate
  cookie (issue time + signature, 48 h, strictly necessary), the
  webapp.gate storage entry, retention, Cloudflare's role.
- ToS (EN/VI): don't circumvent the verification check or share its cookie.
- EULA (EN/VI/RTF): list the .rpm package v4.0.0 already shipped.
- LEGAL_VERSION and the About page date → 2026-09-24, so the legal gate
  asks everyone once more.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 17:58:35 +07:00
poli0981andClaude Opus 5.5 2c2d990f33 feat(worker): Turnstile verification gate for the web app
Until a visitor passes a Cloudflare Turnstile check, app pages ("/" is
now Worker-first too) answer with a self-contained verification page and
/img covers with 403, so a browser loads nothing of the site before the
check. Passing sets an HttpOnly, host-only cookie (HMAC of its issue
time) good for BOT_GATE_TTL_HOURS (48). The page then reloads into the
link that was asked for, and the legal gate follows as before.

- /assets, /data (desktop/Android apps, CC BY reuse), robots, sitemap,
  og image, /api/* and /admin* stay ungated.
- Verified bots pass with the token a zone Transform Rule adds
  (x-fig-known-bot); clients that only claim to be a search crawler get
  a 503, never the noindex page.
- Fails open: it needs BOT_GATE="on", the Turnstile keys, GATE_SECRET
  and GATE_BOT_TOKEN; deleting GATE_SECRET switches it off at once.
- POST /api/verify: same-origin, RL_GATE (IPv4 / IPv6 /64), siteverify
  with action "gate". GET reports the pass for the page and the SPA.
- turnstile.ts: siteverify shared with Suggest, which now also checks
  the hostname and action (a token from one page can't be spent on the
  other) and answers 503 when Turnstile is unreachable.
- SPA: a tab whose pass ran out re-checks when shown again or when a
  cover fails, and reloads into the verification page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 17:56:33 +07:00
poli0981andClaude Opus 5.5 3ce23dec17 fix(charts): readable hover tooltips and cursor
The chart colours wrapped the hex design tokens in hsl() ("hsl(#efefec)"),
an invalid colour: SVG painted the bar hover band black and the tooltip
lost its background and border. Recharts 3 also focuses the chart on a
mouse click, so Chromium drew its focus ring and pinned the tooltip on
the first item.

- chart-theme.ts: shared Tooltip props and cursors using var(--x).
- chart-tooltip.tsx: one tooltip body for every chart (popover colours,
  series swatch, locale-formatted numbers, share of the whole on the
  pies that cover it, formatted dates on the count chart).
- Translated series names instead of the raw dataKey ("count").
- Pie seams and treemap cells use the card/background tokens.
- Clicks no longer move focus into a chart; keyboard focus keeps the
  --ring outline.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 17:43:43 +07:00
poli0981andClaude Opus 5 066f368b53 fix(worker): accept the GitHub App key as downloaded (PKCS#1)
Approving from the queue failed with 500 "internal_error"; the Worker log
said: TypeError: "pkcs8" must be PKCS#8 formatted string. GitHub downloads
App keys as PKCS#1, which WebCrypto cannot import.

- github.ts wraps a PKCS#1 PEM into PKCS#8 itself (and turns two-character
  "
" escapes into newlines), so the downloaded key works unchanged.
- GitHub failures throw GitHubError and the admin API answers 502
  github_error with the reason, instead of a bare internal error.
- Admin CSP allows the Cloudflare beacon the zone injects into every HTML
  response; dropped browsing-topics from Permissions-Policy (Chrome no
  longer knows the feature and logs an error on every page).
- Docs: the key needs no openssl conversion any more.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 15:38:05 +07:00
poli0981andClaude Opus 5 00b517e069 docs(changelog): date the 4.0.0 release [skip-discuss]
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 22:19:56 +07:00
poli0981andClaude Opus 5 e4a5ee532d fix(worker): keep the dashboard settings in wrangler.jsonc; Access fixes
- wrangler.jsonc vars now hold the production values set in the dashboard
  (GitHub App ids, Access team domain and AUD tags, Turnstile site key).
  A deploy replaces plain-text variables with the file's values, so the
  next data commit would have blanked them.
- access.ts: ignore a trailing slash in ACCESS_TEAM_DOMAIN (the issuer is
  the bare origin; the dashboard value had one).
- /admin redirects to /admin/ (the path the Access application covers), so
  the visitor gets the login page instead of a 403.
- Runbook: values must be changed in the file.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 22:18:37 +07:00
poli0981andClaude Opus 5 951aaff823 docs(claude): v4 is live — record go-live state and open setup
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 21:31:24 +07:00
poli0981 a87264456c Merge v4: Cloudflare Worker site, review queue and redesign (#88)
v4.0.0: Cloudflare Worker site, review queue and redesign (go-live)
2026-09-18 21:23:46 +07:00
poli0981andClaude Opus 5 902384ea2f feat(web): v4 redesign — top nav, Welcome page, URL-synced filters (v4 Phase 3)
Implements the approved mockup (Free Itch Games, dark and light).

- Tailwind CSS 4 via @tailwindcss/vite (no PostCSS / tailwind.config), design
  tokens in src/index.css, tw-animate-css, self-hosted Geist / Geist Mono.
- A sticky top nav (global search with the / shortcut, display menu for
  theme / language / density / 18+, phone sheet menu) and a footer replace the
  sidebar; the window scrolls, with scroll restoration on back / forward.
- Welcome page at / (catalog status, features, recently added) replaces the
  dashboard.
- Games: search, genre / platform / status / tags / language / input / engine,
  minimum rating, plays-in-browser, sort and page live in the URL
  (lib/game-filters.ts, unit-tested); facet counts ignore their own filter;
  a table on desktop, a list on phones, 100 per page. Counts show the whole
  catalog while 18+ games are hidden.
- New game detail page (breadcrumb back to the same list, facts, tags that
  open the matching list, copy link, report a problem), searchable Removed
  page, simpler Settings, restyled error pages and charts header.
- Legal gate is an overlay above the page (deep links land where they
  pointed), with translated document names; no "Leave" button in the apps.
- Cached data stays on screen when a background refresh fails (offline).
- Numbers and dates follow the language (lib/format.ts).
- New favicon, PWA icons and OG image from the same tokens
  (scripts/gen_assets.py uses the Geist fonts from node_modules).
- Removed: sidebar, dashboard, data-table components, TanStack Table /
  Virtual, sonner and toast settings, the unused Select primitive; 81 unused
  i18n keys; prefs now persist only the keys still in use.
- Review fixes: routers without startTransition (useSearchParams was stale,
  so quick filter clicks and typed searches overwrote each other or pulled
  the visitor back from a game); paging starts at the top and Back returns
  to the old position; the 18+ confirmation is an in-app dialog
  (window.confirm is a no-op in the macOS app); the apps show only the legal
  gate until it is accepted (covers load from itch.io there); breadcrumb goes
  back; named popovers, list semantics, IME-safe Enter, English plurals,
  pointer cursor, --brand-soft without color-mix, copy-link fallback.
- wrangler.jsonc: id of the production D1 database (created by command,
  0001_init applied); runbook notes that R2 must be enabled first.
- Docs: CLAUDE.md, CHANGELOG, webapp README / TAURI.md, THIRD_PARTY,
  ACKNOWLEDGEMENTS, docs/operations.md; Dependabot groups for Tailwind 4.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 21:21:14 +07:00
poli0981andClaude Opus 5 6f4a956855 docs: v4.0.0 licenses, policies and documentation (v4 Phase 5)
Licenses
- Code stays MIT (LICENSE: 2025-2026 poli0981 (SkullMute)). The catalog
  data (data_game/LICENSE.md) and the documentation are CC BY 4.0 (full
  legal code in LICENSES/CC-BY-4.0.txt); creators' descriptions, cover
  images, names and trademarks are excluded. NOTICE.md: license map and
  non-affiliation with itch.io.

Policies (English + Vietnamese mirrors, dated 2026-09-18, applying from
4.0.0)
- Terms of Use now cover the website and the public data, with the
  content-removal / copyright process, prohibited uses (bulk scraping,
  /img abuse, /admin and ingest access, Suggest spam), 18+ opt-in and
  Vietnamese law with the consumer-rights reservation.
- Privacy Policy rewritten for Cloudflare as processor: exact browser
  storage, cookies, Turnstile, D1 retention (Suggest notes 180 days,
  idempotency 7 days), rights under Law No. 91/2025/QH15 and the GDPR.
- EULA covers only the desktop and Android apps (also the installer RTF).
- Disclaimer, Security Policy (private reporting, scope, safe harbor) and
  Code of Conduct (Contributor Covenant 2.1) rewritten; PAT, GPG and
  Telegram-bot material removed.

Docs and templates
- README / CONTRIBUTING (EN + VI), webapp/README, TAURI.md, dev_env
  (EN + VI), THIRD_PARTY, ACKNOWLEDGEMENTS; new docs/operations.md
  (Cloudflare + GitHub setup, v4 release order, routine tasks).
- CLAUDE.md rewritten for the v4 architecture; CHANGELOG [4.0.0].
- Issue templates: config.yml (Suggest page + private security reports),
  "Add games" points to /suggest, "Remove a game" gained a rights-holder
  section; PR templates updated; CODEOWNERS.
- Dependabot npm version updates resume with the v4 merge (limit 5).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00
poli0981andClaude Opus 5 41a8f8461f fix: Phase 4 review findings (admin, ingest, suggest)
Worker
- The local DEV_ADMIN_EMAIL bypass keeps the same-origin check for
  writes, and JSON bodies must be exactly application/json (a cross-site
  `text/plain; application/json` POST no longer gets through without a
  preflight).
- Request bodies are capped while they stream (a chunked upload without
  Content-Length is never buffered past 4 KB / 64 KB).
- count_history.json is rewritten when today's row already exists
  (upsertCountHistory no longer mutates the rows it was given).
- A game that entered the catalog through the queue, was removed and turns
  up again is reviewed again (flagged previously removed) instead of being
  blocked as "already pending" for good.
- Restoring / approving a removed game no longer deletes its public
  removal record up front: the Worker allow-lists it in
  scripts/state/unblocked.json, update_info.py scrapes it despite the
  deleted log, and apply_patch.py drops the log entry only when the game is
  really re-added (a still-paid or dead game keeps its record).

Admin app
- The editor compares against what the repository holds (published data
  or what was saved in this session), so saved changes can be reverted and
  are never dropped silently.
- An Access session that expires mid-session shows a sign-in banner from
  any request, without losing what is on the page.
- Restore refreshes the queue; knip now checks the admin entry.

Suggest page
- The form doesn't let the browser's URL check block links without
  https:// (the page and the server accept them).
- A failed config request shows an error with Retry instead of a
  permanently disabled form or a false "closed" message.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00
poli0981andClaude Opus 5 369de32c2b feat(web): Cloudflare Web Analytics beacon from a build variable
The cookieless beacon is added to the public page only when the web build
has VITE_CF_BEACON_TOKEN (Workers Builds variable; manual site setup with
automatic injection off), never to the admin page or the Tauri apps. The
site CSP already allows it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00
poli0981andClaude Opus 5 6f8b9ed490 feat(web): 18+ games hidden by default, /removed, version 4.0.0
- Games marked nsfw=Yes are left out of the table, dashboard and charts
  unless the visitor opts in (Settings -> Content, after confirming they
  are 18+; stored only in this browser). Their detail pages show a notice
  instead. The admin app still sees everything.
- /deleted is now /removed (301 from the Worker, redirect in the SPA,
  sitemap and canonical updated); <html lang> follows the language.
- Legal links: the gate lists only the documents being accepted (ToS,
  Privacy, Disclaimer, and the EULA inside the apps) and asks to confirm
  the visitor is 16+; new "Licenses & notice", "Data license" and
  "Content removal" links; the retired Telegram bot link is gone.
  LEGAL_VERSION 2026-09-18, so everyone is asked once more.
- Version 4.0.0 in about.ts, package.json (+ "license": "MIT"),
  tauri.conf.json (+ bundle copyright), Cargo.toml / Cargo.lock.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00
poli0981andClaude Opus 5 cbe3e389ea feat(web): admin app and public Suggest page (v4 Phase 4)
- webapp/admin/: a second Vite entry (/admin/, HashRouter), served only
  by the Worker after the Access check, with its own CSP. Review queue by
  status (approve, approve with override for previously removed games,
  reject), paste-to-add URLs, and a catalog editor for the three
  maintainer fields, removal with a public reason, and restore of removed
  games. Uses the published /data for search; every write is applied to
  the latest repository state by the Worker. An expired Access session
  surfaces as "sign in again" instead of a broken request.
- /suggest (web only; the desktop/Android apps link to the website):
  itch.io link + optional note (<= 500 characters, deleted after 180
  days), Cloudflare Turnstile loaded on demand, EN + VI strings.
- Local development: DEV_ADMIN_EMAIL in .dev.vars lets `wrangler dev` on
  localhost into the admin without Access; it is ignored on any other host.

Checked in wrangler dev with a local D1: queue listing, reject, approve
answering "GitHub App not configured", catalog search/editor, and a
Suggest submission (Turnstile test keys) landing in the queue; no CSP
violations.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:01 +07:00
poli0981andClaude Opus 5 8f121a8e9c feat(worker): review queue, admin API, ingest and suggest endpoints (v4 Phase 4)
Adds the server side of the admin and the automatic game discovery. The
catalog stays JSON in this repo; the Worker writes it as a GitHub App
(GraphQL createCommitOnBranch with expectedHeadOid: verified commits,
retried on a race) and keeps only the review queue in D1.

- worker/admin.ts: /api/admin/* (queue list, approve/reject, add, edit the
  three maintainer fields, remove with reason + R2 cover cleanup, restore)
  and the /admin shell with its own CSP. Every request re-verifies the
  Cloudflare Access JWT (aud + maintainer email + same-origin writes).
  Approving commits to scripts/temp_link.json, which starts update.yml.
  The maintainer's email goes to the D1 audit log only, never a commit.
- worker/ingest.ts: POST /api/ingest for the browser extension (Access
  service token, per-client rate limit, Idempotency-Key replay, <= 150
  items / 64 KB), replacing its PAT commits.
- worker/suggest.ts: public POST /api/suggest (same-origin, per-IP rate
  limit, Turnstile siteverify, canonical itch.io URL) into the queue.
- worker/discover.ts + scheduled(): every 4 h, one itch.io RSS feed
  (round-robin, 6 h back-off on 429) into the queue, then reconcile
  (queued -> ingested / failed) and retention (idempotency 7 d, form
  notes 180 d).
- worker/queue.ts: URL classification (catalog, pending, deleted,
  blocklist) and the D1 store; worker/repo.ts builds each admin commit
  from the files at the head of main, byte-compatible with the Python
  pipeline (golden fixtures).
- wrangler.jsonc: D1 (bound by name; migrations applied by hand), rate
  limits, cron, non-secret settings as vars (empty until setup: features
  answer 503 until configured), staging env without the cron.
  `npm run cf:types` ignores .dev.vars so the committed types are stable.
- Tests: 159 passing; the SQL runs against a real local D1 (workerd via
  wrangler's platform proxy).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:01 +07:00
poli0981andClaude Opus 5 ce177d8f27 fix(web): review findings on the Worker platform (v4 Phase 2)
- Missing files no longer get the app shell: `not_found_handling: "none"`
  and worker/spa.ts answer /assets/*, /data/* and file-like misses with a
  real 404 (no-store). A stale hashed chunk used to get index.html with
  the year-long immutable cache of /assets/*. Routes get the shell with
  200; unknown paths and unknown game slugs get it with 404.
- Recharts is off the first load again (~314 -> ~195 KB gzip): drop the
  vendor-charts group, which captured React and clsx, and give
  vendor-react the top priority.
- Web build target restored (Safari/iOS 15.4): Vite 8's default shipped
  Radix class static blocks unlowered, a blank page on iOS 15.
- The allow-list cache shares only loaded values, never an in-flight
  promise: a cancelled first /img request hung every later one.
- /img answers upstream resets and R2 errors with a 502 instead of an
  uncaught exception, and releases unused upstream bodies.
- Per-route canonical + robots (useSeoHead) instead of a static root
  canonical and og:url on every page.
- Legacy hash redirect: crafted hashes (#//host, #/\host) go home
  instead of throwing before React mounts.
- Chunk-reload guard is time-windowed and storage-safe.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:01 +07:00
poli0981andClaude Opus 5 1910d61d08 feat(web)!: Cloudflare Worker platform, read-only app (v4 Phase 2)
BREAKING: the public web app has no sign-in anymore and uses real paths
(BrowserRouter); /add and /workflows are gone (admin comes in Phase 4).

Platform
- wrangler.jsonc: Worker (worker/index.ts) + static assets with SPA
  fallback; only /img/* and /api/* run the Worker. R2 binding THUMBS,
  `staging` env for the v4 pre-release Worker. worker-configuration.d.ts
  from `wrangler types` (checked in CI with --check).
- vite-plugins/catalog-data.ts bundles data_game + deleted log into
  dist/data (build fails on bad JSON / index mismatch), emits urls.json
  (thumbnail allow-list) and a real-path sitemap; version.json carries
  the build stamp so data-only rebuilds keep identical JS.
- Data is read same-origin from /data (Tauri: https://freeitchgames.win/data,
  CORS *); chunks load with allSettled.
- worker/img.ts: /img/<160|640>/<itch path> serves a WebP rendered once
  per image+width by Image Transformations and stored in R2 (edge cache
  → R2 → transform); catalog allow-list, fixed upstream host, hotlink
  block, streamed original on transform failure, 403/404 upstream → 404.
  15 vitest cases.
- Enforced CSP (same-origin + Web Analytics/Turnstile), cache headers for
  /assets, /data, og/icons; security.txt; robots disallows /api, /admin.

App
- Remove PAT/GPG sign-in, bulk edit/delete, undo, workflow dispatch,
  Octokit and OpenPGP (and ~220 write-path i18n keys); Settings keeps
  language/theme/density/notifications only.
- react-router 8 (unified package), React 19.3, TanStack/Recharts/etc.
  minors, Vite 8 rolldown codeSplitting groups; legacy #/ links are
  rewritten to paths; old PAT/GPG localStorage keys are cleared; reload
  once on vite:preloadError after a deploy.
- GameThumb uses the /img proxy (referrerPolicy no-referrer, N/A-safe).

Tauri
- Real CSP, drop the unused http plugin + capability, read-only
  descriptions, rust-version 1.88, drop the time pin, commit Cargo.lock.

Also: remove the GitHub Pages redirect workflow/stub (deployed by v4
Phase 0); add scripts/i18n-edit.mjs (TS-parser based key maintenance for
en.ts/vi.ts).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:54:49 +07:00
poli0981andClaude Opus 5 e020be12fa feat(pipeline): rotating refresh + patch/apply pipeline, drop lists/ (v4 Phase 1) (#82)
* feat(pipeline): rotating refresh + patch/apply pipeline, drop lists/

Replace check_paid / check_alive / update_reviews / update_status: each
crawled all 2,600+ pages sequentially, overran its job timeout, saved
only at the end and has lost every run since late June (unreported:
timeouts end as "cancelled").

- scripts/refresh.py: daily slice of ~1/7 of the catalog (pending
  strikes first, then least recently checked), one GET per game for
  alive / paid / rating / status (+ release_date, thumbnail, updated_at
  backfill). Removal needs the same 404/410 or paid strike on two
  different UTC days. Paced requests, capped Retry-After back-off, stop
  after 3x 429, checkpoints and an in-script deadline. --full replaces
  force_update.py (rotating batches, editable fields preserved).
- Scanners emit a URL-keyed patch (patch.py); apply_patch.py applies it
  to the latest main and runs validate.py; bash/commit_push.sh fetches,
  re-applies and retries pushes, so concurrent writers never clobber
  each other.
- update_info.py: canonical URLs (canonical.py), skip games in the
  deleted log, keep transient failures queued (max 3 runs, tracked in
  scripts/state/), stamp added_at, never drop links queued meanwhile.
- data_store.py: games stay in their chunk, re-slice only past
  thresholds, write only changed bytes; index/count_history change only
  with data (no more no-op commits).
- validate.py (schema, enums, canonical/unique URLs, index consistency)
  + normalize one invalid safe_virus ("y" -> "Yes").
- tests/: 85 network-free pytest cases, HTML fixtures (from sample/),
  shared URL vectors and golden chunk/serialization fixtures for the
  future Worker port.
- Workflows: refresh.yml (scan -> apply -> notify), update.yml (runs on
  queue change), force_update.yml (refresh.yml full mode),
  notify-failure.yml (Discord on failure/cancel/rate limit),
  python-ci.yml, webapp-ci.yml, deploy-status.yml; draft-first release
  with one create-release job and tauri-action v1, no caches in release
  builds; SHA-pinned actions, permissions: {} defaults, reusable
  workflows pinned with explicit secrets, injection fixes; dependabot.yml.
- Remove lists/, generate_md, generate_table, log_deleted,
  deleted_games.txt, the Telegram bot-ingest path and old bash wrappers;
  update README (EN/VI), CONTRIBUTING, templates, CLAUDE.md, CHANGELOG
  and mark the retired Telegram path in the policies.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(pipeline): review findings on the refresh / ingest rewrite

Removals
- Mass-change guard: a run whose removals or new strikes exceed
  max(10, 10%) of the games it checked withholds all its removals and
  alerts (mass_change). Withheld games are marked withheld_at and stay
  withheld in later (even single-URL or rate-limited) runs until a healthy
  check clears them or a run is dispatched with allow_mass_removal.
- Checkpoints never carry removals, so a scan that dies before its guard
  cannot delete games; apply_patch re-checks the per-run limit and caps
  any patch at max(25, 5%) of the catalog (ALLOW_MASS_REMOVAL=1 overrides).
- Strikes mature by time, not calendar day: a second sighting must come
  >= 20 h after the first (strike_at), so two checks around midnight UTC no
  longer remove a game.
- Overlapping scans can't undo each other: refresh_state merges keep the
  newest check and the newest full stamp in either apply order, and a
  removal is skipped when a newer check has landed since.
- A corrupt count_history.json fails the apply instead of being replaced
  by a one-row history.

Ingest
- A second spelling of a queued game no longer drops the first copy
  before it reaches a final outcome.
- A dispatched url is processed first and kept in temp_link.json
  (queue_add) until it finishes, so a retry, deadline or rate-limit stop
  keeps it.
- Failures count as an attempt only >= 6 h apart and a 429 counts as none,
  so a burst of queued runs can't burn a link's three attempts.
- Non-string queue entries are cleaned on every apply instead of crashing
  it; {"url": ...} objects are unwrapped.

CI
- queue: max on the ingest, refresh-apply and force-update concurrency
  groups: the default queue replaced (and silently dropped) pending runs.
- Seed scripts/state/*.json and mkdir -p before git add (the pathspec
  failed on an empty patch until the directory existed on main).
- Cancelling a refresh / force-update / desktop release really stops it
  (!cancelled() instead of always()).
- deploy-status.yml becomes an hourly check of main's latest finished
  "Workers Builds: free-games-itchio-list" run (bash/cf_build_status.sh):
  GitHub never starts check_run workflows for GITHUB_TOKEN data commits.
- The reusable release notifiers still take their script from
  poli0981/.github@main; the caller comments now say so.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(pipeline): close the remaining mass-removal and monitor gaps

From the second review round of the pipeline fixes:
- A strike spike now marks every strike of that run withheld_at (the
  checkpoint of a run that dies mid-spike too), so a later short,
  rate-limited or single-URL run can't remove them without an
  allow_mass_removal dispatch.
- Withheld games take at most half of a run's budget (all of it for the
  allow_mass_removal run that confirms them), and a withheld full-mode
  game moves its `full` stamp, so neither rotation stalls on them.
- refresh.yml runs one scan -> apply pipeline at a time (workflow-level
  concurrency refresh-pipeline, queue: max), so an older removal can't be
  applied after a newer healthy check of the same game.
- deploy-status.yml alerts once per failed Cloudflare build, keyed on its
  check-run id and marked only after the Discord post, instead of by age
  (which could drop an alert after a missed run, or repeat it); the
  monitor walks main's first-parent history so preview builds of merged
  branch commits are never mistaken for the site's build.
- CLAUDE.md: merge PRs with squash or a merge commit, never by fast-forward.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:52:57 +07:00
poli0981andClaude Opus 5 1c600586a4 fix: deploy the real build to freeitchgames.win + Phase 0 hotfixes (#81)
- Add webapp/wrangler.jsonc (Workers static assets from ./dist, SPA
  fallback, workers_dev/preview_urls off) and build the web app to
  webapp/dist. The config-less Workers Builds deploy was serving the raw
  webapp/ source tree (blank page, /package.json and /src/* public).
- npm audit fix in-range (vite 8.3.0, react-router-dom 7.18.4, postcss
  8.5.28, transitive fixes): closes all Dependabot alerts, audit = 0.
  Add wrangler as a pinned devDependency, engines node >=22.22,
  .node-version 24.
- public/_headers: Referrer-Policy, frame denial, Permissions-Policy,
  COOP, CSP report-only; immutable cache for hashed /assets/*.
- release_android.yml: Node 24 action majors (setup-java v6,
  upload-artifact v7, setup-android v4, checkout/setup-node v7),
  SHA-pinned, timeout + concurrency, tag via env.
- GitHub Pages now publishes only a redirect stub (pages-redirect/)
  that keeps #/ routes and clears the old PAT/GPG localStorage keys;
  drop notify-deploy.yml.
- .gitattributes: fix invalid '* text = auto' / '* eol = lf'; binary
  rules; stop export-ignoring README/policy docs. .gitignore: local
  contacts/QR assets, wrangler state, .dev.vars, keystores.
- Scraper workflows: unbuffered UTF-8 logs; pause the schedules of
  check_paid/check_alive/update_reviews/update_status (full passes over
  2,600+ games exceed their timeouts and lose all work).
- Point canonical/og/manifest/sitemap/robots and doc links at
  freeitchgames.win; regenerate OG image (fit title); interim Cloudflare
  notice in the Privacy Policy.

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 16:26:06 +07:00
itch-f2p-ext[bot] 83a09446e0 ext: add 68 game(s) to temp_link [2026-08-16] 2026-08-16 09:58:01 +00:00
itch-f2p-ext[bot] 5fce82a411 ext: add 45 game(s) to temp_link [2026-08-16] 2026-08-16 01:46:47 +00:00
itch-f2p-ext[bot] 74de5a0fdb ext: add 1 game(s) to temp_link [2026-07-25] 2026-07-25 04:24:04 +00:00
itch-f2p-ext[bot] 3eae2be1d7 ext: add 43 game(s) to temp_link [2026-07-08] 2026-07-08 13:19:32 +00:00
itch-f2p-ext[bot] 4fcfcb056f ext: add 150 game(s) to temp_link [2026-06-30] 2026-06-30 06:10:46 +00:00
itch-f2p-ext[bot] 61e53c55db ext: add 3 game(s) to temp_link [2026-06-28] 2026-06-28 00:35:49 +00:00
itch-f2p-ext[bot] 9ebb166f6e ext: add 24 game(s) to temp_link [2026-06-27] 2026-06-27 13:53:46 +00:00
itch-f2p-ext[bot] d347f8d426 ext: add 7 game(s) to temp_link [2026-06-23] 2026-06-23 00:53:05 +00:00
itch-f2p-ext[bot] f6f4b784b3 ext: add 150 game(s) to temp_link [2026-06-21] 2026-06-21 03:52:38 +00:00
itch-f2p-ext[bot] 596895639c ext: add 78 game(s) to temp_link [2026-06-17] 2026-06-17 04:26:32 +00:00
poli0981andClaude Opus 4.8 316f258ba6 feat(android): raise minSdkVersion to 30 (Android 11) + document requirements (#77)
Raise the Android APK floor from API 24 (Android 7.0) to API 30 (Android 11).
minSdkVersion is the OS-level install gate, so Android refuses to install the
APK on versions below the floor -- no runtime check needed. Chosen for OS
security hardening + AOSP patch availability (pre-11 is off Google's monthly
Security Bulletins) and our tested range (emulator 11->latest, vivo 1907 /
Android 12). Reach: ~86.9% of active devices (was 96.6% at API 24).

- tauri.conf.json: minSdkVersion 24->30; version 3.8.0->3.9.0
- Cargo.toml + about.ts: version -> 3.9.0 (kept aligned, gotcha #18)
- webapp/TAURI.md: "Why Android 11" rationale + sources + tested devices
- README.md / README.vi.md: Android note 7.0/API24 -> 11/API30
- docs/pc_spec.md (+ vi): Android (Tauri APK) tested-devices table
- CHANGELOG.md: add [3.9.0]; backfill the missing [3.8.0] entry
- CLAUDE.md: gotcha #19 (minSdk floor rationale + reach table) + current state

Sources: endoflife.date/android, source.android.com Security Bulletins,
StatCounter version share (May 2026), apilevels.com (Apr 2026).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 20:51:54 +07:00
poli0981andClaude Opus 4.8 d371a0f8d0 docs(claude-md): mark v3.8.0 released + gradle-cache gotcha (#74)
v3.8.0 (Android APK) is tagged and released. Flip "in progress" -> released,
extend the tag range to v3.8.0, and note the release_android.yml gotcha:
setup-java `cache: gradle` hard-fails because gen/android is generated mid-job.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 15:26:05 +07:00
poli0981andClaude Opus 4.8 f08637db82 fix(ci): drop gradle cache from Android JDK setup (#73)
`actions/setup-java` with `cache: gradle` hard-fails because gen/android (the
Gradle project) is gitignored and only generated by `tauri android init` later
in the job — there are no gradle files at checkout to key the cache on. Remove
it; rust-cache + npm cache still apply.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 15:02:54 +07:00
poli0981andClaude Opus 4.8 3d5d4d0cf2 feat(android): Android APK build & packaging via Tauri mobile (#71)
Ship the webapp as a sideloadable arm64-v8a .apk alongside the desktop
installers — the same React + Tauri app running in an Android WebView.

- Fix the bundle identifier to be Android-valid (alphanumeric — Android
  rejects hyphens, Tauri rejects underscores):
  com.poli0981.free-games-itchio-webapp -> com.poli0981.freegamesitchio.
  release_desktop.yml now reads the macOS .pkg --identifier from config.
- Realign Tauri/Cargo/UI versions to 3.8.0 (sane, monotonic versionCode).
- Add bundle.android.minSdkVersion 24.
- New release_android.yml: arm64-v8a build, post-signed with zipalign +
  apksigner (gen/ stays gitignored — no Gradle edits). Attaches to the
  draft Release on a v* tag; uploads a workflow artifact on manual dispatch.
- Mobile UX: Android back button -> router history (useBackButton hook),
  safe-area insets, platform-aware sidebar badge (Desktop/Mobile app).
- Add @tauri-apps/api dependency; docs in TAURI.md, README(.vi), CLAUDE.md.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 14:59:31 +07:00
poli0981andClaude Opus 4.8 68d97d48cb fix(webapp): stop emitting source maps in the web build (#70)
The web build set `sourcemap: !isTauri` → true, so Vite emitted *.js.map
files and `sourceMappingURL` comments into docs/app/, exposing the
original TypeScript via DevTools on the deployed GitHub Pages site.

No error-tracking service consumes the maps (PrivacyPolicy confirms no
Sentry/Datadog), so disable them outright rather than using 'hidden'
(which would still publish fetchable .map files). The Tauri build was
already mapless; local `npm run dev` sourcemaps are unaffected.

Verified: build emits 0 .map files and 0 sourceMappingURL refs; lint clean.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 21:00:20 +07:00
itch-f2p-ext[bot] 2c83bb3443 ext: add 24 game(s) to temp_link [2026-06-14] 2026-06-14 11:42:55 +00:00
poli0981andClaude Opus 4.8 5afbf31cb5 docs(claude-md): record Tauri nsis.license gotcha (#15) + v3.7.1 state (#69)
bundle.windows.nsis.license does not exist in @tauri-apps/cli 2.11.0 and broke
the v3.7.0 desktop build; document the bundle.licenseFile (RTF) workaround so
future sessions don't relearn it. Bump current-state note to v3.7.1.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 09:09:09 +07:00
poli0981andClaude Opus 4.8 892e8fa23f release(v3.7.1): installer EULA via bundle.licenseFile RTF (working desktop build) (#66)
v3.7.0's desktop installers failed config validation on all platforms:
@tauri-apps/cli 2.11.0's NsisConfig has no `license` key (added in a later
release), so `bundle.windows.nsis.license` was rejected.

Switch to the top-level `bundle.licenseFile` (valid in 2.11.0) -> RTF EULA.
RTF satisfies BOTH Windows bundlers — WiX (.msi) requires RTF and NSIS (.exe)
auto-detects it — so both installers show the "I Agree" page. The previous
plain-text EULA.txt would also have broken the WiX/.msi build.

Bumps about.ts version 3.7.0 -> 3.7.1; adds CHANGELOG [3.7.1]. Web feature set
is identical to v3.7.0.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 08:56:33 +07:00
poli0981andClaude Opus 4.8 7d99881aff feat(v3.7.0): legal-acceptance gates + per-tab chart lazy-loading (#62)
Web: full-screen first-launch legal gate (LegalGate) blocks the app until the
user accepts the current LEGAL_VERSION; persists as prefs.acceptedLegalVersion
in localStorage (no cookie). Reuses LEGAL_LINKS; re-prompts on LEGAL_VERSION bump.
Built on raw Radix Dialog (focus-trapped, no close-X, Esc/outside-click disabled).

Desktop: Windows NSIS installer shows an EULA "I Agree" page via
bundle.windows.nsis.license -> src-tauri/installer/EULA.txt.

Charts: /charts split into four lazy per-tab chunks (charts/tabs/*). Each tab
imports its chart components directly (index.ts barrel removed) so the bundler
keeps each tab's components in its own chunk; non-default tabs' component code
loads only on activation. Recharts still loads with the default Overview tab.

Also: about.ts version -> 3.7.0 + Opus 4.8 credit; Privacy Policy localStorage
key note (EN + VI); CHANGELOG + CLAUDE.md updates.

Verified: eslint, tsc -b, knip, npm audit (0 vulns), ruff, vulture all clean;
browser smoke test of gate (appear / accept / persist / version-bump re-prompt)
and per-tab lazy loading (reach-tab + its charts load only on tab click).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 08:44:34 +07:00
poli0981andClaude Fable 5 95089ae500 docs(claude-md): catch up repo notes to v3.6.1 (#61)
- Webapp structure: document src/lib/i18n/ (en.ts source of truth, vi.ts lazy-only), react-query IndexedDB persistence in main.tsx (buster = APP.version, gcTime >= maxAge), and the error-handling stack (HttpError, error pages, /errors/:code preview, public/404.html)
- prefs store: note language preference
- Current state: v3.5.0 -> v3.6.1

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 23:27:29 +07:00
poli0981andClaude Fable 5 555fb33deb release(v3.6.1): pin time 0.3.47 - unbreak desktop builds (#58)
- time 0.3.48 (released 2026-06-12) fails to compile inside tauri-utils
  (E0119 conflicting From impls, time-rs/time#783); with no committed
  Cargo.lock, CI resolved it fresh and the v3.6.0 desktop build failed
- Pin time = "=0.3.47" in webapp/src-tauri/Cargo.toml (the version all
  releases through v3.5.2 built with); remove once upstream fix ships
- Bump version badges, about.ts, CHANGELOG to 3.6.1 (web unchanged from
  v3.6.0; no Tauri version bump - no binary behavior change)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 20:18:53 +07:00
poli0981andClaude Fable 5 af8dd83157 release(v3.6.0): i18n EN/VI, offline cache, custom error pages (#55)
- Minimal typed i18n layer (~454 keys) with lazy-loaded Vietnamese dictionary
  chunk; language switcher in Settings, preference persisted in webapp.prefs
- Persist react-query catalog cache to IndexedDB (instant paint on revisit,
  background revalidation; buster = app version, maxAge 7 days)
- Status-aware error pages (400-504, 419, offline, unknown) wired into every
  route via typed HttpError; route ErrorBoundary with new-version reload;
  hidden /errors/:code preview route; static 404.html for GitHub Pages
- Perf polish: GameThumb onError fallback, lazy settings avatar, DEV-gated
  react-query devtools
- npm audit fix: react-router 7.14.2 -> 7.17.0 (GHSA-8x6r-g9mw-2r78)
- Bump version badges, about.ts APP.version, CHANGELOG to 3.6.0

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 20:00:25 +07:00
itch-f2p-ext[bot] 28a30393f8 ext: add 150 game(s) to temp_link [2026-06-10] 2026-06-10 09:31:28 +00:00
itch-f2p-ext[bot] 6f7f104254 ext: add 134 game(s) to temp_link [2026-06-09] 2026-06-09 16:53:19 +00:00
itch-f2p-ext[bot] 35272ff193 ext: add 150 game(s) to temp_link [2026-06-08] 2026-06-08 16:23:47 +00:00
itch-f2p-ext[bot] fcff789d39 ext: add 2 game(s) to temp_link [2026-06-08] 2026-06-08 14:50:11 +00:00
itch-f2p-ext[bot] c1ff95f20c ext: add 2 game(s) to temp_link [2026-06-08] 2026-06-08 14:24:34 +00:00
itch-f2p-ext[bot] db3bafa156 ext: add 5 game(s) to temp_link [2026-06-06] 2026-06-06 03:22:55 +00:00
itch-f2p-ext[bot] 5e25b5926d ext: add 5 game(s) to temp_link [2026-06-04] 2026-06-04 03:40:45 +00:00
itch-f2p-ext[bot] 61b290402f ext: add 21 game(s) to temp_link [2026-05-25] 2026-05-25 15:51:40 +00:00
itch-f2p-ext[bot] 7d03a4c3ff ext: add 17 game(s) to temp_link [2026-05-23] 2026-05-23 13:13:22 +00:00
itch-f2p-ext[bot] a2755686af ext: add 10 game(s) to temp_link [2026-05-23] 2026-05-23 08:34:54 +00:00
poli0981andClaude Opus 4.7 199497a5a6 release(v3.5.2): dead-code cleanup + knip/vulture tooling (#52)
- Wire in knip (webapp) and vulture (Python) as dead-code detectors
- Remove 8 unused deps, the unwired Tauri scrape-preview scaffold, and
  ~20 unused exports/types across the webapp
- Add docs/THIRD_PARTY.md attributing the dev tooling; trim TAURI.md
- Bump version badges, about.ts, and CHANGELOG to 3.5.2

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 00:42:36 +07:00
itch-f2p-ext[bot] 63b31346ca ext: add 150 game(s) to temp_link [2026-05-22] 2026-05-22 11:22:56 +00:00
itch-f2p-ext[bot] d8f111a9ca ext: add 1 game(s) to temp_link [2026-05-21] 2026-05-21 11:44:59 +00:00
poli0981andClaude Opus 4.7 0f284ba04e release(v3.5.1): clean up ESLint — zero lint problems (#49)
- Turn off react-refresh/only-export-components for src/components/ui/**
  (vendored shadcn primitives) and react-hooks/incompatible-library
  (non-actionable TanStack Table warning) in eslint.config.js.
- Extract SortableHeader into its own data-table/sortable-header.tsx so
  columns.tsx is a pure column-definition module.
- Fix react-hooks/exhaustive-deps in games.tsx and faceted-filter.tsx —
  wrap values built with `?? []` so dependent useMemos actually memoize.
- npm run lint now reports 0 errors, 0 warnings (was 17 + 5).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 18:39:41 +07:00
poli0981andClaude Opus 4.7 ac8db6ab1d release(v3.5.0): charts expansion, game-count history, pipeline cleanup (#46)
- Add 6 charts (game-count line, genre treemap, KPI cards, deletions
  over time, deletion reasons, most-rated) and split charts.tsx into a
  charts/ module (one file per chart, shared chart-card + palette).
- Track catalog size over time: data_store.py appends data_game/
  count_history.json daily; backfill_count_history.py seeds it from git.
- Add scripts/json_io.py with shared load/save and a URL-keyed
  dedup_deleted so the deleted-games log can't double-log re-added games.
- Add a scroll-to-top button and a ruff config (pyproject.toml).
- Refactor docs for v3.5.0 (CHANGELOG, README badges, CLAUDE.md).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 13:32:52 +07:00
itch-f2p-ext[bot] 9d5d02d34e ext: add 45 game(s) to temp_link [2026-05-18] 2026-05-18 07:35:32 +00:00
poli0981 c5ef1502e7 chore(webapp): bulk-update 2 games (nsfw) 2026-05-17 19:55:37 +07:00
itch-f2p-ext[bot] b7745ba4da ext: add 150 game(s) to game_info [2026-05-17] 2026-05-17 12:46:05 +00:00
poli0981andClaude Opus 4.7 3fab1e94c9 release(v3.4.1): hotfix — DataTable column alignment + auto-discover Discussion IDs (#43)
- Fix DataTable header/body width mismatch at desktop widths (Tauri 1280×800
  and any viewport wider than the natural sum of header content widths). Header
  was native table-layout, body was flex — the absolutely-positioned virtual
  rows never participated in table layout, so the two diverged whenever the
  container had leftover space. Header `<tr>` now uses `flex w-full` and each
  `<th>` mirrors the body `<td>`'s flex style. Drops the table-cell variant of
  the priority helper.
- Rewrite `announce-discussion.yml` to auto-discover IDs at runtime via
  `gh api graphql`. Previous validation step silently `exit 0`'d on every run
  because the three required repo variables (`DISCUSSION_REPO_ID` +
  category IDs) had never been configured, so every release since v3.2.0
  failed to post to Discussions without flagging it. Zero config now; fails
  loudly if Discussions isn't enabled or a category is missing.
- README + README.vi badges + about.ts APP.version → 3.4.1.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-17 17:53:21 +07:00
itch-f2p-ext[bot] ca01b5969e ext: add 150 game(s) to game_info [2026-05-17] 2026-05-17 06:34:34 +00:00
poli0981 c654cc6f0c Update deployment trigger paths in workflow
Removed 'data_game/**' path from the deployment trigger.
2026-05-17 10:53:54 +07:00
itch-f2p-ext[bot] f9bd3443f2 ext: add 49 game(s) to temp_link [2026-05-17] 2026-05-17 03:42:23 +00:00
poli0981 179dedb7e3 chore(webapp): update annotations for Just Kiss Him Already! 2026-05-16 23:29:45 +07:00
poli0981andClaude Opus 4.7 500ff7fd02 release(v3.4.0): periodic refresh workflows + UTF-8 round-trip fix (#42)
- New scripts/update_reviews.py + bash + workflow on cron '0 5 1,15 * *':
  refresh rating + rating_count fortnightly via scrape_game_info, skip on
  network/parse errors so old values aren't blanked.
- New scripts/update_status.py + bash + workflow on cron '0 6 1 * *':
  refresh status monthly using the same pattern.
- New scripts/force_update.py + bash + workflow (workflow_dispatch only):
  optional url input; empty input re-scrapes every game. Always preserves
  safe_virus / notes / nsfw per CLAUDE.md "Editable vs read-only fields".
  Doubles as the canonical mojibake repair tool.
- Chain generate_table.yml on the three new workflows so lists/*.md regen
  automatically after data mutations.
- Fix UTF-8 mojibake on webapp writes: webapp/src/lib/github/contents.ts
  readFileWithSha and git-data.ts bulkDeleteGames decoded GitHub's base64
  content with atob alone (Latin-1 binary string). Multi-byte UTF-8 sequences
  became mojibake; next write re-encoded them as UTF-8, double-corrupting per
  edit cycle. Confirmed damage in data_game/game_info_002.json
  ('BotÃÂão Esquerdo' was 'Botão Esquerdo'). Extract shared helper
  webapp/src/lib/github/encoding.ts (base64ToUtf8 / utf8ToBase64) using
  TextDecoder('utf-8') / TextEncoder; route both call sites through it.
- Version bumps: README + README.vi -> 3.4.0, about.ts APP.version -> 3.4.0,
  new CHANGELOG entry, CLAUDE.md GitHub Actions table + gotcha #8 updated.
- No Rust binary change: tauri Cargo.toml / tauri.conf.json untouched.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-16 23:15:38 +07:00
poli0981andClaude Opus 4.7 c90e038585 release(v3.3.0): mobile polish + Settings cards + in-browser GPG commit signing (#41)
- Mobile fix: useIsMobile hook + MobileCardList (card view <md:) for games table;
  Workflows route dual-renders Select on mobile + TabsList on desktop;
  Charts TabsList gains flex-wrap defensively.
- Settings Phase A: four new cards in routes/settings.tsx
  (Appearance, Session, Commit author, Notifications) backed by extended prefs
  store (density, idleTimeoutMs, authorName/email, notificationsEnabled/Duration).
  AppToaster wraps sonner so notification settings apply globally.
- In-browser GPG signing: new webapp/src/lib/gpg/ module
  (canonicalize.ts, sign.ts, storage.ts) + stores/gpg.ts + components/settings/gpg-card.tsx.
  openpgp lazy-loaded into vendor-openpgp chunk (~129 KB gz). Private key decrypted
  once at import, re-encrypted with webapp passphrase (AES-GCM, same scheme as PAT).
  Settings card surfaces UID emails + warns on mismatch; auto-populates author email
  from primary UID on import.
- Refactor PUT contents -> Git Data API: all write paths (single-file edits,
  bulk edit/delete, temp_link.json queue) route through atomicCommit so signing
  applies uniformly. atomicCommit gains optional signer (defaults to
  getSignerIfEnabled()), threads canonical commit object + signature + author/
  committer blocks. Verified byte-for-byte against git cat-file commit <sha>.
- About page lists OpenPGP.js 6.3 under Data; CLAUDE.md + ACKNOWLEDGEMENTS.md
  updated; README + README.vi badges bumped to 3.3.0.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-16 22:37:31 +07:00
poli0981 cfd2295960 chore(webapp): update annotations for A Date with Death 2: REMNANTS 2026-05-16 22:26:07 +07:00