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/ROADMAP.md CHANGED
@@ -10,8 +10,8 @@
10
10
  > **В ROADMAP только открытые задачи.** Закрытые задачи и подзадачи удаляются отсюда
11
11
  > и фиксируются в [CHANGELOG.md](./CHANGELOG.md) — больше нигде.
12
12
 
13
- Текущая версия: **agent-steward 0.0.5** (19.11.2026).
14
- В 0.0.5 вошли pipeline-as-code — `opencode.pipeline.yaml`: парсер, валидатор, CLI, 3 инструмента, 51 тест — worktree-изоляция с guard-условиями, аудит-бэклог и защита Quality Gate. Это не задачи 0.1.0.
13
+ Текущая версия: **agent-steward 0.0.6** (20.11.2026).
14
+ В 0.0.6 вошли исправления PL-41..PL-53, QA-CI-5 и REL-01/REL-02 — синхронизация документации, счётчики 30/57/115. Это не задачи 0.1.0.
15
15
  Legacy: `opencode-windows-scheduler@1.5.8`.
16
16
 
17
17
  - Стратегия и позиционирование — [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
@@ -26,17 +26,93 @@ Legacy: `opencode-windows-scheduler@1.5.8`.
26
26
 
27
27
  > Все находки перепроверены по исходникам (чтение кода, grep, подсчёт счётчиков). Приоритеты снижены относительно анализа: ни одна находка не ведёт к потере данных или тихому успеху. Правило канбана не меняется: деталь → задача → подзадача, в работу берётся одна подзадача.
28
28
 
29
- Открытых задач нет.
29
+ ## Деталь 1.3 — Находки QA-аудита (20.11.2026, по TEST-PLAN.md)
30
30
 
31
- ---
31
+ > Полный аудит: `npm run build` / `npm run lint` / `npm test` зелёные, все 16 деталей D01–D16 подтверждены, i18n-паритет 870/870/870. Источник — отчёт `reports/QA_AUDIT.md`, после переноса удалён.
32
+
33
+ **Задача QA-A2 — Полная типизация плагина (эпик)** · P3 · ⬜
34
+
35
+ > Цель: **0 предупреждений** `no-explicit-any` / `no-unsafe-*` в `src/**/*.ts` при 0 ошибок `tsc` и без изменения поведения. На старте 826 предупреждений: ~200 корневых `any` и ~600 каскадных. Оценка — ~1,5–2 недели одному разработчику, знакомому с кодом. Релиз не блокируется: правила в eslint — `warn`, CI уже зелёный.
36
+
37
+ **Правила выполнения (обязательны для агента):**
38
+
39
+ 1. **НЕ применять `eslint --fix`** — проверено: число предупреждений растёт до 7990 из-за каскада новых `no-unsafe-*`. Только ручная правка.
40
+ 2. Сначала устраняется **корневой `any`**, затем перепроверяется файл: каскад `no-unsafe-*` уходит сам. Счётчик смотреть через `npx eslint src/<file>.ts --format json`.
41
+ 3. Стратегия типов: `unknown` + type guard, `z.infer<typeof schema>` из уже объявленных Zod-схем, доменный тип в `src/types.ts` или рядом с модулем. **Запрещено:** `as any`, `@ts-ignore`, новые `eslint-disable` без обоснования. Исключение — границы внешних API (`@opencode/plugin` V1/V2, `node:sqlite`, JSON-пейлоады): disable допустим только с комментарием «почему» и ссылкой на задачу.
42
+ 4. После каждого файла: `npm run build` + `npx eslint <file>` (счётчик строго снижается) + точечный `npm run test:<имя>` затронутой детали. В конце — полный `npm test`.
43
+ 5. **Один файл = один коммит** `type(scope): description` латиницей. Поведение не меняется → CHANGELOG не трогать, отмечать только подзадачи здесь.
44
+ 6. Не редактировать `dist/`, `gui-experimental.cjs`, `legacy/`.
45
+
46
+ **Подзадачи:**
47
+
48
+ - [ ] QA-A2.7 Финальная верификация: `npm run lint` → 0 ошибок и 0 предупреждений, `npm run build`, `npm test` зелёные; снять baseline-гейт, закрыть эпик.
32
49
 
33
50
  # 2. Задачи согласно архитектуре (Execution model)
34
51
 
35
52
  agent-steward — execution engine с опциональной регистрацией триггеров. Четыре входа ведут в один путь исполнения; планировщик ОС — только полоса A (cron/once), а не центральный маршрут. Оркестрация (цепочки, DAG, ретраи, матрицы, эскалации) выполняется ядром и рекордером прямыми запусками обёрток.
36
53
 
37
- > Реализованные части execution model (ядро, полосы A/B, wrapper, recorder, storage, in-process triggers) в ROADMAP не перечисляются — они в [CHANGELOG.md](./CHANGELOG.md). Здесь только открытые архитектурные задачи.
54
+ > Здесь — только открытая архитектурная очередь 0.2.0, структурированная по правилу «деталь → задача → подзадача». Реализованные части execution model перенесены в [CHANGELOG.md](./CHANGELOG.md); описание целевого кровотока — в [docs/EXECUTION-LOOP.md](./docs/EXECUTION-LOOP.md).
55
+
56
+ ## Деталь 2.1 — Durable ledger и provenance
57
+ `src/db/runs-repo.ts`, `src/db/run-journal.ts`, `src/db/schema.ts`, `src/core/execution.ts`
58
+
59
+ > Сверка с кодом: таблицы `runs`/`run_steps` создаются только в ad-hoc пути (`runMission` → `execution.ts` → `createRun`/`finishStep`); зарегистрированные задачи идут через `record-history.ts` без durable-run. Таблицы `gate_outcomes`, полей `prev_hash`/`evidence_path` нет.
60
+
61
+ **Задача ARCH-1 — Durable ledger для всех входов** · P2 · ⬜
62
+
63
+ - [ ] ARCH-1.1 Вызвать `createRun`/`finishStep` из `record-history.ts` для зарегистрированных задач, объединив ad-hoc и registered через общий `RunContext`.
64
+ - [ ] ARCH-1.2 Добавить таблицу `gate_outcomes` (`verdict`, `gate_hash`, `policy_hash`, `prompt_hash`, `attempts_to_pass`, `first_pass`, `executor`, `trigger_kind`) и писать её из прохождения гейта.
65
+ - [ ] ARCH-1.3 Provenance: `evidence_path` и `prev_hash` (tamper-evident аудит); отчёт читает только ledger; тест на подделку цепочки.
66
+
67
+ ## Деталь 2.2 — Класс риска и компиляция политики
68
+ `src/core/permissions.ts`, `src/core/execution.ts`, `src/core/mission.ts`
69
+
70
+ > Сверка с кодом: есть `PermissionPolicy` (`hybrid`/`secure`/`legacy`) и scoped-конфиг прав; класса риска и компилятора политики нет. OPA/Rego/Cedar отклонены в [docs/EXECUTION-LOOP.md](./docs/EXECUTION-LOOP.md) §10 — внешние зависимости не добавлять.
71
+
72
+ **Задача ARCH-2 — Класс риска и компиляция политики** · P2 · ⬜
73
+
74
+ - [ ] ARCH-2.1 Ввести risk class в `MissionSpec`/`RunContext` и классификацию по gate/tool scope.
75
+ - [ ] ARCH-2.2 Компилятор политики: risk class → `PermissionPolicy`, allowed/denied tools и лимиты; тест паритета ad-hoc/registered.
76
+
77
+ ## Деталь 2.3 — Flake-aware вердикт и отложенные эффекты
78
+ `src/core/router/escalation.ts`, `src/core/gate-integrity.ts`, `src/db/capability-repo.ts`, обёртки
38
79
 
39
- Открытых задач нет: полосы A/B и ad-hoc вход (`run_mission`) реализованы.
80
+ > Сверка с кодом: `escalateAfterGate()` есть; вердиктов `flake`/`infra_fail`, повтора гейта на том же артефакте, `effect_intents` и saga-компенсации нет.
81
+
82
+ **Задача ARCH-3 — Flake-aware вердикт гейта** · P2 · ⬜
83
+
84
+ - [ ] ARCH-3.1 Вердикты `pass|fail|flake|infra_fail`, повтор гейта N=2 на том же артефакте, `attempts_to_pass`/`first_pass` в ledger.
85
+ - [ ] ARCH-3.2 `flake`/`infra_fail` не обновляют `capability_map`; карантин стабильно флакующих гейтов и предупреждение пользователю.
86
+
87
+ **Задача ARCH-4 — Отложенные внешние эффекты** · P2 · ⬜
88
+
89
+ - [ ] ARCH-4.1 `effect_intents` пишутся до гейта; применение и `effects_applied_at` — только после `pass`.
90
+ - [ ] ARCH-4.2 Saga-компенсация при частичном применении; тест «irreversible не произошёл до pass».
91
+
92
+ ## Деталь 2.4 — Context compilation
93
+ `src/db/run-context.ts`, `src/core/router/dispatch.ts`
94
+
95
+ > Сверка с кодом: базовый `run-context` есть; repo-map, отбор файлов, примеры gate-passed и пересборка при эскалации не реализованы.
96
+
97
+ **Задача ARCH-5 — Context compilation** · P3 · ⬜
98
+
99
+ - [ ] ARCH-5.1 Repo-map + отбор файлов по типу задачи, дедуп/лимит/scrub секретов и gate-passed примеры.
100
+ - [ ] ARCH-5.2 Пересборка контекста при эскалации (другая модель → другое окно) и тест с бюджетом токенов.
101
+
102
+ ## Деталь 2.5 — Egress-контроль и approvals
103
+ `src/core/permissions.ts`, `src/core/audit.ts`
104
+
105
+ > Сверка с кодом: worktree-изоляция есть; egress-политики и approvals-очереди нет (пересекается с A-1 в §3).
106
+
107
+ **Задача ARCH-6 — Egress-контроль** · P2 · ⬜
108
+
109
+ - [ ] ARCH-6.1 Egress-политика (разрешённые хосты/API) в scoped-конфиге + аудит попыток выхода.
110
+ - [ ] ARCH-6.2 Тест «сеть закрыта → деградация без тихого успеха».
111
+
112
+ **Задача ARCH-7 — Approvals-очередь** · P2 · ⬜
113
+
114
+ - [ ] ARCH-7.1 Очередь ручных одобрений для R2/R3 и аудит решений (связь с A-1).
115
+ - [ ] ARCH-7.2 Вызов очереди в execution loop до `createRun`/применения эффектов.
40
116
 
41
117
  ---
42
118
 
@@ -45,15 +121,6 @@ agent-steward — execution engine с опциональной регистра
45
121
  ## Деталь 3.3 — Экономика v2
46
122
  `src/core/budget*`, `src/analytics*`
47
123
 
48
- **Задача E-1 — Бюджеты день/неделя** · P2 · ⬜
49
- - [ ] E-1.1 Лимиты и учёт
50
- - [ ] E-1.2 Авто-пауза при превышении
51
- - [ ] E-1.3 Алерт
52
-
53
- **Задача E-2 — Per-task token budgets** · P2 · ⬜
54
- - [ ] E-2.1 Лимит на задачу
55
- - [ ] E-2.2 Остановка при превышении
56
-
57
124
  **Задача E-3 — Token efficiency score** · P3 · ⬜
58
125
  - [ ] E-3.1 Метрика и расчёт
59
126
 
@@ -152,8 +219,31 @@ agent-steward — execution engine с опциональной регистра
152
219
  **Задача X-6 — `systemd` в keywords** · P3 · ⏸️
153
220
  - [ ] X-6.1 Убрать, бэкенда нет
154
221
 
155
- > Находки аудита dev-ветки (V-1 … V-4) закрыты и перенесены в [CHANGELOG.md](./CHANGELOG.md)
156
- > (`Unreleased` → Fixed); открытых задач по ним нет.
222
+ ## Деталь 3.8 — Обратная связь от пользователей (bug reports → GitHub Issues)
223
+ `src/core/feedback.ts`, `src/settings.ts`, `src/index.ts`, `infra/feedback-worker/`
224
+
225
+ ### QA-находки, найденные при проверке работоспособности плагина
226
+
227
+ (клавиатурный сдвиг), 507 запусков / 197 ошибок — P2.
228
+ Действие: удалить или переписать промпт задачи через `update_task`.
229
+ Действие: посмотреть `get_task_logs`, починить `beforeScript` или саму задачу.
230
+ `manage_*` поддерживают — P2. Действие: добавить `list` или явно задокументировать
231
+ get-only контракт, чтобы агент не терял вызовы.
232
+ на 12 — P3. Действие: обновить справку и добавить автопроверку в `test-docs`.
233
+ (Free usage limit reached) — P3, окружение, не баг репозитория.
234
+ Действие: при доступном провайдере повторить F-2 через суб-агента и сравнить
235
+ результат с ручной реализацией.
236
+ `get_task_logs` — задача `F38-3_8-event-gate` упала через 754 мс:
237
+ `The process cannot access the file ... logs\\f38-3_8-event-gate.log because
238
+ it is being used by another process` (1/1 ошибка) — P2.
239
+ Действие: открывать файл лога с `FileShare.ReadWrite` и/или ретраить чтение
240
+ при `EBUSY`; сериализовать запуск задачи и чтение лога в планировщике.
241
+ - [ ] UX-3.8.2 Автоматическая отправка отчёта о повторяющейся ошибке — P3,
242
+ не реализовано: сейчас `report_bug` вызывается агентом/пользователем вручную,
243
+ фоновой телеметрии нет. Действие: если понадобится, добавить отдельный
244
+ opt-in-гейт (N одинаковых crash/error в час + тот же antispam + явное
245
+ согласие в UI), не включая его по умолчанию.
246
+ - [ ] PL-54 Промпт задачи с двойными кавычками проходит валидацию, но ломает запуск `opencode run`: `schedule_task` + `schtasks /Run`, ошибка `Cannot process argument because the value of argument "name" is not valid` — P1. Действие: экранировать промпт при передаче в `opencode.ps1` либо отклонять двойные кавычки при создании задачи; добавить проверку в `test-agent-tools.mjs`.
157
247
 
158
248
  ---
159
249
 
package/dist/cli.js CHANGED
@@ -329,6 +329,11 @@ async function main(argv) {
329
329
  return 2;
330
330
  }
331
331
  switch (command) {
332
+ case "--help":
333
+ case "-h":
334
+ case "help":
335
+ console.log(USAGE);
336
+ return 0;
332
337
  case "validate":
333
338
  return runValidate(rest);
334
339
  case "apply":
@@ -24,6 +24,8 @@ export interface AnalyticsRecord {
24
24
  export interface AnalyticsTaskRef {
25
25
  name: string;
26
26
  matrixParentId?: string | null;
27
+ /** Экономика v2 (E-2): лимит токенов на запуск (0/undefined — без лимита). */
28
+ tokenBudget?: number;
27
29
  }
28
30
  export interface DailyBucket {
29
31
  /** YYYY-MM-DD (UTC). */
@@ -49,6 +51,10 @@ export interface TaskAnalyticsRow {
49
51
  /** Задача — клон матрицы (matrixParentId задан). */
50
52
  isMatrixClone: boolean;
51
53
  matrixParentId: string | null;
54
+ /** Экономика v2 (E-2): лимит токенов на запуск (0 — без лимита). */
55
+ tokenBudget?: number;
56
+ /** Сумма токенов за период превысила лимит на задачу. */
57
+ tokenBudgetExceeded?: boolean;
52
58
  }
53
59
  export interface MatrixAnalyticsRow {
54
60
  parentId: string;
@@ -1 +1 @@
1
- {"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"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"}
@@ -62,10 +62,15 @@ export function buildAnalytics(records, options = {}) {
62
62
  const byModel = new Map();
63
63
  const byError = new Map();
64
64
  const cloneParent = new Map();
65
+ const taskTokenBudget = new Map();
65
66
  for (const task of options.tasks ?? []) {
66
67
  const parentId = task.matrixParentId?.trim();
67
68
  if (parentId)
68
69
  cloneParent.set(task.name.toLowerCase(), parentId);
70
+ const budget = Number(task.tokenBudget);
71
+ if (Number.isFinite(budget) && budget > 0) {
72
+ taskTokenBudget.set(task.name.toLowerCase(), budget);
73
+ }
69
74
  }
70
75
  let totalsTotal = 0;
71
76
  let totalsSuccess = 0;
@@ -132,7 +137,11 @@ export function buildAnalytics(records, options = {}) {
132
137
  costUsd: 0,
133
138
  isMatrixClone: cloneParent.has(taskKey),
134
139
  matrixParentId: cloneParent.get(taskKey) ?? null,
140
+ tokenBudget: taskTokenBudget.get(taskKey),
141
+ tokenBudgetExceeded: false,
142
+ maxRunTokens: 0,
135
143
  };
144
+ existing.maxRunTokens = Math.max(existing.maxRunTokens, tokens);
136
145
  existing.total += 1;
137
146
  if (status === "success")
138
147
  existing.success += 1;
@@ -152,8 +161,11 @@ export function buildAnalytics(records, options = {}) {
152
161
  byModel.set(model, modelRow);
153
162
  // Топ ошибок: группируем по тексту, чтобы дайджест показывал частые причины.
154
163
  if (status !== "success" && status !== "partial") {
155
- const message = typeof record.error === "string" && record.error.trim()
156
- ? record.error.trim().slice(0, 160)
164
+ // QA-P1.5: легаси-записи успешных запусков содержат "-" вместо текста
165
+ // ошибки. Такой маркер не является сообщением и не должен попадать в топ.
166
+ const rawError = typeof record.error === "string" ? record.error.trim() : "";
167
+ const message = rawError && rawError !== "-"
168
+ ? rawError.slice(0, 160)
157
169
  : "(без текста)";
158
170
  const errorRow = byError.get(message) ?? {
159
171
  message,
@@ -169,11 +181,16 @@ export function buildAnalytics(records, options = {}) {
169
181
  }
170
182
  }
171
183
  const tasks = [...byTask.values()]
172
- .map((row) => ({
184
+ .map(({ maxRunTokens, ...row }) => ({
173
185
  ...row,
174
186
  successRate: percent(row.success, row.total),
175
187
  avgDurationMs: Math.round(row.avgDurationMs),
176
188
  costUsd: Math.round(row.costUsd * 1e6) / 1e6,
189
+ // E-2: бюджет задаётся на один запуск, поэтому флаг выставляем по
190
+ // максимальному расходу токенов за запуск, а не по сумме за период.
191
+ tokenBudgetExceeded: row.tokenBudget
192
+ ? maxRunTokens > row.tokenBudget
193
+ : false,
177
194
  }))
178
195
  .sort((a, b) => b.total - a.total || a.taskName.localeCompare(b.taskName));
179
196
  const matrices = new Map();
@@ -79,6 +79,12 @@ export declare function recordToolBlocked(input: ToolBlockedInput): number | nul
79
79
  * неограничен. Возвращает число записанных событий.
80
80
  */
81
81
  export declare function recordTaskToolBlocks(task: string, allowedTools: readonly string[] | null | undefined, deniedTools: readonly string[] | null | undefined, actor?: AuditActor, source?: string, policy?: PermissionPolicy, legacyShell?: boolean): number;
82
+ /**
83
+ * QA-P3.1: единообразная проверка ISO-дат для фильтров аудита.
84
+ * Возвращает текст ошибки или null — чтобы все вызывающие (MCP, RPC, HTTP)
85
+ * отвечали одинаково, а не молча отдавали пустую выборку.
86
+ */
87
+ export declare function auditDateFilterError(value: string | null | undefined, name: "since" | "until"): string | null;
82
88
  /** Читает журнал аудита (новые сверху). */
83
89
  export declare function readAuditLog(filter?: ReadAuditFilter): ReadAuditResult;
84
90
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"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"}
@@ -199,8 +199,32 @@ export function recordTaskToolBlocks(task, allowedTools, deniedTools, actor = "s
199
199
  }
200
200
  return written;
201
201
  }
202
+ /**
203
+ * QA-P3.1: единообразная проверка ISO-дат для фильтров аудита.
204
+ * Возвращает текст ошибки или null — чтобы все вызывающие (MCP, RPC, HTTP)
205
+ * отвечали одинаково, а не молча отдавали пустую выборку.
206
+ */
207
+ export function auditDateFilterError(value, name) {
208
+ if (value === null || value === undefined)
209
+ return null;
210
+ const trimmed = String(value).trim();
211
+ if (!trimmed)
212
+ return null;
213
+ if (Number.isNaN(Date.parse(trimmed))) {
214
+ return `Некорректный параметр ${name}: ожидается ISO-дата.`;
215
+ }
216
+ return null;
217
+ }
202
218
  /** Читает журнал аудита (новые сверху). */
203
219
  export function readAuditLog(filter = {}) {
220
+ for (const [name, value] of [
221
+ ["since", filter.since],
222
+ ["until", filter.until],
223
+ ]) {
224
+ const dateError = auditDateFilterError(value, name);
225
+ if (dateError)
226
+ throw new Error(dateError);
227
+ }
204
228
  const limit = Math.max(1, Math.min(5000, Math.floor(filter.limit ?? 200) || 200));
205
229
  const where = [];
206
230
  const params = [];
@@ -0,0 +1,118 @@
1
+ /**
2
+ * Бюджеты день/неделя (Экономика v2, E-1.1).
3
+ *
4
+ * Чистые функции без БД, HTTP и ОС: расход считается из уже загруженной
5
+ * истории запусков, лимиты задаются пользователем в settings.json.
6
+ * Fail-open по умолчанию: выключенная группа или нулевой лимит никогда
7
+ * не блокируют запуски — они только перестают проверяться.
8
+ */
9
+ import { type AnalyticsRecord } from "./analytics.js";
10
+ export type BudgetPeriod = "day" | "week";
11
+ /** Лимиты в USD. 0 означает «без лимита» (fail-open). */
12
+ export interface BudgetSettings {
13
+ /** Включён ли учёт/проверка бюджетов. */
14
+ enabled: boolean;
15
+ /** Лимит на один UTC-день, USD (0 — без лимита). */
16
+ dailyUsd: number;
17
+ /** Лимит на одну UTC-неделю (с понедельника), USD (0 — без лимита). */
18
+ weeklyUsd: number;
19
+ }
20
+ export declare const DEFAULT_BUDGET_SETTINGS: BudgetSettings;
21
+ export declare function defaultBudgetSettings(): BudgetSettings;
22
+ /** Учёт одного периода: потрачено, осталось, достигнут ли лимит. */
23
+ export interface BudgetUsage {
24
+ period: BudgetPeriod;
25
+ /** Начало периода в UTC, ISO-строка. */
26
+ periodStart: string;
27
+ /** Конечный лимит, USD (0 — лимит выключен). */
28
+ limitUsd: number;
29
+ /** Потрачено завершёнными запусками в периоде, USD. */
30
+ spentUsd: number;
31
+ /** Сколько запусков попало в период. */
32
+ runs: number;
33
+ /** Остаток; 0, если лимит выключен или уже исчерпан. */
34
+ remainingUsd: number;
35
+ /** Доля расхода от лимита (0, если лимит выключен). Может быть > 1. */
36
+ ratio: number;
37
+ /** Лимит включён и расход достиг/превысил его. */
38
+ exceeded: boolean;
39
+ /**
40
+ * Проверка не активна: группа выключена глобально или лимит равен нулю.
41
+ * По умолчанию true — fail-open.
42
+ */
43
+ disabled: boolean;
44
+ }
45
+ export interface BudgetReport {
46
+ generatedAt: string;
47
+ enabled: boolean;
48
+ day: BudgetUsage;
49
+ week: BudgetUsage;
50
+ /** Хотя бы один включённый лимит достигнут/превышен. */
51
+ exceeded: boolean;
52
+ }
53
+ /** Начало UTC-дня, в котором находится `now`. */
54
+ export declare function startOfUtcDay(now: Date): Date;
55
+ /** Начало UTC-недели (понедельник 00:00), в которой находится `now`. */
56
+ export declare function startOfUtcWeek(now: Date): Date;
57
+ /**
58
+ * Считает расход за текущий UTC-день и UTC-неделю (с понедельника).
59
+ * Запуск относится к периоду по времени завершения (`finishedAt`, при
60
+ * отсутствии — `startedAt`); даты вне периода и статус `running` игнорируются.
61
+ */
62
+ export declare function buildBudgetReport(records: AnalyticsRecord[], settings?: BudgetSettings, now?: Date): BudgetReport;
63
+ /** Причина решения гейта запуска. */
64
+ export type BudgetGateReason = "disabled" | "within_limit" | "day_exceeded" | "week_exceeded";
65
+ /** Решение: можно ли начинать новый запуск. */
66
+ export interface BudgetGateDecision {
67
+ allowed: boolean;
68
+ reason: BudgetGateReason;
69
+ /** Какой лимит сработал (только при exceeded). */
70
+ period?: BudgetPeriod;
71
+ report: BudgetReport;
72
+ }
73
+ /**
74
+ * E-1.2: авто-пауза при превышении лимита.
75
+ *
76
+ * Fail-open: если группа выключена или оба лимита нулевые, запуски не
77
+ * блокируются. Иначе новый запуск пропускается, как только расход за
78
+ * текущий день/неделю достиг лимита. Дневной лимит проверяется первым.
79
+ */
80
+ export declare function evaluateBudgetGate(records: AnalyticsRecord[], settings?: BudgetSettings, now?: Date): BudgetGateDecision;
81
+ /** Человекочитаемая причина пропуска; пустая строка, если запуск разрешён. */
82
+ export declare function formatBudgetSkipMessage(decision: BudgetGateDecision): string;
83
+ /**
84
+ * E-1.3: текст алерта о превышении бюджета. Пустая строка, если лимит не
85
+ * превышен. Отличается от сообщения о пропуске запуска (E-1.2) тем, что
86
+ * явно сообщает об остановке всех новых запусков.
87
+ */
88
+ export declare function formatBudgetAlertMessage(decision: BudgetGateDecision): string;
89
+ /**
90
+ * E-2.2: гейт токен-бюджета одной задачи (per-task token budget).
91
+ *
92
+ * Лимит задаётся в определении задачи (`tokenBudget`, токены на один запуск).
93
+ * Если какой-либо завершённый прогон задачи в текущем UTC-дне/неделе превысил
94
+ * лимит, новые запуски пропускаются до начала следующего периода — та же
95
+ * логика, что у глобального бюджетного гейта E-1.2, но в разрезе одной задачи.
96
+ * Fail-open: лимит 0/undefined отключает проверку, запуски не блокируются.
97
+ */
98
+ export type TaskTokenBudgetReason = "no_budget" | "within_limit" | "day_exceeded" | "week_exceeded";
99
+ export interface TaskTokenBudgetDecision {
100
+ allowed: boolean;
101
+ reason: TaskTokenBudgetReason;
102
+ taskName: string;
103
+ tokenBudget: number;
104
+ /** Максимум токенов за один прогон в сработавшем периоде. */
105
+ maxRunTokens: number;
106
+ period?: BudgetPeriod;
107
+ }
108
+ /**
109
+ * Решение гейта персонального токен-бюджета задачи.
110
+ *
111
+ * Источник данных — уже загруженная история (`getHistoryForBudget`). Как и в
112
+ * аналитике (QA-B.1), превышение считается по одному прогону, а не по сумме за
113
+ * период; дневное окно проверяется первым (как дневной лимит в E-1.2).
114
+ */
115
+ export declare function evaluateTaskTokenBudgetGate(records: AnalyticsRecord[], taskName: string, tokenBudget: number | undefined, now?: Date): TaskTokenBudgetDecision;
116
+ /** Человекочитаемая причина пропуска; пустая строка, если запуск разрешён. */
117
+ export declare function formatTaskTokenBudgetSkipMessage(decision: TaskTokenBudgetDecision): string;
118
+ //# sourceMappingURL=budget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/core/budget.ts"],"names":[],"mappings":"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"}