main
8
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
2b4b988cc7 |
docs: sync the community docs with the repository
A read-through against the code found about forty claims that had drifted. README: - Dynamic game-count and version badges. The count is index.json's total. The version is the newest v* release by semver, since an app release published last would otherwise count as "latest". - SvelteKit 3, every desktop package, and the shard layout without a last shard number. - The media host, which commits deploy, and the nine workflows the table left out. - The accessibility statement and form in the link lists. SECURITY.md: - Fix the broken bullet list. - Describe the real stack, and pushes with the built-in GITHUB_TOKEN. - Add to scope: the media host, /api/ingest/*, /api/updates/desktop and the avatar origin. AUTHORS.md and username.txt: - Donations are in FUNDING.yml. - The Add-games template is gone. - Test devices come from pc_spec. The issue forms lose the hash URLs, the GitHub Pages permalink, and the editing and GPG options. web/README.md, dev_env (EN + VI), the acknowledgements and the contact page are updated to match. The last two are not consent documents, so nobody is asked to accept the terms again. CHANGELOG [Unreleased] lists all three commits. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|
|
a74a004e19 |
docs: publish role contact addresses and the maintainer's website
contact@ stays the default. Three role aliases go where a reader of that
document will look for them, and nowhere else:
- security@ SECURITY.md, security.txt, SECURITY_SETUP section 8
- privacy@ the Privacy Policy's "Your rights"
- copyright@ LICENSE-DATA (new "If you hold rights" section) and ToS
section 6, one address for copyright, DMCA and takedown notices
security.txt now lists GitHub's private vulnerability reporting first and
security@ second, in RFC 9116 preference order; the links page is not a
security channel and is dropped from it. The About page gains a Website card
(https://poli0981.dev/), two columns at sm and three from md so the email
handle never truncates. AUTHORS, Contact, CONTRIBUTING and username.txt carry
the full map.
The copyright text promises a human reading, not an outcome: an override
cannot blank a field and the store refresh rewrites description monthly.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
||
|
|
56559a13f6 |
docs(contact): move to contact@poli0981.dev and one links page
Nine maintainer channels collapse to two: the email, and https://poli0981.dev/links/ as the single source of truth for everything else. Handles now live off-repo so a retired account cannot strand a dead link in a shipped build — which had already happened three times. Replaced lopop05905@proton.me at all 6 sites (AUTHORS.md, SECURITY.md, docs/Contact.md, username.txt, and both the handle and the mailto: href in About.tsx). Edited by hand rather than by regex: a naive email pattern misses the 10 `github-actions[bot]@` occurrences and matches things that must not change (the you@example.com placeholder, 128x128@2x.png, the data/overrides set_by identities, ~200 `uses: …@v6` action pins). Stale content removed or corrected while in here: - CONTRIBUTING.md carried a whole WARNING block about whitelisting a Telegram user_id for a bot that no longer exists. Replaced with a general "public and permanent" privacy note. - docs/Contact.md had an orphaned bullet body (lines 17-19) left behind when the Telegram ingest bot was deleted — no title line, dangling arrows. Section rewritten; it now says outright that the bot and the issue template are gone and the extension is the only submission path. - docs/ADMIN.md credited temp_info.jsonl's appends to "the issue workflow and the Telegram bot". Both are gone; the producers are the extension and this Worker. - README.md described CONTRIBUTING as covering "web-app sign-in, Telegram bot flow" (both removed) and ToS.md as holding Telegram user_id rules (it no longer mentions them). - CODE_OF_CONDUCT.md had no reporting address at all. Added one. - Two legacy /#/about URLs now point at the real /about path. - Deleted the dead Telegram QR assets and the About page card that displayed one. Licensing claims corrected in AUTHORS.md and twice in About.tsx: all three still said the whole repo including data was MIT. The dataset moved to CC BY 4.0 in LICENSE-DATA and these were the last places asserting otherwise. SECURITY.md's parenthetical claimed the address was published in CONTRIBUTING.md — it never was, only a pointer. Replaced with the real list plus a forward reference to the security.txt added next. typecheck and build pass; knip reports only the pre-existing backlog. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> |
||
|
|
122075c9bf |
feat(admin): genre dropdown, bulk retag; ingest reduced to the extension
## /admin/edit
Genre is a dropdown instead of free text, built from the genres ACTUALLY in
use with their counts — the counts are the point, since they are how a vague
bucket announces itself ("Action" holds 287 games, "Adventure" 232). A
"Custom…" option still allows a value the catalogue has never used, and the
game's current genre is always offered even when absent from that list, so
loading a game can never silently change it.
New "Bulk by genre" mode: pick a genre, see everything carrying it, retag up
to ten in ONE commit. The cap is enforced in the UI (remaining checkboxes
disable, with "limit reached") and again on the server.
Supporting work:
- commitFiles() replaces commitFile(): several files in one commit, reading
the head and every file in ONE aliased GraphQL query so expectedHeadOid
still means what it says across ten files. Ten commits would be ten pushes,
ten workflow triggers and ten chances to land half a change.
- listByGenre() and genreCounts() in records.ts. Genres are counted by regex
over shard TEXT rather than parsing 3,426 records — verified to agree with a
full parse exactly (92 distinct, 3,426 games). listByGenre prefilters by
substring and only then parses, so cost scales with matches, not catalogue
size; an exact field check rejects the substring appearing in a description.
Found by driving the page: renderBulk() rebuilt all 60 cards on every checkbox
click, replacing the element just clicked and losing keyboard focus. Selection
now updates in place.
## Ingest: extension only
Removed the GitHub-issue and Telegram paths. Kept the browser extension, which
pushes to scripts/temp_info.jsonl directly, plus the /admin approve flow that
appends to the same file.
Deleted: bot-ingest.yml, ingest-from-issue.yml, ISSUE_TEMPLATE/add_games.yml,
docs/telegram-bot.md, and both copies of the bot QR.
Four things would have broken, and a fifth was already broken:
- BUILD BREAK. web/tsconfig.json sets noUnusedLocals, so removing the Telegram
and add-games UI orphans the PlusCircle and Bot icon imports — four TS6133
errors, web-ci red, site unbuildable.
- A live button. About.tsx linked issues/new?template=add_games.yml; GitHub
silently ignores an unknown template and drops the user on a blank form.
- CommandPalette linked "/add" — a route that does not exist. Every
`<Route path=…>` in web/src confirms it: left behind when sign-in and
in-app editing were removed, so selecting it navigated to the 404 page.
- notify-ci-failure.yml matches by exact workflow NAME and its own comment
warns a stale entry breaks silently.
- ALREADY BROKEN: README and CONTRIBUTING both linked
poli0981/free-steam-games-list-extension, which does not exist
(`gh repo view` → "Could not resolve"). The real repo is
poli0981/steam-f2p-extension. That was the link to the one path being kept.
README's Contribute section and CONTRIBUTING §2 still documented signing into
the web app with a Classic PAT — removed months ago. Both rewritten: the
extension is the submission route, issues are for reports, and discovery plus
/admin is how most games actually arrive now.
docs/ToS.md §5.1 governed sending a Telegram user_id to a bot that no longer
exists; removed, and TERMS_VERSION bumped 2 → 3 because ConsentGate exists to
re-ask when the terms change. Workflow counts corrected 24 → 23 in README and
SECURITY.md.
Kept deliberately: the maintainer's own @SkullMute0011 DM row and its QR, with
the "whitelist requests" framing dropped — that is a contact channel, not part
of the ingest path.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
||
|
|
96b2d2d69d |
fix: correct two stale claims that a wildcard add swept in
The previous commit staged these with `git add -A`; both had been left uncommitted because they were wrong, so correct them rather than carry them. username.txt said the Telegram QR codes were untracked. They are tracked — assets/qr/telegram-bot.png and assets/qr/telegram-user.png — and CONTRIBUTING.md and AUTHORS.md already link to those paths. .gitignore carried a block ignoring app/dist, app/release and friends under the heading "F2P Tracker desktop app (Electron + Vite)". There is no app/ directory in this repo and the desktop shell is Tauri 2 with a Rust backend, so the block ignored nothing and described the wrong technology. Replaced with the paths Tauri actually produces. Verified the new rules match no already-tracked file. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> |
||
|
|
5ab4f27347 |
docs: split the licence, correct the legal docs, add deployment and admin guides
The docs had drifted badly from the code. This makes them true. LICENCE SPLIT. Code stays MIT; the dataset moves to CC BY 4.0 in a new LICENSE-DATA, which is explicit about what the project cannot license: the `description` field is the publisher's own store blurb stored verbatim (median 213 characters), `header_image` is a URL to publisher artwork, and game names are trademarks used nominatively. Blanket-MIT over that material was a claim the project was never entitled to make. Facts — player counts, review percentages, platform support — are noted as unownable; the CC BY grant covers the compilation and the project's own derived fields. PRIVACY POLICY, rewritten rather than patched. The previous one said "no backend, no server-side log, no cookies, no server other than GitHub's CDN". Every clause of that is now false: the site runs on a Cloudflare Worker that processes IP and User-Agent and keeps operational logs. It also documents the one honest exception — the Activity page still calls api.github.com and loads GitHub avatars from the browser, so GitHub sees a visitor's IP there while no other page does — and lists every localStorage, IndexedDB and Cache Storage key with why it exists. SECURITY.md, rewritten. The old one claimed "no executable code, no dependencies, no backend, no user data" and said there was no contact address, while four other files publish one. It also told people to report vulnerabilities in public issues. There is now a real scope (the Worker, the proxies, D1, Actions secrets, the Tauri signing key), a private channel via GitHub's vulnerability reporting, and specific things worth probing. EULA corrected on two counts: it asserted a single MIT licence over everything, and claimed there is "no installable software" despite the signed desktop and Android builds. ToS and DISCLAIMER updated for the licence split, the new domain, and the removal of in-browser editing and GPG signing — the disclaimer described a signing flow that no longer exists. README contradictions fixed: 1.2k games -> 3,424 across 5 shards not 2, 11 workflows -> 24, two scripts listed that were never in the tree, a TanStack Table dependency the project does not use, and nine links to the old Pages URL. New: docs/DEPLOYMENT.md (how a push becomes a deploy, the two wrangler.jsonc fields that silently break it, and the stale-service-worker trap when verifying) and docs/ADMIN.md (Cloudflare Access plus the GitHub App, with the exact permission set — Contents write and Metadata only, and why Actions and Workflows are deliberately withheld). Two live fixes came out of writing this. GitHub Pages was serving a blank page: it had the new index.html, which references assets at `/`, while Pages serves under /free-steam-games-list/, so every asset 404'd — and deploy-pages.yml kept redeploying it. That workflow now publishes a redirect that preserves the #/ fragment, since Pages cannot issue a 301. And CI pinned Python at 3.11, 3.12 and 3.14 across different workflows while the docs claimed 3.12 was pinned; all fourteen references are now 3.12, which makes the claim true. TERMS_VERSION 1 -> 2, so everyone re-consents. A privacy policy that now discloses edge logging where it previously promised none is not a change to apply silently. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> |
||
|
|
16eabcbbf5 |
docs(v3.1.0): Telegram bot flow, AUTHORS at root, version bumps (#63)
- AUTHORS.md (new) at repo root — maintainer + canonical handle map
+ AI disclosure. Mirror of `username.txt` (now includes telegram bot,
telegram user, email).
- assets/qr/ (new) — QR PNGs for `@my_skull_bot` and `@SkullMute0011`,
mirrored to web/public/qr/ so the SPA serves them.
- About page (web): new Maintainer entries (Telegram bot + DM with
inline QR thumbnails + Email) and a dedicated "Telegram QR codes"
card with full-size scannable codes. Privacy note added.
- CONTRIBUTING.md rewrite: explicit `@my_skull_bot` flow as a
first-class path (find user_id → DM maintainer privately → whitelist
→ run when bot's online → follow prompts). Loud warning about
NEVER posting Telegram user_id in public channels.
- docs/PRIVACY_POLICY.md: new "Telegram bot" section covering data
flow, storage, retention, and the maintainer's commitment.
- docs/ToS.md: new section 5.1 with non-negotiable rules about private
vs public channels for personal info.
- docs/Contact.md: Telegram bot + DM entries at the top.
- README: version badge 3.0.0 → 3.1.0; quick links + workflow table
+ contributor section + docs index updated; Mark Dead Games and
Bot Ingest workflows listed.
- CHANGELOG: v3.1.0 entry covering PRs #60-#62 + this docs PR.
- Versions bumped:
web/package.json 1.0.0 → 1.1.0
web/src-tauri/Cargo.toml 1.0.0 → 1.1.0
web/src-tauri/Cargo.lock 1.0.0 → 1.1.0
web/src-tauri/tauri.conf.json 1.0.0 → 1.1.0
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
||
|
|
5425014bf3 |
Phase 6: enums + JSON editor + Add overrides + pagination + About + permalinks + verify poll + owner gate (#50)
Curated enums (lib/enums.ts)
ANTI_CHEAT_ENUM mirrors scripts/core/constants.py:45 (14 patterns + "-").
GENRE_ENUM is a curated 44-item list rendered as a combobox so users can
pick or type a one-off. TYPE_GAME / SAFE / STATUS are fixed.
EditGameDrawer + BulkEditDrawer + Add page all consume these.
JSON editor toggle (EditGameDrawer)
Form / JSON segmented control. JSON mode shows the full record, validates
on every keystroke, and refuses to commit if the edited link's appid
doesn't match the original. New replaceGame() helper in edits.ts skips
the patch-merge path and writes the whole record back; added_at is
preserved from the original. JsonDiff renders a side-by-side stringified
diff per field.
Add page upgrade
AddEntry now carries optional manual fields. SingleAdd has a collapsible
"Manual overrides" panel; BulkAdd has a Links/JSON view toggle —
Links mode = current 1-URL-per-line, JSON mode = 1 object per line with
per-link manual fields. Pruned empty values so we don't clog
temp_info.jsonl with empty strings. Pipeline's parse_entries already
accepts dict entries, so this is purely client-side.
GamesTable pagination + scrollbar + validation badge + export
pageSize state added to filters store: 50/100/200/500/all, default 100.
Page nav buttons render only when not "all". Page resets on filter or
sort change. Native scrollbar hidden via CSS. New "issues" column shows
an amber AlertTriangle when recordIssues() flags missing manual fields,
stale (>30d) records, or online + AC + kernel-unknown.
Export menu downloads filtered+sorted subset as CSV or JSON
(lib/export.ts).
Per-game permalinks
GamesPage now responds to /games/:appid. Row click navigates instead of
opening a local drawer. URL is the source of truth so deep-links share
cleanly. Unknown appid → friendly 404 drawer with link to Steam +
Health.
Verify-after-commit poll (lib/verify-commit.ts)
GitHub computes verification asynchronously, so the create-commit
response usually still says "unverified" even when the signature is
valid. pollCommitVerification retries up to 4× with backoff and resolves
on first verified=true. Edit / bulk edit / bulk delete / single add /
bulk add all wire it through sonner toast IDs so the chip updates
in-place from "verifying…" to "Verified ✓" or "Unverified · {reason}".
About page (/about)
Stat cards (game count, last_updated). Repo info + quick links to
markdown all-games / top-online / raw JSONL. Dev info pulled from the
fields in username.txt — X / YouTube / Discord / Patreon / Steam /
Bluesky / Mastodon. Bug-report / feature-request / add / delete /
feedback issue templates linked directly. Third-party stack with
per-dep links. Wired into Sidebar + ⌘K palette. username.txt is now
committed.
Topbar GPG quick-unlock
Locked chip is now a Radix Popover trigger instead of a Settings link.
Click → small form with passphrase + Unlock — same flow as Settings but
one click. Lock action stays inline.
Owner gate (useIsOwner + OWNER_LOGIN)
Visitors signed in with their own PATs would fail at the API push
anyway, but they used to see the Edit / Add / Delete UI greyed out.
useIsOwner returns true only when login matches OWNER_LOGIN
("poli0981") OR the API confirmed write/admin permission. GameDetail's
Edit button, Bulk action bar, Add page, and Sidebar's "Add" entry all
hide for non-owners.
bug_report.yml
New "where did you see it?" dropdown (web app / GitHub markdown /
top-online / raw / API). Expanded "kind of bug" checklist (Edit-fail,
GPG unverified, SW cache, dropdown / form, mobile). New optional
Browser/OS, web-app version, and Console-errors textarea fields.
Tightened wording.
Bundle: index 109 KB gz (+21 KB across 12 features). Build 3.93 s.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|