Skip to content

Move CLI docs release automation into docs - #1744

Open
llewellyn-sl wants to merge 2 commits into
masterfrom
llewellyn-cli-docs-automation
Open

Move CLI docs release automation into docs#1744
llewellyn-sl wants to merge 2 commits into
masterfrom
llewellyn-cli-docs-automation

Conversation

@llewellyn-sl

@llewellyn-sl llewellyn-sl commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

What changed

  • replace the failed tower-cli source/Gradle extraction path with a docs-owned extractor compiled against the published tw-jar.jar
  • verify the release checksum and stable-release status before generation
  • compare current and previous resolved picocli command models
  • recursively regenerate reference pages, preserve exact-path overlays, and reject orphaned overlays
  • keep raw metadata as a short-lived Actions artifact instead of committing it
  • add stable-only draft PR creation, manual dry runs, and a scheduled recovery check
  • add the CLI release review skill and the platform-cli-docs ownership/runbook README
  • include Platform CLI pages in Netlify deploy previews

Why

The previous workflow called a Gradle metadata task that does not exist on tower-cli master, so every scheduled update failed. Keeping extraction and generated metadata in tower-cli was also rejected as repository bloat. This makes the released CLI JAR the contract and leaves tower-cli responsible only for sending a small release notification.

Impact

After this merges, stable tower-cli releases can produce deterministic draft documentation PRs without checking out tower-cli source or using GitHub Packages. Conceptual inference and examples remain an explicit review step guided by the new skill.

This PR intentionally excludes the generated current-release parity snapshot. That output is in the stacked docs #1745, produced by running this implementation locally against v0.38.0.

Validation

  • live checksum verification and extraction from tower-cli v0.38.0
  • like-for-like comparison with v0.37.0
  • six Python tests
  • actionlint on both workflows
  • skill validator
  • Platform CLI + Platform Cloud + changelog Docusaurus production build
  • repository pre-commit hooks

@netlify

netlify Bot commented Aug 14, 2026

Copy link
Copy Markdown

Deploy Preview for seqera-docs ready!

Name Link
🔨 Latest commit 9343885
🔍 Latest deploy log https://app.netlify.com/projects/seqera-docs/deploys/6a82413fee37ee218a90c57d
😎 Deploy Preview https://deploy-preview-1744--seqera-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

2 participants