agent-steward 0.0.4 → 0.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. package/CHANGELOG.md +309 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +55 -8
  4. package/ROADMAP-STRATEGY.md +22 -19
  5. package/ROADMAP.md +230 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +356 -0
  9. package/dist/core/analytics.d.ts +6 -0
  10. package/dist/core/analytics.d.ts.map +1 -1
  11. package/dist/core/analytics.js +20 -3
  12. package/dist/core/audit.d.ts +6 -0
  13. package/dist/core/audit.d.ts.map +1 -1
  14. package/dist/core/audit.js +24 -0
  15. package/dist/core/budget.d.ts +118 -0
  16. package/dist/core/budget.d.ts.map +1 -0
  17. package/dist/core/budget.js +206 -0
  18. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  19. package/dist/core/cron-to-schtasks.js +38 -0
  20. package/dist/core/dry-run.d.ts +26 -1
  21. package/dist/core/dry-run.d.ts.map +1 -1
  22. package/dist/core/dry-run.js +199 -8
  23. package/dist/core/execution.d.ts +203 -0
  24. package/dist/core/execution.d.ts.map +1 -0
  25. package/dist/core/execution.js +309 -0
  26. package/dist/core/feedback.d.ts +192 -0
  27. package/dist/core/feedback.d.ts.map +1 -0
  28. package/dist/core/feedback.js +426 -0
  29. package/dist/core/gate-integrity.d.ts +71 -0
  30. package/dist/core/gate-integrity.d.ts.map +1 -0
  31. package/dist/core/gate-integrity.js +275 -0
  32. package/dist/core/git-trigger.d.ts.map +1 -1
  33. package/dist/core/git-trigger.js +14 -2
  34. package/dist/core/guard-run.d.ts +4 -0
  35. package/dist/core/guard-run.d.ts.map +1 -0
  36. package/dist/core/guard-run.js +101 -0
  37. package/dist/core/guard.d.ts +52 -0
  38. package/dist/core/guard.d.ts.map +1 -0
  39. package/dist/core/guard.js +362 -0
  40. package/dist/core/local-ai.d.ts.map +1 -1
  41. package/dist/core/local-ai.js +7 -3
  42. package/dist/core/lock.d.ts +41 -0
  43. package/dist/core/lock.d.ts.map +1 -1
  44. package/dist/core/lock.js +141 -29
  45. package/dist/core/matrix.d.ts +8 -0
  46. package/dist/core/matrix.d.ts.map +1 -1
  47. package/dist/core/matrix.js +132 -17
  48. package/dist/core/mission.d.ts +103 -0
  49. package/dist/core/mission.d.ts.map +1 -0
  50. package/dist/core/mission.js +374 -0
  51. package/dist/core/opencode-models.d.ts +2 -2
  52. package/dist/core/opencode-models.d.ts.map +1 -1
  53. package/dist/core/opencode-models.js +28 -21
  54. package/dist/core/opencode-usage.d.ts +35 -0
  55. package/dist/core/opencode-usage.d.ts.map +1 -0
  56. package/dist/core/opencode-usage.js +132 -0
  57. package/dist/core/pipeline-apply.d.ts +38 -0
  58. package/dist/core/pipeline-apply.d.ts.map +1 -0
  59. package/dist/core/pipeline-apply.js +117 -0
  60. package/dist/core/pipeline-io.d.ts +13 -0
  61. package/dist/core/pipeline-io.d.ts.map +1 -0
  62. package/dist/core/pipeline-io.js +78 -0
  63. package/dist/core/pipeline-map.d.ts +52 -0
  64. package/dist/core/pipeline-map.d.ts.map +1 -0
  65. package/dist/core/pipeline-map.js +208 -0
  66. package/dist/core/pipeline-spec.d.ts +109 -0
  67. package/dist/core/pipeline-spec.d.ts.map +1 -0
  68. package/dist/core/pipeline-spec.js +554 -0
  69. package/dist/core/ps-wrapper.d.ts +27 -2
  70. package/dist/core/ps-wrapper.d.ts.map +1 -1
  71. package/dist/core/ps-wrapper.js +424 -65
  72. package/dist/core/record-history.d.ts.map +1 -1
  73. package/dist/core/record-history.js +206 -33
  74. package/dist/core/router/rules.d.ts.map +1 -1
  75. package/dist/core/router/rules.js +6 -0
  76. package/dist/core/run-mode.d.ts +12 -0
  77. package/dist/core/run-mode.d.ts.map +1 -0
  78. package/dist/core/run-mode.js +17 -0
  79. package/dist/core/scheduler/linux.d.ts +8 -1
  80. package/dist/core/scheduler/linux.d.ts.map +1 -1
  81. package/dist/core/scheduler/linux.js +34 -9
  82. package/dist/core/scheduler/logs.d.ts +4 -0
  83. package/dist/core/scheduler/logs.d.ts.map +1 -1
  84. package/dist/core/scheduler/logs.js +25 -1
  85. package/dist/core/scheduler/mac.d.ts +44 -2
  86. package/dist/core/scheduler/mac.d.ts.map +1 -1
  87. package/dist/core/scheduler/mac.js +126 -15
  88. package/dist/core/scheduler/windows.d.ts.map +1 -1
  89. package/dist/core/scheduler/windows.js +15 -12
  90. package/dist/core/secrets.d.ts.map +1 -1
  91. package/dist/core/secrets.js +18 -8
  92. package/dist/core/self-analysis.d.ts +32 -2
  93. package/dist/core/self-analysis.d.ts.map +1 -1
  94. package/dist/core/self-analysis.js +38 -27
  95. package/dist/core/shutdown.d.ts +33 -2
  96. package/dist/core/shutdown.d.ts.map +1 -1
  97. package/dist/core/shutdown.js +58 -2
  98. package/dist/core/structured-log.d.ts +37 -1
  99. package/dist/core/structured-log.d.ts.map +1 -1
  100. package/dist/core/structured-log.js +37 -0
  101. package/dist/core/usage-surface.d.ts +25 -0
  102. package/dist/core/usage-surface.d.ts.map +1 -0
  103. package/dist/core/usage-surface.js +41 -0
  104. package/dist/core/worktree-run.d.ts +4 -0
  105. package/dist/core/worktree-run.d.ts.map +1 -0
  106. package/dist/core/worktree-run.js +164 -0
  107. package/dist/core/worktree.d.ts +115 -0
  108. package/dist/core/worktree.d.ts.map +1 -0
  109. package/dist/core/worktree.js +462 -0
  110. package/dist/core/wrappers/bash.d.ts +19 -0
  111. package/dist/core/wrappers/bash.d.ts.map +1 -1
  112. package/dist/core/wrappers/bash.js +230 -27
  113. package/dist/db/capability-repo.d.ts +43 -2
  114. package/dist/db/capability-repo.d.ts.map +1 -1
  115. package/dist/db/capability-repo.js +96 -11
  116. package/dist/db/history-repo.d.ts +70 -5
  117. package/dist/db/history-repo.d.ts.map +1 -1
  118. package/dist/db/history-repo.js +170 -29
  119. package/dist/db/metrics-repo.d.ts +20 -2
  120. package/dist/db/metrics-repo.d.ts.map +1 -1
  121. package/dist/db/metrics-repo.js +35 -13
  122. package/dist/db/migrate.d.ts.map +1 -1
  123. package/dist/db/migrate.js +37 -17
  124. package/dist/db/recovery.d.ts +3 -1
  125. package/dist/db/recovery.d.ts.map +1 -1
  126. package/dist/db/recovery.js +11 -5
  127. package/dist/db/run-journal.d.ts +33 -5
  128. package/dist/db/run-journal.d.ts.map +1 -1
  129. package/dist/db/run-journal.js +78 -14
  130. package/dist/db/run-resume.d.ts +5 -0
  131. package/dist/db/run-resume.d.ts.map +1 -1
  132. package/dist/db/run-resume.js +9 -2
  133. package/dist/db/runs-repo.d.ts +19 -2
  134. package/dist/db/runs-repo.d.ts.map +1 -1
  135. package/dist/db/runs-repo.js +91 -60
  136. package/dist/db/schema.d.ts +2 -2
  137. package/dist/db/schema.d.ts.map +1 -1
  138. package/dist/db/schema.js +132 -2
  139. package/dist/db/templates-repo.d.ts +2 -2
  140. package/dist/db/templates-repo.d.ts.map +1 -1
  141. package/dist/db/templates-repo.js +5 -3
  142. package/dist/history.d.ts +7 -2
  143. package/dist/history.d.ts.map +1 -1
  144. package/dist/history.js +4 -2
  145. package/dist/hook-output.d.ts +2 -0
  146. package/dist/hook-output.d.ts.map +1 -0
  147. package/dist/hook-output.js +31 -0
  148. package/dist/i18n.d.ts +5 -0
  149. package/dist/i18n.d.ts.map +1 -1
  150. package/dist/i18n.js +11 -4
  151. package/dist/index.d.ts +375 -47
  152. package/dist/index.d.ts.map +1 -1
  153. package/dist/index.js +1344 -192
  154. package/dist/notifications.d.ts +53 -2
  155. package/dist/notifications.d.ts.map +1 -1
  156. package/dist/notifications.js +168 -21
  157. package/dist/profiles.d.ts.map +1 -1
  158. package/dist/profiles.js +82 -10
  159. package/dist/rpc.d.ts +354 -0
  160. package/dist/rpc.d.ts.map +1 -1
  161. package/dist/rpc.js +145 -0
  162. package/dist/server.d.ts +32 -2
  163. package/dist/server.d.ts.map +1 -1
  164. package/dist/server.js +154 -30
  165. package/dist/settings.d.ts +44 -2
  166. package/dist/settings.d.ts.map +1 -1
  167. package/dist/settings.js +85 -3
  168. package/dist/shared/jobs-view.d.ts +1 -1
  169. package/dist/shared/jobs-view.d.ts.map +1 -1
  170. package/dist/shared/jobs-view.js +2 -0
  171. package/dist/task-transfer.d.ts +21 -0
  172. package/dist/task-transfer.d.ts.map +1 -1
  173. package/dist/task-transfer.js +64 -3
  174. package/dist/templates.d.ts +2 -2
  175. package/dist/templates.d.ts.map +1 -1
  176. package/dist/templates.js +3 -3
  177. package/dist/types.d.ts +22 -2
  178. package/dist/types.d.ts.map +1 -1
  179. package/dist/workspaces.d.ts.map +1 -1
  180. package/dist/workspaces.js +34 -11
  181. package/docs/ARCHITECTURE.md +319 -66
  182. package/docs/COMPATIBILITY.md +2 -2
  183. package/docs/CONCEPT.md +18 -4
  184. package/docs/CROSS_PLATFORM.ru.md +20 -0
  185. package/docs/CROSS_PLATFORM.zh.md +18 -0
  186. package/docs/EXECUTION-LOOP.md +28 -10
  187. package/docs/FEATURES.md +129 -7
  188. package/docs/FEATURES.zh.md +97 -6
  189. package/docs/MIGRATION.md +2 -2
  190. package/docs/PIPELINE.md +293 -0
  191. package/docs/QA-A2-GUI-TUI.md +205 -0
  192. package/docs/README.ru.md +43 -4
  193. package/docs/README.zh.md +44 -4
  194. package/docs/SAFETY.md +23 -3
  195. package/gui-experimental.cjs +9 -8
  196. package/locales/en.json +58 -3
  197. package/locales/ru.json +58 -3
  198. package/locales/zh.json +58 -3
  199. package/opencode.pipeline.yaml +35 -0
  200. package/package.json +36 -4
  201. package/scripts/check-eslint-baseline.mjs +139 -0
  202. package/scripts/gen-test-plan-counters.mjs +117 -0
  203. package/scripts/github-ci-fetch.ps1 +37 -0
  204. package/scripts/pl-commit.ps1 +112 -0
  205. package/scripts/qa-a2-commit.ps1 +104 -0
  206. package/scripts/test-home.mjs +107 -0
  207. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  208. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  209. package/src/cli.ts +417 -0
  210. package/src/core/analytics.ts +27 -4
  211. package/src/core/audit.ts +25 -0
  212. package/src/core/budget.ts +340 -0
  213. package/src/core/cron-to-schtasks.ts +42 -0
  214. package/src/core/dry-run.ts +235 -12
  215. package/src/core/execution.ts +538 -0
  216. package/src/core/feedback.ts +582 -0
  217. package/src/core/file-watcher.ts +2 -2
  218. package/src/core/gate-integrity.ts +330 -0
  219. package/src/core/git-trigger.ts +18 -5
  220. package/src/core/guard-run.ts +119 -0
  221. package/src/core/guard.ts +431 -0
  222. package/src/core/local-ai.ts +7 -3
  223. package/src/core/lock.ts +178 -37
  224. package/src/core/matrix.ts +158 -52
  225. package/src/core/mission.ts +531 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/opencode-models.ts +30 -21
  228. package/src/core/opencode-usage.ts +182 -0
  229. package/src/core/pipeline-apply.ts +158 -0
  230. package/src/core/pipeline-io.ts +96 -0
  231. package/src/core/pipeline-map.ts +283 -0
  232. package/src/core/pipeline-spec.ts +775 -0
  233. package/src/core/ps-wrapper.ts +435 -66
  234. package/src/core/record-history.ts +258 -81
  235. package/src/core/router/rules.ts +6 -0
  236. package/src/core/run-mode.ts +19 -0
  237. package/src/core/schedule-gate.ts +1 -1
  238. package/src/core/scheduler/at-fallback.ts +1 -1
  239. package/src/core/scheduler/linux.ts +40 -11
  240. package/src/core/scheduler/logs.ts +34 -3
  241. package/src/core/scheduler/mac.ts +174 -14
  242. package/src/core/scheduler/registry.ts +2 -2
  243. package/src/core/scheduler/windows.ts +19 -15
  244. package/src/core/secrets.ts +26 -19
  245. package/src/core/self-analysis.ts +75 -29
  246. package/src/core/shutdown.ts +90 -4
  247. package/src/core/structured-log.ts +89 -5
  248. package/src/core/telegram.ts +2 -2
  249. package/src/core/triage-worker.ts +7 -7
  250. package/src/core/triage.ts +2 -2
  251. package/src/core/usage-surface.ts +70 -0
  252. package/src/core/worktree-run.ts +199 -0
  253. package/src/core/worktree.ts +600 -0
  254. package/src/core/wrappers/bash.ts +248 -26
  255. package/src/db/capability-repo.ts +127 -10
  256. package/src/db/history-repo.ts +281 -40
  257. package/src/db/metrics-repo.ts +40 -13
  258. package/src/db/migrate.ts +57 -32
  259. package/src/db/recovery.ts +12 -5
  260. package/src/db/run-journal.ts +100 -13
  261. package/src/db/run-resume.ts +17 -1
  262. package/src/db/runs-repo.ts +147 -65
  263. package/src/db/schema.ts +134 -2
  264. package/src/db/templates-repo.ts +5 -3
  265. package/src/gui.tsx +438 -18
  266. package/src/history.ts +11 -4
  267. package/src/hook-output.ts +39 -0
  268. package/src/i18n.ts +12 -4
  269. package/src/index.ts +1902 -320
  270. package/src/notifications.ts +227 -47
  271. package/src/profiles.ts +88 -10
  272. package/src/rpc.ts +158 -0
  273. package/src/server.ts +201 -41
  274. package/src/settings.ts +125 -5
  275. package/src/shared/jobs-view.ts +3 -1
  276. package/src/task-transfer.ts +90 -6
  277. package/src/templates.ts +3 -3
  278. package/src/types.ts +23 -2
  279. package/src/workspaces.ts +37 -14
package/ROADMAP.md CHANGED
@@ -1,200 +1,271 @@
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.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
+ 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. Бэклог
15
26
 
16
- ### Что сделано
27
+ > Все находки перепроверены по исходникам (чтение кода, grep, подсчёт счётчиков). Приоритеты снижены относительно анализа: ни одна находка не ведёт к потере данных или тихому успеху. Правило канбана не меняется: деталь → задача → подзадача, в работу берётся одна подзадача.
17
28
 
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.
29
+ ## Деталь 1.3 — Находки QA-аудита (20.11.2026, по TEST-PLAN.md)
22
30
 
23
- ### Что в приоритете прямо сейчас
31
+ > Полный аудит: `npm run build` / `npm run lint` / `npm test` зелёные, все 16 деталей D01–D16 подтверждены, i18n-паритет 870/870/870. Источник — отчёт `reports/QA_AUDIT.md`, после переноса удалён.
24
32
 
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`)**.
33
+ **Задача QA-A2 — Полная типизация плагина (эпик)** · P3 · ⬜
26
34
 
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-направлений |
35
+ > Цель: **0 предупреждений** `no-explicit-any` / `no-unsafe-*` в `src/**/*.ts` при 0 ошибок `tsc` и без изменения поведения. На старте 826 предупреждений: ~200 корневых `any` и ~600 каскадных. Оценка — ~1,5–2 недели одному разработчику, знакомому с кодом. Релиз не блокируется: правила в eslint — `warn`, CI уже зелёный.
32
36
 
33
- ---
37
+ **Правила выполнения (обязательны для агента):**
34
38
 
35
- ## 2. Четыре столпа (north star, CONCEPT §4)
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/`.
36
45
 
