patchwork-os 0.2.0-alpha.0

package/dist/recipes/parser.js

@@ -0,0 +1,160 @@
+/**
+ * parseRecipe — validates a raw object and returns a typed Recipe.
+ *
+ * Phase-1 scope: JSON in, Recipe out. YAML support lands when a real recipe
+ * needs it (add `yaml` dep + pre-parse step; schema unchanged).
+ */
+export class RecipeParseError extends Error {
+    path;
+    constructor(message, path = []) {
+        super(path.length ? `${path.join(".")}: ${message}` : message);
+        this.path = path;
+        this.name = "RecipeParseError";
+    }
+}
+export function parseRecipe(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        throw new RecipeParseError("recipe must be an object");
+    }
+    const r = raw;
+    const name = requireString(r, "name");
+    const version = requireString(r, "version");
+    const trigger = parseTrigger(r.trigger);
+    const stepsRaw = r.steps;
+    if (!Array.isArray(stepsRaw) || stepsRaw.length === 0) {
+        throw new RecipeParseError("steps must be a non-empty array", ["steps"]);
+    }
+    const ids = new Set();
+    const steps = stepsRaw.map((s, i) => {
+        const step = parseStep(s, ["steps", String(i)]);
+        if (ids.has(step.id)) {
+            throw new RecipeParseError(`duplicate step id '${step.id}'`, [
+                "steps",
+                String(i),
+            ]);
+        }
+        ids.add(step.id);
+        return step;
+    });
+    return {
+        name,
+        version,
+        description: typeof r.description === "string" ? r.description : undefined,
+        trigger,
+        context: Array.isArray(r.context)
+            ? r.context
+            : undefined,
+        steps,
+        on_error: typeof r.on_error === "object" && r.on_error !== null
+            ? r.on_error
+            : undefined,
+    };
+}
+function requireString(o, key) {
+    const v = o[key];
+    if (typeof v !== "string" || !v)
+        throw new RecipeParseError(`missing or empty '${key}'`, [key]);
+    return v;
+}
+function parseTrigger(raw) {
+    if (typeof raw !== "object" || raw === null)
+        throw new RecipeParseError("trigger required", ["trigger"]);
+    const t = raw;
+    switch (t.type) {
+        case "webhook":
+            if (typeof t.path !== "string" || !t.path.startsWith("/"))
+                throw new RecipeParseError("webhook.path must start with /", [
+                    "trigger",
+                    "path",
+                ]);
+            return { type: "webhook", path: t.path };
+        case "cron":
+            if (typeof t.schedule !== "string" || !t.schedule.trim())
+                throw new RecipeParseError("cron.schedule required", [
+                    "trigger",
+                    "schedule",
+                ]);
+            return { type: "cron", schedule: t.schedule };
+        case "file_watch":
+            if (!Array.isArray(t.patterns) || t.patterns.length === 0)
+                throw new RecipeParseError("file_watch.patterns required", [
+                    "trigger",
+                    "patterns",
+                ]);
+            return {
+                type: "file_watch",
+                patterns: t.patterns.filter((p) => typeof p === "string"),
+            };
+        case "git_hook":
+            if (t.event !== "post-commit" &&
+                t.event !== "pre-push" &&
+                t.event !== "post-merge")
+                throw new RecipeParseError("invalid git_hook.event", [
+                    "trigger",
+                    "event",
+                ]);
+            return { type: "git_hook", event: t.event };
+        case "manual":
+            return { type: "manual" };
+        default:
+            throw new RecipeParseError(`unknown trigger type '${String(t.type)}'`, [
+                "trigger",
+                "type",
+            ]);
+    }
+}
+function parseStep(raw, path) {
+    if (typeof raw !== "object" || raw === null)
+        throw new RecipeParseError("step must be an object", path);
+    const s = raw;
+    const id = requireString(s, "id");
+    if (s.agent === true) {
+        const prompt = requireString(s, "prompt");
+        return {
+            id,
+            agent: true,
+            prompt,
+            tools: Array.isArray(s.tools) ? s.tools : undefined,
+            risk: s.risk,
+            output: typeof s.output === "string" ? s.output : undefined,
+        };
+    }
+    if (s.agent === false) {
+        const tool = requireString(s, "tool");
+        return {
+            id,
+            agent: false,
+            tool,
+            params: typeof s.params === "object" && s.params !== null
+                ? s.params
+                : {},
+            risk: s.risk,
+            output: typeof s.output === "string" ? s.output : undefined,
+        };
+    }
+    throw new RecipeParseError("step.agent must be true or false", [
+        ...path,
+        "agent",
+    ]);
+}
+/**
+ * Render `{{ path.to.value }}` templates against a flat context map.
+ * Whitespace-tolerant. Missing keys render as "". Does NOT touch double-brace
+ * inside quoted strings specially — this is a minimal renderer by design.
+ */
+export function renderTemplate(input, context) {
+    return input.replace(/\{\{\s*([^}]+?)\s*\}\}/g, (_, expr) => {
+        const parts = expr.split(".").map((s) => s.trim());
+        let cur = context;
+        for (const p of parts) {
+            if (cur && typeof cur === "object" && p in cur) {
+                cur = cur[p];
+            }
+            else {
+                return "";
+            }
+        }
+        return cur === undefined || cur === null ? "" : String(cur);
+    });
+}
+//# sourceMappingURL=parser.js.map

