agent-bober 0.17.1 → 0.19.0

package/dist/do-bridge/promote.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Promotion gate orchestration — write pending marker, resolve approve/reject,
+ * then on approval call launch; on rejection clean up and return.
+ *
+ * PURE-ish DI core: all I/O via injected projectRoot paths + approval-state.ts
+ * functions + injected confirm / now / launcher. Never reads the real clock
+ * (now is injected). Never throws — failures propagate as Promise rejections
+ * which the caller (runDo) converts to process.exitCode = 1.
+ */
+import type { PromotionPlan } from "./types.js";
+/** Result returned by runPromotionGate after the approve/reject decision. */
+export interface GateOutcome {
+    approved: boolean;
+}
+/** Arguments for runPromotionGate — all I/O dependencies are injected. */
+export interface PromotionGateArgs {
+    /** Absolute project root (used to build .bober/approvals paths). */
+    projectRoot: string;
+    /** Finding id — used to derive checkpointId `promote-<findingId>`. */
+    findingId: string;
+    /** The promotion plan to summarize in the pending marker. */
+    plan: PromotionPlan;
+    /** When true, bypass interactive prompt and auto-approve. */
+    yes?: boolean;
+    /**
+     * Whether stdout is a TTY. When true and not --yes, calls the injected
+     * confirm() and waits for a synchronous answer. When false, polls the
+     * approvals directory until an external approve/reject marker appears.
+     */
+    isTTY: boolean;
+    /** Injected interactive confirm. TTY path only; must return true/false. */
+    confirm: () => Promise<boolean>;
+    /** Clock injection — returns an ISO string. */
+    now: () => string;
+    /** Non-TTY poll interval in ms. Default 2000ms; use small values in tests. */
+    pollMs?: number;
+    /** Non-TTY timeout in ms. Default 24 hours. */
+    timeoutMs?: number;
+}
+/**
+ * Write promote-<findingId>.pending.json, gate on it
+ * (--yes → auto-approve; TTY → prompts(); non-TTY → poll directory),
+ * and return { approved }.
+ *
+ * Writes/deletes markers via approval-state.ts only — no new format.
+ * checkpointId is always `promote-${findingId}` so external
+ * `bober approve promote-<id>` resolves it (sc-2-5).
+ */
+export declare function runPromotionGate(args: PromotionGateArgs): Promise<GateOutcome>;
+//# sourceMappingURL=promote.d.ts.map

package/dist/do-bridge/promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../src/do-bridge/promote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,IAAI,EAAE,aAAa,CAAC;IACpB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiHpF"}

package/dist/do-bridge/promote.js

