Skip to content

v0.26.0 — milestone branches, review lenses, shared knowledge

Choose a tag to compare

@github-actions github-actions released this 26 Oct 17:28
· 2191 commits to main since this release

Milestones get their own integration branches, reviews gain security, perf and UX lenses, and a shared knowledge base can follow you across projects.

Upgrade notes

  • Named machine pins. machine:<name> replaces site:support: main is named main, support uses round.support. On main, preview with rota migrate labels, then run rota migrate labels --apply to relabel open issues and retire issues.labels.support (including a custom label value). config fill keeps that key until the migration succeeds.
  • Visible claim labels. After upgrading, run rota round reconcile --apply once to backfill claimed:<agent>@<machine> labels for in-flight comment claims. Comment claims stay authoritative. Reverting leaves the claimed:* labels on the tracker; remove them by hand.
  • Stale claims can be reclaimed. Status, candidates and doctor mark inactive remote claims stale-claim (round.claimStaleMinutes, default 240; round.claimStaleMinutesMajor, default 480 for Major features; 0 disables). After approval, rota round assign <ID> --reclaim-stale <claim-id> transfers the claim, and the former holder's PR is refused claim-lost at the gate.
  • Fewer filed follow-ups. review.fileDeferred now defaults to major: minor deferred findings stay in the verdict record. A PR whose issue is itself a deferred-findings item files none. Set minor for the old behaviour.
  • Stale and provenance-fail gates no longer count as bounces. They go back to the worker, and a support machine's worker still gets the review-bounce comment on its PR, but neither counts toward round.maxBounces or parks the item.
  • An unresolved base refuses. A git.baseBranch that is set but missing used to fall back to main. Round verbs, round start and worker adopt now refuse and name it, and rota ship passes --base to gh pr create.

Milestone branches

Issues tagged to an active milestone merge into milestone/<id>, which reaches main only through a release PR.

  • Branch lifecycle. Activating a milestone cuts and pushes milestone/<id> from origin's base. Archiving keeps it as archive/milestone/<id> or deletes it (--branch), and shipping deletes it.
  • Routing. rota round assign branches the worker from the milestone, records it as the slot's base and names it in the brief; the PR, rota git base and rota ship follow. When an issue's milestone changes after assign, rota round reconcile --apply repairs the new base-drift: it retargets the PR and holds the slot until the worker merges the new base.
  • Trains sync first. rota worker train --base milestone/<id> merges the project base into the milestone, gates base + milestone + members once and pushes only on green. A sync conflict ends the train merge-failed and pushes nothing.
  • Close on merge. PRs merged into a milestone label their issues on-milestone/<id> and close them. rota round candidates and assign flag dependencies on another active milestone (cross-milestone; override with --accept-cross-milestone).
  • Release. /rota-release on a milestone with a branch syncs the base, runs the full gate plus e2e, opens a PR to the base and merges it with a merge commit once CI is green. It then removes the labels, deletes the branch and marks the milestone shipped.

New

  • Review lenses. review.lenses maps security, perf and ux to path globs and labels. rota review depth --json lists the triggered lenses, /rota-review runs one focused reviewer per lens, and rota worker gate refuses review-missing until each lens has a record at head. Empty by default.
  • Gate refuses a blocking finding. rota worker gate and rota worker train refuse a PR whose review record at the merged head carries a blocker or major finding, even under CONCERNS.
  • External knowledge base. knowledge.external points at a cloned git repo of markdown topics shared across projects. rota knowledge query|topics|add|amend --external read and write it, and writes land by the repo's own push or PR policy. See external knowledge.
  • Surface-aware /rota-qa. first-run offers a check menu per surface (CLI, web, API, library). Strategies can scope pillars with pillar-globs, and ship.qa runs only the pillars the change touches (/rota-qa run --gate).
  • Support pull. A support machine fills free slots from its pinned issues, then unpinned issues in round.scope, through the shared claim.
  • Merge trains. rota worker train --plan previews the conflict-free subset, and trains accept external PR targets.
  • Assign before landing. Train nudges, worker gate and worker train name a ready assignment to run first when a slot is free (--no-assign-check skips it).
  • Worker pre-flight. The worker contract and brief carry measured, numeric acceptance checks, and round workers post learnings on their issue before worker done.

Fixed

  • herdr panes that move. Reconcile follows a pane moved to another tab (tab-moved drift) and records the pane handle when the tab holds other panes. Kill checks the tab's pane count before it closes anything, so a shared tab is never closed.
  • Round watch. Every exit carries the re-arm hint, and the watch wakes on gate release, support PR comments and pushes, and a second done for the same PR.
  • Assign races. Two assigns racing on one slot: the later one is refused slot busy and rolls back only its own claim.
  • Transfers. A transferred slot stays busy until its own worker reports done.
  • Superseded PRs. Reconcile repairs a slot whose recorded PR was closed while another PR heads its branch (pr-superseded).
  • Merged PRs. The gate judges the merged head, not the local branch tip, and a merged PR counts as closed for dependencies.
  • Builds. Unstamped builds report their version as unknown.

Stats

387 commits, 469 files changed, +22337 −3570 lines

Full changelog: v0.25.0...v0.26.0