opencode-windows-scheduler 1.2.1 → 1.2.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 +20 -0
- package/README.md +32 -6
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +114 -14
- package/docs/README.ru.md +208 -0
- package/package.json +12 -5
- package/src/gui.tsx +3832 -3832
- package/src/server.ts +121 -13
- package/README.ru.md +0 -141
- package/dist/gui-experimental.cjs +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,26 @@ All notable changes to this project are documented here. Format follows [Keep a
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [1.2.3] - 2026-11-13
|
|
8
|
+
|
|
9
|
+
### Changed
|
|
10
|
+
|
|
11
|
+
- README переписан под OpenCode v2: установка через `plugins` и `opencode plugin add` (ключ `plugin` в конфиге устарел), добавлены FAQ, бейдж загрузок и ссылка на CROSS_PLATFORM.md, исправлено число тестовых сюит (26).
|
|
12
|
+
- Русский README перенесён в `docs/README.ru.md` и синхронизирован с английским: одноразовые запуски, непрерывность сессий, webhooks, Prometheus/OTLP, матричные сборки, FAQ.
|
|
13
|
+
- `package.json`: описание и ключевые слова расширены для поиска (OpenCode v2, планировщик, оркестрация, DAG, матрицы, Quality Gates, наблюдаемость).
|
|
14
|
+
|
|
15
|
+
### Fixed
|
|
16
|
+
|
|
17
|
+
- Страница пакета на npm показывала устаревший русский README: npm выбирал `README.ru.md` вместо `README.md`. Теперь в корне только английский README, npm отдаёт актуальный текст.
|
|
18
|
+
|
|
19
|
+
## [1.2.2] - 2026-11-13
|
|
20
|
+
|
|
21
|
+
### Fixed
|
|
22
|
+
|
|
23
|
+
- Тест дашборда больше не требует Windows-название планировщика в HTML (платформа macOS/Linux показывает «OpenCode Scheduler»), проверка переведена на `getSchedulerTitle()`.
|
|
24
|
+
- Зомби-процесс плагина, удерживающий порт веб-дашборда, теперь снимается и на macOS/Linux: PID слушающих сокетов ищутся через `lsof` (Linux дополнительно — `ss`), имя процесса читается из `ps` (для Node берём basename argv[0], т.к. comm главного потока — `MainThread`), убиваем через SIGKILL.
|
|
25
|
+
- Дашборд перед повторным bind порта ждёт его освобождения (до 3 с через опрос `lsof`/`ss`): SIGKILL на POSIX асинхронный, и сокет может держаться ещё какое-то время после снятия процесса — без этого дашборд уходил на запасной порт вместо освобождённого.
|
|
26
|
+
|
|
7
27
|
## [1.2.1] - 2026-11-13
|
|
8
28
|
|
|
9
29
|
### Fixed
|
package/README.md
CHANGED
|
@@ -1,13 +1,14 @@
|
|
|
1
1
|
# opencode-windows-scheduler
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> OpenCode v2 plugin for scheduling and orchestrating AI agent jobs — cron, one-shot runs, DAG pipelines, matrix builds, quality gates, SQLite history and a local web dashboard. Runs on Windows, macOS and Linux. Free and open source (MIT).
|
|
4
4
|
|
|
5
5
|
[](https://github.com/DeadSno/opencode-windows-scheduler/actions/workflows/ci.yml)
|
|
6
6
|
[](https://www.npmjs.com/package/opencode-windows-scheduler)
|
|
7
|
+
[](https://www.npmjs.com/package/opencode-windows-scheduler)
|
|
7
8
|
[](LICENSE)
|
|
8
9
|
[](package.json)
|
|
9
10
|
|
|
10
|
-
Русская версия: [README.ru.md](README.ru.md).
|
|
11
|
+
Русская версия: [docs/README.ru.md](docs/README.ru.md).
|
|
11
12
|
|
|
12
13
|
---
|
|
13
14
|
|
|
@@ -46,14 +47,15 @@ Want to see it without installing OpenCode? `node scripts/demo-dashboard.mjs` st
|
|
|
46
47
|
Requires OpenCode v2 and Node.js 20+.
|
|
47
48
|
|
|
48
49
|
```bash
|
|
49
|
-
|
|
50
|
+
opencode plugin add opencode-windows-scheduler
|
|
50
51
|
```
|
|
51
52
|
|
|
52
|
-
|
|
53
|
+
Or add the plugin to `opencode.jsonc` manually:
|
|
53
54
|
|
|
54
55
|
```jsonc
|
|
55
56
|
{
|
|
56
|
-
"
|
|
57
|
+
"$schema": "https://opencode.ai/config.json",
|
|
58
|
+
"plugins": ["opencode-windows-scheduler"],
|
|
57
59
|
"experimental": {
|
|
58
60
|
"schedules": false
|
|
59
61
|
}
|
|
@@ -62,6 +64,12 @@ Add the plugin to `opencode.jsonc`:
|
|
|
62
64
|
|
|
63
65
|
`experimental.schedules: false` disables the built-in OpenCode scheduler so the agent does not confuse built-in job tools with this plugin's tools. Restart OpenCode after changing the config.
|
|
64
66
|
|
|
67
|
+
Alternatively, install globally with npm:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npm install -g opencode-windows-scheduler
|
|
71
|
+
```
|
|
72
|
+
|
|
65
73
|
From source:
|
|
66
74
|
|
|
67
75
|
```bash
|
|
@@ -163,7 +171,7 @@ Job wrappers run `opencode run` in the task working directory, so project MCP se
|
|
|
163
171
|
npm install
|
|
164
172
|
npm run build # tsc
|
|
165
173
|
npm run build:gui # vite
|
|
166
|
-
npm test #
|
|
174
|
+
npm test # 26 test suites, 500+ checks
|
|
167
175
|
```
|
|
168
176
|
|
|
169
177
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
|
@@ -173,6 +181,24 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
|
|
173
181
|
- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — process model, modules, backends, data model.
|
|
174
182
|
- [docs/FEATURES.md](docs/FEATURES.md) — full feature catalog with examples.
|
|
175
183
|
- [docs/MIGRATION.md](docs/MIGRATION.md) — moving from cron, systemd, launchd or Task Scheduler.
|
|
184
|
+
- [CROSS_PLATFORM.md](CROSS_PLATFORM.md) — Windows / macOS / Linux differences and backends.
|
|
185
|
+
|
|
186
|
+
## FAQ
|
|
187
|
+
|
|
188
|
+
**Does it work when OpenCode is closed?**
|
|
189
|
+
Yes. Jobs are registered with the native OS scheduler, so they run without an open OpenCode window.
|
|
190
|
+
|
|
191
|
+
**Which platforms are supported?**
|
|
192
|
+
Windows (Task Scheduler), macOS (launchd) and Linux (crontab). Backend differences are documented in [CROSS_PLATFORM.md](CROSS_PLATFORM.md).
|
|
193
|
+
|
|
194
|
+
**Where does my data go?**
|
|
195
|
+
Nowhere. History, logs, metrics and settings are stored locally in SQLite. No telemetry, no accounts, no cloud.
|
|
196
|
+
|
|
197
|
+
**How is this different from `experimental.schedules`?**
|
|
198
|
+
The built-in scheduler runs jobs while OpenCode is open. This plugin uses the native OS scheduler and adds DAG pipelines, matrix builds, quality gates, webhooks and observability.
|
|
199
|
+
|
|
200
|
+
**Can jobs run in other repositories?**
|
|
201
|
+
Yes. Workspaces point at project paths, and a matrix build runs one template across several workspaces at once.
|
|
176
202
|
|
|
177
203
|
## Roadmap
|
|
178
204
|
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/dist/server.js
CHANGED
|
@@ -29,8 +29,12 @@ const PREFERRED_PORT = 3782;
|
|
|
29
29
|
const FALLBACK_PORT = 4782;
|
|
30
30
|
/** Дополнительный порт, если и 3782, и 4782 заняты чужими процессами. */
|
|
31
31
|
const EXTRA_PORTS = [5782];
|
|
32
|
-
|
|
33
|
-
|
|
32
|
+
const IS_WINDOWS = process.platform === "win32";
|
|
33
|
+
/**
|
|
34
|
+
* Имена процессов, которые считаем «зомби» от прошлых запусков плагина.
|
|
35
|
+
* На Windows процессы называются node.exe / bun.exe, на POSIX — node / bun.
|
|
36
|
+
*/
|
|
37
|
+
const ZOMBIE_IMAGE_NAMES = new Set(["node", "nodejs", "node.exe", "bun", "bun.exe"]);
|
|
34
38
|
/** Маркер-заголовок: по нему узнаём «свой» дашборд, уже слушающий порт. */
|
|
35
39
|
const DASHBOARD_HEADER = "x-plugin-dashboard";
|
|
36
40
|
const DASHBOARD_MARKER = "opencode-windows-scheduler";
|
|
@@ -159,16 +163,21 @@ export async function startDashboardServer(deps, ports) {
|
|
|
159
163
|
return { port };
|
|
160
164
|
}
|
|
161
165
|
// Порт занят чужим или старым процессом: пробуем снять зомби
|
|
162
|
-
// (только node/bun этого плагина) и
|
|
166
|
+
// (только node/bun этого плагина) и повторить bind.
|
|
163
167
|
if (port !== 0 && (await tryFreeZombiePort(port))) {
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
168
|
+
// SIGKILL асинхронный: на POSIX процесс может ещё какое-то время
|
|
169
|
+
// держать сокет, поэтому сначала ждём освобождения порта.
|
|
170
|
+
const freed = await waitForPortFree(port, 3000);
|
|
171
|
+
if (freed) {
|
|
172
|
+
try {
|
|
173
|
+
const server = await listenOn(port, deps);
|
|
174
|
+
running = { server, port };
|
|
175
|
+
console.log(`[windows-scheduler] Веб-дашборд запущен: http://localhost:${port}`);
|
|
176
|
+
return { port };
|
|
177
|
+
}
|
|
178
|
+
catch {
|
|
179
|
+
// Не вышло — идём к следующему порту.
|
|
180
|
+
}
|
|
172
181
|
}
|
|
173
182
|
}
|
|
174
183
|
// Чужой сервис — пробуем запасной порт.
|
|
@@ -214,7 +223,12 @@ async function tryFreeZombiePort(port) {
|
|
|
214
223
|
continue;
|
|
215
224
|
}
|
|
216
225
|
try {
|
|
217
|
-
|
|
226
|
+
if (IS_WINDOWS) {
|
|
227
|
+
await execFileAsync("taskkill", ["/PID", String(pid), "/T", "/F"], { windowsHide: true });
|
|
228
|
+
}
|
|
229
|
+
else {
|
|
230
|
+
process.kill(pid, "SIGKILL");
|
|
231
|
+
}
|
|
218
232
|
console.log(`[windows-scheduler] Снят зомби-процесс ${info.name} (PID ${pid}), державший порт ${port}.`);
|
|
219
233
|
killed = true;
|
|
220
234
|
}
|
|
@@ -224,8 +238,25 @@ async function tryFreeZombiePort(port) {
|
|
|
224
238
|
}
|
|
225
239
|
return killed;
|
|
226
240
|
}
|
|
227
|
-
/**
|
|
241
|
+
/** Ждёт, пока порт освободится (POSIX: убитый процесс отпускает сокет не синхронно). */
|
|
242
|
+
async function waitForPortFree(port, timeoutMs) {
|
|
243
|
+
const deadline = Date.now() + timeoutMs;
|
|
244
|
+
while (Date.now() < deadline) {
|
|
245
|
+
const pids = await findListeningPids(port);
|
|
246
|
+
if (pids.length === 0)
|
|
247
|
+
return true;
|
|
248
|
+
await new Promise((resolve) => setTimeout(resolve, 150));
|
|
249
|
+
}
|
|
250
|
+
return false;
|
|
251
|
+
}
|
|
252
|
+
/** Возвращает PID'ы процессов, слушающих указанный TCP-порт. */
|
|
228
253
|
async function findListeningPids(port) {
|
|
254
|
+
if (IS_WINDOWS)
|
|
255
|
+
return findListeningPidsWindows(port);
|
|
256
|
+
return findListeningPidsPosix(port);
|
|
257
|
+
}
|
|
258
|
+
/** Windows: netstat -ano, состояния LISTENING. */
|
|
259
|
+
async function findListeningPidsWindows(port) {
|
|
229
260
|
try {
|
|
230
261
|
const { stdout } = await execFileAsync("netstat", ["-ano", "-p", "TCP"], {
|
|
231
262
|
windowsHide: true,
|
|
@@ -252,8 +283,50 @@ async function findListeningPids(port) {
|
|
|
252
283
|
return [];
|
|
253
284
|
}
|
|
254
285
|
}
|
|
255
|
-
/**
|
|
286
|
+
/**
|
|
287
|
+
* macOS/Linux: lsof (есть в macOS и на большинстве Linux-образов),
|
|
288
|
+
* на Linux — запасной вариант через ss из iproute2.
|
|
289
|
+
*/
|
|
290
|
+
async function findListeningPidsPosix(port) {
|
|
291
|
+
try {
|
|
292
|
+
const { stdout } = await execFileAsync("lsof", ["-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-t"], { windowsHide: true });
|
|
293
|
+
const pids = stdout
|
|
294
|
+
.split(/\s+/)
|
|
295
|
+
.map(Number)
|
|
296
|
+
.filter((pid) => Number.isInteger(pid) && pid > 0);
|
|
297
|
+
if (pids.length > 0)
|
|
298
|
+
return Array.from(new Set(pids));
|
|
299
|
+
}
|
|
300
|
+
catch {
|
|
301
|
+
// lsof может отсутствовать или не быть в PATH — пробуем ss.
|
|
302
|
+
}
|
|
303
|
+
if (process.platform === "linux") {
|
|
304
|
+
try {
|
|
305
|
+
const { stdout } = await execFileAsync("ss", ["-ltnp", `sport = :${port}`], {
|
|
306
|
+
windowsHide: true,
|
|
307
|
+
});
|
|
308
|
+
const pids = new Set();
|
|
309
|
+
for (const match of stdout.matchAll(/pid=(\d+)/g)) {
|
|
310
|
+
const pid = Number(match[1]);
|
|
311
|
+
if (Number.isInteger(pid) && pid > 0)
|
|
312
|
+
pids.add(pid);
|
|
313
|
+
}
|
|
314
|
+
return Array.from(pids);
|
|
315
|
+
}
|
|
316
|
+
catch {
|
|
317
|
+
// ss тоже недоступен — считаем, что владельца порта не знаем.
|
|
318
|
+
}
|
|
319
|
+
}
|
|
320
|
+
return [];
|
|
321
|
+
}
|
|
322
|
+
/** Имя процесса и командная строка. */
|
|
256
323
|
async function getProcessInfo(pid) {
|
|
324
|
+
if (IS_WINDOWS)
|
|
325
|
+
return getProcessInfoWindows(pid);
|
|
326
|
+
return getProcessInfoPosix(pid);
|
|
327
|
+
}
|
|
328
|
+
/** Имя процесса и командная строка через CIM (Windows PowerShell). */
|
|
329
|
+
async function getProcessInfoWindows(pid) {
|
|
257
330
|
try {
|
|
258
331
|
const script = '$p = Get-CimInstance Win32_Process -Filter "ProcessId=' +
|
|
259
332
|
pid +
|
|
@@ -271,6 +344,33 @@ async function getProcessInfo(pid) {
|
|
|
271
344
|
return null;
|
|
272
345
|
}
|
|
273
346
|
}
|
|
347
|
+
/** Имя процесса и командная строка через ps (macOS/Linux). */
|
|
348
|
+
async function getProcessInfoPosix(pid) {
|
|
349
|
+
try {
|
|
350
|
+
// NOTE: на Linux у Node главный поток помечен как "MainThread", поэтому
|
|
351
|
+
// имя берём из argv[0] командной строки (это полный путь к бинарнику),
|
|
352
|
+
// а comm используем только как запасной вариант.
|
|
353
|
+
const { stdout: argsOut } = await execFileAsync("ps", ["-p", String(pid), "-o", "args="], {
|
|
354
|
+
windowsHide: true,
|
|
355
|
+
});
|
|
356
|
+
const args = argsOut.trim();
|
|
357
|
+
const argv0 = args.split(/\s+/)[0]?.replace(/^["']|["']$/g, "") ?? "";
|
|
358
|
+
let name = argv0.split(/[\\/]/).pop() ?? "";
|
|
359
|
+
if (!name) {
|
|
360
|
+
const { stdout: commOut } = await execFileAsync("ps", ["-p", String(pid), "-o", "comm="], {
|
|
361
|
+
windowsHide: true,
|
|
362
|
+
});
|
|
363
|
+
const comm = commOut.trim();
|
|
364
|
+
if (!comm)
|
|
365
|
+
return null;
|
|
366
|
+
name = comm.split(/[\\/]/).pop() || comm;
|
|
367
|
+
}
|
|
368
|
+
return { name, commandLine: args };
|
|
369
|
+
}
|
|
370
|
+
catch {
|
|
371
|
+
return null;
|
|
372
|
+
}
|
|
373
|
+
}
|
|
274
374
|
/** Проверяет по маркер-заголовку, что на порту отвечает наш дашборд. */
|
|
275
375
|
async function isOwnDashboardOn(port) {
|
|
276
376
|
try {
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
# opencode-windows-scheduler
|
|
2
|
+
|
|
3
|
+
> Плагин для планирования и оркестрации задач AI-агентов в OpenCode v2: cron, одноразовые запуски, DAG-пайплайны, матричные сборки, Quality Gates и наблюдаемость. Бесплатно, с открытым кодом (MIT).
|
|
4
|
+
|
|
5
|
+
[](https://github.com/DeadSno/opencode-windows-scheduler/actions/workflows/ci.yml)
|
|
6
|
+
[](https://www.npmjs.com/package/opencode-windows-scheduler)
|
|
7
|
+
[](../LICENSE)
|
|
8
|
+
[](../package.json)
|
|
9
|
+
|
|
10
|
+
English version: [README.md](../README.md).
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+

|
|
15
|
+
|
|
16
|
+
Хотите посмотреть без установки OpenCode? `node scripts/demo-dashboard.mjs` поднимет дашборд с демо-данными на http://localhost:4380.
|
|
17
|
+
|
|
18
|
+
## Зачем
|
|
19
|
+
|
|
20
|
+
Большинство планировщиков для AI-агентов — это обёртки над cron: запустить промпт по таймеру и записать лог. Этот плагин относится к задачам агента как к **воркфлоу**:
|
|
21
|
+
|
|
22
|
+
- **DAG-пайплайны** — задача ждёт зависимости и продолжается по success/error.
|
|
23
|
+
- **Матричные сборки** — один шаблон, N репозиториев, параллельно или последовательно, с лимитом конкурентности и переопределениями для workspace.
|
|
24
|
+
- **Quality Gates** — задача считается успешной только если прошла `npm test` (или любая другая команда).
|
|
25
|
+
- **Наблюдаемость** — история в SQLite, метрики, логи и локальный веб-дашборд.
|
|
26
|
+
- **Работает без запущенного OpenCode** — задачи регистрируются в нативном планировщике ОС (Планировщик Windows, launchd, crontab) и переживают перезагрузку.
|
|
27
|
+
|
|
28
|
+
Всё выполняется на вашей машине: без SaaS, телеметрии и аккаунтов.
|
|
29
|
+
|
|
30
|
+
## Возможности
|
|
31
|
+
|
|
32
|
+
| Область | Что есть |
|
|
33
|
+
|---|---|
|
|
34
|
+
| Расписание | cron-выражения, одноразовые запуски через `runAt` / `delaySeconds`, нативный планировщик ОС (Windows / macOS / Linux), локальное время без таймзон, пауза/возобновление, непрерывность сессий (`new` / `reuse` / `last` с очисткой `sessionMaxRuns`) |
|
|
35
|
+
| Надёжность | lock-файл от наложения запусков, таймауты с жёстким kill, повторы с задержкой, crash recovery |
|
|
36
|
+
| Качество | команда Quality Gate, before/after hooks, allow/deny списки инструментов для задачи |
|
|
37
|
+
| Оркестрация | DAG `dependsOn`, цепочки `nextTaskOnSuccess` / `nextTaskOnError`, матричный fan-out (parallel/sequential, `continue`/`stop`, concurrency, переопределения для workspace, агрегатор) |
|
|
38
|
+
| Триггеры | cron, одноразовый запуск (`triggerType: "once"`), изменение файла (chokidar), MCP-события, входящие webhooks (`POST /api/hooks/:task` с HMAC) |
|
|
39
|
+
| Мультирепо | workspaces с валидацией путей, запуски по workspace, матрица поверх родительской задачи |
|
|
40
|
+
| Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики (длительность, токены, стоимость), JSONL-логи с `/api/logs`, Prometheus `/metrics`, экспорт OTLP, логи по задачам, веб-дашборд с аналитикой за 14 дней, ретеншн истории и экспорт CSV/JSON |
|
|
41
|
+
| Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, webhook-уведомления, настройки |
|
|
42
|
+
| Интерфейсы | панель OpenCode GUI, веб-дашборд, 22 инструмента для агента, встроенный скилл |
|
|
43
|
+
|
|
44
|
+
## Установка
|
|
45
|
+
|
|
46
|
+
Нужны OpenCode v2 и Node.js 20+.
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
opencode plugin add opencode-windows-scheduler
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Или добавьте плагин в `opencode.jsonc` вручную:
|
|
53
|
+
|
|
54
|
+
```jsonc
|
|
55
|
+
{
|
|
56
|
+
"$schema": "https://opencode.ai/config.json",
|
|
57
|
+
"plugins": ["opencode-windows-scheduler"],
|
|
58
|
+
"experimental": {
|
|
59
|
+
"schedules": false
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
`experimental.schedules: false` отключает встроенный планировщик OpenCode, чтобы агент не путал встроенные инструменты расписаний с инструментами этого плагина. После изменения конфигурации перезапустите OpenCode.
|
|
65
|
+
|
|
66
|
+
Альтернатива — глобальная установка через npm:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npm install -g opencode-windows-scheduler
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Из исходников:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
git clone https://github.com/DeadSno/opencode-windows-scheduler.git
|
|
76
|
+
cd opencode-windows-scheduler
|
|
77
|
+
npm install
|
|
78
|
+
npm run build && npm run build:gui
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Инструменты для агента
|
|
82
|
+
|
|
83
|
+
Агенту доступен весь функционал — 22 инструмента: расписание, пайплайны, эксплуатация, аналитика и администрирование.
|
|
84
|
+
|
|
85
|
+
| Инструмент | Аргументы | Что делает |
|
|
86
|
+
|---|---|---|
|
|
87
|
+
| `schedule_task` | `name`, `prompt`, `schedule` для cron или `runAt` / `delaySeconds` для одноразового запуска, опционально `session` / `sessionMaxRuns`, `timeoutSeconds`, `model`, `priority`, `beforeScript`, `afterScript`, `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`, `nextTaskOnSuccess`, `nextTaskOnError`, `triggerType`, `mcpEvent`, `workingDirectory`, `workspaceId`, `allowedTools`, `deniedTools`, `matrix` | Регистрирует задачу в планировщике ОС (cron, одноразовый запуск, файл или MCP-событие) |
|
|
88
|
+
| `list_tasks` | — | Задачи: расписание, статус, следующее время запуска, цепочки, workspace, сводка матрицы |
|
|
89
|
+
| `update_task` | `name` + изменяемые поля | Частичное обновление: незаданные поля сохраняются, пустые — очищаются, `matrix: null` убирает матрицу |
|
|
90
|
+
| `delete_task` | `name` | Удаляет задачу (родитель матрицы — вместе с клонами и агрегатором) |
|
|
91
|
+
| `run_task_now` | `name` | Немедленный запуск (для матрицы — запуск fan-out) |
|
|
92
|
+
| `pause_task` | `name` | Пауза (для матрицы — все клоны) |
|
|
93
|
+
| `resume_task` | `name` | Возобновление |
|
|
94
|
+
| `get_history` | `taskName?`, `status?`, `limit?` | История запусков: длительность, токены, стоимость, модель, Quality Gate, хуки |
|
|
95
|
+
| `get_task_logs` | `name`, `lines?` | Хвост лога запуска |
|
|
96
|
+
| `dry_run` | `name?` | Симуляция пайплайна (или всех задач): порядок, DAG, fan-out, оценки |
|
|
97
|
+
| `manage_workspaces` | `action`, `id?`, `name?`, `path?`, `color?` | Multi-repo workspace: список, добавление, изменение, удаление |
|
|
98
|
+
| `matrix_control` | `action`, `name?` | Результаты матрицы, отмена клонов, очистка осиротевших задач, предпросмотр |
|
|
99
|
+
| `get_metrics` | — | Всего запусков, успехов и падений |
|
|
100
|
+
| `get_analytics` | `days?`, `topLimit?` | Отчёт за период: запуски, успешность, длительность, токены, стоимость, топ задач |
|
|
101
|
+
| `manage_settings` | `action`, `maxConcurrent?`, `winterMode?`, `notifications?`, `history?` | Чтение и изменение глобальных настроек (параллелизм, уведомления, retention) |
|
|
102
|
+
| `manage_templates` | `action`, поля шаблона | Список, сохранение и удаление шаблонов задач |
|
|
103
|
+
| `manage_profiles` | `action`, `name?`, `port?` | Список, создание, переключение и удаление изолированных профилей |
|
|
104
|
+
| `transfer_tasks` | `action`, `data?` | Экспорт всех задач в JSON и импорт обратно |
|
|
105
|
+
| `send_notification` | `action` (`test`/`digest`) | Проверка канала уведомлений или отправка дайджеста |
|
|
106
|
+
| `get_dashboard_info` | — | Порт/URL дашборда, платформа, заголовок, активный профиль |
|
|
107
|
+
| `cleanup_history` | `retentionDays?`, `maxRecords?` | Удаление старой истории по возрасту и/или лимиту записей |
|
|
108
|
+
| `emit_event` | `eventName`, `payload?` | Запуск задач, подписанных на MCP-событие |
|
|
109
|
+
|
|
110
|
+
`schedule_task` принимает и полную конфигурацию матрицы (`workspaceIds`, `strategy`, `failureMode`, `aggregation`, `concurrency`, `overrides`, `createAggregator`).
|
|
111
|
+
|
|
112
|
+
## Скилл для агента
|
|
113
|
+
|
|
114
|
+
Плагин сам регистрирует встроенный скилл `scheduled-job-best-practices`: агент подгружает инструкцию только когда она действительно нужна — проектирование cron, самодостаточные промпты, Quality Gates, лимиты матрицы, правила DAG и разбор падений. Ручная настройка `.opencode/skills` не требуется. Вместе со скиллом поставляется `references/recipes.md` — семь готовых конфигураций.
|
|
115
|
+
|
|
116
|
+
## Матричные сборки
|
|
117
|
+
|
|
118
|
+
```jsonc
|
|
119
|
+
{
|
|
120
|
+
"name": "deploy",
|
|
121
|
+
"schedule": "0 3 * * *",
|
|
122
|
+
"prompt": "Build, test and deploy",
|
|
123
|
+
"matrix": {
|
|
124
|
+
"workspaceIds": ["frontend-id", "backend-id", "mobile-id"],
|
|
125
|
+
"strategy": "parallel",
|
|
126
|
+
"failureMode": "continue",
|
|
127
|
+
"aggregation": "summary",
|
|
128
|
+
"concurrency": 2,
|
|
129
|
+
"createAggregator": true,
|
|
130
|
+
"overrides": {
|
|
131
|
+
"mobile-id": { "qualityGate": "npm run test:mobile" }
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
Каждый workspace получает клон `<parent>-matrix-<workspace>`. Родительская задача сама не выполняется: она агрегирует результаты клонов в `success`, `error` или `partial`. Клоны синхронизируются с родителем при его изменении; запущенные клоны не затрагиваются.
|
|
138
|
+
|
|
139
|
+
## GUI и дашборд
|
|
140
|
+
|
|
141
|
+
В боковой панели OpenCode доступны задачи, история, логи, dry-run, шаблоны, импорт/экспорт, лимит конкурентности и группировка матриц. Локальный веб-дашборд добавляет сводку по workspace, вкладки матриц, вид пайплайна и метрики.
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
npm run build:gui # собирает gui-experimental.cjs
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
## Как это устроено
|
|
148
|
+
|
|
149
|
+
```
|
|
150
|
+
src/
|
|
151
|
+
index.ts жизненный цикл плагина, инструменты агента, RPC
|
|
152
|
+
gui.tsx панель OpenCode в сайдбаре
|
|
153
|
+
server.ts локальный веб-дашборд
|
|
154
|
+
core/
|
|
155
|
+
scheduler/ бэкенды Windows / Linux / macOS
|
|
156
|
+
matrix.ts fan-out, агрегация, синхронизация, отмена
|
|
157
|
+
record-history.ts история, повторы, цепочки, продолжение матриц
|
|
158
|
+
dry-run.ts симуляция пайплайна
|
|
159
|
+
lock.ts защита от наложения запусков
|
|
160
|
+
file-watcher.ts триггеры chokidar
|
|
161
|
+
db/ SQLite: задачи, история, метрики, настройки
|
|
162
|
+
task-transfer.ts экспорт / импорт / валидация
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
Обёртки задач запускают `opencode run` в рабочей директории задачи, поэтому MCP-серверы проекта подхватываются автоматически.
|
|
166
|
+
|
|
167
|
+
## Разработка
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
npm install
|
|
171
|
+
npm run build # tsc
|
|
172
|
+
npm run build:gui # vite
|
|
173
|
+
npm test # полный набор тестов, 500+ проверок
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
Подробности — в [CONTRIBUTING.md](../CONTRIBUTING.md).
|
|
177
|
+
|
|
178
|
+
## Документация
|
|
179
|
+
|
|
180
|
+
- [ARCHITECTURE.md](ARCHITECTURE.md) — модель процессов, модули, бэкенды, модель данных.
|
|
181
|
+
- [FEATURES.md](FEATURES.md) — полный каталог возможностей с примерами.
|
|
182
|
+
- [MIGRATION.md](MIGRATION.md) — переезд с cron, systemd, launchd или Планировщика Windows.
|
|
183
|
+
|
|
184
|
+
## FAQ
|
|
185
|
+
|
|
186
|
+
**Работает ли плагин, когда OpenCode закрыт?**
|
|
187
|
+
Да. Задачи регистрируются в нативном планировщике ОС, поэтому выполняются без открытого OpenCode.
|
|
188
|
+
|
|
189
|
+
**Какие платформы поддерживаются?**
|
|
190
|
+
Windows (Планировщик Windows), macOS (launchd) и Linux (crontab). Различия описаны в [CROSS_PLATFORM.md](../CROSS_PLATFORM.md).
|
|
191
|
+
|
|
192
|
+
**Куда отправляются данные?**
|
|
193
|
+
Никуда. История, логи, метрики и настройки хранятся локально в SQLite; телеметрии и аккаунтов нет.
|
|
194
|
+
|
|
195
|
+
**Чем это отличается от `experimental.schedules` в OpenCode?**
|
|
196
|
+
Встроенный планировщик выполняет задачи, пока OpenCode запущен. Этот плагин использует нативный планировщик ОС и добавляет DAG-пайплайны, матричные сборки, Quality Gates, webhooks и наблюдаемость.
|
|
197
|
+
|
|
198
|
+
**Можно ли запускать задачи в других репозиториях?**
|
|
199
|
+
Да. Workspaces задают путь к проекту, а матричная сборка запускает один шаблон по нескольким workspace сразу.
|
|
200
|
+
|
|
201
|
+
## Дальнейшее развитие
|
|
202
|
+
|
|
203
|
+
- [ROADMAP.md](../ROADMAP.md) — история спринтов и ближайшие планы.
|
|
204
|
+
- [ROADMAP-STRATEGY.md](../ROADMAP-STRATEGY.md) — позиционирование и горизонт 0–6 месяцев.
|
|
205
|
+
|
|
206
|
+
## Лицензия
|
|
207
|
+
|
|
208
|
+
[MIT](../LICENSE).
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "opencode-windows-scheduler",
|
|
3
|
-
"version": "1.2.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "1.2.3",
|
|
4
|
+
"description": "OpenCode v2 plugin for scheduling and orchestrating AI agent jobs: cron, one-shot runs, DAG pipelines, matrix builds, quality gates, SQLite history, metrics and a local web dashboard. Windows, macOS and Linux. Free and open source (MIT).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "opencode-windows-scheduler contributors",
|
|
7
7
|
"homepage": "https://github.com/DeadSno/opencode-windows-scheduler#readme",
|
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
"keywords": [
|
|
16
16
|
"opencode",
|
|
17
17
|
"opencode-plugin",
|
|
18
|
+
"opencode-v2",
|
|
18
19
|
"scheduler",
|
|
19
20
|
"cron",
|
|
20
21
|
"task-scheduler",
|
|
@@ -22,9 +23,16 @@
|
|
|
22
23
|
"launchd",
|
|
23
24
|
"systemd",
|
|
24
25
|
"ai-agents",
|
|
25
|
-
"automation",
|
|
26
|
+
"ai-automation",
|
|
27
|
+
"agent-orchestration",
|
|
28
|
+
"workflow-orchestration",
|
|
29
|
+
"workflow-automation",
|
|
30
|
+
"job-scheduler",
|
|
31
|
+
"dag",
|
|
26
32
|
"matrix-builds",
|
|
27
|
-
"
|
|
33
|
+
"quality-gates",
|
|
34
|
+
"observability",
|
|
35
|
+
"local-first"
|
|
28
36
|
],
|
|
29
37
|
"main": "dist/index.js",
|
|
30
38
|
"types": "dist/index.d.ts",
|
|
@@ -43,7 +51,6 @@
|
|
|
43
51
|
"scripts",
|
|
44
52
|
"docs",
|
|
45
53
|
"README.md",
|
|
46
|
-
"README.ru.md",
|
|
47
54
|
"LICENSE",
|
|
48
55
|
"CHANGELOG.md",
|
|
49
56
|
"CROSS_PLATFORM.md",
|