Skip to content

release: promote beta docs cycle to production - #65

Merged
thieung merged 3 commits into
mainfrom
dev
Aug 13, 2026
Merged

release: promote beta docs cycle to production#65
thieung merged 3 commits into
mainfrom
dev

Conversation

@thieung

@thieung thieung commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Beta release update: ak orchestrate CLI reference (start/status/resume/stop) + config prefs set/unset refresh, EN + VI
  • Align release channel contract across channels.json, channel selector, beta banner, and docs layout
  • Add Grok Claude-compat Hook troubleshooting page to both beta and stable troubleshooting sections (EN + VI)
  • Refresh desktop-app pages via beta sync automation; update release notes and reference-raw / reference-derived output
  • Update release quality metrics/shape scripts, channel route href helper, and their tests

Test plan

  • pnpm build (static export) succeeds
  • pnpm test — channel route href, CLI reference routes, release quality suites pass
  • Spot-check /beta/reference/cli/orchestrate and troubleshooting Grok hooks pages in EN and VI
  • Verify channel selector + beta banner behavior on both channels

* docs: beta v2.13.0-beta.2 release update

Syncs beta channel to v2.13.0-beta.2 via sync-release.mjs (171 reference
files, ak-gui asset metadata refreshed for 4 platforms). Adds the new
ak orchestrate command group (start / resume / status / stop) as EN+VI
prose, mirrored into content/docs/stable/** for whole-copy parity.
Updates ak config prefs set/unset and index prose to cover the new
worktree.root leaf. Adds ak orchestrate to the root CLI outcome table.
Bumps release-quality-shape baseline to 398 source / 397 built routes.

* docs: bump search-index baseline for orchestrate group

* docs: keep orchestrate group off stable channel until promote

The prior commit mirrored the new ak orchestrate CLI group + config prefs
worktree.root prose into content/docs/stable/reference/cli/** to satisfy
cli-reference-routes.test.mjs's strict beta==stable route parity. That
would publish /en/stable/reference/cli/orchestrate/** on merge even
though channels.stable.tag is still v2.12.0, where the ak orchestrate
command does not exist upstream — misleading anyone reading the stable
docs.

Fix by relaxing the invariant to beta ⊇ stable (whole-copy promote stays
safe as long as every stable route also exists in beta; beta may include
routes authored ahead of the next promote) and removing the mirrored
orchestrate group + prose deltas from content/docs/stable/. The next
stable promote picks these up as part of its normal whole-copy step.

- cli-reference-routes.test.mjs: expected counts are per-channel; assert
  EN/VI parity within each channel and stable ⊆ beta across channels.
- release-quality-shape.mjs: per-channel source/route baselines; new
  addMissingSubset() replaces the strict equality cross-channel check.
- release-quality-metrics.mjs: per-channel searchPagesPerLocaleChannel.
- release-quality.test.mjs: fixtures updated to the object shape.

* fix: allow beta-only search routes

* fix: avoid unavailable channel links
* docs(troubleshooting): add Grok Claude-compat Hook workaround

Document how to disable Claude hook scanning and use ~/.grok/hooks until AgentKit folds global settings commands. Do not recommend editing AgentKit-managed settings.json.

* docs: bump release-quality baselines for grok-hooks page

The new troubleshooting route is published on beta and stable, EN+VI.
Bump reviewed source/built/search counts by one per channel so
check:quality:shape matches the authored tree.
@thieung
thieung merged commit 288802c into main Aug 13, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant