agent-bober 0.17.1 → 0.19.0

package/dist/fleet/critic-deep.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import type { LLMClient } from "../providers/types.js";
+import type { FleetManifest } from "./manifest.js";
+import type { Outline } from "./decomposer-deep-types.js";
+export declare const CRITIQUE_MAX_ROUNDS = 1;
+export declare const CRITIQUE_PARSE_MAX_RETRIES = 1;
+export declare const DEEP_CRITIQUE_MAX_TOTAL_CALLS: number;
+export declare const CRITIQUE_SYSTEM_PROMPT = "You are an independent tech-lead reviewer evaluating a proposed fleet manifest for adequacy.\n\nA fleet manifest is a list of sub-project children, each with a folder name and a build task.\nYou did NOT author this manifest \u2014 it was produced by another agent. Review it as a third-party critic.\n\nOutput ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:\n{\n  \"verdict\": \"approve\" | \"reject\",\n  \"feedback\": \"<concise free-text feedback; empty string if approving>\"\n}\n\nRules:\n- \"verdict\" must be exactly \"approve\" or \"reject\" (no other values).\n- \"feedback\" must be a string (empty string is fine for an approval).\n- Approve if: the manifest has enough children to plausibly cover the outlined areas, each child has a clear folder and self-contained task, and there are no obvious duplicates or missing critical areas.\n- Reject if: the manifest is under-expanded (too few children for the number of outlined areas), children are vague or not self-contained, or critical areas from the outline are missing.\n- Output the JSON object and nothing else.";
+export declare const CRITIQUE_COERCION_INSTRUCTION = "Your previous response was not a valid critique verdict.\nOutput ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:\n{\n  \"verdict\": \"approve\" | \"reject\",\n  \"feedback\": \"<concise free-text feedback; empty string if approving>\"\n}\n\nRules:\n- \"verdict\" must be exactly \"approve\" or \"reject\".\n- \"feedback\" must be a string.\n- Output the JSON object and nothing else.";
+export declare const CritiqueVerdictSchema: z.ZodObject<{
+    verdict: z.ZodEnum<["approve", "reject"]>;
+    feedback: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    feedback: string;
+    verdict: "approve" | "reject";
+}, {
+    feedback: string;
+    verdict: "approve" | "reject";
+}>;
+export type CritiqueVerdict = z.infer<typeof CritiqueVerdictSchema>;
+export type ValidateVerdictResult = {
+    ok: true;
+    verdict: CritiqueVerdict;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateVerdict(rawText: string): ValidateVerdictResult;
+export declare function callCritic(input: {
+    client: LLMClient;
+    model: string;
+    goal: string;
+    outline: Outline;
+    candidate: FleetManifest;
+    priorText?: string;
+    formattedError?: string;
+}): Promise<string>;
+export declare function getCriticVerdict(input: {
+    client: LLMClient;
+    model: string;
+    goal: string;
+    outline: Outline;
+    candidate: FleetManifest;
+}): Promise<CritiqueVerdict>;
+export declare function runCritiqueLoop(input: {
+    client: LLMClient;
+    model: string;
+    goal: string;
+    outline: Outline;
+    baseline: FleetManifest;
+    expandMaxRetries: number;
+    expand: (input: {
+        client: LLMClient;
+        model: string;
+        outline: Outline;
+        goal: string;
+        maxRetries: number;
+        critiqueFeedback?: string;
+    }) => Promise<FleetManifest>;
+}): Promise<FleetManifest>;
+//# sourceMappingURL=critic-deep.d.ts.map

package/dist/fleet/critic-deep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critic-deep.d.ts","sourceRoot":"","sources":["../../src/fleet/critic-deep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAW1D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,eAAO,MAAM,6BAA6B,QAEgD,CAAC;AAI3F,eAAO,MAAM,sBAAsB,4mCAgBQ,CAAC;AAE5C,eAAO,MAAM,6BAA6B,qbAUC,CAAC;AAI5C,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAIjC,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAgDtE;AAID,wBAAsB,UAAU,CAAC,KAAK,EAAE;IACtC,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAID,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;CAC1B,GAAG,OAAO,CAAC,eAAe,CAAC,CA8B3B;AAID,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,CAAC,KAAK,EAAE;QACd,MAAM,EAAE,SAAS,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC9B,GAAG,OAAO,CAAC,aAAa,CAAC,CAoDzB"}

package/dist/fleet/critic-deep.js

@@ -0,0 +1,202 @@
+import { z } from "zod";
+// bober: read budget constants from the dependency-free leaf, NOT from ./decomposer-deep.js.
+// These are used at module-evaluation time (DEEP_CRITIQUE_MAX_TOTAL_CALLS below); importing them
+// from the leaf avoids the circular-import TDZ that killed the CLI (inc-20260620-cli-tdz-crash).
+import { DEEP_MAX_TOTAL_CALLS, DEEP_EXPAND_MAX_RETRIES, } from "./decomposer-deep-constants.js";
+// ── Constants ────────────────────────────────────────────────────────
+export const CRITIQUE_MAX_ROUNDS = 1;
+export const CRITIQUE_PARSE_MAX_RETRIES = 1;
+// bober: fixed budget = DEEP_MAX_TOTAL_CALLS + CRITIQUE_MAX_ROUNDS*((1+CRITIQUE_PARSE_MAX_RETRIES)+(1+DEEP_EXPAND_MAX_RETRIES)); raise CRITIQUE_MAX_ROUNDS if 1 round proves too few
+export const DEEP_CRITIQUE_MAX_TOTAL_CALLS = DEEP_MAX_TOTAL_CALLS +
+    CRITIQUE_MAX_ROUNDS * ((1 + CRITIQUE_PARSE_MAX_RETRIES) + (1 + DEEP_EXPAND_MAX_RETRIES));
+// ── Prompts ──────────────────────────────────────────────────────────
+export const CRITIQUE_SYSTEM_PROMPT = `You are an independent tech-lead reviewer evaluating a proposed fleet manifest for adequacy.
+
+A fleet manifest is a list of sub-project children, each with a folder name and a build task.
+You did NOT author this manifest — it was produced by another agent. Review it as a third-party critic.
+
+Output ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:
+{
+  "verdict": "approve" | "reject",
+  "feedback": "<concise free-text feedback; empty string if approving>"
+}
+
+Rules:
+- "verdict" must be exactly "approve" or "reject" (no other values).
+- "feedback" must be a string (empty string is fine for an approval).
+- Approve if: the manifest has enough children to plausibly cover the outlined areas, each child has a clear folder and self-contained task, and there are no obvious duplicates or missing critical areas.
+- Reject if: the manifest is under-expanded (too few children for the number of outlined areas), children are vague or not self-contained, or critical areas from the outline are missing.
+- Output the JSON object and nothing else.`;
+export const CRITIQUE_COERCION_INSTRUCTION = `Your previous response was not a valid critique verdict.
+Output ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:
+{
+  "verdict": "approve" | "reject",
+  "feedback": "<concise free-text feedback; empty string if approving>"
+}
+
+Rules:
+- "verdict" must be exactly "approve" or "reject".
+- "feedback" must be a string.
+- Output the JSON object and nothing else.`;
+// ── Schema + types ───────────────────────────────────────────────────
+export const CritiqueVerdictSchema = z.object({
+    verdict: z.enum(["approve", "reject"]),
+    feedback: z.string(),
+});
+// ── validateVerdict (NEVER throws) ───────────────────────────────────
+export function validateVerdict(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 = CritiqueVerdictSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        return { ok: false, error: issues };
+    }
+    return { ok: true, verdict: result.data };
+}
+// ── Internal: one CRITIC call ────────────────────────────────────────
+export async function callCritic(input) {
+    const { client, model, goal, outline, candidate, priorText, formattedError } = input;
+    // Fresh message array — NEVER extends the EXPAND conversation (LOCK1)
+    const firstUserContent = `Review this proposed fleet manifest as a third-party critic.\n\n` +
+        `Goal: ${goal}\n\n` +
+        `Outline:\n${JSON.stringify(outline)}\n\n` +
+        `Proposed manifest:\n${JSON.stringify(candidate)}`;
+    let messages;
+    if (priorText !== undefined && formattedError !== undefined) {
+        // Coercion retry: 3-message shape [user, assistant, user]
+        messages = [
+            { role: "user", content: firstUserContent },
+            { role: "assistant", content: priorText },
+            {
+                role: "user",
+                content: `${CRITIQUE_COERCION_INSTRUCTION}\n\nPrevious validation error:\n${formattedError}`,
+            },
+        ];
+    }
+    else {
+        // First turn: single user message
+        messages = [{ role: "user", content: firstUserContent }];
+    }
+    const response = await client.chat({
+        model,
+        system: CRITIQUE_SYSTEM_PROMPT,
+        messages,
+        jsonObjectMode: true,
+    });
+    return response.text;
+}
+// ── getCriticVerdict (fail-open on parse exhaustion) ─────────────────
+export async function getCriticVerdict(input) {
+    const { client, model, goal, outline, candidate } = input;
+    const maxAttempts = 1 + CRITIQUE_PARSE_MAX_RETRIES;
+    let lastError = "Unknown error";
+    let priorText;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const rawText = await callCritic({
+            client,
+            model,
+            goal,
+            outline,
+            candidate,
+            priorText: attempt > 0 ? priorText : undefined,
+            formattedError: attempt > 0 ? lastError : undefined,
+        });
+        const validated = validateVerdict(rawText);
+        if (validated.ok) {
+            return validated.verdict;
+        }
+        lastError = validated.error;
+        priorText = rawText;
+    }
+    // Fail-open: degrade to Phase-3 rather than blocking (ADR-3)
+    // bober: approve on parse exhaustion; upgrade path — add structured schema if model drift worsens
+    return { verdict: "approve", feedback: "" };
+}
+// ── runCritiqueLoop (never throws, accept-best on exhaustion) ─────────
+export async function runCritiqueLoop(input) {
+    const { client, model, goal, outline, baseline, expandMaxRetries } = input;
+    // Track all structurally-valid candidates for accept-best on exhaustion
+    const candidates = [baseline];
+    let current = baseline;
+    // totalCriticRounds = CRITIQUE_MAX_ROUNDS re-expands means CRITIQUE_MAX_ROUNDS+1 critic calls
+    let reExpandsLeft = CRITIQUE_MAX_ROUNDS;
+    let continueLoop = true;
+    while (continueLoop) {
+        let verdict;
+        try {
+            verdict = await getCriticVerdict({ client, model, goal, outline, candidate: current });
+        }
+        catch {
+            // Transport failure — accept best, never throw (ADR-1)
+            break;
+        }
+        if (verdict.verdict === "approve") {
+            return current;
+        }
+        // Reject: re-expand with critique feedback if rounds remain
+        if (reExpandsLeft <= 0) {
+            // Round budget exhausted after critiquing re-expanded manifest — accept best
+            break;
+        }
+        reExpandsLeft -= 1;
+        try {
+            const reExpanded = await input.expand({
+                client,
+                model,
+                outline,
+                goal,
+                maxRetries: expandMaxRetries,
+                critiqueFeedback: verdict.feedback,
+            });
+            candidates.push(reExpanded);
+            current = reExpanded;
+        }
+        catch {
+            // Expand failure — accept best so far, never throw
+            break;
+        }
+    }
+    // Accept best: tiebreak by most children, then first-seen (baseline)
+    return candidates.reduce((best, c) => c.children.length > best.children.length ? c : best);
+}
+//# sourceMappingURL=critic-deep.js.map

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

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

