wotann 0.5.0 → 0.5.39

package/dist/recipes/sop-crystallizer.js

@@ -0,0 +1,238 @@
+/**
+ * sop-crystallizer — procedural-tier auto-recipe writer.
+ *
+ * Fused port from agentmemory's episodic→procedural promotion and
+ * GenericAgent's trajectory-summarizer. WOTANN already records every
+ * successful tool-call sequence to episodic memory but never promotes
+ * that recipe knowledge into an invokable form. This module observes
+ * a successful trajectory and crystallizes it into a YAML-frontmatter
+ * Markdown skill under `<skillsDir>/<task-slug>.md`.
+ *
+ * The output is a Goose/WOTANN-compatible recipe (YAML frontmatter at
+ * the top, prose body below) so the existing recipe-loader and skill
+ * dispatcher pick it up without modification.
+ *
+ * Quality bars honoured:
+ *   - QB #6  honest stubs: every code path returns a typed `{ok, ...}`
+ *     result. Skipped vs. failed are distinct outcomes. Threshold misses
+ *     return `{ok:true, skipped:true, reason}` rather than throwing.
+ *   - QB #7  per-call state: zero module globals; every helper takes
+ *     its inputs explicitly.
+ *   - QB #11 cross-surface dispatch: the file format is Goose-compat so
+ *     the recipe-loader path and skill-discovery path both consume it.
+ *   - QB #13 env guard: never reads process.env. The skills directory
+ *     is always passed in.
+ *   - QB #14 commit-claim verification: every claim — atomic write,
+ *     versioned-rename, threshold gating, slug derivation — is covered
+ *     by a real-code-path test.
+ *
+ *   - Atomic writes via temp-file + rename (reuses utils/atomic-write).
+ *   - Idempotent: a collision with an existing slug writes
+ *     `<slug>-v2.md`, `<slug>-v3.md`, etc. — never overwrites.
+ */
+import { stringify as stringifyYaml } from "yaml";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { atomicWriteFile } from "../utils/atomic-write.js";
+// ── Defaults ────────────────────────────────────────────────
+const DEFAULT_MIN_STEPS = 3;
+const DEFAULT_MIN_SUCCESS_RATE = 0.8;
+const SLUG_MAX_LENGTH = 64;
+// ── Pure helpers ────────────────────────────────────────────
+/**
+ * Derive a kebab-case slug from a free-form task summary. Rules:
+ *   1. Lowercase.
+ *   2. Replace every non-alphanumeric character with `-`. Unicode is
+ *      reduced to ASCII via Unicode NFKD-stripping when possible; any
+ *      character that doesn't decompose to ASCII becomes `-`.
+ *   3. Collapse runs of `-` into one.
+ *   4. Trim leading and trailing `-`.
+ *   5. Cap at 64 characters.
+ *   6. If the result is empty, return `"recipe"` as a safe default.
+ */
+export function deriveSopSlug(summary) {
+    if (typeof summary !== "string" || summary.length === 0)
+        return "recipe";
+    // Strip combining marks (NFKD) to convert "café" → "cafe", "naïve" → "naive".
+    // Characters that don't decompose to ASCII are caught by the regex below.
+    const normalized = summary.normalize("NFKD");
+    let out = "";
+    for (const ch of normalized) {
+        const cp = ch.codePointAt(0);
+        if (cp === undefined)
+            continue;
+        // Skip combining marks (U+0300–U+036F covers most Latin-1 diacritics).
+        if (cp >= 0x0300 && cp <= 0x036f)
+            continue;
+        if ((cp >= 0x41 && cp <= 0x5a) || (cp >= 0x61 && cp <= 0x7a) || (cp >= 0x30 && cp <= 0x39)) {
+            out += ch.toLowerCase();
+        }
+        else {
+            out += "-";
+        }
+    }
+    // Collapse runs of dashes.
+    out = out.replace(/-+/g, "-");
+    // Trim leading/trailing dashes.
+    out = out.replace(/^-+/, "").replace(/-+$/, "");
+    // Cap at SLUG_MAX_LENGTH, then re-trim trailing `-` in case the cut
+    // landed mid-dash-run.
+    if (out.length > SLUG_MAX_LENGTH) {
+        out = out.slice(0, SLUG_MAX_LENGTH).replace(/-+$/, "");
+    }
+    if (out.length === 0)
+        return "recipe";
+    return out;
+}
+/**
+ * Serialise step arguments to a stable JSON string suitable for embedding
+ * in a Markdown code span. Sorts top-level keys for determinism so two
+ * trajectories with the same logical args render identically regardless
+ * of insertion order. Falls back to a placeholder on circular references.
+ */
+function serializeArgs(args) {
+    try {
+        const keys = Object.keys(args).sort();
+        const sorted = {};
+        for (const k of keys)
+            sorted[k] = args[k];
+        return JSON.stringify(sorted);
+    }
+    catch {
+        return '{"_error":"unserializable args"}';
+    }
+}
+/**
+ * Render the SOP-skill Markdown body. The frontmatter is YAML, the body
+ * is a numbered procedure plus a "when to use" hint — the exact shape
+ * WOTANN's skill discoverer expects.
+ */
+export function renderSopMarkdown(opts) {
+    const { trajectory, taskSummary, slug } = opts;
+    const total = trajectory.length;
+    const successes = trajectory.filter((s) => s.outcome === "success").length;
+    const successRate = total === 0 ? 0 : Number((successes / total).toFixed(4));
+    const frontmatter = stringifyYaml({
+        name: slug,
+        source: "sop-crystallizer",
+        generated: new Date().toISOString(),
+        trajectory_steps: total,
+        success_rate: successRate,
+    });
+    const steps = trajectory.map((step, i) => {
+        const argString = serializeArgs(step.args);
+        const summary = step.resultSummary ? ` (${step.resultSummary})` : "";
+        return `${String(i + 1)}. **${step.tool}** with args \`${argString}\` → ${step.outcome}${summary}`;
+    });
+    const lines = [
+        "---",
+        frontmatter.trimEnd(),
+        "---",
+        "",
+        `# ${taskSummary}`,
+        "",
+        "## Procedure",
+        "",
+        ...steps,
+        "",
+        "## When to use",
+        "",
+        `When task matches: ${taskSummary}`,
+        "",
+    ];
+    return lines.join("\n");
+}
+// ── Internal helpers ────────────────────────────────────────
+function computeSuccessRate(trajectory) {
+    if (trajectory.length === 0)
+        return 0;
+    const successes = trajectory.reduce((acc, s) => acc + (s.outcome === "success" ? 1 : 0), 0);
+    return successes / trajectory.length;
+}
+/**
+ * Resolve the next non-colliding file path. If `<slug>.md` is free,
+ * return it. Otherwise step through `<slug>-v2.md`, `<slug>-v3.md`, …
+ * until a vacancy is found. Tested for v2/v3 progression.
+ */
+function resolveVersionedPath(skillsDir, slug) {
+    const primary = join(skillsDir, `${slug}.md`);
+    if (!existsSync(primary))
+        return { path: primary, finalSlug: slug };
+    for (let v = 2; v < 10_000; v++) {
+        const candidate = join(skillsDir, `${slug}-v${String(v)}.md`);
+        if (!existsSync(candidate)) {
+            return { path: candidate, finalSlug: `${slug}-v${String(v)}` };
+        }
+    }
+    // Defensive — practically unreachable. A 10_000-collision scenario means
+    // the caller is in a bad loop; surface a unique-suffix fallback.
+    const fallback = join(skillsDir, `${slug}-${Date.now().toString(36)}.md`);
+    return { path: fallback, finalSlug: `${slug}-${Date.now().toString(36)}` };
+}
+// ── Public API ──────────────────────────────────────────────
+/**
+ * Crystallize a trajectory into an invokable skill. Returns a typed
+ * result — never throws on threshold misses; throws only on actual IO
+ * failure (in which case the result carries `ok:false` with a reason).
+ */
+export async function crystallizeSop(opts) {
+    const { trajectory, taskSummary, skillsDir } = opts;
+    const minSteps = opts.threshold?.minSteps ?? DEFAULT_MIN_STEPS;
+    const minSuccessRate = opts.threshold?.minSuccessRate ?? DEFAULT_MIN_SUCCESS_RATE;
+    // Validate shape — honest stubs, no silent successes.
+    if (!Array.isArray(trajectory)) {
+        return { ok: false, reason: "sop-crystallizer: trajectory must be an array" };
+    }
+    if (typeof taskSummary !== "string" || taskSummary.trim().length === 0) {
+        return { ok: false, reason: "sop-crystallizer: taskSummary must be a non-empty string" };
+    }
+    if (typeof skillsDir !== "string" || skillsDir.length === 0) {
+        return { ok: false, reason: "sop-crystallizer: skillsDir must be a non-empty string" };
+    }
+    // Threshold gating: empty trajectories and below-threshold trajectories
+    // are SKIPPED, not FAILED. Skipping is a normal outcome — most observed
+    // trajectories don't earn promotion to procedural memory.
+    if (trajectory.length === 0) {
+        return { ok: true, skipped: true, reason: "empty trajectory" };
+    }
+    if (trajectory.length < minSteps) {
+        return {
+            ok: true,
+            skipped: true,
+            reason: `below minSteps threshold (${String(trajectory.length)} < ${String(minSteps)})`,
+        };
+    }
+    const rate = computeSuccessRate(trajectory);
+    if (rate < minSuccessRate) {
+        return {
+            ok: true,
+            skipped: true,
+            reason: `below minSuccessRate threshold (${rate.toFixed(2)} < ${minSuccessRate.toFixed(2)})`,
+        };
+    }
+    // Resolve slug — explicit override wins, otherwise derive from summary.
+    const baseSlug = opts.slugOverride
+        ? deriveSopSlug(opts.slugOverride)
+        : deriveSopSlug(taskSummary);
+    // Resolve a non-colliding path. The probe is on the FINAL filename,
+    // not the slug — so the user always sees the file they expect.
+    const { path: filePath, finalSlug } = resolveVersionedPath(skillsDir, baseSlug);
+    // Render markdown using the FINAL slug (so the frontmatter `name`
+    // matches the on-disk filename — important for skill discovery).
+    const content = renderSopMarkdown({ trajectory, taskSummary, slug: finalSlug });
+    try {
+        // atomicWriteFile creates the dir, writes to <path>.tmp.<rand>, fsyncs,
+        // then renames. If the process dies before rename, target stays clean.
+        await atomicWriteFile(filePath, content, {
+            mode: 0o644,
+            ensureDir: true,
+            fsync: true,
+        });
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return { ok: false, reason: `sop-crystallizer: write failed — ${reason}` };
+    }
+    return { ok: true, filePath, slug: finalSlug };
+}
+//# sourceMappingURL=sop-crystallizer.js.map

