agent-steward 0.0.3 → 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 (171) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +3 -3
  3. package/ROADMAP-STRATEGY.md +9 -9
  4. package/ROADMAP.md +50 -34
  5. package/dist/core/dlq-api.d.ts +44 -0
  6. package/dist/core/dlq-api.d.ts.map +1 -0
  7. package/dist/core/dlq-api.js +68 -0
  8. package/dist/core/dry-run.d.ts.map +1 -1
  9. package/dist/core/dry-run.js +18 -1
  10. package/dist/core/lock.d.ts +20 -4
  11. package/dist/core/lock.d.ts.map +1 -1
  12. package/dist/core/lock.js +97 -22
  13. package/dist/core/one-shot.d.ts +5 -1
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +33 -8
  16. package/dist/core/opencode-cli.d.ts +28 -0
  17. package/dist/core/opencode-cli.d.ts.map +1 -0
  18. package/dist/core/opencode-cli.js +74 -0
  19. package/dist/core/opencode-models.d.ts +62 -0
  20. package/dist/core/opencode-models.d.ts.map +1 -0
  21. package/dist/core/opencode-models.js +277 -0
  22. package/dist/core/ps-wrapper.d.ts +1 -1
  23. package/dist/core/ps-wrapper.d.ts.map +1 -1
  24. package/dist/core/ps-wrapper.js +11 -1
  25. package/dist/core/record-history.d.ts +15 -0
  26. package/dist/core/record-history.d.ts.map +1 -1
  27. package/dist/core/record-history.js +56 -32
  28. package/dist/core/router/dispatch.d.ts +36 -0
  29. package/dist/core/router/dispatch.d.ts.map +1 -0
  30. package/dist/core/router/dispatch.js +59 -0
  31. package/dist/core/router/escalation.d.ts +47 -0
  32. package/dist/core/router/escalation.d.ts.map +1 -0
  33. package/dist/core/router/escalation.js +87 -0
  34. package/dist/core/router/planner.d.ts +53 -0
  35. package/dist/core/router/planner.d.ts.map +1 -0
  36. package/dist/core/router/planner.js +113 -0
  37. package/dist/core/router/rules.d.ts +46 -0
  38. package/dist/core/router/rules.d.ts.map +1 -0
  39. package/dist/core/router/rules.js +85 -0
  40. package/dist/core/run-panel-api.d.ts +94 -0
  41. package/dist/core/run-panel-api.d.ts.map +1 -0
  42. package/dist/core/run-panel-api.js +169 -0
  43. package/dist/core/schedule-gate.js +5 -1
  44. package/dist/core/schedule-v2.d.ts +34 -0
  45. package/dist/core/schedule-v2.d.ts.map +1 -1
  46. package/dist/core/schedule-v2.js +91 -5
  47. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  48. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  49. package/dist/core/scheduler/at-fallback.js +135 -5
  50. package/dist/core/scheduler/linux.d.ts +10 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +29 -11
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +25 -1
  55. package/dist/core/scheduler/registry.d.ts +11 -0
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +83 -21
  58. package/dist/core/scheduler/run-now.d.ts +16 -0
  59. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  60. package/dist/core/scheduler/run-now.js +28 -0
  61. package/dist/core/secrets.d.ts.map +1 -1
  62. package/dist/core/secrets.js +125 -28
  63. package/dist/core/session.d.ts.map +1 -1
  64. package/dist/core/session.js +18 -11
  65. package/dist/core/task-name.d.ts +24 -0
  66. package/dist/core/task-name.d.ts.map +1 -0
  67. package/dist/core/task-name.js +40 -0
  68. package/dist/core/wrappers/bash.d.ts.map +1 -1
  69. package/dist/core/wrappers/bash.js +49 -4
  70. package/dist/db/capability-repo.d.ts +83 -0
  71. package/dist/db/capability-repo.d.ts.map +1 -0
  72. package/dist/db/capability-repo.js +182 -0
  73. package/dist/db/history-repo.d.ts +8 -0
  74. package/dist/db/history-repo.d.ts.map +1 -1
  75. package/dist/db/history-repo.js +19 -0
  76. package/dist/db/index.d.ts +4 -0
  77. package/dist/db/index.d.ts.map +1 -1
  78. package/dist/db/index.js +39 -1
  79. package/dist/db/migrate.d.ts.map +1 -1
  80. package/dist/db/migrate.js +3 -1
  81. package/dist/db/run-context.d.ts +103 -0
  82. package/dist/db/run-context.d.ts.map +1 -0
  83. package/dist/db/run-context.js +224 -0
  84. package/dist/db/run-dlq.d.ts +100 -0
  85. package/dist/db/run-dlq.d.ts.map +1 -0
  86. package/dist/db/run-dlq.js +191 -0
  87. package/dist/db/run-resume.d.ts +5 -2
  88. package/dist/db/run-resume.d.ts.map +1 -1
  89. package/dist/db/run-resume.js +30 -11
  90. package/dist/db/runs-repo.d.ts +13 -5
  91. package/dist/db/runs-repo.d.ts.map +1 -1
  92. package/dist/db/runs-repo.js +28 -5
  93. package/dist/db/schema.d.ts +2 -2
  94. package/dist/db/schema.d.ts.map +1 -1
  95. package/dist/db/schema.js +154 -2
  96. package/dist/db/settings-repo.d.ts +11 -0
  97. package/dist/db/settings-repo.d.ts.map +1 -1
  98. package/dist/db/settings-repo.js +25 -0
  99. package/dist/db/step-idempotency.d.ts +51 -0
  100. package/dist/db/step-idempotency.d.ts.map +1 -0
  101. package/dist/db/step-idempotency.js +136 -0
  102. package/dist/index.d.ts +4 -4
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.js +102 -4
  105. package/dist/rpc.d.ts +678 -0
  106. package/dist/rpc.d.ts.map +1 -1
  107. package/dist/rpc.js +235 -0
  108. package/dist/server.d.ts +31 -0
  109. package/dist/server.d.ts.map +1 -1
  110. package/dist/server.js +95 -35
  111. package/dist/types.d.ts.map +1 -1
  112. package/dist/types.js +7 -0
  113. package/dist/workspaces.d.ts +25 -3
  114. package/dist/workspaces.d.ts.map +1 -1
  115. package/dist/workspaces.js +43 -8
  116. package/docs/ARCHITECTURE.md +229 -5
  117. package/docs/CONCEPT.md +171 -91
  118. package/docs/EXECUTION-LOOP.md +196 -0
  119. package/docs/README.ru.md +2 -2
  120. package/docs/README.zh.md +3 -3
  121. package/docs/SAFETY.md +122 -0
  122. package/docs/SAVINGS.md +29 -0
  123. package/docs/SAVINGS.ru.md +29 -0
  124. package/docs/SAVINGS.zh.md +18 -0
  125. package/gui-experimental.cjs +8 -8
  126. package/locales/en.json +67 -0
  127. package/locales/ru.json +67 -0
  128. package/locales/zh.json +67 -0
  129. package/package.json +28 -3
  130. package/scripts/audit-bundle.mjs +215 -0
  131. package/src/core/dlq-api.ts +98 -0
  132. package/src/core/dry-run.ts +25 -1
  133. package/src/core/lock.ts +95 -22
  134. package/src/core/one-shot.ts +36 -8
  135. package/src/core/opencode-cli.ts +103 -0
  136. package/src/core/opencode-models.ts +315 -0
  137. package/src/core/ps-wrapper.ts +11 -1
  138. package/src/core/record-history.ts +75 -37
  139. package/src/core/router/dispatch.ts +94 -0
  140. package/src/core/router/escalation.ts +129 -0
  141. package/src/core/router/planner.ts +166 -0
  142. package/src/core/router/rules.ts +109 -0
  143. package/src/core/run-panel-api.ts +262 -0
  144. package/src/core/schedule-gate.ts +6 -2
  145. package/src/core/schedule-v2.ts +114 -5
  146. package/src/core/scheduler/at-fallback.ts +190 -5
  147. package/src/core/scheduler/linux.ts +32 -10
  148. package/src/core/scheduler/posix.ts +20 -1
  149. package/src/core/scheduler/registry.ts +107 -26
  150. package/src/core/scheduler/run-now.ts +32 -0
  151. package/src/core/secrets.ts +127 -27
  152. package/src/core/session.ts +23 -10
  153. package/src/core/task-name.ts +67 -0
  154. package/src/core/wrappers/bash.ts +49 -4
  155. package/src/db/capability-repo.ts +285 -0
  156. package/src/db/history-repo.ts +22 -0
  157. package/src/db/index.ts +37 -1
  158. package/src/db/migrate.ts +3 -1
  159. package/src/db/run-context.ts +370 -0
  160. package/src/db/run-dlq.ts +310 -0
  161. package/src/db/run-resume.ts +48 -12
  162. package/src/db/runs-repo.ts +30 -7
  163. package/src/db/schema.ts +154 -2
  164. package/src/db/settings-repo.ts +31 -0
  165. package/src/db/step-idempotency.ts +185 -0
  166. package/src/gui.tsx +515 -0
  167. package/src/index.ts +124 -4
  168. package/src/rpc.ts +251 -0
  169. package/src/server.ts +112 -36
  170. package/src/types.ts +9 -0
  171. package/src/workspaces.ts +58 -9