37
- Любая фича / ADR сверяется с ними. При конфликте порядок: **надёжно > приватно > дёшево > краткосрочные фичи**.
46
+ **Подзадачи:**
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
+ - [ ] QA-A2.7 Финальная верификация: `npm run lint` → 0 ошибок и 0 предупреждений, `npm run build`, `npm test` зелёные; снять baseline-гейт, закрыть эпик.
45
49
 
46
- ---
50
+ # 2. Задачи согласно архитектуре (Execution model)
47
51
 
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): никогда «готово» на слово агента. Провал → эскалация / ретрай / откат.
52
+ agent-steward — execution engine с опциональной регистрацией триггеров. Четыре входа ведут в один путь исполнения; планировщик ОС — только полоса A (cron/once), а не центральный маршрут. Оркестрация (цепочки, DAG, ретраи, матрицы, эскалации) выполняется ядром и рекордером прямыми запусками обёрток.
71
53
 
72
- ---
54
+ > Здесь — только открытая архитектурная очередь 0.2.0, структурированная по правилу «деталь → задача → подзадача». Реализованные части execution model перенесены в [CHANGELOG.md](./CHANGELOG.md); описание целевого кровотока — в [docs/EXECUTION-LOOP.md](./docs/EXECUTION-LOOP.md).
73
55
 
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).
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`
94
58
 
95
- ---
59
+ > Сверка с кодом: таблицы `runs`/`run_steps` создаются только в ad-hoc пути (`runMission` → `execution.ts` → `createRun`/`finishStep`); зарегистрированные задачи идут через `record-history.ts` без durable-run. Таблицы `gate_outcomes`, полей `prev_hash`/`evidence_path` нет.
96
60
 
97
- ### Ревизия роадмапа — 17.11.2026
61
+ **Задача ARCH-1 — Durable ledger для всех входов** · P2 · ⬜
98
62
 
99
- Сверка роадмапа с фактическим состоянием репозитория (`CHANGELOG.md` 1.5.1–1.5.6, `locales/`, `src/core/permissions.ts`, git-log):
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; тест на подделку цепочки.
100
66
 
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) |
67
+ ## Деталь 2.2 — Класс риска и компиляция политики
68
+ `src/core/permissions.ts`, `src/core/execution.ts`, `src/core/mission.ts`
108
69
 
109
- **Правило итерации:** берём одну подзадачу → выполняем → отчёт; найденные улучшения/фиксы сразу дописываются в ближайший спринт этого роадмапа.
70
+ > Сверка с кодом: есть `PermissionPolicy` (`hybrid`/`secure`/`legacy`) и scoped-конфиг прав; класса риска и компилятора политики нет. OPA/Rego/Cedar отклонены в [docs/EXECUTION-LOOP.md](./docs/EXECUTION-LOOP.md) §10 — внешние зависимости не добавлять.
110
71
 
111
- ---
72
+ **Задача ARCH-2 — Класс риска и компиляция политики** · P2 · ⬜
112
73
 
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; роутер маршрутизирует известные типы задач без вызова модели; пауза с комментарием доходит до следующего шага.
74
+ - [ ] ARCH-2.1 Ввести risk class в `MissionSpec`/`RunContext` и классификацию по gate/tool scope.
75
+ - [ ] ARCH-2.2 Компилятор политики: risk class → `PermissionPolicy`, allowed/denied tools и лимиты; тест паритета ad-hoc/registered.
169
76
 
170
- ---
77
+ ## Деталь 2.3 — Flake-aware вердикт и отложенные эффекты
78
+ `src/core/router/escalation.ts`, `src/core/gate-integrity.ts`, `src/db/capability-repo.ts`, обёртки
79
+
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 и пересборка при эскалации не реализованы.
171
96
 
172
- ## 6. Что изменено относительно исходного плана и почему
97
+ **Задача ARCH-5 — Context compilation** · P3 · ⬜
173
98
 
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, завершён) |
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`/применения эффектов.
181
116
 
182
117
  ---
183
118
 
184
- ## 7. Правила планирования
119
+ # 3. Остальные задачи (не бэклог и не архитектура)
120
+
121
+ ## Деталь 3.3 — Экономика v2
122
+ `src/core/budget*`, `src/analytics*`
123
+
124
+ **Задача E-3 — Token efficiency score** · P3 · ⬜
125
+ - [ ] E-3.1 Метрика и расчёт
126
+
127
+ **Задача E-4 — Прогноз и Grafana JSON** · P3 · ⬜
128
+ - [ ] E-4.1 Прогноз затрат
129
+ - [ ] E-4.2 Экспорт в Grafana
130
+
131
+ **Задача E-5 — Local vs cloud** · P3 · ⬜
132
+ - [ ] E-5.1 Разбивка запусков и стоимости
133
+
134
+ ## Деталь 3.4 — Docker runner
135
+ `src/core/runner*`
136
+
137
+ **Задача D-1 — Runner local/docker/ssh** · P3 · ⬜
138
+ - [ ] D-1.1 Интерфейс runner
139
+ - [ ] D-1.2 Docker
140
+ - [ ] D-1.3 SSH
141
+
142
+ **Задача D-2 — Opt-in и обратная совместимость** · P3 · ⬜
143
+ - [ ] D-2.1 Без Docker работает как раньше
144
+
145
+ **Задача D-3 — Детерминизм вердикта** · P3 · ⬜
146
+ - [ ] D-3.1 Та же спека → тот же вердикт
185
147
 
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 (границы).
148
+ ## Деталь 3.5 — Approvals и окружения (0.1.0)
149
+ `src/core/approval*`, `src/core/environment*`
150
+
151
+ **Задача A-1 — R2/R3 approval-гейт** · P2 · ⬜
152
+ - [ ] A-1.1 Ручное подтверждение перед деплоем
153
+ - [ ] A-1.2 Аудит решений
154
+
155
+ **Задача A-2 — dev/staging/prod** · P2 · ⬜
156
+ - [ ] A-2.1 Изоляция сред
157
+ - [ ] A-2.2 Привязка задач к среде
158
+
159
+ **Задача A-3 — Артефакты запуска** · P3 · ⬜
160
+ - [ ] A-3.1 Отчёты/coverage как артефакты
161
+
162
+ **Задача A-4 — Docs-сайт** · P3 · ⬜
163
+ - [ ] A-4.1 Публикация документации
164
+
165
+ **Задача A-5 — 4-я локаль (tr)** · P3 · ⬜
166
+ - [ ] A-5.1 Переводы и тесты локалей
167
+
168
+ **Задача A-6 — Telegram pause/resume** · P3 · ⬜
169
+ - [ ] A-6.1 Команды бота
170
+ - [ ] A-6.2 Привязка к запускам
171
+
172
+ ## Деталь 3.6 — Мульти-агентная оркестрация (0.2.x+)
173
+ `src/core/agents*`
174
+
175
+ **Задача M-1 — Context artifacts** · P3 · ⬜
176
+ - [ ] M-1.1 Сквозной контекст (CONCEPT §13.2)
177
+
178
+ **Задача M-2 — Crew / роли** · P3 · ⬜
179
+ - [ ] M-2.1 worker → reviewer
180
+
181
+ **Задача M-3 — Self-correcting retry** · P3 · ⬜
182
+ - [ ] M-3.1 Post-mortem и повтор
183
+
184
+ **Задача M-4 — Model fallback + confidence** · P3 · ⬜
185
+ - [ ] M-4.1 Фолбэк между моделями
186
+
187
+ **Задача M-5 — Tournament A/B** · P3 · ⬜
188
+ - [ ] M-5.1 Сравнение моделей и промптов
189
+
190
+ **Задача M-6 — CEP и входящие события** · P3 · ⬜
191
+ - [ ] M-6.1 Complex Event Processing
192
+
193
+ **Задача M-7 — Cross-run memory** · P3 · ⬜
194
+ - [ ] M-7.1 Память между прогонами
195
+
196
+ **Задача M-8 — Smart recipes** · P3 · ⬜
197
+ - [ ] M-8.1 Самонастраивающиеся конвейеры
198
+
199
+ ## Деталь 3.7 — Инфраструктура и релиз (внешние действия)
200
+ `package.json`, npm, GitHub
201
+
202
+ **Задача X-1 — `npm deprecate` legacy** · P1 · ⏸️
203
+ - [ ] X-1.1 Депрекейт `opencode-windows-scheduler@1.5.8`
204
+
205
+ **Задача X-2 — Legacy 1.5.9 с `<0.1.0`** · P1 · ⏸️
206
+ - [ ] X-2.1 Upper bound, чтобы breaking 0.1.0 не прилетел
207
+
208
+ **Задача X-3 — `is_template: false`** · P3 · ⏸️
209
+ - [ ] X-3.1 Убрать из `package.json`
210
+
211
+ **Задача X-4 — Dependabot** · P2 · ⏸️
212
+ - [ ] X-4.1 Мерж #4 (plugin 2.3.0)
213
+ - [ ] X-4.2 OpenTUI 0.9.0
214
+
215
+ **Задача X-5 — Теги/релизы/версии** · P2 · ⏸️
216
+ - [ ] X-5.1 Привести теги к существующим релизам
217
+ - [ ] X-5.2 GitHub release для каждого тега
218
+
219
+ **Задача X-6 — `systemd` в keywords** · P3 · ⏸️
220
+ - [ ] X-6.1 Убрать, бэкенда нет
221
+
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`.
193
247
 
194
248
  ---
195
249
 
196
- ## 8. После 0.1.0 — мульти-агентная оркестрация (кандидаты 0.2.x+)
250
+ # 4. Правила работы (канбан)
251
+
252
+ 1. **Одна подзадача за раз.** Взял → сделал → отчёт → следующая подзадача.
253
+ 2. **Слой не пропускается.** Деталь → задача → подзадача; подзадача закрывается только с тестом и документацией.
254
+ 3. **Закрытое уходит из ROADMAP.** Выполненная задача/подзадача удаляется отсюда и попадает в CHANGELOG.
255
+ 4. **Нет спринтов.** Статусы ⬜ → 🔄 → ✅ независимо от релизов.
256
+ 5. **Версия — следствие релиза, а не обещание.** `npm version` в момент релиза.
257
+ 6. **Приоритет — по боли пользователя.** P1 = без этого нельзя рекомендовать плагин.
258
+ 7. **Fail-open по умолчанию.** Необязательная подсистема при отказе деградирует, а не блокирует.
259
+ 8. **Сверка с CONCEPT.md.** Четыре столпа (§4), без противоречий §8.
260
+ 9. **Честность в маркетинге.** Оценки — с методикой рядом.
261
+
262
+ ---
197
263
 
198
- Оценка идей: контекстные артефакты → роли (worker → reviewer) → self-correcting retry → model fallback chain → A/B tournament → CEP → входящие внешние события → cross-run memory. Все возможности **opt-in**; планировщик и базовые задачи обязаны работать без локальной модели, без Docker и без внешних сервисов.
264
+ # 5. Release-чеклист
199
265
 
200
- Подробное описание спринтов 40–47 (Context artifacts, Crew / роли, Self-correcting retry, Model fallback, Tournament, CEP, входящие события, Cross-run memory, Smart recipes) — в разделе «После 1.6.0» предыдущей версии роадмапа; перенесено в бэклог под новые номера версий 0.2.x+.
266
+ - [ ] `package.json` version == tag; CI verify зелёный.
267
+ - [ ] CHANGELOG обновлён; шапка ROADMAP и SECURITY.md supported versions в порядке.
268
+ - [ ] `test-docs` (инструменты/RPC/schema/сюиты/локали) зелёный.
269
+ - [ ] GitHub release создан для тега.
270
+ - [ ] Пока жив legacy: диапазон шима актуален, deprecation не снят.
271
+ - [ ] Критические баги аудита закрыты или документированы как 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":""}