agent-steward 0.0.2 → 0.0.4

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 (263) hide show
  1. package/CHANGELOG.md +45 -2
  2. package/CROSS_PLATFORM.md +11 -9
  3. package/README.md +11 -10
  4. package/ROADMAP-STRATEGY.md +93 -44
  5. package/ROADMAP.md +148 -1017
  6. package/dist/core/cron-to-schtasks.d.ts +0 -8
  7. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  8. package/dist/core/cron-to-schtasks.js +11 -86
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +19 -2
  14. package/dist/core/file-watcher.js +9 -9
  15. package/dist/core/git-trigger.js +4 -4
  16. package/dist/core/lock.d.ts +20 -4
  17. package/dist/core/lock.d.ts.map +1 -1
  18. package/dist/core/lock.js +99 -26
  19. package/dist/core/one-shot.d.ts +31 -5
  20. package/dist/core/one-shot.d.ts.map +1 -1
  21. package/dist/core/one-shot.js +78 -10
  22. package/dist/core/opencode-cli.d.ts +28 -0
  23. package/dist/core/opencode-cli.d.ts.map +1 -0
  24. package/dist/core/opencode-cli.js +74 -0
  25. package/dist/core/opencode-models.d.ts +62 -0
  26. package/dist/core/opencode-models.d.ts.map +1 -0
  27. package/dist/core/opencode-models.js +277 -0
  28. package/dist/core/otel.js +2 -2
  29. package/dist/core/ps-wrapper.d.ts +1 -1
  30. package/dist/core/ps-wrapper.d.ts.map +1 -1
  31. package/dist/core/ps-wrapper.js +66 -36
  32. package/dist/core/record-history.d.ts +15 -0
  33. package/dist/core/record-history.d.ts.map +1 -1
  34. package/dist/core/record-history.js +78 -54
  35. package/dist/core/router/dispatch.d.ts +36 -0
  36. package/dist/core/router/dispatch.d.ts.map +1 -0
  37. package/dist/core/router/dispatch.js +59 -0
  38. package/dist/core/router/escalation.d.ts +47 -0
  39. package/dist/core/router/escalation.d.ts.map +1 -0
  40. package/dist/core/router/escalation.js +87 -0
  41. package/dist/core/router/planner.d.ts +53 -0
  42. package/dist/core/router/planner.d.ts.map +1 -0
  43. package/dist/core/router/planner.js +113 -0
  44. package/dist/core/router/rules.d.ts +46 -0
  45. package/dist/core/router/rules.d.ts.map +1 -0
  46. package/dist/core/router/rules.js +85 -0
  47. package/dist/core/run-panel-api.d.ts +94 -0
  48. package/dist/core/run-panel-api.d.ts.map +1 -0
  49. package/dist/core/run-panel-api.js +169 -0
  50. package/dist/core/schedule-gate.js +5 -1
  51. package/dist/core/schedule-v2.d.ts +36 -2
  52. package/dist/core/schedule-v2.d.ts.map +1 -1
  53. package/dist/core/schedule-v2.js +98 -12
  54. package/dist/core/scheduler/at-fallback.d.ts +95 -0
  55. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  56. package/dist/core/scheduler/at-fallback.js +200 -0
  57. package/dist/core/scheduler/linux.d.ts +13 -2
  58. package/dist/core/scheduler/linux.d.ts.map +1 -1
  59. package/dist/core/scheduler/linux.js +67 -13
  60. package/dist/core/scheduler/mac.d.ts +14 -8
  61. package/dist/core/scheduler/mac.d.ts.map +1 -1
  62. package/dist/core/scheduler/mac.js +71 -22
  63. package/dist/core/scheduler/posix.d.ts.map +1 -1
  64. package/dist/core/scheduler/posix.js +37 -2
  65. package/dist/core/scheduler/registry.d.ts +13 -0
  66. package/dist/core/scheduler/registry.d.ts.map +1 -1
  67. package/dist/core/scheduler/registry.js +83 -21
  68. package/dist/core/scheduler/run-now.d.ts +16 -0
  69. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  70. package/dist/core/scheduler/run-now.js +28 -0
  71. package/dist/core/scheduler/windows.d.ts +16 -3
  72. package/dist/core/scheduler/windows.d.ts.map +1 -1
  73. package/dist/core/scheduler/windows.js +249 -96
  74. package/dist/core/secrets.d.ts.map +1 -1
  75. package/dist/core/secrets.js +127 -30
  76. package/dist/core/self-analysis.js +55 -55
  77. package/dist/core/session.d.ts.map +1 -1
  78. package/dist/core/session.js +18 -11
  79. package/dist/core/summary.js +1 -1
  80. package/dist/core/task-name.d.ts +24 -0
  81. package/dist/core/task-name.d.ts.map +1 -0
  82. package/dist/core/task-name.js +40 -0
  83. package/dist/core/triage-chain.js +1 -1
  84. package/dist/core/triage-worker.js +2 -2
  85. package/dist/core/triage.js +1 -1
  86. package/dist/core/wrappers/bash.d.ts.map +1 -1
  87. package/dist/core/wrappers/bash.js +82 -37
  88. package/dist/db/capability-repo.d.ts +83 -0
  89. package/dist/db/capability-repo.d.ts.map +1 -0
  90. package/dist/db/capability-repo.js +182 -0
  91. package/dist/db/history-repo.d.ts +8 -0
  92. package/dist/db/history-repo.d.ts.map +1 -1
  93. package/dist/db/history-repo.js +19 -0
  94. package/dist/db/index.d.ts +6 -0
  95. package/dist/db/index.d.ts.map +1 -1
  96. package/dist/db/index.js +48 -2
  97. package/dist/db/migrate.d.ts.map +1 -1
  98. package/dist/db/migrate.js +3 -1
  99. package/dist/db/run-context.d.ts +103 -0
  100. package/dist/db/run-context.d.ts.map +1 -0
  101. package/dist/db/run-context.js +224 -0
  102. package/dist/db/run-dlq.d.ts +100 -0
  103. package/dist/db/run-dlq.d.ts.map +1 -0
  104. package/dist/db/run-dlq.js +191 -0
  105. package/dist/db/run-journal.d.ts +60 -0
  106. package/dist/db/run-journal.d.ts.map +1 -0
  107. package/dist/db/run-journal.js +143 -0
  108. package/dist/db/run-resume.d.ts +51 -0
  109. package/dist/db/run-resume.d.ts.map +1 -0
  110. package/dist/db/run-resume.js +156 -0
  111. package/dist/db/runs-repo.d.ts +128 -0
  112. package/dist/db/runs-repo.d.ts.map +1 -0
  113. package/dist/db/runs-repo.js +342 -0
  114. package/dist/db/schema.d.ts +16 -2
  115. package/dist/db/schema.d.ts.map +1 -1
  116. package/dist/db/schema.js +342 -35
  117. package/dist/db/settings-repo.d.ts +11 -0
  118. package/dist/db/settings-repo.d.ts.map +1 -1
  119. package/dist/db/settings-repo.js +25 -0
  120. package/dist/db/step-idempotency.d.ts +51 -0
  121. package/dist/db/step-idempotency.d.ts.map +1 -0
  122. package/dist/db/step-idempotency.js +136 -0
  123. package/dist/index.d.ts +5 -5
  124. package/dist/index.d.ts.map +1 -1
  125. package/dist/index.js +168 -40
  126. package/dist/notifications.js +18 -18
  127. package/dist/profiles.d.ts +7 -3
  128. package/dist/profiles.d.ts.map +1 -1
  129. package/dist/profiles.js +85 -7
  130. package/dist/rpc.d.ts +787 -0
  131. package/dist/rpc.d.ts.map +1 -1
  132. package/dist/rpc.js +324 -0
  133. package/dist/server.d.ts +33 -2
  134. package/dist/server.d.ts.map +1 -1
  135. package/dist/server.js +115 -54
  136. package/dist/shared/jobs-view.d.ts.map +1 -1
  137. package/dist/skill.js +1 -1
  138. package/dist/task-transfer.d.ts +1 -1
  139. package/dist/task-transfer.d.ts.map +1 -1
  140. package/dist/task-transfer.js +14 -10
  141. package/dist/types.d.ts +20 -4
  142. package/dist/types.d.ts.map +1 -1
  143. package/dist/types.js +44 -9
  144. package/dist/workspaces.d.ts +25 -3
  145. package/dist/workspaces.d.ts.map +1 -1
  146. package/dist/workspaces.js +44 -9
  147. package/docs/ARCHITECTURE.md +335 -9
  148. package/docs/COMPATIBILITY.md +10 -6
  149. package/docs/CONCEPT.md +183 -91
  150. package/docs/CROSS_PLATFORM.ru.md +11 -9
  151. package/docs/CROSS_PLATFORM.zh.md +11 -9
  152. package/docs/EXECUTION-LOOP.md +196 -0
  153. package/docs/FAQ.md +2 -2
  154. package/docs/FAQ.ru.md +2 -2
  155. package/docs/FAQ.zh.md +2 -2
  156. package/docs/FEATURES.md +5 -4
  157. package/docs/FEATURES.zh.md +5 -4
  158. package/docs/MIGRATION.md +34 -26
  159. package/docs/README.ru.md +27 -8
  160. package/docs/README.zh.md +11 -10
  161. package/docs/SAFETY.md +122 -0
  162. package/docs/SAVINGS.md +29 -0
  163. package/docs/SAVINGS.ru.md +29 -0
  164. package/docs/SAVINGS.zh.md +18 -0
  165. package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
  166. package/gui-experimental.cjs +8 -8
  167. package/index.js +1 -0
  168. package/locales/en.json +68 -0
  169. package/locales/ru.json +68 -0
  170. package/locales/zh.json +68 -0
  171. package/package.json +57 -11
  172. package/scripts/audit-bundle.mjs +215 -0
  173. package/src/core/analytics.ts +2 -2
  174. package/src/core/audit.ts +17 -17
  175. package/src/core/cron-to-schtasks.ts +14 -93
  176. package/src/core/dlq-api.ts +98 -0
  177. package/src/core/dry-run.ts +51 -27
  178. package/src/core/file-watcher.ts +17 -17
  179. package/src/core/git-trigger.ts +9 -9
  180. package/src/core/glob.ts +1 -1
  181. package/src/core/local-ai.ts +2 -2
  182. package/src/core/lock.ts +104 -31
  183. package/src/core/matrix.ts +31 -31
  184. package/src/core/native-notify.ts +2 -2
  185. package/src/core/one-shot.ts +91 -13
  186. package/src/core/opencode-cli.ts +103 -0
  187. package/src/core/opencode-models.ts +315 -0
  188. package/src/core/otel.ts +4 -4
  189. package/src/core/permissions.ts +5 -5
  190. package/src/core/prometheus.ts +17 -17
  191. package/src/core/ps-wrapper.ts +68 -38
  192. package/src/core/record-history.ts +114 -76
  193. package/src/core/retention.ts +3 -3
  194. package/src/core/router/dispatch.ts +94 -0
  195. package/src/core/router/escalation.ts +129 -0
  196. package/src/core/router/planner.ts +166 -0
  197. package/src/core/router/rules.ts +109 -0
  198. package/src/core/run-panel-api.ts +262 -0
  199. package/src/core/savings.ts +1 -1
  200. package/src/core/schedule-gate.ts +17 -13
  201. package/src/core/schedule-v2.ts +138 -29
  202. package/src/core/scheduler/at-fallback.ts +298 -0
  203. package/src/core/scheduler/index.ts +3 -3
  204. package/src/core/scheduler/linux.ts +92 -19
  205. package/src/core/scheduler/logs.ts +1 -1
  206. package/src/core/scheduler/mac.ts +112 -60
  207. package/src/core/scheduler/posix.ts +35 -2
  208. package/src/core/scheduler/registry.ts +109 -26
  209. package/src/core/scheduler/run-now.ts +32 -0
  210. package/src/core/scheduler/windows.ts +295 -125
  211. package/src/core/secrets.ts +139 -39
  212. package/src/core/self-analysis.ts +61 -61
  213. package/src/core/session.ts +26 -13
  214. package/src/core/structured-log.ts +3 -3
  215. package/src/core/summary.ts +25 -25
  216. package/src/core/task-name.ts +67 -0
  217. package/src/core/telegram.ts +16 -16
  218. package/src/core/triage-chain.ts +4 -4
  219. package/src/core/triage-compare.ts +8 -8
  220. package/src/core/triage-rules.ts +4 -4
  221. package/src/core/triage-shadow.ts +7 -7
  222. package/src/core/triage-worker.ts +6 -6
  223. package/src/core/triage.ts +23 -23
  224. package/src/core/watch-paths.ts +1 -1
  225. package/src/core/wrappers/bash.ts +90 -45
  226. package/src/db/capability-repo.ts +285 -0
  227. package/src/db/git-state-repo.ts +1 -1
  228. package/src/db/history-repo.ts +44 -22
  229. package/src/db/index.ts +53 -7
  230. package/src/db/metrics-repo.ts +10 -10
  231. package/src/db/migrate.ts +13 -11
  232. package/src/db/recovery.ts +3 -3
  233. package/src/db/run-context.ts +370 -0
  234. package/src/db/run-dlq.ts +310 -0
  235. package/src/db/run-journal.ts +212 -0
  236. package/src/db/run-resume.ts +256 -0
  237. package/src/db/runs-repo.ts +504 -0
  238. package/src/db/schema.ts +357 -44
  239. package/src/db/settings-repo.ts +33 -2
  240. package/src/db/step-idempotency.ts +185 -0
  241. package/src/db/tasks-repo.ts +10 -10
  242. package/src/db/templates-repo.ts +7 -7
  243. package/src/gui.tsx +516 -1
  244. package/src/history.ts +4 -4
  245. package/src/i18n.ts +7 -7
  246. package/src/index.ts +465 -308
  247. package/src/integrations.ts +6 -6
  248. package/src/notifications.ts +76 -76
  249. package/src/profiles.ts +98 -7
  250. package/src/rpc.ts +347 -1
  251. package/src/schtasks.ts +2 -2
  252. package/src/server.ts +155 -78
  253. package/src/settings.ts +44 -44
  254. package/src/shared/jobs-view.ts +60 -60
  255. package/src/skill.ts +1 -1
  256. package/src/task-transfer.ts +58 -56
  257. package/src/templates.ts +1 -1
  258. package/src/types.ts +54 -10
  259. package/src/workspaces.ts +73 -24
  260. package/dist/core/self-analysis.test.d.ts +0 -2
  261. package/dist/core/self-analysis.test.d.ts.map +0 -1
  262. package/dist/core/self-analysis.test.js +0 -219
  263. package/dist/gui-experimental.cjs +0 -1
