@calmo/task-runner 1.2.1 → 1.2.3

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 (54) hide show
  1. package/.gemini/commands/openspec/apply.toml +21 -0
  2. package/.gemini/commands/openspec/archive.toml +25 -0
  3. package/.gemini/commands/openspec/proposal.toml +26 -0
  4. package/AGENTS.md +18 -0
  5. package/CHANGELOG.md +23 -0
  6. package/GEMINI.md +8 -0
  7. package/coverage/coverage-final.json +5 -2
  8. package/coverage/index.html +20 -20
  9. package/coverage/lcov-report/index.html +20 -20
  10. package/coverage/lcov-report/src/EventBus.ts.html +337 -0
  11. package/coverage/{TaskGraphValidator.ts.html → lcov-report/src/TaskGraphValidator.ts.html} +44 -14
  12. package/coverage/lcov-report/src/TaskRunner.ts.html +307 -0
  13. package/coverage/lcov-report/src/WorkflowExecutor.ts.html +457 -0
  14. package/coverage/lcov-report/src/contracts/RunnerEvents.ts.html +217 -0
  15. package/coverage/lcov-report/src/contracts/index.html +116 -0
  16. package/coverage/lcov-report/src/index.html +161 -0
  17. package/coverage/lcov.info +190 -165
  18. package/coverage/src/EventBus.ts.html +337 -0
  19. package/coverage/{lcov-report → src}/TaskGraphValidator.ts.html +44 -14
  20. package/coverage/src/TaskRunner.ts.html +307 -0
  21. package/coverage/src/WorkflowExecutor.ts.html +457 -0
  22. package/coverage/src/contracts/RunnerEvents.ts.html +217 -0
  23. package/coverage/src/contracts/index.html +116 -0
  24. package/coverage/src/index.html +161 -0
  25. package/dist/EventBus.d.ts +26 -0
  26. package/dist/EventBus.js +56 -0
  27. package/dist/EventBus.js.map +1 -0
  28. package/dist/TaskGraphValidator.d.ts +6 -0
  29. package/dist/TaskGraphValidator.js +9 -0
  30. package/dist/TaskGraphValidator.js.map +1 -1
  31. package/dist/TaskRunner.d.ts +3 -36
  32. package/dist/TaskRunner.js +8 -127
  33. package/dist/TaskRunner.js.map +1 -1
  34. package/dist/WorkflowExecutor.d.ts +32 -0
  35. package/dist/WorkflowExecutor.js +109 -0
  36. package/dist/WorkflowExecutor.js.map +1 -0
  37. package/dist/contracts/ITaskGraphValidator.d.ts +6 -0
  38. package/dist/contracts/RunnerEvents.d.ts +36 -0
  39. package/dist/contracts/RunnerEvents.js +2 -0
  40. package/dist/contracts/RunnerEvents.js.map +1 -0
  41. package/openspec/AGENTS.md +456 -0
  42. package/openspec/changes/add-external-task-cancellation/proposal.md +14 -0
  43. package/openspec/changes/add-external-task-cancellation/tasks.md +10 -0
  44. package/openspec/project.md +31 -0
  45. package/package.json +1 -1
  46. package/src/EventBus.ts +84 -0
  47. package/src/TaskGraphValidator.ts +10 -0
  48. package/src/TaskRunner.ts +11 -196
  49. package/src/WorkflowExecutor.ts +124 -0
  50. package/src/contracts/ITaskGraphValidator.ts +7 -0
  51. package/src/contracts/RunnerEvents.ts +44 -0
  52. package/test-report.xml +49 -37
  53. package/coverage/TaskRunner.ts.html +0 -862
  54. package/coverage/lcov-report/TaskRunner.ts.html +0 -862
