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/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,38 @@ All notable changes to this project are documented here. Format follows [Keep a
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [1.3.0] - 2026-11-14
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **Telegram-канал:** Bot API `sendMessage` с `chat_id`, `parse_mode` (HTML / MarkdownV2 / Markdown / plain), тихим режимом, темой форума и ссылкой на дашборд; настройка через GUI и `manage_settings`.
|
|
12
|
+
- **Нативные уведомления ОС:** Windows Toast, macOS Notification Center, Linux `notify-send`; без внешних зависимостей, `node-notifier` не требуется.
|
|
13
|
+
- **Тихие часы:** success и partial подавляются в заданном окне (в том числе через полночь), ошибки и таймауты отправляются всегда.
|
|
14
|
+
- **Стоимость и токены в сообщениях:** `tokens`/`costUsd` передаются из истории, в шаблонах доступны плейсхолдеры `{cost}` и `{tokens}`.
|
|
15
|
+
- `test-notifications-v3.mjs` (40 проверок): экранирование Telegram, подмена fetch, сборка нативных команд, тихие часы, миграция настроек.
|
|
16
|
+
|
|
17
|
+
### Changed
|
|
18
|
+
|
|
19
|
+
- `deliver()` отправляет сообщение во все включённые каналы (webhook + Telegram + native) и не прерывает остальные при ошибке одного из них.
|
|
20
|
+
- Тестовая кнопка и дайджест работают через любой включённый канал, а не только webhook.
|
|
21
|
+
- `send_notification` принимает `channel` (`all` / `webhook` / `telegram` / `native`).
|
|
22
|
+
|
|
23
|
+
### Security
|
|
24
|
+
|
|
25
|
+
- Токен Telegram маскируется в ошибках и логах; секреты не попадают в `tasks.json` и историю запусков. Токен и `chat_id` можно задать через `OPENCODE_SCHEDULER_TELEGRAM_BOT_TOKEN` и `OPENCODE_SCHEDULER_TELEGRAM_CHAT_ID` вместо `settings.json`.
|
|
26
|
+
|
|
27
|
+
## [1.2.3] - 2026-11-13
|
|
28
|
+
|
|
29
|
+
### Changed
|
|
30
|
+
|
|
31
|
+
- README переписан под OpenCode v2: установка через `plugins` и `opencode plugin add` (ключ `plugin` в конфиге устарел), добавлены FAQ, бейдж загрузок и ссылка на CROSS_PLATFORM.md, исправлено число тестовых сюит (26).
|
|
32
|
+
- Русский README перенесён в `docs/README.ru.md` и синхронизирован с английским: одноразовые запуски, непрерывность сессий, webhooks, Prometheus/OTLP, матричные сборки, FAQ.
|
|
33
|
+
- `package.json`: описание и ключевые слова расширены для поиска (OpenCode v2, планировщик, оркестрация, DAG, матрицы, Quality Gates, наблюдаемость).
|
|
34
|
+
|
|
35
|
+
### Fixed
|
|
36
|
+
|
|
37
|
+
- Страница пакета на npm показывала устаревший русский README: npm выбирал `README.ru.md` вместо `README.md`. Теперь в корне только английский README, npm отдаёт актуальный текст.
|
|
38
|
+
|
|
7
39
|
## [1.2.2] - 2026-11-13
|
|
8
40
|
|
|
9
41
|
### Fixed
|
|
@@ -14,6 +46,12 @@ All notable changes to this project are documented here. Format follows [Keep a
|
|
|
14
46
|
|
|
15
47
|
## [1.2.1] - 2026-11-13
|
|
16
48
|
|
|
49
|
+
### Added
|
|
50
|
+
|
|
51
|
+
- **One-shot scheduling:** `triggerType: "once"` with `runAt` (ISO-8601 or local date) or `delaySeconds`; native registration (`schtasks /sc ONCE`, Linux `at`, macOS launchd + cleanup wrapper), no repeat after plugin restart, export/import and dry-run support, GUI and dashboard display.
|
|
52
|
+
- **Session continuity:** `session: "new" | "reuse" | "last"` and `sessionMaxRuns` for `reuse`; `sessionId` is generated by the plugin, never accepted from input and never exported; old packages import as `new`.
|
|
53
|
+
- `test-one-shot.mjs` (41 проверка) и `test-session-continuity.mjs` (50 проверок) — в цепочке `npm test`.
|
|
54
|
+
|
|
17
55
|
### Fixed
|
|
18
56
|
|
|
19
57
|
- TUI-панель теперь обновляется каждые 5 секунд через reactive store контекста и показывает паузу, а не статический снимок первого рендера.
|
|
@@ -41,6 +79,14 @@ All notable changes to this project are documented here. Format follows [Keep a
|
|
|
41
79
|
- `test-notifications-v2.mjs` (44 проверки) — добавлен в `npm test`.
|
|
42
80
|
- **Полный паритет агента (10 новых инструментов):** `get_metrics`, `get_analytics`, `manage_settings`, `manage_templates`, `manage_profiles`, `transfer_tasks`, `send_notification`, `get_dashboard_info`, `cleanup_history`, `emit_event`; `matrix_control` получил действие `preview`. Все операции, ранее доступные только в GUI/RPC, теперь доступны агенту (итого 22 инструмента).
|
|
43
81
|
|
|
82
|
+
### Integrations and observability (Спринт 22)
|
|
83
|
+
|
|
84
|
+
- Входящий webhook-триггер `POST /api/hooks/:task` с HMAC-SHA256 по сырому телу: заголовки `X-Scheduler-Signature`, `X-Hub-Signature-256` (GitHub) и `X-Gitlab-Token`, опциональная проверка timestamp; канал выключен по умолчанию.
|
|
85
|
+
- Structured logs: JSONL `<PLUGIN_DIR>/logs/runs.jsonl` с событиями `run.started` / `run.finished` / `hook.received`, ротация 10 МБ и `GET /api/logs` с фильтрами по задаче, статусу, событию и периоду.
|
|
86
|
+
- Prometheus `GET /metrics`: запуски, ошибки, токены, стоимость, histogram длительности, глубина очереди и объём истории.
|
|
87
|
+
- OpenTelemetry: `GET /api/history/export?format=otlp` — OTLP/JSON со стабильными traceId/spanId на каждый запуск.
|
|
88
|
+
- `test-integrations.mjs` (116 проверок) — в цепочке `npm test`.
|
|
89
|
+
|
|
44
90
|
### Profiles (Спринт 21)
|
|
45
91
|
|
|
46
92
|
- Профили (`default`, `work`, …): каждый профиль — отдельная директория со своей БД (`scheduler.db`), настройками (`settings.json`), логами, обёртками и портом дашборда. `default` использует базовую директорию плагина (как раньше — без миграции), остальные живут в `<base>/profiles/<name>`.
|
|
@@ -71,7 +117,7 @@ All notable changes to this project are documented here. Format follows [Keep a
|
|
|
71
117
|
|
|
72
118
|
### Planned
|
|
73
119
|
|
|
74
|
-
-
|
|
120
|
+
- Guards, worktree isolation and declarative job files — перенесены в [ROADMAP.md](./ROADMAP.md).
|
|
75
121
|
|
|
76
122
|
## [1.1.0] - 2026-11-13
|
|
77
123
|
|
|
@@ -112,7 +158,10 @@ First public release.
|
|
|
112
158
|
- Deleting a matrix parent deletes its family, but deleting a workspace does not touch existing matrix jobs.
|
|
113
159
|
- Agent tools cover a subset of the RPC surface (see roadmap item 0.4).
|
|
114
160
|
|
|
115
|
-
[Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.
|
|
161
|
+
[Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.3.0...HEAD
|
|
162
|
+
[1.3.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.3...v1.3.0
|
|
163
|
+
[1.2.3]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.2...v1.2.3
|
|
164
|
+
[1.2.2]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.1...v1.2.2
|
|
116
165
|
[1.2.1]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.0...v1.2.1
|
|
117
166
|
[1.2.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.1.0...v1.2.0
|
|
118
167
|
[1.1.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.0.0...v1.1.0
|
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
|
|
|
@@ -38,7 +39,7 @@ Want to see it without installing OpenCode? `node scripts/demo-dashboard.mjs` st
|
|
|
38
39
|
| Triggers | cron, one-shot (`triggerType: "once"`), file change (chokidar), MCP events, incoming webhooks (`POST /api/hooks/:task` with HMAC) |
|
|
39
40
|
| Multi-repo | workspaces with path validation, per-workspace runs, matrix over one parent task |
|
|
40
41
|
| Observability | SQLite history (success / error / timeout / partial / running), metrics (duration, tokens, cost), JSONL run logs with `/api/logs`, Prometheus `/metrics`, OTLP export, per-task logs, local web dashboard with 14-day analytics, history retention and CSV/JSON export |
|
|
41
|
-
| Operations | dry-run preview, export/import JSON, templates,
|
|
42
|
+
| Operations | dry-run preview, export/import JSON, templates, multi-channel notifications (webhook, Telegram, native OS toasts), quiet hours, digest, settings |
|
|
42
43
|
| Interfaces | OpenCode GUI panel, web dashboard, 22 agent tools, built-in agent skill |
|
|
43
44
|
|
|
44
45
|
## Install
|
|
@@ -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
|
|
@@ -95,7 +103,7 @@ The agent gets the full feature set — 22 tools covering scheduling, pipelines,
|
|
|
95
103
|
| `manage_templates` | `action`, template fields | List, save or delete reusable task templates |
|
|
96
104
|
| `manage_profiles` | `action`, `name?`, `port?` | List, create, switch or delete isolated profiles |
|
|
97
105
|
| `transfer_tasks` | `action`, `data?` | Export all tasks to JSON or import them back |
|
|
98
|
-
| `send_notification` | `action` (`test`/`digest`) | Test the notification
|
|
106
|
+
| `send_notification` | `action` (`test`/`digest`), `channel?` (`all`/`webhook`/`telegram`/`native`) | Test the notification channels or send the digest |
|
|
99
107
|
| `get_dashboard_info` | — | Dashboard port/URL, platform, title, active profile |
|
|
100
108
|
| `cleanup_history` | `retentionDays?`, `maxRecords?` | Delete old history by age and/or record cap |
|
|
101
109
|
| `emit_event` | `eventName`, `payload?` | Start tasks subscribed to an MCP event |
|
|
@@ -151,6 +159,8 @@ src/
|
|
|
151
159
|
dry-run.ts pipeline simulation
|
|
152
160
|
lock.ts no-overlap protection
|
|
153
161
|
file-watcher.ts chokidar triggers
|
|
162
|
+
telegram.ts Telegram Bot API delivery
|
|
163
|
+
native-notify.ts Windows Toast / macOS / Linux notifications
|
|
154
164
|
db/ SQLite: tasks, history, metrics, settings
|
|
155
165
|
task-transfer.ts export / import / validation
|
|
156
166
|
```
|
|
@@ -163,7 +173,7 @@ Job wrappers run `opencode run` in the task working directory, so project MCP se
|
|
|
163
173
|
npm install
|
|
164
174
|
npm run build # tsc
|
|
165
175
|
npm run build:gui # vite
|
|
166
|
-
npm test #
|
|
176
|
+
npm test # 27 test suites, 500+ checks
|
|
167
177
|
```
|
|
168
178
|
|
|
169
179
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
|
@@ -173,6 +183,33 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
|
|
173
183
|
- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — process model, modules, backends, data model.
|
|
174
184
|
- [docs/FEATURES.md](docs/FEATURES.md) — full feature catalog with examples.
|
|
175
185
|
- [docs/MIGRATION.md](docs/MIGRATION.md) — moving from cron, systemd, launchd or Task Scheduler.
|
|
186
|
+
- [CROSS_PLATFORM.md](CROSS_PLATFORM.md) — Windows / macOS / Linux differences and backends.
|
|
187
|
+
|
|
188
|
+
## FAQ
|
|
189
|
+
|
|
190
|
+
**Does it work when OpenCode is closed?**
|
|
191
|
+
Yes. Jobs are registered with the native OS scheduler, so they run without an open OpenCode window.
|
|
192
|
+
|
|
193
|
+
**Which platforms are supported?**
|
|
194
|
+
Windows (Task Scheduler), macOS (launchd) and Linux (crontab). Backend differences are documented in [CROSS_PLATFORM.md](CROSS_PLATFORM.md).
|
|
195
|
+
|
|
196
|
+
**Where does my data go?**
|
|
197
|
+
Nowhere. History, logs, metrics and settings are stored locally in SQLite. No telemetry, no accounts, no cloud.
|
|
198
|
+
|
|
199
|
+
**How do I get Telegram notifications?**
|
|
200
|
+
Create a bot with [@BotFather](https://t.me/BotFather), copy the token, send the bot a message and read `chat_id` from `getUpdates` (or use a group/channel ID). Paste both in the sidebar panel or run `manage_settings` with `notifications.telegram` (`enabled`, `botToken`, `chatId`, optional `parseMode`). To keep secrets out of `settings.json`, set `OPENCODE_SCHEDULER_TELEGRAM_BOT_TOKEN` and `OPENCODE_SCHEDULER_TELEGRAM_CHAT_ID` instead — environment values are used when the fields are empty. Use `send_notification` with `channel: "telegram"` to verify.
|
|
201
|
+
|
|
202
|
+
**Do I need an extra package for desktop notifications?**
|
|
203
|
+
No. Windows Toast (PowerShell/WinRT), macOS Notification Center (`osascript`) and Linux `notify-send` are called directly, so `node-notifier` is not required. Enable them with `notifications.native.enabled`.
|
|
204
|
+
|
|
205
|
+
**Can I silence notifications at night?**
|
|
206
|
+
Yes. Set `notifications.quietHours` (`enabled`, `from`, `to` in `HH:MM`). During the window successful and `partial` runs are suppressed, while failures and timeouts are always delivered.
|
|
207
|
+
|
|
208
|
+
**How is this different from `experimental.schedules`?**
|
|
209
|
+
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.
|
|
210
|
+
|
|
211
|
+
**Can jobs run in other repositories?**
|
|
212
|
+
Yes. Workspaces point at project paths, and a matrix build runs one template across several workspaces at once.
|
|
176
213
|
|
|
177
214
|
## Roadmap
|
|
178
215
|
|
package/ROADMAP-STRATEGY.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# 🎯 Стратегический роадмап — opencode-windows-scheduler
|
|
2
2
|
|
|
3
|
-
> Цель: **стать лучшим
|
|
4
|
-
>
|
|
3
|
+
> Цель: **стать лучшим планировщиком и оркестратором для OpenCode, оставаясь бесплатным и open source.**
|
|
4
|
+
> Тактический спринт-план — в [ROADMAP.md](./ROADMAP.md), выпущенные изменения — в [CHANGELOG.md](./CHANGELOG.md).
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -12,206 +12,108 @@
|
|
|
12
12
|
|
|
13
13
|
| Принцип | Что это значит на практике |
|
|
14
14
|
|---|---|
|
|
15
|
-
| **Бесплатно навсегда** | MIT, без SaaS, без телеметрии, без «pro»-функций
|
|
16
|
-
| **Локально по умолчанию** | Данные, история и логи — на машине
|
|
17
|
-
| **Open source-first** | Публичный roadmap,
|
|
18
|
-
| **Оркестрация, а не таймер** | Ров — DAG, матрицы,
|
|
15
|
+
| **Бесплатно навсегда** | MIT, без SaaS, без телеметрии, без «pro»-функций |
|
|
16
|
+
| **Локально по умолчанию** | Данные, история и логи — на машине пользователя |
|
|
17
|
+
| **Open source-first** | Публичный roadmap, CI на 3 ОС, английская документация |
|
|
18
|
+
| **Оркестрация, а не таймер** | Ров — DAG, матрицы, Quality Gates, наблюдаемость. Cron скопируют за неделю |
|
|
19
19
|
|
|
20
|
-
**Текущая
|
|
21
|
-
- нет LICENSE / npm / CI / английского README → нас не находят;
|
|
22
|
-
- агент видит 4 инструмента из ~30 RPC-методов (~35–40% функционала);
|
|
23
|
-
- нет table stakes: one-shot, session continuity, guard, worktree, декларативные job-файлы, TUI.
|
|
20
|
+
**Текущая точка (1.3.0):**
|
|
24
21
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
> Максимальный ROI. Без этого всё остальное не имеет значения: продукт не установят и не прочитают.
|
|
30
|
-
|
|
31
|
-
### 0.1 OSS-упаковка (2–3 дня)
|
|
32
|
-
|
|
33
|
-
- [x] `LICENSE` — MIT (текст + поле `license` в `package.json`).
|
|
34
|
-
- [x] Метаданные пакета: `repository`, `homepage`, `bugs`, `keywords`, `author`, `engines`.
|
|
35
|
-
- [ ] Публикация `latest` (`npm publish --access public`) — имя `opencode-windows-scheduler` свободно, нужен `npm login` и `NPM_TOKEN` в GitHub Secrets.
|
|
36
|
-
- [x] `README.md` на английском (текущий → `README.ru.md`, ссылки друг на друга).
|
|
37
|
-
- [x] Скриншот дашборда в README + демо-скрипт `node scripts/demo-dashboard.mjs`.
|
|
38
|
-
- [x] `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md`, `CHANGELOG.md`, `.editorconfig`, `.gitignore`.
|
|
39
|
-
|
|
40
|
-
**Готово, когда:** `npm install opencode-windows-scheduler` работает на чистой машине; README читается англоязычным пользователем; лицензия видна в GitHub.
|
|
41
|
-
|
|
42
|
-
### 0.2 CI и качество (2 дня)
|
|
43
|
-
|
|
44
|
-
- [x] GitHub Actions: матрица `windows-latest` / `ubuntu-latest` / `macos-latest`, Node 24.
|
|
45
|
-
- [x] Шаги: `npm ci` → `npm run build` → `npm run build:gui` → `npm test`.
|
|
46
|
-
- [x] Бейджи статуса в README; защита `main` настраивается в GitHub после первого пуша.
|
|
47
|
-
- [x] Релизный workflow `release.yml` (publish + GitHub Release) и `files` с `gui-experimental.cjs` в пакете.
|
|
48
|
-
|
|
49
|
-
**Готово, когда:** зелёный CI на трёх ОС, бейдж в README, релизы собираются автоматически.
|
|
50
|
-
|
|
51
|
-
### 0.3 Паритет агента — часть 1: расширить `schedule_task` (3–4 дня)
|
|
52
|
-
|
|
53
|
-
Добавить в zod-схему инструмента отсутствующие параметры (уже есть в RPC/БД):
|
|
22
|
+
- опубликован в npm, CI зелёный на Windows / macOS / Linux;
|
|
23
|
+
- 22 инструмента агента — паритет с RPC-поверхностью;
|
|
24
|
+
- one-shot запуски, непрерывность сессий, профили, webhooks, Telegram и нативные toast, тихие часы, Prometheus и OTLP — есть;
|
|
25
|
+
- английский README и `docs/` — основные, русский синхронизирован в `docs/README.ru.md`.
|
|
54
26
|
|
|
55
|
-
-
|
|
56
|
-
- [x] `nextTaskOnSuccess`, `nextTaskOnError`.
|
|
57
|
-
- [x] `matrix.concurrency`, `matrix.overrides`.
|
|
58
|
-
- [x] Английские `description` инструментов в схемах и при регистрации.
|
|
27
|
+
**Чего ещё нет:** управления секретами и аудита, git-триггеров, pipeline-as-code, Docker-runner, approvals и remote runners.
|
|
59
28
|
|
|
60
|
-
|
|
29
|
+
---
|
|
61
30
|
|
|
62
|
-
|
|
31
|
+
## Горизонт 0–1 месяц: ежедневные сценарии и доверие
|
|
63
32
|
|
|
64
|
-
|
|
65
|
-
- [x] `pause_task` / `resume_task` (для матрицы — вся семья клонов).
|
|
66
|
-
- [x] `get_history` / `get_task_logs` — агент видит результат своих запусков.
|
|
67
|
-
- [x] `dry_run` — превью пайплайна/матрицы до создания.
|
|
68
|
-
- [x] `manage_workspaces` — list/add/update/delete.
|
|
69
|
-
- [x] `matrix_control` — results/cancel/cleanup в одном инструменте.
|
|
33
|
+
### 1. Уведомления, которые доходят (P1)
|
|
70
34
|
|
|
71
|
-
|
|
35
|
+
Telegram Bot API и нативные уведомления ОС, фильтры по статусам и задачам, тихие часы. Webhook уже есть, но им пользуется меньшинство.
|
|
72
36
|
|
|
73
|
-
|
|
37
|
+
**Почему:** соседний `@mohak34/opencode-notifier` набирает ~12k загрузок в месяц только на desktop-уведомлениях — спрос доказан.
|
|
74
38
|
|
|
75
|
-
|
|
76
|
-
- [x] Регистрация скилла в структуре плагина, авто-подсказка агенту.
|
|
77
|
-
- [x] `references/recipes.md` — семь готовых конфигураций (nightly deps, дайджест, file-триггер, матрица с overrides, деплой-пайплайн, очистка веток, разбор partial-матрицы).
|
|
78
|
-
- [x] `test-skill.mjs` — 25 проверок целостности скилла и его поставки в npm-пакет.
|
|
39
|
+
### 2. Секреты и аудит (P1)
|
|
79
40
|
|
|
80
|
-
|
|
41
|
+
Credential Manager / Keychain / Secret Service, маскирование в логах и экспорте, audit log всех мутаций задач.
|
|
81
42
|
|
|
82
|
-
|
|
43
|
+
**Почему:** без этого «CI/CD для агентов» не продаётся даже бесплатно — в задачах живут токены и доступы.
|
|
83
44
|
|
|
84
|
-
|
|
85
|
-
- [x] `docs/FEATURES.md` — полный список возможностей с примерами.
|
|
86
|
-
- [x] `docs/MIGRATION.md` — переход с cron и других внешних планировщиков.
|
|
87
|
-
- [x] `test-docs.mjs` — 30 проверок наличия/полноты документации (в `npm test`).
|
|
45
|
+
### 3. Git-триггеры и условия (P2)
|
|
88
46
|
|
|
89
|
-
|
|
47
|
+
Новые коммиты в ветке, фильтр по путям, glob-маски, временные окна. Сейчас `watchPath` — один файл или папка.
|
|
90
48
|
|
|
91
49
|
---
|
|
92
50
|
|
|
93
|
-
## Горизонт
|
|
51
|
+
## Горизонт 2–4 месяца: CI/CD-оркестрация
|
|
94
52
|
|
|
95
|
-
|
|
53
|
+
### 4. Pipeline-as-code (P2)
|
|
96
54
|
|
|
97
|
-
|
|
98
|
-
- `runAt` (ISO-дата) / `delaySeconds` в `schedule_task`, RPC, GUI, dashboard.
|
|
99
|
-
- OS-бэкенды: ONCE (Windows/macOS), `at`/systemd-timer с `OnCalendar` (Linux).
|
|
100
|
-
- Статус в истории: `scheduled → running → success/error`.
|
|
55
|
+
`opencode.pipeline.yaml` в репозитории + CLI `opencode pipeline validate|run|export`. DAG, матрицы и Quality Gates описываются файлом, который можно ревьюить в PR.
|
|
101
56
|
|
|
102
|
-
|
|
103
|
-
- Режимы `session: "new" | "reuse" | "last"`; хранение `sessionId` у задачи.
|
|
104
|
-
- Наследование `agent`/`model` из сессии (как у pan17), опционально.
|
|
105
|
-
- Очистка/компакция сессии по политике.
|
|
57
|
+
**Почему:** это водораздел между «планировщиком» и «оркестратором». Ни один плагин экосистемы пока не умеет pipeline-as-code.
|
|
106
58
|
|
|
107
|
-
###
|
|
108
|
-
- `guard?: string` — shell-команда; ненулевой код = пропуск запуска.
|
|
109
|
-
- Статус `skipped` с причиной в истории; не влияет на DAG-зависимых.
|
|
110
|
-
- Примеры: «только если есть изменения», «только если CI зелёный».
|
|
59
|
+
### 5. Runner abstraction и Docker (P2)
|
|
111
60
|
|
|
112
|
-
|
|
113
|
-
- `worktree: true` — одноразовый `git worktree` на запуск, базовый ref настраивается.
|
|
114
|
-
- Политика очистки (успех/ошибка/через N дней), защита от незакоммиченных изменений.
|
|
115
|
-
- Отображение в истории: путь worktree, ветка/ref.
|
|
61
|
+
Локальный процесс, Docker, SSH-хост. Задача описывает *что* делать, runner — *где*. Изоляцию не изобретаем: Docker / Landstrip.
|
|
116
62
|
|
|
117
|
-
###
|
|
118
|
-
- Source of truth: `.opencode/scheduler/*.json` (или `.yaml` без новых зависимостей — JSON).
|
|
119
|
-
- Синхронизация при активации плагина + file-watcher; конфликты — в лог/историю.
|
|
120
|
-
- `export`/`init` в репозиторий; git-committable, ревью через PR.
|
|
63
|
+
### 6. Approvals, окружения, артефакты (P3)
|
|
121
64
|
|
|
122
|
-
|
|
123
|
-
- Список задач со статусами, группировка матриц, run/pause/resume, просмотр лога и навигация по списку.
|
|
124
|
-
- `src/tui.tsx` читает реальные задачи и историю, группирует клоны матриц под родителем, поддерживает run/pause/resume (клик по задаче или `Ctrl+Shift+J`, плюс палитра команд), показывает последние 40 строк лога и навигацию по списку (`Ctrl+Shift+↑/↓`, `Ctrl+Shift+Enter`).
|
|
65
|
+
Ручное подтверждение перед деплоем, dev / staging / prod, отчёты и coverage как артефакты запуска.
|
|
125
66
|
|
|
126
|
-
###
|
|
127
|
-
- Модель `action / resource / effect` либо строгая реализация текущих `allowedTools`/`deniedTools`.
|
|
128
|
-
- Реальное применение на уровне исполнения, аудит-лог решений.
|
|
67
|
+
### 7. Remote runners (P3)
|
|
129
68
|
|
|
130
|
-
|
|
69
|
+
Агент на удалённой машине, центральный дашборд, очередь и конкурентность на кластере. Делать после подтверждения спроса.
|
|
131
70
|
|
|
132
71
|
---
|
|
133
72
|
|
|
134
|
-
##
|
|
135
|
-
|
|
136
|
-
### 2.1 Позиционирование «CI/CD для AI-агентов»
|
|
137
|
-
- Лендинг в README: 10 рецептов (утренний дайджест, matrix по репо, деплой-пайплайн, авто-фикс CI, ночная аналитика).
|
|
138
|
-
- Статья/доклад: «почему cron недостаточно для агентов» (DAG, политики, наблюдаемость).
|
|
139
|
-
- Benchmarks: накладные расходы, надёжность на 3 ОС.
|
|
140
|
-
|
|
141
|
-
### 2.2 Адаптер к нативной службе расписаний OpenCode (2.2.3+)
|
|
142
|
-
- Не воевать с хостом: использовать нативный scheduler как транспорт, себе оставить оркестрацию.
|
|
143
|
-
- Feature-flag `nativeScheduler: auto|on|off`; миграция существующих задач.
|
|
144
|
-
- Убрать из README рекомендацию «отключите `experimental.schedules`» — заменить на «работаем вместе».
|
|
145
|
-
|
|
146
|
-
### 2.3 Политики, approvals и бюджеты
|
|
147
|
-
- Approval-gates для опасных действий (деплой, удаление, внешние вызовы).
|
|
148
|
-
- Бюджеты: токены/стоимость на задачу и матрицу, авто-пауза при превышении.
|
|
149
|
-
- Квоты на параллелизм (глобально и на проект), приоритеты очереди.
|
|
150
|
-
|
|
151
|
-
### 2.4 Мультипроектность и секреты
|
|
152
|
-
- Профили (`default`, `work`, …) с отдельными БД/настройками/портами.
|
|
153
|
-
- Env-переменные на workspace, маскировка секретов в логах и истории.
|
|
154
|
-
- Экспорт/импорт с шифрованием секретов (опционально, без внешних зависимостей — WebCrypto).
|
|
73
|
+
## Ров, который не скопируют за неделю
|
|
155
74
|
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
-
|
|
159
|
-
|
|
75
|
+
1. **Windows-супервизия.** Конкурент `opencode-scheduler` прямо предупреждает, что на Windows не гарантирует no-overlap и таймауты; у нас обёртки, lock-файлы, crash recovery и единая модель на трёх ОС.
|
|
76
|
+
2. **OpenCode v2.** Часть плагинов всё ещё на устаревшем конфиге `plugin` и не подтверждает совместимость с v2.
|
|
77
|
+
3. **Оркестрация.** DAG, матрицы, Quality Gates, `partial`-статусы, dry-run и история — этого нет ни у одного планировщика экосистемы.
|
|
78
|
+
4. **Локальность.** Никаких облаков и аккаунтов — конкуренты с SaaS-моделью сюда не пойдут.
|
|
160
79
|
|
|
161
|
-
|
|
162
|
-
- `good-first-issue`, discussions, «awesome-recipes», шаблоны задач.
|
|
163
|
-
- Semver, changelog, процесс релизов, ответ на issues ≤ 72 ч.
|
|
164
|
-
- Русская и английская документация синхронно.
|
|
80
|
+
**Чего не делаем:** свой sandbox, свою CI-платформу, хостинг агентов, платные тарифы.
|
|
165
81
|
|
|
166
82
|
---
|
|
167
83
|
|
|
168
84
|
## Метрики успеха
|
|
169
85
|
|
|
170
|
-
| Метрика | Сейчас
|
|
171
|
-
|
|
172
|
-
|
|
|
173
|
-
|
|
|
174
|
-
|
|
|
175
|
-
|
|
|
176
|
-
|
|
|
177
|
-
|
|
|
178
|
-
|
|
|
179
|
-
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
## Как это соотносится со спринтами 18–22
|
|
184
|
-
|
|
185
|
-
| Существующий спринт | Судьба в стратегии |
|
|
186
|
-
|---|---|
|
|
187
|
-
| 17 — Синхронизация матриц | ✅ Сделан |
|
|
188
|
-
| **Новый 17.5 — Упаковка OSS** | Вставить сразу: LICENSE, npm, CI, EN README |
|
|
189
|
-
| **Новый 17.6 — Паритет агента** | Вставить сразу после упаковки (0.3–0.5) |
|
|
190
|
-
| 18 — Ретеншн и аналитика | Оставить, но после 17.5–17.6 |
|
|
191
|
-
| 19 — Планирование 2.0 | Совместить с 1.1 (one-shot) и 1.3 (guard) |
|
|
192
|
-
| 20 — Уведомления v2 | Оставить в горизонте 1–2 мес (после table stakes) |
|
|
193
|
-
| 21 — Мультипроектность | Переносится в горизонт 3–6 мес (2.4) |
|
|
194
|
-
| 22 — Интеграции | Переносится в горизонт 3–6 мес (2.5) |
|
|
86
|
+
| Метрика | Сейчас (1.3.0) | Через 2 мес | Через 6 мес |
|
|
87
|
+
|---|---|---|---|
|
|
88
|
+
| npm latest | 1.3.0 | регулярные патчи | 2.x |
|
|
89
|
+
| CI на 3 ОС | ✅ | ✅ | ✅ |
|
|
90
|
+
| Покрытие RPC инструментами агента | 100% | 100% | 100% |
|
|
91
|
+
| Telegram / toast | ✅ | ✅ | ✅ |
|
|
92
|
+
| Secrets / audit | ❌ | ✅ | ✅ |
|
|
93
|
+
| Git-триггеры | ❌ | ✅ | ✅ |
|
|
94
|
+
| Pipeline-as-code | ❌ | прототип | ✅ |
|
|
95
|
+
| Docker runner | ❌ | ❌ | ✅ |
|
|
96
|
+
| Загрузки npm / мес | первые | 300+ | 1500+ |
|
|
97
|
+
| GitHub stars | единицы | 100+ | 500+ |
|
|
195
98
|
|
|
196
99
|
---
|
|
197
100
|
|
|
198
101
|
## Риски и триггеры пересмотра
|
|
199
102
|
|
|
200
|
-
| Риск | Триггер
|
|
103
|
+
| Риск | Триггер | Ответ |
|
|
201
104
|
|---|---|---|
|
|
202
|
-
|
|
|
203
|
-
|
|
|
204
|
-
|
|
|
205
|
-
|
|
|
105
|
+
| Нативный scheduler OpenCode поглощает cron | Стабильный API расписаний | Режим `nativeScheduler`, акцент на DAG / матрицы / политики |
|
|
106
|
+
| Похожий плагин с GUI и CI/CD | Релиз конкурента | Ускорить pipeline-as-code и Docker runner |
|
|
107
|
+
| Bus factor = 1 | >5 issues без ответа | Сузить scope, заморозить P3, искать мейнтейнеров |
|
|
108
|
+
| API OpenCode v2 меняется | Breaking change в `@opencode/plugin` | Держать адаптер, следить за релизами, CI ловит первым |
|
|
109
|
+
| Расползание scope | Спринт длиннее 2 недель | Резать на вертикальные срезы, P3 — в бэклог |
|
|
206
110
|
|
|
207
111
|
---
|
|
208
112
|
|
|
209
|
-
##
|
|
113
|
+
## Ближайшие две недели
|
|
210
114
|
|
|
211
|
-
1.
|
|
212
|
-
2.
|
|
213
|
-
3.
|
|
214
|
-
4. [x] Расширение `schedule_task` (QG, DAG, retry, matrix extras) (0.3).
|
|
215
|
-
5. [x] Все новые инструменты: `update_task`, `get_history`, `pause/resume`, logs, dry-run, workspaces, matrix control (0.4).
|
|
115
|
+
1. Спринт 26: секреты и audit log.
|
|
116
|
+
2. Затем git-триггеры и pipeline-as-code.
|
|
117
|
+
3. Docker runner — после подтверждения спроса.
|
|
216
118
|
|
|
217
|
-
**Критерий
|
|
119
|
+
**Критерий месяца:** пользователь ставит плагин одной командой, получает уведомление в Telegram о падении задачи, а токены и доступы не лежат открытым текстом в `tasks.json`.
|