agent-steward 0.0.5 → 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 (191) hide show
  1. package/CHANGELOG.md +176 -1
  2. package/README.md +9 -7
  3. package/ROADMAP-STRATEGY.md +5 -5
  4. package/ROADMAP.md +107 -17
  5. package/dist/cli.js +5 -0
  6. package/dist/core/analytics.d.ts +6 -0
  7. package/dist/core/analytics.d.ts.map +1 -1
  8. package/dist/core/analytics.js +20 -3
  9. package/dist/core/audit.d.ts +6 -0
  10. package/dist/core/audit.d.ts.map +1 -1
  11. package/dist/core/audit.js +24 -0
  12. package/dist/core/budget.d.ts +118 -0
  13. package/dist/core/budget.d.ts.map +1 -0
  14. package/dist/core/budget.js +206 -0
  15. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  16. package/dist/core/cron-to-schtasks.js +38 -0
  17. package/dist/core/dry-run.d.ts +26 -1
  18. package/dist/core/dry-run.d.ts.map +1 -1
  19. package/dist/core/dry-run.js +199 -8
  20. package/dist/core/feedback.d.ts +192 -0
  21. package/dist/core/feedback.d.ts.map +1 -0
  22. package/dist/core/feedback.js +426 -0
  23. package/dist/core/gate-integrity.d.ts +36 -0
  24. package/dist/core/gate-integrity.d.ts.map +1 -1
  25. package/dist/core/gate-integrity.js +144 -1
  26. package/dist/core/local-ai.d.ts.map +1 -1
  27. package/dist/core/local-ai.js +7 -3
  28. package/dist/core/matrix.d.ts +8 -0
  29. package/dist/core/matrix.d.ts.map +1 -1
  30. package/dist/core/matrix.js +57 -2
  31. package/dist/core/mission.d.ts +20 -0
  32. package/dist/core/mission.d.ts.map +1 -1
  33. package/dist/core/mission.js +45 -5
  34. package/dist/core/opencode-models.d.ts +2 -2
  35. package/dist/core/opencode-models.d.ts.map +1 -1
  36. package/dist/core/opencode-models.js +28 -21
  37. package/dist/core/opencode-usage.d.ts +35 -0
  38. package/dist/core/opencode-usage.d.ts.map +1 -0
  39. package/dist/core/opencode-usage.js +132 -0
  40. package/dist/core/pipeline-io.d.ts +1 -1
  41. package/dist/core/pipeline-io.d.ts.map +1 -1
  42. package/dist/core/pipeline-io.js +26 -12
  43. package/dist/core/pipeline-map.d.ts +6 -0
  44. package/dist/core/pipeline-map.d.ts.map +1 -1
  45. package/dist/core/pipeline-map.js +12 -0
  46. package/dist/core/ps-wrapper.d.ts +10 -2
  47. package/dist/core/ps-wrapper.d.ts.map +1 -1
  48. package/dist/core/ps-wrapper.js +176 -5
  49. package/dist/core/record-history.d.ts.map +1 -1
  50. package/dist/core/record-history.js +76 -4
  51. package/dist/core/run-mode.d.ts +12 -0
  52. package/dist/core/run-mode.d.ts.map +1 -0
  53. package/dist/core/run-mode.js +17 -0
  54. package/dist/core/scheduler/logs.d.ts +4 -0
  55. package/dist/core/scheduler/logs.d.ts.map +1 -1
  56. package/dist/core/scheduler/logs.js +25 -1
  57. package/dist/core/secrets.d.ts.map +1 -1
  58. package/dist/core/secrets.js +18 -8
  59. package/dist/core/self-analysis.d.ts +32 -2
  60. package/dist/core/self-analysis.d.ts.map +1 -1
  61. package/dist/core/self-analysis.js +38 -27
  62. package/dist/core/shutdown.d.ts +33 -2
  63. package/dist/core/shutdown.d.ts.map +1 -1
  64. package/dist/core/shutdown.js +58 -2
  65. package/dist/core/structured-log.d.ts +30 -0
  66. package/dist/core/structured-log.d.ts.map +1 -1
  67. package/dist/core/structured-log.js +37 -0
  68. package/dist/core/usage-surface.d.ts +25 -0
  69. package/dist/core/usage-surface.d.ts.map +1 -0
  70. package/dist/core/usage-surface.js +41 -0
  71. package/dist/core/wrappers/bash.d.ts +2 -0
  72. package/dist/core/wrappers/bash.d.ts.map +1 -1
  73. package/dist/core/wrappers/bash.js +58 -6
  74. package/dist/db/history-repo.d.ts +32 -0
  75. package/dist/db/history-repo.d.ts.map +1 -1
  76. package/dist/db/history-repo.js +85 -7
  77. package/dist/db/metrics-repo.d.ts +20 -2
  78. package/dist/db/metrics-repo.d.ts.map +1 -1
  79. package/dist/db/metrics-repo.js +33 -11
  80. package/dist/db/migrate.d.ts.map +1 -1
  81. package/dist/db/migrate.js +37 -17
  82. package/dist/db/recovery.d.ts +3 -1
  83. package/dist/db/recovery.d.ts.map +1 -1
  84. package/dist/db/recovery.js +9 -4
  85. package/dist/db/runs-repo.d.ts.map +1 -1
  86. package/dist/db/runs-repo.js +71 -56
  87. package/dist/db/schema.d.ts +2 -2
  88. package/dist/db/schema.d.ts.map +1 -1
  89. package/dist/db/schema.js +70 -1
  90. package/dist/db/templates-repo.d.ts +2 -2
  91. package/dist/db/templates-repo.d.ts.map +1 -1
  92. package/dist/db/templates-repo.js +5 -3
  93. package/dist/history.d.ts +6 -1
  94. package/dist/history.d.ts.map +1 -1
  95. package/dist/history.js +4 -2
  96. package/dist/hook-output.d.ts +2 -0
  97. package/dist/hook-output.d.ts.map +1 -0
  98. package/dist/hook-output.js +31 -0
  99. package/dist/index.d.ts +247 -53
  100. package/dist/index.d.ts.map +1 -1
  101. package/dist/index.js +999 -211
  102. package/dist/notifications.d.ts +31 -2
  103. package/dist/notifications.d.ts.map +1 -1
  104. package/dist/notifications.js +132 -13
  105. package/dist/profiles.d.ts.map +1 -1
  106. package/dist/profiles.js +66 -15
  107. package/dist/rpc.d.ts +108 -0
  108. package/dist/rpc.d.ts.map +1 -1
  109. package/dist/rpc.js +28 -0
  110. package/dist/server.d.ts +17 -2
  111. package/dist/server.d.ts.map +1 -1
  112. package/dist/server.js +77 -12
  113. package/dist/settings.d.ts +42 -0
  114. package/dist/settings.d.ts.map +1 -1
  115. package/dist/settings.js +82 -0
  116. package/dist/task-transfer.d.ts +5 -0
  117. package/dist/task-transfer.d.ts.map +1 -1
  118. package/dist/task-transfer.js +48 -3
  119. package/dist/templates.d.ts +2 -2
  120. package/dist/templates.d.ts.map +1 -1
  121. package/dist/templates.js +3 -3
  122. package/dist/types.d.ts +22 -2
  123. package/dist/types.d.ts.map +1 -1
  124. package/dist/workspaces.d.ts.map +1 -1
  125. package/dist/workspaces.js +34 -11
  126. package/docs/ARCHITECTURE.md +49 -12
  127. package/docs/COMPATIBILITY.md +2 -2
  128. package/docs/EXECUTION-LOOP.md +6 -3
  129. package/docs/FEATURES.md +65 -4
  130. package/docs/FEATURES.zh.md +45 -2
  131. package/docs/QA-A2-GUI-TUI.md +205 -0
  132. package/docs/README.ru.md +3 -3
  133. package/docs/README.zh.md +2 -2
  134. package/gui-experimental.cjs +9 -9
  135. package/locales/en.json +42 -3
  136. package/locales/ru.json +42 -3
  137. package/locales/zh.json +42 -3
  138. package/package.json +15 -2
  139. package/scripts/check-eslint-baseline.mjs +139 -0
  140. package/scripts/gen-test-plan-counters.mjs +117 -0
  141. package/scripts/github-ci-fetch.ps1 +37 -0
  142. package/scripts/pl-commit.ps1 +112 -0
  143. package/scripts/qa-a2-commit.ps1 +104 -0
  144. package/scripts/test-home.mjs +26 -2
  145. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  146. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  147. package/src/cli.ts +5 -0
  148. package/src/core/analytics.ts +27 -4
  149. package/src/core/audit.ts +25 -0
  150. package/src/core/budget.ts +340 -0
  151. package/src/core/cron-to-schtasks.ts +42 -0
  152. package/src/core/dry-run.ts +233 -10
  153. package/src/core/feedback.ts +582 -0
  154. package/src/core/gate-integrity.ts +171 -1
  155. package/src/core/local-ai.ts +7 -3
  156. package/src/core/matrix.ts +63 -2
  157. package/src/core/mission.ts +51 -5
  158. package/src/core/opencode-models.ts +30 -21
  159. package/src/core/opencode-usage.ts +182 -0
  160. package/src/core/pipeline-io.ts +28 -11
  161. package/src/core/pipeline-map.ts +19 -0
  162. package/src/core/ps-wrapper.ts +173 -4
  163. package/src/core/record-history.ts +94 -4
  164. package/src/core/run-mode.ts +19 -0
  165. package/src/core/scheduler/logs.ts +32 -1
  166. package/src/core/secrets.ts +18 -11
  167. package/src/core/self-analysis.ts +75 -29
  168. package/src/core/shutdown.ts +90 -4
  169. package/src/core/structured-log.ts +67 -0
  170. package/src/core/usage-surface.ts +70 -0
  171. package/src/core/wrappers/bash.ts +60 -5
  172. package/src/db/history-repo.ts +153 -19
  173. package/src/db/metrics-repo.ts +38 -11
  174. package/src/db/migrate.ts +57 -32
  175. package/src/db/recovery.ts +10 -4
  176. package/src/db/runs-repo.ts +113 -61
  177. package/src/db/schema.ts +70 -1
  178. package/src/db/templates-repo.ts +5 -3
  179. package/src/gui.tsx +261 -5
  180. package/src/history.ts +10 -3
  181. package/src/hook-output.ts +39 -0
  182. package/src/index.ts +1407 -345
  183. package/src/notifications.ts +189 -39
  184. package/src/profiles.ts +72 -16
  185. package/src/rpc.ts +30 -0
  186. package/src/server.ts +107 -23
  187. package/src/settings.ts +120 -0
  188. package/src/task-transfer.ts +59 -6
  189. package/src/templates.ts +3 -3
  190. package/src/types.ts +23 -2
  191. package/src/workspaces.ts +37 -14
