agent-steward 0.0.3 → 0.0.4

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 (171) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +3 -3
  3. package/ROADMAP-STRATEGY.md +9 -9
  4. package/ROADMAP.md +50 -34
  5. package/dist/core/dlq-api.d.ts +44 -0
  6. package/dist/core/dlq-api.d.ts.map +1 -0
  7. package/dist/core/dlq-api.js +68 -0
  8. package/dist/core/dry-run.d.ts.map +1 -1
  9. package/dist/core/dry-run.js +18 -1
  10. package/dist/core/lock.d.ts +20 -4
  11. package/dist/core/lock.d.ts.map +1 -1
  12. package/dist/core/lock.js +97 -22
  13. package/dist/core/one-shot.d.ts +5 -1
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +33 -8
  16. package/dist/core/opencode-cli.d.ts +28 -0
  17. package/dist/core/opencode-cli.d.ts.map +1 -0
  18. package/dist/core/opencode-cli.js +74 -0
  19. package/dist/core/opencode-models.d.ts +62 -0
  20. package/dist/core/opencode-models.d.ts.map +1 -0
  21. package/dist/core/opencode-models.js +277 -0
  22. package/dist/core/ps-wrapper.d.ts +1 -1
  23. package/dist/core/ps-wrapper.d.ts.map +1 -1
  24. package/dist/core/ps-wrapper.js +11 -1
  25. package/dist/core/record-history.d.ts +15 -0
  26. package/dist/core/record-history.d.ts.map +1 -1
  27. package/dist/core/record-history.js +56 -32
  28. package/dist/core/router/dispatch.d.ts +36 -0
  29. package/dist/core/router/dispatch.d.ts.map +1 -0
  30. package/dist/core/router/dispatch.js +59 -0
  31. package/dist/core/router/escalation.d.ts +47 -0
  32. package/dist/core/router/escalation.d.ts.map +1 -0
  33. package/dist/core/router/escalation.js +87 -0
  34. package/dist/core/router/planner.d.ts +53 -0
  35. package/dist/core/router/planner.d.ts.map +1 -0
  36. package/dist/core/router/planner.js +113 -0
  37. package/dist/core/router/rules.d.ts +46 -0
  38. package/dist/core/router/rules.d.ts.map +1 -0
  39. package/dist/core/router/rules.js +85 -0
  40. package/dist/core/run-panel-api.d.ts +94 -0
  41. package/dist/core/run-panel-api.d.ts.map +1 -0
  42. package/dist/core/run-panel-api.js +169 -0
  43. package/dist/core/schedule-gate.js +5 -1
  44. package/dist/core/schedule-v2.d.ts +34 -0
  45. package/dist/core/schedule-v2.d.ts.map +1 -1
  46. package/dist/core/schedule-v2.js +91 -5
  47. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  48. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  49. package/dist/core/scheduler/at-fallback.js +135 -5
  50. package/dist/core/scheduler/linux.d.ts +10 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +29 -11
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +25 -1
  55. package/dist/core/scheduler/registry.d.ts +11 -0
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +83 -21
  58. package/dist/core/scheduler/run-now.d.ts +16 -0
  59. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  60. package/dist/core/scheduler/run-now.js +28 -0
  61. package/dist/core/secrets.d.ts.map +1 -1
  62. package/dist/core/secrets.js +125 -28
  63. package/dist/core/session.d.ts.map +1 -1
  64. package/dist/core/session.js +18 -11
  65. package/dist/core/task-name.d.ts +24 -0
  66. package/dist/core/task-name.d.ts.map +1 -0
  67. package/dist/core/task-name.js +40 -0
  68. package/dist/core/wrappers/bash.d.ts.map +1 -1
  69. package/dist/core/wrappers/bash.js +49 -4
  70. package/dist/db/capability-repo.d.ts +83 -0
  71. package/dist/db/capability-repo.d.ts.map +1 -0
  72. package/dist/db/capability-repo.js +182 -0
  73. package/dist/db/history-repo.d.ts +8 -0
  74. package/dist/db/history-repo.d.ts.map +1 -1
  75. package/dist/db/history-repo.js +19 -0
  76. package/dist/db/index.d.ts +4 -0
  77. package/dist/db/index.d.ts.map +1 -1
  78. package/dist/db/index.js +39 -1
  79. package/dist/db/migrate.d.ts.map +1 -1
  80. package/dist/db/migrate.js +3 -1
  81. package/dist/db/run-context.d.ts +103 -0
  82. package/dist/db/run-context.d.ts.map +1 -0
  83. package/dist/db/run-context.js +224 -0
  84. package/dist/db/run-dlq.d.ts +100 -0
  85. package/dist/db/run-dlq.d.ts.map +1 -0
  86. package/dist/db/run-dlq.js +191 -0
  87. package/dist/db/run-resume.d.ts +5 -2
  88. package/dist/db/run-resume.d.ts.map +1 -1
  89. package/dist/db/run-resume.js +30 -11
  90. package/dist/db/runs-repo.d.ts +13 -5
  91. package/dist/db/runs-repo.d.ts.map +1 -1
  92. package/dist/db/runs-repo.js +28 -5
  93. package/dist/db/schema.d.ts +2 -2
  94. package/dist/db/schema.d.ts.map +1 -1
  95. package/dist/db/schema.js +154 -2
  96. package/dist/db/settings-repo.d.ts +11 -0
  97. package/dist/db/settings-repo.d.ts.map +1 -1
  98. package/dist/db/settings-repo.js +25 -0
  99. package/dist/db/step-idempotency.d.ts +51 -0
  100. package/dist/db/step-idempotency.d.ts.map +1 -0
  101. package/dist/db/step-idempotency.js +136 -0
  102. package/dist/index.d.ts +4 -4
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.js +102 -4
  105. package/dist/rpc.d.ts +678 -0
  106. package/dist/rpc.d.ts.map +1 -1
  107. package/dist/rpc.js +235 -0
  108. package/dist/server.d.ts +31 -0
  109. package/dist/server.d.ts.map +1 -1
  110. package/dist/server.js +95 -35
  111. package/dist/types.d.ts.map +1 -1
  112. package/dist/types.js +7 -0
  113. package/dist/workspaces.d.ts +25 -3
  114. package/dist/workspaces.d.ts.map +1 -1
  115. package/dist/workspaces.js +43 -8
  116. package/docs/ARCHITECTURE.md +229 -5
  117. package/docs/CONCEPT.md +171 -91
  118. package/docs/EXECUTION-LOOP.md +196 -0
  119. package/docs/README.ru.md +2 -2
  120. package/docs/README.zh.md +3 -3
  121. package/docs/SAFETY.md +122 -0
  122. package/docs/SAVINGS.md +29 -0
  123. package/docs/SAVINGS.ru.md +29 -0
  124. package/docs/SAVINGS.zh.md +18 -0
  125. package/gui-experimental.cjs +8 -8
  126. package/locales/en.json +67 -0
  127. package/locales/ru.json +67 -0
  128. package/locales/zh.json +67 -0
  129. package/package.json +28 -3
  130. package/scripts/audit-bundle.mjs +215 -0
  131. package/src/core/dlq-api.ts +98 -0
  132. package/src/core/dry-run.ts +25 -1
  133. package/src/core/lock.ts +95 -22
  134. package/src/core/one-shot.ts +36 -8
  135. package/src/core/opencode-cli.ts +103 -0
  136. package/src/core/opencode-models.ts +315 -0
  137. package/src/core/ps-wrapper.ts +11 -1
  138. package/src/core/record-history.ts +75 -37
  139. package/src/core/router/dispatch.ts +94 -0
  140. package/src/core/router/escalation.ts +129 -0
  141. package/src/core/router/planner.ts +166 -0
  142. package/src/core/router/rules.ts +109 -0
  143. package/src/core/run-panel-api.ts +262 -0
  144. package/src/core/schedule-gate.ts +6 -2
  145. package/src/core/schedule-v2.ts +114 -5
  146. package/src/core/scheduler/at-fallback.ts +190 -5
  147. package/src/core/scheduler/linux.ts +32 -10
  148. package/src/core/scheduler/posix.ts +20 -1
  149. package/src/core/scheduler/registry.ts +107 -26
  150. package/src/core/scheduler/run-now.ts +32 -0
  151. package/src/core/secrets.ts +127 -27
  152. package/src/core/session.ts +23 -10
  153. package/src/core/task-name.ts +67 -0
  154. package/src/core/wrappers/bash.ts +49 -4
  155. package/src/db/capability-repo.ts +285 -0
  156. package/src/db/history-repo.ts +22 -0
  157. package/src/db/index.ts +37 -1
  158. package/src/db/migrate.ts +3 -1
  159. package/src/db/run-context.ts +370 -0
  160. package/src/db/run-dlq.ts +310 -0
  161. package/src/db/run-resume.ts +48 -12
  162. package/src/db/runs-repo.ts +30 -7
  163. package/src/db/schema.ts +154 -2
  164. package/src/db/settings-repo.ts +31 -0
  165. package/src/db/step-idempotency.ts +185 -0
  166. package/src/gui.tsx +515 -0
  167. package/src/index.ts +124 -4
  168. package/src/rpc.ts +251 -0
  169. package/src/server.ts +112 -36
  170. package/src/types.ts +9 -0
  171. package/src/workspaces.ts +58 -9
