opencode-windows-scheduler 1.2.2 → 1.3.0
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 +51 -2
- package/README.md +45 -8
- package/ROADMAP-STRATEGY.md +61 -159
- package/ROADMAP.md +63 -96
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +110 -0
- package/dist/core/record-history.js +4 -4
- package/dist/core/telegram.d.ts +45 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +160 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -3
- package/dist/notifications.d.ts +26 -6
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +191 -34
- package/dist/settings.d.ts +47 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +97 -2
- package/docs/ARCHITECTURE.md +4 -2
- package/docs/FEATURES.md +28 -11
- package/docs/README.ru.md +217 -0
- package/gui-experimental.cjs +4 -4
- package/package.json +14 -6
- package/src/core/native-notify.ts +154 -0
- package/src/core/record-history.ts +6 -4
- package/src/core/telegram.ts +219 -0
- package/src/gui.tsx +220 -6
- package/src/index.ts +7 -3
- package/src/notifications.ts +232 -40
- package/src/settings.ts +162 -4
- package/README.ru.md +0 -141
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).
|