20260909-2355-manual-pages-deploy Add a manually triggered Cloudflare Workers deployment workflow

• status: completed
• priority: P2
• owner: claude/session-pages
• createdAt: 2026-09-09 23:55

Description

Publish the VitePress docs site to Cloudflare Workers static assets through a GitHub Actions workflow that only runs on manual dispatch (no push trigger).

Acceptance criteria:

• wrangler.jsonc serves .vitepress/dist as assets-only (no Worker script).
• .github/workflows/deploy.yml builds with Bun and deploys with cloudflare/wrangler-action, triggered by workflow_dispatch only.
• The build uses full git history so VitePress lastUpdated timestamps are correct.
• A dispatched run completes and the site is reachable.

ActiveForm

Adding a manually triggered Cloudflare Workers deployment workflow.

Dependencies

• blocked by: CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID repository secrets must exist
• blocks: (none)

Notes

• 2026-09-10: retargeted from GitHub Pages to Cloudflare Workers. GitHub Pages was blocked anyway — ybolab/docs is private under a free organisation plan, where Pages is unavailable. Cloudflare Pages is deliberately not used; Cloudflare now steers new static sites to Workers static assets.

• Deploying at a domain root keeps VitePress base at /, so no site-config change is needed.

• 2026-09-10: first dispatched run (34424156608) built successfully and failed at deploy with Cloudflare API error 10000 (authentication). The token resolves to the right account but lacks Account -> Workers Scripts -> Edit; it must be reissued before the deploy step can pass.

• complete: Deployed via run 34424708536 to https://ybo-docs.cfaa.workers.dev