@calmo/task-runner 3.8.4 → 4.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 (124) hide show
  1. package/.agent/workflows/openspec-apply.md +20 -0
  2. package/.agent/workflows/openspec-archive.md +24 -0
  3. package/.agent/workflows/openspec-proposal.md +25 -0
  4. package/.github/workflows/codeql.yml +1 -1
  5. package/.github/workflows/release-please.yml +46 -0
  6. package/.husky/commit-msg +0 -0
  7. package/.husky/pre-commit +0 -0
  8. package/.jules/nexus.md +5 -0
  9. package/.release-please-manifest.json +3 -0
  10. package/AGENTS.md +1 -4
  11. package/CHANGELOG.md +123 -0
  12. package/CODE_OF_CONDUCT.md +131 -0
  13. package/CONTRIBUTING.md +89 -0
  14. package/README.md +1 -1
  15. package/dist/TaskResult.d.ts +9 -0
  16. package/dist/TaskRunner.js +47 -34
  17. package/dist/TaskRunner.js.map +1 -1
  18. package/dist/TaskStateManager.d.ts +22 -6
  19. package/dist/TaskStateManager.js +101 -45
  20. package/dist/TaskStateManager.js.map +1 -1
  21. package/dist/WorkflowExecutor.js +17 -10
  22. package/dist/WorkflowExecutor.js.map +1 -1
  23. package/dist/strategies/DryRunExecutionStrategy.d.ts +1 -1
  24. package/dist/strategies/DryRunExecutionStrategy.js +2 -4
  25. package/dist/strategies/DryRunExecutionStrategy.js.map +1 -1
  26. package/dist/utils/PriorityQueue.d.ts +13 -0
  27. package/dist/utils/PriorityQueue.js +82 -0
  28. package/dist/utils/PriorityQueue.js.map +1 -0
  29. package/openspec/changes/add-resource-concurrency/proposal.md +18 -0
  30. package/openspec/changes/add-resource-concurrency/specs/task-runner/spec.md +25 -0
  31. package/openspec/changes/add-resource-concurrency/tasks.md +9 -0
  32. package/openspec/changes/archive/2026-01-18-add-concurrency-control/specs/task-runner/spec.md +26 -0
  33. package/openspec/changes/archive/2026-01-18-add-external-task-cancellation/specs/task-runner/spec.md +63 -0
  34. package/openspec/changes/archive/2026-01-18-add-integration-tests/specs/task-runner/spec.md +22 -0
  35. package/openspec/changes/archive/2026-01-18-add-task-retry-policy/specs/task-runner/spec.md +40 -0
  36. package/openspec/changes/archive/2026-01-18-add-workflow-preview/specs/task-runner/spec.md +25 -0
  37. package/openspec/changes/archive/2026-01-18-refactor-core-architecture/specs/task-runner/spec.md +31 -0
  38. package/openspec/changes/archive/2026-01-22-adopt-release-pr/design.md +40 -0
  39. package/openspec/changes/archive/2026-01-22-adopt-release-pr/proposal.md +47 -0
  40. package/openspec/changes/archive/2026-01-22-adopt-release-pr/specs/release-pr/spec.md +34 -0
  41. package/openspec/changes/archive/2026-01-22-adopt-release-pr/tasks.md +14 -0
  42. package/openspec/changes/{feat-task-metrics → archive/2026-01-22-feat-task-metrics}/proposal.md +1 -1
  43. package/openspec/changes/archive/2026-01-22-feat-task-metrics/specs/001-generic-task-runner/spec.md +13 -0
  44. package/openspec/changes/archive/2026-01-22-feat-task-metrics/tasks.md +6 -0
  45. package/openspec/changes/feat-conditional-retries/proposal.md +18 -0
  46. package/openspec/changes/feat-conditional-retries/specs/task-runner/spec.md +23 -0
  47. package/openspec/changes/feat-conditional-retries/tasks.md +37 -0
  48. package/openspec/changes/feat-per-task-timeout/specs/task-runner/spec.md +34 -0
  49. package/openspec/changes/feat-state-persistence/specs/task-runner/spec.md +47 -0
  50. package/openspec/specs/release-pr/spec.md +31 -0
  51. package/openspec/specs/task-runner/spec.md +174 -0
  52. package/package.json +11 -20
  53. package/release-please-config.json +9 -0
  54. package/src/TaskResult.ts +9 -0
  55. package/src/TaskRunner.ts +55 -36
  56. package/src/TaskStateManager.ts +114 -46
  57. package/src/WorkflowExecutor.ts +21 -11
  58. package/src/strategies/DryRunExecutionStrategy.ts +2 -3
  59. package/src/utils/PriorityQueue.ts +101 -0
  60. package/.gemini/commands/speckit.analyze.toml +0 -188
  61. package/.gemini/commands/speckit.checklist.toml +0 -298
  62. package/.gemini/commands/speckit.clarify.toml +0 -185
  63. package/.gemini/commands/speckit.constitution.toml +0 -86
  64. package/.gemini/commands/speckit.implement.toml +0 -139
  65. package/.gemini/commands/speckit.plan.toml +0 -93
  66. package/.gemini/commands/speckit.specify.toml +0 -262
  67. package/.gemini/commands/speckit.tasks.toml +0 -141
  68. package/.gemini/commands/speckit.taskstoissues.toml +0 -34
  69. package/.github/workflows/release.yml +0 -46
  70. package/.releaserc.json +0 -27
  71. package/coverage/base.css +0 -224
  72. package/coverage/block-navigation.js +0 -87
  73. package/coverage/coverage-final.json +0 -15
  74. package/coverage/favicon.png +0 -0
  75. package/coverage/index.html +0 -146
  76. package/coverage/lcov-report/base.css +0 -224
  77. package/coverage/lcov-report/block-navigation.js +0 -87
  78. package/coverage/lcov-report/favicon.png +0 -0
  79. package/coverage/lcov-report/index.html +0 -146
  80. package/coverage/lcov-report/prettify.css +0 -1
  81. package/coverage/lcov-report/prettify.js +0 -2
  82. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  83. package/coverage/lcov-report/sorter.js +0 -210
  84. package/coverage/lcov-report/src/EventBus.ts.html +0 -379
  85. package/coverage/lcov-report/src/ExecutionConstants.ts.html +0 -121
  86. package/coverage/lcov-report/src/TaskGraphValidationError.ts.html +0 -130
  87. package/coverage/lcov-report/src/TaskGraphValidator.ts.html +0 -643
  88. package/coverage/lcov-report/src/TaskRunner.ts.html +0 -706
  89. package/coverage/lcov-report/src/TaskRunnerBuilder.ts.html +0 -337
  90. package/coverage/lcov-report/src/TaskRunnerExecutionConfig.ts.html +0 -154
  91. package/coverage/lcov-report/src/TaskStateManager.ts.html +0 -529
  92. package/coverage/lcov-report/src/WorkflowExecutor.ts.html +0 -712
  93. package/coverage/lcov-report/src/contracts/ErrorTypes.ts.html +0 -103
  94. package/coverage/lcov-report/src/contracts/RunnerEvents.ts.html +0 -217
  95. package/coverage/lcov-report/src/contracts/index.html +0 -131
  96. package/coverage/lcov-report/src/index.html +0 -236
  97. package/coverage/lcov-report/src/strategies/DryRunExecutionStrategy.ts.html +0 -178
  98. package/coverage/lcov-report/src/strategies/RetryingExecutionStrategy.ts.html +0 -373
  99. package/coverage/lcov-report/src/strategies/StandardExecutionStrategy.ts.html +0 -190
  100. package/coverage/lcov-report/src/strategies/index.html +0 -146
  101. package/coverage/lcov.info +0 -671
  102. package/coverage/prettify.css +0 -1
  103. package/coverage/prettify.js +0 -2
  104. package/coverage/sort-arrow-sprite.png +0 -0
  105. package/coverage/sorter.js +0 -210
  106. package/coverage/src/EventBus.ts.html +0 -379
  107. package/coverage/src/ExecutionConstants.ts.html +0 -121
  108. package/coverage/src/TaskGraphValidationError.ts.html +0 -130
  109. package/coverage/src/TaskGraphValidator.ts.html +0 -643
  110. package/coverage/src/TaskRunner.ts.html +0 -706
  111. package/coverage/src/TaskRunnerBuilder.ts.html +0 -337
  112. package/coverage/src/TaskRunnerExecutionConfig.ts.html +0 -154
  113. package/coverage/src/TaskStateManager.ts.html +0 -529
  114. package/coverage/src/WorkflowExecutor.ts.html +0 -712
  115. package/coverage/src/contracts/ErrorTypes.ts.html +0 -103
  116. package/coverage/src/contracts/RunnerEvents.ts.html +0 -217
  117. package/coverage/src/contracts/index.html +0 -131
  118. package/coverage/src/index.html +0 -236
  119. package/coverage/src/strategies/DryRunExecutionStrategy.ts.html +0 -178
  120. package/coverage/src/strategies/RetryingExecutionStrategy.ts.html +0 -373
  121. package/coverage/src/strategies/StandardExecutionStrategy.ts.html +0 -190
  122. package/coverage/src/strategies/index.html +0 -146
  123. package/openspec/changes/feat-task-metrics/tasks.md +0 -6
  124. package/test-report.xml +0 -299
