Generated from
cat-harness/sdlc/processes/saturation-meta-merge.bpmnbygen-processes-viz.ts— do not edit here. All processes · cat-harness processes
Saturation meta-merge: land the ready PRs when the runners are full
Process_SaturationMetaMerge · strict (defaulted) · 8 step(s)
Landing a batch while the runners are full: cancel everything queued, pause new work, consolidate all ready PRs on one meta-merge branch, skip CI and rendering, and merge it, holding the swarm siblings until it is done. It repeats across repositories. Skill saturation-meta-merge holds the steps, the safety rules and the record of its first run. This process bypasses merge:guard on purpose, so the owner’s card, the PR body and a comment on each member PR are the record.
How it connects
- Called by: Merge manager watch: wake, read the queue live, route
- Calls: none
- Presented on: no docs page section shows this diagram
- Skill:
saturation-meta-merge - Running instances: none recorded
Lanes — who acts
Steps
Every one of the 8 step(s) is documented.
| step | lane | skill / sub-process | what it does |
|---|---|---|---|
Broadcast the hold to siblingsTask_Hold | Merge steward | merge-manager-watcher | Message every sibling that pushes to the repositories involved: what is about to land, and hold pushes, merges and run cancels until done. Ask the coordinator to pass it on to any thread that cannot be reached. |
Hold, and name the heads to mergeTask_SibHold | Sibling session | saturation-meta-merge | A sibling that owns a PR in the batch names the head it wants merged. |
Dry-run, then ask the owner naming every PRTask_Ask | Merge steward | ask-the-person | Stack the PRs on a meta-merge branch without pushing. Then post the full question (include, leave out with the reason, merge method, per repository), followed by the card: A go, B also the red ones, C dry run only, D cancel. |
Choose A, B, C or DTask_Owner | Owner | — | Only the owner’s own tap or words approve the landing. A PR the card does not name gets no merge from it. |
Cancel queued PR runs; build, push, mergeTask_Land | Merge steward | saturation-meta-merge | Never cancel a main push run that has started. Build from fresh main with merge commits, skipping conflicts, .github/workflows/ and subscriptions/. Open one PR per repository, merge it with a merge commit, and comment on each member PR with the link. |
Post done to every held siblingTask_Done | Merge steward | merge-manager-watcher | Post done with what landed and what is still open, also when nothing was merged. A hold with no done is an outage. |
Run main’s checksTask_MainRun | Build pipeline | — | The merge starts main’s checks. Until tools#1384, a closed PR’s run can cancel them, so the steward re-runs a cancelled main run. |
Report what landed and main’s verdictTask_Report | Merge steward | merge-to-main | One message to the owner: what merged, main’s verdict per repository, and any open decision. On red, the fix goes to main as its own PR. |
Decisions
1 of 2 decision(s) carry no documentation — gateway-documented lists them.
| decision | what decides it | branches |
|---|---|---|
Go?Gw_Go | A or B is yes. C or D is no. | Yes → Cancel queued PR runs; build, push, merge No → Post done to every held sibling |
Merged?Gw_Merged | — | Yes → Run main’s checks No → Hold released, nothing merged |