@calmo/task-runner 3.1.0 → 3.2.0

package/package.json

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

package/src/TaskRunner.ts

@@ -9,6 +9,7 @@ import { TaskRunnerExecutionConfig } from "./TaskRunnerExecutionConfig.js";
 import { TaskStateManager } from "./TaskStateManager.js";
 import { IExecutionStrategy } from "./strategies/IExecutionStrategy.js";
 import { StandardExecutionStrategy } from "./strategies/StandardExecutionStrategy.js";
+import { RetryingExecutionStrategy } from "./strategies/RetryingExecutionStrategy.js";
 import { DryRunExecutionStrategy } from "./strategies/DryRunExecutionStrategy.js";
 
 // Re-export types for backward compatibility
@@ -22,7 +23,9 @@ export { RunnerEventPayloads, RunnerEventListener, TaskRunnerExecutionConfig };
 export class TaskRunner<TContext> {
   private eventBus = new EventBus<TContext>();
   private validator = new TaskGraphValidator();
-  private executionStrategy: IExecutionStrategy<TContext> = new StandardExecutionStrategy();
+  private executionStrategy: IExecutionStrategy<TContext> = new RetryingExecutionStrategy(
+    new StandardExecutionStrategy()
+  );
 
   /**
    * @param context The shared context object to be passed to each task.

package/src/TaskStep.ts

@@ -1,4 +1,5 @@
 import { TaskResult } from "./TaskResult.js";
+import { TaskRetryConfig } from "./contracts/TaskRetryConfig.js";
 
 /**
  * Represents a single, executable step within a workflow.
@@ -9,6 +10,8 @@ export interface TaskStep<TContext> {
   name: string;
   /** An optional list of task names that must complete successfully before this step can run. */
   dependencies?: string[];
+  /** Optional retry configuration for the task. */
+  retry?: TaskRetryConfig;
   /**
    * The core logic of the task.
    * @param context The shared context object, allowing for state to be passed between tasks.

package/src/contracts/TaskRetryConfig.ts

@@ -0,0 +1,8 @@
+export interface TaskRetryConfig {
+  /** Number of retries (excluding the initial run). */
+  attempts: number;
+  /** Delay in milliseconds between retries. */
+  delay: number;
+  /** Backoff strategy: 'fixed' (default) or 'exponential'. */
+  backoff?: "fixed" | "exponential";
+}

package/src/index.ts

@@ -2,7 +2,9 @@ export { TaskRunner } from "./TaskRunner.js";
 export { TaskRunnerBuilder } from "./TaskRunnerBuilder.js";
 export { TaskStateManager } from "./TaskStateManager.js";
 export { StandardExecutionStrategy } from "./strategies/StandardExecutionStrategy.js";
+export { RetryingExecutionStrategy } from "./strategies/RetryingExecutionStrategy.js";
 export type { IExecutionStrategy } from "./strategies/IExecutionStrategy.js";
+export type { TaskRetryConfig } from "./contracts/TaskRetryConfig.js";
 export type { TaskStep } from "./TaskStep.js";
 export type { TaskResult } from "./TaskResult.js";
 export type { TaskStatus } from "./TaskStatus.js";

package/src/strategies/RetryingExecutionStrategy.ts

