agent-steward 0.0.2 → 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 +45 -2
- package/CROSS_PLATFORM.md +11 -9
- package/README.md +11 -10
- package/ROADMAP-STRATEGY.md +93 -44
- package/ROADMAP.md +148 -1017
- package/dist/core/cron-to-schtasks.d.ts +0 -8
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +11 -86
- 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 +19 -2
- package/dist/core/file-watcher.js +9 -9
- package/dist/core/git-trigger.js +4 -4
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +99 -26
- package/dist/core/one-shot.d.ts +31 -5
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +78 -10
- 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/otel.js +2 -2
- 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 +66 -36
- 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 +78 -54
- 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 +36 -2
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +98 -12
- package/dist/core/scheduler/at-fallback.d.ts +95 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +200 -0
- package/dist/core/scheduler/linux.d.ts +13 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +67 -13
- package/dist/core/scheduler/mac.d.ts +14 -8
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +71 -22
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +37 -2
- package/dist/core/scheduler/registry.d.ts +13 -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 +16 -3
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +249 -96
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +127 -30
- package/dist/core/self-analysis.js +55 -55
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/summary.js +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/triage-chain.js +1 -1
- package/dist/core/triage-worker.js +2 -2
- package/dist/core/triage.js +1 -1
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +82 -37
- 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 +6 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +48 -2
- 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-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +51 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +156 -0
- package/dist/db/runs-repo.d.ts +128 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +342 -0
- package/dist/db/schema.d.ts +16 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +342 -35
- 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 +5 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +168 -40
- package/dist/notifications.js +18 -18
- package/dist/profiles.d.ts +7 -3
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +85 -7
- package/dist/rpc.d.ts +787 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +324 -0
- package/dist/server.d.ts +33 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +115 -54
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/skill.js +1 -1
- package/dist/task-transfer.d.ts +1 -1
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +14 -10
- package/dist/types.d.ts +20 -4
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +44 -9
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +44 -9
- package/docs/ARCHITECTURE.md +335 -9
- package/docs/COMPATIBILITY.md +10 -6
- package/docs/CONCEPT.md +183 -91
- package/docs/CROSS_PLATFORM.ru.md +11 -9
- package/docs/CROSS_PLATFORM.zh.md +11 -9
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/FAQ.md +2 -2
- package/docs/FAQ.ru.md +2 -2
- package/docs/FAQ.zh.md +2 -2
- package/docs/FEATURES.md +5 -4
- package/docs/FEATURES.zh.md +5 -4
- package/docs/MIGRATION.md +34 -26
- package/docs/README.ru.md +27 -8
- package/docs/README.zh.md +11 -10
- 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/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
- package/gui-experimental.cjs +8 -8
- package/index.js +1 -0
- package/locales/en.json +68 -0
- package/locales/ru.json +68 -0
- package/locales/zh.json +68 -0
- package/package.json +57 -11
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/analytics.ts +2 -2
- package/src/core/audit.ts +17 -17
- package/src/core/cron-to-schtasks.ts +14 -93
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +51 -27
- package/src/core/file-watcher.ts +17 -17
- package/src/core/git-trigger.ts +9 -9
- package/src/core/glob.ts +1 -1
- package/src/core/local-ai.ts +2 -2
- package/src/core/lock.ts +104 -31
- package/src/core/matrix.ts +31 -31
- package/src/core/native-notify.ts +2 -2
- package/src/core/one-shot.ts +91 -13
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/otel.ts +4 -4
- package/src/core/permissions.ts +5 -5
- package/src/core/prometheus.ts +17 -17
- package/src/core/ps-wrapper.ts +68 -38
- package/src/core/record-history.ts +114 -76
- package/src/core/retention.ts +3 -3
- 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/savings.ts +1 -1
- package/src/core/schedule-gate.ts +17 -13
- package/src/core/schedule-v2.ts +138 -29
- package/src/core/scheduler/at-fallback.ts +298 -0
- package/src/core/scheduler/index.ts +3 -3
- package/src/core/scheduler/linux.ts +92 -19
- package/src/core/scheduler/logs.ts +1 -1
- package/src/core/scheduler/mac.ts +112 -60
- package/src/core/scheduler/posix.ts +35 -2
- package/src/core/scheduler/registry.ts +109 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/scheduler/windows.ts +295 -125
- package/src/core/secrets.ts +139 -39
- package/src/core/self-analysis.ts +61 -61
- package/src/core/session.ts +26 -13
- package/src/core/structured-log.ts +3 -3
- package/src/core/summary.ts +25 -25
- package/src/core/task-name.ts +67 -0
- package/src/core/telegram.ts +16 -16
- package/src/core/triage-chain.ts +4 -4
- package/src/core/triage-compare.ts +8 -8
- package/src/core/triage-rules.ts +4 -4
- package/src/core/triage-shadow.ts +7 -7
- package/src/core/triage-worker.ts +6 -6
- package/src/core/triage.ts +23 -23
- package/src/core/watch-paths.ts +1 -1
- package/src/core/wrappers/bash.ts +90 -45
- package/src/db/capability-repo.ts +285 -0
- package/src/db/git-state-repo.ts +1 -1
- package/src/db/history-repo.ts +44 -22
- package/src/db/index.ts +53 -7
- package/src/db/metrics-repo.ts +10 -10
- package/src/db/migrate.ts +13 -11
- package/src/db/recovery.ts +3 -3
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +256 -0
- package/src/db/runs-repo.ts +504 -0
- package/src/db/schema.ts +357 -44
- package/src/db/settings-repo.ts +33 -2
- package/src/db/step-idempotency.ts +185 -0
- package/src/db/tasks-repo.ts +10 -10
- package/src/db/templates-repo.ts +7 -7
- package/src/gui.tsx +516 -1
- package/src/history.ts +4 -4
- package/src/i18n.ts +7 -7
- package/src/index.ts +465 -308
- package/src/integrations.ts +6 -6
- package/src/notifications.ts +76 -76
- package/src/profiles.ts +98 -7
- package/src/rpc.ts +347 -1
- package/src/schtasks.ts +2 -2
- package/src/server.ts +155 -78
- package/src/settings.ts +44 -44
- package/src/shared/jobs-view.ts +60 -60
- package/src/skill.ts +1 -1
- package/src/task-transfer.ts +58 -56
- package/src/templates.ts +1 -1
- package/src/types.ts +54 -10
- package/src/workspaces.ts +73 -24
- package/dist/core/self-analysis.test.d.ts +0 -2
- package/dist/core/self-analysis.test.d.ts.map +0 -1
- package/dist/core/self-analysis.test.js +0 -219
- package/dist/gui-experimental.cjs +0 -1
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,104 +48,160 @@
|
|
|
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
|
-
- **Capability-aware
|
|
93
|
-
|
|
94
|
-
|
|
96
|
+
- **Capability-aware роутинг (3 слоя)**:
|
|
97
|
+
- **Слой 1 — статические правила (0 токенов, мгновенно):**
|
|
98
|
+
```json
|
|
99
|
+
{
|
|
100
|
+
"read_file": { "transport": "direct", "executor": "local" },
|
|
101
|
+
"write_file": { "transport": "direct", "executor": "local" },
|
|
102
|
+
"run_tests": { "transport": "direct", "executor": "local" },
|
|
103
|
+
"apply_diff": { "transport": "direct", "executor": "local" },
|
|
104
|
+
"github_create_pr": { "transport": "mcp", "executor": "local" },
|
|
105
|
+
"jira_update_task": { "transport": "mcp", "executor": "cloud" }
|
|
106
|
+
}
|
|
107
|
+
```
|
|
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
|
+
модель не маршрутизирует каждый шаг.
|
|
114
|
+
- **Эскалация при провале гейта — по правилу, без участия модели.**
|
|
115
|
+
- **Reliability вместо бинарного исхода**: «прошло с первой попытки» ≠ «с третьей»;
|
|
116
|
+
first_pass_rate и среднее число попыток участвуют в роутинге.
|
|
95
117
|
- **Объективная верификация** (keystone): провал → эскалация / ретрай / откат;
|
|
96
|
-
никогда «готово» на слово агента.
|
|
97
|
-
-
|
|
98
|
-
|
|
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), токены/стоимость по шагам и моделям.
|
|
99
130
|
- **Полный аудит**: кто, каким инструментом, какой файл, когда, почему
|
|
100
|
-
эскалировали.
|
|
101
|
-
- **Learning-loop**: capability-карта
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
зависает; 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/таймауты/бюджеты.
|
|
106
136
|
|
|
107
137
|
## 6. Исполнительный цикл (его задачи)
|
|
108
138
|
|
|
109
|
-
1. Принять
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
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.
|
|
119
160
|
|
|
120
161
|
## 7. Архитектура (слои)
|
|
121
162
|
|
|
122
163
|
```
|
|
123
|
-
[
|
|
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 → компиляция политики + бюджет
|
|
124
172
|
│
|
|
125
|
-
|
|
173
|
+
createRun (durable, trigger_kind)
|
|
126
174
|
│
|
|
127
|
-
|
|
175
|
+
planner: декомпозиция на шаги/роли
|
|
128
176
|
│
|
|
129
|
-
|
|
130
|
-
│ │ эскалация
|
|
177
|
+
router: capability-карта + reliability → локаль first; explore capped
|
|
178
|
+
│ │ эскалация → возврат к router
|
|
131
179
|
│ ▼
|
|
132
|
-
│ [ облачные модели (fallback
|
|
180
|
+
│ [ облачные модели (fallback) ]
|
|
133
181
|
▼
|
|
134
|
-
|
|
182
|
+
context compilation: окно модели + бюджет токенов (scaffolding + repo-map)
|
|
135
183
|
│
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
▼ ▼
|
|
139
|
-
[ ledger: savings/audit/metrics ] [ escalate / retry / rollback ]
|
|
184
|
+
executor: OpenCode-агенты, capability issuance (TTL), worktree/sandbox
|
|
185
|
+
внешние эффекты → intents (не применяются)
|
|
140
186
|
│
|
|
141
|
-
|
|
187
|
+
GATE: hard, независимый, tamper-evident, flake-aware ← keystone
|
|
188
|
+
│ pass │ fail
|
|
189
|
+
▼ ▼
|
|
190
|
+
применить intents → ledger escalate / retry / rollback
|
|
142
191
|
│
|
|
143
|
-
|
|
192
|
+
learning: карта → scaffolding → eval → shadow/canary → LoRA (staged)
|
|
193
|
+
│
|
|
194
|
+
control plane: локальный, приватный, аудит, dashboard
|
|
195
|
+
|
|
196
|
+
[ РЕГИСТРАЦИЯ ТРИГГЕРА — опционально ]
|
|
197
|
+
Task Scheduler / crontab / launchd — только для registered-входа
|
|
144
198
|
```
|
|
145
199
|
|
|
146
|
-
|
|
147
|
-
(
|
|
148
|
-
|
|
200
|
+
Объекты: **миссия** — единица работы; **задача** — миссия-шаблон + триггер
|
|
201
|
+
(опциональна); **запуск** — durable-исполнение миссии.
|
|
202
|
+
|
|
203
|
+
Локально-первым является **control plane и роутинг**; инференс — гибрид.
|
|
204
|
+
Приватность = данные/аудит/управление локальны, а не «ни одного облачного токена».
|
|
149
205
|
|
|
150
206
|
## 8. Границы (чем НЕ является)
|
|
151
207
|
|
|
@@ -153,17 +209,19 @@
|
|
|
153
209
|
- Не замена способной облачной модели на сложном: облако — эскалация.
|
|
154
210
|
- Не отмена человеческого ревью критичного: гейт поднимает пол, не потолок.
|
|
155
211
|
- Не облачный SaaS и не multi-machine: локальный control plane, одна машина.
|
|
156
|
-
- Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и
|
|
157
|
-
|
|
212
|
+
- Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и обвязка.
|
|
213
|
+
- **Не «только планировщик»**: ad-hoc миссия без расписания — полноправный вход.
|
|
214
|
+
Регистрация в планировщике ОС опциональна; его недоступность не блокирует ядро.
|
|
158
215
|
|
|
159
216
|
## 9. Душа: flywheel
|
|
160
217
|
|
|
161
218
|
Больше задач → больше локальных попыток → больше исходов гейта → точнее
|
|
162
|
-
capability-карта и больше примеров →
|
|
163
|
-
сильнее адаптеры → ещё больше задач
|
|
219
|
+
capability-карта и больше примеров → **примеры инжектятся в контекст** → выше
|
|
220
|
+
local first_pass_rate → больше экономия и сильнее адаптеры → ещё больше задач
|
|
221
|
+
выгодно гнать через локаль.
|
|
164
222
|
|
|
165
|
-
|
|
166
|
-
|
|
223
|
+
Ключевое звено: примеры не просто копятся, а **используются** (context compilation).
|
|
224
|
+
Без него flywheel не крутится.
|
|
167
225
|
|
|
168
226
|
## 10. Реальность железа (ограничение, учтённое в дизайне)
|
|
169
227
|
|
|
@@ -172,59 +230,93 @@ capability-карта и больше примеров → выше local succes
|
|
|
172
230
|
- инференс локально: QLoRA/квант 3–8B;
|
|
173
231
|
- обучение: только QLoRA 3–4B, low-rank, накопленным gate-passed датасетом,
|
|
174
232
|
пакетами, а не онлайн;
|
|
175
|
-
-
|
|
176
|
-
|
|
233
|
+
- прокачка staged: сначала scaffolding/роутинг (дёшево, сразу), веса — когда
|
|
234
|
+
датасет и железо позволяют;
|
|
235
|
+
- context compilation обязателен: малое окно — не повод отказываться от задачи.
|
|
236
|
+
|
|
177
237
|
Дизайн не зависит от конкретного железа: capability-карта и гейты работают и на
|
|
178
238
|
слабой, и на сильной локали; меняется лишь доля задач, которую тянет локаль.
|
|
179
239
|
|
|
180
240
|
## 11. Как поймём, что пришли (definition of done концепции)
|
|
181
241
|
|
|
182
242
|
Вертикальный срез работает end-to-end и измеримо:
|
|
183
|
-
|
|
184
|
-
|
|
243
|
+
|
|
244
|
+
1. **ad-hoc** миссия с явным гейтом и safety-контрактом принята, политика
|
|
245
|
+
скомпилирована, миссия разложена — **без регистрации в планировщике ОС**;
|
|
246
|
+
2. шаги смаршрутированы локаль-first по capability-карте с учётом reliability;
|
|
185
247
|
3. гейт объективно верифицировал; провал экалировался/откатился без тихих
|
|
186
|
-
отказов;
|
|
248
|
+
отказов; irreversible не произошёл до pass;
|
|
187
249
|
4. ledger показал честную net-экономию и escalation rate;
|
|
188
|
-
5. learning-loop обновил capability
|
|
189
|
-
6.
|
|
190
|
-
|
|
250
|
+
5. learning-loop обновил capability-карту, положил пример и **переиспользовал** его;
|
|
251
|
+
6. паритет: та же спека через registered-вход даёт тот же маршрут и вердикт;
|
|
252
|
+
7. на фикс-наборе задач за N недель: local success_rate и first_pass_rate ↑,
|
|
253
|
+
net-экономия ↑ при неизменном качестве (eval не деградировал).
|
|
191
254
|
|
|
192
|
-
Когда 1–
|
|
193
|
-
(больше типов задач, больше машин, сильнее адаптеры).
|
|
255
|
+
Когда 1–7 воспроизводимо — концепция достигнута; всё дальнейшее = масштаб.
|
|
194
256
|
|
|
195
257
|
## 12. Открытые вопросы / риски (честно)
|
|
196
258
|
|
|
197
|
-
- Качество локального вердикта на пограничных задачах →
|
|
198
|
-
shadow-режим, а не
|
|
199
|
-
- Cost of verification
|
|
259
|
+
- Качество локального вердикта на пограничных задачах → правила/пороги и
|
|
260
|
+
shadow-режим, а не слепая вера модели.
|
|
261
|
+
- Cost of verification → учитывать в net-экономике, кэшировать.
|
|
200
262
|
- Explore может тратить впустую → capped explore-бюджет, bandit по типам задач.
|
|
201
263
|
- Датасет для весов копится медленно → staged-прокачка, не обещать онлайн-LoRA.
|
|
202
|
-
- Prompt-injection даже при
|
|
203
|
-
|
|
264
|
+
- Prompt-injection даже при гейте → гейт + аудит + allowedTools как пол;
|
|
265
|
+
внешний контент недоверенный по умолчанию; критичное — человеку.
|
|
266
|
+
- **Reward hacking**: агент правит тесты/гейт → snapshot + hash + права вне
|
|
267
|
+
write-scope; обязательный тест-атака в CI.
|
|
268
|
+
- **Irreversible до вердикта** → отложенные эффекты (intents) и компенсация.
|
|
269
|
+
- **Хеш-цепочка ledger** — tamper-evident аудит, **не** граница безопасности;
|
|
270
|
+
граница — права и изоляция.
|
|
271
|
+
- **Зависимости под гипотезы** → сначала переиспользуем существующее; новый
|
|
272
|
+
движок/БД только с доказанной необходимостью.
|
|
204
273
|
|
|
205
274
|
## 13. Стратегия развития: от плагина к фреймворку
|
|
206
275
|
|
|
207
|
-
Наша эволюция строится на двух столпах и постепенной абстракции:
|
|
208
|
-
|
|
209
276
|
### 13.1 Локальный интеллект
|
|
210
277
|
|
|
211
|
-
Максимум проверяемой работы на локальных моделях с
|
|
278
|
+
Максимум проверяемой работы на локальных моделях с компандингом. Объективный
|
|
279
|
+
гейт дёшев и не врёт, поэтому локаль направляется на максимум задач: брак
|
|
280
|
+
ловится и эскалируется. Исходы гейта — бесплатная разметка.
|
|
212
281
|
|
|
213
282
|
### 13.2 Мультиагентная оркестрация
|
|
214
283
|
|
|
215
|
-
Ролевая декомпозиция миссий на
|
|
284
|
+
Ролевая декомпозиция миссий на шаги. Каждый шаг — самому дешёвому способному
|
|
285
|
+
исполнителю; облако только при провале гейта.
|
|
216
286
|
|
|
217
287
|
### 13.3 Непрерывное улучшение Control Plane
|
|
218
288
|
|
|
219
|
-
Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) —
|
|
289
|
+
Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) —
|
|
290
|
+
фундамент доверия, а не отдельный продукт. Дорабатывается наравне с ядром.
|
|
220
291
|
|
|
221
292
|
### 13.4 Путь к универсальности
|
|
222
293
|
|
|
223
|
-
- **Этап 1:** глубокая интеграция с OpenCode V1 и V2
|
|
224
|
-
|
|
225
|
-
- **Этап
|
|
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
|
+
безопасности; критичные решения остаются за человеком.
|
|
226
318
|
|
|
227
319
|
---
|
|
228
320
|
|
|
229
321
|
*Любое изменение в репозитории, которое не двигает хотя бы один столп из §4 и
|
|
230
|
-
не согласуется с §8, — не цель, а шум.*
|
|
322
|
+
не согласуется с §8, — не цель, а шум.*
|
|
@@ -50,23 +50,25 @@ interface SchedulerBackend {
|
|
|
50
50
|
## Как работает каждая ОС
|
|
51
51
|
|
|
52
52
|
### Windows (поведение не изменилось)
|
|
53
|
-
- Задачи регистрируются в Планировщике Windows через `schtasks` в папке `\OpenCode\windows-scheduler
|
|
54
|
-
- Обёртка: `run-task.ps1` + персональный `run-<name>.cmd` в `%APPDATA%\opencode\
|
|
55
|
-
- Логи: `%APPDATA%\opencode\
|
|
53
|
+
- Задачи регистрируются в Планировщике Windows через `schtasks` в папке `\OpenCode\agent-steward\` (профили — `\OpenCode\agent-steward-<profile>\`). Legacy-папка `\OpenCode\windows-scheduler\` по-прежнему читается, переименовывается и удаляется по требованию.
|
|
54
|
+
- Обёртка: `run-task.ps1` + персональный `run-<name>.cmd` в `%APPDATA%\opencode\agent-steward\wrapper`. Legacy-каталог `%APPDATA%\opencode\windows-scheduler` переносится при первом запуске.
|
|
55
|
+
- Логи: `%APPDATA%\opencode\agent-steward\logs\<name>.log`.
|
|
56
56
|
- cron конвертируется в schtasks (`convertCronToSchTasks`) — поддерживается тот же набор шаблонов.
|
|
57
57
|
|
|
58
58
|
### Linux
|
|
59
59
|
- Задачи живут в управляемом блоке `crontab`:
|
|
60
60
|
```
|
|
61
|
-
# >>> opencode-scheduler >>>
|
|
61
|
+
# >>> opencode-scheduler:agent-steward >>>
|
|
62
62
|
# task: my-task
|
|
63
63
|
*/5 * * * * /bin/bash '/…/wrapper/run-my-task.sh' >> '/…/logs/my-task.log' 2>&1
|
|
64
|
-
# <<< opencode-scheduler <<<
|
|
64
|
+
# <<< opencode-scheduler:agent-steward <<<
|
|
65
65
|
```
|
|
66
|
+
Блоки без суффикса `:<folder>` (legacy) по-прежнему читаются и удаляются.
|
|
66
67
|
- Пауза = строка с префиксом `# PAUSED: ` (блок пересобирается из реестра).
|
|
67
68
|
- Задачи с триггером `file` в crontab не попадают — их запускает FileWatchManager плагина.
|
|
68
|
-
- Обёртка: `~/.config/opencode/
|
|
69
|
+
- Обёртка: `~/.config/opencode/agent-steward/wrapper/run-<name>.sh` (chmod 0755).
|
|
69
70
|
- Полный cron-синтаксис (в отличие от Windows), т.к. crontab понимает его нативно.
|
|
71
|
+
- Разовый запуск (`once`): `at -t`; если `at` не установлен, плагин ставит отвязанный процесс `sleep && команда` (`pid:<pid>` в реестре). Fallback не переживает перезагрузку — для надёжности установите пакет `at`.
|
|
70
72
|
- Удаление/пересборка — только своего блока, остальные строки `crontab` не трогаются.
|
|
71
73
|
|
|
72
74
|
### macOS
|
|
@@ -75,7 +77,7 @@ interface SchedulerBackend {
|
|
|
75
77
|
`M H * * *`, `M H * * D`.
|
|
76
78
|
- Пауза = `launchctl unload -w`, возобновление = `launchctl load -w`.
|
|
77
79
|
- Обёртка — тот же `.sh`, что и на Linux; пути конфигов:
|
|
78
|
-
`~/.config/opencode/
|
|
80
|
+
`~/.config/opencode/agent-steward/` (или `$XDG_CONFIG_HOME`).
|
|
79
81
|
|
|
80
82
|
### Общая POSIX-обёртка (`.sh`)
|
|
81
83
|
- `cd` в рабочую директорию, `opencode run` с промптом из файла.
|
|
@@ -98,7 +100,7 @@ interface SchedulerBackend {
|
|
|
98
100
|
| Пауза / возобновление | `schtasks /change /disable` / `/enable` | строка `# PAUSED:` в управляемом блоке | `launchctl unload -w` / `load -w` |
|
|
99
101
|
| Файловые триггеры | in-process `FileWatchManager` | так же | так же |
|
|
100
102
|
| Обёртки задач | `.cmd` + `.ps1` | `.sh` | `.sh` |
|
|
101
|
-
| Логи | `%APPDATA%\opencode\
|
|
103
|
+
| Логи | `%APPDATA%\opencode\agent-steward\logs` | `~/.config/opencode/agent-steward/logs` | как на Linux |
|
|
102
104
|
| Защита `secrets.key` | `icacls` (только владелец) + `chmod` как fallback | `chmod 0600` | `chmod 0600` |
|
|
103
105
|
| Дашборд | `127.0.0.1`, динамический заголовок | так же | так же |
|
|
104
106
|
| DAG / matrix / quality gates / уведомления | в плагине, не зависят от ОС | так же | так же |
|
|
@@ -145,6 +147,6 @@ interface SchedulerBackend {
|
|
|
145
147
|
2. cron → launchd поддерживает тот же ограниченный набор шаблонов, что и Windows
|
|
146
148
|
(`* * * * *`, `*/N * * * *`, `M * * * *`, `M H * * *`, `M H * * D`).
|
|
147
149
|
На Linux доступен полный cron.
|
|
148
|
-
3. Префикс задач Windows (`\OpenCode\windows-scheduler\`)
|
|
150
|
+
3. Префикс задач Windows теперь `\OpenCode\agent-steward\` (legacy `\OpenCode\windows-scheduler\` по-прежнему распознаётся); id плагина сохранён для обратной совместимости.
|
|
149
151
|
4. `src/schtasks.ts` оставлен как тонкий shim для старых скриптов (`test-create.cjs`, `test-run.cjs`),
|
|
150
152
|
вся логика теперь в `core/scheduler/windows.ts`.
|
|
@@ -49,23 +49,25 @@ interface SchedulerBackend {
|
|
|
49
49
|
## 各操作系统的运行方式
|
|
50
50
|
|
|
51
51
|
### Windows(行为未变)
|
|
52
|
-
- 任务通过 `schtasks` 注册到 Windows 任务计划程序的 `\OpenCode\windows-scheduler\`
|
|
53
|
-
- 包装脚本:`run-task.ps1` 加每个任务专属的 `run-<name>.cmd`,位于 `%APPDATA%\opencode\windows-scheduler
|
|
54
|
-
- 日志:`%APPDATA%\opencode\
|
|
52
|
+
- 任务通过 `schtasks` 注册到 Windows 任务计划程序的 `\OpenCode\agent-steward\` 文件夹(配置文件使用 `\OpenCode\agent-steward-<profile>\`)。旧的 `\OpenCode\windows-scheduler\` 文件夹仍会被读取、重命名和按需删除。
|
|
53
|
+
- 包装脚本:`run-task.ps1` 加每个任务专属的 `run-<name>.cmd`,位于 `%APPDATA%\opencode\agent-steward\wrapper`。旧的 `%APPDATA%\opencode\windows-scheduler` 目录会在首次启动时迁移。
|
|
54
|
+
- 日志:`%APPDATA%\opencode\agent-steward\logs\<name>.log`。
|
|
55
55
|
- cron 会转换成 schtasks(`convertCronToSchTasks`)——支持与之前相同的模板集合。
|
|
56
56
|
|
|
57
57
|
### Linux
|
|
58
58
|
- 任务保存在受管 `crontab` 块中:
|
|
59
59
|
```
|
|
60
|
-
# >>> opencode-scheduler >>>
|
|
60
|
+
# >>> opencode-scheduler:agent-steward >>>
|
|
61
61
|
# task: my-task
|
|
62
62
|
*/5 * * * * /bin/bash '/…/wrapper/run-my-task.sh' >> '/…/logs/my-task.log' 2>&1
|
|
63
|
-
# <<< opencode-scheduler <<<
|
|
63
|
+
# <<< opencode-scheduler:agent-steward <<<
|
|
64
64
|
```
|
|
65
|
+
不带 `:<folder>` 后缀的旧块仍会被读取和删除。
|
|
65
66
|
- 暂停 = 带 `# PAUSED: ` 前缀的行(块会从注册表重建)。
|
|
66
67
|
- `file` 触发器的任务不会进入 crontab——由插件的 FileWatchManager 启动。
|
|
67
|
-
- 包装脚本:`~/.config/opencode/
|
|
68
|
+
- 包装脚本:`~/.config/opencode/agent-steward/wrapper/run-<name>.sh`(chmod 0755)。
|
|
68
69
|
- 支持完整 cron 语法(与 Windows 不同),因为 crontab 原生支持。
|
|
70
|
+
- 一次性任务(`once`):使用 `at -t`;如果未安装 `at`,插件会退回到分离的 `sleep && 命令` 进程(注册表中为 `pid:<pid>`)。回退方案无法在重启后保留,建议安装 `at` 包。
|
|
69
71
|
- 删除/重建只触及自己的块,`crontab` 的其他行不受影响。
|
|
70
72
|
|
|
71
73
|
### macOS
|
|
@@ -74,7 +76,7 @@ interface SchedulerBackend {
|
|
|
74
76
|
使用 `StartCalendarInterval`。
|
|
75
77
|
- 暂停 = `launchctl unload -w`,恢复 = `launchctl load -w`。
|
|
76
78
|
- 包装脚本与 Linux 相同的 `.sh`;配置路径:
|
|
77
|
-
`~/.config/opencode/
|
|
79
|
+
`~/.config/opencode/agent-steward/`(或 `$XDG_CONFIG_HOME`)。
|
|
78
80
|
|
|
79
81
|
### 共享 POSIX 包装脚本(`.sh`)
|
|
80
82
|
- `cd` 到工作目录,用文件中的提示词执行 `opencode run`。
|
|
@@ -97,7 +99,7 @@ interface SchedulerBackend {
|
|
|
97
99
|
| 暂停 / 恢复 | `schtasks /change /disable` / `/enable` | 托管块中的 `# PAUSED:` 行 | `launchctl unload -w` / `load -w` |
|
|
98
100
|
| 文件触发器 | 进程内 `FileWatchManager` | 相同 | 相同 |
|
|
99
101
|
| 任务包装脚本 | `.cmd` + `.ps1` | `.sh` | `.sh` |
|
|
100
|
-
| 日志 | `%APPDATA%\opencode\
|
|
102
|
+
| 日志 | `%APPDATA%\opencode\agent-steward\logs` | `~/.config/opencode/agent-steward/logs` | 与 Linux 相同 |
|
|
101
103
|
| `secrets.key` 保护 | `icacls`(仅所有者)+ `chmod` 回退 | `chmod 0600` | `chmod 0600` |
|
|
102
104
|
| 仪表盘 | `127.0.0.1`,动态标题 | 相同 | 相同 |
|
|
103
105
|
| DAG / matrix / quality gates / 通知 | 插件内,与操作系统无关 | 相同 | 相同 |
|
|
@@ -141,6 +143,6 @@ interface SchedulerBackend {
|
|
|
141
143
|
2. cron → launchd 支持与 Windows 相同的有限模板集合
|
|
142
144
|
(`* * * * *`、`*/N * * * *`、`M * * * *`、`M H * * *`、`M H * * D`)。
|
|
143
145
|
Linux 上支持完整 cron。
|
|
144
|
-
3. Windows
|
|
146
|
+
3. Windows 任务前缀现为 `\OpenCode\agent-steward\`(旧的 `\OpenCode\windows-scheduler\` 仍会被识别);插件 id 为向后兼容而保留。
|
|
145
147
|
4. `src/schtasks.ts` 保留为旧脚本(`test-create.cjs`、`test-run.cjs`)的薄垫片;
|
|
146
148
|
所有逻辑现在都在 `core/scheduler/windows.ts`。
|