opencode-windows-scheduler 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. package/CHANGELOG.md +52 -0
  2. package/CROSS_PLATFORM.md +113 -0
  3. package/LICENSE +21 -0
  4. package/README.md +173 -2
  5. package/README.ru.md +131 -0
  6. package/ROADMAP-STRATEGY.md +217 -0
  7. package/ROADMAP.md +90 -0
  8. package/dist/core/analytics.d.ts +119 -0
  9. package/dist/core/analytics.d.ts.map +1 -0
  10. package/dist/core/analytics.js +265 -0
  11. package/dist/core/cron-to-schtasks.d.ts +20 -0
  12. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  13. package/dist/core/cron-to-schtasks.js +233 -0
  14. package/dist/core/dry-run.d.ts +44 -0
  15. package/dist/core/dry-run.d.ts.map +1 -0
  16. package/dist/core/dry-run.js +252 -0
  17. package/dist/core/file-watcher.d.ts +31 -0
  18. package/dist/core/file-watcher.d.ts.map +1 -0
  19. package/dist/core/file-watcher.js +128 -0
  20. package/dist/core/lock.d.ts +43 -0
  21. package/dist/core/lock.d.ts.map +1 -0
  22. package/dist/core/lock.js +118 -0
  23. package/dist/core/matrix.d.ts +167 -0
  24. package/dist/core/matrix.d.ts.map +1 -0
  25. package/dist/core/matrix.js +687 -0
  26. package/dist/core/ps-wrapper.d.ts +60 -0
  27. package/dist/core/ps-wrapper.d.ts.map +1 -0
  28. package/dist/core/ps-wrapper.js +538 -0
  29. package/dist/core/record-history.d.ts +14 -0
  30. package/dist/core/record-history.d.ts.map +1 -0
  31. package/dist/core/record-history.js +360 -0
  32. package/dist/core/retention.d.ts +29 -0
  33. package/dist/core/retention.d.ts.map +1 -0
  34. package/dist/core/retention.js +98 -0
  35. package/dist/core/scheduler/index.d.ts +20 -0
  36. package/dist/core/scheduler/index.d.ts.map +1 -0
  37. package/dist/core/scheduler/index.js +32 -0
  38. package/dist/core/scheduler/linux.d.ts +32 -0
  39. package/dist/core/scheduler/linux.d.ts.map +1 -0
  40. package/dist/core/scheduler/linux.js +115 -0
  41. package/dist/core/scheduler/logs.d.ts +11 -0
  42. package/dist/core/scheduler/logs.d.ts.map +1 -0
  43. package/dist/core/scheduler/logs.js +34 -0
  44. package/dist/core/scheduler/mac.d.ts +39 -0
  45. package/dist/core/scheduler/mac.d.ts.map +1 -0
  46. package/dist/core/scheduler/mac.js +175 -0
  47. package/dist/core/scheduler/posix.d.ts +40 -0
  48. package/dist/core/scheduler/posix.d.ts.map +1 -0
  49. package/dist/core/scheduler/posix.js +86 -0
  50. package/dist/core/scheduler/registry.d.ts +36 -0
  51. package/dist/core/scheduler/registry.d.ts.map +1 -0
  52. package/dist/core/scheduler/registry.js +56 -0
  53. package/dist/core/scheduler/types.d.ts +63 -0
  54. package/dist/core/scheduler/types.d.ts.map +1 -0
  55. package/dist/core/scheduler/types.js +1 -0
  56. package/dist/core/scheduler/windows.d.ts +47 -0
  57. package/dist/core/scheduler/windows.d.ts.map +1 -0
  58. package/dist/core/scheduler/windows.js +375 -0
  59. package/dist/core/wrappers/bash.d.ts +58 -0
  60. package/dist/core/wrappers/bash.d.ts.map +1 -0
  61. package/dist/core/wrappers/bash.js +223 -0
  62. package/dist/db/history-repo.d.ts +102 -0
  63. package/dist/db/history-repo.d.ts.map +1 -0
  64. package/dist/db/history-repo.js +215 -0
  65. package/dist/db/index.d.ts +47 -0
  66. package/dist/db/index.d.ts.map +1 -0
  67. package/dist/db/index.js +120 -0
  68. package/dist/db/metrics-repo.d.ts +43 -0
  69. package/dist/db/metrics-repo.d.ts.map +1 -0
  70. package/dist/db/metrics-repo.js +95 -0
  71. package/dist/db/migrate.d.ts +24 -0
  72. package/dist/db/migrate.d.ts.map +1 -0
  73. package/dist/db/migrate.js +237 -0
  74. package/dist/db/recovery.d.ts +11 -0
  75. package/dist/db/recovery.d.ts.map +1 -0
  76. package/dist/db/recovery.js +38 -0
  77. package/dist/db/schema.d.ts +24 -0
  78. package/dist/db/schema.d.ts.map +1 -0
  79. package/dist/db/schema.js +97 -0
  80. package/dist/db/settings-repo.d.ts +8 -0
  81. package/dist/db/settings-repo.d.ts.map +1 -0
  82. package/dist/db/settings-repo.js +27 -0
  83. package/dist/db/tasks-repo.d.ts +26 -0
  84. package/dist/db/tasks-repo.d.ts.map +1 -0
  85. package/dist/db/tasks-repo.js +120 -0
  86. package/dist/db/templates-repo.d.ts +17 -0
  87. package/dist/db/templates-repo.d.ts.map +1 -0
  88. package/dist/db/templates-repo.js +57 -0
  89. package/dist/history.d.ts +53 -0
  90. package/dist/history.d.ts.map +1 -0
  91. package/dist/history.js +57 -0
  92. package/dist/index.d.ts +156 -0
  93. package/dist/index.d.ts.map +1 -0
  94. package/dist/index.js +2159 -0
  95. package/dist/notifications.d.ts +45 -0
  96. package/dist/notifications.d.ts.map +1 -0
  97. package/dist/notifications.js +135 -0
  98. package/dist/rpc.d.ts +2186 -0
  99. package/dist/rpc.d.ts.map +1 -0
  100. package/dist/rpc.js +924 -0
  101. package/dist/schtasks.d.ts +32 -0
  102. package/dist/schtasks.d.ts.map +1 -0
  103. package/dist/schtasks.js +45 -0
  104. package/dist/server.d.ts +106 -0
  105. package/dist/server.d.ts.map +1 -0
  106. package/dist/server.js +1668 -0
  107. package/dist/settings.d.ts +66 -0
  108. package/dist/settings.d.ts.map +1 -0
  109. package/dist/settings.js +137 -0
  110. package/dist/shared/jobs-view.d.ts +21 -0
  111. package/dist/shared/jobs-view.d.ts.map +1 -0
  112. package/dist/shared/jobs-view.js +28 -0
  113. package/dist/skill.d.ts +15 -0
  114. package/dist/skill.d.ts.map +1 -0
  115. package/dist/skill.js +93 -0
  116. package/dist/task-transfer.d.ts +176 -0
  117. package/dist/task-transfer.d.ts.map +1 -0
  118. package/dist/task-transfer.js +442 -0
  119. package/dist/templates.d.ts +57 -0
  120. package/dist/templates.d.ts.map +1 -0
  121. package/dist/templates.js +16 -0
  122. package/dist/types.d.ts +78 -0
  123. package/dist/types.d.ts.map +1 -0
  124. package/dist/types.js +88 -0
  125. package/dist/version.d.ts +8 -0
  126. package/dist/version.d.ts.map +1 -0
  127. package/dist/version.js +27 -0
  128. package/dist/workspaces.d.ts +55 -0
  129. package/dist/workspaces.d.ts.map +1 -0
  130. package/dist/workspaces.js +183 -0
  131. package/docs/ARCHITECTURE.md +314 -0
  132. package/docs/FEATURES.md +300 -0
  133. package/docs/MIGRATION.md +266 -0
  134. package/docs/dashboard.png +0 -0
  135. package/gui-experimental.cjs +2 -0
  136. package/index.js +1 -0
  137. package/package.json +94 -4
  138. package/scripts/demo-dashboard.mjs +199 -0
  139. package/skills/scheduled-job-best-practices/SKILL.md +155 -0
  140. package/skills/scheduled-job-best-practices/references/recipes.md +123 -0
  141. package/src/core/analytics.ts +378 -0
  142. package/src/core/cron-to-schtasks.ts +269 -0
  143. package/src/core/dry-run.ts +315 -0
  144. package/src/core/file-watcher.ts +171 -0
  145. package/src/core/lock.ts +134 -0
  146. package/src/core/matrix.ts +907 -0
  147. package/src/core/ps-wrapper.ts +572 -0
  148. package/src/core/record-history.ts +493 -0
  149. package/src/core/retention.ts +141 -0
  150. package/src/core/scheduler/index.ts +44 -0
  151. package/src/core/scheduler/linux.ts +125 -0
  152. package/src/core/scheduler/logs.ts +37 -0
  153. package/src/core/scheduler/mac.ts +222 -0
  154. package/src/core/scheduler/posix.ts +111 -0
  155. package/src/core/scheduler/registry.ts +93 -0
  156. package/src/core/scheduler/types.ts +67 -0
  157. package/src/core/scheduler/windows.ts +469 -0
  158. package/src/core/wrappers/bash.ts +282 -0
  159. package/src/db/history-repo.ts +396 -0
  160. package/src/db/index.ts +166 -0
  161. package/src/db/metrics-repo.ts +158 -0
  162. package/src/db/migrate.ts +322 -0
  163. package/src/db/recovery.ts +46 -0
  164. package/src/db/schema.ts +109 -0
  165. package/src/db/settings-repo.ts +31 -0
  166. package/src/db/tasks-repo.ts +162 -0
  167. package/src/db/templates-repo.ts +77 -0
  168. package/src/gui.tsx +2868 -0
  169. package/src/history.ts +107 -0
  170. package/src/index.ts +2768 -0
  171. package/src/notifications.ts +174 -0
  172. package/src/rpc.ts +999 -0
  173. package/src/schtasks.ts +75 -0
  174. package/src/server.ts +1879 -0
  175. package/src/settings.ts +228 -0
  176. package/src/shared/jobs-view.ts +38 -0
  177. package/src/skill.ts +113 -0
  178. package/src/task-transfer.ts +648 -0
  179. package/src/templates.ts +67 -0
  180. package/src/tui.tsx +46 -0
  181. package/src/types.ts +145 -0
  182. package/src/version.ts +27 -0
  183. package/src/workspaces.ts +236 -0
