@feigi/fleet-ctl 3.72.5 → 3.73.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agents/fleet-implementer-slow-high.agent.md +8 -2
- package/agents/fleet-implementer-slow-medium.agent.md +8 -2
- package/agents/fleet-implementer-smol-high.agent.md +8 -2
- package/agents/fleet-implementer-task-high.agent.md +8 -2
- package/agents/fleet-implementer-task-max.agent.md +8 -2
- package/package.json +1 -1
- package/scripts/dispatch-prompt.mjs +1 -1
- package/scripts/fleet-event.mjs +102 -24
- package/scripts/report-schema.mjs +1 -1
- package/skills/run-team/SKILL.md +11 -27
- package/skills/run-team/briefs/relabel.md +9 -0
- package/skills/run-team/references/pull.md +11 -0
|
@@ -48,8 +48,14 @@ human hands you do not have → bail, name the cause, do not implement.
|
|
|
48
48
|
**Re-derive the ticket's claims against `origin/main` before implementing** —
|
|
49
49
|
not the working tree, and not the ticket's line numbers, which drift. The Pull
|
|
50
50
|
runs a cheap version of this check, so what reaches you is what a `grep` could
|
|
51
|
-
not settle; you have the tree, so you are the backstop. Already fixed
|
|
52
|
-
|
|
51
|
+
not settle; you have the tree, so you are the backstop. Already fixed on
|
|
52
|
+
`origin/main` → bail with `bailCause` `fixed` and do NOT invent work:
|
|
53
|
+
`bailDetail` is `<sha> — <how origin/main's tree meets the acceptance>`, `<sha>`
|
|
54
|
+
the commit that fixed it. Already covered by an open PR M you find → bail with
|
|
55
|
+
`bailCause` `covered`: `bailDetail` is `PR#M — <how M's diff meets N's
|
|
56
|
+
acceptance>`, and PR M is never edited. What the controller does with each
|
|
57
|
+
cause is the *Implementer bails before implementing* table in run-team's
|
|
58
|
+
SKILL.md. An acceptance criterion the tree
|
|
53
59
|
now **contradicts** is a bail, not a thing to implement: say which, and stop.
|
|
54
60
|
|
|
55
61
|
**Claim discipline, on every ticket:**
|
|
@@ -48,8 +48,14 @@ human hands you do not have → bail, name the cause, do not implement.
|
|
|
48
48
|
**Re-derive the ticket's claims against `origin/main` before implementing** —
|
|
49
49
|
not the working tree, and not the ticket's line numbers, which drift. The Pull
|
|
50
50
|
runs a cheap version of this check, so what reaches you is what a `grep` could
|
|
51
|
-
not settle; you have the tree, so you are the backstop. Already fixed
|
|
52
|
-
|
|
51
|
+
not settle; you have the tree, so you are the backstop. Already fixed on
|
|
52
|
+
`origin/main` → bail with `bailCause` `fixed` and do NOT invent work:
|
|
53
|
+
`bailDetail` is `<sha> — <how origin/main's tree meets the acceptance>`, `<sha>`
|
|
54
|
+
the commit that fixed it. Already covered by an open PR M you find → bail with
|
|
55
|
+
`bailCause` `covered`: `bailDetail` is `PR#M — <how M's diff meets N's
|
|
56
|
+
acceptance>`, and PR M is never edited. What the controller does with each
|
|
57
|
+
cause is the *Implementer bails before implementing* table in run-team's
|
|
58
|
+
SKILL.md. An acceptance criterion the tree
|
|
53
59
|
now **contradicts** is a bail, not a thing to implement: say which, and stop.
|
|
54
60
|
|
|
55
61
|
**Claim discipline, on every ticket:**
|
|
@@ -48,8 +48,14 @@ human hands you do not have → bail, name the cause, do not implement.
|
|
|
48
48
|
**Re-derive the ticket's claims against `origin/main` before implementing** —
|
|
49
49
|
not the working tree, and not the ticket's line numbers, which drift. The Pull
|
|
50
50
|
runs a cheap version of this check, so what reaches you is what a `grep` could
|
|
51
|
-
not settle; you have the tree, so you are the backstop. Already fixed
|
|
52
|
-
|
|
51
|
+
not settle; you have the tree, so you are the backstop. Already fixed on
|
|
52
|
+
`origin/main` → bail with `bailCause` `fixed` and do NOT invent work:
|
|
53
|
+
`bailDetail` is `<sha> — <how origin/main's tree meets the acceptance>`, `<sha>`
|
|
54
|
+
the commit that fixed it. Already covered by an open PR M you find → bail with
|
|
55
|
+
`bailCause` `covered`: `bailDetail` is `PR#M — <how M's diff meets N's
|
|
56
|
+
acceptance>`, and PR M is never edited. What the controller does with each
|
|
57
|
+
cause is the *Implementer bails before implementing* table in run-team's
|
|
58
|
+
SKILL.md. An acceptance criterion the tree
|
|
53
59
|
now **contradicts** is a bail, not a thing to implement: say which, and stop.
|
|
54
60
|
|
|
55
61
|
**Claim discipline, on every ticket:**
|
|
@@ -48,8 +48,14 @@ human hands you do not have → bail, name the cause, do not implement.
|
|
|
48
48
|
**Re-derive the ticket's claims against `origin/main` before implementing** —
|
|
49
49
|
not the working tree, and not the ticket's line numbers, which drift. The Pull
|
|
50
50
|
runs a cheap version of this check, so what reaches you is what a `grep` could
|
|
51
|
-
not settle; you have the tree, so you are the backstop. Already fixed
|
|
52
|
-
|
|
51
|
+
not settle; you have the tree, so you are the backstop. Already fixed on
|
|
52
|
+
`origin/main` → bail with `bailCause` `fixed` and do NOT invent work:
|
|
53
|
+
`bailDetail` is `<sha> — <how origin/main's tree meets the acceptance>`, `<sha>`
|
|
54
|
+
the commit that fixed it. Already covered by an open PR M you find → bail with
|
|
55
|
+
`bailCause` `covered`: `bailDetail` is `PR#M — <how M's diff meets N's
|
|
56
|
+
acceptance>`, and PR M is never edited. What the controller does with each
|
|
57
|
+
cause is the *Implementer bails before implementing* table in run-team's
|
|
58
|
+
SKILL.md. An acceptance criterion the tree
|
|
53
59
|
now **contradicts** is a bail, not a thing to implement: say which, and stop.
|
|
54
60
|
|
|
55
61
|
**Claim discipline, on every ticket:**
|
|
@@ -48,8 +48,14 @@ human hands you do not have → bail, name the cause, do not implement.
|
|
|
48
48
|
**Re-derive the ticket's claims against `origin/main` before implementing** —
|
|
49
49
|
not the working tree, and not the ticket's line numbers, which drift. The Pull
|
|
50
50
|
runs a cheap version of this check, so what reaches you is what a `grep` could
|
|
51
|
-
not settle; you have the tree, so you are the backstop. Already fixed
|
|
52
|
-
|
|
51
|
+
not settle; you have the tree, so you are the backstop. Already fixed on
|
|
52
|
+
`origin/main` → bail with `bailCause` `fixed` and do NOT invent work:
|
|
53
|
+
`bailDetail` is `<sha> — <how origin/main's tree meets the acceptance>`, `<sha>`
|
|
54
|
+
the commit that fixed it. Already covered by an open PR M you find → bail with
|
|
55
|
+
`bailCause` `covered`: `bailDetail` is `PR#M — <how M's diff meets N's
|
|
56
|
+
acceptance>`, and PR M is never edited. What the controller does with each
|
|
57
|
+
cause is the *Implementer bails before implementing* table in run-team's
|
|
58
|
+
SKILL.md. An acceptance criterion the tree
|
|
53
59
|
now **contradicts** is a bail, not a thing to implement: say which, and stop.
|
|
54
60
|
|
|
55
61
|
**Claim discipline, on every ticket:**
|
package/package.json
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
// recipe-deriver, relabel (the comment a Pull posts on a ticket it returns,
|
|
9
9
|
// not a member's brief). A role with kinds (fix-applier: review, conflict,
|
|
10
10
|
// dispositions-retry, red-check; finisher: fresh, repair; relabel:
|
|
11
|
-
// needs-triage, fork, hands) requires --kind; a role without them refuses it
|
|
11
|
+
// needs-triage, fork, hands, covered, fixed) requires --kind; a role without them refuses it
|
|
12
12
|
// as an unknown flag.
|
|
13
13
|
//
|
|
14
14
|
// OUTPUT. The brief on stdout and nothing else. With --json the payload
|
package/scripts/fleet-event.mjs
CHANGED
|
@@ -19,14 +19,15 @@
|
|
|
19
19
|
//
|
|
20
20
|
// impl-report <impl-N[-x]>
|
|
21
21
|
// `ledger.mjs settle <member> --from-report`, which runs `verify-sha.sh` and reads the PR itself. Settled `bailed`: the
|
|
22
|
-
// report's `bailCause` names the label (undecided `needs-triage`, fork
|
|
23
|
-
// and
|
|
22
|
+
// report's `bailCause` names the label (undecided `needs-triage`, fork,
|
|
23
|
+
// hands and covered `ready-for-human`), then:
|
|
24
24
|
// `gh issue edit <N> --remove-label ready-for-agent --remove-label
|
|
25
25
|
// in-progress --add-label <label>`, skipped when the issue already
|
|
26
26
|
// carries the label and neither of the others;
|
|
27
27
|
// `gh issue comment <N>` with the comment `dispatch-prompt.mjs render
|
|
28
28
|
// relabel` renders from the report's `bailDetail` — kind
|
|
29
|
-
// `needs-triage` (`--line`), `fork` (`--options`),
|
|
29
|
+
// `needs-triage` (`--line`), `fork` (`--options`), `covered`
|
|
30
|
+
// (`--detail`, `PR#M — <how>`), or `hands`, whose
|
|
30
31
|
// detail opens with the cause the Pull's answer names (`external
|
|
31
32
|
// access`, `manual testing`, `judgment`) and goes on with the line —
|
|
32
33
|
// skipped when the issue already carries that comment;
|
|
@@ -37,6 +38,16 @@
|
|
|
37
38
|
// `NEED hand-release #<N> <blocker>` and is never forced.
|
|
38
39
|
// Dropping `in-progress` is the load-bearing half: phase 1 applied it and `candidates.mjs` excludes it, so leaving it makes the ticket invisible to the controller's scans and the maintainer's. It does not loop; it disappears.
|
|
39
40
|
// `reap.sh` declines a claim that never became a PR, so the release of a bailed claim is `release-ticket.sh`'s.
|
|
41
|
+
// A `fixed` bail takes no label. Its `bailDetail` is `<sha> — <how>`,
|
|
42
|
+
// and `verify-sha.sh main <sha>` decides: exit 0 closes N, `gh issue
|
|
43
|
+
// close <N> --comment` with the kind `fixed` render (`--detail`, the
|
|
44
|
+
// whole `bailDetail`) — no comment when the issue already carries it,
|
|
45
|
+
// no close when it is already closed — then drops whichever of
|
|
46
|
+
// `ready-for-agent` and `in-progress` it carries and releases as above;
|
|
47
|
+
// exit 1 relabels `needs-triage` as above, its comment naming `<sha>`
|
|
48
|
+
// not on origin/main, and releases; any other answer, or a detail that
|
|
49
|
+
// opens with no sha, is a NEED and N is left untouched, claim and all.
|
|
50
|
+
// The PR a `covered` detail names is never written to.
|
|
40
51
|
// fix-report <fix-pr-M[-x]>
|
|
41
52
|
// `settle --from-report`, which records the filings and rulings the
|
|
42
53
|
// report carries. Settled `applied:`/`no-op`, on a PR whose rows carry
|
|
@@ -176,11 +187,17 @@ const USAGE = `usage: ${NAME}.mjs <kind> <args> [--in-flight <n>] — kinds: `
|
|
|
176
187
|
+ Object.entries(KINDS).map(([k, { args, flag }]) => [k, ...args, ...(flag ? [flag] : [])].join(" ")).join(", ");
|
|
177
188
|
|
|
178
189
|
// The label each `bailCause` demotes to, and the relabel template's kind.
|
|
179
|
-
|
|
190
|
+
// `fixed` takes no label: it closes the ticket once `verify-sha.sh` finds the
|
|
191
|
+
// commit on origin/main, and demotes to `needs-triage` when it does not.
|
|
192
|
+
export const BAILS = {
|
|
180
193
|
undecided: { label: "needs-triage", kind: "needs-triage", flag: "line" },
|
|
181
194
|
fork: { label: "ready-for-human", kind: "fork", flag: "options" },
|
|
182
195
|
hands: { label: "ready-for-human", kind: "hands" },
|
|
196
|
+
covered: { label: "ready-for-human", kind: "covered", flag: "detail" },
|
|
197
|
+
fixed: { kind: "fixed", flag: "detail" },
|
|
183
198
|
};
|
|
199
|
+
// The commit a `fixed` bail's detail opens with.
|
|
200
|
+
const FIXED_SHA = /^([0-9a-f]{7,40})(?![0-9A-Za-z])/;
|
|
184
201
|
// The causes a `hands` detail opens with — the Pull's answer grammar — and the
|
|
185
202
|
// words each puts in the comment.
|
|
186
203
|
const HANDS = { "external access": "external access", "manual testing": "manual testing", judgment: "judgment during the work" };
|
|
@@ -303,10 +320,11 @@ class Event {
|
|
|
303
320
|
return outcome;
|
|
304
321
|
}
|
|
305
322
|
|
|
306
|
-
// The
|
|
307
|
-
// could not answer (the NEED is
|
|
323
|
+
// The labels, comments and state of issue `n`, or the comments of PR `n`,
|
|
324
|
+
// each comment trimmed, or null when gh could not answer (the NEED is
|
|
325
|
+
// printed here).
|
|
308
326
|
comments(noun, n, what) {
|
|
309
|
-
const r = gh([noun, "view", String(n), "--json", noun === "issue" ? "labels,comments" : "comments"]);
|
|
327
|
+
const r = gh([noun, "view", String(n), "--json", noun === "issue" ? "labels,comments,state" : "comments"]);
|
|
310
328
|
let v = null;
|
|
311
329
|
if (r.status === 0) {
|
|
312
330
|
try {
|
|
@@ -319,7 +337,7 @@ class Event {
|
|
|
319
337
|
this.need(`${what} — gh ${noun} view ${n} did not answer (${r.status === 0 ? "no JSON" : said(r)})`);
|
|
320
338
|
return null;
|
|
321
339
|
}
|
|
322
|
-
return { labels: (v.labels ?? []).map((l) => l?.name), bodies: v.comments.map((c) => String(c?.body ?? "").trim()) };
|
|
340
|
+
return { labels: (v.labels ?? []).map((l) => l?.name), bodies: v.comments.map((c) => String(c?.body ?? "").trim()), state: v.state ?? null };
|
|
323
341
|
}
|
|
324
342
|
|
|
325
343
|
// `gh <noun> comment <n> --body <body>` unless `seen` already holds it.
|
|
@@ -352,35 +370,95 @@ function relabelArgs(cause, detail) {
|
|
|
352
370
|
return { args: ["--kind", "hands", "--hands", HANDS[opener], "--line", line] };
|
|
353
371
|
}
|
|
354
372
|
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
const
|
|
359
|
-
if (
|
|
360
|
-
ev.need(
|
|
361
|
-
return;
|
|
373
|
+
// The comment `dispatch-prompt.mjs render relabel` renders for a bail, or null
|
|
374
|
+
// when there is none (the NEED, named `what`, is printed here).
|
|
375
|
+
function rendered(ev, ticket, cause, detail, what) {
|
|
376
|
+
const relabel = relabelArgs(cause, detail);
|
|
377
|
+
if (relabel.why !== undefined) {
|
|
378
|
+
ev.need(`${what} #${ticket} — ${relabel.why}: comment the cause by hand`);
|
|
379
|
+
return null;
|
|
362
380
|
}
|
|
363
|
-
const
|
|
381
|
+
const r = node("dispatch-prompt.mjs", ["render", "relabel", ...relabel.args]);
|
|
382
|
+
if (r.status !== 0) {
|
|
383
|
+
ev.need(`${what} #${ticket} — dispatch-prompt.mjs render relabel refused: ${said(r)}`);
|
|
384
|
+
return null;
|
|
385
|
+
}
|
|
386
|
+
return r.stdout;
|
|
387
|
+
}
|
|
388
|
+
|
|
389
|
+
// Moves #ticket to `label`, then posts the comment `body()` returns, if any.
|
|
390
|
+
// False when the move could not be made, so nothing after it may run.
|
|
391
|
+
function demote(ev, ticket, label, cause, body) {
|
|
364
392
|
const seen = ev.comments("issue", ticket, `relabel #${ticket} ${label}`);
|
|
365
|
-
if (seen === null) return;
|
|
393
|
+
if (seen === null) return false;
|
|
366
394
|
if (seen.labels.includes(label) && !seen.labels.includes("ready-for-agent") && !seen.labels.includes("in-progress")) {
|
|
367
395
|
ev.note(`#${ticket} already ${label}`);
|
|
368
396
|
} else {
|
|
369
397
|
const e = gh(["issue", "edit", String(ticket), "--remove-label", "ready-for-agent", "--remove-label", "in-progress", "--add-label", label]);
|
|
370
398
|
if (e.status !== 0) {
|
|
371
399
|
ev.need(`relabel #${ticket} ${label} — gh issue edit failed: ${said(e)}`);
|
|
372
|
-
return;
|
|
400
|
+
return false;
|
|
373
401
|
}
|
|
374
402
|
ev.note(`relabelled #${ticket} ${label} (${cause})`);
|
|
375
403
|
}
|
|
376
|
-
const
|
|
377
|
-
if (
|
|
378
|
-
|
|
404
|
+
const text = body();
|
|
405
|
+
if (text !== null) ev.comment("issue", ticket, text, seen, "relabel comment");
|
|
406
|
+
return true;
|
|
407
|
+
}
|
|
408
|
+
|
|
409
|
+
// A `fixed` bail: closed when its commit is on origin/main, demoted to
|
|
410
|
+
// `needs-triage` when it is not, untouched when that cannot be told. False
|
|
411
|
+
// when the claim must not be released.
|
|
412
|
+
function fixed(ev, ticket, detail) {
|
|
413
|
+
const sha = FIXED_SHA.exec(String(detail ?? "").trim())?.[1];
|
|
414
|
+
if (sha === undefined) {
|
|
415
|
+
ev.need(`close #${ticket} — the report's bailDetail opens with no commit sha: check the fix on origin/main and close or relabel by hand`);
|
|
416
|
+
return false;
|
|
417
|
+
}
|
|
418
|
+
const v = run("sh", [join(SCRIPTS, "verify-sha.sh"), "main", sha]);
|
|
419
|
+
if (v.status === 1) {
|
|
420
|
+
return demote(ev, ticket, "needs-triage", "fixed", () => `*Relabelled by the fleet controller.* Pulled for implementation and returned as already fixed by ${sha}: ${sha} not on origin/main.`);
|
|
421
|
+
}
|
|
422
|
+
if (v.status !== 0) {
|
|
423
|
+
ev.need(`close #${ticket} — verify-sha.sh main ${sha} could not answer (${v.how}): ${said(v)}`);
|
|
424
|
+
return false;
|
|
425
|
+
}
|
|
426
|
+
const body = rendered(ev, ticket, "fixed", detail, "close-comment");
|
|
427
|
+
if (body === null) return false;
|
|
428
|
+
const seen = ev.comments("issue", ticket, `close #${ticket}`);
|
|
429
|
+
if (seen === null) return false;
|
|
430
|
+
if (seen.state === "CLOSED") {
|
|
431
|
+
ev.note(`#${ticket} already closed`);
|
|
379
432
|
} else {
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
433
|
+
// A comment that landed before its close failed is not posted twice.
|
|
434
|
+
const c = gh(["issue", "close", String(ticket), ...(seen.bodies.includes(body.trim()) ? [] : ["--comment", body])]);
|
|
435
|
+
if (c.status !== 0) {
|
|
436
|
+
ev.need(`close #${ticket} — gh issue close failed: ${said(c)}`);
|
|
437
|
+
return false;
|
|
438
|
+
}
|
|
439
|
+
ev.note(`closed #${ticket}: fixed by ${sha}`);
|
|
440
|
+
}
|
|
441
|
+
const stale = ["ready-for-agent", "in-progress"].filter((l) => seen.labels.includes(l));
|
|
442
|
+
if (stale.length > 0) {
|
|
443
|
+
const e = gh(["issue", "edit", String(ticket), ...stale.flatMap((l) => ["--remove-label", l])]);
|
|
444
|
+
if (e.status !== 0) ev.need(`unlabel #${ticket} ${stale.join(" ")} — gh issue edit failed: ${said(e)}`);
|
|
445
|
+
}
|
|
446
|
+
return true;
|
|
447
|
+
}
|
|
448
|
+
|
|
449
|
+
function bailed(ev, member) {
|
|
450
|
+
const ticket = parseMember(member).number;
|
|
451
|
+
const read = ev.report(member);
|
|
452
|
+
const cause = read.state === "ok" ? read.report.bailCause : null;
|
|
453
|
+
if (!Object.hasOwn(BAILS, cause ?? "")) {
|
|
454
|
+
ev.need(`relabel #${ticket} — ${member}'s report ${read.path} is ${read.state === "ok" ? `missing a bailCause` : read.state}: relabel by its cause by hand`);
|
|
455
|
+
return;
|
|
383
456
|
}
|
|
457
|
+
const detail = read.report.bailDetail;
|
|
458
|
+
const moved = cause === "fixed"
|
|
459
|
+
? fixed(ev, ticket, detail)
|
|
460
|
+
: demote(ev, ticket, BAILS[cause].label, cause, () => rendered(ev, ticket, cause, detail, "relabel-comment"));
|
|
461
|
+
if (!moved) return;
|
|
384
462
|
const release = run("sh", [join(SCRIPTS, "release-ticket.sh"), String(ticket), `impl-${ticket}`, "implementer", "--apply"]);
|
|
385
463
|
if (release.status === 0) ev.note(`released #${ticket}`);
|
|
386
464
|
else ev.need(`hand-release #${ticket} ${blocker(release)}`);
|
|
@@ -109,7 +109,7 @@ export const SCHEMAS = {
|
|
|
109
109
|
{ verdict: { type: "string", enum: ["light", "heavy"] }, signal: str, ranBeforePr: { type: "boolean" } },
|
|
110
110
|
["object", "null"],
|
|
111
111
|
),
|
|
112
|
-
bailCause: { type: ["string", "null"], enum: ["undecided", "fork", "hands", null] },
|
|
112
|
+
bailCause: { type: ["string", "null"], enum: ["undecided", "fork", "hands", "fixed", "covered", null] },
|
|
113
113
|
bailDetail: { type: ["string", "null"] },
|
|
114
114
|
confirmation: strings,
|
|
115
115
|
}),
|
package/skills/run-team/SKILL.md
CHANGED
|
@@ -1079,23 +1079,18 @@ Each rule here is a judgement a driver stops for: answer it by the cause it name
|
|
|
1079
1079
|
### Relabel causes
|
|
1080
1080
|
|
|
1081
1081
|
- **Implementer bails before implementing** → `fleet-event.mjs impl-report impl-<N>`
|
|
1082
|
-
settles `impl-<N>=bailed` and
|
|
1082
|
+
settles `impl-<N>=bailed` and acts by `bailCause`, never by parsing `bailDetail`; no cause opens a PR:
|
|
1083
1083
|
|
|
1084
|
-
| Cause |
|
|
1085
|
-
|
|
1086
|
-
| brief does not decide *what* to build | `needs-triage` |
|
|
1087
|
-
| genuine fork — options named, none ruled | `ready-for-human` |
|
|
1088
|
-
| needs human hands — external access, manual testing, judgment during the work | `ready-for-human` |
|
|
1084
|
+
| Cause | `bailCause` | `bailDetail` format | Issue action | Ledger |
|
|
1085
|
+
|---|---|---|---|---|
|
|
1086
|
+
| brief does not decide *what* to build | `undecided` | `<one line>` | relabel `needs-triage` | `=bailed` |
|
|
1087
|
+
| genuine fork — options named, none ruled | `fork` | `<options>` | relabel `ready-for-human` | `=bailed` |
|
|
1088
|
+
| needs human hands — external access, manual testing, judgment during the work | `hands` | `<cause>: <line>` | relabel `ready-for-human` | `=bailed` |
|
|
1089
|
+
| already fixed on main | `fixed` | `<sha> — <how origin/main's tree meets the acceptance>` | `verify-sha.sh main <sha>` first. Exit 0: close N with the `fixed` comment (quotes `bailDetail`), drop `ready-for-agent`, release the claim (drops `in-progress`); no label. Exit 1: relabel `needs-triage`, comment `<sha> not on origin/main`. Exit 2: `NEED`, N untouched. | `=bailed` |
|
|
1090
|
+
| covered by an open PR M | `covered` | `PR#M — <how M's diff meets N's acceptance>` | relabel `ready-for-human` with the `covered` comment: close N when M merges, or restore `ready-for-agent` if M closes unmerged. PR M's body is never edited. | `=bailed` |
|
|
1089
1091
|
|
|
1090
|
-
The call
|
|
1092
|
+
The call comments the cause and releases the claim — never when `fixed` neither closes nor relabels N — then ticks:
|
|
1091
1093
|
the head the tick names next is a *different* ticket.
|
|
1092
|
-
`needs-triage` routes back to `/triage`, which can return it as
|
|
1093
|
-
`ready-for-agent`; `ready-for-human` for hands or a fork; `needs-triage` for a
|
|
1094
|
-
brief that names no *what*.
|
|
1095
|
-
|
|
1096
|
-
The same causes relabel an unclaimed ticket at the Pull (phase 1), where there
|
|
1097
|
-
is no `in-progress` to drop — the causes and labels are one table, applied at
|
|
1098
|
-
whichever point the ticket fails them.
|
|
1099
1094
|
|
|
1100
1095
|
### Resolving a finisher halt
|
|
1101
1096
|
|
|
@@ -1303,7 +1298,7 @@ owes beyond its call:
|
|
|
1303
1298
|
and the tick prints no dispatch for it. The cockpit flags the PR
|
|
1304
1299
|
`finisher:failed` / `finisher:killed` at severity 4 and you resolve it by hand
|
|
1305
1300
|
(**Resolving a finisher that died**, above), then run the tick.
|
|
1306
|
-
- **Implementer bails before implementing** → `fleet-event.mjs impl-report impl-<N>`; the causes and the
|
|
1301
|
+
- **Implementer bails before implementing** → `fleet-event.mjs impl-report impl-<N>`; the causes and the issue action each takes are under **Relabel causes**.
|
|
1307
1302
|
- **A review result lands** → see the result file written (by you or by the
|
|
1308
1303
|
runner — **Reviewers** says which, per harness), then
|
|
1309
1304
|
`fleet-event.mjs review-result <pr> <path>`: a PR with survived or unverified findings prints as
|
|
@@ -2338,17 +2333,6 @@ or even see it — `worktree-audit.sh`'s committed-vs-uncommitted split is exact
|
|
|
2338
2333
|
what decides whether a replacement redoes or destroys work. Observed twice in
|
|
2339
2334
|
one run.
|
|
2340
2335
|
|
|
2341
|
-
**The identity block is what makes `sizing-a-ticket`'s fleet entry reachable.**
|
|
2342
|
-
That skill conditions its heavy-row process on the reader being a fleet member;
|
|
2343
|
-
a solo reader settles the open design choices with its user before planning,
|
|
2344
|
-
while a fleet member's `## Agent Brief` already is that settlement. A member
|
|
2345
|
-
that takes itself for a solo session waits on a user to settle design — a user
|
|
2346
|
-
no unattended member has, so it parks rather
|
|
2347
|
-
than fails. Nothing else you carry says what the member is — an incidental
|
|
2348
|
-
mention of the controller is not a statement that the reader is one of its
|
|
2349
|
-
members. That skill keeps its condition, so a solo session still runs the
|
|
2350
|
-
interactive path; this block is what puts a member on the fleet side of it.
|
|
2351
|
-
|
|
2352
2336
|
A member that bails demotes nothing itself; demotion by cause is yours
|
|
2353
2337
|
(**Implementer bails before implementing**).
|
|
2354
2338
|
|
|
@@ -2606,7 +2590,7 @@ Match the failure to its row in the table below and run that response; where the
|
|
|
2606
2590
|
| Failure | Response |
|
|
2607
2591
|
|---|---|
|
|
2608
2592
|
| SHA not on expected branch | Flag, do not enqueue, report |
|
|
2609
|
-
| Implementer bails before implementing |
|
|
2593
|
+
| Implementer bails before implementing | Act by the report's `bailCause` as the **Relabel causes** table says, then refill (phase 3) |
|
|
2610
2594
|
| Implementer blocked or ambiguous *mid-implementation* | Free the slot, `ledger.mjs settle impl-<N> blocked`, leave `in-progress`, report — the ticket is not In flight and waits for a human; the row above is the pre-code bail, not this one |
|
|
2611
2595
|
| `review-pr` workflow throws or returns no tree | Retry once under the next letter (`review-pr-<pr#>-b`); still failing, report and leave the PR at review-due. Never enqueue the PR as reviewed — the workflow is not a member, so no other row here covers it |
|
|
2612
2596
|
| Reviewer, fix-applier or red-check fixer cannot reach green | Report, leave the PR unlabeled, free the slot — a fix-applier or red-check fixer settles `failed` |
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
arg line one line
|
|
3
3
|
arg options options
|
|
4
4
|
arg hands hands
|
|
5
|
+
arg detail detail
|
|
5
6
|
---
|
|
6
7
|
## kind: needs-triage
|
|
7
8
|
*Relabelled by the fleet controller.* Pulled for implementation and
|
|
@@ -13,3 +14,11 @@ returned: the brief leaves a decision open. Open fork: <options>.
|
|
|
13
14
|
## kind: hands
|
|
14
15
|
*Relabelled by the fleet controller.* Pulled for implementation and
|
|
15
16
|
returned: needs human hands — <hands>: <one line>.
|
|
17
|
+
## kind: covered
|
|
18
|
+
*Relabelled by the fleet controller.* Pulled for implementation and
|
|
19
|
+
returned: an open pull request already covers it — <detail>. Close this
|
|
20
|
+
issue when that pull request merges, or restore `ready-for-agent` if it
|
|
21
|
+
closes unmerged.
|
|
22
|
+
## kind: fixed
|
|
23
|
+
*Closed by the fleet controller.* Pulled for implementation and found
|
|
24
|
+
already fixed on origin/main: <detail>.
|
|
@@ -390,6 +390,17 @@ own ticket** — one's acceptance criterion went unmet, and the other three left
|
|
|
390
390
|
the named defect reachable by a sibling spelling. Every one was caught by
|
|
391
391
|
review, at review cost, which runs 3-5x the implementation it checks.
|
|
392
392
|
|
|
393
|
+
**The identity block is what makes `sizing-a-ticket`'s fleet entry reachable.**
|
|
394
|
+
That skill conditions its heavy-row process on the reader being a fleet member;
|
|
395
|
+
a solo reader settles the open design choices with its user before planning,
|
|
396
|
+
while a fleet member's `## Agent Brief` already is that settlement. A member
|
|
397
|
+
that takes itself for a solo session waits on a user to settle design — a user
|
|
398
|
+
no unattended member has, so it parks rather
|
|
399
|
+
than fails. Nothing else you carry says what the member is — an incidental
|
|
400
|
+
mention of the controller is not a statement that the reader is one of its
|
|
401
|
+
members. That skill keeps its condition, so a solo session still runs the
|
|
402
|
+
interactive path; this block is what puts a member on the fleet side of it.
|
|
403
|
+
|
|
393
404
|
## Default: In-flight bound 5
|
|
394
405
|
|
|
395
406
|
**Default: In-flight bound 5, fixed for the run.** The level is set by load, not
|