package/docs/CONCEPT.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # CONCEPT — Верифицируемая локально-первая оркестрация агент-задач
2
2
 
3
- > Статус: черновик цели (north star). Рабочее имя пакета — TBD (см. шаг rename).
4
- > Это документ-направление: любое решение по фиче сверяется с ним.
3
+ > Статус: north star проекта **agent-steward**. Любое решение по фиче сверяется с ним.
4
+ > Система гибридная: миссии по триггеру **или ad-hoc**, на усмотрение пользователя.
5
5
 
6
6
  ## TL;DR
7
7
 
@@ -13,7 +13,7 @@
13
13
  Со временем локальный сетап становится личной, приватной, дешёвой и всё более
14
14
  умной рабочей силой.
15
15
 
16
- Это и есть продукт. Всё остальное — обвязка.
16
+ Это и есть продукт. Всё остальное — обвязка, включая планировщик.
17
17
 
18
18
  ---
19
19
 
@@ -22,20 +22,20 @@
22
22
  Разработчику, который хочет автономной agent-работы, сегодня доступны три
23
23
  плохих варианта:
24
24
 
25
- 1. **Не автоматизировать** — рутина (починить тесты, обновить зависимости,
26
- бойлерплейт, извлечение, мелкие трансформации) остаётся ручной.
25
+ 1. **Не автоматизировать** — рутина остаётся ручной.
27
26
  2. **Автоматизировать в облаке** — токены на каждый прогон, код уходит наружу,
28
- нет контроля над тем, что именно исполняется и куда течёт.
29
- 3. **Автоматизировать локально наивно** — слабая модель молно выдаёт брак,
27
+ нет контроля над тем, что исполняется и куда течёт.
28
+ 3. **Автоматизировать локально наивно** — слабая модель молча выдаёт брак,
30
29
  падает, двоится; доверия нет, затею бросают.
31
30
 
32
31
  Корень всех трёх: **нет слоя, который делает агент-труд одновременно дешёвым,
33
32
  приватным и проверяемо надёжным.**
34
33
 
35
- - OpenCode даёт агентов, но не даёт супервизии: нет capability-роутинга,
36
- объективных гейтов, честной экономии, learning-loop.
34
+ - OpenCode даёт агентов, но не даёт супервизии: capability-роутинга, объективных
35
+ гейтов, честной экономии, learning-loop.
37
36
  - Облачные оркестраторы дают масштаб, но не приватность и не локальную экономию.
38
37
  - Swarm-фреймворки дают коллаборацию, но не надёжность и не экономию.
38
+ - Планировщики дают расписание, но не верификацию и не контроль ущерба.
39
39
 
40
40
  Ниша пуста: **локально-первая, верифицируемая, компаундящаяся оркестрация**.
41
41
 
@@ -48,49 +48,53 @@
48
48
  - **Объективный гейт** (тесты / линт / схема / diff-applies / команда) дёшев и
49
49
  не врёт. Он позволяет натравливать локаль на максимум задач: брак ловится и
50
50
  эскалируется, а не уезжает в прод.