package/coverage/src/TaskRunner.ts.html ADDED
@@ -0,0 +1,307 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for src/TaskRunner.ts</title>
7
+ <meta charset="utf-8" />
8
+ <link rel="stylesheet" href="../prettify.css" />
9
+ <link rel="stylesheet" href="../base.css" />
10
+ <link rel="shortcut icon" type="image/x-icon" href="../favicon.png" />
11
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
12
+ <style type='text/css'>
13
+ .coverage-summary .sorter {
14
+ background-image: url(../sort-arrow-sprite.png);
15
+ }
16
+ </style>
17
+ </head>
18
+
19
+ <body>
20
+ <div class='wrapper'>
21
+ <div class='pad1'>
22
+ <h1><a href="../index.html">All files</a> / <a href="index.html">src</a> TaskRunner.ts</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">100% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>12/12</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">100% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>4/4</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">100% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>5/5</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">100% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>12/12</span>
50
+ </div>
51
+
52
+
53
+ </div>
54
+ <p class="quiet">
55
+ 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.
56
+ </p>
57
+ <template id="filterTemplate">
58
+ <div class="quiet">
59
+ Filter:
60
+ <input type="search" id="fileSearch">
61
+ </div>
62
+ </template>
63
+ </div>
64
+ <div class='status-line high'></div>
65
+ <pre><table class="coverage">
66
+ <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
67
+ <a name='L2'></a><a href='#L2'>2</a>
68
+ <a name='L3'></a><a href='#L3'>3</a>
69
+ <a name='L4'></a><a href='#L4'>4</a>
70
+ <a name='L5'></a><a href='#L5'>5</a>
71
+ <a name='L6'></a><a href='#L6'>6</a>
72
+ <a name='L7'></a><a href='#L7'>7</a>
73
+ <a name='L8'></a><a href='#L8'>8</a>
74
+ <a name='L9'></a><a href='#L9'>9</a>
75
+ <a name='L10'></a><a href='#L10'>10</a>
76
+ <a name='L11'></a><a href='#L11'>11</a>
77
+ <a name='L12'></a><a href='#L12'>12</a>
78
+ <a name='L13'></a><a href='#L13'>13</a>
79
+ <a name='L14'></a><a href='#L14'>14</a>
80
+ <a name='L15'></a><a href='#L15'>15</a>
81
+ <a name='L16'></a><a href='#L16'>16</a>
82
+ <a name='L17'></a><a href='#L17'>17</a>
83
+ <a name='L18'></a><a href='#L18'>18</a>
84
+ <a name='L19'></a><a href='#L19'>19</a>
85
+ <a name='L20'></a><a href='#L20'>20</a>
86
+ <a name='L21'></a><a href='#L21'>21</a>
87
+ <a name='L22'></a><a href='#L22'>22</a>
88
+ <a name='L23'></a><a href='#L23'>23</a>
89
+ <a name='L24'></a><a href='#L24'>24</a>
90
+ <a name='L25'></a><a href='#L25'>25</a>
91
+ <a name='L26'></a><a href='#L26'>26</a>
92
+ <a name='L27'></a><a href='#L27'>27</a>
93
+ <a name='L28'></a><a href='#L28'>28</a>
94
+ <a name='L29'></a><a href='#L29'>29</a>
95
+ <a name='L30'></a><a href='#L30'>30</a>
96
+ <a name='L31'></a><a href='#L31'>31</a>
97
+ <a name='L32'></a><a href='#L32'>32</a>
98
+ <a name='L33'></a><a href='#L33'>33</a>
99
+ <a name='L34'></a><a href='#L34'>34</a>
100
+ <a name='L35'></a><a href='#L35'>35</a>
101
+ <a name='L36'></a><a href='#L36'>36</a>
102
+ <a name='L37'></a><a href='#L37'>37</a>
103
+ <a name='L38'></a><a href='#L38'>38</a>
104
+ <a name='L39'></a><a href='#L39'>39</a>
105
+ <a name='L40'></a><a href='#L40'>40</a>
106
+ <a name='L41'></a><a href='#L41'>41</a>
107
+ <a name='L42'></a><a href='#L42'>42</a>
108
+ <a name='L43'></a><a href='#L43'>43</a>
109
+ <a name='L44'></a><a href='#L44'>44</a>
110
+ <a name='L45'></a><a href='#L45'>45</a>
111
+ <a name='L46'></a><a href='#L46'>46</a>
112
+ <a name='L47'></a><a href='#L47'>47</a>
113
+ <a name='L48'></a><a href='#L48'>48</a>
114
+ <a name='L49'></a><a href='#L49'>49</a>
115
+ <a name='L50'></a><a href='#L50'>50</a>
116
+ <a name='L51'></a><a href='#L51'>51</a>
117
+ <a name='L52'></a><a href='#L52'>52</a>
118
+ <a name='L53'></a><a href='#L53'>53</a>
119
+ <a name='L54'></a><a href='#L54'>54</a>
120
+ <a name='L55'></a><a href='#L55'>55</a>
121
+ <a name='L56'></a><a href='#L56'>56</a>
122
+ <a name='L57'></a><a href='#L57'>57</a>
123
+ <a name='L58'></a><a href='#L58'>58</a>
124
+ <a name='L59'></a><a href='#L59'>59</a>
125
+ <a name='L60'></a><a href='#L60'>60</a>
126
+ <a name='L61'></a><a href='#L61'>61</a>
127
+ <a name='L62'></a><a href='#L62'>62</a>
128
+ <a name='L63'></a><a href='#L63'>63</a>
129
+ <a name='L64'></a><a href='#L64'>64</a>
130
+ <a name='L65'></a><a href='#L65'>65</a>
131
+ <a name='L66'></a><a href='#L66'>66</a>
132
+ <a name='L67'></a><a href='#L67'>67</a>
133
+ <a name='L68'></a><a href='#L68'>68</a>
134
+ <a name='L69'></a><a href='#L69'>69</a>
135
+ <a name='L70'></a><a href='#L70'>70</a>
136
+ <a name='L71'></a><a href='#L71'>71</a>
137
+ <a name='L72'></a><a href='#L72'>72</a>
138
+ <a name='L73'></a><a href='#L73'>73</a>
139
+ <a name='L74'></a><a href='#L74'>74</a>
140
+ <a name='L75'></a><a href='#L75'>75</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
141
+ <span class="cline-any cline-neutral">&nbsp;</span>
142
+ <span class="cline-any cline-neutral">&nbsp;</span>
143
+ <span class="cline-any cline-neutral">&nbsp;</span>
144
+ <span class="cline-any cline-neutral">&nbsp;</span>
145
+ <span class="cline-any cline-neutral">&nbsp;</span>
146
+ <span class="cline-any cline-neutral">&nbsp;</span>
147
+ <span class="cline-any cline-neutral">&nbsp;</span>
148
+ <span class="cline-any cline-neutral">&nbsp;</span>
149
+ <span class="cline-any cline-neutral">&nbsp;</span>
150
+ <span class="cline-any cline-neutral">&nbsp;</span>
151
+ <span class="cline-any cline-neutral">&nbsp;</span>
152
+ <span class="cline-any cline-neutral">&nbsp;</span>
153
+ <span class="cline-any cline-neutral">&nbsp;</span>
154
+ <span class="cline-any cline-neutral">&nbsp;</span>
155
+ <span class="cline-any cline-neutral">&nbsp;</span>
156
+ <span class="cline-any cline-neutral">&nbsp;</span>
157
+ <span class="cline-any cline-yes">22x</span>
158
+ <span class="cline-any cline-yes">22x</span>
159
+ <span class="cline-any cline-neutral">&nbsp;</span>
160
+ <span class="cline-any cline-neutral">&nbsp;</span>
161
+ <span class="cline-any cline-neutral">&nbsp;</span>
162
+ <span class="cline-any cline-neutral">&nbsp;</span>
163
+ <span class="cline-any cline-yes">22x</span>
164
+ <span class="cline-any cline-neutral">&nbsp;</span>
165
+ <span class="cline-any cline-neutral">&nbsp;</span>
166
+ <span class="cline-any cline-neutral">&nbsp;</span>
167
+ <span class="cline-any cline-neutral">&nbsp;</span>
168
+ <span class="cline-any cline-neutral">&nbsp;</span>
169
+ <span class="cline-any cline-neutral">&nbsp;</span>
170
+ <span class="cline-any cline-neutral">&nbsp;</span>
171
+ <span class="cline-any cline-neutral">&nbsp;</span>
172
+ <span class="cline-any cline-neutral">&nbsp;</span>
173
+ <span class="cline-any cline-neutral">&nbsp;</span>
174
+ <span class="cline-any cline-yes">12x</span>
175
+ <span class="cline-any cline-neutral">&nbsp;</span>
176
+ <span class="cline-any cline-neutral">&nbsp;</span>
177
+ <span class="cline-any cline-neutral">&nbsp;</span>
178
+ <span class="cline-any cline-neutral">&nbsp;</span>
179
+ <span class="cline-any cline-neutral">&nbsp;</span>
180
+ <span class="cline-any cline-neutral">&nbsp;</span>
181
+ <span class="cline-any cline-neutral">&nbsp;</span>
182
+ <span class="cline-any cline-neutral">&nbsp;</span>
183
+ <span class="cline-any cline-neutral">&nbsp;</span>
184
+ <span class="cline-any cline-neutral">&nbsp;</span>
185
+ <span class="cline-any cline-neutral">&nbsp;</span>
186
+ <span class="cline-any cline-yes">2x</span>
187
+ <span class="cline-any cline-neutral">&nbsp;</span>
188
+ <span class="cline-any cline-neutral">&nbsp;</span>
189
+ <span class="cline-any cline-neutral">&nbsp;</span>
190
+ <span class="cline-any cline-neutral">&nbsp;</span>
191
+ <span class="cline-any cline-neutral">&nbsp;</span>
192
+ <span class="cline-any cline-neutral">&nbsp;</span>
193
+ <span class="cline-any cline-neutral">&nbsp;</span>
194
+ <span class="cline-any cline-neutral">&nbsp;</span>
195
+ <span class="cline-any cline-neutral">&nbsp;</span>
196
+ <span class="cline-any cline-neutral">&nbsp;</span>
197
+ <span class="cline-any cline-neutral">&nbsp;</span>
198
+ <span class="cline-any cline-yes">21x</span>
199
+ <span class="cline-any cline-yes">43x</span>
200
+ <span class="cline-any cline-neutral">&nbsp;</span>
201
+ <span class="cline-any cline-neutral">&nbsp;</span>
202
+ <span class="cline-any cline-neutral">&nbsp;</span>
203
+ <span class="cline-any cline-neutral">&nbsp;</span>
204
+ <span class="cline-any cline-neutral">&nbsp;</span>
205
+ <span class="cline-any cline-yes">21x</span>
206
+ <span class="cline-any cline-yes">21x</span>
207
+ <span class="cline-any cline-yes">6x</span>
208
+ <span class="cline-any cline-neutral">&nbsp;</span>
209
+ <span class="cline-any cline-neutral">&nbsp;</span>
210
+ <span class="cline-any cline-yes">15x</span>
211
+ <span class="cline-any cline-yes">15x</span>
212
+ <span class="cline-any cline-neutral">&nbsp;</span>
213
+ <span class="cline-any cline-neutral">&nbsp;</span>
214
+ <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { TaskStep } from "./TaskStep.js";
215
+ import { TaskResult } from "./TaskResult.js";
216
+ import { TaskGraphValidator } from "./TaskGraphValidator.js";
217
+ import { TaskGraph } from "./TaskGraph.js";
218
+ import { RunnerEventPayloads, RunnerEventListener } from "./contracts/RunnerEvents.js";
219
+ import { EventBus } from "./EventBus.js";
220
+ import { WorkflowExecutor } from "./WorkflowExecutor.js";
221
+ &nbsp;
222
+ // Re-export types for backward compatibility
223
+ export { RunnerEventPayloads, RunnerEventListener };
224
+ &nbsp;
225
+ /**
226
+ * The main class that orchestrates the execution of a list of tasks
227
+ * based on their dependencies, with support for parallel execution.
228
+ * @template TContext The shape of the shared context object.
229
+ */
230
+ export class TaskRunner&lt;TContext&gt; {
231
+ private eventBus = new EventBus&lt;TContext&gt;();
232
+ private validator = new TaskGraphValidator();
233
+ &nbsp;
234
+ /**
235
+ * @param context The shared context object to be passed to each task.
236
+ */
237
+ constructor(private context: TContext) {}
238
+ &nbsp;
239
+ /**
240
+ * Subscribe to an event.
241
+ * @param event The event name.
242
+ * @param callback The callback to execute when the event is emitted.
243
+ */
244
+ public on&lt;K extends keyof RunnerEventPayloads&lt;TContext&gt;&gt;(
245
+ event: K,
246
+ callback: RunnerEventListener&lt;TContext, K&gt;
247
+ ): void {
248
+ this.eventBus.on(event, callback);
249
+ }
250
+ &nbsp;
251
+ /**
252
+ * Unsubscribe from an event.
253
+ * @param event The event name.
254
+ * @param callback The callback to remove.
255
+ */
256
+ public off&lt;K extends keyof RunnerEventPayloads&lt;TContext&gt;&gt;(
257
+ event: K,
258
+ callback: RunnerEventListener&lt;TContext, K&gt;
259
+ ): void {
260
+ this.eventBus.off(event, callback);
261
+ }
262
+ &nbsp;
263
+ /**
264
+ * Executes a list of tasks, respecting their dependencies and running
265
+ * independent tasks in parallel.
266
+ * @param steps An array of TaskStep objects to be executed.
267
+ * @returns A Promise that resolves to a Map where keys are task names
268
+ * and values are the corresponding TaskResult objects.
269
+ */
270
+ async execute(steps: TaskStep&lt;TContext&gt;[]): Promise&lt;Map&lt;string, TaskResult&gt;&gt; {
271
+ // Validate the task graph before execution
272
+ const taskGraph: TaskGraph = {
273
+ tasks: steps.map((step) =&gt; ({
274
+ id: step.name,
275
+ dependencies: step.dependencies ?? [],
276
+ })),
277
+ };
278
+ &nbsp;
279
+ const validationResult = this.validator.validate(taskGraph);
280
+ if (!validationResult.isValid) {
281
+ throw new Error(this.validator.createErrorMessage(validationResult));
282
+ }
283
+ &nbsp;
284
+ const executor = new WorkflowExecutor(this.context, this.eventBus);
285
+ return executor.execute(steps);
286
+ }
287
+ }
288
+ &nbsp;</pre></td></tr></table></pre>
289
+
290
+ <div class='push'></div><!-- for sticky footer -->
291
+ </div><!-- /wrapper -->
292
+ <div class='footer quiet pad2 space-top1 center small'>
293
+ Code coverage generated by
294
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
295
+ at 2026-01-18T14:25:37.513Z
296
+ </div>
297
+ <script src="../prettify.js"></script>
298
+ <script>
299
+ window.onload = function () {
300
+ prettyPrint();
301
+ };
302
+ </script>
303
+ <script src="../sorter.js"></script>
304
+ <script src="../block-navigation.js"></script>
305
+ </body>
306
+ </html>
307
+