@calmo/task-runner 2.0.0 → 3.1.0

package/src/strategies/IExecutionStrategy.ts

@@ -0,0 +1,21 @@
+import { TaskStep } from "../TaskStep.js";
+import { TaskResult } from "../TaskResult.js";
+
+/**
+ * Interface for task execution strategies.
+ * Allows different execution behaviors (e.g., standard, dry-run, debugging).
+ */
+export interface IExecutionStrategy<TContext> {
+  /**
+   * Executes a single task step.
+   * @param step The task step to execute.
+   * @param context The shared context.
+   * @param signal Optional abort signal.
+   * @returns A promise resolving to the task result.
+   */
+  execute(
+    step: TaskStep<TContext>,
+    context: TContext,
+    signal?: AbortSignal
+  ): Promise<TaskResult>;
+}

package/src/strategies/StandardExecutionStrategy.ts

@@ -0,0 +1,35 @@
+import { IExecutionStrategy } from "./IExecutionStrategy.js";
+import { TaskStep } from "../TaskStep.js";
+import { TaskResult } from "../TaskResult.js";
+
+/**
+ * Standard execution strategy that runs the task's run method.
+ */
+export class StandardExecutionStrategy<TContext>
+  implements IExecutionStrategy<TContext>
+{
+  async execute(
+    step: TaskStep<TContext>,
+    context: TContext,
+    signal?: AbortSignal
+  ): Promise<TaskResult> {
+    try {
+      return await step.run(context, signal);
+    } catch (e) {
+      // Check if error is due to abort
+      if (
+        signal?.aborted &&
+        (e instanceof Error && e.name === "AbortError" || signal.reason === e)
+      ) {
+        return {
+          status: "cancelled",
+          message: "Task cancelled during execution",
+        };
+      }
+      return {
+        status: "failure",
+        error: e instanceof Error ? e.message : String(e),
+      };
+    }
+  }
+}

package/test-report.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-<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">
+<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">
             <system-out>
 Running StepA
 Running StepB
@@ -15,89 +15,183 @@ 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.001176806">
+        <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>
     </testsuite>
-    <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">
+    <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">
         </testcase>
     </testsuite>
-    <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">
+    <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">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid result for empty graph" time="0.001258177">
+    </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">
+        </testcase>
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid result for empty graph" time="0.001737874">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect duplicate tasks" time="0.001873847">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect duplicate tasks" time="0.002036873">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect missing dependencies" time="0.000404865">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect missing dependencies" time="0.000562039">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect cycles" time="0.000448717">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect cycles" time="0.000863322">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid for a correct graph" time="0.000404856">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should return valid for a correct graph" time="0.000538966">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should not detect cycles if missing dependencies are present" time="0.000360703">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should not detect cycles if missing dependencies are present" time="0.000377365">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect more complex cycles" time="0.000276827">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should detect more complex cycles" time="0.000308877">
         </testcase>
-        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should handle cycle detection with no cycles but shared dependencies" time="0.000241571">
+        <testcase classname="tests/TaskGraphValidator.test.ts" name="TaskGraphValidator &gt; should handle cycle detection with no cycles but shared dependencies" time="0.00036466">
         </testcase>
     </testsuite>
-    <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">
+    <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">
         </testcase>
     </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">
+    <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">
+        </testcase>
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle an empty list of tasks gracefully" time="0.000536321">
+        </testcase>
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run independent tasks in parallel" time="0.100527713">
+        </testcase>
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip dependent tasks if a root task fails" time="0.000423">
+        </testcase>
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;circular dependency&apos;" time="0.001873287">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle an empty list of tasks gracefully" time="0.000635346">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;missing dependency&apos;" time="0.00040734">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should run independent tasks in parallel" time="0.100728925">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw an error during execution" time="0.000383796">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip dependent tasks if a root task fails" time="0.000416347">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip tasks whose dependencies are skipped" time="0.000511766">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;circular dependency&apos;" time="0.002357119">
+        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw a non-Error object during execution" time="0.000416708">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should throw an error for &apos;missing dependency&apos;" time="0.000314708">
+        <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>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw an error during execution" time="0.000313525">
+    </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">
+        </testcase>
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire taskSkipped event when dependency fails" time="0.00515295">
+        </testcase>
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should not crash if a listener throws an error" time="0.001447632">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should skip tasks whose dependencies are skipped" time="0.00036969">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire workflow events even for empty step list" time="0.000565135">
         </testcase>
-        <testcase classname="tests/TaskRunner.test.ts" name="TaskRunner &gt; should handle tasks that throw a non-Error object during execution" time="0.000305942">
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should handle unsubscribe correctly" time="0.000747466">
         </testcase>
-        <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 classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should safely handle off() when no listeners exist" time="0.000408022">
+        </testcase>
+        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should support multiple listeners for the same event" time="0.00061583">
         </testcase>
     </testsuite>
-    <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">
+    <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">
+        </testcase>
+        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should generate a graph with dependencies" time="0.000646657">
+        </testcase>
+        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should handle mixed independent and dependent tasks" time="0.000325818">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire taskSkipped event when dependency fails" time="0.005329486">
+        <testcase classname="tests/TaskRunnerMermaid.test.ts" name="TaskRunner Mermaid Graph &gt; should handle special characters in task names" time="0.000442687">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should not crash if a listener throws an error" time="0.001806131">
+    </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">
+        </testcase>
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; should allow unsubscribing from events" time="0.000975977">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should fire workflow events even for empty step list" time="0.000492118">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskStateManager.cancelAllPending should handle non-existing tasks gracefully" time="0.000457464">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should handle unsubscribe correctly" time="0.000713071">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskRunnerBuilder should build a TaskRunner" time="0.000437858">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should safely handle off() when no listeners exist" time="0.00075527">
+        <testcase classname="tests/TaskRunnerRefactor.test.ts" name="TaskRunner Refactor Coverage &gt; TaskRunnerBuilder should build a TaskRunner with no listeners" time="0.000220612">
         </testcase>
-        <testcase classname="tests/TaskRunnerEvents.test.ts" name="TaskRunner Events &gt; should support multiple listeners for the same event" time="0.000722328">
+        <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>
     </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">
+    <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">
         </testcase>
-        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should skip dependent steps if dependency fails" time="0.000424162">
+        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should skip dependent steps if dependency fails" time="0.000479806">
         </testcase>
-        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should run independent steps in parallel" time="0.051090362">
+        <testcase classname="tests/WorkflowExecutor.test.ts" name="WorkflowExecutor &gt; should run independent steps in parallel" time="0.050936934">
         </testcase>
     </testsuite>
-    <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">
+    <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">
+        </testcase>
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via AbortSignal" time="0.011234474">
+        </testcase>
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via global timeout" time="0.049697551">
+        </testcase>
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should handle pre-aborted signal" time="0.000409645">
+        </testcase>
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should propagate cancellation to running task" time="0.010620648">
         </testcase>
-        <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 classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should respect timeout over signal if timeout happens first" time="0.050354487">
+        </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>
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel workflow via AbortSignal when timeout is also set" time="0.010740512">
+        </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>
+        <testcase classname="tests/cancellation.test.ts" name="TaskRunner Cancellation &gt; should cancel task if it rejects with signal.reason" time="0.010617862">
+        </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">
         </testcase>
-        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for cycles" time="0.000504291">
+        <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>
+        <testcase classname="tests/integration.test.ts" name="TaskRunner Validation Integration &gt; should throw validation error with clear message for cycles" time="0.0004287">
+        </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">
+        </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>
+        <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>
+        <testcase classname="tests/integration-tests/basic-structure.test.ts" name="Integration: Basic Structure &gt; Scenario 14: Zero-dependency parallel burst" time="0.021032996">
+        </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">
+        </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>
+        <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>
+    </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">
+        </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>
+        <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>
+    </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">
+        </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>
+    </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">
+        </testcase>
+        <testcase classname="tests/integration-tests/error-handling.test.ts" name="Integration: Error Handling &gt; Scenario 10: Circular dependency detection" time="0.002707284">
+        </testcase>
+        <testcase classname="tests/integration-tests/error-handling.test.ts" name="Integration: Error Handling &gt; Scenario 11: Missing dependency handling" time="0.000328242">
+        </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">
         </testcase>
     </testsuite>
 </testsuites>

package/GEMINI.md

@@ -1,48 +0,0 @@
-# task-runner Development Guidelines
-
-Auto-generated from all feature plans. Last updated: 2026-01-17
-
-## Active Technologies
-- TypeScript 5.9.3 + vitest 4.0.17 (for testing) (004-pre-execution-validation)
-- TypeScript 5.9.3 + vitest 4.0.17, AbortSignal/AbortController (standard Web APIs) (002-task-cancellation)
-- N/A (in-memory context object) (002-task-cancellation)
-- N/A (in-memory queue for tasks) (005-concurrency-control)
-
-- TypeScript 5.9.3 + vitest 4.0.17 (003-refactor-file-structure)
-
-- (001-generic-task-runner)
-
-## Project Structure
-
-```text
-src/
-tests/
-```
-
-## Commands
-
-# Add commands for
-
-## Code Style
-
-: Follow standard conventions
-
-## Recent Changes
-- 005-concurrency-control: Added TypeScript 5.9.3 + vitest 4.0.17
-- 002-task-cancellation: Added TypeScript 5.9.3 + vitest 4.0.17, AbortSignal/AbortController (standard Web APIs)
-- 004-pre-execution-validation: Added TypeScript 5.9.3 + vitest 4.0.17 (for testing)
-
-
-
-<!-- MANUAL ADDITIONS START -->
-- Never edit CHANGELOG.md manually. This file is for semantic release and is filled automatically.
-
-Before marking a task as concluded, YOU MUST:
-
-1. run pnpm install
-2. run pnpm build
-3. run pnpm test
-4. run pnpm lint
-
-If any of those command fail, review your changes.
-<!-- MANUAL ADDITIONS END -->

package/openspec/changes/add-external-task-cancellation/tasks.md

@@ -1,10 +0,0 @@
-## Implementation
-- [ ] 1.1 Update `TaskRunner.execute` signature to accept an optional config object.
-- [ ] 1.2 Implement logic within `TaskRunner` to listen for `AbortSignal` and initiate cancellation.
-- [ ] 1.3 Implement global timeout mechanism using `AbortController` and `setTimeout`.
-- [ ] 1.4 Propagate `AbortSignal` to individual `TaskStep` executions.
-- [ ] 1.5 Ensure `TaskRunner` correctly handles tasks that are already aborted before execution.
-- [ ] 1.6 Update `TaskResult` and `RunnerEvents` to reflect cancellation status.
-- [ ] 1.7 Add unit tests for `AbortSignal` cancellation scenarios.
-- [ ] 1.8 Add unit tests for global timeout scenarios.
-- [ ] 1.9 Add integration tests covering both `AbortSignal` and timeout interactions.