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.
- package/CHANGELOG.md +20 -0
- package/README.md +3 -3
- package/ROADMAP-STRATEGY.md +9 -9
- package/ROADMAP.md +50 -34
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +18 -1
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +97 -22
- package/dist/core/one-shot.d.ts +5 -1
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +33 -8
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- package/dist/core/ps-wrapper.d.ts +1 -1
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +11 -1
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +56 -32
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +85 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +34 -0
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +91 -5
- package/dist/core/scheduler/at-fallback.d.ts +55 -2
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
- package/dist/core/scheduler/at-fallback.js +135 -5
- package/dist/core/scheduler/linux.d.ts +10 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +29 -11
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +25 -1
- package/dist/core/scheduler/registry.d.ts +11 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +125 -28
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +49 -4
- package/dist/db/capability-repo.d.ts +83 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +182 -0
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +19 -0
- package/dist/db/index.d.ts +4 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +39 -1
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-resume.d.ts +5 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +30 -11
- package/dist/db/runs-repo.d.ts +13 -5
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +28 -5
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +154 -2
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/index.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +102 -4
- package/dist/rpc.d.ts +678 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +235 -0
- package/dist/server.d.ts +31 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +95 -35
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +7 -0
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +43 -8
- package/docs/ARCHITECTURE.md +229 -5
- package/docs/CONCEPT.md +171 -91
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/README.ru.md +2 -2
- package/docs/README.zh.md +3 -3
- package/docs/SAFETY.md +122 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/gui-experimental.cjs +8 -8
- package/locales/en.json +67 -0
- package/locales/ru.json +67 -0
- package/locales/zh.json +67 -0
- package/package.json +28 -3
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +25 -1
- package/src/core/lock.ts +95 -22
- package/src/core/one-shot.ts +36 -8
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/ps-wrapper.ts +11 -1
- package/src/core/record-history.ts +75 -37
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +109 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +6 -2
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +32 -10
- package/src/core/scheduler/posix.ts +20 -1
- package/src/core/scheduler/registry.ts +107 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/secrets.ts +127 -27
- package/src/core/session.ts +23 -10
- package/src/core/task-name.ts +67 -0
- package/src/core/wrappers/bash.ts +49 -4
- package/src/db/capability-repo.ts +285 -0
- package/src/db/history-repo.ts +22 -0
- package/src/db/index.ts +37 -1
- package/src/db/migrate.ts +3 -1
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-resume.ts +48 -12
- package/src/db/runs-repo.ts +30 -7
- package/src/db/schema.ts +154 -2
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +515 -0
- package/src/index.ts +124 -4
- package/src/rpc.ts +251 -0
- package/src/server.ts +112 -36
- package/src/types.ts +9 -0
- package/src/workspaces.ts +58 -9
package/docs/CONCEPT.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# CONCEPT — Верифицируемая локально-первая оркестрация агент-задач
|
|
2
2
|
|
|
3
|
-
> Статус:
|
|
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 даёт агентов, но не даёт супервизии:
|
|
36
|
-
|
|
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
|
-
|
|
51
|
+
- Исходы гейта — **бесплатная разметка**: они учат роутинг и копят gate-passed
|
|
52
|
+
датасет для прокачки весов.
|
|
53
53
|
|
|
54
54
|
Проверка — не надзор, а **двигатель экономики и обучения**.
|
|
55
55
|
|
|
56
56
|
## 3. Что это такое
|
|
57
57
|
|
|
58
58
|
**Фреймворк-супервизор поверх OpenCode**: локальный control plane, который
|
|
59
|
-
принимает миссии
|
|
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
|
-
Четыре столпа.
|
|
73
|
-
**надёжно > приватно > дёшево > краткосрочные
|
|
73
|
+
Четыре столпа. При конфликте порядок:
|
|
74
|
+
**надёжно > приватно > дёшево > краткосрочные фичи**; explore — управляемая
|
|
74
75
|
инвестиция «дёшево-сегодня» в «компаунд-завтра».
|
|
75
76
|
|
|
76
77
|
| Столп | Что значит | Метрика |
|
|
77
78
|
|---|---|---|
|
|
78
|
-
|
|
|
79
|
+
| **Надёжно** | ноль тихих отказов / двойных прогонов / fake-done / порчи репо | trust-инциденты = 0; гейт независим и tamper-evident; полнота аудита |
|
|
79
80
|
| **Приватно** | control plane, данные, аудит, triage локальны | % инференса/данных локально; cloud-egress только explicit и залогирован |
|
|
80
|
-
|
|
|
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
|
|
105
|
-
|
|
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
|
-
-
|
|
110
|
-
|
|
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-карта
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
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
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
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
|
-
[
|
|
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
|
-
|
|
173
|
+
createRun (durable, trigger_kind)
|
|
138
174
|
│
|
|
139
|
-
|
|
175
|
+
planner: декомпозиция на шаги/роли
|
|
140
176
|
│
|
|
141
|
-
|
|
142
|
-
│ │ эскалация
|
|
177
|
+
router: capability-карта + reliability → локаль first; explore capped
|
|
178
|
+
│ │ эскалация → возврат к router
|
|
143
179
|
│ ▼
|
|
144
|
-
│ [ облачные модели (fallback
|
|
180
|
+
│ [ облачные модели (fallback) ]
|
|
145
181
|
▼
|
|
146
|
-
|
|
182
|
+
context compilation: окно модели + бюджет токенов (scaffolding + repo-map)
|
|
147
183
|
│
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
▼ ▼
|
|
151
|
-
[ ledger: savings/audit/metrics ] [ escalate / retry / rollback ]
|
|
184
|
+
executor: OpenCode-агенты, capability issuance (TTL), worktree/sandbox
|
|
185
|
+
внешние эффекты → intents (не применяются)
|
|
152
186
|
│
|
|
153
|
-
|
|
187
|
+
GATE: hard, независимый, tamper-evident, flake-aware ← keystone
|
|
188
|
+
│ pass │ fail
|
|
189
|
+
▼ ▼
|
|
190
|
+
применить intents → ledger escalate / retry / rollback
|
|
154
191
|
│
|
|
155
|
-
|
|
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
|
-
|
|
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-карта и больше примеров →
|
|
175
|
-
сильнее адаптеры → ещё больше задач
|
|
219
|
+
capability-карта и больше примеров → **примеры инжектятся в контекст** → выше
|
|
220
|
+
local first_pass_rate → больше экономия и сильнее адаптеры → ещё больше задач
|
|
221
|
+
выгодно гнать через локаль.
|
|
176
222
|
|
|
177
|
-
|
|
178
|
-
|
|
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
|
-
-
|
|
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
|
-
|
|
196
|
-
|
|
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
|
|
201
|
-
6.
|
|
202
|
-
|
|
250
|
+
5. learning-loop обновил capability-карту, положил пример и **переиспользовал** его;
|
|
251
|
+
6. паритет: та же спека через registered-вход даёт тот же маршрут и вердикт;
|
|
252
|
+
7. на фикс-наборе задач за N недель: local success_rate и first_pass_rate ↑,
|
|
253
|
+
net-экономия ↑ при неизменном качестве (eval не деградировал).
|
|
203
254
|
|
|
204
|
-
Когда 1–
|
|
205
|
-
(больше типов задач, больше машин, сильнее адаптеры).
|
|
255
|
+
Когда 1–7 воспроизводимо — концепция достигнута; всё дальнейшее = масштаб.
|
|
206
256
|
|
|
207
257
|
## 12. Открытые вопросы / риски (честно)
|
|
208
258
|
|
|
209
|
-
- Качество локального вердикта на пограничных задачах →
|
|
210
|
-
shadow-режим, а не
|
|
211
|
-
- Cost of verification
|
|
259
|
+
- Качество локального вердикта на пограничных задачах → правила/пороги и
|
|
260
|
+
shadow-режим, а не слепая вера модели.
|
|
261
|
+
- Cost of verification → учитывать в net-экономике, кэшировать.
|
|
212
262
|
- Explore может тратить впустую → capped explore-бюджет, bandit по типам задач.
|
|
213
263
|
- Датасет для весов копится медленно → staged-прокачка, не обещать онлайн-LoRA.
|
|
214
|
-
- Prompt-injection даже при
|
|
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
|
-
Максимум проверяемой работы на локальных моделях с
|
|
278
|
+
Максимум проверяемой работы на локальных моделях с компандингом. Объективный
|
|
279
|
+
гейт дёшев и не врёт, поэтому локаль направляется на максимум задач: брак
|
|
280
|
+
ловится и эскалируется. Исходы гейта — бесплатная разметка.
|
|
224
281
|
|
|
225
282
|
### 13.2 Мультиагентная оркестрация
|
|
226
283
|
|
|
227
|
-
Ролевая декомпозиция миссий на
|
|
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
|
|
236
|
-
|
|
237
|
-
- **Этап
|
|
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
|
+
- Критичное — человеку: гейт поднимает пол, не потолок.
|