agent-steward 0.0.4 → 0.0.6

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 (279) hide show
  1. package/CHANGELOG.md +309 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +55 -8
  4. package/ROADMAP-STRATEGY.md +22 -19
  5. package/ROADMAP.md +230 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +356 -0
  9. package/dist/core/analytics.d.ts +6 -0
  10. package/dist/core/analytics.d.ts.map +1 -1
  11. package/dist/core/analytics.js +20 -3
  12. package/dist/core/audit.d.ts +6 -0
  13. package/dist/core/audit.d.ts.map +1 -1
  14. package/dist/core/audit.js +24 -0
  15. package/dist/core/budget.d.ts +118 -0
  16. package/dist/core/budget.d.ts.map +1 -0
  17. package/dist/core/budget.js +206 -0
  18. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  19. package/dist/core/cron-to-schtasks.js +38 -0
  20. package/dist/core/dry-run.d.ts +26 -1
  21. package/dist/core/dry-run.d.ts.map +1 -1
  22. package/dist/core/dry-run.js +199 -8
  23. package/dist/core/execution.d.ts +203 -0
  24. package/dist/core/execution.d.ts.map +1 -0
  25. package/dist/core/execution.js +309 -0
  26. package/dist/core/feedback.d.ts +192 -0
  27. package/dist/core/feedback.d.ts.map +1 -0
  28. package/dist/core/feedback.js +426 -0
  29. package/dist/core/gate-integrity.d.ts +71 -0
  30. package/dist/core/gate-integrity.d.ts.map +1 -0
  31. package/dist/core/gate-integrity.js +275 -0
  32. package/dist/core/git-trigger.d.ts.map +1 -1
  33. package/dist/core/git-trigger.js +14 -2
  34. package/dist/core/guard-run.d.ts +4 -0
  35. package/dist/core/guard-run.d.ts.map +1 -0
  36. package/dist/core/guard-run.js +101 -0
  37. package/dist/core/guard.d.ts +52 -0
  38. package/dist/core/guard.d.ts.map +1 -0
  39. package/dist/core/guard.js +362 -0
  40. package/dist/core/local-ai.d.ts.map +1 -1
  41. package/dist/core/local-ai.js +7 -3
  42. package/dist/core/lock.d.ts +41 -0
  43. package/dist/core/lock.d.ts.map +1 -1
  44. package/dist/core/lock.js +141 -29
  45. package/dist/core/matrix.d.ts +8 -0
  46. package/dist/core/matrix.d.ts.map +1 -1
  47. package/dist/core/matrix.js +132 -17
  48. package/dist/core/mission.d.ts +103 -0
  49. package/dist/core/mission.d.ts.map +1 -0
  50. package/dist/core/mission.js +374 -0
  51. package/dist/core/opencode-models.d.ts +2 -2
  52. package/dist/core/opencode-models.d.ts.map +1 -1
  53. package/dist/core/opencode-models.js +28 -21
  54. package/dist/core/opencode-usage.d.ts +35 -0
  55. package/dist/core/opencode-usage.d.ts.map +1 -0
  56. package/dist/core/opencode-usage.js +132 -0
  57. package/dist/core/pipeline-apply.d.ts +38 -0
  58. package/dist/core/pipeline-apply.d.ts.map +1 -0
  59. package/dist/core/pipeline-apply.js +117 -0
  60. package/dist/core/pipeline-io.d.ts +13 -0
  61. package/dist/core/pipeline-io.d.ts.map +1 -0
  62. package/dist/core/pipeline-io.js +78 -0
  63. package/dist/core/pipeline-map.d.ts +52 -0
  64. package/dist/core/pipeline-map.d.ts.map +1 -0
  65. package/dist/core/pipeline-map.js +208 -0
  66. package/dist/core/pipeline-spec.d.ts +109 -0
  67. package/dist/core/pipeline-spec.d.ts.map +1 -0
  68. package/dist/core/pipeline-spec.js +554 -0
  69. package/dist/core/ps-wrapper.d.ts +27 -2
  70. package/dist/core/ps-wrapper.d.ts.map +1 -1
  71. package/dist/core/ps-wrapper.js +424 -65
  72. package/dist/core/record-history.d.ts.map +1 -1
  73. package/dist/core/record-history.js +206 -33
  74. package/dist/core/router/rules.d.ts.map +1 -1
  75. package/dist/core/router/rules.js +6 -0
  76. package/dist/core/run-mode.d.ts +12 -0
  77. package/dist/core/run-mode.d.ts.map +1 -0
  78. package/dist/core/run-mode.js +17 -0
  79. package/dist/core/scheduler/linux.d.ts +8 -1
  80. package/dist/core/scheduler/linux.d.ts.map +1 -1
  81. package/dist/core/scheduler/linux.js +34 -9
  82. package/dist/core/scheduler/logs.d.ts +4 -0
  83. package/dist/core/scheduler/logs.d.ts.map +1 -1
  84. package/dist/core/scheduler/logs.js +25 -1
  85. package/dist/core/scheduler/mac.d.ts +44 -2
  86. package/dist/core/scheduler/mac.d.ts.map +1 -1
  87. package/dist/core/scheduler/mac.js +126 -15
  88. package/dist/core/scheduler/windows.d.ts.map +1 -1
  89. package/dist/core/scheduler/windows.js +15 -12
  90. package/dist/core/secrets.d.ts.map +1 -1
  91. package/dist/core/secrets.js +18 -8
  92. package/dist/core/self-analysis.d.ts +32 -2
  93. package/dist/core/self-analysis.d.ts.map +1 -1
  94. package/dist/core/self-analysis.js +38 -27
  95. package/dist/core/shutdown.d.ts +33 -2
  96. package/dist/core/shutdown.d.ts.map +1 -1
  97. package/dist/core/shutdown.js +58 -2
  98. package/dist/core/structured-log.d.ts +37 -1
  99. package/dist/core/structured-log.d.ts.map +1 -1
  100. package/dist/core/structured-log.js +37 -0
  101. package/dist/core/usage-surface.d.ts +25 -0
  102. package/dist/core/usage-surface.d.ts.map +1 -0
  103. package/dist/core/usage-surface.js +41 -0
  104. package/dist/core/worktree-run.d.ts +4 -0
  105. package/dist/core/worktree-run.d.ts.map +1 -0
  106. package/dist/core/worktree-run.js +164 -0
  107. package/dist/core/worktree.d.ts +115 -0
  108. package/dist/core/worktree.d.ts.map +1 -0
  109. package/dist/core/worktree.js +462 -0
  110. package/dist/core/wrappers/bash.d.ts +19 -0
  111. package/dist/core/wrappers/bash.d.ts.map +1 -1
  112. package/dist/core/wrappers/bash.js +230 -27
  113. package/dist/db/capability-repo.d.ts +43 -2
  114. package/dist/db/capability-repo.d.ts.map +1 -1
  115. package/dist/db/capability-repo.js +96 -11
  116. package/dist/db/history-repo.d.ts +70 -5
  117. package/dist/db/history-repo.d.ts.map +1 -1
  118. package/dist/db/history-repo.js +170 -29
  119. package/dist/db/metrics-repo.d.ts +20 -2
  120. package/dist/db/metrics-repo.d.ts.map +1 -1
  121. package/dist/db/metrics-repo.js +35 -13
  122. package/dist/db/migrate.d.ts.map +1 -1
  123. package/dist/db/migrate.js +37 -17
  124. package/dist/db/recovery.d.ts +3 -1
  125. package/dist/db/recovery.d.ts.map +1 -1
  126. package/dist/db/recovery.js +11 -5
  127. package/dist/db/run-journal.d.ts +33 -5
  128. package/dist/db/run-journal.d.ts.map +1 -1
  129. package/dist/db/run-journal.js +78 -14
  130. package/dist/db/run-resume.d.ts +5 -0
  131. package/dist/db/run-resume.d.ts.map +1 -1
  132. package/dist/db/run-resume.js +9 -2
  133. package/dist/db/runs-repo.d.ts +19 -2
  134. package/dist/db/runs-repo.d.ts.map +1 -1
  135. package/dist/db/runs-repo.js +91 -60
  136. package/dist/db/schema.d.ts +2 -2
  137. package/dist/db/schema.d.ts.map +1 -1
  138. package/dist/db/schema.js +132 -2
  139. package/dist/db/templates-repo.d.ts +2 -2
  140. package/dist/db/templates-repo.d.ts.map +1 -1
  141. package/dist/db/templates-repo.js +5 -3
  142. package/dist/history.d.ts +7 -2
  143. package/dist/history.d.ts.map +1 -1
  144. package/dist/history.js +4 -2
  145. package/dist/hook-output.d.ts +2 -0
  146. package/dist/hook-output.d.ts.map +1 -0
  147. package/dist/hook-output.js +31 -0
  148. package/dist/i18n.d.ts +5 -0
  149. package/dist/i18n.d.ts.map +1 -1
  150. package/dist/i18n.js +11 -4
  151. package/dist/index.d.ts +375 -47
  152. package/dist/index.d.ts.map +1 -1
  153. package/dist/index.js +1344 -192
  154. package/dist/notifications.d.ts +53 -2
  155. package/dist/notifications.d.ts.map +1 -1
  156. package/dist/notifications.js +168 -21
  157. package/dist/profiles.d.ts.map +1 -1
  158. package/dist/profiles.js +82 -10
  159. package/dist/rpc.d.ts +354 -0
  160. package/dist/rpc.d.ts.map +1 -1
  161. package/dist/rpc.js +145 -0
  162. package/dist/server.d.ts +32 -2
  163. package/dist/server.d.ts.map +1 -1
  164. package/dist/server.js +154 -30
  165. package/dist/settings.d.ts +44 -2
  166. package/dist/settings.d.ts.map +1 -1
  167. package/dist/settings.js +85 -3
  168. package/dist/shared/jobs-view.d.ts +1 -1
  169. package/dist/shared/jobs-view.d.ts.map +1 -1
  170. package/dist/shared/jobs-view.js +2 -0
  171. package/dist/task-transfer.d.ts +21 -0
  172. package/dist/task-transfer.d.ts.map +1 -1
  173. package/dist/task-transfer.js +64 -3
  174. package/dist/templates.d.ts +2 -2
  175. package/dist/templates.d.ts.map +1 -1
  176. package/dist/templates.js +3 -3
  177. package/dist/types.d.ts +22 -2
  178. package/dist/types.d.ts.map +1 -1
  179. package/dist/workspaces.d.ts.map +1 -1
  180. package/dist/workspaces.js +34 -11
  181. package/docs/ARCHITECTURE.md +319 -66
  182. package/docs/COMPATIBILITY.md +2 -2
  183. package/docs/CONCEPT.md +18 -4
  184. package/docs/CROSS_PLATFORM.ru.md +20 -0
  185. package/docs/CROSS_PLATFORM.zh.md +18 -0
  186. package/docs/EXECUTION-LOOP.md +28 -10
  187. package/docs/FEATURES.md +129 -7
  188. package/docs/FEATURES.zh.md +97 -6
  189. package/docs/MIGRATION.md +2 -2
  190. package/docs/PIPELINE.md +293 -0
  191. package/docs/QA-A2-GUI-TUI.md +205 -0
  192. package/docs/README.ru.md +43 -4
  193. package/docs/README.zh.md +44 -4
  194. package/docs/SAFETY.md +23 -3
  195. package/gui-experimental.cjs +9 -8
  196. package/locales/en.json +58 -3
  197. package/locales/ru.json +58 -3
  198. package/locales/zh.json +58 -3
  199. package/opencode.pipeline.yaml +35 -0
  200. package/package.json +36 -4
  201. package/scripts/check-eslint-baseline.mjs +139 -0
  202. package/scripts/gen-test-plan-counters.mjs +117 -0
  203. package/scripts/github-ci-fetch.ps1 +37 -0
  204. package/scripts/pl-commit.ps1 +112 -0
  205. package/scripts/qa-a2-commit.ps1 +104 -0
  206. package/scripts/test-home.mjs +107 -0
  207. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  208. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  209. package/src/cli.ts +417 -0
  210. package/src/core/analytics.ts +27 -4
  211. package/src/core/audit.ts +25 -0
  212. package/src/core/budget.ts +340 -0
  213. package/src/core/cron-to-schtasks.ts +42 -0
  214. package/src/core/dry-run.ts +235 -12
  215. package/src/core/execution.ts +538 -0
  216. package/src/core/feedback.ts +582 -0
  217. package/src/core/file-watcher.ts +2 -2
  218. package/src/core/gate-integrity.ts +330 -0
  219. package/src/core/git-trigger.ts +18 -5
  220. package/src/core/guard-run.ts +119 -0
  221. package/src/core/guard.ts +431 -0
  222. package/src/core/local-ai.ts +7 -3
  223. package/src/core/lock.ts +178 -37
  224. package/src/core/matrix.ts +158 -52
  225. package/src/core/mission.ts +531 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/opencode-models.ts +30 -21
  228. package/src/core/opencode-usage.ts +182 -0
  229. package/src/core/pipeline-apply.ts +158 -0
  230. package/src/core/pipeline-io.ts +96 -0
  231. package/src/core/pipeline-map.ts +283 -0
  232. package/src/core/pipeline-spec.ts +775 -0
  233. package/src/core/ps-wrapper.ts +435 -66
  234. package/src/core/record-history.ts +258 -81
  235. package/src/core/router/rules.ts +6 -0
  236. package/src/core/run-mode.ts +19 -0
  237. package/src/core/schedule-gate.ts +1 -1
  238. package/src/core/scheduler/at-fallback.ts +1 -1
  239. package/src/core/scheduler/linux.ts +40 -11
  240. package/src/core/scheduler/logs.ts +34 -3
  241. package/src/core/scheduler/mac.ts +174 -14
  242. package/src/core/scheduler/registry.ts +2 -2
  243. package/src/core/scheduler/windows.ts +19 -15
  244. package/src/core/secrets.ts +26 -19
  245. package/src/core/self-analysis.ts +75 -29
  246. package/src/core/shutdown.ts +90 -4
  247. package/src/core/structured-log.ts +89 -5
  248. package/src/core/telegram.ts +2 -2
  249. package/src/core/triage-worker.ts +7 -7
  250. package/src/core/triage.ts +2 -2
  251. package/src/core/usage-surface.ts +70 -0
  252. package/src/core/worktree-run.ts +199 -0
  253. package/src/core/worktree.ts +600 -0
  254. package/src/core/wrappers/bash.ts +248 -26
  255. package/src/db/capability-repo.ts +127 -10
  256. package/src/db/history-repo.ts +281 -40
  257. package/src/db/metrics-repo.ts +40 -13
  258. package/src/db/migrate.ts +57 -32
  259. package/src/db/recovery.ts +12 -5
  260. package/src/db/run-journal.ts +100 -13
  261. package/src/db/run-resume.ts +17 -1
  262. package/src/db/runs-repo.ts +147 -65
  263. package/src/db/schema.ts +134 -2
  264. package/src/db/templates-repo.ts +5 -3
  265. package/src/gui.tsx +438 -18
  266. package/src/history.ts +11 -4
  267. package/src/hook-output.ts +39 -0
  268. package/src/i18n.ts +12 -4
  269. package/src/index.ts +1902 -320
  270. package/src/notifications.ts +227 -47
  271. package/src/profiles.ts +88 -10
  272. package/src/rpc.ts +158 -0
  273. package/src/server.ts +201 -41
  274. package/src/settings.ts +125 -5
  275. package/src/shared/jobs-view.ts +3 -1
  276. package/src/task-transfer.ts +90 -6
  277. package/src/templates.ts +3 -3
  278. package/src/types.ts +23 -2
  279. package/src/workspaces.ts +37 -14