@@ -1,210 +0,0 @@
1
- /* eslint-disable */
2
- var addSorting = (function() {
3
- 'use strict';
4
- var cols,
5
- currentSort = {
6
- index: 0,
7
- desc: false
8
- };
9
-
10
- // returns the summary table element
11
- function getTable() {
12
- return document.querySelector('.coverage-summary');
13
- }
14
- // returns the thead element of the summary table
15
- function getTableHeader() {
16
- return getTable().querySelector('thead tr');
17
- }
18
- // returns the tbody element of the summary table
19
- function getTableBody() {
20
- return getTable().querySelector('tbody');
21
- }
22
- // returns the th element for nth column
23
- function getNthColumn(n) {
24
- return getTableHeader().querySelectorAll('th')[n];
25
- }
26
-
27
- function onFilterInput() {
28
- const searchValue = document.getElementById('fileSearch').value;
29
- const rows = document.getElementsByTagName('tbody')[0].children;
30
-
31
- // Try to create a RegExp from the searchValue. If it fails (invalid regex),
32
- // it will be treated as a plain text search
33
- let searchRegex;
34
- try {
35
- searchRegex = new RegExp(searchValue, 'i'); // 'i' for case-insensitive
36
- } catch (error) {
37
- searchRegex = null;
38
- }
39
-
40
- for (let i = 0; i < rows.length; i++) {
41
- const row = rows[i];
42
- let isMatch = false;
43
-
44
- if (searchRegex) {
45
- // If a valid regex was created, use it for matching
46
- isMatch = searchRegex.test(row.textContent);
47
- } else {
48
- // Otherwise, fall back to the original plain text search
49
- isMatch = row.textContent
50
- .toLowerCase()
51
- .includes(searchValue.toLowerCase());
52
- }
53
-
54
- row.style.display = isMatch ? '' : 'none';
55
- }
56
- }
57
-
58
- // loads the search box
59
- function addSearchBox() {
60
- var template = document.getElementById('filterTemplate');
61
- var templateClone = template.content.cloneNode(true);
62
- templateClone.getElementById('fileSearch').oninput = onFilterInput;
63
- template.parentElement.appendChild(templateClone);
64
- }
65
-
66
- // loads all columns
67
- function loadColumns() {
68
- var colNodes = getTableHeader().querySelectorAll('th'),
69
- colNode,
70
- cols = [],
71
- col,
72
- i;
73
-
74
- for (i = 0; i < colNodes.length; i += 1) {
75
- colNode = colNodes[i];
76
- col = {
77
- key: colNode.getAttribute('data-col'),
78
- sortable: !colNode.getAttribute('data-nosort'),
79
- type: colNode.getAttribute('data-type') || 'string'
80
- };
81
- cols.push(col);
82
- if (col.sortable) {
83
- col.defaultDescSort = col.type === 'number';
84
- colNode.innerHTML =
85
- colNode.innerHTML + '<span class="sorter"></span>';
86
- }
87
- }
88
- return cols;
89
- }
90
- // attaches a data attribute to every tr element with an object
91
- // of data values keyed by column name
92
- function loadRowData(tableRow) {
93
- var tableCols = tableRow.querySelectorAll('td'),
94
- colNode,
95
- col,
96
- data = {},
97
- i,
98
- val;
99
- for (i = 0; i < tableCols.length; i += 1) {
100
- colNode = tableCols[i];
101
- col = cols[i];
102
- val = colNode.getAttribute('data-value');
103
- if (col.type === 'number') {
104
- val = Number(val);
105
- }
106
- data[col.key] = val;
107
- }
108
- return data;
109
- }
110
- // loads all row data
111
- function loadData() {
112
- var rows = getTableBody().querySelectorAll('tr'),
113
- i;
114
-
115
- for (i = 0; i < rows.length; i += 1) {
116
- rows[i].data = loadRowData(rows[i]);
117
- }
118
- }
119
- // sorts the table using the data for the ith column
120
- function sortByIndex(index, desc) {
121
- var key = cols[index].key,
122
- sorter = function(a, b) {
123
- a = a.data[key];
124
- b = b.data[key];
125
- return a < b ? -1 : a > b ? 1 : 0;
126
- },
127
- finalSorter = sorter,
128
- tableBody = document.querySelector('.coverage-summary tbody'),
129
- rowNodes = tableBody.querySelectorAll('tr'),
130
- rows = [],
131
- i;
132
-
133
- if (desc) {
134
- finalSorter = function(a, b) {
135
- return -1 * sorter(a, b);
136
- };
137
- }
138
-
139
- for (i = 0; i < rowNodes.length; i += 1) {
140
- rows.push(rowNodes[i]);
141
- tableBody.removeChild(rowNodes[i]);
142
- }
143
-
144
- rows.sort(finalSorter);
145
-
146
- for (i = 0; i < rows.length; i += 1) {
147
- tableBody.appendChild(rows[i]);
148
- }
149
- }
150
- // removes sort indicators for current column being sorted
151
- function removeSortIndicators() {
152
- var col = getNthColumn(currentSort.index),
153
- cls = col.className;
154
-
155
- cls = cls.replace(/ sorted$/, '').replace(/ sorted-desc$/, '');
156
- col.className = cls;
157
- }
158
- // adds sort indicators for current column being sorted
159
- function addSortIndicators() {
160
- getNthColumn(currentSort.index).className += currentSort.desc
161
- ? ' sorted-desc'
162
- : ' sorted';
163
- }
164
- // adds event listeners for all sorter widgets
165
- function enableUI() {
166
- var i,
167
- el,
168
- ithSorter = function ithSorter(i) {
169
- var col = cols[i];
170
-
171
- return function() {
172
- var desc = col.defaultDescSort;
173
-
174
- if (currentSort.index === i) {
175
- desc = !currentSort.desc;
176
- }
177
- sortByIndex(i, desc);
178
- removeSortIndicators();
179
- currentSort.index = i;
180
- currentSort.desc = desc;
181
- addSortIndicators();
182
- };
183
- };
184
- for (i = 0; i < cols.length; i += 1) {
185
- if (cols[i].sortable) {
186
- // add the click event handler on the th so users
187
- // dont have to click on those tiny arrows
188
- el = getNthColumn(i).querySelector('.sorter').parentElement;
189
- if (el.addEventListener) {
190
- el.addEventListener('click', ithSorter(i));
191
- } else {
192
- el.attachEvent('onclick', ithSorter(i));
193
- }
194
- }
195
- }
196
- }
197
- // adds sorting functionality to the UI
198
- return function() {
199
- if (!getTable()) {
200
- return;
201
- }
202
- cols = loadColumns();
203
- loadData();
204
- addSearchBox();
205
- addSortIndicators();
206
- enableUI();
207
- };
208
- })();
209
-
210
- window.addEventListener('load', addSorting);
@@ -1,379 +0,0 @@
1
-
2
- <!doctype html>
3
- <html lang="en">
4
-
5
- <head>
6
- <title>Code coverage report for src/EventBus.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> EventBus.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'>17/17</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'>8/8</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'>6/6</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'>17/17</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></td><td class="line-coverage quiet"><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-neutral">&nbsp;</span>
175
- <span class="cline-any cline-yes">92x</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">24x</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-yes">21x</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-yes">24x</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-neutral">&nbsp;</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">8x</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-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-neutral">&nbsp;</span>
218
- <span class="cline-any cline-neutral">&nbsp;</span>
219
- <span class="cline-any cline-neutral">&nbsp;</span>
220
- <span class="cline-any cline-neutral">&nbsp;</span>
221
- <span class="cline-any cline-neutral">&nbsp;</span>
222
- <span class="cline-any cline-yes">451x</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-yes">451x</span>
226
- <span class="cline-any cline-yes">19x</span>
227
- <span class="cline-any cline-neutral">&nbsp;</span>
228
- <span class="cline-any cline-neutral">&nbsp;</span>
229
- <span class="cline-any cline-neutral">&nbsp;</span>
230
- <span class="cline-any cline-yes">19x</span>
231
- <span class="cline-any cline-neutral">&nbsp;</span>
232
- <span class="cline-any cline-yes">19x</span>
233
- <span class="cline-any cline-yes">19x</span>
234
- <span class="cline-any cline-yes">19x</span>
235
- <span class="cline-any cline-neutral">&nbsp;</span>
236
- <span class="cline-any cline-yes">1x</span>
237
- <span class="cline-any cline-yes">1x</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">3x</span>
246
- <span class="cline-any cline-neutral">&nbsp;</span>
247
- <span class="cline-any cline-neutral">&nbsp;</span>
248
- <span class="cline-any cline-neutral">&nbsp;</span>
249
- <span class="cline-any cline-neutral">&nbsp;</span>
250
- <span class="cline-any cline-neutral">&nbsp;</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">1x</span>
254
- <span class="cline-any cline-neutral">&nbsp;</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-neutral">&nbsp;</span>
259
- <span class="cline-any cline-neutral">&nbsp;</span>
260
- <span class="cline-any cline-neutral">&nbsp;</span>
261
- <span class="cline-any cline-neutral">&nbsp;</span>
262
- <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import {
263
- ListenerMap,
264
- RunnerEventListener,
265
- RunnerEventPayloads,
266
- } from "./contracts/RunnerEvents.js";
267
- &nbsp;
268
- /**
269
- * Manages event subscriptions and emissions for the TaskRunner.
270
- * @template TContext The shape of the shared context object.
271
- */
272
- export class EventBus&lt;TContext&gt; {
273
- private listeners: ListenerMap&lt;TContext&gt; = {};
274
- &nbsp;
275
- /**
276
- * Subscribe to an event.
277
- * @param event The event name.
278
- * @param callback The callback to execute when the event is emitted.
279
- */
280
- public on&lt;K extends keyof RunnerEventPayloads&lt;TContext&gt;&gt;(
281
- event: K,
282
- callback: RunnerEventListener&lt;TContext, K&gt;
283
- ): void {
284
- if (!this.listeners[event]) {
285
- // Type assertion needed because TypeScript cannot verify that the generic K
286
- // matches the specific key in the mapped type during assignment.
287
- this.listeners[event] = new Set() as unknown as ListenerMap&lt;TContext&gt;[K];
288
- }
289
- // Type assertion needed to tell TS that this specific Set matches the callback type
290
- (this.listeners[event] as Set&lt;RunnerEventListener&lt;TContext, K&gt;&gt;).add(
291
- callback
292
- );
293
- }
294
- &nbsp;
295
- /**
296
- * Unsubscribe from an event.
297
- * @param event The event name.
298
- * @param callback The callback to remove.
299
- */
300
- public off&lt;K extends keyof RunnerEventPayloads&lt;TContext&gt;&gt;(
301
- event: K,
302
- callback: RunnerEventListener&lt;TContext, K&gt;
303
- ): void {
304
- if (this.listeners[event]) {
305
- (this.listeners[event] as Set&lt;RunnerEventListener&lt;TContext, K&gt;&gt;).delete(
306
- callback
307
- );
308
- }
309
- }
310
- &nbsp;
311
- /**
312
- * Emit an event to all subscribers.
313
- * @param event The event name.
314
- * @param data The payload for the event.
315
- */
316
- public emit&lt;K extends keyof RunnerEventPayloads&lt;TContext&gt;&gt;(
317
- event: K,
318
- data: RunnerEventPayloads&lt;TContext&gt;[K]
319
- ): void {
320
- const listeners = this.listeners[event] as
321
- | Set&lt;RunnerEventListener&lt;TContext, K&gt;&gt;
322
- | undefined;
323
- if (listeners) {
324
- for (const listener of listeners) {
325
- // We use Promise.resolve().then() to schedule the listener on the microtask queue,
326
- // ensuring the emit method remains non-blocking.
327
- // The final .catch() ensures that any errors in the promise infrastructure itself are logged.
328
- Promise.resolve()
329
- .then(() =&gt; {
330
- try {
331
- const result = listener(data);
332
- if (result instanceof Promise) {
333
- // Handle async listener rejections
334
- result.catch((error) =&gt; {
335
- console.error(
336
- `Error in event listener for ${String(event)}:`,
337
- error
338
- );
339
- });
340
- }
341
- } catch (error) {
342
- // Handle sync listener errors
343
- console.error(
344
- `Error in event listener for ${String(event)}:`,
345
- error
346
- );
347
- }
348
- })
349
- .catch((error) =&gt; {
350
- // detailed handling for the promise chain itself
351
- console.error(
352
- `Unexpected error in event bus execution for ${String(event)}:`,
353
- error
354
- );
355
- });
356
- }
357
- }
358
- }
359
- }
360
- &nbsp;</pre></td></tr></table></pre>
361
-
362
- <div class='push'></div><!-- for sticky footer -->
363
- </div><!-- /wrapper -->
364
- <div class='footer quiet pad2 space-top1 center small'>
365
- Code coverage generated by
366
- <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
367
- at 2026-01-21T21:46:28.723Z
368
- </div>
369
- <script src="../prettify.js"></script>
370
- <script>
371
- window.onload = function () {
372
- prettyPrint();
373
- };
374
- </script>
375
- <script src="../sorter.js"></script>
376
- <script src="../block-navigation.js"></script>
377
- </body>
378
- </html>
379
-