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
package/src/server.ts CHANGED
@@ -1,15 +1,20 @@
1
1
  import http from "node:http";
2
+ import { randomBytes } from "node:crypto";
2
3
  import fs from "node:fs/promises";
3
4
  import { execFile } from "node:child_process";
4
5
  import { promisify } from "node:util";
5
6
  import { loadHistory, loadMetrics } from "./history.js";
6
- import { getHistory, countRunningRecords } from "./db/history-repo.js";
7
+ import {
8
+ getHistory,
9
+ getHistoryForAnalytics,
10
+ countRunningRecords,
11
+ } from "./db/history-repo.js";
7
12
  import { buildAnalytics, historyToCsv } from "./core/analytics.js";
8
13
  import { getSchedulerTitle } from "./core/scheduler/index.js";
9
14
  import { getPluginVersion } from "./version.js";
10
15
  import { checkpointDb, getDbFile, getDbStatus } from "./db/index.js";
11
16
  import { listWorkspaces } from "./workspaces.js";
12
- import { getProfileName, getProfilePort } from "./profiles.js";
17
+ import { DEFAULT_PROFILE, getProfileName, getProfilePort } from "./profiles.js";
13
18
  import { simulatePipeline } from "./core/dry-run.js";
14
19
  import { loadSettings } from "./settings.js";
