agent-steward 0.0.2 → 0.0.3

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 (180) hide show
  1. package/CHANGELOG.md +25 -2
  2. package/CROSS_PLATFORM.md +11 -9
  3. package/README.md +9 -8
  4. package/ROADMAP-STRATEGY.md +93 -44
  5. package/ROADMAP.md +114 -999
  6. package/dist/core/cron-to-schtasks.d.ts +0 -8
  7. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  8. package/dist/core/cron-to-schtasks.js +11 -86
  9. package/dist/core/dry-run.js +1 -1
  10. package/dist/core/file-watcher.js +9 -9
  11. package/dist/core/git-trigger.js +4 -4
  12. package/dist/core/lock.js +2 -4
  13. package/dist/core/one-shot.d.ts +27 -5
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +53 -10
  16. package/dist/core/otel.js +2 -2
  17. package/dist/core/ps-wrapper.d.ts +1 -1
  18. package/dist/core/ps-wrapper.d.ts.map +1 -1
  19. package/dist/core/ps-wrapper.js +55 -35
  20. package/dist/core/record-history.js +22 -22
  21. package/dist/core/schedule-v2.d.ts +2 -2
  22. package/dist/core/schedule-v2.d.ts.map +1 -1
  23. package/dist/core/schedule-v2.js +7 -7
  24. package/dist/core/scheduler/at-fallback.d.ts +42 -0
  25. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  26. package/dist/core/scheduler/at-fallback.js +70 -0
  27. package/dist/core/scheduler/linux.d.ts +3 -1
  28. package/dist/core/scheduler/linux.d.ts.map +1 -1
  29. package/dist/core/scheduler/linux.js +43 -7
  30. package/dist/core/scheduler/mac.d.ts +14 -8
  31. package/dist/core/scheduler/mac.d.ts.map +1 -1
  32. package/dist/core/scheduler/mac.js +71 -22
  33. package/dist/core/scheduler/posix.d.ts.map +1 -1
  34. package/dist/core/scheduler/posix.js +12 -1
  35. package/dist/core/scheduler/registry.d.ts +2 -0
  36. package/dist/core/scheduler/registry.d.ts.map +1 -1
  37. package/dist/core/scheduler/windows.d.ts +16 -3
  38. package/dist/core/scheduler/windows.d.ts.map +1 -1
  39. package/dist/core/scheduler/windows.js +249 -96
  40. package/dist/core/secrets.js +2 -2
  41. package/dist/core/self-analysis.js +55 -55
  42. package/dist/core/summary.js +1 -1
  43. package/dist/core/triage-chain.js +1 -1
  44. package/dist/core/triage-worker.js +2 -2
  45. package/dist/core/triage.js +1 -1
  46. package/dist/core/wrappers/bash.js +33 -33
  47. package/dist/db/index.d.ts +2 -0
  48. package/dist/db/index.d.ts.map +1 -1
  49. package/dist/db/index.js +9 -1
  50. package/dist/db/run-journal.d.ts +60 -0
  51. package/dist/db/run-journal.d.ts.map +1 -0
  52. package/dist/db/run-journal.js +143 -0
  53. package/dist/db/run-resume.d.ts +48 -0
  54. package/dist/db/run-resume.d.ts.map +1 -0
  55. package/dist/db/run-resume.js +137 -0
  56. package/dist/db/runs-repo.d.ts +120 -0
  57. package/dist/db/runs-repo.d.ts.map +1 -0
  58. package/dist/db/runs-repo.js +319 -0
  59. package/dist/db/schema.d.ts +16 -2
  60. package/dist/db/schema.d.ts.map +1 -1
  61. package/dist/db/schema.js +190 -35
  62. package/dist/index.d.ts +1 -1
  63. package/dist/index.d.ts.map +1 -1
  64. package/dist/index.js +66 -36
  65. package/dist/notifications.js +18 -18
  66. package/dist/profiles.d.ts +7 -3
  67. package/dist/profiles.d.ts.map +1 -1
  68. package/dist/profiles.js +85 -7
  69. package/dist/rpc.d.ts +109 -0
  70. package/dist/rpc.d.ts.map +1 -1
  71. package/dist/rpc.js +89 -0
  72. package/dist/server.d.ts +2 -2
  73. package/dist/server.d.ts.map +1 -1
  74. package/dist/server.js +20 -19
  75. package/dist/shared/jobs-view.d.ts.map +1 -1
  76. package/dist/skill.js +1 -1
  77. package/dist/task-transfer.d.ts +1 -1
  78. package/dist/task-transfer.d.ts.map +1 -1
  79. package/dist/task-transfer.js +14 -10
  80. package/dist/types.d.ts +20 -4
  81. package/dist/types.d.ts.map +1 -1
  82. package/dist/types.js +37 -9
  83. package/dist/workspaces.js +1 -1
  84. package/docs/ARCHITECTURE.md +110 -8
  85. package/docs/COMPATIBILITY.md +10 -6
  86. package/docs/CONCEPT.md +15 -3
  87. package/docs/CROSS_PLATFORM.ru.md +11 -9
  88. package/docs/CROSS_PLATFORM.zh.md +11 -9
  89. package/docs/FAQ.md +2 -2
  90. package/docs/FAQ.ru.md +2 -2
  91. package/docs/FAQ.zh.md +2 -2
  92. package/docs/FEATURES.md +5 -4
  93. package/docs/FEATURES.zh.md +5 -4
  94. package/docs/MIGRATION.md +34 -26
  95. package/docs/README.ru.md +26 -7
  96. package/docs/README.zh.md +9 -8
  97. package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
  98. package/gui-experimental.cjs +8 -8
  99. package/index.js +1 -0
  100. package/locales/en.json +1 -0
  101. package/locales/ru.json +1 -0
  102. package/locales/zh.json +1 -0
  103. package/package.json +31 -10
  104. package/src/core/analytics.ts +2 -2
  105. package/src/core/audit.ts +17 -17
  106. package/src/core/cron-to-schtasks.ts +14 -93
  107. package/src/core/dry-run.ts +26 -26
  108. package/src/core/file-watcher.ts +17 -17
  109. package/src/core/git-trigger.ts +9 -9
  110. package/src/core/glob.ts +1 -1
  111. package/src/core/local-ai.ts +2 -2
  112. package/src/core/lock.ts +9 -9
  113. package/src/core/matrix.ts +31 -31
  114. package/src/core/native-notify.ts +2 -2
  115. package/src/core/one-shot.ts +63 -13
  116. package/src/core/otel.ts +4 -4
  117. package/src/core/permissions.ts +5 -5
  118. package/src/core/prometheus.ts +17 -17
  119. package/src/core/ps-wrapper.ts +57 -37
  120. package/src/core/record-history.ts +40 -40
  121. package/src/core/retention.ts +3 -3
  122. package/src/core/savings.ts +1 -1
  123. package/src/core/schedule-gate.ts +12 -12
  124. package/src/core/schedule-v2.ts +24 -24
  125. package/src/core/scheduler/at-fallback.ts +113 -0
  126. package/src/core/scheduler/index.ts +3 -3
  127. package/src/core/scheduler/linux.ts +64 -13
  128. package/src/core/scheduler/logs.ts +1 -1
  129. package/src/core/scheduler/mac.ts +112 -60
  130. package/src/core/scheduler/posix.ts +15 -1
  131. package/src/core/scheduler/registry.ts +6 -4
  132. package/src/core/scheduler/windows.ts +295 -125
  133. package/src/core/secrets.ts +13 -13
  134. package/src/core/self-analysis.ts +61 -61
  135. package/src/core/session.ts +3 -3
  136. package/src/core/structured-log.ts +3 -3
  137. package/src/core/summary.ts +25 -25
  138. package/src/core/telegram.ts +16 -16
  139. package/src/core/triage-chain.ts +4 -4
  140. package/src/core/triage-compare.ts +8 -8
  141. package/src/core/triage-rules.ts +4 -4
  142. package/src/core/triage-shadow.ts +7 -7
  143. package/src/core/triage-worker.ts +6 -6
  144. package/src/core/triage.ts +23 -23
  145. package/src/core/watch-paths.ts +1 -1
  146. package/src/core/wrappers/bash.ts +41 -41
  147. package/src/db/git-state-repo.ts +1 -1
  148. package/src/db/history-repo.ts +22 -22
  149. package/src/db/index.ts +16 -6
  150. package/src/db/metrics-repo.ts +10 -10
  151. package/src/db/migrate.ts +10 -10
  152. package/src/db/recovery.ts +3 -3
  153. package/src/db/run-journal.ts +212 -0
  154. package/src/db/run-resume.ts +220 -0
  155. package/src/db/runs-repo.ts +481 -0
  156. package/src/db/schema.ts +205 -44
  157. package/src/db/settings-repo.ts +2 -2
  158. package/src/db/tasks-repo.ts +10 -10
  159. package/src/db/templates-repo.ts +7 -7
  160. package/src/gui.tsx +1 -1
  161. package/src/history.ts +4 -4
  162. package/src/i18n.ts +7 -7
  163. package/src/index.ts +341 -304
  164. package/src/integrations.ts +6 -6
  165. package/src/notifications.ts +76 -76
  166. package/src/profiles.ts +98 -7
  167. package/src/rpc.ts +96 -1
  168. package/src/schtasks.ts +2 -2
  169. package/src/server.ts +43 -42
  170. package/src/settings.ts +44 -44
  171. package/src/shared/jobs-view.ts +60 -60
  172. package/src/skill.ts +1 -1
  173. package/src/task-transfer.ts +58 -56
  174. package/src/templates.ts +1 -1
  175. package/src/types.ts +45 -10
  176. package/src/workspaces.ts +16 -16
  177. package/dist/core/self-analysis.test.d.ts +0 -2
  178. package/dist/core/self-analysis.test.d.ts.map +0 -1
  179. package/dist/core/self-analysis.test.js +0 -219
  180. package/dist/gui-experimental.cjs +0 -1
package/ROADMAP.md CHANGED
@@ -1,6 +1,9 @@
1
1
  # 🗺️ Roadmap — agent-steward
2
2
 
3
- Текущая версия: **1.5.6** (17.11.2026). Плагин опубликован в npm, CI зелёный на Windows / macOS / Linux, 26 инструментов агента, 63 тестовые сюиты.
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
7
 
5
8
  - Стратегия и позиционирование — [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
6
9
  - Что уже выпущено — [CHANGELOG.md](./CHANGELOG.md).
@@ -8,1062 +11,174 @@
8
11
 
9
12
  ---
10
13
 
11
- ## История релизов
12
-
13
- | Версия | Дата | Что вошло |
14
- |---|---|---|
15
- | 1.0.0 | 13.11.2026 | Ядро: cron и нативный планировщик ОС (Windows / macOS / Linux), lock-файлы, таймауты, повторы, Quality Gate, DAG и цепочки, файловые и MCP-триггеры, SQLite-история, workspaces, дашборд, dry-run, экспорт/импорт, шаблоны, матричные сборки (fan-out, lifecycle, sync). |
16
- | 1.1.0 | 13.11.2026 | Паритет агента: 12 инструментов, полная схема `schedule_task`, встроенный скилл `scheduled-job-best-practices`, документация ARCHITECTURE / FEATURES / MIGRATION, ретеншн истории и аналитика за 14 дней. |
17
- | 1.2.0 | 13.11.2026 | Планирование 2.0 (timezone, окна `notBefore`/`notAfter`, расширенный cron, `pausedUntil`), уведомления v2 (ретраи, шаблоны, фильтры, матрицы, дайджест), профили и env на workspace, входящие webhooks с HMAC, JSONL-логи, Prometheus `/metrics`, OTLP-экспорт, 22 инструмента агента. |
18
- | 1.2.1 | 13.11.2026 | Одноразовые запуски (`runAt` / `delaySeconds`), непрерывность сессий (`new` / `reuse` / `last`, `sessionMaxRuns`), TUI-панель с логами и клавиатурной навигацией, SVG-граф DAG и светлая тема в дашборде, `partial` отдельно от `error`. |
19
- | 1.2.2 | 13.11.2026 | Кроссплатформенный дашборд: снятие зомби-процесса на macOS/Linux (`lsof`, `ss`), ожидание освобождения порта после SIGKILL, платформо-независимый тест заголовка. |
20
- | 1.2.3 | 13.11.2026 | Документация и дистрибуция: установка через `plugins` и `opencode plugin add` (ключ `plugin` устарел), FAQ, английский README для npm, русский README в `docs/README.ru.md`, расширенные описание и keywords пакета. |
21
- | 1.3.0 | 14.11.2026 | Уведомления: Telegram Bot API (HTML / MarkdownV2 / Markdown, тема форума, ссылка на дашборд), нативные toast на Windows / macOS / Linux без внешних зависимостей, тихие часы, стоимость и токены в сообщениях, тестовая отправка по выбранному каналу. |
22
- | 1.4.0 | 14.11.2026 | Секреты и аудит: зашифрованное хранилище (AES-256-GCM, secrets.key 0600) с ссылками ${secret:NAME}, маскирование в логах и истории, журнал аудита (audit_log в SQLite, ротация 90 дней / 10 000 записей), инструменты manage_secrets и get_audit_log, GUI-панели секретов и аудита, HTTP-аудит мутаций. |
23
- | 1.5.0 | 14.11.2026 | Git-триггеры (HEAD против последнего запуска, фильтр по ветке и путям), glob-маски и ignore-списки для файловых триггеров, временные окна с активными днями недели и политикой вне окна (skip / postpone / run), активное окно проверяется в dry-run и при событии, триггеры настраиваются через schedule_task и GUI, 3 новых тестовых сюита (glob, git-trigger, window-v3). |
24
- | 1.5.1 | 15.11.2026 | Hotfix по итогам приёмки 1.5.0 и i18n-фундамент: каталоги `locales/ru.json` и `locales/en.json` (693 ключа в паритете), загрузчик без зависимостей с fallback и ICU-плюрализацией, переключение языка без перезапуска для GUI, уведомлений, дашборда и инструментов агента, локале-зависимые шаблоны в `settings.json`, тесты в двух локалях (`npm run test:en`, шаг CI на Ubuntu), пакет-заглушка `opencode-pipeline`, раздел Localization в архитектуре. |
25
- | 1.5.2 | 15.11.2026 | Security slice A: enforced `allowedTools`/`deniedTools` через task-scoped конфиг в `OPENCODE_CONFIG_CONTENT`, scoped-инъекция секретов, аудит `tool.blocked`, документация модели прав и ограничений. |
26
- | 1.5.3 | 15.11.2026 | ⭐ Local assistant v1: триаж + shadow mode, `manage_local_ai` инструмент + блок настроек в GUI, бенчмарк `scripts/bench-local.mjs`, версия 1.5.3, исправление бага сохранения настроек уведомлений (`Expected JSON value at ["notifications"]["triage"]`). |
27
- | 1.5.4 | 16.11.2026 | 🔧 Hotfix выполнения: реальный таймаут задач (таймаут → статус `timeout`), блокировка на уровне wrapper `.cmd`, повторные попытки (`retryCount`), экранирование кавычек в before/after/gate-хуках, фикс отбрасывания аргументов в `record-history --finish`, поле `timeoutSeconds` в `list_tasks`. |
28
-
29
- ---
30
-
31
- ## План 1.5.1 → 1.6.0
32
-
33
- План собран 14.11.2026 после выпуска 1.5.0, обновлён 16.11.2026: внеплановый hotfix 1.5.4 и 12 релизов 1.5.1 → 1.6.0. Порядок отражает приоритет по боли пользователя, а не по красоте темы. Каждый спринт — один вертикальный срез; задачи внутри спринта выполняются строго по одной.
34
-
35
- ### Принципы планирования
36
-
37
- 1. **Задачи выполняются строго по одной.** Внутри спринта не начинаем следующую задачу, пока текущая не закрыта тестом и документацией. Спринт может длиться дольше двух недель — качество важнее скорости; большие темы режем на задачи, а не тащим одним куском.
38
- 2. **Никаких переименований и миграций внутри функциональных релизов.** Отдельный релиз = отдельный риск.
39
- 3. **Каждая фича приходит с тестом и документацией.** Без этого задача и спринт не закрыты.
40
- 4. **Приоритет — по боли пользователя, а не по красоте темы.** P1 = без этого нельзя рекомендовать плагин.
41
- 5. **Fail-open по умолчанию.** Любая необязательная подсистема (локальный ИИ, Docker, daemon) при отказе деградирует, а не блокирует планировщик.
42
- 6. **Честность в маркетинге.** «Сэкономлено $» — оценка контрфактики, а не факт. Методика публикуется рядом с цифрой.
43
-
44
- ### Карта версий
45
-
46
- | Версия | Спринт | Тема | Приоритет | Риск |
47
- |---|---|---|---|---|
48
- | ~~1.5.1~~ | ~~27.5 + 28~~ | ~~Hotfix по итогам приёмки 1.5.0 + i18n-фундамент~~ | ~~P1~~ | ~~средний~~ |
49
- | ~~1.5.2~~ | ~~29~~ | ~~Security slice A: enforced permissions + scoped secrets~~ | ~~P1~~ | ~~высокий (спайк API)~~ |
50
- | ~~1.5.3~~ | ~~30~~ | ~~⭐ Local assistant v1: триаж + shadow mode~~ | ~~P1~~ | ~~высокий~~ |
51
- | 1.5.4 | 30.1 | 🔧 Hotfix выполнения (таймаут, блокировка wrapper, повторы, хуки, timeoutSeconds в view) | P1 | низкий |
52
- | 1.5.5 | 31 | Local assistant v2: саммари + дедуп + wizard | P2 | средний |
53
- | 1.5.6 | 31A | OpenCode v1 + v2 в одном пакете (внеплановый) | P1 | средний |
54
- | 1.5.7 | 32 | Pipeline-as-code | P2 | средний |
55
- | 1.5.8 | 33 | Worktree-изоляция + guard-условия | P2 | средний |
56
- | 1.5.9 | 34 | Экономика v2: бюджеты | P2 | низкий |
57
- | 1.5.10 | 35 | Docker runner (opt-in) | P3 | высокий |
58
- | 1.5.11 | 36 | Durable DAG: resume, идемпотентность, DLQ | P1 (для 1.6.0) | очень высокий |
59
- | 1.5.12 | 37 | Rename-only релиз + scheduler daemon + config v2 | P2 | высокий |
60
- | 1.5.5 (спайк) | 31.A | Маршрутизация local/cloud — только исследование, без релиза | P3 | высокий |
61
- | 1.6.0 | 38 | Approvals, окружения, артефакты, docs-сайт | MAJOR | высокий |
62
- | 1.6.x | 39 | Запуск и сообщество | — | средний |
63
-
64
- **Если ресурсов меньше:** можно слить 31→30 и 33→32 (получится 10 релизов вместо 12), но **не** сливать 36→37, не сливать rename с фичами и не откладывать hotfix 27.5.
65
-
66
- ### Как устроен план задач
67
-
68
- - **Номер задачи** — `<спринт>.<порядок>`, например `28.2`. В коммитах, отчётах и issue ссылаемся на номер.
69
- - **Сложность** — `лёгкая` (один файл, конфиг или документация; до полудня), `средняя` (1–2 модуля плюс тесты; до двух дней), `сложная` (ядро, новая подсистема или миграция; два дня и больше).
70
- - **Подзадачи** — обязательны у средней и сложной задачи, у лёгкой их нет. Подзадача — проверяемый результат, а не «поработать над темой».
71
- - **Чекбоксы** — `[ ]` запланировано, `[x]` сделано и подтверждено тестом/документацией. Задачу нельзя закрыть с открытыми подзадачами.
72
- - **Порядок** — сверху вниз, по одной задаче за раз. Задача считается закрытой, когда выполнены все её подзадачи и зелёные проверки.
73
-
74
- ### Сводка задач
75
-
76
- | Спринт | Задач | Сложных | Средних | Лёгких | Статус |
77
- |---|---:|---:|---:|---:|---|
78
- | ~~27.5 — hotfix 1.5.1~~ | ~~11~~ | ~~1~~ | ~~7~~ | ~~3~~ | ~~завершён~~ |
79
- | ~~28 — i18n~~ | ~~11~~ | ~~3~~ | ~~5~~ | ~~3~~ | ~~завершён~~ |
80
- | ~~29 — Security A~~ | ~~6~~ | ~~1~~ | ~~2~~ | ~~3~~ | ~~завершён~~ |
81
- | ~~30 — Local assistant v1~~ | ~~10~~ | ~~2~~ | ~~6~~ | ~~2~~ | ~~завершён~~ |
82
- | 31 — Local assistant v2 | 14 | 3 | 6 | 5 | активен |
83
- | 31.A — routing spike (вне релиза) | 4 | 1 | 3 | 0 | бэклог |
84
- | 32 — Pipeline-as-code | 6 | 2 | 3 | 1 | активен |
85
- | 33 — Worktree + guards | 5 | 1 | 4 | 0 | активен |
86
- | 34 — Экономика v2 | 4 | 1 | 3 | 0 | активен |
87
- | 35 — Docker runner | 4 | 2 | 1 | 1 | активен |
88
- | 36 — Durable DAG | 6 | 3 | 3 | 0 | активен |
89
- | 37 — Rename + daemon + config v2 | 4 | 3 | 1 | 0 | активен |
90
- | 38 — 1.6.0 | 5 | 2 | 3 | 0 | активен |
91
- | 39 — Запуск | 6 | 0 | 1 | 5 | активен |
92
- | **Итого** | **96** | **25** | **47** | **24** | |
93
- | ~~Итого завершённые~~ | ~~38~~ | ~~7~~ | ~~20~~ | ~~11~~ | ~~D01–D16, D04, D05, D09.2~~ |
94
-
95
- ### Что изменено относительно исходного плана и почему
96
-
97
- | Исходный пункт | Проблема | Решение здесь |
98
- |---|---|---|
99
- | «Спринт 27 — Фундамент переезда (1.5.0)» | **1.5.0 уже выпущен** — это git-триггеры. Номер и версия заняты | Фундамент становится **1.5.1 / спринт 28** |
100
- | «Спринт 29 — Git-триггеры (из старого плана)» | Работа **уже в 1.5.0**: `glob.ts`, `git-trigger.ts`, окна с `activeDays` и `windowPolicy` | Спринт удалён из плана как выполненный |
101
- | Фундамент: i18n + имя + bench + рецепт Ollama в одном спринте | i18n по 4300-строчному `gui.tsx`, `server.ts`, уведомлениям и тестам — это 2+ недели само по себе | Фундамент = **только i18n + резерв имени**. Bench и рецепт переезжают в спринт локального помощника, где реально проверяются |
102
- | «Локальный помощник v1» = triage + дедуп эмбеддингами + саммари + wizard + shadow + инструменты | 4–5 вертикальных срезов в одном релизе; риск не выпустить ничего | Разрезан на **v1 (триаж + shadow)** и **v2 (саммари + дедуп + wizard)** |
103
- | Security & isolation на 1.5.4, flagship на 1.5.1 | Флагман продаёт приватность и локальность, а `allowedTools`/`deniedTools` **advisory** — это прямо заявлено в `docs/FEATURES.md`. Обещание расходится с реализацией | **Security slice A** (enforced permissions) поднят до 1.5.2, до флагмана |
104
- | Docker runner + chaos + 24-часовой soak + zh/tr в одном спринте | Docker на Windows-CI болезненный; soak — это nightly-процесс, а не спринт | Docker — отдельный opt-in релиз; chaos/soak — **nightly workflow**, а не блокер релиза |
105
- | 1.6.0 = переименование + daemon + durable DAG + approvals + config v2 + docs-сайт | Самое тяжёлое в проекте (durable DAG) сложено с самым рискованным (переименование npm-пакета) | Разрезано на **3 релиза**: Durable DAG → Rename+daemon → 1.6.0 Approvals |
106
- | Переименование внутри 1.6.0 | Переименование ломает установку у всех пользователей; смешивать его с фичами — худший способ отладить регрессию | **Rename — отдельный релиз без функциональных изменений**, старый пакет остаётся живым re-export'ом и **не** депрекейтится сразу |
107
- | Дефекты, найденные на приёмке 1.5.0 (S01.2.1, S01.2.4) | Без отдельной записи потеряются в бэклоге; внутри i18n-спринта смешают темы и отложат заметные баги до 1.5.1 | Отдельный **hotfix 27.5 / 1.5.1** перед спринтом 28, закрывается первым |
108
-
109
- ---
110
-
111
- ### Спринт 27.5 — Hotfix после 1.5.0: стабилизация после приёмки 1.5.0 (P1, внеплановый)
112
-
113
- **Цель:** убрать пять дефектов, найденных при тестировании детали D01 (подзадачи S01.2.1–S01.2.4), до начала i18n-работ. Четыре — бытовые, но заметные каждый день: мусор на диске, пустой `nextRun`, ложный пустой список и недокументированный запуск только при активном входе. Пятый — критический: command injection через имя задачи (фантомная задача в БД + исполнение метасимволов оболочки).
114
-
115
- **Номер спринта условный:** это hotfix между 27 и 28, поэтому нумерация `27.5.x`; отдельного релизного поезда 27.6 нет.
116
-
117
- **Задачи:**
118
-
119
- - [x] **27.5.1 Очистка wrappers и временных файлов** — средняя — P1.
120
- - [x] `delete_task` удаляет `wrappers/run-<name>.cmd`, prompt/lock/defer-файлы удалённой задачи.
121
- - [x] Отсутствие задачи в ОС считать успехом: распознавать русские варианты «Не удается найти…» и «не может найти…». Сейчас `deleteTask` бросает ошибку на `ОШИБКА: Не удается найти указанный файл.` (найдено в 27.5.5.1), из-за чего delete фантомной/вручную удалённой задачи падает.
122
- - [x] GC при старте: удалять файлы в `wrappers`, для которых нет задачи ни в БД, ни в ОС; активные (`running`, есть lock) не трогать.
123
- - [x] Тест: создать → удалить → файлов нет; повторный `delete_task` идемпотентен (в т.ч. при русской ошибке schtasks); после перезапуска мусорных файлов нет.
124
- - [x] Лог/метрика `wrappers.cleaned` (сколько удалено) для наблюдаемости.
125
- - [x] **27.5.2 `nextRun` сразу после create/update/pause/resume** — средняя — P1.
126
- - [x] `schedule_task`, `update_task`, `pause_task` и `resume_task` возвращают `nextRun`, рассчитанный из cron/`runAt`, не дожидаясь обновления кэша ОС.
127
- - [x] Ответ не зависит от задержки ОС: кэша списка в коде нет (каждый вызов — `schtasks /query`); `nextRun` считается из определения через `computeTaskNextRun()`.
128
- - [x] Для one-shot `nextRun = runAt`; для задач вне окна — ближайшее открытие окна; при паузе — `null` с явным `paused: true`.
129
- - [x] Тест: сразу после create/update/pause/resume `nextRun` корректен в MCP, GUI и дашборде (общий `collectTasksView`, RPC `get_tasks`).
130
- - [x] Наблюдение S01.2.2: после `resume_task` ОС показывает 8:00, а API отдаёт `nextRun: null`; после `pause_task` статус `unknown` (маскируется флагом `paused`).
131
- - [x] **27.5.3 `list_tasks` без ложного пустого ответа** — средняя — P2.
132
- - [x] При пустом результате чтения ОС сразу после мутации — один retry с короткой задержкой (300 мс, всего 2 попытки).
133
- - [x] Не отдавать `[]`, если в БД есть задачи: отдавать БД-состояние с пометкой «статус ОС недоступен» (`osAvailable:false`, `osError`, задачи `orphaned:true`).
134
- - [x] Тест: create → delete → list в том же тике возвращает все остальные задачи; retry, постоянная пустота и исключение ОС; RPC `get_tasks` совпадает.
135
- - [x] **27.5.4 Logon Mode и запуск без входа** — средняя — P2.
136
- - [x] Документирован `Interactive only` в README (EN/RU), FEATURES (раздел Logon mode + строка в Platform support) и FAQ: по умолчанию задачи идут только при активном входе пользователя.
137
- - [x] Опция `runWhenLoggedOff` реализована как `/ru SYSTEM` (без пароля — не нужен секрет), по умолчанию выключена; предупреждение о session 0, отсутствии профиля/дисков/сохранённых кредов и необходимости повышенных прав — в описании схемы и документации. Windows-only: Linux crontab и так работает без входа, launchd-агент — только в сессии.
138
- - [x] Тест: по умолчанию `/create` идёт без `/ru`; с опцией — `/ru SYSTEM`; без прав — понятная ошибка «Отказано в доступе» и откат (задачи нет ни в ОС, ни в БД); режим виден в `list_tasks` (`runWhenLoggedOff` + `logonMode`), `dry_run` и RPC `get_tasks`. Попутно исправлено: `schtasks /query` без `/v` не отдавал `logonMode`, а RU-ключ «Режим входа в систему» не маппился. Успешная ветка `/ru SYSTEM` в неэлевированной консоли не воспроизводится — нужен запуск от администратора (см. 27.5.9 и TEST-PLAN).
139
- - [x] **27.5.5 Безопасная передача имени задачи в schtasks** — сложная — P1.
140
- - [x] Не собирать командную строку для `cmd.exe`: вызывать `schtasks.exe` через `execFile` с массивом аргументов, вывод декодировать как сейчас.
141
- - [x] Валидация имени до записи в БД: буквы (включая кириллицу), цифры, `.`, `_`, `-`, пробелы; запретить `& | < > ^ % " ' ; ( ) \`` и управляющие символы — с понятным сообщением.
142
- - [x] После `/create` проверять фактическое наличие задачи в ОС; при провале — откат записи в БД и удаление wrapper/prompt.
143
- - [x] Тест: `qa space` создаётся; `qa"quote` и `qa&echo MARKER` отклоняются до записи в БД, маркер не исполняется, фантомных задач нет; кириллица и спецсимволы промпта сохраняются без искажений.
144
- - [x] Регресс create/update/pause/resume/delete на Windows/macOS/Linux; проверить аналогичное экранирование в mac/Linux-бэкендах. Linux: `shellQuote` для command/log + валидация имени (сырое имя только в комментарии crontab), macOS: `xmlEscape` plist + `sanitizeName` label, запуск через `execFile`/`spawn` с массивом аргументов — инъекций не найдено.
145
- - [x] **27.5.6 Атомарное обновление задачи** — средняя — P2.
146
- - [x] Откат без временного имени: определение задачи в БД не меняется до успешного create, поэтому при сбое оно остаётся прежним. Добавлена `recreateTaskFromDefinition`, которая пересоздаёт задачу из сохранённого определения (все поля, включая время входа и паузу).
147
- - [x] В `updateTaskFromInput` отслеживается `previousDeleted`: если удалить старую версию не удалось — возвращается `restored: true` и «прежняя версия не тронута»; если удалили, но создать не смогли — сначала убирается возможный частичный результат, затем вызывается `recreateTaskFromDefinition(previous)`, обновляются триггеры, ответ `restored: true`; при провале отката — `restored: false` и явное «задача отсутствует, создайте заново». Ошибка отката не маскирует исходную причину.
148
- - [x] Тест `s2755-6.mjs`: update с некорректным cron → `success:false`, `restored:true`, прежние расписание и `nextRun` на месте, задача в ОС «Включено»; update с `/ru SYSTEM` без прав → откат, режим остался интерактивным; update задачи на паузе → пауза и расписание сохранены, ОС «Отключено»; RPC согласован — 24/24.
149
- - [x] **27.5.7 Откат частично созданной матрицы** — средняя — P2.
150
- - [x] Разворачивание матрицы (`matrixMode = "create"`) обёрнуто в общий `try`: клоны из `expandMatrixTask` (включая ошибку неизвестного workspace) создаются по одному, ошибка клона перебрасывается с именем клона и названием workspace. В `catch` созданные в этом прогоне клоны удаляются в обратном порядке вместе с определениями, очередью и файлами (`removeTaskArtifacts`); агрегатор удаляется, если успел появиться; для новой задачи (`!definitionExisted`) удаляются также родитель из ОС, его определение и файлы обёртки. Сообщение: `Не удалось развернуть матрицу "<name>": … Созданные клоны удалены.`
151
- - [x] Откат update-матрицы (27.5.6) идёт через `recreateTaskFromDefinition` с `matrixMode: "create"`: перед разворачиванием старые клоны удаляются, поэтому дублей нет, а неудачный прогон откатывается по тем же правилам и прежняя версия восстанавливается целиком.
152
- - [x] Тест `s2755-7.mjs`: 3 workspace, сбой на втором клоне (имя клона 224 симв. при лимите schtasks 237 с папкой) → `success:false`, в ошибке матрица, проблемный workspace и «Созданные клоны удалены»; в `list_tasks`, ОС и БД нет ни родителя, ни первого (успевшего создаться) клона, ни агрегатора, файлы wrapper/prompt удалены; позитивный контроль (3 клона + агрегатор, удаление родителя убирает семью) и RPC `get_tasks` согласованы — 23/23.
153
- - [x] **27.5.8 `update_task` не должен снимать паузу** — средняя — P1.
154
- - [x] Бессрочная пауза хранится в определении задачи (`paused: true`) и участвует в export/import; `pauseOrResumeTask` пишет/снимает флаг, `resumeExpiredPauses` его сбрасывает.
155
- - [x] После delete+create пауза восстанавливается через `pauseTask` (для матрицы — на клонах); ошибка снятия паузы не валит создание, а пишется в лог. `update_task`, `list_tasks` и RPC `get_tasks` отдают `paused` из определения, ОС или `pausedUntil`.
156
- - [x] Тест `s2755-8.mjs`: pause → update → пауза и `nextRun: null` (в ОС «Отключено»); resume → работает, `nextRun` задан; пауза с `until` переживает update; RPC совпадает — 30/30.
157
- - [x] **27.5.9 Переключатель режима входа в GUI** — лёгкая — P2.
158
- - [x] В сайдбар добавлен чекбокс «Запускать без входа пользователя» (виден только на Windows, по данным RPC `get_platform`); подсказка честно предупреждает про session 0, отсутствие профиля, сетевых дисков и сохранённых паролей и необходимость запуска от администратора. Флаг уходит в `create_task` и `update_task`, заполняется при редактировании, сбрасывается при создании/отмене и импортируется из `list_tasks`.
159
- - [x] В карточке задачи появился бейдж «🌙 без входа» с режимом планировщика из `logonMode` (при отсутствии — «неизвестен»); ключи добавлены в `locales/ru.json` и `locales/en.json`.
160
- - [x] Тест `s2755-9.mjs`: статические инварианты формы (чекбокс только для win32, привязка к сигналу, два payload-места, заполнение/сброс, бейдж), паритет локалей, создание с `false` → интерактивная задача, `update_task` с `true` без прав → отказ и `restored:true` с сохранением режима, `update_task` с `false` → успех, RPC `get_tasks` согласован — 20/20.
161
- - [x] **27.5.10 `runWhenLoggedOff` в экспорте/импорте задач** — лёгкая — P2.
162
- - [x] Поле добавлено в `buildExportJson` (`src/task-transfer.ts`): `runWhenLoggedOff: true` попадает в экспортный JSON.
163
- - [x] Поле добавлено в `parseImportJson` (`src/task-transfer.ts`): `source.runWhenLoggedOff === true` восстанавливается как флаг фоновой задачи.
164
- - [x] RPC `import_tasks` (`src/index.ts`) прокидывает `runWhenLoggedOff` и `paused` в `schedulerCreateTask` при восстановлении.
165
- - [x] Тест `s2755-10.mjs`: create без поля → `false`; export → ключ отсутствует; delete → import → восстановлена с `false`; create с `false` → export → import → `false`; RPC `get_tasks` совпадает с `list_tasks` — 17/17. Ветка `true` требует элевации (como 27.5.4/27.5.9).
166
- - [x] **27.5.11 Ранняя проверка длины имени** — лёгкая — P2.
167
- - [x] `validateTaskName` (`src/types.ts`) теперь отвергает имя длинее 209 символов (лимит schtasks /tn — 237 с учётом папки `\OpenCode\windows-scheduler\` = 28 символов) с понятной ошибкой, включая фактическую длину и максимум.
168
- - [x] Проверка срабатывает в `schedulerCreateTask` (`src/index.ts:4707`) ДО создания wrapper/prompt-файлов и записи в БД, поэтому длинное имя не оставляет хвостовых файлов.
169
- - [x] Тест `s2755-11.mjs`: обычное имя → success + файлы; имя 256 знаков → `success:false` с сообщением про длину, файлов не создано; граничное имя 100 → success; RPC не содержит невалидные имена — 12/12.
170
-
171
- **Вне объёма:** полный редизайн обёрток, переход на service/daemon (это спринт 37), автоматический перезапуск задач после входа.
172
-
173
- **Готово, когда:**
174
- - после удаления задач в `wrappers` не остаётся файлов, а старые накопленные файлы вычищены;
175
- - `nextRun` заполнен сразу после create/update во всех трёх интерфейсах;
176
- - нет ложных пустых списков после мутаций;
177
- - небезопасные имена (кавычки, метасимволы оболочки) отклоняются до записи в БД с понятной ошибкой; инъекция не выполняется, фантомных задач нет;
178
- - ограничение `Interactive only` задокументировано, `runWhenLoggedOff` доступен и выключен по умолчанию;
179
- - неудачный `update_task` не теряет задачу: прежняя версия восстанавливается из определения, ответ содержит `restored`;
180
- - `npm test` зелёный, `CHANGELOG.md` содержит hotfix 27.5 и i18n-спринт 28 в 1.5.1.
181
-
182
- **Риски:**
183
- - `/ru SYSTEM` не требует пароля, но даёт задачи в session 0 без профиля пользователя: предупреждать в UI/доках, не включать по умолчанию. Вариант `/ru <user> /rp` отклонён — пароль был бы виден в аргументах процесса и журнале schtasks.
184
- - Метасимволы оболочки в имени задачи (`& | < > ^ % " ' ; ( ) \``) отклонять на входе, не пытаться экранировать постфактум.
185
- - GC может удалить файл активного запуска: удалять только при отсутствии lock и записи `running`; при сомнении — пропускать и логировать.
186
-
187
- **Кросс-платформенная проверка (15.11.2026):** CI-прогон `43693823056` для коммита `b46ee25` — `windows-latest`, `ubuntu-latest`, `macos-latest`, Node 24: «Build backend» → «Build GUI» → «Test» (`npm test` = 33 сюиты) — все три job `success`, 10/10 шагов. Linux и macOS тем самым проверены без локальной машины. Локальный Docker на машине разработчика недоступен по причине окружения (в BIOS выключена виртуализация: `virtualizationFirmwareEnabled:false`, `HCS_E_HYPERV_NOT_INSTALLED`), к плагину отношения не имеет.
188
-
189
- ---
190
-
191
- ### Спринт 28 — i18n-фундамент (1.5.1, P1) — ЗАВЕРШЁН
192
-
193
- **Цель:** вынести все пользовательские строки в каталоги локалей, убрать русские литералы из кода, добавить тесты на существование ключей и эвристику «нет кириллицы вне каталога».
194
-
195
- **Задачи:**
196
-
197
- - [ ] **28.1 Каталог ключей в workspaces.ts и task-transfer.ts** — средняя.
198
- - [ ] Перенести строки `уже существует`, `Workspace … недоступен по пути`, `нельзя одновременно workspaceId и matrix.workspaceIds`, `matrix.workspaceIds не может быть пустым`, `пустой allowedTools запрещён` в `locales/ru.json` и `locales/en.json`.
199
- - [ ] Заменить литералы на вызовы `t(...)` с ключами.
200
- - [ ] Проверить паритет ru/en.
201
-
202
- - [ ] **28.2 Каталог ключей crash recovery, formatJobLog, дашборд** — средняя.
203
- - [ ] Перенести `Прервано (сбой/перезагрузка)`, `Лог пуст.`, `Скачать БД`, `БД: ✅ SQLite (WAL)` и прочие подписи дашборда в каталоги.
204
- - [ ] Заменить на `t(...)`.
205
- - [ ] Тест: EN-локаль не показывает русские строки.
206
-
207
- - [ ] **28.3 Две копии tool-логики в src/index.ts** — сложная.
208
- - [ ] Вынести общие обработчики и валидации инструментов из MCP-сервера и plugin/RPC в общий слой.
209
- - [ ] Убедиться, что ключи и поведение не расходятся.
210
- - [ ] Тест: оба интерфейса дают одинаковый результат для одного вызова.
211
-
212
- - [ ] **28.4 Русские runtime-метки в данных** — средняя.
213
- - [ ] reason триггеров (`изменение отслеживаемого файла`, `новый коммит …`), `lastError` планировщика, сравнение `s.includes("выполняется")` заменить на коды причин.
214
- - [ ] Перевод на отображении через каталог, сравнение статусов по коду, не по слову.
215
- - [ ] Тест: EN-локаль — коды, не русские строки в истории/дашборде.
216
-
217
- - [ ] **28.5 Тест на существование ключей t()** — лёгкая.
218
- - [ ] Статический тест: собрать ключи из `src/**` и сверить с `locales/ru.json` / `locales/en.json`.
219
- - [ ] Ловить опечатки в ключах.
220
- - [ ] Добавить в `npm test`.
221
-
222
- - [ ] **28.6 Резерв имени npm `opencode-pipeline`** — лёгкая — ❌ отменена в 1.5.6.
223
- - [ ] Заглушка удалена из репозитория, пакет депрекейчен; резерв имени вынесен в `agent-steward` (см. раздел «Немедленные действия»).
224
-
225
- - [ ] **28.7 Эвристика «нет кириллицы в пользовательских строках»** — лёгкая.
226
- - [ ] Скрипт или проверка в `test-docs`: кириллица вне комментариев, `console.*` и каталога → ошибка.
227
- - [ ] Запускать разовый скрипт по всему `src/`.
228
-
229
- - [ ] **28.8 Язык диагностик (console.*, startup)** — сложная.
230
- - [ ] Решить явно: логи на EN как часть кода или локализовать по настройке.
231
- - [ ] Привести startup-сообщения и `console.*` к выбранному языку.
232
- - [ ] Тест: диагностики не смешивают языки.
233
-
234
- - [ ] **28.9 Эвристика встроенных шаблонов (localizedTemplate)** — средняя.
235
- - [ ] Пользовательский шаблон, совпавший с дефолтом, не считать встроенным.
236
- - [ ] Хранить флаг `templatesCustomized` или считать пустое значение дефолтом.
237
- - [ ] Тест: пользовательский шаблон ≠ встроенный.
238
-
239
- - [ ] **28.10 Разделение src/index.ts на src/tools/*** — сложная.
240
- - [ ] При следующем касании разнести инструменты по `src/tools/*` (~6000 строк → модули).
241
- - [ ] Сохранить обратную совместимость экспортов.
242
- - [ ] Тест: все инструменты доступны после разделения.
243
-
244
- - [ ] **28.11 Замена склейки фраз на цельные шаблоны** — средняя.
245
- - [ ] `notify.reason` = `": {error}"`, `matrix.aggregate.stoppedFirst` с ведущим пробелом, `" до {date}"`, `" Ошибки: …"` — заменить на цельные шаблоны с плейсхолдерами.
246
- - [ ] Переводчик управляет порядком и puntuацией через ключи каталога.
247
- - [ ] Тест: EN-локаль — правильный порядок слов и пунктуация.
248
-
249
- **Готово, когда:** EN-локаль не показывает русские строки, все `t(...)` ключи существуют в обоих каталогах, нет кириллицы вне комментариев/каталога, `npm test` зелёный в ru и en.
250
-
251
- ---
252
-
253
- ### Спринт 29 — Security slice A (1.5.2, P1) — ЗАВЕРШЁН
254
-
255
- **Цель:** enforced `allowedTools`/`deniedTools`, scoped-инъекция секретов, аудит `tool.blocked`, регрессионные тесты.
256
-
257
- **Задачи:**
258
-
259
- - [ ] **29.1 Спайк по правам агента (2 дня)** — средняя — ✅ done.
260
- - [ ] См. `ARCHITECTURE.md`, раздел модели прав.
261
- - [ ] Утверждена схема enforced permissions.
262
-
263
- - [ ] **29.2 Аудит фиксирует политику, а не попытки** — средняя.
264
- - [ ] `tool.blocked` пишется при создании/обновлении задачи.
265
- - [ ] Если нужен журнал реальных попыток — добавить перехватчик в обёртку или разбирать лог `opencode`.
266
- - [ ] Тест: запись `tool.blocked` при нарушении политики.
267
-
268
- - [ ] **29.3 Проектный/системный конфиг может ослабить политику** — сложная.
269
- - [ ] `opencode.jsonc` и `policies` выше по приоритету; вложенные subagent-вызовы используют собственные права.
270
- - [ ] Проверить на реальном проекте с permissive-конфигом, зафиксировать поведение в тесте.
271
- - [ ] Тест: политика задачи не ослабляется системным конфигом.
272
-
273
- - [ ] **29.4 PowerShell: область видимости `$toolToAction`** — лёгкая.
274
- - [ ] Хэш-таблица объявлялась внутри `if ($DeniedTools)`, использовалась и в `allowedTools` — исправлено.
275
- - [ ] Регрессионный тест на `allowedTools` без `deniedTools`.
276
-
277
- - [ ] **29.5 `OPENCODE_CONFIG_CONTENT` — деталь реализации OpenCode** — лёгкая.
278
- - [ ] При обновлении CLI проверить поддержку переменной.
279
- - [ ] Текущий тест ловит только наличие строки в обёртке, не фактическое поведение `opencode`.
280
- - [ ] Дополнить тест фактической проверкой.
281
-
282
- - [ ] **29.6 Общие временные артефакты** — средняя.
283
- - [ ] Конфликт за `opencode.jsonc` устранён.
284
- - [ ] Проверить prompt/lock/логи при параллельных задачах в одном workdir.
285
- - [ ] Тест: параллельные задачи не перезаписывают артефакты друг друга.
286
-
287
- **Готово, когда:** enforced permissions работают, аудит `tool.blocked` пишется, регрессионные тесты зелёные, конфиг не ослабляет политику задачи.
288
-
289
- ---
290
-
291
- ### Спринт 30 — ⭐ Local assistant v1: триаж + shadow (1.5.3, P1) — ЗАВЕРШЁН
292
-
293
- **Все задачи закрыты:** 30.6, 30.7, 30.8, 30.9, 30.10 помечены `[x]`. Содержимое перенесено в CHANGELOG `[1.5.3]`.
294
-
295
- **Цель:** меньше шума в уведомлениях без потери важного. Работает даже без локальной модели.
296
-
297
- **Задачи:**
298
-
299
- **Сделано в спринте:** 30.1 (спайк локальной модели, 10/10 схема-валидных ответов), 30.2 (схема настроек триажа), 30.3 (LLM-классификатор), 30.4 (Rules-движок), 30.5 (цепочка деградации) и 30.6 (shadow-режим) закрыты и перенесены в CHANGELOG `[Unreleased]`; здесь остаются только незакрытые задачи.
300
-
301
- - [x] **30.6 Shadow mode** — средняя.
302
- - [x] Вердикты только в лог, по умолчанию 14 дней.
303
- - [x] Отчёт: false-skip и сколько уведомлений было бы подавлено.
304
- - [x] Индикатор shadow в GUI.
305
- - [x] **30.7 `manage_local_ai` + GUI** — средняя.
306
- - [x] Инструмент get/update настроек.
307
- - [x] Минимальный блок настроек в GUI.
308
- - [x] Тест схемы инструмента.
309
- - [x] **30.8 `scripts/bench-local.mjs` v1** — средняя.
310
- - [x] Замер tok/s и подбор тира по RAM.
311
- - [x] Версионированный JSON-формат под краудсорсинг.
312
- - [x] Прогон на 16 ГБ CPU-машине.
313
- - [x] **30.9 Рецепт локальной модели** — лёгкая: `references/recipes.md` + docs — модель, запуск, troubleshooting `OLLAMA_CONTEXT_LENGTH`. Закрыто: `docs/LOCAL-AI.md` + рецепт 8 в `skills/scheduled-job-best-practices/references/recipes.md`.
314
- - [x] **30.10 Документация/CHANGELOG** — лёгкая: настройки триажа, fail-open и ограничения; CHANGELOG 1.5.3. Закрыто: `docs/FEATURES.md`, `docs/README.ru.md`, CHANGELOG, версия 1.5.3.
315
-
316
- **Вне объёма:** эмбеддинги, дедуп, саммари, wizard, счётчик экономии (спринт 31).
317
-
318
- **Готово, когда:**
319
- - Ollama недоступна → работают правила, уведомления **никогда** не блокируются (тест на таймаут и на отказ соединения);
320
- - shadow-отчёт показывает false-skip и подавленные уведомления;
321
- - ответ модели валидируется по схеме, при невалидном JSON — fallback на правила;
322
- - bench выдаёт стабильный JSON на 16 ГБ CPU-машине;
323
- - порог уверенности настраивается и покрыт тестом.
324
-
325
- **Формулировка приёмки (важно):** не «первое саммари < 10 минут после установки» — это зависит от скорости скачивания модели и не контролируется нами. Вместо этого: «установка и работа планировщика не ухудшаются, если локальной модели нет».
326
-
327
- ---
328
-
329
- ### 🔧 Hotfix 1.5.4 — Исправление выполнения задач (16.11.2026)
330
-
331
- **Версия:** 1.5.4
332
- **Приоритет:** P1
333
- **Статус:** реализован, тесты 21/21
334
-
335
- **Что исправлено:**
336
- 1. **Реальный таймаут задач** — `timeoutSeconds` теперь применяется в wrapper `.cmd` через watchdog `Start-Job` + `taskkill /T /PID`. Превышение лимита задаёт статус `timeout` (ранее задача дорабатывала полностью и получала `success`).
337
- 2. **Блокировка на уровне wrapper** — wrapper аккуратно захватывает lock-файл через `[System.IO.File]::Open(..., CreateNew)` перед запуском. Если задача уже запущена, повторный wrapper пропускается с кодом 0 и без записи истории (раньше два wrapper-а могли запуститься одновременно и сравниться на лог-файле).
338
- 3. **Повторные попытки** — `retryCount` и `retryDelaySeconds` теперь enforce-ятся в wrapper (1 + retryCount попыток с задержкой между ними).
339
- 4. **Экранирование кавычек в хуках** — before/after/gate-скрипты выносятся во временные `.cmd` файлы через `writeHookFile`, поэтому кавычки в путях больше не ломают single-line вызов PowerShell.
340
- 5. **Фикс `record-history --finish`** — `$errorArg` передаётся quoted (по умолчанию `-`), предотвращая off-by-one сдвиг аргументов при пустом сообщении об ошибке (раньше `model` получал значение `preFlightStatus`, а `postFlightStatus` терялся).
341
- 6. **`timeoutSeconds` в `list_tasks`** — поле теперь присутствует в task view, агенту виден таймаут задачи.
342
-
343
- **Регрессионный тест:** `test-execution-hardening.mjs` (21 проверка), добавлен в `npm test`.
344
-
345
- ---
346
-
347
- ### Спринт 31 — Local assistant v2 (1.5.5, P2)
348
-
349
- **Порядок выполнения (решение 16.11.2026).** Список задач ниже — состав спринта, а не очередь: идём по зависимостям и боли, а не по номерам. 31.15–31.18 вынесены в отдельный спайк 31.A, потому что плагин не управляет выбором модели OpenCode напрямую и эти задачи делают релиз незакрываемым.
350
-
351
- 1. **31.8 → 31.7** — сначала persistent-аудит решений, затем асинхронный триаж. Без журнала нельзя проверить shadow и собрать корпус; без 31.7 модель продолжает задерживать доставку на 20–45 с.
352
- 2. **31.10 → 31.11 → 31.13** — таймаут 60 с, переименование `fallback`, статус подключения в GUI. Дёшево и снимает самые частые ошибки настройки.
353
- 3. **31.12 → 31.9** — отдельная сюита настроек и расширение встроенных правил (`cost` уже поддержан движком, нужны примеры и тесты).
354
- 4. **31.2 → 31.1** — сначала дедуп по правилам/тексту со счётчиком, эмбеддинги только после накопления корпуса shadow.
355
- 5. **31.3 → 31.5 → 31.6** — саммари логов, сравнение «до/после», счётчик экономии.
356
- 6. **31.4** — wizard последним: он собирает все настройки, включая переименованный fallback и новые поля.
357
- 7. **31.14** — стабилизация test-dag выполняется в любой момент как гигиена.
358
-
359
- **Найденные несоответствия:**
360
- - 1.5.4 уже выпущен как hotfix, поэтому Sprint 31 перенесён на 1.5.5; версии 32–37 сдвинуты на 1.5.6–1.5.11, 1.6.0 остаётся за 38.
361
- - 17.11.2026: 1.5.6 занят внеплановой поддержкой OpenCode v1 + v2 (Спринт 31A), поэтому версии 32–37 сдвинуты ещё на один шаг — 1.5.7–1.5.12; 1.6.0 остаётся за 38.
362
- - LLM-триаж **не подавляет** уведомления: при валидном вердикте `decideTriage` всегда возвращает `notify`, подавляют только правила. Документация обещает обратное — исправить в 31.7/31.11.
363
- - Shadow-журнал сейчас в памяти процесса `record-history`, поэтому в реальной эксплуатации отчёт пуст. Это не только «аудит», а предусловие для 31.1/31.2.
364
- - 31.9: поля `cost`/`task` и операторы сравнения уже были в схеме и движке; встроенные правила, примеры и тест добавлены.
365
-
366
- **Задачи:**
367
-
368
- - [x] **31.1 Эмбеддинги для дедупа** — сложная. (16.11.2026)
369
- - [x] Клиент эмбеддингов: локальный детерминированный векторизатор (нормализованный bag-of-words) вместо внешней модели — без новых зависимостей и без обязательной Ollama; внешний провайдер остаётся опцией на будущее.
370
- - [x] Таблица векторов в SQLite: `notification_embeddings` (`embedding_json`, `dimension`, окно, индексы).
371
- - [x] Косинус брутфорсом и порог похожести: `notifications.embedding.threshold` (0.85), `maxVectors` с очисткой старых.
372
- - [x] Тест: `test-notifications-embedding.mjs`, 6 проверок (похожее подавляется, разное доставляется, важные статусы не подавляются, выключенный дедуп).
373
- - Примечание: отдельного «корпуса shadow» в тестах нет — поведение проверено фиксированными парами сообщений; накопление корпуса остаётся эксплуатационной задачей.
374
- - [x] **31.2 Дедуп со счётчиком** — средняя. (16.11.2026)
375
- - [x] Группировка похожих уведомлений: `notifications.dedup` (окно `windowMinutes`, ключ «задача + статус», таблица `notification_dedup`).
376
- - [x] Счётчик повторов в сообщении: локализованный суффикс `(повтор N)`, `maxCount`.
377
- - [x] Тест: важные уведомления не подавляются — `importantStatuses` (`error`/`timeout`) доставляются всегда; `test-notifications-dedup.mjs`, 14 проверок.
378
- - Примечание: отдельной GUI-панели нет (задачей не требовалась); настраивается через `manage_settings` → `notifications.dedup`, GUI-сохранение поле не теряет.
379
- - [x] **31.3 Саммари логов** — средняя. (16.11.2026)
380
- - [x] Три строки для Telegram и тостов: `notifications.summary` + `src/core/summary.ts`.
381
- - [x] Structured output + валидация: строгая JSON-схема `{"lines": [...]}`, 1..3 строки, каждая ≤ `maxCharsPerLine`.
382
- - [x] Fallback на усечение при отказе модели: детерминированные строки (задача/статус, ошибка, время/токены/стоимость); `test-notifications-summary.mjs`, 9 проверок.
383
- - Примечание: отдельного файла лога у задачи нет — саммари строится по payload уведомления (задача, статус, текст ошибки, время, токены, стоимость).
384
- - [x] **31.4 GUI wizard** — сложная. (16.11.2026)
385
- - [x] Три экрана настройки (модель, пресет, порядок правил).
386
- - [x] Карточки моделей с последствиями отказа.
387
- - [x] Пресеты Minimal/Recommended.
388
- - [x] Предпросмотр приоритета и порядка правил триажа.
389
- - [x] Пояснение confidenceThreshold в GUI («порог перехода к правилам», не «фильтр уведомлений»).
390
- - [x] Проверка: wizard проходится без документации.
391
- - [x] Кнопка «Мастер настройки триажа» в панели «Локальный ассистент»; i18n ключи в ru/en локалях.
392
- - [x] **31.5 Кнопка «Сравнить»** — средняя. (16.11.2026)
393
- - [x] Before/after на одном событии: `compareTriage` в `src/core/triage-compare.ts`.
394
- - [x] RPC-метод `compare_triage` + схемы в `src/rpc.ts`, обработчик в `src/index.ts`.
395
- - [x] Рендер diff вердиктов, правил, уверенности, категории, причин и сообщений.
396
- - [x] Тест: `test-triage-compare.mjs`, 17 проверок (подавление правила, fallback llm, одинаковые настройки без diff).
397
- - [x] **31.6 Счётчик «сэкономлено $»** — средняя. (16.11.2026)
398
- - [x] Расчёт контрфактики по истории: `src/core/savings.ts`, `report.savings` в `buildAnalytics`.
399
- - [x] Пометка «оценка» и ссылка на методику `docs/SAVINGS.md` (+ KPI на дашборде).
400
- - [x] Тест методики на фиксированных данных: `test-savings.mjs`, 14 проверок.
401
- - [x] **31.7 Асинхронный триаж (убрать задержку 20–45 с)** — сложная. *(16.11.2026)*
402
- - [x] `notifyTaskCompletion` не блокирует доставку: в `llm`/`auto` уведомление уходит сразу, вердикт считает detached-процесс `src/core/triage-worker.ts` и пишет в аудит с `async: true`.
403
- - [x] GUI предупреждает: в `llm`/`auto` решение модели рекомендательное, подавляют только правила в режиме `rules`.
404
- - [x] `test-triage-async.mjs` — 32 проверки: доставка при «медленной» модели, реальный фоновый процесс, redaction, spawn-ошибки.
405
- - [x] **31.8 Постоянный аудит решений триажа** — средняя. *(16.11.2026)*
406
- - [x] `decideTriage` возвращает `source`, `failure`, `ruleId`, латентность.
407
- - [x] Решения пишутся в persistent журнал аудита (не только shadow) — `audit_log`, action `triage.decision`.
408
- - [x] Отчёт доступен через `rpc.get_shadow_report` и `get_audit_log`; shadow-отчёт читает SQLite, сброс удаляет только shadow-записи.
409
- - [x] `test-triage-audit.mjs` — 27 проверок, включая reopen БД, окно периода, redaction и интеграцию с доставкой.
410
- - [x] **31.9 Расширение встроенных правил** — средняя. *(16.11.2026)*
411
- - [x] Правила для стоимости и имени задачи (не только статус/текст ошибки): `cost-high` (≥ 1 USD) и `task-important` (deploy/release/backup/migration), оба notify-only.
412
- - [x] Готовые примеры в GUI и документации: подсказка `localAi.rulesHint`, таблица встроенных правил и JSON-пример в `docs/LOCAL-AI.md`.
413
- - [x] Тест: правило по стоимости и по имени срабатывает; `test-triage-rules.mjs` — 17 проверок.
414
- - [x] **31.10 Таймаут триажа 60 с вместо 45 с** — лёгкая. *(16.11.2026)*
415
- - [x] Дефолтный `timeoutMs` поднят до 60 с: холодный старт Qwen3-4B в спайке ~42 с, прежние 45 с не давали запаса.
416
- - [x] В `llm`/`auto` таймаут относится к фоновому запросу (31.7) и не задерживает доставку; в `rules` сети нет.
417
- - [x] `test-notifications-v2.mjs` проверяет дефолт 60 000 мс; асинхронный воркер покрыт `test-triage-async.mjs`.
418
- - [x] **31.11 Переименование fallback:'skip'** — лёгкая. (16.11.2026)
419
- - [x] `fallback: "skip"` → `rules`/`notify` (текущее название легко понять наоборот).
420
- - [x] Обновлены схема `manage_local_ai`, RPC, нормализация `settings.json`, GUI и документация.
421
- - [x] Тест: `fallback: "notify"` и старое `"skip"` работают; legacy-значение превращается в `notify`.
422
- - [x] **31.12 Отдельная сюита настроек (test-settings.mjs)** — лёгкая. *(16.11.2026)*
423
- - [x] Вынести проверки триажа из `test-notifications-v2.mjs` в `test-settings.mjs` — 12 проверок.
424
- - [x] Добавить тест OpenAI-совместимой ветки с реальным провайдером (strict-схема, `json_schema`) — ветка усилена в `test-triage.mjs` (24 проверки).
425
- - [x] Тест: схема настроек валидируется, невалидный JSON → fallback — `test-settings.mjs` + `test-triage-chain.mjs`.
426
- - [x] Документировать семантику `rules`: `undefined` = встроенные правила, `[]` = ничего (la6).
427
- - [x] **31.13 Статус подключения baseUrl в GUI** — лёгкая. *(16.11.2026)*
428
- - [x] GUI показывает статус подключения к Ollama/OpenAI-совместимому провайдеру.
429
- - [x] Пользователь видит проблему не только из лога.
430
- - [x] Тест: статус отображается при недоступности Ollama.
431
- - [x] **31.14 Стабилизация test-dag.mjs (ci1)** — лёгкая. *(16.11.2026)*
432
- - [x] Убрать гонку по времени/общему состоянию (фиксированные таймстампы, уникальная temp-папка, не relied на wall-clock).
433
- - [x] Прогон 5 раз подряд — стабильно зелёный (12/12 проверок каждый раз).
434
- - [x] Тест: полный `npm test` проходит без флаков (EXIT=0, `test-full-after-31.14.log`).
435
-
436
- **Готово, когда:** дедуп не подавляет важные уведомления (проверено на корпусе из shadow-периода); wizard проходится без документации; счётчик объясняет методику; триаж не блокирует уведомления; решения триажа в persistent-аудите; настройки имеют отдельную сюиту тестов; test-dag.mjs стабилен.
437
-
438
- ---
439
-
440
- ### Спайк 31.A — маршрутизация local/cloud (вне релиза 1.5.5)
441
-
442
- Перенесено из спринта 31, чтобы не делать релиз незакрываемым. Сначала спайк: может ли плагин выбирать модель OpenCode для конкретной задачи (per-task config / provider routing), и только потом задачи 31.15–31.18. До результата спайка в релизы не входит.
443
-
444
- - [ ] **31.15 Маршрутизатор задач в пользу локальной модели** — сложная.
445
- - [ ] Классификатор сложности: лёгкая (локальная модель) vs сложная (облачная модель) — по длине промпта, ключевым словам, наличию кода/математики, контексту.
446
- - [ ] Динамическая маршрутизация: оркестратор отправляет лёгкие задачи на локальную модель, сложные — на облачную; логирует решение.
447
- - [ ] Fallback локально→облачно: при ошибке локальной модели или низкой confidence — перепробрасывает задачу в облако.
448
- - [ ] Прямой вызов локальной модели: обход оркестратора для выбранных задач (настраивается в manage_settings).
449
- - [ ] Спайк: проверить per-task model config OpenCode и прямой вызов; зафиксировать ограничения.
450
-
451
- - [ ] **31.16 Учёт и отслеживание токенов** — средняя.
452
- - [ ] Счётчик токенов: раздельный подсчёт входящих/исходящих у локальной и облачной модели.
453
- - [ ] Метрика экономии: сколько токенов сэкономлено за счёт локальной модели vs облачной.
454
- - [ ] Дашборд экономии: карточка — % задач на локальной модели, токенов сэкономлено, оценочная стоимость.
455
-
456
- - [ ] **31.17 Оптимизация локальной модели** — средняя.
457
- - [ ] Кэширование ответов: кэш ответов локальной модели на повторяющиеся лёгкие задачи (без повторного вызова).
458
- - [ ] Сжатие промпта: укорочение промпта перед отправкой в локальную модель (убрать лишнее, оставить суть).
459
- - [ ] Прогрев модели: поддержание локальной модели в активном состоянии, уменьшение cold start.
460
- - [ ] Параметры генерации: оптимизация temperature/seed для лёгких задач.
461
- - [ ] Выбор модели по сложности: подбор qwen3:0.6b / 1.7b / 4b под тип задачи.
462
-
463
- - [ ] **31.18 GUI панель оркестрации и управление** — средняя.
464
- - [ ] Панель оркестрации: переключатель режима «только локальная / только облачная / авто-маршрутизация».
465
- - [ ] Порог сложности: настройка пользователем границы ухода задачи в облако.
466
- - [ ] История маршрутизации: в логах видно задача → локальная/облачная → результат → токены.
14
+ ## 1. Начальная точка (milestone Д7 — agent-steward 0.0.2)
467
15
 
468
- ---
469
-
470
- ### Спринт 31A — OpenCode v1 + v2 в одном пакете (1.5.6, P1, внеплановый)
16
+ ### Что сделано
471
17
 
472
- Внеплановый спринт: пользователи на OpenCode v1 не могли установить пакет, потому
473
- что он был только v2. Полный план — `docs/V1-V2-COMPATIBILITY-PLAN.md` (детали
474
- Д1–Д6), контракт версий — `docs/COMPATIBILITY.md` (V1 от `1.18.29`, V2 от `2.2.7`).
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.
475
22
 
476
- **Задачи:**
23
+ ### Что в приоритете прямо сейчас
477
24
 
478
- - [x] **31A.1 Контракт версий** — лёгкая: минимум V1 `1.18.29` и V2 `2.2.7` зафиксированы в `docs/COMPATIBILITY.md`, проверяются в `test-docs`.
479
- - [x] Матрица версий и обоснование минимумов.
480
- - [x] Границы поверхности V1: нет GUI и RPC, TUI — отдельный entrypoint.
481
- - [x] Инварианты состояния: plugin id, пути `%APPDATA%/opencode/windows-scheduler`, SQLite, логи, префикс задач не меняются.
482
- - [x] **31A.2 Извлечение общего ядра** — выполнено: `createRuntime(ctxLike)`, общий реестр 26 инструментов, общие хуки, единый shutdown. Зафиксировано в коммитах Д2 (9b252c5, fc739e2, 3cfe0e4, 9fe4add, bc7c8f2).
483
- - [ ] **31A.3 V1-адаптер** — сложная: `export default { ...Plugin.define(...), async server() }`, `tool()`-обёртка, строковые хуки, `src/tui-v1.tsx`.
484
- - [ ] **31A.4 Регрессия V2** — средняя: `setup`, GUI и RPC не затронуты, 61 сюита зелёная.
485
- - [ ] **31A.5 Тесты совместимости и CI** — средняя: unit на форму экспорта, стенды V1 `1.19.5` и V2 `2.2.7`/`2.3.0`, jobs `compat-v1` и `compat-v2`.
486
- - [ ] **31A.6 Документация и релиз 1.5.6** — средняя: README («V1 >=1.18.29 или V2»), CHANGELOG, тег `v1.5.6`, GitHub Release.
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** (идемпотентные ключи шагов).
487
26
 
488
- **Готово, когда:** один и тот же пакет ставится и работает в OpenCode `1.19.x`
489
- (инструменты, хуки, TUI, dashboard) и в `2.x` (плюс GUI и RPC), V2-регрессия
490
- зелёная, контракт версий и различия поверхностей описаны в документации.
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-ядра; номера версий — по факту релиза |
491
33
 
492
34
  ---
493
35
 
494
- ### Спринт 32 — Pipeline-as-code (1.5.7, P2)
36
+ ## 2. Четыре столпа (north star, CONCEPT §4)
495
37
 
496
- **Задачи:**
38
+ Любая фича / ADR сверяется с ними. При конфликте порядок: **надёжно > приватно > дёшево > краткосрочные фичи**.
497
39
 
498
- - [ ] **32.1 Формат pipeline-файла** — сложная.
499
- - [ ] `opencode.pipeline.yaml` или JSON-совместимый подформат без новых зависимостей.
500
- - [ ] JSON-схема и пример.
501
- - [ ] Парсер с ошибками и номерами строк.
502
- - [ ] **32.2 CLI** — сложная.
503
- - [ ] `validate` с кодами возврата.
504
- - [ ] `run` без открытого OpenCode и без расписаний.
505
- - [ ] `export` и `diff`.
506
- - [ ] `--help` и читаемые ошибки.
507
- - [ ] **32.3 Drift-детект** — средняя.
508
- - [ ] Сравнение файл ↔ БД.
509
- - [ ] Конфликты в лог и историю.
510
- - [ ] Явные стратегии применения.
511
- - [ ] **32.4 DAG и матрицы из файла** — средняя.
512
- - [ ] `dependsOn`, `qualityGate`, `matrix` в файле.
513
- - [ ] Round-trip export/import без потерь.
514
- - [ ] **32.5 Тесты и спецификация** — средняя.
515
- - [ ] Тесты парсера, CLI и drift.
516
- - [ ] Спецификация формата в docs.
517
- - [ ] **32.6 Документация** — лёгкая: README/ARCHITECTURE и CHANGELOG 1.5.5.
518
-
519
- **Готово, когда:** пайплайн из репозитория запускается одной командой без расписаний и без открытого OpenCode; спецификация покрыта тестом и документацией.
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-библиотеки |
520
46
 
521
47
  ---
522
48
 
523
- ### Спринт 33 — Worktree-изоляция + guards (1.5.8, P2)
524
-
525
- **Задачи:**
49
+ ## 3. Исполнительный цикл (CONCEPT §6)
526
50
 
527
- - [ ] **33.1 Worktree на запуск** — сложная.
528
- - [ ] Одноразовый `git worktree` на запуск.
529
- - [ ] Политика очистки после успеха и ошибки.
530
- - [ ] Защита незакоммиченных изменений.
531
- - [ ] Снятие lock-файлов после краша.
532
- - [ ] Тест: два клона матрицы на одном репозитории не конфликтуют.
533
- - [ ] **33.2 Guard по exit-коду** — средняя.
534
- - [ ] Shell-команда как условие запуска.
535
- - [ ] Код возврата и причина в истории.
536
- - [ ] **33.3 Семантический `guardPrompt`** — средняя.
537
- - [ ] Проверка через локальный тир.
538
- - [ ] Shadow-проверка перед включением.
539
- - [ ] **33.4 Статус `skipped`** — средняя.
540
- - [ ] Новый статус и причина в dry-run и GUI.
541
- - [ ] **33.5 Тесты** — средняя.
542
- - [ ] git/glob/окна/guard вместе, включая Windows.
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
+ ```
543
70
 
544
- **Готово, когда:** два клона матрицы на одном репозитории не конфликтуют; семантический guard прошёл shadow-проверку; тесты на git/glob/окна/guard.
545
-
546
- **Почему раньше Docker:** worktree даёт 80% ценности «безопасный параллельный fan-out на одном репо» без инфраструктуры и без проблем Windows-CI.
71
+ GATE — keystone (§5 CONCEPT): никогда «готово» на слово агента. Провал → эскалация / ретрай / откат.
547
72
 
548
73
  ---
549
74
 
550
- ### Спринт 34 — Экономика v2 (1.5.9, P2)
551
-
552
- **Задачи:**
75
+ ## 4. Карта спринтов
553
76
 
554
- - [ ] **34.1 Бюджеты** — сложная.
555
- - [ ] Дневной и недельный лимит стоимости.
556
- - [ ] Авто-пауза очереди и алерт.
557
- - [ ] Per-task token budgets.
558
- - [ ] Возобновление после лимита.
559
- - [ ] Тесты паузы и возобновления.
560
- - [ ] **34.2 Token efficiency + прогноз + Grafana** — средняя.
561
- - [ ] Token efficiency score.
562
- - [ ] Прогноз стоимости по скользящему среднему.
563
- - [ ] Grafana dashboard JSON.
564
- - [ ] **34.3 Аналитика local vs cloud** — средняя.
565
- - [ ] Разделение запусков и стоимости по тиру модели.
566
- - [ ] **34.4 Tier-router v1 (advisory)** — средняя.
567
- - [ ] GUI предлагает тир по истории задачи.
568
- - [ ] Без автоматического переключения модели.
569
- - [ ] **34.5 Бюджетный приоритет и дешёвые окна** — средняя.
570
- - [ ] Класс задачи `priority: urgent | normal | batch` (или budget-класс).
571
- - [ ] Batch-задачи автоматически сдвигаются в дешёвое окно (например, 02:00–06:00).
572
- - [ ] Urgent-задачи не ждут окна; конфликт с `activeDays`/`notBefore` решается явно.
573
- - [ ] Тест: batch ждёт окна, urgent запускается сразу, лимит бюджета останавливает очередь.
574
- - [ ] «Выкуп времени» у ожидающих задач **не делаем** в 1.x — слишком сложная модель приоритетов.
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 |
575
93
 
576
- **Готово, когда:** лимит исчерпан → очередь встала и пришёл алерт; возобновление работает; аналитика разделяет local/cloud; batch-задачи уходят в дешёвое окно; тесты на паузу/возобновление и приоритеты.
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).
577
95
 
578
96
  ---
579
97
 
580
- ### Спринт 35 — Docker runner (1.5.10, P3)
98
+ ### Ревизия роадмапа — 17.11.2026
581
99
 
582
- **Задачи:**
583
-
584
- - [ ] **35.1 Runner-абстракция** — сложная.
585
- - [ ] `local | docker` без изменения поведения по умолчанию.
586
- - [ ] Общий интерфейс для хуков, Quality Gate, истории и метрик.
587
- - [ ] **35.2 Docker-раннер** — сложная.
588
- - [ ] Образ.
589
- - [ ] Монтирование workspace.
590
- - [ ] Лимиты CPU/RAM.
591
- - [ ] Сеть off по умолчанию.
592
- - [ ] Хуки и Quality Gate внутри контейнера.
593
- - [ ] **35.3 Opt-in настройка** — лёгкая: по умолчанию выключен; понятная ошибка без Docker.
594
- - [ ] **35.4 Тесты** — средняя.
595
- - [ ] Docker-тесты только на Linux-раннере, opt-in.
100
+ Сверка роадмапа с фактическим состоянием репозитория (`CHANGELOG.md` 1.5.1–1.5.6, `locales/`, `src/core/permissions.ts`, git-log):
596
101
 
597
- **Готово, когда:** задача в контейнере проходит те же хуки, Quality Gate, историю и метрики, что и локально.
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) |
598
109
 
599
- **Вне объёма:** 24-часовой soak и chaos-тесты — это **nightly workflow**, отдельно от релиза.
110
+ **Правило итерации:** берём одну подзадачу → выполняем → отчёт; найденные улучшения/фиксы сразу дописываются в ближайший спринт этого роадмапа.
600
111
 
601
112
  ---
602
113
 
603
- ### Спринт 36 — Durable DAG (1.5.11, P1 для 1.6.0)
114
+ ## 5. Спринт 36 — Durable DAG + роутер (0.0.3, P1 для 0.1.0)
604
115
 
605
- **Цель:** пережить краш посреди прогона.
116
+ **Цель:** пережить крах посреди прогона + реализовать трёхслойный роутер исполнения (CONCEPT §5 capability-aware роутинг).
606
117
 
607
118
  **Задачи:**
608
119
 
609
- - [ ] **36.1 Персистентная state-машина** — сложная.
610
- - [ ] Схема шага: шаг → статус → попытка.
611
- - [ ] Запись состояния на каждом переходе.
612
- - [ ] **36.2 Resume с середины** — сложная.
613
- - [ ] Продолжение с того же шага после краша.
614
- - [ ] Тест: `kill -9` посреди линейной цепочки.
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` посреди линейной цепочки.
615
128
  - [ ] **36.3 Идемпотентные ключи шагов** — сложная.
616
129
  - [ ] Ключ шага и защита от дублей побочных эффектов.
617
130
  - [ ] Тест повторного запуска шага.
618
131
  - [ ] **36.4 DLQ** — средняя.
619
132
  - [ ] Очередь окончательно упавших шагов.
620
133
  - [ ] Ручной retry из DLQ.
134
+ - [ ] **36.5.X Реализация роутера** — сложная.
135
+ - [ ] Слой 1: статические правила для горячего пути (таблица соответствий типа задачи → транспорт + исполнитель, 0 токенов, мгновенно).
136
+ - [ ] Слой 2: Capability Map в SQLite (тип задачи → модель / success_rate / средняя стоимость / среднее время / последние 10 запусков; обучается на исходах гейта, 0 токенов, быстро).
137
+ - [ ] Слой 3: локальная модель только для декомпозиции миссии и разрешения неоднозначности (не для маршрутизации каждого шага).
138
+ - [ ] Эскалация при провале гейта — по правилу, без участия модели.
139
+ - [ ] Тест: маршрутизация без вызова модели для известных типов задач.
621
140
  - [ ] **36.5 Chaos-тест nightly** — средняя.
622
141
  - [ ] `kill -9` посреди DAG в nightly workflow.
623
142
  - [ ] **36.6 DLQ в GUI** — средняя.
624
143
  - [ ] Список, причина, retry.
625
144
  - [ ] **36.7 Пауза с инъекцией контекста** — средняя.
626
- - [ ] На паузе можно оставить комментарий/файл/структурированный артефакт.
627
- - [ ] При resume следующий шаг получает вставку как контекст (через артефакты спринта 40).
145
+ - [ ] На паузе можно оставить комментарий / файл / структурированный артефакт.
146
+ - [ ] При resume следующий шаг получает вставку как контекст.
628
147
  - [ ] Комментарий и автор видны в истории; секреты маскируются.
629
- - [ ] Тест: resume без комментария не меняет поведение; с комментарием — меняет вход следующего шага.
630
148
  - [ ] **36.8 Пауза и resume в GUI/Telegram** — средняя.
631
149
  - [ ] Кнопки pause/resume, поле комментария, ссылка на текущий шаг.
632
- - [ ] Явное предупреждение, если шаг уже выполняется.
633
-
634
- **Готово, когда:** `kill -9` посреди DAG → продолжение с того же шага; повторный запуск шага не дублирует побочные эффекты; DLQ видна в GUI; пауза с комментарием доходит до следующего шага.
635
-
636
- **Почему отдельно:** это самое сложное изменение ядра за весь план. Оно трогает цикл запуска, схему истории и планировщик. Смешивать его с переименованием нельзя.
637
-
638
- ---
639
-
640
- ### Спринт 37 — Rename-only + daemon + config v2 (1.5.12 → 1.6.0-rc, P2)
641
-
642
- **Задачи:**
643
-
644
- - [ ] **37.1 Rename-only** — сложная.
645
- - [ ] Публикация `agent-steward` как тонкого re-export поверх текущего пакета.
646
- - [ ] GitHub-переименование с редиректами.
647
- - [ ] Trusted publishing на новый пакет.
648
- - [ ] Старый пакет остаётся живым и получает патчи; `npm deprecate` — только после сопоставимых загрузок.
649
- - [ ] **37.2 Scheduler daemon** — сложная.
650
- - [ ] `scheduler.backend: native | daemon | off | auto`.
651
- - [ ] daemon: systemd user / launchd agent / Windows-сервис.
652
- - [ ] Catch-up политика после простоя.
653
- - [ ] `off` = чистый событийный оркестратор.
654
- - [ ] **37.3 Config v2** — сложная.
655
- - [ ] Автомиграция настроек.
656
- - [ ] `OPENCODE_PIPELINE_*` с fallback на старый префикс.
657
- - [ ] Migration guide, проверенный на реальном старом экспорте.
658
- - [ ] **37.4 Regression-прогон** — средняя.
659
- - [ ] Все сюиты на старом и новом пакете.
660
- - [ ] Smoke-установка старого пакета через обёртку.
661
-
662
- **Готово, когда:** старый пакет работает через обёртку; `off`-режим живёт только на событиях; миграция проверена на старом экспорте; ни одна фича не сломана переименованием.
663
-
664
- ---
665
-
666
- ### Спринт 38 — 1.6.0: Approvals & environments (MAJOR)
667
-
668
- **Задачи:**
669
-
670
- - [ ] **38.1 Approvals** — сложная.
671
- - [ ] Ручное подтверждение в GUI и Telegram.
672
- - [ ] Варианты ответа: «Да», «Да, с правками» (поле ввода), «Нет, дай summary», «Передать ревьюеру».
673
- - [ ] Продвижение dev → staging → prod.
674
- - [ ] Блокировка prod-деплоя без подтверждения.
675
- - [ ] Таймаут и политика `fail-closed`; аудит решения и автора.
676
- - [ ] Тест: таймаут подтверждения не запускает prod; «Да, с правками» меняет вход следующего шага.
677
- - [ ] **38.2 Артефакты запуска** — средняя.
678
- - [ ] Сохранение и ссылки на артефакты в истории.
679
- - [ ] **38.3 Docs-сайт** — сложная.
680
- - [ ] Генератор и хостинг.
681
- - [ ] Навигация и поиск.
682
- - [ ] 4 локали (en/ru/zh/tr) с паритетом ключей.
683
- - [ ] **38.4 ZH/TR черновики + CODEOWNERS** — средняя.
684
- - [ ] Черновики через локальную модель.
685
- - [ ] CODEOWNERS на locale-файлы.
686
- - [ ] Good-first-issues для носителей языка.
687
- - [ ] **38.5 Release checklist + migration** — средняя.
688
- - [ ] Проверка migration guide на старом экспорте.
689
- - [ ] Финальный прогон всех сюит и docs-тестов.
150
+ - [ ] Предупреждение, если шаг уже выполняется.
690
151
 
691
- **Готово, когда:** краш посреди DAG → resume; `off`-режим работает; 4 локали зелёные; migration guide проверен; approvals блокируют prod-деплой без подтверждения.
152
+ **Готово, когда:** `kill -9` посреди DAG → продолжение с того же шага; повторный запуск шага не дублирует побочные эффекты; DLQ видна в GUI; роутер маршрутизирует известные типы задач без вызова модели; пауза с комментарием доходит до следующего шага.
692
153
 
693
154
  ---
694
155
 
695
- ### Спринт 39 — Запуск и сообщество (1.6.x)
696
-
697
- **Задачи:**
698
-
699
- - [ ] **39.1 EN-волна** — лёгкая: HN/Reddit и PR в ecosystem opencode.ai.
700
- - [ ] **39.2 RU-волна** — лёгкая: Habr/Pikabu.
701
- - [ ] **39.3 ZH-волна** — лёгкая: juejin/V2EX.
702
- - [ ] **39.4 TR-волна** — лёгкая: профильные сообщества и перевод анонса.
703
- - [ ] **39.5 Демо и краудсорсинг** — средняя.
704
- - [ ] Демо «тишина в уведомлениях + сэкономлено $».
705
- - [ ] Пакет `local-recipes`.
706
- - [ ] Краудсорсинговая таблица bench в docs.
707
- - [ ] **39.6 Ecosystem и сообщество** — лёгкая: заявка в ecosystem подана и обработана; ответы на первые внешние issue/PR.
708
-
709
- **Готово, когда:** заявка в ecosystem подана и обработана; первые внешние PR; загрузки растут после анонсов (бот-всплеск не в счёт).
710
-
711
- ---
712
-
713
- ## После 1.6.0 — мульти-агентная оркестрация (кандидаты 1.7.x)
714
-
715
- Оценка идей от 15.11.2026. Порядок отражает зависимости, а не важность: сначала артефакты и надёжный DAG, потом роли, самоисправление и память. Все возможности **opt-in**; планировщик и базовые задачи обязаны работать без локальной модели, без Docker и без внешних сервисов.
716
-
717
- ### Оценка: что делаем, что позже, что не делаем
718
-
719
- | Идея | Решение | Куда | Почему |
720
- |---|---|---|---|
721
- | Context artifacts, сквозной контекст | **Делаем первым** | Спринт 40 | Фундамент для crew, self-correction и tournament. Без него роли общаются файлами и ломают изоляцию. |
722
- | Crew / swarm, роли worker → reviewer | **Делаем, но не «произвольный swarm»** | Спринт 41 | Сильный демо-сценарий. Начинаем с линейной цепочки ролей и одного reviewer-цикла, без свободной топологии и рекурсии. |
723
- | Feedback-driven retry + post-mortem | **Делаем** | Спринт 42 | Высокая воспринимаемая ценность при умеренной сложности. Ограничиваем попытки и бюджет токенов. |
724
- | Model fallback chain | **Делаем после confidence и бюджетов** | Спринт 43 | Экономия реальная, но нужны порог уверенности, учёт стоимости и предсказуемая семантика retry. |
725
- | A/B tournament моделей и промптов | **Делаем** | Спринт 44 | Расширение уже существующей матрицы; хороший differentiator, если есть честная таблица стоимости/времени. |
726
- | CEP, составные события | **Делаем после durable DAG** | Спринт 45 | Нужен журнал событий и идемпотентность. Начинаем с «3 падения за 30 минут», без сложного DSL на старте. |
727
- | Входящие IMAP/Slack/Discord/GitHub events | **Частично, позже** | Спринт 45, P3 | Полезно, но это интеграции с внешней авторизацией и обслуживанием. Только opt-in, после CEP-ядра. |
728
- | Cross-run memory с эмбеддингами | **Позже, отдельным спринтом** | Спринт 46 | Дорого по хранению и рискованно по приватности. Сначала простая память «уроков» без эмбеддингов, затем retrieval. |
729
- | Smart recipes / self-configuring pipelines | **Частично** | Спринт 47 + 32 | Библиотека рецептов нужна раньше; intent-to-pipeline — после pipeline-as-code и шаблонов. |
730
- | Pause & resume с инъекцией контекста | **Включаем в текущий DAG** | 36.7–36.8 | Естественное продолжение durable DAG, не отдельный спринт. |
731
- | Approval с голосованием/делегированием | **Включаем в approvals** | 38.1 | Уже есть точка входа; расширяем варианты ответа, а не создаём второй механизм. |
732
- | Cost-aware scheduling, дешёвые окна | **Включаем в экономику** | 34.5 | Бюджеты уже планируются; «выкуп времени» у ожидающих — не делаем в 1.x. |
733
- | Confidence scoring результата | **Включаем в fallback** | 43.2 | Отдельная фича без действия бесполезна; нужен порог и переход к следующей модели/человеку. |
734
- | Token efficiency / cost per value | **Уже есть частично** | 34.2 | `tokens_per_success` и прогноз стоимости уже в плане; `cost_per_value` требует определить «ценность» — позже. |
735
-
736
- ### Общие требования к спринтам 40–47
737
-
738
- - Новые поля схемы задач и настроек — с миграцией и дефолтами, старые задачи не меняют поведение.
739
- - Любой цикл (reviewer, retry, fallback) имеет жёсткий лимит попыток, времени и токенов; при исчерпании — понятный терминальный статус, а не бесконечный запуск.
740
- - Артефакты, комментарии и память могут содержать секреты: маскировать через существующий `redactAuditDetails`, ограничивать размер и срок хранения, не отдавать в чужие workspace.
741
- - Все новые пользовательские строки — в `locales/ru.json` и `locales/en.json`; тесты в ru и en.
742
- - Новые инструменты агента и GUI-панели — по существующим паттернам; описания инструментов остаются EN.
743
- - Фичи не должны требовать локальной модели: при её отсутствии — heuristic/правила или явный отказ с объяснением.
744
-
745
- ### Спринт 40 — Context artifacts (1.7.0, P1)
746
-
747
- **Цель:** артефакты запуска — first-class citizen, а не файлы в рабочей директории.
748
-
749
- - [ ] **40.1 Схема и хранилище** — сложная.
750
- - [ ] Таблица `run_artifacts`: `run_id`, `task`, `type`, `schema_version`, `data_json`, `bytes`, `created_at`, `expires_at`.
751
- - [ ] Индексы по `run_id`, `task`, `type`; лимит размера на артефакт и на запуск.
752
- - [ ] Ретеншн и очистка вместе с историей; ручное удаление.
753
- - [ ] Миграция БД и тест на старой базе.
754
- - [ ] **40.2 Контракт чтения/записи** — сложная.
755
- - [ ] В задаче: `context.read` (типы и/или задачи-источники), `context.write` (`{type, from: prompt | json | file}`), `context.required`.
756
- - [ ] Порядок разрешения: явная задача → тип из `dependsOn` → ошибка/пустой контекст по политике.
757
- - [ ] Валидация: неизвестный тип, цикл, отсутствующий обязательный артефакт.
758
- - [ ] **40.3 Инъекция в промпт** — средняя.
759
- - [ ] Плейсхолдеры `{context}` / `{artifact:type}` с детерминированным порядком.
760
- - [ ] Усечение по token budget и явная пометка «контекст обрезан».
761
- - [ ] Тест: producer → consumer, несколько артефактов, отсутствующий артефакт.
762
- - [ ] **40.4 Ветки DAG и матрицы** — средняя.
763
- - [ ] Чтение артефактов из нескольких предшественников и из клонов матрицы.
764
- - [ ] Изоляция по workspace; запрет читать чужие run_id.
765
- - [ ] **40.5 GUI и история** — средняя.
766
- - [ ] Список артефактов запуска, preview, размер, срок жизни.
767
- - [ ] Маскирование секретов; diff между двумя артефактами одного типа.
768
- - [ ] **40.6 Тесты и документация** — средняя.
769
- - [ ] Producer/consumer, missing/oversized, redaction, retention, миграция.
770
- - [ ] Раздел в ARCHITECTURE и CHANGELOG.
771
-
772
- **Готово, когда:** planner пишет `plan`, worker читает его без файлов; reviewer пишет `review-issues`; секреты не попадают в артефакты; лимиты и ретеншн работают.
773
-
774
- ### Спринт 41 — Crew / роли (1.7.1, P1)
775
-
776
- **Цель:** внутри одной задачи — предсказуемая цепочка ролей, а не один промпт на всё.
777
-
778
- - [ ] **41.1 Схема ролей** — сложная.
779
- - [ ] `roles[]`: `name`, `prompt`, `model?`, `tools?`, `outputType?`, `maxTokens?`, `timeoutSeconds?`.
780
- - [ ] Обратная совместимость: задача без `roles` работает как раньше.
781
- - [ ] Валидация: уникальные имена, хотя бы один worker, лимит числа ролей.
782
- - [ ] **41.2 Последовательный runner** — сложная.
783
- - [ ] worker → reviewer; каждая роль видит артефакты предыдущих.
784
- - [ ] Политика сессии `new | reuse | last` на роль; отдельные таймауты.
785
- - [ ] Агрегатор как отдельная роль или системный шаг.
786
- - [ ] **41.3 Reviewer-цикл** — сложная.
787
- - [ ] Вердикт: `{approved, issues[], feedback, confidence}`.
788
- - [ ] `reject` → повтор worker с фидбеком; `maxCycles` по умолчанию 2.
789
- - [ ] Жёсткий лимит токенов/стоимости на цикл; при исчерпании — `error` с причиной.
790
- - [ ] **41.4 Параллельные роли** — средняя.
791
- - [ ] Fan-out ролей с общим входом и агрегатором; без произвольной рекурсии.
792
- - [ ] Максимальная глубина и число ролей; защита от «роя».
793
- - [ ] **41.5 История и стоимость по ролям** — средняя.
794
- - [ ] Отдельные строки/поля: роль, модель, токены, стоимость, длительность.
795
- - [ ] Сводка по задаче в GUI и уведомлении.
796
- - [ ] **41.6 Ошибки и частичный успех** — средняя.
797
- - [ ] Политика `stop | continue | retry` для упавшей роли.
798
- - [ ] Интеграция с DLQ и durable resume.
799
- - [ ] **41.7 Тесты и демо** — средняя.
800
- - [ ] approve, reject ×2, исчерпание цикла, таймаут роли, отсутствующий артефакт.
801
- - [ ] Демо «planner → worker → reviewer» с отклонением и исправлением.
802
-
803
- **Готово, когда:** три роли видны в истории; reviewer может отклонить результат и вернуть с фидбеком; после `maxCycles` задача завершается понятным статусом; стоимость разложена по ролям.
804
-
805
- ### Спринт 42 — Self-correcting retry + post-mortem (1.7.2, P1)
806
-
807
- **Цель:** агент учится на ошибке в пределах запуска, но не уходит в бесконечный цикл.
808
-
809
- - [ ] **42.1 Извлечение ошибки** — сложная.
810
- - [ ] Нормализовать ошибку из лога, истории и Quality Gate: класс, сообщение, последние строки.
811
- - [ ] Маскировать секреты и ограничивать размер.
812
- - [ ] **42.2 Retry с фидбеком** — средняя.
813
- - [ ] `retryPolicy: same | feedback`; шаблон с `error`, `attempt`, `previousSummary`.
814
- - [ ] Лимит попыток (по умолчанию 3) и token budget на все попытки.
815
- - [ ] Явно помечать в истории, что промпт изменён.
816
- - [ ] **42.3 Post-mortem агент** — средняя.
817
- - [ ] Запускается после окончательного провала; structured output: причина, доказательства, 2–3 рекомендации.
818
- - [ ] Fallback на шаблонное объяснение, если модель недоступна.
819
- - [ ] Не применяет изменения автоматически.
820
- - [ ] **42.4 GUI и уведомления** — средняя.
821
- - [ ] Timeline попыток, карточка post-mortem, кнопка «скопировать рекомендацию в задачу».
822
- - [ ] **42.5 Тесты и документация** — средняя.
823
- - [ ] Вторая попытка успешна после ошибки; лимит попыток; отсутствие модели; redaction.
824
- - [ ] Ограничения: post-mortem — совет, а не гарантия исправления.
156
+ ## 6. Что изменено относительно исходного плана и почему
825
157
 
826
- **Готово, когда:** упавшая задача повторяется с текстом ошибки; после 3 попыток ciclo останавливается; post-mortem объясняет причину и предлагает фикс; секреты не утекают.
827
-
828
- ### Спринт 43 — Model fallback + confidence (1.7.3, P2)
829
-
830
- **Цель:** дешёвая модель первой, дорогая — только при необходимости.
831
-
832
- - [ ] **43.1 Схема цепочки** — средняя.
833
- - [ ] `models: [{model, maxAttempts, confidenceThreshold}]`; порядок = приоритет.
834
- - [ ] Валидация: хотя бы одна модель, лимит длины цепочки, совместимость с `session`.
835
- - [ ] **43.2 Оценка уверенности** — средняя.
836
- - [ ] Structured output 0–100 от локальной модели или heuristic по ошибкам/длине/Quality Gate.
837
- - [ ] Порог настраивается; fail-open при недоступности оценки.
838
- - [ ] **43.3 Переключение модели** — сложная.
839
- - [ ] Переключение только между попытками, не посреди генерации.
840
- - [ ] Учёт стоимости и бюджет на всю цепочку; история хранит модель каждой попытки.
841
- - [ ] **43.4 Передача человеку** — средняя.
842
- - [ ] Финальная ступень — approval из спринта 38; таймаут `fail-closed`.
843
- - [ ] **43.5 Аналитика** — средняя.
844
- - [ ] Успех/стоимость/время по моделям; сравнение в дашборде.
845
- - [ ] **43.6 Тесты и документация** — средняя.
846
- - [ ] Дешёвая модель падает → следующая; низкая уверенность → следующая; цепочка исчерпана → approval.
847
-
848
- **Готово, когда:** цепочка из 2–3 моделей работает; причина перехода видна в истории; стоимость не превышает бюджет; без локальной модели цепочка деградирует к одной облачной.
849
-
850
- ### Спринт 44 — Tournament: A/B моделей и промптов (1.7.4, P2)
851
-
852
- **Цель:** честно сравнить варианты на одной задаче и выбрать лучший.
853
-
854
- - [ ] **44.1 Оси матрицы** — сложная.
855
- - [ ] Оси `model`, `promptVersion`, `params`; декартово произведение.
856
- - [ ] Стабильные имена ячеек и связь с родителем.
857
- - [ ] **44.2 Runner** — средняя.
858
- - [ ] Параллельно/последовательно, лимит конкурентности и стоимости.
859
- - [ ] Отдельный статус каждой ячейки; агрегация partial.
860
- - [ ] **44.3 Таблица результатов** — средняя.
861
- - [ ] Успех, время, стоимость, токены, оценка качества (если есть).
862
- - [ ] Сортировка, фильтры, экспорт CSV/JSON, GUI.
863
- - [ ] **44.4 Победитель и применение** — средняя.
864
- - [ ] Отметить лучший вариант; применить модель/промпт к задаче только по подтверждению.
865
- - [ ] **44.5 Тесты и документация** — средняя.
866
- - [ ] 2 модели × 2 промпта = 4 ячейки; корректные имена; нет утечек секретов.
867
-
868
- **Готово, когда:** турнир запускается одной матрицей; таблица показывает стоимость и успех; победитель применяется вручную; отчёт экспортируется.
869
-
870
- ### Спринт 45 — CEP и входящие события (1.7.5, P2)
871
-
872
- **Цель:** реагировать не на одно событие, а на паттерн.
873
-
874
- - [ ] **45.1 Журнал событий** — сложная.
875
- - [ ] Нормализованные события: `task.failed`, `task.succeeded`, `git.push`, `file.changed`, `mcp.event`, `email.received`.
876
- - [ ] Дедупликация по ключу, TTL, индексы по типу/времени.
877
- - [ ] **45.2 Движок паттернов** — сложная.
878
- - [ ] Окно, count, sequence, absence; простой YAML/JSON без полноценного DSL.
879
- - [ ] Валидация и понятные ошибки; защита от штормов.
880
- - [ ] **45.3 Действия** — средняя.
881
- - [ ] Запустить задачу, поставить очередь на паузу, уведомить, emit MCP event.
882
- - [ ] Идемпотентность: один паттерн не срабатывает дважды на одно окно.
883
- - [ ] **45.4 Встроенные паттерны** — средняя.
884
- - [ ] 3 падения за 30 минут → алерт + пауза.
885
- - [ ] Push в main без зелёного Quality Gate → задача на откат.
886
- - [ ] Email + коммит в течение часа → задача согласования.
887
- - [ ] **45.5 Входящие адаптеры (P3)** — средняя.
888
- - [ ] IMAP, Slack/Discord webhook с проверкой подписи, GitHub events.
889
- - [ ] Только opt-in, секреты через хранилище, отдельный лимит событий.
890
- - [ ] **45.6 Тесты и лимиты** — средняя.
891
- - [ ] 3 падения → срабатывание; дубликаты не считаются; адаптер выключен по умолчанию.
892
-
893
- **Готово, когда:** паттерн «3 падения за 30 минут» работает; повторные события не дублируют действие; адаптеры можно не включать.
894
-
895
- ### Спринт 46 — Cross-run memory (1.7.6, P3)
896
-
897
- **Цель:** задача помнит прошлые запуски, но памятью можно управлять.
898
-
899
- - [ ] **46.1 Схема памяти** — сложная.
900
- - [ ] Запись: task/workspace, текст, источник (`run_id`), тип (`lesson`, `summary`, `fact`), TTL.
901
- - [ ] Эмбеддинг опционален; без него — keyword-поиск.
902
- - [ ] **46.2 Запись** — средняя.
903
- - [ ] Кандидаты в память после успеха/провала; запись только по политике или подтверждению.
904
- - [ ] Запрет секретов/PII; лимит размера и количества.
905
- - [ ] **46.3 Retrieval и инъекция** — средняя.
906
- - [ ] Top-k по релевантности, порог, token budget; `memory.mode: off | manual | auto`.
907
- - [ ] Детерминированный порядок и пометка «из прошлого запуска».
908
- - [ ] **46.4 GUI** — средняя.
909
- - [ ] Просмотр, удаление, экспорт; переключатель на задачу/workspace.
910
- - [ ] **46.5 Тесты и приватность** — средняя.
911
- - [ ] Повторный запуск получает релевантный урок; удаление памяти влияет на следующий запуск; утечек нет.
912
-
913
- **Готово, когда:** память opt-in; retrieval объясним; пользователь может всё удалить; без эмбеддингов работает keyword-режим.
914
-
915
- ### Спринт 47 — Smart recipes и intent-to-pipeline (1.7.7, P2)
916
-
917
- **Цель:** от «хочу каждую пятницу...» к проверенному черновику пайплайна.
918
-
919
- - [ ] **47.1 Реестр рецептов** — средняя.
920
- - [ ] Расширение шаблонов: параметры, prerequisites, quality gates, notifications.
921
- - [ ] `manage_templates action=install`; версия и источник рецепта.
922
- - [ ] **47.2 Анализ репозитория** — средняя.
923
- - [ ] Определить язык, тесты, CI, размер; предложить Quality Gate.
924
- - [ ] Ничего не писать без подтверждения.
925
- - [ ] **47.3 Intent parser** — сложная.
926
- - [ ] Естественный язык → черновик DAG/триггеров/уведомлений.
927
- - [ ] Structured output + уточняющие вопросы при неоднозначности.
928
- - [ ] **47.4 Preview и apply** — средняя.
929
- - [ ] Diff, валидация, dry-run, явное «применить».
930
- - [ ] Никакого автоматического создания задач.
931
- - [ ] **47.5 Каталог** — средняя.
932
- - [ ] `nightly-refactor`, `dependency-audit`, `doc-sync`, `coverage-report`.
933
- - [ ] **47.6 Тесты и документация** — средняя.
934
- - [ ] Валидный черновик из intent; неоднозначность → вопрос; apply только после подтверждения.
935
-
936
- **Готово, когда:** intent даёт валидный черновик; пользователь видит diff и применяет вручную; рецепты ставятся из каталога; без модели доступны статические рецепты.
937
-
938
-
939
- ### Решения по плану (согласованы 14.11.2026)
940
-
941
- 1. **Security до флагмана — принято.** Enforced `allowedTools` / `deniedTools` выходит в **1.5.2**, до локального помощника. Флагман не может продавать приватность на advisory-правах.
942
- 2. **Переименование — имя выбрано: `agent-steward` (17.11.2026).** Имя зарезервировано заглушкой `0.0.1`. `opencode-pipeline` отменён: удалён из репозитория и депрекейчен в npm. Rename-релиз — milestone **2.0.0**, первый реальный релиз `agent-steward@0.0.2`. Сначала выпускается dual-support `opencode-windows-scheduler@1.5.6` (OpenCode v1 + v2). Аргументы против старого имени: «windows-scheduler» уже неточен (три ОС) и мешает позиционированию.
943
- 3. **11 релизов — принято.** Каждый спринт — один вертикальный срез; задачи внутри выполняются по одной, длительность не ограничена двумя неделями. Слияние 31→30 и 33→32 остаётся аварийным вариантом при нехватке ресурсов, но не планом по умолчанию.
944
- 4. **Локальный ИИ — строго опция.** `mode: off` по умолчанию, включение через wizard. Решено на уровне архитектуры, не только документации.
945
- 5. **Открыто:** кто владелец locale-файлов (CODEOWNERS) — нужен до 1.5.4, иначе zh/tr будут мертворождёнными.
946
- 6. **1.7.x — кандидаты, не обязательства (15.11.2026).** Спринты 40–47 не входят в обещание 1.6.0 и не сдвигают запуск. Перед каждым спринтом — отдельная оценка по факту загрузок и обратной связи; порядок 40 → 47 отражает зависимости, а не дату.
947
-
948
- ### Немедленные действия
949
-
950
- | Действие | Задача | Статус |
951
- |---|---|---|
952
- | Зарезервировать имя npm `agent-steward` заглушкой `0.0.1` | — | ✅ сделано 17.11.2026 |
953
- | Спайк по правам агента (2 дня) | 29.1 | ✅ сделано, см. ARCHITECTURE |
954
- | Зафиксировать формат `bench-local.json` | 30.8 | ✅_done, см. scripts/bench-local.mjs и CHANGELOG [1.5.3]_ |
955
- | Проверить формат id моделей Ollama и structured output 4B | 30.1 | ✅ сделано: 10/10 схема-валидных, средняя латентность ~20 с |
956
-
957
- Заглушка — именно `0.0.1`: `0.0.0-stage` у npm служебная stub-версия, которую создаёт сам реестр во время automated review, а не выбранный человеком номер.
958
-
959
- ### Риски
960
-
961
- | Риск | Триггер | Ответ |
962
- |---|---|---|
963
- | Переименование убивает установки | Падение загрузок после rename-релиза | Старый пакет остаётся живым, deprecate не раньше 2.1 |
964
- | i18n ломает тесты | Массовые падения после экстракции | Ассерты на ключи (задача 28.5); RU по умолчанию |
965
- | Локальная модель даёт мусор | Невалидный JSON > 5% | Схема + retry + порог уверенности + fallback на правила |
966
- | Durable DAG расползается | Задача 36.2 или 36.3 > 2 недель | Резать: сначала resume для линейных цепочек, потом матрицы |
967
- | Docker на Windows-CI | Падения CI | Docker-тесты только на Linux-раннере, opt-in |
968
- | Bus factor = 1 | >5 issues без ответа | Заморозить P3, искать мейнтейнеров, сузить scope |
969
- | Scope creep | Задача длиннее 2 недель | P3 — в бэклог без обсуждения; задачу резать на подзадачи |
970
- | Мульти-агентные циклы не сходятся | Reviewer/worker крутятся без прогресса | `maxCycles`, бюджет токенов, терминальный статус, тест на исчерпание |
971
- | Артефакты/память содержат секреты | Утечка в историю, GUI или другой workspace | redaction, лимит размера, TTL, изоляция по workspace |
972
- | Tournament сжигает бюджет | Много ячеек параллельно | подтверждение турнира, лимит стоимости на запуск, последовательный режим |
973
- | CEP-шторм событий | Дубли или лавина триггеров | дедупликация, TTL, rate limit, opt-in адаптеры |
974
-
975
- ### Горизонт 3.x (без обязательств)
976
-
977
- - Remote runners (SSH).
978
- - Worktree → auto-PR (описание PR пишет локальная модель).
979
- - Адаптеры других CLI (Claude Code / Gemini / aider).
980
- - Экспорт в GitHub Actions.
981
-
982
- ### Метрики плана
983
-
984
- | Метрика | Сейчас (1.5.3) | 1.6.0 |
985
- |---|---|---|
986
- | Локали | en + ru | en/ru/zh/tr |
987
- | Enforced permissions | ✅ | ✅ |
988
- | Локальный триаж | ✅ shadow | ✅ + саммари/дедуп |
989
- | Pipeline-as-code | ❌ | ✅ |
990
- | Durable DAG | ❌ | ✅ |
991
- | Docker runner | ❌ | ✅ opt-in |
992
- | Загрузки npm / мес | первые | 1500+ |
993
- | GitHub stars | единицы | 500+ |
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, завершён) |
994
165
 
995
166
  ---
996
167
 
997
- ## Идеи без спринта
168
+ ## 7. Правила планирования
998
169
 
999
- - **Remote runners**: агент на удалённой машине, центральный дашборд, очередь и конкурентность на кластере.
1000
- - **Экспорт в CI**: адаптеры GitHub Actions и GitLab CI из pipeline-as-code (не наоборот).
1001
- - **DAG в GUI**: клик по узлу → карточка задачи, zoom/pan, подсветка пути, дорожка матричных клонов.
1002
- - **Нативный scheduler OpenCode**: режим `nativeScheduler: auto|on|off` вместо рекомендации отключать `experimental.schedules`.
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 (границы).
1003
177
 
1004
178
  ---
1005
179
 
1006
- ## Замечания по ходу работ
1007
-
1008
- Копится по мере выполнения задач: что замечено, но не входит в текущий скоуп. Перед планированием следующего спринта просмотреть и разложить по задачам. Целевые версии доработок — ближайшие релизы начиная с 1.5.10; отдельные версии под них не выделяем.
1009
-
1010
- ### Совместимость OpenCode v1/v2 (в работе, Спринт 31A)
1011
-
1012
- - **Числа версий дублируются в документах и коде.** Ввести `src/shared/compat.ts` с `OPENCODE_V1_MIN_VERSION` / `OPENCODE_V2_MIN_VERSION` и проверять тестом, что `docs/COMPATIBILITY.md` и README содержат значения из кода, а не литералы. Делать в 31A.2, пока адаптер ещё не размазал числа по файлам.
1013
- - **Стенд V1 ставить pinned `@opencode-ai/plugin@1.19.5`**, не `^1.19.0`: тогда дрейф V1-типов ловится осознанным обновлением, а не после `npm install`. То же для V2-стенда (`2.2.7` и `2.3.0`). Входит в 31A.5.
1014
- - **V2 ниже `2.2.7` не поддерживается.** Ядро (инструменты, хуки, SQLite, планировщик) технически работает с `2.0.0`, но subpath `/gui` появился только в `2.2.0`, а собираемся мы против `2.2.7`. Если придёт запрос на `2.0.0–2.1.x` — решать отдельно: либо отказ, либо условная сборка GUI.
1015
- - **`files` в `package.json` включает `docs`.** Любой новый документ автоматически уезжает в npm-пакет; перед релизом проверять `npm pack --dry-run`, чтобы не тащить черновики.
1016
- - **`ROADMAP-STRATEGY.md` отстал по нумерации версий** от `ROADMAP.md` (там Worktree — 1.5.6). Не переписывать: пометить документ как стратегический черновик и ссылаться на `ROADMAP.md` как на актуальную карту версий.
1017
- - **Dev-зависимости `@opentui/core` и `@opentui/solid` объявлены как `>=0.8.1`** — без верхней границы. Диапазон подтягивает `@opentui/core@0.8.4`, который требует Node `>=26.4.0` при `engines.node >=22.22.0`, отсюда `EBADENGINE` на каждой установке. На публикуемый пакет не влияет (dev-only), но чистый CI-прогон может упасть на Node 22. Запинить dev-зависимости на проверенную версию или сузить диапазон; делать вместе с CI-стендами в 31A.5.
1018
- - **Две копии `zod` после установки V1-типов** (`4.1.8` внутри `@opencode-ai/plugin`, `4.6.7` в корне). Мажор совпадает, поэтому Zod-схемы инструментов переиспользуются как есть и `zod-v3`-alias не нужен; вторая копия живёт только в dev-зависимости и в npm-пакет не попадает.
1019
-
1020
- ### i18n (после 28.3–28.5)
1021
-
1022
- - **Не все модули покрыты каталогами** (видно по прогону в en): `workspaces.ts` (`уже существует`, `Workspace … недоступен по пути`), валидации импорта в `task-transfer.ts` (`нельзя одновременно workspaceId и matrix.workspaceIds`, `matrix.workspaceIds не может быть пустым`, `пустой allowedTools запрещён`), сообщение crash recovery (`Прервано (сбой/перезагрузка)`), `formatJobLog` (`Лог пуст.`), подписи дашборда (`Скачать БД`, `БД: ✅ SQLite (WAL)`). При EN-локали они остаются русскими, а соответствующие тесты сравнивают RU-литералы — переносить в каталог и в `t()` вместе.
1023
-
1024
- - **Две копии tool-логики** в `src/index.ts` (MCP-сервер и plugin/RPC): тексты уже из общих ключей, но сами обработчики и валидации дублируются. Вынести в общий слой, иначе ключи и поведение разъедутся.
1025
- - **Русские runtime-метки в данных**: reason триггеров (`изменение отслеживаемого файла`, `новый коммит …`), `lastError` планировщика (`планировщик ОС вернул пустой список…`), сравнение `s.includes("выполняется")`. При EN-локали они останутся русскими и попадут в историю/дашборд. Нужны коды причин с переводом на отображении, а статусы сравнивать по коду, не по слову.
1026
- - **Склейка фраз из кусков** (`notify.reason` = `": {error}"`, `matrix.aggregate.stoppedFirst` с ведущим пробелом, `" до {date}"`, `" Ошибки: …"`): переводчик не управляет порядком и пунктуацией. Заменить цельными шаблонами с плейсхолдерами.
1027
- - **Нет теста на существование ключей**: паритет ru/en проверяется, а `t("…")` из кода — нет. Добавить статический тест: собрать ключи из `src/**` и сверить с каталогом, заодно ловятся опечатки.
1028
- - **Нет автопроверки «нет кириллицы в пользовательских строках»** (в 28.2 это делалось разовым скриптом). Эвристика в `test-docs` или отдельный скрипт: кириллица вне комментариев, `console.*` и каталога → ошибка.
1029
- - **Язык диагностик** (`console.*`, startup-сообщения) остаётся русским — для EN-пользователей это смешение. Решить явно: логи на EN как часть кода или локализовать по настройке.
1030
- - **Эвристика встроенных шаблонов** (`localizedTemplate` сравнивает текст с переводами): пользовательский шаблон, совпавший с дефолтом, будет считаться встроенным. Если станет проблемой — хранить флаг `templatesCustomized` или считать пустое значение дефолтом.
1031
- - **`src/index.ts` ~6 тыс. строк** — дальше править тяжело; при следующем касании разнести инструменты по `src/tools/*`.
1032
-
1033
- ### Local assistant (после 30.1–30.6)
1034
-
1035
- - **Триаж не блокирует доставку (31.7).** В `llm`/`auto` уведомление уходит сразу, вердикт считает detached-воркер `src/core/triage-worker.ts` и пишет в аудит с `async: true`; в `rules` триаж синхронный, потому что только правила подавляют.
1036
- - **Решения триажа пишутся в persistent-аудит (31.8).** `notifyTaskCompletion` и фоновый воркер вызывают `recordTriageOutcome`; записи `triage.decision` переживают перезапуск `record-history`, отчёт читает SQLite.
1037
- - **Встроенные правила покрывают статус, текст ошибки, стоимость и имя задачи (31.9).** `cost-high` и `task-important` добавлены, оба notify-only; примеры в GUI и `docs/LOCAL-AI.md`.
1038
- - **Причины правил на русском и генерируются в коде.** Это внутренний текст для вердикта; при показе пользователю понадобятся ключи каталога или шаблоны в `reason`.
1039
- - **Приоритет и порядок правил не видны пользователю.** Сортировка по `priority`, затем по порядку массива; в GUI нужен предпросмотр «какое правило сработает», иначе конфигурировать вслепую.
1040
- - **Пустой массив `rules` отключает встроенные правила.** Семантика `undefined` = встроенные, `[]` = ничего; её надо явно описать в документации 30.10, иначе легко случайно отключить триаж.
1041
- - **Дефолтный `timeoutMs` — 60 с (31.10).** Спайк 30.1: ~20 с на ответ Qwen3-4B и ~42 с на холодную; 60 с даёт запас, а в `llm`/`auto` таймаут относится только к фоновому запросу.
1042
- - **OpenAI-совместимая ветка проверена только на стабе.** Путь `/v1/chat/completions` и `response_format` покрыты `test-triage.mjs`, но с реальным провайдером не запускались; при подключении проверить strict-схему и поведение при отказе `json_schema`.
1043
- - **Внутренние ошибки классификатора на русском.** Это диагностика, не пользовательский текст; при показе в GUI/уведомлении понадобятся ключи каталога.
1044
- - **`confidenceThreshold` управляет только переходом к правилам.** LLM никогда сам не подавляет уведомление; при уверенности ниже порога решение принимают правила или fail-open. Это осознанно, но в GUI нужно объяснить, иначе порог выглядит как «фильтр уведомлений».
1045
- - **Нет отдельной сюиты настроек.** Проверки триажа добавлены в `test-notifications-v2.mjs`; при росте `settings.ts` вынести в `test-settings.mjs`, чтобы не смешивать уведомления и схему.
1046
- - **`baseUrl` принимает только http/https**, но не проверяет доступность Ollama. Для GUI стоит показать статус подключения, иначе пользователь узнает о проблеме только из лога.
1047
-
1048
- ### Security (после 29)
1049
-
1050
- - **Аудит фиксирует политику, а не попытки.** `tool.blocked` пишется при создании/обновлении задачи, потому что `opencode` — внешний процесс и плагин не видит отдельных отказов. Если нужен журнал реальных попыток, придётся разбирать лог `opencode` или добавлять перехватчик в обёртку.
1051
- - **Проектный/системный конфиг может ослабить политику задачи.** `opencode.jsonc` и `policies` выше по приоритету, вложенные subagent-вызовы используют собственные права. Проверить на реальном проекте с permissive-конфигом и зафиксировать поведение в тесте.
1052
- - **PowerShell: область видимости `$toolToAction`.** Хэш-таблица объявлялась внутри ветки `if ($DeniedTools)`, но использовалась и в ветке `allowedTools`; исправлено. Добавить регрессионный тест на `allowedTools` без `deniedTools`.
1053
- - **`OPENCODE_CONFIG_CONTENT` — деталь реализации OpenCode.** При обновлении CLI проверить поддержку переменной; текущий тест ловит только наличие строки в обёртке, не фактическое поведение `opencode`.
1054
- - **Общие временные артефакты.** Конфликт за `opencode.jsonc` устранён, но стоит проверить prompt/lock/логи при параллельных задачах в одном workdir.
1055
-
1056
- ### Тесты и CI
1057
-
1058
- - **Нестабильный `test-dag.mjs`:** в первом полном прогоне `npm run test:en` упал, отдельно и при повторном полном прогоне зелёный (12/12). Похоже на гонку по времени/общему состоянию; при повторе — запустить несколько раз подряд и убрать зависимость от текущей минуты.
1059
-
1060
- ---
180
+ ## 8. После 0.1.0 — мульти-агентная оркестрация (кандидаты 0.2.x+)
1061
181
 
1062
- ## Правила разработки
182
+ Оценка идей: контекстные артефакты → роли (worker → reviewer) → self-correcting retry → model fallback chain → A/B tournament → CEP → входящие внешние события → cross-run memory. Все возможности **opt-in**; планировщик и базовые задачи обязаны работать без локальной модели, без Docker и без внешних сервисов.
1063
183
 
1064
- - Node.js 20+ (`engines`), CI — Node 24 на Windows, macOS и Linux.
1065
- - Обязательны `npm run build` и `npm run build:gui`; `npm test` включает 37 сюит, включая `test-docs.mjs`.
1066
- - Новые runtime-зависимости — только с обоснованием; предпочтение optional dependencies и нативным командам ОС.
1067
- - Обратная совместимость: старые `tasks.json` и экспорт читаются без миграции пользователем.
1068
- - Каждый релиз обновляет CHANGELOG, README (EN + RU) и `docs/`; устаревшие отчёты спринтов не хранятся в корне — история живёт здесь и в CHANGELOG.
1069
- - После каждой задачи в «Замечания по ходу работ» добавляется то, что замечено, но не входит в скоуп: так следующий спринт планируется по фактам, а не по памяти.
184
+ Подробное описание спринтов 40–47 (Context artifacts, Crew / роли, Self-correcting retry, Model fallback, Tournament, CEP, входящие события, Cross-run memory, Smart recipes) — в разделе «После 1.6.0» предыдущей версии роадмапа; перенесено в бэклог под новые номера версий 0.2.x+.