package/src/server.ts CHANGED
@@ -4,7 +4,11 @@ import fs from "node:fs/promises";
4
4
  import { execFile } from "node:child_process";
5
5
  import { promisify } from "node:util";
6
6
  import { loadHistory, loadMetrics } from "./history.js";
7
- import { getHistory, countRunningRecords } from "./db/history-repo.js";
7
+ import {
8
+ getHistory,
9
+ getHistoryForAnalytics,
10
+ countRunningRecords,
11
+ } from "./db/history-repo.js";
8
12
  import { buildAnalytics, historyToCsv } from "./core/analytics.js";
9
13
  import { getSchedulerTitle } from "./core/scheduler/index.js";
10
14
  import { getPluginVersion } from "./version.js";
@@ -19,7 +23,9 @@ import {
19
23
  catalogPricePerMillion,
20
24
  normalizeModelId,
21
25
  resolveWhatIfModels,
26
+ selectWhatIfModels,
22
27
  } from "./core/opencode-models.js";
28
+ import type { WhatIfSelection } from "./core/opencode-models.js";
23
29
  import {
24
30
  authenticateHookRequest,
25
31
  extractHookSignature,
@@ -29,7 +35,7 @@ import {
29
35
  import { appendStructuredLog, readStructuredLogs } from "./core/structured-log.js";
30
36
  import { PROMETHEUS_CONTENT_TYPE, renderPrometheusMetrics } from "./core/prometheus.js";
31
37
  import { buildOtlpExport } from "./core/otel.js";
32
- import { readAuditLog, recordAudit } from "./core/audit.js";
38
+ import { auditDateFilterError, readAuditLog, recordAudit } from "./core/audit.js";
33
39
  import { getLocale, t } from "./i18n.js";
34
40
 
35
41
  /**
@@ -66,6 +72,16 @@ function normalizeProcessName(name: string): string {
66
72
  return name;
67
73
  }
68
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
+
69
85
  /** Маркер-заголовок: по нему узнаём «свой» дашборд, уже слушающий порт. */
70
86
  const DASHBOARD_HEADER = "x-plugin-dashboard";
71
87
  const DASHBOARD_MARKER = "agent-steward";
@@ -127,6 +143,8 @@ export interface DashboardDeps {
127
143
  } | null;
128
144
  /** Для клона матрицы — имя родительской задачи. */
129
145
  matrixParentId?: string | null;
146
+ /** Экономика v2 (E-2): лимит токенов на запуск (null — без лимита). */
147
+ tokenBudget?: number | null;
130
148
  /** true — задача является родителем матрицы (шаблоном). */
131
149
  isMatrixParent?: boolean;
132
150
  /** Агрегат по клонам матрицы (только у родителя). */
@@ -162,6 +180,8 @@ export interface TaskMetrics {
162
180
  error: number;
163
181
  /** Частичные выполнения: ответ получен, но проверка не прошла. */
164
182
  partial: number;
183
+ /** Запуски в процессе (последняя запись — running, ещё не завершились). */
184
+ running: number;
165
185
  }
166
186
 
167
187
  /** Агрегированная статистика по одной LLM-модели. */
@@ -229,6 +249,8 @@ export function aggregateModels(
229
249
  costUsd?: number;
230
250
  model?: string;
231
251
  }[],
252
+ /** Готовая What-If выборка. Без неё CLI не вызывается: только история и встроенный список. */
253
+ whatIfSelection?: WhatIfSelection,
232
254
  ) {
233
255
  const map = new Map<
234
256
  string,
@@ -285,7 +307,7 @@ export function aggregateModels(
285
307
  const selection =
286
308
  Array.isArray(envWhatIfModels) && envWhatIfModels.length > 0
287
309
  ? { models: envWhatIfModels, source: "env" as const }
288
- : resolveWhatIfModels(usedModels);
310
+ : (whatIfSelection ?? selectWhatIfModels(usedModels, []));
289
311
 
290
312
  const whatIf = selection.models.map((model) => ({
291
313
  model,
@@ -310,17 +332,56 @@ const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
310
332
  /** Единственный активный экземпляр сервера (защита от двойного запуска). */
311
333
  let running: { server: http.Server; port: number } | null = null;
312
334
 
335
+ /**
336
+ * QA-P3.5: порт дашборда, найденного в другом экземпляре плагина/процессе.
337
+ * При переиспользовании чужого дашборда у нас нет его `http.Server`, но
338
+ * reporting-инструменты должны видеть реальный порт, а не null.
339
+ */
340
+ let observedPort: number | null = null;
341
+
313
342
  /** Незавершённый запуск стартовой логики — повторные вызовы делят его между собой. */
314
343
  let starting: Promise<{ port: number } | null> | null = null;
315
344
 
316
- /** Запущен ли дашборд прямо сейчас. */
345
+ /** Запущен ли дашборд прямо сейчас (локальный сервер этого процесса). */
317
346
  export function isDashboardRunning(): boolean {
318
347
  return running !== null;
319
348
  }
320
349
 
321
350
  /** Порт, на котором слушает дашборд (или null, если не запущен). */
322
351
  export function getDashboardPort(): number | null {
323
- 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;
324
385
  }
325
386
 
326
387
  /** Локальные имена, которым разрешено обращаться к дашборду. */
@@ -425,8 +486,8 @@ export async function startDashboardServer(
425
486
  running = { server, port: actualPort };
426
487
  console.log(`[agent-steward] Веб-дашборд запущен: http://localhost:${actualPort}`);
427
488
  return { port: actualPort };
428
- } catch (err: any) {
429
- if (err?.code !== "EADDRINUSE") {
489
+ } catch (err: unknown) {
490
+ if (!(hasErrorCode(err) && err.code === "EADDRINUSE")) {
430
491
  console.error(
431
492
  `[agent-steward] Не удалось запустить дашборд на порту ${port}: ${
432
493
  err instanceof Error ? err.message : String(err)
@@ -441,6 +502,9 @@ export async function startDashboardServer(
441
502
  // ни переиспользовать (покажет чужие данные), ни снимать как зомби.
442
503
  const probe = port !== 0 ? await probeDashboardOn(port) : null;
443
504
  if (probe?.dashboard && probe.profile === getProfileName()) {
505
+ // QA-P3.5: чужой дашборд не даёт нам http.Server, но его порт должен
506
+ // быть виден через getDashboardPort()/get_dashboard_info.
507
+ rememberDashboardPort(port);
444
508
  console.log(
445
509
  `[agent-steward] Дашборд уже запущен на http://localhost:${port} — переиспользуем его.`,
446
510
  );
@@ -536,7 +600,7 @@ async function tryFreeZombiePort(port: number): Promise<boolean> {
536
600
  `[agent-steward] Снят зомби-процесс ${info.name} (PID ${pid}), державший порт ${port}.`,
537
601
  );
538
602
  killed = true;
539
- } catch (err: any) {
603
+ } catch (err: unknown) {
540
604
  console.warn(
541
605
  `[agent-steward] Не удалось снять процесс PID ${pid}: ${
542
606
  err instanceof Error ? err.message : String(err)
@@ -724,8 +788,10 @@ export async function probeDashboardOn(port: number): Promise<DashboardProbe> {
724
788
  */
725
789
  export async function closeDashboardServer(): Promise<boolean> {
726
790
  if (!running) return false;
727
- const { server } = running;
791
+ const { server, port } = running;
728
792
  running = null;
793
+ // QA-P3.5: не оставлять «фантомный» порт после закрытия нашего сервера.
794
+ if (observedPort === port) observedPort = null;
729
795
  return new Promise((resolve) => {
730
796
  server.close(() => resolve(true));
731
797
  // Закрываем и keep-alive соединения, чтобы порт освобождался сразу
@@ -964,7 +1030,7 @@ async function handleRequest(
964
1030
  try {
965
1031
  const report = await simulatePipeline(taskName);
966
1032
  sendJson(res, 200, report);
967
- } catch (err: any) {
1033
+ } catch (err: unknown) {
968
1034
  sendJson(res, 404, {
969
1035
  success: false,
970
1036
  taskName,
@@ -1003,7 +1069,13 @@ async function handleRequest(
1003
1069
 
1004
1070
  if (req.method === "GET" && pathname === "/api/models-analysis") {
1005
1071
  const history = await loadHistory();
1006
- 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));
1007
1079
  return;
1008
1080
  }
1009
1081
 
@@ -1017,7 +1089,7 @@ async function handleRequest(
1017
1089
  1,
1018
1090
  Math.floor(Number(url.searchParams.get("top")) || 10),
1019
1091
  );
1020
- const records = getHistory(null, 20000);
1092
+ const records = getHistoryForAnalytics(days);
1021
1093
  const tasks = await deps.getTasks();
1022
1094
  const report = buildAnalytics(records, {
1023
1095
  days,
@@ -1025,6 +1097,7 @@ async function handleRequest(
1025
1097
  tasks: tasks.map((task) => ({
1026
1098
  name: task.name,
1027
1099
  matrixParentId: task.matrixParentId ?? null,
1100
+ tokenBudget: task.tokenBudget ?? undefined,
1028
1101
  })),
1029
1102
  });
1030
1103
  sendJson(res, 200, report);
@@ -1106,7 +1179,7 @@ async function handleRequest(
1106
1179
  data,
1107
1180
  `scheduler-${stamp}.db`,
1108
1181
  );
1109
- } catch (err: any) {
1182
+ } catch (err: unknown) {
1110
1183
  sendJson(res, 500, {
1111
1184
  error: `Не удалось экспортировать БД: ${sanitizeError(err)}`,
1112
1185
  });
@@ -1117,6 +1190,15 @@ async function handleRequest(
1117
1190
  // Журнал аудита (Спринт 26): GET /api/audit?action=…&actor=…&limit=…
1118
1191
  if (req.method === "GET" && pathname === "/api/audit") {
1119
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
+ }
1120
1202
  const limitRaw = Number(url.searchParams.get("limit"));
1121
1203
  const result = readAuditLog({
1122
1204
  action: url.searchParams.get("action") ?? undefined,
@@ -1127,7 +1209,7 @@ async function handleRequest(
1127
1209
  limit: Number.isFinite(limitRaw) ? limitRaw : undefined,
1128
1210
  });
1129
1211
  sendJson(res, 200, { success: true, ...result });
1130
- } catch (err: any) {
1212
+ } catch (err: unknown) {
1131
1213
  sendJson(res, 500, {
1132
1214
  error: sanitizeError(err),
1133
1215
  });
@@ -1202,7 +1284,7 @@ async function handleRequest(
1202
1284
  let tasks: Awaited<ReturnType<DashboardDeps["getTasks"]>>;
1203
1285
  try {
1204
1286
  tasks = await deps.getTasks();
1205
- } catch (err: any) {
1287
+ } catch (err: unknown) {
1206
1288
  const message = err instanceof Error ? err.message : String(err);
1207
1289
  logHook(500, "rejected", `Не удалось получить список задач: ${message}`, bodyResult.body.length);
1208
1290
  sendJson(res, 500, { success: false, error: sanitizeError(err) });
@@ -1240,7 +1322,7 @@ async function handleRequest(
1240
1322
  alreadyRunning: Boolean(result?.alreadyRunning),
1241
1323
  message,
1242
1324
  });
1243
- } catch (err: any) {
1325
+ } catch (err: unknown) {
1244
1326
  const message = err instanceof Error ? err.message : String(err);
1245
1327
  logHook(500, "rejected", message, bodyResult.body.length);
1246
1328
  sendJson(res, 500, { success: false, error: sanitizeError(err) });
@@ -1273,7 +1355,7 @@ async function handleRequest(
1273
1355
  ? `Задача "${name}" уже выполняется.`
1274
1356
  : `Задача "${name}" запущена.`,
1275
1357
  });
1276
- } catch (err: any) {
1358
+ } catch (err: unknown) {
1277
1359
  sendJson(res, 500, {
1278
1360
  success: false,
1279
1361
  error: sanitizeError(err),
@@ -1311,7 +1393,7 @@ async function handleRequest(
1311
1393
  message: result.message,
1312
1394
  cancelled: result.cancelled,
1313
1395
  });
1314
- } catch (err: any) {
1396
+ } catch (err: unknown) {
1315
1397
  sendJson(res, 500, {
1316
1398
  success: false,
1317
1399
  error: sanitizeError(err),
@@ -1345,7 +1427,7 @@ async function handleRequest(
1345
1427
  ? `Удалено осиротевших задач: ${removed.length}.`
1346
1428
  : "Осиротевших задач не найдено.",
1347
1429
  });
1348
- } catch (err: any) {
1430
+ } catch (err: unknown) {
1349
1431
  sendJson(res, 500, {
1350
1432
  success: false,
1351
1433
  error: sanitizeError(err),
@@ -1373,7 +1455,7 @@ async function handleRequest(
1373
1455
  remote: req.socket.remoteAddress ?? null,
1374
1456
  });
1375
1457
  sendJson(res, 200, { success: true, message: `Задача "${name}" удалена.` });
1376
- } catch (err: any) {
1458
+ } catch (err: unknown) {
1377
1459
  sendJson(res, 500, {
1378
1460
  success: false,
1379
1461
  error: sanitizeError(err),
@@ -1385,7 +1467,7 @@ async function handleRequest(
1385
1467
  // Любой неизвестный путь — строго JSON, чтобы клиент не пытался
1386
1468
  // разобрать HTML/картинку как JSON.
1387
1469
  sendJson(res, 404, { error: t("server.notFound") });
1388
- } catch (err: any) {
1470
+ } catch (err: unknown) {
1389
1471
  const message = err instanceof Error ? err.message : String(err);
1390
1472
  console.error(`[agent-steward] Ошибка обработки запроса ${req.url}: ${message}`);
1391
1473
  if (res.headersSent) {
@@ -1409,7 +1491,7 @@ function sendJson(res: http.ServerResponse, status: number, payload: unknown): v
1409
1491
 
1410
1492
  /** Санитизирует сообщение об ошибке для клиентского ответа.
1411
1493
  * Подробности стека/пути/токенов не утекают наружу — пишем только в лог. */
1412
- function sanitizeError(err: any): string {
1494
+ function sanitizeError(err: unknown): string {
1413
1495
  if (err instanceof Error) {
1414
1496
  const msg = err.message;
1415
1497
  // Убираем внутренние пути и стеки
@@ -1515,10 +1597,11 @@ async function collectTasksWithMetrics(deps: DashboardDeps) {
1515
1597
  for (const r of history) {
1516
1598
  const key = String(r.taskName || "").toLowerCase();
1517
1599
  if (!key) continue;
1518
- 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 };
1519
1601
  m.total += 1;
1520
1602
  if (r.status === "success") m.success += 1;
1521
1603
  else if (r.status === "partial") m.partial += 1;
1604
+ else if (r.status === "running") m.running += 1;
1522
1605
  else m.error += 1;
1523
1606
  byTask.set(key, m);
1524
1607
  }
@@ -1530,6 +1613,7 @@ async function collectTasksWithMetrics(deps: DashboardDeps) {
1530
1613
  success: 0,
1531
1614
  error: 0,
1532
1615
  partial: 0,
1616
+ running: 0,
1533
1617
  },
1534
1618
  }));
1535
1619
  }
package/src/settings.ts CHANGED
@@ -8,6 +8,7 @@ import {
8
8
  normalizePolicy,
9
9
  type PermissionPolicy,
10
10
  } from "./core/permissions.js";
11
+ import { defaultBudgetSettings, type BudgetSettings } from "./core/budget.js";
11
12
 
12
13
  /** Настройки webhook-уведомлений (Discord/Slack/generic). */
13
14
  export interface WebhookNotificationSettings {
@@ -354,6 +355,25 @@ export interface PermissionSettings {
354
355
  defaultPolicy: PermissionPolicy;
355
356
  }
356
357
 
358
+ /**
359
+ * Деталь 3.8: канал «пользователь → автор».
360
+ *
361
+ * В настройках хранится только URL write-only приёмника. Никаких токенов:
362
+ * PAT живёт в секретах Cloudflare Worker (infra/feedback-worker).
363
+ */
364
+ export interface FeedbackSettings {
365
+ /** Включена ли отправка отчётов автору. По умолчанию выключена. */
366
+ enabled: boolean;
367
+ /** URL приёмника (`POST /report`). Пустой → fail-open в локальный outbox. */
368
+ endpoint: string;
369
+ /** Прикладывать логи. По умолчанию false — приватность важнее. */
370
+ includeLogs: boolean;
371
+ /** Обратный адрес (опционально, попадает в payload). */
372
+ contactEmail: string;
373
+ /** Лимит отчётов в час (антиспам, F-1.7). */
374
+ maxPerHour: number;
375
+ }
376
+
357
377
  /**
358
378
  * Глобальные настройки плагина, которые меняются из GUI.
359
379
  * Хранятся в settings.json рядом с tasks.json / history.json.
@@ -384,6 +404,10 @@ export interface SchedulerSettings {
384
404
  audit: AuditSettings;
385
405
  /** Политика прав фоновых задач (Спринт 32). */
386
406
  permissions: PermissionSettings;
407
+ /** Бюджеты день/неделя (Экономика v2, E-1.1). */
408
+ budgets: BudgetSettings;
409
+ /** Обратная связь пользователей (Деталь 3.8). */
410
+ feedback: FeedbackSettings;
387
411
  }
388
412
 
389
413
  export const SETTINGS_FILE = path.join(PLUGIN_DIR, "settings.json");
@@ -417,6 +441,88 @@ export function defaultAuditSettings(): AuditSettings {
417
441
  };
418
442
  }
419
443
 
444
+ /**
445
+ * Приводит бюджетные лимиты к безопасному виду (Экономика v2, E-1.1).
446
+ * Отрицательные и нечисловые значения откатываются к дефолту; 0 = без лимита.
447
+ */
448
+ export function normalizeBudgetSettings(
449
+ value: unknown,
450
+ fallback: BudgetSettings,
451
+ ): BudgetSettings {
452
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
453
+ return { ...fallback };
454
+ }
455
+ const raw = value as Partial<BudgetSettings>;
456
+ return {
457
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
458
+ dailyUsd: normalizeFloatInRange(raw.dailyUsd, fallback.dailyUsd, 0, 1_000_000),
459
+ weeklyUsd: normalizeFloatInRange(raw.weeklyUsd, fallback.weeklyUsd, 0, 1_000_000),
460
+ };
461
+ }
462
+
463
+ /**
464
+ * Деталь 3.8 / UX-3.8.1: рабочий приёмник автора подставлен по умолчанию,
465
+ * чтобы пользователю достаточно было только включить отправку чекбоксом.
466
+ * Отправка всё равно остаётся opt-in (`enabled: false`).
467
+ */
468
+ export const DEFAULT_FEEDBACK_ENDPOINT =
469
+ "https://agent-steward-feedback.agent-steward.workers.dev/report";
470
+
471
+ /** По умолчанию канал автору выключен, логи не прикладываются. */
472
+ export const DEFAULT_FEEDBACK_SETTINGS: FeedbackSettings = {
473
+ enabled: false,
474
+ endpoint: DEFAULT_FEEDBACK_ENDPOINT,
475
+ includeLogs: false,
476
+ contactEmail: "",
477
+ maxPerHour: 6,
478
+ };
479
+
480
+ export function defaultFeedbackSettings(): FeedbackSettings {
481
+ return { ...DEFAULT_FEEDBACK_SETTINGS };
482
+ }
483
+
484
+ /**
485
+ * Валидация настроек обратной связи. Неверный URL не отбрасывает всю секцию —
486
+ * он заменяется пустым (fail-open): отправка деградирует до outbox.
487
+ */
488
+ export function normalizeFeedbackSettings(
489
+ value: unknown,
490
+ fallback: FeedbackSettings,
491
+ ): FeedbackSettings {
492
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
493
+ return { ...fallback };
494
+ }
495
+ const raw = value as Partial<FeedbackSettings>;
496
+ let endpoint = typeof raw.endpoint === "string" ? raw.endpoint.trim() : fallback.endpoint;
497
+ // Апгрейд старых профилей: пустой endpoint из previous-версии заменяем дефолтным.
498
+ if (!endpoint) endpoint = fallback.endpoint;
499
+ if (endpoint) {
500
+ try {
501
+ const url = new URL(endpoint);
502
+ const local = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
503
+ if (
504
+ (url.protocol !== "https:" && !(url.protocol === "http:" && local)) ||
505
+ url.username ||
506
+ url.password ||
507
+ url.hash ||
508
+ endpoint.length > 2048
509
+ ) {
510
+ endpoint = "";
511
+ }
512
+ } catch {
513
+ endpoint = "";
514
+ }
515
+ }
516
+ return {
517
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
518
+ endpoint,
519
+ includeLogs: typeof raw.includeLogs === "boolean" ? raw.includeLogs : fallback.includeLogs,
520
+ contactEmail:
521
+ typeof raw.contactEmail === "string" ? raw.contactEmail.trim().slice(0, 254) : fallback.contactEmail,
522
+ maxPerHour: normalizeIntInRange(raw.maxPerHour, fallback.maxPerHour, 1, 100),
523
+ };
524
+ }
525
+
420
526
  /** Политика прав по умолчанию: гибрид (без shell/question). */
421
527
  export function defaultPermissionsSettings(): PermissionSettings {
422
528
  return { defaultPolicy: DEFAULT_PERMISSION_POLICY };
@@ -1258,6 +1364,8 @@ export async function loadSettings(): Promise<SchedulerSettings> {
1258
1364
  const fallbackIntegrations = defaultIntegrations();
1259
1365
  const fallbackAudit = defaultAuditSettings();
1260
1366
  const fallbackPermissions = defaultPermissionsSettings();
1367
+ const fallbackBudgets = defaultBudgetSettings();
1368
+ const fallbackFeedback = defaultFeedbackSettings();
1261
1369
  try {
1262
1370
  const raw = await fs.readFile(SETTINGS_FILE, "utf8");
1263
1371
  const parsed = JSON.parse(raw) as Partial<SchedulerSettings> | null;
@@ -1286,6 +1394,8 @@ export async function loadSettings(): Promise<SchedulerSettings> {
1286
1394
  parsed?.permissions,
1287
1395
  fallbackPermissions,
1288
1396
  ),
1397
+ budgets: normalizeBudgetSettings(parsed?.budgets, fallbackBudgets),
1398
+ feedback: normalizeFeedbackSettings(parsed?.feedback, fallbackFeedback),
1289
1399
  };
1290
1400
  } catch {
1291
1401
  return {
@@ -1298,6 +1408,8 @@ export async function loadSettings(): Promise<SchedulerSettings> {
1298
1408
  integrations: fallbackIntegrations,
1299
1409
  audit: fallbackAudit,
1300
1410
  permissions: fallbackPermissions,
1411
+ budgets: fallbackBudgets,
1412
+ feedback: fallbackFeedback,
1301
1413
  };
1302
1414
  }
1303
1415
  }
@@ -1344,6 +1456,14 @@ export async function saveSettings(
1344
1456
  patch.permissions !== undefined
1345
1457
  ? normalizePermissionsSettings(patch.permissions, current.permissions)
1346
1458
  : current.permissions,
1459
+ budgets:
1460
+ patch.budgets !== undefined
1461
+ ? normalizeBudgetSettings(patch.budgets, current.budgets)
1462
+ : current.budgets,
1463
+ feedback:
1464
+ patch.feedback !== undefined
1465
+ ? normalizeFeedbackSettings(patch.feedback, current.feedback)
1466
+ : current.feedback,
1347
1467
  };
1348
1468
 
1349
1469
  // Удобство: при включении хуков без явных учётных данных генерируем их,
@@ -241,6 +241,11 @@ export interface TaskDefinition {
241
241
  pipelineName?: string;
242
242
  /** Спринт 32: стабильный id шага внутри pipeline (для diff/apply). */
243
243
  pipelineStepId?: string;
244
+ /**
245
+ * Экономика v2 (E-2): лимит токенов на один запуск задачи.
246
+ * 0/undefined — лимит не задан (fail-open, как и глобальные budgets).
247
+ */
248
+ tokenBudget?: number;
244
249
  }
245
250
 
246
251
  const PREFIX = `\\OpenCode\\${TASK_FOLDER_NAME}\\`;
@@ -417,6 +422,10 @@ export async function buildExportJson(
417
422
  ...(definition?.worktree === true ? { worktree: true } : {}),
418
423
  // W-3: guard-условия переживают перенос между профилями.
419
424
  ...(definition?.guards ? { guards: definition.guards } : {}),
425
+ // QA-P0.1 (E-2.1): лимит токенов переживает экспорт/импорт.
426
+ ...(definition?.tokenBudget !== undefined
427
+ ? { tokenBudget: definition.tokenBudget }
428
+ : {}),
420
429
  ...(Array.isArray(definition?.allowedTools) && definition.allowedTools.length > 0
421
430
  ? { allowedTools: definition.allowedTools }
422
431
  : {}),
@@ -460,6 +469,25 @@ export interface ParsedImport {
460
469
  errors: string[];
461
470
  }
462
471
 
472
+ /**
473
+ * Строковое представление unknown для текстов ошибок импорта (QA-A2.5).
474
+ * Примитивы превращаются в строку так же, как это делал String(); для
475
+ * объектов/функций сохраняется результат стандартной конверсии '[object Object]'.
476
+ */
477
+ function describeImportValue(value: unknown): string {
478
+ if (value === null || value === undefined) return String(value);
479
+ switch (typeof value) {
480
+ case "string":
481
+ case "number":
482
+ case "boolean":
483
+ case "bigint":
484
+ case "symbol":
485
+ return String(value);
486
+ default:
487
+ return "[object Object]";
488
+ }
489
+ }
490
+
463
491
  /**
464
492
  * Разбирает файл импорта. Поддерживает как { tasks: [...] }, так и просто массив.
465
493
  * Ошибки отдельных записей не прерывают импорт остальных.
@@ -468,10 +496,14 @@ export function parseImportJson(raw: string): ParsedImport {
468
496
  let parsed: unknown;
469
497
  try {
470
498
  parsed = JSON.parse(raw);
471
- } catch (err: any) {
472
- throw new Error(
473
- `Файл не является корректным JSON: ${err?.message ?? String(err)}`,
474
- );
499
+ } catch (err: unknown) {
500
+ const detail =
501
+ err instanceof Error
502
+ ? err.message
503
+ : typeof err === "object" && err !== null && "message" in err
504
+ ? describeImportValue(err.message)
505
+ : describeImportValue(err);
506
+ throw new Error(`Файл не является корректным JSON: ${detail}`);
475
507
  }
476
508
 
477
509
  const list = Array.isArray(parsed)
@@ -589,7 +621,7 @@ export function parseImportJson(raw: string): ParsedImport {
589
621
  session = source.session;
590
622
  } else {
591
623
  errors.push(
592
- `Запись ${position}${name ? ` (${name})` : ""}: неизвестный session «${String(source.session)}» (ожидается new, reuse или last).`,
624
+ `Запись ${position}${name ? ` (${name})` : ""}: неизвестный session «${describeImportValue(source.session)}» (ожидается new, reuse или last).`,
593
625
  );
594
626
  return;
595
627
  }
@@ -624,6 +656,25 @@ export function parseImportJson(raw: string): ParsedImport {
624
656
  ? Math.floor(source.timeoutSeconds)
625
657
  : undefined;
626
658
 
659
+ // QA-P0.1 (E-2.1): tokenBudget 0..10M, как в схемах create/update. 0 — без лимита.
660
+ let tokenBudget: number | undefined;
661
+ if (source.tokenBudget !== undefined) {
662
+ const raw = source.tokenBudget;
663
+ if (
664
+ typeof raw === "number" &&
665
+ Number.isFinite(raw) &&
666
+ raw >= 0 &&
667
+ raw <= 10_000_000
668
+ ) {
669
+ tokenBudget = Math.floor(raw);
670
+ } else {
671
+ errors.push(
672
+ `Запись ${position}${name ? ` (${name})` : ""}: tokenBudget должен быть целым числом 0..10000000.`,
673
+ );
674
+ return;
675
+ }
676
+ }
677
+
627
678
  // Новое поле workingDirectory; workdir читаем для обратной совместимости.
628
679
  const workingDirectory =
629
680
  typeof source.workingDirectory === "string" && source.workingDirectory.trim()
@@ -708,7 +759,7 @@ export function parseImportJson(raw: string): ParsedImport {
708
759
  windowPolicy = source.windowPolicy;
709
760
  } else {
710
761
  errors.push(
711
- `Запись ${position}${name ? ` (${name})` : ""}: неизвестный windowPolicy «${String(source.windowPolicy)}» (ожидается skip, postpone или run).`,
762
+ `Запись ${position}${name ? ` (${name})` : ""}: неизвестный windowPolicy «${describeImportValue(source.windowPolicy)}» (ожидается skip, postpone или run).`,
712
763
  );
713
764
  return;
714
765
  }
@@ -965,6 +1016,8 @@ export function parseImportJson(raw: string): ParsedImport {
965
1016
  ...(runWhenLoggedOffFlag ? { runWhenLoggedOff: true } : {}),
966
1017
  ...(worktreeFlag ? { worktree: true } : {}),
967
1018
  ...(guards ? { guards } : {}),
1019
+ // QA-P0.1 (E-2.1): импорт сохраняет tokenBudget.
1020
+ ...(tokenBudget !== undefined ? { tokenBudget } : {}),
968
1021
  ...(mcpEvent ? { mcpEvent } : {}),
969
1022
  ...(allowedTools !== undefined ? { allowedTools } : {}),
970
1023
  ...(deniedTools !== undefined ? { deniedTools } : {}),
package/src/templates.ts CHANGED
@@ -61,7 +61,7 @@ export async function saveTemplate(
61
61
  return saveTemplateRow(template);
62
62
  }
63
63
 
64
- /** Удаляет шаблон по id. */
65
- export async function deleteTemplate(id: string): Promise<void> {
66
- deleteTemplateRow(id);
64
+ /** Удаляет шаблон по id или имени (QA-P3.3). */
65
+ export async function deleteTemplate(idOrName: string): Promise<void> {
66
+ deleteTemplateRow(idOrName);
67
67
  }