agent-steward 0.0.4 → 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 (190) hide show
  1. package/CHANGELOG.md +134 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +52 -7
  4. package/ROADMAP-STRATEGY.md +21 -18
  5. package/ROADMAP.md +140 -159
  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/execution.d.ts +203 -0
  10. package/dist/core/execution.d.ts.map +1 -0
  11. package/dist/core/execution.js +309 -0
  12. package/dist/core/gate-integrity.d.ts +35 -0
  13. package/dist/core/gate-integrity.d.ts.map +1 -0
  14. package/dist/core/gate-integrity.js +132 -0
  15. package/dist/core/git-trigger.d.ts.map +1 -1
  16. package/dist/core/git-trigger.js +14 -2
  17. package/dist/core/guard-run.d.ts +4 -0
  18. package/dist/core/guard-run.d.ts.map +1 -0
  19. package/dist/core/guard-run.js +101 -0
  20. package/dist/core/guard.d.ts +52 -0
  21. package/dist/core/guard.d.ts.map +1 -0
  22. package/dist/core/guard.js +362 -0
  23. package/dist/core/lock.d.ts +41 -0
  24. package/dist/core/lock.d.ts.map +1 -1
  25. package/dist/core/lock.js +141 -29
  26. package/dist/core/matrix.d.ts.map +1 -1
  27. package/dist/core/matrix.js +75 -15
  28. package/dist/core/mission.d.ts +83 -0
  29. package/dist/core/mission.d.ts.map +1 -0
  30. package/dist/core/mission.js +334 -0
  31. package/dist/core/pipeline-apply.d.ts +38 -0
  32. package/dist/core/pipeline-apply.d.ts.map +1 -0
  33. package/dist/core/pipeline-apply.js +117 -0
  34. package/dist/core/pipeline-io.d.ts +13 -0
  35. package/dist/core/pipeline-io.d.ts.map +1 -0
  36. package/dist/core/pipeline-io.js +64 -0
  37. package/dist/core/pipeline-map.d.ts +46 -0
  38. package/dist/core/pipeline-map.d.ts.map +1 -0
  39. package/dist/core/pipeline-map.js +196 -0
  40. package/dist/core/pipeline-spec.d.ts +109 -0
  41. package/dist/core/pipeline-spec.d.ts.map +1 -0
  42. package/dist/core/pipeline-spec.js +554 -0
  43. package/dist/core/ps-wrapper.d.ts +19 -2
  44. package/dist/core/ps-wrapper.d.ts.map +1 -1
  45. package/dist/core/ps-wrapper.js +250 -62
  46. package/dist/core/record-history.d.ts.map +1 -1
  47. package/dist/core/record-history.js +130 -29
  48. package/dist/core/router/rules.d.ts.map +1 -1
  49. package/dist/core/router/rules.js +6 -0
  50. package/dist/core/scheduler/linux.d.ts +8 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +34 -9
  53. package/dist/core/scheduler/mac.d.ts +44 -2
  54. package/dist/core/scheduler/mac.d.ts.map +1 -1
  55. package/dist/core/scheduler/mac.js +126 -15
  56. package/dist/core/scheduler/windows.d.ts.map +1 -1
  57. package/dist/core/scheduler/windows.js +15 -12
  58. package/dist/core/structured-log.d.ts +7 -1
  59. package/dist/core/structured-log.d.ts.map +1 -1
  60. package/dist/core/worktree-run.d.ts +4 -0
  61. package/dist/core/worktree-run.d.ts.map +1 -0
  62. package/dist/core/worktree-run.js +164 -0
  63. package/dist/core/worktree.d.ts +115 -0
  64. package/dist/core/worktree.d.ts.map +1 -0
  65. package/dist/core/worktree.js +462 -0
  66. package/dist/core/wrappers/bash.d.ts +17 -0
  67. package/dist/core/wrappers/bash.d.ts.map +1 -1
  68. package/dist/core/wrappers/bash.js +175 -24
  69. package/dist/db/capability-repo.d.ts +43 -2
  70. package/dist/db/capability-repo.d.ts.map +1 -1
  71. package/dist/db/capability-repo.js +96 -11
  72. package/dist/db/history-repo.d.ts +38 -5
  73. package/dist/db/history-repo.d.ts.map +1 -1
  74. package/dist/db/history-repo.js +88 -25
  75. package/dist/db/metrics-repo.js +2 -2
  76. package/dist/db/recovery.d.ts.map +1 -1
  77. package/dist/db/recovery.js +5 -4
  78. package/dist/db/run-journal.d.ts +33 -5
  79. package/dist/db/run-journal.d.ts.map +1 -1
  80. package/dist/db/run-journal.js +78 -14
  81. package/dist/db/run-resume.d.ts +5 -0
  82. package/dist/db/run-resume.d.ts.map +1 -1
  83. package/dist/db/run-resume.js +9 -2
  84. package/dist/db/runs-repo.d.ts +19 -2
  85. package/dist/db/runs-repo.d.ts.map +1 -1
  86. package/dist/db/runs-repo.js +22 -6
  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 +63 -2
  90. package/dist/history.d.ts +1 -1
  91. package/dist/history.d.ts.map +1 -1
  92. package/dist/i18n.d.ts +5 -0
  93. package/dist/i18n.d.ts.map +1 -1
  94. package/dist/i18n.js +11 -4
  95. package/dist/index.d.ts +136 -2
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.js +378 -14
  98. package/dist/notifications.d.ts +22 -0
  99. package/dist/notifications.d.ts.map +1 -1
  100. package/dist/notifications.js +36 -8
  101. package/dist/profiles.d.ts.map +1 -1
  102. package/dist/profiles.js +25 -4
  103. package/dist/rpc.d.ts +246 -0
  104. package/dist/rpc.d.ts.map +1 -1
  105. package/dist/rpc.js +117 -0
  106. package/dist/server.d.ts +15 -0
  107. package/dist/server.d.ts.map +1 -1
  108. package/dist/server.js +77 -18
  109. package/dist/settings.d.ts +2 -2
  110. package/dist/settings.d.ts.map +1 -1
  111. package/dist/settings.js +3 -3
  112. package/dist/shared/jobs-view.d.ts +1 -1
  113. package/dist/shared/jobs-view.d.ts.map +1 -1
  114. package/dist/shared/jobs-view.js +2 -0
  115. package/dist/task-transfer.d.ts +16 -0
  116. package/dist/task-transfer.d.ts.map +1 -1
  117. package/dist/task-transfer.js +16 -0
  118. package/docs/ARCHITECTURE.md +281 -65
  119. package/docs/COMPATIBILITY.md +2 -2
  120. package/docs/CONCEPT.md +18 -4
  121. package/docs/CROSS_PLATFORM.ru.md +20 -0
  122. package/docs/CROSS_PLATFORM.zh.md +18 -0
  123. package/docs/EXECUTION-LOOP.md +22 -7
  124. package/docs/FEATURES.md +65 -4
  125. package/docs/FEATURES.zh.md +52 -4
  126. package/docs/MIGRATION.md +2 -2
  127. package/docs/PIPELINE.md +293 -0
  128. package/docs/README.ru.md +42 -3
  129. package/docs/README.zh.md +43 -3
  130. package/docs/SAFETY.md +23 -3
  131. package/gui-experimental.cjs +9 -8
  132. package/locales/en.json +17 -1
  133. package/locales/ru.json +17 -1
  134. package/locales/zh.json +17 -1
  135. package/opencode.pipeline.yaml +35 -0
  136. package/package.json +23 -4
  137. package/scripts/test-home.mjs +83 -0
  138. package/src/cli.ts +412 -0
  139. package/src/core/dry-run.ts +2 -2
  140. package/src/core/execution.ts +538 -0
  141. package/src/core/file-watcher.ts +2 -2
  142. package/src/core/gate-integrity.ts +160 -0
  143. package/src/core/git-trigger.ts +18 -5
  144. package/src/core/guard-run.ts +119 -0
  145. package/src/core/guard.ts +431 -0
  146. package/src/core/lock.ts +178 -37
  147. package/src/core/matrix.ts +95 -50
  148. package/src/core/mission.ts +485 -0
  149. package/src/core/native-notify.ts +1 -1
  150. package/src/core/pipeline-apply.ts +158 -0
  151. package/src/core/pipeline-io.ts +79 -0
  152. package/src/core/pipeline-map.ts +264 -0
  153. package/src/core/pipeline-spec.ts +775 -0
  154. package/src/core/ps-wrapper.ts +263 -63
  155. package/src/core/record-history.ts +164 -77
  156. package/src/core/router/rules.ts +6 -0
  157. package/src/core/schedule-gate.ts +1 -1
  158. package/src/core/scheduler/at-fallback.ts +1 -1
  159. package/src/core/scheduler/linux.ts +40 -11
  160. package/src/core/scheduler/logs.ts +2 -2
  161. package/src/core/scheduler/mac.ts +174 -14
  162. package/src/core/scheduler/registry.ts +2 -2
  163. package/src/core/scheduler/windows.ts +19 -15
  164. package/src/core/secrets.ts +8 -8
  165. package/src/core/structured-log.ts +22 -5
  166. package/src/core/telegram.ts +2 -2
  167. package/src/core/triage-worker.ts +7 -7
  168. package/src/core/triage.ts +2 -2
  169. package/src/core/worktree-run.ts +199 -0
  170. package/src/core/worktree.ts +600 -0
  171. package/src/core/wrappers/bash.ts +190 -23
  172. package/src/db/capability-repo.ts +127 -10
  173. package/src/db/history-repo.ts +129 -22
  174. package/src/db/metrics-repo.ts +2 -2
  175. package/src/db/recovery.ts +5 -4
  176. package/src/db/run-journal.ts +100 -13
  177. package/src/db/run-resume.ts +17 -1
  178. package/src/db/runs-repo.ts +36 -6
  179. package/src/db/schema.ts +65 -2
  180. package/src/gui.tsx +177 -13
  181. package/src/history.ts +1 -1
  182. package/src/i18n.ts +12 -4
  183. package/src/index.ts +524 -4
  184. package/src/notifications.ts +38 -8
  185. package/src/profiles.ts +26 -4
  186. package/src/rpc.ts +128 -0
  187. package/src/server.ts +94 -18
  188. package/src/settings.ts +5 -5
  189. package/src/shared/jobs-view.ts +3 -1
  190. package/src/task-transfer.ts +31 -0
