11 Commits
Author SHA1 Message Date
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 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 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.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 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 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 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
poli0981 e2728be0a5 Add docs & fix comment 2025-12-28 16:37:25 +07:00