package/dist/fleet/decomposer-deep-constants.d.ts

@@ -0,0 +1,4 @@
+export declare const DEEP_PLAN_MAX_RETRIES = 1;
+export declare const DEEP_EXPAND_MAX_RETRIES = 1;
+export declare const DEEP_MAX_TOTAL_CALLS = 4;
+//# sourceMappingURL=decomposer-deep-constants.d.ts.map

package/dist/fleet/decomposer-deep-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer-deep-constants.d.ts","sourceRoot":"","sources":["../../src/fleet/decomposer-deep-constants.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,oBAAoB,IAAI,CAAC"}

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

@@ -0,0 +1,14 @@
+// bober: Leaf constants module — INTENTIONALLY has no imports.
+//
+// It exists to break the `decomposer-deep` <-> `critic-deep` module-init circular-import
+// temporal-dead-zone crash (incident inc-20260620-cli-tdz-crash). `critic-deep.ts` reads
+// DEEP_MAX_TOTAL_CALLS + DEEP_EXPAND_MAX_RETRIES at module-evaluation time to derive
+// DEEP_CRITIQUE_MAX_TOTAL_CALLS; when those bindings lived in `decomposer-deep.ts` (which
+// imports `runCritiqueLoop` back from `critic-deep.ts`), entering the graph via
+// `decomposer-deep` first left them in their TDZ → ReferenceError, killing the whole CLI.
+// Sourcing them from this dependency-free leaf makes the init-time reads order-independent.
+export const DEEP_PLAN_MAX_RETRIES = 1;
+export const DEEP_EXPAND_MAX_RETRIES = 1;
+// bober: fixed budget = (1+DEEP_PLAN_MAX_RETRIES)+(1+DEEP_EXPAND_MAX_RETRIES); upgrade path: increase retries constants
+export const DEEP_MAX_TOTAL_CALLS = 4;
+//# sourceMappingURL=decomposer-deep-constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer-deep-constants.js","sourceRoot":"","sources":["../../src/fleet/decomposer-deep-constants.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,yFAAyF;AACzF,yFAAyF;AACzF,qFAAqF;AACrF,0FAA0F;AAC1F,gFAAgF;AAChF,0FAA0F;AAC1F,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,wHAAwH;AACxH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/dist/fleet/decomposer-deep-types.d.ts