package/ROADMAP.md CHANGED
@@ -1,200 +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
- Точка на 18.11.2026: **спринты 28–31 закрыты и выпущены** (1.5.1–1.5.6), **спринт 36 закрыт и выпущен как `agent-steward@0.0.4`**. Подзадачи **36.1.a**, **36.1.b**, **36.2**, **36.3**, **36.4**, **36.5.a**, **36.5.b**, **36.5.c**, **36.5.d**, **36.5.e**, **36.5 Chaos-тест nightly**, **36.6 DLQ в GUI**, **36.7 Пауза с инъекцией контекста** и **36.8 Пауза и resume в GUI** выполнены: durable DAG (SCHEMA_VERSION 7, `runs`/`run_steps`/`run_dlq`/`run_injections`/`capability_map`), журнал переходов с восстановлением после `kill -9`, resume с середины, идемпотентные ключи, DLQ с ручным retry, все три слоя роутера (`rules.ts`, `capability-repo.ts`, `planner.ts`), сборка маршрута `dispatch.ts` и эскалация `escalation.ts` без модели, ночной chaos-тест с `kill -9` посреди DAG, панель DLQ в GUI со списком, причинами, retry и discard, пауза с комментарием/файлом/артефактом и передачей контекста следующему шагу при resume, панель durable-запусков с pause/resume, комментарием и ссылкой на текущий шаг. Приёмка пройдена: CI по коммиту `b5b130e` зелёный на Windows, Ubuntu и macOS. Следующий шаг: **спринт 32 — Pipeline-as-code (`0.0.5`)**.
37
+ > Реализованные части execution model (ядро, полосы A/B, wrapper, recorder, storage, in-process triggers) в ROADMAP не перечисляются — они в [CHANGELOG.md](./CHANGELOG.md). Здесь только открытые архитектурные задачи.
26
38
 
