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 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
- > Local-first orchestration for AI agent jobs in OpenCode v2 — cron, DAG pipelines, matrix fan-out, quality gates and observability. Free and open source (MIT).
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
  [![CI](https://github.com/DeadSno/opencode-windows-scheduler/actions/workflows/ci.yml/badge.svg)](https://github.com/DeadSno/opencode-windows-scheduler/actions/workflows/ci.yml)
6
6
  [![npm](https://img.shields.io/npm/v/opencode-windows-scheduler.svg)](https://www.npmjs.com/package/opencode-windows-scheduler)
7
+ [![npm downloads](https://img.shields.io/npm/dm/opencode-windows-scheduler.svg)](https://www.npmjs.com/package/opencode-windows-scheduler)
7
8
  [![license](https://img.shields.io/npm/l/opencode-windows-scheduler.svg)](LICENSE)
8
9
  [![node](https://img.shields.io/node/v/opencode-windows-scheduler.svg)](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
- npm install -g opencode-windows-scheduler
50
+ opencode plugin add opencode-windows-scheduler
50
51
  ```
51
52
 
52
- Add the plugin to `opencode.jsonc`:
53
+ Or add the plugin to `opencode.jsonc` manually:
53
54
 
54
55
  ```jsonc
55
56
  {
56
- "plugin": ["opencode-windows-scheduler"],
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 # 17 test suites, 500+ checks
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
 
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
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
- const ZOMBIE_IMAGE_NAMES = new Set(["node.exe", "bun.exe"]);
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 этого плагина) и один раз повторить bind.
166
+ // (только node/bun этого плагина) и повторить bind.
163
167
  if (port !== 0 && (await tryFreeZombiePort(port))) {
164
- try {
165
- const server = await listenOn(port, deps);
166
- running = { server, port };
167
- console.log(`[windows-scheduler] Веб-дашборд запущен: http://localhost:${port}`);
168
- return { port };
169
- }
170
- catch {
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
- await execFileAsync("taskkill", ["/PID", String(pid), "/T", "/F"], { windowsHide: true });
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
- /** Возвращает PID'ы процессов, слушающих указанный TCP-порт (netstat). */
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
- /** Имя процесса и командная строка через CIM (Windows PowerShell). */
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
+ [![CI](https://github.com/DeadSno/opencode-windows-scheduler/actions/workflows/ci.yml/badge.svg)](https://github.com/DeadSno/opencode-windows-scheduler/actions/workflows/ci.yml)
6
+ [![npm](https://img.shields.io/npm/v/opencode-windows-scheduler.svg)](https://www.npmjs.com/package/opencode-windows-scheduler)
7
+ [![license](https://img.shields.io/npm/l/opencode-windows-scheduler.svg)](../LICENSE)
8
+ [![node](https://img.shields.io/node/v/opencode-windows-scheduler.svg)](../package.json)
9
+
10
+ English version: [README.md](../README.md).
11
+
12
+ ---
13
+
14
+ ![Локальный веб-дашборд: матричные сборки, граф DAG, метрики и история запусков](dashboard.png)
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.1",
4
- "description": "Local-first scheduling and orchestration for OpenCode v2 agent jobs: cron, DAG pipelines, matrix fan-out, quality gates and observability. Free and open source (MIT).",
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
- "dag"
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",