@calmo/task-runner 3.3.0 → 3.4.1

package/coverage/lcov-report/src/TaskGraphValidator.ts.html

@@ -46,7 +46,7 @@
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>54/54</span>
+                <span class='fraction'>55/55</span>
             </div>
         
             
@@ -226,7 +226,12 @@
 <a name='L161'></a><a href='#L161'>161</a>
 <a name='L162'></a><a href='#L162'>162</a>
 <a name='L163'></a><a href='#L163'>163</a>
-<a name='L164'></a><a href='#L164'>164</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<a name='L164'></a><a href='#L164'>164</a>
+<a name='L165'></a><a href='#L165'>165</a>
+<a name='L166'></a><a href='#L166'>166</a>
+<a name='L167'></a><a href='#L167'>167</a>
+<a name='L168'></a><a href='#L168'>168</a>
+<a name='L169'></a><a href='#L169'>169</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -243,27 +248,27 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">60x</span>
+<span class="cline-any cline-yes">61x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">60x</span>
-<span class="cline-any cline-yes">60x</span>
-<span class="cline-any cline-yes">20157x</span>
+<span class="cline-any cline-yes">61x</span>
+<span class="cline-any cline-yes">61x</span>
+<span class="cline-any cline-yes">20158x</span>
 <span class="cline-any cline-yes">3x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">20154x</span>
+<span class="cline-any cline-yes">20155x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">60x</span>
-<span class="cline-any cline-yes">20157x</span>
-<span class="cline-any cline-yes">20168x</span>
-<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-yes">61x</span>
+<span class="cline-any cline-yes">20158x</span>
+<span class="cline-any cline-yes">20169x</span>
+<span class="cline-any cline-yes">7x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -274,10 +279,12 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">60x</span>
+<span class="cline-any cline-yes">61x</span>
+<span class="cline-any cline-yes">9x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">60x</span>
-<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">61x</span>
+<span class="cline-any cline-yes">6x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -301,6 +308,8 @@
 <span class="cline-any cline-yes">20139x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">5x</span>
 <span class="cline-any cline-yes">5x</span>
 <span class="cline-any cline-yes">5x</span>