@@ -0,0 +1,98 @@
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 {
15
+ countDeadLetters,
16
+ discardDeadLetter,
17
+ listDeadLetters,
18
+ retryDeadLetter,
19
+ type DlqEntry,
20
+ type DlqStatus,
21
+ } from "../db/run-dlq.js";
22
+
23
+ /** Фильтр списка: конкретный статус или все записи. */
24
+ export type DlqFilter = DlqStatus | "all";
25
+
26
+ export interface DlqListResult {
27
+ success: boolean;
28
+ entries: DlqEntry[];
29
+ /** Сколько записей открыто (для бейджа в заголовке панели). */
30
+ open: number;
31
+ error?: string;
32
+ }
33
+
34
+ export interface DlqActionResult {
35
+ success: boolean;
36
+ error?: string;
37
+ entry?: DlqEntry;
38
+ runId?: string;
39
+ stepName?: string;
40
+ /** true, если retry переоткрыл упавший запуск. */
41
+ runReopened?: boolean;
42
+ }
43
+
44
+ function errorText(err: unknown): string {
45
+ return err instanceof Error ? err.message : String(err);
46
+ }
47
+
48
+ /** Неизвестный статус трактуем как `open`: безопасный дефолт очереди. */
49
+ export function normalizeDlqFilter(value: unknown): DlqFilter {
50
+ return value === "all" || value === "retried" || value === "discarded" || value === "open"
51
+ ? value
52
+ : "open";
53
+ }
54
+
55
+ function normalizeLimit(value: unknown, fallback = 100): number {
56
+ const num = Math.floor(Number(value));
57
+ if (!Number.isFinite(num) || num < 1) return fallback;
58
+ return Math.min(num, 500);
59
+ }
60
+
61
+ /** Список записей DLQ и счётчик открытых. */
62
+ export function listDlq(options: { status?: unknown; limit?: unknown } = {}): DlqListResult {
63
+ try {
64
+ const status = normalizeDlqFilter(options.status);
65
+ return {
66
+ success: true,
67
+ entries: listDeadLetters({ status, limit: normalizeLimit(options.limit) }),
68
+ open: countDeadLetters("open"),
69
+ };
70
+ } catch (err) {
71
+ return { success: false, entries: [], open: 0, error: errorText(err) };
72
+ }
73
+ }
74
+
75
+ /** Ручной retry: готовит шаг к выполнению и закрывает запись DLQ. */
76
+ export function retryDlq(id: string): DlqActionResult {
77
+ try {
78
+ const result = retryDeadLetter(id);
79
+ return {
80
+ success: true,
81
+ entry: result.entry,
82
+ runId: result.run.id,
83
+ stepName: result.step.stepName,
84
+ runReopened: result.runReopened,
85
+ };
86
+ } catch (err) {
87
+ return { success: false, error: errorText(err) };
88
+ }
89
+ }
90
+
91
+ /** Осознанный отказ от повтора: запись закрывается, шаг остаётся failed. */
92
+ export function discardDlq(id: string, resolution = "discarded"): DlqActionResult {
93
+ try {
94
+ return { success: true, entry: discardDeadLetter(id, resolution) };
95
+ } catch (err) {
96
+ return { success: false, error: errorText(err) };
97
+ }
98
+ }
@@ -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
  import type { TaskDefinition } from "../task-transfer.js";
