agent-steward 0.0.3 → 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 (287) hide show
  1. package/CHANGELOG.md +154 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +54 -9
  4. package/ROADMAP-STRATEGY.md +23 -20
  5. package/ROADMAP.md +140 -143
  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/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +18 -1
  14. package/dist/core/execution.d.ts +203 -0
  15. package/dist/core/execution.d.ts.map +1 -0
  16. package/dist/core/execution.js +309 -0
  17. package/dist/core/gate-integrity.d.ts +35 -0
  18. package/dist/core/gate-integrity.d.ts.map +1 -0
  19. package/dist/core/gate-integrity.js +132 -0
  20. package/dist/core/git-trigger.d.ts.map +1 -1
  21. package/dist/core/git-trigger.js +14 -2
  22. package/dist/core/guard-run.d.ts +4 -0
  23. package/dist/core/guard-run.d.ts.map +1 -0
  24. package/dist/core/guard-run.js +101 -0
  25. package/dist/core/guard.d.ts +52 -0
  26. package/dist/core/guard.d.ts.map +1 -0
  27. package/dist/core/guard.js +362 -0
  28. package/dist/core/lock.d.ts +61 -4
  29. package/dist/core/lock.d.ts.map +1 -1
  30. package/dist/core/lock.js +213 -26
  31. package/dist/core/matrix.d.ts.map +1 -1
  32. package/dist/core/matrix.js +75 -15
  33. package/dist/core/mission.d.ts +83 -0
  34. package/dist/core/mission.d.ts.map +1 -0
  35. package/dist/core/mission.js +334 -0
  36. package/dist/core/one-shot.d.ts +5 -1
  37. package/dist/core/one-shot.d.ts.map +1 -1
  38. package/dist/core/one-shot.js +33 -8
  39. package/dist/core/opencode-cli.d.ts +28 -0
  40. package/dist/core/opencode-cli.d.ts.map +1 -0
  41. package/dist/core/opencode-cli.js +74 -0
  42. package/dist/core/opencode-models.d.ts +62 -0
  43. package/dist/core/opencode-models.d.ts.map +1 -0
  44. package/dist/core/opencode-models.js +277 -0
  45. package/dist/core/pipeline-apply.d.ts +38 -0
  46. package/dist/core/pipeline-apply.d.ts.map +1 -0
  47. package/dist/core/pipeline-apply.js +117 -0
  48. package/dist/core/pipeline-io.d.ts +13 -0
  49. package/dist/core/pipeline-io.d.ts.map +1 -0
  50. package/dist/core/pipeline-io.js +64 -0
  51. package/dist/core/pipeline-map.d.ts +46 -0
  52. package/dist/core/pipeline-map.d.ts.map +1 -0
  53. package/dist/core/pipeline-map.js +196 -0
  54. package/dist/core/pipeline-spec.d.ts +109 -0
  55. package/dist/core/pipeline-spec.d.ts.map +1 -0
  56. package/dist/core/pipeline-spec.js +554 -0
  57. package/dist/core/ps-wrapper.d.ts +19 -2
  58. package/dist/core/ps-wrapper.d.ts.map +1 -1
  59. package/dist/core/ps-wrapper.js +261 -63
  60. package/dist/core/record-history.d.ts +15 -0
  61. package/dist/core/record-history.d.ts.map +1 -1
  62. package/dist/core/record-history.js +183 -58
  63. package/dist/core/router/dispatch.d.ts +36 -0
  64. package/dist/core/router/dispatch.d.ts.map +1 -0
  65. package/dist/core/router/dispatch.js +59 -0
  66. package/dist/core/router/escalation.d.ts +47 -0
  67. package/dist/core/router/escalation.d.ts.map +1 -0
  68. package/dist/core/router/escalation.js +87 -0
  69. package/dist/core/router/planner.d.ts +53 -0
  70. package/dist/core/router/planner.d.ts.map +1 -0
  71. package/dist/core/router/planner.js +113 -0
  72. package/dist/core/router/rules.d.ts +46 -0
  73. package/dist/core/router/rules.d.ts.map +1 -0
  74. package/dist/core/router/rules.js +91 -0
  75. package/dist/core/run-panel-api.d.ts +94 -0
  76. package/dist/core/run-panel-api.d.ts.map +1 -0
  77. package/dist/core/run-panel-api.js +169 -0
  78. package/dist/core/schedule-gate.js +5 -1
  79. package/dist/core/schedule-v2.d.ts +34 -0
  80. package/dist/core/schedule-v2.d.ts.map +1 -1
  81. package/dist/core/schedule-v2.js +91 -5
  82. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  83. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  84. package/dist/core/scheduler/at-fallback.js +135 -5
  85. package/dist/core/scheduler/linux.d.ts +18 -2
  86. package/dist/core/scheduler/linux.d.ts.map +1 -1
  87. package/dist/core/scheduler/linux.js +63 -20
  88. package/dist/core/scheduler/mac.d.ts +44 -2
  89. package/dist/core/scheduler/mac.d.ts.map +1 -1
  90. package/dist/core/scheduler/mac.js +126 -15
  91. package/dist/core/scheduler/posix.d.ts.map +1 -1
  92. package/dist/core/scheduler/posix.js +25 -1
  93. package/dist/core/scheduler/registry.d.ts +11 -0
  94. package/dist/core/scheduler/registry.d.ts.map +1 -1
  95. package/dist/core/scheduler/registry.js +83 -21
  96. package/dist/core/scheduler/run-now.d.ts +16 -0
  97. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  98. package/dist/core/scheduler/run-now.js +28 -0
  99. package/dist/core/scheduler/windows.d.ts.map +1 -1
  100. package/dist/core/scheduler/windows.js +15 -12
  101. package/dist/core/secrets.d.ts.map +1 -1
  102. package/dist/core/secrets.js +125 -28
  103. package/dist/core/session.d.ts.map +1 -1
  104. package/dist/core/session.js +18 -11
  105. package/dist/core/structured-log.d.ts +7 -1
  106. package/dist/core/structured-log.d.ts.map +1 -1
  107. package/dist/core/task-name.d.ts +24 -0
  108. package/dist/core/task-name.d.ts.map +1 -0
  109. package/dist/core/task-name.js +40 -0
  110. package/dist/core/worktree-run.d.ts +4 -0
  111. package/dist/core/worktree-run.d.ts.map +1 -0
  112. package/dist/core/worktree-run.js +164 -0
  113. package/dist/core/worktree.d.ts +115 -0
  114. package/dist/core/worktree.d.ts.map +1 -0
  115. package/dist/core/worktree.js +462 -0
  116. package/dist/core/wrappers/bash.d.ts +17 -0
  117. package/dist/core/wrappers/bash.d.ts.map +1 -1
  118. package/dist/core/wrappers/bash.js +224 -28
  119. package/dist/db/capability-repo.d.ts +124 -0
  120. package/dist/db/capability-repo.d.ts.map +1 -0
  121. package/dist/db/capability-repo.js +267 -0
  122. package/dist/db/history-repo.d.ts +46 -5
  123. package/dist/db/history-repo.d.ts.map +1 -1
  124. package/dist/db/history-repo.js +107 -25
  125. package/dist/db/index.d.ts +4 -0
  126. package/dist/db/index.d.ts.map +1 -1
  127. package/dist/db/index.js +39 -1
  128. package/dist/db/metrics-repo.js +2 -2
  129. package/dist/db/migrate.d.ts.map +1 -1
  130. package/dist/db/migrate.js +3 -1
  131. package/dist/db/recovery.d.ts.map +1 -1
  132. package/dist/db/recovery.js +5 -4
  133. package/dist/db/run-context.d.ts +103 -0
  134. package/dist/db/run-context.d.ts.map +1 -0
  135. package/dist/db/run-context.js +224 -0
  136. package/dist/db/run-dlq.d.ts +100 -0
  137. package/dist/db/run-dlq.d.ts.map +1 -0
  138. package/dist/db/run-dlq.js +191 -0
  139. package/dist/db/run-journal.d.ts +33 -5
  140. package/dist/db/run-journal.d.ts.map +1 -1
  141. package/dist/db/run-journal.js +78 -14
  142. package/dist/db/run-resume.d.ts +10 -2
  143. package/dist/db/run-resume.d.ts.map +1 -1
  144. package/dist/db/run-resume.js +39 -13
  145. package/dist/db/runs-repo.d.ts +32 -7
  146. package/dist/db/runs-repo.d.ts.map +1 -1
  147. package/dist/db/runs-repo.js +50 -11
  148. package/dist/db/schema.d.ts +2 -2
  149. package/dist/db/schema.d.ts.map +1 -1
  150. package/dist/db/schema.js +216 -3
  151. package/dist/db/settings-repo.d.ts +11 -0
  152. package/dist/db/settings-repo.d.ts.map +1 -1
  153. package/dist/db/settings-repo.js +25 -0
  154. package/dist/db/step-idempotency.d.ts +51 -0
  155. package/dist/db/step-idempotency.d.ts.map +1 -0
  156. package/dist/db/step-idempotency.js +136 -0
  157. package/dist/history.d.ts +1 -1
  158. package/dist/history.d.ts.map +1 -1
  159. package/dist/i18n.d.ts +5 -0
  160. package/dist/i18n.d.ts.map +1 -1
  161. package/dist/i18n.js +11 -4
  162. package/dist/index.d.ts +140 -6
  163. package/dist/index.d.ts.map +1 -1
  164. package/dist/index.js +480 -18
  165. package/dist/notifications.d.ts +22 -0
  166. package/dist/notifications.d.ts.map +1 -1
  167. package/dist/notifications.js +36 -8
  168. package/dist/profiles.d.ts.map +1 -1
  169. package/dist/profiles.js +25 -4
  170. package/dist/rpc.d.ts +924 -0
  171. package/dist/rpc.d.ts.map +1 -1
  172. package/dist/rpc.js +352 -0
  173. package/dist/server.d.ts +46 -0
  174. package/dist/server.d.ts.map +1 -1
  175. package/dist/server.js +172 -53
  176. package/dist/settings.d.ts +2 -2
  177. package/dist/settings.d.ts.map +1 -1
  178. package/dist/settings.js +3 -3
  179. package/dist/shared/jobs-view.d.ts +1 -1
  180. package/dist/shared/jobs-view.d.ts.map +1 -1
  181. package/dist/shared/jobs-view.js +2 -0
  182. package/dist/task-transfer.d.ts +16 -0
  183. package/dist/task-transfer.d.ts.map +1 -1
  184. package/dist/task-transfer.js +16 -0
  185. package/dist/types.d.ts.map +1 -1
  186. package/dist/types.js +7 -0
  187. package/dist/workspaces.d.ts +25 -3
  188. package/dist/workspaces.d.ts.map +1 -1
  189. package/dist/workspaces.js +43 -8
  190. package/docs/ARCHITECTURE.md +498 -58
  191. package/docs/COMPATIBILITY.md +2 -2
  192. package/docs/CONCEPT.md +185 -91
  193. package/docs/CROSS_PLATFORM.ru.md +20 -0
  194. package/docs/CROSS_PLATFORM.zh.md +18 -0
  195. package/docs/EXECUTION-LOOP.md +211 -0
  196. package/docs/FEATURES.md +65 -4
  197. package/docs/FEATURES.zh.md +52 -4
  198. package/docs/MIGRATION.md +2 -2
  199. package/docs/PIPELINE.md +293 -0
  200. package/docs/README.ru.md +44 -5
  201. package/docs/README.zh.md +46 -6
  202. package/docs/SAFETY.md +142 -0
  203. package/docs/SAVINGS.md +29 -0
  204. package/docs/SAVINGS.ru.md +29 -0
  205. package/docs/SAVINGS.zh.md +18 -0
  206. package/gui-experimental.cjs +9 -8
  207. package/locales/en.json +84 -1
  208. package/locales/ru.json +84 -1
  209. package/locales/zh.json +84 -1
  210. package/opencode.pipeline.yaml +35 -0
  211. package/package.json +46 -2
  212. package/scripts/audit-bundle.mjs +215 -0
  213. package/scripts/test-home.mjs +83 -0
  214. package/src/cli.ts +412 -0
  215. package/src/core/dlq-api.ts +98 -0
  216. package/src/core/dry-run.ts +27 -3
  217. package/src/core/execution.ts +538 -0
  218. package/src/core/file-watcher.ts +2 -2
  219. package/src/core/gate-integrity.ts +160 -0
  220. package/src/core/git-trigger.ts +18 -5
  221. package/src/core/guard-run.ts +119 -0
  222. package/src/core/guard.ts +431 -0
  223. package/src/core/lock.ts +244 -30
  224. package/src/core/matrix.ts +95 -50
  225. package/src/core/mission.ts +485 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/one-shot.ts +36 -8
  228. package/src/core/opencode-cli.ts +103 -0
  229. package/src/core/opencode-models.ts +315 -0
  230. package/src/core/pipeline-apply.ts +158 -0
  231. package/src/core/pipeline-io.ts +79 -0
  232. package/src/core/pipeline-map.ts +264 -0
  233. package/src/core/pipeline-spec.ts +775 -0
  234. package/src/core/ps-wrapper.ts +274 -64
  235. package/src/core/record-history.ts +229 -104
  236. package/src/core/router/dispatch.ts +94 -0
  237. package/src/core/router/escalation.ts +129 -0
  238. package/src/core/router/planner.ts +166 -0
  239. package/src/core/router/rules.ts +115 -0
  240. package/src/core/run-panel-api.ts +262 -0
  241. package/src/core/schedule-gate.ts +7 -3
  242. package/src/core/schedule-v2.ts +114 -5
  243. package/src/core/scheduler/at-fallback.ts +190 -5
  244. package/src/core/scheduler/linux.ts +72 -21
  245. package/src/core/scheduler/logs.ts +2 -2
  246. package/src/core/scheduler/mac.ts +174 -14
  247. package/src/core/scheduler/posix.ts +20 -1
  248. package/src/core/scheduler/registry.ts +107 -26
  249. package/src/core/scheduler/run-now.ts +32 -0
  250. package/src/core/scheduler/windows.ts +19 -15
  251. package/src/core/secrets.ts +131 -31
  252. package/src/core/session.ts +23 -10
  253. package/src/core/structured-log.ts +22 -5
  254. package/src/core/task-name.ts +67 -0
  255. package/src/core/telegram.ts +2 -2
  256. package/src/core/triage-worker.ts +7 -7
  257. package/src/core/triage.ts +2 -2
  258. package/src/core/worktree-run.ts +199 -0
  259. package/src/core/worktree.ts +600 -0
  260. package/src/core/wrappers/bash.ts +239 -27
  261. package/src/db/capability-repo.ts +402 -0
  262. package/src/db/history-repo.ts +151 -22
  263. package/src/db/index.ts +37 -1
  264. package/src/db/metrics-repo.ts +2 -2
  265. package/src/db/migrate.ts +3 -1
  266. package/src/db/recovery.ts +5 -4
  267. package/src/db/run-context.ts +370 -0
  268. package/src/db/run-dlq.ts +310 -0
  269. package/src/db/run-journal.ts +100 -13
  270. package/src/db/run-resume.ts +65 -13
  271. package/src/db/runs-repo.ts +66 -13
  272. package/src/db/schema.ts +218 -3
  273. package/src/db/settings-repo.ts +31 -0
  274. package/src/db/step-idempotency.ts +185 -0
  275. package/src/gui.tsx +692 -13
  276. package/src/history.ts +1 -1
  277. package/src/i18n.ts +12 -4
  278. package/src/index.ts +648 -8
  279. package/src/notifications.ts +38 -8
  280. package/src/profiles.ts +26 -4
  281. package/src/rpc.ts +379 -0
  282. package/src/server.ts +206 -54
  283. package/src/settings.ts +5 -5
  284. package/src/shared/jobs-view.ts +3 -1
  285. package/src/task-transfer.ts +31 -0
  286. package/src/types.ts +9 -0
  287. package/src/workspaces.ts +58 -9
