@calmo/task-runner 2.0.0 → 3.0.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 (83) hide show
  1. package/AGENTS.md +49 -0
  2. package/CHANGELOG.md +21 -0
  3. package/README.md +1 -1
  4. package/coverage/coverage-final.json +8 -4
  5. package/coverage/index.html +24 -9
  6. package/coverage/lcov-report/index.html +24 -9
  7. package/coverage/lcov-report/src/EventBus.ts.html +8 -8
  8. package/coverage/lcov-report/src/TaskGraphValidator.ts.html +53 -53
  9. package/coverage/lcov-report/src/TaskRunner.ts.html +213 -21
  10. package/coverage/lcov-report/src/TaskRunnerBuilder.ts.html +313 -0
  11. package/coverage/lcov-report/src/TaskRunnerExecutionConfig.ts.html +124 -0
  12. package/coverage/lcov-report/src/TaskStateManager.ts.html +511 -0
  13. package/coverage/lcov-report/src/WorkflowExecutor.ts.html +119 -137
  14. package/coverage/lcov-report/src/contracts/RunnerEvents.ts.html +1 -1
  15. package/coverage/lcov-report/src/contracts/index.html +1 -1
  16. package/coverage/lcov-report/src/index.html +57 -12
  17. package/coverage/lcov-report/src/strategies/StandardExecutionStrategy.ts.html +190 -0
  18. package/coverage/lcov-report/src/strategies/index.html +116 -0
  19. package/coverage/lcov.info +381 -204
  20. package/coverage/src/EventBus.ts.html +8 -8
  21. package/coverage/src/TaskGraphValidator.ts.html +53 -53
  22. package/coverage/src/TaskRunner.ts.html +213 -21
  23. package/coverage/src/TaskRunnerBuilder.ts.html +313 -0
  24. package/coverage/src/TaskRunnerExecutionConfig.ts.html +124 -0
  25. package/coverage/src/TaskStateManager.ts.html +511 -0
  26. package/coverage/src/WorkflowExecutor.ts.html +119 -137
  27. package/coverage/src/contracts/RunnerEvents.ts.html +1 -1
  28. package/coverage/src/contracts/index.html +1 -1
  29. package/coverage/src/index.html +57 -12
  30. package/coverage/src/strategies/StandardExecutionStrategy.ts.html +190 -0
  31. package/coverage/src/strategies/index.html +116 -0
  32. package/dist/TaskRunner.d.ts +12 -2
  33. package/dist/TaskRunner.js +55 -3
  34. package/dist/TaskRunner.js.map +1 -1
  35. package/dist/TaskRunnerBuilder.d.ts +33 -0
  36. package/dist/TaskRunnerBuilder.js +54 -0
  37. package/dist/TaskRunnerBuilder.js.map +1 -0
  38. package/dist/TaskRunnerExecutionConfig.d.ts +13 -0
  39. package/dist/TaskRunnerExecutionConfig.js +2 -0
  40. package/dist/TaskRunnerExecutionConfig.js.map +1 -0
  41. package/dist/TaskStateManager.d.ts +54 -0
  42. package/dist/TaskStateManager.js +130 -0
  43. package/dist/TaskStateManager.js.map +1 -0
  44. package/dist/TaskStatus.d.ts +1 -1
  45. package/dist/TaskStep.d.ts +2 -1
  46. package/dist/WorkflowExecutor.d.ts +11 -17
  47. package/dist/WorkflowExecutor.js +67 -69
  48. package/dist/WorkflowExecutor.js.map +1 -1
  49. package/dist/index.d.ts +4 -0
  50. package/dist/index.js +3 -0
  51. package/dist/index.js.map +1 -1
  52. package/dist/strategies/IExecutionStrategy.d.ts +16 -0
  53. package/dist/strategies/IExecutionStrategy.js +2 -0
  54. package/dist/strategies/IExecutionStrategy.js.map +1 -0
  55. package/dist/strategies/StandardExecutionStrategy.d.ts +9 -0
  56. package/dist/strategies/StandardExecutionStrategy.js +25 -0
  57. package/dist/strategies/StandardExecutionStrategy.js.map +1 -0
  58. package/openspec/changes/add-concurrency-control/proposal.md +14 -0
  59. package/openspec/changes/add-concurrency-control/tasks.md +9 -0
  60. package/openspec/changes/add-task-retry-policy/proposal.md +13 -0
  61. package/openspec/changes/add-task-retry-policy/tasks.md +10 -0
  62. package/openspec/changes/add-workflow-preview/proposal.md +12 -0
  63. package/openspec/changes/add-workflow-preview/tasks.md +7 -0
  64. package/openspec/changes/archive/2026-01-18-add-external-task-cancellation/tasks.md +10 -0
  65. package/openspec/changes/archive/2026-01-18-add-integration-tests/proposal.md +18 -0
  66. package/openspec/changes/archive/2026-01-18-add-integration-tests/tasks.md +17 -0
  67. package/openspec/changes/archive/2026-01-18-refactor-core-architecture/proposal.md +14 -0
  68. package/openspec/changes/archive/2026-01-18-refactor-core-architecture/tasks.md +8 -0
  69. package/package.json +1 -1
  70. package/src/TaskRunner.ts +68 -4
  71. package/src/TaskRunnerBuilder.ts +76 -0
  72. package/src/TaskRunnerExecutionConfig.ts +13 -0
  73. package/src/TaskStateManager.ts +142 -0
  74. package/src/TaskStatus.ts +1 -1
  75. package/src/TaskStep.ts +2 -1
  76. package/src/WorkflowExecutor.ts +77 -83
  77. package/src/index.ts +4 -0
  78. package/src/strategies/IExecutionStrategy.ts +21 -0
  79. package/src/strategies/StandardExecutionStrategy.ts +35 -0
  80. package/test-report.xml +119 -45
  81. package/GEMINI.md +0 -48
  82. package/openspec/changes/add-external-task-cancellation/tasks.md +0 -10
  83. /package/openspec/changes/{add-external-task-cancellation → archive/2026-01-18-add-external-task-cancellation}/proposal.md +0 -0
