@feigi/fleet-ctl 3.28.3 → 3.28.5

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@feigi/fleet-ctl",
3
- "version": "3.28.3",
3
+ "version": "3.28.5",
4
4
  "description": "Agent fleet: run-team controller, merge bot, PR reviewer, and the ticket pipeline they share",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -8,7 +8,7 @@
8
8
  // until a human asked why nothing was being implemented. No error, no warning.
9
9
  //
10
10
  // So compute the deficit instead of remembering it. Every wake ends in one
11
- // invocation (spec 2026-09-24 § 6: record, tick, act, beat), and each prints
11
+ // invocation (record, tick, act, beat), and each prints
12
12
  // actual/target and a named ACTION per role — `PULL #<n> #<n>`, `DISPATCH
13
13
  // fix-pr PR#<pr>`, `DISPATCH review PR#<pr>`, `DISPATCH merge-bot`, `HOLD (…)`,
14
14
  // `REFRESHED shortlist: …` — with run-team's guards applied in code rather than
@@ -143,10 +143,10 @@ function implementers(s, left) {
143
143
  `unclaimed=${s.heads.length} supply=${s.supply ?? "?"} unreviewed=${left.unreviewed}`
144
144
  + (s.shortlistStatus === "ok" ? "" : ` shortlist=${s.shortlistStatus}`));
145
145
 
146
- // Drain stops supply and nothing else (spec § 6 §5). Read from the file, so
146
+ // Drain stops supply and nothing else. Read from the file, so
147
147
  // a replacement controller that never saw the drain is held by it too.
148
148
  if (s.draining !== null) return row("HOLD (draining)");
149
- // Held until a replacement at the right tier is dispatched (§ 6 §6). The
149
+ // Held until a replacement at the right tier is dispatched. The
150
150
  // controller can fix this unattended, so the row asks it to — and names the
151
151
  // replacement in its detail, since the step lives otherwise only in
152
152
  // SKILL.md prose, which is what a compaction loses.
