patchwork-os 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/commands/patchworkInit.js

@@ -1,4 +1,6 @@
-import { copyFileSync, existsSync, mkdirSync, readdirSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -49,6 +51,59 @@ What it does:
   5. Print next steps
 `);
 }
+function findDashboardDir() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(here, "..", "..", "dashboard"),
+        join(here, "..", "..", "..", "dashboard"),
+    ];
+    for (const c of candidates) {
+        if (existsSync(join(c, "package.json")))
+            return c;
+    }
+    return null;
+}
+export function ensureDashboardEnv(patchworkDir) {
+    const envPath = join(patchworkDir, ".env");
+    let existing = "";
+    if (existsSync(envPath))
+        existing = readFileSync(envPath, "utf8");
+    const hasPassword = /^DASHBOARD_PASSWORD=.+$/m.test(existing);
+    const hasSecret = /^DASHBOARD_SESSION_SECRET=.+$/m.test(existing);
+    if (hasPassword && hasSecret)
+        return { password: "[already set]", generated: false };
+    const password = randomBytes(8).toString("hex");
+    const secret = randomBytes(32).toString("hex");
+    const additions = [];
+    if (!hasPassword)
+        additions.push(`DASHBOARD_PASSWORD=${password}`);
+    if (!hasSecret)
+        additions.push(`DASHBOARD_SESSION_SECRET=${secret}`);
+    const sep = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+    writeFileSync(envPath, `${existing + sep + additions.join("\n")}\n`, {
+        mode: 0o600,
+    });
+    // Also write dashboard/.env.local so Next.js picks up credentials without start-all sourcing
+    const dashDir = findDashboardDir();
+    if (dashDir) {
+        const localPath = join(dashDir, ".env.local");
+        let local = existsSync(localPath) ? readFileSync(localPath, "utf8") : "";
+        if (/^DASHBOARD_PASSWORD=/m.test(local)) {
+            local = local.replace(/^DASHBOARD_PASSWORD=.*$/m, `DASHBOARD_PASSWORD=${password}`);
+        }
+        else {
+            local += `${local.endsWith("\n") ? "" : "\n"}DASHBOARD_PASSWORD=${password}\n`;
+        }
+        if (/^DASHBOARD_SESSION_SECRET=/m.test(local)) {
+            local = local.replace(/^DASHBOARD_SESSION_SECRET=.*$/m, `DASHBOARD_SESSION_SECRET=${secret}`);
+        }
+        else {
+            local += `DASHBOARD_SESSION_SECRET=${secret}\n`;
+        }
+        writeFileSync(localPath, local, { mode: 0o600 });
+    }
+    return { password, generated: true };
+}
 function findTemplatesDir() {
     const here = dirname(fileURLToPath(import.meta.url));
     // dist/commands/patchworkInit.js → ../../templates/recipes
@@ -62,6 +117,18 @@ function findTemplatesDir() {
             return c;
     return null;
 }
+function detectGeminiCli() {
+    try {
+        const r = spawnSync("gemini", ["--version"], {
+            stdio: "pipe",
+            timeout: 3000,
+        });
+        return r.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
 async function detectOllama(timeoutMs = 500) {
     try {
         const controller = new AbortController();
@@ -94,6 +161,9 @@ export async function runPatchworkInit(argv, opts = {}) {
         mkdirSync(dir, { recursive: true });
     }
     log(`  ✓ ~/.patchwork scaffolded\n`);
+    const dashEnv = ensureDashboardEnv(patchworkDir);
+    if (dashEnv.generated)
+        log(`  ✓ ~/.patchwork/.env created with dashboard credentials\n`);
     const templatesDir = findTemplatesDir();
     let recipesCopied = 0;
     let recipesSkipped = 0;
@@ -124,6 +194,10 @@ export async function runPatchworkInit(argv, opts = {}) {
     else {
         log(`  ! recipe templates not found (expected templates/recipes/)\n`);
     }
+    const geminiCliDetected = detectGeminiCli();
+    log(geminiCliDetected
+        ? `  ✓ Gemini CLI detected — driver will default to gemini\n`
+        : `  · Gemini CLI not detected (install from https://github.com/google-gemini/gemini-cli)\n`);
     let ollamaDetected = false;
     if (!parsed.skipOllama) {
         ollamaDetected = await detectOllama();
@@ -157,6 +231,7 @@ export async function runPatchworkInit(argv, opts = {}) {
         const fresh = {
             model: ollamaDetected ? "local" : "claude",
             recipesDir,
+            ...(geminiCliDetected ? { driver: "gemini" } : {}),
             dashboard: {
                 port: 3200,
                 requireApproval: ["high"],
@@ -202,18 +277,22 @@ export async function runPatchworkInit(argv, opts = {}) {
     const restartLine = preToolUseHook === "added"
         ? `\n  ⚠  Restart Claude Code so the new PreToolUse hook takes effect.\n     (CC reads hooks at session start — existing sessions won't see the change.)\n`
         : "";
-    log(`${restartLine}\nNext:
-  1. patchwork start                           # launch bridge + Claude + dashboard (one command)
-  2. patchwork-os recipe run daily-status      # zero-config: yesterday's commits + today's hints
-  3. patchwork-os                              # terminal dashboard (TUI, alternative to web)
-  4. patchwork-os recipe list                  # browse installed recipes
-  5. patchwork-os init --with-connectors       # add gmail/github/linear/etc. recipes\n`);
+    const dashPasswordLine = dashEnv.generated
+        ? `\n  Dashboard password: ${dashEnv.password}  (saved to ~/.patchwork/.env)\n`
+        : "";
+    log(`${restartLine}${dashPasswordLine}
+Next:
+  1. patchwork start                           # launch bridge + dashboard
+  2. open http://localhost:3200                # dashboard (use password printed above)
+  3. patchwork-os recipe run daily-status      # zero-config: yesterday's commits + today's hints
+  4. patchwork-os init --with-connectors       # add gmail/github/linear/etc. recipes\n`);
     return {
         configPath,
         recipesDir,
         recipesCopied,
         recipesSkipped,
         ollamaDetected,
+        geminiCliDetected,
         configAction,
         preToolUseHook,
     };

package/dist/commands/patchworkInit.js.map

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

package/dist/commands/recipe.d.ts

@@ -17,6 +17,43 @@ export declare function runNew(options: NewOptions): {
     content: string;
 };
 export declare function listTemplates(): string[];
+export interface InteractivePromptDeps {
+    /** Free-text prompt. Returns the user's trimmed answer. */
+    ask: (question: string) => Promise<string>;
+    /**
+     * List-select prompt. Returns the 1-based index of the choice the
+     * user picked. Implementations must reject 0 / out-of-range / NaN.
+     */
+    pickFromList: (question: string, options: string[]) => Promise<number>;
+    /** Y/N prompt. Returns true on yes. */
+    confirm: (question: string) => Promise<boolean>;
+    /** Optional preview hook — called once before the final write confirm. */
+    preview?: (yaml: string) => void;
+}
+export interface InteractiveNewOptions {
+    outputDir?: string;
+    deps: InteractivePromptDeps;
+    /**
+     * AI-suggest path. Injected so tests can stub the bridge-discovery +
+     * fetch pair without touching the network or the lock-file dir. When
+     * omitted, runNewInteractive uses the production defaults (findBridgeLock
+     * + global fetch). The CLI dispatch passes nothing.
+     */
+    aiSuggest?: {
+        findBridge?: () => {
+            port: number;
+            authToken: string;
+        } | null;
+        fetch?: typeof globalThis.fetch;
+    };
+}
+export interface InteractiveNewResult {
+    path: string;
+    content: string;
+    /** Lint issues surfaced by validateRecipeDefinition (warnings only — write proceeds). */
+    warnings: LintIssue[];
+}
+export declare function runNewInteractive(options: InteractiveNewOptions): Promise<InteractiveNewResult>;
 export interface SchemaWriteResult {
     outputDir: string;
     filesWritten: string[];
@@ -61,6 +98,20 @@ export interface RunRecipeOptions {
     vars?: Record<string, string>;
     workdir?: string;
     deps?: Partial<RunnerDeps>;
+    /**
+     * PR5c — stable id for one *logical* execution attempt. Forwarded to
+     * RunnerDeps so the runner constructs a disk-backed WriteEffectLedger
+     * scoped by `${recipe.name}:${manualRunId}`. Re-using the same id on
+     * a retry replays prior dedup records and skips already-completed
+     * write tools (resume semantics).
+     */
+    manualRunId?: string;
+    /**
+     * PR5c — directory holding `effect_ledger.jsonl`. Required for the
+     * disk-backed ledger; without it the ledger stays in-memory even
+     * when manualRunId is set.
+     */
+    ledgerDir?: string;
 }
 export interface RunRecipeStepSelection {
     query: string;

package/dist/commands/recipe.js

@@ -11,10 +11,10 @@ import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 import "../recipes/tools/index.js";
 import { loadFixtureLibrary } from "../connectors/fixtureLibrary.js";
 import { MockConnector } from "../connectors/mockConnector.js";
-import { defaultDeprecationWarn, normalizeRecipeForRuntime, } from "../recipes/legacyRecipeCompat.js";
+import { defaultDeprecationWarn, normalizeRecipeForRuntime, } from "../recipes/migrations/index.js";
 import { tryResolveRecipePath } from "../recipes/resolveRecipePath.js";
 import { generateSchemaSet, writeSchemas } from "../recipes/schemaGenerator.js";
-import { getTool, isConnectorNamespace, seedToolOutputPreviewContext, } from "../recipes/toolRegistry.js";
+import { getTool, isConnectorNamespace, listConnectorNamespaces, listTools, seedToolOutputPreviewContext, } from "../recipes/toolRegistry.js";
 import { validateRecipeDefinition, } from "../recipes/validation.js";
 import { buildChainedDeps, dispatchRecipe, loadYamlRecipe, render, runYamlRecipe, } from "../recipes/yamlRunner.js";
 import { findYamlRecipePath } from "../recipesHttp.js";
@@ -113,6 +113,355 @@ export function runNew(options) {
 export function listTemplates() {
     return Object.keys(TEMPLATES);
 }
+// ============================================================================
+// patchwork recipe new --interactive
+//
+// Connector-aware prompt tree. Writes a valid recipe YAML based on
+// user choices. Use a `node:readline/promises` adapter in real CLI;
+// tests inject a stub `InteractivePromptDeps`.
+// ============================================================================
+const RECIPE_NAME_RE = /^[a-z0-9][a-z0-9_-]{1,63}$/;
+const CRON_SHAPE_RE = /^(@every\s+\d+\s*(ms|s|m|h)|\S+\s+\S+\s+\S+\s+\S+\s+\S+)$/i;
+async function askWithValidation(deps, question, validate) {
+    for (let attempt = 0; attempt < 5; attempt++) {
+        const answer = await deps.ask(question);
+        const error = validate(answer);
+        if (!error)
+            return answer;
+        // Surface error and re-ask via the question prompt itself.
+        question = `${error} ${question}`;
+    }
+    throw new Error("Too many invalid answers");
+}
+function yamlScalar(value) {
+    // Quote unless the string is a simple identifier-ish token. Conservative
+    // — when in doubt, JSON-encode (always parses as a YAML string).
+    if (/^[A-Za-z0-9_.\-/:]+$/.test(value))
+        return value;
+    return JSON.stringify(value);
+}
+/**
+ * Prompt the user for the tool's required JSON Schema fields. Optional
+ * properties are skipped — the user can hand-edit the YAML afterwards
+ * if they want to set defaults. `into` is excluded since the generator
+ * supplies its own name.
+ *
+ * Returns an ordered list of `[key, value]` pairs so the YAML output is
+ * stable across runs (insertion order of object keys is sufficient in
+ * V8 for string keys, but an array makes the contract explicit).
+ */
+async function collectRequiredParams(deps, tool) {
+    const schema = tool.paramsSchema;
+    if (!schema || typeof schema !== "object")
+        return [];
+    const required = Array.isArray(schema.required)
+        ? schema.required.filter((k) => typeof k === "string" && k !== "into")
+        : [];
+    if (required.length === 0)
+        return [];
+    const out = [];
+    const properties = schema.properties ?? {};
+    for (const key of required) {
+        const propMeta = properties[key];
+        const hint = propMeta?.description ? ` — ${propMeta.description}` : "";
+        const value = await askWithValidation(deps, `${tool.id} → ${key}${hint}`, (a) => (a.trim().length > 0 ? null : "required, cannot be empty."));
+        out.push([key, value.trim()]);
+    }
+    return out;
+}
+/**
+ * AI-suggest path. Discovers the running bridge via lock file, POSTs
+ * the user's natural-language goal to `/recipes/generate`, writes the
+ * bridge's raw YAML response to disk (no form normalization — per
+ * memory project_recipe_audit_2026_05_06_part2), and validates
+ * post-hoc as warnings only.
+ *
+ * Failure modes:
+ *   - No bridge running    → clear actionable error
+ *   - Bridge returns 503   → "AI generation unavailable — start the
+ *                            bridge with --driver subprocess"
+ *   - Bridge returns 4xx   → surface server error message
+ *   - Bridge returns 200 but `result.yaml` is empty → write nothing,
+ *                            throw with the raw refusal text
+ */
+async function runNewAiSuggest(options) {
+    const { deps } = options;
+    const name = await askWithValidation(deps, "Recipe name", (a) => RECIPE_NAME_RE.test(a)
+        ? null
+        : 'must match /^[a-z0-9][a-z0-9_-]{1,63}$/ (e.g. "morning-brief").');
+    const goal = await askWithValidation(deps, "Describe what the recipe should do (one-paragraph natural language)", (a) => (a.trim().length > 0 ? null : "goal cannot be empty."));
+    // Resolve bridge discovery + fetch — production defaults or test injection.
+    const findBridge = options.aiSuggest?.findBridge ??
+        (() => {
+            // Lazy import so non-AI paths don't pay the cost.
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const mod = require("../bridgeLockDiscovery.js");
+            return mod.findBridgeLock();
+        });
+    const doFetch = options.aiSuggest?.fetch ?? globalThis.fetch;
+    const lock = findBridge();
+    if (!lock) {
+        throw new Error("AI generation requires a running bridge. Start one with `patchwork start` " +
+            "(or `claude-ide-bridge --driver subprocess` for the bridge-only mode), " +
+            "then retry.");
+    }
+    let response;
+    try {
+        response = await doFetch(`http://127.0.0.1:${lock.port}/recipes/generate`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${lock.authToken}`,
+            },
+            body: JSON.stringify({ prompt: goal.trim() }),
+        });
+    }
+    catch (err) {
+        throw new Error(`Could not reach the bridge at port ${lock.port}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let payload;
+    try {
+        payload = (await response.json());
+    }
+    catch {
+        throw new Error(`Bridge returned non-JSON response (status ${response.status})`);
+    }
+    if (response.status === 503 || payload.unavailable) {
+        throw new Error("AI generation unavailable — start the bridge with `--driver subprocess`.");
+    }
+    if (!payload.ok) {
+        throw new Error(payload.error ?? `Bridge returned ${response.status}`);
+    }
+    const yamlBody = (payload.yaml ?? "").trim();
+    if (!yamlBody) {
+        throw new Error("Bridge returned empty YAML — try a more specific goal.");
+    }
+    // Ensure the SchemaStore pragma is present at line 1 so the file
+    // gets autocomplete on first open. If the bridge already prepended
+    // one, leave it.
+    const hasPragma = /^#\s*yaml-language-server:/.test(yamlBody);
+    const content = hasPragma
+        ? `${yamlBody}\n`
+        : `${RECIPE_SCHEMA_HEADER}\n${yamlBody}\n`;
+    if (deps.preview)
+        deps.preview(content);
+    const shouldWrite = await deps.confirm("Write to disk?");
+    if (!shouldWrite) {
+        throw new Error("Cancelled by user");
+    }
+    const outputDir = options.outputDir ?? RECIPES_DIR;
+    if (!existsSync(outputDir)) {
+        mkdirSync(outputDir, { recursive: true });
+    }
+    const outputPath = join(outputDir, `${name}.yaml`);
+    if (existsSync(outputPath)) {
+        throw new Error(`Recipe already exists: ${outputPath}`);
+    }
+    writeFileSync(outputPath, content);
+    // Lint post-hoc. Surface as warnings; never block — the user asked
+    // for a draft, the bridge produced it, the file is on disk.
+    let warnings = [];
+    try {
+        const parsed = parseYaml(content);
+        const lintResult = validateRecipeDefinition(parsed);
+        warnings = lintResult.issues ?? [];
+    }
+    catch (err) {
+        warnings = [
+            {
+                level: "warning",
+                message: `AI-generated YAML did not parse cleanly: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        ];
+    }
+    return { path: outputPath, content, warnings };
+}
+export async function runNewInteractive(options) {
+    const { deps } = options;
+    // Mode pick — Guided (full prompt tree), Template (existing runNew
+    // templates: minimal | daily | inbox), or AI-suggest (asks the running
+    // bridge's /recipes/generate endpoint and writes the raw response).
+    //
+    // AI-suggest skips the form normalizer per memory
+    // project_recipe_audit_2026_05_06_part2 — applyAiYaml on the dashboard
+    // was lossy. Here we writeFileSync the bridge's `result.yaml` verbatim
+    // (only the SchemaStore pragma is prepended if absent) and validate
+    // post-hoc as warnings, never blocking the write.
+    const templates = listTemplates();
+    const modeChoices = [
+        "Guided — full prompt tree (recommended)",
+        `Template — pick from ${templates.length} starters (${templates.join(", ")})`,
+        "AI suggest — describe what you want; the bridge drafts a YAML",
+    ];
+    const modeIdx = await deps.pickFromList("How do you want to start?", modeChoices);
+    // AI-suggest mode: route through the running bridge's /recipes/generate.
+    if (modeIdx === 3) {
+        return runNewAiSuggest(options);
+    }
+    // Template mode: re-use the existing runNew() flow with the picked template.
+    if (modeIdx === 2) {
+        const name = await askWithValidation(deps, "Recipe name", (a) => RECIPE_NAME_RE.test(a)
+            ? null
+            : 'must match /^[a-z0-9][a-z0-9_-]{1,63}$/ (e.g. "morning-brief").');
+        const description = await askWithValidation(deps, "One-line description", (a) => (a.trim().length > 0 ? null : "cannot be empty."));
+        const templateIdx = await deps.pickFromList("Pick a template", templates);
+        const template = templates[templateIdx - 1];
+        if (!template)
+            throw new Error("Invalid template selection");
+        const result = runNew({
+            name,
+            description,
+            template,
+            ...(options.outputDir ? { outputDir: options.outputDir } : {}),
+        });
+        if (deps.preview)
+            deps.preview(result.content);
+        const shouldWrite = await deps.confirm("Keep this recipe?");
+        if (!shouldWrite) {
+            // runNew already wrote the file — clean up to honor "cancel."
+            try {
+                if (existsSync(result.path)) {
+                    const { unlinkSync } = await import("node:fs");
+                    unlinkSync(result.path);
+                }
+            }
+            catch {
+                // best effort
+            }
+            throw new Error("Cancelled by user");
+        }
+        return { path: result.path, content: result.content, warnings: [] };
+    }
+    // Guided mode (default — modeIdx === 1).
+    const name = await askWithValidation(deps, "Recipe name", (a) => RECIPE_NAME_RE.test(a)
+        ? null
+        : 'must match /^[a-z0-9][a-z0-9_-]{1,63}$/ (e.g. "morning-brief").');
+    const description = await askWithValidation(deps, "One-line description", (a) => (a.trim().length > 0 ? null : "cannot be empty."));
+    const triggerTypes = ["manual", "cron"];
+    const triggerIdx = await deps.pickFromList("Trigger type", triggerTypes.slice());
+    const triggerType = triggerTypes[triggerIdx - 1];
+    if (!triggerType)
+        throw new Error("Invalid trigger selection");
+    const triggerLines = [`trigger:`, `  type: ${triggerType}`];
+    if (triggerType === "cron") {
+        const cron = await askWithValidation(deps, "Cron expression (e.g. '0 8 * * *' for 8am daily)", (a) => CRON_SHAPE_RE.test(a.trim())
+            ? null
+            : 'expected 5-field cron or "@every Ns|Nm|Nh".');
+        triggerLines.push(`  at: ${yamlScalar(cron.trim())}`);
+    }
+    // Step loop. The user adds tool / agent steps until they pick "done".
+    // Each tool pick reads its paramsSchema and prompts for required fields,
+    // so the generated recipe is closer to runnable than the MVP slice.
+    const namespaces = listConnectorNamespaces();
+    const stepLines = ["steps:"];
+    const intoNames = [];
+    let lastAgentInto = null;
+    let toolStepCount = 0;
+    let agentStepCount = 0;
+    const stepKindChoices = [
+        "Add a tool step (calls a registered tool — gmail.fetch_unread, github.list_issues, …)",
+        "Add an agent step (LLM prompt — drafts, classifies, summarizes)",
+        "Done — preview and write",
+    ];
+    for (let stepIdx = 0; stepIdx < 20; stepIdx++) {
+        const kind = await deps.pickFromList(stepIdx === 0
+            ? "Build steps — what's next?"
+            : "Add another step? (or pick Done)", stepKindChoices);
+        if (kind === 3)
+            break;
+        if (kind === 1) {
+            // Tool step
+            const nsIdx = await deps.pickFromList("Pick a connector", namespaces.slice());
+            const ns = namespaces[nsIdx - 1];
+            if (!ns)
+                throw new Error("Invalid connector selection");
+            const tools = listTools(ns);
+            const labels = tools.map((t) => `${t.id} — ${t.description}`);
+            const toolIdx = await deps.pickFromList(`Pick a ${ns} tool`, labels);
+            const tool = tools[toolIdx - 1];
+            if (!tool)
+                throw new Error(`Invalid tool selection for ${ns}`);
+            toolStepCount += 1;
+            const intoName = toolStepCount === 1 ? `${ns}_result` : `${ns}_result_${toolStepCount}`;
+            intoNames.push(intoName);
+            stepLines.push(`  - tool: ${tool.id}`);
+            // Prompt for required params from the tool's JSON schema.
+            const params = await collectRequiredParams(deps, tool);
+            for (const [key, value] of params) {
+                stepLines.push(`    ${key}: ${yamlScalar(value)}`);
+            }
+            stepLines.push(`    into: ${intoName}`);
+        }
+        else if (kind === 2) {
+            // Agent step
+            const prompt = await askWithValidation(deps, "Agent prompt", (a) => a.trim().length > 0 ? null : "cannot be empty.");
+            agentStepCount += 1;
+            const intoName = agentStepCount === 1
+                ? "agent_output"
+                : `agent_output_${agentStepCount}`;
+            lastAgentInto = intoName;
+            stepLines.push(`  - agent: true`);
+            stepLines.push(`    prompt: |`);
+            for (const line of prompt.split("\n")) {
+                stepLines.push(`      ${line}`);
+            }
+            stepLines.push(`    into: ${intoName}`);
+        }
+    }
+    // Always tail with file.write to inbox so the user sees output somewhere.
+    // Reference the most recent agent output when one exists, otherwise fall
+    // back to the most recent tool result (or a TODO comment if neither).
+    const tailRef = lastAgentInto ?? intoNames[intoNames.length - 1] ?? null;
+    stepLines.push(`  - tool: file.write`);
+    stepLines.push(`    path: "~/.patchwork/inbox/${name}-{{date}}.md"`);
+    stepLines.push(`    content: |`);
+    stepLines.push(`      # ${name} — {{date}}`);
+    stepLines.push(``);
+    if (tailRef) {
+        stepLines.push(`      {{${tailRef}}}`);
+    }
+    else {
+        stepLines.push(`      (no steps configured — fill in)`);
+    }
+    const content = `${RECIPE_SCHEMA_HEADER}\n` +
+        `version: 1.0.0\n` +
+        `name: ${name}\n` +
+        `description: ${yamlScalar(description)}\n` +
+        `${triggerLines.join("\n")}\n` +
+        `${stepLines.join("\n")}\n`;
+    // Lint pre-write. validateRecipeDefinition expects parsed YAML.
+    let warnings = [];
+    try {
+        const parsed = parseYaml(content);
+        const lintResult = validateRecipeDefinition(parsed);
+        warnings = lintResult.issues ?? [];
+    }
+    catch {
+        // Parse failure here is a bug in the generator — surface but don't block.
+        warnings = [
+            {
+                level: "error",
+                message: "Generated YAML failed to parse — please report this.",
+            },
+        ];
+    }
+    if (deps.preview)
+        deps.preview(content);
+    const shouldWrite = await deps.confirm("Write to disk?");
+    if (!shouldWrite) {
+        throw new Error("Cancelled by user");
+    }
+    const outputDir = options.outputDir ?? RECIPES_DIR;
+    if (!existsSync(outputDir)) {
+        mkdirSync(outputDir, { recursive: true });
+    }
+    const outputPath = join(outputDir, `${name}.yaml`);
+    if (existsSync(outputPath)) {
+        throw new Error(`Recipe already exists: ${outputPath}`);
+    }
+    writeFileSync(outputPath, content);
+    return { path: outputPath, content, warnings };
+}
 export async function runSchema(outputDir) {
     const resolvedOutputDir = resolve(outputDir);
     const schemas = generateSchemaSet();
@@ -420,6 +769,8 @@ export async function runRecipe(recipeRef, options = {}) {
     const runnerDeps = {
         ...options.deps,
         workdir: options.workdir ?? options.deps?.workdir ?? process.cwd(),
+        ...(options.manualRunId && { manualRunId: options.manualRunId }),
+        ...(options.ledgerDir && { ledgerDir: options.ledgerDir }),
     };
     if (options.dryRun) {
         throw new Error("runRecipeDryPlan must be used for dry-run execution");
@@ -832,7 +1183,16 @@ export async function runPreflight(recipeRef, options = {}) {
     }
     const plan = await runRecipeDryPlan(recipeRef, options);
     const requireWriteAck = options.requireWriteAck ?? true;
-    const allowlist = new Set(options.allowWrites ?? []);
+    // Merge the recipe's declared allowWrites (YAML) with any caller-supplied
+    // entries (e.g. --allow-write CLI flag). Either source is sufficient.
+    const recipeForWrites = loadYamlRecipe(recipePath);
+    const recipeAllowWrites = Array.isArray(recipeForWrites.allowWrites)
+        ? recipeForWrites.allowWrites.filter((entry) => typeof entry === "string")
+        : [];
+    const allowlist = new Set([
+        ...recipeAllowWrites,
+        ...(options.allowWrites ?? []),
+    ]);
     for (const step of plan.steps) {
         if (step.type === "tool" && step.tool && step.resolved === false) {
             issues.push({