@gravito/flux 3.0.1 → 3.0.3

package/dist/bun.d.ts

@@ -1,74 +1,113 @@
 import { Database } from 'bun:sqlite';
-import { o as WorkflowStorage, m as WorkflowState, l as WorkflowFilter } from './types-CZwYGpou.js';
+import { p as WorkflowStorage, a as WorkflowState, n as WorkflowFilter } from './types-CGIEQPFv.js';
 
 /**
- * @fileoverview Bun SQLite Storage Adapter
- *
- * High-performance storage using Bun's built-in SQLite.
- *
- * @module @gravito/flux/storage
- */
-
-/**
- * SQLite Storage Options
+ * Configuration options for the Bun SQLite storage adapter.
  */
 interface BunSQLiteStorageOptions {
-    /** Database file path (default: ':memory:') */
+    /**
+     * Path to the SQLite database file.
+     * Use ':memory:' for an ephemeral in-memory database.
+     */
     path?: string;
-    /** Table name (default: 'flux_workflows') */
+    /**
+     * Name of the table used to store workflow states.
+     */
     tableName?: string;
 }
 /**
- * Bun SQLite Storage
+ * BunSQLiteStorage provides a persistent storage backend for Flux workflows using Bun's native SQLite module.
  *
- * High-performance storage adapter using Bun's built-in SQLite.
+ * It handles automatic table creation, indexing for performance, and serialization of workflow state
+ * into a relational format.
  *
  * @example
  * ```typescript
- * const engine = new FluxEngine({
- *   storage: new BunSQLiteStorage({ path: './data/flux.db' })
- * })
+ * const storage = new BunSQLiteStorage({
+ *   path: './workflows.db',
+ *   tableName: 'my_workflows'
+ * });
+ * await storage.init();
  * ```
  */
 declare class BunSQLiteStorage implements WorkflowStorage {
     private db;
     private tableName;
     private initialized;
+    /**
+     * Creates a new instance of BunSQLiteStorage.
+     *
+     * @param options - Configuration for the database connection and table naming.
+     */
     constructor(options?: BunSQLiteStorageOptions);
     /**
-     * Initialize storage (create tables)
+     * Initializes the database schema and required indexes.
+     *
+     * This method is idempotent and will be called automatically by other operations if not invoked manually.
+     *
+     * @throws {Error} If the database schema cannot be created or indexes fail to initialize.
      */
     init(): Promise<void>;
     /**
-     * Save workflow state
+     * Persists or updates a workflow state in the database.
+     *
+     * Uses an "INSERT OR REPLACE" strategy to ensure the latest state is always stored for a given ID.
+     *
+     * @param state - The current state of the workflow to be saved.
+     * @throws {Error} If the database write operation fails or serialization errors occur.
      */
     save(state: WorkflowState): Promise<void>;
     /**
-     * Load workflow state by ID
+     * Retrieves a workflow state by its unique identifier.
+     *
+     * @param id - The unique ID of the workflow to load.
+     * @returns The reconstructed workflow state, or null if no record is found.
+     * @throws {Error} If the database query fails or deserialization of stored JSON fails.
      */
     load(id: string): Promise<WorkflowState | null>;
     /**
-     * List workflow states with optional filter
+     * Lists workflow states based on the provided filtering criteria.
+     *
+     * Results are returned in descending order of creation time.
+     *
+     * @param filter - Criteria for filtering and paginating the results.
+     * @returns An array of workflow states matching the filter.
+     * @throws {Error} If the database query fails.
      */
     list(filter?: WorkflowFilter): Promise<WorkflowState[]>;
     /**
-     * Delete workflow state
+     * Deletes a workflow state from the database.
+     *
+     * @param id - The unique ID of the workflow to delete.
+     * @throws {Error} If the database deletion fails.
      */
     delete(id: string): Promise<void>;
     /**
-     * Close database connection
+     * Closes the database connection and resets the initialization state.
+     *
+     * @throws {Error} If the database connection cannot be closed cleanly.
      */
     close(): Promise<void>;
     /**
-     * Convert SQLite row to WorkflowState
+     * Converts a raw database row into a structured WorkflowState object.
+     *
+     * @param row - The raw SQLite row data.
+     * @returns The parsed workflow state.
+     * @private
      */
     private rowToState;
     /**
-     * Get raw database (for advanced usage)
+     * Provides direct access to the underlying Bun SQLite Database instance.
+     *
+     * Useful for performing custom queries or maintenance tasks.
+     *
+     * @returns The raw Database instance.
      */
     getDatabase(): Database;
     /**
-     * Run a vacuum to optimize database
+     * Performs a VACUUM operation to reclaim unused space and defragment the database.
+     *
+     * @throws {Error} If the VACUUM operation fails.
      */
     vacuum(): void;
 }