15
20
  import {
@@ -18,7 +23,9 @@ import {
18
23
  catalogPricePerMillion,
19
24
  normalizeModelId,
20
25
  resolveWhatIfModels,
26
+ selectWhatIfModels,
21
27
  } from "./core/opencode-models.js";
28
+ import type { WhatIfSelection } from "./core/opencode-models.js";
22
29
  import {
23
30
  authenticateHookRequest,
24
31
  extractHookSignature,
@@ -28,7 +35,7 @@ import {
28
35
  import { appendStructuredLog, readStructuredLogs } from "./core/structured-log.js";
29
36
  import { PROMETHEUS_CONTENT_TYPE, renderPrometheusMetrics } from "./core/prometheus.js";
30
37
  import { buildOtlpExport } from "./core/otel.js";
31
- import { readAuditLog, recordAudit } from "./core/audit.js";
38
+ import { auditDateFilterError, readAuditLog, recordAudit } from "./core/audit.js";
32
39
  import { getLocale, t } from "./i18n.js";
33
40
 
34
41
  /**
@@ -65,10 +72,28 @@ function normalizeProcessName(name: string): string {
65
72
  return name;
66
73
  }
67
74
 
75
+ /**
76
+ * Type guard для ошибок с полем `code` (например, `EADDRINUSE` от listen()).
77
+ * Сужает `unknown` из catch до безопасного чтения поля без `as any`.
78
+ */
79
+ function hasErrorCode(err: unknown): err is { code?: unknown } {
80
+ return err !== null &&
81
+ (typeof err === "object" || typeof err === "function") &&
82
+ "code" in err;
83
+ }
84
+
68
85
  /** Маркер-заголовок: по нему узнаём «свой» дашборд, уже слушающий порт. */
69
86
  const DASHBOARD_HEADER = "x-plugin-dashboard";
70
87
  const DASHBOARD_MARKER = "agent-steward";
71
88
 
89
+ /**
90
+ * Профиль, которому принадлежит ответившее приложение (B4).
91
+ * Маркер DASHBOARD_MARKER одинаков у всех профилей, поэтому без этого
92
+ * заголовка второй профиль принимал чужой дашборд за свой: переиспользовал
93
+ * чужой порт и показывал данные другого профиля.
94
+ */
95
+ const PROFILE_HEADER = "x-plugin-profile";
96
+
72
97
  /** Переопределение портов (используется в тестах; по умолчанию 3782/4782). */
73
98
  export interface DashboardPorts {
74
99
  preferred?: number;
@@ -118,6 +143,8 @@ export interface DashboardDeps {
118
143
  } | null;
119
144
  /** Для клона матрицы — имя родительской задачи. */
120
145
  matrixParentId?: string | null;
146
+ /** Экономика v2 (E-2): лимит токенов на запуск (null — без лимита). */
147
+ tokenBudget?: number | null;
121
148
  /** true — задача является родителем матрицы (шаблоном). */
122
149
  isMatrixParent?: boolean;
123
150
  /** Агрегат по клонам матрицы (только у родителя). */
@@ -153,6 +180,8 @@ export interface TaskMetrics {
153
180
  error: number;
154
181
  /** Частичные выполнения: ответ получен, но проверка не прошла. */
155
182
  partial: number;
183
+ /** Запуски в процессе (последняя запись — running, ещё не завершились). */
184
+ running: number;
156
185
  }
157
186
 
158
187
  /** Агрегированная статистика по одной LLM-модели. */
@@ -220,6 +249,8 @@ export function aggregateModels(
220
249
  costUsd?: number;
221
250
  model?: string;
222
251
  }[],
252
+ /** Готовая What-If выборка. Без неё CLI не вызывается: только история и встроенный список. */
253
+ whatIfSelection?: WhatIfSelection,
223
254
  ) {
224
255
  const map = new Map<
225
256
  string,
@@ -276,7 +307,7 @@ export function aggregateModels(
276
307
  const selection =
277
308
  Array.isArray(envWhatIfModels) && envWhatIfModels.length > 0
278
309
  ? { models: envWhatIfModels, source: "env" as const }
279
- : resolveWhatIfModels(usedModels);
310
+ : (whatIfSelection ?? selectWhatIfModels(usedModels, []));
280
311
 
281
312
  const whatIf = selection.models.map((model) => ({
282
313
  model,
@@ -301,17 +332,56 @@ const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
301
332
  /** Единственный активный экземпляр сервера (защита от двойного запуска). */
302
333
  let running: { server: http.Server; port: number } | null = null;
303
334
 
335
+ /**
336
+ * QA-P3.5: порт дашборда, найденного в другом экземпляре плагина/процессе.
337
+ * При переиспользовании чужого дашборда у нас нет его `http.Server`, но
338
+ * reporting-инструменты должны видеть реальный порт, а не null.
339
+ */
340
+ let observedPort: number | null = null;
341
+
304
342
  /** Незавершённый запуск стартовой логики — повторные вызовы делят его между собой. */
305
343
  let starting: Promise<{ port: number } | null> | null = null;
306
344
 
307
- /** Запущен ли дашборд прямо сейчас. */
345
+ /** Запущен ли дашборд прямо сейчас (локальный сервер этого процесса). */
308
346
  export function isDashboardRunning(): boolean {
309
347
  return running !== null;
310
348
  }
311
349
 
312
350
  /** Порт, на котором слушает дашборд (или null, если не запущен). */
313
351
  export function getDashboardPort(): number | null {
314
- return running?.port ?? null;
352
+ return running?.port ?? observedPort ?? null;
353
+ }
354
+
355
+ /** Запоминает порт найденного дашборда (используется и при переиспользовании). */
356
+ function rememberDashboardPort(port: number): void {
357
+ if (Number.isInteger(port) && port > 0) observedPort = port;
358
+ }
359
+
360
+ /**
361
+ * QA-P3.5: кандидаты для поиска живого дашборда. Порт профиля может быть
362
+ * «бумажным» (например, 4782 в env/profile.json), а реально сервер слушает
363
+ * 3782 — поэтому проверяем все стандартные порты зондированием маркера.
364
+ */
365
+ export function dashboardPortCandidates(): number[] {
366
+ const preferred = getProfilePort(getProfileName());
367
+ return Array.from(
368
+ new Set(
369
+ [getDashboardPort(), preferred, PREFERRED_PORT, FALLBACK_PORT, ...EXTRA_PORTS].filter(
370
+ (port): port is number => Number.isInteger(port) && port! > 0,
371
+ ),
372
+ ),
373
+ );
374
+ }
375
+
376
+ /** Находит живой дашборд среди стандартных портов и запоминает его порт. */
377
+ export async function discoverDashboardPort(): Promise<number | null> {
378
+ for (const port of dashboardPortCandidates()) {
379
+ if ((await probeDashboardOn(port)).dashboard) {
380
+ rememberDashboardPort(port);
381
+ return port;
382
+ }
383
+ }
384
+ return null;
315
385
  }
316
386
 
317
387
  /** Локальные имена, которым разрешено обращаться к дашборду. */
@@ -416,8 +486,8 @@ export async function startDashboardServer(
416
486
  running = { server, port: actualPort };
417
487
  console.log(`[agent-steward] Веб-дашборд запущен: http://localhost:${actualPort}`);
418
488
  return { port: actualPort };
419
- } catch (err: any) {
420
- if (err?.code !== "EADDRINUSE") {
489
+ } catch (err: unknown) {
490
+ if (!(hasErrorCode(err) && err.code === "EADDRINUSE")) {
421
491
  console.error(
422
492
  `[agent-steward] Не удалось запустить дашборд на порту ${port}: ${
423
493
  err instanceof Error ? err.message : String(err)
@@ -426,14 +496,26 @@ export async function startDashboardServer(
426
496
  return null;
427
497
  }
428
498
 
429
- // Порт занят: если это уже наш дашборд (другой экземпляр плагина
430
- // в том же процессе/сессии), переиспользуем его, а не вешаем второй порт.
431
- if (port !== 0 && (await isOwnDashboardOn(port))) {
499
+ // Порт занят: если это уже наш дашборд того же профиля (другой
500
+ // экземпляр плагина в том же процессе/сессии), переиспользуем его,
501
+ // а не вешаем второй порт. Дашборд другого профиля не наш: его нельзя
502
+ // ни переиспользовать (покажет чужие данные), ни снимать как зомби.
503
+ const probe = port !== 0 ? await probeDashboardOn(port) : null;
504
+ if (probe?.dashboard && probe.profile === getProfileName()) {
505
+ // QA-P3.5: чужой дашборд не даёт нам http.Server, но его порт должен
506
+ // быть виден через getDashboardPort()/get_dashboard_info.
507
+ rememberDashboardPort(port);
432
508
  console.log(
433
509
  `[agent-steward] Дашборд уже запущен на http://localhost:${port} — переиспользуем его.`,
434
510
  );
435
511
  return { port };
436
512
  }
513
+ if (probe?.dashboard && probe.profile !== getProfileName()) {
514
+ console.warn(
515
+ `[agent-steward] Порт ${port} занят дашбордом профиля "${probe.profile}" — не трогаем, пробуем другой порт.`,
516
+ );
517
+ continue;
518
+ }
437
519
 
438
520
  // Порт занят чужим или старым процессом: пробуем снять зомби
439
521
  // (только node/bun этого плагина) и повторить bind.
@@ -518,7 +600,7 @@ async function tryFreeZombiePort(port: number): Promise<boolean> {
518
600
  `[agent-steward] Снят зомби-процесс ${info.name} (PID ${pid}), державший порт ${port}.`,
519
601
  );
520
602
  killed = true;
521
- } catch (err: any) {
603
+ } catch (err: unknown) {
522
604
  console.warn(
523
605
  `[agent-steward] Не удалось снять процесс PID ${pid}: ${
524
606
  err instanceof Error ? err.message : String(err)
@@ -669,16 +751,34 @@ async function getProcessInfoPosix(
669
751
  }
670
752
  }
671
753
 
672
- /** Проверяет по маркер-заголовку, что на порту отвечает наш дашборд. */
673
- async function isOwnDashboardOn(port: number): Promise<boolean> {
754
+ export interface DashboardProbe {
755
+ /** На порту отвечает наш дашборд (маркер-заголовок совпал). */
756
+ dashboard: boolean;
757
+ /** Профиль ответившего дашборда; null, если это не дашборд. */
758
+ profile: string | null;
759
+ }
760
+
761
+ /**
762
+ * Проверяет по маркер-заголовку, что на порту отвечает наш дашборд,
763
+ * и определяет его профиль (B4.1).
764
+ *
765
+ * Заголовок профиля появился в B4.1. Более старые сборки его не отдают —
766
+ * таких считаем профилем `default`: до появления профилей база была одна,
767
+ * а значит старый процесс работал именно с default.
768
+ */
769
+ export async function probeDashboardOn(port: number): Promise<DashboardProbe> {
674
770
  try {
675
771
  const res = await fetch(`http://127.0.0.1:${port}/`, {
676
772
  method: "GET",
677
773
  signal: AbortSignal.timeout(1500),
678
774
  });
679
- return res.headers.get(DASHBOARD_HEADER) === DASHBOARD_MARKER;
775
+ if (res.headers.get(DASHBOARD_HEADER) !== DASHBOARD_MARKER) {
776
+ return { dashboard: false, profile: null };
777
+ }
778
+ const profile = res.headers.get(PROFILE_HEADER)?.trim() || DEFAULT_PROFILE;
779
+ return { dashboard: true, profile };
680
780
  } catch {
681
- return false;
781
+ return { dashboard: false, profile: null };
682
782
  }
683
783
  }
684
784
 
@@ -688,8 +788,10 @@ async function isOwnDashboardOn(port: number): Promise<boolean> {
688
788
  */
689
789
  export async function closeDashboardServer(): Promise<boolean> {
690
790
  if (!running) return false;
691
- const { server } = running;
791
+ const { server, port } = running;
692
792
  running = null;
793
+ // QA-P3.5: не оставлять «фантомный» порт после закрытия нашего сервера.
794
+ if (observedPort === port) observedPort = null;
693
795
  return new Promise((resolve) => {
694
796
  server.close(() => resolve(true));
695
797
  // Закрываем и keep-alive соединения, чтобы порт освобождался сразу
@@ -789,7 +891,10 @@ async function handleRequest(
789
891
 
790
892
  // Статический HTML-файл — страница дашборда.
791
893
  if (req.method === "GET" && (pathname === "/" || pathname === "/index.html")) {
792
- send(res, 200, "text/html; charset=utf-8", renderPage());
894
+ const nonce = randomBytes(16).toString("base64");
895
+ send(res, 200, "text/html; charset=utf-8", renderPage(nonce), {
896
+ "Content-Security-Policy": dashboardCsp(nonce),
897
+ });
793
898
  return;
794
899
  }
795
900
 
@@ -925,7 +1030,7 @@ async function handleRequest(
925
1030
  try {
926
1031
  const report = await simulatePipeline(taskName);
927
1032
  sendJson(res, 200, report);
928
- } catch (err: any) {
1033
+ } catch (err: unknown) {
929
1034
  sendJson(res, 404, {
930
1035
  success: false,
931
1036
  taskName,
@@ -964,7 +1069,13 @@ async function handleRequest(
964
1069
 
965
1070
  if (req.method === "GET" && pathname === "/api/models-analysis") {
966
1071
  const history = await loadHistory();
967
- sendJson(res, 200, aggregateModels(history));
1072
+ // Список моделей OpenCode берём асинхронно: синхронный спавн CLI вешал
1073
+ // event loop сервера и приводил к его перезапуску (см. opencode-models.ts).
1074
+ const usedModels = history
1075
+ .map((record) => (record.model ?? "").trim())
1076
+ .filter((model) => model !== "" && model !== "по умолчанию");
1077
+ const selection = await resolveWhatIfModels(usedModels);
1078
+ sendJson(res, 200, aggregateModels(history, selection));
968
1079
  return;
969
1080
  }
970
1081
 
@@ -978,7 +1089,7 @@ async function handleRequest(
978
1089
  1,
979
1090
  Math.floor(Number(url.searchParams.get("top")) || 10),
980
1091
  );
981
- const records = getHistory(null, 20000);
1092
+ const records = getHistoryForAnalytics(days);
982
1093
  const tasks = await deps.getTasks();
983
1094
  const report = buildAnalytics(records, {
984
1095
  days,
@@ -986,6 +1097,7 @@ async function handleRequest(
986
1097
  tasks: tasks.map((task) => ({
987
1098
  name: task.name,
988
1099
  matrixParentId: task.matrixParentId ?? null,
1100
+ tokenBudget: task.tokenBudget ?? undefined,
989
1101
  })),
990
1102
  });
991
1103
  sendJson(res, 200, report);
@@ -1067,7 +1179,7 @@ async function handleRequest(
1067
1179
  data,
1068
1180
  `scheduler-${stamp}.db`,
1069
1181
  );
1070
- } catch (err: any) {
1182
+ } catch (err: unknown) {
1071
1183
  sendJson(res, 500, {
1072
1184
  error: `Не удалось экспортировать БД: ${sanitizeError(err)}`,
1073
1185
  });
@@ -1078,6 +1190,15 @@ async function handleRequest(
1078
1190
  // Журнал аудита (Спринт 26): GET /api/audit?action=…&actor=…&limit=…
1079
1191
  if (req.method === "GET" && pathname === "/api/audit") {
1080
1192
  try {
1193
+ const sinceRaw = url.searchParams.get("since") ?? undefined;
1194
+ const untilRaw = url.searchParams.get("until") ?? undefined;
1195
+ const dateError =
1196
+ auditDateFilterError(sinceRaw, "since") ??
1197
+ auditDateFilterError(untilRaw, "until");
1198
+ if (dateError) {
1199
+ sendJson(res, 400, { error: dateError });
1200
+ return;
1201
+ }
1081
1202
  const limitRaw = Number(url.searchParams.get("limit"));
1082
1203
  const result = readAuditLog({
1083
1204
  action: url.searchParams.get("action") ?? undefined,
@@ -1088,7 +1209,7 @@ async function handleRequest(
1088
1209
  limit: Number.isFinite(limitRaw) ? limitRaw : undefined,
1089
1210
  });
1090
1211
  sendJson(res, 200, { success: true, ...result });
1091
- } catch (err: any) {
1212
+ } catch (err: unknown) {
1092
1213
  sendJson(res, 500, {
1093
1214
  error: sanitizeError(err),
1094
1215
  });
@@ -1163,7 +1284,7 @@ async function handleRequest(
1163
1284
  let tasks: Awaited<ReturnType<DashboardDeps["getTasks"]>>;
1164
1285
  try {
1165
1286
  tasks = await deps.getTasks();
1166
- } catch (err: any) {
1287
+ } catch (err: unknown) {
1167
1288
  const message = err instanceof Error ? err.message : String(err);
1168
1289
  logHook(500, "rejected", `Не удалось получить список задач: ${message}`, bodyResult.body.length);
1169
1290
  sendJson(res, 500, { success: false, error: sanitizeError(err) });
@@ -1201,7 +1322,7 @@ async function handleRequest(
1201
1322
  alreadyRunning: Boolean(result?.alreadyRunning),
1202
1323
  message,
1203
1324
  });
1204
- } catch (err: any) {
1325
+ } catch (err: unknown) {
1205
1326
  const message = err instanceof Error ? err.message : String(err);
1206
1327
  logHook(500, "rejected", message, bodyResult.body.length);
1207
1328
  sendJson(res, 500, { success: false, error: sanitizeError(err) });
@@ -1234,7 +1355,7 @@ async function handleRequest(
1234
1355
  ? `Задача "${name}" уже выполняется.`
1235
1356
  : `Задача "${name}" запущена.`,
1236
1357
  });
1237
- } catch (err: any) {
1358
+ } catch (err: unknown) {
1238
1359
  sendJson(res, 500, {
1239
1360
  success: false,
1240
1361
  error: sanitizeError(err),
@@ -1272,7 +1393,7 @@ async function handleRequest(
1272
1393
  message: result.message,
1273
1394
  cancelled: result.cancelled,
1274
1395
  });
1275
- } catch (err: any) {
1396
+ } catch (err: unknown) {
1276
1397
  sendJson(res, 500, {
1277
1398
  success: false,
1278
1399
  error: sanitizeError(err),
@@ -1306,7 +1427,7 @@ async function handleRequest(
1306
1427
  ? `Удалено осиротевших задач: ${removed.length}.`
1307
1428
  : "Осиротевших задач не найдено.",
1308
1429
  });
1309
- } catch (err: any) {
1430
+ } catch (err: unknown) {
1310
1431
  sendJson(res, 500, {
1311
1432
  success: false,
1312
1433
  error: sanitizeError(err),
@@ -1334,7 +1455,7 @@ async function handleRequest(
1334
1455
  remote: req.socket.remoteAddress ?? null,
1335
1456
  });
1336
1457
  sendJson(res, 200, { success: true, message: `Задача "${name}" удалена.` });
1337
- } catch (err: any) {
1458
+ } catch (err: unknown) {
1338
1459
  sendJson(res, 500, {
1339
1460
  success: false,
1340
1461
  error: sanitizeError(err),
@@ -1346,7 +1467,7 @@ async function handleRequest(
1346
1467
  // Любой неизвестный путь — строго JSON, чтобы клиент не пытался
1347
1468
  // разобрать HTML/картинку как JSON.
1348
1469
  sendJson(res, 404, { error: t("server.notFound") });
1349
- } catch (err: any) {
1470
+ } catch (err: unknown) {
1350
1471
  const message = err instanceof Error ? err.message : String(err);
1351
1472
  console.error(`[agent-steward] Ошибка обработки запроса ${req.url}: ${message}`);
1352
1473
  if (res.headersSent) {
@@ -1370,7 +1491,7 @@ function sendJson(res: http.ServerResponse, status: number, payload: unknown): v
1370
1491
 
1371
1492
  /** Санитизирует сообщение об ошибке для клиентского ответа.
1372
1493
  * Подробности стека/пути/токенов не утекают наружу — пишем только в лог. */
1373
- function sanitizeError(err: any): string {
1494
+ function sanitizeError(err: unknown): string {
1374
1495
  if (err instanceof Error) {
1375
1496
  const msg = err.message;
1376
1497
  // Убираем внутренние пути и стеки
@@ -1380,16 +1501,43 @@ function sanitizeError(err: any): string {
1380
1501
  }
1381
1502
 
1382
1503
  /** Отправляет ответ с телом и закрывает соединение. */
1383
- function send(res: http.ServerResponse, status: number, contentType: string, body: string): void {
1504
+ function send(
1505
+ res: http.ServerResponse,
1506
+ status: number,
1507
+ contentType: string,
1508
+ body: string,
1509
+ extraHeaders?: Record<string, string>,
1510
+ ): void {
1384
1511
  res.writeHead(status, {
1385
1512
  "Content-Type": contentType,
1386
1513
  "Cache-Control": "no-store",
1387
1514
  "X-Content-Type-Options": "nosniff",
1388
1515
  [DASHBOARD_HEADER]: DASHBOARD_MARKER,
1516
+ [PROFILE_HEADER]: getProfileName(),
1517
+ ...extraHeaders,
1389
1518
  });
1390
1519
  res.end(body);
1391
1520
  }
1392
1521
 
1522
+ /**
1523
+ * CSP страницы дашборда: defense in depth к экранированию (B3.4).
1524
+ * Единственный инлайн-скрипт помечается nonce, внешние скрипты запрещены;
1525
+ * инлайн-стили остаются разрешёнными, потому что разметка использует style="…".
1526
+ */
1527
+ function dashboardCsp(nonce: string): string {
1528
+ return [
1529
+ "default-src 'none'",
1530
+ `script-src 'nonce-${nonce}'`,
1531
+ "style-src 'unsafe-inline'",
1532
+ "connect-src 'self'",
1533
+ "img-src 'self' data:",
1534
+ "base-uri 'none'",
1535
+ "form-action 'none'",
1536
+ "frame-ancestors 'none'",
1537
+ "object-src 'none'",
1538
+ ].join("; ");
1539
+ }
1540
+
1393
1541
  /** Отправляет бинарный файл (скачивание .db-бэкапа). */
1394
1542
  function sendBuffer(
1395
1543
  res: http.ServerResponse,
@@ -1409,6 +1557,7 @@ function sendBuffer(
1409
1557
  "Cache-Control": "no-store",
1410
1558
  "X-Content-Type-Options": "nosniff",
1411
1559
  [DASHBOARD_HEADER]: DASHBOARD_MARKER,
1560
+ [PROFILE_HEADER]: getProfileName(),
1412
1561
  });
1413
1562
  res.end(body);
1414
1563
  }
@@ -1432,6 +1581,7 @@ function sendAttachment(
1432
1581
  "Cache-Control": "no-store",
1433
1582
  "X-Content-Type-Options": "nosniff",
1434
1583
  [DASHBOARD_HEADER]: DASHBOARD_MARKER,
1584
+ [PROFILE_HEADER]: getProfileName(),
1435
1585
  });
1436
1586
  res.end(body);
1437
1587
  }
@@ -1447,10 +1597,11 @@ async function collectTasksWithMetrics(deps: DashboardDeps) {
1447
1597
  for (const r of history) {
1448
1598
  const key = String(r.taskName || "").toLowerCase();
1449
1599
  if (!key) continue;
1450
- const m = byTask.get(key) ?? { total: 0, success: 0, error: 0, partial: 0 };
1600
+ const m = byTask.get(key) ?? { total: 0, success: 0, error: 0, partial: 0, running: 0 };
1451
1601
  m.total += 1;
1452
1602
  if (r.status === "success") m.success += 1;
1453
1603
  else if (r.status === "partial") m.partial += 1;
1604
+ else if (r.status === "running") m.running += 1;
1454
1605
  else m.error += 1;
1455
1606
  byTask.set(key, m);
1456
1607
  }
@@ -1462,6 +1613,7 @@ async function collectTasksWithMetrics(deps: DashboardDeps) {
1462
1613
  success: 0,
1463
1614
  error: 0,
1464
1615
  partial: 0,
1616
+ running: 0,
1465
1617
  },
1466
1618
  }));
1467
1619
  }
@@ -1471,7 +1623,7 @@ async function collectTasksWithMetrics(deps: DashboardDeps) {
1471
1623
  * Данные тянутся fetch'ем с JSON-API и перерисовываются каждые 5 секунд.
1472
1624
  * Внутри строковой константы не используются бэктики и ${}, чтобы не экранировать.
1473
1625
  */
1474
- function renderPage(): string {
1626
+ function renderPage(nonce: string): string {
1475
1627
  return `<!DOCTYPE html>
1476
1628
  <html lang="${getLocale()}">
1477
1629
  <head>
@@ -1756,7 +1908,7 @@ function renderPage(): string {
1756
1908
  </div>
1757
1909
  <div id="toast" role="status" aria-live="polite"></div>
1758
1910
 
1759
- <script>
1911
+ <script nonce="${nonce}">
1760
1912
  (function () {
1761
1913
  'use strict';
1762
1914
 
@@ -1779,10 +1931,17 @@ function renderPage(): string {
1779
1931
  // P3-29: тяжёлая аналитика обновляется реже остальных блоков.
1780
1932
  var ANALYTICS_INTERVAL_MS = 60000;
1781
1933
 
1934
+ // Экранирование для текстового и атрибутного контекста.
1935
+ // Раньше использовался div.innerHTML: он превращает & < > в сущности,
1936
+ // но оставляет кавычки как есть, а результат подставляется в
1937
+ // title="…", style="…", data-*="…" и href="…" — это и был вектор XSS.
1782
1938
  function esc(s) {
1783
- var d = document.createElement('div');
1784
- d.textContent = s == null ? '' : String(s);
1785
- return d.innerHTML;
1939
+ return String(s == null ? '' : s)
1940
+ .replace(/&/g, '&amp;')
1941
+ .replace(/</g, '&lt;')
1942
+ .replace(/>/g, '&gt;')
1943
+ .replace(/"/g, '&quot;')
1944
+ .replace(/'/g, '&#39;');
1786
1945
  }
1787
1946
 
1788
1947
  function toast(msg, kind) {
@@ -1852,7 +2011,7 @@ function renderPage(): string {
1852
2011
  );
1853
2012
  throw new Error('Сервер вернул не JSON. Проверьте консоль.');
1854
2013
  }
1855
- if (marker !== 'opencode-windows-scheduler') {
2014
+ if (marker !== 'agent-steward' && marker !== 'opencode-windows-scheduler') {
1856
2015
  console.warn(
1857
2016
  'В ответе нет заголовка x-plugin-dashboard — возможно, это не дашборд плагина.'
1858
2017
  );
@@ -2232,8 +2391,9 @@ function renderPage(): string {
2232
2391
  var text = String(value == null ? '' : value);
2233
2392
  return text.length > max ? text.slice(0, max - 1) + '…' : text;
2234
2393
  }
2394
+ // esc() уже экранирует кавычки, отдельная подмена " больше не нужна.
2235
2395
  function attr(value) {
2236
- return esc(String(value == null ? '' : value)).replace(/"/g, '&quot;');
2396
+ return esc(value);
2237
2397
  }
2238
2398
  function statusClass(status) {
2239
2399
  if (status === 'success') return ' okg';
@@ -2719,7 +2879,7 @@ function renderPage(): string {
2719
2879
  })();
2720
2880
  </script>
2721
2881
 
2722
- <script>
2882
+ <script nonce="${nonce}">
2723
2883
  (function () {
2724
2884
  var flakes = ['❄', '❅', '❆'];
2725
2885
  for (var i = 0; i < 18; i++) {