51
- - Исходы гейта — **бесплатная разметка**: они учат роутинг («какие типы задач
52
- локаль тянет») и копят gate-passed датасет для прокачки весов.
51
+ - Исходы гейта — **бесплатная разметка**: они учат роутинг и копят gate-passed
52
+ датасет для прокачки весов.
53
53
 
54
54
  Проверка — не надзор, а **двигатель экономики и обучения**.
55
55
 
56
56
  ## 3. Что это такое
57
57
 
58
58
  **Фреймворк-супервизор поверх OpenCode**: локальный control plane, который
59
- принимает миссии (ad-hoc или по расписанию), раскладывает их на шаги с ролями,
60
- назначает каждый шаг **самому дешёвому способному исполнителю** (локаль →
61
- облако только при провале гейта), объективно верифицирует результат, честно
62
- считает экономию и компаундится — с каждой задачей дешевле и умнее под
63
- конкретного пользователя.
59
+ принимает миссии — **ad-hoc по желанию пользователя или по триггеру/расписанию** —
60
+ раскладывает их на шаги с ролями, назначает каждый шаг **самому дешёвому способному
61
+ исполнителю** (локаль → облако только при провале гейта), объективно верифицирует
62
+ результат, честно считает экономию и компаундится.
64
63
 
65
64
  Метафора: бригадир смешанной бригады. Дешёвые локальные подмастерья делают
66
65
  ограниченную работу под инспекцией; дорогие облачные специалисты вызываются,
67
66
  только когда инспекция завалила подмастерье; каждая инспекция делает
68
67
  подмастерьев лучше именно в твоих ремёслах.
69
68
 
69
+ Бригадира можно позвать руками в любой момент — он не живёт внутри календаря.
70
+
70
71
  ## 4. Цель и критерии приёмки (north star)
71
72
 
72
- Четыре столпа. Любая фича/ADR сверяется с ними; при конфликте порядок такой:
73
- **надёжно > приватно > дёшево > краткосрочные фичи**, explore — управляемая
73
+ Четыре столпа. При конфликте порядок:
74
+ **надёжно > приватно > дёшево > краткосрочные фичи**; explore — управляемая
74
75
  инвестиция «дёшево-сегодня» в «компаунд-завтра».
75
76
 
76
77
  | Столп | Что значит | Метрика |
77
78
  |---|---|---|
78
- | **Дёшево** | локаль закрывает максимум gate-able задач | net-экономия $ (честная контрфактика), local share %, escalation rate, time overhead |
79
+ | **Надёжно** | ноль тихих отказов / двойных прогонов / fake-done / порчи репо | trust-инциденты = 0; гейт независим и tamper-evident; полнота аудита |
79
80
  | **Приватно** | control plane, данные, аудит, triage локальны | % инференса/данных локально; cloud-egress только explicit и залогирован |
80
- | **Надёжно** | ноль тихих отказов/двойных прогонов/fake-done/порчи репо | trust-инциденты = 0; гейт независим от self-report; полнота аудита |
81
- | **Компаундится** | success rate и экономия растут под пользователя | тренд local success_rate ↑, eval-lift адаптеров, рост scaffolding-библиотеки |
81
+ | **Дёшево** | локаль закрывает максимум gate-able задач | net-экономия (минус верификация/эскалации/overhead), local share, escalation rate |
82
+ | **Компаундится** | success rate и экономия растут под пользователя | тренд local success_rate и first_pass_rate ↑, eval-lift адаптеров, рост scaffolding |
82
83
 
83
84
  Цель одним предложением: **разработчик оставляет AI-агентам свою рутину —
84
- дёшево, приватно, надёжно — и его локальный сетап с каждой неделей работает
85
- лучше и дешевле именно под его задачи.**
85
+ дёшево, приватно, надёжно, когда сам захочет или по расписанию — и его локальный
86
+ сетап с каждой неделей работает лучше и дешевле именно под его задачи.**
86
87
 
87
88
  ## 5. Способности (что он делает)
88
89
 
89
90
  - **Миссия** = цель + scope + явный критерий приёмки (гейт). Без критерия —
90
91
  не миссия, а лотерея.
92
+ - **Гибридные входы**: ad-hoc (инструмент/CLI/GUI/RPC), внутренние (цепочка, DAG,
93
+ retry, эскалация), registered (cron, once, file, git, mcp-event, webhook).
94
+ Регистрация в планировщике ОС **опциональна**.
91
95
  - **Декомпозиция** на шаги/роли (planner → implementer → reviewer …).
92
96
  - **Capability-aware роутинг (3 слоя)**:
93
- - **Слой 1 — статические правила (0 токенов, мгновенно):** таблица соответствий тип задачи → транспорт + исполнитель. Большинство операций заранее известно, модель не нужна.
97
+ - **Слой 1 — статические правила (0 токенов, мгновенно):**
94
98
  ```json
95
99
  {
96
100
  "read_file": { "transport": "direct", "executor": "local" },
@@ -101,63 +105,103 @@
101
105
  "jira_update_task": { "transport": "mcp", "executor": "cloud" }
102
106
  }
103
107
  ```
104
- - **Слой 2 — Capability Map (0 токенов, быстро):** SQLite-таблица `task_type → model / success_rate / avg_cost / avg_time / last_10_runs`. Обучается на исходах гейта. При `success_rate ≥ 0.85` — маршрут локально; при `0.30` — эскалация в облако или «нужно ревью». Это и есть learning loop из §9.
105
- - **Слой 3 — локальная модель (только декомпозиция и неоднозначность):** модель не маршрутизирует каждый шаг. Она только разбивает миссию на шаги с типами и разрешает неоднозначность (Explore-режим). После этого каждый шаг проходит через Слой 1 и Слой 2.
108
+ - **Слой 2 — Capability Map (0 токенов):** SQLite `task_type → model /
109
+ success_rate / first_pass_rate / avg_attempts / avg_cost / avg_time /
110
+ last_10_runs`. Обучается на исходах гейта, с затуханием старых данных.
111
+ Высокая надёжность → локаль; низкая → облако или ревью.
112
+ - **Слой 3 — локальная модель (только декомпозиция и неоднозначность):**
113
+ модель не маршрутизирует каждый шаг.
106
114
  - **Эскалация при провале гейта — по правилу, без участия модели.**
