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 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
- - One-shot scheduling, session continuity, guards, worktree isolation, declarative job files.
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.2.1...HEAD
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
- > 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
 
@@ -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, webhook notifications, settings |
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
- 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
@@ -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 channel or send the digest |
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 # 17 test suites, 500+ checks
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
 
@@ -1,7 +1,7 @@
1
1
  # 🎯 Стратегический роадмап — opencode-windows-scheduler
2
2
 
3
- > Цель: **стать лучшим планировщиком/оркестратором для OpenCode, оставаясь бесплатным и open source.**
4
- > Основано на аудите плагина (ноябрь 2026). Тактический спринт-план — в [ROADMAP.md](./ROADMAP.md).
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, good-first-issues, CI на 3 ОС, англоязычная документация |
18
- | **Оркестрация, а не таймер** | Ров — DAG, матрицы, политики, дашборд. Cron — commodity, его скопируют |
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
- ## Горизонт 0 — 2 недели: упаковка и паритет агента
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
- - [x] `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`.
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
- **Готово, когда:** агентом можно создать задачу с QG, DAG, retry и матрицей с лимитом — без GUI.
29
+ ---
61
30
 
62
- ### 0.4 Паритет агента — часть 2: новые инструменты (3–4 дня)
31
+ ## Горизонт 0–1 месяц: ежедневные сценарии и доверие
63
32
 
64
- - [x] `update_task` — частичное обновление с сохранением незаданных полей.
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
- **Готово, когда:** покрытие RPC-поверхности инструментами агента = 100% (кроме чисто-GUI настроек).
35
+ Telegram Bot API и нативные уведомления ОС, фильтры по статусам и задачам, тихие часы. Webhook уже есть, но им пользуется меньшинство.
72
36
 
73
- ### 0.5 Native skill для агента (1–2 дня)
37
+ **Почему:** соседний `@mohak34/opencode-notifier` набирает ~12k загрузок в месяц только на desktop-уведомлениях — спрос доказан.
74
38
 
75
- - [x] Skill `scheduled-job-best-practices`: когда планировать, как формулировать промпт, какие QG/hooks ставить, чего не делать (опасные команды, секреты).
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
- ### 0.6 Документация (2 дня)
43
+ **Почему:** без этого «CI/CD для агентов» не продаётся даже бесплатно — в задачах живут токены и доступы.
83
44
 
84
- - [x] `docs/ARCHITECTURE.md` — как устроены процессы, backends, lock, DAG, matrix.
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
- ## Горизонт 1–2 месяца: закрыть table stakes
51
+ ## Горизонт 2–4 месяца: CI/CD-оркестрация
94
52
 
95
- > Базовые сценарии, которые ожидают от планировщика. Без них мы «мощнее, но неудобнее».
53
+ ### 4. Pipeline-as-code (P2)
96
54
 
97
- ### 1.1 One-shot расписание (3–4 дня)
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
- ### 1.2 Session continuity (4–5 дней)
103
- - Режимы `session: "new" | "reuse" | "last"`; хранение `sessionId` у задачи.
104
- - Наследование `agent`/`model` из сессии (как у pan17), опционально.
105
- - Очистка/компакция сессии по политике.
57
+ **Почему:** это водораздел между «планировщиком» и «оркестратором». Ни один плагин экосистемы пока не умеет pipeline-as-code.
106
58
 
107
- ### 1.3 Guard-условия (2–3 дня)
108
- - `guard?: string` — shell-команда; ненулевой код = пропуск запуска.
109
- - Статус `skipped` с причиной в истории; не влияет на DAG-зависимых.
110
- - Примеры: «только если есть изменения», «только если CI зелёный».
59
+ ### 5. Runner abstraction и Docker (P2)
111
60
 
112
- ### 1.4 Worktree-изоляция (3–4 дня)
113
- - `worktree: true` — одноразовый `git worktree` на запуск, базовый ref настраивается.
114
- - Политика очистки (успех/ошибка/через N дней), защита от незакоммиченных изменений.
115
- - Отображение в истории: путь worktree, ветка/ref.
61
+ Локальный процесс, Docker, SSH-хост. Задача описывает *что* делать, runner — *где*. Изоляцию не изобретаем: Docker / Landstrip.
116
62
 
117
- ### 1.5 Декларативные job-файлы (5–6 дней)
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
- ### 1.6 TUI-центр задач (5–6 дней)
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
- ### 1.7 Per-task permissions (4–5 дней)
127
- - Модель `action / resource / effect` либо строгая реализация текущих `allowedTools`/`deniedTools`.
128
- - Реальное применение на уровне исполнения, аудит-лог решений.
67
+ ### 7. Remote runners (P3)
129
68
 
130
- **Готово, когда:** базовые сценарии (one-shot, reuse session, guard, worktree, md/json в репо, TUI) закрыты; `npm test` и CI зелёные; документация обновлена.
69
+ Агент на удалённой машине, центральный дашборд, очередь и конкурентность на кластере. Делать после подтверждения спроса.
131
70
 
132
71
  ---
133
72
 
134
- ## Горизонт 3–6 месяцев: ров, который не скопируют за неделю
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
- ### 2.5 Интеграции и наблюдаемость
157
- - Входящий webhook-триггер `POST /api/hooks/:task` с HMAC — запуск из GitHub Actions/GitLab CI.
158
- - Prometheus `/metrics`, JSONL-логи, экспорт истории в OpenTelemetry.
159
- - Плагин-хуки: `beforeRun`/`afterRun` для расширений сообщества.
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
- ### 2.6 Сообщество и устойчивость
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
- | Метрика | Сейчас | Через 2 нед | Через 2 мес | Через 6 мес |
171
- |---|---|---|---|---|
172
- | Публикация в npm | ❌ | ✅ | ✅ | ✅ |
173
- | LICENSE / CI на 3 ОС | ❌ | ✅ | ✅ | ✅ |
174
- | README на английском | ❌ | ✅ | ✅ | ✅ |
175
- | Покрытие RPC инструментами агента | ~35–40% | 100% | 100% | 100% |
176
- | One-shot / session / guard / worktree | ❌ | ❌ | ✅ | ✅ |
177
- | Загрузок npm / мес | 0 | 50+ | 300+ | 1500+ |
178
- | GitHub stars | ? | +20 | +100 | +500 |
179
- | Закрытых table-stakes | 0/7 | 1/7 | 7/7 | 7/7 |
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
- | Нативная служба OpenCode поглощает cron | Релиз с stable native schedule API | Ускорить 2.2, сместить акцент на DAG/matrix/политики |
203
- | Появление похожего плагина с GUI | Релиз с дашбордом | Ускорить 0.1–0.3, подчеркнуть матрицы и DAG |
204
- | Нет времени на поддержку (bus factor) | >5 открытых issues без ответа | Упростить scope, заморозить 2.4–2.6, набрать мейнтейнеров |
205
- | Русские тексты мешают adopted | Жалобы в issues | Полная i18n инструментов и ошибок |
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. [x] LICENSE + метаданные (0.1); npm publish — после `npm login`.
212
- 2. [x] GitHub Actions CI на 3 ОС + бейдж (0.2).
213
- 3. [x] Английский README со скриншотом и примерами использования (0.1).
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
- **Критерий недели:** пользователь ставит плагин из npm одной командой, CI зелёный, а агент может создать и сопроводить задачу с Quality Gate и зависимостями без GUI.
119
+ **Критерий месяца:** пользователь ставит плагин одной командой, получает уведомление в Telegram о падении задачи, а токены и доступы не лежат открытым текстом в `tasks.json`.