package/dist/bun.js

@@ -1,6 +1,6 @@
 import {
   BunSQLiteStorage
-} from "./chunk-ZAMVC732.js";
+} from "./chunk-EZGSU6AW.js";
 export {
   BunSQLiteStorage
 };

package/dist/chunk-6AZNHVEO.cjs

@@ -0,0 +1,316 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/visualization/MermaidGenerator.ts
+var MermaidGenerator = class {
+  /**
+   * Generates a Mermaid flowchart from a workflow definition.
+   *
+   * @param definition - The workflow definition to visualize
+   * @param options - Customization options
+   * @returns Mermaid diagram syntax as a string
+   *
+   * @example
+   * ```typescript
+   * const generator = new MermaidGenerator()
+   * const diagram = generator.generateFromDefinition(workflow, {
+   *   showDetails: true,
+   *   showParallelGroups: true
+   * })
+   * console.log(diagram)
+   * ```
+   */
+  generateFromDefinition(definition, options = {}) {
+    const { showDetails = false, showParallelGroups = true, theme = "default" } = options;
+    const lines = [];
+    lines.push(`%%{init: {'theme':'${theme}'}}%%`);
+    lines.push("flowchart TD");
+    lines.push(`  Start([Start: ${definition.name}])`);
+    let prevNode = "Start";
+    const parallelGroups = /* @__PURE__ */ new Map();
+    if (showParallelGroups) {
+      for (const step of definition.steps) {
+        if (step.parallelGroup) {
+          const group = parallelGroups.get(step.parallelGroup) || [];
+          group.push(step.name);
+          parallelGroups.set(step.parallelGroup, group);
+        }
+      }
+    }
+    const processedGroups = /* @__PURE__ */ new Set();
+    for (let i = 0; i < definition.steps.length; i++) {
+      const step = definition.steps[i];
+      if (step.parallelGroup && showParallelGroups) {
+        if (processedGroups.has(step.parallelGroup)) {
+          continue;
+        }
+        processedGroups.add(step.parallelGroup);
+        const groupSteps = parallelGroups.get(step.parallelGroup);
+        const groupName = `ParallelGroup_${step.parallelGroup}`;
+        lines.push(`  subgraph ${groupName}[" "]`);
+        lines.push(`    direction LR`);
+        for (const stepName of groupSteps) {
+          const s = definition.steps.find((st) => st.name === stepName);
+          const nodeId = this.sanitizeNodeId(stepName);
+          const label = this.buildStepLabel(s, showDetails);
+          const shape = s.commit ? `[${label}]` : `(${label})`;
+          lines.push(`    ${nodeId}${shape}`);
+          if (s.compensate) {
+            lines.push(`    ${nodeId}_comp[\u{1F504} Compensate]`);
+            lines.push(`    ${nodeId} -.->|on failure| ${nodeId}_comp`);
+          }
+        }
+        lines.push(`  end`);
+        lines.push(`  ${prevNode} --> ${groupName}`);
+        prevNode = groupName;
+      } else if (!step.parallelGroup) {
+        const nodeId = this.sanitizeNodeId(step.name);
+        const label = this.buildStepLabel(step, showDetails);
+        const shape = step.commit ? `[${label}]` : `(${label})`;
+        lines.push(`  ${nodeId}${shape}`);
+        if (step.when) {
+          const condId = `${nodeId}_cond`;
+          lines.push(`  ${condId}{Condition?}`);
+          lines.push(`  ${prevNode} --> ${condId}`);
+          lines.push(`  ${condId} -->|yes| ${nodeId}`);
+          lines.push(`  ${condId} -->|no| ${this.getNextNodeId(definition.steps, i)}`);
+          prevNode = nodeId;
+        } else {
+          lines.push(`  ${prevNode} --> ${nodeId}`);
+          prevNode = nodeId;
+        }
+        if (step.compensate) {
+          lines.push(`  ${nodeId}_comp[\u{1F504} Compensate]`);
+          lines.push(`  ${nodeId} -.->|on failure| ${nodeId}_comp`);
+        }
+      }
+    }
+    lines.push(`  ${prevNode} --> End([End])`);
+    lines.push("");
+    lines.push("  classDef commitStep fill:#e1f5e1,stroke:#4caf50,stroke-width:2px");
+    lines.push("  classDef normalStep fill:#e3f2fd,stroke:#2196f3,stroke-width:2px");
+    lines.push(
+      "  classDef compensateStep fill:#fff3e0,stroke:#ff9800,stroke-width:1px,stroke-dasharray: 5 5"
+    );
+    return lines.join("\n");
+  }
+  /**
+   * Generates a Mermaid flowchart from a workflow execution state.
+   * Overlays execution status (completed, failed, compensated) on top of the structure.
+   *
+   * @param definition - The workflow definition
+   * @param state - The current execution state
+   * @param options - Customization options
+   * @returns Mermaid diagram syntax with status overlay
+   *
+   * @example
+   * ```typescript
+   * const diagram = generator.generateFromState(workflow, executionState, {
+   *   showStatus: true,
+   *   showDetails: true
+   * })
+   * ```
+   */
+  generateFromState(definition, state, options = {}) {
+    const {
+      showDetails = true,
+      showStatus = true,
+      showParallelGroups = true,
+      theme = "default"
+    } = options;
+    const lines = [];
+    lines.push(`%%{init: {'theme':'${theme}'}}%%`);
+    lines.push("flowchart TD");
+    lines.push(`  Start([Start: ${definition.name}])`);
+    lines.push(`  Start:::started`);
+    let prevNode = "Start";
+    const parallelGroups = /* @__PURE__ */ new Map();
+    const executionMap = /* @__PURE__ */ new Map();
+    for (const exec of state.history) {
+      executionMap.set(exec.name, exec);
+    }
+    if (showParallelGroups) {
+      for (const step of definition.steps) {
+        if (step.parallelGroup) {
+          const group = parallelGroups.get(step.parallelGroup) || [];
+          group.push(step.name);
+          parallelGroups.set(step.parallelGroup, group);
+        }
+      }
+    }
+    const processedGroups = /* @__PURE__ */ new Set();
+    for (let i = 0; i < definition.steps.length; i++) {
+      const step = definition.steps[i];
+      if (step.parallelGroup && showParallelGroups) {
+        if (processedGroups.has(step.parallelGroup)) {
+          continue;
+        }
+        processedGroups.add(step.parallelGroup);
+        const groupSteps = parallelGroups.get(step.parallelGroup);
+        const groupName = `ParallelGroup_${step.parallelGroup}`;
+        lines.push(`  subgraph ${groupName}[" "]`);
+        lines.push(`    direction LR`);
+        for (const stepName of groupSteps) {
+          const s = definition.steps.find((st) => st.name === stepName);
+          const nodeId = this.sanitizeNodeId(stepName);
+          const exec = executionMap.get(stepName);
+          const label = this.buildStepLabelWithStatus(s, exec, showDetails, showStatus);
+          const shape = s.commit ? `[${label}]` : `(${label})`;
+          lines.push(`    ${nodeId}${shape}`);
+          if (exec && showStatus) {
+            const statusClass = this.getStatusClass(exec.status);
+            lines.push(`    ${nodeId}:::${statusClass}`);
+          }
+          if (s.compensate && _optionalChain([exec, 'optionalAccess', _ => _.status]) === "compensated") {
+            lines.push(`    ${nodeId}_comp[\u{1F504} Compensated]`);
+            lines.push(`    ${nodeId}_comp:::compensated`);
+            lines.push(`    ${nodeId} -.->|rolled back| ${nodeId}_comp`);
+          }
+        }
+        lines.push(`  end`);
+        lines.push(`  ${prevNode} --> ${groupName}`);
+        prevNode = groupName;
+      } else if (!step.parallelGroup) {
+        const nodeId = this.sanitizeNodeId(step.name);
+        const exec = executionMap.get(step.name);
+        const label = this.buildStepLabelWithStatus(step, exec, showDetails, showStatus);
+        const shape = step.commit ? `[${label}]` : `(${label})`;
+        lines.push(`  ${nodeId}${shape}`);
+        if (exec && showStatus) {
+          const statusClass = this.getStatusClass(exec.status);
+          lines.push(`  ${nodeId}:::${statusClass}`);
+        }
+        if (step.when) {
+          const condId = `${nodeId}_cond`;
+          const skipped = _optionalChain([exec, 'optionalAccess', _2 => _2.status]) === "skipped";
+          lines.push(`  ${condId}{Condition?}`);
+          lines.push(`  ${prevNode} --> ${condId}`);
+          if (skipped) {
+            lines.push(`  ${condId}:::skipped`);
+            lines.push(`  ${condId} -->|no| ${nodeId}`);
+          } else {
+            lines.push(`  ${condId} -->|yes| ${nodeId}`);
+          }
+        } else {
+          lines.push(`  ${prevNode} --> ${nodeId}`);
+        }
+        if (step.compensate && _optionalChain([exec, 'optionalAccess', _3 => _3.status]) === "compensated") {
+          lines.push(`  ${nodeId}_comp[\u{1F504} Compensated]`);
+          lines.push(`  ${nodeId}_comp:::compensated`);
+          lines.push(`  ${nodeId} -.->|rolled back| ${nodeId}_comp`);
+        }
+        prevNode = nodeId;
+      }
+    }
+    const finalStatus = this.getWorkflowFinalStatus(state.status);
+    lines.push(`  ${prevNode} --> End([End: ${finalStatus}])`);
+    lines.push(`  End:::${this.getStatusClass(state.status)}`);
+    lines.push("");
+    lines.push("  classDef started fill:#e3f2fd,stroke:#2196f3,stroke-width:2px");
+    lines.push("  classDef completed fill:#e8f5e9,stroke:#4caf50,stroke-width:2px");
+    lines.push("  classDef failed fill:#ffebee,stroke:#f44336,stroke-width:2px");
+    lines.push("  classDef compensated fill:#fff3e0,stroke:#ff9800,stroke-width:2px");
+    lines.push(
+      "  classDef skipped fill:#f5f5f5,stroke:#9e9e9e,stroke-width:1px,stroke-dasharray: 5 5"
+    );
+    lines.push("  classDef pending fill:#fafafa,stroke:#bdbdbd,stroke-width:1px");
+    lines.push(
+      "  classDef suspended fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,stroke-dasharray: 3 3"
+    );
+    return lines.join("\n");
+  }
+  sanitizeNodeId(name) {
+    return name.replace(/[^a-zA-Z0-9_]/g, "_");
+  }
+  buildStepLabel(step, showDetails) {
+    let label = step.name;
+    if (showDetails) {
+      const meta = [];
+      if (step.commit) {
+        meta.push("\u{1F4DD}");
+      }
+      if (step.retries && step.retries > 0) {
+        meta.push(`\u21BB${step.retries}`);
+      }
+      if (step.timeout) {
+        meta.push(`\u23F1${step.timeout}ms`);
+      }
+      if (step.when) {
+        meta.push("\u2753");
+      }
+      if (meta.length > 0) {
+        label += `<br/><small>${meta.join(" ")}</small>`;
+      }
+    }
+    return label;
+  }
+  buildStepLabelWithStatus(step, exec, showDetails, showStatus) {
+    let label = step.name;
+    if (showStatus && exec) {
+      label += `<br/><small><b>${exec.status.toUpperCase()}</b></small>`;
+      if (exec.duration) {
+        label += `<br/><small>${exec.duration}ms</small>`;
+      }
+      if (exec.retries > 0) {
+        label += `<br/><small>Retries: ${exec.retries}</small>`;
+      }
+    } else if (showDetails) {
+      const meta = [];
+      if (step.commit) {
+        meta.push("\u{1F4DD}");
+      }
+      if (step.retries && step.retries > 0) {
+        meta.push(`\u21BB${step.retries}`);
+      }
+      if (step.timeout) {
+        meta.push(`\u23F1${step.timeout}ms`);
+      }
+      if (step.when) {
+        meta.push("\u2753");
+      }
+      if (meta.length > 0) {
+        label += `<br/><small>${meta.join(" ")}</small>`;
+      }
+    }
+    return label;
+  }
+  getStatusClass(status) {
+    switch (status) {
+      case "completed":
+        return "completed";
+      case "failed":
+        return "failed";
+      case "compensated":
+      case "compensating":
+        return "compensated";
+      case "skipped":
+        return "skipped";
+      case "suspended":
+        return "suspended";
+      case "running":
+        return "started";
+      default:
+        return "pending";
+    }
+  }
+  getWorkflowFinalStatus(status) {
+    switch (status) {
+      case "completed":
+        return "\u2705 Completed";
+      case "failed":
+        return "\u274C Failed";
+      case "rolled_back":
+        return "\u{1F504} Rolled Back";
+      case "suspended":
+        return "\u23F8 Suspended";
+      default:
+        return status;
+    }
+  }
+  getNextNodeId(steps, currentIndex) {
+    const nextStep = steps[currentIndex + 1];
+    return nextStep ? this.sanitizeNodeId(nextStep.name) : "End";
+  }
+};
+
+
+
+exports.MermaidGenerator = MermaidGenerator;
+//# sourceMappingURL=chunk-6AZNHVEO.cjs.map