@@ -0,0 +1,90 @@
+import { IExecutionStrategy } from "./IExecutionStrategy.js";
+import { TaskStep } from "../TaskStep.js";
+import { TaskResult } from "../TaskResult.js";
+
+/**
+ * Execution strategy that retries tasks upon failure based on their retry configuration.
+ */
+export class RetryingExecutionStrategy<TContext> implements IExecutionStrategy<TContext> {
+  constructor(private innerStrategy: IExecutionStrategy<TContext>) {}
+
+  async execute(
+    step: TaskStep<TContext>,
+    context: TContext,
+    signal?: AbortSignal
+  ): Promise<TaskResult> {
+    const config = step.retry;
+    if (!config) {
+      return this.innerStrategy.execute(step, context, signal);
+    }
+
+    let attempt = 0;
+    while (true) {
+      // Check for cancellation before execution
+      if (signal?.aborted) {
+        return {
+          status: "cancelled",
+          message: "Task cancelled before execution",
+        };
+      }
+
+      const result = await this.innerStrategy.execute(step, context, signal);
+
+      if (result.status === "success" || result.status === "cancelled" || result.status === "skipped") {
+        return result;
+      }
+
+      // Task failed, check if we should retry
+      if (attempt >= config.attempts) {
+        return result; // Max attempts reached, return failure
+      }
+
+      attempt++;
+
+      // Calculate delay
+      let delay = config.delay;
+      if (config.backoff === "exponential") {
+        delay = config.delay * Math.pow(2, attempt - 1);
+      }
+
+      // Wait for delay, respecting cancellation
+      try {
+        await this.sleep(delay, signal);
+      } catch (e) {
+      if (signal?.aborted) {
+        return {
+          status: "cancelled",
+          message: "Task cancelled during retry delay",
+        };
+      }
+      throw e;
+      }
+    }
+  }
+
+  private sleep(ms: number, signal?: AbortSignal): Promise<void> {
+    return new Promise((resolve, reject) => {
+      if (signal?.aborted) {
+        reject(new Error("AbortError"));
+        return;
+      }
+
+      const timer = setTimeout(() => {
+        cleanup();
+        resolve();
+      }, ms);
+
+      const onAbort = () => {
+        clearTimeout(timer);
+        cleanup();
+        reject(new Error("AbortError"));
+      };
+
+      const cleanup = () => {
+        signal?.removeEventListener("abort", onAbort);
+      };
+
+      signal?.addEventListener("abort", onAbort);
+    });
+  }
+}

package/test-report.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-<testsuites name="vitest tests" tests="73" failures="0" errors="0" time="0.754679547">
-    <testsuite name="tests/ComplexScenario.test.ts" timestamp="2026-01-18T18:12:39.220Z" hostname="runnervmmtnos" tests="2" failures="0" errors="0" skipped="0" time="0.011704892">
-        <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.007835477">
+<testsuites name="vitest tests" tests="82" failures="0" errors="0" time="0.785820378">
+    <testsuite name="tests/ComplexScenario.test.ts" timestamp="2026-01-18T18:46:49.739Z" hostname="runnervmmtnos" tests="2" failures="0" errors="0" skipped="0" time="0.013047963">
+        <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.008439296">
             <system-out>
 Running StepA
 Running StepB
@@ -15,183 +15,203 @@ 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.001197405">
+        <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.002316602">
         </testcase>
     </testsuite>
-    <testsuite name="tests/DryRunExecutionStrategy.test.ts" timestamp="2026-01-18T18:12:39.221Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.003459238">
-        <testcase classname="tests/DryRunExecutionStrategy.test.ts" name="DryRunExecutionStrategy &gt; should return success without running the task" time="0.001914755">
+    <testsuite name="tests/DryRunExecutionStrategy.test.ts" timestamp="2026-01-18T18:46:49.740Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.003482613">
+        <testcase classname="tests/DryRunExecutionStrategy.test.ts" name="DryRunExecutionStrategy &gt; should return success without running the task" time="0.001915555">
         </testcase>
     </testsuite>
