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
@@ -56,7 +56,7 @@ export function expandMatrixTask(task: TaskDefinition): TaskDefinition[] {
56
56
  const matrix = task.matrix;
57
57
  if (!matrix || !Array.isArray(matrix.workspaceIds) || matrix.workspaceIds.length === 0) {
58
58
  throw new Error(
59
- t("matrix.error.workspaceIdsEmpty", { task: task.name })
59
+ t("matrix.error.workspaceIdsEmpty", { task: task.name }),
60
60
  );
61
61
  }
62
62
 
@@ -70,13 +70,13 @@ export function expandMatrixTask(task: TaskDefinition): TaskDefinition[] {
70
70
  t("matrix.error.workspaceMissing", {
71
71
  task: task.name,
72
72
  workspace: workspaceId,
73
- })
73
+ }),
74
74
  );
75
75
  }
76
76
  const name = matrixCloneName(task.name, workspace.name);
77
77
  if (usedNames.has(name.toLowerCase())) {
78
78
  throw new Error(
79
- t("matrix.error.duplicateCloneName", { task: task.name, name })
79
+ t("matrix.error.duplicateCloneName", { task: task.name, name }),
80
80
  );
81
81
  }
82
82
  usedNames.add(name.toLowerCase());
@@ -123,7 +123,7 @@ export function expandMatrixTask(task: TaskDefinition): TaskDefinition[] {
123
123
 
124
124
  if (clones.length === 0) {
125
125
  throw new Error(
126
- t("matrix.error.cloneCreation", { task: task.name })
126
+ t("matrix.error.cloneCreation", { task: task.name }),
127
127
  );
128
128
  }
129
129
  return clones;
@@ -189,7 +189,7 @@ export function aggregateMatrixResults(parentId: string): MatrixAggregate {
189
189
  const successCount = results.filter((r) => r.status === "success").length;
190
190
  const errorCount = results.filter((r) => r.status === "error").length;
191
191
  const pendingCount = results.filter(
192
- (r) => r.status !== "success" && r.status !== "error" && r.status !== "partial"
192
+ (r) => r.status !== "success" && r.status !== "error" && r.status !== "partial",
193
193
  ).length;
194
194
 
195
195
  let status: MatrixAggregate["status"];
@@ -217,9 +217,9 @@ export function aggregateMatrixResults(parentId: string): MatrixAggregate {
217
217
  }) +
218
218
  (firstError?.error
219
219
  ? t("matrix.aggregate.stoppedFirst", {
220
- name: firstError.name,
221
- error: firstError.error,
222
- })
220
+ name: firstError.name,
221
+ error: firstError.error,
222
+ })
223
223
  : "");