@@ -0,0 +1,282 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { WRAPPER_DIR } from "../../types.js";
4
+ import { shellQuote } from "../scheduler/posix.js";
5
+
6
+ /** Параметры генерации bash-обёртки. */
7
+ export interface BashWrapperOptions {
8
+ /** Безопасное имя для файла (латиница, цифры, -, _). */
9
+ sanitizedName: string;
10
+ /** Отображаемое имя задачи (может быть кириллицей). */
11
+ taskName: string;
12
+ /** Абсолютный путь к файлу с промптом. */
13
+ promptFile: string;
14
+ /** Таймаут в секундах (0 — без таймаута). */
15
+ timeoutSeconds: number;
16
+ /** Абсолютный путь к lock-файлу (рядом создаётся каталог <lock>.d). */
17
+ lockFile: string;
18
+ /** Рабочая директория задачи. */
19
+ workdir?: string;
20
+ /** Имя multi-repo workspace (для git-контекста в логе). */
21
+ workspaceName?: string;
22
+ /** Разрешённые инструменты (спринт 14, metadata-only). */
23
+ allowedTools?: string[];
24
+ /** Запрещённые инструменты (спринт 14, metadata-only). */
25
+ deniedTools?: string[];
26
+ /** Путь к файлу лога. */
27
+ logFile?: string;
28
+ /** Путь к скомпилированному record-history.js. */
29
+ recorderFile?: string;
30
+ /** Проверочная команда Quality Gate. */
31
+ qualityGate?: string;
32
+ /** LLM-модель для `opencode run --model` (если не задана — модель по умолчанию). */
33
+ model?: string;
34
+ /** Pre-flight команда: ненулевой код отменяет запуск задачи. */
35
+ beforeScript?: string;
36
+ /** Post-flight команда: выполняется даже при ошибке основной задачи. */
37
+ afterScript?: string;
38
+ }
39
+
40
+ /**
41
+ * Собирает текст bash-обёртки.
42
+ *
43
+ * Скрипт:
44
+ * 1. выставляет PATH (важно для cron, где окружение минимальное);
45
+ * 2. берёт атомарный lock через `mkdir` (аналог 'wx' в Node);
46
+ * 3. переходит в рабочую директорию проекта;
47
+ * 4. выполняет pre-flight (если задан) — при ошибке задача отменяется;
48
+ * 5. запускает `opencode run <промпт>` с перенаправлением вывода в лог;
49
+ * 6. по таймауту завершает процесс;
50
+ * 7. выполняет Quality Gate (если задан);
51
+ * 8. выполняет post-flight (если задан) — даже при ошибке задачи;
52
+ * 9. пишет историю/метрики через `node record-history.js`.
53
+ *
54
+ * Если задана модель, вызов превращается в `opencode run --model "<model>" <промпт>`.
55
+ */
56
+ export function buildBashWrapperScript(options: BashWrapperOptions): string {
57
+ const {
58
+ taskName,
59
+ promptFile,
60
+ timeoutSeconds,
61
+ lockFile,
62
+ workdir,
63
+ workspaceName,
64
+ logFile,
65
+ recorderFile,
66
+ qualityGate,
67
+ model,
68
+ beforeScript,
69
+ afterScript,
70
+ allowedTools,
71
+ deniedTools,
72
+ } = options;
73
+
74
+ const lines: string[] = [
75
+ "#!/usr/bin/env bash",
76
+ "# Сгенерировано opencode-windows-scheduler. Не редактируйте вручную:",
77
+ "# файл перезаписывается при каждом обновлении задачи.",
78
+ "set -u",
79
+ "",
80
+ `TASK_NAME=${shellQuote(taskName)}`,
81
+ `PROMPT_FILE=${shellQuote(promptFile)}`,
82
+ `LOG_FILE=${shellQuote(logFile ?? path.join(WRAPPER_DIR, "task.log"))}`,
83
+ `LOCK_FILE=${shellQuote(lockFile)}`,
84
+ `WORKDIR=${shellQuote(workdir || process.cwd())}`,
85
+ `WORKSPACE_NAME=${shellQuote(workspaceName ?? "")}`,
86
+ `TIMEOUT_SECONDS=${Number.isFinite(timeoutSeconds) ? Math.max(0, Math.floor(timeoutSeconds)) : 3600}`,
87
+ `RECORDER_FILE=${shellQuote(recorderFile ?? "")}`,
88
+ `QUALITY_GATE=${shellQuote(qualityGate ?? "")}`,
89
+ `MODEL=${shellQuote(model ?? "")}`,
90
+ `BEFORE_SCRIPT=${shellQuote(beforeScript ?? "")}`,
91
+ `AFTER_SCRIPT=${shellQuote(afterScript ?? "")}`,
92
+ `ALLOWED_TOOLS=${shellQuote((allowedTools ?? []).join(","))}`,
93
+ `DENIED_TOOLS=${shellQuote((deniedTools ?? []).join(","))}`,
94
+ "",
95
+ "# cron запускает задачи с минимальным PATH — добавляем типовые каталоги.",
96
+ 'export PATH="/opt/homebrew/bin:/usr/local/bin:$HOME/.local/bin:$HOME/.bun/bin:$PATH"',
97
+ "",
98
+ 'mkdir -p "$(dirname "$LOG_FILE")" 2>/dev/null || true',
99
+ "",
100
+ "log() {",
101
+ ' printf \'[%s] %s\\n\' "$(date \'+%Y-%m-%d %H:%M:%S\')" "$*" >> "$LOG_FILE" 2>/dev/null || true',
102
+ "}",
103
+ "",
104
+ "# Атомарная блокировка: mkdir завершается ошибкой, если каталог уже есть.",
105
+ 'if ! mkdir "$LOCK_FILE.d" 2>/dev/null; then',
106
+ ' log "[scheduler] Задача \'$TASK_NAME\' уже выполняется — пропуск запуска."',
107
+ " exit 0",
108
+ "fi",
109
+ 'cleanup() { rmdir "$LOCK_FILE.d" 2>/dev/null || rm -rf "$LOCK_FILE.d" 2>/dev/null; }',
110
+ "trap cleanup EXIT INT TERM",
111
+ "",
112
+ 'if [ -n "$WORKDIR" ] && [ -d "$WORKDIR" ]; then',
113
+ ' cd "$WORKDIR" || { log "[scheduler] Не удалось перейти в $WORKDIR"; exit 1; }',
114
+ "fi",
115
+ "",
116
+ 'if [ -n "$WORKSPACE_NAME" ]; then',
117
+ ' GIT_BRANCH="$(git -C "$WORKDIR" rev-parse --abbrev-ref HEAD 2>/dev/null || true)"',
118
+ ' GIT_REMOTE="$(git -C "$WORKDIR" remote get-url origin 2>/dev/null || true)"',
119
+ ' [ -n "$GIT_BRANCH" ] || GIT_BRANCH="-"',
120
+ ' [ -n "$GIT_REMOTE" ] || GIT_REMOTE="-"',
121
+ ' log "[workspace] name=$WORKSPACE_NAME, cwd=$WORKDIR, branch=$GIT_BRANCH, remote=$GIT_REMOTE"',
122
+ "fi",
123
+ "",
124
+ "# Role-scoped tools: ограничения фиксируются в логе. Позиция metadata-only:",
125
+ "# opencode 2.2.3 не поддерживает allow/deny флаги, поэтому запрет мы лишь",
126
+ "# логируем и предупреждаем, но не блокируем.",
127
+ 'if [ -n "$ALLOWED_TOOLS" ] || [ -n "$DENIED_TOOLS" ]; then',
128
+ ' log "[role-scoped] allowed=[$ALLOWED_TOOLS], denied=[$DENIED_TOOLS]"',
129
+ ' case ",$DENIED_TOOLS," in',
130
+ ' *",write,"*|*",edit,"*|*",bash,"*|*",apply_patch,"*|*",remove,"*)',
131
+ ' log "[role-scoped] ВНИМАНИЕ: deniedTools содержит опасные инструменты ($DENIED_TOOLS). Запрет не может быть применён автоматически (metadata-only), проверьте промпт задачи."',
132
+ " ;;",
133
+ " esac",
134
+ "fi",
135
+ "",
136
+ 'if ! command -v opencode >/dev/null 2>&1; then',
137
+ ' log "[scheduler] ОШИБКА: opencode не найден в PATH ($PATH)."',
138
+ " exit 127",
139
+ "fi",
140
+ "",
141
+ 'PROMPT="$(cat "$PROMPT_FILE" 2>/dev/null || true)"',
142
+ 'START_EPOCH="$(date +%s)"',
143
+ 'STARTED_AT="$(date -u \'+%Y-%m-%dT%H:%M:%SZ\')"',
144
+ 'EXIT_CODE=0',
145
+ 'ERROR_MESSAGE=""',
146
+ 'PRE_FLIGHT_STATUS="skipped"',
147
+ 'POST_FLIGHT_STATUS="skipped"',
148
+ 'SKIP_MAIN=0',
149
+ "",
150
+ `log "[scheduler] Запуск задачи '$TASK_NAME'..."`,
151
+ "",
152
+ "# Crash recovery: фиксируем начало до pre-flight. Если процесс убьют,",
153
+ "# останется finished_at = NULL и recovery при следующем старте пометит error.",
154
+ 'RUN_ID=""',
155
+ 'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
156
+ ' RUN_ID="$(node "$RECORDER_FILE" --start "$TASK_NAME" "$STARTED_AT" 2>> "$LOG_FILE" | tail -n 1)"',
157
+ "fi",
158
+ "",
159
+ "# Pre-flight: выполняется до основной задачи. Ненулевой код отменяет запуск.",
160
+ 'if [ -n "$BEFORE_SCRIPT" ]; then',
161
+ ' log "[scheduler] Pre-flight: $BEFORE_SCRIPT"',
162
+ ' bash -lc "$BEFORE_SCRIPT" >> "$LOG_FILE" 2>&1',
163
+ " PRE_CODE=$?",
164
+ ' if [ "$PRE_CODE" -ne 0 ]; then',
165
+ ' log "[scheduler] ОШИБКА: Pre-flight script failed (код $PRE_CODE)."',
166
+ ' PRE_FLIGHT_STATUS="error"',
167
+ ' ERROR_MESSAGE="Pre-flight script failed"',
168
+ " EXIT_CODE=1",
169
+ " SKIP_MAIN=1",
170
+ " else",
171
+ ' PRE_FLIGHT_STATUS="success"',
172
+ ' log "[scheduler] Pre-flight успешно завершён."',
173
+ " fi",
174
+ "fi",
175
+ "",
176
+ 'if [ "$SKIP_MAIN" -eq 0 ]; then',
177
+ "",
178
+ "# Модель указывается только если задана — иначе OpenCode берёт свою по умолчанию.",
179
+ "run_opencode() {",
180
+ ' if [ -n "$MODEL" ]; then',
181
+ ' opencode run --model "$MODEL" "$PROMPT"',
182
+ " else",
183
+ ' opencode run "$PROMPT"',
184
+ " fi",
185
+ "}",
186
+ "",
187
+ 'if [ "$TIMEOUT_SECONDS" -gt 0 ] 2>/dev/null; then',
188
+ ' run_opencode >> "$LOG_FILE" 2>&1 &',
189
+ " CHILD=$!",
190
+ ' ( sleep "$TIMEOUT_SECONDS"; kill -TERM "$CHILD" 2>/dev/null; sleep 5; kill -KILL "$CHILD" 2>/dev/null ) &',
191
+ " WATCHDOG=$!",
192
+ ' wait "$CHILD"',
193
+ " EXIT_CODE=$?",
194
+ ' kill "$WATCHDOG" 2>/dev/null || true',
195
+ ' wait "$WATCHDOG" 2>/dev/null || true',
196
+ "else",
197
+ ' run_opencode >> "$LOG_FILE" 2>&1',
198
+ " EXIT_CODE=$?",
199
+ "fi",
200
+ "",
201
+ 'if [ "$EXIT_CODE" -ne 0 ]; then',
202
+ ' log "[scheduler] Задача \'$TASK_NAME\' завершилась с кодом $EXIT_CODE."',
203
+ ' ERROR_MESSAGE="Код возврата $EXIT_CODE"',
204
+ "else",
205
+ ' log "[scheduler] Задача \'$TASK_NAME\' успешно завершена."',
206
+ "fi",
207
+ "",
208
+ 'if [ -n "$QUALITY_GATE" ] && [ "$EXIT_CODE" -eq 0 ]; then',
209
+ ' log "[scheduler] Запуск Quality Gate: $QUALITY_GATE"',
210
+ ' bash -lc "$QUALITY_GATE" >> "$LOG_FILE" 2>&1',
211
+ " GATE_CODE=$?",
212
+ ' if [ "$GATE_CODE" -ne 0 ]; then',
213
+ ' log "[scheduler] ОШИБКА: Quality Gate провален. Код возврата: $GATE_CODE"',
214
+ ' ERROR_MESSAGE="Quality Gate провален. Код возврата: $GATE_CODE"',
215
+ " EXIT_CODE=1",
216
+ " else",
217
+ ' log "[scheduler] Quality Gate пройден."',
218
+ " fi",
219
+ "fi",
220
+ "",
221
+ "fi # конец блока основной задачи",
222
+ "",
223
+ "# Post-flight: выполняется ВСЕГДА, даже если основная задача упала.",
224
+ 'if [ -n "$AFTER_SCRIPT" ]; then',
225
+ ' log "[scheduler] Post-flight: $AFTER_SCRIPT"',
226
+ ' bash -lc "$AFTER_SCRIPT" >> "$LOG_FILE" 2>&1',
227
+ " POST_CODE=$?",
228
+ ' if [ "$POST_CODE" -ne 0 ]; then',
229
+ ' log "[scheduler] ОШИБКА: Post-flight script failed (код $POST_CODE)."',
230
+ ' POST_FLIGHT_STATUS="error"',
231
+ ' if [ "$EXIT_CODE" -eq 0 ]; then',
232
+ ' ERROR_MESSAGE="Post-flight script failed"',
233
+ " EXIT_CODE=1",
234
+ " fi",
235
+ " else",
236
+ ' POST_FLIGHT_STATUS="success"',
237
+ ' log "[scheduler] Post-flight успешно завершён."',
238
+ " fi",
239
+ "fi",
240
+ "",
241
+ 'END_EPOCH="$(date +%s)"',
242
+ 'DURATION_MS=$(( (END_EPOCH - START_EPOCH) * 1000 ))',
243
+ 'STATUS="error"',
244
+ 'if [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
245
+ "",
246
+ 'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
247
+ ' if [ -n "$RUN_ID" ]; then',
248
+ ' node "$RECORDER_FILE" --finish "$RUN_ID" "$TASK_NAME" "$STATUS" "$DURATION_MS" "$ERROR_MESSAGE" "-" "-" "$MODEL" "$PRE_FLIGHT_STATUS" "$POST_FLIGHT_STATUS" >> "$LOG_FILE" 2>&1 || true',
249
+ " else",
250
+ ' node "$RECORDER_FILE" "$TASK_NAME" "$STATUS" "$STARTED_AT" "$DURATION_MS" "$ERROR_MESSAGE" "-" "-" "$MODEL" "$PRE_FLIGHT_STATUS" "$POST_FLIGHT_STATUS" >> "$LOG_FILE" 2>&1 || true',
251
+ " fi",
252
+ "fi",
253
+ "",
254
+ 'exit "$EXIT_CODE"',
255
+ "",
256
+ ];
257
+
258
+ return lines.join("\n");
259
+ }
260
+
261
+ /**
262
+ * Записывает per-task bash-обёртку и делает её исполняемой.
263
+ * Возвращает абсолютный путь к .sh-файлу.
264
+ */
265
+ export async function writeBashWrapper(
266
+ options: BashWrapperOptions
267
+ ): Promise<string> {
268
+ await fs.mkdir(WRAPPER_DIR, { recursive: true });
269
+ const scriptPath = path.join(
270
+ WRAPPER_DIR,
271
+ `run-${options.sanitizedName}.sh`
272
+ );
273
+ const script = buildBashWrapperScript(options);
274
+ await fs.writeFile(scriptPath, script, "utf8");
275
+ await fs.chmod(scriptPath, 0o755);
276
+ return scriptPath;
277
+ }
278
+
279
+ /** Путь к bash-обёртке задачи (для диагностики/тестов). */
280
+ export function bashWrapperPath(sanitizedName: string): string {
281
+ return path.join(WRAPPER_DIR, `run-${sanitizedName}.sh`);
282
+ }
@@ -0,0 +1,396 @@
1
+ import { getDb, withTransaction } from "./index.js";
2
+ import { incrementMetricsUnsafe } from "./metrics-repo.js";
3
+ import type { TaskStatus } from "../history.js";
4
+
5
+ /**
6
+ * История запусков.
7
+ *
8
+ * completed-запись пишется одной транзакцией вместе с инкрементом метрик.
9
+ * Незавершённые запуски (finished_at IS NULL) при старте помечаются как error
10
+ * в crash recovery.
11
+ */
12
+
13
+ export type HistoryStatus = TaskStatus | "running";
14
+
15
+ export interface StoredHistoryRecord {
16
+ id?: number;
17
+ taskName: string;
18
+ status: HistoryStatus;
19
+ startedAt: string;
20
+ finishedAt?: string | null;
21
+ durationMs?: number | null;
22
+ error?: string | null;
23
+ nextTask?: string | null;
24
+ tokens?: number;
25
+ costUsd?: number;
26
+ model?: string;
27
+ preFlightStatus?: "success" | "error" | "skipped";
28
+ postFlightStatus?: "success" | "error" | "skipped";
29
+ workspaceId?: string | null;
30
+ allowedTools?: string[] | null;
31
+ deniedTools?: string[] | null;
32
+ }
33
+
34
+ /** Поля, которые пишутся в history при завершении запуска. */
35
+ export interface RunResult {
36
+ taskName: string;
37
+ status: TaskStatus;
38
+ startedAt: string;
39
+ durationMs: number;
40
+ error?: string | null;
41
+ nextTask?: string | null;
42
+ tokens?: number;
43
+ costUsd?: number;
44
+ model?: string;
45
+ preFlightStatus?: "success" | "error" | "skipped";
46
+ postFlightStatus?: "success" | "error" | "skipped";
47
+ finishedAt?: string;
48
+ }
49
+
50
+ function rowToRecord(row: any): StoredHistoryRecord {
51
+ const status = String(row.status) as HistoryStatus;
52
+ return {
53
+ id: Number(row.id),
54
+ taskName: String(row.task_name),
55
+ status,
56
+ startedAt: String(row.started_at),
57
+ finishedAt: row.finished_at == null ? null : String(row.finished_at),
58
+ durationMs: row.duration_ms == null ? null : Number(row.duration_ms),
59
+ error: row.error == null ? null : String(row.error),
60
+ nextTask: row.next_task == null ? null : String(row.next_task),
61
+ tokens: row.tokens == null ? undefined : Number(row.tokens),
62
+ costUsd: row.cost_usd == null ? undefined : Number(row.cost_usd),
63
+ model: row.model == null ? undefined : String(row.model),
64
+ preFlightStatus:
65
+ row.pre_flight_status == null
66
+ ? undefined
67
+ : (String(row.pre_flight_status) as "success" | "error" | "skipped"),
68
+ postFlightStatus:
69
+ row.post_flight_status == null
70
+ ? undefined
71
+ : (String(row.post_flight_status) as "success" | "error" | "skipped"),
72
+ workspaceId: row.workspace_id == null ? null : String(row.workspace_id),
73
+ allowedTools: row.allowed_tools == null ? null : JSON.parse(String(row.allowed_tools)),
74
+ deniedTools: row.denied_tools == null ? null : JSON.parse(String(row.denied_tools)),
75
+ };
76
+ }
77
+
78
+ const INSERT_SQL = `INSERT INTO history (
79
+ task_name, status, started_at, finished_at, duration_ms, error,
80
+ tokens, cost_usd, model, pre_flight_status, post_flight_status, next_task,
81
+ workspace_id, allowed_tools, denied_tools
82
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
83
+
84
+ function lastId(result: { lastInsertRowid: number | bigint }): number {
85
+ return Number(result.lastInsertRowid) || 0;
86
+ }
87
+
88
+ /** Вставляет запись истории без инкремента метрик (совместимость с appendHistory). */
89
+ export function insertHistory(record: StoredHistoryRecord): number {
90
+ const result = getDb()
91
+ .prepare(INSERT_SQL)
92
+ .run(
93
+ record.taskName,
94
+ record.status,
95
+ record.startedAt,
96
+ record.finishedAt ?? null,
97
+ record.durationMs ?? null,
98
+ record.error ?? null,
99
+ record.tokens ?? null,
100
+ record.costUsd ?? null,
101
+ record.model ?? null,
102
+ record.preFlightStatus ?? null,
103
+ record.postFlightStatus ?? null,
104
+ record.nextTask ?? null,
105
+ record.workspaceId ?? null,
106
+ record.allowedTools == null ? null : JSON.stringify(record.allowedTools),
107
+ record.deniedTools == null ? null : JSON.stringify(record.deniedTools)
108
+ );
109
+ return lastId(result);
110
+ }
111
+
112
+ /** Начало запуска: строка с finished_at = NULL (переживёт сбой процесса). */
113
+ export function startRun(
114
+ taskName: string,
115
+ startedAt = new Date().toISOString(),
116
+ workspaceId?: string | null,
117
+ allowedTools?: string[] | null,
118
+ deniedTools?: string[] | null
119
+ ): number {
120
+ return insertHistory({
121
+ taskName,
122
+ status: "running",
123
+ startedAt,
124
+ finishedAt: null,
125
+ workspaceId,
126
+ allowedTools,
127
+ deniedTools,
128
+ });
129
+ }
130
+
131
+ /**
132
+ * Завершает ранее начатый запуск и инкрементирует метрики.
133
+ * Возвращает false, если запись уже завершена/не найдена (защита от двойного учёта).
134
+ */
135
+ export function finishRun(
136
+ id: number,
137
+ status: TaskStatus,
138
+ durationMs: number,
139
+ error?: string | null,
140
+ nextTask?: string | null,
141
+ tokens?: number,
142
+ costUsd?: number,
143
+ model?: string,
144
+ preFlightStatus?: "success" | "error" | "skipped",
145
+ postFlightStatus?: "success" | "error" | "skipped"
146
+ ): boolean {
147
+ return withTransaction(() => {
148
+ const instance = getDb();
149
+ const row = instance
150
+ .prepare("SELECT finished_at FROM history WHERE id = ?")
151
+ .get(id) as any;
152
+ if (!row || row.finished_at != null) return false;
153
+
154
+ instance
155
+ .prepare(
156
+ `UPDATE history SET
157
+ status = ?, finished_at = ?, duration_ms = ?, error = ?, next_task = ?,
158
+ tokens = ?, cost_usd = ?, model = ?,
159
+ pre_flight_status = ?, post_flight_status = ?
160
+ WHERE id = ?`
161
+ )
162
+ .run(
163
+ status,
164
+ new Date().toISOString(),
165
+ Number.isFinite(durationMs) ? Math.max(0, Math.floor(durationMs)) : 0,
166
+ error ?? null,
167
+ nextTask ?? null,
168
+ tokens ?? null,
169
+ costUsd ?? null,
170
+ model ?? null,
171
+ preFlightStatus ?? null,
172
+ postFlightStatus ?? null,
173
+ id
174
+ );
175
+
176
+ const taskRow = instance
177
+ .prepare("SELECT task_name FROM history WHERE id = ?")
178
+ .get(id) as any;
179
+ incrementMetricsUnsafe(String(taskRow.task_name), status, tokens, costUsd);
180
+ return true;
181
+ });
182
+ }
183
+
184
+ /**
185
+ * Записывает завершённый запуск: history + metrics в одной транзакции.
186
+ * Заменяет старый recordTaskRun/recordRun.
187
+ */
188
+ export function recordRun(
189
+ taskName: string,
190
+ status: TaskStatus,
191
+ startedAt: string,
192
+ durationMs: number,
193
+ error?: string | null,
194
+ nextTask?: string | null,
195
+ tokens?: number,
196
+ costUsd?: number,
197
+ model?: string,
198
+ preFlightStatus?: "success" | "error" | "skipped",
199
+ postFlightStatus?: "success" | "error" | "skipped",
200
+ finishedAt = new Date().toISOString(),
201
+ workspaceId?: string | null,
202
+ allowedTools?: string[] | null,
203
+ deniedTools?: string[] | null
204
+ ): number {
205
+ return withTransaction(() => {
206
+ const result = getDb()
207
+ .prepare(INSERT_SQL)
208
+ .run(
209
+ taskName,
210
+ status,
211
+ startedAt,
212
+ finishedAt,
213
+ Math.max(0, Math.floor(Number(durationMs) || 0)),
214
+ error ?? null,
215
+ tokens ?? null,
216
+ costUsd ?? null,
217
+ model ?? null,
218
+ preFlightStatus ?? null,
219
+ postFlightStatus ?? null,
220
+ nextTask ?? null,
221
+ workspaceId ?? null,
222
+ allowedTools == null ? null : JSON.stringify(allowedTools),
223
+ deniedTools == null ? null : JSON.stringify(deniedTools)
224
+ );
225
+ incrementMetricsUnsafe(taskName, status, tokens, costUsd);
226
+ return lastId(result);
227
+ });
228
+ }
229
+
230
+ /** История запусков (новые сверху). Без taskName — по всем задачам. */
231
+ export function getHistory(
232
+ taskName?: string | null,
233
+ limit = 200
234
+ ): StoredHistoryRecord[] {
235
+ const safeLimit = Math.max(1, Math.min(100000, Math.floor(limit) || 1));
236
+ const instance = getDb();
237
+ const rows = taskName
238
+ ? (instance
239
+ .prepare(
240
+ `SELECT * FROM history
241
+ WHERE lower(task_name) = lower(?)
242
+ ORDER BY started_at DESC, id DESC
243
+ LIMIT ?`
244
+ )
245
+ .all(taskName, safeLimit) as any[])
246
+ : (instance
247
+ .prepare(
248
+ `SELECT * FROM history
249
+ ORDER BY started_at DESC, id DESC
250
+ LIMIT ?`
251
+ )
252
+ .all(safeLimit) as any[]);
253
+ return rows.map(rowToRecord);
254
+ }
255
+
256
+ /** История запусков, начатых не раньше timestamp (ISO-строка). */
257
+ export function getHistorySince(
258
+ timestamp: string,
259
+ limit = 5000
260
+ ): StoredHistoryRecord[] {
261
+ const safeLimit = Math.max(1, Math.min(100000, Math.floor(limit) || 1));
262
+ const rows = getDb()
263
+ .prepare(
264
+ `SELECT * FROM history
265
+ WHERE started_at >= ?
266
+ ORDER BY started_at DESC, id DESC
267
+ LIMIT ?`
268
+ )
269
+ .all(timestamp, safeLimit) as any[];
270
+ return rows.map(rowToRecord);
271
+ }
272
+
273
+ /**
274
+ * Crash recovery: все незавершённые записи (finished_at IS NULL) помечаются
275
+ * как error. Длительность считается от started_at до текущего момента.
276
+ * Возвращает количество восстановленных записей.
277
+ */
278
+ export function recoverInterrupted(): number {
279
+ const now = new Date().toISOString();
280
+ const result = getDb()
281
+ .prepare(
282
+ `UPDATE history SET
283
+ status = 'error',
284
+ error = CASE
285
+ WHEN error IS NULL OR error = '' THEN 'Прервано (сбой/перезагрузка)'
286
+ ELSE error
287
+ END,
288
+ finished_at = COALESCE(finished_at, ?),
289
+ duration_ms = COALESCE(
290
+ duration_ms,
291
+ CAST((julianday(?) - julianday(started_at)) * 86400000 AS INTEGER)
292
+ )
293
+ WHERE finished_at IS NULL`
294
+ )
295
+ .run(now, now);
296
+ return Number(result.changes) || 0;
297
+ }
298
+
299
+ /** Количество записей истории (для миграции и тестов). */
300
+ export function countHistory(): number {
301
+ const row = getDb().prepare("SELECT COUNT(*) AS count FROM history").get() as any;
302
+ return Number(row?.count) || 0;
303
+ }
304
+
305
+ /** Число активных (незавершённых) запусков: глубина очереди для /api/health. */
306
+ export function countRunningRecords(): number {
307
+ const row = getDb()
308
+ .prepare("SELECT COUNT(*) AS count FROM history WHERE finished_at IS NULL")
309
+ .get() as any;
310
+ return Number(row?.count) || 0;
311
+ }
312
+
313
+ /** Параметры очистки истории (Спринт 18). 0 — ограничение выключено. */
314
+ export interface PruneHistoryOptions {
315
+ /** Удалять завершённые записи старше N дней. */
316
+ retentionDays?: number;
317
+ /** Оставить не более N последних записей. */
318
+ maxRecords?: number;
319
+ /** Опорный момент времени (для тестов). */
320
+ now?: Date;
321
+ }
322
+
323
+ export interface PruneHistoryResult {
324
+ deletedByAge: number;
325
+ deletedByCount: number;
326
+ deleted: number;
327
+ kept: number;
328
+ /** Граница по возрасту (ISO) или null, если возраст не ограничивали. */
329
+ cutoff: string | null;
330
+ }
331
+
332
+ /**
333
+ * Чистит сырую историю: по возрасту и/или по количеству записей.
334
+ *
335
+ * Незавершённые запуски (`finished_at IS NULL`) не удаляются никогда — их
336
+ * обрабатывает crash recovery. Агрегаты в таблице metrics не трогаются:
337
+ * ретеншн чистит детали, а не статистику.
338
+ */
339
+ export function pruneHistory(options: PruneHistoryOptions = {}): PruneHistoryResult {
340
+ const instance = getDb();
341
+ const now = options.now ?? new Date();
342
+ let deletedByAge = 0;
343
+ let deletedByCount = 0;
344
+ let cutoff: string | null = null;
345
+
346
+ const days = Number(options.retentionDays ?? 0);
347
+ if (Number.isFinite(days) && days > 0) {
348
+ cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000).toISOString();
349
+ const result = instance
350
+ .prepare(
351
+ `DELETE FROM history
352
+ WHERE finished_at IS NOT NULL AND finished_at < ?`
353
+ )
354
+ .run(cutoff);
355
+ deletedByAge = Number(result.changes) || 0;
356
+ }
357
+
358
+ const maxRecords = Number(options.maxRecords ?? 0);
359
+ if (Number.isFinite(maxRecords) && maxRecords > 0) {
360
+ const result = instance
361
+ .prepare(
362
+ `DELETE FROM history
363
+ WHERE finished_at IS NOT NULL
364
+ AND id NOT IN (
365
+ SELECT id FROM history
366
+ WHERE finished_at IS NOT NULL
367
+ ORDER BY started_at DESC, id DESC
368
+ LIMIT ?
369
+ )`
370
+ )
371
+ .run(Math.max(0, Math.floor(maxRecords)));
372
+ deletedByCount = Number(result.changes) || 0;
373
+ }
374
+
375
+ return {
376
+ deletedByAge,
377
+ deletedByCount,
378
+ deleted: deletedByAge + deletedByCount,
379
+ kept: countHistory(),
380
+ cutoff,
381
+ };
382
+ }
383
+
384
+ /**
385
+ * Освобождает место после массового удаления. `PRAGMA incremental_vacuum`
386
+ * работает только при auto_vacuum = INCREMENTAL; иначе это no-op, поэтому
387
+ * вызов безопасен и не требует проверки режима.
388
+ */
389
+ export function vacuumHistory(): boolean {
390
+ try {
391
+ getDb().exec("PRAGMA incremental_vacuum");
392
+ return true;
393
+ } catch {
394
+ return false;
395
+ }
396
+ }