@@ -4,14 +4,6 @@ import type { CronConversion } from "../types.js";
4
4
  * Возвращает CronConversion или выбрасывает Error с понятным сообщением.
5
5
  */
6
6
  export declare function convertCronToSchTasks(cron: string): CronConversion;
7
- /**
8
- * Вычисляет ближайшее прошедшее (<= now) время срабатывания для поддерживаемых
9
- * cron-выражений. Нужно для восстановления пропущенных запусков (catch-up):
10
- * сравнивая это время с историей, можно понять, выполнялась ли задача.
11
- *
12
- * Возвращает null, если выражение не поддерживается или не распознано.
13
- */
14
- export declare function previousRunTime(cron: string, now?: Date): Date | null;
15
7
  /**
16
8
  * Формирует массив флагов расписания для schtasks на основе CronConversion.
17
9
  * Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
@@ -1 +1 @@
1
- {"version":3,"file":"cron-to-schtasks.d.ts","sourceRoot":"","sources":["../../src/core/cron-to-schtasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgElD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAsHlE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,GAAG,IAAI,CA4EjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,EAAE,CAUvE"}
1
+ {"version":3,"file":"cron-to-schtasks.d.ts","sourceRoot":"","sources":["../../src/core/cron-to-schtasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgElD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA4HlE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,EAAE,CAUvE"}
@@ -40,7 +40,7 @@ function isStar(value) {
40
40
  * Возвращает N или undefined.
41
41
  */
