agent-bober 0.17.1 → 0.19.0

package/dist/fleet/decomposer-deep.js.map

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

package/dist/fleet/decomposer.d.ts

@@ -0,0 +1,22 @@
+import type { FleetManifest } from "./manifest.js";
+import type { LLMClient } from "../providers/types.js";
+export declare const DECOMPOSE_SYSTEM_PROMPT = "You are a tech-lead decomposing ONE high-level goal into N independent, buildable sub-projects.\n\nOutput ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:\n{\n  \"children\": [\n    { \"folder\": \"<short-kebab-case-dir-name>\", \"task\": \"<self-contained build instruction>\" }\n  ]\n}\n\nRules:\n- \"folder\" must be a short kebab-case directory name (e.g. \"api-server\", \"web-frontend\", \"cli-tool\").\n- \"task\" must be a complete, self-contained instruction that a code-generation agent can execute independently.\n- You MUST include at least 1 child.\n- Do NOT include \"config\", \"concurrency\", \"rootDir\", or \"provider\" keys anywhere in the output.\n- Each child carries ONLY \"folder\" and \"task\" \u2014 no other keys.\n- Output the JSON object and nothing else.";
+export declare const DECOMPOSE_COERCION_INSTRUCTION = "Your previous response was not a valid fleet manifest.\nOutput ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:\n{\n  \"children\": [\n    { \"folder\": \"<short-kebab-case-dir-name>\", \"task\": \"<self-contained build instruction>\" }\n  ]\n}\n\nRules:\n- \"folder\" must be a short kebab-case directory name.\n- \"task\" must be a complete, self-contained build instruction.\n- You MUST include at least 1 child.\n- Do NOT include \"config\", \"concurrency\", \"rootDir\", or \"provider\" keys anywhere in the output.\n- Each child carries ONLY \"folder\" and \"task\" \u2014 no other keys.\n- Output the JSON object and nothing else.";
+export declare const DECOMPOSE_MAX_RETRIES = 1;
+export interface DecomposeInput {
+    goal: string;
+    client: LLMClient;
+    model: string;
+    maxRetries?: number;
+}
+type ValidateResult = {
+    ok: true;
+    manifest: FleetManifest;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateManifest(rawText: string): ValidateResult;
+export declare function decomposeGoal(input: DecomposeInput): Promise<FleetManifest>;
+export {};
+//# sourceMappingURL=decomposer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer.d.ts","sourceRoot":"","sources":["../../src/fleet/decomposer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,uBAAuB,CAAC;AAIhE,eAAO,MAAM,uBAAuB,o0BAeO,CAAC;AAE5C,eAAO,MAAM,8BAA8B,krBAcA,CAAC;AAE5C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAIvC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,cAAc,GACf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA0CjC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA4DhE;AAID,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA4BjF"}

package/dist/fleet/decomposer.js

@@ -0,0 +1,144 @@
+import { FleetManifestSchema } from "./manifest.js";
+// ── Constants ────────────────────────────────────────────────────────
+export const DECOMPOSE_SYSTEM_PROMPT = `You are a tech-lead decomposing ONE high-level goal into N independent, buildable sub-projects.
+
+Output ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:
+{
+  "children": [
+    { "folder": "<short-kebab-case-dir-name>", "task": "<self-contained build instruction>" }
+  ]
+}
+
+Rules:
+- "folder" must be a short kebab-case directory name (e.g. "api-server", "web-frontend", "cli-tool").
+- "task" must be a complete, self-contained instruction that a code-generation agent can execute independently.
+- You MUST include at least 1 child.
+- Do NOT include "config", "concurrency", "rootDir", or "provider" keys anywhere in the output.
+- Each child carries ONLY "folder" and "task" — no other keys.
+- Output the JSON object and nothing else.`;
+export const DECOMPOSE_COERCION_INSTRUCTION = `Your previous response was not a valid fleet manifest.
+Output ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:
+{
+  "children": [
+    { "folder": "<short-kebab-case-dir-name>", "task": "<self-contained build instruction>" }
+  ]
+}
+
+Rules:
+- "folder" must be a short kebab-case directory name.
+- "task" must be a complete, self-contained build instruction.
+- You MUST include at least 1 child.
+- Do NOT include "config", "concurrency", "rootDir", or "provider" keys anywhere in the output.
+- Each child carries ONLY "folder" and "task" — no other keys.
+- Output the JSON object and nothing else.`;
+export const DECOMPOSE_MAX_RETRIES = 1;
+// ── Internal: one LLM call ───────────────────────────────────────────
+async function callDecomposer(input) {
+    const { client, model, goal, priorText, formattedError } = input;
+    let messages;
+    if (priorText !== undefined && formattedError !== undefined) {
+        // Coercion retry: 3-message shape [user, assistant, user]
+        messages = [
+            { role: "user", content: goal },
+            { role: "assistant", content: priorText },
+            {
+                role: "user",
+                content: `${DECOMPOSE_COERCION_INSTRUCTION}\n\nPrevious validation error:\n${formattedError}`,
+            },
+        ];
+    }
+    else {
+        // First turn: single user message
+        messages = [{ role: "user", content: goal }];
+    }
+    const response = await client.chat({
+        model,
+        system: DECOMPOSE_SYSTEM_PROMPT,
+        messages,
+        jsonObjectMode: true,
+    });
+    return response.text;
+}
+// ── Internal: extract + validate + config-key guard ──────────────────
+export function validateManifest(rawText) {
+    let parsed;
+    // Try direct parse first
+    try {
+        parsed = JSON.parse(rawText.trim());
+    }
+    catch {
+        // Try extracting JSON from markdown code fences
+        const fenceMatch = /```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/.exec(rawText);
+        if (fenceMatch) {
+            try {
+                parsed = JSON.parse(fenceMatch[1].trim());
+            }
+            catch {
+                // Fall through
+            }
+        }
+        // Try finding the first { ... } block
+        if (!parsed) {
+            const braceStart = rawText.indexOf("{");
+            const braceEnd = rawText.lastIndexOf("}");
+            if (braceStart !== -1 && braceEnd > braceStart) {
+                try {
+                    parsed = JSON.parse(rawText.slice(braceStart, braceEnd + 1));
+                }
+                catch {
+                    return {
+                        ok: false,
+                        error: `No valid JSON object found in response. Raw: ${rawText.slice(0, 200)}`,
+                    };
+                }
+            }
+            else {
+                return {
+                    ok: false,
+                    error: `No JSON object found in response. Raw: ${rawText.slice(0, 200)}`,
+                };
+            }
+        }
+    }
+    const result = FleetManifestSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        return { ok: false, error: issues };
+    }
+    // Config-key guard: children must not carry a "config" key
+    // (FleetChildSchema.config is optional, so safeParse alone accepts it)
+    const offending = result.data.children.find((c) => Object.prototype.hasOwnProperty.call(c, "config"));
+    if (offending) {
+        return {
+            ok: false,
+            error: `child "${offending.folder}": children must not carry a "config" key`,
+        };
+    }
+    return { ok: true, manifest: result.data };
+}
+// ── Public entrypoint ────────────────────────────────────────────────
+export async function decomposeGoal(input) {
+    const { goal, client, model, maxRetries = DECOMPOSE_MAX_RETRIES } = input;
+    const maxAttempts = 1 + maxRetries;
+    let lastError = "Unknown error";
+    let priorText;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const rawText = await callDecomposer({
+            client,
+            model,
+            goal,
+            priorText: attempt > 0 ? priorText : undefined,
+            formattedError: attempt > 0 ? lastError : undefined,
+        });
+        const validated = validateManifest(rawText);
+        if (validated.ok) {
+            return validated.manifest;
+        }
+        lastError = validated.error;
+        priorText = rawText;
+    }
+    throw new Error(`Fleet decomposition failed after ${maxAttempts} attempt${maxAttempts === 1 ? "" : "s"}:\n${lastError}`);
+}
+//# sourceMappingURL=decomposer.js.map

package/dist/fleet/decomposer.js.map

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

package/dist/fleet/index.d.ts

@@ -2,8 +2,20 @@ import type { Command } from "commander";
 import { FleetCoordinator } from "./coordinator.js";
 import { OutcomeAggregator } from "./aggregator.js";
 import { PortfolioReporter } from "./reporter.js";
+import { createClient } from "../providers/factory.js";
+import { decomposeGoal } from "./decomposer.js";
+import { decomposeGoalDeep } from "./decomposer-deep.js";
+import type { FleetManifest } from "./manifest.js";
 import type { PortfolioReport } from "./reporter.js";
 export type { PortfolioReport };
+/**
+ * Resolve the ABSOLUTE shared blackboard path for a fleet run.
+ * Returns undefined when no blackboard is configured.
+ *
+ * ADR-5: the caller bears the absolute-path responsibility — resolve() is
+ * applied here so downstream modules receive an absolute path directly.
+ */
+export declare function resolveBlackboardPath(manifest: FleetManifest): string | undefined;
 export interface FleetDeps {
     coordinator?: FleetCoordinator;
     aggregator?: OutcomeAggregator;
@@ -28,6 +40,96 @@ export interface FleetOptions {
  * @param deps         - Optional DI for testing (coordinator / aggregator / reporter).
  */
 export declare function runFleet(manifestPath: string, options?: FleetOptions, deps?: FleetDeps): Promise<PortfolioReport>;
+export interface FleetExpandOptions {
+    /** Soft target for number of children to decompose */
+    count?: string;
+    /** Override the decomposer LLM provider (default: "openai-compat") */
+    provider?: string;
+    /** Override the decomposer LLM model (default: "deepseek-v4-pro") */
+    model?: string;
+    /** Override the manifest rootDir (default: ".") */
+    root?: string;
+    /** Override manifest concurrency (default: 3) */
+    concurrency?: string;
+    /** Override the output path for the written manifest */
+    out?: string;
+    /** When true, chain into runFleet(outPath) after writing */
+    yes?: boolean;
+}
+export interface FleetExpandDeps {
+    decompose?: typeof decomposeGoal;
+    runFleet?: typeof runFleet;
+    createClient?: typeof createClient;
+}
+/**
+ * Core logic for `fleet expand <goal>`:
+ *
+ * 1. Build the DeepSeek LLMClient (credential fail-fast BEFORE any IO).
+ * 2. Call decomposeGoal to get a children-only FleetManifest.
+ * 3. Assemble { rootDir, concurrency, children }.
+ * 4. Atomically write the manifest to outPath (overwrite with notice).
+ * 5. Print the manifest + a review hint.
+ * 6. If --yes, chain into runFleet(outPath) and print Fleet Summary.
+ *    Otherwise stop (exit 0).
+ *
+ * @param goal  - The high-level goal to decompose into children.
+ * @param opts  - Parsed Commander options.
+ * @param deps  - Optional DI seams for testing (decompose, runFleet, createClient).
+ */
+export declare function runFleetExpand(goal: string, opts: FleetExpandOptions, deps?: FleetExpandDeps): Promise<void>;
+export interface FleetExpandDeepOptions {
+    /** Soft target for number of children to decompose */
+    count?: string;
+    /** Override the decomposer LLM provider (default: "openai-compat") */
+    provider?: string;
+    /** Override the decomposer LLM model (default: "deepseek-v4-pro") */
+    model?: string;
+    /** Override the manifest rootDir (default: ".") */
+    root?: string;
+    /** Override manifest concurrency (default: 3) */
+    concurrency?: string;
+    /** Override the output path for the written manifest */
+    out?: string;
+    /** When true, chain into runFleet(outPath) after writing */
+    yes?: boolean;
+    /** When true, run a fresh-context critic gate that re-expands degenerate manifests */
+    critique?: boolean;
+}
+export interface FleetExpandDeepDeps {
+    decomposeDeep?: typeof decomposeGoalDeep;
+    runFleet?: typeof runFleet;
+    createClient?: typeof createClient;
+}
+/**
+ * Core logic for `fleet expand-deep <goal>`:
+ *
+ * 1. Build the DeepSeek LLMClient (credential fail-fast BEFORE any IO).
+ * 2. Call decomposeGoalDeep to get a children-only FleetManifest (two-stage plan→expand).
+ * 3. Assemble { rootDir, concurrency, children }.
+ * 4. Atomically write the manifest to outPath (overwrite with notice).
+ * 5. Print the manifest + a review hint.
+ * 6. If --yes, chain into runFleet(outPath) and print Fleet Summary.
+ *    Otherwise stop (exit 0).
+ *
+ * @param goal  - The high-level goal to decompose into children.
+ * @param opts  - Parsed Commander options.
+ * @param deps  - Optional DI seams for testing (decomposeDeep, runFleet, createClient).
+ */
+export declare function runFleetExpandDeep(goal: string, opts: FleetExpandDeepOptions, deps?: FleetExpandDeepDeps): Promise<void>;
+/**
+ * Attach `expand-deep <goal>` as a child subcommand of the existing `fleet` command.
+ * Options: --count, --provider, --model, --root, --concurrency, --out, --yes.
+ *
+ * The action body is a thin wrapper around runFleetExpandDeep for testability.
+ */
+export declare function registerFleetExpandDeepSubcommand(fleet: Command): void;
+/**
+ * Attach `expand <goal>` as a child subcommand of the existing `fleet` command.
+ * Options: --count, --provider, --model, --root, --concurrency, --out, --yes.
+ *
+ * The action body is a thin wrapper around runFleetExpand for testability.
+ */
+export declare function registerFleetExpandSubcommand(fleet: Command): void;
 /**
  * Register `agent-bober fleet <manifest>` with the commander program.
  *

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

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