agent-steward 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (287) hide show
  1. package/CHANGELOG.md +154 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +54 -9
  4. package/ROADMAP-STRATEGY.md +23 -20
  5. package/ROADMAP.md +140 -143
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +351 -0
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +18 -1
  14. package/dist/core/execution.d.ts +203 -0
  15. package/dist/core/execution.d.ts.map +1 -0
  16. package/dist/core/execution.js +309 -0
  17. package/dist/core/gate-integrity.d.ts +35 -0
  18. package/dist/core/gate-integrity.d.ts.map +1 -0
  19. package/dist/core/gate-integrity.js +132 -0
  20. package/dist/core/git-trigger.d.ts.map +1 -1
  21. package/dist/core/git-trigger.js +14 -2
  22. package/dist/core/guard-run.d.ts +4 -0
  23. package/dist/core/guard-run.d.ts.map +1 -0
  24. package/dist/core/guard-run.js +101 -0
  25. package/dist/core/guard.d.ts +52 -0
  26. package/dist/core/guard.d.ts.map +1 -0
  27. package/dist/core/guard.js +362 -0
  28. package/dist/core/lock.d.ts +61 -4
  29. package/dist/core/lock.d.ts.map +1 -1
  30. package/dist/core/lock.js +213 -26
  31. package/dist/core/matrix.d.ts.map +1 -1
  32. package/dist/core/matrix.js +75 -15
  33. package/dist/core/mission.d.ts +83 -0
  34. package/dist/core/mission.d.ts.map +1 -0
  35. package/dist/core/mission.js +334 -0
  36. package/dist/core/one-shot.d.ts +5 -1
  37. package/dist/core/one-shot.d.ts.map +1 -1
  38. package/dist/core/one-shot.js +33 -8
  39. package/dist/core/opencode-cli.d.ts +28 -0
  40. package/dist/core/opencode-cli.d.ts.map +1 -0
  41. package/dist/core/opencode-cli.js +74 -0
  42. package/dist/core/opencode-models.d.ts +62 -0
  43. package/dist/core/opencode-models.d.ts.map +1 -0
  44. package/dist/core/opencode-models.js +277 -0
  45. package/dist/core/pipeline-apply.d.ts +38 -0
  46. package/dist/core/pipeline-apply.d.ts.map +1 -0
  47. package/dist/core/pipeline-apply.js +117 -0
  48. package/dist/core/pipeline-io.d.ts +13 -0
  49. package/dist/core/pipeline-io.d.ts.map +1 -0
  50. package/dist/core/pipeline-io.js +64 -0
  51. package/dist/core/pipeline-map.d.ts +46 -0
  52. package/dist/core/pipeline-map.d.ts.map +1 -0
  53. package/dist/core/pipeline-map.js +196 -0
  54. package/dist/core/pipeline-spec.d.ts +109 -0
  55. package/dist/core/pipeline-spec.d.ts.map +1 -0
  56. package/dist/core/pipeline-spec.js +554 -0
  57. package/dist/core/ps-wrapper.d.ts +19 -2
  58. package/dist/core/ps-wrapper.d.ts.map +1 -1
  59. package/dist/core/ps-wrapper.js +261 -63
  60. package/dist/core/record-history.d.ts +15 -0
  61. package/dist/core/record-history.d.ts.map +1 -1
  62. package/dist/core/record-history.js +183 -58
  63. package/dist/core/router/dispatch.d.ts +36 -0
  64. package/dist/core/router/dispatch.d.ts.map +1 -0
  65. package/dist/core/router/dispatch.js +59 -0
  66. package/dist/core/router/escalation.d.ts +47 -0
  67. package/dist/core/router/escalation.d.ts.map +1 -0
  68. package/dist/core/router/escalation.js +87 -0
  69. package/dist/core/router/planner.d.ts +53 -0
  70. package/dist/core/router/planner.d.ts.map +1 -0
  71. package/dist/core/router/planner.js +113 -0
  72. package/dist/core/router/rules.d.ts +46 -0
  73. package/dist/core/router/rules.d.ts.map +1 -0
  74. package/dist/core/router/rules.js +91 -0
  75. package/dist/core/run-panel-api.d.ts +94 -0
  76. package/dist/core/run-panel-api.d.ts.map +1 -0
  77. package/dist/core/run-panel-api.js +169 -0
  78. package/dist/core/schedule-gate.js +5 -1
  79. package/dist/core/schedule-v2.d.ts +34 -0
  80. package/dist/core/schedule-v2.d.ts.map +1 -1
  81. package/dist/core/schedule-v2.js +91 -5
  82. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  83. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  84. package/dist/core/scheduler/at-fallback.js +135 -5
  85. package/dist/core/scheduler/linux.d.ts +18 -2
  86. package/dist/core/scheduler/linux.d.ts.map +1 -1
  87. package/dist/core/scheduler/linux.js +63 -20
  88. package/dist/core/scheduler/mac.d.ts +44 -2
  89. package/dist/core/scheduler/mac.d.ts.map +1 -1
  90. package/dist/core/scheduler/mac.js +126 -15
  91. package/dist/core/scheduler/posix.d.ts.map +1 -1
  92. package/dist/core/scheduler/posix.js +25 -1
  93. package/dist/core/scheduler/registry.d.ts +11 -0
  94. package/dist/core/scheduler/registry.d.ts.map +1 -1
  95. package/dist/core/scheduler/registry.js +83 -21
  96. package/dist/core/scheduler/run-now.d.ts +16 -0
  97. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  98. package/dist/core/scheduler/run-now.js +28 -0
  99. package/dist/core/scheduler/windows.d.ts.map +1 -1
  100. package/dist/core/scheduler/windows.js +15 -12
  101. package/dist/core/secrets.d.ts.map +1 -1
  102. package/dist/core/secrets.js +125 -28
  103. package/dist/core/session.d.ts.map +1 -1
  104. package/dist/core/session.js +18 -11
  105. package/dist/core/structured-log.d.ts +7 -1
  106. package/dist/core/structured-log.d.ts.map +1 -1
  107. package/dist/core/task-name.d.ts +24 -0
  108. package/dist/core/task-name.d.ts.map +1 -0
  109. package/dist/core/task-name.js +40 -0
  110. package/dist/core/worktree-run.d.ts +4 -0
  111. package/dist/core/worktree-run.d.ts.map +1 -0
  112. package/dist/core/worktree-run.js +164 -0
  113. package/dist/core/worktree.d.ts +115 -0
  114. package/dist/core/worktree.d.ts.map +1 -0
  115. package/dist/core/worktree.js +462 -0
  116. package/dist/core/wrappers/bash.d.ts +17 -0
  117. package/dist/core/wrappers/bash.d.ts.map +1 -1
  118. package/dist/core/wrappers/bash.js +224 -28
  119. package/dist/db/capability-repo.d.ts +124 -0
  120. package/dist/db/capability-repo.d.ts.map +1 -0
  121. package/dist/db/capability-repo.js +267 -0
  122. package/dist/db/history-repo.d.ts +46 -5
  123. package/dist/db/history-repo.d.ts.map +1 -1
  124. package/dist/db/history-repo.js +107 -25
  125. package/dist/db/index.d.ts +4 -0
  126. package/dist/db/index.d.ts.map +1 -1
  127. package/dist/db/index.js +39 -1
  128. package/dist/db/metrics-repo.js +2 -2
  129. package/dist/db/migrate.d.ts.map +1 -1
  130. package/dist/db/migrate.js +3 -1
  131. package/dist/db/recovery.d.ts.map +1 -1
  132. package/dist/db/recovery.js +5 -4
  133. package/dist/db/run-context.d.ts +103 -0
  134. package/dist/db/run-context.d.ts.map +1 -0
  135. package/dist/db/run-context.js +224 -0
  136. package/dist/db/run-dlq.d.ts +100 -0
  137. package/dist/db/run-dlq.d.ts.map +1 -0
  138. package/dist/db/run-dlq.js +191 -0
  139. package/dist/db/run-journal.d.ts +33 -5
  140. package/dist/db/run-journal.d.ts.map +1 -1
  141. package/dist/db/run-journal.js +78 -14
  142. package/dist/db/run-resume.d.ts +10 -2
  143. package/dist/db/run-resume.d.ts.map +1 -1
  144. package/dist/db/run-resume.js +39 -13
  145. package/dist/db/runs-repo.d.ts +32 -7
  146. package/dist/db/runs-repo.d.ts.map +1 -1
  147. package/dist/db/runs-repo.js +50 -11
  148. package/dist/db/schema.d.ts +2 -2
  149. package/dist/db/schema.d.ts.map +1 -1
  150. package/dist/db/schema.js +216 -3
  151. package/dist/db/settings-repo.d.ts +11 -0
  152. package/dist/db/settings-repo.d.ts.map +1 -1
  153. package/dist/db/settings-repo.js +25 -0
  154. package/dist/db/step-idempotency.d.ts +51 -0
  155. package/dist/db/step-idempotency.d.ts.map +1 -0
  156. package/dist/db/step-idempotency.js +136 -0
  157. package/dist/history.d.ts +1 -1
  158. package/dist/history.d.ts.map +1 -1
  159. package/dist/i18n.d.ts +5 -0
  160. package/dist/i18n.d.ts.map +1 -1
  161. package/dist/i18n.js +11 -4
  162. package/dist/index.d.ts +140 -6
  163. package/dist/index.d.ts.map +1 -1
  164. package/dist/index.js +480 -18
  165. package/dist/notifications.d.ts +22 -0
  166. package/dist/notifications.d.ts.map +1 -1
  167. package/dist/notifications.js +36 -8
  168. package/dist/profiles.d.ts.map +1 -1
  169. package/dist/profiles.js +25 -4
  170. package/dist/rpc.d.ts +924 -0
  171. package/dist/rpc.d.ts.map +1 -1
  172. package/dist/rpc.js +352 -0
  173. package/dist/server.d.ts +46 -0
  174. package/dist/server.d.ts.map +1 -1
  175. package/dist/server.js +172 -53
  176. package/dist/settings.d.ts +2 -2
  177. package/dist/settings.d.ts.map +1 -1
  178. package/dist/settings.js +3 -3
  179. package/dist/shared/jobs-view.d.ts +1 -1
  180. package/dist/shared/jobs-view.d.ts.map +1 -1
  181. package/dist/shared/jobs-view.js +2 -0
  182. package/dist/task-transfer.d.ts +16 -0
  183. package/dist/task-transfer.d.ts.map +1 -1
  184. package/dist/task-transfer.js +16 -0
  185. package/dist/types.d.ts.map +1 -1
  186. package/dist/types.js +7 -0
  187. package/dist/workspaces.d.ts +25 -3
  188. package/dist/workspaces.d.ts.map +1 -1
  189. package/dist/workspaces.js +43 -8
  190. package/docs/ARCHITECTURE.md +498 -58
  191. package/docs/COMPATIBILITY.md +2 -2
  192. package/docs/CONCEPT.md +185 -91
  193. package/docs/CROSS_PLATFORM.ru.md +20 -0
  194. package/docs/CROSS_PLATFORM.zh.md +18 -0
  195. package/docs/EXECUTION-LOOP.md +211 -0
  196. package/docs/FEATURES.md +65 -4
  197. package/docs/FEATURES.zh.md +52 -4
  198. package/docs/MIGRATION.md +2 -2
  199. package/docs/PIPELINE.md +293 -0
  200. package/docs/README.ru.md +44 -5
  201. package/docs/README.zh.md +46 -6
  202. package/docs/SAFETY.md +142 -0
  203. package/docs/SAVINGS.md +29 -0
  204. package/docs/SAVINGS.ru.md +29 -0
  205. package/docs/SAVINGS.zh.md +18 -0
  206. package/gui-experimental.cjs +9 -8
  207. package/locales/en.json +84 -1
  208. package/locales/ru.json +84 -1
  209. package/locales/zh.json +84 -1
  210. package/opencode.pipeline.yaml +35 -0
  211. package/package.json +46 -2
  212. package/scripts/audit-bundle.mjs +215 -0
  213. package/scripts/test-home.mjs +83 -0
  214. package/src/cli.ts +412 -0
  215. package/src/core/dlq-api.ts +98 -0
  216. package/src/core/dry-run.ts +27 -3
  217. package/src/core/execution.ts +538 -0
  218. package/src/core/file-watcher.ts +2 -2
  219. package/src/core/gate-integrity.ts +160 -0
  220. package/src/core/git-trigger.ts +18 -5
  221. package/src/core/guard-run.ts +119 -0
  222. package/src/core/guard.ts +431 -0
  223. package/src/core/lock.ts +244 -30
  224. package/src/core/matrix.ts +95 -50
  225. package/src/core/mission.ts +485 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/one-shot.ts +36 -8
  228. package/src/core/opencode-cli.ts +103 -0
  229. package/src/core/opencode-models.ts +315 -0
  230. package/src/core/pipeline-apply.ts +158 -0
  231. package/src/core/pipeline-io.ts +79 -0
  232. package/src/core/pipeline-map.ts +264 -0
  233. package/src/core/pipeline-spec.ts +775 -0
  234. package/src/core/ps-wrapper.ts +274 -64
  235. package/src/core/record-history.ts +229 -104
  236. package/src/core/router/dispatch.ts +94 -0
  237. package/src/core/router/escalation.ts +129 -0
  238. package/src/core/router/planner.ts +166 -0
  239. package/src/core/router/rules.ts +115 -0
  240. package/src/core/run-panel-api.ts +262 -0
  241. package/src/core/schedule-gate.ts +7 -3
  242. package/src/core/schedule-v2.ts +114 -5
  243. package/src/core/scheduler/at-fallback.ts +190 -5
  244. package/src/core/scheduler/linux.ts +72 -21
  245. package/src/core/scheduler/logs.ts +2 -2
  246. package/src/core/scheduler/mac.ts +174 -14
  247. package/src/core/scheduler/posix.ts +20 -1
  248. package/src/core/scheduler/registry.ts +107 -26
  249. package/src/core/scheduler/run-now.ts +32 -0
  250. package/src/core/scheduler/windows.ts +19 -15
  251. package/src/core/secrets.ts +131 -31
  252. package/src/core/session.ts +23 -10
  253. package/src/core/structured-log.ts +22 -5
  254. package/src/core/task-name.ts +67 -0
  255. package/src/core/telegram.ts +2 -2
  256. package/src/core/triage-worker.ts +7 -7
  257. package/src/core/triage.ts +2 -2
  258. package/src/core/worktree-run.ts +199 -0
  259. package/src/core/worktree.ts +600 -0
  260. package/src/core/wrappers/bash.ts +239 -27
  261. package/src/db/capability-repo.ts +402 -0
  262. package/src/db/history-repo.ts +151 -22
  263. package/src/db/index.ts +37 -1
  264. package/src/db/metrics-repo.ts +2 -2
  265. package/src/db/migrate.ts +3 -1
  266. package/src/db/recovery.ts +5 -4
  267. package/src/db/run-context.ts +370 -0
  268. package/src/db/run-dlq.ts +310 -0
  269. package/src/db/run-journal.ts +100 -13
  270. package/src/db/run-resume.ts +65 -13
  271. package/src/db/runs-repo.ts +66 -13
  272. package/src/db/schema.ts +218 -3
  273. package/src/db/settings-repo.ts +31 -0
  274. package/src/db/step-idempotency.ts +185 -0
  275. package/src/gui.tsx +692 -13
  276. package/src/history.ts +1 -1
  277. package/src/i18n.ts +12 -4
  278. package/src/index.ts +648 -8
  279. package/src/notifications.ts +38 -8
  280. package/src/profiles.ts +26 -4
  281. package/src/rpc.ts +379 -0
  282. package/src/server.ts +206 -54
  283. package/src/settings.ts +5 -5
  284. package/src/shared/jobs-view.ts +3 -1
  285. package/src/task-transfer.ts +31 -0
  286. package/src/types.ts +9 -0
  287. package/src/workspaces.ts +58 -9
package/ROADMAP.md CHANGED
@@ -1,184 +1,181 @@
1
1
  # 🗺️ Roadmap — agent-steward
2
2
 
3
3
  > North Star: [docs/CONCEPT.md](./docs/CONCEPT.md) — верифицируемая локально-первая оркестрация агент-задач.
4
- > Это не «планировщик». Сcheduler/уведомления/аналитика — триггеры и обвязка, не ядро (§8 CONCEPT).
5
-
6
- Текущая версия: **agent-steward 0.0.2** (milestone Д7, 17.11.2026). Пакет переименован с `opencode-windows-scheduler`, опубликован в npm, CI зелёный на Windows / macOS / Linux.
4
+ > Это не «планировщик». Планировщик/уведомления/аналитика — триггеры и обвязка, не ядро (§8 CONCEPT).
5
+ >
6
+ > Модель работы — канбан. Каждая задача разложена слоями:
7
+ > **Деталь** (подсистема/файлы) → **Задача** (что чиним/делаем) → **Подзадача** (атомарный шаг).
8
+ > В работу берётся ровно одна подзадача: подзадача → отчёт → следующая подзадача.
9
+ >
10
+ > **В ROADMAP только открытые задачи.** Закрытые задачи и подзадачи удаляются отсюда
11
+ > и фиксируются в [CHANGELOG.md](./CHANGELOG.md) — больше нигде.
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.
15
+ Legacy: `opencode-windows-scheduler@1.5.8`.
7
16
 
8
17
  - Стратегия и позиционирование — [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
9
- - Что уже выпущено — [CHANGELOG.md](./CHANGELOG.md).
18
+ - Что уже сделано — [CHANGELOG.md](./CHANGELOG.md).
10
19
  - Устройство и возможности — [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md), [docs/FEATURES.md](./docs/FEATURES.md).
11
20
 
21
+ Обозначения: ⬜ не начато · 🔄 в работе · ⏸️ внешнее действие.
22
+
12
23
  ---
13
24
 
14
- ## 1. Начальная точка (milestone Д7 — agent-steward 0.0.2)
25
+ # 1. Бэклог
26
+
27
+ > Все находки перепроверены по исходникам (чтение кода, grep, подсчёт счётчиков). Приоритеты снижены относительно анализа: ни одна находка не ведёт к потере данных или тихому успеху. Правило канбана не меняется: деталь → задача → подзадача, в работу берётся одна подзадача.
28
+
29
+ Открытых задач нет.
15
30
 
16
- ### Что сделано
31
+ ---
17
32
 
18
- - Пакет переименован: `opencode-windows-scheduler` → `agent-steward` (релиз 0.0.2), старый пакет остаётся как thin re-export (`legacy/`) на один major.
19
- - `plugin id` не меняется: `opencode-windows-scheduler` — имена SQLite и логов, формат `runs.jsonl`, маркер дашборда и ID действий TUI без изменений; каталог данных переименован в `agent-steward` с автоматической миграцией legacy-данных.
20
- - Dual-support: один пакет работает с OpenCode V1 (≥ 1.18.29) и V2 (≥ 2.2.7) — общий ядро `createRuntime`, 26 инструментов.
21
- - GitHub-репозиторий: `DeadSno/agent-steward` с редиректами со старых URL.
33
+ # 2. Задачи согласно архитектуре (Execution model)
22
34
 
23
- ### Что в приоритете прямо сейчас
35
+ agent-steward — execution engine с опциональной регистрацией триггеров. Четыре входа ведут в один путь исполнения; планировщик ОС — только полоса A (cron/once), а не центральный маршрут. Оркестрация (цепочки, DAG, ретраи, матрицы, эскалации) выполняется ядром и рекордером прямыми запусками обёрток.
24
36
 
25
- Точка на 17.11.2026: **спринты 28–31 закрыты и выпущены** (1.5.1–1.5.6), **спринт 36 начат**. Подзадачи **36.1.a** и **36.1.b** выполнены: схема `runs`/`run_steps` (SCHEMA_VERSION 3, колонка `position`), журнал переходов с восстановлением после `kill -9`, resume с середины (`run-resume.ts`) и тесты `test-run-state.mjs`, `test-run-journal.mjs`, `test-run-resume.mjs`. Следующая подзадача в работу: **36.3** (идемпотентные ключи шагов).
37
+ > Реализованные части execution model (ядро, полосы A/B, wrapper, recorder, storage, in-process triggers) в ROADMAP не перечисляются — они в [CHANGELOG.md](./CHANGELOG.md). Здесь только открытые архитектурные задачи.
26
38
 
27
- | Приоритет | Что | Почему |
28
- |-----------|-----|--------|
29
- | P1 | Durable DAG (спринт 36, задача 36.1) | Персистентная state-машина — фундамент resume, идемпотентности и DLQ; без неё 0.1.0 не выпустить |
30
- | P1 | Роутер, слои 1–2 (спринт 36.5.X) | 0 токенов на горячем пути, learning-loop из исходов гейта |
31
- | P2 | Pipeline-as-code (спринт 32) | `opencode.pipeline.yaml` — водораздел планировщик → оркестратор |
32
- | P2 | Worktree-изоляция (33), экономика v2 (34) | Идут после P1-ядра; номера версий — по факту релиза |
39
+ Открытых задач нет: полосы A/B и ad-hoc вход (`run_mission`) реализованы.
33
40
 
34
41
  ---
35
42
 
36
- ## 2. Четыре столпа (north star, CONCEPT §4)
43
+ # 3. Остальные задачи (не бэклог и не архитектура)
37
44
 
38
- Любая фича / ADR сверяется с ними. При конфликте порядок: **надёжно > приватно > дёшево > краткосрочные фичи**.
45
+ ## Деталь 3.3 — Экономика v2
46
+ `src/core/budget*`, `src/analytics*`
39
47
 
40
- | Столп | Что значит | Метрика |
41
- |-------|-----------|---------|
42
- | **Дёшево** | Локаль закрывает максимум gate-able задач | net-экономия $ (контрфактика), local share %, escalation rate, time overhead |
43
- | **Приватно** | Control plane, данные, аудит, triage — локальны | % инференса/данных локально; cloud-egress только explicit и залогирован |
44
- | **Надёжно** | Ноль тихих отказов / двойных прогонов / fake-done / порчи репо | trust-инциденты = 0; гейт независим от self-report; полнота аудита |
45
- | **Компаундится** | Success rate и экономия растут под пользователя | Тренд local success_rate ↑, eval-lift адаптеров, рост scaffolding-библиотеки |
48
+ **Задача E-1 — Бюджеты день/неделя** · P2 · ⬜
49
+ - [ ] E-1.1 Лимиты и учёт
50
+ - [ ] E-1.2 Авто-пауза при превышении
51
+ - [ ] E-1.3 Алерт
46
52
 
47
- ---
53
+ **Задача E-2 — Per-task token budgets** · P2 · ⬜
54
+ - [ ] E-2.1 Лимит на задачу
55
+ - [ ] E-2.2 Остановка при превышении
48
56
 
49
- ## 3. Исполнительный цикл (CONCEPT §6)
50
-
51
- ```
52
- 1. Принять миссию + критерий приёмки (гейт)
53
- ↓
54
- 2. Декомпозиция на шаги / роли
55
- ↓
56
- 3. Выбрать исполнителя (локаль first по capability-карте)
57
- ↓
58
- 4. Выполнить шаг (OpenCode-агент)
59
- ↓
60
- 5. GATE — объективная верификация (tests / lint / schema / diff / cmd)
61
- ├─ pass → ledger: économie + пример + training-record
62
- └─ fail → эскалация / ретрай / откат
63
- ↓
64
- 6. Артефакт миссии (diff / PR / отчёт / аудит-трейл)
65
- ↓
66
- 7. Отчёт:'économie, success rate, эскалации, overhead
67
- ↓
68
- 8. Обновить роутинг / capability-карту → eval → LoRA (staged)
69
- ```
70
-
71
- GATE — keystone (§5 CONCEPT): никогда «готово» на слово агента. Провал → эскалация / ретрай / откат.
57
+ **Задача E-3 — Token efficiency score** · P3 · ⬜
58
+ - [ ] E-3.1 Метрика и расчёт
72
59
 
73
- ---
60
+ **Задача E-4 — Прогноз и Grafana JSON** · P3 · ⬜
61
+ - [ ] E-4.1 Прогноз затрат
62
+ - [ ] E-4.2 Экспорт в Grafana
74
63
 
75
- ## 4. Карта спринтов
76
-
77
- | Спринт | Тема | Приоритет | Статус | Версия |
78
- |--------|------|-----------|--------|--------|
79
- | 27.5 | Hotfix после приёмки 1.5.0 | P1 | ✅ завершён | 1.5.1 |
80
- | 28 | i18n-фундамент | P1 | ✅ завершён | 1.5.1 (+ zh/auto в 1.5.6) |
81
- | 29 | Security slice A | P1 | ✅ завершён | 1.5.2 |
82
- | 30 | Local assistant v1 (триаж + shadow) | P1 | ✅ завершён | 1.5.3 |
83
- | 31 | Local assistant v2 (дедуп, эмбеддинги, саммари, wizard, экономия) | P2 | ✅ завершён (31.1–31.13) | 1.5.5–1.5.6 |
84
- | 31.A | Спайк маршрутизации local/cloud | P3 | ⬜ бэклог | — |
85
- | 32 | Pipeline-as-code (`opencode.pipeline.yaml`) | P2 | ⬜ запланирован | 0.0.4 |
86
- | 33 | Worktree-изоляция + guard-условия | P2 | ⬜ запланирован | 0.0.5 |
87
- | 34 | Экономика v2 (бюджеты, token efficiency, прогноз) | P2 | ⬜ запланирован | 0.0.6 |
88
- | 35 | Docker runner (opt-in) | P3 | ⬜ запланирован | 0.0.7 |
89
- | 36 | Durable DAG (resume, идемпотентность, DLQ) + роутер | P1 (для 0.1.0) | 🔄 активен (спека готова, код не начат) | 0.0.3 |
90
- | 37 | Rename-only + daemon + config v2 | P2 | ✅ завершён (Д7) | 0.0.2 |
91
- | 38 | Approvals, окружения, артефакты, docs-сайт | MAJOR | ⬜ запланирован | 0.1.0 |
92
- | 39 | Запуск и сообщество | — | ⬜ запланирован | 0.1.x |
93
-
94
- **Версии:** rename-релиз Д7 дал `agent-steward@0.0.2`. **Версия присваивается по факту релиза, а не заранее.** Следующий релиз — спринт 36 (`0.0.3`); 32–35 сдвигаются на `0.0.4`–`0.0.7` в порядке фактического выпуска. Переход на `0.1.0` — при спринте 38 (Approvals).
64
+ **Задача E-5 — Local vs cloud** · P3 · ⬜
65
+ - [ ] E-5.1 Разбивка запусков и стоимости
95
66
 
96
- ---
67
+ ## Деталь 3.4 — Docker runner
68
+ `src/core/runner*`
97
69
 
98
- ### Ревизия роадмапа — 17.11.2026
70
+ **Задача D-1 — Runner local/docker/ssh** · P3 · ⬜
71
+ - [ ] D-1.1 Интерфейс runner
72
+ - [ ] D-1.2 Docker
73
+ - [ ] D-1.3 SSH
99
74
 
100
- Сверка роадмапа с фактическим состоянием репозитория (`CHANGELOG.md` 1.5.1–1.5.6, `locales/`, `src/core/permissions.ts`, git-log):
75
+ **Задача D-2 — Opt-in и обратная совместимость** · P3 · ⬜
76
+ - [ ] D-2.1 Без Docker работает как раньше
101
77
 
102
- | Находка | Решение |
103
- |---------|---------|
104
- | Статусы 28–31 отставали от факта: 28 висел «активен», 29/31 «запланированы», хотя выпущены в 1.5.1–1.5.6 | Статусы и версии в §4 исправлены по `CHANGELOG` |
105
- | «Что в приоритете прямо сейчас» указывало на уже закрытые спринты 28/29/31 | Блок переписан под спринт 36 и подзадачу 36.1.a |
106
- | Версии 32–36 были зафиксированы заранее (0.0.4–0.0.8), хотя 36 идёт первым — релиз нарушил бы порядок | Версия присваивается по факту релиза: 36 → 0.0.3, 32–35 → 0.0.4–0.0.7 |
107
- | У подзадач 36.1 не было собственного критерия приёмки — закрывать итерацию было нечем | Добавлены 36.1.a / 36.1.b с проверяемым «готово, когда» и тестом |
108
- | `docs/ARCHITECTURE.md` в двух местах утверждал «25 agent tools» при фактических 26 | Исправлено на 26 (схема + таблица Modules) |
78
+ **Задача D-3 — Детерминизм вердикта** · P3 · ⬜
79
+ - [ ] D-3.1 Та же спека → тот же вердикт
109
80
 
110
- **Правило итерации:** берём одну подзадачу → выполняем → отчёт; найденные улучшения/фиксы сразу дописываются в ближайший спринт этого роадмапа.
81
+ ## Деталь 3.5 — Approvals и окружения (0.1.0)
82
+ `src/core/approval*`, `src/core/environment*`
111
83
 
112
- ---
84
+ **Задача A-1 — R2/R3 approval-гейт** · P2 · ⬜
85
+ - [ ] A-1.1 Ручное подтверждение перед деплоем
86
+ - [ ] A-1.2 Аудит решений
113
87
 
114
- ## 5. Спринт 36 — Durable DAG + роутер (0.0.3, P1 для 0.1.0)
115
-
116
- **Цель:** пережить крах посреди прогона + реализовать трёхслойный роутер исполнения (CONCEPT §5 capability-aware роутинг).
117
-
118
- **Задачи:**
119
-
120
- - [x] **36.1 Персистентная state-машина** — сложная.
121
- - [x] **36.1.a** Схема шага: шаг → статус → попытка.
122
- - Готово, когда: таблицы `runs`/`run_steps` создаются идемпотентно на чистой и на старой БД; шаг хранит `status`, `attempt`, `idempotency_key`, timestamps; есть `test-run-state.mjs` на переходы `pending → running → passed/failed`.
123
- - [x] **36.1.b** Запись состояния на каждом переходе.
124
- - Готово, когда: каждый переход пишет строку состояния до запуска шага и после него; падение процесса между записями не теряет последнюю попытку; тест покрывает повторный переход без потери `attempt`.
125
- - [x] **36.2 Resume с середины** — сложная.
126
- - [x] Продолжение с того же шага после краха.
127
- - [x] Тест: `kill -9` посреди линейной цепочки.
128
- - [ ] **36.3 Идемпотентные ключи шагов** — сложная.
129
- - [ ] Ключ шага и защита от дублей побочных эффектов.
130
- - [ ] Тест повторного запуска шага.
131
- - [ ] **36.4 DLQ** — средняя.
132
- - [ ] Очередь окончательно упавших шагов.
133
- - [ ] Ручной retry из DLQ.
134
- - [ ] **36.5.X Реализация роутера** — сложная.
135
- - [ ] Слой 1: статические правила для горячего пути (таблица соответствий типа задачи → транспорт + исполнитель, 0 токенов, мгновенно).
136
- - [ ] Слой 2: Capability Map в SQLite (тип задачи → модель / success_rate / средняя стоимость / среднее время / последние 10 запусков; обучается на исходах гейта, 0 токенов, быстро).
137
- - [ ] Слой 3: локальная модель только для декомпозиции миссии и разрешения неоднозначности (не для маршрутизации каждого шага).
138
- - [ ] Эскалация при провале гейта — по правилу, без участия модели.
139
- - [ ] Тест: маршрутизация без вызова модели для известных типов задач.
140
- - [ ] **36.5 Chaos-тест nightly** — средняя.
141
- - [ ] `kill -9` посреди DAG в nightly workflow.
142
- - [ ] **36.6 DLQ в GUI** — средняя.
143
- - [ ] Список, причина, retry.
144
- - [ ] **36.7 Пауза с инъекцией контекста** — средняя.
145
- - [ ] На паузе можно оставить комментарий / файл / структурированный артефакт.
146
- - [ ] При resume следующий шаг получает вставку как контекст.
147
- - [ ] Комментарий и автор видны в истории; секреты маскируются.
148
- - [ ] **36.8 Пауза и resume в GUI/Telegram** — средняя.
149
- - [ ] Кнопки pause/resume, поле комментария, ссылка на текущий шаг.
150
- - [ ] Предупреждение, если шаг уже выполняется.
151
-
152
- **Готово, когда:** `kill -9` посреди DAG → продолжение с того же шага; повторный запуск шага не дублирует побочные эффекты; DLQ видна в GUI; роутер маршрутизирует известные типы задач без вызова модели; пауза с комментарием доходит до следующего шага.
88
+ **Задача A-2 — dev/staging/prod** · P2 · ⬜
89
+ - [ ] A-2.1 Изоляция сред
90
+ - [ ] A-2.2 Привязка задач к среде
153
91
 
154
- ---
92
+ **Задача A-3 — Артефакты запуска** · P3 · ⬜
93
+ - [ ] A-3.1 Отчёты/coverage как артефакты
155
94
 
156
- ## 6. Что изменено относительно исходного плана и почему
95
+ **Задача A-4 — Docs-сайт** · P3 · ⬜
96
+ - [ ] A-4.1 Публикация документации
157
97
 
158
- | Исходный пункт | Проблема | Решение здесь |
159
- |---------------|----------|---------------|
160
- | «Спринт 27 — Фундамент переезда (1.5.0)» | 1.5.0 уже выпущен — это git-триггеры | Фундамент становится 1.5.1 / спринт 28 |
161
- | «Локальный помощник v1» = 5 срезов в одном релизе | Риск не выпустить ничего | Разрезан на v1 (триаж + shadow) и v2 (дедуп, эмбеддинги, саммари, wizard) |
162
- | Security & isolation на 1.5.4, flagship на 1.5.1 | Обещание приватности расходилось с advisory-правами | Security slice A (enforced permissions) поднят до 1.5.2, до флагмана |
163
- | 1.6.0 = переименование + daemon + durable DAG + approvals + config v2 | Самое тяжёлое (durable DAG) смешано с самым рискованным (переименование) | Разрезано: Durable DAG → Rename+daemon → 0.1.0 Approvals |
164
- | Переименование внутри функционального релиза | Переименование ломает установку у всех пользователей | **Rename — отдельный релиз без фич** (Д7, завершён) |
98
+ **Задача A-5 — 4-я локаль (tr)** · P3 · ⬜
99
+ - [ ] A-5.1 Переводы и тесты локалей
165
100
 
166
- ---
101
+ **Задача A-6 — Telegram pause/resume** · P3 · ⬜
102
+ - [ ] A-6.1 Команды бота
103
+ - [ ] A-6.2 Привязка к запускам
104
+
105
+ ## Деталь 3.6 — Мульти-агентная оркестрация (0.2.x+)
106
+ `src/core/agents*`
107
+
108
+ **Задача M-1 — Context artifacts** · P3 · ⬜
109
+ - [ ] M-1.1 Сквозной контекст (CONCEPT §13.2)
110
+
111
+ **Задача M-2 — Crew / роли** · P3 · ⬜
112
+ - [ ] M-2.1 worker → reviewer
113
+
114
+ **Задача M-3 — Self-correcting retry** · P3 · ⬜
115
+ - [ ] M-3.1 Post-mortem и повтор
167
116
 
168
- ## 7. Правила планирования
117
+ **Задача M-4 — Model fallback + confidence** · P3 · ⬜
118
+ - [ ] M-4.1 Фолбэк между моделями
169
119
 
170
- 1. **Одна задача за раз.** Внутри спринта не начинаем следующую, пока текущая не закрыта тестом и документацией.
171
- 2. **Никаких переименований и миграций внутри функциональных релизов.** Отдельный релиз = отдельный риск.
172
- 3. **Каждая фича — с тестом и документацией.** Без этого задача и спринт не закрыты.
173
- 4. **Приоритет — по боли пользователя, а не по красоте темы.** P1 = без этого нельзя рекомендовать плагин.
174
- 5. **Fail-open по умолчанию.** Любая необязательная подсистема при отказе деградирует, а не блокирует планировщик.
175
- 6. **Честность в маркетинге.** «Сэкономлено $» — оценка контрфактики, а не факт. Методика публикуется рядом с цифрой (`docs/SAVINGS.md`).
176
- 7. **Сверка с CONCEPT.md.** Любая фича / ADR проверяется на соответствие четырём столпам (§4 CONCEPT) и не противоречит §8 (границы).
120
+ **Задача M-5 — Tournament A/B** · P3 · ⬜
121
+ - [ ] M-5.1 Сравнение моделей и промптов
122
+
123
+ **Задача M-6 — CEP и входящие события** · P3 · ⬜
124
+ - [ ] M-6.1 Complex Event Processing
125
+
126
+ **Задача M-7 — Cross-run memory** · P3 · ⬜
127
+ - [ ] M-7.1 Память между прогонами
128
+
129
+ **Задача M-8 — Smart recipes** · P3 · ⬜
130
+ - [ ] M-8.1 Самонастраивающиеся конвейеры
131
+
132
+ ## Деталь 3.7 — Инфраструктура и релиз (внешние действия)
133
+ `package.json`, npm, GitHub
134
+
135
+ **Задача X-1 — `npm deprecate` legacy** · P1 · ⏸️
136
+ - [ ] X-1.1 Депрекейт `opencode-windows-scheduler@1.5.8`
137
+
138
+ **Задача X-2 — Legacy 1.5.9 с `<0.1.0`** · P1 · ⏸️
139
+ - [ ] X-2.1 Upper bound, чтобы breaking 0.1.0 не прилетел
140
+
141
+ **Задача X-3 — `is_template: false`** · P3 · ⏸️
142
+ - [ ] X-3.1 Убрать из `package.json`
143
+
144
+ **Задача X-4 — Dependabot** · P2 · ⏸️
145
+ - [ ] X-4.1 Мерж #4 (plugin 2.3.0)
146
+ - [ ] X-4.2 OpenTUI 0.9.0
147
+
148
+ **Задача X-5 — Теги/релизы/версии** · P2 · ⏸️
149
+ - [ ] X-5.1 Привести теги к существующим релизам
150
+ - [ ] X-5.2 GitHub release для каждого тега
151
+
152
+ **Задача X-6 — `systemd` в keywords** · P3 · ⏸️
153
+ - [ ] X-6.1 Убрать, бэкенда нет
154
+
155
+ > Находки аудита dev-ветки (V-1 … V-4) закрыты и перенесены в [CHANGELOG.md](./CHANGELOG.md)
156
+ > (`Unreleased` → Fixed); открытых задач по ним нет.
177
157
 
178
158
  ---
179
159
 
180
- ## 8. После 0.1.0 — мульти-агентная оркестрация (кандидаты 0.2.x+)
160
+ # 4. Правила работы (канбан)
161
+
162
+ 1. **Одна подзадача за раз.** Взял → сделал → отчёт → следующая подзадача.
163
+ 2. **Слой не пропускается.** Деталь → задача → подзадача; подзадача закрывается только с тестом и документацией.
164
+ 3. **Закрытое уходит из ROADMAP.** Выполненная задача/подзадача удаляется отсюда и попадает в CHANGELOG.
165
+ 4. **Нет спринтов.** Статусы ⬜ → 🔄 → ✅ независимо от релизов.
166
+ 5. **Версия — следствие релиза, а не обещание.** `npm version` в момент релиза.
167
+ 6. **Приоритет — по боли пользователя.** P1 = без этого нельзя рекомендовать плагин.
168
+ 7. **Fail-open по умолчанию.** Необязательная подсистема при отказе деградирует, а не блокирует.
169
+ 8. **Сверка с CONCEPT.md.** Четыре столпа (§4), без противоречий §8.
170
+ 9. **Честность в маркетинге.** Оценки — с методикой рядом.
171
+
172
+ ---
181
173
 
182
- Оценка идей: контекстные артефакты → роли (worker → reviewer) → self-correcting retry → model fallback chain → A/B tournament → CEP → входящие внешние события → cross-run memory. Все возможности **opt-in**; планировщик и базовые задачи обязаны работать без локальной модели, без Docker и без внешних сервисов.
174
+ # 5. Release-чеклист
183
175
 
184
- Подробное описание спринтов 40–47 (Context artifacts, Crew / роли, Self-correcting retry, Model fallback, Tournament, CEP, входящие события, Cross-run memory, Smart recipes) — в разделе «После 1.6.0» предыдущей версии роадмапа; перенесено в бэклог под новые номера версий 0.2.x+.
176
+ - [ ] `package.json` version == tag; CI verify зелёный.
177
+ - [ ] CHANGELOG обновлён; шапка ROADMAP и SECURITY.md supported versions в порядке.
178
+ - [ ] `test-docs` (инструменты/RPC/schema/сюиты/локали) зелёный.
179
+ - [ ] GitHub release создан для тега.
180
+ - [ ] Пока жив legacy: диапазон шима актуален, deprecation не снят.
181
+ - [ ] Критические баги аудита закрыты или документированы как known issues.
package/dist/cli.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}