agent-steward 0.0.3 → 0.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +154 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +54 -9
- package/ROADMAP-STRATEGY.md +23 -20
- package/ROADMAP.md +140 -143
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +351 -0
- 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/execution.d.ts +203 -0
- package/dist/core/execution.d.ts.map +1 -0
- package/dist/core/execution.js +309 -0
- package/dist/core/gate-integrity.d.ts +35 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +132 -0
- package/dist/core/git-trigger.d.ts.map +1 -1
- package/dist/core/git-trigger.js +14 -2
- package/dist/core/guard-run.d.ts +4 -0
- package/dist/core/guard-run.d.ts.map +1 -0
- package/dist/core/guard-run.js +101 -0
- package/dist/core/guard.d.ts +52 -0
- package/dist/core/guard.d.ts.map +1 -0
- package/dist/core/guard.js +362 -0
- package/dist/core/lock.d.ts +61 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +213 -26
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +75 -15
- package/dist/core/mission.d.ts +83 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +334 -0
- 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/pipeline-apply.d.ts +38 -0
- package/dist/core/pipeline-apply.d.ts.map +1 -0
- package/dist/core/pipeline-apply.js +117 -0
- package/dist/core/pipeline-io.d.ts +13 -0
- package/dist/core/pipeline-io.d.ts.map +1 -0
- package/dist/core/pipeline-io.js +64 -0
- package/dist/core/pipeline-map.d.ts +46 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +196 -0
- package/dist/core/pipeline-spec.d.ts +109 -0
- package/dist/core/pipeline-spec.d.ts.map +1 -0
- package/dist/core/pipeline-spec.js +554 -0
- package/dist/core/ps-wrapper.d.ts +19 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +261 -63
- 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 +183 -58
- 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 +91 -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 +18 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +63 -20
- package/dist/core/scheduler/mac.d.ts +44 -2
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +126 -15
- 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/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +15 -12
- 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/structured-log.d.ts +7 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- 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/worktree-run.d.ts +4 -0
- package/dist/core/worktree-run.d.ts.map +1 -0
- package/dist/core/worktree-run.js +164 -0
- package/dist/core/worktree.d.ts +115 -0
- package/dist/core/worktree.d.ts.map +1 -0
- package/dist/core/worktree.js +462 -0
- package/dist/core/wrappers/bash.d.ts +17 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +224 -28
- package/dist/db/capability-repo.d.ts +124 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +267 -0
- package/dist/db/history-repo.d.ts +46 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +107 -25
- 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/metrics-repo.js +2 -2
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +5 -4
- 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-journal.d.ts +33 -5
- package/dist/db/run-journal.d.ts.map +1 -1
- package/dist/db/run-journal.js +78 -14
- package/dist/db/run-resume.d.ts +10 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +39 -13
- package/dist/db/runs-repo.d.ts +32 -7
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +50 -11
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +216 -3
- 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/history.d.ts +1 -1
- package/dist/history.d.ts.map +1 -1
- package/dist/i18n.d.ts +5 -0
- package/dist/i18n.d.ts.map +1 -1
- package/dist/i18n.js +11 -4
- package/dist/index.d.ts +140 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +480 -18
- package/dist/notifications.d.ts +22 -0
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +36 -8
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +25 -4
- package/dist/rpc.d.ts +924 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +352 -0
- package/dist/server.d.ts +46 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +172 -53
- package/dist/settings.d.ts +2 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +3 -3
- package/dist/shared/jobs-view.d.ts +1 -1
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/shared/jobs-view.js +2 -0
- package/dist/task-transfer.d.ts +16 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +16 -0
- 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 +498 -58
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +185 -91
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +211 -0
- package/docs/FEATURES.md +65 -4
- package/docs/FEATURES.zh.md +52 -4
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/README.ru.md +44 -5
- package/docs/README.zh.md +46 -6
- package/docs/SAFETY.md +142 -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 +9 -8
- package/locales/en.json +84 -1
- package/locales/ru.json +84 -1
- package/locales/zh.json +84 -1
- package/opencode.pipeline.yaml +35 -0
- package/package.json +46 -2
- package/scripts/audit-bundle.mjs +215 -0
- package/scripts/test-home.mjs +83 -0
- package/src/cli.ts +412 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +27 -3
- package/src/core/execution.ts +538 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +160 -0
- package/src/core/git-trigger.ts +18 -5
- package/src/core/guard-run.ts +119 -0
- package/src/core/guard.ts +431 -0
- package/src/core/lock.ts +244 -30
- package/src/core/matrix.ts +95 -50
- package/src/core/mission.ts +485 -0
- package/src/core/native-notify.ts +1 -1
- 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/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +79 -0
- package/src/core/pipeline-map.ts +264 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +274 -64
- package/src/core/record-history.ts +229 -104
- 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 +115 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +7 -3
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +72 -21
- package/src/core/scheduler/logs.ts +2 -2
- package/src/core/scheduler/mac.ts +174 -14
- 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/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +131 -31
- package/src/core/session.ts +23 -10
- package/src/core/structured-log.ts +22 -5
- package/src/core/task-name.ts +67 -0
- package/src/core/telegram.ts +2 -2
- package/src/core/triage-worker.ts +7 -7
- package/src/core/triage.ts +2 -2
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +239 -27
- package/src/db/capability-repo.ts +402 -0
- package/src/db/history-repo.ts +151 -22
- package/src/db/index.ts +37 -1
- package/src/db/metrics-repo.ts +2 -2
- package/src/db/migrate.ts +3 -1
- package/src/db/recovery.ts +5 -4
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +65 -13
- package/src/db/runs-repo.ts +66 -13
- package/src/db/schema.ts +218 -3
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +692 -13
- package/src/history.ts +1 -1
- package/src/i18n.ts +12 -4
- package/src/index.ts +648 -8
- package/src/notifications.ts +38 -8
- package/src/profiles.ts +26 -4
- package/src/rpc.ts +379 -0
- package/src/server.ts +206 -54
- package/src/settings.ts +5 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +31 -0
- package/src/types.ts +9 -0
- package/src/workspaces.ts +58 -9
package/docs/COMPATIBILITY.md
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
|
|
16
16
|
| Возможность | V1 (`>=1.18.29`) | V2 (`>=2.2.7`) | Комментарий |
|
|
17
17
|
|---|---|---|---|
|
|
18
|
-
|
|
|
18
|
+
| 29 инструментов агента | да, `tool()`; без `options.codemode` | да, `ctx.tool.transform`; `options: { codemode: true }` | имена, схемы и обработчики совпадают |
|
|
19
19
|
| Хуки (tool / session / event / config) | да, строковые ключи в `Hooks` | да, типизированные домены `ctx.*` | API есть, но плагин его **не использует** — см. ниже |
|
|
20
20
|
| TUI-панель «Планировщик» | да, `src/tui-v1.tsx`; маршрут `/scheduler` + снимок в сайдбаре | да, `src/tui.tsx`; reactive store | **обе линии**, один модуль `./tui` |
|
|
21
21
|
| GUI-панель | **нет** | да | subpath `@opencode/plugin/gui` в V1 отсутствует |
|
|
@@ -102,7 +102,7 @@ SDK — совместимость мажора проверяется в `test-
|
|
|
102
102
|
|
|
103
103
|
| Проверка | Что покрывает |
|
|
104
104
|
|---|---|
|
|
105
|
-
| `test-dual-entry.mjs` | форму default export (`id`, `setup`, `server`), `createV1Hooks` → `tool` + `dispose`,
|
|
105
|
+
| `test-dual-entry.mjs` | форму default export (`id`, `setup`, `server`), `createV1Hooks` → `tool` + `dispose`, 29 инструментов, совпадение имён с V2-реестром `createToolHandlers`, кросс-версию zod |
|
|
106
106
|
| `test-v1-integration.mjs` | реальный V1-путь: `server({ directory })`, изолированные `OPENCODE_SCHEDULER_HOME` и порт дашборда, три read-only инструмента, повторный `dispose` |
|
|
107
107
|
| `test-docs.mjs` | контракт в документации и коде: `exports["./tui"]`, `sidebar_content`, ключи `plugin`/`plugins`, инварианты состояния |
|
|
108
108
|
| CI `compat-v1` / `compat-v2` | отдельные jobs: V1 SDK `1.19.x` и V2 SDK `2.3.0` (устанавливается поверх `2.2.7`), не блокируют матрицу трёх ОС |
|
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,59 @@
|
|
|
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
|
+
Это независимый список свойств системы, а не формула приоритетов.
|
|
75
|
+
|
|
76
|
+
Формула приоритетов при конфликте — другая вещь:
|
|
77
|
+
**надёжно > приватно > дёшево > краткосрочные фичи**. Её последний член —
|
|
78
|
+
**не четвёртый столп**: это то, чем жертвуют в первую очередь. Четвёртый
|
|
79
|
+
столп «Компаундится» не противопоставлен «краткосрочным фичам», а накапливается
|
|
80
|
+
за счёт того, что краткосрочные фичи откладываются. `explore` — управляемая
|
|
74
81
|
инвестиция «дёшево-сегодня» в «компаунд-завтра».
|
|
75
82
|
|
|
76
83
|
| Столп | Что значит | Метрика |
|
|
77
84
|
|---|---|---|
|
|
78
|
-
|
|
|
85
|
+
| **Надёжно** | ноль тихих отказов / двойных прогонов / fake-done / порчи репо | trust-инциденты = 0; гейт независим и tamper-evident; полнота аудита |
|
|
79
86
|
| **Приватно** | control plane, данные, аудит, triage локальны | % инференса/данных локально; cloud-egress только explicit и залогирован |
|
|
80
|
-
|
|
|
81
|
-
| **Компаундится** | success rate и экономия растут под пользователя | тренд local success_rate ↑, eval-lift адаптеров, рост scaffolding
|
|
87
|
+
| **Дёшево** | локаль закрывает максимум gate-able задач | net-экономия (минус верификация/эскалации/overhead), local share, escalation rate |
|
|
88
|
+
| **Компаундится** | success rate и экономия растут под пользователя | тренд local success_rate и first_pass_rate ↑, eval-lift адаптеров, рост scaffolding |
|
|
82
89
|
|
|
83
90
|
Цель одним предложением: **разработчик оставляет AI-агентам свою рутину —
|
|
84
|
-
дёшево, приватно,
|
|
85
|
-
лучше и дешевле именно под его задачи.**
|
|
91
|
+
дёшево, приватно, надёжно, когда сам захочет или по расписанию — и его локальный
|
|
92
|
+
сетап с каждой неделей работает лучше и дешевле именно под его задачи.**
|
|
86
93
|
|
|
87
94
|
## 5. Способности (что он делает)
|
|
88
95
|
|
|
89
96
|
- **Миссия** = цель + scope + явный критерий приёмки (гейт). Без критерия —
|
|
90
97
|
не миссия, а лотерея.
|
|
98
|
+
- **Гибридные входы**: ad-hoc (инструмент/CLI/GUI/RPC), внутренние (цепочка, DAG,
|
|
99
|
+
retry, эскалация), registered (cron, once, file, git, mcp-event, webhook).
|
|
100
|
+
Регистрация в планировщике ОС **опциональна**.
|
|
91
101
|
- **Декомпозиция** на шаги/роли (planner → implementer → reviewer …).
|
|
92
102
|
- **Capability-aware роутинг (3 слоя)**:
|
|
93
|
-
- **Слой 1 — статические правила (0 токенов, мгновенно):**
|
|
103
|
+
- **Слой 1 — статические правила (0 токенов, мгновенно):**
|
|
94
104
|
```json
|
|
95
105
|
{
|
|
96
106
|
"read_file": { "transport": "direct", "executor": "local" },
|
|
@@ -101,63 +111,103 @@
|
|
|
101
111
|
"jira_update_task": { "transport": "mcp", "executor": "cloud" }
|
|
102
112
|
}
|
|
103
113
|
```
|
|
104
|
-
- **Слой 2 — Capability Map (0
|
|
105
|
-
|
|
114
|
+
- **Слой 2 — Capability Map (0 токенов):** SQLite `task_type → model /
|
|
115
|
+
success_rate / first_pass_rate / avg_attempts / avg_cost / avg_time /
|
|
116
|
+
last_10_runs`. Обучается на исходах гейта, с затуханием старых данных.
|
|
117
|
+
Высокая надёжность → локаль; низкая → облако или ревью.
|
|
118
|
+
- **Слой 3 — локальная модель (только декомпозиция и неоднозначность):**
|
|
119
|
+
модель не маршрутизирует каждый шаг.
|
|
106
120
|
- **Эскалация при провале гейта — по правилу, без участия модели.**
|
|
121
|
+
- **Reliability вместо бинарного исхода**: «прошло с первой попытки» ≠ «с третьей»;
|
|
122
|
+
first_pass_rate и среднее число попыток участвуют в роутинге.
|
|
107
123
|
- **Объективная верификация** (keystone): провал → эскалация / ретрай / откат;
|
|
108
|
-
никогда «готово» на слово агента.
|
|
109
|
-
-
|
|
110
|
-
|
|
124
|
+
никогда «готово» на слово агента. Гейт **всегда hard**.
|
|
125
|
+
- **Целостность гейта**: gate-файлы и команда вне write-scope агента; snapshot и
|
|
126
|
+
хэш gate-входов и политики фиксируются на старте и сверяются перед вердиктом.
|
|
127
|
+
Flake/infra-исходы не обучают карту. Shadow/canary — для маршрутов и адаптеров,
|
|
128
|
+
не для приёмки артефакта.
|
|
129
|
+
- **Отложенные внешние эффекты**: до гейта агент заявляет намерения
|
|
130
|
+
(`effect_intents`), а не выполняет irreversible-действия. Применение — только
|
|
131
|
+
после pass; при провале — отброс или компенсация.
|
|
132
|
+
- **Контракт безопасности миссии**: класс риска компилируется в исполняемую
|
|
133
|
+
политику (allow/deny, egress, обязательные гейты, бюджет) **до** исполнения.
|
|
134
|
+
- **Честная экономика**: savings ledger (net-контрфактика с учётом эскалаций,
|
|
135
|
+
верификации и overhead), токены/стоимость по шагам и моделям.
|
|
111
136
|
- **Полный аудит**: кто, каким инструментом, какой файл, когда, почему
|
|
112
|
-
эскалировали.
|
|
113
|
-
- **Learning-loop**: capability-карта
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
зависает; leases/locks/таймауты.
|
|
137
|
+
эскалировали. Ledger — tamper-evident (хеш-цепочка), не граница безопасности.
|
|
138
|
+
- **Learning-loop**: capability-карта → scaffolding/few-shot из успешных решений →
|
|
139
|
+
eval-harness → shadow → canary → (staged) LoRA на gate-passed датасете.
|
|
140
|
+
- **Автономность по выбору**: ad-hoc или расписание; переживает ребут; не двоится;
|
|
141
|
+
не зависает; leases/locks/таймауты/бюджеты.
|
|
118
142
|
|
|
119
143
|
## 6. Исполнительный цикл (его задачи)
|
|
120
144
|
|
|
121
|
-
1. Принять
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
145
|
+
1. Принять миссию: цель + scope + gate-спека + **контракт безопасности**;
|
|
146
|
+
скомпилировать политику (класс риска → allow/deny + egress + обязательные
|
|
147
|
+
гейты + бюджет); approval, если класс риска требует.
|
|
148
|
+
2. Разложить на шаги, назначить роли (локальная модель — только здесь).
|
|
149
|
+
3. **Роутинг шага**: статические правила → capability-карта с учётом reliability
|
|
150
|
+
(first_pass_rate, попытки, decay), локаль first, explore capped.
|
|
151
|
+
4. **Context compilation**: собрать бандл под окно выбранной модели и бюджет
|
|
152
|
+
токенов — scaffolding/few-shot из ledger + repo-map. Пересборка при эскалации.
|
|
153
|
+
5. Выполнить шаг: capability issuance на шаг (TTL), least privilege,
|
|
154
|
+
worktree/sandbox; внешние эффекты — только намерения.
|
|
155
|
+
6. Прогнать **hard, независимый, tamper-evident, flake-aware** гейт.
|
|
156
|
+
- Pass → применить намерения → ledger (экономия + пример + provenance) → обновить карту.
|
|
157
|
+
- Fail → эскалация / ретрай / откат в рамках живого бюджета; эскалация возвращает к шагу 3.
|
|
158
|
+
7. Собрать артефакт миссии (diff/PR из worktree, отчёт, аудит-трейл).
|
|
159
|
+
8. Отчитаться честно: net-экономия, success rate, first_pass_rate, escalation rate,
|
|
160
|
+
overhead.
|
|
161
|
+
9. Обновить роутинг/eval; периодически — дообучить адаптер (staged, opt-in).
|
|
162
|
+
|
|
163
|
+
Шаги 3–6 — внутренний цикл на каждый шаг миссии.
|
|
164
|
+
Сквозные слои: телеметрия (span на шаг), живой бюджет, аудит, durable state.
|
|
165
|
+
Human review / approval — **тип гейта**, доступен на любом шаге; пауза не потребляет compute.
|
|
131
166
|
|
|
132
167
|
## 7. Архитектура (слои)
|
|
133
168
|
|
|
134
169
|
```
|
|
135
|
-
[
|
|
170
|
+
[ ВХОДЫ-АДАПТЕРЫ ]
|
|
171
|
+
ad-hoc: run_mission / CLI / GUI / RPC ← без регистрации в ОС
|
|
172
|
+
внутренние: chain / DAG / retry / escalation ← без регистрации в ОС
|
|
173
|
+
registered: cron / once / file / git / mcp / webhook
|
|
136
174
|
│
|
|
137
|
-
|
|
175
|
+
▼
|
|
176
|
+
[ MISSION RUNTIME — ядро ]
|
|
177
|
+
intake: цель + scope + gate-спека + safety → компиляция политики + бюджет
|
|
138
178
|
│
|
|
139
|
-
|
|
179
|
+
createRun (durable, trigger_kind)
|
|
140
180
|
│
|
|
141
|
-
|
|
142
|
-
│
|
|
181
|
+
planner: декомпозиция на шаги/роли
|
|
182
|
+
│
|
|
183
|
+
router: capability-карта + reliability → локаль first; explore capped
|
|
184
|
+
│ │ эскалация → возврат к router
|
|
143
185
|
│ ▼
|
|
144
|
-
│ [ облачные модели (fallback
|
|
186
|
+
│ [ облачные модели (fallback) ]
|
|
145
187
|
▼
|
|
146
|
-
|
|
188
|
+
context compilation: окно модели + бюджет токенов (scaffolding + repo-map)
|
|
189
|
+
│
|
|
190
|
+
executor: OpenCode-агенты, capability issuance (TTL), worktree/sandbox
|
|
191
|
+
внешние эффекты → intents (не применяются)
|
|
147
192
|
│
|
|
148
|
-
|
|
149
|
-
│ pass
|
|
150
|
-
▼
|
|
151
|
-
|
|
193
|
+
GATE: hard, независимый, tamper-evident, flake-aware ← keystone
|
|
194
|
+
│ pass │ fail
|
|
195
|
+
▼ ▼
|
|
196
|
+
применить intents → ledger escalate / retry / rollback
|
|
152
197
|
│
|
|
153
|
-
|
|
198
|
+
learning: карта → scaffolding → eval → shadow/canary → LoRA (staged)
|
|
154
199
|
│
|
|
155
|
-
|
|
200
|
+
control plane: локальный, приватный, аудит, dashboard
|
|
201
|
+
|
|
202
|
+
[ РЕГИСТРАЦИЯ ТРИГГЕРА — опционально ]
|
|
203
|
+
Task Scheduler / crontab / launchd — только для registered-входа
|
|
156
204
|
```
|
|
157
205
|
|
|
158
|
-
|
|
159
|
-
(
|
|
160
|
-
|
|
206
|
+
Объекты: **миссия** — единица работы; **задача** — миссия-шаблон + триггер
|
|
207
|
+
(опциональна); **запуск** — durable-исполнение миссии.
|
|
208
|
+
|
|
209
|
+
Локально-первым является **control plane и роутинг**; инференс — гибрид.
|
|
210
|
+
Приватность = данные/аудит/управление локальны, а не «ни одного облачного токена».
|
|
161
211
|
|
|
162
212
|
## 8. Границы (чем НЕ является)
|
|
163
213
|
|
|
@@ -165,17 +215,19 @@
|
|
|
165
215
|
- Не замена способной облачной модели на сложном: облако — эскалация.
|
|
166
216
|
- Не отмена человеческого ревью критичного: гейт поднимает пол, не потолок.
|
|
167
217
|
- Не облачный SaaS и не multi-machine: локальный control plane, одна машина.
|
|
168
|
-
- Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и
|
|
169
|
-
|
|
218
|
+
- Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и обвязка.
|
|
219
|
+
- **Не «только планировщик»**: ad-hoc миссия без расписания — полноправный вход.
|
|
220
|
+
Регистрация в планировщике ОС опциональна; его недоступность не блокирует ядро.
|
|
170
221
|
|
|
171
222
|
## 9. Душа: flywheel
|
|
172
223
|
|
|
173
224
|
Больше задач → больше локальных попыток → больше исходов гейта → точнее
|
|
174
|
-
capability-карта и больше примеров →
|
|
175
|
-
сильнее адаптеры → ещё больше задач
|
|
225
|
+
capability-карта и больше примеров → **примеры инжектятся в контекст** → выше
|
|
226
|
+
local first_pass_rate → больше экономия и сильнее адаптеры → ещё больше задач
|
|
227
|
+
выгодно гнать через локаль.
|
|
176
228
|
|
|
177
|
-
|
|
178
|
-
|
|
229
|
+
Ключевое звено: примеры не просто копятся, а **используются** (context compilation).
|
|
230
|
+
Без него flywheel не крутится.
|
|
179
231
|
|
|
180
232
|
## 10. Реальность железа (ограничение, учтённое в дизайне)
|
|
181
233
|
|
|
@@ -184,59 +236,101 @@ capability-карта и больше примеров → выше local succes
|
|
|
184
236
|
- инференс локально: QLoRA/квант 3–8B;
|
|
185
237
|
- обучение: только QLoRA 3–4B, low-rank, накопленным gate-passed датасетом,
|
|
186
238
|
пакетами, а не онлайн;
|
|
187
|
-
-
|
|
188
|
-
|
|
239
|
+
- прокачка staged: сначала scaffolding/роутинг (дёшево, сразу), веса — когда
|
|
240
|
+
датасет и железо позволяют;
|
|
241
|
+
- context compilation обязателен: малое окно — не повод отказываться от задачи.
|
|
242
|
+
|
|
189
243
|
Дизайн не зависит от конкретного железа: capability-карта и гейты работают и на
|
|
190
244
|
слабой, и на сильной локали; меняется лишь доля задач, которую тянет локаль.
|
|
191
245
|
|
|
192
246
|
## 11. Как поймём, что пришли (definition of done концепции)
|
|
193
247
|
|
|
194
248
|
Вертикальный срез работает end-to-end и измеримо:
|
|
195
|
-
|
|
196
|
-
|
|
249
|
+
|
|
250
|
+
1. **ad-hoc** миссия с явным гейтом и safety-контрактом принята, политика
|
|
251
|
+
скомпилирована, миссия разложена — **без регистрации в планировщике ОС**;
|
|
252
|
+
2. шаги смаршрутированы локаль-first по capability-карте с учётом reliability;
|
|
197
253
|
3. гейт объективно верифицировал; провал экалировался/откатился без тихих
|
|
198
|
-
отказов;
|
|
254
|
+
отказов; irreversible не произошёл до pass;
|
|
199
255
|
4. ledger показал честную net-экономию и escalation rate;
|
|
200
|
-
5. learning-loop обновил capability
|
|
201
|
-
6.
|
|
202
|
-
|
|
256
|
+
5. learning-loop обновил capability-карту, положил пример и **переиспользовал** его;
|
|
257
|
+
6. паритет: та же спека через registered-вход даёт тот же маршрут и вердикт;
|
|
258
|
+
7. на фикс-наборе задач за N недель: local success_rate и first_pass_rate ↑,
|
|
259
|
+
net-экономия ↑ при неизменном качестве (eval не деградировал).
|
|
203
260
|
|
|
204
|
-
Когда 1–
|
|
205
|
-
(больше типов задач, больше машин, сильнее адаптеры).
|
|
261
|
+
Когда 1–7 воспроизводимо — концепция достигнута; всё дальнейшее = масштаб.
|
|
206
262
|
|
|
207
263
|
## 12. Открытые вопросы / риски (честно)
|
|
208
264
|
|
|
209
|
-
- Качество локального вердикта на пограничных задачах →
|
|
210
|
-
shadow-режим, а не
|
|
211
|
-
- Cost of verification
|
|
265
|
+
- Качество локального вердикта на пограничных задачах → правила/пороги и
|
|
266
|
+
shadow-режим, а не слепая вера модели.
|
|
267
|
+
- Cost of verification → учитывать в net-экономике, кэшировать.
|
|
212
268
|
- Explore может тратить впустую → capped explore-бюджет, bandit по типам задач.
|
|
213
269
|
- Датасет для весов копится медленно → staged-прокачка, не обещать онлайн-LoRA.
|
|
214
|
-
- Prompt-injection даже при
|
|
215
|
-
|
|
270
|
+
- Prompt-injection даже при гейте → гейт + аудит + allowedTools как пол;
|
|
271
|
+
внешний контент недоверенный по умолчанию; критичное — человеку.
|
|
272
|
+
- **Reward hacking**: агент правит тесты/гейт → при создании задачи
|
|
273
|
+
`src/core/gate-integrity.ts` фиксирует snapshot входов гейта (команда/файл
|
|
274
|
+
хука, prompt, таймаут) в `PLUGIN_DIR/gate-snapshots/` с SHA-256; обе обёртки
|
|
275
|
+
проверяют хэш непосредственно перед запуском гейта. Расхождение или отсутствие
|
|
276
|
+
snapshot → fail-closed: гейт не выполняется, запуск считается ошибкой.
|
|
277
|
+
Обязательная тест-атака (подмена gate-команды/хука) есть в `npm test` и в CI
|
|
278
|
+
на Windows, macOS и Linux. Мера защищает **определение гейта**, а не исходники
|
|
279
|
+
репозитория, которые гейт проверяет: подмена самих тестов агентом эту проверку
|
|
280
|
+
не обходит, но и не детектируется ею. Права вне write-scope и `gate_outcomes`
|
|
281
|
+
с хэш-цепочкой остаются планом. Status: 🔄 (реализована базовая мера).
|
|
282
|
+
- **Irreversible до вердикта** → отложенные эффекты (intents) и компенсация.
|
|
283
|
+
- **Хеш-цепочка ledger** — tamper-evident аудит, **не** граница безопасности;
|
|
284
|
+
граница — права и изоляция.
|
|
285
|
+
- **Зависимости под гипотезы** → сначала переиспользуем существующее; новый
|
|
286
|
+
движок/БД только с доказанной необходимостью.
|
|
216
287
|
|
|
217
288
|
## 13. Стратегия развития: от плагина к фреймворку
|
|
218
289
|
|
|
219
|
-
Наша эволюция строится на двух столпах и постепенной абстракции:
|
|
220
|
-
|
|
221
290
|
### 13.1 Локальный интеллект
|
|
222
291
|
|
|
223
|
-
Максимум проверяемой работы на локальных моделях с
|
|
292
|
+
Максимум проверяемой работы на локальных моделях с компандингом. Объективный
|
|
293
|
+
гейт дёшев и не врёт, поэтому локаль направляется на максимум задач: брак
|
|
294
|
+
ловится и эскалируется. Исходы гейта — бесплатная разметка.
|
|
224
295
|
|
|
225
296
|
### 13.2 Мультиагентная оркестрация
|
|
226
297
|
|
|
227
|
-
Ролевая декомпозиция миссий на
|
|
298
|
+
Ролевая декомпозиция миссий на шаги. Каждый шаг — самому дешёвому способному
|
|
299
|
+
исполнителю; облако только при провале гейта.
|
|
228
300
|
|
|
229
301
|
### 13.3 Непрерывное улучшение Control Plane
|
|
230
302
|
|
|
231
|
-
Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) —
|
|
303
|
+
Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) —
|
|
304
|
+
фундамент доверия, а не отдельный продукт. Дорабатывается наравне с ядром.
|
|
232
305
|
|
|
233
306
|
### 13.4 Путь к универсальности
|
|
234
307
|
|
|
235
|
-
- **Этап 1:** глубокая интеграция с OpenCode V1 и V2
|
|
236
|
-
|
|
237
|
-
- **Этап
|
|
308
|
+
- **Этап 1 (текущий):** глубокая интеграция с OpenCode V1 и V2 — один пакет,
|
|
309
|
+
dual export, общее ядро.
|
|
310
|
+
- **Этап 2:** выделение mission runtime, независимого от планировщика ОС, и
|
|
311
|
+
абстракция слоя исполнения (Agent Executor Interface).
|
|
312
|
+
- **Этап 3:** универсальный фреймворк оркестрации, совместимый с любым агентом
|
|
313
|
+
через MCP или стандартные API; интероперабельность — через стабильные форматы
|
|
314
|
+
(pipeline YAML, SQLite ledger) и MCP, а не через соответствие чужим схемам слоёв.
|
|
315
|
+
|
|
316
|
+
## 14. Продукт для людей (не на продажу)
|
|
317
|
+
|
|
318
|
+
- **Суверенитет пользователя.** Данные локальны и экспортируемы; роутинг
|
|
319
|
+
переопределяем; обучение отключаемо; без аккаунтов, SaaS и телеметрии.
|
|
320
|
+
- **Свобода сценария.** Можно жить без расписаний, можно на расписаниях, можно
|
|
321
|
+
смешивать. Одноразовая работа не требует регистрации задачи.
|
|
322
|
+
- **Честность.** «Сэкономлено $» — консервативная оценка с методикой рядом;
|
|
323
|
+
метрики воспроизводимы из ledger. Термин — tamper-evident, не tamper-proof.
|
|
324
|
+
- **Низкий порог.** Работает на скромном железе, безопасно по умолчанию,
|
|
325
|
+
понятные дефолты, документация на нескольких языках.
|
|
326
|
+
- **Долговечность.** Скучные технологии, мало зависимостей, стабильные форматы,
|
|
327
|
+
дисциплина миграций: через годы оно всё ещё запускается.
|
|
328
|
+
- **Открытость.** Открытые форматы pipeline и ledger, библиотека рецептов,
|
|
329
|
+
skill-экосистема — сообщество расширяет без maintainer'а.
|
|
330
|
+
- **Пол, не потолок.** Гейт и approval поднимают минимальную планку качества и
|
|
331
|
+
безопасности; критичные решения остаются за человеком.
|
|
238
332
|
|
|
239
333
|
---
|
|
240
334
|
|
|
241
335
|
*Любое изменение в репозитории, которое не двигает хотя бы один столп из §4 и
|
|
242
|
-
не согласуется с §8, — не цель, а шум.*
|
|
336
|
+
не согласуется с §8, — не цель, а шум.*
|
|
@@ -54,6 +54,13 @@ interface SchedulerBackend {
|
|
|
54
54
|
- Обёртка: `run-task.ps1` + персональный `run-<name>.cmd` в `%APPDATA%\opencode\agent-steward\wrapper`. Legacy-каталог `%APPDATA%\opencode\windows-scheduler` переносится при первом запуске.
|
|
55
55
|
- Логи: `%APPDATA%\opencode\agent-steward\logs\<name>.log`.
|
|
56
56
|
- cron конвертируется в schtasks (`convertCronToSchTasks`) — поддерживается тот же набор шаблонов.
|
|
57
|
+
- Промпт передаётся в `opencode run` после `--`, поэтому промпт, начинающийся с `-`,
|
|
58
|
+
не может быть принят за флаг. Обёртка отклоняет промпты длиннее 30 000 символов
|
|
59
|
+
до `CreateProcess` (лимит командной строки — 32 767 символов).
|
|
60
|
+
- Сторож таймаута: дерево процессов читается через `Get-CimInstance`; при сбое CIM
|
|
61
|
+
или пустом результате обёртка переходит на `Get-WmiObject`, затем проверяет
|
|
62
|
+
`tasklist`/`Get-Process`. Если данных о дереве нет, срабатывает fail-closed:
|
|
63
|
+
`taskkill /F /T /PID <root>`, чтобы внуки не остались работать.
|
|
57
64
|
|
|
58
65
|
### Linux
|
|
59
66
|
- Задачи живут в управляемом блоке `crontab`:
|
|
@@ -70,19 +77,32 @@ interface SchedulerBackend {
|
|
|
70
77
|
- Полный cron-синтаксис (в отличие от Windows), т.к. crontab понимает его нативно.
|
|
71
78
|
- Разовый запуск (`once`): `at -t`; если `at` не установлен, плагин ставит отвязанный процесс `sleep && команда` (`pid:<pid>` в реестре). Fallback не переживает перезагрузку — для надёжности установите пакет `at`.
|
|
72
79
|
- Удаление/пересборка — только своего блока, остальные строки `crontab` не трогаются.
|
|
80
|
+
- Незакрытый блок плагина (маркер начала без конца) — fail-closed: плагин сообщает об ошибке и не перезаписывает crontab, поэтому строки пользователя после маркера не теряются.
|
|
73
81
|
|
|
74
82
|
### macOS
|
|
75
83
|
- Задачи — LaunchAgent-плисты `~/Library/LaunchAgents/com.opencode.scheduler.<name>.plist`.
|
|
76
84
|
- Расписание: `StartInterval` для `* * * * *` и `*/N`, `StartCalendarInterval` для `M * * * *`,
|
|
77
85
|
`M H * * *`, `M H * * D`.
|
|
78
86
|
- Пауза = `launchctl unload -w`, возобновление = `launchctl load -w`.
|
|
87
|
+
- Установка приостановленной задачи пишет plist, но не вызывает `load -w`
|
|
88
|
+
(он снял бы паузу); `unload -w` оставляет агент выключенным и после входа.
|
|
89
|
+
- Ошибки `launchctl load` не глотаются: ошибка установки/возобновления содержит
|
|
90
|
+
команду, exit code и stderr (например, `Invalid property list` у битого plist).
|
|
79
91
|
- Обёртка — тот же `.sh`, что и на Linux; пути конфигов:
|
|
80
92
|
`~/.config/opencode/agent-steward/` (или `$XDG_CONFIG_HOME`).
|
|
81
93
|
|
|
82
94
|
### Общая POSIX-обёртка (`.sh`)
|
|
83
95
|
- `cd` в рабочую директорию, `opencode run` с промптом из файла.
|
|
96
|
+
Промпт идёт после `--`, поэтому ведущий `-` не считается опцией.
|
|
97
|
+
- Backstop argv отклоняет `PROMPT_BYTES >= 131072`: `MAX_ARG_STRLEN` в Linux
|
|
98
|
+
включает завершающий NUL, поэтому полезных данных помещается максимум 131 071 байт.
|
|
84
99
|
- Логи пишутся в файл через `>>` и дублируются метками времени.
|
|
85
100
|
- Блокировка через атомарный `mkdir` — защита от параллельных запусков.
|
|
101
|
+
- Node, PS и bash пишут владельца lock как `<pid>-<iso>`; старые форматы
|
|
102
|
+
`<iso>|<pid>` (PS) и голый `<pid>` тоже читаются, поэтому живой lock не
|
|
103
|
+
вытесняется другой средой исполнения.
|
|
104
|
+
- При старте плагин читает владельца и из `<task>.lock`, и из `<task>.lock.d/pid`:
|
|
105
|
+
каталог lock вытесняется только если PID мёртв или отсутствует; возраст — fallback.
|
|
86
106
|
- Таймаут: дочерний процесс + watchdog (`TERM`, затем `KILL`).
|
|
87
107
|
- Quality Gate: `bash -lc "<команда>"` (аналог `cmd.exe /c` на Windows).
|
|
88
108
|
- Метрики: `node "<record-history.js>" <task> <status> <started> <duration> <error> "-" "-"` —
|
|
@@ -53,6 +53,12 @@ interface SchedulerBackend {
|
|
|
53
53
|
- 包装脚本:`run-task.ps1` 加每个任务专属的 `run-<name>.cmd`,位于 `%APPDATA%\opencode\agent-steward\wrapper`。旧的 `%APPDATA%\opencode\windows-scheduler` 目录会在首次启动时迁移。
|
|
54
54
|
- 日志:`%APPDATA%\opencode\agent-steward\logs\<name>.log`。
|
|
55
55
|
- cron 会转换成 schtasks(`convertCronToSchTasks`)——支持与之前相同的模板集合。
|
|
56
|
+
- 提示词在 `--` 之后传给 `opencode run`,因此以 `-` 开头的提示词不会被当成选项。
|
|
57
|
+
包装脚本会在 `CreateProcess` 之前拒绝超过 30 000 字符的提示词
|
|
58
|
+
(命令行上限为 32 767 字符)。
|
|
59
|
+
- 超时看门狗:通过 `Get-CimInstance` 读取进程树;如果 CIM 失败或为空,则回退到
|
|
60
|
+
`Get-WmiObject`,再检查 `tasklist`/`Get-Process`。如果完全拿不到树数据,则
|
|
61
|
+
故障关闭并执行 `taskkill /F /T /PID <root>`,避免孙进程继续运行。
|
|
56
62
|
|
|
57
63
|
### Linux
|
|
58
64
|
- 任务保存在受管 `crontab` 块中:
|
|
@@ -69,19 +75,31 @@ interface SchedulerBackend {
|
|
|
69
75
|
- 支持完整 cron 语法(与 Windows 不同),因为 crontab 原生支持。
|
|
70
76
|
- 一次性任务(`once`):使用 `at -t`;如果未安装 `at`,插件会退回到分离的 `sleep && 命令` 进程(注册表中为 `pid:<pid>`)。回退方案无法在重启后保留,建议安装 `at` 包。
|
|
71
77
|
- 删除/重建只触及自己的块,`crontab` 的其他行不受影响。
|
|
78
|
+
- 未闭合的插件块(只有开始标记)按 fail-closed 处理:插件报告错误且不重写 crontab,因此标记之后的用户行不会丢失。
|
|
72
79
|
|
|
73
80
|
### macOS
|
|
74
81
|
- 任务是 LaunchAgent plist:`~/Library/LaunchAgents/com.opencode.scheduler.<name>.plist`。
|
|
75
82
|
- 调度:`* * * * *` 和 `*/N` 使用 `StartInterval`,`M * * * *`、`M H * * *`、`M H * * D`
|
|
76
83
|
使用 `StartCalendarInterval`。
|
|
77
84
|
- 暂停 = `launchctl unload -w`,恢复 = `launchctl load -w`。
|
|
85
|
+
- 安装已暂停的任务只写入 plist,不调用 `load -w`(它会清除暂停);
|
|
86
|
+
`unload -w` 保证代理在下次登录后仍保持禁用。
|
|
87
|
+
- `launchctl load` 的错误不会被吞掉:安装/恢复失败会带上命令、退出码和
|
|
88
|
+
stderr(例如损坏的 plist 返回 `Invalid property list`)。
|
|
78
89
|
- 包装脚本与 Linux 相同的 `.sh`;配置路径:
|
|
79
90
|
`~/.config/opencode/agent-steward/`(或 `$XDG_CONFIG_HOME`)。
|
|
80
91
|
|
|
81
92
|
### 共享 POSIX 包装脚本(`.sh`)
|
|
82
93
|
- `cd` 到工作目录,用文件中的提示词执行 `opencode run`。
|
|
94
|
+
提示词位于 `--` 之后,因此开头的 `-` 不会被当作选项。
|
|
95
|
+
- argv 保护会在 `PROMPT_BYTES >= 131072` 时拒绝运行:Linux 的 `MAX_ARG_STRLEN`
|
|
96
|
+
包含结尾 NUL,因此最多只有 131 071 字节的有效负载。
|
|
83
97
|
- 日志通过 `>>` 追加,并带时间戳。
|
|
84
98
|
- 通过原子 `mkdir` 加锁——防止并行运行。
|
|
99
|
+
- Node、PS 和 bash 都将锁持有者写为 `<pid>-<iso>`;旧格式 `<iso>|<pid>`(PS)和
|
|
100
|
+
裸 `<pid>` 仍可读取,因此运行中的锁不会被另一种运行时误判为过期。
|
|
101
|
+
- 插件启动时同时读取 `<task>.lock` 与 `<task>.lock.d/pid` 的持有者:只有 PID
|
|
102
|
+
已死亡或缺失时才清理锁目录,年龄仅作为回退条件。
|
|
85
103
|
- 超时:子进程 + 看门狗(先 `TERM`,再 `KILL`)。
|
|
86
104
|
- Quality Gate:`bash -lc "<命令>"`(相当于 Windows 上的 `cmd.exe /c`)。
|
|
87
105
|
- 指标:`node "<record-history.js>" <task> <status> <started> <duration> <error> "-" "-"`——
|