@calmo/task-runner 1.2.2 → 2.0.0

package/openspec/project.md

@@ -0,0 +1,31 @@
+# Project: Task Runner
+
+## Overview
+The 'task-runner' project is a TypeScript-based utility designed to manage and execute tasks. It incorporates features such as task cancellation, pre-execution validation, and concurrency control, providing a robust framework for workflow automation.
+
+## Tech Stack
+- **Languages:** TypeScript 5.9.3
+- **Testing:** Vitest 4.0.17
+- **Core APIs:** AbortSignal/AbortController (Standard Web APIs for cancellation)
+- **Package Manager:** pnpm
+
+## Architecture
+The project follows a modular architecture with distinct components for managing different aspects of task execution:
+-   `EventBus.ts`: Handles event propagation within the system.
+-   `TaskGraph.ts`: Represents the structure and dependencies of tasks.
+-   `TaskGraphValidator.ts`: Ensures the validity of task graphs before execution.
+-   `TaskRunner.ts`: Orchestrates the execution of tasks.
+-   `WorkflowExecutor.ts`: Manages the overall workflow.
+-   `contracts/`: Defines interfaces and types for various components, promoting loose coupling and clear API boundaries.
+
+## Conventions
+-   **Coding Style:** Adheres to standard TypeScript conventions, enforced by ESLint and Prettier.
+-   **Commit Messages:** Follows conventional commits enforced by Commitlint.
+-   **Git Hooks:** Utilizes Husky for pre-commit and commit-msg hooks.
+-   **Testing:** Uses Vitest for unit and integration testing.
+
+## Build/Test/Run Commands
+-   **Install Dependencies:** `pnpm install`
+-   **Build Project:** `pnpm build`
+-   **Run Tests:** `pnpm test`
+-   **Lint Code:** `pnpm lint`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calmo/task-runner",
-  "version": "1.2.2",
+  "version": "2.0.0",
   "description": "",
   "repository": {
     "type": "git",

package/src/TaskGraphValidator.ts

@@ -93,34 +93,71 @@ export class TaskGraphValidator implements ITaskGraphValidator {
         };
     }
 
+    /**
+     * 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 => e.message);
+        return `Task graph validation failed: ${errorDetails.join("; ")}`;
+    }
+
     private detectCycle(
-        taskId: string,
+        startTaskId: string,
         path: string[],
         visited: Set<string>,
         recursionStack: Set<string>,
         adjacencyList: Map<string, string[]>
     ): boolean {
-        visited.add(taskId);
-        recursionStack.add(taskId);
-        path.push(taskId);
-
-        const dependencies = adjacencyList.get(taskId)!;
-        for (const dependenceId of dependencies) {
-            if (
-                !visited.has(dependenceId) &&
-                this.detectCycle(dependenceId, path, visited, recursionStack, adjacencyList)
-            ) {
-                return true;
-            } else if (recursionStack.has(dependenceId)) {
-                // Cycle detected
-                // Add the dependency to complete the visual cycle
-                path.push(dependenceId);
-                return true;
+        // Use an explicit stack to avoid maximum call stack size exceeded errors
+        const stack: { taskId: string; index: number; dependencies: string[] }[] = [];
+
+        visited.add(startTaskId);
+        recursionStack.add(startTaskId);
+        path.push(startTaskId);
+
+        stack.push({
+            taskId: startTaskId,
+            index: 0,
+            /* v8 ignore next */
+            dependencies: adjacencyList.get(startTaskId) ?? []
+        });
+
+        while (stack.length > 0) {
+            const frame = stack[stack.length - 1];
+            const { taskId, dependencies } = frame;
+
+            if (frame.index < dependencies.length) {
+                const dependenceId = dependencies[frame.index];
+                frame.index++;
+
+                if (recursionStack.has(dependenceId)) {
+                    // Cycle detected
+                    path.push(dependenceId);
+                    return true;
+                }
+
+                if (!visited.has(dependenceId)) {
+                    visited.add(dependenceId);
+                    recursionStack.add(dependenceId);
+                    path.push(dependenceId);
+
+                    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();
             }
         }
 
-        recursionStack.delete(taskId);
-        path.pop();
         return false;
     }
 }

