Repository navigation
v0.26.0 — milestone branches, review lenses, shared knowledge
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>replacessite:support: main is namedmain, support usesround.support. On main, preview withrota migrate labels, then runrota migrate labels --applyto relabel open issues and retireissues.labels.support(including a custom label value).config fillkeeps that key until the migration succeeds. - Visible claim labels. After upgrading, run
rota round reconcile --applyonce to backfillclaimed:<agent>@<machine>labels for in-flight comment claims. Comment claims stay authoritative. Reverting leaves theclaimed:*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;0disables). After approval,rota round assign <ID> --reclaim-stale <claim-id>transfers the claim, and the former holder's PR is refusedclaim-lostat the gate. - Fewer filed follow-ups.
review.fileDeferrednow defaults tomajor: minor deferred findings stay in the verdict record. A PR whose issue is itself a deferred-findings item files none. Setminorfor 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.maxBouncesor parks the item. - An unresolved base refuses. A
git.baseBranchthat is set but missing used to fall back to main. Round verbs,round startandworker adoptnow refuse and name it, androta shippasses--basetogh 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 asarchive/milestone/<id>or deletes it (--branch), and shipping deletes it. - Routing.
rota round assignbranches the worker from the milestone, records it as the slot's base and names it in the brief; the PR,rota git baseandrota shipfollow. When an issue's milestone changes after assign,rota round reconcile --applyrepairs the newbase-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 trainmerge-failedand pushes nothing. - Close on merge. PRs merged into a milestone label their issues
on-milestone/<id>and close them.rota round candidatesandassignflag dependencies on another active milestone (cross-milestone; override with--accept-cross-milestone). - Release.
/rota-releaseon 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.lensesmapssecurity,perfanduxto path globs and labels.rota review depth --jsonlists the triggered lenses,/rota-reviewruns one focused reviewer per lens, androta worker gaterefusesreview-missinguntil each lens has a record at head. Empty by default. - Gate refuses a blocking finding.
rota worker gateandrota worker trainrefuse a PR whose review record at the merged head carries a blocker or major finding, even under CONCERNS. - External knowledge base.
knowledge.externalpoints at a cloned git repo of markdown topics shared across projects.rota knowledge query|topics|add|amend --externalread and write it, and writes land by the repo's own push or PR policy. See external knowledge. - Surface-aware
/rota-qa.first-runoffers a check menu per surface (CLI, web, API, library). Strategies can scope pillars withpillar-globs, andship.qaruns 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 --planpreviews the conflict-free subset, and trains accept external PR targets. - Assign before landing. Train nudges,
worker gateandworker trainname a ready assignment to run first when a slot is free (--no-assign-checkskips 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-moveddrift) 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 busyand 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