@@ -283,6 +283,30 @@ async function describeTrigger(opts: DescribeTriggerOptions): Promise<DryRunTrig
283
283
  }),
284
284
  );
285
285
  }
286
+
287
+ // P2-24: даже если сейчас окно откроется, cron может никогда в него не
288
+ // попадать (например, daily 09:00 при окне 22:00–06:00). Предупреждаем
289
+ // заранее — иначе задача молча не выполняется из-за лимита переноса 12 ч.
290
+ if ((def.triggerType ?? "cron") === "cron" && def.schedule) {
291
+ const feasibility = assessCronWindowFeasibility(
292
+ def.schedule,
293
+ {
294
+ notBefore: def.notBefore ?? undefined,
295
+ notAfter: def.notAfter ?? undefined,
296
+ days: def.activeDays ?? undefined,
297
+ timeZone: def.timezone ?? undefined,
298
+ },
299
+ policy,
300
+ );
301
+ if (!feasibility.feasible) {
302
+ warnings.push(
303
+ t("dryRun.window.unreachable", {
304
+ cron: def.schedule,
305
+ reason: windowFeasibilityReasonText(feasibility.reason),
306
+ }),
307
+ );
308
+ }
309
+ }
286
310
  }
287
311
 
288
312
  return base;
package/src/core/lock.ts CHANGED
@@ -1,7 +1,36 @@
1
1
  import fs from "node:fs/promises";