-    <testsuite name="tests/EventBus.test.ts" timestamp="2026-01-18T18:12:39.222Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.017999624">
-        <testcase classname="tests/EventBus.test.ts" name="EventBus &gt; should handle async listeners throwing errors without crashing" time="0.015821096">
+    <testsuite name="tests/EventBus.test.ts" timestamp="2026-01-18T18:46:49.741Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.024092755">
+        <testcase classname="tests/EventBus.test.ts" name="EventBus &gt; should handle async listeners throwing errors without crashing" time="0.020617446">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskGraphValidator.test.ts" timestamp="2026-01-18T18:12:39.222Z" hostname="runnervmmtnos" tests="9" failures="0" errors="0" skipped="0" time="0.011382149">
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should be instantiated" time="0.001899887">
+    <testsuite name="tests/TaskGraphValidator.test.ts" timestamp="2026-01-18T18:46:49.741Z" hostname="runnervmmtnos" tests="9" failures="0" errors="0" skipped="0" time="0.009883353">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should be instantiated" time="0.001875719">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid result for empty graph" time="0.001737874">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid result for empty graph" time="0.001637773">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect duplicate tasks" time="0.002036873">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect duplicate tasks" time="0.001916166">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect missing dependencies" time="0.000562039">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect missing dependencies" time="0.00044542">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect cycles" time="0.000863322">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect cycles" time="0.000433328">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid for a correct graph" time="0.000538966">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid for a correct graph" time="0.000368676">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should not detect cycles if missing dependencies are present" time="0.000377365">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should not detect cycles if missing dependencies are present" time="0.000359628">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect more complex cycles" time="0.000308877">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect more complex cycles" time="0.000276081">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should handle cycle detection with no cycles but shared dependencies" time="0.00036466">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should handle cycle detection with no cycles but shared dependencies" time="0.000227679">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskGraphValidatorDoS.test.ts" timestamp="2026-01-18T18:12:39.225Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.041649175">
-        <testcase classname="tests/TaskGraphValidatorDoS.test.ts" name="TaskGraphValidator - Deep Recursion &gt; should handle deep graphs without stack overflow" time="0.039614286">
+    <testsuite name="tests/TaskGraphValidatorDoS.test.ts" timestamp="2026-01-18T18:46:49.743Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.036618642">
+        <testcase classname="tests/TaskGraphValidatorDoS.test.ts" name="TaskGraphValidator - Deep Recursion &gt; should handle deep graphs without stack overflow" time="0.035004656">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskRunner.test.ts" timestamp="2026-01-18T18:12:39.225Z" hostname="runnervmmtnos" tests="10" failures="0" errors="0" skipped="0" time="0.11229965">
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run tasks in the correct sequential order" time="0.004393812">
+    <testsuite name="tests/TaskRunner.test.ts" timestamp="2026-01-18T18:46:49.743Z" hostname="runnervmmtnos" tests="10" failures="0" errors="0" skipped="0" time="0.113731907">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run tasks in the correct sequential order" time="0.004694148">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle an empty list of tasks gracefully" time="0.000536321">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle an empty list of tasks gracefully" time="0.00059366">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run independent tasks in parallel" time="0.100527713">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run independent tasks in parallel" time="0.100602941">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip dependent tasks if a root task fails" time="0.000423">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip dependent tasks if a root task fails" time="0.0004344">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;circular dependency&apos;" time="0.001873287">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;circular dependency&apos;" time="0.002507171">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;missing dependency&apos;" time="0.00040734">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;missing dependency&apos;" time="0.00044014">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw an error during execution" time="0.000383796">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw an error during execution" time="0.000387592">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip tasks whose dependencies are skipped" time="0.000511766">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip tasks whose dependencies are skipped" time="0.000607847">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw a non-Error object during execution" time="0.000416708">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw a non-Error object during execution" time="0.000421054">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle duplicate steps where one gets skipped due to failed dependency" time="0.000533827">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle duplicate steps where one gets skipped due to failed dependency" time="0.000498732">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskRunnerEvents.test.ts" timestamp="2026-01-18T18:12:39.227Z" hostname="runnervmmtnos" tests="7" failures="0" errors="0" skipped="0" time="0.019539167">
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire all lifecycle events in a successful run" time="0.008228782">
+    <testsuite name="tests/TaskRunnerEvents.test.ts" timestamp="2026-01-18T18:46:49.745Z" hostname="runnervmmtnos" tests="7" failures="0" errors="0" skipped="0" time="0.018258426">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire all lifecycle events in a successful run" time="0.0065126">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire taskSkipped event when dependency fails" time="0.00515295">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire taskSkipped event when dependency fails" time="0.005135632">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should not crash if a listener throws an error" time="0.001447632">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should not crash if a listener throws an error" time="0.001568409">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire workflow events even for empty step list" time="0.000565135">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire workflow events even for empty step list" time="0.000519159">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should handle unsubscribe correctly" time="0.000747466">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should handle unsubscribe correctly" time="0.001143738">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should safely handle off() when no listeners exist" time="0.000408022">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should safely handle off() when no listeners exist" time="0.000436914">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should support multiple listeners for the same event" time="0.00061583">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should support multiple listeners for the same event" time="0.000591366">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskRunnerMermaid.test.ts" timestamp="2026-01-18T18:12:39.228Z" hostname="runnervmmtnos" tests="4" failures="0" errors="0" skipped="0" time="0.00721517">
-        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should generate a simple graph with no dependencies" time="0.003558584">
+    <testsuite name="tests/TaskRunnerMermaid.test.ts" timestamp="2026-01-18T18:46:49.747Z" hostname="runnervmmtnos" tests="4" failures="0" errors="0" skipped="0" time="0.008826577">
+        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should generate a simple graph with no dependencies" time="0.004010268">
         </testcase>
