70 Commits
Author SHA1 Message Date
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 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 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
dependabot[bot] 3928fffdc7 chore(deps): Bump the actions group with 2 updates (#148)
Bumps the actions group with 2 updates: [actions/setup-java](https://github.com/actions/setup-java) and [dtolnay/rust-toolchain](https://github.com/dtolnay/rust-toolchain).


Updates `actions/setup-java` from 6.0.1 to 6.1.0
- [Release notes](https://github.com/actions/setup-java/releases)
- [Commits](https://github.com/actions/setup-java/compare/de7274f081f381c8f8158605e0321c36c376e2e6...b843ebf9b913146b38da2eaa7aeddf76074ae1ad)

Updates `dtolnay/rust-toolchain` from e2a55d2ffb04f378e9626c28d38b36d230d1e12f to 683b588c487a69d01f6c6ddf40f036ff682cc2c8
- [Release notes](https://github.com/dtolnay/rust-toolchain/releases)
- [Commits](https://github.com/dtolnay/rust-toolchain/compare/e2a55d2ffb04f378e9626c28d38b36d230d1e12f...683b588c487a69d01f6c6ddf40f036ff682cc2c8)

---
updated-dependencies:
- dependency-name: actions/setup-java
  dependency-version: 6.1.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
- dependency-name: dtolnay/rust-toolchain
  dependency-version: 683b588c487a69d01f6c6ddf40f036ff682cc2c8
  dependency-type: direct:production
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-21 02:19:10 +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
dependabot[bot] 8adf51daaa chore(deps): Bump the actions group with 4 updates (#124)
Bumps the actions group with 4 updates: [actions/upload-artifact](https://github.com/actions/upload-artifact), [actions/download-artifact](https://github.com/actions/download-artifact), [actions/setup-node](https://github.com/actions/setup-node) and [dtolnay/rust-toolchain](https://github.com/dtolnay/rust-toolchain).


Updates `actions/upload-artifact` from 7.0.1 to 7.0.2
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/043fb46d1a93c77aae656e7c1c64a875d1fc6a0a...cf430e030ddbb5b0abf93d22962f4752f3646cd9)

Updates `actions/download-artifact` from 8.0.1 to 8.0.2
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](https://github.com/actions/download-artifact/compare/3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c...9000827ccba6bdab643e8b6fd33ac0654aef8333)

Updates `actions/setup-node` from 7.0.0 to 7.1.0
- [Release notes](https://github.com/actions/setup-node/releases)
- [Commits](https://github.com/actions/setup-node/compare/820762786026740c76f36085b0efc47a31fe5020...949feb2413d6458794dcd2491c4babbbce0c15c1)

Updates `dtolnay/rust-toolchain` from 7e38f4b43b4db5c8dd498af069a4f6196df1d067 to e2a55d2ffb04f378e9626c28d38b36d230d1e12f
- [Release notes](https://github.com/dtolnay/rust-toolchain/releases)
- [Commits](https://github.com/dtolnay/rust-toolchain/compare/7e38f4b43b4db5c8dd498af069a4f6196df1d067...e2a55d2ffb04f378e9626c28d38b36d230d1e12f)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-version: 7.0.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: actions/download-artifact
  dependency-version: 8.0.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: actions/setup-node
  dependency-version: 7.1.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
- dependency-name: dtolnay/rust-toolchain
  dependency-version: e2a55d2ffb04f378e9626c28d38b36d230d1e12f
  dependency-type: direct:production
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-10 13:53:13 +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 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
dependabot[bot] 47f2979e24 chore(deps): Bump dtolnay/rust-toolchain (#116)
Bumps the actions group with 1 update: [dtolnay/rust-toolchain](https://github.com/dtolnay/rust-toolchain).


Updates `dtolnay/rust-toolchain` from 02cb101ec7c40f2c49e1d9714d64511d8e1b74de to 7e38f4b43b4db5c8dd498af069a4f6196df1d067
- [Release notes](https://github.com/dtolnay/rust-toolchain/releases)
- [Commits](https://github.com/dtolnay/rust-toolchain/compare/02cb101ec7c40f2c49e1d9714d64511d8e1b74de...7e38f4b43b4db5c8dd498af069a4f6196df1d067)

---
updated-dependencies:
- dependency-name: dtolnay/rust-toolchain
  dependency-version: 7e38f4b43b4db5c8dd498af069a4f6196df1d067
  dependency-type: direct:production
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-08 14:41:47 +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
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 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 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 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 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
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.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
poli0981 c654cc6f0c Update deployment trigger paths in workflow
Removed 'data_game/**' path from the deployment trigger.
2026-05-17 10:53:54 +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
poli0981 d4a0575c48 Add path filter for data_game directory in workflow 2026-05-15 13:08:31 +07:00
poli0981andClaude Opus 4.7 74ad62be79 v3.2.0: CI cleanup + mobile + SEO + Telegram bot path + auto-discussion
Workflows
- notify-ci-failure / notify-deploy / notify-release-pipeline: replace
  workflows: ["*"] with explicit allowlists. No more skip storm.
- bot-ingest.yml: drop dead final step (wrong secret name + missing
  result.txt).
- announce-discussion.yml (NEW): release:published -> Announcements
  category; push to docs/** -> General. Gated by [skip-discuss] commit
  token + skip on bot-ingest: commits. Configured via repo variables
  DISCUSSION_REPO_ID / *_ANNOUNCEMENTS_CATEGORY_ID / *_GENERAL_CATEGORY_ID.

Webapp - mobile + SEO + image
- ui/sheet.tsx (NEW) on top of existing @radix-ui/react-dialog.
- sidebar.tsx: desktop static sidebar (hidden md:flex) + MobileTopBar
  with hamburger Sheet drawer + auto-close on route change.
- App.tsx: responsive layout, h-[100dvh] for mobile, ScrollToHash for
  /about#support hash anchor.
- DataTable: meta.priority 1/2/3 + Tailwind responsive hide below md/lg.
- Touch targets bumped to 44pt minimum on mobile.
- index.html: full meta (description, OG, Twitter card, theme-color,
  manifest, canonical, preconnect img.itch.zone +
  raw.githubusercontent.com).
- public/: manifest.webmanifest, robots.txt, sitemap.xml, icon-192.png,
  icon-512.png, og.png, og.webp (generated by scripts/gen_assets.py).
- useDocumentTitle hook + applied to all 10 routes.
- Image hints: width/height (CLS), decoding=async, fetchPriority hi/lo.

Webapp - About + donate
- about.ts: messaging group with @SkullMute0011 + @my_skull_bot;
  full FUNDING.yml mirror (5 sources: GitHub Sponsors, Patreon, Ko-fi,
  Buy Me a Coffee, PayPal); +@hookform/resolvers and TanStack Query
  version bump 5.10 -> 5.100.
- about.tsx: messaging group privacy reminder, paypal footnote,
  scroll-mt anchor for /about#support.
- sidebar Heart "Support" link in both collapsed and expanded states.
- App version bumped to 3.2.0.

Telegram bot contribution flow
- CONTRIBUTING.md sec.1b (EN+VI): DM owner -> numeric ID added to
  operator-side whitelist -> bot dispatches bot-ingest.yml. Cross-link
  to telegram-scraper-bot/USER_GUIDE.md.
- ToS.md sec.14 + PrivacyPolicy.md sec.15 (EN+VI): explicit consent,
  whitelist never enters this repo, removable on DM.
- ISSUE_TEMPLATE/game_via_bot.yml (NEW) with required checkbox
  blocking numeric ID paste.

Docs
- docs/pc_spec.md + docs/dev_env.md (EN+VI): hardware + IDE + toolchain.
- README.md / README.vi.md: badge -> 3.2.0, Telegram bullets, full
  donate list, dev_env links.
- ACKNOWLEDGEMENTS.md: extended Claude Code line through v3.2.0,
  open-source libs subsection, Telegram bot ingest-path note,
  full FUNDING list, fixed "100% Grok assistance" closer.
- CHANGELOG.md v3.2.0 entry with maintainer setup notes.

Build + lint pass. Initial bundle ~163 KB gzip target maintained.
Mobile drawer + table priority columns smoke-tested per maintainer.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 23:16:15 +07:00
poli0981 b85f7df5f5 Fix formatting in bot-ingest.yml 2026-05-10 01:39:03 +07:00
poli0981 b1348ef73c test telegram bot 2026-05-10 01:35:46 +07:00
poli0981 8b4675a0be test telegram bot 2026-05-09 14:07:04 +07:00
poli0981 d63d919935 delete 2026-05-09 00:47:11 +07:00
poli0981 dbeddd0547 Refactor Discord notification workflow 2026-05-09 00:11:51 +07:00
poli0981 1b5e0202b3 Refactor deploy notification workflow configuration 2026-05-09 00:11:27 +07:00
poli0981 e8f9fa09cf Refactor CI failure notification workflow 2026-05-09 00:10:58 +07:00
poli0981 5f7c2d7700 Refactor announce-release.yml to use reusable workflow 2026-05-09 00:10:24 +07:00
poli0981 04ab1bfe04 discord notification script update 2026-05-08 21:04:21 +07:00
poli0981 97f56ef136 discord notification script update 2026-05-08 20:07:25 +07:00
poli0981 e074c6bda9 discord notification 2026-05-08 18:01:00 +07:00
poli0981andClaude Opus 4.7 465ce02242 fix(ci): cross-compile macOS x86_64 from Apple Silicon runner
The macos-13 job in v3.1.0's release run sat in 'queued' forever and
GitHub auto-cancelled it (runner_name was null in the run output).
GitHub retired macos-13 from free-tier hosted runners in late 2024;
new jobs requesting that label never get picked up.

Switched the Intel matrix entry to also run on macos-latest (Apple
Silicon) and cross-compile to x86_64-apple-darwin. The same toolchain
step already drives `rustup target add ...` from matrix.tauri_target,
and Xcode CLI tools on macos-latest carry both SDKs, so no extra
setup is needed.

The DMG bundler packages a single-arch x86_64 binary on an aarch64
host — bundle_dmg.sh doesn't execute the binary, only stages it into
a disk image, so cross-compile doesn't reintroduce the
universal-apple-darwin failure that v3.1.0 fixed by going per-arch.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 04:13:43 +07:00
poli0981andClaude Opus 4.7 3d85d76530 v3.1.0: per-arch macOS builds + .pkg installer + table pagination
## macOS DMG bundling

Universal target (lipo'd ARM + Intel) tripped bundle_dmg.sh on the
universal-apple-darwin run — a known fragility around AppleScript +
hdiutil + the universal binary in headless CI.

Switched the matrix to two native macOS targets:
- macos-latest (Apple Silicon) → aarch64-apple-darwin
- macos-13 (Intel) → x86_64-apple-darwin

Each runs DMG bundling against its own native binary instead of a
universal lipo, which avoids the failure mode altogether. fail-fast
is already off so a flake on one arch doesn't kill the other.

## .pkg installer (requested)

Tauri's bundler doesn't emit .pkg, so added a follow-on step that
runs pkgbuild (preinstalled on macOS runners) against the .app
produced by tauri-action and uploads it to the same draft release.

The step is gated on if: always() so even if the DMG layer fails on
some future runner image, the .pkg still ships — pkgbuild only needs
the .app, which is built before DMG packaging.

Output naming: {AppName}_{version}_{aarch64|x86_64}.pkg.

## Games table pagination

Added DataTablePagination footer (rows-per-page selector +
First/Prev/Next/Last) under the table. Page sizes 50/100/200/500;
default 100. Pagination state is lifted into Games route so toolbar
counts ('filtered of total') and bulk-action selection survive
filter/sort/page changes.

Virtualization is still in place inside each page so a 500-row page
doesn't blow render perf.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 03:51:04 +07:00
poli0981andClaude Opus 4.7 91afd4ecf9 Add webapp Phase 8: Tauri 2 desktop wrapper scaffold
The same React build can now ship as a native Win/macOS/Linux app via
Tauri 2. Web users still get the GitHub Pages SPA; desktop users get
a ~10 MB installer that can scrape itch.io directly without CORS.

src-tauri/:
- Cargo.toml: tauri 2 + tauri-plugin-http 2, edition 2021. Release
  profile uses panic=abort, lto=true, opt-level='s', strip — minimizes
  the bundled binary.
- tauri.conf.json: window 1280x800 (min 900x600), bundle targets all
  platforms, identifier com.poli0981.free-games-itchio-webapp.
- src/main.rs + src/lib.rs: minimal builder + one Tauri command
  (runtime_info) so the frontend can confirm desktop mode.
- capabilities/default.json: scopes the http plugin to itch.io,
  img.itch.zone, api.github.com, raw.githubusercontent.com.

Frontend plumbing:
- lib/runtime.ts: isTauri() probes window.__TAURI_INTERNALS__ to
  branch features at runtime. getRuntimeInfo() lazy-imports
  @tauri-apps/api/core only on desktop, so web bundles aren't bloated.
- lib/tauri-scrape.ts: tauriScrapePreview(url) uses the http plugin to
  fetch an itch.io page and pulls og:title / og:description / og:image
  out of the HTML. Full 23-field extraction stays in scripts/scraper.py
  and runs in CI; porting to Rust is tracked as Phase 8b in TAURI.md.
- Sidebar gains a small "Desktop mode (Tauri)" badge above the theme
  toggle when running native.
- vite.config.ts: when TAURI_ENV_PLATFORM is set, build to ./dist (not
  ../docs/app), drop sourcemaps, and target ES2022 — the bundled
  WebView2/WKWebView/WebKitGTK all support modern JS.
- package.json scripts: tauri / tauri:dev / tauri:build.

CI:
- .github/workflows/release_desktop.yml: builds for macOS (universal),
  Ubuntu 22.04, and Windows on tag v* via tauri-apps/tauri-action,
  caches cargo with Swatinem/rust-cache, installs Linux WebKit deps,
  and uploads the bundle to a draft GitHub Release.

Docs:
- webapp/TAURI.md: prereqs (rustup + platform deps), how to dev, how
  to build installers, how to add new Rust commands, roadmap to a
  full Rust scrape (Phase 8b).

.gitignore picks up the Cargo target/, generated gen/, and Cargo.lock
under src-tauri.

Note: Local `npm run tauri:dev` requires a Rust toolchain
(https://rustup.rs); the GitHub Actions workflow installs it
automatically. The web build still works without Rust installed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 09:00:37 +07:00
poli0981andClaude Opus 4.7 52b8e31d33 Add webapp Phase 3: workflow dispatch (single + bulk URL → CI)
Wires the webapp's Add route and Workflows route to GitHub Actions so
non-technical users can extend the catalog without editing temp_link.json
or waiting for the 03:00 UTC cron.

CI changes (backwards-compatible — daily cron still works exactly the
same):
- update.yml gains an optional 'url' input on workflow_dispatch and
  forwards it to the bash step as INPUT_URL.
- update_info.py reads INPUT_URL at the top of main() and appends it
  to the new_links list (deduplicated). When INPUT_URL is empty AND
  temp_link.json is empty, the script now exits cleanly instead of
  raising on the missing file.

Frontend:
- lib/github/workflow.ts: dispatchWorkflow / listWorkflowRuns /
  getWorkflowRun. Plus findRecentDispatchedRun because
  createWorkflowDispatch returns 204 with no run id, so we have to
  back-fill by listing recent runs filtered by event=workflow_dispatch
  and the dispatch timestamp.
- hooks/useWorkflows.ts: TanStack Query wrapper with refetchInterval
  that drops to 5s while any run is queued/in_progress, then relaxes
  to 30s.
- routes/add.tsx: two tabs (Single / Bulk).
  - Single: validates against URL_REGEX and the in-cache duplicate set,
    then dispatch with inputs.url and poll every 5s up to 5min. On
    success → invalidate ['db'] so the new game shows up everywhere.
  - Bulk: parses whitespace-separated URLs, validates+dedupes, PUTs
    them to scripts/temp_link.json in one commit (using putFile from
    Phase 2b), then dispatches without inputs so the workflow consumes
    the queue.
- routes/workflows.tsx: tab per workflow (5 of them) with Dispatch +
  Refresh buttons and the last 10 runs (status badge, run number,
  display title, event, timestamp, link to GitHub).

Bundle 1.03 MB / 298 KB gzip.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:14:35 +07:00
poli0981andClaude Opus 4.7 cdfd8d3595 Add deploy_webapp.yml: build webapp/ to GitHub Pages
When webapp/ or this workflow changes on main, build the Vite app and
publish docs/app/ via the official GitHub Pages actions. Manual run via
workflow_dispatch is supported for backfill or first-time setup.

Pipeline:
  checkout → setup-node@v6 (Node 22, npm cache keyed on
  webapp/package-lock.json) → npm ci → npm run build → configure-pages →
  upload-pages-artifact (docs/app/) → deploy-pages.

Permissions limited to contents:read, pages:write, id-token:write
(required for the OIDC token deploy-pages uses). Concurrency group
'pages' with cancel-in-progress:false so two pushes in quick succession
both publish in order rather than dropping the earlier one.

One-time setup the repo owner needs to do: GitHub repo Settings → Pages
→ Source = 'GitHub Actions'. After that, every push to main that
touches webapp/ ships automatically.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:07:02 +07:00
poli0981andClaude Opus 4.6 cd56d350cc Refactor: split game data into chunked files in data_game/ (#27)
When game_info.json reaches 500 entries, data is automatically split
into numbered files (game_info_001.json, game_info_002.json, etc.).
New data_store.py module handles load/save/rebalance for all scripts.

Also removes CSV export pipeline (export_csv.py, pandas dependency)
and cleans up unused files.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 12:47:03 +07:00
poli0981 e92962a03e Add GitHub workflows for checking game links, exporting logs, and updating JSON data 2026-03-11 22:20:14 +07:00