2
2
  import path from "node:path";
3
+ import { randomUUID } from "node:crypto";
3
4
  import { LOCK_DIR, STALE_LOCK_MAX_AGE_MS } from "../types.js";
4
5
 
6
+ /**
7
+ * Проверяет, жив ли процесс-владелец lock-файла.
8
+ *
9
+ * `process.kill(pid, 0)` не посылает сигнал, а только проверяет существование.
10
+ * EPERM означает, что процесс есть, но у нас нет прав на сигнал — считаем живым.
11
+ * Остальные ошибки трактуем консервативно как «жив», чтобы не вытеснить
12
+ * чужую критическую секцию.
13
+ */
14
+ export function isProcessAlive(pid: number): boolean {
15
+ if (!Number.isInteger(pid) || pid <= 0) return false;
16
+ try {
17
+ process.kill(pid, 0);
18
+ return true;
19
+ } catch (err: any) {
20
+ if (err?.code === "ESRCH") return false;
21
+ return true;
22
+ }
23
+ }
24
+
25
+ /** PID владельца из токена lock-файла (`<pid>-<timestamp>-<uuid>`). */
26
+ function ownerPidFromToken(content: string): number | null {
27
+ const match = /^(\d+)-/.exec(content.trim());
28
+ if (!match) return null;
29
+ const pid = Number.parseInt(match[1], 10);
30
+ return Number.isInteger(pid) ? pid : null;
31
+ }
32
+
33
+
5
34
  /**
6
35
  * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
7
36
  *
@@ -60,6 +89,21 @@ export class LockManager {
60
89
  const stat = await fs.stat(fullPath);
61
90
  const age = now - stat.mtimeMs;
62
91
  if (age > STALE_LOCK_MAX_AGE_MS) {
92
+ // P2-18: возраст — только повод проверить владельца. Задача может
93
+ // легально работать дольше 24 ч (timeoutSeconds: 0), поэтому живой
94
+ // процесс не вытесняем: иначе после рестарта плагина появится дубль.
95
+ if (isLockFile) {
96
+ const content = await fs.readFile(fullPath, "utf8").catch(() => "");
97
+ const ownerPid = ownerPidFromToken(content);
98
+ if (ownerPid !== null && isProcessAlive(ownerPid)) {
99
+ console.log(
100
+ `[agent-steward] Lock ${file} старше ${Math.round(
101
+ age / 1000,
102
+ )} с, но процесс ${ownerPid} жив — оставляем.`,
103
+ );
104
+ continue;
105
+ }
106
+ }
63
107
  // T-03: не удаляем lock напрямую. Два воркера могли одновременно
64
108
  // снести один и тот же файл, после чего один из них удалял свежий
65
109
  // lock, созданный другим, и задача запускалась повторно. Атомарный
@@ -87,20 +131,24 @@ export class LockManager {
87
131
 
88
132
  /**
89
133
  * Пытается захватить блокировку для задачи.
90
- * Возвращает true, если блокировка захвачена (файл создан).
91
- * Возвращает false, если блокировка уже удерживается другим запуском.
134
+ * Возвращает уникальный токен владельца (он же содержимое lock-файла) или
135
+ * null, если блокировка уже удерживается другим запуском.
136
+ *
137
+ * Токен нужен release(): процесс, чей lock был вытеснен по stale-таймауту,
138
+ * не должен удалять файл нового владельца.
92
139
  */
