docs(release): restore alpha publishing and docs deployment [Codex]

[jderochervlk]

Context

The CI workflow combined validation, packaging, and npm publishing, so every push to main created an alpha release. That made releases harder to control and kept publishing concerns coupled to the normal build.

Changes

• keep validation and documentation generation in CI with Node.js 24
• move alpha versioning, package creation, and npm publication into a dedicated release workflow
• run the release workflow for pull requests to main with npm publish --dry-run
• make manual release runs default to dry_run: true; publishing requires explicitly setting it to false
• publish commit-specific prereleases to the alpha dist-tag through npm trusted publishing
• scope GitHub Pages write permissions to the documentation deployment job
• update README and documentation version metadata to use the alpha channel

[brnrdog]

@jderochervlk Can we actually decouple the release and publish steps from the build, and have them as a manually triggered workflow instead of on every push on main? From my personal experience, it saves a bit of headache some times.

[jderochervlk]

@jderochervlk Can we actually decouple the release and publish steps from the build, and have them as a manually triggered workflow instead of on every push on main? From my personal experience, it saves a bit of headache some times.

Sure, that makes sense.

[jderochervlk]

@codex

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-13T14:30:00.811597Z	fc814bf	New commits

ℹ️ About Codex in GitHub

Your team has set up Codex to 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2535ba61d0

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".