intentdna 1.0.0

package/dist/runtime/skill-adapter.js

@@ -0,0 +1,170 @@
+/**
+ * Intent DNA — Skill Adapter
+ *
+ * Compiles DNA roles + workflow + genes into Claude Code skill files
+ * (.claude/skills/<name>/SKILL.md).
+ *
+ * Skills are compiled views of DNA's structured definitions — not stored content.
+ */
+import { mkdir, writeFile, readdir, readFile, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { toKebabCase } from "./agent-md.js";
+const SENTINEL = "<!-- intentdna:managed — do not edit manually -->";
+// ── Compile Workflow → Skill ───────────────────────────────
+/**
+ * Compile a WorkflowPlan + roles + IR into a SKILL.md file.
+ */
+export function compileWorkflowToSkill(plan, roles, ir) {
+    const lines = [];
+    // Frontmatter
+    lines.push("---");
+    lines.push(`name: ${plan.name}`);
+    lines.push(`description: "${escapeYaml(plan.description)}"`);
+    lines.push("---");
+    lines.push("");
+    // Sentinel
+    lines.push(SENTINEL);
+    lines.push(`<!-- Compiled: ${new Date().toISOString()} -->`);
+    lines.push("");
+    // Title
+    lines.push(`# /${plan.name} [task-id]`);
+    lines.push("");
+    lines.push(plan.description);
+    lines.push("");
+    // Roles table
+    lines.push("## Roles");
+    lines.push("");
+    lines.push("| Role | Agent | Tools | Deny | Scope (write) |");
+    lines.push("|------|-------|-------|------|---------------|");
+    const usedRoles = new Set(plan.steps.map((s) => s.role));
+    for (const roleName of usedRoles) {
+        const role = roles[roleName];
+        if (!role)
+            continue;
+        const agent = `dna-${toKebabCase(roleName)}`;
+        const tools = role.tool_permissions?.allow?.join(", ") || "all";
+        const deny = role.tool_permissions?.deny?.join(", ") || "—";
+        const scope = role.scope?.write?.join(", ") || "—";
+        lines.push(`| ${roleName} | ${agent} | ${tools} | ${deny} | ${scope} |`);
+    }
+    lines.push("");
+    // Process
+    lines.push("## Process");
+    lines.push("");
+    for (let i = 0; i < plan.parallel_groups.length; i++) {
+        const group = plan.parallel_groups[i];
+        const isParallel = group.step_ids.length > 1;
+        if (isParallel) {
+            lines.push(`### Group ${i + 1} (parallel)`);
+        }
+        for (const stepId of group.step_ids) {
+            const step = plan.steps.find((s) => s.id === stepId);
+            const agent = `@dna-${toKebabCase(step.role)}`;
+            const runIf = step.run_if ? ` (${step.run_if})` : "";
+            const optional = step.optional ? " (optional)" : "";
+            lines.push(`${i + 1}. **${step.id}** → ${agent}${runIf}${optional}`);
+            lines.push(`   ${step.description}`);
+        }
+    }
+    lines.push("");
+    // Retry
+    if (plan.retry.max_retries > 0) {
+        lines.push("## Retry Policy");
+        lines.push("");
+        lines.push(`- Max retries: ${plan.retry.max_retries}`);
+        if (plan.retry.retry_from) {
+            lines.push(`- Retry from: ${plan.retry.retry_from}`);
+        }
+        for (const t of plan.transitions) {
+            if (t.condition === "fail") {
+                lines.push(`- On **${t.from}** fail → go to **${t.to}**`);
+            }
+        }
+        lines.push("");
+    }
+    // Guidelines from IR
+    if (ir && ir.prompt_directives.length > 0) {
+        lines.push("## Guidelines");
+        lines.push("");
+        const high = ir.prompt_directives.filter((d) => d.priority === "high");
+        const medium = ir.prompt_directives.filter((d) => d.priority === "medium");
+        if (high.length > 0) {
+            lines.push("### Critical");
+            for (const d of high) {
+                lines.push(`- **${d.text}**`);
+            }
+            lines.push("");
+        }
+        if (medium.length > 0) {
+            lines.push("### Standard");
+            for (const d of medium) {
+                lines.push(`- ${d.text}`);
+            }
+            lines.push("");
+        }
+    }
+    // Role instructions
+    lines.push("## Role Instructions");
+    lines.push("");
+    for (const roleName of usedRoles) {
+        const role = roles[roleName];
+        if (!role)
+            continue;
+        lines.push(`### ${roleName}`);
+        lines.push("");
+        if (role.instructions && role.instructions.length > 0) {
+            for (let j = 0; j < role.instructions.length; j++) {
+                lines.push(`${j + 1}. ${role.instructions[j]}`);
+            }
+        }
+        if (role.post_checks && role.post_checks.length > 0) {
+            lines.push("");
+            lines.push("Post checks: " + role.post_checks.join(", "));
+        }
+        lines.push("");
+    }
+    const content = lines.join("\n") + "\n";
+    const dirName = plan.name;
+    const fileName = join(dirName, "SKILL.md");
+    return { name: plan.name, fileName, dirName, content };
+}
+// ── File Operations ────────────────────────────────────────
+export async function writeSkillFiles(results, outputDir) {
+    const written = [];
+    for (const result of results) {
+        const dir = join(outputDir, result.dirName);
+        await mkdir(dir, { recursive: true });
+        const path = join(dir, "SKILL.md");
+        await writeFile(path, result.content, "utf-8");
+        written.push(path);
+    }
+    return written;
+}
+export async function removeSkillFiles(outputDir) {
+    let removed = 0;
+    let entries;
+    try {
+        entries = await readdir(outputDir);
+    }
+    catch {
+        return 0;
+    }
+    for (const entry of entries) {
+        const skillPath = join(outputDir, entry, "SKILL.md");
+        try {
+            const content = await readFile(skillPath, "utf-8");
+            if (content.includes(SENTINEL)) {
+                await rm(join(outputDir, entry), { recursive: true });
+                removed++;
+            }
+        }
+        catch {
+            // Skip
+        }
+    }
+    return removed;
+}
+function escapeYaml(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+//# sourceMappingURL=skill-adapter.js.map

package/dist/runtime/skill-adapter.js.map

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

package/dist/runtime/workflow-runner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Intent DNA -- Workflow Shell Script Runner
+ *
+ * Compiles a WorkflowPlan into an executable bash script.
+ * Each step invokes `claude -p --agent <role-name>`.
+ * Parallel groups use background jobs + wait.
+ * Retry loops wrap the execution with round tracking.
+ *
+ * Output: a self-contained shell script with set -euo pipefail,
+ * run_agent helper, parallel group execution, retry logic, and
+ * transition-based flow control.
+ */
+import type { WorkflowPlan } from "../schema/types.js";
+/** Options for workflow shell script generation */
+export interface WorkflowShellOptions {
+    /** Agent name prefix (default "dna-") */
+    agentPrefix?: string;
+    /** Max budget per agent in USD (default 10) */
+    maxBudgetPerAgent?: number;
+    /** Output format for agent results (default "json") */
+    outputFormat?: "json" | "text";
+    /** Permission mode (default "bypassPermissions") */
+    permissionMode?: string;
+    /** Log directory relative to project root (default ".") */
+    logDir?: string;
+    /** Include pause/resume support (default false) */
+    pauseSupport?: boolean;
+}
+/** Result of workflow shell script generation */
+export interface WorkflowShellResult {
+    /** The generated script content */
+    script: string;
+    /** File name for the script */
+    fileName: string;
+}
+/**
+ * Compile a WorkflowPlan into an executable shell script.
+ * Pure function, no side effects.
+ */
+export declare function compileWorkflowToShell(plan: WorkflowPlan, options?: WorkflowShellOptions): WorkflowShellResult;
+/**
+ * Write workflow shell script to the file system.
+ * Creates the directory if it doesn't exist.
+ * Returns the path of the written file.
+ */
+export declare function writeWorkflowScript(result: WorkflowShellResult, outputDir: string): Promise<string>;
+/**
+ * Remove Intent DNA generated workflow scripts from a directory.
+ * Only removes files that contain the sentinel comment.
+ * Returns number of files removed.
+ */
+export declare function removeWorkflowScripts(outputDir: string): Promise<number>;
+//# sourceMappingURL=workflow-runner.d.ts.map

package/dist/runtime/workflow-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,oBAAoB,CAAC;AAO5B,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAkVD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,mBAAmB,CAwFrB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/runtime/workflow-runner.js

@@ -0,0 +1,420 @@
+/**
+ * Intent DNA -- Workflow Shell Script Runner
+ *
+ * Compiles a WorkflowPlan into an executable bash script.
+ * Each step invokes `claude -p --agent <role-name>`.
+ * Parallel groups use background jobs + wait.
+ * Retry loops wrap the execution with round tracking.
+ *
+ * Output: a self-contained shell script with set -euo pipefail,
+ * run_agent helper, parallel group execution, retry logic, and
+ * transition-based flow control.
+ */
+import { mkdir, writeFile, readFile, readdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { toKebabCase } from "./agent-md.js";
+const SENTINEL_COMMENT = "# intentdna:managed -- do not edit manually";
+// ── Internal helpers ────────────────────────────────────────
+/**
+ * Sanitize a step ID for use as a bash variable name.
+ * Replaces any non-alphanumeric/underscore character with underscore.
+ */
+function sanitizeForBash(id) {
+    return id.replace(/[^a-zA-Z0-9_]/g, "_");
+}
+/**
+ * Get the agent name for a role, using toKebabCase and the configured prefix.
+ */
+function agentName(role, prefix) {
+    return `${prefix}${toKebabCase(role)}`;
+}
+/**
+ * Escape a string for safe use inside a single-quoted shell string.
+ */
+function escapeShellSingleQuote(s) {
+    return s.replace(/'/g, "'\\''");
+}
+/**
+ * Compile a run_if expression into a bash conditional string.
+ * Returns null for unconditional execution.
+ */
+function compileRunIf(runIf) {
+    if (runIf === null)
+        return null;
+    // "round == N"
+    const eqMatch = runIf.match(/^round\s*==\s*(\d+)$/);
+    if (eqMatch) {
+        return `[ "$ROUND" -eq ${eqMatch[1]} ]`;
+    }
+    // "round > N"
+    const gtMatch = runIf.match(/^round\s*>\s*(\d+)$/);
+    if (gtMatch) {
+        return `[ "$ROUND" -gt ${gtMatch[1]} ]`;
+    }
+    // "retry" is equivalent to "round > 1"
+    if (runIf === "retry") {
+        return '[ "$ROUND" -gt 1 ]';
+    }
+    // Unsupported expressions -- return as comment hint
+    return null;
+}
+/**
+ * Build a step map for looking up steps by ID.
+ */
+function buildStepMap(steps) {
+    const map = new Map();
+    for (const s of steps) {
+        map.set(s.id, s);
+    }
+    return map;
+}
+/**
+ * Find the topological index of a step ID in the step list.
+ */
+function stepIndex(steps, id) {
+    return steps.findIndex((s) => s.id === id);
+}
+// ── Script generators ──────────────────────────────────────
+function generateHeader(plan, options) {
+    const lines = [];
+    lines.push("#!/bin/bash");
+    lines.push(SENTINEL_COMMENT);
+    lines.push(`# Workflow: ${plan.name}`);
+    lines.push(`# Compiled: ${plan.compiled_at}`);
+    lines.push(`# Source: ${plan.source_workflow}`);
+    lines.push("set -euo pipefail");
+    lines.push("");
+    lines.push('PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"');
+    lines.push('cd "$PROJECT_ROOT"');
+    lines.push("");
+    // Check jq availability
+    lines.push("# Check dependencies");
+    lines.push('if ! command -v jq &>/dev/null; then');
+    lines.push('  echo "Error: jq is required but not installed." >&2');
+    lines.push("  exit 1");
+    lines.push("fi");
+    lines.push('if ! command -v claude &>/dev/null; then');
+    lines.push('  echo "Error: claude CLI is required but not installed." >&2');
+    lines.push("  exit 1");
+    lines.push("fi");
+    lines.push("");
+    // Variables
+    lines.push("# Configuration");
+    lines.push(`MAX_BUDGET="${options.maxBudgetPerAgent}"`);
+    lines.push(`LOG_DIR="${options.logDir}"`);
+    lines.push('mkdir -p "$LOG_DIR"');
+    lines.push("");
+    // Pause support
+    if (options.pauseSupport) {
+        lines.push('PAUSE_FILE=".claude/dev-pause"');
+        lines.push("check_pause() {");
+        lines.push('  if [ -f "$PAUSE_FILE" ]; then');
+        lines.push('    echo "[$(date \'+%H:%M:%S\')] Paused. Remove $PAUSE_FILE to continue."');
+        lines.push("    exit 0");
+        lines.push("  fi");
+        lines.push("}");
+        lines.push("");
+    }
+    return lines;
+}
+function generateRunAgentFn(options) {
+    const lines = [];
+    lines.push("# Run a single agent step");
+    lines.push("run_agent() {");
+    lines.push('  local agent="$1"');
+    lines.push('  local prompt="$2"');
+    lines.push('  local step_id="$3"');
+    lines.push('  local result_file="${LOG_DIR}/${step_id}-result.json"');
+    lines.push("");
+    lines.push('  echo "[$(date \'+%H:%M:%S\')] Running step: $step_id (agent: $agent)"');
+    lines.push("");
+    lines.push('  echo "$prompt" | claude -p \\');
+    lines.push('    --agent "$agent" \\');
+    lines.push(`    --output-format ${options.outputFormat} \\`);
+    lines.push('    --max-budget-usd "$MAX_BUDGET" \\');
+    lines.push(`    --permission-mode ${options.permissionMode} \\`);
+    lines.push('    --session-id "$(uuidgen | tr \'[:upper:]\' \'[:lower:]\')" \\');
+    lines.push('    --no-session-persistence \\');
+    lines.push('    > "$result_file" 2>&1 || true');
+    lines.push("");
+    lines.push('  local is_error=$(jq -r \'.is_error // false\' "$result_file" 2>/dev/null || echo "false")');
+    lines.push('  if [ "$is_error" = "true" ]; then');
+    lines.push('    echo "[$(date \'+%H:%M:%S\')] Step $step_id FAILED"');
+    lines.push("    return 1");
+    lines.push("  fi");
+    lines.push('  echo "[$(date \'+%H:%M:%S\')] Step $step_id PASSED"');
+    lines.push("  return 0");
+    lines.push("}");
+    return lines;
+}
+/**
+ * Generate execution code for a single step, with run_if and optional handling.
+ * Returns lines of bash code.
+ */
+function generateStepExecution(step, options, plan, isParallel) {
+    const lines = [];
+    const varId = sanitizeForBash(step.id);
+    const agent = agentName(step.role, options.agentPrefix);
+    const prompt = escapeShellSingleQuote(step.prompt ?? step.description);
+    const bashCondition = compileRunIf(step.run_if);
+    // Determine if this step needs a retry_from skip guard.
+    // If plan has retry_from set, and this step is before retry_from in
+    // topological order, and step has no explicit run_if, inject a round==1 guard.
+    let retrySkipGuard = false;
+    if (plan.retry.max_retries > 0 && plan.retry.retry_from !== null && step.run_if === null) {
+        const retryFromIdx = stepIndex(plan.steps, plan.retry.retry_from);
+        const thisIdx = stepIndex(plan.steps, step.id);
+        if (thisIdx >= 0 && retryFromIdx >= 0 && thisIdx < retryFromIdx) {
+            retrySkipGuard = true;
+        }
+    }
+    const effectiveCondition = retrySkipGuard ? '[ "$ROUND" -eq 1 ]' : bashCondition;
+    // Build the agent call
+    const agentCall = step.optional
+        ? `run_agent "${agent}" '${prompt}' "${step.id}" || {\n    STEP_${varId}_STATUS=1\n    echo "[$(date '+%H:%M:%S')] Optional step '${step.id}' failed, continuing..."\n  }`
+        : `run_agent "${agent}" '${prompt}' "${step.id}" || STEP_${varId}_STATUS=1`;
+    if (effectiveCondition) {
+        const condLabel = retrySkipGuard ? "round == 1 (retry_from skip)" : step.run_if;
+        lines.push(`  # Step: ${step.id} (run_if: ${condLabel})`);
+        lines.push(`  if ${effectiveCondition}; then`);
+        lines.push(`    ${agentCall}`);
+        lines.push("  else");
+        lines.push(`    echo "[$(date '+%H:%M:%S')] Skipping step: ${step.id} (run_if: ${condLabel}, current round: $ROUND)"`);
+        lines.push("  fi");
+    }
+    else {
+        lines.push(`  # Step: ${step.id}`);
+        if (step.optional) {
+            lines.push(`  run_agent "${agent}" '${prompt}' "${step.id}" || {`);
+            lines.push(`    STEP_${varId}_STATUS=1`);
+            lines.push(`    echo "[$(date '+%H:%M:%S')] Optional step '${step.id}' failed, continuing..."`);
+            lines.push("  }");
+        }
+        else {
+            lines.push(`  run_agent "${agent}" '${prompt}' "${step.id}" || STEP_${varId}_STATUS=1`);
+        }
+    }
+    return lines;
+}
+/**
+ * Generate execution code for a parallel group.
+ */
+function generateGroupExecution(group, stepMap, options, plan) {
+    const lines = [];
+    const isParallel = group.step_ids.length > 1;
+    if (isParallel) {
+        lines.push(`  # Group ${group.group_index}: ${group.step_ids.join(", ")} (parallel)`);
+    }
+    else {
+        lines.push(`  # Group ${group.group_index}: ${group.step_ids[0]} (sequential)`);
+    }
+    // Initialize status variables
+    for (const id of group.step_ids) {
+        const varId = sanitizeForBash(id);
+        lines.push(`  STEP_${varId}_STATUS=0`);
+    }
+    if (isParallel) {
+        // Background jobs
+        for (const id of group.step_ids) {
+            const step = stepMap.get(id);
+            const varId = sanitizeForBash(id);
+            const agent = agentName(step.role, options.agentPrefix);
+            const prompt = escapeShellSingleQuote(step.prompt ?? step.description);
+            lines.push("");
+            lines.push(`  run_agent "${agent}" '${prompt}' "${step.id}" &`);
+            lines.push(`  PID_${varId}=$!`);
+        }
+        lines.push("");
+        // Wait for all
+        for (const id of group.step_ids) {
+            const step = stepMap.get(id);
+            const varId = sanitizeForBash(id);
+            if (step.optional) {
+                lines.push(`  wait $PID_${varId} || {`);
+                lines.push(`    STEP_${varId}_STATUS=1`);
+                lines.push(`    echo "[$(date '+%H:%M:%S')] Optional step '${step.id}' failed, continuing..."`);
+                lines.push("  }");
+            }
+            else {
+                lines.push(`  wait $PID_${varId} || STEP_${varId}_STATUS=1`);
+            }
+        }
+    }
+    else {
+        // Sequential -- single step
+        const step = stepMap.get(group.step_ids[0]);
+        lines.push("");
+        lines.push(...generateStepExecution(step, options, plan, false));
+    }
+    return lines;
+}
+/**
+ * Generate transition check code after all groups execute.
+ */
+function generateTransitionChecks(transitions, plan) {
+    const lines = [];
+    const failTransitions = transitions.filter((t) => t.condition === "fail" || t.condition === "error");
+    if (failTransitions.length === 0)
+        return lines;
+    lines.push("");
+    lines.push("  # Transition checks");
+    for (const t of failTransitions) {
+        const varId = sanitizeForBash(t.from);
+        lines.push(`  if [ "$STEP_${varId}_STATUS" -ne 0 ]; then`);
+        lines.push(`    # Transition: ${t.from} --${t.condition}--> ${t.to}`);
+        lines.push("    RETRY_NEEDED=true");
+        lines.push("  fi");
+    }
+    return lines;
+}
+/**
+ * Generate the complete check for non-optional step failures (that don't have
+ * explicit fail transitions) to trigger exit or retry.
+ */
+function generateFailureChecks(plan) {
+    const lines = [];
+    const failTransitionFroms = new Set(plan.transitions.filter((t) => t.condition === "fail" || t.condition === "error").map((t) => t.from));
+    const nonOptionalSteps = plan.steps.filter((s) => !s.optional && !failTransitionFroms.has(s.id));
+    if (nonOptionalSteps.length === 0)
+        return lines;
+    lines.push("");
+    lines.push("  # Check for non-optional step failures");
+    for (const step of nonOptionalSteps) {
+        const varId = sanitizeForBash(step.id);
+        if (plan.retry.max_retries > 0) {
+            lines.push(`  if [ "$STEP_${varId}_STATUS" -ne 0 ]; then`);
+            lines.push("    RETRY_NEEDED=true");
+            lines.push("  fi");
+        }
+        else {
+            lines.push(`  if [ "$STEP_${varId}_STATUS" -ne 0 ]; then`);
+            lines.push(`    echo "[$(date '+%H:%M:%S')] Step '${step.id}' failed."`);
+            lines.push("    exit 1");
+            lines.push("  fi");
+        }
+    }
+    return lines;
+}
+// ── Public API ──────────────────────────────────────────────
+/**
+ * Compile a WorkflowPlan into an executable shell script.
+ * Pure function, no side effects.
+ */
+export function compileWorkflowToShell(plan, options) {
+    const opts = {
+        agentPrefix: options?.agentPrefix ?? "dna-",
+        maxBudgetPerAgent: options?.maxBudgetPerAgent ?? 10,
+        outputFormat: options?.outputFormat ?? "json",
+        permissionMode: options?.permissionMode ?? "bypassPermissions",
+        logDir: options?.logDir ?? ".",
+        pauseSupport: options?.pauseSupport ?? false,
+    };
+    const stepMap = buildStepMap(plan.steps);
+    const lines = [];
+    // Header
+    lines.push(...generateHeader(plan, opts));
+    // run_agent function
+    lines.push(...generateRunAgentFn(opts));
+    lines.push("");
+    // Main execution
+    if (plan.retry.max_retries > 0) {
+        // With retry loop
+        lines.push("# ── Main execution (with retry) ──");
+        lines.push("ROUND=1");
+        lines.push(`MAX_RETRIES=${plan.retry.max_retries}`);
+        lines.push("");
+        lines.push('while [ "$ROUND" -le $((MAX_RETRIES + 1)) ]; do');
+        lines.push('  echo "=== Round $ROUND ==="');
+        lines.push("  RETRY_NEEDED=false");
+        if (opts.pauseSupport) {
+            lines.push("  check_pause");
+        }
+        lines.push("");
+        // Group blocks
+        for (const group of plan.parallel_groups) {
+            lines.push(...generateGroupExecution(group, stepMap, opts, plan));
+            lines.push("");
+        }
+        // Transition checks
+        lines.push(...generateTransitionChecks(plan.transitions, plan));
+        // Failure checks
+        lines.push(...generateFailureChecks(plan));
+        lines.push("");
+        lines.push('  if [ "$RETRY_NEEDED" = false ]; then');
+        lines.push('    echo "All steps passed."');
+        lines.push("    break");
+        lines.push("  fi");
+        lines.push("");
+        lines.push("  ROUND=$((ROUND + 1))");
+        lines.push('  if [ "$ROUND" -gt $((MAX_RETRIES + 1)) ]; then');
+        lines.push('    echo "Max retries ($MAX_RETRIES) exhausted."');
+        lines.push("    exit 1");
+        lines.push("  fi");
+        lines.push("");
+        lines.push('  echo "Retrying from round $ROUND..."');
+        lines.push("done");
+    }
+    else {
+        // No retry -- direct execution
+        lines.push("# ── Main execution (no retry) ──");
+        lines.push('echo "=== Running workflow: ' + escapeShellSingleQuote(plan.name) + ' ==="');
+        lines.push("");
+        // Group blocks
+        for (const group of plan.parallel_groups) {
+            lines.push(...generateGroupExecution(group, stepMap, opts, plan));
+            lines.push("");
+        }
+        // Failure checks (exit on failure, no retry)
+        lines.push(...generateFailureChecks(plan));
+        lines.push("");
+        lines.push('echo "All steps passed."');
+    }
+    lines.push("");
+    const script = lines.join("\n") + "\n";
+    const fileName = toKebabCase(plan.name) + ".sh";
+    return { script, fileName };
+}
+/**
+ * Write workflow shell script to the file system.
+ * Creates the directory if it doesn't exist.
+ * Returns the path of the written file.
+ */
+export async function writeWorkflowScript(result, outputDir) {
+    await mkdir(outputDir, { recursive: true });
+    const path = join(outputDir, result.fileName);
+    await writeFile(path, result.script, { mode: 0o755 });
+    return path;
+}
+/**
+ * Remove Intent DNA generated workflow scripts from a directory.
+ * Only removes files that contain the sentinel comment.
+ * Returns number of files removed.
+ */
+export async function removeWorkflowScripts(outputDir) {
+    let entries;
+    try {
+        entries = await readdir(outputDir);
+    }
+    catch {
+        // Directory doesn't exist
+        return 0;
+    }
+    let removed = 0;
+    for (const entry of entries) {
+        if (!entry.endsWith(".sh"))
+            continue;
+        const path = join(outputDir, entry);
+        try {
+            const content = await readFile(path, "utf-8");
+            if (content.includes(SENTINEL_COMMENT)) {
+                await rm(path);
+                removed++;
+            }
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=workflow-runner.js.map