patchwork-os 0.2.0-alpha.3 → 0.2.0-alpha.31

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 {};

package/dist/recipes/scheduler.js

@@ -1,6 +1,9 @@
 import { readdirSync, readFileSync } from "node:fs";
 import path from "node:path";
-import { loadRecipePrompt } from "../recipesHttp.js";
+import cron from "node-cron";
+import { parse as parseYaml } from "yaml";
+import { loadConfig } from "../patchworkConfig.js";
+import { findYamlRecipePath, loadRecipePrompt } from "../recipesHttp.js";
 export class RecipeScheduler {
     opts;
     scheduled = [];
@@ -13,6 +16,17 @@ export class RecipeScheduler {
     }
     start() {
         this.stop();
+        // Load disabled list from config
+        let disabled = new Set();
+        try {
+            const cfg = loadConfig();
+            if (cfg.recipes?.disabled) {
+                disabled = new Set(cfg.recipes.disabled);
+            }
+        }
+        catch {
+            // non-fatal — proceed with empty disabled set
+        }
         let entries;
         try {
             entries = readdirSync(this.opts.recipesDir);
@@ -21,35 +35,80 @@ export class RecipeScheduler {
             return [];
         }
         for (const f of entries) {
-            if (!f.endsWith(".json") || f.endsWith(".permissions.json"))
+            const isJson = f.endsWith(".json") && !f.endsWith(".permissions.json");
+            const isYaml = f.endsWith(".yaml") || f.endsWith(".yml");
+            if (!isJson && !isYaml)
                 continue;
             const fullPath = path.join(this.opts.recipesDir, f);
             try {
-                const raw = readFileSync(fullPath, "utf-8");
-                const parsed = JSON.parse(raw);
-                if (parsed.trigger?.type !== "cron")
-                    continue;
-                if (!parsed.trigger.schedule ||
-                    typeof parsed.trigger.schedule !== "string")
+                let name;
+                let schedule;
+                if (isJson) {
+                    const raw = readFileSync(fullPath, "utf-8");
+                    const parsed = JSON.parse(raw);
+                    if (parsed.trigger?.type !== "cron")
+                        continue;
+                    if (!parsed.trigger.schedule ||
+                        typeof parsed.trigger.schedule !== "string")
+                        continue;
+                    schedule = parsed.trigger.schedule;
+                    name = parsed.name ?? path.basename(f, ".json");
+                }
+                else {
+                    // YAML
+                    const raw = readFileSync(fullPath, "utf-8");
+                    const parsed = parseYaml(raw);
+                    if (parsed.trigger?.type !== "cron")
+                        continue;
+                    schedule = parsed.trigger.at ?? parsed.trigger.schedule;
+                    if (!schedule || typeof schedule !== "string")
+                        continue;
+                    name =
+                        parsed.name ?? path.basename(f, isYaml ? path.extname(f) : ".yaml");
+                }
+                // Apply disabled filter
+                if (disabled.has(name)) {
+                    this.opts.logger?.info?.(`[scheduler] skipping disabled recipe "${name}"`);
                     continue;
-                const intervalMs = parseSchedule(parsed.trigger.schedule);
-                if (intervalMs === null) {
-                    this.opts.logger?.warn?.(`[scheduler] ignoring recipe "${parsed.name ?? f}" — unsupported schedule "${parsed.trigger.schedule}" (use @every Ns|Nm|Nh)`);
+                }
+                const parsed2 = parseSchedule(schedule);
+                if (parsed2 === null) {
+                    this.opts.logger?.warn?.(`[scheduler] ignoring recipe "${name}" — unsupported schedule "${schedule}" (use @every Ns|Nm|Nh or a 5-field cron expression)`);
                     continue;
                 }
-                const name = parsed.name ?? path.basename(f, ".json");
-                const timer = this.setIntervalFn(() => {
-                    this.fire(name);
-                }, intervalMs);
-                if (typeof timer === "object" && "unref" in timer)
-                    timer.unref();
-                this.scheduled.push({
-                    name,
-                    schedule: parsed.trigger.schedule,
-                    intervalMs,
-                    timer,
-                });
-                this.opts.logger?.info?.(`[scheduler] "${name}" scheduled every ${intervalMs}ms (${parsed.trigger.schedule})`);
+                if (parsed2.kind === "interval") {
+                    const intervalMs = parsed2.intervalMs;
+                    const timer = this.setIntervalFn(() => {
+                        this.fire(name);
+                    }, intervalMs);
+                    if (typeof timer === "object" && "unref" in timer)
+                        timer.unref();
+                    this.scheduled.push({
+                        name,
+                        schedule,
+                        intervalMs,
+                        timer,
+                    });
+                    this.opts.logger?.info?.(`[scheduler] "${name}" scheduled every ${intervalMs}ms (${schedule})`);
+                }
+                else {
+                    // cron5
+                    const cronJob = cron.schedule(parsed2.expression, () => {
+                        this.fire(name);
+                    });
+                    // Store a sentinel timer so the ScheduledRecipe shape stays stable
+                    const dummyTimer = this.setIntervalFn(() => { }, 2_147_483_647);
+                    if (typeof dummyTimer === "object" && "unref" in dummyTimer)
+                        dummyTimer.unref();
+                    this.scheduled.push({
+                        name,
+                        schedule,
+                        intervalMs: 0,
+                        timer: dummyTimer,
+                        cronJob,
+                    });
+                    this.opts.logger?.info?.(`[scheduler] "${name}" scheduled with cron expression "${schedule}"`);
+                }
             }
             catch {
                 // skip malformed recipe
@@ -59,18 +118,41 @@ export class RecipeScheduler {
     }
     stop() {
         for (const entry of this.scheduled) {
-            this.clearIntervalFn(entry.timer);
+            if (entry.cronJob) {
+                entry.cronJob.stop();
+            }
+            else {
+                this.clearIntervalFn(entry.timer);
+            }
         }
         this.scheduled = [];
     }
+    restart() {
+        this.stop();
+        this.start();
+    }
     list() {
-        return this.scheduled.map(({ timer: _t, ...rest }) => rest);
+        return this.scheduled.map(({ timer: _t, cronJob: _c, ...rest }) => rest);
     }
     /** Test hook: dispatch a recipe immediately without waiting for the interval. */
     fireForTest(name) {
         this.fire(name);
     }
     fire(name) {
+        // YAML recipe — delegate to runYaml if provided
+        const yamlPath = findYamlRecipePath(this.opts.recipesDir, name);
+        if (yamlPath) {
+            if (!this.opts.runYaml) {
+                this.opts.logger?.warn?.(`[scheduler] skipped "${name}" — YAML recipe requires runYaml callback (start bridge with --claude-driver)`);
+                return;
+            }
+            this.opts.runYaml(name).catch((err) => {
+                this.opts.logger?.warn?.(`[scheduler] YAML recipe "${name}" failed: ${err instanceof Error ? err.message : String(err)}`);
+            });
+            this.opts.logger?.info?.(`[scheduler] fired YAML recipe "${name}"`);
+            return;
+        }
+        // JSON recipe — legacy path
         const loaded = loadRecipePrompt(this.opts.recipesDir, name);
         if (!loaded) {
             this.opts.logger?.warn?.(`[scheduler] skipped "${name}" — recipe file disappeared`);
@@ -88,23 +170,31 @@ export class RecipeScheduler {
         }
     }
 }
-/** Parse @every forms into milliseconds. Returns null for unsupported schedules. */
+/** Parse @every forms into milliseconds, or detect a 5-field cron expression. Returns null for unsupported schedules. */
 export function parseSchedule(schedule) {
     const trimmed = schedule.trim();
+    // @every Ns|Nm|Nh
     const m = /^@every\s+(\d+)\s*(ms|s|m|h)$/i.exec(trimmed);
-    if (!m)
-        return null;
-    const n = Number.parseInt(m[1], 10);
-    const unit = m[2].toLowerCase();
-    if (!Number.isFinite(n) || n <= 0)
-        return null;
-    const multiplier = unit === "ms"
-        ? 1
-        : unit === "s"
-            ? 1000
-            : unit === "m"
-                ? 60_000
-                : 60 * 60_000;
-    return n * multiplier;
+    if (m) {
+        const n = Number.parseInt(m[1], 10);
+        const unit = m[2]?.toLowerCase();
+        if (!Number.isFinite(n) || n <= 0)
+            return null;
+        const multiplier = unit === "ms"
+            ? 1
+            : unit === "s"
+                ? 1000
+                : unit === "m"
+                    ? 60_000
+                    : 60 * 60_000;
+        return { kind: "interval", intervalMs: n * multiplier };
+    }
+    // 5-field cron expression (e.g. "0 8 * * 1-5")
+    if (/^\S+\s+\S+\s+\S+\s+\S+\s+\S+$/.test(trimmed)) {
+        if (cron.validate(trimmed)) {
+            return { kind: "cron5", expression: trimmed };
+        }
+    }
+    return null;
 }
 //# sourceMappingURL=scheduler.js.map

package/dist/recipes/scheduler.js.map

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

package/dist/recipes/schema.d.ts

@@ -55,10 +55,25 @@ export interface ToolStep {
     output?: string;
 }
 export type Step = AgentStep | ToolStep;
+/**
+ * Recipe-level error policy. Single source of truth shared across
+ * chainedRunner, yamlRunner, and generated JSON schema.
+ *
+ * Currently-honored fields at runtime:
+ *   - retry        — integer; overridden per-step via step.retry
+ *   - retryDelay   — ms between retries (default 1000); overridden per-step
+ *   - fallback     — "log_only" and "deliver_original" both treat step
+ *                    failure as non-fatal (like optional: true) — fail-open.
+ *                    "abort" is the default (propagate).
+ *   - notify       — reserved; yamlRunner currently posts Slack notifications
+ *                    on any step failure when slack is connected. Gating on
+ *                    this flag is not yet wired.
+ */
 export interface ErrorPolicy {
-    notify?: boolean;
     retry?: number;
-    fallback?: "log_only" | "abort" | string;
+    retryDelay?: number;
+    fallback?: "log_only" | "abort" | "deliver_original";
+    notify?: boolean;
 }
 export interface Recipe {
     name: string;

package/dist/recipes/schemaGenerator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Schema Generator — produces JSON Schema from tool registry.
+ *
+ * Generates composable schemas for editor autocomplete:
+ *   - schemas/recipe.v1.json — top-level recipe schema
+ *   - schemas/tools/<namespace>.json — per-namespace tool param schemas
+ */
+export interface SchemaSet {
+    /** Top-level recipe schema */
+    recipe: unknown;
+    /** Per-namespace tool schemas */
+    namespaces: Record<string, unknown>;
+    /** Dry-run plan JSON schema (machine-readable contract for `recipe run --dry-run` output) */
+    dryRunPlan: unknown;
+}
+/**
+ * Generate complete schema set from current registry state.
+ */
+export declare function generateSchemaSet(): SchemaSet;
+/**
+ * JSON Schema for RecipeDryRunPlan. Consumers (dashboard run timeline, external CI)
+ * should pin on `schemaVersion` and validate against this.
+ */
+export declare function generateDryRunPlanSchema(): unknown;
+/**
+ * Write schema files to disk.
+ */
+export declare function writeSchemas(outputDir: string, schemas: SchemaSet, writeFile: (path: string, content: string) => Promise<void> | void): Promise<void>;