115
+ - **Reliability вместо бинарного исхода**: «прошло с первой попытки» ≠ «с третьей»;
116
+ first_pass_rate и среднее число попыток участвуют в роутинге.
107
117
  - **Объективная верификация** (keystone): провал → эскалация / ретрай / откат;
108
- никогда «готово» на слово агента.
109
- - **Честная экономика**: savings ledger (net-контрфактика с учётом эскалаций и
110
- overhead), токены/стоимость по шагам и моделям.
118
+ никогда «готово» на слово агента. Гейт **всегда hard**.
119
+ - **Целостность гейта**: gate-файлы и команда вне write-scope агента; snapshot и
120
+ хэш gate-входов и политики фиксируются на старте и сверяются перед вердиктом.
121
+ Flake/infra-исходы не обучают карту. Shadow/canary — для маршрутов и адаптеров,
122
+ не для приёмки артефакта.
123
+ - **Отложенные внешние эффекты**: до гейта агент заявляет намерения
124
+ (`effect_intents`), а не выполняет irreversible-действия. Применение — только
125
+ после pass; при провале — отброс или компенсация.
126
+ - **Контракт безопасности миссии**: класс риска компилируется в исполняемую
127
+ политику (allow/deny, egress, обязательные гейты, бюджет) **до** исполнения.
128
+ - **Честная экономика**: savings ledger (net-контрфактика с учётом эскалаций,
129
+ верификации и overhead), токены/стоимость по шагам и моделям.
111
130
  - **Полный аудит**: кто, каким инструментом, какой файл, когда, почему
112
- эскалировали.
113
- - **Learning-loop**: capability-карта по типам задач → scaffolding/few-shot из
114
- успешных решений → eval-harness → (staged) LoRA-адаптеры на gate-passed
115
- датасете.
116
- - **Автономность**: ad-hoc или расписание; переживает ребут; не двоится; не
117
- зависает; leases/locks/таймауты.
131
+ эскалировали. Ledger — tamper-evident (хеш-цепочка), не граница безопасности.
132
+ - **Learning-loop**: capability-карта → scaffolding/few-shot из успешных решений →
133
+ eval-harness → shadow → canary → (staged) LoRA на gate-passed датасете.
134
+ - **Автономность по выбору**: ad-hoc или расписание; переживает ребут; не двоится;
135
+ не зависает; leases/locks/таймауты/бюджеты.
118
136
 
119
137
  ## 6. Исполнительный цикл (его задачи)
120
138
 
121
- 1. Принять миссию + критерий приёмки.
122
- 2. Разложить на шаги, назначить роли.
123
- 3. Выбрать исполнителя шага (локаль first по capability-карте).
124
- 4. Выполнить шаг.
125
- 5. Прогнать объективный гейт.
126
- 6. Pass → записать экономию + пример + метку (+ training-record).
127
- Fail → эскалация / ретрай / откат + метка.
128
- 7. Собрать артефакт миссии (diff/PR, отчёт, аудит-трейл).
129
- 8. Отчитаться честно (savings, success rate, эскалации, overhead).
130
- 9. Обновить роутинг/eval; периодически — дообучить адаптер.
139
+ 1. Принять миссию: цель + scope + gate-спека + **контракт безопасности**;
140
+ скомпилировать политику (класс риска → allow/deny + egress + обязательные
141
+ гейты + бюджет); approval, если класс риска требует.
142
+ 2. Разложить на шаги, назначить роли (локальная модель — только здесь).
143
+ 3. **Роутинг шага**: статические правила → capability-карта с учётом reliability
144
+ (first_pass_rate, попытки, decay), локаль first, explore capped.
145
+ 4. **Context compilation**: собрать бандл под окно выбранной модели и бюджет
146
+ токенов — scaffolding/few-shot из ledger + repo-map. Пересборка при эскалации.
147
+ 5. Выполнить шаг: capability issuance на шаг (TTL), least privilege,
148
+ worktree/sandbox; внешние эффекты — только намерения.
149
+ 6. Прогнать **hard, независимый, tamper-evident, flake-aware** гейт.
150
+ - Pass → применить намерения → ledger (экономия + пример + provenance) → обновить карту.
151
+ - Fail → эскалация / ретрай / откат в рамках живого бюджета; эскалация возвращает к шагу 3.
152
+ 7. Собрать артефакт миссии (diff/PR из worktree, отчёт, аудит-трейл).
153
+ 8. Отчитаться честно: net-экономия, success rate, first_pass_rate, escalation rate,
154
+ overhead.
155
+ 9. Обновить роутинг/eval; периодически — дообучить адаптер (staged, opt-in).
156
+
157
+ Шаги 3–6 — внутренний цикл на каждый шаг миссии.
158
+ Сквозные слои: телеметрия (span на шаг), живой бюджет, аудит, durable state.
159
+ Human review / approval — **тип гейта**, доступен на любом шаге; пауза не потребляет compute.
131
160
 
132
161
  ## 7. Архитектура (слои)
133
162
 
134
163
  ```
135
- [ триггеры: ad-hoc CLI/RPC | scheduler | file | git | mcp-event ] ← обвязка
164
+ [ ВХОДЫ-АДАПТЕРЫ ]
165
+ ad-hoc: run_mission / CLI / GUI / RPC ← без регистрации в ОС
166
+ внутренние: chain / DAG / retry / escalation ← без регистрации в ОС
167
+ registered: cron / once / file / git / mcp / webhook
168
+ │
169
+ ▼
170
+ [ MISSION RUNTIME — ядро ]
171
+ intake: цель + scope + gate-спека + safety → компиляция политики + бюджет
136
172
  │
137
- [ mission intake: цель + scope + критерий приёмки (гейт) ]
173
+ createRun (durable, trigger_kind)
138
174
  │
139
- [ planner: декомпозиция на шаги/роли ]
175
+ planner: декомпозиция на шаги/роли
140
176
  │
141
- [ router: capability-карта → локаль first; explore/exploit ]
142
- │ │ эскалация
177
+ router: capability-карта + reliability → локаль first; explore capped
178
+ │ │ эскалация → возврат к router
143
179
  │ ▼
144
- │ [ облачные модели (fallback / тяжёлая артиллерия) ]
180
+ │ [ облачные модели (fallback) ]
145
181
  ▼
146
- [ executor: OpenCode-агенты (локальные / облачные) ]
182
+ context compilation: окно модели + бюджет токенов (scaffolding + repo-map)
147
183
  │
148
- [ GATE: объективная верификация (tests/lint/schema/diff/cmd) ] ← keystone
149
- │ pass │ fail
150
- ▼ ▼
151
- [ ledger: savings/audit/metrics ] [ escalate / retry / rollback ]
184
+ executor: OpenCode-агенты, capability issuance (TTL), worktree/sandbox
185
+ внешние эффекты → intents (не применяются)
152
186
  │
153
- [ learning: capability-карта → scaffolding → eval → LoRA (staged) ]
187
+ GATE: hard, независимый, tamper-evident, flake-aware ← keystone
188
+ │ pass │ fail
189
+ ▼ ▼
190
+ применить intents → ledger escalate / retry / rollback
154
191
  │
155
- [ control plane: локальный, приватный, аудит, dashboard ]
192
+ learning: карта → scaffolding → eval → shadow/canary → LoRA (staged)
193
+ │
194
+ control plane: локальный, приватный, аудит, dashboard
195
+
196
+ [ РЕГИСТРАЦИЯ ТРИГГЕРА — опционально ]
197
+ Task Scheduler / crontab / launchd — только для registered-входа
156
198
  ```
