poly-weaver 0.2.5

package/dist/flow-editor/validate.d.ts

@@ -0,0 +1,39 @@
+import type { FlowTemplate, FlowDefinition } from "../flow/types.js";
+export type ValidationSuccess = {
+    ok: true;
+    template: FlowTemplate;
+    flow: FlowDefinition;
+    diagramLines: string[];
+    code: string;
+};
+export type ValidationFailure = {
+    ok: false;
+    error: string;
+    phase: "import" | "validate" | "build" | "name-patch";
+};
+export type ValidationResult = ValidationSuccess | ValidationFailure;
+/**
+ * Replace the flow name in generated source code.
+ * Patches TWO locations to maintain the template.name === flow.name invariant:
+ * 1. Template object literal:  name: "currentName"  →  name: "expectedName"
+ * 2. defineFlow call:          defineFlow("currentName", ...)  →  defineFlow("expectedName", ...)
+ * Throws if either location cannot be found.
+ */
+export declare function patchFlowName(code: string, currentName: string, expectedName: string): string;
+/**
+ * Validate LLM-generated flow code:
+ *  1. Write to temp file
+ *  2. Dynamic import()
+ *  3. Extract factory (default or createTemplate export)
+ *  4. Call factory(flowDSL) → FlowTemplate
+ *  5. validateTemplate() shape check
+ *  6. Name consistency check: if template.name !== flowName,
+ *     call patchFlowName(code, template.name, flowName),
+ *     re-import and re-validate the patched code
+ *  7. Call build() with default param values → FlowDefinition
+ *  8. Build-time name invariant: assert flow.name === flowName
+ *  9. Render diagram from FlowDefinition
+ *  10. Return ValidationSuccess with final code + template + flow + diagram
+ */
+export declare function validateFlowCode(code: string, flowName: string, diagramWidth: number): Promise<ValidationResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/flow-editor/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/flow-editor/validate.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIrE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAQrE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CA8BR;AAqBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAkI3B"}

package/dist/flow-editor/validate.js

