Files
poli0981andClaude Opus 5.5 7bcbcf59dd docs: maintenance mode — policy, triage bot, issue forms, status badge, docs for 2.3.0 (#139)
* 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>
2026-11-21 08:48:09 +07:00

9.1 KiB

poli0981.dev

CI Quality Gate Qodana License: GPL-3.0 Status: maintenance mode

The personal site of Kokone (SkullMute) — dev portfolio, blog, short fiction and a hub for the SkullMute channel, in Vietnamese and English. Live at poli0981.dev.

Trang cá nhân của Kokone (SkullMute): dự án, blog, truyện ngắn và kênh SkullMute — song ngữ Việt/Anh. Tài liệu thiết kế đầy đủ (tiếng Việt) nằm trong poli0981.dev-docs/.

Status

Maintenance mode since v2.3.0 (November 2026). The site is complete. It still gets dependency updates, security fixes (High/Critical advisories, runtime vulnerabilities), major runtime and framework upgrades, bug fixes (UI/UX and accessibility included) and language fixes, but no new features. Issues and pull requests asking for one are closed automatically. Details: CONTRIBUTING.md.

Trạng thái: chế độ bảo trì từ v2.3.0 — chỉ cập nhật dependency, vá bảo mật, nâng cấp runtime/framework, sửa lỗi (cả UI/UX, accessibility) và sửa lỗi ngôn ngữ; không thêm tính năng mới.

Stack

Layer Choice
Framework Astro 7 (static-first) with Svelte 5 islands
Styling Tailwind CSS 4, design tokens in src/styles/global.css ("Glacier Teal" palette)
Hosting Cloudflare Workers + Static Assets; KV, R2, Images, Rate Limiting, Access, Turnstile
Content Markdown/MDX in poli0981/content (git submodule src/content)
Search Pagefind (built after astro build)
Tooling Node 26 · TypeScript 7 (tsc) next to TypeScript 6 (astro check, typescript-eslint) · node:test · ESLint · Prettier · knip
Quality SonarCloud quality gate · Qodana · CodeQL · OSV-Scanner · Snyk · Dependabot (3-day cooldown) · axe-core gate · licence check

How it fits together

visitor ─▶ Cloudflare edge ─▶ src/worker.ts (every request, pages included)
            www → apex · IP denylist (KV) · admin host split · /media (R2) · /ext-img (KV)
            Turnstile gate (48-hour pass) · static pages from ASSETS · the rest → Astro app
                                                                      ├─ /api/report, /api/gate, /api/widgets, /api/health
                                                                      └─ admin.poli0981.dev (Cloudflare Access + JWT check)
workers/widgets (cron, every 45 min) ─▶ YouTube / Steam / GitHub ─▶ KV (data + mirrored images)

Almost every page is prerendered. The Worker entry runs first for every route so the bot gate, the denylist and the security headers also cover static pages. Details: 02_ARCHITECTURE.md and 06_SECURITY.md.

Getting started

Requirements: Node 26 (.nvmrc) and npm 11. The content submodule is public, so a plain clone works.

git clone --recurse-submodules https://github.com/poli0981/poli0981-dev.git
cd poli0981-dev
npm ci --ignore-scripts && npm run check-install-scripts
npx lefthook install
npm run types && npm run types:widgets
npm run dev

npm run dev runs Astro on workerd with local bindings. The admin works locally with a stand-in identity (dev@localhost); saving content needs a GITHUB_CONTENT_TOKEN in .dev.vars.

Commands

Command What it does
npm run dev Dev server (workerd, local KV/R2)
npm run build astro build → OG images → Pagefind index → CSP hash check
npm run preview Serve the build
npm run check astro check (TypeScript 6 language service)
npm run typecheck tsc from TypeScript 7 for the site and the widgets worker
npm run lint · npm run format:check · npm run knip ESLint · Prettier · unused files/exports
npm test · npm run test:coverage node:test suites; coverage writes coverage/lcov.info (80% line floor)
npm run smoke Runs the built Worker with wrangler dev and probes pages, headers, the gate and the denylist
npm run test:a11y axe-core, keyboard, reflow and forced-colours checks against npm run preview (Chrome)
npm run probe:ratelimit -- [url] [requests] [parallel] Spams a live URL and counts 429s from the Worker's site-wide limit vs. the WAF rule
npm run new:post Scaffold a post or story from docs/templates/
npm run check-exif · npm run strip-exif Refuse / remove GPS and camera metadata in images
npm run gen-notices Regenerate THIRD-PARTY-NOTICES.md (CI checks it)

Deploying

Cloudflare Workers Builds builds every push: main runs npx wrangler deploy, any other branch only npx wrangler versions upload (a preview version that takes no traffic). After a merge, https://poli0981.dev/api/health reports the running version and commit. The widgets worker deploys by hand: npx wrangler deploy --config workers/widgets/wrangler.jsonc. Setup from scratch: 07_CLOUDFLARE_SETUP.md; pipeline: 08_CI_CD.md; changes per release: CHANGELOG.md.

Admin

admin.poli0981.dev is the owner's editor: write and edit posts (commits to the content repo), upload images (transformed once into AVIF/WebP and stored in R2), manage gallery albums, set content labels and age ratings, review an audit log and manage the IP denylist. Every save or delete publishes itself: it starts a submodule-bump PR that CI must pass, which then merges and deploys, and the admin follows it until the change is live (/api/health reports the content commit too). It sits behind Cloudflare Access, and the Worker independently verifies the Access JWT (≤ 24 hours old) and an email allowlist on every request.

Security

Please report vulnerabilities privately — see SECURITY.md. Bug reports from the site's "Report a bug" button land in a private repository, not in this one's issues.

Accessibility

The site aims for WCAG 2.2 AA and checks it on every pull request (axe-core over every page, plus keyboard, reflow and forced-colours tests). What is in place, what is known not to work and how to report a barrier: ACCESSIBILITY.md; the statement for visitors is at /legal/accessibility. Barriers can be reported to accessibility@poli0981.dev.

License