opencode-windows-scheduler 1.2.2 → 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 +12 -0
- package/README.md +32 -6
- package/docs/README.ru.md +208 -0
- package/package.json +12 -5
- package/README.ru.md +0 -141
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,18 @@ 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
|
+
|
|
7
19
|
## [1.2.2] - 2026-11-13
|
|
8
20
|
|
|
9
21
|
### 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
|
|
|
@@ -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",
|
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).
|