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/settings.ts CHANGED
@@ -2,12 +2,13 @@ import crypto from "node:crypto";
2
2
  import fs from "node:fs/promises";
3
3
  import path from "node:path";
4
4
  import { PLUGIN_DIR } from "./types.js";
5
- import { DEFAULT_LOCALE, normalizeLocale, normalizeLocaleMode, SUPPORTED_LOCALES, messageIn, t, type Locale, type LocaleMode } from "./i18n.js";
5
+ import { DEFAULT_LOCALE, DEFAULT_LOCALE_MODE, normalizeLocale, normalizeLocaleMode, SUPPORTED_LOCALES, messageIn, t, type Locale, type LocaleMode } from "./i18n.js";
6
6
  import {
7
7
  DEFAULT_PERMISSION_POLICY,
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.
@@ -362,8 +382,8 @@ export interface SchedulerSettings {
362
382
  /** Максимум одновременно выполняющихся задач. 0 — без ограничения. */
363
383
  maxConcurrent: number;
364
384
  /**
365
- * Язык интерфейса (Спринт 28, режим `auto` — T7): `ru` по умолчанию,
366
- * `en`/`zh` — явный выбор, `auto` — следовать за языком OpenCode.
385
+ * Язык интерфейса (Спринт 28, режим `auto` — T7): `auto` по умолчанию —
386
+ * следовать за языком OpenCode; `ru`/`en`/`zh` — явный выбор пользователя.
367
387
  */
368
388
  locale: LocaleMode;
369
389
  /**
@@ -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;
@@ -1266,7 +1374,7 @@ export async function loadSettings(): Promise<SchedulerSettings> {
1266
1374
  parsed?.maxConcurrent,
1267
1375
  DEFAULT_MAX_CONCURRENT,
1268
1376
  ),
1269
- locale: normalizeLocaleMode(parsed?.locale, DEFAULT_LOCALE),
1377
+ locale: normalizeLocaleMode(parsed?.locale, DEFAULT_LOCALE_MODE),
1270
1378
  uiLocale: normalizeLocale(parsed?.uiLocale, DEFAULT_LOCALE),
1271
1379
  winterMode: normalizeWinterMode(
1272
1380
  parsed?.winterMode,
@@ -1286,11 +1394,13 @@ 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 {
1292
1402
  maxConcurrent: DEFAULT_MAX_CONCURRENT,
1293
- locale: DEFAULT_LOCALE,
1403
+ locale: DEFAULT_LOCALE_MODE,
1294
1404
  uiLocale: DEFAULT_LOCALE,
1295
1405
  winterMode: DEFAULT_WINTER_MODE,
1296
1406
  notifications: fallbackNotifications,
@@ -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
  // Удобство: при включении хуков без явных учётных данных генерируем их,
@@ -6,7 +6,7 @@ import {
6
6
  } from "../task-transfer.js";
7
7
  import type { ScheduledTaskInfo } from "../types.js";
8
8
 
9
- export type JobStatus = "running" | "success" | "error" | "partial" | "idle" | "unknown"
9
+ export type JobStatus = "running" | "success" | "error" | "partial" | "skipped" | "idle" | "unknown"
10
10
 
11
11
  export interface JobView {
12
12
  name: string
@@ -117,6 +117,8 @@ export function statusIcon(status: JobStatus): string {
117
117
  return "✓";
118
118
  case "partial":
119
119
  return "◐";
120
+ case "skipped":
121
+ return "⏭";
120
122
  case "idle":
121
123
  // Задача создана, но ещё ни разу не запускалась.
122
124
  return "○";
@@ -14,6 +14,7 @@ import {
14
14
  validateLaunchWindow,
15
15
  } from "./core/schedule-v2.js";
16
16
  import { isValidSessionId } from "./core/session.js";
17
+ import { normalizeTaskGuards, type TaskGuards } from "./core/guard.js";
17
18
 
18
19
  /** Триггер задачи по событию из MCP-шины. */
19
20
  export interface McpEventTrigger {
@@ -158,6 +159,13 @@ export interface TaskDefinition {
158
159
  * перечислить shell в allowedTools.
159
160
  */
160
161
  legacyShell?: boolean;
162
+ /**
163
+ * W-1: запускать задачу в одноразовом git worktree, созданном от HEAD
164
+ * рабочей директории. По умолчанию выключено. Требует git-репозиторий.
165
+ */
166
+ worktree?: boolean;
167
+ /** W-3: guard-условия перед запуском (semantic-проверки и shell-команда). */
168
+ guards?: TaskGuards;
161
169
  /** Настройки fan-out матрицы (родитель). */
162
170
  matrix?: MatrixConfig;
163
171
  /** Для клона матрицы — имя родительской задачи-шаблона. */
@@ -225,6 +233,19 @@ export interface TaskDefinition {
225
233
  runWhenLoggedOff?: boolean;
226
234
  /** Когда задача была создана — защита от ложного catch-up сразу после создания. */
227
235
  createdAt?: string;
236
+ /**
237
+ * Спринт 32 (Pipeline-as-code): имя pipeline, из которого создан шаг.
238
+ * Хранится в definition_json и позволяет apply отличать «свои» задачи
239
+ * от созданных вручную. Не участвует в запуске.
240
+ */
241
+ pipelineName?: string;
242
+ /** Спринт 32: стабильный id шага внутри pipeline (для diff/apply). */
243
+ pipelineStepId?: string;
244
+ /**
245
+ * Экономика v2 (E-2): лимит токенов на один запуск задачи.
246
+ * 0/undefined — лимит не задан (fail-open, как и глобальные budgets).
247
+ */
248
+ tokenBudget?: number;
228
249
  }
229
250
 
230
251
  const PREFIX = `\\OpenCode\\${TASK_FOLDER_NAME}\\`;
@@ -397,6 +418,14 @@ export async function buildExportJson(
397
418
  ...(definition?.paused === true ? { paused: true } : {}),
398
419
  // Спринт 27.5.10: режим входа переживает перенос между профилями.
399
420
  ...(definition?.runWhenLoggedOff === true ? { runWhenLoggedOff: true } : {}),
421
+ // W-1: изоляция запуска в одноразовом git worktree.
422
+ ...(definition?.worktree === true ? { worktree: true } : {}),
423
+ // W-3: guard-условия переживают перенос между профилями.
424
+ ...(definition?.guards ? { guards: definition.guards } : {}),
425
+ // QA-P0.1 (E-2.1): лимит токенов переживает экспорт/импорт.
426
+ ...(definition?.tokenBudget !== undefined
427
+ ? { tokenBudget: definition.tokenBudget }
428
+ : {}),
400
429
  ...(Array.isArray(definition?.allowedTools) && definition.allowedTools.length > 0
401
430
  ? { allowedTools: definition.allowedTools }
402
431
  : {}),
@@ -440,6 +469,25 @@ export interface ParsedImport {
440
469
  errors: string[];
441
470
  }
442
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
+
443
491
  /**
444
492
  * Разбирает файл импорта. Поддерживает как { tasks: [...] }, так и просто массив.
445
493
  * Ошибки отдельных записей не прерывают импорт остальных.
@@ -448,10 +496,14 @@ export function parseImportJson(raw: string): ParsedImport {
448
496
  let parsed: unknown;
449
497
  try {
450
498
  parsed = JSON.parse(raw);
451
- } catch (err: any) {
452
- throw new Error(
453
- `Файл не является корректным JSON: ${err?.message ?? String(err)}`,
454
- );
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}`);
455
507
  }
456
508
 
457
509
  const list = Array.isArray(parsed)
@@ -569,7 +621,7 @@ export function parseImportJson(raw: string): ParsedImport {
569
621
  session = source.session;
570
622
  } else {
571
623
  errors.push(
572
- `Запись ${position}${name ? ` (${name})` : ""}: неизвестный session «${String(source.session)}» (ожидается new, reuse или last).`,
624
+ `Запись ${position}${name ? ` (${name})` : ""}: неизвестный session «${describeImportValue(source.session)}» (ожидается new, reuse или last).`,
573
625
  );
574
626
  return;
575
627
  }
@@ -604,6 +656,25 @@ export function parseImportJson(raw: string): ParsedImport {
604
656
  ? Math.floor(source.timeoutSeconds)
605
657
  : undefined;
606
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
+
607
678
  // Новое поле workingDirectory; workdir читаем для обратной совместимости.
608
679
  const workingDirectory =
609
680
  typeof source.workingDirectory === "string" && source.workingDirectory.trim()
@@ -688,7 +759,7 @@ export function parseImportJson(raw: string): ParsedImport {
688
759
  windowPolicy = source.windowPolicy;
689
760
  } else {
690
761
  errors.push(
691
- `Запись ${position}${name ? ` (${name})` : ""}: неизвестный windowPolicy «${String(source.windowPolicy)}» (ожидается skip, postpone или run).`,
762
+ `Запись ${position}${name ? ` (${name})` : ""}: неизвестный windowPolicy «${describeImportValue(source.windowPolicy)}» (ожидается skip, postpone или run).`,
692
763
  );
693
764
  return;
694
765
  }
@@ -720,6 +791,15 @@ export function parseImportJson(raw: string): ParsedImport {
720
791
  // Спринт 27.5.10: режим входа. Только явный `true` делает задачу фоновой;
721
792
  // всё остальное (false, null, строка) означает интерактивную задачу.
722
793
  const runWhenLoggedOffFlag = source.runWhenLoggedOff === true;
794
+ // W-1: одноразовый git worktree; только явный `true`.
795
+ const worktreeFlag = source.worktree === true;
796
+ // W-3: guard-условия. Ошибка нормализации попадает в общий список ошибок
797
+ // импорта; валидная конфигурация переносится вместе с задачей.
798
+ const guardsResult = normalizeTaskGuards(source.guards);
799
+ if (!guardsResult.ok) {
800
+ errors.push(`Запись ${position}${name ? ` (${name})` : ""}: ${guardsResult.error}`);
801
+ }
802
+ const guards = guardsResult.ok ? guardsResult.guards : undefined;
723
803
 
724
804
  // Ограничения инструментов (Спринт 14): массив непустых строк без дублей.
725
805
  // Пустой allowedTools отклоняется с явной ошибкой (избегаем «запрещено всё»).
@@ -934,6 +1014,10 @@ export function parseImportJson(raw: string): ParsedImport {
934
1014
  ...(pausedFlag ? { paused: true } : {}),
935
1015
  // Спринт 27.5.10: сохраняем режим входа при переносе задачи.
936
1016
  ...(runWhenLoggedOffFlag ? { runWhenLoggedOff: true } : {}),
1017
+ ...(worktreeFlag ? { worktree: true } : {}),
1018
+ ...(guards ? { guards } : {}),
1019
+ // QA-P0.1 (E-2.1): импорт сохраняет tokenBudget.
1020
+ ...(tokenBudget !== undefined ? { tokenBudget } : {}),
937
1021
  ...(mcpEvent ? { mcpEvent } : {}),
938
1022
  ...(allowedTools !== undefined ? { allowedTools } : {}),
939
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
  }
package/src/types.ts CHANGED
@@ -201,8 +201,8 @@ export type ListJobsArgs = z.infer<typeof ListJobsArgs>;
201
201
  * Результат преобразования cron в флаги schtasks.
202
202
  */
203
203
  export interface CronConversion {
204
- /** Тип расписания schtasks: MINUTE, DAILY или WEEKLY. */
205
- sc: "MINUTE" | "HOURLY" | "DAILY" | "WEEKLY";
204
+ /** Тип расписания schtasks: MINUTE, HOURLY, DAILY, WEEKLY или MONTHLY. */
205
+ sc: "MINUTE" | "HOURLY" | "DAILY" | "WEEKLY" | "MONTHLY";
206
206
  /** Дополнительные флаги командной строки (кроме /sc и /tn /tr /f). */
207
207
  extraFlags: string[];
208
208
  /** Время начала для /st (HH:MM) или undefined. */
@@ -233,3 +233,24 @@ export interface ScheduledTaskInfo {
233
233
  /** true — задача поставлена на паузу (disabled). */
234
234
  paused?: boolean;
235
235
  }
236
+
237
+ /**
238
+ * Строка history.json, приведённая к колонкам БД миграцией (QA-A2.4).
239
+ * Все поля уже проверены type guard'ами в src/db/migrate.ts: строки непустые,
240
+ * числа конечные, а status сужен до значений, которые умеет писать миграция.
241
+ */
242
+ export interface MigrationHistoryRow {
243
+ taskName: string;
244
+ /** skipped/running в legacy JSON не встречаются: миграция пишет только эти четыре. */
245
+ status: "success" | "partial" | "timeout" | "error";
246
+ startedAt: string;
247
+ finishedAt: string | null;
248
+ durationMs: number | null;
249
+ error: string | null;
250
+ tokens: number | null;
251
+ costUsd: number | null;
252
+ model: string | null;
253
+ preFlightStatus: string | null;
254
+ postFlightStatus: string | null;
255
+ nextTask: string | null;
256
+ }
package/src/workspaces.ts CHANGED
@@ -46,6 +46,25 @@ export interface UpdateWorkspacePatch {
46
46
  /** Максимум пар env на workspace — защита от раздувания строки JSON. */
47
47
  export const MAX_WORKSPACE_ENV_PAIRS = 100;
48
48
 
49
+ /**
50
+ * Строковое представление unknown для env и колонок БД (QA-A2.5).
51
+ * Для примитивов совпадает с String(); объекты дают стандартный '[object Object]'
52
+ * (в JSON и в текстовых колонках SQLite таких значений не бывает).
53
+ */
54
+ function safeString(value: unknown): string {
55
+ if (value === null || value === undefined) return String(value);
56
+ switch (typeof value) {
57
+ case "string":
58
+ case "number":
59
+ case "boolean":
60
+ case "bigint":
61
+ case "symbol":
62
+ return String(value);
63
+ default:
64
+ return "[object Object]";
65
+ }
66
+ }
67
+
49
68
  /** Палитра цветных маркеров для GUI/дашборда. */
50
69
  export const WORKSPACE_COLORS = [
51
70
  "#5b8def",
@@ -90,7 +109,7 @@ export function normalizeWorkspaceEnv(
90
109
  if (typeof rawValue === "object") {
91
110
  throw new Error(`Значение env '${key}' должно быть строкой.`);
92
111
  }
93
- result[key] = String(rawValue);
112
+ result[key] = safeString(rawValue);
94
113
  }
95
114
  return result;
96
115
  }
@@ -279,24 +298,24 @@ export function writeWorkspaceEnvFile(
279
298
  return file;
280
299
  }
281
300
 
282
- function rowToWorkspace(row: any): Workspace {
301
+ function rowToWorkspace(row: Record<string, unknown>): Workspace {
283
302
  let env: Record<string, string> | undefined;
284
303
  if (row.env_json) {
285
304
  try {
286
- env = normalizeWorkspaceEnv(JSON.parse(String(row.env_json)));
305
+ env = normalizeWorkspaceEnv(JSON.parse(safeString(row.env_json)));
287
306
  } catch {
288
307
  env = undefined;
289
308
  }
290
309
  }
291
310
  return {
292
- id: String(row.id),
293
- name: String(row.name),
294
- path: String(row.path),
295
- gitRemote: row.git_remote == null ? undefined : String(row.git_remote),
296
- color: row.color == null ? undefined : String(row.color),
311
+ id: safeString(row.id),
312
+ name: safeString(row.name),
313
+ path: safeString(row.path),
314
+ gitRemote: row.git_remote == null ? undefined : safeString(row.git_remote),
315
+ color: row.color == null ? undefined : safeString(row.color),
297
316
  env,
298
- envFile: row.env_file == null ? undefined : String(row.env_file),
299
- createdAt: String(row.created_at),
317
+ envFile: row.env_file == null ? undefined : safeString(row.env_file),
318
+ createdAt: safeString(row.created_at),
300
319
  };
301
320
  }
302
321
 
@@ -371,14 +390,16 @@ export function readGitBranch(workspacePath: string): string | undefined {
371
390
  export function listWorkspaces(): Workspace[] {
372
391
  const rows = getDb()
373
392
  .prepare("SELECT * FROM workspaces ORDER BY name COLLATE NOCASE ASC")
374
- .all();
393
+ .all() as Record<string, unknown>[];
375
394
  return rows.map(rowToWorkspace);
376
395
  }
377
396
 
378
397
  /** Workspace по id. */
379
398
  export function getWorkspace(id: string): Workspace | undefined {
380
399
  if (!id) return undefined;
381
- const row = getDb().prepare("SELECT * FROM workspaces WHERE id = ?").get(id);
400
+ const row = getDb()
401
+ .prepare("SELECT * FROM workspaces WHERE id = ?")
402
+ .get(id) as Record<string, unknown> | undefined;
382
403
  return row ? rowToWorkspace(row) : undefined;
383
404
  }
384
405
 
@@ -387,7 +408,7 @@ export function getWorkspaceByPath(workspacePath: string): Workspace | undefined
387
408
  const normalized = normalizePath(workspacePath);
388
409
  const row = getDb()
389
410
  .prepare("SELECT * FROM workspaces WHERE lower(path) = lower(?) LIMIT 1")
390
- .get(normalized);
411
+ .get(normalized) as Record<string, unknown> | undefined;
391
412
  return row ? rowToWorkspace(row) : undefined;
392
413
  }
393
414
 
@@ -531,6 +552,8 @@ export function deleteWorkspace(id: string): boolean {
531
552
 
532
553
  /** Количество workspace (для сводок и тестов). */
533
554
  export function countWorkspaces(): number {
534
- const row = getDb().prepare("SELECT COUNT(*) AS count FROM workspaces").get();
555
+ const row = getDb()
556
+ .prepare("SELECT COUNT(*) AS count FROM workspaces")
557
+ .get() as Record<string, unknown> | undefined;
535
558
  return Number(row?.count) || 0;
536
559
  }