@@ -0,0 +1,8 @@
+export type OutlineArea = {
+    name: string;
+    intent: string;
+};
+export type Outline = {
+    areas: OutlineArea[];
+};
+//# sourceMappingURL=decomposer-deep-types.d.ts.map

package/dist/fleet/decomposer-deep-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer-deep-types.d.ts","sourceRoot":"","sources":["../../src/fleet/decomposer-deep-types.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3D,MAAM,MAAM,OAAO,GAAG;IAAE,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC"}

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

@@ -0,0 +1,9 @@
+// bober: Leaf types module — INTENTIONALLY has no relative imports.
+//
+// It exists to break the `critic-deep` <-> `decomposer-deep` import cycle: critic-deep needs the
+// `Outline` type but must NOT depend on decomposer-deep.ts (the cycle node). Hosting Outline here —
+// a dependency-free leaf both modules can import — removes critic-deep's last edge to decomposer-deep
+// (mirrors the ./decomposer-deep-constants.ts precedent that broke the init-time TDZ cycle,
+// inc-20260620-cli-tdz-crash). decomposer-deep.ts re-exports these so its public surface is unchanged.
+export {};
+//# sourceMappingURL=decomposer-deep-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer-deep-types.js","sourceRoot":"","sources":["../../src/fleet/decomposer-deep-types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,iGAAiG;AACjG,oGAAoG;AACpG,sGAAsG;AACtG,4FAA4F;AAC5F,uGAAuG"}

