mirror of
https://github.com/garrytan/gstack.git
synced 2026-11-16 13:21:30 +01:00
* ship-queue: wave PRs — group 3-6 same-area READY PRs into one train slot (GST-574) Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * ship-queue wave: review fixes — stamped wave re-READY, constituent double-land, drop dry-run, settle names hand-resolved merges, one settled row per PR, ready refuses an unreadable PR Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * ship-queue wave: release a wave (drop under --min, or --release), and accept stacked train stamps after the last constituent Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * ship-queue wave: Step 11 fixes — settle binds to a merge on the base, drop fetches pins first, close re-reads the head, drop and release wait for the wave PR to close, stacked constituents refused, conflict worktree derived from the nonce Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * docs: wave PRs — drop/release wait for a closed wave PR, settle's base checks, more QUEUE_WAVE_* cases Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * ship-queue wave: DROP line and QUEUE_WAVE_MOVED text match the closed-PR rule Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * changelog: wave PRs fragment covers release, stacked-PR refusal and settle checks Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * captain: keep the skill generic and under its context budget (wave paragraph trimmed) Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * fix(wave): settle a wave PR the train merged directly onto a moved main Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * docs(wave): settle accepts a wave PR the train merged directly Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --------- Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
# READY block
|
|
|
|
Sent by the lane: first the block exactly as `gstack-ship-queue ready --pr <n> --no-screen|--screen`
|
|
prints it, then the lane's own lines. The controller validates every field before the pin
|
|
enters `train build`. A missing or wrong field goes back to the lane, never into a train.
|
|
|
|
The tool's lines (shapes as printed; `screen:` is inserted as the second line under a train policy):
|
|
|
|
```text
|
|
READY #<n> <sha40> STAMP_VERSION=unstamped
|
|
screen: <screen|no-screen> policy=<selection> nonce=<nonce> run=<run id or ->
|
|
pr: <PR url>
|
|
head: <sha40>
|
|
version: unstamped
|
|
base: origin/<BASE>@<base sha40>
|
|
ci: green at <sha12> (passed=<k> failed=0 pending=0 skipped=<s>)
|
|
PREGATE: pass tree=<tree12> head=<sha12> checks=<c>
|
|
gate: command=<"…"|none> full_e2e=<yes|no> gate-ahead=<…>
|
|
SHIP_RECEIPT: pr=<n> head=<sha12> version=- base=<BASE> tree=<tree> session_kind=unattended …
|
|
READY_RECEIPT: <path the tool wrote> (<local and notes-ref detail>)
|
|
```
|
|
|
|
A wave PR (docs/ship-policy.md#wave-prs) adds two lines after `READY`, and the controller checks
|
|
that every constituent named is one the wave was planned for:
|
|
|
|
```text
|
|
WAVE: <nonce> area=<area> branch=wave/<nonce> constituents=<k> integrator_commits=<i>
|
|
CONSTITUENTS: #<n>@<sha12>,#<n>@<sha12>,... (heads frozen; fixes go on the wave branch)
|
|
```
|
|
|
|
Under `changelog_fragments` (docs/ship-policy.md#changelog-fragments) the PR's entry is a
|
|
fragment, `changelog.d/<slug>.md`, never an `[Unreleased]` section or a version, and the
|
|
controller merges with `train land` or `land`, so no slot call follows this block.
|
|
|
|
The lane's own lines, after the block:
|
|
|
|
```text
|
|
pin: <sha40> # the full head SHA, restated
|
|
screen choice: <--no-screen: cases <ids> ran focused and passed | --screen: <reason>>
|
|
flaky: <none | case, both run ids, logged in the ledger on <date>>
|
|
review passes: <n> (deferred: <items filed as issues, or none>)
|
|
Head frozen from now on; a push drops this PR from any train and I will READY again.
|
|
```
|
|
|
|
Optional lines a crew's rules file may require:
|
|
|
|
```text
|
|
gate_run: <run id> tree=<tree12> # when lanes gate on their own machines
|
|
closes: #<issue>
|
|
image: <URL of the key before/after image>
|
|
```
|
|
|
|
Refuse (send back) when: the SHA is short or a fork head; `SHIP_RECEIPT` reads `none` or
|
|
`invalid`, or its head is not the pin; `ci:` is not `green at` the pin; `PREGATE:` is not
|
|
`pass` for the pin's tree; `--no-screen` names no cases; a flaky case is not in the ledger;
|
|
the PR page is "green" but no block was sent; the evidence offered is a cheap tier.
|
|
|
|
After the slot call the lane answers with the stamped head:
|
|
|
|
```text
|
|
READY #<n> <stamped sha40> STAMP_VERSION=<X>
|
|
```
|