42
42
  function parseStep(value) {
43
- const match = value.match(/^\*\/(\d+)$/);
43
+ const match = /^\*\/(\d+)$/.exec(value);
44
44
  if (!match)
45
45
  return undefined;
46
46
  const n = parseInt(match[1], 10);
@@ -93,10 +93,12 @@ export function convertCronToSchTasks(cron) {
93
93
  " минут превышает максимально допустимый для schtasks (1439 минут).\n\n" +
94
94
  UNSUPPORTED_ERROR);
95
95
  }
96
- // schtasks /mo N запускает задачу каждые N минут начиная с момента создания
97
- // задачи, а cron */N — в минуты 0, N, 2N внутри каждого часа. Семантики
98
- // совпадают только когда N делит 60 без остатка; иначе отдаём задачу в
99
- // минутный опрос с gate во враппере (needsPollMode).
96
+ // schtasks /mo Nanchors на момент создания задачи, а cron */N означает
97
+ // минуты 0, N, 2N … внутри часа. Семантики совпадают только когда N
98
+ // делит 60 без остатка И есть выровненный старт (00:00), поэтому ниже
99
+ // добавляется startTime: "00:00". Для N, не делящих 60, выбрасывается
100
+ // ошибка — задача уходит в минутный опрос с gate во враппере
101
+ // (needsPollMode в windows.ts), а не конвертируется здесь нативно.
100
102
  if (60 % stepN !== 0) {
101
103
  throw new Error("Интервал */" +
102
104
  stepN +
@@ -106,6 +108,10 @@ export function convertCronToSchTasks(cron) {
106
108
  return {
107
109
  sc: "MINUTE",
108
110
  extraFlags: ["/mo", String(stepN)],
111
+ // schtasks /mo Nanchors на момент создания задачи; cron */N означает
112
+ // минуты 0, N, 2N … внутри часа. Выровненный старт 00:00 делает
113
+ // расписание идентичным cron для любого N, делящего 60.
114
+ startTime: "00:00",
109
115
  };
110
116
  }
111
117
  // --- ПАТТЕРН 3: M * * * * -> HOURLY /mo 1 /st 00:MM (каждый час в минуту M) ---
@@ -155,87 +161,6 @@ export function convertCronToSchTasks(cron) {
155
161
  // Ни один поддерживаемый паттерн не совпал.
156
162
  throw new Error(UNSUPPORTED_ERROR);
157
163
  }
158
- /**
159
- * Вычисляет ближайшее прошедшее (<= now) время срабатывания для поддерживаемых
160
- * cron-выражений. Нужно для восстановления пропущенных запусков (catch-up):
161
- * сравнивая это время с историей, можно понять, выполнялась ли задача.
162
- *
163
- * Возвращает null, если выражение не поддерживается или не распознано.
164
- */
165
- export function previousRunTime(cron, now = new Date()) {
166
- const fields = cron.trim().split(/\s+/);
167
- if (fields.length !== 5)
168
- return null;
169
- const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
170
- const star = (value) => value === "*";
171
- const intIn = (value, min, max) => {
172
- if (!/^\d+$/.test(value))
173
- return undefined;
174
- const n = parseInt(value, 10);
175
- return n >= min && n <= max ? n : undefined;
176
- };
177
- const nowMs = now.getTime();
178
- // * * * * * — каждую минуту: последняя граница минуты.
179
- if (star(minute) && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
180
- return new Date(Math.floor(nowMs / 60000) * 60000);
181
- }
182
- // */N * * * * — каждые N минут внутри часа (минуты 0, N, 2N...).
183
- const step = /^\*\/(\d+)$/.exec(minute);
184
- if (step && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
185
- const n = parseInt(step[1], 10);
186
- if (n > 0) {
187
- const result = new Date(now);
188
- result.setSeconds(0, 0);
189
- const minuteOfHour = result.getMinutes();
190
- result.setMinutes(n >= 60 ? 0 : minuteOfHour - (minuteOfHour % n));
191
- return result;
192
- }
193
- return null;
194
- }
195
- // M * * * * — каждый час в минуту M.
196
- const hourlyMinute = intIn(minute, 0, 59);
197
- if (hourlyMinute !== undefined &&
198
- star(hour) &&
199
- star(dayOfMonth) &&
200
- star(month) &&
201
- star(dayOfWeek)) {
202
- const result = new Date(now);
203
- result.setSeconds(0, 0);
204
- result.setMinutes(hourlyMinute);
205
- if (result.getTime() > nowMs)
206
- result.setHours(result.getHours() - 1);
207
- return result;
208
- }
209
- const m = intIn(minute, 0, 59);
210
- const h = intIn(hour, 0, 23);
211
- if (m === undefined || h === undefined || !star(dayOfMonth) || !star(month)) {
212
- return null;
213
- }
214
- // M H * * * — ежедневно в HH:MM.
215
- if (star(dayOfWeek)) {
216
- const result = new Date(now);
217
- result.setSeconds(0, 0);
218
- result.setHours(h, m, 0, 0);
219
- if (result.getTime() > nowMs)
220
- result.setDate(result.getDate() - 1);
221
- return result;
222
- }
223
- // M H * * D — еженедельно в день D (0 и 7 — воскресенье) в HH:MM.
224
- const dow = intIn(dayOfWeek, 0, 7);
225
- if (dow === undefined)
226
- return null;
227
- const targetDow = dow === 7 ? 0 : dow;
228
- const result = new Date(now);
229
- result.setSeconds(0, 0);
230
- result.setHours(h, m, 0, 0);
231
- // Не больше 8 итераций: одна неделя гарантированно содержит нужный день.
232
- for (let i = 0; i <= 8; i += 1) {
233
- if (result.getTime() <= nowMs && result.getDay() === targetDow)
234
- return result;
235
- result.setDate(result.getDate() - 1);
236
- }
237
- return null;
238
- }
239
164
  /**
240
165
  * Формирует массив флагов расписания для schtasks на основе CronConversion.
241
166
  * Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
@@ -0,0 +1,44 @@
1
+ /**
2
+ * GUI/RPC-фасад над dead-letter queue (Спринт 36.6).
3
+ *
4
+ * Тонкий слой между `src/db/run-dlq.ts` и RPC: приводит вход от GUI к
5
+ * безопасным значениям (статус, лимит), не даёт панике БД выйти наружу и
6
+ * возвращает единый `{ success, error }`-контракт. Логика очереди (идемпотентный
7
+ * enqueue, retry через reopenRun, discard) остаётся в БД-слое.
8
+ *
9
+ * Retry здесь только готовит шаг к повторному выполнению: переоткрывает запуск,
10
+ * переводит шаг в `running` и закрывает запись DLQ. Сам обработчик шага
11
+ * запускает resume (Спринт 36.7), поэтому фасад не притворяется, что шаг уже
12
+ * выполнен.
13
+ */
14
+ import { type DlqEntry, type DlqStatus } from "../db/run-dlq.js";
15
+ /** Фильтр списка: конкретный статус или все записи. */
16
+ export type DlqFilter = DlqStatus | "all";
17
+ export interface DlqListResult {
18
+ success: boolean;
19
+ entries: DlqEntry[];
20
+ /** Сколько записей открыто (для бейджа в заголовке панели). */
21
+ open: number;
22
+ error?: string;
23
+ }
24
+ export interface DlqActionResult {
25
+ success: boolean;
26
+ error?: string;
27
+ entry?: DlqEntry;
28
+ runId?: string;
29
+ stepName?: string;
30
+ /** true, если retry переоткрыл упавший запуск. */
31
+ runReopened?: boolean;
32
+ }
33
+ /** Неизвестный статус трактуем как `open`: безопасный дефолт очереди. */
34
+ export declare function normalizeDlqFilter(value: unknown): DlqFilter;
35
+ /** Список записей DLQ и счётчик открытых. */
36
+ export declare function listDlq(options?: {
37
+ status?: unknown;
38
+ limit?: unknown;
39
+ }): DlqListResult;
40
+ /** Ручной retry: готовит шаг к выполнению и закрывает запись DLQ. */
41
+ export declare function retryDlq(id: string): DlqActionResult;
42
+ /** Осознанный отказ от повтора: запись закрывается, шаг остаётся failed. */
43
+ export declare function discardDlq(id: string, resolution?: string): DlqActionResult;
44
+ //# sourceMappingURL=dlq-api.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dlq-api.d.ts","sourceRoot":"","sources":["../../src/core/dlq-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC;AAE1B,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAI5D;AAQD,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,CAW1F;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAapD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,SAAc,GAAG,eAAe,CAMhF"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * GUI/RPC-фасад над dead-letter queue (Спринт 36.6).
3
+ *
4
+ * Тонкий слой между `src/db/run-dlq.ts` и RPC: приводит вход от GUI к
5
+ * безопасным значениям (статус, лимит), не даёт панике БД выйти наружу и
6
+ * возвращает единый `{ success, error }`-контракт. Логика очереди (идемпотентный
7
+ * enqueue, retry через reopenRun, discard) остаётся в БД-слое.
8
+ *
9
+ * Retry здесь только готовит шаг к повторному выполнению: переоткрывает запуск,
10
+ * переводит шаг в `running` и закрывает запись DLQ. Сам обработчик шага
11
+ * запускает resume (Спринт 36.7), поэтому фасад не притворяется, что шаг уже
12
+ * выполнен.
13
+ */
14
+ import { countDeadLetters, discardDeadLetter, listDeadLetters, retryDeadLetter, } from "../db/run-dlq.js";
15
+ function errorText(err) {
16
+ return err instanceof Error ? err.message : String(err);
17
+ }
18
+ /** Неизвестный статус трактуем как `open`: безопасный дефолт очереди. */
19
+ export function normalizeDlqFilter(value) {
20
+ return value === "all" || value === "retried" || value === "discarded" || value === "open"
21
+ ? value
22
+ : "open";
23
+ }
24
+ function normalizeLimit(value, fallback = 100) {
25
+ const num = Math.floor(Number(value));
26
+ if (!Number.isFinite(num) || num < 1)
27
+ return fallback;
28
+ return Math.min(num, 500);
29
+ }
30
+ /** Список записей DLQ и счётчик открытых. */
31
+ export function listDlq(options = {}) {
32
+ try {
33
+ const status = normalizeDlqFilter(options.status);
34
+ return {
35
+ success: true,
36
+ entries: listDeadLetters({ status, limit: normalizeLimit(options.limit) }),
37
+ open: countDeadLetters("open"),
38
+ };
39
+ }
40
+ catch (err) {
41
+ return { success: false, entries: [], open: 0, error: errorText(err) };
42
+ }
43
+ }
44
+ /** Ручной retry: готовит шаг к выполнению и закрывает запись DLQ. */
45
+ export function retryDlq(id) {
46
+ try {
47
+ const result = retryDeadLetter(id);
48
+ return {
49
+ success: true,
50
+ entry: result.entry,
51
+ runId: result.run.id,
52
+ stepName: result.step.stepName,
53
+ runReopened: result.runReopened,
54
+ };
55
+ }
56
+ catch (err) {
57
+ return { success: false, error: errorText(err) };
58
+ }
59
+ }
60
+ /** Осознанный отказ от повтора: запись закрывается, шаг остаётся failed. */
61
+ export function discardDlq(id, resolution = "discarded") {
62
+ try {
63
+ return { success: true, entry: discardDeadLetter(id, resolution) };
64
+ }
65
+ catch (err) {
66
+ return { success: false, error: errorText(err) };
67
+ }
68
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;IAChE,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IACF,gDAAgD;IAChD,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,oCAAoC;IACpC,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,eAAe,CAAC,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,iEAAiE;IACjE,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,4EAA4E;AAC5E,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AA6KtD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAkT9E"}
1
+ {"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;IAChE,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IACF,gDAAgD;IAChD,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,oCAAoC;IACpC,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,eAAe,CAAC,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,iEAAiE;IACjE,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,4EAA4E;AAC5E,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AAqMtD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAkT9E"}
@@ -10,7 +10,7 @@ import { loadTaskDefinitions } from "../task-transfer.js";
10
10
  import { getHistory } from "../db/history-repo.js";
11
11
  import { getWorkspace } from "../workspaces.js";
12
12
  import { expandMatrixTask } from "./matrix.js";
13
- import { nextRun, activeWindowState } from "./schedule-v2.js";
13
+ import { nextRun, activeWindowState, assessCronWindowFeasibility, windowFeasibilityReasonText } from "./schedule-v2.js";
14
14
  import { checkGitTrigger } from "./git-trigger.js";
15
15
  import { t } from "../i18n.js";
16
16
  /** Сколько последних успешных/любых запусков усредняем для оценки. */
@@ -90,7 +90,7 @@ async function describeTrigger(opts) {
90
90
  }
91
91
  case "mcp-event": {
92
92
  const ev = def.mcpEvent;
93
- base.explanation = ev && ev.event
93
+ base.explanation = ev?.event
94
94
  ? t("dryRun.mcp.event", {
95
95
  server: ev.server,
96
96
  event: ev.event,
@@ -153,6 +153,23 @@ async function describeTrigger(opts) {
153
153
  reason: state.reason ?? t("dryRun.window.outside"),
154
154
  }));
155
155
  }
156
+ // P2-24: даже если сейчас окно откроется, cron может никогда в него не
157
+ // попадать (например, daily 09:00 при окне 22:00–06:00). Предупреждаем
158
+ // заранее — иначе задача молча не выполняется из-за лимита переноса 12 ч.
159
+ if ((def.triggerType ?? "cron") === "cron" && def.schedule) {
160
+ const feasibility = assessCronWindowFeasibility(def.schedule, {
161
+ notBefore: def.notBefore ?? undefined,
162
+ notAfter: def.notAfter ?? undefined,
163
+ days: def.activeDays ?? undefined,
164
+ timeZone: def.timezone ?? undefined,
165
+ }, policy);
166
+ if (!feasibility.feasible) {
167
+ warnings.push(t("dryRun.window.unreachable", {
168
+ cron: def.schedule,
169
+ reason: windowFeasibilityReasonText(feasibility.reason),
170
+ }));
171
+ }
172
+ }
156
173
  }
157
174
  return base;
158
175
  }
@@ -52,11 +52,11 @@ export class FileWatchManager {
52
52
  // Защита от legacy-записей и ручного редактирования БД: не запускаем
53
53
  // watcher на путях с управляющими символами или выходом через `..`.
54
54
  if (hasPathControlChars(d.path)) {
55
- console.error(`[windows-scheduler] Задача "${d.name}": путь наблюдения содержит управляющие символы — пропущен.`);
55
+ console.error(`[agent-steward] Задача "${d.name}": путь наблюдения содержит управляющие символы — пропущен.`);
56
56
  return false;
57
57
  }
58
58
  if (!isAbsolute(d.path) && d.path.split(/[\\/]/).includes("..")) {
59
- console.error(`[windows-scheduler] Задача "${d.name}": относительный путь наблюдения выходит за рабочую директорию — пропущен.`);
59
+ console.error(`[agent-steward] Задача "${d.name}": относительный путь наблюдения выходит за рабочую директорию — пропущен.`);
60
60
  return false;
61
61
  }
62
62
  return true;
@@ -106,7 +106,7 @@ export class FileWatchManager {
106
106
  });
107
107
  }
