agent-steward 0.0.2 → 0.0.3
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 +25 -2
- package/CROSS_PLATFORM.md +11 -9
- package/README.md +9 -8
- package/ROADMAP-STRATEGY.md +93 -44
- package/ROADMAP.md +114 -999
- 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/dry-run.js +1 -1
- package/dist/core/file-watcher.js +9 -9
- package/dist/core/git-trigger.js +4 -4
- package/dist/core/lock.js +2 -4
- package/dist/core/one-shot.d.ts +27 -5
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +53 -10
- 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 +55 -35
- package/dist/core/record-history.js +22 -22
- package/dist/core/schedule-v2.d.ts +2 -2
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +7 -7
- package/dist/core/scheduler/at-fallback.d.ts +42 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +70 -0
- package/dist/core/scheduler/linux.d.ts +3 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +43 -7
- 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 +12 -1
- package/dist/core/scheduler/registry.d.ts +2 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- 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.js +2 -2
- package/dist/core/self-analysis.js +55 -55
- package/dist/core/summary.js +1 -1
- 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.js +33 -33
- package/dist/db/index.d.ts +2 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +9 -1
- 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 +48 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +137 -0
- package/dist/db/runs-repo.d.ts +120 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +319 -0
- package/dist/db/schema.d.ts +16 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +190 -35
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +66 -36
- 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 +109 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +89 -0
- package/dist/server.d.ts +2 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +20 -19
- 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 +37 -9
- package/dist/workspaces.js +1 -1
- package/docs/ARCHITECTURE.md +110 -8
- package/docs/COMPATIBILITY.md +10 -6
- package/docs/CONCEPT.md +15 -3
- package/docs/CROSS_PLATFORM.ru.md +11 -9
- package/docs/CROSS_PLATFORM.zh.md +11 -9
- 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 +26 -7
- package/docs/README.zh.md +9 -8
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
- package/gui-experimental.cjs +8 -8
- package/index.js +1 -0
- package/locales/en.json +1 -0
- package/locales/ru.json +1 -0
- package/locales/zh.json +1 -0
- package/package.json +31 -10
- 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/dry-run.ts +26 -26
- 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 +9 -9
- package/src/core/matrix.ts +31 -31
- package/src/core/native-notify.ts +2 -2
- package/src/core/one-shot.ts +63 -13
- 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 +57 -37
- package/src/core/record-history.ts +40 -40
- package/src/core/retention.ts +3 -3
- package/src/core/savings.ts +1 -1
- package/src/core/schedule-gate.ts +12 -12
- package/src/core/schedule-v2.ts +24 -24
- package/src/core/scheduler/at-fallback.ts +113 -0
- package/src/core/scheduler/index.ts +3 -3
- package/src/core/scheduler/linux.ts +64 -13
- package/src/core/scheduler/logs.ts +1 -1
- package/src/core/scheduler/mac.ts +112 -60
- package/src/core/scheduler/posix.ts +15 -1
- package/src/core/scheduler/registry.ts +6 -4
- package/src/core/scheduler/windows.ts +295 -125
- package/src/core/secrets.ts +13 -13
- package/src/core/self-analysis.ts +61 -61
- package/src/core/session.ts +3 -3
- package/src/core/structured-log.ts +3 -3
- package/src/core/summary.ts +25 -25
- 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 +41 -41
- package/src/db/git-state-repo.ts +1 -1
- package/src/db/history-repo.ts +22 -22
- package/src/db/index.ts +16 -6
- package/src/db/metrics-repo.ts +10 -10
- package/src/db/migrate.ts +10 -10
- package/src/db/recovery.ts +3 -3
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +220 -0
- package/src/db/runs-repo.ts +481 -0
- package/src/db/schema.ts +205 -44
- package/src/db/settings-repo.ts +2 -2
- package/src/db/tasks-repo.ts +10 -10
- package/src/db/templates-repo.ts +7 -7
- package/src/gui.tsx +1 -1
- package/src/history.ts +4 -4
- package/src/i18n.ts +7 -7
- package/src/index.ts +341 -304
- package/src/integrations.ts +6 -6
- package/src/notifications.ts +76 -76
- package/src/profiles.ts +98 -7
- package/src/rpc.ts +96 -1
- package/src/schtasks.ts +2 -2
- package/src/server.ts +43 -42
- 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 +45 -10
- package/src/workspaces.ts +16 -16
- 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/dist/types.js
CHANGED
|
@@ -1,20 +1,27 @@
|
|
|
1
1
|
import path from "node:path";
|
|
2
2
|
import { z } from "zod";
|
|
3
3
|
import { getProfileDir, getProfileName } from "./profiles.js";
|
|
4
|
-
/** Префикс всех задач плагина (историческое имя, сохраняется для совместимости). */
|
|
5
|
-
export const TASK_PREFIX = "OpenCode\\windows-scheduler";
|
|
6
4
|
/** Папка задач плагина в планировщике ОС (Windows). */
|
|
7
5
|
export const TASK_FOLDER = "OpenCode";
|
|
8
6
|
/**
|
|
9
7
|
* Имя папки/блока задач. У нестандартного профиля своё пространство имён,
|
|
10
8
|
* иначе профили делят одну папку Планировщика Windows и один блок crontab.
|
|
11
|
-
*
|
|
12
|
-
*
|
|
9
|
+
* Новое имя — agent-steward; историческое windows-scheduler поддерживается
|
|
10
|
+
* как legacy (см. legacyTaskFolderNameForProfile).
|
|
13
11
|
*/
|
|
14
12
|
export function taskFolderNameForProfile(profile = getProfileName()) {
|
|
13
|
+
return profile === "default" ? "agent-steward" : `agent-steward-${profile}`;
|
|
14
|
+
}
|
|
15
|
+
/** Историческое имя папки/блока задач — для чтения и удаления старых задач. */
|
|
16
|
+
export function legacyTaskFolderNameForProfile(profile = getProfileName()) {
|
|
15
17
|
return profile === "default" ? "windows-scheduler" : `windows-scheduler-${profile}`;
|
|
16
18
|
}
|
|
17
19
|
export const TASK_FOLDER_NAME = taskFolderNameForProfile();
|
|
20
|
+
export const LEGACY_TASK_FOLDER_NAME = legacyTaskFolderNameForProfile();
|
|
21
|
+
/** Префикс всех задач плагина. */
|
|
22
|
+
export const TASK_PREFIX = `OpenCode\\${TASK_FOLDER_NAME}`;
|
|
23
|
+
/** Исторический префикс задач (до переименования). */
|
|
24
|
+
export const LEGACY_TASK_PREFIX = `OpenCode\\${LEGACY_TASK_FOLDER_NAME}`;
|
|
18
25
|
/**
|
|
19
26
|
* Директория для хранения файлов плагина (обёртки, логи, блокировки, история).
|
|
20
27
|
*
|
|
@@ -53,6 +60,27 @@ export function sanitizeName(name) {
|
|
|
53
60
|
result = result.replace(/-+/g, "-").replace(/^-+|-+$/g, "");
|
|
54
61
|
return result || "task";
|
|
55
62
|
}
|
|
63
|
+
/**
|
|
64
|
+
* Проверяет идентификатор LLM-модели перед подстановкой в командную строку.
|
|
65
|
+
*
|
|
66
|
+
* Формат: `provider/model` (вариант — `provider/model#variant`).
|
|
67
|
+
* Разрешены только латиница, цифры и символы `. _ : / -` (плюс `#` для
|
|
68
|
+
* варианта). Это исключает PowerShell-subexpression (`$(...)`, backtick)
|
|
69
|
+
* и прочие спецсимволы. Пустая строка — «модель не задана», это допустимо.
|
|
70
|
+
*
|
|
71
|
+
* @returns текст ошибки или null, если значение допустимо.
|
|
72
|
+
*/
|
|
73
|
+
export function validateModelId(raw) {
|
|
74
|
+
const model = raw.trim();
|
|
75
|
+
if (!model)
|
|
76
|
+
return null;
|
|
77
|
+
if (!/^[A-Za-z0-9._:/-]+(?:#[A-Za-z0-9._-]+)?$/.test(model)) {
|
|
78
|
+
return (`Недопустимый идентификатор модели «${raw}». ` +
|
|
79
|
+
"Разрешены латиница, цифры и символы «.», «_», «:», «/», «-» " +
|
|
80
|
+
"(вариант — через «#»).");
|
|
81
|
+
}
|
|
82
|
+
return null;
|
|
83
|
+
}
|
|
56
84
|
/**
|
|
57
85
|
* Проверяет имя задачи до создания файлов и записи в БД.
|
|
58
86
|
*
|
|
@@ -71,7 +99,7 @@ export function validateTaskName(raw) {
|
|
|
71
99
|
if (/[\u0000-\u001f\u007f]/.test(name)) {
|
|
72
100
|
return "Имя задачи не должно содержать управляющие символы.";
|
|
73
101
|
}
|
|
74
|
-
const invalid =
|
|
102
|
+
const invalid = /[^\p{L}\p{N}_\-. ]/u.exec(name);
|
|
75
103
|
if (invalid) {
|
|
76
104
|
return (`Имя задачи содержит недопустимый символ «${invalid[0]}». ` +
|
|
77
105
|
"Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».");
|
|
@@ -79,13 +107,13 @@ export function validateTaskName(raw) {
|
|
|
79
107
|
// schtasks ограничивает /tn в 237 символов вместе с полным путём задачи.
|
|
80
108
|
// Полный путь: \OpenCode\<TASK_FOLDER_NAME>\<taskName>
|
|
81
109
|
// leading \ + TASK_FOLDER + \ + TASK_FOLDER_NAME + \ — префикс перед именем задачи.
|
|
82
|
-
// Для default: \OpenCode\
|
|
83
|
-
// Для не-default профиля: \OpenCode\
|
|
110
|
+
// Для default: \OpenCode\agent-steward\ = 24 символа → 213 на имя.
|
|
111
|
+
// Для не-default профиля: \OpenCode\agent-steward-<profile>\ → чем длиннее профиль, тем меньше места.
|
|
84
112
|
const prefixLength = 1 + TASK_FOLDER.length + 1 + TASK_FOLDER_NAME.length + 1;
|
|
85
113
|
const MAX_TASK_NAME_LENGTH = 237 - prefixLength;
|
|
86
114
|
if (name.length > MAX_TASK_NAME_LENGTH) {
|
|
87
115
|
return (`Имя задачи "${name}" слишком длинное (${name.length} символов, максимум ${MAX_TASK_NAME_LENGTH} ` +
|
|
88
|
-
|
|
116
|
+
"с учётом папки планировщика). Сократите имя или имя workspace (для клонов матрицы).");
|
|
89
117
|
}
|
|
90
118
|
return null;
|
|
91
119
|
}
|
|
@@ -103,7 +131,7 @@ export const ScheduleJobArgs = z.object({
|
|
|
103
131
|
ctx.addIssue({ code: z.ZodIssueCode.custom, message: error });
|
|
104
132
|
}
|
|
105
133
|
})
|
|
106
|
-
.describe("Имя задачи (уникально в рамках префикса OpenCode\\windows-scheduler)"),
|
|
134
|
+
.describe("Имя задачи (уникально в рамках префикса OpenCode\\agent-steward; legacy OpenCode\\windows-scheduler поддерживается)"),
|
|
107
135
|
schedule: z
|
|
108
136
|
.string()
|
|
109
137
|
.min(1)
|
package/dist/workspaces.js
CHANGED
|
@@ -381,7 +381,7 @@ export function deleteWorkspace(id) {
|
|
|
381
381
|
if (affected.length > 0) {
|
|
382
382
|
console.warn(`[workspace] Удалён workspace '${workspace.name}'. ` +
|
|
383
383
|
`Отвязано задач: ${affected.length} (${affected.join(", ")}). ` +
|
|
384
|
-
|
|
384
|
+
"Задачи не удалены, workspaceId очищен.");
|
|
385
385
|
}
|
|
386
386
|
const result = getDb().prepare("DELETE FROM workspaces WHERE id = ?").run(id);
|
|
387
387
|
return Number(result.changes) > 0;
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
# Architecture
|
|
2
2
|
|
|
3
|
-
This document explains how `
|
|
3
|
+
This document explains how `agent-steward` (plugin id
|
|
4
|
+
`opencode-windows-scheduler`) is put together: the process
|
|
4
5
|
model, the modules, the data model and the extension points.
|
|
5
6
|
|
|
6
7
|
- [Design principles](#design-principles)
|
|
@@ -42,7 +43,7 @@ model, the modules, the data model and the extension points.
|
|
|
42
43
|
```
|
|
43
44
|
┌─────────────────────────────┐
|
|
44
45
|
│ OpenCode (plugin host) │
|
|
45
|
-
│ • agent tools (
|
|
46
|
+
│ • agent tools (26) │
|
|
46
47
|
│ • sidebar GUI (gui.tsx) │
|
|
47
48
|
│ • RPC ↔ sidebar │
|
|
48
49
|
│ • dashboard HTTP server │
|
|
@@ -118,11 +119,58 @@ is read from the database or from files under the plugin directory.
|
|
|
118
119
|
history record and metrics into a `TaskItem`. Matrix parents get an aggregated status
|
|
119
120
|
from their clones instead of their own last run.
|
|
120
121
|
|
|
122
|
+
## Router (3-layer)
|
|
123
|
+
|
|
124
|
+
The router decides *how* each task step executes — direct local call, MCP transport, or
|
|
125
|
+
cloud model — without involving a model for known step types.
|
|
126
|
+
|
|
127
|
+
### Слой 1 — статические правила (0 токенов, мгновенно)
|
|
128
|
+
|
|
129
|
+
Таблица соответствий тип задачи → транспорт + исполнитель. Большинство операций
|
|
130
|
+
известны заранее, модель не нужна.
|
|
131
|
+
|
|
132
|
+
| Тип задачи | Транспорт | Исполнитель |
|
|
133
|
+
| --- | --- | --- |
|
|
134
|
+
| `read_file` | direct | local |
|
|
135
|
+
| `write_file` | direct | local |
|
|
136
|
+
| `run_tests` | direct | local |
|
|
137
|
+
| `apply_diff` | direct | local |
|
|
138
|
+
| `github_create_pr` | mcp | local |
|
|
139
|
+
| `jira_update_task` | mcp | cloud |
|
|
140
|
+
|
|
141
|
+
Агент хочет прочитать файл → роутер смотрит в таблицу → видит `direct + local` →
|
|
142
|
+
выполняет напрямую, без MCP, без модели.
|
|
143
|
+
|
|
144
|
+
### Слой 2 — Capability Map (0 токенов, быстро)
|
|
145
|
+
|
|
146
|
+
SQLite-таблица `task_type → model / success_rate / avg_cost / avg_time /
|
|
147
|
+
last_10_runs`. Обучается на исходах гейта (CONCEPT §9 learning loop).
|
|
148
|
+
|
|
149
|
+
- `success_rate ≥ 0.85` → маршрут локально
|
|
150
|
+
- `success_rate ≤ 0.30` → эскалация в облако или «нужно ревью»
|
|
151
|
+
|
|
152
|
+
Это и есть learning loop: роутер учится на гейтах и становится точнее без затрат
|
|
153
|
+
токенов на само решение.
|
|
154
|
+
|
|
155
|
+
### Слой 3 — локальная модель (только декомпозиция и неоднозначность)
|
|
156
|
+
|
|
157
|
+
Модель не маршрутизирует каждый шаг. Она только:
|
|
158
|
+
1. Разбивает миссию на шаги с типами (планирование);
|
|
159
|
+
2. Разрешает неоднозначность (Explore-режим, когда в Capability Map нет данных).
|
|
160
|
+
|
|
161
|
+
После этого каждый шаг проходит через Слой 1 и Слой 2.
|
|
162
|
+
|
|
163
|
+
### Эскалация
|
|
164
|
+
|
|
165
|
+
При провале гейта роутер эскалирует в облако **по правилу**, без участия модели.
|
|
166
|
+
|
|
167
|
+
---
|
|
168
|
+
|
|
121
169
|
## Modules
|
|
122
170
|
|
|
123
171
|
| Path | Role |
|
|
124
172
|
| --- | --- |
|
|
125
|
-
| `src/index.ts` | Plugin lifecycle,
|
|
173
|
+
| `src/index.ts` | Plugin lifecycle, 26 agent tools, RPC handlers, task CRUD, view assembly |
|
|
126
174
|
| `src/rpc.ts` | JSON-schema contracts for every RPC method |
|
|
127
175
|
| `src/gui.tsx` | OpenCode sidebar panel (SolidJS, built to `gui-experimental.cjs`) |
|
|
128
176
|
| `src/server.ts` | Local web dashboard HTTP server and HTML rendering |
|
|
@@ -154,7 +202,7 @@ from their clones instead of their own last run.
|
|
|
154
202
|
| `src/core/cron-to-schtasks.ts` | Cron → Task Scheduler translation |
|
|
155
203
|
| `src/core/schedule-v2.ts` | Extended cron parser/matcher, timezone math, launch windows, poll-mode decisions |
|
|
156
204
|
| `src/core/schedule-gate.ts` | Wrapper-side gate: cron re-check (poll mode), window postpone, defer-file |
|
|
157
|
-
| `src/db/` | SQLite access: schema, migrations, repositories, recovery |
|
|
205
|
+
| `src/db/` | SQLite access: schema, migrations, repositories, recovery; `runs-repo.ts` keeps durable `runs`/`run_steps` state, `run-journal.ts` writes transitions around each step, `run-resume.ts` continues a crashed chain |
|
|
158
206
|
| `src/shared/jobs-view.ts` | Task view shared by the GUI and dashboard |
|
|
159
207
|
|
|
160
208
|
## Scheduling backends
|
|
@@ -284,11 +332,11 @@ Everything lives under the plugin directory:
|
|
|
284
332
|
|
|
285
333
|
| Platform | Path |
|
|
286
334
|
| --- | --- |
|
|
287
|
-
| Windows | `%APPDATA%\opencode\windows-scheduler` |
|
|
288
|
-
| macOS/Linux | `$XDG_CONFIG_HOME/opencode/
|
|
335
|
+
| Windows | `%APPDATA%\opencode\agent-steward` (legacy `windows-scheduler` переносится автоматически) |
|
|
336
|
+
| macOS/Linux | `$XDG_CONFIG_HOME/opencode/agent-steward` (default `~/.config/...`) |
|
|
289
337
|
|
|
290
338
|
```
|
|
291
|
-
scheduler.db SQLite database (WAL)
|
|
339
|
+
scheduler.db SQLite database (WAL; схема версионируется через PRAGMA user_version)
|
|
292
340
|
logs/ per-task run logs
|
|
293
341
|
locks/ lock files
|
|
294
342
|
wrappers/ generated .cmd / .sh wrappers
|
|
@@ -307,7 +355,61 @@ the whole plugin directory (database, logs, locks, wrappers, prompts) with
|
|
|
307
355
|
|
|
308
356
|
Schema evolution is additive: `applySchema` runs `CREATE TABLE IF NOT EXISTS` on every
|
|
309
357
|
connection and adds missing columns after `PRAGMA table_info`, so upgrading the plugin
|
|
310
|
-
never requires a manual migration.
|
|
358
|
+
never requires a manual migration. `SCHEMA_VERSION` (currently `3`) is stored in
|
|
359
|
+
`PRAGMA user_version`; incremental steps live in `MIGRATIONS`.
|
|
360
|
+
|
|
361
|
+
### Durable run state (Sprint 36.1)
|
|
362
|
+
|
|
363
|
+
Sprint 36.1 adds `runs` and `run_steps`, the persistence layer for resumable DAG
|
|
364
|
+
execution:
|
|
365
|
+
|
|
366
|
+
| Table | Purpose |
|
|
367
|
+
| --- | --- |
|
|
368
|
+
| `runs` | One row per execution (`pending → running → passed/failed/cancelled`), with `task_name`, `parent_run_id`, `workspace_id`, `started_at`, `finished_at`, `metadata_json` |
|
|
369
|
+
| `run_steps` | One row per step (`pending → running → passed/failed/skipped`), with `position`, `attempt`, `idempotency_key`, `started_at`, `finished_at`, `error`, `output_json`; unique per `(run_id, step_name)`, cascade-deleted with the run |
|
|
370
|
+
|
|
371
|
+
`src/db/runs-repo.ts` owns the transitions and rejects invalid ones
|
|
372
|
+
(`InvalidTransitionError`). A failed step can be retried explicitly (`retryStep`),
|
|
373
|
+
which increments `attempt` and returns it to `running`. The tables survive process
|
|
374
|
+
crashes and reconnects, which is the prerequisite for resume (36.2) and
|
|
375
|
+
idempotent steps (36.3).
|
|
376
|
+
|
|
377
|
+
`src/db/run-journal.ts` (Sprint 36.1.b) writes every transition to disk before
|
|
378
|
+
and after executing the step body: `beginStepAttempt` commits `running` + `started_at`
|
|
379
|
+
before the body runs; `recordStepSuccess`/`recordStepFailure` commit `passed`/`failed`
|
|
380
|
+
(and `finished_at`/`error`/`output_json`) after it. The high-level wrappers
|
|
381
|
+
`runStepStatefully` / `runStepStatefullyAsync` execute `body` between those two
|
|
382
|
+
commits and propagate its error while still recording `failed`. `recoverInterruptedSteps`
|
|
383
|
+
marks any `running` steps left after a process crash as `failed` — preserving
|
|
384
|
+
`attempt`, so the next repeat gets `attempt + 1` and never restarts from 1.
|
|
385
|
+
SQLite runs in WAL mode with `synchronous = NORMAL`, so a committed transition
|
|
386
|
+
survives a `kill -9` (only the last in-flight commit can be lost with a power cut).
|
|
387
|
+
|
|
388
|
+
### Resume from the middle (Sprint 36.2)
|
|
389
|
+
|
|
390
|
+
`src/db/run-resume.ts` continues a run after a crash. `run_steps.position`
|
|
391
|
+
(schema v3) fixes the order of a linear chain — `created_at` can be identical
|
|
392
|
+
for steps inserted in one transaction, so it cannot be used for ordering; on an
|
|
393
|
+
existing v2 database the migration backfills `position` from the insertion order.
|
|
394
|
+
The `(run_id, position)` index is created after migrations, not in `SCHEMA_SQL`:
|
|
395
|
+
on an old database the column does not exist yet, so an early `CREATE INDEX`
|
|
396
|
+
would fail before the `ALTER TABLE` step.
|
|
397
|
+
`findResumeStep` returns the first step that is not `passed`/`skipped`.
|
|
398
|
+
`resumeRunSync` / `resumeRun` then:
|
|
399
|
+
|
|
400
|
+
1. recover dangling `running` steps (`recoverInterruptedSteps`), so the crash
|
|
401
|
+
victim is retried with `attempt + 1`;
|
|
402
|
+
2. skip already passed/skipped steps without invoking their handlers;
|
|
403
|
+
3. validate that every remaining step has a handler **before** any side effect;
|
|
404
|
+
4. reopen a `failed` run (`reopenRun`, the only `failed → running` transition);
|
|
405
|
+
5. execute the rest through the journal and finalize the run as `passed` or
|
|
406
|
+
`failed`.
|
|
407
|
+
|
|
408
|
+
The result reports `resumedFrom`, `resumedFromAttempt`, `executed`, `skipped`,
|
|
409
|
+
`failedStep` and `error`. With `stopOnError: false` the chain continues after a
|
|
410
|
+
failure, but the run still ends `failed`. This is covered by
|
|
411
|
+
`test-run-resume.mjs`, including a real `kill -9` in the middle of a four-step
|
|
412
|
+
chain.
|
|
311
413
|
|
|
312
414
|
## Interfaces
|
|
313
415
|
|
package/docs/COMPATIBILITY.md
CHANGED
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
**Конфигурация по линиям.** Ключ выбирает загрузчик OpenCode, а не плагин: сам
|
|
35
35
|
пакет не читает ни `plugin`, ни `plugins`, поэтому чужое поле не может уронить
|
|
36
36
|
его код. V1 подключается ключом `plugin` в `opencode.jsonc`, V2 — ключом
|
|
37
|
-
`plugins` или командой `opencode plugin add
|
|
37
|
+
`plugins` или командой `opencode plugin add agent-steward`. Оба
|
|
38
38
|
ключа одновременно не нужны. Примеры для обеих линий — в README (en/ru/zh).
|
|
39
39
|
|
|
40
40
|
**TUI в V1.** `src/tui-v1.tsx` реализует `TuiPluginModule` и живёт на тех же
|
|
@@ -206,25 +206,29 @@ Zod-объекта. `@opencode-ai/plugin@1.19.5` зависит от `zod@4.1.8`
|
|
|
206
206
|
## Инварианты состояния
|
|
207
207
|
|
|
208
208
|
Эти значения не меняются ни при переходе на dual-support в `1.5.6`, ни при
|
|
209
|
-
rename в `agent-steward` (
|
|
209
|
+
rename в `agent-steward` (Д7): иначе пользователи теряют историю, задачи,
|
|
210
210
|
настройки и уже созданные записи в планировщике ОС. Значения проверяются
|
|
211
211
|
`test-docs` по исходникам.
|
|
212
212
|
|
|
213
213
|
| Что | Значение | Где |
|
|
214
214
|
|---|---|---|
|
|
215
215
|
| `plugin id` | `opencode-windows-scheduler` | `src/index.ts`, `Plugin.define({ id })` |
|
|
216
|
-
| Каталог состояния (default) | Windows: `%APPDATA%\opencode\
|
|
216
|
+
| Каталог состояния (default) | Windows: `%APPDATA%\opencode\agent-steward`; macOS/Linux: `$XDG_CONFIG_HOME/opencode/agent-steward` или `~/.config/opencode/agent-steward` | `src/profiles.ts` |
|
|
217
217
|
| Каталог нестандартного профиля | `<каталог состояния>/profiles/<profile>` | `src/profiles.ts` |
|
|
218
218
|
| SQLite | `<PLUGIN_DIR>/scheduler.db`; `OPENCODE_SCHEDULER_DB` — только для тестов | `src/db/index.ts` |
|
|
219
219
|
| Логи, обёртки, locks | `<PLUGIN_DIR>/logs`, `<PLUGIN_DIR>/wrappers`, `<PLUGIN_DIR>/locks` | `src/types.ts` |
|
|
220
220
|
| Промпты и env-файлы задач | `<PLUGIN_DIR>/prompts`, `<PLUGIN_DIR>/env` | `src/index.ts` |
|
|
221
221
|
| Секреты | `<PLUGIN_DIR>/secrets.json`, `<PLUGIN_DIR>/secrets.key` | `src/core/secrets.ts` |
|
|
222
|
-
| Префикс задач Windows | `\OpenCode\
|
|
222
|
+
| Префикс задач Windows | `\OpenCode\agent-steward\` (новый, профиль: `\OpenCode\agent-steward-<profile>\`); legacy `\OpenCode\windows-scheduler\` по-прежнему распознаётся (алиасинг) | `src/core/scheduler/windows.ts` |
|
|
223
223
|
| Блок crontab | `# >>> opencode-scheduler:<folder> >>>` … `# <<< opencode-scheduler:<folder> <<<` (legacy-блок без суффикса читается) | `src/core/scheduler/linux.ts` |
|
|
224
224
|
| launchd label | `com.opencode.scheduler.<name>` | `src/core/scheduler/mac.ts` |
|
|
225
225
|
|
|
226
|
-
Rename
|
|
227
|
-
|
|
226
|
+
Rename (Д7) меняет npm-имя пакета (`agent-steward@0.0.2`), каталог данных
|
|
227
|
+
(`opencode/agent-steward`; legacy `opencode/windows-scheduler` копируется при первом
|
|
228
|
+
запуске) и папку задач Windows (`\OpenCode\agent-steward\`; legacy-папка читается и
|
|
229
|
+
удаляется по требованию). `plugin id`, имена файлов SQLite/логов и
|
|
230
|
+
crontab/launchd-маркеры остаются прежними (П7.2); ключи TUI-хранилища вида
|
|
231
|
+
`opencode-windows-scheduler.*` тоже не меняются.
|
|
228
232
|
|
|
229
233
|
## Связанные документы
|
|
230
234
|
|
package/docs/CONCEPT.md
CHANGED
|
@@ -89,9 +89,21 @@
|
|
|
89
89
|
- **Миссия** = цель + scope + явный критерий приёмки (гейт). Без критерия —
|
|
90
90
|
не миссия, а лотерея.
|
|
91
91
|
- **Декомпозиция** на шаги/роли (planner → implementer → reviewer …).
|
|
92
|
-
- **Capability-aware
|
|
93
|
-
|
|
94
|
-
|
|
92
|
+
- **Capability-aware роутинг (3 слоя)**:
|
|
93
|
+
- **Слой 1 — статические правила (0 токенов, мгновенно):** таблица соответствий тип задачи → транспорт + исполнитель. Большинство операций заранее известно, модель не нужна.
|
|
94
|
+
```json
|
|
95
|
+
{
|
|
96
|
+
"read_file": { "transport": "direct", "executor": "local" },
|
|
97
|
+
"write_file": { "transport": "direct", "executor": "local" },
|
|
98
|
+
"run_tests": { "transport": "direct", "executor": "local" },
|
|
99
|
+
"apply_diff": { "transport": "direct", "executor": "local" },
|
|
100
|
+
"github_create_pr": { "transport": "mcp", "executor": "local" },
|
|
101
|
+
"jira_update_task": { "transport": "mcp", "executor": "cloud" }
|
|
102
|
+
}
|
|
103
|
+
```
|
|
104
|
+
- **Слой 2 — Capability Map (0 токенов, быстро):** SQLite-таблица `task_type → model / success_rate / avg_cost / avg_time / last_10_runs`. Обучается на исходах гейта. При `success_rate ≥ 0.85` — маршрут локально; при `0.30` — эскалация в облако или «нужно ревью». Это и есть learning loop из §9.
|
|
105
|
+
- **Слой 3 — локальная модель (только декомпозиция и неоднозначность):** модель не маршрутизирует каждый шаг. Она только разбивает миссию на шаги с типами и разрешает неоднозначность (Explore-режим). После этого каждый шаг проходит через Слой 1 и Слой 2.
|
|
106
|
+
- **Эскалация при провале гейта — по правилу, без участия модели.**
|
|
95
107
|
- **Объективная верификация** (keystone): провал → эскалация / ретрай / откат;
|
|
96
108
|
никогда «готово» на слово агента.
|
|
97
109
|
- **Честная экономика**: savings ledger (net-контрфактика с учётом эскалаций и
|
|
@@ -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`。
|
package/docs/FAQ.md
CHANGED
|
@@ -20,8 +20,8 @@ destroy data.
|
|
|
20
20
|
|
|
21
21
|
Recovery steps:
|
|
22
22
|
|
|
23
|
-
1. Find the file in the plugin directory: `%APPDATA%\opencode\
|
|
24
|
-
(Windows) or `~/.config/opencode/
|
|
23
|
+
1. Find the file in the plugin directory: `%APPDATA%\opencode\agent-steward\`
|
|
24
|
+
(Windows) or `~/.config/opencode/agent-steward/` (macOS/Linux, or
|
|
25
25
|
`$XDG_CONFIG_HOME`).
|
|
26
26
|
2. Open it in an editor: it is usually truncated JSON. Fix the syntax.
|
|
27
27
|
3. Copy the fixed file back as `secrets.json` (keep the `.corrupt-*` copy as a
|
package/docs/FAQ.ru.md
CHANGED
|
@@ -20,8 +20,8 @@ Translations: [English](FAQ.md) · [中文](FAQ.zh.md)
|
|
|
20
20
|
|
|
21
21
|
Порядок восстановления:
|
|
22
22
|
|
|
23
|
-
1. Найдите файл в каталоге плагина: `%APPDATA%\opencode\
|
|
24
|
-
(Windows) или `~/.config/opencode/
|
|
23
|
+
1. Найдите файл в каталоге плагина: `%APPDATA%\opencode\agent-steward\`
|
|
24
|
+
(Windows) или `~/.config/opencode/agent-steward/` (macOS/Linux,
|
|
25
25
|
либо `$XDG_CONFIG_HOME`).
|
|
26
26
|
2. Откройте его в редакторе: обычно это обрезанный JSON. Исправьте синтаксис.
|
|
27
27
|
3. Верните исправленный файл под именем `secrets.json` (копию `.corrupt-*`
|
package/docs/FAQ.zh.md
CHANGED
|
@@ -17,8 +17,8 @@ Translations: [English](FAQ.md) · [Русский](FAQ.ru.md)
|
|
|
17
17
|
|
|
18
18
|
恢复步骤:
|
|
19
19
|
|
|
20
|
-
1. 在插件目录中找到该文件:`%APPDATA%\opencode\
|
|
21
|
-
或 `~/.config/opencode/
|
|
20
|
+
1. 在插件目录中找到该文件:`%APPDATA%\opencode\agent-steward\`(Windows)
|
|
21
|
+
或 `~/.config/opencode/agent-steward/`(macOS/Linux,或 `$XDG_CONFIG_HOME`)。
|
|
22
22
|
2. 用编辑器打开:通常是截断的 JSON,修正语法。
|
|
23
23
|
3. 把修好的文件复制回 `secrets.json`(保留 `.corrupt-*` 副本作为备份),
|
|
24
24
|
用 `manage_secrets`(`action: "list"`)验证。
|
package/docs/FEATURES.md
CHANGED
|
@@ -567,8 +567,8 @@ side effect of a read operation — recovery is **manual by design** so that no
|
|
|
567
567
|
automatic rewrite can destroy data:
|
|
568
568
|
|
|
569
569
|
1. Find the quarantined file in the plugin directory: `secrets.json.corrupt-*`
|
|
570
|
-
(Windows: `%APPDATA%\opencode\
|
|
571
|
-
`~/.config/opencode/
|
|
570
|
+
(Windows: `%APPDATA%\opencode\agent-steward\`, macOS/Linux:
|
|
571
|
+
`~/.config/opencode/agent-steward/` or `$XDG_CONFIG_HOME`).
|
|
572
572
|
2. Inspect it: the corruption is usually truncated JSON (interrupted write) or
|
|
573
573
|
manual editing. Fix the JSON syntax in a text editor.
|
|
574
574
|
3. Copy the fixed file back to `secrets.json` (keep the `.corrupt-*` copy as a
|
|
@@ -610,10 +610,11 @@ the `cleanup_history` RPC and the GUI's **Clear now** button. Aggregates in
|
|
|
610
610
|
|
|
611
611
|
## Agent interface
|
|
612
612
|
|
|
613
|
-
Twenty-
|
|
613
|
+
Twenty-six tools: `schedule_task`, `list_tasks`, `update_task`, `delete_task`,
|
|
614
614
|
`run_task_now`, `pause_task`, `resume_task`, `get_history`, `get_task_logs`, `dry_run`,
|
|
615
615
|
`manage_workspaces`, `matrix_control` (results/cancel/cleanup/preview), `get_metrics`,
|
|
616
|
-
`get_analytics`, `
|
|
616
|
+
`get_analytics`, `self_analysis` (health score, anomalies, trends), `manage_settings`,
|
|
617
|
+
`manage_local_ai`, `manage_templates`, `manage_profiles`,
|
|
617
618
|
`transfer_tasks`, `send_notification`, `get_dashboard_info`, `cleanup_history`,
|
|
618
619
|
`manage_secrets`, `get_audit_log`,
|
|
619
620
|
`emit_event`.
|
package/docs/FEATURES.zh.md
CHANGED
|
@@ -524,8 +524,8 @@ GUI 面板)支持 `list`、`set` 和 `delete`。密钥名匹配
|
|
|
524
524
|
自动重写能够破坏数据:
|
|
525
525
|
|
|
526
526
|
1. 在插件目录中找到被隔离的文件:`secrets.json.corrupt-*`
|
|
527
|
-
(Windows:`%APPDATA%\opencode\
|
|
528
|
-
`~/.config/opencode/
|
|
527
|
+
(Windows:`%APPDATA%\opencode\agent-steward\`,macOS/Linux:
|
|
528
|
+
`~/.config/opencode/agent-steward/` 或 `$XDG_CONFIG_HOME`)。
|
|
529
529
|
2. 检查它:损坏通常是被截断的 JSON(写入中断)或
|
|
530
530
|
手工编辑。在文本编辑器中修正 JSON 语法。
|
|
531
531
|
3. 把修好的文件复制回 `secrets.json`(保留 `.corrupt-*` 副本作为
|
|
@@ -566,10 +566,11 @@ GUI 面板)支持 `list`、`set` 和 `delete`。密钥名匹配
|
|
|
566
566
|
|
|
567
567
|
## Agent 接口
|
|
568
568
|
|
|
569
|
-
|
|
569
|
+
二十六个工具:`schedule_task`、`list_tasks`、`update_task`、`delete_task`、
|
|
570
570
|
`run_task_now`、`pause_task`、`resume_task`、`get_history`、`get_task_logs`、`dry_run`、
|
|
571
571
|
`manage_workspaces`、`matrix_control`(results/cancel/cleanup/preview)、`get_metrics`、
|
|
572
|
-
`get_analytics`、`manage_settings
|
|
572
|
+
`get_analytics`、`self_analysis`(健康评分、异常、趋势)、`manage_settings`、
|
|
573
|
+
`manage_local_ai`、`manage_templates`、`manage_profiles`、
|
|
573
574
|
`transfer_tasks`、`send_notification`、`get_dashboard_info`、`cleanup_history`、
|
|
574
575
|
`manage_secrets`、`get_audit_log`、
|
|
575
576
|
`emit_event`。
|