package/dist/chunk-6AZNHVEO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-6AZNHVEO.cjs","../src/visualization/MermaidGenerator.ts"],"names":[],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-6AZNHVEO.cjs","sourcesContent":[null,"import type { StepExecution, WorkflowDefinition, WorkflowState } from '../types'\n\n/**\n * Options for customizing Mermaid diagram generation.\n */\nexport interface MermaidOptions {\n  /** Include detailed step information (retries, timeout, conditions). */\n  showDetails?: boolean\n  /** Include execution history with status colors. */\n  showStatus?: boolean\n  /** Render parallel groups visually. */\n  showParallelGroups?: boolean\n  /** Theme: 'default' | 'dark' | 'forest' | 'neutral'. */\n  theme?: 'default' | 'dark' | 'forest' | 'neutral'\n}\n\n/**\n * Generates Mermaid flowchart diagrams from workflow definitions and execution states.\n *\n * **Features**:\n * - Workflow structure visualization (steps, parallel groups, conditions)\n * - Execution status overlay (completed, failed, compensated)\n * - Detailed metadata (retries, timeout, commit markers)\n *\n * **Use Cases**:\n * - Documentation generation\n * - Debugging workflow execution\n * - Visual workflow design validation\n */\nexport class MermaidGenerator {\n  /**\n   * Generates a Mermaid flowchart from a workflow definition.\n   *\n   * @param definition - The workflow definition to visualize\n   * @param options - Customization options\n   * @returns Mermaid diagram syntax as a string\n   *\n   * @example\n   * ```typescript\n   * const generator = new MermaidGenerator()\n   * const diagram = generator.generateFromDefinition(workflow, {\n   *   showDetails: true,\n   *   showParallelGroups: true\n   * })\n   * console.log(diagram)\n   * ```\n   */\n  generateFromDefinition<TInput, TData>(\n    definition: WorkflowDefinition<TInput, TData>,\n    options: MermaidOptions = {}\n  ): string {\n    const { showDetails = false, showParallelGroups = true, theme = 'default' } = options\n\n    const lines: string[] = []\n    lines.push(`%%{init: {'theme':'${theme}'}}%%`)\n    lines.push('flowchart TD')\n    lines.push(`  Start([Start: ${definition.name}])`)\n\n    let prevNode = 'Start'\n    const parallelGroups = new Map<string, string[]>()\n\n    // First pass: identify parallel groups\n    if (showParallelGroups) {\n      for (const step of definition.steps) {\n        if (step.parallelGroup) {\n          const group = parallelGroups.get(step.parallelGroup) || []\n          group.push(step.name)\n          parallelGroups.set(step.parallelGroup, group)\n        }\n      }\n    }\n\n    const processedGroups = new Set<string>()\n\n    for (let i = 0; i < definition.steps.length; i++) {\n      const step = definition.steps[i]!\n\n      // Handle parallel groups\n      if (step.parallelGroup && showParallelGroups) {\n        if (processedGroups.has(step.parallelGroup)) {\n          continue // Already processed this group\n        }\n        processedGroups.add(step.parallelGroup)\n\n        const groupSteps = parallelGroups.get(step.parallelGroup)!\n        const groupName = `ParallelGroup_${step.parallelGroup}`\n\n        // Create subgraph for parallel execution\n        lines.push(`  subgraph ${groupName}[\" \"]`)\n        lines.push(`    direction LR`)\n\n        for (const stepName of groupSteps) {\n          const s = definition.steps.find((st) => st.name === stepName)!\n          const nodeId = this.sanitizeNodeId(stepName)\n          const label = this.buildStepLabel(s, showDetails)\n          const shape = s.commit ? `[${label}]` : `(${label})`\n          lines.push(`    ${nodeId}${shape}`)\n\n          if (s.compensate) {\n            lines.push(`    ${nodeId}_comp[🔄 Compensate]`)\n            lines.push(`    ${nodeId} -.->|on failure| ${nodeId}_comp`)\n          }\n        }\n\n        lines.push(`  end`)\n        lines.push(`  ${prevNode} --> ${groupName}`)\n        prevNode = groupName\n      } else if (!step.parallelGroup) {\n        // Regular sequential step\n        const nodeId = this.sanitizeNodeId(step.name)\n        const label = this.buildStepLabel(step, showDetails)\n        const shape = step.commit ? `[${label}]` : `(${label})`\n\n        lines.push(`  ${nodeId}${shape}`)\n\n        // Handle conditional steps\n        if (step.when) {\n          const condId = `${nodeId}_cond`\n          lines.push(`  ${condId}{Condition?}`)\n          lines.push(`  ${prevNode} --> ${condId}`)\n          lines.push(`  ${condId} -->|yes| ${nodeId}`)\n          lines.push(`  ${condId} -->|no| ${this.getNextNodeId(definition.steps, i)}`)\n          prevNode = nodeId\n        } else {\n          lines.push(`  ${prevNode} --> ${nodeId}`)\n          prevNode = nodeId\n        }\n\n        // Show compensation\n        if (step.compensate) {\n          lines.push(`  ${nodeId}_comp[🔄 Compensate]`)\n          lines.push(`  ${nodeId} -.->|on failure| ${nodeId}_comp`)\n        }\n      }\n    }\n\n    lines.push(`  ${prevNode} --> End([End])`)\n\n    // Add styling\n    lines.push('')\n    lines.push('  classDef commitStep fill:#e1f5e1,stroke:#4caf50,stroke-width:2px')\n    lines.push('  classDef normalStep fill:#e3f2fd,stroke:#2196f3,stroke-width:2px')\n    lines.push(\n      '  classDef compensateStep fill:#fff3e0,stroke:#ff9800,stroke-width:1px,stroke-dasharray: 5 5'\n    )\n\n    return lines.join('\\n')\n  }\n\n  /**\n   * Generates a Mermaid flowchart from a workflow execution state.\n   * Overlays execution status (completed, failed, compensated) on top of the structure.\n   *\n   * @param definition - The workflow definition\n   * @param state - The current execution state\n   * @param options - Customization options\n   * @returns Mermaid diagram syntax with status overlay\n   *\n   * @example\n   * ```typescript\n   * const diagram = generator.generateFromState(workflow, executionState, {\n   *   showStatus: true,\n   *   showDetails: true\n   * })\n   * ```\n   */\n  generateFromState<TInput, TData>(\n    definition: WorkflowDefinition<TInput, TData>,\n    state: WorkflowState<TInput, TData>,\n    options: MermaidOptions = {}\n  ): string {\n    const {\n      showDetails = true,\n      showStatus = true,\n      showParallelGroups = true,\n      theme = 'default',\n    } = options\n\n    const lines: string[] = []\n    lines.push(`%%{init: {'theme':'${theme}'}}%%`)\n    lines.push('flowchart TD')\n    lines.push(`  Start([Start: ${definition.name}])`)\n    lines.push(`  Start:::started`)\n\n    let prevNode = 'Start'\n    const parallelGroups = new Map<string, string[]>()\n    const executionMap = new Map<string, StepExecution>()\n\n    // Build execution map\n    for (const exec of state.history) {\n      executionMap.set(exec.name, exec)\n    }\n\n    // Identify parallel groups\n    if (showParallelGroups) {\n      for (const step of definition.steps) {\n        if (step.parallelGroup) {\n          const group = parallelGroups.get(step.parallelGroup) || []\n          group.push(step.name)\n          parallelGroups.set(step.parallelGroup, group)\n        }\n      }\n    }\n\n    const processedGroups = new Set<string>()\n\n    for (let i = 0; i < definition.steps.length; i++) {\n      const step = definition.steps[i]!\n\n      // Handle parallel groups\n      if (step.parallelGroup && showParallelGroups) {\n        if (processedGroups.has(step.parallelGroup)) {\n          continue\n        }\n        processedGroups.add(step.parallelGroup)\n\n        const groupSteps = parallelGroups.get(step.parallelGroup)!\n        const groupName = `ParallelGroup_${step.parallelGroup}`\n\n        lines.push(`  subgraph ${groupName}[\" \"]`)\n        lines.push(`    direction LR`)\n\n        for (const stepName of groupSteps) {\n          const s = definition.steps.find((st) => st.name === stepName)!\n          const nodeId = this.sanitizeNodeId(stepName)\n          const exec = executionMap.get(stepName)\n          const label = this.buildStepLabelWithStatus(s, exec, showDetails, showStatus)\n          const shape = s.commit ? `[${label}]` : `(${label})`\n\n          lines.push(`    ${nodeId}${shape}`)\n\n          if (exec && showStatus) {\n            const statusClass = this.getStatusClass(exec.status)\n            lines.push(`    ${nodeId}:::${statusClass}`)\n          }\n\n          if (s.compensate && exec?.status === 'compensated') {\n            lines.push(`    ${nodeId}_comp[🔄 Compensated]`)\n            lines.push(`    ${nodeId}_comp:::compensated`)\n            lines.push(`    ${nodeId} -.->|rolled back| ${nodeId}_comp`)\n          }\n        }\n\n        lines.push(`  end`)\n        lines.push(`  ${prevNode} --> ${groupName}`)\n        prevNode = groupName\n      } else if (!step.parallelGroup) {\n        const nodeId = this.sanitizeNodeId(step.name)\n        const exec = executionMap.get(step.name)\n        const label = this.buildStepLabelWithStatus(step, exec, showDetails, showStatus)\n        const shape = step.commit ? `[${label}]` : `(${label})`\n\n        lines.push(`  ${nodeId}${shape}`)\n\n        if (exec && showStatus) {\n          const statusClass = this.getStatusClass(exec.status)\n          lines.push(`  ${nodeId}:::${statusClass}`)\n        }\n\n        if (step.when) {\n          const condId = `${nodeId}_cond`\n          const skipped = exec?.status === 'skipped'\n          lines.push(`  ${condId}{Condition?}`)\n          lines.push(`  ${prevNode} --> ${condId}`)\n\n          if (skipped) {\n            lines.push(`  ${condId}:::skipped`)\n            lines.push(`  ${condId} -->|no| ${nodeId}`)\n          } else {\n            lines.push(`  ${condId} -->|yes| ${nodeId}`)\n          }\n        } else {\n          lines.push(`  ${prevNode} --> ${nodeId}`)\n        }\n\n        if (step.compensate && exec?.status === 'compensated') {\n          lines.push(`  ${nodeId}_comp[🔄 Compensated]`)\n          lines.push(`  ${nodeId}_comp:::compensated`)\n          lines.push(`  ${nodeId} -.->|rolled back| ${nodeId}_comp`)\n        }\n\n        prevNode = nodeId\n      }\n    }\n\n    const finalStatus = this.getWorkflowFinalStatus(state.status)\n    lines.push(`  ${prevNode} --> End([End: ${finalStatus}])`)\n    lines.push(`  End:::${this.getStatusClass(state.status)}`)\n\n    // Add status-based styling\n    lines.push('')\n    lines.push('  classDef started fill:#e3f2fd,stroke:#2196f3,stroke-width:2px')\n    lines.push('  classDef completed fill:#e8f5e9,stroke:#4caf50,stroke-width:2px')\n    lines.push('  classDef failed fill:#ffebee,stroke:#f44336,stroke-width:2px')\n    lines.push('  classDef compensated fill:#fff3e0,stroke:#ff9800,stroke-width:2px')\n    lines.push(\n      '  classDef skipped fill:#f5f5f5,stroke:#9e9e9e,stroke-width:1px,stroke-dasharray: 5 5'\n    )\n    lines.push('  classDef pending fill:#fafafa,stroke:#bdbdbd,stroke-width:1px')\n    lines.push(\n      '  classDef suspended fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,stroke-dasharray: 3 3'\n    )\n\n    return lines.join('\\n')\n  }\n\n  private sanitizeNodeId(name: string): string {\n    return name.replace(/[^a-zA-Z0-9_]/g, '_')\n  }\n\n  private buildStepLabel(step: any, showDetails: boolean): string {\n    let label = step.name\n\n    if (showDetails) {\n      const meta: string[] = []\n      if (step.commit) {\n        meta.push('📝')\n      }\n      if (step.retries && step.retries > 0) {\n        meta.push(`↻${step.retries}`)\n      }\n      if (step.timeout) {\n        meta.push(`⏱${step.timeout}ms`)\n      }\n      if (step.when) {\n        meta.push('❓')\n      }\n\n      if (meta.length > 0) {\n        label += `<br/><small>${meta.join(' ')}</small>`\n      }\n    }\n\n    return label\n  }\n\n  private buildStepLabelWithStatus(\n    step: any,\n    exec: StepExecution | undefined,\n    showDetails: boolean,\n    showStatus: boolean\n  ): string {\n    let label = step.name\n\n    if (showStatus && exec) {\n      label += `<br/><small><b>${exec.status.toUpperCase()}</b></small>`\n\n      if (exec.duration) {\n        label += `<br/><small>${exec.duration}ms</small>`\n      }\n\n      if (exec.retries > 0) {\n        label += `<br/><small>Retries: ${exec.retries}</small>`\n      }\n    } else if (showDetails) {\n      const meta: string[] = []\n      if (step.commit) {\n        meta.push('📝')\n      }\n      if (step.retries && step.retries > 0) {\n        meta.push(`↻${step.retries}`)\n      }\n      if (step.timeout) {\n        meta.push(`⏱${step.timeout}ms`)\n      }\n      if (step.when) {\n        meta.push('❓')\n      }\n\n      if (meta.length > 0) {\n        label += `<br/><small>${meta.join(' ')}</small>`\n      }\n    }\n\n    return label\n  }\n\n  private getStatusClass(status: string): string {\n    switch (status) {\n      case 'completed':\n        return 'completed'\n      case 'failed':\n        return 'failed'\n      case 'compensated':\n      case 'compensating':\n        return 'compensated'\n      case 'skipped':\n        return 'skipped'\n      case 'suspended':\n        return 'suspended'\n      case 'running':\n        return 'started'\n      default:\n        return 'pending'\n    }\n  }\n\n  private getWorkflowFinalStatus(status: string): string {\n    switch (status) {\n      case 'completed':\n        return '✅ Completed'\n      case 'failed':\n        return '❌ Failed'\n      case 'rolled_back':\n        return '🔄 Rolled Back'\n      case 'suspended':\n        return '⏸ Suspended'\n      default:\n        return status\n    }\n  }\n\n  private getNextNodeId(steps: any[], currentIndex: number): string {\n    const nextStep = steps[currentIndex + 1]\n    return nextStep ? this.sanitizeNodeId(nextStep.name) : 'End'\n  }\n}\n"]}