@@ -327,8 +336,9 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">8x</span>
-<span class="cline-any cline-yes">8x</span>
+<span class="cline-any cline-yes">9x</span>
+<span class="cline-any cline-yes">9x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -395,162 +405,167 @@ import { ValidationError } from "./contracts/ValidationError.js";
 import { TaskGraph } from "./TaskGraph.js";
 &nbsp;
 export class TaskGraphValidator implements ITaskGraphValidator {
-    /**
-     * Validates a given task graph for structural integrity.
-     * Checks for:
-     * 1. Duplicate task IDs.
-     * 2. Missing dependencies (tasks that depend on non-existent IDs).
-     * 3. Circular dependencies (cycles in the graph).
-     *
-     * @param taskGraph The task graph to validate.
-     * @returns A ValidationResult object indicating the outcome of the validation.
-     */
-    validate(taskGraph: TaskGraph): ValidationResult {
-        const errors: ValidationError[] = [];
-&nbsp;
-        // 1. Check for duplicate tasks
-        const taskIds = new Set&lt;string&gt;();
-        for (const task of taskGraph.tasks) {
-            if (taskIds.has(task.id)) {
-                errors.push({
-                    type: "duplicate_task",
-                    message: `Duplicate task detected with ID: ${task.id}`,
-                    details: { taskId: task.id }
-                });
-            } else {
-                taskIds.add(task.id);
-            }
-        }
-&nbsp;
-        // 2. Check for missing dependencies
-        for (const task of taskGraph.tasks) {
-            for (const dependenceId of task.dependencies) {
-                if (!taskIds.has(dependenceId)) {
-                    errors.push({
-                        type: "missing_dependency",
-                        message: `Task '${task.id}' depends on missing task '${dependenceId}'`,
-                        details: { taskId: task.id, missingDependencyId: dependenceId }
-                    });
-                }
-            }
-        }
+  /**
+   * Validates a given task graph for structural integrity.
+   * Checks for:
+   * 1. Duplicate task IDs.
+   * 2. Missing dependencies (tasks that depend on non-existent IDs).
+   * 3. Circular dependencies (cycles in the graph).
+   *
+   * @param taskGraph The task graph to validate.
+   * @returns A ValidationResult object indicating the outcome of the validation.
+   */
+  validate(taskGraph: TaskGraph): ValidationResult {
+    const errors: ValidationError[] = [];
 &nbsp;
-        // 3. Check for cycles
-        // Only run cycle detection if there are no missing dependencies, otherwise we might chase non-existent nodes.
-        const hasMissingDependencies = errors.some(e =&gt; e.type === "missing_dependency");
+    // 1. Check for duplicate tasks
+    const taskIds = new Set&lt;string&gt;();
+    for (const task of taskGraph.tasks) {
+      if (taskIds.has(task.id)) {
+        errors.push({
+          type: "duplicate_task",
+          message: `Duplicate task detected with ID: ${task.id}`,
+          details: { taskId: task.id },
+        });
+      } else {
+        taskIds.add(task.id);
+      }
+    }
 &nbsp;
-        if (hasMissingDependencies) {
-            return {
-                isValid: errors.length === 0,
-                errors
-            };
+    // 2. Check for missing dependencies
+    for (const task of taskGraph.tasks) {
+      for (const dependenceId of task.dependencies) {
+        if (!taskIds.has(dependenceId)) {
+          errors.push({
+            type: "missing_dependency",
+            message: `Task '${task.id}' depends on missing task '${dependenceId}'`,
+            details: { taskId: task.id, missingDependencyId: dependenceId },
+          });
         }
+      }
+    }
 &nbsp;
-        // Build adjacency list
-        const adjacencyList = new Map&lt;string, string[]&gt;();
-        for (const task of taskGraph.tasks) {
-            adjacencyList.set(task.id, task.dependencies);
-        }
+    // 3. Check for cycles
+    // Only run cycle detection if there are no missing dependencies, otherwise we might chase non-existent nodes.
+    const hasMissingDependencies = errors.some(
+      (e) =&gt; e.type === "missing_dependency"
+    );
 &nbsp;
-        const visited = new Set&lt;string&gt;();
-        const recursionStack = new Set&lt;string&gt;();
+    if (hasMissingDependencies) {
+      return {
+        isValid: errors.length === 0,
+        errors,
+      };
+    }
 &nbsp;
-        for (const task of taskGraph.tasks) {
-            if (visited.has(task.id)) {
-                continue;
-            }
+    // Build adjacency list
+    const adjacencyList = new Map&lt;string, string[]&gt;();
+    for (const task of taskGraph.tasks) {
+      adjacencyList.set(task.id, task.dependencies);
+    }
 &nbsp;
-            const path: string[] = [];
-            if (this.detectCycle(task.id, path, visited, recursionStack, adjacencyList)) {
-                // Extract the actual cycle from the path
-                // The path might look like A -&gt; B -&gt; C -&gt; B (if we started at A and found cycle B-C-B)
-                const cycleStart = path[path.length - 1];
-                const cycleStartIndex = path.indexOf(cycleStart);
-                const cyclePath = path.slice(cycleStartIndex);
+    const visited = new Set&lt;string&gt;();
+    const recursionStack = new Set&lt;string&gt;();
 &nbsp;
-                errors.push({
-                    type: "cycle",
-                    message: `Cycle detected: ${cyclePath.join(" -&gt; ")}`,
-                    details: { cyclePath }
-                });
-                // Break after first cycle found to avoid spamming similar errors
-                break;
-            }
-        }
+    for (const task of taskGraph.tasks) {
+      if (visited.has(task.id)) {
+        continue;
+      }
 &nbsp;
-        return {
-            isValid: errors.length === 0,
-            errors
-        };
-    }
+      const path: string[] = [];
+      if (
+        this.detectCycle(task.id, path, visited, recursionStack, adjacencyList)
+      ) {
+        // Extract the actual cycle from the path
+        // The path might look like A -&gt; B -&gt; C -&gt; B (if we started at A and found cycle B-C-B)
+        const cycleStart = path[path.length - 1];
+        const cycleStartIndex = path.indexOf(cycleStart);
+        const cyclePath = path.slice(cycleStartIndex);
 &nbsp;
-    /**
-     * Creates a human-readable error message from a validation result.
-     * @param result The validation result containing errors.
-     * @returns A formatted error string.
-     */
-    createErrorMessage(result: ValidationResult): string {
-        const errorDetails = result.errors.map(e =&gt; e.message);
-        return `Task graph validation failed: ${errorDetails.join("; ")}`;
+        errors.push({
+          type: "cycle",
+          message: `Cycle detected: ${cyclePath.join(" -&gt; ")}`,
+          details: { cyclePath },
+        });
+        // Break after first cycle found to avoid spamming similar errors
+        break;
+      }
     }
 &nbsp;
-    private detectCycle(
-        startTaskId: string,
-        path: string[],
-        visited: Set&lt;string&gt;,
-        recursionStack: Set&lt;string&gt;,
-        adjacencyList: Map&lt;string, string[]&gt;
-    ): boolean {
-        // Use an explicit stack to avoid maximum call stack size exceeded errors
-        const stack: { taskId: string; index: number; dependencies: string[] }[] = [];
+    return {
+      isValid: errors.length === 0,
+      errors,
+    };
+  }
 &nbsp;
-        visited.add(startTaskId);
-        recursionStack.add(startTaskId);
-        path.push(startTaskId);
+  /**
+   * Creates a human-readable error message from a validation result.
+   * @param result The validation result containing errors.
+   * @returns A formatted error string.
+   */
+  createErrorMessage(result: ValidationResult): string {
+    const errorDetails = result.errors.map((e) =&gt; e.message);
+    return `Task graph validation failed: ${errorDetails.join("; ")}`;
+  }
 &nbsp;
-        stack.push({
-            taskId: startTaskId,
-            index: 0,
-            /* v8 ignore next */
-            dependencies: adjacencyList.get(startTaskId) ?? []
-        });
+  private detectCycle(
+    startTaskId: string,
+    path: string[],
+    visited: Set&lt;string&gt;,
+    recursionStack: Set&lt;string&gt;,
+    adjacencyList: Map&lt;string, string[]&gt;
+  ): boolean {
+    // Use an explicit stack to avoid maximum call stack size exceeded errors
+    const stack: { taskId: string; index: number; dependencies: string[] }[] =
+      [];
 &nbsp;
-        while (stack.length &gt; 0) {
-            const frame = stack[stack.length - 1];
-            const { taskId, dependencies } = frame;
+    visited.add(startTaskId);
+    recursionStack.add(startTaskId);
+    path.push(startTaskId);
 &nbsp;
-            if (frame.index &lt; dependencies.length) {
-                const dependenceId = dependencies[frame.index];
-                frame.index++;
+    stack.push({
+      taskId: startTaskId,
+      index: 0,
+      /* v8 ignore next */
+      dependencies: adjacencyList.get(startTaskId) ?? [],
+    });
 &nbsp;
-                if (recursionStack.has(dependenceId)) {
-                    // Cycle detected
-                    path.push(dependenceId);
-                    return true;
-                }
+    while (stack.length &gt; 0) {
+      const frame = stack[stack.length - 1];
+      const { taskId, dependencies } = frame;
 &nbsp;
-                if (!visited.has(dependenceId)) {
-                    visited.add(dependenceId);
-                    recursionStack.add(dependenceId);
-                    path.push(dependenceId);
+      if (frame.index &lt; dependencies.length) {
+        const dependenceId = dependencies[frame.index];
+        frame.index++;
 &nbsp;
-                    stack.push({
-                        taskId: dependenceId,
-                        index: 0,
-                        /* v8 ignore next */
-                        dependencies: adjacencyList.get(dependenceId) ?? []
-                    });
-                }
-            } else {
-                // Finished all dependencies for this node
-                recursionStack.delete(taskId);
-                path.pop();
-                stack.pop();
-            }
+        if (recursionStack.has(dependenceId)) {
+          // Cycle detected
+          path.push(dependenceId);
+          return true;
         }
 &nbsp;
-        return false;
+        if (!visited.has(dependenceId)) {
+          visited.add(dependenceId);
+          recursionStack.add(dependenceId);
+          path.push(dependenceId);
+&nbsp;
+          stack.push({
+            taskId: dependenceId,
+            index: 0,
+            /* v8 ignore next */
+            dependencies: adjacencyList.get(dependenceId) ?? [],
+          });
+        }
+      } else {
+        // Finished all dependencies for this node
+        recursionStack.delete(taskId);
+        path.pop();
+        stack.pop();
+      }
     }
+&nbsp;
+    return false;
+  }
 }
 &nbsp;</pre></td></tr></table></pre>
 
@@ -559,7 +574,7 @@ export class TaskGraphValidator implements ITaskGraphValidator {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-01-18T20:12:36.630Z
+                at 2026-01-18T21:02:31.387Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/TaskRunner.ts.html

@@ -260,7 +260,12 @@
 <a name='L195'></a><a href='#L195'>195</a>
 <a name='L196'></a><a href='#L196'>196</a>
 <a name='L197'></a><a href='#L197'>197</a>
-<a name='L198'></a><a href='#L198'>198</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<a name='L198'></a><a href='#L198'>198</a>
+<a name='L199'></a><a href='#L199'>199</a>
+<a name='L200'></a><a href='#L200'>200</a>
+<a name='L201'></a><a href='#L201'>201</a>
+<a name='L202'></a><a href='#L202'>202</a>
+<a name='L203'></a><a href='#L203'>203</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -283,16 +288,19 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">56x</span>
-<span class="cline-any cline-yes">56x</span>
-<span class="cline-any cline-yes">56x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">57x</span>
+<span class="cline-any cline-yes">57x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">57x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">56x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">57x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -347,7 +355,6 @@
 <span class="cline-any cline-yes">24x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -364,8 +371,6 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -391,16 +396,19 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">51x</span>
-<span class="cline-any cline-yes">139x</span>
+<span class="cline-any cline-yes">52x</span>
+<span class="cline-any cline-yes">140x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">52x</span>
+<span class="cline-any cline-yes">52x</span>
+<span class="cline-any cline-yes">9x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">51x</span>
-<span class="cline-any cline-yes">51x</span>
-<span class="cline-any cline-yes">8x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">43x</span>
@@ -419,12 +427,14 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">51x</span>
+<span class="cline-any cline-yes">52x</span>
 <span class="cline-any cline-yes">5x</span>
 <span class="cline-any cline-yes">5x</span>
 <span class="cline-any cline-yes">3x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">5x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -461,11 +471,15 @@
 import { TaskResult } from "./TaskResult.js";
 import { TaskGraphValidator } from "./TaskGraphValidator.js";
 import { TaskGraph } from "./TaskGraph.js";
-import { RunnerEventPayloads, RunnerEventListener } from "./contracts/RunnerEvents.js";
+import {
+  RunnerEventPayloads,
+  RunnerEventListener,
+} from "./contracts/RunnerEvents.js";
 import { EventBus } from "./EventBus.js";
 import { WorkflowExecutor } from "./WorkflowExecutor.js";
 import { TaskRunnerExecutionConfig } from "./TaskRunnerExecutionConfig.js";
 import { TaskStateManager } from "./TaskStateManager.js";
+import { TaskGraphValidationError } from "./TaskGraphValidationError.js";
 import { IExecutionStrategy } from "./strategies/IExecutionStrategy.js";
 import { StandardExecutionStrategy } from "./strategies/StandardExecutionStrategy.js";
 import { RetryingExecutionStrategy } from "./strategies/RetryingExecutionStrategy.js";
@@ -482,9 +496,8 @@ export { RunnerEventPayloads, RunnerEventListener, TaskRunnerExecutionConfig };
 export class TaskRunner&lt;TContext&gt; {
   private eventBus = new EventBus&lt;TContext&gt;();
   private validator = new TaskGraphValidator();
-  private executionStrategy: IExecutionStrategy&lt;TContext&gt; = new RetryingExecutionStrategy(
-    new StandardExecutionStrategy()
-  );
+  private executionStrategy: IExecutionStrategy&lt;TContext&gt; =
+    new RetryingExecutionStrategy(new StandardExecutionStrategy());
 &nbsp;
   /**
    * @param context The shared context object to be passed to each task.
@@ -542,7 +555,6 @@ export class TaskRunner&lt;TContext&gt; {
     // Actually, Mermaid ID cannot have spaces without quotes.
     const safeId = (name: string) =&gt; JSON.stringify(name);
     const sanitize = (name: string) =&gt; this.sanitizeMermaidId(name);
-&nbsp;
 &nbsp;
     // Add all nodes first to ensure they exist
     for (const step of steps) {
@@ -556,9 +568,7 @@ export class TaskRunner&lt;TContext&gt; {
     for (const step of steps) {
       if (step.dependencies) {
         for (const dep of step.dependencies) {
-          graphLines.push(
-            `  ${sanitize(dep)} --&gt; ${sanitize(step.name)}`
-          );
+          graphLines.push(`  ${sanitize(dep)} --&gt; ${sanitize(step.name)}`);
         }
       }
     }
@@ -597,7 +607,10 @@ export class TaskRunner&lt;TContext&gt; {
 &nbsp;
     const validationResult = this.validator.validate(taskGraph);
     if (!validationResult.isValid) {
-      throw new Error(this.validator.createErrorMessage(validationResult));
+      throw new TaskGraphValidationError(
+        validationResult,
+        this.validator.createErrorMessage(validationResult)
+      );
     }
 &nbsp;
     const stateManager = new TaskStateManager(this.eventBus);
@@ -617,40 +630,42 @@ export class TaskRunner&lt;TContext&gt; {
 &nbsp;
     // We need to handle the timeout cleanup properly.
     if (config?.timeout !== undefined) {
-       const controller = new AbortController();
-       const timeoutId = setTimeout(() =&gt; {
-         controller.abort(new Error(`Workflow timed out after ${config.timeout}ms`));
-       }, config.timeout);
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() =&gt; {
+        controller.abort(
+          new Error(`Workflow timed out after ${config.timeout}ms`)
+        );
+      }, config.timeout);
 &nbsp;
-       let effectiveSignal = controller.signal;
-       let onAbort: (() =&gt; void) | undefined;
+      let effectiveSignal = controller.signal;
+      let onAbort: (() =&gt; void) | undefined;
 &nbsp;
-       // Handle combination of signals if user provided one
-       if (config.signal) {
-          if (config.signal.aborted) {
-             // If already aborted, use it directly (WorkflowExecutor handles early abort)
-             // We can cancel timeout immediately
-             clearTimeout(timeoutId);
-             effectiveSignal = config.signal;
-          } else {
-             // Listen to user signal to abort our controller
-             onAbort = () =&gt; {
-                controller.abort(config.signal?.reason);
-             };
-             config.signal.addEventListener("abort", onAbort);
-          }
-       }
+      // Handle combination of signals if user provided one
+      if (config.signal) {
+        if (config.signal.aborted) {
+          // If already aborted, use it directly (WorkflowExecutor handles early abort)
+          // We can cancel timeout immediately
+          clearTimeout(timeoutId);
+          effectiveSignal = config.signal;
+        } else {
+          // Listen to user signal to abort our controller
+          onAbort = () =&gt; {
+            controller.abort(config.signal?.reason);
+          };
+          config.signal.addEventListener("abort", onAbort);
+        }
+      }
 &nbsp;
-       try {
-         return await executor.execute(steps, effectiveSignal);
-       } finally {
-         clearTimeout(timeoutId);
-         if (config.signal &amp;&amp; onAbort) {
-            config.signal.removeEventListener("abort", onAbort);
-         }
-       }
+      try {
+        return await executor.execute(steps, effectiveSignal);
+      } finally {
+        clearTimeout(timeoutId);
+        if (config.signal &amp;&amp; onAbort) {
+          config.signal.removeEventListener("abort", onAbort);
+        }
+      }
     } else {
-       return executor.execute(steps, config?.signal);
+      return executor.execute(steps, config?.signal);
     }
   }
 }
@@ -661,7 +676,7 @@ export class TaskRunner&lt;TContext&gt; {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-01-18T20:12:36.630Z
+                at 2026-01-18T21:02:31.387Z
             </div>
         <script src="../prettify.js"></script>
         <script>