108
108
  catch (err) {
109
- console.error(`[windows-scheduler] Не удалось начать отслеживание "${watchPath}" для задачи "${name}": ${err instanceof Error ? err.message : String(err)}`);
109
+ console.error(`[agent-steward] Не удалось начать отслеживание "${watchPath}" для задачи "${name}": ${err instanceof Error ? err.message : String(err)}`);
110
110
  return;
111
111
  }
112
112
  const entry = {
@@ -142,14 +142,14 @@ export class FileWatchManager {
142
142
  return;
143
143
  try {
144
144
  const result = this.handler(name, changedPath);
145
- if (result && typeof result.catch === "function") {
146
- result.catch((err) => {
147
- console.error(`[windows-scheduler] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
145
+ if (result && typeof (result).catch === "function") {
146
+ (result).catch((err) => {
147
+ console.error(`[agent-steward] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
148
148
  });
149
149
  }
150
150
  }
151
151
  catch (err) {
152
- console.error(`[windows-scheduler] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
152
+ console.error(`[agent-steward] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
153
153
  }
154
154
  }, this.debounceMs);
155
155
  // Таймер не должен удерживать процесс, если хост завершается.
@@ -162,10 +162,10 @@ export class FileWatchManager {
162
162
  watcher.on("add", onChange);
163
163
  watcher.on("unlink", onChange);
164
164
  watcher.on("error", (err) => {
165
- console.error(`[windows-scheduler] Ошибка наблюдения за "${watchPath}" (задача "${name}"): ${err?.message ?? String(err)}`);
165
+ console.error(`[agent-steward] Ошибка наблюдения за "${watchPath}" (задача "${name}"): ${err?.message ?? String(err)}`);
166
166
  });
167
167
  this.entries.set(name.toLowerCase(), entry);
168
- console.log(`[windows-scheduler] Слежу за "${watchPath}" — задача "${name}" запускается при изменении файла.`);
168
+ console.log(`[agent-steward] Слежу за "${watchPath}" — задача "${name}" запускается при изменении файла.`);
169
169
  }
170
170
  async remove(key) {
171
171
  const entry = this.entries.get(key);
@@ -22,7 +22,7 @@ export const GIT_COMMAND_TIMEOUT_MS = 10000;
22
22
  const defaultRunner = (cwd, args) => new Promise((resolve, reject) => {
23
23
  execFile("git", ["-C", cwd, ...args], { timeout: GIT_COMMAND_TIMEOUT_MS, windowsHide: true, maxBuffer: 4 * 1024 * 1024 }, (err, stdout) => {
24
24
  if (err) {
25
- reject(err);
25
+ reject(err instanceof Error ? err : new Error(String(err)));
26
26
  return;
27
27
  }
28
28
  resolve(String(stdout ?? ""));
@@ -73,7 +73,7 @@ export async function gitChangedFiles(cwd, from, to, run = defaultRunner) {
73
73
  .filter(Boolean);
74
74
  }
75
75
  function branchMatches(branch, pattern) {
76
- if (!pattern || !pattern.trim())
76
+ if (!pattern?.trim())
77
77
  return true;
78
78
  if (!branch)
79
79
  return false;
@@ -280,11 +280,11 @@ export class GitTriggerManager {
280
280
  await this.handler(managed.def.name, { ...result, cwd: cwdOf(managed.def) });
281
281
  }
282
282
  else if (result.status === "error") {
283
- console.error(`[windows-scheduler] git-триггер «${managed.def.name}»: ${result.message}`);
283
+ console.error(`[agent-steward] git-триггер «${managed.def.name}»: ${result.message}`);
284
284
  }
285
285
  }
286
286
  catch (err) {
287
- console.error(`[windows-scheduler] git-триггер «${managed.def.name}»: ${err instanceof Error ? err.message : String(err)}`);
287
+ console.error(`[agent-steward] git-триггер «${managed.def.name}»: ${err instanceof Error ? err.message : String(err)}`);
288
288
  }
289
289
  finally {
290
290
  managed.busy = false;
@@ -1,3 +1,12 @@
1
+ /**
2
+ * Проверяет, жив ли процесс-владелец lock-файла.
3
+ *
4
+ * `process.kill(pid, 0)` не посылает сигнал, а только проверяет существование.
5
+ * EPERM означает, что процесс есть, но у нас нет прав на сигнал — считаем живым.
6
+ * Остальные ошибки трактуем консервативно как «жив», чтобы не вытеснить
7
+ * чужую критическую секцию.
8
+ */
9
+ export declare function isProcessAlive(pid: number): boolean;
1
10
  /**
2
11
  * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
3
12
  *
@@ -22,15 +31,22 @@ export declare class LockManager {
22
31
  initialize(): Promise<void>;
23
32
  /**
24
33
  * Пытается захватить блокировку для задачи.
25
- * Возвращает true, если блокировка захвачена (файл создан).
26
- * Возвращает false, если блокировка уже удерживается другим запуском.
34
+ * Возвращает уникальный токен владельца (он же содержимое lock-файла) или
35
+ * null, если блокировка уже удерживается другим запуском.
36
+ *
37
+ * Токен нужен release(): процесс, чей lock был вытеснен по stale-таймауту,
38
+ * не должен удалять файл нового владельца.
27
39
  */
28
- acquire(taskName: string): Promise<boolean>;
40
+ acquire(taskName: string): Promise<string | null>;
29
41
  /**
30
42
  * Освобождает блокировку задачи (удаляет lock-файл).
43
+ *
44
+ * Удаляет файл только если в нём лежит токен этого владельца. Если lock
45
+ * успели вытеснить и перехватить, release ничего не трогает и возвращает
46
+ * false — иначе старый процесс снёс бы чужую критическую секцию.
31
47
  * Не выбрасывает ошибку, если файл уже удалён.
32
48
  */
33
- release(taskName: string): Promise<void>;
49
+ release(taskName: string, token: string): Promise<boolean>;
34
50
  /**
35
51
  * Проверяет, удерживается ли блокировка задачей в данный момент.
36
52
  */
@@ -1 +1 @@
1
- {"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAiB;IAItC,iCAAiC;IACjC,OAAO,CAAC,YAAY;IAIpB,uCAAuC;IACvC,OAAO,CAAC,YAAY;IAIpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDjC;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBjD;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC,CAAC,CAAC,CA4CZ"}
1
+ {"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAWD;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAiB;IAItC,iCAAiC;IACjC,OAAO,CAAC,YAAY;IAIpB,uCAAuC;IACvC,OAAO,CAAC,YAAY;IAIpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgEjC;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBvD;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBhE;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC,CAAC,CAAC,CAuDZ"}