@@ -0,0 +1,192 @@
+import { writeFile, unlink, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { pathToFileURL } from "node:url";
+import { randomBytes } from "node:crypto";
+import { flowDSL } from "../dsl.js";
+import { validateTemplate } from "../flow/custom/index.js";
+import { renderFlowDiagram } from "../flow/diagram.js";
+// ─── Name Patching ───────────────────────────────────────────────────────
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Replace the flow name in generated source code.
+ * Patches TWO locations to maintain the template.name === flow.name invariant:
+ * 1. Template object literal:  name: "currentName"  →  name: "expectedName"
+ * 2. defineFlow call:          defineFlow("currentName", ...)  →  defineFlow("expectedName", ...)
+ * Throws if either location cannot be found.
+ */
+export function patchFlowName(code, currentName, expectedName) {
+    const escaped = escapeRegex(currentName);
+    // 1. Patch template object literal: name: "currentName" or name: 'currentName'
+    const nameFieldPattern = new RegExp(`(name\\s*:\\s*)(['"])${escaped}\\2`);
+    const nameFieldMatch = code.match(nameFieldPattern);
+    if (!nameFieldMatch) {
+        throw new Error(`Could not find name: "${currentName}" in template object literal`);
+    }
+    const q1 = nameFieldMatch[2];
+    code = code.replace(nameFieldPattern, `$1${q1}${expectedName}${q1}`);
+    // 2. Patch defineFlow call: defineFlow("currentName", ...) or defineFlow('currentName', ...)
+    const defineFlowPattern = new RegExp(`(defineFlow\\s*\\(\\s*)(['"])${escaped}\\2`);
+    const defineFlowMatch = code.match(defineFlowPattern);
+    if (!defineFlowMatch) {
+        throw new Error(`Could not find defineFlow("${currentName}", ...) call`);
+    }
+    const q2 = defineFlowMatch[2];
+    code = code.replace(defineFlowPattern, `$1${q2}${expectedName}${q2}`);
+    return code;
+}
+// ─── Validation Pipeline ─────────────────────────────────────────────────
+async function writeTempFile(code) {
+    const dir = join(tmpdir(), "poly-weaver-validate");
+    await mkdir(dir, { recursive: true });
+    const name = `flow-${randomBytes(8).toString("hex")}.mjs`;
+    const filePath = join(dir, name);
+    await writeFile(filePath, code, "utf-8");
+    return filePath;
+}
+async function cleanupTempFile(filePath) {
+    try {
+        await unlink(filePath);
+    }
+    catch {
+        // Best-effort cleanup
+    }
+}
+/**
+ * Validate LLM-generated flow code:
+ *  1. Write to temp file
+ *  2. Dynamic import()
+ *  3. Extract factory (default or createTemplate export)
+ *  4. Call factory(flowDSL) → FlowTemplate
+ *  5. validateTemplate() shape check
+ *  6. Name consistency check: if template.name !== flowName,
+ *     call patchFlowName(code, template.name, flowName),
+ *     re-import and re-validate the patched code
+ *  7. Call build() with default param values → FlowDefinition
+ *  8. Build-time name invariant: assert flow.name === flowName
+ *  9. Render diagram from FlowDefinition
+ *  10. Return ValidationSuccess with final code + template + flow + diagram
+ */
+export async function validateFlowCode(code, flowName, diagramWidth) {
+    let filePath = await writeTempFile(code);
+    let finalCode = code;
+    try {
+        // Step 2-3: Import and extract factory
+        let mod;
+        try {
+            const url = pathToFileURL(filePath).href + `?t=${Date.now()}`;
+            mod = await import(url);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: `Import error: ${err instanceof Error ? err.message : String(err)}`,
+                phase: "import",
+            };
+        }
+        const factory = (mod.default ?? mod.createTemplate);
+        if (typeof factory !== "function") {
+            return {
+                ok: false,
+                error: "No default export or createTemplate function found",
+                phase: "validate",
+            };
+        }
+        // Step 4-5: Create template and validate
+        let template;
+        try {
+            const raw = factory(flowDSL);
+            template = validateTemplate(raw, "generated");
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: `Validation error: ${err instanceof Error ? err.message : String(err)}`,
+                phase: "validate",
+            };
+        }
+        // Step 6: Name consistency check + patching
+        if (template.name !== flowName) {
+            try {
+                finalCode = patchFlowName(code, template.name, flowName);
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    error: `Name patch error: ${err instanceof Error ? err.message : String(err)}`,
+                    phase: "name-patch",
+                };
+            }
+            // Re-import patched code
+            await cleanupTempFile(filePath);
+            filePath = await writeTempFile(finalCode);
+            try {
+                const url = pathToFileURL(filePath).href + `?t=${Date.now()}`;
+                mod = await import(url);
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    error: `Import error after name patching: ${err instanceof Error ? err.message : String(err)}`,
+                    phase: "name-patch",
+                };
+            }
+            const patchedFactory = (mod.default ?? mod.createTemplate);
+            if (typeof patchedFactory !== "function") {
+                return {
+                    ok: false,
+                    error: "Patched code lost its factory export",
+                    phase: "name-patch",
+                };
+            }
+            try {
+                const raw = patchedFactory(flowDSL);
+                template = validateTemplate(raw, "generated-patched");
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    error: `Validation error after name patching: ${err instanceof Error ? err.message : String(err)}`,
+                    phase: "name-patch",
+                };
+            }
+        }
+        // Step 7: Build with default values
+        let flow;
+        try {
+            const defaults = Object.fromEntries(template.params.map((p) => [p.key, p.default]));
+            flow = template.build(defaults);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: `Build error: ${err instanceof Error ? err.message : String(err)}`,
+                phase: "build",
+            };
+        }
+        // Step 8: Post-build name invariant
+        if (flow.name !== flowName) {
+            return {
+                ok: false,
+                error: `Flow name invariant violated: expected "${flowName}" but got "${flow.name}" after build`,
+                phase: "name-patch",
+            };
+        }
+        // Step 9: Render diagram
+        const diagramLines = renderFlowDiagram(flow, diagramWidth);
+        // Step 10: Success
+        return {
+            ok: true,
+            template,
+            flow,
+            diagramLines,
+            code: finalCode,
+        };
+    }
+    finally {
+        await cleanupTempFile(filePath);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/flow-editor/validate.js.map

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

package/dist/git-info.d.ts

@@ -0,0 +1,6 @@
+export interface GitInfo {
+    branch: string;
+    isWorktree: boolean;
+}
+export declare function getGitInfo(cwd: string): Promise<GitInfo | null>;
+//# sourceMappingURL=git-info.d.ts.map

package/dist/git-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-info.d.ts","sourceRoot":"","sources":["../src/git-info.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAeD,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAcrE"}

package/dist/git-info.js

@@ -0,0 +1,26 @@
+import { execFile } from "node:child_process";
+import { normalizePath } from "./providers/path-utils.js";
+function exec(cmd, args, cwd) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, { cwd, timeout: 5000 }, (err, stdout) => {
+            if (err)
+                return reject(err);
+            resolve(stdout.trim());
+        });
+    });
+}
+export async function getGitInfo(cwd) {
+    try {
+        const [branch, gitDir, commonDir] = await Promise.all([
+            exec("git", ["rev-parse", "--abbrev-ref", "HEAD"], cwd),
+            exec("git", ["rev-parse", "--git-dir"], cwd),
+            exec("git", ["rev-parse", "--git-common-dir"], cwd),
+        ]);
+        const isWorktree = normalizePath(gitDir) !== normalizePath(commonDir);
+        return { branch, isWorktree };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-info.js.map

package/dist/git-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-info.js","sourceRoot":"","sources":["../src/git-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAO1D,SAAS,IAAI,CACX,GAAW,EACX,IAAc,EACd,GAAW;IAEX,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YAC1D,IAAI,GAAG;gBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpD,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC;YACvD,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC;YAC5C,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,kBAAkB,CAAC,EAAE,GAAG,CAAC;SACpD,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,aAAa,CAAC,SAAS,CAAC,CAAC;QAEtE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/orchestrator.d.ts

@@ -0,0 +1,55 @@
+import type { ReviewVerdict } from "./agents/reviewers/types.js";
+import { type UserPromptHandler } from "./user/prompt.js";
+import { type FeatureGates } from "./providers/registry.js";
+import type { StatusBar } from "./status-bar.js";
+import { type FlowTemplate, type FlowParamValues } from "./flow/types.js";
+export declare class PlannerContractError extends Error {
+    constructor(message: string);
+}
+export declare class ReviewerContractError extends Error {
+    constructor(message: string);
+}
+export interface OrchestratorResult {
+    /** The final plan text. */
+    plan: string;
+    /** Total plan-review iterations. */
+    iterations: number;
+    /** Overall success. True when plan and implementation (if configured) are approved. */
+    approved: boolean;
+    /** The final plan-review verdict. */
+    verdict?: ReviewVerdict;
+    /** Implementation-review outcome if implementation phase ran. */
+    implementation?: {
+        approved: boolean;
+        iterations: number;
+        verdict?: ReviewVerdict;
+    };
+}
+/**
+ * Resolve task content: if the task looks like a file path and exists, read it.
+ * Otherwise, treat it as inline task text.
+ */
+export declare function resolveTaskContent(task: string): Promise<string>;
+export declare function runPhaseWithRetries<T>(phaseName: string, run: (attempt: number) => Promise<T>, maxAttempts?: number): Promise<T>;
+export declare function logPhase(phase: string, message: string): void;
+export declare function readPlanFromContract(planFile: string): Promise<string>;
+export declare function removeFileIfExists(path: string): Promise<void>;
+export declare function readVerdictFromContract(verdictFile: string): Promise<ReviewVerdict>;
+export interface TemplateOrchestratorOptions {
+    template: FlowTemplate;
+    paramValues: FlowParamValues;
+    task?: string;
+    verbose?: boolean;
+    opinionless?: boolean;
+    yolo?: boolean;
+    whipMode?: boolean;
+    workdir?: string;
+    statusBar?: StatusBar;
+}
+export declare function createUserPromptHandler(auto: boolean, gates: FeatureGates): UserPromptHandler;
+/**
+ * Orchestrate using a FlowTemplate. Driver params are used to create
+ * drivers dynamically; structure params shape the flow via build().
+ */
+export declare function orchestrateWithTemplate(opts: TemplateOrchestratorOptions): Promise<OrchestratorResult>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAQjE,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,QAAQ,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,iEAAiE;IACjE,cAAc,CAAC,EAAE;QACf,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CActE;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACpC,WAAW,SAAI,GACd,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB5E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE;AAcD,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmCzF;AAID,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,YAAY,GAClB,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAsG7B"}

package/dist/orchestrator.js

@@ -0,0 +1,240 @@
+import _Ajv from "ajv";
+const Ajv = _Ajv.default ?? _Ajv;
+import { createSessionDir, cleanupSessionDir, } from "./session/dir.js";
+import { getVerdictSchema } from "./prompts.js";
+import { readFile, writeFile, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { AutoUserPrompt, InteractiveUserPrompt } from "./user/prompt.js";
+import { computeFeatureGates } from "./providers/registry.js";
+import { UserRoleHandler } from "./user/handler.js";
+import { dim, reset, cyan } from "./ansi.js";
+import { MapArtifactStore } from "./flow/artifacts.js";
+import { FlowExecutor } from "./flow/executor.js";
+import { inspectFlow } from "./flow/inspect.js";
+import { computeConsumerMap } from "./flow/neighbors.js";
+import { createHandler } from "./agents/registry.js";
+import { TASK, handlerKey, } from "./flow/types.js";
+export class PlannerContractError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PlannerContractError";
+    }
+}
+export class ReviewerContractError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ReviewerContractError";
+    }
+}
+/**
+ * Resolve task content: if the task looks like a file path and exists, read it.
+ * Otherwise, treat it as inline task text.
+ */
+export async function resolveTaskContent(task) {
+    if (task.endsWith(".md") ||
+        task.endsWith(".txt") ||
+        task.includes("/") ||
+        task.includes("\\")) {
+        try {
+            return await readFile(task, "utf-8");
+        }
+        catch {
+            // Not a valid file path, treat as inline text
+        }
+    }
+    return task;
+}
+export async function runPhaseWithRetries(phaseName, run, maxAttempts = 3) {
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await run(attempt);
+        }
+        catch (err) {
+            lastError = err;
+            if (attempt < maxAttempts) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(`[poly-weaver] ${phaseName} failed (attempt ${attempt}/${maxAttempts}): ${msg}. Retrying...`);
+            }
+        }
+    }
+    throw lastError instanceof Error
+        ? lastError
+        : new Error(`[poly-weaver] ${phaseName} failed after ${maxAttempts} attempts`);
+}
+export function logPhase(phase, message) {
+    console.log(`\n${dim}[poly-weaver]${reset} ${cyan}${phase}${reset}: ${message}\n`);
+}
+export async function readPlanFromContract(planFile) {
+    let content;
+    try {
+        content = await readFile(planFile, "utf-8");
+    }
+    catch (err) {
+        throw new PlannerContractError(`Planner did not produce plan output file: ${planFile}`);
+    }
+    const trimmed = content.trim();
+    if (!trimmed) {
+        throw new PlannerContractError(`Planner produced an empty plan file: ${planFile}`);
+    }
+    return content;
+}
+export async function removeFileIfExists(path) {
+    try {
+        await unlink(path);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+}
+let cachedValidator = null;
+async function getVerdictValidator() {
+    if (!cachedValidator) {
+        const schemaText = await getVerdictSchema();
+        const schema = JSON.parse(schemaText);
+        const ajv = new Ajv();
+        cachedValidator = ajv.compile(schema);
+    }
+    return cachedValidator;
+}
+export async function readVerdictFromContract(verdictFile) {
+    let content;
+    try {
+        content = await readFile(verdictFile, "utf-8");
+    }
+    catch {
+        throw new ReviewerContractError(`Reviewer did not produce verdict output file: ${verdictFile}`);
+    }
+    const trimmed = content.trim();
+    if (!trimmed) {
+        throw new ReviewerContractError(`Reviewer produced an empty verdict file: ${verdictFile}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        throw new ReviewerContractError(`Reviewer produced invalid JSON in verdict file: ${verdictFile}`);
+    }
+    const validate = await getVerdictValidator();
+    if (!validate(parsed)) {
+        const errors = validate.errors
+            ?.map((e) => `${e.instancePath} ${e.message}`)
+            .join("; ");
+        throw new ReviewerContractError(`Verdict validation failed: ${errors}`);
+    }
+    return parsed;
+}
+export function createUserPromptHandler(auto, gates) {
+    return auto ? new AutoUserPrompt() : new InteractiveUserPrompt(gates);
+}
+/**
+ * Orchestrate using a FlowTemplate. Driver params are used to create
+ * drivers dynamically; structure params shape the flow via build().
+ */
+export async function orchestrateWithTemplate(opts) {
+    const gates = computeFeatureGates(String(opts.paramValues.planner));
+    const handler = createUserPromptHandler(!!opts.paramValues.auto, gates);
+    const sessionDir = await createSessionDir(opts.workdir ?? process.cwd());
+    try {
+        const artifacts = new MapArtifactStore();
+        if (opts.task) {
+            const taskContent = await resolveTaskContent(opts.task);
+            const taskFile = join(sessionDir, "task.md");
+            await writeFile(taskFile, taskContent, "utf-8");
+            artifacts.set(TASK, { file: taskFile, text: taskContent });
+        }
+        const workdir = opts.workdir ?? process.cwd();
+        // Build flow FIRST so we can scan steps for handler creation
+        const flow = opts.template.build(opts.paramValues);
+        // Build handler map by scanning flow steps
+        const handlers = new Map();
+        for (const step of collectAgentSteps(flow.steps)) {
+            const key = handlerKey(step);
+            if (handlers.has(key))
+                continue;
+            handlers.set(key, createHandler(step.role, step.driver, workdir, {
+                opinionless: opts.opinionless, variant: step.variant, yolo: opts.yolo,
+            }));
+        }
+        handlers.set("user", new UserRoleHandler(handler));
+        // Build context
+        const ctx = {
+            sessionDir,
+            artifacts,
+            sessionIds: new Map(),
+            loopIterations: new Map(),
+            loopCycle: new Map(),
+            totalIterations: 0,
+            nextClarificationNumber: 1,
+            statusBar: opts.statusBar,
+            verbose: opts.verbose ?? false,
+            consumerMap: computeConsumerMap(flow),
+            whipMode: opts.whipMode ?? true,
+        };
+        // Execute
+        const executor = new FlowExecutor(flow, handlers, opts.statusBar);
+        await executor.execute(ctx);
+        // Extract results via semantic flow inspection
+        const { loops } = inspectFlow(flow);
+        // Plan loops: all loops that produce a "plan" write key
+        const planLoopsAll = loops.filter(l => "plan" in l.ownWrites);
+        // Use the deepest plan loop for iteration count (inner agent-review loop in interactive mode)
+        const agentReviewLoop = planLoopsAll.length > 0
+            ? planLoopsAll.reduce((deepest, l) => l.depth > deepest.depth ? l : deepest)
+            : undefined;
+        // Use the shallowest plan loop for artifact extraction (outer loop has plan + verdict)
+        const planLoop = planLoopsAll.length > 0
+            ? planLoopsAll.reduce((shallowest, l) => l.depth < shallowest.depth ? l : shallowest)
+            : undefined;
+        const planText = planLoop
+            ? ctx.artifacts.getText(planLoop.ownWrites.plan) ?? ""
+            : "";
+        const planVerdictData = planLoop && "verdict" in planLoop.ownWrites
+            ? ctx.artifacts.getData(planLoop.ownWrites.verdict)
+            : undefined;
+        const planIterations = agentReviewLoop
+            ? ctx.loopIterations.get(agentReviewLoop.id) ?? ctx.totalIterations
+            : ctx.totalIterations;
+        const result = {
+            plan: planText,
+            iterations: planIterations,
+            approved: planVerdictData?.approved ?? false,
+            verdict: planVerdictData,
+        };
+        // Impl loop: a different top-level loop with "verdict" but not the plan loop
+        const topLoops = loops.filter(l => l.depth === 0);
+        const implLoop = topLoops.find(l => l !== planLoop && "verdict" in l.ownWrites);
+        if (implLoop) {
+            const implVerdictData = ctx.artifacts.getData(implLoop.ownWrites.verdict);
+            if (implVerdictData !== undefined) {
+                const implIterations = ctx.loopIterations.get(implLoop.id) ?? 0;
+                result.implementation = {
+                    approved: implVerdictData.approved ?? false,
+                    iterations: implIterations,
+                    verdict: implVerdictData,
+                };
+                result.approved = result.approved && (implVerdictData.approved ?? false);
+            }
+        }
+        return result;
+    }
+    finally {
+        await cleanupSessionDir(sessionDir, { preserve: opts.verbose });
+    }
+}
+/** Recursively walk flow steps and yield all AgentStep nodes. */
+function collectAgentSteps(steps) {
+    const result = [];
+    for (const step of steps) {
+        if (step.type === "agent") {
+            result.push(step);
+        }
+        else if (step.type === "loop") {
+            result.push(...collectAgentSteps(step.steps));
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/preflight.d.ts

@@ -0,0 +1,30 @@
+export interface PreflightNeeds {
+    needClaude: boolean;
+    needCodex: boolean;
+    needCopilot: boolean;
+}
+/**
+ * Compute which CLI tools are needed based on the driver configuration.
+ * Shared by cli.ts and sanity-check.ts to avoid duplicating the logic.
+ */
+export declare function computePreflightNeeds(opts: {
+    planner: string;
+    reviewer: string;
+    implementor: string;
+    simplifier?: string;
+    planOnly?: boolean;
+}): PreflightNeeds;
+export interface PreflightResult {
+    ok: boolean;
+    errors: string[];
+    versions: Map<string, string>;
+}
+/**
+ * Run preflight checks to verify required CLIs and dependencies are available.
+ */
+export declare function runPreflight(opts: {
+    needClaude: boolean;
+    needCodex: boolean;
+    needCopilot: boolean;
+}): Promise<PreflightResult>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,cAAc,CAkBjB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,eAAe,CAAC,CAoE3B"}