agent-steward 0.0.4 → 0.0.5

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 (190) hide show
  1. package/CHANGELOG.md +134 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +52 -7
  4. package/ROADMAP-STRATEGY.md +21 -18
  5. package/ROADMAP.md +140 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +351 -0
  9. package/dist/core/execution.d.ts +203 -0
  10. package/dist/core/execution.d.ts.map +1 -0
  11. package/dist/core/execution.js +309 -0
  12. package/dist/core/gate-integrity.d.ts +35 -0
  13. package/dist/core/gate-integrity.d.ts.map +1 -0
  14. package/dist/core/gate-integrity.js +132 -0
  15. package/dist/core/git-trigger.d.ts.map +1 -1
  16. package/dist/core/git-trigger.js +14 -2
  17. package/dist/core/guard-run.d.ts +4 -0
  18. package/dist/core/guard-run.d.ts.map +1 -0
  19. package/dist/core/guard-run.js +101 -0
  20. package/dist/core/guard.d.ts +52 -0
  21. package/dist/core/guard.d.ts.map +1 -0
  22. package/dist/core/guard.js +362 -0
  23. package/dist/core/lock.d.ts +41 -0
  24. package/dist/core/lock.d.ts.map +1 -1
  25. package/dist/core/lock.js +141 -29
  26. package/dist/core/matrix.d.ts.map +1 -1
  27. package/dist/core/matrix.js +75 -15
  28. package/dist/core/mission.d.ts +83 -0
  29. package/dist/core/mission.d.ts.map +1 -0
  30. package/dist/core/mission.js +334 -0
  31. package/dist/core/pipeline-apply.d.ts +38 -0
  32. package/dist/core/pipeline-apply.d.ts.map +1 -0
  33. package/dist/core/pipeline-apply.js +117 -0
  34. package/dist/core/pipeline-io.d.ts +13 -0
  35. package/dist/core/pipeline-io.d.ts.map +1 -0
  36. package/dist/core/pipeline-io.js +64 -0
  37. package/dist/core/pipeline-map.d.ts +46 -0
  38. package/dist/core/pipeline-map.d.ts.map +1 -0
  39. package/dist/core/pipeline-map.js +196 -0
  40. package/dist/core/pipeline-spec.d.ts +109 -0
  41. package/dist/core/pipeline-spec.d.ts.map +1 -0
  42. package/dist/core/pipeline-spec.js +554 -0
  43. package/dist/core/ps-wrapper.d.ts +19 -2
  44. package/dist/core/ps-wrapper.d.ts.map +1 -1
  45. package/dist/core/ps-wrapper.js +250 -62
  46. package/dist/core/record-history.d.ts.map +1 -1
  47. package/dist/core/record-history.js +130 -29
  48. package/dist/core/router/rules.d.ts.map +1 -1
  49. package/dist/core/router/rules.js +6 -0
  50. package/dist/core/scheduler/linux.d.ts +8 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +34 -9
  53. package/dist/core/scheduler/mac.d.ts +44 -2
  54. package/dist/core/scheduler/mac.d.ts.map +1 -1
  55. package/dist/core/scheduler/mac.js +126 -15
  56. package/dist/core/scheduler/windows.d.ts.map +1 -1
  57. package/dist/core/scheduler/windows.js +15 -12
  58. package/dist/core/structured-log.d.ts +7 -1
  59. package/dist/core/structured-log.d.ts.map +1 -1
  60. package/dist/core/worktree-run.d.ts +4 -0
  61. package/dist/core/worktree-run.d.ts.map +1 -0
  62. package/dist/core/worktree-run.js +164 -0
  63. package/dist/core/worktree.d.ts +115 -0
  64. package/dist/core/worktree.d.ts.map +1 -0
  65. package/dist/core/worktree.js +462 -0
  66. package/dist/core/wrappers/bash.d.ts +17 -0
  67. package/dist/core/wrappers/bash.d.ts.map +1 -1
  68. package/dist/core/wrappers/bash.js +175 -24
  69. package/dist/db/capability-repo.d.ts +43 -2
  70. package/dist/db/capability-repo.d.ts.map +1 -1
  71. package/dist/db/capability-repo.js +96 -11
  72. package/dist/db/history-repo.d.ts +38 -5
  73. package/dist/db/history-repo.d.ts.map +1 -1
  74. package/dist/db/history-repo.js +88 -25
  75. package/dist/db/metrics-repo.js +2 -2
  76. package/dist/db/recovery.d.ts.map +1 -1
  77. package/dist/db/recovery.js +5 -4
  78. package/dist/db/run-journal.d.ts +33 -5
  79. package/dist/db/run-journal.d.ts.map +1 -1
  80. package/dist/db/run-journal.js +78 -14
  81. package/dist/db/run-resume.d.ts +5 -0
  82. package/dist/db/run-resume.d.ts.map +1 -1
  83. package/dist/db/run-resume.js +9 -2
  84. package/dist/db/runs-repo.d.ts +19 -2
  85. package/dist/db/runs-repo.d.ts.map +1 -1
  86. package/dist/db/runs-repo.js +22 -6
  87. package/dist/db/schema.d.ts +2 -2
  88. package/dist/db/schema.d.ts.map +1 -1
  89. package/dist/db/schema.js +63 -2
  90. package/dist/history.d.ts +1 -1
  91. package/dist/history.d.ts.map +1 -1
  92. package/dist/i18n.d.ts +5 -0
  93. package/dist/i18n.d.ts.map +1 -1
  94. package/dist/i18n.js +11 -4
  95. package/dist/index.d.ts +136 -2
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.js +378 -14
  98. package/dist/notifications.d.ts +22 -0
  99. package/dist/notifications.d.ts.map +1 -1
  100. package/dist/notifications.js +36 -8
  101. package/dist/profiles.d.ts.map +1 -1
  102. package/dist/profiles.js +25 -4
  103. package/dist/rpc.d.ts +246 -0
  104. package/dist/rpc.d.ts.map +1 -1
  105. package/dist/rpc.js +117 -0
  106. package/dist/server.d.ts +15 -0
  107. package/dist/server.d.ts.map +1 -1
  108. package/dist/server.js +77 -18
  109. package/dist/settings.d.ts +2 -2
  110. package/dist/settings.d.ts.map +1 -1
  111. package/dist/settings.js +3 -3
  112. package/dist/shared/jobs-view.d.ts +1 -1
  113. package/dist/shared/jobs-view.d.ts.map +1 -1
  114. package/dist/shared/jobs-view.js +2 -0
  115. package/dist/task-transfer.d.ts +16 -0
  116. package/dist/task-transfer.d.ts.map +1 -1
  117. package/dist/task-transfer.js +16 -0
  118. package/docs/ARCHITECTURE.md +281 -65
  119. package/docs/COMPATIBILITY.md +2 -2
  120. package/docs/CONCEPT.md +18 -4
  121. package/docs/CROSS_PLATFORM.ru.md +20 -0
  122. package/docs/CROSS_PLATFORM.zh.md +18 -0
  123. package/docs/EXECUTION-LOOP.md +22 -7
  124. package/docs/FEATURES.md +65 -4
  125. package/docs/FEATURES.zh.md +52 -4
  126. package/docs/MIGRATION.md +2 -2
  127. package/docs/PIPELINE.md +293 -0
  128. package/docs/README.ru.md +42 -3
  129. package/docs/README.zh.md +43 -3
  130. package/docs/SAFETY.md +23 -3
  131. package/gui-experimental.cjs +9 -8
  132. package/locales/en.json +17 -1
  133. package/locales/ru.json +17 -1
  134. package/locales/zh.json +17 -1
  135. package/opencode.pipeline.yaml +35 -0
  136. package/package.json +23 -4
  137. package/scripts/test-home.mjs +83 -0
  138. package/src/cli.ts +412 -0
  139. package/src/core/dry-run.ts +2 -2
  140. package/src/core/execution.ts +538 -0
  141. package/src/core/file-watcher.ts +2 -2
  142. package/src/core/gate-integrity.ts +160 -0
  143. package/src/core/git-trigger.ts +18 -5
  144. package/src/core/guard-run.ts +119 -0
  145. package/src/core/guard.ts +431 -0
  146. package/src/core/lock.ts +178 -37
  147. package/src/core/matrix.ts +95 -50
  148. package/src/core/mission.ts +485 -0
  149. package/src/core/native-notify.ts +1 -1
  150. package/src/core/pipeline-apply.ts +158 -0
  151. package/src/core/pipeline-io.ts +79 -0
  152. package/src/core/pipeline-map.ts +264 -0
  153. package/src/core/pipeline-spec.ts +775 -0
  154. package/src/core/ps-wrapper.ts +263 -63
  155. package/src/core/record-history.ts +164 -77
  156. package/src/core/router/rules.ts +6 -0
  157. package/src/core/schedule-gate.ts +1 -1
  158. package/src/core/scheduler/at-fallback.ts +1 -1
  159. package/src/core/scheduler/linux.ts +40 -11
  160. package/src/core/scheduler/logs.ts +2 -2
  161. package/src/core/scheduler/mac.ts +174 -14
  162. package/src/core/scheduler/registry.ts +2 -2
  163. package/src/core/scheduler/windows.ts +19 -15
  164. package/src/core/secrets.ts +8 -8
  165. package/src/core/structured-log.ts +22 -5
  166. package/src/core/telegram.ts +2 -2
  167. package/src/core/triage-worker.ts +7 -7
  168. package/src/core/triage.ts +2 -2
  169. package/src/core/worktree-run.ts +199 -0
  170. package/src/core/worktree.ts +600 -0
  171. package/src/core/wrappers/bash.ts +190 -23
  172. package/src/db/capability-repo.ts +127 -10
  173. package/src/db/history-repo.ts +129 -22
  174. package/src/db/metrics-repo.ts +2 -2
  175. package/src/db/recovery.ts +5 -4
  176. package/src/db/run-journal.ts +100 -13
  177. package/src/db/run-resume.ts +17 -1
  178. package/src/db/runs-repo.ts +36 -6
  179. package/src/db/schema.ts +65 -2
  180. package/src/gui.tsx +177 -13
  181. package/src/history.ts +1 -1
  182. package/src/i18n.ts +12 -4
  183. package/src/index.ts +524 -4
  184. package/src/notifications.ts +38 -8
  185. package/src/profiles.ts +26 -4
  186. package/src/rpc.ts +128 -0
  187. package/src/server.ts +94 -18
  188. package/src/settings.ts +5 -5
  189. package/src/shared/jobs-view.ts +3 -1
  190. package/src/task-transfer.ts +31 -0
