Ship daily releases
This fits a repository where agents merge into one branch (say develop) and releases come from another (main). It needs the graph engine.
-
On the repository’s
repos[]entry in~/.cambium/config.json:{"slug": "owner/app","path": "~/src/app","baseBranch": "develop","release": { "enabled": true, "time": "06:00", "from": "develop", "to": "main", "check": "cd" }}fromdefaults tobaseBranch,totomain,checkto the repository’srequiredCheck.timeis localHH:MM. Top-level"engine": "graph"must be set. -
Restart if you changed
engine:oakgreen restart cambium. -
Each day at
time, cambium closes promotion PRs older than 24 hours. It then createsrelease/YYYY-MM-DD-Nat the newestfromcommit wherecheckpassed, and opens a PR from it intotolisting the PRs it carries. The PR carriesq:promoteand replaces any older open promotion PR. -
The release branch never changes. Fix a problem on
from, then run release-prepare again to cut a new one. -
Review and approve the promotion PR. cambium merges it through
graft pr merge --auto, if graft’s merge policy allows merges intoto. Otherwise merge it on GitHub.
Run it now
Section titled “Run it now”cambium run release-prepare --repo owner/app # cut a release branch and open its PR; counts as today's runcambium run release-promote --repo owner/app # merge approved promotion PRsSee what awaits release
Section titled “See what awaits release”canopy’s Promote lane lists closed issues whose work is merged into from but not yet in to. This tracking runs whenever from and to differ, even with release.enabled off.
Node details: cambium graphs.