package/dist/recipes/parser.js.map

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

package/dist/recipes/scheduler.d.ts

@@ -0,0 +1,45 @@
+import type { Logger } from "../logger.js";
+/**
+ * RecipeScheduler — runs cron-triggered recipes on a simple interval.
+ *
+ * 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.
+ *
+ * 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.
+ */
+export type SchedulerEnqueue = (opts: {
+    prompt: string;
+    triggerSource: string;
+}) => string;
+export interface ScheduledRecipe {
+    name: string;
+    schedule: string;
+    intervalMs: number;
+    timer: ReturnType<typeof setInterval>;
+}
+export interface SchedulerOptions {
+    recipesDir: string;
+    enqueue: SchedulerEnqueue;
+    logger?: Logger;
+    /** Override for tests — defaults to setInterval. */
+    setInterval?: typeof setInterval;
+    /** Override for tests — defaults to clearInterval. */
+    clearInterval?: typeof clearInterval;
+}
+export declare class RecipeScheduler {
+    private readonly opts;
+    private scheduled;
+    private readonly setIntervalFn;
+    private readonly clearIntervalFn;
+    constructor(opts: SchedulerOptions);
+    start(): ScheduledRecipe[];
+    stop(): void;
+    list(): ReadonlyArray<Omit<ScheduledRecipe, "timer">>;
+    /** 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;

package/dist/recipes/scheduler.js

@@ -0,0 +1,110 @@
+import { readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { loadRecipePrompt } from "../recipesHttp.js";
+export class RecipeScheduler {
+    opts;
+    scheduled = [];
+    setIntervalFn;
+    clearIntervalFn;
+    constructor(opts) {
+        this.opts = opts;
+        this.setIntervalFn = opts.setInterval ?? setInterval;
+        this.clearIntervalFn = opts.clearInterval ?? clearInterval;
+    }
+    start() {
+        this.stop();
+        let entries;
+        try {
+            entries = readdirSync(this.opts.recipesDir);
+        }
+        catch {
+            return [];
+        }
+        for (const f of entries) {
+            if (!f.endsWith(".json") || f.endsWith(".permissions.json"))
+                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")
+                    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)`);
+                    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})`);
+            }
+            catch {
+                // skip malformed recipe
+            }
+        }
+        return this.scheduled;
+    }
+    stop() {
+        for (const entry of this.scheduled) {
+            this.clearIntervalFn(entry.timer);
+        }
+        this.scheduled = [];
+    }
+    list() {
+        return this.scheduled.map(({ timer: _t, ...rest }) => rest);
+    }
+    /** Test hook: dispatch a recipe immediately without waiting for the interval. */
+    fireForTest(name) {
+        this.fire(name);
+    }
+    fire(name) {
+        const loaded = loadRecipePrompt(this.opts.recipesDir, name);
+        if (!loaded) {
+            this.opts.logger?.warn?.(`[scheduler] skipped "${name}" — recipe file disappeared`);
+            return;
+        }
+        try {
+            this.opts.enqueue({
+                prompt: loaded.prompt,
+                triggerSource: `cron:${name}`,
+            });
+            this.opts.logger?.info?.(`[scheduler] enqueued "${name}"`);
+        }
+        catch (err) {
+            this.opts.logger?.warn?.(`[scheduler] failed to enqueue "${name}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+/** Parse @every forms into milliseconds. Returns null for unsupported schedules. */
+export function parseSchedule(schedule) {
+    const trimmed = schedule.trim();
+    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;
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/recipes/scheduler.js.map

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

package/dist/recipes/schema.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Patchwork Recipe schema — the user-authored workflow description.
+ *
+ * Phase 2 plan: YAML files at ~/.patchwork/recipes/*.yaml parse into this
+ * shape, then compile into the bridge's AutomationProgram DSL.
+ *
+ * Phase-1 scaffold: JSON-only parsing (no YAML lib dep yet). YAML frontmatter
+ * loader lands when a recipe requires it.
+ */
+export type TriggerType = "webhook" | "cron" | "file_watch" | "git_hook" | "manual";
+export interface WebhookTrigger {
+    type: "webhook";
+    path: string;
+}
+export interface CronTrigger {
+    type: "cron";
+    schedule: string;
+}
+export interface FileWatchTrigger {
+    type: "file_watch";
+    patterns: string[];
+}
+export interface GitHookTrigger {
+    type: "git_hook";
+    event: "post-commit" | "pre-push" | "post-merge";
+}
+export interface ManualTrigger {
+    type: "manual";
+}
+export type Trigger = WebhookTrigger | CronTrigger | FileWatchTrigger | GitHookTrigger | ManualTrigger;
+export interface FileContext {
+    type: "file";
+    path: string;
+}
+export interface EnvContext {
+    type: "env";
+    keys: string[];
+}
+export type ContextBlock = FileContext | EnvContext;
+export type RiskTier = "low" | "medium" | "high";
+export interface AgentStep {
+    id: string;
+    agent: true;
+    prompt: string;
+    tools?: string[];
+    risk?: RiskTier;
+    output?: string;
+}
+export interface ToolStep {
+    id: string;
+    agent: false;
+    tool: string;
+    params: Record<string, unknown>;
+    risk?: RiskTier;
+    output?: string;
+}
+export type Step = AgentStep | ToolStep;
+export interface ErrorPolicy {
+    notify?: boolean;
+    retry?: number;
+    fallback?: "log_only" | "abort" | string;
+}
+export interface Recipe {
+    name: string;
+    version: string;
+    description?: string;
+    trigger: Trigger;
+    context?: ContextBlock[];
+    steps: Step[];
+    on_error?: ErrorPolicy;
+}

package/dist/recipes/schema.js

@@ -0,0 +1,11 @@
+/**
+ * Patchwork Recipe schema — the user-authored workflow description.
+ *
+ * Phase 2 plan: YAML files at ~/.patchwork/recipes/*.yaml parse into this
+ * shape, then compile into the bridge's AutomationProgram DSL.
+ *
+ * Phase-1 scaffold: JSON-only parsing (no YAML lib dep yet). YAML frontmatter
+ * loader lands when a recipe requires it.
+ */
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/recipes/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/recipes/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/recipesHttp.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Patchwork recipes HTTP surface — reads installed recipes from disk so the
+ * dashboard Recipes page can list what's available. The bridge does not yet
+ * run recipes natively; this endpoint is strictly read-only today.
+ */
+export interface RecipeDraft {
+    name: string;
+    description?: string;
+    trigger: {
+        type: "manual" | "webhook" | "schedule";
+        path?: string;
+        cron?: string;
+    };
+    steps: Array<{
+        id: string;
+        kind: "prompt";
+        prompt: string;
+    }>;
+}
+export declare function saveRecipe(recipesDir: string, draft: RecipeDraft): {
+    ok: boolean;
+    path?: string;
+    error?: string;
+};
+export interface RecipeSummary {
+    name: string;
+    description?: string;
+    trigger?: string;
+    stepCount: number;
+    path: string;
+    installedAt: number;
+    hasPermissions: boolean;
+    source: "user" | "project" | "unknown";
+}
+export interface ListRecipesResult {
+    recipesDir: string;
+    recipes: RecipeSummary[];
+}
+export declare function listInstalledRecipes(recipesDir: string): ListRecipesResult;
+/**
+ * Scan recipes and return the first webhook-triggered recipe whose
+ * trigger.path matches the requested path. Returns null on miss.
+ * Path match is exact (leading-slash required) — no wildcards yet.
+ */
+export declare function findWebhookRecipe(recipesDir: string, requestPath: string): {
+    name: string;
+    path: string;
+} | null;
+/**
+ * Load a recipe by name and render a plain-text prompt suitable for
+ * enqueueing to the Claude orchestrator. Returns null when the recipe
+ * can't be found.
+ */
+export declare function loadRecipePrompt(recipesDir: string, name: string): {
+    prompt: string;
+    path: string;
+} | null;
+/**
+ * Append a webhook payload to a base prompt so the agent can reference
+ * the request body. Payload is JSON-stringified and truncated so a
+ * runaway caller can't blow up the orchestrator prompt budget.
+ */
+export declare function renderWebhookPrompt(basePrompt: string, payload: unknown): string;

package/dist/recipesHttp.js

@@ -0,0 +1,183 @@
+import { mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import path from "node:path";
+export function saveRecipe(recipesDir, draft) {
+    const safeName = draft.name.toLowerCase().replace(/\s+/g, "-");
+    if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(safeName)) {
+        return { ok: false, error: "Invalid recipe name" };
+    }
+    const candidate = path.resolve(recipesDir, `${safeName}.json`);
+    const base = path.resolve(recipesDir);
+    if (!candidate.startsWith(base + path.sep)) {
+        return { ok: false, error: "Invalid path" };
+    }
+    try {
+        mkdirSync(recipesDir, { recursive: true });
+        const payload = {
+            name: safeName,
+            description: draft.description,
+            trigger: draft.trigger,
+            steps: draft.steps,
+            createdAt: Date.now(),
+        };
+        writeFileSync(candidate, JSON.stringify(payload, null, 2), "utf-8");
+        return { ok: true, path: candidate };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+export function listInstalledRecipes(recipesDir) {
+    let entries;
+    try {
+        entries = readdirSync(recipesDir);
+    }
+    catch {
+        return { recipesDir, recipes: [] };
+    }
+    const recipes = [];
+    for (const f of entries) {
+        if (!f.endsWith(".json") || f.endsWith(".permissions.json"))
+            continue;
+        const fullPath = path.join(recipesDir, f);
+        try {
+            const raw = readFileSync(fullPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            const stat = statSync(fullPath);
+            const permsPath = `${fullPath}.permissions.json`;
+            let hasPermissions = false;
+            try {
+                statSync(permsPath);
+                hasPermissions = true;
+            }
+            catch {
+                // no permissions sidecar
+            }
+            const resolvedRecipesDir = path.resolve(recipesDir);
+            let source;
+            if (fullPath.startsWith(resolvedRecipesDir + path.sep) ||
+                fullPath === resolvedRecipesDir) {
+                source = "user";
+            }
+            else if (fullPath.includes(`${path.sep}.patchwork${path.sep}recipes`)) {
+                source = "project";
+            }
+            else {
+                source = "unknown";
+            }
+            recipes.push({
+                name: parsed.name ?? path.basename(f, ".json"),
+                description: parsed.description,
+                trigger: parsed.trigger?.type,
+                stepCount: Array.isArray(parsed.steps) ? parsed.steps.length : 0,
+                path: fullPath,
+                installedAt: stat.mtimeMs,
+                hasPermissions,
+                source,
+            });
+        }
+        catch {
+            // skip malformed recipe file
+        }
+    }
+    recipes.sort((a, b) => a.name.localeCompare(b.name));
+    return { recipesDir, recipes };
+}
+/**
+ * Scan recipes and return the first webhook-triggered recipe whose
+ * trigger.path matches the requested path. Returns null on miss.
+ * Path match is exact (leading-slash required) — no wildcards yet.
+ */
+export function findWebhookRecipe(recipesDir, requestPath) {
+    let entries;
+    try {
+        entries = readdirSync(recipesDir);
+    }
+    catch {
+        return null;
+    }
+    for (const f of entries) {
+        if (!f.endsWith(".json") || f.endsWith(".permissions.json"))
+            continue;
+        try {
+            const raw = readFileSync(path.join(recipesDir, f), "utf-8");
+            const parsed = JSON.parse(raw);
+            if (parsed.trigger?.type !== "webhook")
+                continue;
+            if (parsed.trigger.path === requestPath) {
+                return {
+                    name: parsed.name ?? path.basename(f, ".json"),
+                    path: requestPath,
+                };
+            }
+        }
+        catch {
+            // skip malformed
+        }
+    }
+    return null;
+}
+/**
+ * Load a recipe by name and render a plain-text prompt suitable for
+ * enqueueing to the Claude orchestrator. Returns null when the recipe
+ * can't be found.
+ */
+export function loadRecipePrompt(recipesDir, name) {
+    const safeName = name.toLowerCase();
+    if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(safeName))
+        return null;
+    const candidate = path.resolve(recipesDir, `${safeName}.json`);
+    const base = path.resolve(recipesDir);
+    if (!candidate.startsWith(base + path.sep))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(candidate, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    const parsed = JSON.parse(raw);
+    const lines = [];
+    lines.push(`You are running the Patchwork recipe "${parsed.name ?? name}".`);
+    if (parsed.description)
+        lines.push(`\nRecipe description: ${parsed.description}`);
+    if (Array.isArray(parsed.steps) && parsed.steps.length > 0) {
+        lines.push("\nCarry out each step in order and report progress after every step:\n");
+        for (let i = 0; i < parsed.steps.length; i++) {
+            const s = parsed.steps[i];
+            if (!s)
+                continue;
+            const label = s.id ?? `step-${i + 1}`;
+            const body = s.prompt ??
+                s.description ??
+                (s.tool ? `Use tool ${s.tool}.` : "(no description)");
+            lines.push(`${i + 1}. [${label}] ${body}`);
+        }
+    }
+    lines.push("\nWhen finished, print a one-line summary prefixed with 'RECIPE DONE:'.");
+    return { prompt: lines.join("\n"), path: candidate };
+}
+/**
+ * Append a webhook payload to a base prompt so the agent can reference
+ * the request body. Payload is JSON-stringified and truncated so a
+ * runaway caller can't blow up the orchestrator prompt budget.
+ */
+export function renderWebhookPrompt(basePrompt, payload) {
+    if (payload === undefined)
+        return basePrompt;
+    const MAX = 8_000;
+    let body;
+    try {
+        body = JSON.stringify(payload, null, 2);
+    }
+    catch {
+        body = String(payload);
+    }
+    if (body.length > MAX)
+        body = `${body.slice(0, MAX)}\n…[truncated]`;
+    return `${basePrompt}\n\nWebhook payload:\n\`\`\`json\n${body}\n\`\`\``;
+}
+//# sourceMappingURL=recipesHttp.js.map