ci(cli): publish ts docs reference (CLI-2171)

[7ttp]

TL;DR

fixes the CLI docs reference being frozen at v2.98.2
which was caused by the monorepo merge deleting the Go bumpdoc docs job from the release workflow,
and is now fixed by a stable-only docs job that regenerates the spec from the TS command tree and delivers it to supabase/supabase the same way bumpdoc did...

whats introduced?

• a docs job in release.yml: stable releases only, runs after publish, non-blocking for the release, and mints the same scoped App token...
• scripts/publish-docs-spec.ts: reads the generated spec on stdin, validates it
  (clispec 001, version match, command count) before any network action, formats it with a pinned prettier to match the published file's style, then updates the cli/ref-doc branch in supabase/supabase and opens a PR when none is open..
• bumpdoc's append semantics: when cli/ref-doc already exists the new spec lands as a commit on top, so fixes pushed onto an open bot PR survive later releases
• 6 integration tests for the publisher's refusal and dry-run paths, plus a README release section describing the automated flow

how?

stable release now runs generate-docs-spec.ts "$VERSION" | publish-docs-spec.ts --version "$VERSION"
which lands a validated, formatted spec as a commit on cli/ref-doc and opens the
familiar chore: update cli reference doc PR for the docs team to merge

• (same shape as chore: update cli reference doc supabase#45622)
  a stable dry run exercises the same pipe with --dry-run, which also verifies the App token mint without pushing anything up..

Note

will follow up on supabase/supabase with a spec-to-sidebar coverage guard,
so a new command missing a common-cli-sections.json entry fails the bot PR instead of silently publishing no page...

ref:

• follow up to: chore(cli): generate docs spec from TS (CLI-2171) #6157

[github-actions]

Supabase CLI preview

npx --yes https://pkg.pr.new/supabase/cli/supabase@afa50414ccde59ef506f08155421a4d306ecf651

Preview package for commit afa5041.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:573b364862

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".