forked from heavy-duty/ceremony
docs(fleet): ci-red in the duty order and wake list, on paper; changelog fragment
FLEET.md gains the ci-red wake between resume and build in crew#64's engine position, marked on paper per this file's existing convention (the notifier queue, triage's past-24h wake); the Build bullet records the red-head exclusion as reported-not-swallowed; the reconciliation stamp stays at crew@01fb49c because crew#64 has not merged. Refs #189 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
parent
203907b0ea
commit
e85a7d42f3
2 changed files with 36 additions and 6 deletions
30
FLEET.md
30
FLEET.md
|
|
@ -132,9 +132,13 @@ wake is no longer on paper: `duty-attention.sh` is deployed engine, and
|
|||
|
||||
The engine's duty order is fleet-standard
|
||||
([`bin/duty.sh`](https://github.com/heavy-duty/crew/blob/01fb49cd717a0f4c83df286af86411c69e3c2363/shared/bin/duty.sh)):
|
||||
**attention → triage signals → review queue → resume → build → handoff →
|
||||
rebase → worktree hygiene → backlog hygiene (hourly)** — attention
|
||||
**attention → triage signals → review queue → resume → ci-red → build →
|
||||
handoff → rebase → worktree hygiene → backlog hygiene (hourly)** — attention
|
||||
role-independent and first, then each duty family the box's roles enable.
|
||||
One position in that order is **on paper**: ci-red is
|
||||
[crew#64](https://github.com/heavy-duty/crew/pull/64)'s, unmerged at the
|
||||
stamped SHA, where `duty.sh` still runs resume straight into build — it
|
||||
reads as deployed engine only once that PR merges.
|
||||
The earlier form of this file folded handoff and rebase into the other
|
||||
builder wakes; they are duties of their own.
|
||||
|
||||
|
|
@ -163,10 +167,23 @@ builder wakes; they are duties of their own.
|
|||
— a session died between first push and PR creation. A branch whose PR
|
||||
already **merged** is a post-merge wait, never resumed (#172,
|
||||
incubator#55/#64).
|
||||
- **ci-red** (builders; **on paper** — crew#64's spec, unmerged at the
|
||||
stamped SHA): a non-draft PR of mine whose check at the current head is
|
||||
failing. Evaluated before the build wake, so a red PR of mine outranks a
|
||||
new claim — repairing my own red head comes ahead of new work
|
||||
(ceremony#163: full-panel approvals at the head, mergeable, stranded on
|
||||
a transient failure no wake covered). A round owed at a red head is
|
||||
excluded from the build wake below but reported rather than silent, and
|
||||
an unchanged red head goes quiet after one attempt, through the
|
||||
`report_suppressed` path — suppressed, still said. How a red head is
|
||||
detected and kept quiet is the engine's mechanism, described in crew's
|
||||
`shared/README.md`, not here.
|
||||
- **Build**: a `ready` **unclaimed** issue (an assignee means mid-claim, not
|
||||
pickable), or a completed review round on my PR — a changes-request with
|
||||
no panel review request still outstanding; whole rounds, never single
|
||||
verdicts.
|
||||
verdicts, and — once ci-red deploys — never a round at a red head: that
|
||||
head has already woken ci-red above, and the excluded round is reported,
|
||||
not swallowed.
|
||||
- **Handoff**: a round of mine that converged — every panelist's latest
|
||||
opinionated review approves the current head, no panel request
|
||||
outstanding, mergeable right now, `state:needs-human` not already set.
|
||||
|
|
@ -231,9 +248,10 @@ The duty engine is crew's shared tree, one source deployed to every box;
|
|||
makes the registry rule an operator decision rather than a sweep's. Specs
|
||||
written in this file have a record of becoming engine: the attention wake
|
||||
and the reviewers' request sweep both started here as paper (the sweep's
|
||||
org-wide form was then retired by the 2026-07-25 scope ruling). The
|
||||
notifier's `needs-ruling` queue is the one still on paper: at the stamped
|
||||
crew SHA, `notify.sh`'s only label filter is `state:needs-human`.
|
||||
org-wide form was then retired by the 2026-07-25 scope ruling). Two are
|
||||
still on paper: the notifier's `needs-ruling` queue — at the stamped crew
|
||||
SHA, `notify.sh`'s only label filter is `state:needs-human` — and the
|
||||
builders' ci-red wake above, engine the moment crew#64 merges.
|
||||
|
||||
### Conventions on the board
|
||||
|
||||
|
|
|
|||
12
changelog.d/189.md
Normal file
12
changelog.d/189.md
Normal file
|
|
@ -0,0 +1,12 @@
|
|||
### Changed
|
||||
|
||||
- `BUILDER.md` gates both review-request points on a green check at the
|
||||
head, carries crew#45's argued exception for failures outside the PR,
|
||||
and states the ruled classification: cancelled and stale are not a
|
||||
green head; skipped and neutral are (#189).
|
||||
- `BUILDER.md` documents CI-red recovery in pickup precedence: a red head
|
||||
of your own PR is picked up before claiming another issue, is never a
|
||||
parked claim, and follows crew#17's recovery path (#189).
|
||||
- `FLEET.md` writes the ci-red wake into the duty order between resume
|
||||
and build, marked on paper until crew#64 merges, with the
|
||||
reconciliation stamp unchanged (#189).
|
||||
Loading…
Reference in a new issue