@@ -0,0 +1,362 @@
1
+ /**
2
+ * W-3 (0.0.6): guard-условия задачи.
3
+ *
4
+ * Guard — опциональный набор предварительных проверок перед запуском агента.
5
+ * Если проверка не проходит, прогон пропускается без запуска opencode:
6
+ * - semantic: файлы/ветка/изменённые пути в git-worktree;
7
+ * - command: произвольная shell-команда (exit 0 = можно запускать).
8
+ *
9
+ * Модуль не бросает исключения наружу: ошибка проверки трактуется как
10
+ * fail-closed (прогон пропускается).
11
+ */
12
+ import { execFile, spawn } from "node:child_process";
13
+ import fs from "node:fs/promises";
14
+ import path from "node:path";
15
+ import { promisify } from "node:util";
16
+ import { matchesAnyGlob, matchesGlob } from "./glob.js";
17
+ const execFileAsync = promisify(execFile);
18
+ /** Код выхода CLI-помощника: guard не пройден, прогон нужно пропустить. */
19
+ export const GUARD_SKIP_EXIT_CODE = 4;
20
+ /** Таймаут shell-guard по умолчанию. */
21
+ export const DEFAULT_GUARD_TIMEOUT_SECONDS = 60;
22
+ const MAX_COMMAND_LENGTH = 4000;
23
+ const MAX_TIMEOUT_SECONDS = 3600;
24
+ const MAX_LIST_ITEMS = 200;
25
+ const MAX_CAPTURED_OUTPUT = 16 * 1024;
26
+ function isPlainObject(value) {
27
+ return typeof value === "object" && value !== null && !Array.isArray(value);
28
+ }
29
+ function normalizeRelativePath(raw) {
30
+ const trimmed = raw.trim().replace(/\\/g, "/");
31
+ if (!trimmed || trimmed.includes("\0"))
32
+ return null;
33
+ if (path.isAbsolute(trimmed) || /^[A-Za-z]:/.test(trimmed) || trimmed.startsWith("/")) {
34
+ return null;
35
+ }
36
+ const segments = trimmed.split("/");
37
+ if (segments.some((segment) => segment === ".." || segment === "." || segment === "")) {
38
+ return null;
39
+ }
40
+ return trimmed;
41
+ }
42
+ function readStringList(raw, label, errors) {
43
+ if (raw === undefined || raw === null)
44
+ return undefined;
45
+ if (!Array.isArray(raw)) {
46
+ errors.push(`${label} должен быть массивом строк.`);
47
+ return undefined;
48
+ }
49
+ if (raw.length > MAX_LIST_ITEMS) {
50
+ errors.push(`${label}: не больше ${MAX_LIST_ITEMS} элементов.`);
51
+ return undefined;
52
+ }
53
+ const seen = new Set();
54
+ const result = [];
55
+ for (const item of raw) {
56
+ if (typeof item !== "string") {
57
+ errors.push(`${label} должен содержать только строки.`);
58
+ return undefined;
59
+ }
60
+ const normalized = normalizeRelativePath(item);
61
+ if (!normalized) {
62
+ errors.push(`${label}: путь «${item}» должен быть относительным и не содержать «.» или «..».`);
63
+ return undefined;
64
+ }
65
+ const key = process.platform === "win32" ? normalized.toLowerCase() : normalized;
66
+ if (seen.has(key))
67
+ continue;
68
+ seen.add(key);
69
+ result.push(normalized);
70
+ }
71
+ return result.length > 0 ? result : undefined;
72
+ }
73
+ function normalizeSemantic(raw, errors) {
74
+ if (raw === undefined || raw === null)
75
+ return undefined;
76
+ if (!isPlainObject(raw)) {
77
+ errors.push("guards.semantic должен быть объектом.");
78
+ return undefined;
79
+ }
80
+ const allowed = new Set(["filesExist", "filesMissing", "branch", "changedPaths", "changedSince"]);
81
+ for (const key of Object.keys(raw)) {
82
+ if (!allowed.has(key))
83
+ errors.push(`guards.semantic: неизвестное поле «${key}».`);
84
+ }
85
+ const filesExist = readStringList(raw.filesExist, "guards.semantic.filesExist", errors);
86
+ const filesMissing = readStringList(raw.filesMissing, "guards.semantic.filesMissing", errors);
87
+ const changedPaths = readStringList(raw.changedPaths, "guards.semantic.changedPaths", errors);
88
+ let branch;
89
+ if (raw.branch !== undefined && raw.branch !== null) {
90
+ if (typeof raw.branch !== "string" || !raw.branch.trim()) {
91
+ errors.push("guards.semantic.branch должен быть непустой строкой.");
92
+ }
93
+ else if (raw.branch.length > 200 || /[\u0000-\u001f\u007f]/.test(raw.branch)) {
94
+ errors.push("guards.semantic.branch слишком длинный или содержит управляющие символы.");
95
+ }
96
+ else {
97
+ branch = raw.branch.trim();
98
+ }
99
+ }
100
+ let changedSince;
101
+ if (raw.changedSince !== undefined && raw.changedSince !== null) {
102
+ if (typeof raw.changedSince !== "string" ||
103
+ !/^[A-Za-z0-9._/@{}~^-]+$/.test(raw.changedSince) ||
104
+ raw.changedSince.startsWith("-")) {
105
+ errors.push("guards.semantic.changedSince должен быть git-ref (буквы, цифры, . _ / @ { } ~ ^ -).");
106
+ }
107
+ else {
108
+ changedSince = raw.changedSince;
109
+ }
110
+ }
111
+ if (!filesExist && !filesMissing && !branch && !changedPaths && !changedSince) {
112
+ return undefined;
113
+ }
114
+ return {
115
+ ...(filesExist ? { filesExist } : {}),
116
+ ...(filesMissing ? { filesMissing } : {}),
117
+ ...(branch ? { branch } : {}),
118
+ ...(changedPaths ? { changedPaths } : {}),
119
+ ...(changedSince ? { changedSince } : {}),
120
+ };
121
+ }
122
+ /**
123
+ * Валидирует guard-конфигурацию из JSON/инструмента/импорта.
124
+ * Возвращает нормализованный объект либо ошибку; никогда не бросает.
125
+ */
126
+ export function normalizeTaskGuards(input) {
127
+ if (input === undefined || input === null)
128
+ return { ok: true };
129
+ if (!isPlainObject(input))
130
+ return { ok: false, error: "guards должен быть объектом." };
131
+ const errors = [];
132
+ const allowed = new Set(["command", "timeoutSeconds", "semantic"]);
133
+ for (const key of Object.keys(input)) {
134
+ if (!allowed.has(key))
135
+ errors.push(`guards: неизвестное поле «${key}».`);
136
+ }
137
+ let command;
138
+ if (input.command !== undefined && input.command !== null) {
139
+ if (typeof input.command !== "string") {
140
+ errors.push("guards.command должен быть строкой.");
141
+ }
142
+ else {
143
+ const trimmed = input.command.trim();
144
+ if (!trimmed) {
145
+ errors.push("guards.command не должен быть пустым.");
146
+ }
147
+ else if (trimmed.length > MAX_COMMAND_LENGTH) {
148
+ errors.push(`guards.command длиннее ${MAX_COMMAND_LENGTH} символов.`);
149
+ }
150
+ else if (trimmed.includes("\0")) {
151
+ errors.push("guards.command содержит NUL-символ.");
152
+ }
153
+ else {
154
+ command = trimmed;
155
+ }
156
+ }
157
+ }
158
+ let timeoutSeconds;
159
+ if (input.timeoutSeconds !== undefined && input.timeoutSeconds !== null) {
160
+ if (typeof input.timeoutSeconds !== "number" ||
161
+ !Number.isInteger(input.timeoutSeconds) ||
162
+ input.timeoutSeconds < 1 ||
163
+ input.timeoutSeconds > MAX_TIMEOUT_SECONDS) {
164
+ errors.push(`guards.timeoutSeconds должен быть целым числом 1..${MAX_TIMEOUT_SECONDS}.`);
165
+ }
166
+ else {
167
+ timeoutSeconds = input.timeoutSeconds;
168
+ }
169
+ }
170
+ const semantic = normalizeSemantic(input.semantic, errors);
171
+ if (errors.length > 0)
172
+ return { ok: false, error: errors.join(" ") };
173
+ if (!command && !semantic)
174
+ return { ok: true };
175
+ return {
176
+ ok: true,
177
+ guards: {
178
+ ...(command ? { command } : {}),
179
+ ...(timeoutSeconds ? { timeoutSeconds } : {}),
180
+ ...(semantic ? { semantic } : {}),
181
+ },
182
+ };
183
+ }
184
+ async function git(cwd, args) {
185
+ try {
186
+ const { stdout, stderr } = await execFileAsync("git", ["-C", cwd, ...args], {
187
+ encoding: "utf8",
188
+ timeout: 30000,
189
+ windowsHide: true,
190
+ maxBuffer: 1024 * 1024,
191
+ });
192
+ return { ok: true, stdout: String(stdout), stderr: String(stderr) };
193
+ }
194
+ catch (error) {
195
+ const err = error;
196
+ return {
197
+ ok: false,
198
+ stdout: typeof err.stdout === "string" ? err.stdout : "",
199
+ stderr: typeof err.stderr === "string"
200
+ ? err.stderr
201
+ : typeof err.message === "string"
202
+ ? err.message
203
+ : String(error),
204
+ };
205
+ }
206
+ }
207
+ function resolveInside(cwd, relative) {
208
+ const base = path.resolve(cwd);
209
+ const target = path.resolve(base, relative);
210
+ const rel = path.relative(base, target);
211
+ if (!rel || rel.startsWith("..") || path.isAbsolute(rel))
212
+ return null;
213
+ return target;
214
+ }
215
+ async function lastOutputLine(command, cwd, timeoutSeconds) {
216
+ return await new Promise((resolve) => {
217
+ let output = "";
218
+ let settled = false;
219
+ let timedOut = false;
220
+ const child = spawn(command, {
221
+ cwd,
222
+ shell: true,
223
+ windowsHide: true,
224
+ stdio: ["ignore", "pipe", "pipe"],
225
+ env: { ...process.env, AGENT_STEWARD_GUARD: "1" },
226
+ });
227
+ const finish = (code) => {
228
+ if (settled)
229
+ return;
230
+ settled = true;
231
+ if (timer)
232
+ clearTimeout(timer);
233
+ resolve({ code, timedOut, output });
234
+ };
235
+ const append = (chunk) => {
236
+ if (output.length >= MAX_CAPTURED_OUTPUT)
237
+ return;
238
+ output += chunk.toString().slice(0, MAX_CAPTURED_OUTPUT - output.length);
239
+ };
240
+ child.stdout?.on("data", append);
241
+ child.stderr?.on("data", append);
242
+ const timer = setTimeout(() => {
243
+ timedOut = true;
244
+ try {
245
+ child.kill();
246
+ }
247
+ catch {
248
+ // ignore
249
+ }
250
+ finish(null);
251
+ }, timeoutSeconds * 1000);
252
+ timer.unref?.();
253
+ child.on("error", (error) => {
254
+ output += String(error);
255
+ finish(null);
256
+ });
257
+ child.on("close", (code) => finish(code));
258
+ });
259
+ }
260
+ /**
261
+ * Выполняет guard-проверки в указанной рабочей директории.
262
+ * Никогда не бросает: любая ошибка означает «пропустить».
263
+ */
264
+ export async function evaluateGuards(guards, options) {
265
+ const checks = [];
266
+ const reasons = [];
267
+ const cwd = path.resolve(options.cwd);
268
+ const fail = (reason) => {
269
+ reasons.push(reason);
270
+ return { passed: false, reasons, checks };
271
+ };
272
+ try {
273
+ const semantic = guards.semantic;
274
+ if (semantic) {
275
+ if (semantic.filesExist) {
276
+ for (const relative of semantic.filesExist) {
277
+ const target = resolveInside(cwd, relative);
278
+ if (!target)
279
+ return fail(`файл вне рабочей директории: ${relative}`);
280
+ try {
281
+ await fs.access(target);
282
+ checks.push(`filesExist: ${relative}`);
283
+ }
284
+ catch {
285
+ return fail(`нет файла: ${relative}`);
286
+ }
287
+ }
288
+ }
289
+ if (semantic.filesMissing) {
290
+ for (const relative of semantic.filesMissing) {
291
+ const target = resolveInside(cwd, relative);
292
+ if (!target)
293
+ return fail(`файл вне рабочей директории: ${relative}`);
294
+ try {
295
+ await fs.access(target);
296
+ return fail(`файл не должен существовать: ${relative}`);
297
+ }
298
+ catch {
299
+ checks.push(`filesMissing: ${relative}`);
300
+ }
301
+ }
302
+ }
303
+ if (semantic.branch) {
304
+ const result = await git(cwd, ["rev-parse", "--abbrev-ref", "HEAD"]);
305
+ if (!result.ok)
306
+ return fail(`не удалось определить git-ветку: ${result.stderr.trim()}`);
307
+ const branch = result.stdout.trim();
308
+ if (!branch || branch === "HEAD")
309
+ return fail("git-ветка не определена (detached HEAD)");
310
+ if (!matchesGlob(branch, semantic.branch)) {
311
+ return fail(`ветка «${branch}» не соответствует «${semantic.branch}»`);
312
+ }
313
+ checks.push(`branch: ${branch}`);
314
+ }
315
+ if (semantic.changedPaths) {
316
+ const base = semantic.changedSince ?? "HEAD~1";
317
+ let diff = await git(cwd, ["diff", "--name-only", `${base}..HEAD`]);
318
+ if (!diff.ok) {
319
+ // Корневой коммит: у HEAD~1 нет родителя.
320
+ diff = await git(cwd, ["show", "--name-only", "--format=", "HEAD"]);
321
+ }
322
+ if (!diff.ok) {
323
+ return fail(`не удалось получить изменённые пути: ${diff.stderr.trim()}`);
324
+ }
325
+ const changed = diff.stdout
326
+ .split(/\r?\n/)
327
+ .map((line) => line.trim())
328
+ .filter(Boolean)
329
+ .map((line) => line.replace(/\\/g, "/"));
330
+ const matched = changed.find((file) => matchesAnyGlob(file, semantic.changedPaths));
331
+ if (!matched) {
332
+ return fail(`нет изменённых путей по шаблонам «${semantic.changedPaths.join(", ")}» (${base})`);
333
+ }
334
+ checks.push(`changedPaths: ${matched}`);
335
+ }
336
+ }
337
+ if (guards.command) {
338
+ const timeout = guards.timeoutSeconds ?? DEFAULT_GUARD_TIMEOUT_SECONDS;
339
+ const result = await lastOutputLine(guards.command, cwd, timeout);
340
+ const lastLine = result.output
341
+ .split(/\r?\n/)
342
+ .map((line) => line.trim())
343
+ .filter(Boolean)
344
+ .pop()
345
+ ?.slice(0, 300) ?? "";
346
+ if (result.timedOut) {
347
+ return fail(`shell guard превысил таймаут ${timeout} с`);
348
+ }
349
+ if (result.code !== 0) {
350
+ const suffix = lastLine ? `: ${lastLine}` : "";
351
+ return fail(result.code === null
352
+ ? `shell guard не выполнился${suffix}`
353
+ : `shell guard завершился с кодом ${result.code}${suffix}`);
354
+ }
355
+ checks.push("command: exit 0");
356
+ }
357
+ }
358
+ catch (error) {
359
+ return fail(`ошибка проверки guard: ${error instanceof Error ? error.message : String(error)}`);
360
+ }
361
+ return { passed: reasons.length === 0, reasons, checks };
362
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"local-ai.d.ts","sourceRoot":"","sources":["../../src/core/local-ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAC1C,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAC5C,eAAO,MAAM,yBAAyB,4SACoC,CAAC;AAE3E,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACxC;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC/B;AAWD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAGhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,GAClB;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAuEjD;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAyBzE"}
1
+ {"version":3,"file":"local-ai.d.ts","sourceRoot":"","sources":["../../src/core/local-ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAC1C,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAC5C,eAAO,MAAM,yBAAyB,4SACoC,CAAC;AAE3E,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACxC;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC/B;AAeD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAGhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,GAClB;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAuEjD;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAyBzE"}
@@ -9,10 +9,14 @@ import { DEFAULT_SHADOW_DAYS, isShadowActive } from "../settings.js";
9
9
  export const LOCAL_AI_TIMEOUT_MIN = 1000;
10
10
  export const LOCAL_AI_TIMEOUT_MAX = 120000;
11
11
  export const LOCAL_AI_SELF_TEST_PROMPT = "Тест связи: задача завершилась ошибкой Quality Gate (2 упавших теста).";
12
+ /**
13
+ * QA-P2.2: clamp НЕ округляет — confidenceThreshold дробный (0..1).
14
+ * Целочисленные поля (timeoutMs, shadow.days) округляются в местах вызова.
15
+ */
12
16
  function clamp(value, min, max, fallback) {
13
17
  if (!Number.isFinite(value))
14
18
  return fallback;
15
- return Math.min(max, Math.max(min, Math.round(value)));
19
+ return Math.min(max, Math.max(min, value));
16
20
  }
17
21
  function trimUrl(value) {
18
22
  return value.trim().replace(/\/+$/, "");
@@ -48,7 +52,7 @@ export function applyLocalAiPatch(current, patch) {
48
52
  }
49
53
  }
50
54
  if (patch.timeoutMs !== undefined) {
51
- const timeoutMs = clamp(patch.timeoutMs, LOCAL_AI_TIMEOUT_MIN, LOCAL_AI_TIMEOUT_MAX, current.timeoutMs);
55
+ const timeoutMs = clamp(Math.round(patch.timeoutMs), LOCAL_AI_TIMEOUT_MIN, LOCAL_AI_TIMEOUT_MAX, current.timeoutMs);
52
56
  if (timeoutMs !== current.timeoutMs) {
53
57
  next.timeoutMs = timeoutMs;
54
58
  changed.push("timeoutMs");
@@ -77,7 +81,7 @@ export function applyLocalAiPatch(current, patch) {
77
81
  changed.push("shadow.enabled");
78
82
  }
79
83
  if (shadowPatch.days !== undefined) {
80
- const days = clamp(shadowPatch.days, 1, 365, shadow.days);
84
+ const days = clamp(Math.round(shadowPatch.days), 1, 365, shadow.days);
81
85
  if (days !== shadow.days) {
82
86
  shadow.days = days;
83
87
  changed.push("shadow.days");
@@ -7,6 +7,38 @@
7
7
  * чужую критическую секцию.
8
8
  */
9
9
  export declare function isProcessAlive(pid: number): boolean;
10
+ /** Разобранный lock-токен: PID владельца и формат записи. */
11
+ export interface LockToken {
12
+ pid: number | null;
13
+ createdAt: string | null;
14
+ format: "unified" | "node-legacy" | "ps-legacy" | "pid" | "unknown";
15
+ }
16
+ /**
17
+ * Разбирает содержимое lock-файла в едином для Node/PS/bash виде.
18
+ *
19
+ * Поддерживаемые форматы:
20
+ * `<pid>-<iso>` — единый формат (Node и PS, B6);
21
+ * `<pid>-<epoch>-<uuid>` — старый Node-токен;
22
+ * `<iso>|<pid>` — старый PS-токен (ISO|PID);
23
+ * `<pid>` — голый PID (pid-файл bash-обёртки).
24
+ *
25
+ * Порядок важен: legacy PS проверяется до `<pid>-…`, иначе год из ISO
26
+ * (`2026`) принимался за PID — именно это ломало межпроцессную совместимость.
27
+ */
28
+ export declare function parseLockToken(content: string): LockToken;
29
+ /** PID владельца из токена lock-файла (любой поддерживаемый формат). */
30
+ export declare function ownerPidFromToken(content: string): number | null;
31
+ /**
32
+ * PID владельца lock-артефакта.
33
+ *
34
+ * B7: файловый lock Node/PS хранит токен в самом файле, а POSIX-обёртка
35
+ * держит каталог `<lock>.d` и пишет `<pid>-<iso>` в `<lock>.d/pid`.
36
+ * Раньше каталог вытеснялся только по возрасту, без чтения этого файла,
37
+ * поэтому легально долгая задача (> 24 ч) после рестарта плагина
38
+ * дублировалась. Нет pid-файла/не разобрался — возвращаем null,
39
+ * и решение принимает возраст (fallback).
40
+ */
41
+ export declare function readLockOwnerPid(lockPath: string, isDir: boolean): Promise<number | null>;
10
42
  /**
11
43
  * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
12
44
  *
@@ -38,6 +70,15 @@ export declare class LockManager {
38
70
  * не должен удалять файл нового владельца.
39
71
  */
40
72
  acquire(taskName: string): Promise<string | null>;
73
+ /**
74
+ * Удаляет lock-файл, переживая кратковременные Windows-блокировки.
75
+ *
76
+ * На Windows unlink может вернуть EPERM/EACCES/EBUSY, пока другой процесс
77
+ * читает файл (проверка владельца в withLockWait) или файл ещё «висящий»
78
+ * после создания. Несколько коротких повторов решают гонку; ENOENT — уже
79
+ * удалён, это не ошибка.
80
+ */
81
+ private unlinkWithRetry;
41
82
  /**
42
83
  * Освобождает блокировку задачи (удаляет lock-файл).
43
84
  *
@@ -1 +1 @@
1
- {"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAWD;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAiB;IAItC,iCAAiC;IACjC,OAAO,CAAC,YAAY;IAIpB,uCAAuC;IACvC,OAAO,CAAC,YAAY;IAIpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgEjC;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBvD;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBhE;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC,CAAC,CAAC,CAuDZ"}
1
+ {"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;CACrE;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CA+CzD;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB;AAGD;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAiB;IAItC,iCAAiC;IACjC,OAAO,CAAC,YAAY;IAIpB,uCAAuC;IACvC,OAAO,CAAC,YAAY;IAIpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmEjC;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA6BvD;;;;;;;OAOG;YACW,eAAe;IAmB7B;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAehE;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC,CAAC,CAAC,CAyDZ"}