157
199
 
158
- Локально-первым является **control plane и роутинг**; инференс — гибрид
159
- (локаль максимум, облако эскалация). Приватность = данные/аудит/управление
160
- локальны, а не «ни одного облачного токена».
200
+ Объекты: **миссия** — единица работы; **задача** — миссия-шаблон + триггер
201
+ (опциональна); **запуск** — durable-исполнение миссии.
202
+
203
+ Локально-первым является **control plane и роутинг**; инференс — гибрид.
204
+ Приватность = данные/аудит/управление локальны, а не «ни одного облачного токена».
161
205
 
162
206
  ## 8. Границы (чем НЕ является)
163
207
 
@@ -165,17 +209,19 @@
165
209
  - Не замена способной облачной модели на сложном: облако — эскалация.
166
210
  - Не отмена человеческого ревью критичного: гейт поднимает пол, не потолок.
167
211
  - Не облачный SaaS и не multi-machine: локальный control plane, одна машина.
168
- - Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и
169
- обвязка, не ядро.
212
+ - Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и обвязка.
213
+ - **Не «только планировщик»**: ad-hoc миссия без расписания — полноправный вход.
214
+ Регистрация в планировщике ОС опциональна; его недоступность не блокирует ядро.
170
215
 
171
216
  ## 9. Душа: flywheel
172
217
 
173
218
  Больше задач → больше локальных попыток → больше исходов гейта → точнее
174
- capability-карта и больше примеров → выше local success → больше экономия и
175
- сильнее адаптеры → ещё больше задач выгодно гнать через локаль.
219
+ capability-карта и больше примеров → **примеры инжектятся в контекст** → выше
220
+ local first_pass_rate → больше экономия и сильнее адаптеры → ещё больше задач
221
+ выгодно гнать через локаль.
176
222
 
177
- Этот цикл и есть продукт. Персональная, приватная, компаундящаяся capability —
178
- ров, которого нет ни у статичного облака, ни у OpenCode core, ни у swarm-ов.
223
+ Ключевое звено: примеры не просто копятся, а **используются** (context compilation).
224
+ Без него flywheel не крутится.
179
225
 
180
226
  ## 10. Реальность железа (ограничение, учтённое в дизайне)
181
227
 
@@ -184,59 +230,93 @@ capability-карта и больше примеров → выше local succes
184
230
  - инференс локально: QLoRA/квант 3–8B;
185
231
  - обучение: только QLoRA 3–4B, low-rank, накопленным gate-passed датасетом,
186
232
  пакетами, а не онлайн;
187
- - поэтому прокачка staged: сначала scaffolding/роутинг (дёшево, сразу),
188
- веса — когда датасет и железо позволяют.
233
+ - прокачка staged: сначала scaffolding/роутинг (дёшево, сразу), веса — когда
234
+ датасет и железо позволяют;
235
+ - context compilation обязателен: малое окно — не повод отказываться от задачи.
236
+
189
237
  Дизайн не зависит от конкретного железа: capability-карта и гейты работают и на
190
238
  слабой, и на сильной локали; меняется лишь доля задач, которую тянет локаль.
191
239
 
192
240
  ## 11. Как поймём, что пришли (definition of done концепции)
193
241
 
194
242
  Вертикальный срез работает end-to-end и измеримо:
195
- 1. ad-hoc миссия с явным гейтом принята и разложена;
196
- 2. шаги смаршрутированы локаль-first по capability-карте;
243
+
244
+ 1. **ad-hoc** миссия с явным гейтом и safety-контрактом принята, политика
245
+ скомпилирована, миссия разложена — **без регистрации в планировщике ОС**;
246
+ 2. шаги смаршрутированы локаль-first по capability-карте с учётом reliability;
197
247
  3. гейт объективно верифицировал; провал экалировался/откатился без тихих
198
- отказов;
248
+ отказов; irreversible не произошёл до pass;
199
249
  4. ledger показал честную net-экономию и escalation rate;
200
- 5. learning-loop обновил capability-карту и положил пример/scaffolding;
201
- 6. на фикс-наборе задач за N недель: local success_rate ↑ и net-экономия ↑
202
- при неизменном качестве (eval не деградировал).
250
+ 5. learning-loop обновил capability-карту, положил пример и **переиспользовал** его;
251
+ 6. паритет: та же спека через registered-вход даёт тот же маршрут и вердикт;
252
+ 7. на фикс-наборе задач за N недель: local success_rate и first_pass_rate ↑,
253
+ net-экономия ↑ при неизменном качестве (eval не деградировал).
203
254
 
204
- Когда 1–6 воспроизводимо — концепция достигнута; всё дальнейшее = масштаб
205
- (больше типов задач, больше машин, сильнее адаптеры).
255
+ Когда 1–7 воспроизводимо — концепция достигнута; всё дальнейшее = масштаб.
206
256
 
207
257
  ## 12. Открытые вопросы / риски (честно)
208
258
 
