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/src/server.ts
CHANGED
|
@@ -39,8 +39,13 @@ const FALLBACK_PORT = 4782;
|
|
|
39
39
|
/** Дополнительный порт, если и 3782, и 4782 заняты чужими процессами. */
|
|
40
40
|
const EXTRA_PORTS = [5782];
|
|
41
41
|
|
|
42
|
-
|
|
43
|
-
|
|
42
|
+
const IS_WINDOWS = process.platform === "win32";
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Имена процессов, которые считаем «зомби» от прошлых запусков плагина.
|
|
46
|
+
* На Windows процессы называются node.exe / bun.exe, на POSIX — node / bun.
|
|
47
|
+
*/
|
|
48
|
+
const ZOMBIE_IMAGE_NAMES = new Set(["node", "nodejs", "node.exe", "bun", "bun.exe"]);
|
|
44
49
|
|
|
45
50
|
/** Маркер-заголовок: по нему узнаём «свой» дашборд, уже слушающий порт. */
|
|
46
51
|
const DASHBOARD_HEADER = "x-plugin-dashboard";
|
|
@@ -304,15 +309,20 @@ export async function startDashboardServer(
|
|
|
304
309
|
}
|
|
305
310
|
|
|
306
311
|
// Порт занят чужим или старым процессом: пробуем снять зомби
|
|
307
|
-
// (только node/bun этого плагина) и
|
|
312
|
+
// (только node/bun этого плагина) и повторить bind.
|
|
308
313
|
if (port !== 0 && (await tryFreeZombiePort(port))) {
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
314
|
+
// SIGKILL асинхронный: на POSIX процесс может ещё какое-то время
|
|
315
|
+
// держать сокет, поэтому сначала ждём освобождения порта.
|
|
316
|
+
const freed = await waitForPortFree(port, 3000);
|
|
317
|
+
if (freed) {
|
|
318
|
+
try {
|
|
319
|
+
const server = await listenOn(port, deps);
|
|
320
|
+
running = { server, port };
|
|
321
|
+
console.log(`[windows-scheduler] Веб-дашборд запущен: http://localhost:${port}`);
|
|
322
|
+
return { port };
|
|
323
|
+
} catch {
|
|
324
|
+
// Не вышло — идём к следующему порту.
|
|
325
|
+
}
|
|
316
326
|
}
|
|
317
327
|
}
|
|
318
328
|
// Чужой сервис — пробуем запасной порт.
|
|
@@ -370,7 +380,11 @@ async function tryFreeZombiePort(port: number): Promise<boolean> {
|
|
|
370
380
|
}
|
|
371
381
|
|
|
372
382
|
try {
|
|
373
|
-
|
|
383
|
+
if (IS_WINDOWS) {
|
|
384
|
+
await execFileAsync("taskkill", ["/PID", String(pid), "/T", "/F"], { windowsHide: true });
|
|
385
|
+
} else {
|
|
386
|
+
process.kill(pid, "SIGKILL");
|
|
387
|
+
}
|
|
374
388
|
console.log(
|
|
375
389
|
`[windows-scheduler] Снят зомби-процесс ${info.name} (PID ${pid}), державший порт ${port}.`
|
|
376
390
|
);
|
|
@@ -387,8 +401,25 @@ async function tryFreeZombiePort(port: number): Promise<boolean> {
|
|
|
387
401
|
return killed;
|
|
388
402
|
}
|
|
389
403
|
|
|
390
|
-
/**
|
|
404
|
+
/** Ждёт, пока порт освободится (POSIX: убитый процесс отпускает сокет не синхронно). */
|
|
405
|
+
async function waitForPortFree(port: number, timeoutMs: number): Promise<boolean> {
|
|
406
|
+
const deadline = Date.now() + timeoutMs;
|
|
407
|
+
while (Date.now() < deadline) {
|
|
408
|
+
const pids = await findListeningPids(port);
|
|
409
|
+
if (pids.length === 0) return true;
|
|
410
|
+
await new Promise((resolve) => setTimeout(resolve, 150));
|
|
411
|
+
}
|
|
412
|
+
return false;
|
|
413
|
+
}
|
|
414
|
+
|
|
415
|
+
/** Возвращает PID'ы процессов, слушающих указанный TCP-порт. */
|
|
391
416
|
async function findListeningPids(port: number): Promise<number[]> {
|
|
417
|
+
if (IS_WINDOWS) return findListeningPidsWindows(port);
|
|
418
|
+
return findListeningPidsPosix(port);
|
|
419
|
+
}
|
|
420
|
+
|
|
421
|
+
/** Windows: netstat -ano, состояния LISTENING. */
|
|
422
|
+
async function findListeningPidsWindows(port: number): Promise<number[]> {
|
|
392
423
|
try {
|
|
393
424
|
const { stdout } = await execFileAsync("netstat", ["-ano", "-p", "TCP"], {
|
|
394
425
|
windowsHide: true,
|
|
@@ -410,8 +441,55 @@ async function findListeningPids(port: number): Promise<number[]> {
|
|
|
410
441
|
}
|
|
411
442
|
}
|
|
412
443
|
|
|
413
|
-
/**
|
|
444
|
+
/**
|
|
445
|
+
* macOS/Linux: lsof (есть в macOS и на большинстве Linux-образов),
|
|
446
|
+
* на Linux — запасной вариант через ss из iproute2.
|
|
447
|
+
*/
|
|
448
|
+
async function findListeningPidsPosix(port: number): Promise<number[]> {
|
|
449
|
+
try {
|
|
450
|
+
const { stdout } = await execFileAsync(
|
|
451
|
+
"lsof",
|
|
452
|
+
["-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-t"],
|
|
453
|
+
{ windowsHide: true }
|
|
454
|
+
);
|
|
455
|
+
const pids = stdout
|
|
456
|
+
.split(/\s+/)
|
|
457
|
+
.map(Number)
|
|
458
|
+
.filter((pid) => Number.isInteger(pid) && pid > 0);
|
|
459
|
+
if (pids.length > 0) return Array.from(new Set(pids));
|
|
460
|
+
} catch {
|
|
461
|
+
// lsof может отсутствовать или не быть в PATH — пробуем ss.
|
|
462
|
+
}
|
|
463
|
+
|
|
464
|
+
if (process.platform === "linux") {
|
|
465
|
+
try {
|
|
466
|
+
const { stdout } = await execFileAsync("ss", ["-ltnp", `sport = :${port}`], {
|
|
467
|
+
windowsHide: true,
|
|
468
|
+
});
|
|
469
|
+
const pids = new Set<number>();
|
|
470
|
+
for (const match of stdout.matchAll(/pid=(\d+)/g)) {
|
|
471
|
+
const pid = Number(match[1]);
|
|
472
|
+
if (Number.isInteger(pid) && pid > 0) pids.add(pid);
|
|
473
|
+
}
|
|
474
|
+
return Array.from(pids);
|
|
475
|
+
} catch {
|
|
476
|
+
// ss тоже недоступен — считаем, что владельца порта не знаем.
|
|
477
|
+
}
|
|
478
|
+
}
|
|
479
|
+
|
|
480
|
+
return [];
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
/** Имя процесса и командная строка. */
|
|
414
484
|
async function getProcessInfo(pid: number): Promise<{ name: string; commandLine: string } | null> {
|
|
485
|
+
if (IS_WINDOWS) return getProcessInfoWindows(pid);
|
|
486
|
+
return getProcessInfoPosix(pid);
|
|
487
|
+
}
|
|
488
|
+
|
|
489
|
+
/** Имя процесса и командная строка через CIM (Windows PowerShell). */
|
|
490
|
+
async function getProcessInfoWindows(
|
|
491
|
+
pid: number
|
|
492
|
+
): Promise<{ name: string; commandLine: string } | null> {
|
|
415
493
|
try {
|
|
416
494
|
const script =
|
|
417
495
|
'$p = Get-CimInstance Win32_Process -Filter "ProcessId=' +
|
|
@@ -432,6 +510,36 @@ async function getProcessInfo(pid: number): Promise<{ name: string; commandLine:
|
|
|
432
510
|
}
|
|
433
511
|
}
|
|
434
512
|
|
|
513
|
+
/** Имя процесса и командная строка через ps (macOS/Linux). */
|
|
514
|
+
async function getProcessInfoPosix(
|
|
515
|
+
pid: number
|
|
516
|
+
): Promise<{ name: string; commandLine: string } | null> {
|
|
517
|
+
try {
|
|
518
|
+
// NOTE: на Linux у Node главный поток помечен как "MainThread", поэтому
|
|
519
|
+
// имя берём из argv[0] командной строки (это полный путь к бинарнику),
|
|
520
|
+
// а comm используем только как запасной вариант.
|
|
521
|
+
const { stdout: argsOut } = await execFileAsync("ps", ["-p", String(pid), "-o", "args="], {
|
|
522
|
+
windowsHide: true,
|
|
523
|
+
});
|
|
524
|
+
const args = argsOut.trim();
|
|
525
|
+
const argv0 = args.split(/\s+/)[0]?.replace(/^["']|["']$/g, "") ?? "";
|
|
526
|
+
let name = argv0.split(/[\\/]/).pop() ?? "";
|
|
527
|
+
|
|
528
|
+
if (!name) {
|
|
529
|
+
const { stdout: commOut } = await execFileAsync("ps", ["-p", String(pid), "-o", "comm="], {
|
|
530
|
+
windowsHide: true,
|
|
531
|
+
});
|
|
532
|
+
const comm = commOut.trim();
|
|
533
|
+
if (!comm) return null;
|
|
534
|
+
name = comm.split(/[\\/]/).pop() || comm;
|
|
535
|
+
}
|
|
536
|
+
|
|
537
|
+
return { name, commandLine: args };
|
|
538
|
+
} catch {
|
|
539
|
+
return null;
|
|
540
|
+
}
|
|
541
|
+
}
|
|
542
|
+
|
|
435
543
|
/** Проверяет по маркер-заголовку, что на порту отвечает наш дашборд. */
|
|
436
544
|
async function isOwnDashboardOn(port: number): Promise<boolean> {
|
|
437
545
|
try {
|
package/README.ru.md
DELETED
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
# opencode-windows-scheduler
|
|
2
|
-
|
|
3
|
-
> Локальная оркестрация задач AI-агентов для OpenCode v2: cron, DAG-пайплайны, матричные сборки, Quality Gate и наблюдаемость. Бесплатно и с открытым кодом (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
|
-
|
|
9
|
-
English version: [README.md](README.md).
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-

|
|
14
|
-
|
|
15
|
-
Хотите посмотреть без установки OpenCode? `node scripts/demo-dashboard.mjs` поднимет дашборд с демо-данными на http://localhost:4380.
|
|
16
|
-
|
|
17
|
-
## Зачем
|
|
18
|
-
|
|
19
|
-
Плагин для OpenCode v2: планировщик задач на нативном планировщике ОС (Планировщик Windows, launchd, crontab) с cron-расписанием, защитой от наложения запусков (lock-файл), таймаутами, повторами, Quality Gate, DAG-цепочками, матричными сборками и файловыми триггерами. Всё работает локально: без SaaS, телеметрии и аккаунтов.
|
|
20
|
-
|
|
21
|
-
## Возможности
|
|
22
|
-
|
|
23
|
-
| Область | Что есть |
|
|
24
|
-
|---|---|
|
|
25
|
-
| Расписание | cron, нативный планировщик ОС (Windows / macOS / Linux), пауза/возобновление |
|
|
26
|
-
| Надёжность | lock-файл от наложения, таймауты с жёстким kill, повторы с задержкой, crash recovery |
|
|
27
|
-
| Качество | Quality Gate, before/after hooks, allow/deny списки инструментов |
|
|
28
|
-
| Оркестрация | DAG `dependsOn`, цепочки success/error, матрицы (parallel/sequential, continue/stop, concurrency, overrides, агрегатор) |
|
|
29
|
-
| Триггеры | cron, изменение файла (chokidar), MCP-события |
|
|
30
|
-
| Мультирепо | workspaces с валидацией путей, запуск по workspace, матрица поверх родительской задачи |
|
|
31
|
-
| Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики (длительность, токены, стоимость), логи, веб-дашборд: аналитика за 14 дней, ретеншн истории (лимиты по возрасту и размеру), экспорт CSV/JSON |
|
|
32
|
-
| Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, webhook-уведомления, настройки |
|
|
33
|
-
| Интерфейсы | панель OpenCode GUI, веб-дашборд, 12 инструментов для агента, встроенный скилл |
|
|
34
|
-
|
|
35
|
-
## Установка
|
|
36
|
-
|
|
37
|
-
Нужны OpenCode v2 и Node.js 20+.
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
npm install -g opencode-windows-scheduler
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
Добавьте плагин в `opencode.jsonc`:
|
|
44
|
-
|
|
45
|
-
```jsonc
|
|
46
|
-
{
|
|
47
|
-
"plugin": ["opencode-windows-scheduler"],
|
|
48
|
-
"experimental": {
|
|
49
|
-
"schedules": false
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
`experimental.schedules: false` отключает встроенный планировщик OpenCode, чтобы агент не путал встроенные инструменты расписаний с инструментами этого плагина. После изменения конфигурации перезапустите OpenCode.
|
|
55
|
-
|
|
56
|
-
Из исходников:
|
|
57
|
-
|
|
58
|
-
```bash
|
|
59
|
-
git clone https://github.com/DeadSno/opencode-windows-scheduler.git
|
|
60
|
-
cd opencode-windows-scheduler
|
|
61
|
-
npm install
|
|
62
|
-
npm run build && npm run build:gui
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
## Инструменты для агента
|
|
66
|
-
|
|
67
|
-
Агенту доступен весь функционал — 22 инструмента: расписание, пайплайны, эксплуатация, аналитика и администрирование.
|
|
68
|
-
|
|
69
|
-
| Инструмент | Аргументы | Что делает |
|
|
70
|
-
|---|---|---|
|
|
71
|
-
| `schedule_task` | `name`, `schedule`, `prompt`, опционально `timeoutSeconds`, `model`, `priority`, `beforeScript`, `afterScript`, `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`, `nextTaskOnSuccess`, `nextTaskOnError`, `triggerType`, `mcpEvent`, `workingDirectory`, `workspaceId`, `allowedTools`, `deniedTools`, `matrix` | Регистрирует задачу в планировщике ОС (cron, файл или MCP-событие) |
|
|
72
|
-
| `list_tasks` | — | Задачи: расписание, статус, следующее время запуска, цепочки, workspace, сводка матрицы |
|
|
73
|
-
| `update_task` | `name` + изменяемые поля | Частичное обновление: незаданные поля сохраняются, пустые — очищаются, `matrix: null` убирает матрицу |
|
|
74
|
-
| `delete_task` | `name` | Удаляет задачу (родитель матрицы — вместе с клонами и агрегатором) |
|
|
75
|
-
| `run_task_now` | `name` | Немедленный запуск (для матрицы — запуск fan-out) |
|
|
76
|
-
| `pause_task` | `name` | Пауза (для матрицы — все клоны) |
|
|
77
|
-
| `resume_task` | `name` | Возобновление |
|
|
78
|
-
| `get_history` | `taskName?`, `status?`, `limit?` | История запусков: длительность, токены, стоимость, модель, Quality Gate, хуки |
|
|
79
|
-
| `get_task_logs` | `name`, `lines?` | Хвост лога запуска |
|
|
80
|
-
| `dry_run` | `name?` | Симуляция пайплайна (или всех задач): порядок, DAG, fan-out, оценки |
|
|
81
|
-
| `manage_workspaces` | `action`, `id?`, `name?`, `path?`, `color?` | Multi-repo workspace: список, добавление, изменение, удаление |
|
|
82
|
-
| `matrix_control` | `action`, `name?` | Результаты матрицы, отмена клонов, очистка осиротевших задач, предпросмотр |
|
|
83
|
-
| `get_metrics` | — | Всего запусков, успехов и падений |
|
|
84
|
-
| `get_analytics` | `days?`, `topLimit?` | Отчёт за период: запуски, успешность, длительность, токены, стоимость, топ задач |
|
|
85
|
-
| `manage_settings` | `action`, `maxConcurrent?`, `winterMode?`, `notifications?`, `history?` | Чтение и изменение глобальных настроек (параллелизм, уведомления, retention) |
|
|
86
|
-
| `manage_templates` | `action`, поля шаблона | Список, сохранение и удаление шаблонов задач |
|
|
87
|
-
| `manage_profiles` | `action`, `name?`, `port?` | Список, создание, переключение и удаление профилей |
|
|
88
|
-
| `transfer_tasks` | `action`, `data?` | Экспорт всех задач в JSON и импорт обратно |
|
|
89
|
-
| `send_notification` | `action` (`test`/`digest`) | Проверка канала уведомлений или отправка дайджеста |
|
|
90
|
-
| `get_dashboard_info` | — | Порт/URL дашборда, платформа, заголовок, активный профиль |
|
|
91
|
-
| `cleanup_history` | `retentionDays?`, `maxRecords?` | Удаление старой истории по возрасту и/или лимиту записей |
|
|
92
|
-
| `emit_event` | `eventName`, `payload?` | Запуск задач, подписанных на MCP-событие |
|
|
93
|
-
|
|
94
|
-
`schedule_task` принимает и полную конфигурацию матрицы (`workspaceIds`, `strategy`, `failureMode`, `aggregation`, `concurrency`, `overrides`, `createAggregator`).
|
|
95
|
-
|
|
96
|
-
## Скилл для агента
|
|
97
|
-
|
|
98
|
-
Плагин сам регистрирует встроенный скилл `scheduled-job-best-practices`: агент подгружает инструкцию только когда она действительно нужна — проектирование cron, самодостаточные промпты, Quality Gate, лимиты матрицы, правила DAG и разбор падений. Ручная настройка `.opencode/skills` не требуется. Вместе со скиллом поставляется `references/recipes.md` — семь готовых конфигураций.
|
|
99
|
-
|
|
100
|
-
## MCP-серверы проекта
|
|
101
|
-
|
|
102
|
-
Фоновые задачи запускаются через `opencode run` в рабочей директории задачи. По умолчанию это папка проекта, где лежит `opencode.json` / `opencode.jsonc`, поэтому MCP-серверы проекта подхватываются автоматически — отдельный мост не нужен.
|
|
103
|
-
|
|
104
|
-
- Поле **«Рабочая директория»** в GUI позволяет указать другую папку. Пустое значение = папка проекта.
|
|
105
|
-
- Значение сохраняется как `workingDirectory` и экспортируется вместе с задачей.
|
|
106
|
-
- Старое поле `workdir` читается при импорте для обратной совместимости.
|
|
107
|
-
|
|
108
|
-
## GUI и дашборд
|
|
109
|
-
|
|
110
|
-
В боковой панели OpenCode доступны создание, редактирование, запуск, пауза, удаление задач, просмотр логов и истории, экспорт/импорт, лимит одновременных задач и зимняя тема. Локальный веб-дашборд добавляет сводку по workspace, вкладку матриц, вид пайплайна и метрики.
|
|
111
|
-
|
|
112
|
-
```bash
|
|
113
|
-
npm run build:gui # gui-experimental.cjs
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
## Сборка и тесты
|
|
117
|
-
|
|
118
|
-
```bash
|
|
119
|
-
npm run build # tsc: серверная часть плагина
|
|
120
|
-
npm run build:gui # vite: GUI-бандл gui-experimental.cjs
|
|
121
|
-
npm test # 17 сюит, 500+ проверок
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
## Документация
|
|
125
|
-
|
|
126
|
-
- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — модель процессов, модули, бэкенды, модель данных.
|
|
127
|
-
- [docs/FEATURES.md](docs/FEATURES.md) — полный каталог возможностей с примерами.
|
|
128
|
-
- [docs/MIGRATION.md](docs/MIGRATION.md) — переезд с cron, systemd, launchd или Планировщика Windows.
|
|
129
|
-
|
|
130
|
-
## Дальнейшее развитие
|
|
131
|
-
|
|
132
|
-
- [ROADMAP.md](ROADMAP.md) — история спринтов и ближайшие планы.
|
|
133
|
-
- [ROADMAP-STRATEGY.md](ROADMAP-STRATEGY.md) — позиционирование и горизонт 0–6 месяцев.
|
|
134
|
-
|
|
135
|
-
## Кроссплатформенность
|
|
136
|
-
|
|
137
|
-
Архитектура и различия Windows / macOS / Linux описаны в [CROSS_PLATFORM.md](CROSS_PLATFORM.md).
|
|
138
|
-
|
|
139
|
-
## Лицензия
|
|
140
|
-
|
|
141
|
-
[MIT](LICENSE).
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("solid-js/web"),m=require("solid-js"),a=require("@opencode/plugin/gui");function p(r){switch(r){case"running":return"●";case"error":return"✗";case"success":return"✓";default:return"?"}}async function _(r){return[]}var $=e.template("<div style=padding:8px><h4>Планировщик Windows"),g=e.template("<p>Задач пока нет"),v=e.template("<ul>"),f=e.template("<li> ");const h=a.Plugin.define({setup(r){const[u,i]=m.createSignal([]);return _().then(i).catch(()=>i([])),r.add(a.Panel,{id:"scheduler-jobs",region:"side",list:()=>[{id:"jobs",title:"Планировщик",pinned:!0}],render:()=>(()=>{var s=$();return s.firstChild,e.insert(s,(()=>{var c=e.memo(()=>u().length===0);return()=>c()?g():(()=>{var l=v();return e.insert(l,()=>u().map(n=>(()=>{var t=f(),o=t.firstChild;return e.insert(t,()=>p(n.status),o),e.insert(t,()=>n.name,null),e.insert(t,(()=>{var d=e.memo(()=>!!n.nextRun);return()=>d()?` → ${n.nextRun}`:""})(),null),t})())),l})()})(),null),s})()})}});exports.default=h;
|