93
- async acquire(taskName: string): Promise<boolean> {
140
+ async acquire(taskName: string): Promise<string | null> {
94
141
  await fs.mkdir(this.lockDir, { recursive: true });
95
142
  const lockPath = this.lockFilePath(taskName);
143
+ const token = `${process.pid}-${Date.now()}-${randomUUID()}`;
96
144
 
97
145
  try {
98
146
  // 'wx' — exclusive create: ошибка если файл уже существует.
99
- await fs.writeFile(lockPath, String(Date.now()), { flag: "wx" });
100
- return true;
147
+ await fs.writeFile(lockPath, token, { flag: "wx" });
148
+ return token;
101
149
  } catch (err: any) {
102
150
  if (err.code === "EEXIST") {
103
- return false;
151
+ return null;
104
152
  }
105
153
  throw err;
106
154
  }
@@ -108,14 +156,28 @@ export class LockManager {
108
156
 
109
157
  /**
110
158
  * Освобождает блокировку задачи (удаляет lock-файл).
159
+ *
160
+ * Удаляет файл только если в нём лежит токен этого владельца. Если lock
161
+ * успели вытеснить и перехватить, release ничего не трогает и возвращает
162
+ * false — иначе старый процесс снёс бы чужую критическую секцию.
111
163
  * Не выбрасывает ошибку, если файл уже удалён.
112
164
  */
113
- async release(taskName: string): Promise<void> {
165
+ async release(taskName: string, token: string): Promise<boolean> {
114
166
  const lockPath = this.lockFilePath(taskName);
167
+ let current: string;
168
+ try {
169
+ current = await fs.readFile(lockPath, "utf8");
170
+ } catch (err: any) {
171
+ if (err.code === "ENOENT") return false;
172
+ throw err;
173
+ }
174
+ if (current !== token) return false;
115
175
  try {
116
176
  await fs.unlink(lockPath);
177
+ return true;
117
178
  } catch (err: any) {
118
- if (err.code !== "ENOENT") throw err;
179
+ if (err.code === "ENOENT") return false;
180
+ throw err;
119
181
  }
120
182
  }
121
183
 
@@ -144,8 +206,8 @@ export async function withLock<T>(
144
206
  taskName: string,
145
207
  fn: () => Promise<T>,
146
208
  ): Promise<T | null> {
147
- const acquired = await lockManager.acquire(taskName);
148
- if (!acquired) {
209
+ const token = await lockManager.acquire(taskName);
210
+ if (!token) {
149
211
 
150
212
  console.log(
151
213
  `[agent-steward] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`,
@@ -156,7 +218,7 @@ export async function withLock<T>(
156
218
  try {
157
219
  return await fn();
158
220
  } finally {
159
- await lockManager.release(taskName);
221
+ await lockManager.release(taskName, token);
160
222
  }
161
223
  }
162
224
 
@@ -178,25 +240,36 @@ export async function withLockWait<T>(
178
240
  const staleMs = options.staleMs ?? 60000;
179
241
  const deadline = Date.now() + timeoutMs;
180
242
  const lockPath = lockManager.pathFor(taskName);
243
+ let token: string | null = null;
181
244
 
182
245
  for (;;) {
183
- if (await lockManager.acquire(taskName)) break;
246
+ token = await lockManager.acquire(taskName);
247
+ if (token) break;
184
248
 
185
249
  // Осиротевший lock: короткая операция не может длиться дольше staleMs.
186
250
  if (staleMs > 0) {
187
251
  try {
188
252
  const stat = await fs.stat(lockPath);
189
253
  if (Date.now() - stat.mtimeMs > staleMs) {
190
- // T-03-совместимое вытеснение: атомарный rename выигрывает ровно
191
- // один процесс, остальные получают ENOENT и повторяют попытку.
192
- const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
193
- try {
194
- await fs.rename(lockPath, stalePath);
195
- await fs.rm(stalePath, { force: true }).catch(() => {});
196
- } catch {
197
- // Кто-то успел раньше — просто повторяем acquire.
254
+ // P2-18: staleMs — не приговор. Если владелец ещё жив, его
255
+ // критическая секция может быть легально долгой (crontab RMW,
256
+ // длинная задача). Вытесняем только мёртвый/неизвестный lock.
257
+ const content = await fs.readFile(lockPath, "utf8").catch(() => "");
258
+ const ownerPid = ownerPidFromToken(content);
259
+ if (ownerPid !== null && isProcessAlive(ownerPid)) {
260
+ // Ждём дальше; по deadline вернём понятную ошибку.
261
+ } else {
262
+ // T-03-совместимое вытеснение: атомарный rename выигрывает ровно
263
+ // один процесс, остальные получают ENOENT и повторяют попытку.
264
+ const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
265
+ try {
266
+ await fs.rename(lockPath, stalePath);
267
+ await fs.rm(stalePath, { force: true }).catch(() => {});
268
+ } catch {
269
+ // Кто-то успел раньше — просто повторяем acquire.
270
+ }
271
+ continue;
198
272
  }
199
- continue;
200
273
  }
201
274
  } catch {
202
275
  // lock исчез — сразу пробуем acquire снова.
@@ -214,6 +287,6 @@ export async function withLockWait<T>(
214
287
  try {
215
288
  return await fn();
216
289
  } finally {
217
- await lockManager.release(taskName);
290
+ if (token) await lockManager.release(taskName, token);
218
291
  }
219
292
  }
@@ -143,17 +143,45 @@ export function buildWindowsOneShotFlags(
143
143
  /**
144
144
  * Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
145
145
  * (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
146
- * y/yy/yyyy. Неизвестные символы копируются как есть.
146
+ * MMM/MMMM (название месяца), y/yy/yyyy. Неизвестные символы копируются как есть.
147
+ *
148
+ * P2-26: раньше последовательные replace(/MM/) и replace(/M/) превращали
149
+ * «MMM» в число месяца («2030. 011 2.»). Теперь разбор идёт одним проходом
150
+ * по токенам, поэтому MMM/MMMM не пересекаются с MM/M.
147
151
  */
148
152
  export function formatDateByLocalePattern(date: Date, pattern: string): string {
149
153
  const pad2 = (v: number) => String(v).padStart(2, "0");
150
- return pattern
151
- .replace(/yyyy/g, String(date.getFullYear()))
152
- .replace(/yy/g, String(date.getFullYear()).slice(-2))
153
- .replace(/MM/g, pad2(date.getMonth() + 1))
154
- .replace(/M/g, String(date.getMonth() + 1))
155
- .replace(/dd/g, pad2(date.getDate()))
156
- .replace(/d/g, String(date.getDate()));
154
+ const monthShort = new Intl.DateTimeFormat(undefined, {
155
+ month: "short",
156
+ }).format(date);
157
+ const monthLong = new Intl.DateTimeFormat(undefined, {
158
+ month: "long",
159
+ }).format(date);
160
+ return pattern.replace(
161
+ /yyyy|yy|MMMM|MMM|MM|M|dd|d/g,
162
+ (token) => {
163
+ switch (token) {
164
+ case "yyyy":
165
+ return String(date.getFullYear());
166
+ case "yy":
167
+ return String(date.getFullYear()).slice(-2);
168
+ case "MMMM":
169
+ return monthLong;
170
+ case "MMM":
171
+ return monthShort;
172
+ case "MM":
173
+ return pad2(date.getMonth() + 1);
174
+ case "M":
175
+ return String(date.getMonth() + 1);
176
+ case "dd":
177
+ return pad2(date.getDate());
178
+ case "d":
179
+ return String(date.getDate());
180
+ default:
181
+ return token;
182
+ }
183
+ },
184
+ );
157
185
  }
158
186
 
159
187
  /** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
@@ -0,0 +1,103 @@
1
+ /**
2
+ * Кроссплатформенный запуск OpenCode CLI.
3
+ *
4
+ * На Windows `opencode` — это `opencode.cmd`. Node с 18.20/20.12 запрещает
5
+ * запускать `.cmd`/`.bat` через `execFile` без shell (EINVAL), а имя без
6
+ * расширения не находится вовсе (ENOENT). Поэтому на Windows команда идёт
7
+ * через `cmd.exe /d /s /c` — ровно так же, как в `opencode-models.ts`.
8
+ *
9
+ * Модуль не бросает: результат запуска возвращается объектом, чтобы вызывающий
10
+ * сам решал, писать предупреждение или продолжать молча.
11
+ */
12
+ import { execFile } from "node:child_process";
13
+
14
+ /** Готовая команда для `execFile`/`execFileSync`. */
15
+ export interface OpencodeCommand {
16
+ file: string;
17
+ args: string[];
18
+ }
19
+
20
+ /** Аргументы без спецсимволов cmd.exe можно передавать как есть. */
21
+ const SAFE_ARG = /^[A-Za-z0-9_.,:@/\\+=-]+$/;
22
+
23
+ /** Результат запуска CLI. */
24
+ export interface RunOpencodeResult {
25
+ ok: boolean;
26
+ stdout: string;
27
+ stderr: string;
28
+ /** Текст ошибки запуска (только при ok = false). */
29
+ error?: string;
30
+ }
31
+
32
+ /**
33
+ * Экранирует аргумент для командной строки cmd.exe.
34
+ * Бросает на переводы строк: они разрывают команду на две.
35
+ */
36
+ export function quoteCmdArg(arg: string): string {
37
+ if (/[\r\n]/.test(arg)) {
38
+ throw new Error("Аргумент командной строки не может содержать перевод строки");
39
+ }
40
+ if (SAFE_ARG.test(arg)) return arg;
41
+ return `"${arg.replace(/"/g, '""')}"`;
42
+ }
43
+
44
+ /** Команда запуска OpenCode для указанной платформы (чистая функция). */
45
+ export function opencodeCommandFor(
46
+ platform: NodeJS.Platform,
47
+ args: string[],
48
+ ): OpencodeCommand {
49
+ if (platform !== "win32") return { file: "opencode", args: args.slice() };
50
+ const line = ["opencode", ...args].map(quoteCmdArg).join(" ");
51
+ return { file: "cmd.exe", args: ["/d", "/s", "/c", line] };
52
+ }
53
+
54
+ /** Команда запуска OpenCode на текущей платформе. */
55
+ export function opencodeCommand(args: string[]): OpencodeCommand {
56
+ return opencodeCommandFor(process.platform, args);
57
+ }
58
+
59
+ /**
60
+ * Запускает OpenCode CLI и ждёт завершения. Никогда не бросает.
61
+ * `timeoutMs` защищает от зависшего процесса: CLI не должен держать ротацию.
62
+ */
63
+ export function runOpencode(
64
+ args: string[],
65
+ timeoutMs = 30_000,
66
+ ): Promise<RunOpencodeResult> {
67
+ let command: OpencodeCommand;
68
+ try {
69
+ command = opencodeCommand(args);
70
+ } catch (error) {
71
+ return Promise.resolve({
72
+ ok: false,
73
+ stdout: "",
74
+ stderr: "",
75
+ error: error instanceof Error ? error.message : String(error),
76
+ });
77
+ }
78
+
79
+ return new Promise<RunOpencodeResult>((resolve) => {
80
+ execFile(
81
+ command.file,
82
+ command.args,
83
+ {
84
+ timeout: timeoutMs,
85
+ windowsHide: true,
86
+ encoding: "utf8",
87
+ maxBuffer: 4 * 1024 * 1024,
88
+ },
89
+ (error, stdout, stderr) => {
90
+ if (error) {
91
+ resolve({
92
+ ok: false,
93
+ stdout: String(stdout ?? ""),
94
+ stderr: String(stderr ?? ""),
95
+ error: error.message,
96
+ });
97
+ return;
98
+ }
99
+ resolve({ ok: true, stdout: String(stdout ?? ""), stderr: String(stderr ?? "") });
100
+ },
101
+ );
102
+ });
103
+ }