Skip to content

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.

  1. 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" }
    }

    from defaults to baseBranch, to to main, check to the repository’s requiredCheck. time is local HH:MM. Top-level "engine": "graph" must be set.

  2. Restart if you changed engine: oakgreen restart cambium.

  3. Each day at time, cambium closes promotion PRs older than 24 hours. It then creates release/YYYY-MM-DD-N at the newest from commit where check passed, and opens a PR from it into to listing the PRs it carries. The PR carries q:promote and replaces any older open promotion PR.

  4. The release branch never changes. Fix a problem on from, then run release-prepare again to cut a new one.

  5. Review and approve the promotion PR. cambium merges it through graft pr merge --auto, if graft’s merge policy allows merges into to. Otherwise merge it on GitHub.

Terminal window
cambium run release-prepare --repo owner/app # cut a release branch and open its PR; counts as today's run
cambium run release-promote --repo owner/app # merge approved promotion PRs

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.