package/coverage/src/TaskStateManager.ts.html ADDED
@@ -0,0 +1,511 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for src/TaskStateManager.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> TaskStateManager.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'>45/45</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'>16/16</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'>9/9</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'>45/45</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>
191
+ <a name='L126'></a><a href='#L126'>126</a>
192
+ <a name='L127'></a><a href='#L127'>127</a>
193
+ <a name='L128'></a><a href='#L128'>128</a>
194
+ <a name='L129'></a><a href='#L129'>129</a>
195
+ <a name='L130'></a><a href='#L130'>130</a>
196
+ <a name='L131'></a><a href='#L131'>131</a>
197
+ <a name='L132'></a><a href='#L132'>132</a>
198
+ <a name='L133'></a><a href='#L133'>133</a>
199
+ <a name='L134'></a><a href='#L134'>134</a>
200
+ <a name='L135'></a><a href='#L135'>135</a>
201
+ <a name='L136'></a><a href='#L136'>136</a>
202
+ <a name='L137'></a><a href='#L137'>137</a>
203
+ <a name='L138'></a><a href='#L138'>138</a>
204
+ <a name='L139'></a><a href='#L139'>139</a>
205
+ <a name='L140'></a><a href='#L140'>140</a>
206
+ <a name='L141'></a><a href='#L141'>141</a>
207
+ <a name='L142'></a><a href='#L142'>142</a>
208
+ <a name='L143'></a><a href='#L143'>143</a></td><td class="line-coverage quiet"><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-neutral">&nbsp;</span>
217
+ <span class="cline-any cline-yes">42x</span>
218
+ <span class="cline-any cline-yes">42x</span>
219
+ <span class="cline-any cline-yes">42x</span>
220
+ <span class="cline-any cline-neutral">&nbsp;</span>
221
+ <span class="cline-any cline-yes">42x</span>
222
+ <span class="cline-any cline-neutral">&nbsp;</span>
223
+ <span class="cline-any cline-neutral">&nbsp;</span>
224
+ <span class="cline-any cline-neutral">&nbsp;</span>
225
+ <span class="cline-any cline-neutral">&nbsp;</span>
226
+ <span class="cline-any cline-neutral">&nbsp;</span>
227
+ <span class="cline-any cline-neutral">&nbsp;</span>
228
+ <span class="cline-any cline-yes">41x</span>
229
+ <span class="cline-any cline-yes">41x</span>
230
+ <span class="cline-any cline-yes">41x</span>
231
+ <span class="cline-any cline-neutral">&nbsp;</span>
232
+ <span class="cline-any cline-neutral">&nbsp;</span>
233
+ <span class="cline-any cline-neutral">&nbsp;</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-yes">103x</span>
240
+ <span class="cline-any cline-yes">103x</span>
241
+ <span class="cline-any cline-neutral">&nbsp;</span>
242
+ <span class="cline-any cline-yes">103x</span>
243
+ <span class="cline-any cline-yes">208x</span>
244
+ <span class="cline-any cline-yes">208x</span>
245
+ <span class="cline-any cline-neutral">&nbsp;</span>
246
+ <span class="cline-any cline-neutral">&nbsp;</span>
247
+ <span class="cline-any cline-yes">208x</span>
248
+ <span class="cline-any cline-yes">453x</span>
249
+ <span class="cline-any cline-yes">453x</span>
250
+ <span class="cline-any cline-neutral">&nbsp;</span>
251
+ <span class="cline-any cline-yes">309x</span>
252
+ <span class="cline-any cline-yes">144x</span>
253
+ <span class="cline-any cline-yes">8x</span>
254
+ <span class="cline-any cline-yes">8x</span>
255
+ <span class="cline-any cline-neutral">&nbsp;</span>
256
+ <span class="cline-any cline-neutral">&nbsp;</span>
257
+ <span class="cline-any cline-neutral">&nbsp;</span>
258
+ <span class="cline-any cline-yes">208x</span>
259
+ <span class="cline-any cline-yes">8x</span>
260
+ <span class="cline-any cline-yes">8x</span>
261
+ <span class="cline-any cline-yes">8x</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-neutral">&nbsp;</span>
265
+ <span class="cline-any cline-yes">8x</span>
266
+ <span class="cline-any cline-yes">8x</span>
267
+ <span class="cline-any cline-yes">8x</span>
268
+ <span class="cline-any cline-yes">200x</span>
269
+ <span class="cline-any cline-yes">101x</span>
270
+ <span class="cline-any cline-yes">101x</span>
271
+ <span class="cline-any cline-neutral">&nbsp;</span>
272
+ <span class="cline-any cline-neutral">&nbsp;</span>
273
+ <span class="cline-any cline-neutral">&nbsp;</span>
274
+ <span class="cline-any cline-neutral">&nbsp;</span>
275
+ <span class="cline-any cline-yes">103x</span>
276
+ <span class="cline-any cline-yes">109x</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">103x</span>
280
+ <span class="cline-any cline-neutral">&nbsp;</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-neutral">&nbsp;</span>
285
+ <span class="cline-any cline-neutral">&nbsp;</span>
286
+ <span class="cline-any cline-neutral">&nbsp;</span>
287
+ <span class="cline-any cline-yes">101x</span>
288
+ <span class="cline-any cline-yes">101x</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-neutral">&nbsp;</span>
297
+ <span class="cline-any cline-neutral">&nbsp;</span>
298
+ <span class="cline-any cline-yes">102x</span>
299
+ <span class="cline-any cline-yes">102x</span>
300
+ <span class="cline-any cline-yes">102x</span>
301
+ <span class="cline-any cline-neutral">&nbsp;</span>
302
+ <span class="cline-any cline-neutral">&nbsp;</span>
303
+ <span class="cline-any cline-neutral">&nbsp;</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-neutral">&nbsp;</span>
309
+ <span class="cline-any cline-yes">60x</span>
310
+ <span class="cline-any cline-neutral">&nbsp;</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-yes">4x</span>
314
+ <span class="cline-any cline-yes">3x</span>
315
+ <span class="cline-any cline-neutral">&nbsp;</span>
316
+ <span class="cline-any cline-neutral">&nbsp;</span>
317
+ <span class="cline-any cline-neutral">&nbsp;</span>
318
+ <span class="cline-any cline-yes">3x</span>
319
+ <span class="cline-any cline-neutral">&nbsp;</span>
320
+ <span class="cline-any cline-neutral">&nbsp;</span>
321
+ <span class="cline-any cline-neutral">&nbsp;</span>
322
+ <span class="cline-any cline-neutral">&nbsp;</span>
323
+ <span class="cline-any cline-neutral">&nbsp;</span>
324
+ <span class="cline-any cline-neutral">&nbsp;</span>
325
+ <span class="cline-any cline-neutral">&nbsp;</span>
326
+ <span class="cline-any cline-yes">60x</span>
327
+ <span class="cline-any cline-neutral">&nbsp;</span>
328
+ <span class="cline-any cline-neutral">&nbsp;</span>
329
+ <span class="cline-any cline-neutral">&nbsp;</span>
330
+ <span class="cline-any cline-neutral">&nbsp;</span>
331
+ <span class="cline-any cline-neutral">&nbsp;</span>
332
+ <span class="cline-any cline-neutral">&nbsp;</span>
333
+ <span class="cline-any cline-yes">42x</span>
334
+ <span class="cline-any cline-neutral">&nbsp;</span>
335
+ <span class="cline-any cline-neutral">&nbsp;</span>
336
+ <span class="cline-any cline-neutral">&nbsp;</span>
337
+ <span class="cline-any cline-neutral">&nbsp;</span>
338
+ <span class="cline-any cline-neutral">&nbsp;</span>
339
+ <span class="cline-any cline-neutral">&nbsp;</span>
340
+ <span class="cline-any cline-yes">79x</span>
341
+ <span class="cline-any cline-neutral">&nbsp;</span>
342
+ <span class="cline-any cline-neutral">&nbsp;</span>
343
+ <span class="cline-any cline-neutral">&nbsp;</span>
344
+ <span class="cline-any cline-neutral">&nbsp;</span>
345
+ <span class="cline-any cline-neutral">&nbsp;</span>
346
+ <span class="cline-any cline-neutral">&nbsp;</span>
347
+ <span class="cline-any cline-yes">112x</span>
348
+ <span class="cline-any cline-neutral">&nbsp;</span>
349
+ <span class="cline-any cline-neutral">&nbsp;</span>
350
+ <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { TaskStep } from "./TaskStep.js";
351
+ import { TaskResult } from "./TaskResult.js";
352
+ import { EventBus } from "./EventBus.js";
353
+ &nbsp;
354
+ /**
355
+ * Manages the state of the task execution, including results, pending steps, and running tasks.
356
+ * Handles dependency resolution and event emission for state changes.
357
+ */
358
+ export class TaskStateManager&lt;TContext&gt; {
359
+ private results = new Map&lt;string, TaskResult&gt;();
360
+ private pendingSteps = new Set&lt;TaskStep&lt;TContext&gt;&gt;();
361
+ private running = new Set&lt;string&gt;();
362
+ &nbsp;
363
+ constructor(private eventBus: EventBus&lt;TContext&gt;) {}
364
+ &nbsp;
365
+ /**
366
+ * Initializes the state with the given steps.
367
+ * @param steps The steps to execute.
368
+ */
369
+ initialize(steps: TaskStep&lt;TContext&gt;[]): void {
370
+ this.pendingSteps = new Set(steps);
371
+ this.results.clear();
372
+ this.running.clear();
373
+ }
374
+ &nbsp;
375
+ /**
376
+ * Processes the pending steps to identify tasks that can be started or must be skipped.
377
+ * Emits `taskSkipped` for skipped tasks.
378
+ * @returns An array of tasks that are ready to run.
379
+ */
380
+ processDependencies(): TaskStep&lt;TContext&gt;[] {
381
+ const toRemove: TaskStep&lt;TContext&gt;[] = [];
382
+ const toRun: TaskStep&lt;TContext&gt;[] = [];
383
+ &nbsp;
384
+ for (const step of this.pendingSteps) {
385
+ const deps = step.dependencies ?? [];
386
+ let blocked = false;
387
+ let failedDep: string | undefined;
388
+ &nbsp;
389
+ for (const dep of deps) {
390
+ const depResult = this.results.get(dep);
391
+ if (!depResult) {
392
+ // Dependency not finished yet
393
+ blocked = true;
394
+ } else if (depResult.status !== "success") {
395
+ failedDep = dep;
396
+ break;
397
+ }
398
+ }
399
+ &nbsp;
400
+ if (failedDep) {
401
+ const depResult = this.results.get(failedDep);
402
+ const depError = depResult?.error ? `: ${depResult.error}` : "";
403
+ const result: TaskResult = {
404
+ status: "skipped",
405
+ message: `Skipped because dependency '${failedDep}' failed${depError}`,
406
+ };
407
+ this.results.set(step.name, result);
408
+ this.eventBus.emit("taskSkipped", { step, result });
409
+ toRemove.push(step);
410
+ } else if (!blocked) {
411
+ toRun.push(step);
412
+ toRemove.push(step);
413
+ }
414
+ }
415
+ &nbsp;
416
+ // Cleanup pending set
417
+ for (const step of toRemove) {
418
+ this.pendingSteps.delete(step);
419
+ }
420
+ &nbsp;
421
+ return toRun;
422
+ }
423
+ &nbsp;
424
+ /**
425
+ * Marks a task as running and emits `taskStart`.
426
+ * @param step The task that is starting.
427
+ */
428
+ markRunning(step: TaskStep&lt;TContext&gt;): void {
429
+ this.running.add(step.name);
430
+ this.eventBus.emit("taskStart", { step });
431
+ }
432
+ &nbsp;
433
+ /**
434
+ * Marks a task as completed (success, failure, or cancelled during execution)
435
+ * and emits `taskEnd`.
436
+ * @param step The task that completed.
437
+ * @param result The result of the task.
438
+ */
439
+ markCompleted(step: TaskStep&lt;TContext&gt;, result: TaskResult): void {
440
+ this.running.delete(step.name);
441
+ this.results.set(step.name, result);
442
+ this.eventBus.emit("taskEnd", { step, result });
443
+ }
444
+ &nbsp;
445
+ /**
446
+ * Cancels all pending tasks that haven't started yet.
447
+ * @param message The cancellation message.
448
+ */
449
+ cancelAllPending(message: string): void {
450
+ // Iterate over pendingSteps to cancel them
451
+ for (const step of this.pendingSteps) {
452
+ // Also check running? No, running tasks are handled by AbortSignal in Executor.
453
+ // We only cancel what is pending and hasn't started.
454
+ /* v8 ignore next 1 */
455
+ if (!this.results.has(step.name) &amp;&amp; !this.running.has(step.name)) {
456
+ const result: TaskResult = {
457
+ status: "cancelled",
458
+ message,
459
+ };
460
+ this.results.set(step.name, result);
461
+ }
462
+ }
463
+ // Clear pending set as they are now "done" (cancelled)
464
+ // Wait, if we clear pending steps, processDependencies won't pick them up.
465
+ // The loop in Executor relies on results.size or pendingSteps.
466
+ // The previous implementation iterated `steps` (all steps) to cancel.
467
+ // Here we iterate `pendingSteps`.
468
+ this.pendingSteps.clear();
469
+ }
470
+ &nbsp;
471
+ /**
472
+ * Returns the current results map.
473
+ */
474
+ getResults(): Map&lt;string, TaskResult&gt; {
475
+ return this.results;
476
+ }
477
+ &nbsp;
478
+ /**
479
+ * Checks if there are any tasks currently running.
480
+ */
481
+ hasRunningTasks(): boolean {
482
+ return this.running.size &gt; 0;
483
+ }
484
+ &nbsp;
485
+ /**
486
+ * Checks if there are any pending tasks.
487
+ */
488
+ hasPendingTasks(): boolean {
489
+ return this.pendingSteps.size &gt; 0;
490
+ }
491
+ }
492
+ &nbsp;</pre></td></tr></table></pre>
493
+
494
+ <div class='push'></div><!-- for sticky footer -->
495
+ </div><!-- /wrapper -->
496
+ <div class='footer quiet pad2 space-top1 center small'>
497
+ Code coverage generated by
498
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
499
+ at 2026-01-18T16:53:50.059Z
500
+ </div>
501
+ <script src="../prettify.js"></script>
502
+ <script>
503
+ window.onload = function () {
504
+ prettyPrint();
505
+ };
506
+ </script>
507
+ <script src="../sorter.js"></script>
508
+ <script src="../block-navigation.js"></script>
509
+ </body>
510
+ </html>
511
+