* docs: maintenance mode — policy, triage bot, issue forms, status badge, docs for 2.3.0 From v2.3.0 the project takes no new features (CONTRIBUTING.md, in Vietnamese and English). Accepted: scheduled dependency updates; security fixes (High/Critical advisories, runtime vulnerabilities); major language/runtime/framework upgrades; bug fixes including UI/UX and accessibility; language fixes. - .github/workflows/triage.yml + scripts/triage.mjs (unit-tested): an issue or pull request whose title or label asks for a feature is labelled enhancement + out-of-scope, answered in both languages and closed (issues as "not planned"). The owner's items, bots, `maintenance-exception` and anything the owner does are left alone. It runs on pull_request_target but checks out only that one script from the default branch, never a pull request's code; workflow_dispatch is a dry run. - Issue forms: blank issues off, questions and ideas to Discussions, security to the private policy; a new language-problem form; the bug form no longer claims the site's report button fills it (those reports go to a private repository). The pull request template asks which of the five kinds of change it is. - README: a maintenance-mode badge and a Status section; the admin paragraph describes auto-publish. SECURITY.md: High/Critical fixes ship out of schedule; the age-check answer is local storage only. - Docs: decisions D21–D24, maintenance policy and cadence (17 §0, QODANA_TOKEN rotation), roadmap frozen, CI (Qodana, whole-tree licences, triage, merge rules), architecture tree, the Workers Builds deploy command, licence notes without the stale license-checker/GSAP lines. - CHANGELOG [2.3.0]; sonar.projectVersion 2.3.0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: link #138 in the 2.3.0 changelog Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: album labels come from both language entries Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(ci): triage without a checkout, and linear title patterns SonarCloud and Qodana on #139: - githubactions:S7631 flags any checkout in a pull_request_target workflow, even of the default branch. The workflow now reads scripts/triage.mjs from the default branch through the API and imports it from a data: URL — nothing is checked out at all. - javascript:S8786: `\s+a?\s*` let two quantifiers compete for the same spaces. The title is trimmed once and the patterns are written so no two quantifiers overlap. - Qodana RegExpRedundantEscape: the bot check is `endsWith("[bot]")`, no regex. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
18 KiB
18 KiB
Changelog
Notable changes to poli0981.dev. The site deploys continuously from main; tags mark
milestones. Format follows Keep a Changelog.
Content changes (posts, stories, albums) live in poli0981/content
and are not listed here.
Unreleased
2.3.0 — 2026-11-21
The last feature release: from here on the project is in maintenance mode
(CONTRIBUTING.md).
Added
- Content labels, an age check and blurred images. Posts, chapters and albums — and single
gallery photos — can carry labels from a fixed list (horror, blood, jump scares, violence,
self-harm, death, politics, religion, strong language, flashing lights, spoilers) and an age
rating (13+, 16+, 18+).
- A banner names the labels in the page's language.
- For the visual labels, images are blurred until "Show images" is ticked. That is a real checkbox, and the blur is plain CSS, so it works from the keyboard and without JavaScript.
- An age-rated text stays folded until the reader confirms their age in a native dialog. It
never pops up on its own, and Esc never means "yes". The answer stays in the browser
(
localStorage: an age threshold, never a birth date). - Cards, the photo viewer, RSS descriptions and OG cards carry the warning too. The privacy policy (§6) lists the new local-storage item (#138).
- The admin publishes on its own. Every save or delete starts the publish workflow; bursts
coalesce. The admin now follows a change until it is actually live: the build records the
content commit it was made from (
version.contentin/api/health), and the publish bar shows building / waiting for review / merged and deploying / live / failed. The editor and gallery manager set labels, age ratings and per-photo labels (#137). - Qodana (JetBrains, Qodana for JS) on every pull request and on
main, with a zero-problem quality gate. Results go to Qodana Cloud and, formain, to code scanning (#135). - Licence check over the whole dependency tree: every package in
package-lock.json, with reviews per package instead of per licence. A package with no licence fails CI (#135). - Maintenance-mode governance:
CONTRIBUTING.md, in Vietnamese and English;- a language-problem issue form, with blank issues off and questions sent to Discussions;
- a "kind of change" checklist in the pull request template;
- a triage workflow that labels and closes new-feature requests.
Changed
- Admin commits in the public content repository no longer carry the admin's email address; the private audit log keeps who did what (#137).
- The admin's checks now match the content schema, so a save cannot queue a failing build:
chapters are positive whole numbers,
coverandcoverMediaexclude each other, and an album must be a slug that already has photos (#137). - Deleting an image is refused while the live site's content still uses it, not only while
maindoes (#137). - The post page uses the cover's alt text when one is set (#138); the editor has a field for it, and the media picker takes alt text for uploads (#137).
- One-shot stories (
stories/<slug>.md) can be created and edited in the admin (#137). - Dependencies, keeping the three-day cooldown: astro 7.4.12, @astrojs/cloudflare 14.4.8, @astrojs/svelte 9.1.6, jose 6.2.17, marked 18.2.1, wrangler 4.164.0, eslint 10.15.0, typescript-eslint 8.73.0, prettier 3.10.1, prettier-plugin-svelte 4.2.0 (14 Svelte files reformatted; the rendered markup is unchanged), playwright 1.65.1, knip 6.45.1 (#134, #136). The SonarQube scan action is at 8.5.0 and the OSV-Scanner workflow at 2.7.1 (#127, #128).
Fixed
- In the editor, Ctrl/⌘+S while typing in a tags field saved the previous tags (#137).
- Qodana's first findings (#135):
- the smoke test's forged Access token is built at run time instead of sitting in the source as a token literal;
- redundant escapes in a Markdown-to-text regex;
- a single-character alternation in the CSP check;
- a heading table keyed by a mixed-script property name.
Security
- deepmerge GHSA-gcqx-w48m-w2h4 (alias CVE-2026-93753) was withdrawn on 2026-11-16, and its Dependabot alert is closed. The OSV-Scanner ignore entries for it are gone (#134).
- Node.js 26.13.1 (security release of 2026-11-10) is what CI and the build use (
.nvmrc= 26).
2.2.0 — 2026-11-10
Added
- Accessibility statement. A new page,
/legal/accessibility(Vietnamese and English), says what the site aims for (WCAG 2.2 AA, as a guide — it has not been audited), what is in place, how it is tested, what is known not to work and how to report a barrier: a new address, accessibility@poli0981.dev, or the "Report a bug" button.ACCESSIBILITY.mdis the repository's copy, with the notes for contributors; there is an accessibility issue template and a pull request template with the checklist. - Accessibility gate in CI.
npm run test:a11yruns in the requiredbuildcheck: axe-core over every page in the sitemap and over the menu, search, photo viewer, report dialog, reading settings and legal notice while open, then keyboard, reflow and forced-colours tests (tests/a11y/, Playwright driving the runner's Chrome). Lighthouse stays advisory. - Windows High Contrast (
forced-colors): the search field and its active result keep a visible indicator, the scrollbar switch shows its knob and state, and the chosen reading option is filled.prefers-contrast: morestrengthens hairlines and drops the film grain.
Changed
- The current page is marked by more than colour: an underline in the header and in the legal sidebar, a bar along the top of the current tab on phones. The chosen reading option is bold and double-ruled.
- Footer social icons are 44 px targets (the icons keep their size); the row is a little wider.
- On a phone the legal notice rests on top of the tab bar instead of covering it.
- Below 384 px (Vietnamese pages) or 404 px (English pages) the language switch shows
EN/VIinstead of the full name, and below 352 px the header drops the "SkullMute" wordmark. - Dependencies: Tailwind CSS 4.3.5. New dev dependencies:
playwright1.65 and@axe-core/playwright4.14, both older than the three-day cooldown and without install scripts.
Fixed
- The header was wider than the screen on narrow phones — it needs 378 px in Vietnamese and 400 px in English — so pages scrolled sideways at 360 px, and English pages did on a 390 px iPhone. Pages now reflow down to 320 px; a long URL in a legal page no longer widens it either.
- Focus could land underneath the mobile tab bar, the legal notice or the story reader's bar. The page's scroll padding now accounts for all three.
- Esc in the story reader's "Aa" panel dropped focus to the top of the page; it returns to the button. Pressing play on a video keeps focus on the player.
- Tab could walk out of the search dialog once results were listed; the trap now counts only what Tab can reach.
- A legal page holds both languages, and the half that is not in the page's language had no
lang, so a screen reader read it with the wrong voice. Each half now declares its own. - Names: the three "Play video" buttons on the gaming page each carry their video's title; the search's "Esc" button is named "Esc — Close"; the "Social" and "Legal" navs that shared a name with the footer's (dev and gaming pages, menu sheet, legal sidebar) have their own.
- Headings no longer skip from h1 to h3 on the blog, tag, project and gallery lists. Project, gallery and tag breadcrumbs are navigation landmarks, and the legal notice is a landmark.
- Links inside the Q&A contact list are underlined, not told apart by colour alone.
- The report form ties its "too short" message to the text box and returns focus there. The photo viewer announces the caption when you move to another photo, and no longer reads it three times.
- The sitemap listed seven
/admin/URLs that only exist on the admin host. - The four FrameLedger screenshots have text alternatives (content repository).
2.1.2 — 2026-11-09
Security
- Lint tooling runs on minimatch 11.0.5 instead of 10.2.5, which carried a denial of service
through crafted glob patterns (GHSA-g3hv-75wg-m249). ESLint and typescript-eslint still ask for
minimatch 10, so an
overridesentry inpackage.jsonholds 11 until they move; they only callnew Minimatch(…).match()andminimatch(), which 11 keeps. - The OSV scan ignores deepmerge's prototype-poisoning advisory (GHSA-gcqx-w48m-w2h4) until
2027-02-09, in the new
osv-scanner.toml. No fixed release exists, and the only copy merges this repo's own Svelte config at build time; nothing from a visitor reaches it. These two advisories had kept the weekly scan, and every Dependabot PR, red since 2026-11-02.
Changed
- Dependencies: Astro 7.4.7, @astrojs/cloudflare 14.4.6, @astrojs/mdx 8.1.3, @astrojs/svelte 9.1.2, Svelte 5.57.3, Tailwind CSS 4.3.4, jose 6.2.15, marked 18.1.3 and Pagefind 1.6.0; Wrangler 4.158, ESLint 10.14, typescript-eslint 8.72.1, knip 6.44 and the SonarCloud scan action 8.4.0. Releases younger than three days were held back, as Dependabot's cooldown does.
- knip no longer needs
cloudflareinignoreDependencies; it now readscloudflare:workersimports as a runtime module.
2.1.1 — 2026-10-28
Fixed
- iPhone: the Waveline is visible again while it rests. Its gradient was sized to the line's bounding box, which is 0 px tall for a flat line, and WebKit then draws nothing — the footer, the section headings and the error pages showed an empty band where the line belongs. Chrome drew it anyway, so only iOS browsers were affected.
- iPhone (Safari 26): the page no longer scrolls into view above the sticky header, under the
status bar. Safari extends a sticky header's colour up to the screen edge only when the header
has no
backdrop-filter; the header, the mobile tab bar and the admin bar dropped the blur and are now opaque.
2.1.0 — 2026-10-27
Security
- Site-wide rate limit. Every request that reaches the Worker — pages,
/media,/ext-img, the search index and the API — now spends one budget per client: 100 requests per 10 seconds (IPv6 counted per /64), a newRL_SITEbinding inwrangler.jsonc. Over it, visitors get the site's 429 page withRetry-After: 10and a 10-second countdown; the stricter per-endpoint API limits still apply underneath. Before, only the API groups were limited — pages, images, the search index and the widgets endpoint were not. The admin host is exempt (Cloudflare Access stands in front of it), and a failing limiter lets requests through without skipping the Turnstile gate. - Setup docs describe the zone WAF rate-limiting rule as the outer layer above it, with the Free plan's real limits (path and verified-bot fields, 10-second periods and blocks).
Added
npm run probe:ratelimitspams a live URL and tells the Worker's 429s apart from the WAF's. The CI smoke test now spams the built Worker until the site-wide limit answers.
Changed
- Faster first paint on phones: every page carries its CSS inline (about 9 KB brotli) instead of two render-blocking stylesheets, and the theme toggle and the home page's hero wave hydrate when the browser is idle rather than during first paint.
- Lighthouse CI measures through nginx, which gzips responses as Cloudflare's edge compresses them in production; the local preview server sends everything uncompressed.
Fixed
- A missing page under
/en/gets an English 404 page — English links, recent posts and a search over the English index — instead of the Vietnamese one. The Worker now returns the asset layer's 404 for every missing page rather than rendering it again through the app.
2.0.0 — 2026-10-24
A platform upgrade, a security pass, a new palette and a rebuilt admin (#98, #99, #100).
Security
- Turnstile gate bypass fixed (#97): a pass cookie with a malformed signature made the check throw and the Worker failed open, serving the real page. Decoding is now total, signatures must be exactly 43 characters, and if deciding or rendering the gate throws the visitor gets a 503 — never the page behind it.
- Admin: Access tokens older than 24 hours are refused, and
ADMIN_EMAILSis required (fail closed). Every admin action is recorded in a KV audit log (90 days). - The IP denylist is enforced by the Worker entry for every route, pages included (it only covered on-demand routes), supports CIDR ranges and expiry, and is managed from the admin.
- Request bodies are capped (report 32 KB, gate 8 KB, admin JSON 512 KB, uploads 20 MB) and every outgoing fetch has a timeout.
- Bug reports go to the private
poli0981/site-reportsrepository (the site repo is public);@mentionsin reports are neutralised and Discord pings are disabled. - Widget thumbnails and game icons are mirrored by the cron worker and served from
/ext-img, so browsers no longer contact Google or Steam before a visitor clicks;img-srcis'self'only. frame-ancestors 'none'is now sent as a header (it has no effect in a meta CSP).- CI installs with
--ignore-scriptsand fails on new install scripts; Dependabot waits three days before proposing a release; SonarCloud, CodeQL, OSV-Scanner and Snyk run on every PR.
Added
- Light/dark theme that follows the OS by default, with a system → light → dark toggle.
- "Glacier Teal" palette (navy and teal) across the site and admin, checked against WCAG AA by
tests/palette.test.ts. - Admin: an overview dashboard, an activity page (audit log + content commits), a security page (IP denylist, configuration), editor draft autosave with restore, Ctrl/⌘+S, client-side field validation, a sandboxed preview, media search and usage, parallel uploads, gallery cover picker, drag-and-drop ordering and album deletion, a "session expired" banner.
- Reader routes for one-shot stories (
/truyen/<slug>/). /api/healthreports the running Worker version and the commit it was built from; the 500 page shows the Cloudflare Ray ID, which matches the structured JSON logs in Workers Logs.- Test suite on
node:test(about 200 tests, ~99% line coverage of the TypeScript sources) and a SonarCloud quality gate.
Changed
- Node 26; TypeScript 7 (
tsc) for type checking, alongside TypeScript 6 for tools that need its API; ES2025 target. Astro 7.4, @astrojs/cloudflare 14.4, Wrangler 4.152 and current dependencies. - Vietnamese and English pages share one component each (eleven duplicated pages removed).
- The header shows the full navigation from 960 px (it overflowed between 768 and 900 px).
- Workers Builds deploys only
main; other branches upload preview versions.
Fixed
- The language switch no longer leads to a 404 on posts whose slugs differ between languages.
- The story reader bar no longer hides behind the sticky header.
- Modal dialogs (the bug-report dialog) were stuck in the top-left corner; lists in posts had no bullets — both caused by Tailwind's preflight.
- Callouts in MDX posts rendered unstyled: Astro left their inline styles out of the page's CSP, so
the browser refused them. The rules moved to the shared prose stylesheet, and the build's CSP
check now verifies every inline
<style>(and forbids style attributes) as well as scripts. - Accessibility: the search is an ARIA combobox, the mobile menu is a modal dialog with a focus trap, lightbox focus handling, labelled report dialog, a correct "copied" message, Esc no longer dismisses the legal notice from elsewhere, landmark and link labels translated.
- Gallery albums work without JavaScript; contact lines on /qa and the 403 page are real links.
- Widgets: Steam game icons never appeared. The CDN hosts the worker used answer Workers with 403
for any icon their edge has not cached; the worker now fetches icons from Steam's
community-assets hosts, which serve Workers, falls back to another CDN, and keeps the copy an
earlier run stored (games without an icon show their name only)
(#101,
#102). An optional read-only
GITHUB_TOKENkeeps the GitHub feed from going stale under the per-IP rate limit Workers share. - Dozens of smaller issues found by SonarCloud and the new tests (error pages served with the
wrong status under
astro dev, regex backtracking, scripts that passed without checking).
1.x — 2026-07 → 2026-10
The public launch is tagged v1-launch; the 1.x changes after it were not tagged.
- 2026-07 — Bilingual Astro + Cloudflare Workers site: blog, stories with reading controls and content warnings, projects, dev/uses, gaming, Q&A, links, legal pages; Pagefind search; RSS, sitemap, JSON-LD and generated OG images; offline page with the Skull Hop mini-game; bug-report pipeline (Turnstile → GitHub issue + Discord); widgets cron worker.
- 2026-08 — Content moved to the
poli0981/contentsubmodule; gallery with real photos; /now page;new:post; Lighthouse CI; generated third-party notices; CSP hash guard; security.txt; AI usage disclosure. - 2026-10 — Custom Worker entry in front of every page; Workers Rate Limiting; Web Analytics;
topic email aliases; R2 media; the Turnstile gate; the admin at
admin.poli0981.dev.