@@ -0,0 +1,116 @@
+/**
+ * Promotion gate orchestration — write pending marker, resolve approve/reject,
+ * then on approval call launch; on rejection clean up and return.
+ *
+ * PURE-ish DI core: all I/O via injected projectRoot paths + approval-state.ts
+ * functions + injected confirm / now / launcher. Never reads the real clock
+ * (now is injected). Never throws — failures propagate as Promise rejections
+ * which the caller (runDo) converts to process.exitCode = 1.
+ */
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { savePending, saveApproved, saveRejected, deletePending, } from "../state/approval-state.js";
+/**
+ * Write promote-<findingId>.pending.json, gate on it
+ * (--yes → auto-approve; TTY → prompts(); non-TTY → poll directory),
+ * and return { approved }.
+ *
+ * Writes/deletes markers via approval-state.ts only — no new format.
+ * checkpointId is always `promote-${findingId}` so external
+ * `bober approve promote-<id>` resolves it (sc-2-5).
+ */
+export async function runPromotionGate(args) {
+    const { projectRoot, findingId, plan, yes = false, isTTY, confirm, now, pollMs = 2_000, timeoutMs = 24 * 60 * 60 * 1_000, } = args;
+    const checkpointId = `promote-${findingId}`;
+    const requestedAt = now();
+    const requestedAtMs = Date.parse(requestedAt);
+    const timeoutAt = new Date(requestedAtMs + timeoutMs).toISOString();
+    // 1. Write the pending marker
+    await savePending(projectRoot, {
+        checkpointId,
+        artifact: { type: "bober-run", summary: plan.task },
+        prompt: `Promote to bober run: "${plan.task}"`,
+        requestedAt,
+        timeoutAt,
+    });
+    // 2. --yes: auto-approve without prompting
+    if (yes) {
+        await saveApproved(projectRoot, checkpointId, {
+            approvedAt: now(),
+            approverId: "auto",
+        });
+        await deletePending(projectRoot, checkpointId);
+        return { approved: true };
+    }
+    // 3. TTY: interactive confirm
+    if (isTTY) {
+        const confirmed = await confirm();
+        if (confirmed) {
+            await saveApproved(projectRoot, checkpointId, {
+                approvedAt: now(),
+                approverId: "tty",
+            });
+            await deletePending(projectRoot, checkpointId);
+            return { approved: true };
+        }
+        else {
+            await saveRejected(projectRoot, checkpointId, {
+                rejectedAt: now(),
+                rejecterId: "tty",
+                feedback: "User declined at TTY prompt",
+            });
+            await deletePending(projectRoot, checkpointId);
+            return { approved: false };
+        }
+    }
+    // 4. Non-TTY: poll the approvals directory until resolved or timeout
+    //    Mirror: src/orchestrator/checkpoints/mechanisms/disk.ts:104-175
+    //    Use Date.now() for elapsed-time tracking (not the injected `now` which is
+    //    for file timestamps only and may be frozen in tests).
+    const approvalsDir = join(projectRoot, ".bober", "approvals");
+    const startedAtMs = Date.now();
+    let pollHandle;
+    try {
+        return await new Promise((resolve, reject) => {
+            const tick = async () => {
+                try {
+                    const entries = new Set(await readdir(approvalsDir).catch(() => []));
+                    if (entries.has(`${checkpointId}.approved.json`)) {
+                        await deletePending(projectRoot, checkpointId);
+                        resolve({ approved: true });
+                        return;
+                    }
+                    if (entries.has(`${checkpointId}.rejected.json`)) {
+                        await deletePending(projectRoot, checkpointId);
+                        resolve({ approved: false });
+                        return;
+                    }
+                    // Timeout check (wall clock — not the injected now() which is for file timestamps)
+                    if (Date.now() - startedAtMs >= timeoutMs) {
+                        await deletePending(projectRoot, checkpointId);
+                        resolve({ approved: false });
+                        return;
+                    }
+                    // Schedule next tick — never leak timers (disk.ts:170-175)
+                    pollHandle = setTimeout(() => {
+                        tick().catch(reject);
+                    }, pollMs);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            };
+            // Kick off the first tick
+            pollHandle = setTimeout(() => {
+                tick().catch(reject);
+            }, pollMs);
+        });
+    }
+    finally {
+        // Always clear the handle — covers the resolved-before-tick case
+        if (pollHandle !== undefined) {
+            clearTimeout(pollHandle);
+        }
+    }
+}
+//# sourceMappingURL=promote.js.map

package/dist/do-bridge/promote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.js","sourceRoot":"","sources":["../../src/do-bridge/promote.ts"],"names":[],"mappings":"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"}

package/dist/do-bridge/reconcile.d.ts

@@ -0,0 +1,50 @@
+import type { FindingStore } from "./finding-port.js";
+import type { RunState } from "../mcp/run-manager.js";
+/**
+ * Injected dependencies for reconcilePromotions.
+ * Keeps the core pure so tests can inject a run-state fake without a real run.
+ */
+export interface ReconcileDeps {
+    store: FindingStore;
+    /**
+     * Injected run-state reader.
+     * CLI passes `(runId) => readRunState(projectRoot, runId)`.
+     * Tests inject a fake that returns a predetermined RunState or null.
+     */
+    readState: (runId: string) => Promise<RunState | null>;
+    /** Clock injection — never call new Date() inside the core. */
+    now: () => string;
+}
+/** Counts of findings advanced in a single reconcilePromotions pass. */
+export interface ReconcileSummary {
+    /** Findings transitioned to 'done' (run completed). */
+    completed: number;
+    /** Findings returned to 'open' (run aborted or failed). */
+    aborted: number;
+    /** Findings left unchanged (run still running, missing, or unrecognised). */
+    unchanged: number;
+}
+/**
+ * For each Finding whose promotesTo.status is 'launched', read the linked
+ * run's state.json snapshot and advance the Finding to its terminal status.
+ *
+ * Transition table:
+ *   run 'completed'          → finding 'done',  promotesTo.status 'completed'
+ *   run 'aborted'|'failed'   → finding 'open',  promotesTo.status 'aborted'
+ *   run 'running' (or null)  → finding unchanged (no write)
+ *
+ * PURE-ish: all I/O is injected. Never throws — per-finding failures are
+ * swallowed internally. Reads the current snapshot and returns immediately;
+ * does NOT poll or block waiting for an in-flight run to finish.
+ */
+export declare function reconcilePromotions(deps: ReconcileDeps): Promise<ReconcileSummary>;
+/**
+ * Thin wrapper around reconcilePromotions that injects the real readRunState
+ * adapter for a given project root. Called by the `bober do` CLI handler.
+ *
+ * Caller is responsible for wrapping this in try/catch so a reconcile failure
+ * can never abort the enclosing command (mirrors seedProjectFacts in
+ * src/orchestrator/pipeline.ts:981).
+ */
+export declare function reconcilePromotionsForRoot(projectRoot: string, store: FindingStore, now: () => string): Promise<ReconcileSummary>;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/do-bridge/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/do-bridge/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACvD,+DAA+D;IAC/D,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAID,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuCxF;AAID;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,MAAM,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}