209
- - Качество локального вердикта на пограничных задачах → держим правила/пороги и
210
- shadow-режим, а не слепую веру модели.
211
- - Cost of verification (прогоны тестов) → учитывать в net-экономике, кэшировать.
259
+ - Качество локального вердикта на пограничных задачах → правила/пороги и
260
+ shadow-режим, а не слепая вера модели.
261
+ - Cost of verification → учитывать в net-экономике, кэшировать.
212
262
  - Explore может тратить впустую → capped explore-бюджет, bandit по типам задач.
213
263
  - Датасет для весов копится медленно → staged-прокачка, не обещать онлайн-LoRA.
214
- - Prompt-injection даже при gate → гейт + аудит + allowedTools как пол, а не
215
- потолок; критичное — человеку.
264
+ - Prompt-injection даже при гейте → гейт + аудит + allowedTools как пол;
265
+ внешний контент недоверенный по умолчанию; критичное — человеку.
266
+ - **Reward hacking**: агент правит тесты/гейт → snapshot + hash + права вне
267
+ write-scope; обязательный тест-атака в CI.
268
+ - **Irreversible до вердикта** → отложенные эффекты (intents) и компенсация.
269
+ - **Хеш-цепочка ledger** — tamper-evident аудит, **не** граница безопасности;
270
+ граница — права и изоляция.
271
+ - **Зависимости под гипотезы** → сначала переиспользуем существующее; новый
272
+ движок/БД только с доказанной необходимостью.
216
273
 
217
274
  ## 13. Стратегия развития: от плагина к фреймворку
218
275
 
219
- Наша эволюция строится на двух столпах и постепенной абстракции:
220
-
221
276
  ### 13.1 Локальный интеллект
222
277
 
223
- Максимум проверяемой работы на локальных моделях с компандингом (обучением на успешных гейтах). Локаль тянет ограниченные, хорошо сформулированные, объективно проверяемые задачи — масса реальной рутины. Объективный гейт (тесты, линт, схема, diff-applies) дёшев и не врёт, поэтому локаль направляется на максимум задач: брак ловится и эскалируется, а не уезжает в прод. Исходы гейта — бесплатная разметка, которая учит роутинг и копит gate-passed датасет.
278
+ Максимум проверяемой работы на локальных моделях с компандингом. Объективный
279
+ гейт дёшев и не врёт, поэтому локаль направляется на максимум задач: брак
280
+ ловится и эскалируется. Исходы гейта — бесплатная разметка.
224
281
 
225
282
  ### 13.2 Мультиагентная оркестрация
226
283
 
227
- Ролевая декомпозиция миссий на шаги (planner → implementer → reviewer …). Каждый шаг назначается самому дешёвому способному исполнителю — локаль first, облако только при провале гейта. Облако используется для эскалации сложных задач, обеспечивая экономию и приватность.
284
+ Ролевая декомпозиция миссий на шаги. Каждый шаг — самому дешёвому способному
285
+ исполнителю; облако только при провале гейта.
228
286
 
229
287
  ### 13.3 Непрерывное улучшение Control Plane
230
288
 
231
- Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) — это фундамент доверия, а не отдельный продукт. Он дорабатывается наравне с ядром: локальность, приватность, наблюдаемость, гарантии отсутствия тихих отказов.
289
+ Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) —
290
+ фундамент доверия, а не отдельный продукт. Дорабатывается наравне с ядром.
232
291
 
233
292
  ### 13.4 Путь к универсальности
234
293
 
235
- - **Этап 1:** глубокая интеграция с OpenCode V1 и V2 (текущий): один пакет, dual export, общее ядро.
236
- - **Этап 2:** абстракция слоя исполнения (Agent Executor Interface).
237
- - **Этап 3:** универсальный фреймворк оркестрации, совместимый с любым агентом через MCP или стандартные API.
294
+ - **Этап 1 (текущий):** глубокая интеграция с OpenCode V1 и V2 — один пакет,
295
+ dual export, общее ядро.
296
+ - **Этап 2:** выделение mission runtime, независимого от планировщика ОС, и
297
+ абстракция слоя исполнения (Agent Executor Interface).
298
+ - **Этап 3:** универсальный фреймворк оркестрации, совместимый с любым агентом
299
+ через MCP или стандартные API; интероперабельность — через стабильные форматы
300
+ (pipeline YAML, SQLite ledger) и MCP, а не через соответствие чужим схемам слоёв.
301
+
302
+ ## 14. Продукт для людей (не на продажу)
303
+
304
+ - **Суверенитет пользователя.** Данные локальны и экспортируемы; роутинг
305
+ переопределяем; обучение отключаемо; без аккаунтов, SaaS и телеметрии.
306
+ - **Свобода сценария.** Можно жить без расписаний, можно на расписаниях, можно
307
+ смешивать. Одноразовая работа не требует регистрации задачи.
308
+ - **Честность.** «Сэкономлено $» — консервативная оценка с методикой рядом;
309
+ метрики воспроизводимы из ledger. Термин — tamper-evident, не tamper-proof.
310
+ - **Низкий порог.** Работает на скромном железе, безопасно по умолчанию,
311
+ понятные дефолты, документация на нескольких языках.
312
+ - **Долговечность.** Скучные технологии, мало зависимостей, стабильные форматы,
313
+ дисциплина миграций: через годы оно всё ещё запускается.
314
+ - **Открытость.** Открытые форматы pipeline и ledger, библиотека рецептов,
315
+ skill-экосистема — сообщество расширяет без maintainer'а.
316
+ - **Пол, не потолок.** Гейт и approval поднимают минимальную планку качества и
317
+ безопасности; критичные решения остаются за человеком.
238
318
 
239
319
  ---
240
320
 
241
321
  *Любое изменение в репозитории, которое не двигает хотя бы один столп из §4 и
242
- не согласуется с §8, — не цель, а шум.*
322
+ не согласуется с §8, — не цель, а шум.*
@@ -0,0 +1,196 @@
1
+ # EXECUTION-LOOP — цикл v2.1 (спринты 38–43)
2
+
3
+ > Спека исполнительного цикла. North star: [CONCEPT.md](./CONCEPT.md) §6, §11.
4
+ > Безопасность: [SAFETY.md](./SAFETY.md). Статус компонентов: [ROADMAP.md](../ROADMAP.md) §1.
5
+
6
+ ## 1. Разрыв, который закрываем
7
+
8
+ Построено модулями (спринт 36), но не течёт в живом пути:
9
+
10
+ - **Два мира исполнения.** Планировщик: `wrapper → opencode run → record-history → history`. Durable DAG: `runs/run_steps → resumeRun`. Запланированная задача не создаёт durable-run.
11
+ - **Роутер не вызывается live.** `routeStep` / `decideCapabilityRoute` отсутствуют в `index.ts` / `record-history.ts`.
12
+ - **Карта не обучается.** `recordCapabilityOutcome` не вызывается из горячего пути.
13
+ - **Эскалация не живая.** `escalateAfterGate` есть, но провал гейта идёт в retry/chain.
14
+ - **Нет ad-hoc входа.** Любой запуск требует регистрации: `schedule_task` + `run_task_now`; `once` — это `at` / `schtasks ONCE` / launchd. Цепочки/DAG/retry обходят расписание костылём force-маркера.
15
+
16
+ Не построено вовсе: ledger + provenance; класс риска и компиляция политики;
17
+ бюджет миссии; целостность гейта, flake-aware, отложенные эффекты; context
18
+ compilation, repo-map, инъекция scaffolding; worktree/sandbox, egress-контроль,
19
+ approvals-очередь.
20
+
21
+ Подтверждение:
22
+
23
+ ```bash
24
+ grep -rn "routeStep\|recordCapabilityOutcome\|escalateAfterGate\|planMission" \
25
+ src/index.ts src/core/record-history.ts src/core/ps-wrapper.ts src/core/wrappers/bash.ts
26
+ grep -rn "createRun\|runs-repo" src/core/record-history.ts
27
+ ```
28
+
29
+ ## 2. Целевой кровоток
30
+
31
+ ```
32
+ вход (ad-hoc / внутренний / registered)
33
+ → intake (gate-спека + safety) → компиляция политики → approval?
34
+ → createRun (durable, trigger_kind) → planner (декомпозиция)
35
+ → для каждого шага:
36
+ routeStep (static → capability, reliability, explore capped)
37
+ → context compilation (окно модели + бюджет токенов)
38
+ → capability issuance (TTL) → исполнение (worktree/sandbox)
39
+ внешние эффекты → effect_intents (не применяются)
40
+ → GATE (hard, независимый, tamper-evident, flake-aware)
41
+ pass → применить intents → ledger → карта → пример
42
+ fail → escalate / retry / rollback → к роутингу
43
+ → артефакт (diff/PR) → отчёт из ledger → обучение
44
+
45
+ сквозные: телеметрия (span/шаг) · живой бюджет · аудит · durable state
46
+ ```
47
+
48
+ ## 2.1 Классы входа (гибрид)
49
+
50
+ | Класс | Вход | Регистрация в ОС | Catch-up | Pause расписания |
51
+ |---|---|---|---|---|
52
+ | **Ad-hoc** | `run_mission` / CLI / GUI / RPC | нет | нет | нет (пауза run'а есть) |
53
+ | **Внутренний** | chain / DAG / retry / escalation | нет | нет | нет |
54
+ | **Registered** | cron / once / file / git / mcp-event / webhook | да (cron/once) | да | да |
55
+
56
+ Все три класса проходят **один** runtime. Различаются только источником триггера
57
+ и персистентностью шаблона.
58
+
59
+ Инварианты:
60
+
61
+ 1. Ad-hoc исполняется без единой записи в планировщике ОС.
62
+ 2. Ad-hoc не обходит gate, политику, бюджет, ledger и аудит.
63
+ 3. Внутренние запуски не консультируются с расписанием (force-маркер не нужен структурно).
64
+ 4. Одинаковая спека через ad-hoc и registered даёт одинаковый маршрут и вердикт.
65
+ 5. `trigger_kind` пишется в run и ledger; метрики честно разделяют классы входа.
66
+ 6. Недоступность планировщика ОС не блокирует ad-hoc.
67
+
68
+ Lock/no-overlap для ad-hoc — по run/mission id и по workspace (не по имени задачи);
69
+ изоляция worktree предотвращает конкуренцию двух миссий в одном репо.
70
+
71
+ ## 2.2 Объекты
72
+
73
+ | Объект | Что это | Персистентность |
74
+ |---|---|---|
75
+ | **Миссия** | цель + scope + gate-спека + safety + бюджет | опциональный шаблон; snapshot всегда в run |
76
+ | **Задача** | миссия-шаблон + регистрация триггера | только для registered |
77
+ | **Запуск** | durable-исполнение: шаги, попытки, вердикты | всегда |
78
+
79
+ ## 3. Ledger (append-only, источник правды)
80
+
81
+ ```sql
82
+ CREATE TABLE gate_outcomes (
83
+ id INTEGER PRIMARY KEY,
84
+ mission_id TEXT, run_id TEXT, step_id TEXT, task_type TEXT,
85
+ trigger_kind TEXT, -- adhoc | chain | dag | retry | escalation | cron | once | file | git | mcp | webhook
86
+ executor TEXT, -- local / cloud / model-id
87
+ route_source TEXT, -- static | capability | explore
88
+ route_reason TEXT,
89
+ gate_type TEXT, -- cmd | tests | lint | schema | diff | approval
90
+ verdict TEXT, -- pass | fail | flake | infra_fail
91
+ attempts_to_pass INTEGER, first_pass INTEGER,
92
+ evidence_path TEXT,
93
+ gate_hash TEXT, policy_hash TEXT, prompt_hash TEXT,
94
+ model_version TEXT, tool_versions TEXT,
95
+ effect_intents TEXT, -- JSON: заявленные внешние эффекты
96
+ effects_applied_at TEXT, -- NULL, пока гейт не пройден
97
+ tokens INTEGER, cost_usd REAL,
98
+ counterfactual_cost_usd REAL, verification_cost_usd REAL,
99
+ net_savings_usd REAL,
100
+ time_ms INTEGER, overhead_ms INTEGER,
101
+ escalation_from TEXT, escalation_to TEXT,
102
+ example_ref TEXT, training_record_ref TEXT,
103
+ prev_hash TEXT, -- хеш-цепочка: tamper-evident аудит
104
+ created_at TEXT
105
+ );
106
+ ```
107
+
108
+ - `capability_map` — агрегат по ledger, не отдельная правда.
109
+ - Отчёт (43) и датасет (48) читают **только** ledger.
110
+ - Нет ledger-строки — нет запуска.
111
+ - `prev_hash` даёт **tamper-evident** аудит: подделка заметна. Это **не граница
112
+ безопасности** — у кого есть запись в файл, тот перепишет цепочку. Граница —
113
+ изоляция прав и snapshot гейта.
114
+
115
+ ### Поля capability_map (расширение)
116
+
117
+ `first_pass_rate REAL`, `avg_attempts REAL`, `decay_updated_at TEXT` (EWMA),
118
+ `parent_type TEXT` (иерархия при малых данных).
119
+
120
+ ## 4. Целостность гейта (спринт 39)
121
+
122
+ - Gate-файлы и команда вне write-scope агента; snapshot фиксируется на старте миссии.
123
+ - `gate_hash` и `policy_hash` пишутся в ledger и сверяются перед вердиктом;
124
+ расхождение → `fail` + аудит-инцидент.
125
+ - Gate-executor отделён от агента; артефакт применяется к защищённому дереву.
126
+ - **Гейт всегда hard.** Shadow/canary — только для маршрутов и адаптеров (49).
127
+ - **Тест-атака обязательна:** агент правит тесты → гейт обязан провалить.
128
+
129
+ ## 5. Отложенные внешние эффекты
130
+
131
+ Worktree не защищает от сети/API/БД. Поэтому:
132
+
133
+ 1. До гейта агент **не выполняет** irreversible-действие, а пишет `effect_intents`.
134
+ 2. Гейт проверяет артефакт **и** валидность intents (политика, egress, blast-radius).
135
+ 3. `pass` → применение intents, запись `effects_applied_at`.
136
+ 4. `fail` → discard intents; частично применённые — компенсация (saga, спринт 42).
137
+
138
+ ## 6. Flake-aware вердикт
139
+
140
+ - Повтор гейта на том же артефакте (N=2) при подозрении на флак.
141
+ - verdict `fail` (вина агента) vs `flake` / `infra_fail` (шум/инфра).
142
+ - `flake` и `infra_fail` **не обучают** capability-карту.
143
+ - Quarantine стабильно флакующих гейтов + предупреждение пользователю.
144
+ - `attempts_to_pass` и `first_pass` пишутся всегда.
145
+
146
+ ## 7. Роутинг, бюджет, issuance
147
+
148
+ - `routeStep(taskType)` до сборки контекста; `explore` — с capped бюджетом.
149
+ - Решение учитывает `first_pass_rate`, `avg_attempts`, EWMA-decay; мало данных → `parent_type`.
150
+ - **Живой бюджет** в durable-run: $ / токены / время / эскалации. При подходе к
151
+ границе — даунгрейд модели или `review`; превышение → circuit-breaker.
152
+ - **Capability issuance на шаг**: scoped-конфиг + короткоживущие секреты, очистка
153
+ после шага. База — существующие `permissions` и scoped-инъекция секретов.
154
+
155
+ ## 8. Context compilation (спринт 41)
156
+
157
+ - Выполняется **после роутинга**: окно и бюджет токенов зависят от исполнителя.
158
+ - Пересборка при эскалации (другая модель → другое окно).
159
+ - Repo-map + отбор файлов + gate-passed примеры по типу задачи; дедуп, лимит,
160
+ scrub секретов.
161
+ - Retrieval — bag-of-words векторы (подход `notification_embeddings`), без вектор-БД.
162
+
163
+ ## 9. Приёмка (= CONCEPT §11)
164
+
165
+ 1. Ad-hoc миссия с gate-спекой и safety-контрактом принята, политика скомпилирована,
166
+ планировщик ОС не изменён.
167
+ 2. Шаги смаршрутированы local-first с учётом reliability.
168
+ 3. Гейт объективно верифицировал; провал экалировался/откатился без тихих отказов;
169
+ irreversible не произошёл до pass.
170
+ 4. Ledger показал честную net-экономию и escalation rate.
171
+ 5. Карта обновилась, пример сохранён и переиспользован.
172
+ 6. Паритет: та же спека через registered даёт тот же маршрут и вердикт.
173
+
174
+ Тесты: E2E всего среза + chaos (`kill -9` посреди миссии) + атака на гейт +
175
+ попытка irreversible до pass + недоступность планировщика ОС.
176
+
177
+ ## 10. Архитектурные решения: что отклонено и почему
178
+
179
+ | Предложение | Решение | Причина |
180
+ |---|---|---|
181
+ | Soft-gate / canary для **приёмки** артефакта | ❌ отклонено | Ослабляет keystone: побочные эффекты по «мягкому» вердикту. Canary — только маршруты и адаптеры (49). |
182
+ | AOCL как нормативная модель слоёв | ❌ не опираемся | Стандарт не подтверждён. Интероперабельность — через MCP (уже используется) и стабильные форматы YAML/SQLite. |
183
+ | OPA/Rego или Cedar как движок политик | ⏸ отложено | Внешняя зависимость против «мало deps / одна машина». Достаточно компилятора политики в существующий enforcement. |
184
+ | Hash-linked ledger как «доказуемость» | ✅ переформулировано | **tamper-evident аудит**, не граница безопасности. |
185
+ | Вектор-БД / «динамический RAG» | ❌ отклонено | Durable state уже есть; retrieval — на существующих bag-of-words векторах. |
186
+ | Capability-токены как OAuth/JWT | ⏸ упрощено | Локальная одна машина: scoped-конфиг + TTL-секреты дают тот же эффект без инфраструктуры. |
187
+ | «Сначала зарегистрируй задачу» для одноразовой работы | ❌ отклонено | Гибрид: ad-hoc — полноправный вход; регистрация опциональна. |
188
+
189
+ ## 11. Границы (CONCEPT §8)
190
+
191
+ - Миссии ограниченные, с явным критерием; не open-ended swarm.
192
+ - Облако — эскалация, не замена способной модели.
193
+ - Локальный control plane, одна машина; базовый путь работает без Docker и без
194
+ локальной модели.
195
+ - Планировщик ОС опционален; его недоступность не блокирует ядро.
196
+ - Критичное — человеку: гейт поднимает пол, не потолок.