package/dist/recipes/sop-crystallizer.js.map

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

package/dist/recipes/sub-recipe-orchestrator.d.ts

@@ -0,0 +1,126 @@
+/**
+ * sub-recipe-orchestrator — Isolated subagent sessions for nested recipes.
+ *
+ * Port of the Goose `sub_recipes` pattern with ISOLATION (the existing
+ * recipe-runtime.ts shares context with sub-recipes; this module
+ * spawns each as an isolated session). The motivation:
+ *
+ *   When a parent recipe says `sub_recipes: [refactor, test]`, the
+ *   refactor sub-recipe should NOT see the parent's local variables;
+ *   it should be a CLEAN session that takes only declared inputs and
+ *   returns only declared outputs. This is the safety contract that
+ *   makes nesting reliable — without it, sub-recipes leak state into
+ *   each other and into their parent, producing flaky outcomes.
+ *
+ * The orchestrator is COMPOSITION + POLICY:
+ *   - Spawn each sub-recipe in a fresh context (no parent variables)
+ *   - Pass only the declared `with:` inputs
+ *   - Run sub-recipes in PARALLEL when their `with:` clauses are
+ *     independent (no data dependency between them)
+ *   - Materialize sub-recipe outputs back into the parent's named
+ *     output bindings
+ *   - Track per-subrecipe state (status, duration, error) for
+ *     observability
+ *
+ * The actual recipe execution is delegated to the caller-supplied
+ * `runRecipe` function (matches the existing recipe-runtime contract).
+ *
+ * Quality bars:
+ *   - QB#1 immutable: SubRecipeRun + OrchestratorResult readonly + frozen
+ *   - QB#3 honest: tagged result; never throws
+ *   - QB#7 stateless: caller threads runRecipe; module owns nothing
+ *   - QB#11 sibling-site: composes with existing recipe-types.ts
+ *   - QB#19 zombie-free: every export has runtime callers via tests
+ *
+ * Source: github.com/aaif-goose/goose (sub-recipe composition pattern)
+ */
+export interface SubRecipeRef {
+    /** Sub-recipe identifier — typically a path or registry ID. */
+    readonly ref: string;
+    /** Inputs to pass to the sub-recipe. */
+    readonly with: Readonly<Record<string, unknown>>;
+    /** Optional name to bind the sub-recipe's outputs back into the
+     *  parent's variable namespace. When omitted, outputs are dropped. */
+    readonly bindOutputsTo?: string;
+}
+export interface RunRecipeFn {
+    (ref: string, inputs: Readonly<Record<string, unknown>>): Promise<RunRecipeResult>;
+}
+export type RunRecipeResult = {
+    readonly ok: true;
+    readonly outputs: Readonly<Record<string, unknown>>;
+    readonly durationMs: number;
+} | {
+    readonly ok: false;
+    readonly error: string;
+    readonly durationMs: number;
+};
+export interface SubRecipeRun {
+    readonly ref: string;
+    readonly status: "ok" | "failed" | "skipped";
+    readonly durationMs: number;
+    readonly outputs?: Readonly<Record<string, unknown>>;
+    readonly error?: string;
+    readonly bindOutputsTo?: string;
+}
+export type DependencyEdge = readonly [from: string, to: string];
+export interface OrchestratorResult {
+    readonly status: "ok" | "partial" | "failed";
+    readonly runs: readonly SubRecipeRun[];
+    /**
+     * The materialized parent variable bindings — only sub-recipes that
+     * declared `bindOutputsTo` and succeeded contribute. Frozen.
+     */
+    readonly mergedOutputs: Readonly<Record<string, unknown>>;
+    readonly totalDurationMs: number;
+    /**
+     * Stable execution batches (parallel groups). Each batch is a list
+     * of sub-recipe refs that ran simultaneously. Useful for visualizing
+     * the dependency DAG.
+     */
+    readonly batches: readonly (readonly string[])[];
+}
+export interface OrchestratorOptions {
+    /**
+     * Optional declared dependencies. Each tuple is `[from, to]` meaning
+     * "to depends on from". Sub-recipes with no incoming edge run in
+     * the first batch; subsequent batches release as their dependencies
+     * complete. Pure topological scheduler.
+     */
+    readonly dependencies?: readonly DependencyEdge[];
+    /**
+     * Maximum parallelism per batch. Default: Infinity (no cap).
+     */
+    readonly maxConcurrency?: number;
+    /**
+     * When true, a single sub-recipe failure aborts subsequent batches
+     * and returns `status: "failed"`. Default: false (continue, mark
+     * `status: "partial"`).
+     */
+    readonly stopOnError?: boolean;
+}
+/**
+ * Compute execution batches from sub-recipes + dependency edges.
+ * Each batch is a list of refs that have all dependencies satisfied
+ * by previous batches.
+ *
+ * Pure: same input → same output. Detects cycles by emitting a
+ * partial schedule when no batch can be released.
+ */
+export declare function computeBatches(subs: readonly SubRecipeRef[], deps?: readonly DependencyEdge[]): {
+    readonly ok: true;
+    readonly batches: readonly (readonly string[])[];
+} | {
+    readonly ok: false;
+    readonly error: string;
+    readonly remaining: readonly string[];
+};
+/**
+ * Execute a list of sub-recipes via the caller-supplied runRecipe
+ * function. Sub-recipes within a batch run in parallel (bounded by
+ * maxConcurrency). Sub-recipes in later batches see the merged
+ * outputs from prior batches IFF declared via bindOutputsTo.
+ */
+export declare function orchestrateSubRecipes(subs: readonly SubRecipeRef[], runRecipe: RunRecipeFn, options?: OrchestratorOptions): Promise<OrchestratorResult>;
+export declare function renderSubRecipeReport(result: OrchestratorResult): string;
+//# sourceMappingURL=sub-recipe-orchestrator.d.ts.map

package/dist/recipes/sub-recipe-orchestrator.d.ts.map

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

package/dist/recipes/sub-recipe-orchestrator.js

@@ -0,0 +1,225 @@
+/**
+ * sub-recipe-orchestrator — Isolated subagent sessions for nested recipes.
+ *
+ * Port of the Goose `sub_recipes` pattern with ISOLATION (the existing
+ * recipe-runtime.ts shares context with sub-recipes; this module
+ * spawns each as an isolated session). The motivation:
+ *
+ *   When a parent recipe says `sub_recipes: [refactor, test]`, the
+ *   refactor sub-recipe should NOT see the parent's local variables;
+ *   it should be a CLEAN session that takes only declared inputs and
+ *   returns only declared outputs. This is the safety contract that
+ *   makes nesting reliable — without it, sub-recipes leak state into
+ *   each other and into their parent, producing flaky outcomes.
+ *
+ * The orchestrator is COMPOSITION + POLICY:
+ *   - Spawn each sub-recipe in a fresh context (no parent variables)
+ *   - Pass only the declared `with:` inputs
+ *   - Run sub-recipes in PARALLEL when their `with:` clauses are
+ *     independent (no data dependency between them)
+ *   - Materialize sub-recipe outputs back into the parent's named
+ *     output bindings
+ *   - Track per-subrecipe state (status, duration, error) for
+ *     observability
+ *
+ * The actual recipe execution is delegated to the caller-supplied
+ * `runRecipe` function (matches the existing recipe-runtime contract).
+ *
+ * Quality bars:
+ *   - QB#1 immutable: SubRecipeRun + OrchestratorResult readonly + frozen
+ *   - QB#3 honest: tagged result; never throws
+ *   - QB#7 stateless: caller threads runRecipe; module owns nothing
+ *   - QB#11 sibling-site: composes with existing recipe-types.ts
+ *   - QB#19 zombie-free: every export has runtime callers via tests
+ *
+ * Source: github.com/aaif-goose/goose (sub-recipe composition pattern)
+ */
+// ── Topological scheduler ────────────────────────────────────────────
+/**
+ * Compute execution batches from sub-recipes + dependency edges.
+ * Each batch is a list of refs that have all dependencies satisfied
+ * by previous batches.
+ *
+ * Pure: same input → same output. Detects cycles by emitting a
+ * partial schedule when no batch can be released.
+ */
+export function computeBatches(subs, deps = []) {
+    const refs = subs.map((s) => s.ref);
+    const refSet = new Set(refs);
+    const inDegree = new Map();
+    const downstream = new Map();
+    for (const ref of refs) {
+        inDegree.set(ref, 0);
+        downstream.set(ref, []);
+    }
+    for (const [from, to] of deps) {
+        if (!refSet.has(from) || !refSet.has(to)) {
+            // Ignore edges to/from refs not in the sub-set; the user can have
+            // dangling deps if they're testing a subset.
+            continue;
+        }
+        inDegree.set(to, (inDegree.get(to) ?? 0) + 1);
+        downstream.get(from).push(to);
+    }
+    const batches = [];
+    const remaining = new Set(refs);
+    while (remaining.size > 0) {
+        const batch = [];
+        for (const ref of remaining) {
+            if ((inDegree.get(ref) ?? 0) === 0)
+                batch.push(ref);
+        }
+        if (batch.length === 0) {
+            // Cycle: no zero-in-degree node remains.
+            return {
+                ok: false,
+                error: "dependency cycle detected — no remaining sub-recipe has zero in-degree",
+                remaining: Object.freeze([...remaining]),
+            };
+        }
+        for (const ref of batch) {
+            remaining.delete(ref);
+            for (const ds of downstream.get(ref) ?? []) {
+                inDegree.set(ds, (inDegree.get(ds) ?? 1) - 1);
+            }
+        }
+        batches.push(batch);
+    }
+    return {
+        ok: true,
+        batches: Object.freeze(batches.map((b) => Object.freeze(b.slice()))),
+    };
+}
+// ── Orchestrator ─────────────────────────────────────────────────────
+/**
+ * Execute a list of sub-recipes via the caller-supplied runRecipe
+ * function. Sub-recipes within a batch run in parallel (bounded by
+ * maxConcurrency). Sub-recipes in later batches see the merged
+ * outputs from prior batches IFF declared via bindOutputsTo.
+ */
+export async function orchestrateSubRecipes(subs, runRecipe, options = {}) {
+    const start = Date.now();
+    const runs = [];
+    const merged = {};
+    const sched = computeBatches(subs, options.dependencies ?? []);
+    if (!sched.ok) {
+        return Object.freeze({
+            status: "failed",
+            runs: Object.freeze(sched.remaining.map((ref) => Object.freeze({
+                ref,
+                status: "skipped",
+                durationMs: 0,
+                error: sched.error,
+            }))),
+            mergedOutputs: Object.freeze({}),
+            totalDurationMs: Date.now() - start,
+            batches: Object.freeze([]),
+        });
+    }
+    const subByRef = new Map(subs.map((s) => [s.ref, s]));
+    const concurrency = options.maxConcurrency ?? Infinity;
+    let aborted = false;
+    for (const batch of sched.batches) {
+        if (aborted) {
+            for (const ref of batch) {
+                runs.push(Object.freeze({
+                    ref,
+                    status: "skipped",
+                    durationMs: 0,
+                    error: "previous batch failed (stopOnError)",
+                }));
+            }
+            continue;
+        }
+        // Bounded-parallel execution within the batch.
+        for (let i = 0; i < batch.length; i += concurrency) {
+            const slice = batch.slice(i, i + concurrency);
+            const batchResults = await Promise.all(slice.map(async (ref) => {
+                const sub = subByRef.get(ref);
+                if (!sub) {
+                    return Object.freeze({
+                        ref,
+                        status: "skipped",
+                        durationMs: 0,
+                        error: "ref not in sub-recipe set",
+                    });
+                }
+                // ISOLATION: pass ONLY sub.with — no parent state.
+                // (The merged outputs from prior batches stay in parent's
+                //  binding namespace — they only propagate when the caller
+                //  explicitly references them in the next sub-recipe's
+                //  `with:` clause.)
+                const result = await runRecipe(sub.ref, sub.with);
+                if (result.ok) {
+                    const run = Object.freeze({
+                        ref,
+                        status: "ok",
+                        durationMs: result.durationMs,
+                        outputs: Object.freeze({ ...result.outputs }),
+                        ...(sub.bindOutputsTo ? { bindOutputsTo: sub.bindOutputsTo } : {}),
+                    });
+                    return run;
+                }
+                return Object.freeze({
+                    ref,
+                    status: "failed",
+                    durationMs: result.durationMs,
+                    error: result.error,
+                    ...(sub.bindOutputsTo ? { bindOutputsTo: sub.bindOutputsTo } : {}),
+                });
+            }));
+            for (const r of batchResults) {
+                runs.push(r);
+                if (r.status === "ok" && r.bindOutputsTo && r.outputs) {
+                    merged[r.bindOutputsTo] = r.outputs;
+                }
+                if (r.status === "failed" && options.stopOnError) {
+                    aborted = true;
+                }
+            }
+        }
+    }
+    const failed = runs.some((r) => r.status === "failed");
+    const skipped = runs.some((r) => r.status === "skipped");
+    const status = failed
+        ? aborted
+            ? "failed"
+            : "partial"
+        : skipped
+            ? "partial"
+            : "ok";
+    return Object.freeze({
+        status,
+        runs: Object.freeze(runs),
+        mergedOutputs: Object.freeze({ ...merged }),
+        totalDurationMs: Date.now() - start,
+        batches: sched.batches,
+    });
+}
+// ── Markdown report ──────────────────────────────────────────────────
+export function renderSubRecipeReport(result) {
+    const lines = [];
+    lines.push(`# Sub-Recipe Orchestration — ${result.status}`);
+    lines.push("");
+    lines.push(`Total duration: ${result.totalDurationMs}ms across ${result.batches.length} batches`);
+    lines.push("");
+    for (let i = 0; i < result.batches.length; i += 1) {
+        lines.push(`## Batch ${i + 1}`);
+        for (const ref of result.batches[i] ?? []) {
+            const run = result.runs.find((r) => r.ref === ref);
+            if (!run)
+                continue;
+            const symbol = run.status === "ok" ? "✓" : run.status === "failed" ? "✗" : "·";
+            lines.push(`- ${symbol} \`${run.ref}\` (${run.durationMs}ms)${run.bindOutputsTo ? ` → \`${run.bindOutputsTo}\`` : ""}${run.error ? ` — ${run.error}` : ""}`);
+        }
+        lines.push("");
+    }
+    if (Object.keys(result.mergedOutputs).length > 0) {
+        lines.push(`## Merged outputs`);
+        for (const [name, value] of Object.entries(result.mergedOutputs)) {
+            lines.push(`- \`${name}\`: ${typeof value === "object" ? "(object)" : String(value)}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=sub-recipe-orchestrator.js.map

package/dist/recipes/sub-recipe-orchestrator.js.map

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

package/dist/sandbox/extended-backends.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extended-backends.d.ts","sourceRoot":"","sources":["../../src/sandbox/extended-backends.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIxE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,KAAK,GAAG,UAAU,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GAAG;IACrE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAkExF,CAAC;AAIF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,SAAS,mBAAmB,EAAE,CA2ChC;AA+BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,SAAS,eAAe,EAAE,CAiBpF;AAID,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE/E,wDAAwD;AACxD,wBAAgB,WAAW,IAAI,SAAS,MAAM,EAAE,CAO/C"}
+{"version":3,"file":"extended-backends.d.ts","sourceRoot":"","sources":["../../src/sandbox/extended-backends.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAKxE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,KAAK,GAAG,UAAU,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GAAG;IACrE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAkExF,CAAC;AAIF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,SAAS,mBAAmB,EAAE,CA2ChC;AAmCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,SAAS,eAAe,EAAE,CAiBpF;AAID,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE/E,wDAAwD;AACxD,wBAAgB,WAAW,IAAI,SAAS,MAAM,EAAE,CAO/C"}

package/dist/sandbox/extended-backends.js

@@ -22,6 +22,7 @@
  * detectAvailableBackends() probe so the selector can widen its
  * fallback chain.
  */
+import { getPathDelimiter } from "../utils/platform.js";
 export const EXTENDED_EXECUTION_ENVIRONMENTS = {
     daytona: {
         name: "daytona",
@@ -141,8 +142,12 @@ function isLinux() {
     return process.platform === "linux";
 }
 function commandExists(cmd) {
-    // Check PATH for the binary. Synchronous + cheap.
-    const paths = (process.env["PATH"] ?? "").split(":");
+    // Check PATH for the binary. Synchronous + cheap. Platform-aware
+    // delimiter (':' on POSIX, ';' on Windows) keeps the PATH split
+    // working on every supported OS — getPathDelimiter is imported at
+    // top of file (ESM static import; works under both Node and the
+    // vitest tsx transform).
+    const paths = (process.env["PATH"] ?? "").split(getPathDelimiter());
     const fs = requireFsSync();
     for (const p of paths) {
         if (!p)