package/src/TaskRunner.ts

@@ -65,41 +65,7 @@ export class TaskRunner<TContext> {
 
     const validationResult = this.validator.validate(taskGraph);
     if (!validationResult.isValid) {
-      // Construct error message compatible with legacy tests
-      const affectedTasks = new Set<string>();
-      const errorDetails: string[] = [];
-
-      for (const error of validationResult.errors) {
-        errorDetails.push(error.message);
-        switch (error.type) {
-          case "cycle": {
-            // details is { cyclePath: string[] }
-            const path = (error.details as { cyclePath: string[] }).cyclePath;
-            // The last element duplicates the first in the path representation, so valid unique tasks are slice(0, -1) or just all as Set handles uniq
-            path.forEach((t) => affectedTasks.add(t));
-            break;
-          }
-          case "missing_dependency": {
-            // details is { taskId: string, missingDependencyId: string }
-            const d = error.details as { taskId: string };
-            affectedTasks.add(d.taskId);
-            break;
-          }
-          case "duplicate_task": {
-            const d = error.details as { taskId: string };
-            affectedTasks.add(d.taskId);
-            break;
-          }
-        }
-      }
-
-      // Legacy error format: "Circular dependency or missing dependency detected. Unable to run tasks: A, B"
-      const taskList = Array.from(affectedTasks).join(", ");
-      const legacyMessage = `Circular dependency or missing dependency detected. Unable to run tasks: ${taskList}`;
-      const detailedMessage = `Task graph validation failed: ${errorDetails.join("; ")}`;
-
-      // Combine them to satisfy both legacy tests (checking for legacy message) and new requirements (clear details)
-      throw new Error(`${legacyMessage} | ${detailedMessage}`);
+      throw new Error(this.validator.createErrorMessage(validationResult));
     }
 
     const executor = new WorkflowExecutor(this.context, this.eventBus);

package/src/WorkflowExecutor.ts

@@ -29,77 +29,98 @@ export class WorkflowExecutor<TContext> {
     const results = new Map<string, TaskResult>();
     const executingPromises = new Set<Promise<void>>();
 
-    // Helper to process pending steps and launch ready ones
-    const processPendingSteps = () => {
-      const pendingSteps = steps.filter(
-        (step) => !results.has(step.name) && !this.running.has(step.name)
-      );
-
-      // 1. Identify and mark skipped tasks
-      for (const step of pendingSteps) {
-        const deps = step.dependencies ?? [];
-        const failedDep = deps.find(
-          (dep) => results.has(dep) && results.get(dep)?.status !== "success"
-        );
-        if (failedDep) {
-          const result: TaskResult = {
-            status: "skipped",
-            message: `Skipped due to failed dependency: ${failedDep}`,
-          };
-          results.set(step.name, result);
-          this.eventBus.emit("taskSkipped", { step, result });
-        }
-      }
-
-      // Re-filter pending steps as some might have been skipped above
-      const readySteps = steps.filter((step) => {
-        if (results.has(step.name) || this.running.has(step.name)) return false;
-        const deps = step.dependencies ?? [];
-        return deps.every(
-          (dep) => results.has(dep) && results.get(dep)?.status === "success"
-        );
-      });
-
-      // 2. Launch ready tasks
-      for (const step of readySteps) {
-        this.running.add(step.name);
-        this.eventBus.emit("taskStart", { step });
-
-        const taskPromise = (async () => {
-          try {
-            const result = await step.run(this.context);
-            results.set(step.name, result);
-          } catch (e) {
-            results.set(step.name, {
-              status: "failure",
-              error: e instanceof Error ? e.message : String(e),
-            });
-          } finally {
-            this.running.delete(step.name);
-            const result = results.get(step.name)!;
-            this.eventBus.emit("taskEnd", { step, result });
-          }
-        })();
-
-        // Wrap the task promise to ensure we can track it in the Set
-        const trackedPromise = taskPromise.then(() => {
-          executingPromises.delete(trackedPromise);
-        });
-        executingPromises.add(trackedPromise);
-      }
-    };
-
-    // Initial check to start independent tasks
-    processPendingSteps();
+    // Initial pass
+    this.processQueue(steps, results, executingPromises);
 
     while (results.size < steps.length && executingPromises.size > 0) {
       // Wait for the next task to finish
       await Promise.race(executingPromises);
       // After a task finishes, check for new work
-      processPendingSteps();
+      this.processQueue(steps, results, executingPromises);
     }
 
     this.eventBus.emit("workflowEnd", { context: this.context, results });
     return results;
   }
+
+  /**
+   * Logic to identify tasks that can be started or must be skipped.
+   */
+  private processQueue(
+    steps: TaskStep<TContext>[],
+    results: Map<string, TaskResult>,
+    executingPromises: Set<Promise<void>>
+  ): void {
+    this.handleSkippedTasks(steps, results);
+
+    const readySteps = this.getReadySteps(steps, results);
+
+    for (const step of readySteps) {
+      const taskPromise = this.runStep(step, results).then(() => {
+        executingPromises.delete(taskPromise);
+      });
+      executingPromises.add(taskPromise);
+    }
+  }
+
+  /**
+   * Identifies steps that cannot run because a dependency failed.
+   */
+  private handleSkippedTasks(steps: TaskStep<TContext>[], results: Map<string, TaskResult>): void {
+    const pendingSteps = steps.filter(
+      (step) => !results.has(step.name) && !this.running.has(step.name)
+    );
+
+    for (const step of pendingSteps) {
+      const deps = step.dependencies ?? [];
+      const failedDep = deps.find(
+        (dep) => results.has(dep) && results.get(dep)?.status !== "success"
+      );
+
+      if (failedDep) {
+        const result: TaskResult = {
+          status: "skipped",
+          message: `Skipped due to failed dependency: ${failedDep}`,
+        };
+        results.set(step.name, result);
+        this.eventBus.emit("taskSkipped", { step, result });
+      }
+    }
+  }
+
+  /**
+   * Returns steps where all dependencies have finished successfully.
+   */
+  private getReadySteps(steps: TaskStep<TContext>[], results: Map<string, TaskResult>): TaskStep<TContext>[] {
+    return steps.filter((step) => {
+      if (results.has(step.name) || this.running.has(step.name)) return false;
+
+      const deps = step.dependencies ?? [];
+      return deps.every(
+        (dep) => results.has(dep) && results.get(dep)?.status === "success"
+      );
+    });
+  }
+
+  /**
+   * Handles the lifecycle of a single task execution.
+   */
+  private async runStep(step: TaskStep<TContext>, results: Map<string, TaskResult>): Promise<void> {
+    this.running.add(step.name);
+    this.eventBus.emit("taskStart", { step });
+
+    try {
+      const result = await step.run(this.context);
+      results.set(step.name, result);
+    } catch (e) {
+      results.set(step.name, {
+        status: "failure",
+        error: e instanceof Error ? e.message : String(e),
+      });
+    } finally {
+      this.running.delete(step.name);
+      const result = results.get(step.name)!;
+      this.eventBus.emit("taskEnd", { step, result });
+    }
+  }
 }