@@ -1,8 +1,11 @@
1
1
  import fs from "node:fs/promises";
2
+ import fsSync from "node:fs";
2
3
  import path from "node:path";
3
4
  import { WRAPPER_DIR } from "../../types.js";
4
5
  import { shellQuote } from "../scheduler/posix.js";
5
6
  import type { ScheduleGateSpec } from "../schedule-v2.js";
7
+ import type { TaskGuards } from "../guard.js";
8
+ import { createGateSnapshot } from "../gate-integrity.js";
6
9
  import {
7
10
  buildOpencodeConfig as buildPermissionsConfig,
8
11
  formatPolicyLog,
@@ -76,8 +79,34 @@ export interface BashWrapperOptions {
76
79
  * 0 — без таймаута. Зависший хук не должен держать lock.
77
80
  */
78
81
  gateTimeoutSeconds?: number;
82
+ /** W-1 (0.0.6): запустить задачу в одноразовом git worktree. */
83
+ worktree?: boolean;
84
+ /** Путь к dist/core/worktree-run.js (обязателен при worktree=true). */
85
+ worktreeHelper?: string;
86
+ /** W-3 (0.0.6): guard-условия перед запуском opencode. */
87
+ guards?: TaskGuards;
88
+ /** Путь к dist/core/guard-run.js (обязателен при guards). */
89
+ guardHelper?: string;
79
90
  }
80
91
 
92
+ /**
93
+ * B6: разбор PID из lock-токена для bash-обёртки.
94
+ *
95
+ * Понимает единый `<pid>-<iso>` (Node и PS), legacy PS `<iso>|<pid>`
96
+ * и голый `<pid>` (pid-файл самой bash-обёртки). Legacy PS проверяется
97
+ * первым: иначе год из ISO был бы принят за PID.
98
+ */
99
+ export const BASH_LOCK_PID_FUNCTION = `parse_lock_pid() {
100
+ local text="$1"
101
+ case "$text" in
102
+ *"|"*) printf '%s' "\${text##*|}" ;;
103
+ [0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]T*) printf '' ;;
104
+ [0-9]*-*) printf '%s' "\${text%%-*}" ;;
105
+ [0-9]*) printf '%s' "$text" ;;
106
+ *) printf '' ;;
107
+ esac
108
+ }`;
109
+
81
110
  /**
82
111
  * Собирает текст bash-обёртки.
83
112
  *
@@ -96,6 +125,7 @@ export interface BashWrapperOptions {
96
125
  */
97
126
  export function buildBashWrapperScript(options: BashWrapperOptions): string {
98
127
  const {
128
+ sanitizedName,
99
129
  taskName,
100
130
  promptFile,
101
131
  timeoutSeconds,
@@ -119,8 +149,37 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
119
149
  scheduleGate,
120
150
  envFile,
121
151
  gateTimeoutSeconds,
152
+ worktree,
153
+ worktreeHelper,
154
+ guards,
155
+ guardHelper,
122
156
  } = options;
123
157
 
158
+ // G-1.2: фиксируем входы гейта при создании обёртки и передаём путь
159
+ // snapshot'а и помощника проверки в сгенерированный скрипт.
160
+ let gateSnapshot = "";
161
+ let gateIntegrity = "";
162
+ if (qualityGate?.trim()) {
163
+ const safeGateTimeout =
164
+ typeof gateTimeoutSeconds === "number" && Number.isFinite(gateTimeoutSeconds)
165
+ ? Math.max(0, Math.floor(gateTimeoutSeconds))
166
+ : 300;
167
+ let prompt = "";
168
+ try {
169
+ prompt = fsSync.readFileSync(promptFile || "", "utf8");
170
+ } catch {
171
+ // Промпт мог быть удалён — snapshot всё равно уникален для задачи.
172
+ }
173
+ gateSnapshot = createGateSnapshot(sanitizedName || taskName, {
174
+ gate: qualityGate,
175
+ prompt,
176
+ gateTimeoutSeconds: safeGateTimeout,
177
+ });
178
+ gateIntegrity = recorderFile
179
+ ? path.join(path.dirname(recorderFile), "gate-integrity.js")
180
+ : "";
181
+ }
182
+
124
183
  const effectivePermissions = resolvePermissions({
125
184
  policy,
126
185
  legacyShell,
@@ -139,12 +198,23 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
139
198
  `LOCK_FILE=${shellQuote(lockFile)}`,
140
199
  `WORKDIR=${shellQuote(workdir || process.cwd())}`,
141
200
  `WORKSPACE_NAME=${shellQuote(workspaceName ?? "")}`,
201
+ // W-1 (0.0.6): одноразовый git worktree на запуск.
202
+ `WORKTREE_MODE=${worktree ? 1 : 0}`,
203
+ `WORKTREE_HELPER=${shellQuote(worktreeHelper ?? "")}`,
204
+ // W-3 (0.0.6): guard-условия. Пустая строка = guard не настроен.
205
+ `GUARD_HELPER=${shellQuote(guardHelper ?? "")}`,
206
+ `GUARD_B64=${shellQuote(guards ? Buffer.from(JSON.stringify(guards), "utf8").toString("base64") : "")}`,
207
+ // W-4 (0.0.6): причина пропуска в history (fixed, без произвольного текста из лога).
208
+ `GUARD_SKIP_B64=${shellQuote(Buffer.from("guard conditions not met", "utf8").toString("base64"))}`,
142
209
  `TIMEOUT_SECONDS=${Number.isFinite(timeoutSeconds) ? Math.max(0, Math.floor(timeoutSeconds)) : 3600}`,
143
210
  // Маркер сработавшего watchdog: по нему обёртка отличает таймаут от
144
211
  // обычного ненулевого кода возврата (SIGTERM/SIGKILL неотличимы от падения).
145
212
  `TIMEOUT_MARKER=${shellQuote(`${lockFile}.timeout`)}`,
146
213
  `RECORDER_FILE=${shellQuote(recorderFile ?? "")}`,
147
214
  `QUALITY_GATE=${shellQuote(qualityGate ?? "")}`,
215
+ // G-1.2: путь к snapshot'у и CLI проверки целостности входов гейта.
216
+ `GATE_SNAPSHOT=${shellQuote(gateSnapshot)}`,
217
+ `GATE_INTEGRITY=${shellQuote(gateIntegrity)}`,
148
218
  `MODEL=${shellQuote(model ?? "")}`,
149
219
  // Спринт 24: режим сессии — "new" (по умолчанию), "reuse" (--session <id>), "last" (--continue).
150
220
  `SESSION_MODE=${shellQuote(sessionMode ?? "new")}`,
@@ -188,6 +258,8 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
188
258
  ' printf \'[%s] %s\\n\' "$(date \'+%Y-%m-%d %H:%M:%S\')" "$*" >> "$LOG_FILE" 2>/dev/null || true',
189
259
  "}",
190
260
  "",
261
+ BASH_LOCK_PID_FUNCTION,
262
+ "",
191
263
  'log "[role-scoped] opencode config passed via OPENCODE_CONFIG_CONTENT"',
192
264
  `log ${shellQuote(`[policy] ${formatPolicyLog(effectivePermissions)}`)}`,
193
265
  ...effectivePermissions.deniedByPolicy.map(
@@ -254,8 +326,35 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
254
326
  "fi",
255
327
  "",
256
328
  "# Атомарная блокировка: mkdir завершается ошибкой, если каталог уже есть.",
257
- "# В каталог пишем PID: после kill -9 осиротевший lock снимается, а не",
258
- "# блокирует задачу до истечения STALE_LOCK_MAX_AGE_MS.",
329
+ "# B6: перед своим каталогом проверяем файловый lock Node/PS (<lock>):",
330
+ "# они держат файл, а bash — каталог. Без этой проверки Node-процесс и",
331
+ "# bash-обёртка могли выполнять одну задачу одновременно.",
332
+ 'if [ -f "$LOCK_FILE" ]; then',
333
+ ' LOCK_OWNER_RAW="$(cat "$LOCK_FILE" 2>/dev/null || true)"',
334
+ ' LOCK_FILE_PID="$(parse_lock_pid "$LOCK_OWNER_RAW")"',
335
+ ' if [ -z "$LOCK_FILE_PID" ]; then',
336
+ ' log "[scheduler] Не удалось определить владельца lock — пропуск запуска."',
337
+ " exit 0",
338
+ " fi",
339
+ ' if kill -0 "$LOCK_FILE_PID" 2>/dev/null; then',
340
+ ' log "[scheduler] Задача \'$TASK_NAME\' уже выполняется (pid $LOCK_FILE_PID) — пропуск запуска."',
341
+ " exit 0",
342
+ " fi",
343
+ " # Владелец мёртв: атомарно уводим файл, чтобы не удалить lock, который",
344
+ " # другой воркер успел пересоздать.",
345
+ ' STALE_LOCK_FILE="$LOCK_FILE.stale-$$-$(date +%s)"',
346
+ ' if ! mv "$LOCK_FILE" "$STALE_LOCK_FILE" 2>/dev/null; then',
347
+ ' if [ -f "$LOCK_FILE" ]; then',
348
+ ' log "[scheduler] Не удалось вытеснить осиротевший lock \'$LOCK_FILE\' — пропуск запуска."',
349
+ " exit 0",
350
+ " fi",
351
+ " else",
352
+ ' rm -f "$STALE_LOCK_FILE" 2>/dev/null || true',
353
+ " fi",
354
+ "fi",
355
+ "",
356
+ "# B6: в pid-файл пишем `<pid>-<iso>`, а не голый PID — так его читают",
357
+ "# Node и PS общим парсером. После kill -9 lock снимается по мёртвому PID.",
259
358
  'if ! mkdir "$LOCK_FILE.d" 2>/dev/null; then',
260
359
  ' if [ ! -d "$LOCK_FILE.d" ]; then',
261
360
  ' log "[scheduler] Не удалось создать lock \'$LOCK_FILE.d\' — запуск отменён."',
@@ -263,7 +362,7 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
263
362
  " fi",
264
363
  ' LOCK_PID=""',
265
364
  ' if [ -f "$LOCK_FILE.d/pid" ]; then',
266
- ' LOCK_PID="$(cat "$LOCK_FILE.d/pid" 2>/dev/null || true)"',
365
+ ' LOCK_PID="$(parse_lock_pid "$(cat "$LOCK_FILE.d/pid" 2>/dev/null || true)")"',
267
366
  " fi",
268
367
  " LOCK_ALIVE=1",
269
368
  ' if [ -n "$LOCK_PID" ]; then',
@@ -288,14 +387,61 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
288
387
  " exit 0",
289
388
  " fi",
290
389
  "fi",
291
- 'printf \'%s\\n\' "$$" > "$LOCK_FILE.d/pid" 2>/dev/null || true',
292
- 'cleanup() { rmdir "$LOCK_FILE.d" 2>/dev/null || rm -rf "$LOCK_FILE.d" 2>/dev/null; }',
390
+ 'printf \'%s\\n\' "$$-$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$LOCK_FILE.d/pid" 2>/dev/null || true',
391
+ "cleanup_worktree() {",
392
+ " if [ -n \"${AGENT_STEWARD_WORKTREE:-}\" ] && [ -n \"$WORKTREE_HELPER\" ] && command -v node >/dev/null 2>&1; then",
393
+ " cd \"$WORKDIR\" 2>/dev/null || true",
394
+ " node \"$WORKTREE_HELPER\" cleanup --path \"$AGENT_STEWARD_WORKTREE\" --repo \"$WORKDIR\" >> \"$LOG_FILE\" 2>&1 || true",
395
+ ' AGENT_STEWARD_WORKTREE=""',
396
+ " fi",
397
+ "}",
398
+ 'cleanup() { cleanup_worktree; rmdir "$LOCK_FILE.d" 2>/dev/null || rm -rf "$LOCK_FILE.d" 2>/dev/null; }',
293
399
  "trap cleanup EXIT INT TERM",
294
400
  "",
295
401
  'if [ -n "$WORKDIR" ] && [ -d "$WORKDIR" ]; then',
296
402
  ' cd "$WORKDIR" || { log "[scheduler] Не удалось перейти в $WORKDIR"; exit 1; }',
297
403
  "fi",
298
404
  "",
405
+ "# W-1 (0.0.6): одноразовый git worktree. Ошибка создания — fail-closed:",
406
+ "# задача не должна молча работать в основном дереве репозитория.",
407
+ 'if [ "$WORKTREE_MODE" = "1" ]; then',
408
+ ' if [ -z "$WORKTREE_HELPER" ] || ! command -v node >/dev/null 2>&1; then',
409
+ ' log "[scheduler] ОШИБКА: помощник worktree недоступен (нет node или worktree-run.js). Запуск отменён."',
410
+ " exit 1",
411
+ " fi",
412
+ ' AGENT_STEWARD_WORKTREE="$(node "$WORKTREE_HELPER" --repo "$WORKDIR" --task "$TASK_NAME" 2>> "$LOG_FILE" | tail -n 1)"',
413
+ ' if [ -z "$AGENT_STEWARD_WORKTREE" ]; then',
414
+ ' log "[scheduler] ОШИБКА: не удалось создать git worktree для \'$TASK_NAME\' — запуск отменён."',
415
+ " exit 1",
416
+ " fi",
417
+ " export AGENT_STEWARD_WORKTREE",
418
+ ' export AGENT_STEWARD_WORKTREE_REPO="$WORKDIR"',
419
+ ' log "[scheduler] Git worktree: $AGENT_STEWARD_WORKTREE"',
420
+ ' cd "$AGENT_STEWARD_WORKTREE" || { log "[scheduler] Не удалось перейти в worktree $AGENT_STEWARD_WORKTREE"; exit 1; }',
421
+ "fi",
422
+ "",
423
+ ...(guards
424
+ ? [
425
+ "# W-3 (0.0.6): guard-условия до запуска opencode. Код 4 — штатный skip,",
426
+ "# ненулевой код — ошибка проверки. В обоих случаях opencode не запускается,",
427
+ "# а созданный worktree убирается через trap cleanup.",
428
+ 'if [ -n "$GUARD_HELPER" ] && [ -n "$GUARD_B64" ]; then',
429
+ ' node "$GUARD_HELPER" --cwd "$PWD" --guards-b64 "$GUARD_B64" >> "$LOG_FILE" 2>&1',
430
+ " GUARD_STATUS=$?",
431
+ ' if [ "$GUARD_STATUS" -eq 4 ]; then',
432
+ ' log "[scheduler] guard: run skipped (условия не выполнены)"',
433
+ ' if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
434
+ ' node "$RECORDER_FILE" --skip "$TASK_NAME" "$GUARD_SKIP_B64" >> "$LOG_FILE" 2>&1 || true',
435
+ " fi",
436
+ " exit 0",
437
+ ' elif [ "$GUARD_STATUS" -ne 0 ]; then',
438
+ ' log "[scheduler] ОШИБКА: guard helper завершился с кодом $GUARD_STATUS — запуск отменён."',
439
+ " exit 1",
440
+ " fi",
441
+ "fi",
442
+ "",
443
+ ]
444
+ : []),
299
445
  "# Спринт 21: env-переменные workspace. Файл пишет плагин, значения не логируются.",
300
446
  'if [ -n "$ENV_FILE" ] && [ -f "$ENV_FILE" ]; then',
301
447
  ' while IFS= read -r env_line || [ -n "$env_line" ]; do',
@@ -338,11 +484,17 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
338
484
  "fi",
339
485
  "",
340
486
  'PROMPT="$(cat "$PROMPT_FILE" 2>/dev/null || true)"',
487
+ "# W-1: сообщаем агенту, что он работает в одноразовом git worktree.",
488
+ 'if [ -n "${AGENT_STEWARD_WORKTREE:-}" ]; then',
489
+ ' PROMPT="[agent-steward] Рабочая директория запуска - одноразовый git worktree: $AGENT_STEWARD_WORKTREE',
490
+ '$PROMPT"',
491
+ "fi",
341
492
  "# T-09: backstop размера промпта на POSIX (argv ограничен MAX_ARG_STRLEN",
342
- "# 128 КиБ на аргумент в Linux). Считаем байты, а не символы.",
493
+ "# 128 КиБ на аргумент в Linux). Считаем байты, а не символы. Лимит включает",
494
+ "# завершающий NUL, поэтому максимум полезных данных — 131071 байт (B11.2).",
343
495
  'PROMPT_BYTES="$(printf %s "$PROMPT" | wc -c | tr -d \' \')"',
344
- 'if [ "$PROMPT_BYTES" -gt 131072 ] 2>/dev/null; then',
345
- ' log "[scheduler] ОШИБКА: промпт слишком длинный для argv POSIX: ${PROMPT_BYTES} байт (максимум 131072)."',
496
+ 'if [ "$PROMPT_BYTES" -ge 131072 ] 2>/dev/null; then',
497
+ ' log "[scheduler] ОШИБКА: промпт слишком длинный для argv POSIX: ${PROMPT_BYTES} байт (максимум 131071)."',
346
498
  " exit 1",
347
499
  "fi",
348
500
  'START_EPOCH="$(date +%s)"',
@@ -393,28 +545,28 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
393
545
  " fi",
394
546
  ' if [ -n "$SESSION_ID" ]; then',
395
547
  ' if [ -n "$MODEL" ]; then',
396
- ' exec opencode run --auto --session "$SESSION_ID" --model "$MODEL" "$PROMPT"',
548
+ ' exec opencode run --auto --session "$SESSION_ID" --model "$MODEL" -- "$PROMPT"',
397
549
  " else",
398
- ' exec opencode run --auto --session "$SESSION_ID" "$PROMPT"',
550
+ ' exec opencode run --auto --session "$SESSION_ID" -- "$PROMPT"',
399
551
  " fi",
400
552
  " else",
401
553
  ' if [ -n "$MODEL" ]; then',
402
- ' exec opencode run --auto --model "$MODEL" "$PROMPT"',
554
+ ' exec opencode run --auto --model "$MODEL" -- "$PROMPT"',
403
555
  " else",
404
- ' exec opencode run --auto "$PROMPT"',
556
+ ' exec opencode run --auto -- "$PROMPT"',
405
557
  " fi",
406
558
  " fi",
407
559
  ' elif [ "$SESSION_MODE" = "last" ]; then',
408
560
  ' if [ -n "$MODEL" ]; then',
409
- ' exec opencode run --auto --continue --model "$MODEL" "$PROMPT"',
561
+ ' exec opencode run --auto --continue --model "$MODEL" -- "$PROMPT"',
410
562
  " else",
411
- ' exec opencode run --auto --continue "$PROMPT"',
563
+ ' exec opencode run --auto --continue -- "$PROMPT"',
412
564
  " fi",
413
565
  " else",
414
566
  ' if [ -n "$MODEL" ]; then',
415
- ' exec opencode run --auto --model "$MODEL" "$PROMPT"',
567
+ ' exec opencode run --auto --model "$MODEL" -- "$PROMPT"',
416
568
  " else",
417
- ' exec opencode run --auto "$PROMPT"',
569
+ ' exec opencode run --auto -- "$PROMPT"',
418
570
  " fi",
419
571
  " fi",
420
572
  "}",
@@ -471,15 +623,30 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
471
623
  "fi",
472
624
  "",
473
625
  'if [ -n "$QUALITY_GATE" ] && [ "$EXIT_CODE" -eq 0 ]; then',
474
- ' log "[scheduler] Запуск Quality Gate: $QUALITY_GATE"',
475
- ' run_with_timeout "$GATE_TIMEOUT_SECONDS" bash -c "$QUALITY_GATE" >> "$LOG_FILE" 2>&1',
476
- " GATE_CODE=$?",
477
- ' if [ "$GATE_CODE" -ne 0 ]; then',
478
- ' log "[scheduler] ОШИБКА: Quality Gate провален. Код возврата: $GATE_CODE"',
479
- ' ERROR_MESSAGE="Quality Gate провален. Код возврата: $GATE_CODE"',
626
+ // G-1.2: сверяем входы гейта со snapshot'ом, снятым при создании задачи.
627
+ " GATE_INTEGRITY_OK=1",
628
+ ' if [ -n "$GATE_SNAPSHOT" ] && [ -n "$GATE_INTEGRITY" ] && [ -f "$GATE_SNAPSHOT" ] && [ -f "$GATE_INTEGRITY" ]; then',
629
+ ' node "$GATE_INTEGRITY" verify --snapshot "$GATE_SNAPSHOT" --gate-command "$QUALITY_GATE" --prompt-file "$PROMPT_FILE" --timeout "$GATE_TIMEOUT_SECONDS" >> "$LOG_FILE" 2>&1',
630
+ " VERIFY_CODE=$?",
631
+ ' if [ "$VERIFY_CODE" -ne 0 ]; then GATE_INTEGRITY_OK=0; fi',
632
+ " else",
633
+ " GATE_INTEGRITY_OK=0",
634
+ " fi",
635
+ ' if [ "$GATE_INTEGRITY_OK" -eq 0 ]; then',
636
+ ' log "[scheduler] ОШИБКА: целостность входов Quality Gate нарушена (snapshot mismatch)."',
637
+ ' ERROR_MESSAGE="Quality Gate: целостность входов нарушена (snapshot mismatch)"',
480
638
  " EXIT_CODE=1",
481
639
  " else",
482
- ' log "[scheduler] Quality Gate пройден."',
640
+ ' log "[scheduler] Запуск Quality Gate: $QUALITY_GATE"',
641
+ ' run_with_timeout "$GATE_TIMEOUT_SECONDS" bash -c "$QUALITY_GATE" >> "$LOG_FILE" 2>&1',
642
+ " GATE_CODE=$?",
643
+ ' if [ "$GATE_CODE" -ne 0 ]; then',
644
+ ' log "[scheduler] ОШИБКА: Quality Gate провален. Код возврата: $GATE_CODE"',
645
+ ' ERROR_MESSAGE="Quality Gate провален. Код возврата: $GATE_CODE"',
646
+ " EXIT_CODE=1",
647
+ " else",
648
+ ' log "[scheduler] Quality Gate пройден."',
649
+ " fi",
483
650
  " fi",
484
651
  "fi",
485
652
  "",
@@ -31,13 +31,33 @@ export const MIN_RUNS_FOR_DECISION = 3;
31
31
  /** Сколько последних исходов хранить (1 — гейт пройден, 0 — провал). */
32
32
  export const RECENT_RUNS_LIMIT = 10;
33
33
 
34
+ /**
35
+ * B13: полураспад веса исхода в последних прогонах. Исход давностью
36
+ * `SUCCESS_HALF_LIFE_RUNS` прогонов весит вдвое меньше свежего.
37
+ */
38
+ export const SUCCESS_HALF_LIFE_RUNS = 8;
39
+
40
+ /** B13: доля затухающего success rate в итоговой надёжности. */
41
+ export const DECAY_WEIGHT = 0.7;
42
+
43
+ /** B13: доля first-pass rate в итоговой надёжности. */
44
+ export const FIRST_PASS_WEIGHT = 0.3;
45
+
34
46
  export interface CapabilityRecord {
35
47
  taskType: string;
36
48
  /** Исполнитель, который последним обрабатывал тип задачи. */
37
49
  model: string;
38
50
  runsTotal: number;
39
51
  runsPassed: number;
52
+ /** B13: сколько успехов получено с первой попытки. */
53
+ firstPassCount: number;
54
+ /** B13: first_pass_count / runs_total. */
55
+ firstPassRate: number;
40
56
  successRate: number;
57
+ /** B13: success rate последних прогонов с экспоненциальным затуханием. */
58
+ decayedSuccessRate: number;
59
+ /** B13: 0.7 * decayedSuccessRate + 0.3 * firstPassRate — вход маршрутизации. */
60
+ effectiveSuccessRate: number;
41
61
  avgCostUsd: number;
42
62
  avgTimeMs: number;
43
63
  /** Последние исходы, старые слева, новые справа, максимум 10. */
@@ -53,6 +73,10 @@ export interface CapabilityOutcome {
53
73
  passed: boolean;
54
74
  costUsd?: number;
55
75
  timeMs?: number;
76
+ /** B13: число попыток до исхода (1 — с первой). */
77
+ attempts?: number;
78
+ /** B13: явный признак first-pass; по умолчанию passed && attempts <= 1. */
79
+ firstPass?: boolean;
56
80
  }
57
81
 
58
82
  export interface CapabilityThresholds {
@@ -67,6 +91,12 @@ export interface CapabilityDecision {
67
91
  /** Машиночитаемая причина: no-data | local-reliable | escalate | review. */
68
92
  reason: "no-data" | "local-reliable" | "escalate" | "review";
69
93
  successRate: number;
94
+ /** B13: надёжность с учётом затухания и first-pass, по ней принимается решение. */
95
+ effectiveSuccessRate: number;
96
+ /** B13: затухающий success rate последних прогонов. */
97
+ decayedSuccessRate: number;
98
+ /** B13: доля успехов с первой попытки. */
99
+ firstPassRate: number;
70
100
  runsTotal: number;
71
101
  capability: CapabilityRecord | null;
72
102
  }
@@ -91,6 +121,14 @@ function requireNonNegative(value: number, field: string): number {
91
121
  return value;
92
122
  }
93
123
 
124
+ /** B13: номер попытки — целое ≥ 1. */
125
+ function requireAttempts(value: number): number {
126
+ if (!Number.isInteger(value) || value < 1) {
127
+ throw new Error(`Некорректное значение attempts: ожидалось целое ≥ 1, получено ${value}.`);
128
+ }
129
+ return value;
130
+ }
131
+
94
132
  function parseRecentRuns(raw: unknown): number[] {
95
133
  if (typeof raw !== "string" || raw.trim() === "") {
96
134
  return [];
@@ -109,18 +147,64 @@ function parseRecentRuns(raw: unknown): number[] {
109
147
  }
110
148
  }
111
149
 
150
+ /**
151
+ * B13: экспоненциально взвешенный success rate последних исходов.
152
+ *
153
+ * Свежий исход весит 1, исход давностью `halfLife` прогонов — 0.5.
154
+ * Так старые успехи не перевешивают свежие провалы, а `last_10_runs`
155
+ * участвует в решении, а не только хранится для отчёта.
156
+ */
157
+ export function decayedSuccessRate(
158
+ runs: number[],
159
+ halfLife: number = SUCCESS_HALF_LIFE_RUNS,
160
+ ): number {
161
+ const recent = runs
162
+ .filter((value) => value === 0 || value === 1)
163
+ .slice(-RECENT_RUNS_LIMIT);
164
+ if (recent.length === 0) return 0;
165
+ const hl = Number.isFinite(halfLife) && halfLife > 0 ? halfLife : SUCCESS_HALF_LIFE_RUNS;
166
+ let weighted = 0;
167
+ let weights = 0;
168
+ recent.forEach((value, index) => {
169
+ const age = recent.length - 1 - index;
170
+ const weight = Math.pow(0.5, age / hl);
171
+ weighted += weight * value;
172
+ weights += weight;
173
+ });
174
+ return weights > 0 ? weighted / weights : 0;
175
+ }
176
+
177
+ /** B13: надёжность для маршрутизации — затухание плюс успех с первой попытки. */
178
+ export function effectiveReliability(decayedRate: number, firstPassRate: number): number {
179
+ const decayed = Math.min(1, Math.max(0, decayedRate));
180
+ const firstPass = Math.min(1, Math.max(0, firstPassRate));
181
+ return DECAY_WEIGHT * decayed + FIRST_PASS_WEIGHT * firstPass;
182
+ }
183
+
112
184
  function rowToRecord(row: Record<string, unknown>): CapabilityRecord {
113
185
  const runsTotal = Number(row.runs_total) || 0;
114
186
  const runsPassed = Number(row.runs_passed) || 0;
187
+ const successRate =
188
+ Number(row.success_rate) || (runsTotal > 0 ? runsPassed / runsTotal : 0);
189
+ const firstPassCount = Number(row.first_pass_count) || 0;
190
+ const firstPassRate =
191
+ runsTotal > 0 ? Math.min(1, firstPassCount / runsTotal) : 0;
192
+ const last10Runs = parseRecentRuns(row.last_10_runs);
193
+ const decayed =
194
+ last10Runs.length > 0 ? decayedSuccessRate(last10Runs) : successRate;
115
195
  return {
116
196
  taskType: String(row.task_type),
117
197
  model: String(row.model ?? DEFAULT_MODEL),
118
198
  runsTotal,
119
199
  runsPassed,
120
- successRate: Number(row.success_rate) || (runsTotal > 0 ? runsPassed / runsTotal : 0),
200
+ firstPassCount,
201
+ firstPassRate,
202
+ successRate,
203
+ decayedSuccessRate: decayed,
204
+ effectiveSuccessRate: effectiveReliability(decayed, firstPassRate),
121
205
  avgCostUsd: Number(row.avg_cost_usd) || 0,
122
206
  avgTimeMs: Number(row.avg_time_ms) || 0,
123
- last10Runs: parseRecentRuns(row.last_10_runs),
207
+ last10Runs,
124
208
  createdAt: String(row.created_at),
125
209
  updatedAt: String(row.updated_at),
126
210
  };
@@ -159,6 +243,16 @@ export function recordCapabilityOutcome(outcome: CapabilityOutcome): CapabilityR
159
243
  const time = outcome.timeMs === undefined ? 0 : requireNonNegative(outcome.timeMs, "timeMs");
160
244
  const model = (outcome.model ?? DEFAULT_MODEL).trim() || DEFAULT_MODEL;
161
245
  const passed = outcome.passed ? 1 : 0;
246
+ const attempts = outcome.attempts === undefined ? undefined : requireAttempts(outcome.attempts);
247
+ if (outcome.firstPass !== undefined && typeof outcome.firstPass !== "boolean") {
248
+ throw new Error("Признак firstPass должен быть boolean.");
249
+ }
250
+ // B13: без явного признака успех считается первым, если попытка одна
251
+ // (или число попыток не передано — обратная совместимость).
252
+ const firstPass =
253
+ passed === 1 &&
254
+ (outcome.firstPass ?? (attempts === undefined || attempts === 1));
255
+ const firstPassIncrement = firstPass ? 1 : 0;
162
256
 
163
257
  return withTransaction(() => {
164
258
  const db = getDb();
@@ -167,13 +261,14 @@ export function recordCapabilityOutcome(outcome: CapabilityOutcome): CapabilityR
167
261
  if (!existing) {
168
262
  db.prepare(
169
263
  `INSERT INTO capability_map (
170
- task_type, model, runs_total, runs_passed, success_rate,
264
+ task_type, model, runs_total, runs_passed, first_pass_count, success_rate,
171
265
  avg_cost_usd, avg_time_ms, last_10_runs, created_at, updated_at
172
- ) VALUES (?, ?, 1, ?, ?, ?, ?, ?, ?, ?)`,
266
+ ) VALUES (?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?)`,
173
267
  ).run(
174
268
  key,
175
269
  model,
176
270
  passed,
271
+ firstPassIncrement,
177
272
  passed,
178
273
  cost,
179
274
  time,
@@ -189,13 +284,16 @@ export function recordCapabilityOutcome(outcome: CapabilityOutcome): CapabilityR
189
284
  const recent = [...existing.last10Runs, passed].slice(-RECENT_RUNS_LIMIT);
190
285
  db.prepare(
191
286
  `UPDATE capability_map
192
- SET model = ?, runs_total = ?, runs_passed = ?, success_rate = ?,
193
- avg_cost_usd = ?, avg_time_ms = ?, last_10_runs = ?, updated_at = ?
287
+ SET model = ?, runs_total = ?, runs_passed = ?,
288
+ first_pass_count = COALESCE(first_pass_count, 0) + ?,
289
+ success_rate = ?, avg_cost_usd = ?, avg_time_ms = ?,
290
+ last_10_runs = ?, updated_at = ?
194
291
  WHERE task_type = ?`,
195
292
  ).run(
196
293
  model,
197
294
  runsTotal,
198
295
  runsPassed,
296
+ firstPassIncrement,
199
297
  runsPassed / runsTotal,
200
298
  avgCost,
201
299
  avgTime,
@@ -215,9 +313,13 @@ export function recordCapabilityOutcome(outcome: CapabilityOutcome): CapabilityR
215
313
  /**
216
314
  * Решение слоя 2 по порогам (0 токенов).
217
315
  *
316
+ * Пороги применяются к `effectiveSuccessRate` — 0.7 затухающего success rate
317
+ * последних прогонов плюс 0.3 first-pass rate (B13), а не к кумулятивному
318
+ * success rate. Поэтому старые успехи не перевешивают свежие провалы.
319
+ *
218
320
  * - данных меньше `minRuns` → `explore` (решает слой 3);
219
- * - `success_rate ≥ 0.85` → `local`;
220
- * - `success_rate ≤ 0.30` → `cloud` (эскалация);
321
+ * - `effectiveSuccessRate ≥ 0.85` → `local`;
322
+ * - `effectiveSuccessRate ≤ 0.30` → `cloud` (эскалация);
221
323
  * - между порогами → `review` (нужен человек или облачный ревьюер).
222
324
  */
223
325
  export function decideCapabilityRoute(
@@ -233,34 +335,46 @@ export function decideCapabilityRoute(
233
335
  }
234
336
 
235
337
  const capability = getCapability(key);
338
+ const effectiveSuccessRate = capability?.effectiveSuccessRate ?? 0;
339
+ const decayedSuccessRate = capability?.decayedSuccessRate ?? 0;
340
+ const firstPassRate = capability?.firstPassRate ?? 0;
236
341
  if (!capability || capability.runsTotal < minRuns) {
237
342
  return {
238
343
  taskType: key,
239
344
  target: "explore",
240
345
  reason: "no-data",
241
346
  successRate: capability?.successRate ?? 0,
347
+ effectiveSuccessRate,
348
+ decayedSuccessRate,
349
+ firstPassRate,
242
350
  runsTotal: capability?.runsTotal ?? 0,
243
351
  capability,
244
352
  };
245
353
  }
246
354
 
247
- if (capability.successRate >= localSuccess) {
355
+ if (effectiveSuccessRate >= localSuccess) {
248
356
  return {
249
357
  taskType: key,
250
358
  target: "local",
251
359
  reason: "local-reliable",
252
360
  successRate: capability.successRate,
361
+ effectiveSuccessRate,
362
+ decayedSuccessRate,
363
+ firstPassRate,
253
364
  runsTotal: capability.runsTotal,
254
365
  capability,
255
366
  };
256
367
  }
257
368
 
258
- if (capability.successRate <= cloudFailure) {
369
+ if (effectiveSuccessRate <= cloudFailure) {
259
370
  return {
260
371
  taskType: key,
261
372
  target: "cloud",
262
373
  reason: "escalate",
263
374
  successRate: capability.successRate,
375
+ effectiveSuccessRate,
376
+ decayedSuccessRate,
377
+ firstPassRate,
264
378
  runsTotal: capability.runsTotal,
265
379
  capability,
266
380
  };
@@ -271,6 +385,9 @@ export function decideCapabilityRoute(
271
385
  target: "review",
272
386
  reason: "review",
273
387
  successRate: capability.successRate,
388
+ effectiveSuccessRate,
389
+ decayedSuccessRate,
390
+ firstPassRate,
274
391
  runsTotal: capability.runsTotal,
275
392
  capability,
276
393
  };