27
- | Приоритет | Что | Почему |
28
- |-----------|-----|--------|
29
- | P2 | Pipeline-as-code (спринт 32, `0.0.5`) | `opencode.pipeline.yaml` — водораздел планировщик → оркестратор |
30
- | P2 | Worktree-изоляция (33, `0.0.6`), экономика v2 (34, `0.0.7`) | Идут после Pipeline-as-code; номера версий — по факту релиза |
31
- | P3 | Docker runner (35, `0.0.8`) | Opt-in, после P2-направлений |
39
+ Открытых задач нет: полосы A/B и ad-hoc вход (`run_mission`) реализованы.
32
40
 
33
41
  ---
34
42
 
35
- ## 2. Четыре столпа (north star, CONCEPT §4)
43
+ # 3. Остальные задачи (не бэклог и не архитектура)
36
44
 
37
- Любая фича / ADR сверяется с ними. При конфликте порядок: **надёжно > приватно > дёшево > краткосрочные фичи**.
45
+ ## Деталь 3.3 — Экономика v2
46
+ `src/core/budget*`, `src/analytics*`
38
47
 
39
- | Столп | Что значит | Метрика |
40
- |-------|-----------|---------|
41
- | **Дёшево** | Локаль закрывает максимум gate-able задач | net-экономия $ (контрфактика), local share %, escalation rate, time overhead |
42
- | **Приватно** | Control plane, данные, аудит, triage — локальны | % инференса/данных локально; cloud-egress только explicit и залогирован |
43
- | **Надёжно** | Ноль тихих отказов / двойных прогонов / fake-done / порчи репо | trust-инциденты = 0; гейт независим от self-report; полнота аудита |
44
- | **Компаундится** | Success rate и экономия растут под пользователя | Тренд local success_rate ↑, eval-lift адаптеров, рост scaffolding-библиотеки |
48
+ **Задача E-1 — Бюджеты день/неделя** · P2 · ⬜
49
+ - [ ] E-1.1 Лимиты и учёт
50
+ - [ ] E-1.2 Авто-пауза при превышении
51
+ - [ ] E-1.3 Алерт
45
52
 
46
- ---
53
+ **Задача E-2 — Per-task token budgets** · P2 · ⬜
54
+ - [ ] E-2.1 Лимит на задачу
55
+ - [ ] E-2.2 Остановка при превышении
47
56
 
48
- ## 3. Исполнительный цикл (CONCEPT §6)
49
-
50
- ```
51
- 1. Принять миссию + критерий приёмки (гейт)
52
- ↓
53
- 2. Декомпозиция на шаги / роли
54
- ↓
55
- 3. Выбрать исполнителя (локаль first по capability-карте)
56
- ↓
57
- 4. Выполнить шаг (OpenCode-агент)
58
- ↓
59
- 5. GATE — объективная верификация (tests / lint / schema / diff / cmd)
60
- ├─ pass → ledger: économie + пример + training-record
61
- └─ fail → эскалация / ретрай / откат
62
- ↓
63
- 6. Артефакт миссии (diff / PR / отчёт / аудит-трейл)
64
- ↓
65
- 7. Отчёт:'économie, success rate, эскалации, overhead
66
- ↓
67
- 8. Обновить роутинг / capability-карту → eval → LoRA (staged)
68
- ```
69
-
70
- GATE — keystone (§5 CONCEPT): никогда «готово» на слово агента. Провал → эскалация / ретрай / откат.
57
+ **Задача E-3 — Token efficiency score** · P3 · ⬜
58
+ - [ ] E-3.1 Метрика и расчёт
71
59
 
72
- ---
60
+ **Задача E-4 — Прогноз и Grafana JSON** · P3 · ⬜
61
+ - [ ] E-4.1 Прогноз затрат
62
+ - [ ] E-4.2 Экспорт в Grafana
73
63
 
74
- ## 4. Карта спринтов
75
-
76
- | Спринт | Тема | Приоритет | Статус | Версия |
77
- |--------|------|-----------|--------|--------|
78
- | 27.5 | Hotfix после приёмки 1.5.0 | P1 | ✅ завершён | 1.5.1 |
79
- | 28 | i18n-фундамент | P1 | ✅ завершён | 1.5.1 (+ zh/auto в 1.5.6) |
80
- | 29 | Security slice A | P1 | ✅ завершён | 1.5.2 |
81
- | 30 | Local assistant v1 (триаж + shadow) | P1 | ✅ завершён | 1.5.3 |
82
- | 31 | Local assistant v2 (дедуп, эмбеддинги, саммари, wizard, экономия) | P2 | ✅ завершён (31.1–31.13) | 1.5.5–1.5.6 |
83
- | 31.A | Спайк маршрутизации local/cloud | P3 | ⬜ бэклог | — |
84
- | 32 | Pipeline-as-code (`opencode.pipeline.yaml`) | P2 | ⬜ запланирован | 0.0.5 |
85
- | 33 | Worktree-изоляция + guard-условия | P2 | ⬜ запланирован | 0.0.6 |
86
- | 34 | Экономика v2 (бюджеты, token efficiency, прогноз) | P2 | ⬜ запланирован | 0.0.7 |
87
- | 35 | Docker runner (opt-in) | P3 | ⬜ запланирован | 0.0.8 |
88
- | 36 | Durable DAG (resume, идемпотентность, DLQ) + роутер | P1 (для 0.1.0) | ✅ завершён (36.1–36.8) | 0.0.3–0.0.4 |
89
- | 37 | Rename-only + daemon + config v2 | P2 | ✅ завершён (Д7) | 0.0.2 |
90
- | 38 | Approvals, окружения, артефакты, docs-сайт | MAJOR | ⬜ запланирован | 0.1.0 |
91
- | 39 | Запуск и сообщество | — | ⬜ запланирован | 0.1.x |
92
-
93
- **Версии:** rename-релиз Д7 дал `agent-steward@0.0.2`, спринт 36 — `0.0.3`–`0.0.4`. **Версия присваивается по факту релиза, а не заранее.** Следующий релиз — Pipeline-as-code (`0.0.5`); 33–35 сдвигаются на `0.0.6`–`0.0.8` в порядке фактического выпуска. Переход на `0.1.0` — при спринте 38 (Approvals).
64
+ **Задача E-5 — Local vs cloud** · P3 · ⬜
65
+ - [ ] E-5.1 Разбивка запусков и стоимости
94
66
 
95
- ---
67
+ ## Деталь 3.4 — Docker runner
68
+ `src/core/runner*`
96
69
 
97
- ### Ревизия роадмапа — 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
98
74
 
99
- Сверка роадмапа с фактическим состоянием репозитория (`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 работает как раньше
100
77
 
101
- | Находка | Решение |
102
- |---------|---------|
103
- | Статусы 28–31 отставали от факта: 28 висел «активен», 29/31 «запланированы», хотя выпущены в 1.5.1–1.5.6 | Статусы и версии в §4 исправлены по `CHANGELOG` |
104
- | «Что в приоритете прямо сейчас» указывало на уже закрытые спринты 28/29/31 | Блок переписан под спринт 36 и подзадачу 36.1.a |
105
- | Версии 32–36 были зафиксированы заранее (0.0.4–0.0.8), хотя 36 идёт первым — релиз нарушил бы порядок | Версия присваивается по факту релиза: 36 → 0.0.3, 32–35 → 0.0.4–0.0.7 |
106
- | У подзадач 36.1 не было собственного критерия приёмки — закрывать итерацию было нечем | Добавлены 36.1.a / 36.1.b с проверяемым «готово, когда» и тестом |
107
- | `docs/ARCHITECTURE.md` в двух местах утверждал «25 agent tools» при фактических 26 | Исправлено на 26 (схема + таблица Modules) |
78
+ **Задача D-3 — Детерминизм вердикта** · P3 · ⬜
79
+ - [ ] D-3.1 Та же спека → тот же вердикт
108
80
 
109
- **Правило итерации:** берём одну подзадачу → выполняем → отчёт; найденные улучшения/фиксы сразу дописываются в ближайший спринт этого роадмапа.
81
+ ## Деталь 3.5 — Approvals и окружения (0.1.0)
82
+ `src/core/approval*`, `src/core/environment*`
110
83
 
111
- ---
84
+ **Задача A-1 — R2/R3 approval-гейт** · P2 · ⬜
85
+ - [ ] A-1.1 Ручное подтверждение перед деплоем
86
+ - [ ] A-1.2 Аудит решений
112
87
 
113
- ## 5. Спринт 36 — Durable DAG + роутер (0.0.3–0.0.4, P1 для 0.1.0)
114
-
115
- **Цель:** пережить крах посреди прогона + реализовать трёхслойный роутер исполнения (CONCEPT §5 capability-aware роутинг).
116
-
117
- **Задачи:**
118
-
119
- - [x] **36.1 Персистентная state-машина** — сложная.
120
- - [x] **36.1.a** Схема шага: шаг → статус → попытка.
121
- - Готово, когда: таблицы `runs`/`run_steps` создаются идемпотентно на чистой и на старой БД; шаг хранит `status`, `attempt`, `idempotency_key`, timestamps; есть `test-run-state.mjs` на переходы `pending → running → passed/failed`.
122
- - [x] **36.1.b** Запись состояния на каждом переходе.
123
- - Готово, когда: каждый переход пишет строку состояния до запуска шага и после него; падение процесса между записями не теряет последнюю попытку; тест покрывает повторный переход без потери `attempt`.
124
- - [x] **36.2 Resume с середины** — сложная.
125
- - [x] Продолжение с того же шага после краха.
126
- - [x] Тест: `kill -9` посреди линейной цепочки.
127
- - [x] **36.3 Идемпотентные ключи шагов** — сложная.
128
- - [x] Ключ шага и защита от дублей побочных эффектов.
129
- - [x] Тест повторного запуска шага.
130
- - [x] **36.4 DLQ** — средняя.
131
- - [x] Очередь окончательно упавших шагов.
132
- - [x] Ручной retry из DLQ.
133
- - [ ] **36.5.X Реализация роутера** — сложная.
134
- - [x] **36.5.a** Слой 1: статические правила для горячего пути (таблица тип задачи → транспорт + исполнитель, 0 токенов).
135
- - Готово, когда: `src/core/router/rules.ts` маршрутизирует известные типы без импорта модели/БД; неизвестный тип возвращает `undefined` и уходит слою 2; `test-router-rules.mjs` зелёный.
136
- - Сделано: `src/core/router/rules.ts`, `test-router-rules.mjs` (22 проверки).
137
- - [x] **36.5.b** Слой 2: Capability Map в SQLite (тип задачи → модель / success_rate / средняя стоимость / среднее время / последние 10 запусков; обучается на исходах гейта, 0 токенов).
138
- - Готово, когда: таблица создаётся миграцией, исходы гейта обновляют карту, для известного типа маршрут выбирается без модели.
139
- - Сделано: `SCHEMA_VERSION` 6, `capability_map`, `src/db/capability-repo.ts`, `test-capability-map.mjs`.
140
- - [x] **36.5.c** Слой 3: локальная модель только для декомпозиции миссии и разрешения неоднозначности (не для маршрутизации каждого шага).
141
- - Готово, когда: декомпозиция возвращает шаги с типами, а маршрут каждого шага выбирают слои 1–2.
142
- - Сделано: `src/core/router/planner.ts` (`planMission`, `planMissionSync`, `decomposeHeuristically`, `needsDecomposition`), `test-planner.mjs`.
143
- - [x] **36.5.d** Эскалация при провале гейта — по правилу, без участия модели.
144
- - Готово, когда: провал гейта поднимает шаг local → cloud → review, на review останавливается, модель не вызывается.
145
- - Сделано: `src/core/router/escalation.ts` (`escalateAfterGate`, `escalationChain`), сборка маршрута `src/core/router/dispatch.ts` (`routeStep`), `test-escalation.mjs`.
146
- - [x] **36.5.e** Тест: маршрутизация без вызова модели для известных типов задач.
147
- - Готово, когда: тест доказывает, что известный тип решается слоем 1 до БД, статика не пишет в Capability Map, а `dispatch.ts` не импортирует planner.
148
- - Сделано: `test-router-dispatch.mjs`.
149
- - [x] **36.5 Chaos-тест nightly** — средняя.
150
- - [x] `kill -9` посреди DAG в nightly workflow.
151
- - Готово, когда: ночной workflow убивает процесс посреди цепочки, а следующий запуск/восстановление продолжает с прерванного шага; завершённые шаги не переигрываются.
152
- - Сделано: `test-chaos-dag.mjs` (два сценария `kill -9` — на `build` и `test`), `.github/workflows/nightly.yml` (cron 03:17 UTC, Windows + Ubuntu), `npm run test:chaos`.
153
- - [x] **36.6 DLQ в GUI** — средняя.
154
- - [x] Список, причина, retry.
155
- - Готово, когда: панель показывает открытые записи DLQ с причиной и ошибкой; retry переоткрывает запуск и готовит шаг (attempt + 1), discard закрывает запись без повтора; локали ru/en/zh синхронны.
156
- - Сделано: `src/core/dlq-api.ts` (фасад `listDlq`/`retryDlq`/`discardDlq`, безопасные фильтр и лимит), RPC `list_dlq`/`retry_dlq`/`discard_dlq` в `src/rpc.ts` и `src/index.ts` (+ аудит `dlq.retry`/`dlq.discard`), секция «♻️ Dead-letter queue» в `src/gui.tsx` (фильтр open/all/retried/discarded, refresh, retry/discard с подтверждением), `test-dlq-gui.mjs`.
157
- - [x] **36.7 Пауза с инъекцией контекста** — средняя.
158
- - [x] На паузе можно оставить комментарий / файл / структурированный артефакт.
159
- - [x] При resume следующий шаг получает вставку как контекст.
160
- - [x] Комментарий и автор видны в истории; секреты маскируются.
161
- - Сделано: `SCHEMA_VERSION` 7 и таблица `run_injections` (`src/db/schema.ts`), статус `paused` и `pauseRunRecord` (`src/db/runs-repo.ts`), модуль `src/db/run-context.ts` (`pauseRun`, `listRunInjections`, `pendingInjectionsForStep`, `consumeInjections`, `consumeOrphanInjections`, `StepContext`), передача контекста в `resumeRun`/`resumeRunSync` (`src/db/run-resume.ts`), маскирование JSON-ключей в `redactSecretsInText`, тест `test-run-context.mjs`.
162
- - [x] **36.8 Пауза и resume в GUI/Telegram** — средняя.
163
- - [x] Кнопки pause/resume, поле комментария, ссылка на текущий шаг.
164
- - [x] Предупреждение, если шаг уже выполняется.
165
- - Готово, когда: панель показывает durable-запуски с текущим шагом и прогрессом; pause сохраняет комментарий и автора, resume снимает паузу и готовит шаг; пауза во время running-шага предупреждает и блокируется; локали ru/en/zh синхронны.
166
- - Сделано: `src/core/run-panel-api.ts` (`listRunPanel`, `pauseRunPanel`, `resumeRunPanel`, безопасные фильтр/лимит, обрезка истории контекста), RPC `list_durable_runs`/`pause_durable_run`/`resume_durable_run` в `src/rpc.ts` и `src/index.ts` (+ аудит `run.pause`/`run.resume`), секция «⏯️ Запуски DAG» в `src/gui.tsx` (фильтр active/all/running/paused/failed, текущий шаг-якорь, поле комментария, pause/resume, предупреждение о running-шаге, история контекста), `test-pause-gui.mjs`.
167
-
168
- **Готово, когда:** `kill -9` посреди DAG → продолжение с того же шага; повторный запуск шага не дублирует побочные эффекты; DLQ видна в GUI; роутер маршрутизирует известные типы задач без вызова модели; пауза с комментарием доходит до следующего шага.
88
+ **Задача A-2 — dev/staging/prod** · P2 · ⬜
89
+ - [ ] A-2.1 Изоляция сред
90
+ - [ ] A-2.2 Привязка задач к среде
169
91
 
170
- ---
92
+ **Задача A-3 — Артефакты запуска** · P3 · ⬜
93
+ - [ ] A-3.1 Отчёты/coverage как артефакты
171
94
 
172
- ## 6. Что изменено относительно исходного плана и почему
95
+ **Задача A-4 — Docs-сайт** · P3 · ⬜
96
+ - [ ] A-4.1 Публикация документации
173
97
 
174
- | Исходный пункт | Проблема | Решение здесь |
175
- |---------------|----------|---------------|
176
- | «Спринт 27 — Фундамент переезда (1.5.0)» | 1.5.0 уже выпущен — это git-триггеры | Фундамент становится 1.5.1 / спринт 28 |
177
- | «Локальный помощник v1» = 5 срезов в одном релизе | Риск не выпустить ничего | Разрезан на v1 (триаж + shadow) и v2 (дедуп, эмбеддинги, саммари, wizard) |
178
- | Security & isolation на 1.5.4, flagship на 1.5.1 | Обещание приватности расходилось с advisory-правами | Security slice A (enforced permissions) поднят до 1.5.2, до флагмана |
179
- | 1.6.0 = переименование + daemon + durable DAG + approvals + config v2 | Самое тяжёлое (durable DAG) смешано с самым рискованным (переименование) | Разрезано: Durable DAG → Rename+daemon → 0.1.0 Approvals |
180
- | Переименование внутри функционального релиза | Переименование ломает установку у всех пользователей | **Rename — отдельный релиз без фич** (Д7, завершён) |
98
+ **Задача A-5 — 4-я локаль (tr)** · P3 · ⬜
99
+ - [ ] A-5.1 Переводы и тесты локалей
181
100
 
182
- ---
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 и повтор
183
116
 
184
- ## 7. Правила планирования
117
+ **Задача M-4 — Model fallback + confidence** · P3 · ⬜
118
+ - [ ] M-4.1 Фолбэк между моделями
185
119
 
186
- 1. **Одна задача за раз.** Внутри спринта не начинаем следующую, пока текущая не закрыта тестом и документацией.
187
- 2. **Никаких переименований и миграций внутри функциональных релизов.** Отдельный релиз = отдельный риск.
188
- 3. **Каждая фича — с тестом и документацией.** Без этого задача и спринт не закрыты.
189
- 4. **Приоритет — по боли пользователя, а не по красоте темы.** P1 = без этого нельзя рекомендовать плагин.
190
- 5. **Fail-open по умолчанию.** Любая необязательная подсистема при отказе деградирует, а не блокирует планировщик.
191
- 6. **Честность в маркетинге.** «Сэкономлено $» — оценка контрфактики, а не факт. Методика публикуется рядом с цифрой (`docs/SAVINGS.md`).
192
- 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); открытых задач по ним нет.
193
157
 
194
158
  ---
195
159
 
196
- ## 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
+ ---
197
173
 
198
- Оценка идей: контекстные артефакты → роли (worker → reviewer) → self-correcting retry → model fallback chain → A/B tournament → CEP → входящие внешние события → cross-run memory. Все возможности **opt-in**; планировщик и базовые задачи обязаны работать без локальной модели, без Docker и без внешних сервисов.
174
+ # 5. Release-чеклист
199
175
 
200
- Подробное описание спринтов 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":""}