docs: sync beta to v3.0.0-beta.9 and document project runtime refresh

[mrgoonie]

Summary

• Syncs the Beta channel to AgentKit v3.0.0-beta.9 (source commit 638464def28ec495f89d56e133a4dd70de4a6a9c, docs bundle generated 2026-10-08T12:53:35Z) using scripts/sync-release.mjs. This release attaches the upstream docs-bundle.tar.gz, so the sync uses that asset after verifying it against its .sha256 sidecar and the release-page digest; no local bundle construction was needed. The sync updates the raw and derived ak update reference, the Beta release notes and channels.json.beta, and adds desktop Layer A evidence (release-evidence/desktop/v3.0.0-beta.9.json). No desktop pages changed.
• Includes the docs(update): project ak update refreshes every installed runtime #249 docs from draft PR docs(update): document project ak update refreshing every installed runtime #250 (project ak update refreshes every installed runtime: guide + human-owned reference/cli/update EN/VI). Source commit 766318dce is contained in v3.0.0-beta.9, and apps/cli/internal/commands/updatecmd is byte-identical between that commit and the tag. The prose was re-checked against the synced reference-raw/ak_update.mdx help: the --target/--runtime semantics, the rule for which runtime supplies the tracked kits/ tree, background-update scope, and exit codes 1/2 all match. Reason codes were checked against project_runtime_refresh.go and resolveRuntimeSpec. No mismatch, so no edits were needed.
• Rebinds the Beta Kit catalog guard from v3.0.0-beta.8 to v3.0.0-beta.9. It covers engineer and marketing evidence for all 8 runtimes in the release contract (claude-code, cloud-harness, codex, cursor, dsh, grok, omp, pi): manifests, sidecars and claude-code skill members, plus the runtime contract at the source commit. Identity sets are unchanged: engineer 103, marketing 83, and no Skills were added or removed. Stable is untouched.
• Public Skill disposition: across all 16 archives, the only content change from beta.8 is the ak-ak SKILL.md body. The new text says background project updates reconcile only kits/, while an attended ak update <dir> --yes refreshes every installed runtime. This is classified as update: one sentence was added to kits/{engineer,marketing}/skills/ak EN/VI. Every other Skill is unchanged (byte-identical apart from version and commit stamps).

Closes #249

Evidence (verified hashes)

All 48 expected Kit assets (2 Kits × 8 runtimes × manifest/archive/sidecar) are present, with no extras. Each archive SHA-256 was verified four ways: against the downloaded bytes, manifest.artifact.sha256, the sidecar (<sha> kit.tar.gz), and the release-page digest. Each manifest's channel, version, runtime, Kit, sourceCommit and createdAt (= syncedAt) were checked, along with its githubAssets.

Runtime	engineer archive SHA-256	marketing archive SHA-256
claude-code	efdece969beb5f78155294d3c6a2641ecb6aa0279799ec248ffc38e24dc0efe3	e6cd68204ee19cf1ad02891720c871e4d3c104ea2611b0341ff6c5057f4c9836
cloud-harness	0f9031183b8794c17e52ad4ab4444451bd90a94d05ba6658ac15daee7445ffc8	a6a00c4d0c34a516f09d62cc7cd27ab8210246c983d712006e7eccec85e7c70a
codex	9780061ad1d76ae7ce80a1c2984e7181b4c105837f517d0e90b2ca20153f0602	ca9aa9b7fe074656e6a6a0130bc58abcf3cb38f60fe869f2085fabcad49c9548
cursor	ab5de2109a0f1b771b7260b8c2e600c0ad772551754c0b4e6c5562025c8e31f7	49128bfd0281a9769af8f3e305ccf1a82f18c9bcafee57a331450fc4c1753558
dsh	6e35dda0fda793f4c9509e3b517e2a9cc381e31889bd315f6d5df99b9cebe639	cf8ff430f59c4440502af2799ed770002d42093499130a2f19dc7b035a830bdd
grok	4f0e4878c41b89b421e18a9b8472bfef028daa0a79db7d83ad818d43bfa39f2d	230071da378c995a06af7866ec756385c926ab6620958ab3f0e3ef36d5d394fe
omp	3b61c87703ae80077c21657acfe5479b6c05db93ef97f841f78ead8d87795720	9d5e4c9cc522ae8f82dc8fecc69fef1b82d9ec759ff2af37852cd0874d30b432
pi	385d7a226bca4821d739fa2b17edbda84e56919d539f7e96d37cc5457e7be8e4	59fd6003e2011a5df62e234e60f90880db9b90a044163ae8bc6fdc82d568a2dc

• Snapshot digests: engineer 19ce73b137a123add4b5e5da64041c4c3878948959fc4100fc6e236518fee966, marketing 5579e1fd34bb4954d611b43e13696536d284bdfd370e8f68d6de636aee32709f.
• Runtime contract 638464def…json is byte-identical to the beta.8 contract.
• Docs bundle: de99abf67ce2190d87504c46e8e0224af8cf058c870de36b613bd8155207469f (sidecar and release digest match).
• Desktop: the 4 ak-gui_3.0.0-beta.9_* assets were verified against their .sha256 sidecars and the release digests.
• Source compare window v3.0.0-beta.8...v3.0.0-beta.9 has 5 commits:
  • #2188: covered by this PR.
  • #2184 (native Skill snapshot verification before --force cleanup): no prose impact; the docs make no claim about that cleanup.
  • #2181 (--registry-url kept across the self-update continuation): no prose impact; it fixes a bug against existing documented behavior.
  • #2185 (installer pins) and #2180 (CI): no docs surface.

Validation

• pnpm check:catalog: OK (beta/engineer total=103, beta/marketing total=83, artifacts=8)
• pnpm lint, pnpm typecheck, pnpm check:reference, pnpm check:prose: OK
• node scripts/check-kit-docs-ci.mjs origin/dev: OK (history route, no Stable diff)
• node scripts/generate-reference.mjs: no further diff
• pnpm build, pnpm check:links, pnpm check:seo: OK
• check:quality:shape: route parity OK, and route counts are unchanged, so no baseline update was needed. check:quality:metrics, check:assets and pnpm test have known Windows path failures that also occur on an untouched dev, so this PR relies on Linux CI for them.

Docs impact

Yes:

• The Beta CLI reference and release notes are synced to v3.0.0-beta.9.
• The project runtime refresh docs (EN/VI guide and CLI reference) are added.
• The ak Skill guidance is updated in both Kits.
• The Beta catalog guard is rebound.

Evidence layer: shipped release assets for v3.0.0-beta.9 (verified hashes). Stable content is not edited.

Website impact

None for agentkit.best.

Follow-ups / mismatch disposition

• The human-owned CLI prose overlay drift since v2.20.0-beta.1 (carried over from docs: sync beta to v3.0.0-beta.8 and add ak:filmmaking guide #244) still needs a separate owner-approved release audit. check:prose passes on the current overlays.
• Body drift in existing marketing and engineer Skill pages before v3.0.0-beta.8 was not audited here. Only the beta.8→beta.9 delta (ak-ak) is classified.

🤖 Generated with Claude Code