Skip to content

cuda.bindings: document shared maintenance and release branches - #3178

Draft
rwgk wants to merge 6 commits into
rwgk/cb12-on-main-06-release-routingfrom
rwgk/cb12-on-main-07-maintenance-policy
Draft

rwgk wants to merge 6 commits into
rwgk/cb12-on-main-06-release-routingfrom
rwgk/cb12-on-main-07-maintenance-policy

Conversation

@rwgk

@rwgk rwgk commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Maintain both supported bindings majors on main, with short release branches for stabilization and urgent fixes. This PR supplies the ongoing development and release policy for the preceding packaging/CI layers.

  • Distinguish major-line maintenance, which can include explicitly selected API/Python/platform compatibility work, from a frozen patch release accepting only approved fixes and prerequisites. Record the scope in the checklist and release notes.
  • Keep routine CUDA 12 development in cuda_bindings_12/. The historical 12.9.x branch stays frozen except for emergency fixes using compatible historical tooling; reconcile those fixes back into main.
  • Replace automatic historical-branch backports with a manual workflow taking one already merged PR and one existing non-default target branch. It opens a reviewable PR; normal CI approval and merging remain separate. Workflow-file backports and conflicting/generated adaptations need manual handling.
  • Remove the active backport_branch setting with its last legacy consumer and remove automatic Dependabot updates to the frozen branch. The reader continues accepting that field in earlier schema-2 tagged registries.
  • Document release source/control revisions, exact-tag CI, dry-runs, component publication, owner publication of the shared GitHub Release draft, reconciliation, and version-selector ownership on main.
  • Extend package-specific generation/review guidance and add explicit development/review instructions for existing SYNCED blocks. The bidirectional root-review rule and handwritten patch-transfer procedure are introduced earlier in cuda.bindings: configure independent CUDA 12 and CUDA 13 packages #3174.

Stack / Review Boundary

Previous: #3177. Next: #3182. The stack overview lists all six open PRs and the intended workflow.

#3174 through #3176 are intended to land together, with separate review scopes and cumulative CI at #3176; the first two are incomplete intermediate states. Release routing (#3177), maintenance policy (#3178), and the runtime fixes (#3182) follow that group. The complete proposed source tree is at #3182.

Baseline: main 2e6aa4e9ef89.

Suggested Review Order

  1. .github/RELEASE-bindings.md
  2. ci/README.md
  3. .github/workflows/backport.yml
  4. AGENTS.md

Validation

At the exact published heads, 328 CI-tool tests pass at #3176 and 341 at #3182. Full local pre-commit run --all-files --show-diff-on-failure passes at both, including actionlint and Lychee.

All three synchronized pytest bootstrap blocks and all four shared build helpers match. Tagged-source regressions retain compatibility with schema-2 registries containing the retired field. Hosted cumulative integration: full CI for the complete stack.

The manual backport workflow and hosted release/publication procedure were not exercised against live target branches or package indexes. A retained maintenance milestone and removal of the temporary preview bootstrap remain follow-ups after the validated integration group lands.

Checklist

  • Relevant existing and focused regression tests cover the integration behavior.
  • This description identifies the layer's scope and validation boundary.

@rwgk rwgk added this to the cuda.bindings next milestone Oct 21, 2026
@rwgk rwgk added enhancement Any code-related improvements CI/CD CI/CD infrastructure cuda.bindings Everything related to the cuda.bindings module labels Oct 21, 2026
@copy-pr-bot

copy-pr-bot Bot commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@rwgk rwgk self-assigned this Oct 21, 2026
@github-actions github-actions Bot added the cuda.core Everything related to the cuda.core module label Oct 21, 2026
@rwgk
rwgk added this pull request to stack #3179 October 21, 2026 04:48
@rwgk

rwgk commented Oct 21, 2026

Copy link
Copy Markdown
Contributor Author

/ok to test 9cf3778

@github-actions

Copy link
Copy Markdown
Contributor

@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from 9cf3778 to fb5cced Compare October 21, 2026 05:27
@rwgk

rwgk commented Oct 21, 2026

Copy link
Copy Markdown
Contributor Author

/ok to test fb5cced

@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from fb5cced to db00295 Compare October 21, 2026 13:57
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch 2 times, most recently from e6c8572 to 09cbc38 Compare October 21, 2026 16:51
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from 09cbc38 to 9f79034 Compare October 21, 2026 17:27
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from 9f79034 to e1fd4fb Compare October 21, 2026 18:22
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from e1fd4fb to 3b3aa82 Compare October 21, 2026 19:33
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from 3b3aa82 to d6350b0 Compare October 22, 2026 03:52
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from d6350b0 to 0c73a57 Compare October 22, 2026 04:15
@mdboom
mdboom force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from 5559173 to cdd927d Compare October 23, 2026 15:04
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from cdd927d to 1723499 Compare October 25, 2026 23:56
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from 1723499 to 1006ce0 Compare October 26, 2026 00:20
rwgk added 6 commits October 26, 2026 14:32
Signed-off-by: Ralf W. Grosse-Kunstleve <rgrossekunst@nvidia.com>
Signed-off-by: Ralf W. Grosse-Kunstleve <rgrossekunst@nvidia.com>
Signed-off-by: Ralf W. Grosse-Kunstleve <rgrossekunst@nvidia.com>
Signed-off-by: Ralf W. Grosse-Kunstleve <rgrossekunst@nvidia.com>
Signed-off-by: Ralf W. Grosse-Kunstleve <rgrossekunst@nvidia.com>
Signed-off-by: Ralf W. Grosse-Kunstleve <rgrossekunst@nvidia.com>
@rwgk
rwgk force-pushed the rwgk/cb12-on-main-07-maintenance-policy branch from 1006ce0 to 95303a8 Compare October 26, 2026 21:35

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CI/CD CI/CD infrastructure cuda.bindings Everything related to the cuda.bindings module cuda.core Everything related to the cuda.core module enhancement Any code-related improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant