patchwork-os 0.2.0-alpha.2 → 0.2.0-alpha.22

package/dist/recipes/dependencyGraph.d.ts

@@ -0,0 +1,39 @@
+/**
+ * DependencyGraph — builds and executes recipe step dependencies.
+ *
+ * Supports:
+ *   - Parallel execution up to maxConcurrency
+ *   - Explicit dependencies (awaits: [stepA, stepB])
+ *   - Conditional execution (when: condition)
+ *   - Cycle detection
+ */
+export interface StepDependency {
+    stepId: string;
+    awaits: string[];
+    index: number;
+}
+export interface DependencyGraph {
+    steps: StepDependency[];
+    hasCycles: boolean;
+    topologicalOrder: string[];
+}
+export interface ExecutionOptions {
+    maxConcurrency: number;
+    onStepStart?: (stepId: string) => void;
+    onStepComplete?: (stepId: string, error?: Error) => void;
+}
+export type StepExecutor = (stepId: string) => Promise<void>;
+/** Build dependency graph from step definitions */
+export declare function buildDependencyGraph(steps: Array<{
+    id: string;
+    awaits?: string[];
+}>): DependencyGraph;
+/** Format cycle for error message */
+export declare function formatCycle(cycles: string[][]): string;
+/** Execute steps respecting dependencies with limited concurrency */
+export declare function executeWithDependencies(graph: DependencyGraph, executeStep: StepExecutor, options: ExecutionOptions): Promise<Map<string, {
+    success: boolean;
+    error?: Error;
+}>>;
+/** Get steps that can run immediately (no unresolved dependencies) */
+export declare function getReadySteps(graph: DependencyGraph, completed: Set<string>): string[];

package/dist/recipes/dependencyGraph.js

@@ -0,0 +1,199 @@
+/**
+ * DependencyGraph — builds and executes recipe step dependencies.
+ *
+ * Supports:
+ *   - Parallel execution up to maxConcurrency
+ *   - Explicit dependencies (awaits: [stepA, stepB])
+ *   - Conditional execution (when: condition)
+ *   - Cycle detection
+ */
+/** Build dependency graph from step definitions */
+export function buildDependencyGraph(steps) {
+    const nodes = steps.map((s, index) => ({
+        stepId: s.id,
+        awaits: s.awaits ?? [],
+        index,
+    }));
+    // Detect cycles using DFS
+    const visited = new Set();
+    const visiting = new Set();
+    const cycles = [];
+    function visit(node, path) {
+        if (visiting.has(node.stepId)) {
+            // Found cycle - extract cycle from path
+            const cycleStart = path.indexOf(node.stepId);
+            cycles.push(path.slice(cycleStart).concat(node.stepId));
+            return;
+        }
+        if (visited.has(node.stepId))
+            return;
+        visiting.add(node.stepId);
+        path.push(node.stepId);
+        for (const depId of node.awaits) {
+            const dep = nodes.find((n) => n.stepId === depId);
+            if (dep)
+                visit(dep, path);
+        }
+        path.pop();
+        visiting.delete(node.stepId);
+        visited.add(node.stepId);
+    }
+    for (const node of nodes) {
+        if (!visited.has(node.stepId)) {
+            visit(node, []);
+        }
+    }
+    // Calculate topological order (Kahn's algorithm)
+    const inDegree = new Map();
+    const adjacency = new Map();
+    for (const node of nodes) {
+        inDegree.set(node.stepId, node.awaits.length);
+        for (const dep of node.awaits) {
+            if (!adjacency.has(dep))
+                adjacency.set(dep, []);
+            adjacency.get(dep)?.push(node.stepId);
+        }
+    }
+    const queue = [];
+    for (const [stepId, degree] of inDegree) {
+        if (degree === 0)
+            queue.push(stepId);
+    }
+    const topologicalOrder = [];
+    while (queue.length > 0) {
+        const stepId = queue.shift();
+        topologicalOrder.push(stepId);
+        const dependents = adjacency.get(stepId) ?? [];
+        for (const dep of dependents) {
+            const newDegree = (inDegree.get(dep) ?? 0) - 1;
+            inDegree.set(dep, newDegree);
+            if (newDegree === 0)
+                queue.push(dep);
+        }
+    }
+    return {
+        steps: nodes,
+        hasCycles: cycles.length > 0,
+        topologicalOrder,
+    };
+}
+/** Format cycle for error message */
+export function formatCycle(cycles) {
+    if (cycles.length === 0)
+        return "No cycles detected";
+    return cycles
+        .map((cycle, i) => `  Cycle ${i + 1}: ${cycle.join(" → ")}`)
+        .join("\n");
+}
+/** Execute steps respecting dependencies with limited concurrency */
+export async function executeWithDependencies(graph, executeStep, options) {
+    if (graph.hasCycles) {
+        throw new Error(`Dependency graph has cycles - cannot execute`);
+    }
+    const results = new Map();
+    const completed = new Set();
+    const failed = new Set(); // C1: track which completed steps failed
+    const inProgress = new Set();
+    // Store resolver functions to signal when steps complete
+    const resolvers = new Map();
+    // Track which steps are waiting for which dependencies
+    const waitingFor = new Map();
+    for (const node of graph.steps) {
+        waitingFor.set(node.stepId, [...node.awaits]);
+    }
+    function waitForStep(stepId) {
+        if (completed.has(stepId))
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const list = resolvers.get(stepId);
+            if (list) {
+                list.push(resolve);
+            }
+            else {
+                resolvers.set(stepId, [resolve]);
+            }
+        });
+    }
+    async function runStep(stepId) {
+        if (inProgress.has(stepId) || completed.has(stepId))
+            return;
+        // Check if all dependencies are satisfied
+        const deps = waitingFor.get(stepId) ?? [];
+        const unresolved = deps.filter((d) => !completed.has(d));
+        if (unresolved.length > 0) {
+            await Promise.all(unresolved.map(waitForStep));
+        }
+        // C1: skip if any upstream dependency failed
+        const failedDep = deps.find((d) => failed.has(d));
+        if (failedDep) {
+            const err = new Error(`Skipped: upstream step "${failedDep}" failed`);
+            results.set(stepId, { success: false, error: err });
+            completed.add(stepId);
+            failed.add(stepId);
+            options.onStepComplete?.(stepId, err);
+            // Unblock any steps waiting on this one
+            const waiting = resolvers.get(stepId) ?? [];
+            for (const resolve of waiting)
+                resolve();
+            resolvers.delete(stepId);
+            return;
+        }
+        inProgress.add(stepId);
+        options.onStepStart?.(stepId);
+        let stepErr;
+        try {
+            await executeStep(stepId);
+            results.set(stepId, { success: true });
+            completed.add(stepId);
+        }
+        catch (error) {
+            stepErr = error instanceof Error ? error : new Error(String(error));
+            results.set(stepId, { success: false, error: stepErr });
+            completed.add(stepId);
+            failed.add(stepId); // C1: record failure so dependents are skipped
+        }
+        finally {
+            options.onStepComplete?.(stepId, stepErr);
+            inProgress.delete(stepId);
+            // Signal dependents
+            const waiting = resolvers.get(stepId) ?? [];
+            for (const resolve of waiting) {
+                resolve();
+            }
+            resolvers.delete(stepId);
+        }
+    }
+    // Execute with concurrency limit
+    const executing = [];
+    const queue = [...graph.topologicalOrder];
+    async function processQueue() {
+        while (queue.length > 0 || executing.length > 0) {
+            // Start new steps if under concurrency limit
+            while (executing.length < options.maxConcurrency && queue.length > 0) {
+                const stepId = queue.shift();
+                // C2: push before attaching .then() so indexOf is never -1
+                let resolveSlot;
+                const slot = new Promise((r) => {
+                    resolveSlot = r;
+                });
+                executing.push(slot);
+                runStep(stepId).then(() => {
+                    executing.splice(executing.indexOf(slot), 1);
+                    resolveSlot();
+                });
+            }
+            if (executing.length > 0) {
+                await Promise.race(executing);
+            }
+        }
+    }
+    await processQueue();
+    return results;
+}
+/** Get steps that can run immediately (no unresolved dependencies) */
+export function getReadySteps(graph, completed) {
+    return graph.steps
+        .filter((s) => !completed.has(s.stepId) && s.awaits.every((dep) => completed.has(dep)))
+        .map((s) => s.stepId);
+}
+//# sourceMappingURL=dependencyGraph.js.map

package/dist/recipes/dependencyGraph.js.map

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

package/dist/recipes/legacyRecipeCompat.d.ts

@@ -0,0 +1 @@
+export declare function normalizeRecipeForRuntime(recipe: unknown): unknown;

package/dist/recipes/legacyRecipeCompat.js

@@ -0,0 +1,97 @@
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function normalizeRecipeForRuntime(recipe) {
+    if (!isRecord(recipe)) {
+        return recipe;
+    }
+    const normalized = {
+        ...recipe,
+    };
+    if (isRecord(normalized.trigger)) {
+        normalized.trigger = normalizeLegacyTriggerForRuntime(normalized.trigger);
+    }
+    if (Array.isArray(normalized.steps)) {
+        normalized.steps = normalized.steps.map((step) => normalizeLegacyRuntimeStep(step));
+    }
+    return normalized;
+}
+function normalizeLegacyTriggerForRuntime(trigger) {
+    const normalized = { ...trigger };
+    if (normalized.type === "cron" &&
+        typeof normalized.schedule === "string" &&
+        typeof normalized.at !== "string") {
+        normalized.at = normalized.schedule;
+    }
+    delete normalized.schedule;
+    return normalized;
+}
+function normalizeLegacyRuntimeStep(step) {
+    if (!isRecord(step)) {
+        return step;
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(step)) {
+        if (key === "params" || key === "output" || key === "prompt") {
+            continue;
+        }
+        if (key === "agent" && typeof value === "boolean") {
+            continue;
+        }
+        if (key === "parallel" && Array.isArray(value)) {
+            normalized.parallel = value.map((entry) => normalizeLegacyRuntimeStep(entry));
+            continue;
+        }
+        if (key === "branch" && Array.isArray(value)) {
+            normalized.branch = value.map((entry) => normalizeLegacyBranchEntry(entry));
+            continue;
+        }
+        normalized[key] = value;
+    }
+    if (step.agent === true || isRecord(step.agent)) {
+        const agentConfig = isRecord(step.agent)
+            ? { ...step.agent }
+            : {};
+        if (typeof step.prompt === "string" &&
+            typeof agentConfig.prompt !== "string") {
+            agentConfig.prompt = step.prompt;
+        }
+        if (typeof step.output === "string" &&
+            typeof agentConfig.into !== "string") {
+            agentConfig.into = step.output;
+        }
+        normalized.agent = agentConfig;
+        return normalized;
+    }
+    if (isRecord(step.params)) {
+        Object.assign(normalized, step.params);
+    }
+    if (typeof normalized.into !== "string" && typeof step.output === "string") {
+        normalized.into = step.output;
+    }
+    if (normalized.tool === "file.append" &&
+        typeof normalized.content !== "string" &&
+        typeof normalized.line === "string") {
+        normalized.content = normalized.line;
+        delete normalized.line;
+    }
+    return normalized;
+}
+function normalizeLegacyBranchEntry(entry) {
+    if (!isRecord(entry)) {
+        return entry;
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(entry)) {
+        if (key === "otherwise" && isRecord(value)) {
+            normalized.otherwise = normalizeLegacyRuntimeStep(value);
+            continue;
+        }
+        normalized[key] = value;
+    }
+    if (Object.hasOwn(normalized, "otherwise")) {
+        return normalized;
+    }
+    return normalizeLegacyRuntimeStep(entry);
+}
+//# sourceMappingURL=legacyRecipeCompat.js.map

package/dist/recipes/legacyRecipeCompat.js.map

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

package/dist/recipes/nestedRecipeStep.d.ts

@@ -0,0 +1,58 @@
+/**
+ * NestedRecipeStep — handler for calling recipes from within recipes.
+ *
+ * Supports:
+ *   - Variable passing via template resolution
+ *   - Isolated OutputRegistry for child
+ *   - Risk escalation (child risk > parent risk uses child's)
+ *   - Depth limiting (prevent infinite recursion)
+ */
+import type { OutputRegistry } from "./outputRegistry.js";
+import type { TemplateContext, TemplateError } from "./templateEngine.js";
+export interface NestedRecipeConfig {
+    recipe: string;
+    vars: Record<string, string>;
+    output?: string;
+    risk?: "low" | "medium" | "high";
+    id: string;
+}
+export interface NestedRecipeContext {
+    parentRegistry: OutputRegistry;
+    parentEnv: Record<string, string | undefined>;
+    recipeMaxDepth: number;
+    currentDepth: number;
+    dryRun: boolean;
+}
+export interface NestedRecipeResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    childOutputs?: Record<string, unknown>;
+}
+export interface RecipeLoader {
+    loadRecipe(name: string): Promise<{
+        steps: unknown[];
+    } | null>;
+}
+/** Resolve template variables against parent context */
+export declare function resolveNestedVars(vars: Record<string, string>, context: TemplateContext): {
+    resolved: Record<string, string>;
+    errors: TemplateError[];
+};
+/** Validate nested recipe call before execution */
+export declare function validateNestedRecipe(config: NestedRecipeConfig, context: NestedRecipeContext): {
+    valid: boolean;
+    error?: string;
+};
+/** Calculate effective risk tier */
+export declare function calculateNestedRisk(parentRisk: "low" | "medium" | "high" | undefined, childRisk: "low" | "medium" | "high" | undefined): "low" | "medium" | "high";
+/** Format nested recipe result for parent registry */
+export declare function formatNestedOutput(result: NestedRecipeResult, config: NestedRecipeConfig): {
+    stepId: string;
+    output: {
+        status: "success" | "error" | "skipped";
+        data: unknown;
+    };
+};
+/** Mock nested recipe execution for dry-run mode */
+export declare function mockNestedRecipe(config: NestedRecipeConfig, context: NestedRecipeContext): Promise<NestedRecipeResult>;

package/dist/recipes/nestedRecipeStep.js

@@ -0,0 +1,95 @@
+/**
+ * NestedRecipeStep — handler for calling recipes from within recipes.
+ *
+ * Supports:
+ *   - Variable passing via template resolution
+ *   - Isolated OutputRegistry for child
+ *   - Risk escalation (child risk > parent risk uses child's)
+ *   - Depth limiting (prevent infinite recursion)
+ */
+import { compileTemplate } from "./templateEngine.js";
+/** Resolve template variables against parent context */
+export function resolveNestedVars(vars, context) {
+    const resolved = {};
+    const errors = [];
+    for (const [key, templateStr] of Object.entries(vars)) {
+        const compiled = compileTemplate(templateStr);
+        const result = compiled.evaluate(context);
+        if ("error" in result) {
+            errors.push(result.error);
+            resolved[key] = "";
+        }
+        else {
+            resolved[key] = result.value;
+        }
+    }
+    return { resolved, errors };
+}
+/** Validate nested recipe call before execution */
+export function validateNestedRecipe(config, context) {
+    if (context.currentDepth > context.recipeMaxDepth) {
+        return {
+            valid: false,
+            error: `Recipe nesting depth limit (${context.recipeMaxDepth}) exceeded. ` +
+                `Step "${config.id}" attempted to call "${config.recipe}" at depth ${context.currentDepth + 1}.`,
+        };
+    }
+    if (!config.recipe || typeof config.recipe !== "string") {
+        return {
+            valid: false,
+            error: `Invalid recipe reference in step "${config.id}": recipe name is required`,
+        };
+    }
+    return { valid: true };
+}
+/** Calculate effective risk tier */
+export function calculateNestedRisk(parentRisk, childRisk) {
+    const tiers = { low: 1, medium: 2, high: 3 };
+    const parentTier = tiers[parentRisk ?? "low"];
+    const childTier = tiers[childRisk ?? "low"];
+    const effective = Math.max(parentTier, childTier);
+    return effective === 1 ? "low" : effective === 2 ? "medium" : "high";
+}
+/** Format nested recipe result for parent registry */
+export function formatNestedOutput(result, config) {
+    return {
+        stepId: config.output ?? config.id,
+        output: {
+            status: result.success ? "success" : "error",
+            data: result.success
+                ? {
+                    recipe: config.recipe,
+                    result: result.data,
+                    childOutputs: result.childOutputs,
+                }
+                : { error: result.error },
+        },
+    };
+}
+/** Mock nested recipe execution for dry-run mode */
+export async function mockNestedRecipe(config, context) {
+    const validation = validateNestedRecipe(config, context);
+    if (!validation.valid) {
+        return { success: false, error: validation.error };
+    }
+    // Resolve templates to show what would be passed
+    const parentContext = context.parentRegistry.toTemplateContext(context.parentEnv);
+    const { resolved, errors } = resolveNestedVars(config.vars, parentContext);
+    if (errors.length > 0) {
+        return {
+            success: false,
+            error: `Template errors: ${errors.map((e) => e.message).join(", ")}`,
+        };
+    }
+    return {
+        success: true,
+        data: {
+            dryRun: true,
+            recipe: config.recipe,
+            resolvedVars: resolved,
+            effectiveRisk: calculateNestedRisk(undefined, config.risk),
+            wouldExecuteAtDepth: context.currentDepth + 1,
+        },
+    };
+}
+//# sourceMappingURL=nestedRecipeStep.js.map

package/dist/recipes/nestedRecipeStep.js.map

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

package/dist/recipes/outputRegistry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * OutputRegistry — per-recipe-run state container for step outputs.
+ *
+ * Isolated from other runs, no persistence. Used by template engine
+ * to resolve {{steps.X.data.field}} references.
+ */
+import type { StepOutput, TemplateContext } from "./templateEngine.js";
+export interface OutputRegistry {
+    /** Store output from a completed step */
+    set(stepId: string, output: StepOutput): void;
+    /** Get output for a step, or undefined if not yet run */
+    get(stepId: string): StepOutput | undefined;
+    /** Check if a step has completed */
+    has(stepId: string): boolean;
+    /** Get all step IDs that have outputs */
+    keys(): string[];
+    /** Convert to TemplateContext for template resolution */
+    toTemplateContext(env: Record<string, string | undefined>): TemplateContext;
+    /** Summary for logging/debugging */
+    summary(): {
+        total: number;
+        succeeded: number;
+        failed: number;
+        skipped: number;
+    };
+}
+/** Create a new isolated OutputRegistry for a recipe run */
+export declare function createOutputRegistry(): OutputRegistry;

package/dist/recipes/outputRegistry.js

@@ -0,0 +1,52 @@
+/**
+ * OutputRegistry — per-recipe-run state container for step outputs.
+ *
+ * Isolated from other runs, no persistence. Used by template engine
+ * to resolve {{steps.X.data.field}} references.
+ */
+class OutputRegistryImpl {
+    outputs = new Map();
+    set(stepId, output) {
+        this.outputs.set(stepId, output);
+    }
+    get(stepId) {
+        return this.outputs.get(stepId);
+    }
+    has(stepId) {
+        return this.outputs.has(stepId);
+    }
+    keys() {
+        return Array.from(this.outputs.keys());
+    }
+    toTemplateContext(env) {
+        const steps = {};
+        for (const [key, value] of this.outputs) {
+            steps[key] = value;
+        }
+        return { steps, env };
+    }
+    summary() {
+        let succeeded = 0;
+        let failed = 0;
+        let skipped = 0;
+        for (const output of this.outputs.values()) {
+            if (output.status === "success")
+                succeeded++;
+            else if (output.status === "error")
+                failed++;
+            else if (output.status === "skipped")
+                skipped++;
+        }
+        return {
+            total: this.outputs.size,
+            succeeded,
+            failed,
+            skipped,
+        };
+    }
+}
+/** Create a new isolated OutputRegistry for a recipe run */
+export function createOutputRegistry() {
+    return new OutputRegistryImpl();
+}
+//# sourceMappingURL=outputRegistry.js.map

package/dist/recipes/outputRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputRegistry.js","sourceRoot":"","sources":["../../src/recipes/outputRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,MAAM,kBAAkB;IACd,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEhD,GAAG,CAAC,MAAc,EAAE,MAAkB;QACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,iBAAiB,CAAC,GAAuC;QACvD,MAAM,KAAK,GAA+B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACxB,CAAC;IAED,OAAO;QAML,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;gBAAE,SAAS,EAAE,CAAC;iBACxC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;gBAAE,MAAM,EAAE,CAAC;iBACxC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC;QAClD,CAAC;QACD,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACxB,SAAS;YACT,MAAM;YACN,OAAO;SACR,CAAC;IACJ,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,kBAAkB,EAAE,CAAC;AAClC,CAAC"}

package/dist/recipes/scheduler.d.ts

@@ -1,10 +1,12 @@
+import cron from "node-cron";
 import type { Logger } from "../logger.js";
 /**
- * RecipeScheduler — runs cron-triggered recipes on a simple interval.
+ * RecipeScheduler — runs cron-triggered recipes on a simple interval or
+ * standard 5-field cron expression.
  *
- * Phase-0 scope supports the `@every Ns|Nm|Nh` schedule form, which is
- * enough to demonstrate "works while you're away" without pulling in a full
- * cron dependency. Standard 5-field expressions can be added later.
+ * Supported schedule forms:
+ *   @every Ns|Nm|Nh  — simple interval (setInterval-based)
+ *   <5-field cron>   — standard cron expression (node-cron-based)
  *
  * Scheduler is a pure consumer of the recipes-on-disk contract and an
  * injected enqueue fn, so it's trivial to unit test without the orchestrator.
@@ -13,15 +15,20 @@ export type SchedulerEnqueue = (opts: {
     prompt: string;
     triggerSource: string;
 }) => string;
+export type SchedulerRunYaml = (name: string) => Promise<void>;
 export interface ScheduledRecipe {
     name: string;
     schedule: string;
     intervalMs: number;
     timer: ReturnType<typeof setInterval>;
+    /** Present only for cron5-kind recipes. */
+    cronJob?: cron.ScheduledTask;
 }
 export interface SchedulerOptions {
     recipesDir: string;
     enqueue: SchedulerEnqueue;
+    /** Called for YAML recipes instead of enqueue. */
+    runYaml?: SchedulerRunYaml;
     logger?: Logger;
     /** Override for tests — defaults to setInterval. */
     setInterval?: typeof setInterval;
@@ -36,10 +43,19 @@ export declare class RecipeScheduler {
     constructor(opts: SchedulerOptions);
     start(): ScheduledRecipe[];
     stop(): void;
-    list(): ReadonlyArray<Omit<ScheduledRecipe, "timer">>;
+    restart(): void;
+    list(): ReadonlyArray<Omit<ScheduledRecipe, "timer" | "cronJob">>;
     /** Test hook: dispatch a recipe immediately without waiting for the interval. */
     fireForTest(name: string): void;
     private fire;
 }
-/** Parse @every forms into milliseconds. Returns null for unsupported schedules. */
-export declare function parseSchedule(schedule: string): number | null;
+type ParsedSchedule = {
+    kind: "interval";
+    intervalMs: number;
+} | {
+    kind: "cron5";
+    expression: string;
+};
+/** Parse @every forms into milliseconds, or detect a 5-field cron expression. Returns null for unsupported schedules. */
+export declare function parseSchedule(schedule: string): ParsedSchedule | null;
+export {};