package/src/contracts/ITaskGraphValidator.ts

@@ -11,4 +11,11 @@ export interface ITaskGraphValidator {
      * @returns A ValidationResult object indicating the outcome of the validation.
      */
     validate(taskGraph: TaskGraph): ValidationResult;
+
+    /**
+     * 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;
 }

package/test-report.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-<testsuites name="vitest tests" tests="32" failures="0" errors="0" time="0.171985314">
-    <testsuite name="tests/ComplexScenario.test.ts" timestamp="2026-01-18T05:44:30.743Z" hostname="runnervmmtnos" tests="2" failures="0" errors="0" skipped="0" time="0.008824338">
-        <testcase classname="tests/ComplexScenario.test.ts" name="Complex Scenario Integration Tests &gt; 1. All steps execute when all succeed and context is hydrated" time="0.005524092">
+<testsuites name="vitest tests" tests="36" failures="0" errors="0" time="0.286169223">
+    <testsuite name="tests/ComplexScenario.test.ts" timestamp="2026-01-18T15:13:46.722Z" hostname="runnervmmtnos" tests="2" failures="0" errors="0" skipped="0" time="0.009123917">
+        <testcase classname="tests/ComplexScenario.test.ts" name="Complex Scenario Integration Tests &gt; 1. All steps execute when all succeed and context is hydrated" time="0.005950364">
             <system-out>
 Running StepA
 Running StepB
@@ -15,77 +15,89 @@ Running StepG
 
             </system-out>
         </testcase>
-        <testcase classname="tests/ComplexScenario.test.ts" name="Complex Scenario Integration Tests &gt; 2. The &apos;skip&apos; propagation works as intended if something breaks up in the tree" time="0.001386436">
+        <testcase classname="tests/ComplexScenario.test.ts" name="Complex Scenario Integration Tests &gt; 2. The &apos;skip&apos; propagation works as intended if something breaks up in the tree" time="0.001176806">
         </testcase>
     </testsuite>
-    <testsuite name="tests/EventBus.test.ts" timestamp="2026-01-18T05:44:30.744Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.019386386">
-        <testcase classname="tests/EventBus.test.ts" name="EventBus &gt; should handle async listeners throwing errors without crashing" time="0.017035792">
+    <testsuite name="tests/EventBus.test.ts" timestamp="2026-01-18T15:13:46.724Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.019297461">
+        <testcase classname="tests/EventBus.test.ts" name="EventBus &gt; should handle async listeners throwing errors without crashing" time="0.017335491">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskGraphValidator.test.ts" timestamp="2026-01-18T05:44:30.745Z" hostname="runnervmmtnos" tests="9" failures="0" errors="0" skipped="0" time="0.010354972">
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should be instantiated" time="0.001917275">
+    <testsuite name="tests/TaskGraphValidator.test.ts" timestamp="2026-01-18T15:13:46.724Z" hostname="runnervmmtnos" tests="9" failures="0" errors="0" skipped="0" time="0.008829958">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should be instantiated" time="0.001727303">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid result for empty graph" time="0.00165162">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid result for empty graph" time="0.001258177">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect duplicate tasks" time="0.001990723">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect duplicate tasks" time="0.001873847">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect missing dependencies" time="0.00050915">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect missing dependencies" time="0.000404865">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect cycles" time="0.000507055">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect cycles" time="0.000448717">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid for a correct graph" time="0.00041269">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid for a correct graph" time="0.000404856">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should not detect cycles if missing dependencies are present" time="0.00036427">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should not detect cycles if missing dependencies are present" time="0.000360703">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect more complex cycles" time="0.000319536">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect more complex cycles" time="0.000276827">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should handle cycle detection with no cycles but shared dependencies" time="0.000239367">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should handle cycle detection with no cycles but shared dependencies" time="0.000241571">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskRunner.test.ts" timestamp="2026-01-18T05:44:30.747Z" hostname="runnervmmtnos" tests="10" failures="0" errors="0" skipped="0" time="0.112430041">
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run tasks in the correct sequential order" time="0.004173253">
+    <testsuite name="tests/TaskGraphValidatorDoS.test.ts" timestamp="2026-01-18T15:13:46.726Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.049329936">
+        <testcase classname="tests/TaskGraphValidatorDoS.test.ts" name="TaskGraphValidator - Deep Recursion &gt; should handle deep graphs without stack overflow" time="0.047337509">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle an empty list of tasks gracefully" time="0.00045054">
+    </testsuite>
+    <testsuite name="tests/TaskRunner.test.ts" timestamp="2026-01-18T15:13:46.727Z" hostname="runnervmmtnos" tests="10" failures="0" errors="0" skipped="0" time="0.112220851">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run tasks in the correct sequential order" time="0.0038045">
+        </testcase>
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle an empty list of tasks gracefully" time="0.000635346">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run independent tasks in parallel" time="0.099953731">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run independent tasks in parallel" time="0.100728925">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip dependent tasks if a root task fails" time="0.000542632">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip dependent tasks if a root task fails" time="0.000416347">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;circular dependency&apos;" time="0.002602664">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;circular dependency&apos;" time="0.002357119">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;missing dependency&apos;" time="0.000402671">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;missing dependency&apos;" time="0.000314708">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw an error during execution" time="0.000365011">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw an error during execution" time="0.000313525">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip tasks whose dependencies are skipped" time="0.000483552">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip tasks whose dependencies are skipped" time="0.00036969">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw a non-Error object during execution" time="0.000424773">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw a non-Error object during execution" time="0.000305942">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle duplicate steps where one gets skipped due to failed dependency" time="0.000467091">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle duplicate steps where one gets skipped due to failed dependency" time="0.000409565">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskRunnerEvents.test.ts" timestamp="2026-01-18T05:44:30.748Z" hostname="runnervmmtnos" tests="7" failures="0" errors="0" skipped="0" time="0.015344879">
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire all lifecycle events in a successful run" time="0.005483039">
+    <testsuite name="tests/TaskRunnerEvents.test.ts" timestamp="2026-01-18T15:13:46.729Z" hostname="runnervmmtnos" tests="7" failures="0" errors="0" skipped="0" time="0.020279996">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire all lifecycle events in a successful run" time="0.007839309">
+        </testcase>
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire taskSkipped event when dependency fails" time="0.005329486">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire taskSkipped event when dependency fails" time="0.004914606">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should not crash if a listener throws an error" time="0.001806131">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should not crash if a listener throws an error" time="0.001456386">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire workflow events even for empty step list" time="0.000492118">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire workflow events even for empty step list" time="0.000272478">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should handle unsubscribe correctly" time="0.000713071">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should handle unsubscribe correctly" time="0.000554882">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should safely handle off() when no listeners exist" time="0.00075527">
+        </testcase>
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should support multiple listeners for the same event" time="0.000722328">
+        </testcase>
+    </testsuite>
+    <testsuite name="tests/WorkflowExecutor.test.ts" timestamp="2026-01-18T15:13:46.730Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.058601689">
+        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should execute steps sequentially when dependencies exist" time="0.004596878">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should safely handle off() when no listeners exist" time="0.000162473">
+        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should skip dependent steps if dependency fails" time="0.000424162">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should support multiple listeners for the same event" time="0.000345023">
+        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should run independent steps in parallel" time="0.051090362">
         </testcase>
     </testsuite>
-    <testsuite name="tests/integration.test.ts" timestamp="2026-01-18T05:44:30.750Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.005644698">
-        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for duplicate tasks" time="0.003288223">
+    <testsuite name="tests/integration.test.ts" timestamp="2026-01-18T15:13:46.731Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.008485415">
+        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for duplicate tasks" time="0.004859699">
         </testcase>
-        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for missing dependencies" time="0.000378435">
+        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for missing dependencies" time="0.000630747">
         </testcase>
-        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for cycles" time="0.000325437">
+        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for cycles" time="0.000504291">
         </testcase>
     </testsuite>
 </testsuites>