Skip to content

ci: check the CLI against the live API in workflows the dashboard can show - #86

Merged
achoimet merged 1 commit into
mainfrom
ci/spec-check-workflows
Oct 1, 2026
Merged

achoimet merged 1 commit into
mainfrom
ci/spec-check-workflows

Conversation

@achoimet

@achoimet achoimet commented Oct 1, 2026

Copy link
Copy Markdown
Member

The development dashboard shows a workflow's pass or fail, and its Additional checks column already has preflight-kit's Check Open API Spec (platform vs preflight-kit / PROD) and (… / DEV). The coverage check from #85 couldn't appear there: it was a step inside ci.yml that only warned.

New workflows, named the same way as preflight-kit's, so they read the same on the dashboard:

  • spec-diff-platform-prod.yml: Check Open API Spec (platform vs cli / PROD), against platform.steadybit.com.
  • spec-diff-platform-dev.yml: Check Open API Spec (platform vs cli / DEV), against platform.dev.steadybit.com.

Both run every weekday at 07:00 UTC, like preflight-kit's, as well as on pushes to main, by hand, and on PRs that change the check. Both call spec-check.yml, which:

  1. fetches that platform's spec and regenerates the client;
  2. fails if the CLI no longer builds against it;
  3. fails if an operation is neither called by a command nor listed in internal/tools/spec/coverage.go, and lists those operations in the job summary.

Only the PROD workflow keeps the "Platform API operations no CLI command covers" issue open while anything is uncovered, and closes it afterwards. The two don't share an issue, so they can't overwrite each other.

ci.yml: the coverage step moves out, and the job loses issues: write. Its nightly build against the live API stays, because it's what blocks a release on a breaking change.

A separate PR on development-dashboard adds the two workflows to the cli row.

… show

The development dashboard shows workflow results, and the coverage check was a
step of ci.yml that only warned. Two workflows, named like preflight-kit's,
now fetch the production and the dev spec every weekday morning, build the
CLI against them, and fail when an operation is neither called by a command
nor listed with a reason. The production one keeps the coverage issue open
while anything is uncovered. ci.yml keeps its build against the live API,
which blocks a release.
@achoimet
achoimet merged commit 16900b8 into main Oct 1, 2026
14 checks passed
@achoimet
achoimet deleted the ci/spec-check-workflows branch October 1, 2026 08:41
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 1, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant