npm - @calmo/task-runner - Versions diffs - 2.0.0 → 3.1.0 - Mend

@calmo/task-runner 2.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (92) hide show

package/.jules/nexus.md +5 -0
package/AGENTS.md +49 -0
package/CHANGELOG.md +33 -0
package/README.md +1 -1
package/coverage/coverage-final.json +9 -4
package/coverage/index.html +24 -9
package/coverage/lcov-report/index.html +24 -9
package/coverage/lcov-report/src/EventBus.ts.html +8 -8
package/coverage/lcov-report/src/TaskGraphValidator.ts.html +53 -53
package/coverage/lcov-report/src/TaskRunner.ts.html +377 -20
package/coverage/lcov-report/src/TaskRunnerBuilder.ts.html +313 -0
package/coverage/lcov-report/src/TaskRunnerExecutionConfig.ts.html +139 -0
package/coverage/lcov-report/src/TaskStateManager.ts.html +511 -0
package/coverage/lcov-report/src/WorkflowExecutor.ts.html +119 -137
package/coverage/lcov-report/src/contracts/RunnerEvents.ts.html +1 -1
package/coverage/lcov-report/src/contracts/index.html +1 -1
package/coverage/lcov-report/src/index.html +56 -11
package/coverage/lcov-report/src/strategies/DryRunExecutionStrategy.ts.html +178 -0
package/coverage/lcov-report/src/strategies/StandardExecutionStrategy.ts.html +190 -0
package/coverage/lcov-report/src/strategies/index.html +131 -0
package/coverage/lcov.info +419 -204
package/coverage/src/EventBus.ts.html +8 -8
package/coverage/src/TaskGraphValidator.ts.html +53 -53
package/coverage/src/TaskRunner.ts.html +377 -20
package/coverage/src/TaskRunnerBuilder.ts.html +313 -0
package/coverage/src/TaskRunnerExecutionConfig.ts.html +139 -0
package/coverage/src/TaskStateManager.ts.html +511 -0
package/coverage/src/WorkflowExecutor.ts.html +119 -137
package/coverage/src/contracts/RunnerEvents.ts.html +1 -1
package/coverage/src/contracts/index.html +1 -1
package/coverage/src/index.html +56 -11
package/coverage/src/strategies/DryRunExecutionStrategy.ts.html +178 -0
package/coverage/src/strategies/StandardExecutionStrategy.ts.html +190 -0
package/coverage/src/strategies/index.html +131 -0
package/dist/TaskRunner.d.ts +24 -2
package/dist/TaskRunner.js +99 -3
package/dist/TaskRunner.js.map +1 -1
package/dist/TaskRunnerBuilder.d.ts +33 -0
package/dist/TaskRunnerBuilder.js +54 -0
package/dist/TaskRunnerBuilder.js.map +1 -0
package/dist/TaskRunnerExecutionConfig.d.ts +18 -0
package/dist/TaskRunnerExecutionConfig.js +2 -0
package/dist/TaskRunnerExecutionConfig.js.map +1 -0
package/dist/TaskStateManager.d.ts +54 -0
package/dist/TaskStateManager.js +130 -0
package/dist/TaskStateManager.js.map +1 -0
package/dist/TaskStatus.d.ts +1 -1
package/dist/TaskStep.d.ts +2 -1
package/dist/WorkflowExecutor.d.ts +11 -17
package/dist/WorkflowExecutor.js +67 -69
package/dist/WorkflowExecutor.js.map +1 -1
package/dist/index.d.ts +4 -0
package/dist/index.js +3 -0
package/dist/index.js.map +1 -1
package/dist/strategies/DryRunExecutionStrategy.d.ts +16 -0
package/dist/strategies/DryRunExecutionStrategy.js +25 -0
package/dist/strategies/DryRunExecutionStrategy.js.map +1 -0
package/dist/strategies/IExecutionStrategy.d.ts +16 -0
package/dist/strategies/IExecutionStrategy.js +2 -0
package/dist/strategies/IExecutionStrategy.js.map +1 -0
package/dist/strategies/StandardExecutionStrategy.d.ts +9 -0
package/dist/strategies/StandardExecutionStrategy.js +25 -0
package/dist/strategies/StandardExecutionStrategy.js.map +1 -0
package/openspec/changes/add-concurrency-control/proposal.md +14 -0
package/openspec/changes/add-concurrency-control/tasks.md +9 -0
package/openspec/changes/add-task-retry-policy/proposal.md +16 -0
package/openspec/changes/add-task-retry-policy/tasks.md +10 -0
package/openspec/changes/add-workflow-preview/proposal.md +13 -0
package/openspec/changes/add-workflow-preview/tasks.md +7 -0
package/openspec/changes/archive/2026-01-18-add-external-task-cancellation/tasks.md +10 -0
package/openspec/changes/archive/2026-01-18-add-integration-tests/proposal.md +18 -0
package/openspec/changes/archive/2026-01-18-add-integration-tests/tasks.md +17 -0
package/openspec/changes/archive/2026-01-18-refactor-core-architecture/proposal.md +14 -0
package/openspec/changes/archive/2026-01-18-refactor-core-architecture/tasks.md +8 -0
package/openspec/changes/feat-per-task-timeout/proposal.md +25 -0
package/openspec/changes/feat-per-task-timeout/tasks.md +27 -0
package/package.json +1 -1
package/src/TaskRunner.ts +123 -4
package/src/TaskRunnerBuilder.ts +76 -0
package/src/TaskRunnerExecutionConfig.ts +18 -0
package/src/TaskStateManager.ts +142 -0
package/src/TaskStatus.ts +1 -1
package/src/TaskStep.ts +2 -1
package/src/WorkflowExecutor.ts +77 -83
package/src/index.ts +4 -0
package/src/strategies/DryRunExecutionStrategy.ts +31 -0
package/src/strategies/IExecutionStrategy.ts +21 -0
package/src/strategies/StandardExecutionStrategy.ts +35 -0
package/test-report.xml +139 -45
package/GEMINI.md +0 -48
package/openspec/changes/add-external-task-cancellation/tasks.md +0 -10
/package/openspec/changes/{add-external-task-cancellation → archive/2026-01-18-add-external-task-cancellation}/proposal.md +0 -0

package/coverage/src/strategies/DryRunExecutionStrategy.ts.html ADDED Viewed

@@ -0,0 +1,178 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/strategies/DryRunExecutionStrategy.ts</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../../prettify.css" />
+    <link rel="stylesheet" href="../../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../../index.html">All files</a> / <a href="index.html">src/strategies</a> DryRunExecutionStrategy.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>1/1</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/0</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>1/1</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>1/1</span>
+            </div>
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a>
+<a name='L19'></a><a href='#L19'>19</a>
+<a name='L20'></a><a href='#L20'>20</a>
+<a name='L21'></a><a href='#L21'>21</a>
+<a name='L22'></a><a href='#L22'>22</a>
+<a name='L23'></a><a href='#L23'>23</a>
+<a name='L24'></a><a href='#L24'>24</a>
+<a name='L25'></a><a href='#L25'>25</a>
+<a name='L26'></a><a href='#L26'>26</a>
+<a name='L27'></a><a href='#L27'>27</a>
+<a name='L28'></a><a href='#L28'>28</a>
+<a name='L29'></a><a href='#L29'>29</a>
+<a name='L30'></a><a href='#L30'>30</a>
+<a name='L31'></a><a href='#L31'>31</a>
+<a name='L32'></a><a href='#L32'>32</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { IExecutionStrategy } from "./IExecutionStrategy.js";
+import { TaskStep } from "../TaskStep.js";
+import { TaskResult } from "../TaskResult.js";
+&nbsp;
+/**
+ * Execution strategy that simulates task execution without running the actual logic.
+ */
+export class DryRunExecutionStrategy&lt;TContext&gt;
+  implements IExecutionStrategy&lt;TContext&gt;
+{
+  /**
+   * Simulates execution by returning a success result immediately.
+   * @param step The task step (ignored).
+   * @param context The shared context (ignored).
+   * @param signal Optional abort signal (ignored).
+   * @returns A promise resolving to a success result.
+   */
+  async execute(
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _step: TaskStep&lt;TContext&gt;,
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _context: TContext,
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _signal?: AbortSignal
+  ): Promise&lt;TaskResult&gt; {
+    return Promise.resolve({
+      status: "success",
+      message: "Dry run: simulated success",
+    });
+  }
+}
+&nbsp;</pre></td></tr></table></pre>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-01-18T18:12:39.248Z
+            </div>
+        <script src="../../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../../sorter.js"></script>
+        <script src="../../block-navigation.js"></script>
+    </body>
+</html>

package/coverage/src/strategies/StandardExecutionStrategy.ts.html ADDED Viewed

@@ -0,0 +1,190 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/strategies/StandardExecutionStrategy.ts</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../../prettify.css" />
+    <link rel="stylesheet" href="../../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../../index.html">All files</a> / <a href="index.html">src/strategies</a> StandardExecutionStrategy.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>5/5</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>8/8</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>1/1</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>5/5</span>
+            </div>
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a>
+<a name='L19'></a><a href='#L19'>19</a>
+<a name='L20'></a><a href='#L20'>20</a>
+<a name='L21'></a><a href='#L21'>21</a>
+<a name='L22'></a><a href='#L22'>22</a>
+<a name='L23'></a><a href='#L23'>23</a>
+<a name='L24'></a><a href='#L24'>24</a>
+<a name='L25'></a><a href='#L25'>25</a>
+<a name='L26'></a><a href='#L26'>26</a>
+<a name='L27'></a><a href='#L27'>27</a>
+<a name='L28'></a><a href='#L28'>28</a>
+<a name='L29'></a><a href='#L29'>29</a>
+<a name='L30'></a><a href='#L30'>30</a>
+<a name='L31'></a><a href='#L31'>31</a>
+<a name='L32'></a><a href='#L32'>32</a>
+<a name='L33'></a><a href='#L33'>33</a>
+<a name='L34'></a><a href='#L34'>34</a>
+<a name='L35'></a><a href='#L35'>35</a>
+<a name='L36'></a><a href='#L36'>36</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">101x</span>
+<span class="cline-any cline-yes">101x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { IExecutionStrategy } from "./IExecutionStrategy.js";
+import { TaskStep } from "../TaskStep.js";
+import { TaskResult } from "../TaskResult.js";
+&nbsp;
+/**
+ * Standard execution strategy that runs the task's run method.
+ */
+export class StandardExecutionStrategy&lt;TContext&gt;
+  implements IExecutionStrategy&lt;TContext&gt;
+{
+  async execute(
+    step: TaskStep&lt;TContext&gt;,
+    context: TContext,
+    signal?: AbortSignal
+  ): Promise&lt;TaskResult&gt; {
+    try {
+      return await step.run(context, signal);
+    } catch (e) {
+      // Check if error is due to abort
+      if (
+        signal?.aborted &amp;&amp;
+        (e instanceof Error &amp;&amp; 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),
+      };
+    }
+  }
+}
+&nbsp;</pre></td></tr></table></pre>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-01-18T18:12:39.248Z
+            </div>
+        <script src="../../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../../sorter.js"></script>
+        <script src="../../block-navigation.js"></script>
+    </body>
+</html>

package/coverage/src/strategies/index.html ADDED Viewed

@@ -0,0 +1,131 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/strategies</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../../prettify.css" />
+    <link rel="stylesheet" href="../../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../../index.html">All files</a> src/strategies</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>6/6</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>8/8</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>2/2</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>6/6</span>
+            </div>
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <div class="pad1">
+<table class="coverage-summary">
+<thead>
+<tr>
+   <th data-col="file" data-fmt="html" data-html="true" class="file">File</th>
+   <th data-col="pic" data-type="number" data-fmt="html" data-html="true" class="pic"></th>
+   <th data-col="statements" data-type="number" data-fmt="pct" class="pct">Statements</th>
+   <th data-col="statements_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="branches" data-type="number" data-fmt="pct" class="pct">Branches</th>
+   <th data-col="branches_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="functions" data-type="number" data-fmt="pct" class="pct">Functions</th>
+   <th data-col="functions_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="lines" data-type="number" data-fmt="pct" class="pct">Lines</th>
+   <th data-col="lines_raw" data-type="number" data-fmt="html" class="abs"></th>
+</tr>
+</thead>
+<tbody><tr>
+	<td class="file high" data-value="DryRunExecutionStrategy.ts"><a href="DryRunExecutionStrategy.ts.html">DryRunExecutionStrategy.ts</a></td>
+	<td data-value="100" class="pic high">
+	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
+	</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="1" class="abs high">1/1</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="0" class="abs high">0/0</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="1" class="abs high">1/1</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="1" class="abs high">1/1</td>
+	</tr>
+<tr>
+	<td class="file high" data-value="StandardExecutionStrategy.ts"><a href="StandardExecutionStrategy.ts.html">StandardExecutionStrategy.ts</a></td>
+	<td data-value="100" class="pic high">
+	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
+	</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="5" class="abs high">5/5</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="8" class="abs high">8/8</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="1" class="abs high">1/1</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="5" class="abs high">5/5</td>
+	</tr>
+</tbody>
+</table>
+</div>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-01-18T18:12:39.248Z
+            </div>
+        <script src="../../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../../sorter.js"></script>
+        <script src="../../block-navigation.js"></script>
+    </body>
+</html>

package/dist/TaskRunner.d.ts CHANGED Viewed

@@ -1,7 +1,9 @@
 import { TaskStep } from "./TaskStep.js";
 import { TaskResult } from "./TaskResult.js";
 import { RunnerEventPayloads, RunnerEventListener } from "./contracts/RunnerEvents.js";
-export { RunnerEventPayloads, RunnerEventListener };
+import { TaskRunnerExecutionConfig } from "./TaskRunnerExecutionConfig.js";
+import { IExecutionStrategy } from "./strategies/IExecutionStrategy.js";
+export { RunnerEventPayloads, RunnerEventListener, TaskRunnerExecutionConfig };
 /**
  * The main class that orchestrates the execution of a list of tasks
  * based on their dependencies, with support for parallel execution.
@@ -11,6 +13,7 @@ export declare class TaskRunner<TContext> {
     private context;
     private eventBus;
     private validator;
+    private executionStrategy;
     /**
      * @param context The shared context object to be passed to each task.
      */
@@ -27,12 +30,31 @@ export declare class TaskRunner<TContext> {
      * @param callback The callback to remove.
      */
     off<K extends keyof RunnerEventPayloads<TContext>>(event: K, callback: RunnerEventListener<TContext, K>): void;
+    /**
+     * Sets the execution strategy to be used.
+     * @param strategy The execution strategy.
+     * @returns The TaskRunner instance for chaining.
+     */
+    setExecutionStrategy(strategy: IExecutionStrategy<TContext>): this;
+    /**
+     * Generates a Mermaid.js graph representation of the task workflow.
+     * @param steps The list of tasks to visualize.
+     * @returns A string containing the Mermaid graph definition.
+     */
+    static getMermaidGraph<T>(steps: TaskStep<T>[]): string;
+    /**
+     * Sanitizes a string for use as a Mermaid node ID.
+     * @param id The string to sanitize.
+     * @returns The sanitized string.
+     */
+    private static sanitizeMermaidId;
     /**
      * Executes a list of tasks, respecting their dependencies and running
      * independent tasks in parallel.
      * @param steps An array of TaskStep objects to be executed.
+     * @param config Optional configuration for execution (timeout, cancellation).
      * @returns A Promise that resolves to a Map where keys are task names
      * and values are the corresponding TaskResult objects.
      */
-    execute(steps: TaskStep<TContext>[]): Promise<Map<string, TaskResult>>;
+    execute(steps: TaskStep<TContext>[], config?: TaskRunnerExecutionConfig): Promise<Map<string, TaskResult>>;
 }