agent-steward 0.0.4 → 0.0.6
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 +309 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +55 -8
- package/ROADMAP-STRATEGY.md +22 -19
- package/ROADMAP.md +230 -159
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +356 -0
- package/dist/core/analytics.d.ts +6 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +20 -3
- package/dist/core/audit.d.ts +6 -0
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +24 -0
- package/dist/core/budget.d.ts +118 -0
- package/dist/core/budget.d.ts.map +1 -0
- package/dist/core/budget.js +206 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +38 -0
- package/dist/core/dry-run.d.ts +26 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +199 -8
- 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/feedback.d.ts +192 -0
- package/dist/core/feedback.d.ts.map +1 -0
- package/dist/core/feedback.js +426 -0
- package/dist/core/gate-integrity.d.ts +71 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +275 -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/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/lock.d.ts +41 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +141 -29
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +132 -17
- package/dist/core/mission.d.ts +103 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +374 -0
- package/dist/core/opencode-models.d.ts +2 -2
- package/dist/core/opencode-models.d.ts.map +1 -1
- package/dist/core/opencode-models.js +28 -21
- package/dist/core/opencode-usage.d.ts +35 -0
- package/dist/core/opencode-usage.d.ts.map +1 -0
- package/dist/core/opencode-usage.js +132 -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 +78 -0
- package/dist/core/pipeline-map.d.ts +52 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +208 -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 +27 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +424 -65
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +206 -33
- package/dist/core/router/rules.d.ts.map +1 -1
- package/dist/core/router/rules.js +6 -0
- package/dist/core/run-mode.d.ts +12 -0
- package/dist/core/run-mode.d.ts.map +1 -0
- package/dist/core/run-mode.js +17 -0
- package/dist/core/scheduler/linux.d.ts +8 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +34 -9
- package/dist/core/scheduler/logs.d.ts +4 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -1
- package/dist/core/scheduler/logs.js +25 -1
- 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/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 +18 -8
- package/dist/core/self-analysis.d.ts +32 -2
- package/dist/core/self-analysis.d.ts.map +1 -1
- package/dist/core/self-analysis.js +38 -27
- package/dist/core/shutdown.d.ts +33 -2
- package/dist/core/shutdown.d.ts.map +1 -1
- package/dist/core/shutdown.js +58 -2
- package/dist/core/structured-log.d.ts +37 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +37 -0
- package/dist/core/usage-surface.d.ts +25 -0
- package/dist/core/usage-surface.d.ts.map +1 -0
- package/dist/core/usage-surface.js +41 -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 +19 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +230 -27
- package/dist/db/capability-repo.d.ts +43 -2
- package/dist/db/capability-repo.d.ts.map +1 -1
- package/dist/db/capability-repo.js +96 -11
- package/dist/db/history-repo.d.ts +70 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +170 -29
- package/dist/db/metrics-repo.d.ts +20 -2
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +35 -13
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +37 -17
- package/dist/db/recovery.d.ts +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +11 -5
- 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 +5 -0
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +9 -2
- package/dist/db/runs-repo.d.ts +19 -2
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +91 -60
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +132 -2
- package/dist/db/templates-repo.d.ts +2 -2
- package/dist/db/templates-repo.d.ts.map +1 -1
- package/dist/db/templates-repo.js +5 -3
- package/dist/history.d.ts +7 -2
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +4 -2
- package/dist/hook-output.d.ts +2 -0
- package/dist/hook-output.d.ts.map +1 -0
- package/dist/hook-output.js +31 -0
- 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 +375 -47
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1344 -192
- package/dist/notifications.d.ts +53 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +168 -21
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +82 -10
- package/dist/rpc.d.ts +354 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +145 -0
- package/dist/server.d.ts +32 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +154 -30
- package/dist/settings.d.ts +44 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +85 -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 +21 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +64 -3
- package/dist/templates.d.ts +2 -2
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +3 -3
- package/dist/types.d.ts +22 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +34 -11
- package/docs/ARCHITECTURE.md +319 -66
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +18 -4
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +28 -10
- package/docs/FEATURES.md +129 -7
- package/docs/FEATURES.zh.md +97 -6
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +43 -4
- package/docs/README.zh.md +44 -4
- package/docs/SAFETY.md +23 -3
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +58 -3
- package/locales/ru.json +58 -3
- package/locales/zh.json +58 -3
- package/opencode.pipeline.yaml +35 -0
- package/package.json +36 -4
- package/scripts/check-eslint-baseline.mjs +139 -0
- package/scripts/gen-test-plan-counters.mjs +117 -0
- package/scripts/github-ci-fetch.ps1 +37 -0
- package/scripts/pl-commit.ps1 +112 -0
- package/scripts/qa-a2-commit.ps1 +104 -0
- package/scripts/test-home.mjs +107 -0
- package/skills/scheduled-job-best-practices/SKILL.md +95 -1
- package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
- package/src/cli.ts +417 -0
- package/src/core/analytics.ts +27 -4
- package/src/core/audit.ts +25 -0
- package/src/core/budget.ts +340 -0
- package/src/core/cron-to-schtasks.ts +42 -0
- package/src/core/dry-run.ts +235 -12
- package/src/core/execution.ts +538 -0
- package/src/core/feedback.ts +582 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +330 -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/local-ai.ts +7 -3
- package/src/core/lock.ts +178 -37
- package/src/core/matrix.ts +158 -52
- package/src/core/mission.ts +531 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +96 -0
- package/src/core/pipeline-map.ts +283 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +435 -66
- package/src/core/record-history.ts +258 -81
- package/src/core/router/rules.ts +6 -0
- package/src/core/run-mode.ts +19 -0
- package/src/core/schedule-gate.ts +1 -1
- package/src/core/scheduler/at-fallback.ts +1 -1
- package/src/core/scheduler/linux.ts +40 -11
- package/src/core/scheduler/logs.ts +34 -3
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/registry.ts +2 -2
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +26 -19
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +89 -5
- 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/usage-surface.ts +70 -0
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +248 -26
- package/src/db/capability-repo.ts +127 -10
- package/src/db/history-repo.ts +281 -40
- package/src/db/metrics-repo.ts +40 -13
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +12 -5
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +17 -1
- package/src/db/runs-repo.ts +147 -65
- package/src/db/schema.ts +134 -2
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +438 -18
- package/src/history.ts +11 -4
- package/src/hook-output.ts +39 -0
- package/src/i18n.ts +12 -4
- package/src/index.ts +1902 -320
- package/src/notifications.ts +227 -47
- package/src/profiles.ts +88 -10
- package/src/rpc.ts +158 -0
- package/src/server.ts +201 -41
- package/src/settings.ts +125 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +90 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
package/docs/README.zh.md
CHANGED
|
@@ -53,9 +53,10 @@ Translations: [English](../README.md) · [Русский](README.ru.md).
|
|
|
53
53
|
|
|
54
54
|
### 语言
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
界面提供俄语、英语和中文。默认选择「自动」模式——与 OpenCode 一样,界面语言跟随 OpenCode;
|
|
57
|
+
也可以显式选择俄语、英语或中文。语言选择器位于调度器面板顶部(🌐 自动 / Русский / English / 中文),
|
|
57
58
|
也可通过 `manage_settings` 工具切换(`action: "update"`,`locale: "zh"` 等)。
|
|
58
|
-
`locale: "auto"
|
|
59
|
+
`locale: "auto"`(「自动」,默认)跟随 OpenCode 界面语言:面板会立即响应语言切换,
|
|
59
60
|
并将解析后的语言发送到服务器,使通知、摘要和仪表盘保持一致。切换无需重启。
|
|
60
61
|
仪表盘的本地化仍在推进:部分客户端字符串目前仍为俄语。按设计,agent 工具描述
|
|
61
62
|
与 schema 保持英语,输出到控制台的诊断信息保持俄语。
|
|
@@ -115,7 +116,7 @@ npm run build && npm run build:gui
|
|
|
115
116
|
|
|
116
117
|
## Agent 工具
|
|
117
118
|
|
|
118
|
-
agent 可获得完整功能 ——
|
|
119
|
+
agent 可获得完整功能 —— 30 个工具,覆盖调度、流水线、运维、可观测性与管理:
|
|
119
120
|
|
|
120
121
|
| 工具 | 参数 | 作用 |
|
|
121
122
|
|---|---|---|
|
|
@@ -145,6 +146,9 @@ agent 可获得完整功能 —— 26 个工具,覆盖调度、流水线、运
|
|
|
145
146
|
| `manage_secrets` | `action`、`name?`、`value?` | 创建、列出或删除用于任务 `env` 的 AES-256-GCM 加密密钥 |
|
|
146
147
|
| `get_audit_log` | `action?`、`target?`、`actor?`、`since?`、`until?`、`limit?` | 变更审计日志:谁、何时、通过哪个界面改了什么 |
|
|
147
148
|
| `emit_event` | `eventName`、`payload?` | 启动订阅该 MCP 事件的任务 |
|
|
149
|
+
| `pipeline_validate` | `path?`、`source?` | 校验 `opencode.pipeline.yaml`,不修改任务 |
|
|
150
|
+
| `pipeline_apply` | `path?`、`source?`、`dryRun?` | 幂等地创建/更新流水线任务;`dryRun` 只报告差异 |
|
|
151
|
+
| `pipeline_export` | `pipeline` | 将流水线任务导出回 YAML |
|
|
148
152
|
|
|
149
153
|
`schedule_task` 还接受完整的矩阵配置(`workspaceIds`、`strategy`、`failureMode`、`aggregation`、`concurrency`、`overrides`、`createAggregator`)。
|
|
150
154
|
|
|
@@ -191,6 +195,41 @@ Agent 任务以 `opencode run --auto` 运行,因此其工具策略必须显式
|
|
|
191
195
|
|
|
192
196
|
每个 workspace 会得到一个名为 `<parent>-matrix-<workspace>` 的克隆。父任务自身从不运行:它把克隆结果聚合为 `success`、`error` 或 `partial`。编辑父任务时克隆会保持同步;正在运行的克隆不会被改动。
|
|
193
197
|
|
|
198
|
+
## Pipeline 即代码
|
|
199
|
+
|
|
200
|
+
用一个 `opencode.pipeline.yaml` 文件描述整个工作流,而不是逐个创建任务:
|
|
201
|
+
|
|
202
|
+
```yaml
|
|
203
|
+
version: 1
|
|
204
|
+
name: nightly-release
|
|
205
|
+
defaults:
|
|
206
|
+
retryCount: 1
|
|
207
|
+
retryDelay: 120
|
|
208
|
+
steps:
|
|
209
|
+
- id: lint
|
|
210
|
+
schedule: "0 2 * * *"
|
|
211
|
+
prompt: Run the linter and fix what it reports.
|
|
212
|
+
qualityGate: npm run lint
|
|
213
|
+
- id: test
|
|
214
|
+
needs: [lint]
|
|
215
|
+
trigger: dag
|
|
216
|
+
prompt: Run the tests and fix failures.
|
|
217
|
+
qualityGate: npm test
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
`needs` 会变成 DAG 依赖,`trigger: dag` 的步骤只在其依赖成功后运行,`defaults` 由所有步骤继承。每个步骤都会成为名为 `<pipeline> <step>` 的任务。
|
|
221
|
+
|
|
222
|
+
```bash
|
|
223
|
+
agent-steward pipeline validate opencode.pipeline.yaml
|
|
224
|
+
agent-steward pipeline apply opencode.pipeline.yaml --dry-run
|
|
225
|
+
agent-steward pipeline apply opencode.pipeline.yaml
|
|
226
|
+
agent-steward pipeline export --pipeline nightly-release --out opencode.pipeline.yaml
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
apply 是幂等的:未变化的步骤会跳过,修改过的步骤会更新,流水线之外的任务不会被触碰。从文件中删除的步骤会被标记为 stale,但不会自动删除。agent 可通过 `pipeline_validate`、`pipeline_apply` 和 `pipeline_export` 使用同样的操作。
|
|
230
|
+
|
|
231
|
+
完整格式、矩阵扇出、校验规则与限制见 [docs/PIPELINE.md](PIPELINE.md),可直接复制的示例见 [opencode.pipeline.yaml](../opencode.pipeline.yaml)。
|
|
232
|
+
|
|
194
233
|
## GUI 与仪表盘
|
|
195
234
|
|
|
196
235
|
OpenCode 侧边栏显示任务、历史、日志、dry-run、模板、导入/导出、并发限制和矩阵分组。本地 Web 仪表盘额外提供按 workspace 的汇总、矩阵标签页、流水线视图和指标。
|
|
@@ -231,7 +270,7 @@ src/
|
|
|
231
270
|
npm install
|
|
232
271
|
npm run build # tsc
|
|
233
272
|
npm run build:gui # vite
|
|
234
|
-
npm test #
|
|
273
|
+
npm test # 115 test suites, 600+ checks
|
|
235
274
|
npm run test:en # same suites with the English locale
|
|
236
275
|
```
|
|
237
276
|
|
|
@@ -247,6 +286,7 @@ npm run test:en # same suites with the English locale
|
|
|
247
286
|
- [docs/FEATURES.md](FEATURES.md) —— 带示例的完整功能目录。
|
|
248
287
|
- [docs/FAQ.md](FAQ.md) —— 恢复场景与运维问答。
|
|
249
288
|
- [docs/MIGRATION.md](MIGRATION.md) —— 从 cron、systemd、launchd 或任务计划程序迁移。
|
|
289
|
+
- [docs/PIPELINE.md](PIPELINE.md) —— 流水线即代码:文件格式、CLI、幂等 apply。
|
|
250
290
|
- [docs/SAVINGS.md](SAVINGS.md) —— "Saved $" 估算如何计算。
|
|
251
291
|
- [CROSS_PLATFORM.md](../CROSS_PLATFORM.md) —— Windows / macOS / Linux 的差异与后端。
|
|
252
292
|
|
package/docs/SAFETY.md
CHANGED
|
@@ -44,7 +44,7 @@ risk R2 → allowedTools: [read, edit, glob, grep]
|
|
|
44
44
|
|
|
45
45
|
| Уровень | Механизм | Когда |
|
|
46
46
|
|---------|----------|-------|
|
|
47
|
-
| 1 (
|
|
47
|
+
| 1 (opt-in: `worktree: true`) | git worktree | R0/R1, когда включено у задачи |
|
|
48
48
|
| 2 | OS-jail: ограничение ФС/процессов | R1 с недоверенным контентом |
|
|
49
49
|
| 3 | Docker runner (opt-in, спринт 46) | R2/R3, недоверенные зависимости |
|
|
50
50
|
|
|
@@ -62,7 +62,13 @@ risk R2 → allowedTools: [read, edit, glob, grep]
|
|
|
62
62
|
## 6. Blast-radius
|
|
63
63
|
|
|
64
64
|
- Работа в worktree; основное дерево не трогается до принятия.
|
|
65
|
+
- Одноразовый worktree удаляется после прогона; остатки старше суток выметаются,
|
|
66
|
+
sidecar без рабочей копии очищается, чужие каталоги и свежие запуски не трогаются.
|
|
65
67
|
- Запрет push в защищённые ветки; лимит числа файлов и объёма diff.
|
|
68
|
+
- Opt-in guards (W-3): shell-`command` и/или `semantic`-условия (`filesExist`/
|
|
69
|
+
`filesMissing`, `branch` glob, `changedPaths` в `changedSince..HEAD`); любая
|
|
70
|
+
ошибка или невыполненное условие — запуск пропущен (fail-closed), видимый
|
|
71
|
+
статус `skipped` — в W-4.
|
|
66
72
|
- Egress только по явному allowlist; всё в аудит.
|
|
67
73
|
- Destructive-команды запрещены без явного разрешения в контракте.
|
|
68
74
|
|
|
@@ -108,13 +114,27 @@ paused-миссия **не потребляет compute**, комментари
|
|
|
108
114
|
- Глобальная пауза планировщика останавливает новые **registered** запуски;
|
|
109
115
|
ad-hoc миссии можно запускать и на паузе планировщика (это разные подсистемы).
|
|
110
116
|
|
|
111
|
-
## 11.
|
|
117
|
+
## 11. Ad-hoc миссии (AB-8)
|
|
118
|
+
|
|
119
|
+
Ad-hoc запуск (`run_mission`, CLI `agent-steward run`, GUI, RPC) строит тот же
|
|
120
|
+
`RunContext`, что и registered-задача: политика `hybrid` по умолчанию,
|
|
121
|
+
`allowedTools` / `deniedTools`, Quality Gate и таймаут передаются в обёртку,
|
|
122
|
+
а результат пишется в `runs` / `run_steps` с `metadata.adHoc = true`. Записи в
|
|
123
|
+
Task Scheduler, launchd или crontab не создаются. Один workspace — одна
|
|
124
|
+
активная миссия: параллельный запуск в том же каталоге отклоняется. `dryRun`
|
|
125
|
+
показывает план и маршрут, не создавая run.
|
|
126
|
+
|
|
127
|
+
## 12. Инварианты (проверяются тестами)
|
|
112
128
|
|
|
113
129
|
1. Миссия без gate-спеки не принимается.
|
|
114
130
|
2. Миссия без safety-контракта получает safe-default (R1, worktree, бюджет).
|
|
115
131
|
3. R2/R3 без approval не стартует.
|
|
116
132
|
4. Агент не получает инструмент, запрещённый скомпилированной политикой.
|
|
117
|
-
5.
|
|
133
|
+
5. Подмена gate-файла/команды детектируется: обёртка сверяет snapshot и хэш
|
|
134
|
+
входов гейта перед запуском и падает fail-closed (`gate-integrity.ts`).
|
|
135
|
+
Это обнаружение до вердикта, а не абсолютная изоляция прав: каталог гейта
|
|
136
|
+
находится вне write-scope задачи, но файлы не были бы защищены от процесса
|
|
137
|
+
с привилегиями пользователя.
|
|
118
138
|
6. Irreversible-действие невозможно до `pass`.
|
|
119
139
|
7. Превышение бюджета останавливает миссию.
|
|
120
140
|
8. Каждый вердикт, эскалация и применение эффектов попадают в аудит.
|