@@ -0,0 +1,160 @@
1
+ /**
2
+ * G-1.2: проверяемый snapshot входов Quality Gate.
3
+ *
4
+ * Обёртка фиксирует хэш команды/хука гейта, промпта и таймаута в момент
5
+ * создания задачи (файл лежит в PLUGIN_DIR, вне write-scope агента) и
6
+ * сверяет его непосредственно перед запуском гейта. Подмена гейта или
7
+ * промпта после создания задачи приводит к fail-closed: гейт не выполняется,
8
+ * запуск помечается ошибкой. Snapshot защищает от подмены *definition*
9
+ * гейта; исходники, которые гейт проверяет, в хэш не входят (агент
10
+ * legitimately меняет их в ходе задачи).
11
+ */
12
+ import crypto from "node:crypto";
13
+ import fs from "node:fs";
14
+ import path from "node:path";
15
+ import { fileURLToPath } from "node:url";
16
+ import { PLUGIN_DIR, sanitizeName } from "../types.js";
17
+
18
+ export const GATE_SNAPSHOT_VERSION = 1;
19
+ export const GATE_SNAPSHOT_DIR = path.join(PLUGIN_DIR, "gate-snapshots");
20
+
21
+ export interface GateSnapshotInputs {
22
+ /** Текст гейта: на Windows — содержимое hook-файла, на POSIX — команда. */
23
+ gate: string;
24
+ /** Текст промпта задачи. */
25
+ prompt: string;
26
+ /** Таймаут гейта в секундах. */
27
+ gateTimeoutSeconds: number;
28
+ }
29
+
30
+ export interface GateSnapshot {
31
+ version: number;
32
+ taskName: string;
33
+ createdAt: string;
34
+ hash: string;
35
+ }
36
+
37
+ /** Канонический хэш входов гейта. Порядок полей фиксирован контрактом. */
38
+ export function gateInputsHash(inputs: GateSnapshotInputs): string {
39
+ const canonical = JSON.stringify({
40
+ version: GATE_SNAPSHOT_VERSION,
41
+ gate: inputs.gate,
42
+ prompt: inputs.prompt,
43
+ gateTimeoutSeconds: inputs.gateTimeoutSeconds,
44
+ });
45
+ return crypto.createHash("sha256").update(canonical, "utf8").digest("hex");
46
+ }
47
+
48
+ /** Путь snapshot'а задачи — вне рабочей директории задачи. */
49
+ export function gateSnapshotPath(taskName: string): string {
50
+ const segment = sanitizeName(taskName).slice(0, 80) || "task";
51
+ return path.join(GATE_SNAPSHOT_DIR, `${segment}.json`);
52
+ }
53
+
54
+ function readText(file: string | undefined): string {
55
+ if (!file) return "";
56
+ try {
57
+ return fs.readFileSync(file, "utf8");
58
+ } catch {
59
+ return "";
60
+ }
61
+ }
62
+
63
+ /** Пишет snapshot задачам на этапе создания обёртки (fail-closed при ошибке). */
64
+ export function createGateSnapshot(
65
+ taskName: string,
66
+ inputs: GateSnapshotInputs,
67
+ snapshotFile = gateSnapshotPath(taskName),
68
+ ): string {
69
+ const snapshot: GateSnapshot = {
70
+ version: GATE_SNAPSHOT_VERSION,
71
+ taskName,
72
+ createdAt: new Date().toISOString(),
73
+ hash: gateInputsHash(inputs),
74
+ };
75
+ fs.mkdirSync(path.dirname(snapshotFile), { recursive: true });
76
+ fs.writeFileSync(snapshotFile, `${JSON.stringify(snapshot, null, 2)}\n`, {
77
+ encoding: "utf8",
78
+ mode: 0o600,
79
+ });
80
+ return snapshotFile;
81
+ }
82
+
83
+ export function readGateSnapshot(file: string): GateSnapshot | null {
84
+ try {
85
+ const parsed: unknown = JSON.parse(fs.readFileSync(file, "utf8"));
86
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
87
+ const value = parsed as Partial<GateSnapshot>;
88
+ if (value.version !== GATE_SNAPSHOT_VERSION) return null;
89
+ if (typeof value.hash !== "string" || !/^[0-9a-f]{64}$/.test(value.hash)) return null;
90
+ return {
91
+ version: value.version,
92
+ taskName: typeof value.taskName === "string" ? value.taskName : "",
93
+ createdAt: typeof value.createdAt === "string" ? value.createdAt : "",
94
+ hash: value.hash,
95
+ };
96
+ } catch {
97
+ return null;
98
+ }
99
+ }
100
+
101
+ /** Сверяет текущие входы гейта с зафиксированными. При расхождении — fail-closed. */
102
+ export function verifyGateSnapshot(
103
+ snapshotFile: string,
104
+ inputs: GateSnapshotInputs,
105
+ ): { ok: boolean; reason?: string } {
106
+ const snapshot = readGateSnapshot(snapshotFile);
107
+ if (!snapshot) {
108
+ return { ok: false, reason: "snapshot гейта отсутствует или повреждён" };
109
+ }
110
+ const actual = gateInputsHash(inputs);
111
+ const expected = snapshot.hash;
112
+ const same =
113
+ Buffer.byteLength(actual) === Buffer.byteLength(expected) &&
114
+ crypto.timingSafeEqual(Buffer.from(actual, "utf8"), Buffer.from(expected, "utf8"));
115
+ if (!same) {
116
+ return { ok: false, reason: "входы Quality Gate изменены с момента создания задачи" };
117
+ }
118
+ return { ok: true };
119
+ }
120
+
121
+ function optionValue(argv: string[], name: string): string | undefined {
122
+ const index = argv.indexOf(name);
123
+ return index >= 0 ? argv[index + 1] : undefined;
124
+ }
125
+
126
+ /**
127
+ * CLI для обёрток: `node gate-integrity.js verify --snapshot <file>
128
+ * --gate-file <file> | --gate-command <text> --prompt-file <file> --timeout <n>`.
129
+ * exit 0 — входы совпадают, exit 1 — расхождение/отсутствие snapshot'а.
130
+ */
131
+ export async function main(argv = process.argv.slice(2)): Promise<number> {
132
+ if (argv[0] !== "verify") {
133
+ console.error("gate-integrity: только команда verify поддерживается");
134
+ return 2;
135
+ }
136
+ const snapshotFile = optionValue(argv, "--snapshot");
137
+ if (!snapshotFile) {
138
+ console.error("gate-integrity: не задан --snapshot");
139
+ return 2;
140
+ }
141
+ const gateFile = optionValue(argv, "--gate-file");
142
+ const gateCommand = optionValue(argv, "--gate-command");
143
+ const gate = gateFile ? readText(gateFile) : gateCommand ?? "";
144
+ const timeoutRaw = Number(optionValue(argv, "--timeout") ?? 300);
145
+ const inputs: GateSnapshotInputs = {
146
+ gate,
147
+ prompt: readText(optionValue(argv, "--prompt-file")),
148
+ gateTimeoutSeconds: Number.isFinite(timeoutRaw) ? timeoutRaw : 300,
149
+ };
150
+ const result = verifyGateSnapshot(snapshotFile, inputs);
151
+ if (!result.ok) {
152
+ console.error(`gate-integrity: ${result.reason ?? "проверка целостности не пройдена"}`);
153
+ return 1;
154
+ }
155
+ return 0;
156
+ }
157
+
158
+ if (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url))) {
159
+ process.exitCode = await main();
160
+ }
@@ -62,12 +62,25 @@ export type GitTriggerHandler = (taskName: string, info: GitCheckResult & { cwd:
62
62
 
63
63
  export type GitRunner = (cwd: string, args: string[]) => Promise<string>;
64
64
 
65
+ /**
66
+ * W-1 (0.0.6): опрос репозитория — служебная операция, а не пользовательская.
67
+ * Игнорируем пользовательские хуки и запрещаем интерактивный ввод пароля,
68
+ * чтобы длинная цепочка хуков или запрос credentials не блокировали опрос.
69
+ */
70
+ const GIT_SAFE_ARGS = ["-c", `core.hooksPath=${process.platform === "win32" ? "NUL" : "/dev/null"}`];
71
+ const GIT_SAFE_ENV = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
72
+
65
73
  const defaultRunner: GitRunner = (cwd, args) =>
66
74
  new Promise((resolve, reject) => {
67
75
  execFile(
68
76
  "git",
69
- ["-C", cwd, ...args],
70
- { timeout: GIT_COMMAND_TIMEOUT_MS, windowsHide: true, maxBuffer: 4 * 1024 * 1024 },
77
+ ["-C", cwd, ...GIT_SAFE_ARGS, ...args],
78
+ {
79
+ timeout: GIT_COMMAND_TIMEOUT_MS,
80
+ windowsHide: true,
81
+ maxBuffer: 4 * 1024 * 1024,
82
+ env: GIT_SAFE_ENV,
83
+ },
71
84
  (err, stdout) => {
72
85
  if (err) {
73
86
  reject(err instanceof Error ? err : new Error(String(err)));
@@ -208,7 +221,7 @@ export async function checkGitTrigger(
208
221
  let files: string[];
209
222
  try {
210
223
  files = await gitChangedFiles(task.cwd, state.commitSha, probe.head, run);
211
- } catch (err: any) {
224
+ } catch (err: unknown) {
212
225
  // Не двигаем state: следующий опрос повторит сравнение с тем же коммитом,
213
226
  // и пропущенные изменения не потеряются.
214
227
  return {
@@ -219,7 +232,7 @@ export async function checkGitTrigger(
219
232
  files: [],
220
233
  matched: [],
221
234
  message: t("gitTrigger.diffFailed", {
222
- error: err?.message ? String(err.message) : String(err),
235
+ error: err instanceof Error ? err.message : String(err),
223
236
  }),
224
237
  };
225
238
  }
@@ -356,7 +369,7 @@ export class GitTriggerManager {
356
369
  } else if (result.status === "error") {
357
370
  console.error(`[agent-steward] git-триггер «${managed.def.name}»: ${result.message}`);
358
371
  }
359
- } catch (err: any) {
372
+ } catch (err: unknown) {
360
373
  console.error(
361
374
  `[agent-steward] git-триггер «${managed.def.name}»: ${
362
375
  err instanceof Error ? err.message : String(err)
@@ -0,0 +1,119 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * W-3 (0.0.6): CLI-помощник guard-условий.
4
+ *
5
+ * Вызывается из сгенерированных обёрток до запуска opencode:
6
+ * node guard-run.js --cwd "<workdir>" --guards-b64 "<base64 json>" [--json]
7
+ *
8
+ * Коды выхода:
9
+ * 0 — все guard-проверки пройдены, можно запускать;
10
+ * 4 — проверки не пройдены, прогон нужно пропустить (skip);
11
+ * 1 — некорректные аргументы или конфигурация (fail-closed).
12
+ *
13
+ * В stdout печатается человекочитаемая причина (или JSON с --json),
14
+ * диагностика — в stderr. Модуль ничего не завершает при импорте.
15
+ */
16
+ import path from "node:path";
17
+ import { pathToFileURL } from "node:url";
18
+ import {
19
+ evaluateGuards,
20
+ GUARD_SKIP_EXIT_CODE,
21
+ normalizeTaskGuards,
22
+ } from "./guard.js";
23
+
24
+ interface HelperArgs {
25
+ cwd?: string;
26
+ guardsB64?: string;
27
+ json: boolean;
28
+ }
29
+
30
+ function parseArgs(argv: string[]): { args: HelperArgs; error?: string } {
31
+ const args: HelperArgs = { json: false };
32
+ for (let index = 0; index < argv.length; index += 1) {
33
+ const flag = argv[index];
34
+ const value = argv[index + 1];
35
+ switch (flag) {
36
+ case "--json":
37
+ args.json = true;
38
+ break;
39
+ case "--cwd":
40
+ case "--guards-b64": {
41
+ if (!value || value.startsWith("--")) {
42
+ return { args, error: `Флаг ${flag} требует значение.` };
43
+ }
44
+ if (flag === "--cwd") args.cwd = value;
45
+ if (flag === "--guards-b64") args.guardsB64 = value;
46
+ index += 1;
47
+ break;
48
+ }
49
+ default:
50
+ return { args, error: `Неизвестный аргумент: ${flag}` };
51
+ }
52
+ }
53
+ return { args };
54
+ }
55
+
56
+ function usage(): string {
57
+ return [
58
+ "Использование:",
59
+ ' guard-run.js --cwd <dir> --guards-b64 "<base64 json>" [--json]',
60
+ ].join("\n");
61
+ }
62
+
63
+ /** Точка входа для тестов: возвращает exit code, ничего не завершает. */
64
+ export async function main(argv: string[] = process.argv.slice(2)): Promise<number> {
65
+ const parsed = parseArgs(argv);
66
+ if (parsed.error) {
67
+ process.stderr.write(`[guard] ${parsed.error}\n`);
68
+ return 1;
69
+ }
70
+
71
+ const { cwd, guardsB64 } = parsed.args;
72
+ if (!cwd || !guardsB64) {
73
+ process.stderr.write(`[guard] ${usage()}\n`);
74
+ return 1;
75
+ }
76
+
77
+ let raw: unknown;
78
+ try {
79
+ raw = JSON.parse(Buffer.from(guardsB64, "base64").toString("utf8"));
80
+ } catch (error) {
81
+ process.stderr.write(
82
+ `[guard] не удалось разобрать guards: ${error instanceof Error ? error.message : String(error)}\n`,
83
+ );
84
+ return 1;
85
+ }
86
+
87
+ const normalized = normalizeTaskGuards(raw);
88
+ if (!normalized.ok) {
89
+ process.stderr.write(`[guard] ${normalized.error}\n`);
90
+ return 1;
91
+ }
92
+ if (!normalized.guards) {
93
+ process.stderr.write("[guard] пустая конфигурация guard.\n");
94
+ return 1;
95
+ }
96
+
97
+ const result = await evaluateGuards(normalized.guards, { cwd });
98
+ if (parsed.args.json) {
99
+ process.stdout.write(`${JSON.stringify(result)}\n`);
100
+ } else if (result.passed) {
101
+ process.stdout.write(`[guard] OK: ${result.checks.length} проверок пройдено\n`);
102
+ } else {
103
+ process.stdout.write(`[guard] skipped: ${result.reasons.join("; ")}\n`);
104
+ }
105
+ return result.passed ? 0 : GUARD_SKIP_EXIT_CODE;
106
+ }
107
+
108
+ const invokedPath = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : "";
109
+ if (import.meta.url === invokedPath) {
110
+ main().then(
111
+ (code) => {
112
+ process.exitCode = code;
113
+ },
114
+ (error: unknown) => {
115
+ process.stderr.write(`[guard] ${error instanceof Error ? error.message : String(error)}\n`);
116
+ process.exitCode = 1;
117
+ },
118
+ );
119
+ }