package/dist/fleet/decomposer-deep.d.ts

@@ -0,0 +1,44 @@
+import type { FleetManifest } from "./manifest.js";
+import type { LLMClient } from "../providers/types.js";
+import { DEEP_PLAN_MAX_RETRIES, DEEP_EXPAND_MAX_RETRIES, DEEP_MAX_TOTAL_CALLS } from "./decomposer-deep-constants.js";
+export { DEEP_PLAN_MAX_RETRIES, DEEP_EXPAND_MAX_RETRIES, DEEP_MAX_TOTAL_CALLS };
+export declare const DEEP_PLAN_SYSTEM_PROMPT = "You are a tech-lead creating a coarse outline of independent sub-project areas for a high-level goal.\n\nOutput ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:\n{\n  \"areas\": [\n    { \"name\": \"<free-form area name>\", \"intent\": \"<what this sub-project area covers>\" }\n  ]\n}\n\nRules:\n- \"name\" is a free-form label describing a major concern of the goal (e.g. \"Authentication\", \"Data Layer\", \"Web Frontend\").\n- \"intent\" is a concise description of what this area covers and why it is independent.\n- You MUST include at least 1 area.\n- Do NOT include folder names, kebab-case slugs, or implementation details \u2014 this is a coarse planning outline only.\n- Output the JSON object and nothing else.";
+export declare const DEEP_PLAN_COERCION_INSTRUCTION = "Your previous response was not a valid outline.\nOutput ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:\n{\n  \"areas\": [\n    { \"name\": \"<free-form area name>\", \"intent\": \"<what this sub-project area covers>\" }\n  ]\n}\n\nRules:\n- \"name\" must be a non-empty string describing a major concern of the goal.\n- \"intent\" must be a non-empty string describing what the area covers.\n- You MUST include at least 1 area.\n- Output the JSON object and nothing else.";
+export declare const DEEP_EXPAND_SYSTEM_PROMPT = "You are a tech-lead expanding a coarse outline into 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 DEEP_EXPAND_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.";
+import type { Outline, OutlineArea } from "./decomposer-deep-types.js";
+export type { Outline, OutlineArea };
+export interface DecomposeDeepInput {
+    goal: string;
+    client: LLMClient;
+    model: string;
+    count?: string;
+    planMaxRetries?: number;
+    expandMaxRetries?: number;
+    critique?: boolean;
+}
+type ValidateOutlineResult = {
+    ok: true;
+    outline: Outline;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateOutline(rawText: string): ValidateOutlineResult;
+export declare function runPlanStage(input: {
+    client: LLMClient;
+    model: string;
+    goal: string;
+    count?: string;
+    maxRetries: number;
+}): Promise<Outline>;
+export declare function runExpandStage(input: {
+    client: LLMClient;
+    model: string;
+    outline: Outline;
+    goal: string;
+    maxRetries: number;
+    critiqueFeedback?: string;
+}): Promise<FleetManifest>;
+export declare function decomposeGoalDeep(input: DecomposeDeepInput): Promise<FleetManifest>;
+//# sourceMappingURL=decomposer-deep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer-deep.d.ts","sourceRoot":"","sources":["../../src/fleet/decomposer-deep.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,CAAC;AAIhF,eAAO,MAAM,uBAAuB,wwBAcO,CAAC;AAE5C,eAAO,MAAM,8BAA8B,8gBAYA,CAAC;AAE5C,eAAO,MAAM,yBAAyB,6zBAeK,CAAC;AAE5C,eAAO,MAAM,gCAAgC,krBAcF,CAAC;AAW5C,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAErC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,qBAAqB,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAejC,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAgDtE;AA+FD,wBAAsB,YAAY,CAAC,KAAK,EAAE;IACxC,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BnB;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,aAAa,CAAC,CA+BzB;AAID,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAgCxB"}

package/dist/fleet/decomposer-deep.js

@@ -0,0 +1,261 @@
+import { z } from "zod";
+import { validateManifest } from "./decomposer.js";
+import { runCritiqueLoop } from "./critic-deep.js";
+import { DEEP_PLAN_MAX_RETRIES, DEEP_EXPAND_MAX_RETRIES, DEEP_MAX_TOTAL_CALLS, } from "./decomposer-deep-constants.js";
+// bober: re-exported so existing importers of these from ./decomposer-deep.js keep working.
+// Defined in the dependency-free leaf to avoid the critic-deep module-init TDZ cycle.
+export { DEEP_PLAN_MAX_RETRIES, DEEP_EXPAND_MAX_RETRIES, DEEP_MAX_TOTAL_CALLS };
+// ── Constants ────────────────────────────────────────────────────────
+export const DEEP_PLAN_SYSTEM_PROMPT = `You are a tech-lead creating a coarse outline of independent sub-project areas for a high-level goal.
+
+Output ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:
+{
+  "areas": [
+    { "name": "<free-form area name>", "intent": "<what this sub-project area covers>" }
+  ]
+}
+
+Rules:
+- "name" is a free-form label describing a major concern of the goal (e.g. "Authentication", "Data Layer", "Web Frontend").
+- "intent" is a concise description of what this area covers and why it is independent.
+- You MUST include at least 1 area.
+- Do NOT include folder names, kebab-case slugs, or implementation details — this is a coarse planning outline only.
+- Output the JSON object and nothing else.`;
+export const DEEP_PLAN_COERCION_INSTRUCTION = `Your previous response was not a valid outline.
+Output ONLY a single JSON object (no prose, no markdown fences, no tool calls) with EXACTLY this shape:
+{
+  "areas": [
+    { "name": "<free-form area name>", "intent": "<what this sub-project area covers>" }
+  ]
+}
+
+Rules:
+- "name" must be a non-empty string describing a major concern of the goal.
+- "intent" must be a non-empty string describing what the area covers.
+- You MUST include at least 1 area.
+- Output the JSON object and nothing else.`;
+export const DEEP_EXPAND_SYSTEM_PROMPT = `You are a tech-lead expanding a coarse outline into 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 DEEP_EXPAND_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.`;
+// ── Local Outline schema ─────────────────────────────────────────────
+const OutlineAreaSchema = z.object({
+    name: z.string().min(1),
+    intent: z.string(),
+});
+const OutlineSchema = z.object({
+    areas: z.array(OutlineAreaSchema).min(1),
+});
+// ── validateOutline (NEVER throws) ───────────────────────────────────
+export function validateOutline(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 = OutlineSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        return { ok: false, error: issues };
+    }
+    return { ok: true, outline: result.data };
+}
+// ── Internal: one PLAN call ──────────────────────────────────────────
+async function callPlan(input) {
+    const { client, model, goal, count, priorText, formattedError } = input;
+    const firstUserContent = count
+        ? `${goal}\n\n(Outline into approximately ${count} areas.)`
+        : goal;
+    let messages;
+    if (priorText !== undefined && formattedError !== undefined) {
+        // Coercion retry: 3-message shape [user, assistant, user]
+        messages = [
+            { role: "user", content: firstUserContent },
+            { role: "assistant", content: priorText },
+            {
+                role: "user",
+                content: `${DEEP_PLAN_COERCION_INSTRUCTION}\n\nPrevious validation error:\n${formattedError}`,
+            },
+        ];
+    }
+    else {
+        // First turn: single user message
+        messages = [{ role: "user", content: firstUserContent }];
+    }
+    const response = await client.chat({
+        model,
+        system: DEEP_PLAN_SYSTEM_PROMPT,
+        messages,
+        jsonObjectMode: true,
+    });
+    return response.text;
+}
+// ── Internal: one EXPAND call ────────────────────────────────────────
+async function callExpand(input) {
+    const { client, model, outline, goal, priorText, formattedError } = input;
+    const firstUserContent = `Goal: ${goal}\n\nOutline:\n${JSON.stringify(outline)}`;
+    let messages;
+    if (priorText !== undefined && formattedError !== undefined) {
+        // Coercion retry: 3-message shape [user, assistant, user]
+        messages = [
+            { role: "user", content: firstUserContent },
+            { role: "assistant", content: priorText },
+            {
+                role: "user",
+                content: `${DEEP_EXPAND_COERCION_INSTRUCTION}\n\nPrevious validation error:\n${formattedError}`,
+            },
+        ];
+    }
+    else {
+        // First turn: single user message
+        messages = [{ role: "user", content: firstUserContent }];
+    }
+    // NEW: append critique feedback to the first user turn only when present
+    const { critiqueFeedback } = input;
+    if (critiqueFeedback && messages.length === 1) {
+        messages = [{ role: "user", content: firstUserContent + `\n\nPrior reviewer feedback to address:\n${critiqueFeedback}` }];
+    }
+    const response = await client.chat({
+        model,
+        system: DEEP_EXPAND_SYSTEM_PROMPT,
+        messages,
+        jsonObjectMode: true,
+    });
+    return response.text;
+}
+// ── Stages ───────────────────────────────────────────────────────────
+export async function runPlanStage(input) {
+    const { client, model, goal, count, maxRetries } = input;
+    const maxAttempts = 1 + maxRetries;
+    let lastError = "Unknown error";
+    let priorText;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const rawText = await callPlan({
+            client,
+            model,
+            goal,
+            count,
+            priorText: attempt > 0 ? priorText : undefined,
+            formattedError: attempt > 0 ? lastError : undefined,
+        });
+        const validated = validateOutline(rawText);
+        if (validated.ok) {
+            return validated.outline;
+        }
+        lastError = validated.error;
+        priorText = rawText;
+    }
+    throw new Error(`deep plan failed after ${maxAttempts} attempt${maxAttempts === 1 ? "" : "s"}:\n${lastError}`);
+}
+export async function runExpandStage(input) {
+    const { client, model, outline, goal, maxRetries } = input;
+    const { critiqueFeedback } = input; // NEW
+    const maxAttempts = 1 + maxRetries;
+    let lastError = "Unknown error";
+    let priorText;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const rawText = await callExpand({
+            client,
+            model,
+            outline,
+            goal,
+            priorText: attempt > 0 ? priorText : undefined,
+            formattedError: attempt > 0 ? lastError : undefined,
+            critiqueFeedback: attempt === 0 ? critiqueFeedback : undefined,
+        });
+        const validated = validateManifest(rawText);
+        if (validated.ok) {
+            return validated.manifest;
+        }
+        lastError = validated.error;
+        priorText = rawText;
+    }
+    throw new Error(`deep expand failed after ${maxAttempts} attempt${maxAttempts === 1 ? "" : "s"}:\n${lastError}`);
+}
+// ── Public entrypoint ────────────────────────────────────────────────
+export async function decomposeGoalDeep(input) {
+    const { goal, client, model, count, planMaxRetries = DEEP_PLAN_MAX_RETRIES, expandMaxRetries = DEEP_EXPAND_MAX_RETRIES, } = input;
+    // PLAN strictly precedes EXPAND — never parallel
+    const outline = await runPlanStage({
+        client,
+        model,
+        goal,
+        count,
+        maxRetries: planMaxRetries,
+    });
+    const manifest = await runExpandStage({
+        client,
+        model,
+        outline,
+        goal,
+        maxRetries: expandMaxRetries,
+    });
+    if (input.critique === true) {
+        return runCritiqueLoop({ client, model, goal, outline, baseline: manifest, expandMaxRetries, expand: runExpandStage });
+    }
+    return manifest;
+}
+//# sourceMappingURL=decomposer-deep.js.map