Repository navigation
Description
Agents: read the guide for agents in #310 first (order, difficulty, how to claim an issue, working method). The specification is in this description and in the comments below.
Goal
Give this package the release and CI infrastructure of the other packages of the organization, so that releases (0.6.0-beta in ct-registry, see #283, then stable versions) follow recipes/release.md of ct-agents and rules REL1–REL7 of ct-conventions.
Part of #310, step 0. Depends on #313: theme 1 (AGENTS.md, pinned conventions) and theme 2 (the labels used below must exist).
Why the CI workflows change too
In the other packages, PR jobs run only when a label is set (run ci github-runner, run documentation, run breakage); on main and on tags they always run. Here, CI.yml and Documentation.yml run on every PR without labels. The release gate (ReleaseGate.yml) requires every label-gated job to have run, so the gate only works once CI and documentation are label-gated. See CTActions docs/conventions/labels.md and docs/workflows/release-gate.md.
Work
Model for every workflow: the file of the same name in CTFlows.jl (.github/workflows/), adapted to this package. One commit per item.
CHANGELOG.mdandBREAKING.md(rulesCHG1–CHG5). Baseline entry for the last stable release, asCHG5prescribes:## [0.5.0] - 2026-03-10 — baseline, no reconstructed history;BREAKING.mdstarts at the same point.- New workflows, callers of the CTActions reusable workflows:
ReleaseGate.yml(release-gate.yml);ReleaseTag.yml(release-tag.yml, on push tomaintouchingProject.toml, andworkflow_dispatch);Breakage.yml(breakage-suite.yml, labelrun breakage; the only dependent package in the organization today is CTBenchmarks.jl);DocPreviewCleanup.yml(documentation-preview-cleanup.yml).
CI.yml: on PRs, only with the labelrun ci github-runner; always onmainand tags. Runnersubuntu-latest,macos-latest,windows-latest; Julia 1.10 and 1.12. Use the guard against repeatedlabeledevents as in CTFlows.Documentation.yml: on PRs, only withrun documentation(documentation push previewdeploys the preview); deploy on stable tags only (SITE13);workflow_dispatch(run byReleaseTagon the tag).Coverage.yml: aligned on CTFlows.use_ct_registry: truein every workflow that has the input. Harmless while all dependencies come from General; required by the port to v2 ([Paper] Port to OptimalControl v2 and new problem interface #283).
Out of scope
- GPU jobs (
run ci kkt-runner,run ci occidata-runner,ci-gpu.ymlonmain): added with the test layout ([Tests] Test layout per environment and consistency tests #304), once GPU tests exist (Exa on GPU after [Paper] Port to OptimalControl v2 and new problem interface #283); GPU in the weekly cron with [Tests] Crons per scope for the slow tests, with reports #305. - Labels per modeling (to test one backend only): with [Tests] Test layout per environment and consistency tests #304.
- Any change to the package code or tests. If a workflow change needs one (e.g. a test failing on windows), stop and report it in this issue.
Done when
-
CHANGELOG.mdandBREAKING.mdexist with the 0.5.0 baseline. - The six workflows above exist or are updated;
use_ct_registry: trueeverywhere. - On a test PR: nothing runs without labels;
run ci github-runnerruns the CI on the three OSes;run documentation(+documentation push preview) builds and previews the docs;run breakagetests CTBenchmarks.jl. - The release gate passes on that test PR in local mode:
julia scripts/release/release.jl gate --base <base sha> --labels "run breakage,run ci github-runner,run documentation" <clone>(see CTActionsdocs/workflows/release-gate.md); nothing is released. - Windows: the existing tests pass, or the failures are reported here.
Activity
[-][Chore] Release infrastructure: CHANGELOG, BREAKING and release workflows[/-][+][Chore] Release and CI infrastructure: CHANGELOG, BREAKING, release workflows, label-gated CI[/+]ocots commentedon Nov 4, 2026
Taken by an agent; draft PR to follow.
ocots commentedon Nov 4, 2026
Implementation is ready in draft PR #318, now based on main after #313, #316, and #317 were merged. The branch contains the 0.5.0 CHANGELOG/BREAKING baseline, release workflows, label-gated CI and documentation, CT registry-enabled callers, and coverage alignment. Local actionlint, git diff --check, and the CTActions release-gate check pass. GitHub-hosted CI and the test-PR label checks remain for review.
ocots commentedon Nov 4, 2026
Completed in PR #318, merged into
main.CHANGELOG.mdandBREAKING.md.mainand stable tags.use_ct_registry: truein the applicable workflows.actionlintand the local CTActions release gate.No package source or test code was changed. Closing this issue.