package/dist/do-bridge/reconcile.js

@@ -0,0 +1,70 @@
+import { readRunState } from "../state/run-state.js";
+// ── reconcilePromotions (DI core) ─────────────────────────────────────
+/**
+ * For each Finding whose promotesTo.status is 'launched', read the linked
+ * run's state.json snapshot and advance the Finding to its terminal status.
+ *
+ * Transition table:
+ *   run 'completed'          → finding 'done',  promotesTo.status 'completed'
+ *   run 'aborted'|'failed'   → finding 'open',  promotesTo.status 'aborted'
+ *   run 'running' (or null)  → finding unchanged (no write)
+ *
+ * PURE-ish: all I/O is injected. Never throws — per-finding failures are
+ * swallowed internally. Reads the current snapshot and returns immediately;
+ * does NOT poll or block waiting for an in-flight run to finish.
+ */
+export async function reconcilePromotions(deps) {
+    const { store, readState, now } = deps;
+    const summary = { completed: 0, aborted: 0, unchanged: 0 };
+    const promoted = await store.listPromoted();
+    const launched = promoted.filter((f) => f.promotesTo?.status === "launched");
+    for (const finding of launched) {
+        try {
+            // promotesTo is guaranteed non-undefined by the filter above
+            const ref = finding.promotesTo;
+            const state = await readState(ref.runId);
+            if (state === null) {
+                // Missing or corrupt run-state file → treat as "still running"
+                summary.unchanged++;
+                continue;
+            }
+            if (state.status === "completed") {
+                const updatedRef = { ...ref, status: "completed" };
+                await store.applyOutcome(finding.id, "done", updatedRef, { now: now() });
+                summary.completed++;
+            }
+            else if (state.status === "aborted" || state.status === "failed") {
+                const updatedRef = { ...ref, status: "aborted" };
+                await store.applyOutcome(finding.id, "open", updatedRef, { now: now() });
+                summary.aborted++;
+            }
+            else {
+                // 'running', 'input-required', 'paused' — leave unchanged
+                summary.unchanged++;
+            }
+        }
+        catch {
+            // Per-finding error: swallow and count as unchanged (belt and suspenders).
+            // reconcilePromotions MUST NOT throw.
+            summary.unchanged++;
+        }
+    }
+    return summary;
+}
+// ── reconcilePromotionsForRoot (CLI wrapper) ──────────────────────────
+/**
+ * Thin wrapper around reconcilePromotions that injects the real readRunState
+ * adapter for a given project root. Called by the `bober do` CLI handler.
+ *
+ * Caller is responsible for wrapping this in try/catch so a reconcile failure
+ * can never abort the enclosing command (mirrors seedProjectFacts in
+ * src/orchestrator/pipeline.ts:981).
+ */
+export async function reconcilePromotionsForRoot(projectRoot, store, now) {
+    return reconcilePromotions({
+        store,
+        readState: (runId) => readRunState(projectRoot, runId),
+        now,
+    });
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/do-bridge/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../src/do-bridge/reconcile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAiCrD,yEAAyE;AAEzE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAmB;IAC3D,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACvC,MAAM,OAAO,GAAqB,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAE7E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC;IAE7E,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,6DAA6D;YAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,UAA0B,CAAC;YAC/C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAEzC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,+DAA+D;gBAC/D,OAAO,CAAC,SAAS,EAAE,CAAC;gBACpB,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACjC,MAAM,UAAU,GAAiB,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;gBACjE,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;gBACzE,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACnE,MAAM,UAAU,GAAiB,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;gBAC/D,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;gBACzE,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,0DAA0D;gBAC1D,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;YAC3E,sCAAsC;YACtC,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yEAAyE;AAEzE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAAmB,EACnB,KAAmB,EACnB,GAAiB;IAEjB,OAAO,mBAAmB,CAAC;QACzB,KAAK;QACL,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC;QACtD,GAAG;KACJ,CAAC,CAAC;AACL,CAAC"}

package/dist/do-bridge/registry.d.ts

@@ -0,0 +1,23 @@
+import type { PromoterKey, Promoter } from "./types.js";
+/**
+ * Registry of Promoters keyed by PromoterKey {domain, kind?}.
+ *
+ * Resolution precedence (sc-1-2):
+ *   1. domain+kind specific match
+ *   2. domain-only fallback
+ *   3. undefined — the CLI handler converts this to process.exitCode=1 (sc-1-5)
+ *
+ * resolve() returns undefined (never throws) for unsupported domains.
+ * Modelled on src/orchestrator/checkpoints/registry.ts keyed-registry pattern.
+ */
+export declare class PromoterRegistry {
+    private readonly map;
+    /** Register a Promoter under the given key. Overwrites any prior registration. */
+    register(key: PromoterKey, promoter: Promoter): void;
+    /**
+     * Resolve the Promoter for a given key.
+     * Tries domain+kind first; falls back to domain-only; returns undefined if neither exists.
+     */
+    resolve(key: PromoterKey): Promoter | undefined;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/do-bridge/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/do-bridge/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmBxD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+B;IAEnD,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIpD;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS;CAKhD"}

package/dist/do-bridge/registry.js

@@ -0,0 +1,42 @@
+// ── Key serialization ─────────────────────────────────────────────────
+/**
+ * Serialize a PromoterKey to a Map-lookup string.
+ * Domain+kind and domain-only never collide because kind is separated by
+ * a space that domain-only registrations leave as an empty suffix.
+ *
+ * Examples:
+ *   {domain:"coding", kind:"action"} → "coding action"
+ *   {domain:"coding"}               → "coding "        (trailing space = domain-only)
+ */
+function serializeKey(key) {
+    return `${key.domain} ${key.kind ?? ""}`;
+}
+// ── PromoterRegistry ──────────────────────────────────────────────────
+/**
+ * Registry of Promoters keyed by PromoterKey {domain, kind?}.
+ *
+ * Resolution precedence (sc-1-2):
+ *   1. domain+kind specific match
+ *   2. domain-only fallback
+ *   3. undefined — the CLI handler converts this to process.exitCode=1 (sc-1-5)
+ *
+ * resolve() returns undefined (never throws) for unsupported domains.
+ * Modelled on src/orchestrator/checkpoints/registry.ts keyed-registry pattern.
+ */
+export class PromoterRegistry {
+    map = new Map();
+    /** Register a Promoter under the given key. Overwrites any prior registration. */
+    register(key, promoter) {
+        this.map.set(serializeKey(key), promoter);
+    }
+    /**
+     * Resolve the Promoter for a given key.
+     * Tries domain+kind first; falls back to domain-only; returns undefined if neither exists.
+     */
+    resolve(key) {
+        const specificKey = serializeKey(key);
+        const domainOnlyKey = serializeKey({ domain: key.domain });
+        return this.map.get(specificKey) ?? this.map.get(domainOnlyKey);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/do-bridge/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/do-bridge/registry.ts"],"names":[],"mappings":"AAEA,yEAAyE;AAEzE;;;;;;;;GAQG;AACH,SAAS,YAAY,CAAC,GAAgB;IACpC,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AAC3C,CAAC;AAED,yEAAyE;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IACV,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEnD,kFAAkF;IAClF,QAAQ,CAAC,GAAgB,EAAE,QAAkB;QAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,GAAgB;QACtB,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,aAAa,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/do-bridge/types.d.ts

@@ -0,0 +1,50 @@
+import type { Finding } from "../hub/finding.js";
+/** Mirror of Finding["kind"] — derived, never redefined. */
+export type FindingKind = Finding["kind"];
+/**
+ * Registry lookup key for a Promoter.
+ * domain is required; kind is optional so domain-only registrations
+ * serve as a fallback for any kind within that domain.
+ */
+export interface PromoterKey {
+    domain: string;
+    kind?: FindingKind;
+}
+/**
+ * Rich plan returned by a Promoter — what would be launched.
+ * kind='bober-run' is a discriminant; Sprint 2 may add more plan kinds.
+ * PURE: no I/O encoded here — just data.
+ */
+export interface PromotionPlan {
+    kind: "bober-run";
+    /** The one-line task string that bober run would receive. */
+    task: string;
+    /** Optional target team id; undefined means the default team. */
+    teamId?: string;
+}
+/**
+ * Structured ref written to Finding.promotesTo after a real launch.
+ *
+ * On-disk: serialized to a JSON string (Finding.promotesTo is z.string()).
+ * In-process (via FindingStore port): callers receive this object shape.
+ * Use serializePromotionRef / parsePromotionRef to cross the boundary.
+ */
+export interface PromotionRef {
+    kind: "bober-run";
+    runId: string;
+    launchedAt: string;
+    status: "launched" | "completed" | "aborted";
+}
+/** Serialize a PromotionRef to a JSON string for on-disk storage. */
+export declare function serializePromotionRef(ref: PromotionRef): string;
+/**
+ * Parse a PromotionRef from a JSON string.
+ * Returns null on parse failure or missing required fields.
+ */
+export declare function parsePromotionRef(s: string): PromotionRef | null;
+/**
+ * A Promoter converts a Finding into a PromotionPlan.
+ * PURE: no I/O — all input comes from the finding.
+ */
+export type Promoter = (finding: Finding) => PromotionPlan;
+//# sourceMappingURL=types.d.ts.map

package/dist/do-bridge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/do-bridge/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAI1C;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAID;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;CAC9C;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMhE;AAID;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,CAAC"}

package/dist/do-bridge/types.js

@@ -0,0 +1,17 @@
+/** Serialize a PromotionRef to a JSON string for on-disk storage. */
+export function serializePromotionRef(ref) {
+    return JSON.stringify(ref);
+}
+/**
+ * Parse a PromotionRef from a JSON string.
+ * Returns null on parse failure or missing required fields.
+ */
+export function parsePromotionRef(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/do-bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/do-bridge/types.ts"],"names":[],"mappings":"AAkDA,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,GAAiB;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAS;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAiB,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/fleet/child-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"child-config.d.ts","sourceRoot":"","sources":["../../src/fleet/child-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAUhD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAwB/D"}
+{"version":3,"file":"child-config.d.ts","sourceRoot":"","sources":["../../src/fleet/child-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAWhD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CA+B/D"}

package/dist/fleet/child-config.js

@@ -1,4 +1,5 @@
 import { BoberConfigSchema, createDefaultConfig } from "../config/schema.js";
+import { tierPolicy } from "./tier-policy.js";
 // ── DeepSeek / openai-compat constants ──────────────────────────────
 const DEEPSEEK_PROVIDER = "openai-compat";
 const DEEPSEEK_ENDPOINT = "https://api.deepseek.com";
@@ -32,6 +33,12 @@ export function buildChildConfig(child) {
         provider: DEEPSEEK_PROVIDER,
         endpoint: DEEPSEEK_ENDPOINT,
     };
+    const block = tierPolicy.resolveTier(child.tier);
+    if (block) {
+        base.planner = { ...base.planner, ...block.planner };
+        base.generator = { ...base.generator, ...block.generator };
+        base.evaluator = { ...base.evaluator, ...block.evaluator };
+    }
     const merged = { ...base, ...(child.config ?? {}) };
     return BoberConfigSchema.parse(merged);
 }

package/dist/fleet/child-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"child-config.js","sourceRoot":"","sources":["../../src/fleet/child-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI7E,uEAAuE;AAEvE,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAC1C,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AACrD,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEzC,wEAAwE;AAExE;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE7D,IAAI,CAAC,OAAO,GAAG;QACb,GAAG,IAAI,CAAC,OAAO;QACf,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IACF,IAAI,CAAC,SAAS,GAAG;QACf,GAAG,IAAI,CAAC,SAAS;QACjB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IACF,IAAI,CAAC,SAAS,GAAG;QACf,GAAG,IAAI,CAAC,SAAS;QACjB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IAEF,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;IACpD,OAAO,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"child-config.js","sourceRoot":"","sources":["../../src/fleet/child-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,uEAAuE;AAEvE,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAC1C,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AACrD,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEzC,wEAAwE;AAExE;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE7D,IAAI,CAAC,OAAO,GAAG;QACb,GAAG,IAAI,CAAC,OAAO;QACf,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IACF,IAAI,CAAC,SAAS,GAAG;QACf,GAAG,IAAI,CAAC,SAAS;QACjB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IACF,IAAI,CAAC,SAAS,GAAG;QACf,GAAG,IAAI,CAAC,SAAS;QACjB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;QAC3D,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;IACpD,OAAO,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/fleet/coordinator.d.ts

@@ -2,8 +2,14 @@ import type { FleetManifest, FleetChild } from "./manifest.js";
 import type { ScaffoldResult } from "./scaffolder.js";
 import type { ChildSpawnResult } from "./runner.js";
 import type { ChildExecution } from "./types.js";
+import type { SharedBlackboard } from "./shared-blackboard.js";
+/** Optional 3rd param threads the blackboard config into round-1 scaffolding. */
 export interface Scaffolder {
-    scaffold(rootDir: string, child: FleetChild): Promise<ScaffoldResult>;
+    scaffold(rootDir: string, child: FleetChild, blackboard?: {
+        dbPath: string;
+        namespace: string;
+        maxRounds: number;
+    }): Promise<ScaffoldResult>;
 }
 export interface Runner {
     run(spec: {
@@ -20,6 +26,26 @@ export declare class FleetCoordinator {
         runner?: Runner;
     });
     execute(manifest: FleetManifest): Promise<ChildExecution[]>;
+    /**
+     * Run children for up to opts.maxRounds rounds sharing the blackboard.
+     * Round 1 scaffolds each child (writes config.fleet from scaffoldCfg).
+     * Rounds 2..N skip scaffolding entirely and re-spawn via runner only.
+     * Early-stops when a completed round adds zero new 'finding' facts.
+     * Returns the FINAL round's ChildExecution[].
+     */
+    executeRounds(manifest: FleetManifest, blackboard: SharedBlackboard, opts: {
+        maxRounds: number;
+        dbPath: string;
+    }): Promise<{
+        executions: ChildExecution[];
+        roundsRun: number;
+    }>;
+    /**
+     * Round-aware never-reject thunk.
+     * Scaffolds ONLY on round 1 (with optional blackboard config threaded in).
+     * On rounds ≥ 2, skips scaffolding and reuses the round-1 absPath.
+     */
+    private runChildRound;
     private runChild;
 }
 //# sourceMappingURL=coordinator.d.ts.map

package/dist/fleet/coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/fleet/coordinator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzF;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAKzD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YASnD,QAAQ;CAsBvB"}
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/fleet/coordinator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,UAAU,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzF;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAKzD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAUjE;;;;;;OAMG;IACG,aAAa,CACjB,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,gBAAgB,EAC5B,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC;QAAE,UAAU,EAAE,cAAc,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA6B/D;;;;OAIG;YACW,aAAa;YA2Cb,QAAQ;CAsBvB"}

package/dist/fleet/coordinator.js

@@ -1,3 +1,4 @@
+import { resolve } from "node:path";
 import { mapBounded } from "../orchestrator/workflow/scheduler.js";
 import { ChildScaffolder } from "./scaffolder.js";
 import { ChildRunner } from "./runner.js";
@@ -12,6 +13,75 @@ export class FleetCoordinator {
     async execute(manifest) {
         return mapBounded(manifest.children, manifest.concurrency, (child) => this.runChild(manifest.rootDir, child));
     }
+    // ── executeRounds ─────────────────────────────────────────────────
+    /**
+     * Run children for up to opts.maxRounds rounds sharing the blackboard.
+     * Round 1 scaffolds each child (writes config.fleet from scaffoldCfg).
+     * Rounds 2..N skip scaffolding entirely and re-spawn via runner only.
+     * Early-stops when a completed round adds zero new 'finding' facts.
+     * Returns the FINAL round's ChildExecution[].
+     */
+    async executeRounds(manifest, blackboard, opts) {
+        const scaffoldCfg = {
+            dbPath: opts.dbPath,
+            namespace: manifest.blackboard.namespace,
+            maxRounds: opts.maxRounds,
+        };
+        let prevCount = blackboard.readAll().length;
+        let lastExecutions = [];
+        let roundsRun = 0;
+        for (let r = 1; r <= opts.maxRounds; r++) {
+            roundsRun = r;
+            lastExecutions = await mapBounded(manifest.children, manifest.concurrency, (child) => this.runChildRound(manifest.rootDir, child, r, r === 1 ? scaffoldCfg : undefined));
+            const count = blackboard.readAll().length;
+            if (r > 1 && count === prevCount)
+                break; // early-stop: no new findings this round
+            prevCount = count;
+        }
+        return { executions: lastExecutions, roundsRun };
+    }
+    // ── runChildRound ─────────────────────────────────────────────────
+    /**
+     * Round-aware never-reject thunk.
+     * Scaffolds ONLY on round 1 (with optional blackboard config threaded in).
+     * On rounds ≥ 2, skips scaffolding and reuses the round-1 absPath.
+     */
+    async runChildRound(rootDir, child, round, blackboardScaffoldCfg) {
+        try {
+            let scaffold;
+            if (round === 1) {
+                scaffold = await this.scaffolder.scaffold(rootDir, child, blackboardScaffoldCfg);
+                if (scaffold.error) {
+                    return { folder: child.folder, scaffold, spawn: undefined };
+                }
+            }
+            else {
+                // Round ≥ 2: reuse the same absPath the scaffolder computed in round 1.
+                const absPath = resolve(rootDir, child.folder);
+                scaffold = {
+                    folder: child.folder,
+                    absPath,
+                    configWritten: true,
+                    gitInitialized: true,
+                };
+            }
+            const spawn = await this.runner.run({ cwd: scaffold.absPath, task: child.task });
+            return { folder: child.folder, scaffold, spawn };
+        }
+        catch (e) {
+            return {
+                folder: child.folder,
+                scaffold: {
+                    folder: child.folder,
+                    absPath: "",
+                    configWritten: false,
+                    gitInitialized: false,
+                    error: String(e),
+                },
+                spawn: undefined,
+            };
+        }
+    }
     // The never-reject thunk: EVERYTHING (incl. the awaits) is inside try/catch.
     async runChild(rootDir, child) {
         try {

package/dist/fleet/coordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../src/fleet/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB1C,yEAAyE;AAEzE,MAAM,OAAO,gBAAgB;IACV,UAAU,CAAa;IACvB,MAAM,CAAS;IAEhC,YAAY,IAAmD;QAC7D,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,IAAI,eAAe,EAAE,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAuB;QACnC,OAAO,UAAU,CACf,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,WAAW,EACpB,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAClD,CAAC;IACJ,CAAC;IAED,6EAA6E;IACrE,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,KAAiB;QACvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAChE,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC9D,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACjF,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE;oBACR,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,OAAO,EAAE,EAAE;oBACX,aAAa,EAAE,KAAK;oBACpB,cAAc,EAAE,KAAK;oBACrB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;iBACjB;gBACD,KAAK,EAAE,SAAS;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../src/fleet/coordinator.ts"],"names":[],"mappings":"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"}