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,223 @@
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
+ *
8
+ * Скрипт:
9
+ * 1. выставляет PATH (важно для cron, где окружение минимальное);
10
+ * 2. берёт атомарный lock через `mkdir` (аналог 'wx' в Node);
11
+ * 3. переходит в рабочую директорию проекта;
12
+ * 4. выполняет pre-flight (если задан) — при ошибке задача отменяется;
13
+ * 5. запускает `opencode run <промпт>` с перенаправлением вывода в лог;
14
+ * 6. по таймауту завершает процесс;
15
+ * 7. выполняет Quality Gate (если задан);
16
+ * 8. выполняет post-flight (если задан) — даже при ошибке задачи;
17
+ * 9. пишет историю/метрики через `node record-history.js`.
18
+ *
19
+ * Если задана модель, вызов превращается в `opencode run --model "<model>" <промпт>`.
20
+ */
21
+ export function buildBashWrapperScript(options) {
22
+ const { taskName, promptFile, timeoutSeconds, lockFile, workdir, workspaceName, logFile, recorderFile, qualityGate, model, beforeScript, afterScript, allowedTools, deniedTools, } = options;
23
+ const lines = [
24
+ "#!/usr/bin/env bash",
25
+ "# Сгенерировано opencode-windows-scheduler. Не редактируйте вручную:",
26
+ "# файл перезаписывается при каждом обновлении задачи.",
27
+ "set -u",
28
+ "",
29
+ `TASK_NAME=${shellQuote(taskName)}`,
30
+ `PROMPT_FILE=${shellQuote(promptFile)}`,
31
+ `LOG_FILE=${shellQuote(logFile ?? path.join(WRAPPER_DIR, "task.log"))}`,
32
+ `LOCK_FILE=${shellQuote(lockFile)}`,
33
+ `WORKDIR=${shellQuote(workdir || process.cwd())}`,
34
+ `WORKSPACE_NAME=${shellQuote(workspaceName ?? "")}`,
35
+ `TIMEOUT_SECONDS=${Number.isFinite(timeoutSeconds) ? Math.max(0, Math.floor(timeoutSeconds)) : 3600}`,
36
+ `RECORDER_FILE=${shellQuote(recorderFile ?? "")}`,
37
+ `QUALITY_GATE=${shellQuote(qualityGate ?? "")}`,
38
+ `MODEL=${shellQuote(model ?? "")}`,
39
+ `BEFORE_SCRIPT=${shellQuote(beforeScript ?? "")}`,
40
+ `AFTER_SCRIPT=${shellQuote(afterScript ?? "")}`,
41
+ `ALLOWED_TOOLS=${shellQuote((allowedTools ?? []).join(","))}`,
42
+ `DENIED_TOOLS=${shellQuote((deniedTools ?? []).join(","))}`,
43
+ "",
44
+ "# cron запускает задачи с минимальным PATH — добавляем типовые каталоги.",
45
+ 'export PATH="/opt/homebrew/bin:/usr/local/bin:$HOME/.local/bin:$HOME/.bun/bin:$PATH"',
46
+ "",
47
+ 'mkdir -p "$(dirname "$LOG_FILE")" 2>/dev/null || true',
48
+ "",
49
+ "log() {",
50
+ ' printf \'[%s] %s\\n\' "$(date \'+%Y-%m-%d %H:%M:%S\')" "$*" >> "$LOG_FILE" 2>/dev/null || true',
51
+ "}",
52
+ "",
53
+ "# Атомарная блокировка: mkdir завершается ошибкой, если каталог уже есть.",
54
+ 'if ! mkdir "$LOCK_FILE.d" 2>/dev/null; then',
55
+ ' log "[scheduler] Задача \'$TASK_NAME\' уже выполняется — пропуск запуска."',
56
+ " exit 0",
57
+ "fi",
58
+ 'cleanup() { rmdir "$LOCK_FILE.d" 2>/dev/null || rm -rf "$LOCK_FILE.d" 2>/dev/null; }',
59
+ "trap cleanup EXIT INT TERM",
60
+ "",
61
+ 'if [ -n "$WORKDIR" ] && [ -d "$WORKDIR" ]; then',
62
+ ' cd "$WORKDIR" || { log "[scheduler] Не удалось перейти в $WORKDIR"; exit 1; }',
63
+ "fi",
64
+ "",
65
+ 'if [ -n "$WORKSPACE_NAME" ]; then',
66
+ ' GIT_BRANCH="$(git -C "$WORKDIR" rev-parse --abbrev-ref HEAD 2>/dev/null || true)"',
67
+ ' GIT_REMOTE="$(git -C "$WORKDIR" remote get-url origin 2>/dev/null || true)"',
68
+ ' [ -n "$GIT_BRANCH" ] || GIT_BRANCH="-"',
69
+ ' [ -n "$GIT_REMOTE" ] || GIT_REMOTE="-"',
70
+ ' log "[workspace] name=$WORKSPACE_NAME, cwd=$WORKDIR, branch=$GIT_BRANCH, remote=$GIT_REMOTE"',
71
+ "fi",
72
+ "",
73
+ "# Role-scoped tools: ограничения фиксируются в логе. Позиция metadata-only:",
74
+ "# opencode 2.2.3 не поддерживает allow/deny флаги, поэтому запрет мы лишь",
75
+ "# логируем и предупреждаем, но не блокируем.",
76
+ 'if [ -n "$ALLOWED_TOOLS" ] || [ -n "$DENIED_TOOLS" ]; then',
77
+ ' log "[role-scoped] allowed=[$ALLOWED_TOOLS], denied=[$DENIED_TOOLS]"',
78
+ ' case ",$DENIED_TOOLS," in',
79
+ ' *",write,"*|*",edit,"*|*",bash,"*|*",apply_patch,"*|*",remove,"*)',
80
+ ' log "[role-scoped] ВНИМАНИЕ: deniedTools содержит опасные инструменты ($DENIED_TOOLS). Запрет не может быть применён автоматически (metadata-only), проверьте промпт задачи."',
81
+ " ;;",
82
+ " esac",
83
+ "fi",
84
+ "",
85
+ 'if ! command -v opencode >/dev/null 2>&1; then',
86
+ ' log "[scheduler] ОШИБКА: opencode не найден в PATH ($PATH)."',
87
+ " exit 127",
88
+ "fi",
89
+ "",
90
+ 'PROMPT="$(cat "$PROMPT_FILE" 2>/dev/null || true)"',
91
+ 'START_EPOCH="$(date +%s)"',
92
+ 'STARTED_AT="$(date -u \'+%Y-%m-%dT%H:%M:%SZ\')"',
93
+ 'EXIT_CODE=0',
94
+ 'ERROR_MESSAGE=""',
95
+ 'PRE_FLIGHT_STATUS="skipped"',
96
+ 'POST_FLIGHT_STATUS="skipped"',
97
+ 'SKIP_MAIN=0',
98
+ "",
99
+ `log "[scheduler] Запуск задачи '$TASK_NAME'..."`,
100
+ "",
101
+ "# Crash recovery: фиксируем начало до pre-flight. Если процесс убьют,",
102
+ "# останется finished_at = NULL и recovery при следующем старте пометит error.",
103
+ 'RUN_ID=""',
104
+ 'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
105
+ ' RUN_ID="$(node "$RECORDER_FILE" --start "$TASK_NAME" "$STARTED_AT" 2>> "$LOG_FILE" | tail -n 1)"',
106
+ "fi",
107
+ "",
108
+ "# Pre-flight: выполняется до основной задачи. Ненулевой код отменяет запуск.",
109
+ 'if [ -n "$BEFORE_SCRIPT" ]; then',
110
+ ' log "[scheduler] Pre-flight: $BEFORE_SCRIPT"',
111
+ ' bash -lc "$BEFORE_SCRIPT" >> "$LOG_FILE" 2>&1',
112
+ " PRE_CODE=$?",
113
+ ' if [ "$PRE_CODE" -ne 0 ]; then',
114
+ ' log "[scheduler] ОШИБКА: Pre-flight script failed (код $PRE_CODE)."',
115
+ ' PRE_FLIGHT_STATUS="error"',
116
+ ' ERROR_MESSAGE="Pre-flight script failed"',
117
+ " EXIT_CODE=1",
118
+ " SKIP_MAIN=1",
119
+ " else",
120
+ ' PRE_FLIGHT_STATUS="success"',
121
+ ' log "[scheduler] Pre-flight успешно завершён."',
122
+ " fi",
123
+ "fi",
124
+ "",
125
+ 'if [ "$SKIP_MAIN" -eq 0 ]; then',
126
+ "",
127
+ "# Модель указывается только если задана — иначе OpenCode берёт свою по умолчанию.",
128
+ "run_opencode() {",
129
+ ' if [ -n "$MODEL" ]; then',
130
+ ' opencode run --model "$MODEL" "$PROMPT"',
131
+ " else",
132
+ ' opencode run "$PROMPT"',
133
+ " fi",
134
+ "}",
135
+ "",
136
+ 'if [ "$TIMEOUT_SECONDS" -gt 0 ] 2>/dev/null; then',
137
+ ' run_opencode >> "$LOG_FILE" 2>&1 &',
138
+ " CHILD=$!",
139
+ ' ( sleep "$TIMEOUT_SECONDS"; kill -TERM "$CHILD" 2>/dev/null; sleep 5; kill -KILL "$CHILD" 2>/dev/null ) &',
140
+ " WATCHDOG=$!",
141
+ ' wait "$CHILD"',
142
+ " EXIT_CODE=$?",
143
+ ' kill "$WATCHDOG" 2>/dev/null || true',
144
+ ' wait "$WATCHDOG" 2>/dev/null || true',
145
+ "else",
146
+ ' run_opencode >> "$LOG_FILE" 2>&1',
147
+ " EXIT_CODE=$?",
148
+ "fi",
149
+ "",
150
+ 'if [ "$EXIT_CODE" -ne 0 ]; then',
151
+ ' log "[scheduler] Задача \'$TASK_NAME\' завершилась с кодом $EXIT_CODE."',
152
+ ' ERROR_MESSAGE="Код возврата $EXIT_CODE"',
153
+ "else",
154
+ ' log "[scheduler] Задача \'$TASK_NAME\' успешно завершена."',
155
+ "fi",
156
+ "",
157
+ 'if [ -n "$QUALITY_GATE" ] && [ "$EXIT_CODE" -eq 0 ]; then',
158
+ ' log "[scheduler] Запуск Quality Gate: $QUALITY_GATE"',
159
+ ' bash -lc "$QUALITY_GATE" >> "$LOG_FILE" 2>&1',
160
+ " GATE_CODE=$?",
161
+ ' if [ "$GATE_CODE" -ne 0 ]; then',
162
+ ' log "[scheduler] ОШИБКА: Quality Gate провален. Код возврата: $GATE_CODE"',
163
+ ' ERROR_MESSAGE="Quality Gate провален. Код возврата: $GATE_CODE"',
164
+ " EXIT_CODE=1",
165
+ " else",
166
+ ' log "[scheduler] Quality Gate пройден."',
167
+ " fi",
168
+ "fi",
169
+ "",
170
+ "fi # конец блока основной задачи",
171
+ "",
172
+ "# Post-flight: выполняется ВСЕГДА, даже если основная задача упала.",
173
+ 'if [ -n "$AFTER_SCRIPT" ]; then',
174
+ ' log "[scheduler] Post-flight: $AFTER_SCRIPT"',
175
+ ' bash -lc "$AFTER_SCRIPT" >> "$LOG_FILE" 2>&1',
176
+ " POST_CODE=$?",
177
+ ' if [ "$POST_CODE" -ne 0 ]; then',
178
+ ' log "[scheduler] ОШИБКА: Post-flight script failed (код $POST_CODE)."',
179
+ ' POST_FLIGHT_STATUS="error"',
180
+ ' if [ "$EXIT_CODE" -eq 0 ]; then',
181
+ ' ERROR_MESSAGE="Post-flight script failed"',
182
+ " EXIT_CODE=1",
183
+ " fi",
184
+ " else",
185
+ ' POST_FLIGHT_STATUS="success"',
186
+ ' log "[scheduler] Post-flight успешно завершён."',
187
+ " fi",
188
+ "fi",
189
+ "",
190
+ 'END_EPOCH="$(date +%s)"',
191
+ 'DURATION_MS=$(( (END_EPOCH - START_EPOCH) * 1000 ))',
192
+ 'STATUS="error"',
193
+ 'if [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
194
+ "",
195
+ 'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
196
+ ' if [ -n "$RUN_ID" ]; then',
197
+ ' 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',
198
+ " else",
199
+ ' node "$RECORDER_FILE" "$TASK_NAME" "$STATUS" "$STARTED_AT" "$DURATION_MS" "$ERROR_MESSAGE" "-" "-" "$MODEL" "$PRE_FLIGHT_STATUS" "$POST_FLIGHT_STATUS" >> "$LOG_FILE" 2>&1 || true',
200
+ " fi",
201
+ "fi",
202
+ "",
203
+ 'exit "$EXIT_CODE"',
204
+ "",
205
+ ];
206
+ return lines.join("\n");
207
+ }
208
+ /**
209
+ * Записывает per-task bash-обёртку и делает её исполняемой.
210
+ * Возвращает абсолютный путь к .sh-файлу.
211
+ */
212
+ export async function writeBashWrapper(options) {
213
+ await fs.mkdir(WRAPPER_DIR, { recursive: true });
214
+ const scriptPath = path.join(WRAPPER_DIR, `run-${options.sanitizedName}.sh`);
215
+ const script = buildBashWrapperScript(options);
216
+ await fs.writeFile(scriptPath, script, "utf8");
217
+ await fs.chmod(scriptPath, 0o755);
218
+ return scriptPath;
219
+ }
220
+ /** Путь к bash-обёртке задачи (для диагностики/тестов). */
221
+ export function bashWrapperPath(sanitizedName) {
222
+ return path.join(WRAPPER_DIR, `run-${sanitizedName}.sh`);
223
+ }
@@ -0,0 +1,102 @@
1
+ import type { TaskStatus } from "../history.js";
2
+ /**
3
+ * История запусков.
4
+ *
5
+ * completed-запись пишется одной транзакцией вместе с инкрементом метрик.
6
+ * Незавершённые запуски (finished_at IS NULL) при старте помечаются как error
7
+ * в crash recovery.
8
+ */
9
+ export type HistoryStatus = TaskStatus | "running";
10
+ export interface StoredHistoryRecord {
11
+ id?: number;
12
+ taskName: string;
13
+ status: HistoryStatus;
14
+ startedAt: string;
15
+ finishedAt?: string | null;
16
+ durationMs?: number | null;
17
+ error?: string | null;
18
+ nextTask?: string | null;
19
+ tokens?: number;
20
+ costUsd?: number;
21
+ model?: string;
22
+ preFlightStatus?: "success" | "error" | "skipped";
23
+ postFlightStatus?: "success" | "error" | "skipped";
24
+ workspaceId?: string | null;
25
+ allowedTools?: string[] | null;
26
+ deniedTools?: string[] | null;
27
+ }
28
+ /** Поля, которые пишутся в history при завершении запуска. */
29
+ export interface RunResult {
30
+ taskName: string;
31
+ status: TaskStatus;
32
+ startedAt: string;
33
+ durationMs: number;
34
+ error?: string | null;
35
+ nextTask?: string | null;
36
+ tokens?: number;
37
+ costUsd?: number;
38
+ model?: string;
39
+ preFlightStatus?: "success" | "error" | "skipped";
40
+ postFlightStatus?: "success" | "error" | "skipped";
41
+ finishedAt?: string;
42
+ }
43
+ /** Вставляет запись истории без инкремента метрик (совместимость с appendHistory). */
44
+ export declare function insertHistory(record: StoredHistoryRecord): number;
45
+ /** Начало запуска: строка с finished_at = NULL (переживёт сбой процесса). */
46
+ export declare function startRun(taskName: string, startedAt?: string, workspaceId?: string | null, allowedTools?: string[] | null, deniedTools?: string[] | null): number;
47
+ /**
48
+ * Завершает ранее начатый запуск и инкрементирует метрики.
49
+ * Возвращает false, если запись уже завершена/не найдена (защита от двойного учёта).
50
+ */
51
+ export declare function finishRun(id: number, status: TaskStatus, durationMs: number, error?: string | null, nextTask?: string | null, tokens?: number, costUsd?: number, model?: string, preFlightStatus?: "success" | "error" | "skipped", postFlightStatus?: "success" | "error" | "skipped"): boolean;
52
+ /**
53
+ * Записывает завершённый запуск: history + metrics в одной транзакции.
54
+ * Заменяет старый recordTaskRun/recordRun.
55
+ */
56
+ export declare function recordRun(taskName: string, status: TaskStatus, startedAt: string, durationMs: number, error?: string | null, nextTask?: string | null, tokens?: number, costUsd?: number, model?: string, preFlightStatus?: "success" | "error" | "skipped", postFlightStatus?: "success" | "error" | "skipped", finishedAt?: string, workspaceId?: string | null, allowedTools?: string[] | null, deniedTools?: string[] | null): number;
57
+ /** История запусков (новые сверху). Без taskName — по всем задачам. */
58
+ export declare function getHistory(taskName?: string | null, limit?: number): StoredHistoryRecord[];
59
+ /** История запусков, начатых не раньше timestamp (ISO-строка). */
60
+ export declare function getHistorySince(timestamp: string, limit?: number): StoredHistoryRecord[];
61
+ /**
62
+ * Crash recovery: все незавершённые записи (finished_at IS NULL) помечаются
63
+ * как error. Длительность считается от started_at до текущего момента.
64
+ * Возвращает количество восстановленных записей.
65
+ */
66
+ export declare function recoverInterrupted(): number;
67
+ /** Количество записей истории (для миграции и тестов). */
68
+ export declare function countHistory(): number;
69
+ /** Число активных (незавершённых) запусков: глубина очереди для /api/health. */
70
+ export declare function countRunningRecords(): number;
71
+ /** Параметры очистки истории (Спринт 18). 0 — ограничение выключено. */
72
+ export interface PruneHistoryOptions {
73
+ /** Удалять завершённые записи старше N дней. */
74
+ retentionDays?: number;
75
+ /** Оставить не более N последних записей. */
76
+ maxRecords?: number;
77
+ /** Опорный момент времени (для тестов). */
78
+ now?: Date;
79
+ }
80
+ export interface PruneHistoryResult {
81
+ deletedByAge: number;
82
+ deletedByCount: number;
83
+ deleted: number;
84
+ kept: number;
85
+ /** Граница по возрасту (ISO) или null, если возраст не ограничивали. */
86
+ cutoff: string | null;
87
+ }
88
+ /**
89
+ * Чистит сырую историю: по возрасту и/или по количеству записей.
90
+ *
91
+ * Незавершённые запуски (`finished_at IS NULL`) не удаляются никогда — их
92
+ * обрабатывает crash recovery. Агрегаты в таблице metrics не трогаются:
93
+ * ретеншн чистит детали, а не статистику.
94
+ */
95
+ export declare function pruneHistory(options?: PruneHistoryOptions): PruneHistoryResult;
96
+ /**
97
+ * Освобождает место после массового удаления. `PRAGMA incremental_vacuum`
98
+ * работает только при auto_vacuum = INCREMENTAL; иначе это no-op, поэтому
99
+ * вызов безопасен и не требует проверки режима.
100
+ */
101
+ export declare function vacuumHistory(): boolean;
102
+ //# sourceMappingURL=history-repo.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"history-repo.d.ts","sourceRoot":"","sources":["../../src/db/history-repo.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,215 @@
1
+ import { getDb, withTransaction } from "./index.js";
2
+ import { incrementMetricsUnsafe } from "./metrics-repo.js";
3
+ function rowToRecord(row) {
4
+ const status = String(row.status);
5
+ return {
6
+ id: Number(row.id),
7
+ taskName: String(row.task_name),
8
+ status,
9
+ startedAt: String(row.started_at),
10
+ finishedAt: row.finished_at == null ? null : String(row.finished_at),
11
+ durationMs: row.duration_ms == null ? null : Number(row.duration_ms),
12
+ error: row.error == null ? null : String(row.error),
13
+ nextTask: row.next_task == null ? null : String(row.next_task),
14
+ tokens: row.tokens == null ? undefined : Number(row.tokens),
15
+ costUsd: row.cost_usd == null ? undefined : Number(row.cost_usd),
16
+ model: row.model == null ? undefined : String(row.model),
17
+ preFlightStatus: row.pre_flight_status == null
18
+ ? undefined
19
+ : String(row.pre_flight_status),
20
+ postFlightStatus: row.post_flight_status == null
21
+ ? undefined
22
+ : String(row.post_flight_status),
23
+ workspaceId: row.workspace_id == null ? null : String(row.workspace_id),
24
+ allowedTools: row.allowed_tools == null ? null : JSON.parse(String(row.allowed_tools)),
25
+ deniedTools: row.denied_tools == null ? null : JSON.parse(String(row.denied_tools)),
26
+ };
27
+ }
28
+ const INSERT_SQL = `INSERT INTO history (
29
+ task_name, status, started_at, finished_at, duration_ms, error,
30
+ tokens, cost_usd, model, pre_flight_status, post_flight_status, next_task,
31
+ workspace_id, allowed_tools, denied_tools
32
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
33
+ function lastId(result) {
34
+ return Number(result.lastInsertRowid) || 0;
35
+ }
36
+ /** Вставляет запись истории без инкремента метрик (совместимость с appendHistory). */
37
+ export function insertHistory(record) {
38
+ const result = getDb()
39
+ .prepare(INSERT_SQL)
40
+ .run(record.taskName, record.status, record.startedAt, record.finishedAt ?? null, record.durationMs ?? null, record.error ?? null, record.tokens ?? null, record.costUsd ?? null, record.model ?? null, record.preFlightStatus ?? null, record.postFlightStatus ?? null, record.nextTask ?? null, record.workspaceId ?? null, record.allowedTools == null ? null : JSON.stringify(record.allowedTools), record.deniedTools == null ? null : JSON.stringify(record.deniedTools));
41
+ return lastId(result);
42
+ }
43
+ /** Начало запуска: строка с finished_at = NULL (переживёт сбой процесса). */
44
+ export function startRun(taskName, startedAt = new Date().toISOString(), workspaceId, allowedTools, deniedTools) {
45
+ return insertHistory({
46
+ taskName,
47
+ status: "running",
48
+ startedAt,
49
+ finishedAt: null,
50
+ workspaceId,
51
+ allowedTools,
52
+ deniedTools,
53
+ });
54
+ }
55
+ /**
56
+ * Завершает ранее начатый запуск и инкрементирует метрики.
57
+ * Возвращает false, если запись уже завершена/не найдена (защита от двойного учёта).
58
+ */
59
+ export function finishRun(id, status, durationMs, error, nextTask, tokens, costUsd, model, preFlightStatus, postFlightStatus) {
60
+ return withTransaction(() => {
61
+ const instance = getDb();
62
+ const row = instance
63
+ .prepare("SELECT finished_at FROM history WHERE id = ?")
64
+ .get(id);
65
+ if (!row || row.finished_at != null)
66
+ return false;
67
+ instance
68
+ .prepare(`UPDATE history SET
69
+ status = ?, finished_at = ?, duration_ms = ?, error = ?, next_task = ?,
70
+ tokens = ?, cost_usd = ?, model = ?,
71
+ pre_flight_status = ?, post_flight_status = ?
72
+ WHERE id = ?`)
73
+ .run(status, new Date().toISOString(), Number.isFinite(durationMs) ? Math.max(0, Math.floor(durationMs)) : 0, error ?? null, nextTask ?? null, tokens ?? null, costUsd ?? null, model ?? null, preFlightStatus ?? null, postFlightStatus ?? null, id);
74
+ const taskRow = instance
75
+ .prepare("SELECT task_name FROM history WHERE id = ?")
76
+ .get(id);
77
+ incrementMetricsUnsafe(String(taskRow.task_name), status, tokens, costUsd);
78
+ return true;
79
+ });
80
+ }
81
+ /**
82
+ * Записывает завершённый запуск: history + metrics в одной транзакции.
83
+ * Заменяет старый recordTaskRun/recordRun.
84
+ */
85
+ export function recordRun(taskName, status, startedAt, durationMs, error, nextTask, tokens, costUsd, model, preFlightStatus, postFlightStatus, finishedAt = new Date().toISOString(), workspaceId, allowedTools, deniedTools) {
86
+ return withTransaction(() => {
87
+ const result = getDb()
88
+ .prepare(INSERT_SQL)
89
+ .run(taskName, status, startedAt, finishedAt, Math.max(0, Math.floor(Number(durationMs) || 0)), error ?? null, tokens ?? null, costUsd ?? null, model ?? null, preFlightStatus ?? null, postFlightStatus ?? null, nextTask ?? null, workspaceId ?? null, allowedTools == null ? null : JSON.stringify(allowedTools), deniedTools == null ? null : JSON.stringify(deniedTools));
90
+ incrementMetricsUnsafe(taskName, status, tokens, costUsd);
91
+ return lastId(result);
92
+ });
93
+ }
94
+ /** История запусков (новые сверху). Без taskName — по всем задачам. */
95
+ export function getHistory(taskName, limit = 200) {
96
+ const safeLimit = Math.max(1, Math.min(100000, Math.floor(limit) || 1));
97
+ const instance = getDb();
98
+ const rows = taskName
99
+ ? instance
100
+ .prepare(`SELECT * FROM history
101
+ WHERE lower(task_name) = lower(?)
102
+ ORDER BY started_at DESC, id DESC
103
+ LIMIT ?`)
104
+ .all(taskName, safeLimit)
105
+ : instance
106
+ .prepare(`SELECT * FROM history
107
+ ORDER BY started_at DESC, id DESC
108
+ LIMIT ?`)
109
+ .all(safeLimit);
110
+ return rows.map(rowToRecord);
111
+ }
112
+ /** История запусков, начатых не раньше timestamp (ISO-строка). */
113
+ export function getHistorySince(timestamp, limit = 5000) {
114
+ const safeLimit = Math.max(1, Math.min(100000, Math.floor(limit) || 1));
115
+ const rows = getDb()
116
+ .prepare(`SELECT * FROM history
117
+ WHERE started_at >= ?
118
+ ORDER BY started_at DESC, id DESC
119
+ LIMIT ?`)
120
+ .all(timestamp, safeLimit);
121
+ return rows.map(rowToRecord);
122
+ }
123
+ /**
124
+ * Crash recovery: все незавершённые записи (finished_at IS NULL) помечаются
125
+ * как error. Длительность считается от started_at до текущего момента.
126
+ * Возвращает количество восстановленных записей.
127
+ */
128
+ export function recoverInterrupted() {
129
+ const now = new Date().toISOString();
130
+ const result = getDb()
131
+ .prepare(`UPDATE history SET
132
+ status = 'error',
133
+ error = CASE
134
+ WHEN error IS NULL OR error = '' THEN 'Прервано (сбой/перезагрузка)'
135
+ ELSE error
136
+ END,
137
+ finished_at = COALESCE(finished_at, ?),
138
+ duration_ms = COALESCE(
139
+ duration_ms,
140
+ CAST((julianday(?) - julianday(started_at)) * 86400000 AS INTEGER)
141
+ )
142
+ WHERE finished_at IS NULL`)
143
+ .run(now, now);
144
+ return Number(result.changes) || 0;
145
+ }
146
+ /** Количество записей истории (для миграции и тестов). */
147
+ export function countHistory() {
148
+ const row = getDb().prepare("SELECT COUNT(*) AS count FROM history").get();
149
+ return Number(row?.count) || 0;
150
+ }
151
+ /** Число активных (незавершённых) запусков: глубина очереди для /api/health. */
152
+ export function countRunningRecords() {
153
+ const row = getDb()
154
+ .prepare("SELECT COUNT(*) AS count FROM history WHERE finished_at IS NULL")
155
+ .get();
156
+ return Number(row?.count) || 0;
157
+ }
158
+ /**
159
+ * Чистит сырую историю: по возрасту и/или по количеству записей.
160
+ *
161
+ * Незавершённые запуски (`finished_at IS NULL`) не удаляются никогда — их
162
+ * обрабатывает crash recovery. Агрегаты в таблице metrics не трогаются:
163
+ * ретеншн чистит детали, а не статистику.
164
+ */
165
+ export function pruneHistory(options = {}) {
166
+ const instance = getDb();
167
+ const now = options.now ?? new Date();
168
+ let deletedByAge = 0;
169
+ let deletedByCount = 0;
170
+ let cutoff = null;
171
+ const days = Number(options.retentionDays ?? 0);
172
+ if (Number.isFinite(days) && days > 0) {
173
+ cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000).toISOString();
174
+ const result = instance
175
+ .prepare(`DELETE FROM history
176
+ WHERE finished_at IS NOT NULL AND finished_at < ?`)
177
+ .run(cutoff);
178
+ deletedByAge = Number(result.changes) || 0;
179
+ }
180
+ const maxRecords = Number(options.maxRecords ?? 0);
181
+ if (Number.isFinite(maxRecords) && maxRecords > 0) {
182
+ const result = instance
183
+ .prepare(`DELETE FROM history
184
+ WHERE finished_at IS NOT NULL
185
+ AND id NOT IN (
186
+ SELECT id FROM history
187
+ WHERE finished_at IS NOT NULL
188
+ ORDER BY started_at DESC, id DESC
189
+ LIMIT ?
190
+ )`)
191
+ .run(Math.max(0, Math.floor(maxRecords)));
192
+ deletedByCount = Number(result.changes) || 0;
193
+ }
194
+ return {
195
+ deletedByAge,
196
+ deletedByCount,
197
+ deleted: deletedByAge + deletedByCount,
198
+ kept: countHistory(),
199
+ cutoff,
200
+ };
201
+ }
202
+ /**
203
+ * Освобождает место после массового удаления. `PRAGMA incremental_vacuum`
204
+ * работает только при auto_vacuum = INCREMENTAL; иначе это no-op, поэтому
205
+ * вызов безопасен и не требует проверки режима.
206
+ */
207
+ export function vacuumHistory() {
208
+ try {
209
+ getDb().exec("PRAGMA incremental_vacuum");
210
+ return true;
211
+ }
212
+ catch {
213
+ return false;
214
+ }
215
+ }
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Подключение к SQLite через встроенный `node:sqlite` (Node 22.5+).
3
+ *
4
+ * Мы не импортируем модуль статически: в @types/node 20 типов для node:sqlite
5
+ * ещё нет, а `createRequire` позволяет получить модуль без объявления
6
+ * глобального ambient-модуля (и не конфликтовать с будущими версиями типов).
7
+ */
8
+ export interface SqliteRunResult {
9
+ changes: number | bigint;
10
+ lastInsertRowid: number | bigint;
11
+ }
12
+ export interface SqliteStatement {
13
+ run(...params: any[]): SqliteRunResult;
14
+ get(...params: any[]): any;
15
+ all(...params: any[]): any[];
16
+ iterate(...params: any[]): IterableIterator<any>;
17
+ }
18
+ export interface SqliteDatabase {
19
+ exec(sql: string): void;
20
+ prepare(sql: string): SqliteStatement;
21
+ close(): void;
22
+ }
23
+ /** Открывает (или переоткрывает) соединение и применяет схему. */
24
+ export declare function initDb(file?: string): SqliteDatabase;
25
+ /** Singleton-соединение. Создаётся лениво при первом обращении. */
26
+ export declare function getDb(): SqliteDatabase;
27
+ /** Закрывает соединение (вызывается при выгрузке плагина). */
28
+ export declare function closeDb(): void;
29
+ /** Текущий путь к файлу БД. */
30
+ export declare function getDbFile(): string;
31
+ /** Сбрасывает WAL в основной файл — нужно перед отдачей .db наружу. */
32
+ export declare function checkpointDb(): void;
33
+ /** Информация о хранилище для /api/health и футера дашборда. */
34
+ export declare function getDbStatus(): {
35
+ engine: "sqlite";
36
+ file: string;
37
+ journalMode: string;
38
+ wal: boolean;
39
+ };
40
+ /**
41
+ * Выполняет функцию в транзакции BEGIN IMMEDIATE.
42
+ * При любой ошибке откатывает изменения и пробрасывает исключение дальше.
43
+ */
44
+ export declare function withTransaction<T>(fn: () => T): T;
45
+ /** Пуста ли БД (не считая служебных настроек вроде retry_state). */
46
+ export declare function isDatabaseEmpty(): boolean;
47
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,eAAe,CAAC;IACvC,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC3B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAC7B,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;CACf;AA6BD,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAe,GAAG,cAAc,CAkB5D;AAED,mEAAmE;AACnE,wBAAgB,KAAK,IAAI,cAAc,CAEtC;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,IAAI,IAAI,CAa9B;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,uEAAuE;AACvE,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,gEAAgE;AAChE,wBAAgB,WAAW,IAAI;IAC7B,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;CACd,CAcA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAejD;AAED,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,OAAO,CAWzC"}