@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/WorkflowExecutor.ts.html ADDED
@@ -0,0 +1,457 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for src/WorkflowExecutor.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> WorkflowExecutor.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'>48/48</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'>14/14</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'>48/48</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>
141
+ <a name='L76'></a><a href='#L76'>76</a>
142
+ <a name='L77'></a><a href='#L77'>77</a>
143
+ <a name='L78'></a><a href='#L78'>78</a>
144
+ <a name='L79'></a><a href='#L79'>79</a>
145
+ <a name='L80'></a><a href='#L80'>80</a>
146
+ <a name='L81'></a><a href='#L81'>81</a>
147
+ <a name='L82'></a><a href='#L82'>82</a>
148
+ <a name='L83'></a><a href='#L83'>83</a>
149
+ <a name='L84'></a><a href='#L84'>84</a>
150
+ <a name='L85'></a><a href='#L85'>85</a>
151
+ <a name='L86'></a><a href='#L86'>86</a>
152
+ <a name='L87'></a><a href='#L87'>87</a>
153
+ <a name='L88'></a><a href='#L88'>88</a>
154
+ <a name='L89'></a><a href='#L89'>89</a>
155
+ <a name='L90'></a><a href='#L90'>90</a>
156
+ <a name='L91'></a><a href='#L91'>91</a>
157
+ <a name='L92'></a><a href='#L92'>92</a>
158
+ <a name='L93'></a><a href='#L93'>93</a>
159
+ <a name='L94'></a><a href='#L94'>94</a>
160
+ <a name='L95'></a><a href='#L95'>95</a>
161
+ <a name='L96'></a><a href='#L96'>96</a>
162
+ <a name='L97'></a><a href='#L97'>97</a>
163
+ <a name='L98'></a><a href='#L98'>98</a>
164
+ <a name='L99'></a><a href='#L99'>99</a>
165
+ <a name='L100'></a><a href='#L100'>100</a>
166
+ <a name='L101'></a><a href='#L101'>101</a>
167
+ <a name='L102'></a><a href='#L102'>102</a>
168
+ <a name='L103'></a><a href='#L103'>103</a>
169
+ <a name='L104'></a><a href='#L104'>104</a>
170
+ <a name='L105'></a><a href='#L105'>105</a>
171
+ <a name='L106'></a><a href='#L106'>106</a>
172
+ <a name='L107'></a><a href='#L107'>107</a>
173
+ <a name='L108'></a><a href='#L108'>108</a>
174
+ <a name='L109'></a><a href='#L109'>109</a>
175
+ <a name='L110'></a><a href='#L110'>110</a>
176
+ <a name='L111'></a><a href='#L111'>111</a>
177
+ <a name='L112'></a><a href='#L112'>112</a>
178
+ <a name='L113'></a><a href='#L113'>113</a>
179
+ <a name='L114'></a><a href='#L114'>114</a>
180
+ <a name='L115'></a><a href='#L115'>115</a>
181
+ <a name='L116'></a><a href='#L116'>116</a>
182
+ <a name='L117'></a><a href='#L117'>117</a>
183
+ <a name='L118'></a><a href='#L118'>118</a>
184
+ <a name='L119'></a><a href='#L119'>119</a>
185
+ <a name='L120'></a><a href='#L120'>120</a>
186
+ <a name='L121'></a><a href='#L121'>121</a>
187
+ <a name='L122'></a><a href='#L122'>122</a>
188
+ <a name='L123'></a><a href='#L123'>123</a>
189
+ <a name='L124'></a><a href='#L124'>124</a>
190
+ <a name='L125'></a><a href='#L125'>125</a></td><td class="line-coverage quiet"><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-neutral">&nbsp;</span>
199
+ <span class="cline-any cline-yes">18x</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-neutral">&nbsp;</span>
206
+ <span class="cline-any cline-yes">18x</span>
207
+ <span class="cline-any cline-yes">18x</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-neutral">&nbsp;</span>
211
+ <span class="cline-any cline-neutral">&nbsp;</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>
215
+ <span class="cline-any cline-neutral">&nbsp;</span>
216
+ <span class="cline-any cline-yes">18x</span>
217
+ <span class="cline-any cline-neutral">&nbsp;</span>
218
+ <span class="cline-any cline-yes">18x</span>
219
+ <span class="cline-any cline-yes">18x</span>
220
+ <span class="cline-any cline-yes">18x</span>
221
+ <span class="cline-any cline-neutral">&nbsp;</span>
222
+ <span class="cline-any cline-neutral">&nbsp;</span>
223
+ <span class="cline-any cline-yes">18x</span>
224
+ <span class="cline-any cline-neutral">&nbsp;</span>
225
+ <span class="cline-any cline-yes">18x</span>
226
+ <span class="cline-any cline-neutral">&nbsp;</span>
227
+ <span class="cline-any cline-yes">25x</span>
228
+ <span class="cline-any cline-neutral">&nbsp;</span>
229
+ <span class="cline-any cline-yes">25x</span>
230
+ <span class="cline-any cline-neutral">&nbsp;</span>
231
+ <span class="cline-any cline-neutral">&nbsp;</span>
232
+ <span class="cline-any cline-yes">18x</span>
233
+ <span class="cline-any cline-yes">18x</span>
234
+ <span class="cline-any cline-neutral">&nbsp;</span>
235
+ <span class="cline-any cline-neutral">&nbsp;</span>
236
+ <span class="cline-any cline-neutral">&nbsp;</span>
237
+ <span class="cline-any cline-neutral">&nbsp;</span>
238
+ <span class="cline-any cline-neutral">&nbsp;</span>
239
+ <span class="cline-any cline-neutral">&nbsp;</span>
240
+ <span class="cline-any cline-neutral">&nbsp;</span>
241
+ <span class="cline-any cline-neutral">&nbsp;</span>
242
+ <span class="cline-any cline-neutral">&nbsp;</span>
243
+ <span class="cline-any cline-neutral">&nbsp;</span>
244
+ <span class="cline-any cline-neutral">&nbsp;</span>
245
+ <span class="cline-any cline-yes">43x</span>
246
+ <span class="cline-any cline-yes">43x</span>
247
+ <span class="cline-any cline-neutral">&nbsp;</span>
248
+ <span class="cline-any cline-yes">43x</span>
249
+ <span class="cline-any cline-yes">57x</span>
250
+ <span class="cline-any cline-yes">57x</span>
251
+ <span class="cline-any cline-neutral">&nbsp;</span>
252
+ <span class="cline-any cline-neutral">&nbsp;</span>
253
+ <span class="cline-any cline-yes">57x</span>
254
+ <span class="cline-any cline-yes">43x</span>
255
+ <span class="cline-any cline-yes">43x</span>
256
+ <span class="cline-any cline-neutral">&nbsp;</span>
257
+ <span class="cline-any cline-yes">23x</span>
258
+ <span class="cline-any cline-yes">20x</span>
259
+ <span class="cline-any cline-yes">7x</span>
260
+ <span class="cline-any cline-yes">7x</span>
261
+ <span class="cline-any cline-neutral">&nbsp;</span>
262
+ <span class="cline-any cline-neutral">&nbsp;</span>
263
+ <span class="cline-any cline-neutral">&nbsp;</span>
264
+ <span class="cline-any cline-yes">57x</span>
265
+ <span class="cline-any cline-yes">7x</span>
266
+ <span class="cline-any cline-neutral">&nbsp;</span>
267
+ <span class="cline-any cline-neutral">&nbsp;</span>
268
+ <span class="cline-any cline-neutral">&nbsp;</span>
269
+ <span class="cline-any cline-yes">7x</span>
270
+ <span class="cline-any cline-yes">7x</span>
271
+ <span class="cline-any cline-yes">7x</span>
272
+ <span class="cline-any cline-yes">50x</span>
273
+ <span class="cline-any cline-yes">31x</span>
274
+ <span class="cline-any cline-yes">31x</span>
275
+ <span class="cline-any cline-neutral">&nbsp;</span>
276
+ <span class="cline-any cline-neutral">&nbsp;</span>
277
+ <span class="cline-any cline-neutral">&nbsp;</span>
278
+ <span class="cline-any cline-neutral">&nbsp;</span>
279
+ <span class="cline-any cline-yes">43x</span>
280
+ <span class="cline-any cline-yes">38x</span>
281
+ <span class="cline-any cline-neutral">&nbsp;</span>
282
+ <span class="cline-any cline-neutral">&nbsp;</span>
283
+ <span class="cline-any cline-neutral">&nbsp;</span>
284
+ <span class="cline-any cline-yes">43x</span>
285
+ <span class="cline-any cline-yes">31x</span>
286
+ <span class="cline-any cline-yes">31x</span>
287
+ <span class="cline-any cline-neutral">&nbsp;</span>
288
+ <span class="cline-any cline-yes">31x</span>
289
+ <span class="cline-any cline-neutral">&nbsp;</span>
290
+ <span class="cline-any cline-neutral">&nbsp;</span>
291
+ <span class="cline-any cline-neutral">&nbsp;</span>
292
+ <span class="cline-any cline-neutral">&nbsp;</span>
293
+ <span class="cline-any cline-neutral">&nbsp;</span>
294
+ <span class="cline-any cline-neutral">&nbsp;</span>
295
+ <span class="cline-any cline-neutral">&nbsp;</span>
296
+ <span class="cline-any cline-yes">31x</span>
297
+ <span class="cline-any cline-yes">31x</span>
298
+ <span class="cline-any cline-neutral">&nbsp;</span>
299
+ <span class="cline-any cline-yes">31x</span>
300
+ <span class="cline-any cline-yes">31x</span>
301
+ <span class="cline-any cline-yes">29x</span>
302
+ <span class="cline-any cline-neutral">&nbsp;</span>
303
+ <span class="cline-any cline-yes">2x</span>
304
+ <span class="cline-any cline-neutral">&nbsp;</span>
305
+ <span class="cline-any cline-neutral">&nbsp;</span>
306
+ <span class="cline-any cline-neutral">&nbsp;</span>
307
+ <span class="cline-any cline-neutral">&nbsp;</span>
308
+ <span class="cline-any cline-yes">31x</span>
309
+ <span class="cline-any cline-yes">31x</span>
310
+ <span class="cline-any cline-yes">31x</span>
311
+ <span class="cline-any cline-neutral">&nbsp;</span>
312
+ <span class="cline-any cline-neutral">&nbsp;</span>
313
+ <span class="cline-any cline-neutral">&nbsp;</span>
314
+ <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { TaskStep } from "./TaskStep.js";
315
+ import { TaskResult } from "./TaskResult.js";
316
+ import { EventBus } from "./EventBus.js";
317
+ &nbsp;
318
+ /**
319
+ * Handles the execution of the workflow steps.
320
+ * @template TContext The shape of the shared context object.
321
+ */
322
+ export class WorkflowExecutor&lt;TContext&gt; {
323
+ private running = new Set&lt;string&gt;();
324
+ &nbsp;
325
+ /**
326
+ * @param context The shared context object.
327
+ * @param eventBus The event bus to emit events.
328
+ */
329
+ constructor(
330
+ private context: TContext,
331
+ private eventBus: EventBus&lt;TContext&gt;
332
+ ) {}
333
+ &nbsp;
334
+ /**
335
+ * Executes the given steps.
336
+ * @param steps The list of steps to execute.
337
+ * @returns A Promise that resolves to a map of task results.
338
+ */
339
+ async execute(steps: TaskStep&lt;TContext&gt;[]): Promise&lt;Map&lt;string, TaskResult&gt;&gt; {
340
+ this.eventBus.emit("workflowStart", { context: this.context, steps });
341
+ &nbsp;
342
+ const results = new Map&lt;string, TaskResult&gt;();
343
+ const executingPromises = new Set&lt;Promise&lt;void&gt;&gt;();
344
+ const pendingSteps = new Set(steps);
345
+ &nbsp;
346
+ // Initial pass
347
+ this.processQueue(pendingSteps, results, executingPromises);
348
+ &nbsp;
349
+ while (results.size &lt; steps.length &amp;&amp; executingPromises.size &gt; 0) {
350
+ // Wait for the next task to finish
351
+ await Promise.race(executingPromises);
352
+ // After a task finishes, check for new work
353
+ this.processQueue(pendingSteps, results, executingPromises);
354
+ }
355
+ &nbsp;
356
+ this.eventBus.emit("workflowEnd", { context: this.context, results });
357
+ return results;
358
+ }
359
+ &nbsp;
360
+ /**
361
+ * Logic to identify tasks that can be started or must be skipped.
362
+ * Iterate only over pending steps to avoid O(N^2) checks on completed tasks.
363
+ */
364
+ private processQueue(
365
+ pendingSteps: Set&lt;TaskStep&lt;TContext&gt;&gt;,
366
+ results: Map&lt;string, TaskResult&gt;,
367
+ executingPromises: Set&lt;Promise&lt;void&gt;&gt;
368
+ ): void {
369
+ const toRemove: TaskStep&lt;TContext&gt;[] = [];
370
+ const toRun: TaskStep&lt;TContext&gt;[] = [];
371
+ &nbsp;
372
+ for (const step of pendingSteps) {
373
+ const deps = step.dependencies ?? [];
374
+ let blocked = false;
375
+ let failedDep: string | undefined;
376
+ &nbsp;
377
+ for (const dep of deps) {
378
+ const depResult = results.get(dep);
379
+ if (!depResult) {
380
+ // Dependency not finished yet
381
+ blocked = true;
382
+ } else if (depResult.status !== "success") {
383
+ failedDep = dep;
384
+ break;
385
+ }
386
+ }
387
+ &nbsp;
388
+ if (failedDep) {
389
+ const result: TaskResult = {
390
+ status: "skipped",
391
+ message: `Skipped due to failed dependency: ${failedDep}`,
392
+ };
393
+ results.set(step.name, result);
394
+ this.eventBus.emit("taskSkipped", { step, result });
395
+ toRemove.push(step);
396
+ } else if (!blocked) {
397
+ toRun.push(step);
398
+ toRemove.push(step);
399
+ }
400
+ }
401
+ &nbsp;
402
+ // Cleanup pending set
403
+ for (const step of toRemove) {
404
+ pendingSteps.delete(step);
405
+ }
406
+ &nbsp;
407
+ // Execute ready tasks
408
+ for (const step of toRun) {
409
+ const taskPromise = this.runStep(step, results).then(() =&gt; {
410
+ executingPromises.delete(taskPromise);
411
+ });
412
+ executingPromises.add(taskPromise);
413
+ }
414
+ }
415
+ &nbsp;
416
+ /**
417
+ * Handles the lifecycle of a single task execution.
418
+ */
419
+ private async runStep(step: TaskStep&lt;TContext&gt;, results: Map&lt;string, TaskResult&gt;): Promise&lt;void&gt; {
420
+ this.running.add(step.name);
421
+ this.eventBus.emit("taskStart", { step });
422
+ &nbsp;
423
+ try {
424
+ const result = await step.run(this.context);
425
+ results.set(step.name, result);
426
+ } catch (e) {
427
+ results.set(step.name, {
428
+ status: "failure",
429
+ error: e instanceof Error ? e.message : String(e),
430
+ });
431
+ } finally {
432
+ this.running.delete(step.name);
433
+ const result = results.get(step.name)!;
434
+ this.eventBus.emit("taskEnd", { step, result });
435
+ }
436
+ }
437
+ }
438
+ &nbsp;</pre></td></tr></table></pre>
439
+
440
+ <div class='push'></div><!-- for sticky footer -->
441
+ </div><!-- /wrapper -->
442
+ <div class='footer quiet pad2 space-top1 center small'>
443
+ Code coverage generated by
444
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
445
+ at 2026-01-18T14:25:37.513Z
446
+ </div>
447
+ <script src="../prettify.js"></script>
448
+ <script>
449
+ window.onload = function () {
450
+ prettyPrint();
451
+ };
452
+ </script>
453
+ <script src="../sorter.js"></script>
454
+ <script src="../block-navigation.js"></script>
455
+ </body>
456
+ </html>
457
+