@@ -165,7 +165,7 @@ function implementers(s, left) {
165
165
  const deficit = s.implCap - s.implLive;
166
166
  if (deficit <= 0) return row("AT CAP");
167
167
 
168
- // The review-backlog gate, NARROWED (§ 6 §4): more PRs into a review-bound
168
+ // The review-backlog gate, NARROWED: more PRs into a review-bound
169
169
  // pipeline buy nothing — but the pipeline is review-bound only when a PR is
170
170
  // still owed its review after this tick's dispatches AND no reviewer slot is
171
171
  // left for it. A deep backlog with free slots is a reviewer-row DISPATCH on
@@ -877,7 +877,7 @@ export function parseShortlist(text) {
877
877
  return { status: "ok", scanned: d.scanned, entries: d.shortlist.map(({ n, t }) => ({ n, t })) };
878
878
  }
879
879
 
880
- // Why this tick refreshes the shortlist, or null (§ 6 §3). The premise-lifted
880
+ // Why this tick refreshes the shortlist, or null. The premise-lifted
881
881
  // trigger costs gh calls, so main() asks it only when these answer null.
882
882
  export function refreshWhy({ draining, status, entries, unclaimed: k, implCap }) {
883
883
  if (draining !== null) return null;
@@ -1174,7 +1174,7 @@ function finishedReviewPrs(offList) {
1174
1174
  return finished;
1175
1175
  }
1176
1176
 
1177
- // shortlist.mjs, run by the tick itself (§ 6 §3). Its per-ticket stderr is
1177
+ // shortlist.mjs, run by the tick itself. Its per-ticket stderr is
1178
1178
  // captured and dropped rather than billed to the controller's context; only a
1179
1179
  // failure's last line rides along.
1180
1180
  function refresh() {
@@ -90,7 +90,7 @@ export function nextMergeBot(dispatched) {
90
90
 
91
91
  // An implementer cell is `<role>-<level>` — an omp role and a thinking
92
92
  // level — and each cell is one definition, `fleet-implementer-<cell>`, whose
93
- // `model:` is `@<role>:<level>` (spec 2026-09-28 § 2). Nothing is named
93
+ // `model:` is `@<role>:<level>`. Nothing is named
94
94
  // `fleet-implementer` alone, so CELL_DEF is the whole implementer family:
95
95
  // derived from CELL rather than spelled twice, so a level added to one cannot
96
96
  // be missing from the other.
@@ -102,7 +102,7 @@ export const CELL_DEF = new RegExp(`^fleet-implementer-${CELL.source.slice(1)}`)
102
102
  // ticket-router.mjs defaults to the same cell this file maps a bare row to.
103
103
  export const POLICY_CELL = "slow-high";
104
104
 
105
- // The Exploration Pull's draw (spec § 2): uniform over every cell but
105
+ // The Exploration Pull's draw: uniform over every cell but
106
106
  // `policyCell`, keyed off the row's own `session` and `ticket`, so the draw
107
107
  // is reproducible from the row and a re-dispatch of the same ticket in the
108
108
  // same session lands on the same cell. No RNG and no seed token. `k` is the
@@ -1676,10 +1676,10 @@ function runDispatch() {
1676
1676
  // including `nextMergeBot()`'s own read of it.
1677
1677
  refuseMalformedDispatched();
1678
1678
 
1679
- // `merge-bot` bare is the merge-bot case of this command (spec § 4 item 2,
1680
- // which § 6 folds `dispatched` into): the ledger names the bot, 1 + the
1681
- // merge-bot entries already in `## Dispatched`, so the controller never
1682
- // counts. An explicit `merge-bot-<n>` is accepted only when it is that one.
1679
+ // `merge-bot` bare is the merge-bot case of this command: the ledger names
1680
+ // the bot, 1 + the merge-bot entries already in `## Dispatched`, so the
1681
+ // controller never counts. An explicit `merge-bot-<n>` is accepted only
1682
+ // when it is that one.
1683
1683
  const member = parseMember(name === "merge-bot" ? nextMergeBot(data.dispatched) : name);
1684
1684
  if (!member) die(unknownMember(name));
1685
1685
  if (member.bound === null) {
@@ -1693,7 +1693,7 @@ function runDispatch() {
1693
1693
  if (keyNum !== null && !isDigits(keyNum)) die(`'${key}' is not a ticket or PR number`);
1694
1694
 
1695
1695
  // Draining stops supply and nothing else: fix-appliers, finishers and merge
1696
- // bots keep going until the open PRs are merged (spec § 6 §5). Read from
1696
+ // bots keep going until the open PRs are merged. Read from
1697
1697
  // the file, so a replacement controller that never saw the drain is held by
1698
1698
  // it all the same.
1699
1699
  if (member.family === "impl" && data.drain !== null) {
@@ -1712,7 +1712,7 @@ function runDispatch() {
1712
1712
 
1713
1713
  // A replacement (`-b`, `-c` …) works the same ticket or PR as its
1714
1714
  // predecessor: two live tokens for one family+number would double-count
1715
- // liveness ("live implementers = unsettled impl- tokens", spec § 6 §2).
1715
+ // liveness, since live implementers are the unsettled impl- tokens.
1716
1716
  // Checked across both places a token can be live — `## Dispatched` and a
1717
1717
  // row `row` wrote directly — so the refusal holds regardless of which one
1718
1718
  // last wrote it.
@@ -192,7 +192,7 @@ export async function runReviewToFile(args, run = runReviewOnOmp) {
192
192
  return {
193
193
  status: "completed",
194
194
  path,
195
- // Spec § 3 §7's result token, ready for `ledger.mjs row`.
195
+ // The review's result token, ready for `ledger.mjs row`.
196
196
  ledger: `reviewed=${result.head}:${survived}/${refuted}/${unverified}`,
197
197
  attempts: attempt,
198
198
  errors,
@@ -25,7 +25,7 @@
25
25
  // silently (`claude-haiku-4-5` has no `max`, so `@smol:max` would run
26
26
  // at something else), tier-check would then read a level the
27
27
  // definition never declared, and every row the definition ran would
28
- // be inadmissible (spec 2026-09-28 § 2). A target the catalog does
28
+ // be inadmissible. A target the catalog does
29
29
  // not list cannot be checked, so it fails too;
30
30
  // (e) `modelRoles.slow`/`modelRoles.task` resolving to the same model is
31
31
  // flagged as a notice — legal, but every `slow-*` cell then measures
@@ -3308,8 +3308,8 @@ where the controller itself runs from.
3308
3308
  such a PR's review is dispatched by hand.
3309
3309
 
3310
3310
  **Defaults: 2 implementers, 6 reviewers — no hard cap on either.** Reviewer
3311
- slots in use ≈ I·(T_review + 0.94·T_fix)/T_impl ≈ 1.95·I (spec 2026-09-24 § 3
3312
- §3, medians since 2026-08-07: T_impl 19.3 min, T_fix 21.0 min, T_review ~18
3311
+ slots in use ≈ I·(T_review + 0.94·T_fix)/T_impl ≈ 1.95·I (medians since
3312
+ 2026-08-07: T_impl 19.3 min, T_fix 21.0 min, T_review ~18
3313
3313
  min, 0.94 fix-appliers per review), so at the default about four of the six
3314
3314
  are busy, and an idle slot costs nothing. Re-derive it from the map's guard
3315
3315
  once 20 or more PRs have merged under it, never from one run's rows.
@@ -1,17 +0,0 @@
1
- ---
2
- description: Print the exact command to start the fleet run. Does not start it. Use when `run-team` isn't showing up in your picker.
3
- ---
4
-
5
- This command only prints instructions — it never starts the fleet itself.
6
-
7
- `run-team` is a `disable-model-invocation` skill, invoke-only by design (the
8
- fleet writes to a live repo and must never start unasked). That flag also
9
- hides it from the human `/` picker, not just from the model's own
10
- auto-invoke list — so there is nothing to browse to
11
- there.
12
-
13
- To start the fleet, type this exactly — don't pick it from a list, type it:
14
-
15
- /skill:run-team [implementers] [reviewers]
16
-
17
- Both arguments are optional, default 2 implementers and 6 reviewers, with no hard cap. Example: `/skill:run-team 3 2`.