38 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 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 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 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 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 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 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
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 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 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 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 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 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
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
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
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
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
poli0981andClaude Opus 4.7 d241ffb415 release(v3.2.1): single-instance enforcement on desktop (#40)
- Add tauri-plugin-single-instance v2, registered first in builder chain
- Bump desktop binary version 0.1.0 -> 0.1.1 (boundary change)
- Bump app version 3.2.0 -> 3.2.1, README badges, About page

Fixes duplicate-process bug: each launch used to spawn a new
free-games-itchio-webapp.exe instead of focusing the existing window.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:33:49 +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
poli0981andClaude Opus 4.7 89e0197ee5 release(v3.1.4): legal docs rewrite, Vietnamese i18n, Legal Card, UI polish (#38)
Rewrote the four English legal docs (DISCLAIMER, EULA, ToS, PrivacyPolicy) to
be tighter and more enforceable while keeping the project's voice — TL;DR, numbered
sections, definitions, severability, governing law (Vietnam), explicit "not legal
advice" notice, removal-request path. PrivacyPolicy now includes per-storage
table and PAT lifecycle steps.

Added Vietnamese translations for all six policy / community docs under
docs/i18n/vi/ plus a top-level README.vi.md. Each VI file notes that the English
version is the controlling text for legal interpretation.

About page: new "Legal & policies" Card listing Disclaimer, EULA, ToS, Privacy,
Code of Conduct, Security, License (MIT), and Changelog with a pointer to the
Vietnamese translations. New LegalLink interface + LEGAL_LINKS const in
webapp/src/lib/about.ts following the THIRD_PARTY/SOCIAL_LINKS pattern.

Optional UI:
- Tauri desktop: maximize button disabled (maximizable: false in
  tauri.conf.json). Window remains resizable.
- DataTable: scrollbar hidden via new .scrollbar-hide Tailwind utility added to
  webapp/src/index.css; scrolling still works.

Bookkeeping: README badge bumped to 3.1.4 + Vietnamese language badge + pointer
to README.vi.md and docs/i18n/vi/. CHANGELOG entry for 3.1.4.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 11:55:18 +07:00
poli0981andClaude Opus 4.7 9cdd900dba release(v3.1.3): credit Claude Code as AI co-author alongside Grok (#37)
- About page: new "AI co-authors" Card listing Grok (xAI) and Claude Code
  (Anthropic, Claude Opus 4.7, 1M context) with vendor + model badges and
  the role each played in the repo (Grok: Python pipeline + v2.0.0;
  Claude Code: v3.0.0 webapp/Tauri + v3.1.2 fixes).
- AiTool interface + AI_TOOLS const in webapp/src/lib/about.ts so the AI
  credit follows the same structured pattern as THIRD_PARTY and
  SOCIAL_LINKS.
- ACKNOWLEDGEMENTS, My_Stuff, CONTRIBUTING surface Claude Code alongside
  Grok wherever the existing AI credit lived. My_Stuff "The Real MVP" is
  now plural; DEV.blurb mentions both buddies.
- Bump README badge to 3.1.3 + CHANGELOG entry.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 11:07:17 +07:00
poli0981andClaude Opus 4.7 b90f707ae4 release(v3.1.2): fix Tauri offline links, expand About, refresh docs (#35)
- Add tauri-plugin-opener (Rust + JS) so external links open via the OS
  browser on the desktop app. Capability scoped to opener:allow-open-url
  for https://* only.
- New <ExtLink> component (webapp/src/components/ext-link.tsx) used app-wide
  so the offline link bug can't recur.
- About page: new Developer card, Found-a-bug CTA, and Find-me-elsewhere
  social grid (X, YouTube, 2x Discord, Patreon, Ko-fi, Steam, Bluesky,
  Mastodon).
- Rewrite webapp/README.md from Vite boilerplate to actual webapp docs;
  refresh CONTRIBUTING.md, docs/ACKNOWLEDGEMENTS.md, docs/My_Stuff.md, and
  README.md with the new contact handles.
- Bump version badge to 3.1.2 + CHANGELOG entry.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 10:43:19 +07:00
poli0981andClaude Opus 4.7 224fa16fae Update README and CHANGELOG for v3.0.0 (webapp + desktop)
README:
- Bump version badge 2.0.0 → 3.0.0
- New 'Webapp' section between 'Browse by genre' and 'How it works'
  with web/desktop deploy notes, auth model, and local dev commands
- Project structure + Automation table extended with webapp/ folder,
  deploy_webapp.yml, release_desktop.yml, and the new url input on
  update.yml

CHANGELOG:
- v3.0.0 entry summarizing the 17-commit rollout: 8 routes, PAT
  encryption, Git Data API bulk ops + undo, workflow dispatch from UI,
  sync button, collapsible sidebar, dark mode, About page, Tauri 2
  desktop wrapper, two new CI workflows
- Notes that the Python pipeline is unchanged except for the optional
  INPUT_URL pass-through (backwards compatible with the daily cron)

Tag and signed release left for after merge to main — tagging from a
feature branch would force-move on rebase.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 09:32:19 +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 92a1d28a3f chore: update changelog and README for version 2.0.0 release 2026-03-26 13:31:43 +07:00
poli0981 0e6d767393 chore: update CHANGELOG for version 1.0.5 and fix UTF-8 decode issue 2026-01-12 20:07:47 +07:00
poli0981 9acdccf96a update README
Signed-off-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-01-11 21:14:08 +07:00
poli0981 8108f7a8d4 start for release + fix 2025-12-28 17:46:04 +07:00
poli0981 90c4e36913 Initial commit 2025-12-20 11:57:11 +07:00