-        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should generate a graph with dependencies" time="0.000646657">
+        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should generate a graph with dependencies" time="0.00076336">
         </testcase>
-        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should handle mixed independent and dependent tasks" time="0.000325818">
+        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should handle mixed independent and dependent tasks" time="0.000498951">
         </testcase>
-        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should handle special characters in task names" time="0.000442687">
+        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should handle special characters in task names" time="0.000779572">
         </testcase>
     </testsuite>
-    <testsuite name="tests/TaskRunnerRefactor.test.ts" timestamp="2026-01-18T18:12:39.229Z" hostname="runnervmmtnos" tests="6" failures="0" errors="0" skipped="0" time="0.007211009">
-        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; should allow setting execution strategy" time="0.001715663">
+    <testsuite name="tests/TaskRunnerRefactor.test.ts" timestamp="2026-01-18T18:46:49.747Z" hostname="runnervmmtnos" tests="6" failures="0" errors="0" skipped="0" time="0.007360431">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; should allow setting execution strategy" time="0.002132073">
         </testcase>
-        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; should allow unsubscribing from events" time="0.000975977">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; should allow unsubscribing from events" time="0.001008373">
         </testcase>
-        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskStateManager.cancelAllPending should handle non-existing tasks gracefully" time="0.000457464">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskStateManager.cancelAllPending should handle non-existing tasks gracefully" time="0.000394634">
         </testcase>
-        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskRunnerBuilder should build a TaskRunner" time="0.000437858">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskRunnerBuilder should build a TaskRunner" time="0.0005405">
         </testcase>
-        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskRunnerBuilder should build a TaskRunner with no listeners" time="0.000220612">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskRunnerBuilder should build a TaskRunner with no listeners" time="0.000147949">
         </testcase>
-        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; WorkflowExecutor should break infinite loop if no progress can be made" time="0.001620796">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; WorkflowExecutor should break infinite loop if no progress can be made" time="0.001442983">
         </testcase>
     </testsuite>
-    <testsuite name="tests/WorkflowExecutor.test.ts" timestamp="2026-01-18T18:12:39.230Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.056302731">
-        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should execute steps sequentially when dependencies exist" time="0.003118142">
+    <testsuite name="tests/WorkflowExecutor.test.ts" timestamp="2026-01-18T18:46:49.749Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.05590929">
+        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should execute steps sequentially when dependencies exist" time="0.002859246">
         </testcase>
-        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should skip dependent steps if dependency fails" time="0.000479806">
+        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should skip dependent steps if dependency fails" time="0.000417738">
         </testcase>
-        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should run independent steps in parallel" time="0.050936934">
+        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should run independent steps in parallel" time="0.050881922">
         </testcase>
     </testsuite>
-    <testsuite name="tests/cancellation.test.ts" timestamp="2026-01-18T18:12:39.231Z" hostname="runnervmmtnos" tests="10" failures="0" errors="0" skipped="0" time="0.160856804">
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should execute tasks normally without cancellation" time="0.003322061">
+    <testsuite name="tests/cancellation.test.ts" timestamp="2026-01-18T18:46:49.749Z" hostname="runnervmmtnos" tests="10" failures="0" errors="0" skipped="0" time="0.160982347">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should execute tasks normally without cancellation" time="0.003469007">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via AbortSignal" time="0.011234474">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via AbortSignal" time="0.011267273">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via global timeout" time="0.049697551">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via global timeout" time="0.049708076">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should handle pre-aborted signal" time="0.000409645">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should handle pre-aborted signal" time="0.000396578">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should propagate cancellation to running task" time="0.010620648">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should propagate cancellation to running task" time="0.010483123">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should respect timeout over signal if timeout happens first" time="0.050354487">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should respect timeout over signal if timeout happens first" time="0.050629716">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should handle case where timeout is set AND signal is already aborted" time="0.000521704">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should handle case where timeout is set AND signal is already aborted" time="0.000410585">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via AbortSignal when timeout is also set" time="0.010740512">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via AbortSignal when timeout is also set" time="0.010701365">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should fail task if it throws non-abort error during cancellation" time="0.011047434">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should fail task if it throws non-abort error during cancellation" time="0.010792487">
         </testcase>
-        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel task if it rejects with signal.reason" time="0.010617862">
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel task if it rejects with signal.reason" time="0.010733646">
         </testcase>
     </testsuite>
-    <testsuite name="tests/integration.test.ts" timestamp="2026-01-18T18:12:39.233Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.008439546">
-        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for duplicate tasks" time="0.004750889">
+    <testsuite name="tests/integration.test.ts" timestamp="2026-01-18T18:46:49.751Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.00844636">
+        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for duplicate tasks" time="0.005026025">
         </testcase>
-        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for missing dependencies" time="0.000500514">
+        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for missing dependencies" time="0.000516415">
         </testcase>
-        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for cycles" time="0.0004287">
+        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for cycles" time="0.000436023">
         </testcase>
     </testsuite>
-    <testsuite name="tests/integration-tests/basic-structure.test.ts" timestamp="2026-01-18T18:12:39.234Z" hostname="runnervmmtnos" tests="4" failures="0" errors="0" skipped="0" time="0.130392981">
-        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 1: Basic linear workflow (A -&gt; B -&gt; C)" time="0.034111162">
+    <testsuite name="tests/integration-tests/basic-structure.test.ts" timestamp="2026-01-18T18:46:49.752Z" hostname="runnervmmtnos" tests="4" failures="0" errors="0" skipped="0" time="0.133158349">
+        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 1: Basic linear workflow (A -&gt; B -&gt; C)" time="0.034998377">
         </testcase>
-        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 2: Branching workflow (A -&gt; [B, C] -&gt; D)" time="0.032066264">
+        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 2: Branching workflow (A -&gt; [B, C] -&gt; D)" time="0.032839183">
         </testcase>
-        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 12: Complex &apos;Diamond&apos; dependency graph (A -&gt; B -&gt; D, A -&gt; C -&gt; D)" time="0.041142991">
+        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 12: Complex &apos;Diamond&apos; dependency graph (A -&gt; B -&gt; D, A -&gt; C -&gt; D)" time="0.041876117">
         </testcase>
-        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 14: Zero-dependency parallel burst" time="0.021032996">
+        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 14: Zero-dependency parallel burst" time="0.021234381">
         </testcase>
     </testsuite>
-    <testsuite name="tests/integration-tests/concurrency-timing.test.ts" timestamp="2026-01-18T18:12:39.235Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.127910787">
-        <testcase classname="tests/integration-tests/concurrency-timing.test.ts" name="Integration: Concurrency and Timing &gt; Scenario 6: Mixed duration tasks (verifying parallel efficiency)" time="0.053132093">
+    <testsuite name="tests/integration-tests/concurrency-timing.test.ts" timestamp="2026-01-18T18:46:49.753Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.126879172">
+        <testcase classname="tests/integration-tests/concurrency-timing.test.ts" name="Integration: Concurrency and Timing &gt; Scenario 6: Mixed duration tasks (verifying parallel efficiency)" time="0.052560329">
         </testcase>
-        <testcase classname="tests/integration-tests/concurrency-timing.test.ts" name="Integration: Concurrency and Timing &gt; Scenario 7: Cancellation via AbortSignal" time="0.021293783">
+        <testcase classname="tests/integration-tests/concurrency-timing.test.ts" name="Integration: Concurrency and Timing &gt; Scenario 7: Cancellation via AbortSignal" time="0.021351994">
         </testcase>
-        <testcase classname="tests/integration-tests/concurrency-timing.test.ts" name="Integration: Concurrency and Timing &gt; Scenario 8: Global timeout interrupting long tasks" time="0.051132028">
+        <testcase classname="tests/integration-tests/concurrency-timing.test.ts" name="Integration: Concurrency and Timing &gt; Scenario 8: Global timeout interrupting long tasks" time="0.050771636">
         </testcase>
     </testsuite>
-    <testsuite name="tests/integration-tests/context-state.test.ts" timestamp="2026-01-18T18:12:39.236Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.016984148">
-        <testcase classname="tests/integration-tests/context-state.test.ts" name="Integration: Context and State &gt; Scenario 4: Shared context mutation (A writes, B reads)" time="0.003976123">
+    <testsuite name="tests/integration-tests/context-state.test.ts" timestamp="2026-01-18T18:46:49.754Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.020473507">
+        <testcase classname="tests/integration-tests/context-state.test.ts" name="Integration: Context and State &gt; Scenario 4: Shared context mutation (A writes, B reads)" time="0.00578614">
         </testcase>
-        <testcase classname="tests/integration-tests/context-state.test.ts" name="Integration: Context and State &gt; Scenario 9: Dynamic context validation" time="0.000406148">
+        <testcase classname="tests/integration-tests/context-state.test.ts" name="Integration: Context and State &gt; Scenario 9: Dynamic context validation" time="0.000549928">
         </testcase>
-        <testcase classname="tests/integration-tests/context-state.test.ts" name="Integration: Context and State &gt; Scenario 13: Tasks with side-effects" time="0.010604287">
+        <testcase classname="tests/integration-tests/context-state.test.ts" name="Integration: Context and State &gt; Scenario 13: Tasks with side-effects" time="0.011724266">
         </testcase>
     </testsuite>
-    <testsuite name="tests/integration-tests/dryRun.test.ts" timestamp="2026-01-18T18:12:39.237Z" hostname="runnervmmtnos" tests="2" failures="0" errors="0" skipped="0" time="0.007107349">
-        <testcase classname="tests/integration-tests/dryRun.test.ts" name="Integration: Dry Run &gt; should execute successfully without side effects" time="0.00460069">
+    <testsuite name="tests/integration-tests/dryRun.test.ts" timestamp="2026-01-18T18:46:49.754Z" hostname="runnervmmtnos" tests="2" failures="0" errors="0" skipped="0" time="0.007644898">
+        <testcase classname="tests/integration-tests/dryRun.test.ts" name="Integration: Dry Run &gt; should execute successfully without side effects" time="0.005105605">
         </testcase>
-        <testcase classname="tests/integration-tests/dryRun.test.ts" name="Integration: Dry Run &gt; should respect dependencies (topological order is maintained even in dry run)" time="0.000409946">
+        <testcase classname="tests/integration-tests/dryRun.test.ts" name="Integration: Dry Run &gt; should respect dependencies (topological order is maintained even in dry run)" time="0.000382532">
         </testcase>
     </testsuite>
