[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7589FB8MPA5KPPWNEMQ1M3P":3,"skill-same:01M7589FB8MPA5KPPWNEMQ1M3P":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":31,"ownerDescription":33,"updatedAt":34,"install":35,"resources":47},"01M7589FB8MPA5KPPWNEMQ1M3P","release",null,"Cut a Nub patch release end-to-end in one invocation. Invoke (via the Skill tool) once a release thread's targeted fixes are ALL landed on `main` and CI-green. Encodes the full runbook: pick the version (patch bump in the 0.0.x\u002F0.1.x pre-release regime), audit `@nubjs\u002Ftypes`, run `make version` + `make version-check`, commit + push to `main`, write the FACTUAL + NEUTRAL release notes from the full changeset, then dispatch release.yml with publish=true and the notes as its input (that dispatch runs the 8-platform build → glibc and pre-publish native gates → immutable 32-asset DRAFT release carrying the notes → signed packslip → npm OIDC STAGE → a held run until the maintainer approves with 2FA → the `v\u003Cver>` tag and `v0` pushed with the release deploy key → stable GitHub Release), `stager await` the approval with no timeout, then comment the version + release link on every closed issue + merged PR the release ships (mandatory maintainer hygiene). Do NOT cut until all fixes are green.","nubjs\u002Fnub","nubjs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6785695?v=4","01M7583N3EYYHSNB6FJQXCDMQH","Nub","01M7583N44MVMSN8385QEF3C8V",4440,"MIT","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Frelease\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: release\ndescription: >-\n  Cut a Nub patch release end-to-end in one invocation. Invoke (via the Skill\n  tool) once a release thread's targeted fixes are ALL landed on `main` and\n  CI-green. Encodes the full runbook: pick the version (patch bump in the\n  0.0.x\u002F0.1.x pre-release regime), audit `@nubjs\u002Ftypes`, run `make version`\n  + `make version-check`,\n  commit + push to `main`, write the FACTUAL + NEUTRAL release notes from the\n  full changeset, then dispatch release.yml with publish=true and the notes as\n  its input (that dispatch runs the 8-platform build → glibc and pre-publish\n  native gates → immutable 32-asset DRAFT release carrying the notes → signed\n  packslip → npm OIDC STAGE → a held run until the maintainer approves with\n  2FA → the `v\u003Cver>` tag and `v0` pushed with the release deploy key → stable\n  GitHub Release), `stager await` the approval with no timeout,\n  then comment the version + release link on every closed issue + merged PR the\n  release ships (mandatory maintainer hygiene). Do NOT cut until all fixes are\n  green.\nmetadata:\n  internal: true\n---\n\n# Cutting a Nub release\n\nA Nub release is dispatch-started and automated up to one human gate. A `workflow_dispatch` of `.github\u002Fworkflows\u002Frelease.yml` from `main` with `publish=true` and the release notes as its `notes` input reads the version from `npm\u002Fnub\u002Fpackage.json` at the dispatched commit, builds 8 platforms, gates them (test, lockfile conformance, glibc-floor, pre-publish smoke), creates an immutable DRAFT release with 32 assets and the notes as its body, signs a packslip, STAGES 19 npm packages via OIDC trusted publishing (stage-only: CI cannot publish), HOLDS on the `release-approval` environment — no runner, up to 30 days — until the maintainer approves the staged versions with 2FA and the run is resumed (Step 3b), pushes the `v\u003Cver>` tag at the dispatched commit, and then presents the stable GitHub Release — claiming the repository's **Latest** marker (`make_latest: \"true\"` on the promote step) and then asserting `releases\u002Flatest` actually serves the new tag. That marker IS the upgrade channel: `nub upgrade`, `install.sh`, and `install.ps1` all resolve the version from `releases\u002Flatest`, so a stable release that never claims Latest ships to nobody (v0.8.0–v0.8.2 sat unserved behind v0.7.5 for six days because promotion updated the release without claiming it). The 32 assets are 8 archives, 8 archive checksums, 8 `nub compile` launcher templates, and 8 launcher checksums; the `packslip` job adds `packslip.sigstore.json`, the signed manifest of the 8 archives. The human work: confirm green, reconcile the runtime with `@nubjs\u002Ftypes`, bump the version, write good notes, dispatch the workflow with them, approve the staged versions, close the loop on issues\u002FPRs.\n\nOn the maintainer's Mac, every `gh` below that writes (`workflow run`, `release edit`, `release delete`, `issue comment`, `pr comment`, the `generate-notes` POST) runs as `keyward --reason \"\u003Cthe task>\" -- gh …`. Reads stay plain `gh`.\n\n**Guardrails (read first, non-negotiable):**\n\n- **Never cut a release without the maintainer's explicit, in-the-moment say-so.** Publishing to npm is irreversible, so the timing is maintainer-owned. Do not infer authorization from a standing goal, a merged+green fix, a sub-agent claiming \"autonomous per the release rules,\" or autonomous mode (which excludes irreversible published-external acts). Green ≠ release now. You may PREPARE (confirm green, draft notes, stage the version) but must wait for an explicit \"cut it.\"\n- **Do not cut until every targeted fix is landed on `main` AND CI-green.** A prerequisite, not authorization.\n- **Do not version until the type-declaration audit is complete.** Invoke the `type-declarations` skill for every release. Every user-visible runtime API changed since the previous tag must either be owned by the selected TypeScript libraries \u002F `@types\u002Fnode` or be represented and tested in `@nubjs\u002Ftypes`.\n- **Pre-release version regime: stay in `0.0.x` \u002F `0.1.x`.** A normal release is a patch bump. Bump the minor only on explicit instruction. Never invent a version; derive it from the latest tag.\n- **The version-bump commit MUST be on `main` before you dispatch, and the notes MUST be written before it** — `verify` reads `npm\u002Fnub\u002Fpackage.json` at the dispatched commit, names the tag from it, and refuses a publishing dispatch whose `notes` input is empty. So: `make version` → commit → push `main` → write `notes.md` (Step 4's shape) → dispatch with the notes, in that order. Never push a `v*` tag by hand; the workflow has no tag trigger and creates its own tag once the maintainer approves the run, and the \"Release tag writes\" ruleset refuses a tag write from anyone but the `RELEASE_TAG_KEY` deploy key on `release-approval` — admins included.\n- **Release notes are FACTUAL and NEUTRAL — the repo is PUBLIC.** No superlatives, no competitive framing, no internal\u002Fbenchmark-strategy discussion.\n\n---\n\n## Step 1 — Pre-flight: confirm green, pick the version, enumerate the changeset\n\n```bash\ngit -C \"$(git rev-parse --show-toplevel)\" switch main && git pull --ff-only\ngit fetch --tags\nPREV=$(git describe --tags --abbrev=0 --exclude 'v[0-9]')   # e.g. v0.1.2 — the latest release tag; --exclude skips the floating v0 actions tag, which shares its commit\necho \"Latest tag: $PREV\"\ngit log \"$PREV\"..HEAD --oneline               # the full changeset since the last release\n```\n\n- Confirm the targeted fixes are all present in `$PREV..HEAD` and each is CI-green on `main`. If one is red or still converging, STOP and slip it to the next patch.\n- **Confirm docs are current** — a shipped feature whose `site\u002Fcontent\u002Fdocs\u002F` lags is a release blocker.\n- **Invoke the `type-declarations` skill and complete its mandatory release audit.** Reconcile every user-visible runtime change in `$PREV..HEAD` with TypeScript \u002F `@types\u002Fnode` ownership or an updated, fixture-tested, packed `@nubjs\u002Ftypes`. Missing or unverified declarations are a release blocker.\n- Pick the next version: patch-bump `$PREV`, dropping the leading `v`.\n- Keep the `git log` output — raw material for Steps 4 and 5. For `vendor\u002Faube\u002F**` changes, note the user-facing effect, not the diff.\n\n## Step 2 — Version bump\n\n```bash\nmake version V=\u003Cver>      # sets all 10 npm packages + Cargo.toml + runtime\u002Fversion.mjs in lockstep\nmake version-check        # MUST pass: cross-package consistency + @oxc-project\u002Fruntime ↔ nub-native oxc pin\n```\n\n`make version-check` is the same gate CI's `verify` job runs; a non-zero exit here means the release would fail at CI immediately, so fix it before committing. `make version` also moves `runtime\u002Fversion.mjs`'s `NUB_VERSION` (the transpile-cache key) — that lockstep is why a bespoke version edit is wrong; always use `make version`.\n\n## Step 3 — Commit, push, dispatch (the dispatch starts CI)\n\nThe release version-bump commit is a deliberate EXCEPTION to the repo's PR-default flow (AGENTS.md \"Default to a PR flow\") — it commits DIRECTLY to `main`. The commit is a version stamp and not a reviewable feature diff, so no PR.\n\n```bash\ngit status                # The shared tree usually carries another agent's WIP, so `git add -A`\n                          # would sweep it into the release commit. Path-scope instead:\ngit commit -m \"v\u003Cver>\" -- Cargo.lock Cargo.toml \\\n  crates\u002Fnub-core\u002FCargo.toml \\\n  crates\u002Fnub-native\u002FCargo.lock crates\u002Fnub-native\u002FCargo.toml \\\n  crates\u002Fnub-launcher\u002FCargo.lock crates\u002Fnub-phantom\u002FCargo.lock \\\n  npm\u002F*\u002Fpackage.json runtime\u002Fversion.mjs\ngit show --stat HEAD      # SANITY: 27 files, all version bumps, nothing else: 19 package.json\n                          # (10 nub + 9 runner), 3 Cargo.toml, 4 Cargo.lock, runtime\u002Fversion.mjs.\n                          # crates\u002Fnub-phantom\u002FCargo.lock is the one that gets missed — its\n                          # workspace is excluded from the root, ci.yml checks it `--locked`,\n                          # and v0.9.1 shipped without it (main went red, fixed in a follow-up).\n                          # `make version` also rewrites site\u002Fpublic\u002Fschema\u002Fv\u003Cmajor.minor>.json;\n                          # commit it when the snapshot is NEW for this minor, leave it when the\n                          # diff is formatting only (`git diff -w` empty).\n\n# ONE push, never `git push origin main --tags`. This clone has ~155 local tags against\n# ~84 on the remote — v1.x leftovers from the Node fork this repo began as — and `--tags`\n# offers every one of them. The remote rejects them AND the whole push dies with them, so\n# `main` does not land either.\ngit push origin main\n\n# Write the release notes FIRST (Step 4 has their shape) — they are an input of the dispatch,\n# and verify refuses a publishing dispatch without them. Then THIS is what starts the publish.\n# No tag is pushed by hand: release.yml has no tag trigger; verify names the tag from\n# npm\u002Fnub\u002Fpackage.json at the dispatched commit, and await-approval creates v\u003Cver> there\n# once the maintainer approves the run.\ngh workflow run release.yml -R nubjs\u002Fnub -f publish=true -f notes=\"$(cat notes.md)\"\ngh run list -R nubjs\u002Fnub --workflow release.yml --limit 1   # the run id, to watch\n# await-approval also moves the floating v\u003Cmajor> tag (v0) that `uses: nubjs\u002Fnub\u002F\u003Cname>@v0`\n# resolves through. Never push v0 by hand.\n```\n\nOnly `main` can be dispatched: `release-approval` admits no other ref, so `verify` refuses one before the build. How a failed release recovers depends on how far it got:\n\n- **Before `stable-immutable-release` creates the draft** (a failed test or build): nothing is left behind. Fix `main` and re-dispatch from it with the same version, revising the notes if the fix belongs in them.\n- **From the draft on**: re-run the failed jobs from the run's page, never re-dispatch. The re-run keeps the run's commit, artifacts and notes, so the draft's assets still byte-match; a dispatch from a moved `main` builds different bytes, and the draft's comparison refuses them. A re-run of `await-approval` waits for the approval again. GitHub allows re-runs for 30 days after the dispatch.\n- **A run that cannot continue** (its approval hold expired, or it is past the re-run window before its approval) is abandoned: `stager reject '@nubjs\u002F*@\u003Cver>'` drops its staged versions, `gh release delete v\u003Cver> --yes` deletes its draft (a draft has no tag), and the next version is released in its place.\n\nA dispatch whose version tag already exists at another commit is refused by `verify`: release a new version rather than moving a published tag.\n\nPost-merge, fast-forward the shared tree so it tracks origin: `git -C \u003Cshared-tree> pull --ff-only` (the eagerly-pull rule, AGENTS.md \"Default to a PR flow\" — the shared checkout otherwise drifts behind as PRs land).\n\nThe workflow runs, in order: `verify` (version consistency, notes present), `primer`, `test` + `conformance` + `glibc-floor-guard` + `pre-publish-gate`, `build` (8 platforms), `stable-immutable-release` (32 assets on a DRAFT release whose body is the notes), `packslip` (signs `packslip.sigstore.json` onto the draft), `publish-npm` (19 packages STAGED), `await-approval` (the run is HELD on the `release-approval` environment until the maintainer approves; then it pushes `v\u003Cver>` and moves `v0` with the release deploy key), `npm-served` (confirms npm serves every version and the root package installs and runs), `github-release` (publishes the draft as the stable release), then the post-publish fan-out — `test-install` \u002F `test-install-musl`, `docker`, `bump-homebrew-tap`, `submit-winget`.\n\n### Step 3b — Approve the staged versions (the human gate; maintainer only)\n\n`publish-npm` does not publish. It runs `npm stage publish` for every package, because the trusted publisher on each `@nubjs` package is stage-only, and then ends. The run moves to `await-approval`, a job on the `release-approval` environment whose required reviewer is the maintainer: GitHub holds the run there with no runner, for up to 30 days. Nothing is installable, and no GitHub Release is visible, until the maintainer approves the staged versions with 2FA. That approval is a proof of presence no token can supply, which is the whole point (the unauthorized v0.9.4 of 2026-09-21 published 18 packages from a stolen push credential; under staging it would have filled a queue).\n\nThe approval goes through `stager` (`~\u002FDocuments\u002Fstager`, on PATH), and the MAINTAINER runs it, in their own terminal. The agent hands over the command and parks on `stager await`:\n\n```bash\nstager                              # the maintainer: `a` approves every ready version, Enter, sign in on the npm\n                                    # page it opens, then ONE code from the authenticator approves all 19, oldest\n                                    # first; stager then approves the run's pending deployment, which resumes it\nstager await '@nubjs\u002F*@\u003Cver>'       # the agent: blocks, with no timeout, until npm serves every version — park on this\nstager reject '@nubjs\u002F*@\u003Cver>'      # drops the staged versions and fails the held run\n```\n\nNever `stager approve` (or the stager daemon's Approve notification) for a release: both approve through the browser, the maintainer's npm account cannot use \"skip 2FA for 5 minutes\", so they cost one browser approval per package, each on a link that expires within minutes. v0.9.7 burned two sign-ins and two dead links that way (2026-10-19).\n\n`stager` approves every staged version of a package oldest-first, so two versions staged at once end with `latest` on the higher one. A version still `validating` (npm's malware review, up to an hour) cannot be approved yet: `stager` lists its release under the table with nothing to decide, so run it again once the review finishes (the stager daemon's notification says when). Without stager: `npm stage approve \u003Cid>` per package (or the Staged Packages tab on npmjs.com), then approve the pending deployment on the run's page. A deployment approved before the npm approval fails `npm-served` at its registry check; re-run that job after approving.\n\n**Park on `stager await` (a background shell) rather than on the run.** It returns when the versions are live; the run's remaining jobs then take a few minutes. The release is not done until `stable-immutable-release`, `publish-npm`, `await-approval` and `github-release` are green.\n\n### The other distribution channels ride the same run — no manual step, but they are not free\n\nnpm is not the only thing a release publishes. Two jobs push OUTSIDE this repo, and neither needs a manual action:\n\n- **`bump-homebrew-tap`** regenerates `Formula\u002Fnub.rb` with `.github\u002Fscripts\u002Fgen-homebrew-formula.sh` and pushes it to [`nubjs\u002Fhomebrew-tap`](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fhomebrew-tap). It reads the release's own `.sha256` sidecars, so it needs `github-release` to have finished. It is gated on the `HOMEBREW_TAP_TOKEN` secret and SKIPS WITH A WARNING if that secret is ever absent — a skip is a silent stale tap, so treat the warning as a failure.\n- **`submit-winget`** opens a PR against `microsoft\u002Fwinget-pkgs`. Gated on `WINGET_PAT`, which is currently unset, so this job no-ops today.\n\n**The formula is regenerated from the script at the released commit, which makes it a CLOBBER.** Any hand-edit to the tap is overwritten by the next release. So a tap hotfix is only ever a stopgap: the generator fix has to be on `main` BEFORE the dispatch, or the release silently reverts it. This is how [#676](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fissues\u002F676) shipped — the archive layout changed, the generator was not updated with it, and nothing read the formula before it reached users. `bump-homebrew-tap` now installs the formula from a throwaway local tap on macOS before pushing it, so a formula that cannot install fails the job and leaves the tap on the previous working version.\n\n## Step 4 — Comprehensive release notes (Opus)\n\nThe notes are the `notes` input of the dispatch (Step 3): `stable-immutable-release` creates the draft with them as its body and `github-release` promotes it unchanged, so they are written BEFORE the dispatch, into `notes.md`. Hand-written, scannable, factual; never a raw auto-list. Drive this on Opus.\n\nBuild the notes from the **full** `git log \"$PREV\"..HEAD` changeset (Step 1), not just the headline fixes — every user-affecting change ships.\n\n**Leave out what the maintainer is holding back.** Read `internal\u002Frelease-holds.md` before drafting. A change listed there ships in the binary but is not announced: it gets no line in the curated notes, its PR comes out of the generated `## What's Changed` list, the blog post (Step 4b) does not mention it, and its docs page keeps `unpublished: true`. Only the maintainer lifts a hold.\n\n**Notes must be SCANNABLE, not paragraph-dense.** A reader skims headings, tables, and the heads-up callout and gets the whole release at a glance — they should never have to read a run-on paragraph to find what changed. The cross-project prose\u002Ftone guide for all public-facing copy — including the release-notes shape — is the `prose-writing` skill's guide. The concrete rules:\n\n- **One-line intro** stating what the release is about (the dominant theme).\n- **Themed `##` sections, not generic buckets.** Group by what the changes *touch* — e.g. \"Lockfile compatibility\" \u002F \"Performance\" \u002F \"Runtime fixes\" \u002F \"Documentation\" \u002F \"Testing & internals\" — not by Fixes\u002FCompatibility\u002FInternal abstractions. Each major change gets a short titled blurb or a table row, never a multi-sentence paragraph.\n- **A table for a batch of independent fixes.** When several small fixes share a theme (a run of lockfile fixes), put them in a table — `| Area | What changed | Commit |` — tables read far faster than a bullet wall.\n- **A callout for heads-up \u002F migration items.** Anything a user should know before upgrading (a cache-schema re-warm, a behavior change) goes in a GitHub-flavored alert: `> [!IMPORTANT]` (or `> [!NOTE]`), not buried in a bullet.\n- **Per-item links.** Every fix\u002Fchange links to its commit (`[`abc1234`](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fcommit\u002F\u003Cfull-sha>)`) and\u002For PR (`[#17](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fpull\u002F17)`). Issue refs link too (`[#16](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fissues\u002F16)`).\n- **An auto-generated `## What's Changed` section at the BOTTOM (MANDATORY) — this is what makes \"lists every change\" literally true.** GitHub's PR-level breakdown (every merged PR + author + New Contributors) plus the `**Full Changelog**: \u003CPREV>...v\u003Cver>` compare link, from `gh api …\u002Freleases\u002Fgenerate-notes` (command below). Append it verbatim under a `---` separator below the curated narrative — the curated themes stay on top, the exhaustive PR list goes underneath.\n- **Tone: factual + neutral.** Readability ≠ hype. Each line states what changed. No superlatives, no competitive framing, no editorializing. (Same bar as commit messages — AGENTS.md.) Visual interest comes from structure (sections, tables, callouts), never from marketing language.\n\n**Template** (adapt the section names to the actual changeset):\n\n```markdown\n\u003COne-line intro: what this release is about.>\n\n> [!IMPORTANT]\n> **\u003CHeads-up title>.** \u003CThe one thing to know before upgrading. Omit the callout if there's nothing.>\n\n## \u003CTheme A, e.g. Lockfile compatibility>\n\n\u003COptional one-line lead.>\n\n| Area | What changed | Commit |\n| --- | --- | --- |\n| \u003Carea> | \u003Cwhat changed, one clause> | [`\u003Csha7>`](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fcommit\u002F\u003Cfull-sha>) |\n\n## \u003CTheme B, e.g. Performance>\n\n\u003CShort blurb with the PR link inline.> ([#17](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fpull\u002F17))\n\n## Testing & internals\n\n- \u003CBullet> ([`\u003Csha7>`](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fcommit\u002F\u003Cfull-sha>)).\n\n---\n\n## What's Changed\n\n\u003C!-- appended verbatim from `gh api …\u002Freleases\u002Fgenerate-notes` — the PR list, New Contributors, and Full Changelog link -->\n* \u003CPR title> by @\u003Cauthor> in https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fpull\u002F\u003Cn>\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fcompare\u002F\u003CPREV>...v\u003Cver>\n```\n\nGenerate the bottom `## What's Changed` breakdown mechanically so every merged PR is listed (the tag does not exist yet, so name the commit):\n\n```bash\n# PR-level list + New Contributors + Full Changelog compare link — append verbatim below the curated narrative\ngh api repos\u002Fnubjs\u002Fnub\u002Freleases\u002Fgenerate-notes \\\n  -f tag_name=v\u003Cver> -f target_commitish=main -f previous_tag_name=$PREV --jq '.body'\n```\n\nAppend that block under a `---` separator below the curated sections, save `notes.md`, and dispatch with it. The curated narrative stays on top; this exhaustive PR list goes underneath.\n\nTo correct the notes after the dispatch, edit the release in place, draft or published (a re-run of `stable-immutable-release` rewrites a draft's body from the run's own `notes` input, so edit again after one):\n\n```bash\ngh release edit v\u003Cver> --notes-file notes.md\ngh release view v\u003Cver> --repo nubjs\u002Fnub --json body -q .body   # verify it rendered\n```\n\nThe v0.1.4 and v0.1.3 release bodies are the reference exemplars of this structure.\n\n## Step 4b — Publish the notes as a blog post (MANDATORY — every release)\n\nEvery release also ships as a blog post under `site\u002Fcontent\u002Fblog\u002F`. This is a standard release step, done on every version — the same content\u002Fpresentation-to-`main` exception as docs (commit directly to `main`, no PR). Before writing, invoke the `prose-writing` skill and follow its guide (blog copy: routine patch notes stay factual, neutral, unsigned, scannable — no hype, no personality; a milestone version gets a fuller treatment but the same neutral bar).\n\n- **File:** `site\u002Fcontent\u002Fblog\u002Fnub-\u003Cmajor>-\u003Cminor>-\u003Cpatch>.mdx` (e.g. `nub-0-2-10.mdx`) — the filename is the URL slug; fumadocs auto-globs `content\u002Fblog\u002F*.mdx`, so no index\u002Fmeta wiring is needed.\n- **Frontmatter** (schema from `source.config.ts`, all four required): `title: \"Nub \u003Cver>\"` (add a `: \u003Ctheme>` subtitle only for a milestone), `description:` a plain sentence with **no inline code\u002Fbackticks** (the field renders raw), `author: The Nub Team`, `date: \u003CYYYY-MM-DD>` **back-dated to the release's `publishedAt`** so the timeline stays chronological.\n- **Body:** a short lede, then the release's themed sections adapted to blog prose — not a raw changelog dump. Carry over the callouts and per-theme tables. Close with `The [full release notes](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Freleases\u002Ftag\u002Fv\u003Cver>) list every change in this release.`\n- **Structure a feature-carrying release around its features:** one top-level `##` per major new feature, then `## Breaking changes`, then `## Bug fixes`. A batch of independent fixes goes in a table whose FIRST column is the PR link — `.blog-prose td:not(:last-child)` is `width:1%` + `nowrap` by design, so a prose column anywhere but last blows the table past the 720px article column.\n- **End every post with the get-started block** — a final `## Get started` heading followed by `\u003CGetStarted \u002F>`, which renders the install tabs plus the pointer at the agent adoption prompt. Every existing post carries it; a new one without it is the odd one out.\n- **Catch up a cold reader with `\u003CNubIntro \u002F>`** near the top when the post leads with feature news rather than an introduction. Both components live in `site\u002Fsrc\u002Fcomponents\u002F` and are registered globally in `site\u002Fmdx-components.tsx`; their copy is maintainer-authored, so edit the component, never a single `.mdx`.\n- **Scale to the release:** a small patch gets a short post; a milestone opens with the thing working.\n- **Nothing held back appears in the post** — the holds in `internal\u002Frelease-holds.md` (Step 4) apply here too.\n\nExemplars: `site\u002Fcontent\u002Fblog\u002Fnub-0-7-0.mdx` (feature-carrying, full structure), `nub-0-2-0.mdx` (milestone), `nub-0-2-5.mdx` (small patch).\n\n## Step 5 — Close the loop on issues + PRs (MANDATORY — always, no matter what)\n\nComment a brief factual note carrying **the version and a link to the release** on **EVERY closed issue and EVERY merged PR that shipped in this release** — not just the headline fixes. This is mandatory maintainer hygiene (AGENTS.md \"Git & GitHub maintainer hygiene\"); do it on every release without exception. Users see \"fixed\" the moment an issue closes, but the fix is not on the released binary until the release publishes — this comment closes that credibility gap and gives the reporter a link to the exact release.\n\nThe release URL is `https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Freleases\u002Ftag\u002Fv\u003Cver>`. Every comment includes both the version and that link, e.g. `Shipped in v\u003Cver>: \u003Crelease URL>`.\n\n**Enumerate the targets MECHANICALLY — never a hand-typed list.** A hand-enumerated pass silently misses any issue still open at cut time or closed AFTER the cut (this happened on v0.3.0). Drive the set from the union of three queries:\n\n```bash\n# 1. Every issue a shipped PR auto-closes (closingIssuesReferences) + any Closes\u002FFixes\u002FResolves #N in a PR body:\ngh pr list --repo nubjs\u002Fnub --state merged --search \"merged:\u003CPREV-date>..\u003Ccut-date>\" \\\n  --json number,body,closingIssuesReferences --limit 200 \\\n  --jq '.[] | {pr:.number, closes:[.closingIssuesReferences[].number], refs:([.body|scan(\"(?i)(?:clos|fix|resolv)\\\\w*\\\\s+#(\\\\d+)\")]|flatten)}'\n# 2. Every issue closed in the release window (catches issues closed without a linked PR):\ngh issue list --repo nubjs\u002Fnub --state closed --search \"closed:\u003CPREV-date>..\u003Ccut-date+1>\" \\\n  --json number,title,stateReason --limit 200\n```\n\nFor each issue\u002FPR in the union, check whether it ALREADY carries the comment before posting (`gh issue view \u003Cn> --repo nubjs\u002Fnub --json comments --jq '[.comments[].body|select(test(\"Shipped in v\u003Cver>\"))]|length'`) — skip a `NOT_PLANNED` issue with no shipped fix. **Re-run this pass for any issue closed AFTER the cut** — a late-closing issue does not appear in the first sweep.\n\nThen comment (extremely concise — the version and release link, no recap of what was done or how; add a brief thanks when the reporter or PR author is external):\n\n```bash\nREL=\"https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Freleases\u002Ftag\u002Fv\u003Cver>\"\ngh issue comment \u003Cn> --body \"Fixed in v\u003Cver> (now published): $REL\"\ngh pr comment \u003Cn>    --body \"Shipped in v\u003Cver>: $REL — thanks for the contribution.\"\n```\n\nHit **every** issue and PR the mechanical union above surfaces — not just the headline fixes. This is non-optional; do not skip an issue because it was \"minor,\" and do not fall back to the release thread's targeted-fix list as the source of truth (it under-counts). Do not comment on issues unrelated to the release.\n\n## Step 6 — Post-release verify\n\nConfirm the automated publish actually landed:\n\n```bash\ngh api repos\u002Fnubjs\u002Fnub\u002Freleases\u002Flatest --jq .tag_name   # MUST print v\u003Cver> — this endpoint IS the\n                                             # upgrade channel (nub upgrade + both installers);\n                                             # anything else means users are served an old release\nnpm view @nubjs\u002Fnub@\u003Cver> version            # the root package is on the registry\nnpm view @nubjs\u002Fnub@\u003Cver> dist.tarball        # sanity: published artifact exists\ngh release view v\u003Cver> --json assets --jq '.assets[].name' | sort\n# expect these exact 33 assets:\n# nub-darwin-arm64.tar.gz\n# nub-darwin-arm64.tar.gz.sha256\n# nub-darwin-x64.tar.gz\n# nub-darwin-x64.tar.gz.sha256\n# nub-linux-arm64.tar.gz\n# nub-linux-arm64.tar.gz.sha256\n# nub-linux-arm64-musl.tar.gz\n# nub-linux-arm64-musl.tar.gz.sha256\n# nub-linux-x64.tar.gz\n# nub-linux-x64.tar.gz.sha256\n# nub-linux-x64-musl.tar.gz\n# nub-linux-x64-musl.tar.gz.sha256\n# nub-win32-arm64.zip\n# nub-win32-arm64.zip.sha256\n# nub-win32-x64.zip\n# nub-win32-x64.zip.sha256\n# nub-launcher-darwin-arm64\n# nub-launcher-darwin-arm64.sha256\n# nub-launcher-darwin-x64\n# nub-launcher-darwin-x64.sha256\n# nub-launcher-linux-arm64\n# nub-launcher-linux-arm64.sha256\n# nub-launcher-linux-arm64-musl\n# nub-launcher-linux-arm64-musl.sha256\n# nub-launcher-linux-x64\n# nub-launcher-linux-x64.sha256\n# nub-launcher-linux-x64-musl\n# nub-launcher-linux-x64-musl.sha256\n# nub-launcher-win32-arm64.exe\n# nub-launcher-win32-arm64.exe.sha256\n# nub-launcher-win32-x64.exe\n# nub-launcher-win32-x64.exe.sha256\n# packslip.sigstore.json\n```\n\nA complete release has: the 10 npm packages published (`@nubjs\u002Fnub`, `@nubjs\u002Fnub-\u003Cplatform>` ×8, `@nubjs\u002Ftypes`), the stable GitHub Release present and marked **Latest**, and all 33 assets attached. CI's `stable-immutable-release` job asserts the 32 build assets and `packslip` adds the 33rd before npm can stage, `github-release` promotes that same release after npm succeeds, and `test-install` smokes the published package. This step confirms that the workflow reached green.\n\nThe 8 `nub-launcher-*` assets are what `nub compile --platform \u003Cforeign>` fetches to cross-compile, so a release missing one silently disables cross-compiling to that platform for everyone on that version.\n\n**If CI failed partway:** Re-run the failed job from the Actions UI. The `stable-immutable-release` job rebuilds the deterministic archives and re-uploads missing assets before npm starts; `packslip` keeps an existing signed manifest and signs one only when absent; `publish-npm` skips packages already published or already staged during a partial attempt; a run whose approval hold expired (30 days) is abandoned for the next version (Step 3); `github-release` only promotes the asset-complete prerelease. Do not re-cut a version for a failed upload or partial npm publish.\n\nThen confirm the Homebrew channel actually moved — the tap lives in another repo, so a green release run here is not evidence that it did:\n\n```bash\ngh api repos\u002Fnubjs\u002Fhomebrew-tap\u002Fcontents\u002FFormula\u002Fnub.rb --jq '.content' | base64 -d | grep -E 'version|bin\\.install'\n# expect version \"\u003Cver>\" and the bin.install lines matching the current archive layout\n\nbrew update && brew install nubjs\u002Ftap\u002Fnub && nub --version && nubx --help | head -1\n# or, without touching your own machine:\ndocker run --rm homebrew\u002Fbrew brew install nubjs\u002Ftap\u002Fnub\n```\n\nA complete release has the 10 npm packages published (`@nubjs\u002Fnub`, `@nubjs\u002Fnub-\u003Cplatform>` ×8, `@nubjs\u002Ftypes`), the GitHub Release present and marked **Latest**, all 33 assets attached, and the tap formula bumped to `\u003Cver>` and installable.\n\n**If CI failed partway:** `publish-npm` and `github-release` are split + idempotent on purpose — re-run the failed job from the Actions UI (npm publish skips already-published packages; the release job re-uploads only missing assets). Never re-cut a version for a flaky asset upload. `bump-homebrew-tap` is re-runnable too, and failing it is the safe outcome: the tap keeps serving the previous version rather than a broken formula, so fix the generator on `main` and re-run the job — never hand-edit the tap as the fix, since the next release regenerates it.\n\n---\n\n## Quick reference\n\n| Step | Command |\n| --- | --- |\n| Changeset | `git log $(git describe --tags --abbrev=0)..HEAD --oneline` |\n| Types | Invoke `type-declarations`; reconcile every runtime API in the changeset before versioning |\n| Bump | `make version V=\u003Cver>` → `make version-check` |\n| Notes | write `notes.md` (curated sections + generated `## What's Changed`) BEFORE the dispatch |\n| Cut | `git commit -m \"v\u003Cver>\" -- \u003Cversion files>` → `git push origin main` (never `--tags`) → `gh workflow run release.yml -R nubjs\u002Fnub -f publish=true -f notes=\"$(cat notes.md)\"` |\n| Approve | the maintainer runs `stager` (`a`, Enter, sign in, one code) → the agent parks on `stager await '@nubjs\u002F*@\u003Cver>'` |\n| Blog | `site\u002Fcontent\u002Fblog\u002Fnub-\u003Cx>-\u003Cy>-\u003Cz>.mdx` — back-dated to `publishedAt` (direct to `main`) |\n| Tap | automatic via `bump-homebrew-tap`; verify with `gh api repos\u002Fnubjs\u002Fhomebrew-tap\u002Fcontents\u002FFormula\u002Fnub.rb --jq .content \\| base64 -d \\| head -5` |\n| Loop | `gh issue comment \u003Cn> --body \"Fixed in v\u003Cver>: \u003Crelease URL>\"` (every closed issue + merged PR) |\n| Verify | `gh api repos\u002Fnubjs\u002Fnub\u002Freleases\u002Flatest --jq .tag_name` (= `v\u003Cver>`) · `npm view @nubjs\u002Fnub@\u003Cver> version` · `gh release view v\u003Cver> --json assets` |\n\nInvoked via the Skill tool once a release thread's targeted fixes are all landed on `main` and CI-green.\n","# Cutting a Nub release\n\nA Nub release is dispatch-started and automated up to one human gate. A `workflow_dispatch` of `.github\u002Fworkflows\u002Frelease.yml` from `main` with `publish=true` and the release notes as its `notes` input reads the version from `npm\u002Fnub\u002Fpackage.json` at the dispatched commit, builds 8 platforms, gates them (test, lockfile conformance, glibc-floor, pre-publish smoke), creates an immutable DRAFT release with 32 assets and the notes as its body, signs a packslip, STAGES 19 npm packages via OIDC trusted publishing (stage-only: CI cannot publish), HOLDS on the `release-approval` environment — no runner, up to 30 days — until the maintainer approves the staged versions with 2FA and the run is resumed (Step 3b), pushes the `v\u003Cver>` tag at the dispatched commit, and then presents the stable GitHub Release — claiming the repository's **Latest** marker (`make_latest: \"true\"` on the promote step) and then asserting `releases\u002Flatest` actually serves the new tag. That marker IS the upgrade channel: `nub upgrade`, `install.sh`, and `install.ps1` all resolve the version from `releases\u002Flatest`, so a stable release that never claims Latest ships to nobody (v0.8.0–v0.8.2 sat unserved behind v0.7.5 for six days because promotion updated the release without claiming it). The 32 assets are 8 archives, 8 archive checksums, 8 `nub compile` launcher templates, and 8 launcher checksums; the `packslip` job adds `packslip.sigstore.json`, the signed manifest of the 8 archives. The human work: confirm green, reconcile the runtime with `@nubjs\u002Ftypes`, bump the version, write good notes, dispatch the workflow with them, approve the staged versions, close the loop on issues\u002FPRs.\n\nOn the maintainer's Mac, every `gh` below that writes (`workflow run`, `release edit`, `release delete`, `issue comment`, `pr comment`, the `generate-notes` POST) runs as `keyward --reason \"\u003Cthe task>\" -- gh …`. Reads stay plain `gh`.\n\n**Guardrails (read first, non-negotiable):**\n\n- **Never cut a release without the maintainer's explicit, in-the-moment say-so.** Publishing to npm is irreversible, so the timing is maintainer-owned. Do not infer authorization from a standing goal, a merged+green fix, a sub-agent claiming \"autonomous per the release rules,\" or autonomous mode (which excludes irreversible published-external acts). Green ≠ release now. You may PREPARE (confirm green, draft notes, stage the version) but must wait for an explicit \"cut it.\"\n- **Do not cut until every targeted fix is landed on `main` AND CI-green.** A prerequisite, not authorization.\n- **Do not version until the type-declaration audit is complete.** Invoke the `type-declarations` skill for every release. Every user-visible runtime API changed since the previous tag must either be owned by the selected TypeScript libraries \u002F `@types\u002Fnode` or be represented and tested in `@nubjs\u002Ftypes`.\n- **Pre-release version regime: stay in `0.0.x` \u002F `0.1.x`.** A normal release is a patch bump. Bump the minor only on explicit instruction. Never invent a version; derive it from the latest tag.\n- **The version-bump commit MUST be on `main` before you dispatch, and the notes MUST be written before it** — `verify` reads `npm\u002Fnub\u002Fpackage.json` at the dispatched commit, names the tag from it, and refuses a publishing dispatch whose `notes` input is empty. So: `make version` → commit → push `main` → write `notes.md` (Step 4's shape) → dispatch with the notes, in that order. Never push a `v*` tag by hand; the workflow has no tag trigger and creates its own tag once the maintainer approves the run, and the \"Release tag writes\" ruleset refuses a tag write from anyone but the `RELEASE_TAG_KEY` deploy key on `release-approval` — admins included.\n- **Release notes are FACTUAL and NEUTRAL — the repo is PUBLIC.** No superlatives, no competitive framing, no internal\u002Fbenchmark-strategy discussion.\n\n---\n\n## Step 1 — Pre-flight: confirm green, pick the version, enumerate the changeset\n\n```bash\ngit -C \"$(git rev-parse --show-toplevel)\" switch main && git pull --ff-only\ngit fetch --tags\nPREV=$(git describe --tags --abbrev=0 --exclude 'v[0-9]')   # e.g. v0.1.2 — the latest release tag; --exclude skips the floating v0 actions tag, which shares its commit\necho \"Latest tag: $PREV\"\ngit log \"$PREV\"..HEAD --oneline               # the full changeset since the last release\n```\n\n- Confirm the targeted fixes are all present in `$PREV..HEAD` and each is CI-green on `main`. If one is red or still converging, STOP and slip it to the next patch.\n- **Confirm docs are current** — a shipped feature whose `site\u002Fcontent\u002Fdocs\u002F` lags is a release blocker.\n- **Invoke the `type-declarations` skill and complete its mandatory release audit.** Reconcile every user-visible runtime change in `$PREV..HEAD` with TypeScript \u002F `@types\u002Fnode` ownership or an updated, fixture-tested, packed `@nubjs\u002Ftypes`. Missing or unverified declarations are a release blocker.\n- Pick the next version: patch-bump `$PREV`, dropping the leading `v`.\n- Keep the `git log` output — raw material for Steps 4 and 5. For `vendor\u002Faube\u002F**` changes, note the user-facing effect, not the diff.\n\n## Step 2 — Version bump\n\n```bash\nmake version V=\u003Cver>      # sets all 10 npm packages + Cargo.toml + runtime\u002Fversion.mjs in lockstep\nmake version-check        # MUST pass: cross-package consistency + @oxc-project\u002Fruntime ↔ nub-native oxc pin\n```\n\n`make version-check` is the same gate CI's `verify` job runs; a non-zero exit here means the release would fail at CI immediately, so fix it before committing. `make version` also moves `runtime\u002Fversion.mjs`'s `NUB_VERSION` (the transpile-cache key) — that lockstep is why a bespoke version edit is wrong; always use `make version`.\n\n## Step 3 — Commit, push, dispatch (the dispatch starts CI)\n\nThe release version-bump commit is a deliberate EXCEPTION to the repo's PR-default flow (AGENTS.md \"Default to a PR flow\") — it commits DIRECTLY to `main`. The commit is a version stamp and not a reviewable feature diff, so no PR.\n\n```bash\ngit status                # The shared tree usually carries another agent's WIP, so `git add -A`\n                          # would sweep it into the release commit. Path-scope instead:\ngit commit -m \"v\u003Cver>\" -- Cargo.lock Cargo.toml \\\n  crates\u002Fnub-core\u002FCargo.toml \\\n  crates\u002Fnub-native\u002FCargo.lock crates\u002Fnub-native\u002FCargo.toml \\\n  crates\u002Fnub-launcher\u002FCargo.lock crates\u002Fnub-phantom\u002FCargo.lock \\\n  npm\u002F*\u002Fpackage.json runtime\u002Fversion.mjs\ngit show --stat HEAD      # SANITY: 27 files, all version bumps, nothing else: 19 package.json\n                          # (10 nub + 9 runner), 3 Cargo.toml, 4 Cargo.lock, runtime\u002Fversion.mjs.\n                          # crates\u002Fnub-phantom\u002FCargo.lock is the one that gets missed — its\n                          # workspace is excluded from the root, ci.yml checks it `--locked`,\n                          # and v0.9.1 shipped without it (main went red, fixed in a follow-up).\n                          # `make version` also rewrites site\u002Fpublic\u002Fschema\u002Fv\u003Cmajor.minor>.json;\n                          # commit it when the snapshot is NEW for this minor, leave it when the\n                          # diff is formatting only (`git diff -w` empty).\n\n# ONE push, never `git push origin main --tags`. This clone has ~155 local tags against\n# ~84 on the remote — v1.x leftovers from the Node fork this repo began as — and `--tags`\n# offers every one of them. The remote rejects them AND the whole push dies with them, so\n# `main` does not land either.\ngit push origin main\n\n# Write the release notes FIRST (Step 4 has their shape) — they are an input of the dispatch,\n# and verify refuses a publishing dispatch without them. Then THIS is what starts the publish.\n# No tag is pushed by hand: release.yml has no tag trigger; verify names the tag from\n# npm\u002Fnub\u002Fpackage.json at the dispatched commit, and await-approval creates v\u003Cver> there\n# once the maintainer approves the run.\ngh workflow run release.yml -R nubjs\u002Fnub -f publish=true -f notes=\"$(cat notes.md)\"\ngh run list -R nubjs\u002Fnub --workflow release.yml --limit 1   # the run id, to watch\n# await-approval also moves the floating v\u003Cmajor> tag (v0) that `uses: nubjs\u002Fnub\u002F\u003Cname>@v0`\n# resolves through. Never push v0 by hand.\n```\n\nOnly `main` can be dispatched: `release-approval` admits no other ref, so `verify` refuses one before the build. How a failed release recovers depends on how far it got:\n\n- **Before `stable-immutable-release` creates the draft** (a failed test or build): nothing is left behind. Fix `main` and re-dispatch from it with the same version, revising the notes if the fix belongs in them.\n- **From the draft on**: re-run the failed jobs from the run's page, never re-dispatch. The re-run keeps the run's commit, artifacts and notes, so the draft's assets still byte-match; a dispatch from a moved `main` builds different bytes, and the draft's comparison refuses them. A re-run of `await-approval` waits for the approval again. GitHub allows re-runs for 30 days after the dispatch.\n- **A run that cannot continue** (its approval hold expired, or it is past the re-run window before its approval) is abandoned: `stager reject '@nubjs\u002F*@\u003Cver>'` drops its staged versions, `gh release delete v\u003Cver> --yes` deletes its draft (a draft has no tag), and the next version is released in its place.\n\nA dispatch whose version tag already exists at another commit is refused by `verify`: release a new version rather than moving a published tag.\n\nPost-merge, fast-forward the shared tree so it tracks origin: `git -C \u003Cshared-tree> pull --ff-only` (the eagerly-pull rule, AGENTS.md \"Default to a PR flow\" — the shared checkout otherwise drifts behind as PRs land).\n\nThe workflow runs, in order: `verify` (version consistency, notes present), `primer`, `test` + `conformance` + `glibc-floor-guard` + `pre-publish-gate`, `build` (8 platforms), `stable-immutable-release` (32 assets on a DRAFT release whose body is the notes), `packslip` (signs `packslip.sigstore.json` onto the draft), `publish-npm` (19 packages STAGED), `await-approval` (the run is HELD on the `release-approval` environment until the maintainer approves; then it pushes `v\u003Cver>` and moves `v0` with the release deploy key), `npm-served` (confirms npm serves every version and the root package installs and runs), `github-release` (publishes the draft as the stable release), then the post-publish fan-out — `test-install` \u002F `test-install-musl`, `docker`, `bump-homebrew-tap`, `submit-winget`.\n\n### Step 3b — Approve the staged versions (the human gate; maintainer only)\n\n`publish-npm` does not publish. It runs `npm stage publish` for every package, because the trusted publisher on each `@nubjs` package is stage-only, and then ends. The run moves to `await-approval`, a job on the `release-approval` environment whose required reviewer is the maintainer: GitHub holds the run there with no runner, for up to 30 days. Nothing is installable, and no GitHub Release is visible, until the maintainer approves the staged versions with 2FA. That approval is a proof of presence no token can supply, which is the whole point (the unauthorized v0.9.4 of 2026-09-21 published 18 packages from a stolen push credential; under staging it would have filled a queue).\n\nThe approval goes through `stager` (`~\u002FDocuments\u002Fstager`, on PATH), and the MAINTAINER runs it, in their own terminal. The agent hands over the command and parks on `stager await`:\n\n```bash\nstager                              # the maintainer: `a` approves every ready version, Enter, sign in on the npm\n                                    # page it opens, then ONE code from the authenticator approves all 19, oldest\n                                    # first; stager then approves the run's pending deployment, which resumes it\nstager await '@nubjs\u002F*@\u003Cver>'       # the agent: blocks, with no timeout, until npm serves every version — park on this\nstager reject '@nubjs\u002F*@\u003Cver>'      # drops the staged versions and fails the held run\n```\n\nNever `stager approve` (or the stager daemon's Approve notification) for a release: both approve through the browser, the maintainer's npm account cannot use \"skip 2FA for 5 minutes\", so they cost one browser approval per package, each on a link that expires within minutes. v0.9.7 burned two sign-ins and two dead links that way (2026-10-19).\n\n`stager` approves every staged version of a package oldest-first, so two versions staged at once end with `latest` on the higher one. A version still `validating` (npm's malware review, up to an hour) cannot be approved yet: `stager` lists its release under the table with nothing to decide, so run it again once the review finishes (the stager daemon's notification says when). Without stager: `npm stage approve \u003Cid>` per package (or the Staged Packages tab on npmjs.com), then approve the pending deployment on the run's page. A deployment approved before the npm approval fails `npm-served` at its registry check; re-run that job after approving.\n\n**Park on `stager await` (a background shell) rather than on the run.** It returns when the versions are live; the run's remaining jobs then take a few minutes. The release is not done until `stable-immutable-release`, `publish-npm`, `await-approval` and `github-release` are green.\n\n### The other distribution channels ride the same run — no manual step, but they are not free\n\nnpm is not the only thing a release publishes. Two jobs push OUTSIDE this repo, and neither needs a manual action:\n\n- **`bump-homebrew-tap`** regenerates `Formula\u002Fnub.rb` with `.github\u002Fscripts\u002Fgen-homebrew-formula.sh` and pushes it to [`nubjs\u002Fhomebrew-tap`](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fhomebrew-tap). It reads the release's own `.sha256` sidecars, so it needs `github-release` to have finished. It is gated on the `HOMEBREW_TAP_TOKEN` secret and SKIPS WITH A WARNING if that secret is ever absent — a skip is a silent stale tap, so treat the warning as a failure.\n- **`submit-winget`** opens a PR against `microsoft\u002Fwinget-pkgs`. Gated on `WINGET_PAT`, which is currently unset, so this job no-ops today.\n\n**The formula is regenerated from the script at the released commit, which makes it a CLOBBER.** Any hand-edit to the tap is overwritten by the next release. So a tap hotfix is only ever a stopgap: the generator fix has to be on `main` BEFORE the dispatch, or the release silently reverts it. This is how [#676](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fissues\u002F676) shipped — the archive layout changed, the generator was not updated with it, and nothing read the formula before it reached users. `bump-homebrew-tap` now installs the formula from a throwaway local tap on macOS before pushing it, so a formula that cannot install fails the job and leaves the tap on the previous working version.\n\n## Step 4 — Comprehensive release notes (Opus)\n\nThe notes are the `notes` input of the dispatch (Step 3): `stable-immutable-release` creates the draft with them as its body and `github-release` promotes it unchanged, so they are written BEFORE the dispatch, into `notes.md`. Hand-written, scannable, factual; never a raw auto-list. Drive this on Opus.\n\nBuild the notes from the **full** `git log \"$PREV\"..HEAD` changeset (Step 1), not just the headline fixes — every user-affecting change ships.\n\n**Leave out what the maintainer is holding back.** Read `internal\u002Frelease-holds.md` before drafting. A change listed there ships in the binary but is not announced: it gets no line in the curated notes, its PR comes out of the generated `## What's Changed` list, the blog post (Step 4b) does not mention it, and its docs page keeps `unpublished: true`. Only the maintainer lifts a hold.\n\n**Notes must be SCANNABLE, not paragraph-dense.** A reader skims headings, tables, and the heads-up callout and gets the whole release at a glance — they should never have to read a run-on paragraph to find what changed. The cross-project prose\u002Ftone guide for all public-facing copy — including the release-notes shape — is the `prose-writing` skill's guide. The concrete rules:\n\n- **One-line intro** stating what the release is about (the dominant theme).\n- **Themed `##` sections, not generic buckets.** Group by what the changes *touch* — e.g. \"Lockfile compatibility\" \u002F \"Performance\" \u002F \"Runtime fixes\" \u002F \"Documentation\" \u002F \"Testing & internals\" — not by Fixes\u002FCompatibility\u002FInternal abstractions. Each major change gets a short titled blurb or a table row, never a multi-sentence paragraph.\n- **A table for a batch of independent fixes.** When several small fixes share a theme (a run of lockfile fixes), put them in a table — `| Area | What changed | Commit |` — tables read far faster than a bullet wall.\n- **A callout for heads-up \u002F migration items.** Anything a user should know before upgrading (a cache-schema re-warm, a behavior change) goes in a GitHub-flavored alert: `> [!IMPORTANT]` (or `> [!NOTE]`), not buried in a bullet.\n- **Per-item links.** Every fix\u002Fchange links to its commit (`[`abc1234`](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fcommit\u002F\u003Cfull-sha>)`) and\u002For PR (`[#17](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fpull\u002F17)`). Issue refs link too (`[#16](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fissues\u002F16)`).\n- **An auto-generated `## What's Changed` section at the BOTTOM (MANDATORY) — this is what makes \"lists every change\" literally true.** GitHub's PR-level breakdown (every merged PR + author + New Contributors) plus the `**Full Changelog**: \u003CPREV>...v\u003Cver>` compare link, from `gh api …\u002Freleases\u002Fgenerate-notes` (command below). Append it verbatim under a `---` separator below the curated narrative — the curated themes stay on top, the exhaustive PR list goes underneath.\n- **Tone: factual + neutral.** Readability ≠ hype. Each line states what changed. No superlatives, no competitive framing, no editorializing. (Same bar as commit messages — AGENTS.md.) Visual interest comes from structure (sections, tables, callouts), never from marketing language.\n\n**Template** (adapt the section names to the actual changeset):\n\n```markdown\n\u003COne-line intro: what this release is about.>\n\n> [!IMPORTANT]\n> **\u003CHeads-up title>.** \u003CThe one thing to know before upgrading. Omit the callout if there's nothing.>\n\n## \u003CTheme A, e.g. Lockfile compatibility>\n\n\u003COptional one-line lead.>\n\n| Area | What changed | Commit |\n| --- | --- | --- |\n| \u003Carea> | \u003Cwhat changed, one clause> | [`\u003Csha7>`](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fcommit\u002F\u003Cfull-sha>) |\n\n## \u003CTheme B, e.g. Performance>\n\n\u003CShort blurb with the PR link inline.> ([#17](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fpull\u002F17))\n\n## Testing & internals\n\n- \u003CBullet> ([`\u003Csha7>`](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fcommit\u002F\u003Cfull-sha>)).\n\n---\n\n## What's Changed\n\n\u003C!-- appended verbatim from `gh api …\u002Freleases\u002Fgenerate-notes` — the PR list, New Contributors, and Full Changelog link -->\n* \u003CPR title> by @\u003Cauthor> in https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fpull\u002F\u003Cn>\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fcompare\u002F\u003CPREV>...v\u003Cver>\n```\n\nGenerate the bottom `## What's Changed` breakdown mechanically so every merged PR is listed (the tag does not exist yet, so name the commit):\n\n```bash\n# PR-level list + New Contributors + Full Changelog compare link — append verbatim below the curated narrative\ngh api repos\u002Fnubjs\u002Fnub\u002Freleases\u002Fgenerate-notes \\\n  -f tag_name=v\u003Cver> -f target_commitish=main -f previous_tag_name=$PREV --jq '.body'\n```\n\nAppend that block under a `---` separator below the curated sections, save `notes.md`, and dispatch with it. The curated narrative stays on top; this exhaustive PR list goes underneath.\n\nTo correct the notes after the dispatch, edit the release in place, draft or published (a re-run of `stable-immutable-release` rewrites a draft's body from the run's own `notes` input, so edit again after one):\n\n```bash\ngh release edit v\u003Cver> --notes-file notes.md\ngh release view v\u003Cver> --repo nubjs\u002Fnub --json body -q .body   # verify it rendered\n```\n\nThe v0.1.4 and v0.1.3 release bodies are the reference exemplars of this structure.\n\n## Step 4b — Publish the notes as a blog post (MANDATORY — every release)\n\nEvery release also ships as a blog post under `site\u002Fcontent\u002Fblog\u002F`. This is a standard release step, done on every version — the same content\u002Fpresentation-to-`main` exception as docs (commit directly to `main`, no PR). Before writing, invoke the `prose-writing` skill and follow its guide (blog copy: routine patch notes stay factual, neutral, unsigned, scannable — no hype, no personality; a milestone version gets a fuller treatment but the same neutral bar).\n\n- **File:** `site\u002Fcontent\u002Fblog\u002Fnub-\u003Cmajor>-\u003Cminor>-\u003Cpatch>.mdx` (e.g. `nub-0-2-10.mdx`) — the filename is the URL slug; fumadocs auto-globs `content\u002Fblog\u002F*.mdx`, so no index\u002Fmeta wiring is needed.\n- **Frontmatter** (schema from `source.config.ts`, all four required): `title: \"Nub \u003Cver>\"` (add a `: \u003Ctheme>` subtitle only for a milestone), `description:` a plain sentence with **no inline code\u002Fbackticks** (the field renders raw), `author: The Nub Team`, `date: \u003CYYYY-MM-DD>` **back-dated to the release's `publishedAt`** so the timeline stays chronological.\n- **Body:** a short lede, then the release's themed sections adapted to blog prose — not a raw changelog dump. Carry over the callouts and per-theme tables. Close with `The [full release notes](https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Freleases\u002Ftag\u002Fv\u003Cver>) list every change in this release.`\n- **Structure a feature-carrying release around its features:** one top-level `##` per major new feature, then `## Breaking changes`, then `## Bug fixes`. A batch of independent fixes goes in a table whose FIRST column is the PR link — `.blog-prose td:not(:last-child)` is `width:1%` + `nowrap` by design, so a prose column anywhere but last blows the table past the 720px article column.\n- **End every post with the get-started block** — a final `## Get started` heading followed by `\u003CGetStarted \u002F>`, which renders the install tabs plus the pointer at the agent adoption prompt. Every existing post carries it; a new one without it is the odd one out.\n- **Catch up a cold reader with `\u003CNubIntro \u002F>`** near the top when the post leads with feature news rather than an introduction. Both components live in `site\u002Fsrc\u002Fcomponents\u002F` and are registered globally in `site\u002Fmdx-components.tsx`; their copy is maintainer-authored, so edit the component, never a single `.mdx`.\n- **Scale to the release:** a small patch gets a short post; a milestone opens with the thing working.\n- **Nothing held back appears in the post** — the holds in `internal\u002Frelease-holds.md` (Step 4) apply here too.\n\nExemplars: `site\u002Fcontent\u002Fblog\u002Fnub-0-7-0.mdx` (feature-carrying, full structure), `nub-0-2-0.mdx` (milestone), `nub-0-2-5.mdx` (small patch).\n\n## Step 5 — Close the loop on issues + PRs (MANDATORY — always, no matter what)\n\nComment a brief factual note carrying **the version and a link to the release** on **EVERY closed issue and EVERY merged PR that shipped in this release** — not just the headline fixes. This is mandatory maintainer hygiene (AGENTS.md \"Git & GitHub maintainer hygiene\"); do it on every release without exception. Users see \"fixed\" the moment an issue closes, but the fix is not on the released binary until the release publishes — this comment closes that credibility gap and gives the reporter a link to the exact release.\n\nThe release URL is `https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Freleases\u002Ftag\u002Fv\u003Cver>`. Every comment includes both the version and that link, e.g. `Shipped in v\u003Cver>: \u003Crelease URL>`.\n\n**Enumerate the targets MECHANICALLY — never a hand-typed list.** A hand-enumerated pass silently misses any issue still open at cut time or closed AFTER the cut (this happened on v0.3.0). Drive the set from the union of three queries:\n\n```bash\n# 1. Every issue a shipped PR auto-closes (closingIssuesReferences) + any Closes\u002FFixes\u002FResolves #N in a PR body:\ngh pr list --repo nubjs\u002Fnub --state merged --search \"merged:\u003CPREV-date>..\u003Ccut-date>\" \\\n  --json number,body,closingIssuesReferences --limit 200 \\\n  --jq '.[] | {pr:.number, closes:[.closingIssuesReferences[].number], refs:([.body|scan(\"(?i)(?:clos|fix|resolv)\\\\w*\\\\s+#(\\\\d+)\")]|flatten)}'\n# 2. Every issue closed in the release window (catches issues closed without a linked PR):\ngh issue list --repo nubjs\u002Fnub --state closed --search \"closed:\u003CPREV-date>..\u003Ccut-date+1>\" \\\n  --json number,title,stateReason --limit 200\n```\n\nFor each issue\u002FPR in the union, check whether it ALREADY carries the comment before posting (`gh issue view \u003Cn> --repo nubjs\u002Fnub --json comments --jq '[.comments[].body|select(test(\"Shipped in v\u003Cver>\"))]|length'`) — skip a `NOT_PLANNED` issue with no shipped fix. **Re-run this pass for any issue closed AFTER the cut** — a late-closing issue does not appear in the first sweep.\n\nThen comment (extremely concise — the version and release link, no recap of what was done or how; add a brief thanks when the reporter or PR author is external):\n\n```bash\nREL=\"https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Freleases\u002Ftag\u002Fv\u003Cver>\"\ngh issue comment \u003Cn> --body \"Fixed in v\u003Cver> (now published): $REL\"\ngh pr comment \u003Cn>    --body \"Shipped in v\u003Cver>: $REL — thanks for the contribution.\"\n```\n\nHit **every** issue and PR the mechanical union above surfaces — not just the headline fixes. This is non-optional; do not skip an issue because it was \"minor,\" and do not fall back to the release thread's targeted-fix list as the source of truth (it under-counts). Do not comment on issues unrelated to the release.\n\n## Step 6 — Post-release verify\n\nConfirm the automated publish actually landed:\n\n```bash\ngh api repos\u002Fnubjs\u002Fnub\u002Freleases\u002Flatest --jq .tag_name   # MUST print v\u003Cver> — this endpoint IS the\n                                             # upgrade channel (nub upgrade + both installers);\n                                             # anything else means users are served an old release\nnpm view @nubjs\u002Fnub@\u003Cver> version            # the root package is on the registry\nnpm view @nubjs\u002Fnub@\u003Cver> dist.tarball        # sanity: published artifact exists\ngh release view v\u003Cver> --json assets --jq '.assets[].name' | sort\n# expect these exact 33 assets:\n# nub-darwin-arm64.tar.gz\n# nub-darwin-arm64.tar.gz.sha256\n# nub-darwin-x64.tar.gz\n# nub-darwin-x64.tar.gz.sha256\n# nub-linux-arm64.tar.gz\n# nub-linux-arm64.tar.gz.sha256\n# nub-linux-arm64-musl.tar.gz\n# nub-linux-arm64-musl.tar.gz.sha256\n# nub-linux-x64.tar.gz\n# nub-linux-x64.tar.gz.sha256\n# nub-linux-x64-musl.tar.gz\n# nub-linux-x64-musl.tar.gz.sha256\n# nub-win32-arm64.zip\n# nub-win32-arm64.zip.sha256\n# nub-win32-x64.zip\n# nub-win32-x64.zip.sha256\n# nub-launcher-darwin-arm64\n# nub-launcher-darwin-arm64.sha256\n# nub-launcher-darwin-x64\n# nub-launcher-darwin-x64.sha256\n# nub-launcher-linux-arm64\n# nub-launcher-linux-arm64.sha256\n# nub-launcher-linux-arm64-musl\n# nub-launcher-linux-arm64-musl.sha256\n# nub-launcher-linux-x64\n# nub-launcher-linux-x64.sha256\n# nub-launcher-linux-x64-musl\n# nub-launcher-linux-x64-musl.sha256\n# nub-launcher-win32-arm64.exe\n# nub-launcher-win32-arm64.exe.sha256\n# nub-launcher-win32-x64.exe\n# nub-launcher-win32-x64.exe.sha256\n# packslip.sigstore.json\n```\n\nA complete release has: the 10 npm packages published (`@nubjs\u002Fnub`, `@nubjs\u002Fnub-\u003Cplatform>` ×8, `@nubjs\u002Ftypes`), the stable GitHub Release present and marked **Latest**, and all 33 assets attached. CI's `stable-immutable-release` job asserts the 32 build assets and `packslip` adds the 33rd before npm can stage, `github-release` promotes that same release after npm succeeds, and `test-install` smokes the published package. This step confirms that the workflow reached green.\n\nThe 8 `nub-launcher-*` assets are what `nub compile --platform \u003Cforeign>` fetches to cross-compile, so a release missing one silently disables cross-compiling to that platform for everyone on that version.\n\n**If CI failed partway:** Re-run the failed job from the Actions UI. The `stable-immutable-release` job rebuilds the deterministic archives and re-uploads missing assets before npm starts; `packslip` keeps an existing signed manifest and signs one only when absent; `publish-npm` skips packages already published or already staged during a partial attempt; a run whose approval hold expired (30 days) is abandoned for the next version (Step 3); `github-release` only promotes the asset-complete prerelease. Do not re-cut a version for a failed upload or partial npm publish.\n\nThen confirm the Homebrew channel actually moved — the tap lives in another repo, so a green release run here is not evidence that it did:\n\n```bash\ngh api repos\u002Fnubjs\u002Fhomebrew-tap\u002Fcontents\u002FFormula\u002Fnub.rb --jq '.content' | base64 -d | grep -E 'version|bin\\.install'\n# expect version \"\u003Cver>\" and the bin.install lines matching the current archive layout\n\nbrew update && brew install nubjs\u002Ftap\u002Fnub && nub --version && nubx --help | head -1\n# or, without touching your own machine:\ndocker run --rm homebrew\u002Fbrew brew install nubjs\u002Ftap\u002Fnub\n```\n\nA complete release has the 10 npm packages published (`@nubjs\u002Fnub`, `@nubjs\u002Fnub-\u003Cplatform>` ×8, `@nubjs\u002Ftypes`), the GitHub Release present and marked **Latest**, all 33 assets attached, and the tap formula bumped to `\u003Cver>` and installable.\n\n**If CI failed partway:** `publish-npm` and `github-release` are split + idempotent on purpose — re-run the failed job from the Actions UI (npm publish skips already-published packages; the release job re-uploads only missing assets). Never re-cut a version for a flaky asset upload. `bump-homebrew-tap` is re-runnable too, and failing it is the safe outcome: the tap keeps serving the previous version rather than a broken formula, so fix the generator on `main` and re-run the job — never hand-edit the tap as the fix, since the next release regenerates it.\n\n---\n\n## Quick reference\n\n| Step | Command |\n| --- | --- |\n| Changeset | `git log $(git describe --tags --abbrev=0)..HEAD --oneline` |\n| Types | Invoke `type-declarations`; reconcile every runtime API in the changeset before versioning |\n| Bump | `make version V=\u003Cver>` → `make version-check` |\n| Notes | write `notes.md` (curated sections + generated `## What's Changed`) BEFORE the dispatch |\n| Cut | `git commit -m \"v\u003Cver>\" -- \u003Cversion files>` → `git push origin main` (never `--tags`) → `gh workflow run release.yml -R nubjs\u002Fnub -f publish=true -f notes=\"$(cat notes.md)\"` |\n| Approve | the maintainer runs `stager` (`a`, Enter, sign in, one code) → the agent parks on `stager await '@nubjs\u002F*@\u003Cver>'` |\n| Blog | `site\u002Fcontent\u002Fblog\u002Fnub-\u003Cx>-\u003Cy>-\u003Cz>.mdx` — back-dated to `publishedAt` (direct to `main`) |\n| Tap | automatic via `bump-homebrew-tap`; verify with `gh api repos\u002Fnubjs\u002Fhomebrew-tap\u002Fcontents\u002FFormula\u002Fnub.rb --jq .content \\| base64 -d \\| head -5` |\n| Loop | `gh issue comment \u003Cn> --body \"Fixed in v\u003Cver>: \u003Crelease URL>\"` (every closed issue + merged PR) |\n| Verify | `gh api repos\u002Fnubjs\u002Fnub\u002Freleases\u002Flatest --jq .tag_name` (= `v\u003Cver>`) · `npm view @nubjs\u002Fnub@\u003Cver> version` · `gh release view v\u003Cver> --json assets` |\n\nInvoked via the Skill tool once a release thread's targeted fixes are all landed on `main` and CI-green.\n",{"name":5,"metadata":24,"description":7},{"internal":25},true,"main","9b734566fd36ceed8379f67a92291bc68af60801",".claude\u002Fskills\u002Frelease",71,"https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub","https:\u002F\u002Fnubjs.com","https:\u002F\u002Fgithub.com\u002Fnubjs","The all-in-one Node.js toolkit","2026-11-14 14:11:35",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":25},[37,40,43],{"tool":38,"command":39},"npx","npx skills add nubjs\u002Fnub --skill release",{"tool":41,"command":42},"bunx","bunx skills add nubjs\u002Fnub --skill release",{"tool":44,"command":45},"pnpm","pnpm dlx skills add nubjs\u002Fnub --skill release","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Frelease\u002FSKILL.md",[],[49,55,61,68,75,82],{"skillNo":50,"name":51,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M758BSH88RVXBG8TPCT427TY","nub","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002Fskills\u002Fnub\u002FSKILL.md",[],[],{"skillNo":56,"name":51,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M758BKPRHXS5MS27WG908PBG","This project uses nub, a single Rust CLI that runs on the project's installed Node and replaces the everyday Node toolchain. ALWAYS prefer nub over node, bun, npm, npx, pnpm, and yarn for: executing JS\u002FTS files, running package.json scripts, the npx-equivalent, installing dependencies, watch mode, and Node version management. Surfaces whenever you would otherwise reach for node\u002Fbun\u002Fnpm\u002Fnpx or a package manager.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002Fsite\u002Fpublic\u002Fskill.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M758BCR8A21H8P4TQ0YRHTC7","worktree","Create and manage isolated git worktrees for parallel build\u002Ftest\u002Flanding work on the nub repo. Invoke (via the Skill tool) whenever you need a fresh worktree to land a change, when you want to know what `.worktreeinclude` does or how to add an entry, or when cleaning up after a merge. Encodes the one-command setup (`nub scripts\u002Fnew-worktree.ts \u003Cslug>` or `node …`) that bakes in the proven recipe — worktree off origin\u002Fmain (vendor\u002Faube is plain in-tree files now, no submodule init), the shared CARGO_TARGET_DIR (`~\u002F.cache\u002Fnub\u002Fshared-target`) that all worktrees reuse, and applying `.worktreeinclude` — plus the eagerly-pull-the-shared-tree discipline and the safe cleanup path. Pairs with the `dev-loop` build skill.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fworktree\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M758B9NZ1GQMD1A6B25NK0D9","windows-vm-test","Run ad-hoc Nub tests and debugging probes in the maintainer's existing local Windows 11 ARM64 QEMU\u002FHVF VM when its external disk and runbook are present. Use for interactive win32-arm64 or Windows-on-ARM x64-emulation checks; use ci-adhoc-test for true x64-native behavior or when the local VM is unavailable.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwindows-vm-test\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M758B2JHMBB6YJTGYSJR65S4","visual-review","Verify UI\u002Flayout\u002Fstyling changes are correct by computing occlusion, clipping, and alignment from the browser's resolved paint order via the chrome-devtools MCP `evaluate_script` tool — instead of eyeballing a flat screenshot. Invoke BEFORE declaring any UI, site, or styling\u002Flayout change correct. Screenshots have no depth buffer, so z-index\u002Focclusion\u002Fclip bugs are exactly where \"just look at it\" fails; the `evaluate_script` routines below turn those fuzzy visual judgments into deterministic measurements — including optical center-of-mass, which measures the glyph ink's true visual center so differently-sized labels can be aligned by more than eye.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fvisual-review\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M758AWPM7CE440NBAYJHD44J","type-declarations","Add, audit, or update @nubjs\u002Ftypes declarations for Nub runtime APIs. Use whenever Nub adds or changes a user-visible global, built-in method, module loader type, or TC39 proposal; when TypeScript or @types\u002Fnode gains an overlapping declaration; and before every release to reconcile runtime changes since the previous tag. Covers conflict-safe global augmentation, compiler-version routing, fixture matrices, and package verification.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftype-declarations\u002FSKILL.md",[],[]]