224
224
  } else {
225
225
  status = "partial";
@@ -256,7 +256,7 @@ export interface MatrixRunResult {
256
256
  /** Эффективный лимит одновременных клонов матрицы (Спринт 17). */
257
257
  export function resolveMatrixConcurrency(
258
258
  matrix: MatrixConfig | undefined,
259
- totalClones: number
259
+ totalClones: number,
260
260
  ): number {
261
261
  const total = Math.max(1, totalClones);
262
262
  if (!matrix) return total;
@@ -336,14 +336,14 @@ export async function runMatrix(task: TaskDefinition): Promise<MatrixRunResult>
336
336
  console.log(
337
337
  `[matrix] ${task.name}: не удалось сохранить очередь: ${
338
338
  err instanceof Error ? err.message : String(err)
339
- }`
339
+ }`,
340
340
  );
341
341
  }
342
342
 
343
343
  console.log(
344
344
  `[matrix] ${task.name}: strategy=${strategy}, failureMode=${failureMode}, ` +
345
345
  `concurrency=${concurrency}, started=${started.length}, skipped=${skipped.length}, ` +
346
- `queued=${queueToSave.length}, errors=${errors.length}`
346
+ `queued=${queueToSave.length}, errors=${errors.length}`,
347
347
  );
348
348
 
349
349
  return {
@@ -363,7 +363,7 @@ export async function runMatrix(task: TaskDefinition): Promise<MatrixRunResult>
363
363
  * Возвращает имя запущенного клона или undefined.
364
364
  */
365
365
  export async function advanceSequentialMatrix(
366
- cloneName: string
366
+ cloneName: string,
367
367
  ): Promise<string | undefined> {
368
368
  const clone = getTask(cloneName);
369
369
  if (!clone?.matrixParentId) return undefined;
@@ -415,7 +415,7 @@ export async function advanceSequentialMatrix(
415
415
  * Возвращает имена запущенных клонов.
416
416
  */
417
417
  export async function advanceMatrixAfterClone(
418
- cloneName: string
418
+ cloneName: string,
419
419
  ): Promise<string[]> {
420
420
  const sequentialNext = await advanceSequentialMatrix(cloneName);
421
421
  if (sequentialNext) return [sequentialNext];
@@ -433,7 +433,7 @@ export async function advanceMatrixAfterClone(
433
433
  const clones = listMatrixClones(parent.name);
434
434
  const concurrency = resolveMatrixConcurrency(parent.matrix, clones.length);
435
435
  const running = clones.filter(
436
- (item) => latestCloneStatus(item.name).status === "running"
436
+ (item) => latestCloneStatus(item.name).status === "running",
437
437
  ).length;
438
438
  let slots = Math.max(0, concurrency - running);
439
439
  if (slots === 0) return [];
@@ -453,7 +453,7 @@ export async function advanceMatrixAfterClone(
453
453
  } catch (err: any) {
454
454
  const message = err instanceof Error ? err.message : String(err);
455
455
  console.log(
456
- `[matrix] ${parent.name}: не удалось запустить из очереди ${nextName}: ${message}`
456
+ `[matrix] ${parent.name}: не удалось запустить из очереди ${nextName}: ${message}`,
457
457
  );
458
458
  // Попытка запуска «съедает» слот: иначе при недоступном бэкенде
459
459
  // цикл уйдёт по всей очереди, проигнорировав лимит.
@@ -471,7 +471,7 @@ export async function advanceMatrixAfterClone(
471
471
  console.log(
472
472
  `[matrix] ${parent.name}: не удалось сохранить очередь: ${
473
473
  err instanceof Error ? err.message : String(err)
474
- }`
474
+ }`,
475
475
  );
476
476
  }
477
477
 
@@ -578,7 +578,7 @@ export function planMatrixSync(parent: TaskDefinition): MatrixSyncPlan {
578
578
  const desired = expandMatrixTask(parent);
579
579
  const existing = listMatrixClones(parent.name);
580
580
  const byName = new Map(
581
- existing.map((definition) => [definition.name.toLowerCase(), definition])
581
+ existing.map((definition) => [definition.name.toLowerCase(), definition]),
582
582
  );
583
583
  const desiredNames = new Set(desired.map((definition) => definition.name.toLowerCase()));
584
584
 
@@ -601,7 +601,7 @@ export function planMatrixSync(parent: TaskDefinition): MatrixSyncPlan {
601
601
  running.push(current.name);
602
602
  if (cloneSignature(current) !== cloneSignature(wanted)) {
603
603
  warnings.push(
604
- t("matrix.clone.runningChanges", { name: current.name })
604
+ t("matrix.clone.runningChanges", { name: current.name }),
605
605
  );
606
606
  }
607
607
  continue;
@@ -617,7 +617,7 @@ export function planMatrixSync(parent: TaskDefinition): MatrixSyncPlan {
617
617
  if (latest.status === "running") {
618
618
  running.push(current.name);
619
619
  warnings.push(
620
- t("matrix.clone.runningDeletion", { name: current.name })
620
+ t("matrix.clone.runningDeletion", { name: current.name }),
621
621
  );
622
622
  continue;
623
623
  }
@@ -652,7 +652,7 @@ export interface MatrixSyncResult {
652
652
  */
653
653
  export async function syncMatrixFamily(
654
654
  parent: TaskDefinition,
655
- hooks: MatrixSyncHooks = {}
655
+ hooks: MatrixSyncHooks = {},
656
656
  ): Promise<MatrixSyncResult> {
657
657
  const plan = planMatrixSync(parent);
658
658
 
@@ -680,7 +680,7 @@ export async function syncMatrixFamily(
680
680
 
681
681
  /** Имя родителя по имени агрегатора (`<parent>-matrix-complete`). */
682
682
  export function matrixParentOfCompleteTask(
683
- taskName: string
683
+ taskName: string,
684
684
  ): string | undefined {
685
685
  const trimmed = taskName.trim();
686
686
  if (!isMatrixCompleteName(trimmed)) return undefined;
@@ -698,7 +698,7 @@ export interface MatrixFamilyPlan {
698
698
  }
699
699
 
700
700
  export function planMatrixFamilyDelete(
701
- taskName: string
701
+ taskName: string,
702
702
  ): MatrixFamilyPlan | undefined {
703
703
  const definition = getTask(taskName);
704
704
  if (!definition?.matrix) return undefined;
@@ -715,7 +715,7 @@ export function planMatrixFamilyDelete(
715
715
  * Возвращает текст ошибки или undefined, если удаление разрешено.
716
716
  */
717
717
  export function getMatrixDeletionGuard(
718
- taskName: string
718
+ taskName: string,
719
719
  ): string | undefined {
720
720
  const definition = getTask(taskName);
721
721
  const parentId = definition?.matrixParentId?.trim();
@@ -773,7 +773,7 @@ export interface MatrixCancelResult {
773
773
  */
774
774
  export async function cancelPendingMatrixClones(
775
775
  parentName: string,
776
- reason = t("matrix.cancel.defaultReason")
776
+ reason = t("matrix.cancel.defaultReason"),
777
777
  ): Promise<MatrixCancelResult> {
778
778
  const parent = getTask(parentName);
779
779
  if (!parent?.matrix) {
@@ -793,7 +793,7 @@ export async function cancelPendingMatrixClones(
793
793
  console.log(
794
794
  `[matrix] ${parent.name}: не удалось очистить очередь: ${
795
795
  err instanceof Error ? err.message : String(err)
796
- }`
796
+ }`,
797
797
  );
798
798
  }
799
799
  }
@@ -824,14 +824,14 @@ export async function cancelPendingMatrixClones(
824
824
  undefined,
825
825
  clone.model ?? undefined,
826
826
  "skipped",
827
- "skipped"
827
+ "skipped",
828
828
  );
829
829
  cancelled.push(clone.name);
830
830
  } catch (err: any) {
831
831
  console.log(
832
832
  `[matrix] ${parent.name}: не удалось записать отмену клона ${clone.name}: ${
833
833
  err instanceof Error ? err.message : String(err)
834
- }`
834
+ }`,
835
835
  );
836
836
  }
837
837
  }
@@ -860,7 +860,7 @@ export function cloneFileKey(cloneName: string): string {
860
860
  * success/error/partial) и запускает matrix-complete, если он создан.
861
861
  */
862
862
  export async function finalizeMatrixIfComplete(
863
- cloneName: string
863
+ cloneName: string,
864
864
  ): Promise<MatrixAggregate | undefined> {
865
865
  const clone = getTask(cloneName);
866
866
  const parentId = clone?.matrixParentId?.trim();
@@ -908,7 +908,7 @@ export async function finalizeMatrixIfComplete(
908
908
  undefined,
909
909
  parent.model ?? undefined,
910
910
  "skipped",
911
- "skipped"
911
+ "skipped",
912
912
  );
913
913
  // Спринт 20: уведомление о завершении матрицы (partial / все упали / успех).
914
914
  void notifyMatrixCompletion({
@@ -923,7 +923,7 @@ export async function finalizeMatrixIfComplete(
923
923
  console.log(
924
924
  `[matrix] ${parent.name}: не удалось записать агрегат: ${
925
925
  err instanceof Error ? err.message : String(err)
926
- }`
926
+ }`,
927
927
  );
928
928
  }
929
929
 
@@ -937,7 +937,7 @@ export async function finalizeMatrixIfComplete(
937
937
  console.log(
938
938
  `[matrix] ${parent.name}: не удалось запустить агрегатор: ${
939
939
  err instanceof Error ? err.message : String(err)
940
- }`
940
+ }`,
941
941
  );
942
942
  }
943
943
  }
@@ -52,7 +52,7 @@ $appId = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\power
52
52
  */
53
53
  export function buildNativeNotificationCommand(
54
54
  platform: NodeJS.Platform,
55
- message: NativeNotificationMessage
55
+ message: NativeNotificationMessage,
56
56
  ): NativeCommand {
57
57
  const title = (message.title ?? "OpenCode Scheduler").trim() || "OpenCode Scheduler";
58
58
  const body = String(message.body ?? "");
@@ -129,7 +129,7 @@ export interface NativeSendResult {
129
129
  */
130
130
  export async function sendNativeNotification(
131
131
  message: NativeNotificationMessage,
132
- options: SendNativeOptions = {}
132
+ options: SendNativeOptions = {},
133
133
  ): Promise<NativeSendResult> {
134
134
  const platform = options.platform ?? process.platform;
135
135
  const command = buildNativeNotificationCommand(platform, message);
@@ -52,7 +52,7 @@ function asDelaySeconds(value: unknown): number | undefined | "invalid" {
52
52
  */
53
53
  export function normalizeOneShotRunAt(
54
54
  input: OneShotInput,
55
- nowMs: number = Date.now()
55
+ nowMs: number = Date.now(),
56
56
  ): OneShotNormalization {
57
57
  const rawRunAt =
58
58
  typeof input.runAt === "string" ? input.runAt.trim() : undefined;
@@ -73,7 +73,7 @@ export function normalizeOneShotRunAt(
73
73
  return {
74
74
  ok: false,
75
75
  error:
76
- `runAt должен быть датой в формате ISO-8601, например ` +
76
+ "runAt должен быть датой в формате ISO-8601, например " +
77
77
  `2026-12-01T09:00:00Z (получено «${rawRunAt}»).`,
78
78
  };
79
79
  }
@@ -82,7 +82,7 @@ export function normalizeOneShotRunAt(
82
82
  ok: false,
83
83
  error:
84
84
  `runAt должен быть в будущем (получено «${rawRunAt}»). ` +
85
- `Для запуска сразу используйте run_task_now.`,
85
+ "Для запуска сразу используйте run_task_now.",
86
86
  };
87
87
  }
88
88
  return {
@@ -114,24 +114,76 @@ function pad(value: number): string {
114
114
  /**
115
115
  * Формат даты/времени для schtasks /sd и /st.
116
116
  *
117
- * Windows Task Scheduler ожидает дату в формате текущей локали. Плагин уже
118
- * использует DD.MM.YYYY для ONCE-заглушки, поэтому сохраняем этот формат
119
- * для совместимости с русской локалью (основной сценарий проекта).
117
+ * Windows Task Scheduler ожидает дату в формате текущей локали. На русской
118
+ * Windows — DD.MM.YYYY, на английской — M/d/yyyy и т.д. Жёсткий DD.MM.YYYY
119
+ * ломает создание one-shot и file/git/mcp-задач на не-RU Windows (P1-8).
120
+ * Вызывающий код (windows.ts) передаёт `dateFormat`, полученный из системной
121
+ * локали через PowerShell `(Get-Culture).DateTimeFormat.ShortDatePattern`.
122
+ *
123
+ * @param runAt — ISO-8601 время запуска.
124
+ * @param dateFormat — шаблон даты локали (например, "dd.MM.yyyy" или "M/d/yyyy").
125
+ * Если не задан — используется DD.MM.YYYY (по умолчанию RU).
120
126
  */
121
127
  export function buildWindowsOneShotFlags(
122
- runAt: string
128
+ runAt: string,
129
+ dateFormat?: string,
123
130
  ): ["/sc", "ONCE", "/sd", string, "/st", string] {
124
131
  const date = new Date(runAt);
132
+ const sd = dateFormat ? formatDateByLocalePattern(date, dateFormat) : `${pad(date.getDate())}.${pad(date.getMonth() + 1)}.${date.getFullYear()}`;
125
133
  return [
126
134
  "/sc",
127
135
  "ONCE",
128
136
  "/sd",
129
- `${pad(date.getDate())}.${pad(date.getMonth() + 1)}.${date.getFullYear()}`,
137
+ sd,
130
138
  "/st",
131
139
  `${pad(date.getHours())}:${pad(date.getMinutes())}`,
132
140
  ];
133
141
  }
134
142
 
143
+ /**
144
+ * Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
145
+ * (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
146
+ * MMM/MMMM (название месяца), y/yy/yyyy. Неизвестные символы копируются как есть.
147
+ *
148
+ * P2-26: раньше последовательные replace(/MM/) и replace(/M/) превращали
149
+ * «MMM» в число месяца («2030. 011 2.»). Теперь разбор идёт одним проходом
150
+ * по токенам, поэтому MMM/MMMM не пересекаются с MM/M.
151
+ */
152
+ export function formatDateByLocalePattern(date: Date, pattern: string): string {
153
+ const pad2 = (v: number) => String(v).padStart(2, "0");
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
+ );
185
+ }
186
+
135
187
  /** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
136
188
  export function buildAtTimestamp(runAt: string): string {
137
189
  const date = new Date(runAt);
@@ -144,9 +196,35 @@ export function buildAtTimestamp(runAt: string): string {
144
196
  );
145
197
  }
146
198
 
199
+ /**
200
+ * Bash-команда для one-shot в launchd.
201
+ *
202
+ * StartCalendarInterval не поддерживает год: без защиты задача с runAt
203
+ * дальше чем через год сработала бы в ближайшую годовщину, а после
204
+ * выполнения — повторно через год. Гейт сравнивает now с runAt и ставит
205
+ * маркер, привязанный ко времени запуска.
206
+ */
207
+ export function buildOneShotGuardCommand(
208
+ command: string,
209
+ runAt: string,
210
+ stampPath: string,
211
+ ): string {
212
+ const epoch = Math.floor(new Date(runAt).getTime() / 1000);
213
+ const quote = (value: string) => `'${value.replace(/'/g, "'\\''")}'`;
214
+ return [
215
+ `stamp=${quote(stampPath)}`,
216
+ "[ -f \"$stamp\" ] && exit 0",
217
+ `[ "$(date +%s)" -lt ${epoch} ] && exit 0`,
218
+ "mkdir -p \"$(dirname \"$stamp\")\" 2>/dev/null || true",
219
+ ": > \"$stamp\" 2>/dev/null || true",
220
+ command,
221
+ ].join("; ");
222
+ }
223
+
147
224
  /**
148
225
  * StartCalendarInterval для launchd. launchd не поддерживает год, поэтому
149
- * плагин дополнительно выгружает plist после первого запуска (см. обёртку).
226
+ * обёртка дополнительно проверяет runAt и ставит маркер выполнения
227
+ * (см. buildOneShotGuardCommand).
150
228
  */
151
229
  export function buildLaunchdCalendar(runAt: string): {
152
230
  Month: number;
@@ -166,13 +244,13 @@ export function buildLaunchdCalendar(runAt: string): {
166
244
  /** Команда самоочистки launchd-агента после единственного запуска. */
167
245
  export function buildLaunchdOneShotCleanup(
168
246
  sanitizedName: string,
169
- profile: string = "default"
247
+ profile = "default",
170
248
  ): string {
171
249
  const label = launchdLabel(sanitizedName, profile);
172
250
  return (
173
- `launchctl bootout "gui/$(id -u)" ` +
251
+ "launchctl bootout \"gui/$(id -u)\" " +
174
252
  `"$HOME/Library/LaunchAgents/${label}.plist" ` +
175
- `>/dev/null 2>&1 || true`
253
+ ">/dev/null 2>&1 || true"
176
254
  );
177
255
  }
178
256
 
@@ -181,7 +259,7 @@ export function buildLaunchdOneShotCleanup(
181
259
  * `com.opencode.scheduler.<name>`; у не-default профиля свой префикс, чтобы
182
260
  * одноимённые задачи разных профилей не затирали plist друг друга.
183
261
  */
184
- export function launchdLabel(sanitizedName: string, profile: string = "default"): string {
262
+ export function launchdLabel(sanitizedName: string, profile = "default"): string {
185
263
  const base = `com.opencode.scheduler.${sanitizedName}`;
186
264
  if (profile === "default") return base;
187
265
  const scope = profile.replace(/[^A-Za-z0-9_.-]/g, "-");
@@ -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
+ }