-    <testsuite name="tests/integration-tests/error-handling.test.ts" timestamp="2026-01-18T18:12:39.237Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.008123185">
-        <testcase classname="tests/integration-tests/error-handling.test.ts" name="Integration: Error Handling &gt; Scenario 3: Task failure and downstream skipping" time="0.003344604">
+    <testsuite name="tests/integration-tests/error-handling.test.ts" timestamp="2026-01-18T18:46:49.755Z" hostname="runnervmmtnos" tests="3" failures="0" errors="0" skipped="0" time="0.009582684">
+        <testcase classname="tests/integration-tests/error-handling.test.ts" name="Integration: Error Handling &gt; Scenario 3: Task failure and downstream skipping" time="0.004250201">
         </testcase>
-        <testcase classname="tests/integration-tests/error-handling.test.ts" name="Integration: Error Handling &gt; Scenario 10: Circular dependency detection" time="0.002707284">
+        <testcase classname="tests/integration-tests/error-handling.test.ts" name="Integration: Error Handling &gt; Scenario 10: Circular dependency detection" time="0.002542548">
         </testcase>
-        <testcase classname="tests/integration-tests/error-handling.test.ts" name="Integration: Error Handling &gt; Scenario 11: Missing dependency handling" time="0.000328242">
+        <testcase classname="tests/integration-tests/error-handling.test.ts" name="Integration: Error Handling &gt; Scenario 11: Missing dependency handling" time="0.000480727">
         </testcase>
     </testsuite>
-    <testsuite name="tests/integration-tests/stress.test.ts" timestamp="2026-01-18T18:12:39.238Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.006101942">
-        <testcase classname="tests/integration-tests/stress.test.ts" name="Integration: Stress Tests &gt; Scenario 5: Large graph execution (e.g., 20+ nodes)" time="0.004457772">
+    <testsuite name="tests/integration-tests/stress.test.ts" timestamp="2026-01-18T18:46:49.755Z" hostname="runnervmmtnos" tests="1" failures="0" errors="0" skipped="0" time="0.006965795">
+        <testcase classname="tests/integration-tests/stress.test.ts" name="Integration: Stress Tests &gt; Scenario 5: Large graph execution (e.g., 20+ nodes)" time="0.005155789">
+        </testcase>
+    </testsuite>
+    <testsuite name="tests/strategies/RetryingExecutionStrategy.test.ts" timestamp="2026-01-18T18:46:49.756Z" hostname="runnervmmtnos" tests="9" failures="0" errors="0" skipped="0" time="0.020475309">
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should execute successfully without retry if task succeeds" time="0.006518441">
+        </testcase>
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should execute successfully without retry if task has no retry config" time="0.000709159">
+        </testcase>
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should retry task if it fails and has retry config (fixed backoff)" time="0.002165526">
+        </testcase>
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should fail after max attempts reached" time="0.001107931">
+        </testcase>
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should use exponential backoff" time="0.001009275">
+        </testcase>
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should handle cancellation during delay" time="0.001831877">
+        </testcase>
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should handle cancellation before execution" time="0.000479575">
+        </testcase>
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should propagate error if sleep throws non-abort error" time="0.003430303">
+        </testcase>
+        <testcase classname="tests/strategies/RetryingExecutionStrategy.test.ts" name="RetryingExecutionStrategy &gt; should handle cancellation if signal is aborted right before sleep (covering fast-fail in sleep)" time="0.000709089">
         </testcase>
     </testsuite>
 </testsuites>

package/openspec/changes/add-workflow-preview/tasks.md

@@ -1,7 +0,0 @@
-## Implementation
-- [ ] 1.1 Update `TaskRunnerExecutionConfig` to include an optional `dryRun: boolean` property.
-- [ ] 1.2 Implement `dryRun` logic in `WorkflowExecutor` (traverse graph, validate order, skip `step.run()`, return `skipped` or `success` pseudo-status).
-- [ ] 1.3 Implement `getMermaidGraph(steps: TaskStep[])` method (can be static or instance method on `TaskRunner`).
-- [ ] 1.4 Ensure `dryRun` respects other configs like `concurrency` (if applicable) to simulate actual timing/order if possible, or just strict topological order.
-- [ ] 1.5 Add unit tests for `dryRun` ensuring no side effects occur.
-- [ ] 1.6 Add unit tests for `getMermaidGraph` output correctness (nodes and edges).