agent-bober 0.12.0 → 0.17.0

package/dist/fleet/aggregator.js

@@ -0,0 +1,39 @@
+import { readRunStatesFromDisk } from "../state/run-state.js";
+// ── Status mapping ────────────────────────────────────────────────────
+function mapStatus(s) {
+    if (s === "completed")
+        return "completed";
+    if (s === "failed" || s === "aborted")
+        return "failed";
+    return "other"; // "running"
+}
+// ── OutcomeAggregator ─────────────────────────────────────────────────
+export class OutcomeAggregator {
+    async aggregate(execution) {
+        const { folder, scaffold, spawn } = execution;
+        // Scaffold failed and no spawn → failed via exit-code source
+        if (scaffold.error && !spawn) {
+            return { folder, status: "failed", source: "exit-code", exitCode: -1 };
+        }
+        try {
+            const states = await readRunStatesFromDisk(scaffold.absPath);
+            if (states.length > 0) {
+                // newest by startedAt — ISO-8601 strings sort lexicographically
+                const newest = states.reduce((a, b) => (b.startedAt > a.startedAt ? b : a));
+                return {
+                    folder,
+                    status: mapStatus(newest.status),
+                    source: "disk",
+                    runId: newest.runId,
+                    runState: newest,
+                };
+            }
+        }
+        catch {
+            // readRunStatesFromDisk already swallows IO/JSON errors; guard anyway → fall through
+        }
+        const code = spawn?.exitCode ?? -1;
+        return { folder, status: code === 0 ? "completed" : "failed", source: "exit-code", exitCode: code };
+    }
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/fleet/aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.js","sourceRoot":"","sources":["../../src/fleet/aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,yEAAyE;AAEzE,SAAS,SAAS,CAAC,CAAqB;IACtC,IAAI,CAAC,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IAC1C,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACvD,OAAO,OAAO,CAAC,CAAC,YAAY;AAC9B,CAAC;AAED,yEAAyE;AAEzE,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,SAAS,CAAC,SAAyB;QACvC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;QAE9C,6DAA6D;QAC7D,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC;QACzE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAe,MAAM,qBAAqB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACzE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,gEAAgE;gBAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5E,OAAO;oBACL,MAAM;oBACN,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;oBAChC,MAAM,EAAE,MAAM;oBACd,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,QAAQ,EAAE,MAAM;iBACjB,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qFAAqF;QACvF,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACtG,CAAC;CACF"}

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

@@ -0,0 +1,12 @@
+import type { BoberConfig } from "../config/schema.js";
+import type { FleetChild } from "./manifest.js";
+/**
+ * Build a Zod-valid BoberConfig for a fleet child process.
+ *
+ * Starts from createDefaultConfig() with the DeepSeek (openai-compat)
+ * provider set on planner, generator, and evaluator, then shallow-merges
+ * child.config top-level keys over the base (a child top-level key fully
+ * replaces the base value — no deep merge).
+ */
+export declare function buildChildConfig(child: FleetChild): BoberConfig;
+//# sourceMappingURL=child-config.d.ts.map

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

@@ -0,0 +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"}

package/dist/fleet/child-config.js

@@ -0,0 +1,38 @@
+import { BoberConfigSchema, createDefaultConfig } from "../config/schema.js";
+// ── DeepSeek / openai-compat constants ──────────────────────────────
+const DEEPSEEK_PROVIDER = "openai-compat";
+const DEEPSEEK_ENDPOINT = "https://api.deepseek.com";
+const DEEPSEEK_MODEL = "deepseek-v4-pro";
+// ── Builder ──────────────────────────────────────────────────────────
+/**
+ * Build a Zod-valid BoberConfig for a fleet child process.
+ *
+ * Starts from createDefaultConfig() with the DeepSeek (openai-compat)
+ * provider set on planner, generator, and evaluator, then shallow-merges
+ * child.config top-level keys over the base (a child top-level key fully
+ * replaces the base value — no deep merge).
+ */
+export function buildChildConfig(child) {
+    const base = createDefaultConfig(child.folder, "greenfield");
+    base.planner = {
+        ...base.planner,
+        model: DEEPSEEK_MODEL,
+        provider: DEEPSEEK_PROVIDER,
+        endpoint: DEEPSEEK_ENDPOINT,
+    };
+    base.generator = {
+        ...base.generator,
+        model: DEEPSEEK_MODEL,
+        provider: DEEPSEEK_PROVIDER,
+        endpoint: DEEPSEEK_ENDPOINT,
+    };
+    base.evaluator = {
+        ...base.evaluator,
+        model: DEEPSEEK_MODEL,
+        provider: DEEPSEEK_PROVIDER,
+        endpoint: DEEPSEEK_ENDPOINT,
+    };
+    const merged = { ...base, ...(child.config ?? {}) };
+    return BoberConfigSchema.parse(merged);
+}
+//# sourceMappingURL=child-config.js.map

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

@@ -0,0 +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"}

package/dist/fleet/coordinator.d.ts

@@ -0,0 +1,25 @@
+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";
+export interface Scaffolder {
+    scaffold(rootDir: string, child: FleetChild): Promise<ScaffoldResult>;
+}
+export interface Runner {
+    run(spec: {
+        cwd: string;
+        task: string;
+        timeoutMs?: number;
+    }): Promise<ChildSpawnResult>;
+}
+export declare class FleetCoordinator {
+    private readonly scaffolder;
+    private readonly runner;
+    constructor(deps?: {
+        scaffolder?: Scaffolder;
+        runner?: Runner;
+    });
+    execute(manifest: FleetManifest): Promise<ChildExecution[]>;
+    private runChild;
+}
+//# sourceMappingURL=coordinator.d.ts.map

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

@@ -0,0 +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"}

package/dist/fleet/coordinator.js

@@ -0,0 +1,40 @@
+import { mapBounded } from "../orchestrator/workflow/scheduler.js";
+import { ChildScaffolder } from "./scaffolder.js";
+import { ChildRunner } from "./runner.js";
+// ── FleetCoordinator ──────────────────────────────────────────────────
+export class FleetCoordinator {
+    scaffolder;
+    runner;
+    constructor(deps) {
+        this.scaffolder = deps?.scaffolder ?? new ChildScaffolder();
+        this.runner = deps?.runner ?? new ChildRunner();
+    }
+    async execute(manifest) {
+        return mapBounded(manifest.children, manifest.concurrency, (child) => this.runChild(manifest.rootDir, child));
+    }
+    // The never-reject thunk: EVERYTHING (incl. the awaits) is inside try/catch.
+    async runChild(rootDir, child) {
+        try {
+            const scaffold = await this.scaffolder.scaffold(rootDir, child);
+            if (scaffold.error) {
+                return { folder: child.folder, scaffold, spawn: undefined };
+            }
+            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,
+            };
+        }
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/fleet/coordinator.js.map

@@ -0,0 +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"}

package/dist/fleet/index.d.ts

@@ -0,0 +1,40 @@
+import type { Command } from "commander";
+import { FleetCoordinator } from "./coordinator.js";
+import { OutcomeAggregator } from "./aggregator.js";
+import { PortfolioReporter } from "./reporter.js";
+import type { PortfolioReport } from "./reporter.js";
+export type { PortfolioReport };
+export interface FleetDeps {
+    coordinator?: FleetCoordinator;
+    aggregator?: OutcomeAggregator;
+    reporter?: PortfolioReporter;
+}
+export interface FleetOptions {
+    /** Override manifest.concurrency */
+    concurrency?: number;
+    /** Override manifest.rootDir */
+    rootDir?: string;
+}
+/**
+ * Load a fleet manifest, fail fast on missing credentials, fan-out all
+ * children through the coordinator, aggregate outcomes, build a portfolio
+ * report, write it to <rootDir>/.bober/fleet-report.json, and return it.
+ *
+ * Per-child failures are data in the report — this function only throws on
+ * batch-setup errors (bad manifest, missing credentials, report-write IO).
+ *
+ * @param manifestPath - Absolute or relative path to the fleet manifest JSON.
+ * @param options      - Optional overrides for concurrency and rootDir.
+ * @param deps         - Optional DI for testing (coordinator / aggregator / reporter).
+ */
+export declare function runFleet(manifestPath: string, options?: FleetOptions, deps?: FleetDeps): Promise<PortfolioReport>;
+/**
+ * Register `agent-bober fleet <manifest>` with the commander program.
+ *
+ * Exit codes:
+ *   0 — always on per-child failures (failures are reported, not fatal)
+ *   1 — only on batch-setup errors (bad manifest, missing credentials,
+ *        report IO failure)
+ */
+export declare function registerFleetCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fleet/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,YAAY,EAAE,eAAe,EAAE,CAAC;AAIhC,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAqCD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAC5B,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,eAAe,CAAC,CA6B1B;AAID;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgC3D"}

package/dist/fleet/index.js

@@ -0,0 +1,117 @@
+// ── fleet/index.ts ────────────────────────────────────────────────────
+//
+// runFleet: orchestrates load → credential fail-fast → coordinate →
+//           aggregate → report → write, and always resolves with a
+//           PortfolioReport (per-child failures are data, not throws).
+//
+// registerFleetCommand: wires `agent-bober fleet <manifest>` into the
+//           commander program (mirrors registerWorktreeCommand pattern).
+import chalk from "chalk";
+import { load } from "./manifest.js";
+import { buildChildConfig } from "./child-config.js";
+import { FleetCoordinator } from "./coordinator.js";
+import { OutcomeAggregator } from "./aggregator.js";
+import { PortfolioReporter } from "./reporter.js";
+import { validateApiKey } from "../providers/factory.js";
+import { logger } from "../utils/logger.js";
+// ── Credential fail-fast ──────────────────────────────────────────────
+/**
+ * Validate DeepSeek credentials for every child BEFORE spawning anything.
+ * Reuses validateApiKey from providers/factory.ts for identical semantics.
+ * Throws on the first child whose effective config is missing a required key.
+ */
+function validateManifestCredentials(manifest) {
+    for (const child of manifest.children) {
+        const cfg = buildChildConfig(child);
+        const roleCfgs = [
+            { role: "Planner", section: cfg.planner },
+            { role: "Generator", section: cfg.generator },
+            { role: "Evaluator", section: cfg.evaluator },
+        ];
+        for (const { role, section } of roleCfgs) {
+            if (!section)
+                continue;
+            const s = section;
+            const apiKey = typeof s.providerConfig?.["apiKey"] === "string"
+                ? s.providerConfig["apiKey"]
+                : undefined;
+            validateApiKey(s.provider ?? "anthropic", role, apiKey, s.endpoint ?? undefined);
+        }
+    }
+}
+/**
+ * Load a fleet manifest, fail fast on missing credentials, fan-out all
+ * children through the coordinator, aggregate outcomes, build a portfolio
+ * report, write it to <rootDir>/.bober/fleet-report.json, and return it.
+ *
+ * Per-child failures are data in the report — this function only throws on
+ * batch-setup errors (bad manifest, missing credentials, report-write IO).
+ *
+ * @param manifestPath - Absolute or relative path to the fleet manifest JSON.
+ * @param options      - Optional overrides for concurrency and rootDir.
+ * @param deps         - Optional DI for testing (coordinator / aggregator / reporter).
+ */
+export async function runFleet(manifestPath, options, deps) {
+    // 1. Load + validate manifest
+    const manifest = await load(manifestPath);
+    // 2. Apply options overrides (shallow copy to avoid mutating the parsed object)
+    const effectiveManifest = {
+        ...manifest,
+        ...(options?.concurrency !== undefined ? { concurrency: options.concurrency } : {}),
+        ...(options?.rootDir !== undefined ? { rootDir: options.rootDir } : {}),
+    };
+    // 3. Credential fail-fast BEFORE any spawn
+    validateManifestCredentials(effectiveManifest);
+    // 4. Execute → aggregate
+    const coordinator = deps?.coordinator ?? new FleetCoordinator();
+    const aggregator = deps?.aggregator ?? new OutcomeAggregator();
+    const reporter = deps?.reporter ?? new PortfolioReporter();
+    const executions = await coordinator.execute(effectiveManifest);
+    const outcomes = await Promise.all(executions.map((e) => aggregator.aggregate(e)));
+    // 5. Build + write report
+    const report = reporter.build(outcomes);
+    await reporter.write(effectiveManifest.rootDir, report);
+    return report;
+}
+// ── registerFleetCommand ──────────────────────────────────────────────
+/**
+ * Register `agent-bober fleet <manifest>` with the commander program.
+ *
+ * Exit codes:
+ *   0 — always on per-child failures (failures are reported, not fatal)
+ *   1 — only on batch-setup errors (bad manifest, missing credentials,
+ *        report IO failure)
+ */
+export function registerFleetCommand(program) {
+    program
+        .command("fleet <manifest>")
+        .description("Run a fleet of agent-bober children from a manifest")
+        .option("--concurrency <n>", "Override manifest concurrency")
+        .option("--root <dir>", "Override manifest rootDir")
+        .action(async (manifest, opts) => {
+        try {
+            const report = await runFleet(manifest, {
+                concurrency: opts.concurrency ? Number(opts.concurrency) : undefined,
+                rootDir: opts.root,
+            });
+            console.log();
+            console.log(chalk.bold("═══ Fleet Summary ═══"));
+            console.log();
+            console.log(`  Total:      ${chalk.cyan(String(report.total))} children`);
+            console.log(`  Completed:  ${chalk.green(String(report.completed))}`);
+            if (report.failed > 0) {
+                console.log(`  Failed:     ${chalk.red(String(report.failed))}`);
+            }
+            if (report.other > 0) {
+                console.log(`  Other:      ${chalk.yellow(String(report.other))}`);
+            }
+            console.log();
+            process.exitCode = 0;
+        }
+        catch (err) {
+            logger.error(`Fleet failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/fleet/index.js.map

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

package/dist/fleet/manifest.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export declare const FleetChildSchema: z.ZodObject<{
+    folder: z.ZodString;
+    task: z.ZodString;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    folder: string;
+    task: string;
+    config?: Record<string, unknown> | undefined;
+}, {
+    folder: string;
+    task: string;
+    config?: Record<string, unknown> | undefined;
+}>;
+export type FleetChild = z.infer<typeof FleetChildSchema>;
+export declare const FleetManifestSchema: z.ZodObject<{
+    rootDir: z.ZodDefault<z.ZodString>;
+    concurrency: z.ZodDefault<z.ZodNumber>;
+    children: z.ZodArray<z.ZodObject<{
+        folder: z.ZodString;
+        task: z.ZodString;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        folder: string;
+        task: string;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        folder: string;
+        task: string;
+        config?: Record<string, unknown> | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    rootDir: string;
+    concurrency: number;
+    children: {
+        folder: string;
+        task: string;
+        config?: Record<string, unknown> | undefined;
+    }[];
+}, {
+    children: {
+        folder: string;
+        task: string;
+        config?: Record<string, unknown> | undefined;
+    }[];
+    rootDir?: string | undefined;
+    concurrency?: number | undefined;
+}>;
+export type FleetManifest = z.infer<typeof FleetManifestSchema>;
+export declare function load(manifestPath: string): Promise<FleetManifest>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/fleet/manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,wBAAsB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAsBvE"}

package/dist/fleet/manifest.js

@@ -0,0 +1,32 @@
+import { readFile } from "node:fs/promises";
+import { z } from "zod";
+// ── Schemas ──────────────────────────────────────────────────────────
+export const FleetChildSchema = z.object({
+    folder: z.string().min(1),
+    task: z.string().min(1),
+    config: z.record(z.string(), z.unknown()).optional(),
+});
+export const FleetManifestSchema = z.object({
+    rootDir: z.string().default("."),
+    concurrency: z.number().int().min(1).default(3),
+    children: z.array(FleetChildSchema).min(1),
+});
+// ── Loader ───────────────────────────────────────────────────────────
+export async function load(manifestPath) {
+    let raw;
+    try {
+        raw = await readFile(manifestPath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Failed to read fleet manifest at "${manifestPath}": ${err.message}`, { cause: err });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Fleet manifest at "${manifestPath}" is not valid JSON: ${err.message}`, { cause: err });
+    }
+    return FleetManifestSchema.parse(parsed);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/fleet/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/fleet/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wEAAwE;AAExE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3C,CAAC,CAAC;AAGH,wEAAwE;AAExE,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,YAAoB;IAC7C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,qCAAqC,YAAY,MAAO,GAAa,CAAC,OAAO,EAAE,EAC/E,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sBAAsB,YAAY,wBAAyB,GAAa,CAAC,OAAO,EAAE,EAClF,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;IAED,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/fleet/reporter.d.ts

@@ -0,0 +1,32 @@
+import type { ChildOutcome } from "./types.js";
+export interface PortfolioReport {
+    total: number;
+    completed: number;
+    failed: number;
+    other: number;
+    generatedAt: string;
+    children: ChildOutcome[];
+}
+export declare class PortfolioReporter {
+    /**
+     * Tally a list of ChildOutcome records into a PortfolioReport.
+     *
+     * - completed: status === "completed"
+     * - failed:    status === "failed"
+     * - other:     anything else (running / aborted / unknown)
+     * - generatedAt: ISO-8601 timestamp at call time
+     */
+    build(outcomes: ChildOutcome[]): PortfolioReport;
+    /**
+     * Atomically write the PortfolioReport to <rootDir>/.bober/fleet-report.json.
+     *
+     * Uses temp file + rename to prevent partial-write corruption (mirrors
+     * writeRunState in src/state/run-state.ts).
+     *
+     * This is the ONE place in the fleet subsystem allowed to throw on IO failure.
+     *
+     * @returns The absolute path of the written file.
+     */
+    write(rootDir: string, report: PortfolioReport): Promise<string>;
+}
+//# sourceMappingURL=reporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/fleet/reporter.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAID,qBAAa,iBAAiB;IAG5B;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,eAAe;IA2BhD;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;CAgBvE"}

package/dist/fleet/reporter.js

@@ -0,0 +1,71 @@
+// ── reporter.ts ───────────────────────────────────────────────────────
+//
+// PortfolioReporter: tally ChildOutcome[] into a PortfolioReport and
+// atomically write it to <rootDir>/.bober/fleet-report.json.
+//
+// Write strategy mirrors writeRunState in src/state/run-state.ts:
+// temp file + rename to prevent partial-write corruption.
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import { randomBytes } from "node:crypto";
+import { join, resolve } from "node:path";
+// ── PortfolioReporter ─────────────────────────────────────────────────
+export class PortfolioReporter {
+    // ── build ───────────────────────────────────────────────────────────
+    /**
+     * Tally a list of ChildOutcome records into a PortfolioReport.
+     *
+     * - completed: status === "completed"
+     * - failed:    status === "failed"
+     * - other:     anything else (running / aborted / unknown)
+     * - generatedAt: ISO-8601 timestamp at call time
+     */
+    build(outcomes) {
+        let completed = 0;
+        let failed = 0;
+        let other = 0;
+        for (const o of outcomes) {
+            if (o.status === "completed") {
+                completed++;
+            }
+            else if (o.status === "failed") {
+                failed++;
+            }
+            else {
+                other++;
+            }
+        }
+        return {
+            total: outcomes.length,
+            completed,
+            failed,
+            other,
+            generatedAt: new Date().toISOString(),
+            children: outcomes,
+        };
+    }
+    // ── write ────────────────────────────────────────────────────────────
+    /**
+     * Atomically write the PortfolioReport to <rootDir>/.bober/fleet-report.json.
+     *
+     * Uses temp file + rename to prevent partial-write corruption (mirrors
+     * writeRunState in src/state/run-state.ts).
+     *
+     * This is the ONE place in the fleet subsystem allowed to throw on IO failure.
+     *
+     * @returns The absolute path of the written file.
+     */
+    async write(rootDir, report) {
+        const dir = resolve(join(rootDir, ".bober"));
+        await mkdir(dir, { recursive: true });
+        const filePath = join(dir, "fleet-report.json");
+        const rnd = randomBytes(4).toString("hex");
+        const tmp = `${filePath}.${process.pid}.${Date.now()}.${rnd}.tmp`;
+        await writeFile(tmp, JSON.stringify(report, null, 2) + "\n", {
+            encoding: "utf-8",
+            mode: 0o600,
+        });
+        await rename(tmp, filePath);
+        return filePath;
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/fleet/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/fleet/reporter.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,qEAAqE;AACrE,6DAA6D;AAC7D,EAAE;AACF,kEAAkE;AAClE,0DAA0D;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAe1C,yEAAyE;AAEzE,MAAM,OAAO,iBAAiB;IAC5B,uEAAuE;IAEvE;;;;;;;OAOG;IACH,KAAK,CAAC,QAAwB;QAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC7B,SAAS,EAAE,CAAC;YACd,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,EAAE,CAAC;YACX,CAAC;iBAAM,CAAC;gBACN,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,SAAS;YACT,MAAM;YACN,KAAK;YACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,QAAQ,EAAE,QAAQ;SACnB,CAAC;IACJ,CAAC;IAED,wEAAwE;IAExE;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,MAAuB;QAClD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;QAElE,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;YAC3D,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAE5B,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/fleet/runner.d.ts

@@ -0,0 +1,48 @@
+export declare function resolveCliEntry(): string;
+export interface ChildRunSpec {
+    cwd: string;
+    task: string;
+    timeoutMs?: number;
+}
+export interface ChildSpawnResult {
+    cwd: string;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut?: boolean;
+    spawnError?: string;
+}
+/**
+ * Probe the CLI binary for a successful --version response.
+ * Returns true if the entry file responds with exitCode 0, false otherwise.
+ * Never throws.
+ */
+export declare function probeCliVersion(cliEntry: string): Promise<boolean>;
+export declare class ChildRunner {
+    /**
+     * Optional override for the CLI entry path.
+     * Production code leaves this undefined (defaults to resolveCliEntry()).
+     * Tests inject the stub fixture path via the constructor to avoid
+     * requiring a built dist/cli/index.js during unit testing.
+     */
+    private readonly _cliEntry?;
+    /**
+     * Optional override for the Node.js binary path.
+     * Production code leaves this undefined (defaults to process.execPath).
+     * Tests may inject a bad path to exercise the spawn-failure / ENOENT path.
+     */
+    private readonly _nodeBin?;
+    constructor(options?: {
+        cliEntry?: string;
+        nodeBin?: string;
+    });
+    /**
+     * Spawn one `agent-bober run <task>` child process in spec.cwd.
+     * Uses process.execPath (the current Node binary) + the parent's own
+     * dist/cli/index.js — never a bare PATH lookup.
+     *
+     * Never throws: spawn errors are captured in spawnError.
+     */
+    run(spec: ChildRunSpec): Promise<ChildSpawnResult>;
+}
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/fleet/runner.ts"],"names":[],"mappings":"AAQA,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAID,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUxE;AAID,qBAAa,WAAW;IACtB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IAEpC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAK7D;;;;;;OAMG;IACG,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmDzD"}