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/dist/settings.js CHANGED
@@ -83,10 +83,30 @@ export function defaultNotifications() {
83
83
  retryDelayMs: DEFAULT_WEBHOOK_RETRY_DELAY_MS,
84
84
  },
85
85
  templates: {
86
- success: '✅ Задача "{task}" выполнена ({duration})',
87
- error: '❌ Задача "{task}" упала ({duration}){error}',
86
+ success: '✅ Задача "{task}" выполнена ({duration}){cost}',
87
+ error: '❌ Задача "{task}" упала ({duration}){error}{cost}',
88
88
  },
89
89
  filters: { include: [], exclude: [] },
90
+ telegram: {
91
+ enabled: false,
92
+ botToken: "",
93
+ chatId: "",
94
+ parseMode: "HTML",
95
+ disableNotification: false,
96
+ messageThreadId: null,
97
+ includeDashboardLink: true,
98
+ apiBase: "https://api.telegram.org",
99
+ },
100
+ native: {
101
+ enabled: false,
102
+ sound: true,
103
+ },
104
+ quietHours: {
105
+ enabled: false,
106
+ from: "22:00",
107
+ to: "08:00",
108
+ },
109
+ dashboardUrl: "",
90
110
  matrix: {
91
111
  enabled: true,
92
112
  onPartial: true,
@@ -147,6 +167,29 @@ function asRecord(value) {
147
167
  ? value
148
168
  : undefined;
149
169
  }
170
+ /** Приводит parse_mode Telegram к допустимому значению. */
171
+ function normalizeTelegramParseMode(value, fallback) {
172
+ return value === "" || value === "HTML" || value === "Markdown" || value === "MarkdownV2"
173
+ ? value
174
+ : fallback;
175
+ }
176
+ /** Проверяет http(s)-базу API; иначе возвращает fallback. */
177
+ function normalizeHttpBase(value, fallback) {
178
+ if (typeof value !== "string")
179
+ return fallback;
180
+ const trimmed = value.trim().replace(/\/+$/, "");
181
+ if (!trimmed)
182
+ return fallback;
183
+ try {
184
+ const parsed = new URL(trimmed);
185
+ if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
186
+ return fallback;
187
+ return trimmed;
188
+ }
189
+ catch {
190
+ return fallback;
191
+ }
192
+ }
150
193
  /** Приводит настройки уведомлений к безопасному виду. */
151
194
  function normalizeNotifications(value, fallback) {
152
195
  const fallbackWebhook = fallback.webhook ?? defaultNotifications().webhook;
@@ -154,6 +197,9 @@ function normalizeNotifications(value, fallback) {
154
197
  const fallbackFilters = fallback.filters ?? { include: [], exclude: [] };
155
198
  const fallbackMatrix = fallback.matrix ?? defaultNotifications().matrix;
156
199
  const fallbackDigest = fallback.digest ?? defaultNotifications().digest;
200
+ const fallbackTelegram = fallback.telegram ?? defaultNotifications().telegram;
201
+ const fallbackNative = fallback.native ?? defaultNotifications().native;
202
+ const fallbackQuiet = fallback.quietHours ?? defaultNotifications().quietHours;
157
203
  const raw = asRecord(value);
158
204
  if (!raw) {
159
205
  return {
@@ -166,6 +212,10 @@ function normalizeNotifications(value, fallback) {
166
212
  },
167
213
  matrix: { ...fallbackMatrix },
168
214
  digest: { ...fallbackDigest },
215
+ telegram: { ...fallbackTelegram },
216
+ native: { ...fallbackNative },
217
+ quietHours: { ...fallbackQuiet },
218
+ dashboardUrl: fallback.dashboardUrl ?? "",
169
219
  };
170
220
  }
171
221
  const rawWebhook = asRecord(raw.webhook);
@@ -173,6 +223,9 @@ function normalizeNotifications(value, fallback) {
173
223
  const rawFilters = asRecord(raw.filters);
174
224
  const rawMatrix = asRecord(raw.matrix);
175
225
  const rawDigest = asRecord(raw.digest);
226
+ const rawTelegram = asRecord(raw.telegram);
227
+ const rawNative = asRecord(raw.native);
228
+ const rawQuiet = asRecord(raw.quietHours);
176
229
  const frequency = rawDigest?.frequency === "weekly" || rawDigest?.frequency === "daily"
177
230
  ? rawDigest.frequency
178
231
  : fallbackDigest.frequency;
@@ -205,6 +258,48 @@ function normalizeNotifications(value, fallback) {
205
258
  include: normalizeNameList(rawFilters?.include, fallbackFilters.include),
206
259
  exclude: normalizeNameList(rawFilters?.exclude, fallbackFilters.exclude),
207
260
  },
261
+ telegram: {
262
+ enabled: typeof rawTelegram?.enabled === "boolean"
263
+ ? rawTelegram.enabled
264
+ : fallbackTelegram.enabled,
265
+ botToken: typeof rawTelegram?.botToken === "string"
266
+ ? rawTelegram.botToken.trim().slice(0, 512)
267
+ : fallbackTelegram.botToken,
268
+ chatId: typeof rawTelegram?.chatId === "string"
269
+ ? rawTelegram.chatId.trim().slice(0, 128)
270
+ : fallbackTelegram.chatId,
271
+ parseMode: normalizeTelegramParseMode(rawTelegram?.parseMode, fallbackTelegram.parseMode),
272
+ disableNotification: typeof rawTelegram?.disableNotification === "boolean"
273
+ ? rawTelegram.disableNotification
274
+ : fallbackTelegram.disableNotification,
275
+ messageThreadId: rawTelegram?.messageThreadId === null
276
+ ? null
277
+ : Number.isFinite(Number(rawTelegram?.messageThreadId))
278
+ ? Math.max(0, Math.floor(Number(rawTelegram?.messageThreadId)))
279
+ : fallbackTelegram.messageThreadId,
280
+ includeDashboardLink: typeof rawTelegram?.includeDashboardLink === "boolean"
281
+ ? rawTelegram.includeDashboardLink
282
+ : fallbackTelegram.includeDashboardLink,
283
+ apiBase: normalizeHttpBase(rawTelegram?.apiBase, fallbackTelegram.apiBase),
284
+ },
285
+ native: {
286
+ enabled: typeof rawNative?.enabled === "boolean"
287
+ ? rawNative.enabled
288
+ : fallbackNative.enabled,
289
+ sound: typeof rawNative?.sound === "boolean"
290
+ ? rawNative.sound
291
+ : fallbackNative.sound,
292
+ },
293
+ quietHours: {
294
+ enabled: typeof rawQuiet?.enabled === "boolean"
295
+ ? rawQuiet.enabled
296
+ : fallbackQuiet.enabled,
297
+ from: normalizeDailyTime(rawQuiet?.from, fallbackQuiet.from),
298
+ to: normalizeDailyTime(rawQuiet?.to, fallbackQuiet.to),
299
+ },
300
+ dashboardUrl: typeof raw.dashboardUrl === "string"
301
+ ? raw.dashboardUrl.trim().slice(0, 500)
302
+ : (fallback.dashboardUrl ?? ""),
208
303
  matrix: {
209
304
  enabled: typeof rawMatrix?.enabled === "boolean"
210
305
  ? rawMatrix.enabled
@@ -130,7 +130,9 @@ from their clones instead of their own last run.
130
130
  | `src/workspaces.ts` | Workspace registry and path validation; env pairs and `.env` file resolution with secret masking |
131
131
  | `src/templates.ts` | Reusable task templates |
132
132
  | `src/settings.ts` | Plugin settings: notifications and history retention |
133
- | `src/notifications.ts` | Webhook delivery with retries/backoff, templates, task filters, matrix and stuck-clone notifications, daily/weekly digest |
133
+ | `src/notifications.ts` | Multi-channel delivery (webhook, Telegram, native OS) with retries/backoff, templates, task filters, quiet hours, matrix and stuck-clone notifications, daily/weekly digest |
134
+ | `src/core/telegram.ts` | Telegram Bot API `sendMessage`: parse-mode escaping, dashboard link, token validation and masking |
135
+ | `src/core/native-notify.ts` | Native OS notifications: Windows Toast (PowerShell/WinRT), macOS `osascript`, Linux `notify-send`; no external dependency |
134
136
  | `src/history.ts` | History model and status types |
135
137
  | `src/version.ts` | Runtime plugin version (reads package.json) |
136
138
  | `src/core/retention.ts` | Daily history prune and incremental vacuum |
@@ -304,7 +306,7 @@ never requires a manual migration.
304
306
 
305
307
  | Interface | Audience | Entry point |
306
308
  | --- | --- | --- |
307
- | Agent tools | AI agent | 12 tools registered via `ctx.tool.transform` |
309
+ | Agent tools | AI agent | 22 tools registered via `ctx.tool.transform` |
308
310
  | Agent skill | AI agent | `skills/scheduled-job-best-practices` |
309
311
  | RPC | Sidebar GUI | `src/rpc.ts` contracts, ~30 methods |
310
312
  | Sidebar GUI | Human | `gui-experimental.cjs` |
package/docs/FEATURES.md CHANGED
@@ -397,27 +397,44 @@ matrix combinations are rejected explicitly.
397
397
 
398
398
  ### Notifications
399
399
 
400
- Webhook notifications on run completion, configurable in settings and testable with
400
+ Notifications on run completion through three independent channels — webhook, Telegram
401
+ and native OS notifications — configurable in settings and testable with
401
402
  `test_notification`.
402
403
 
403
- - **Delivery:** per-task completion (success/error/timeout) through a Discord/Slack
404
- compatible webhook (`{ content, text }`). `webhook.timeoutMs` (default 10 000),
405
- `webhook.retryCount` (default 2) and `webhook.retryDelayMs` (default 1000) control
406
- the request; network errors, timeouts, HTTP 5xx and 429 are retried with exponential
407
- backoff (capped at 30 s), other 4xx are not.
404
+ - **Webhook delivery:** per-task completion (success/error/timeout) through a
405
+ Discord/Slack compatible webhook (`{ content, text }`). `webhook.timeoutMs`
406
+ (default 10 000), `webhook.retryCount` (default 2) and `webhook.retryDelayMs`
407
+ (default 1000) control the request; network errors, timeouts, HTTP 5xx and 429 are
408
+ retried with exponential backoff (capped at 30 s), other 4xx are not.
409
+ - **Telegram:** Bot API `sendMessage` with `chat_id`, `parse_mode` (`HTML`,
410
+ `MarkdownV2`, `Markdown` or plain text), optional silent mode, forum topic
411
+ (`messageThreadId`) and a dashboard link (`includeDashboardLink`). Configured in the
412
+ GUI or with `manage_settings` → `notifications.telegram`. `botToken` and `chatId`
413
+ may instead come from `OPENCODE_SCHEDULER_TELEGRAM_BOT_TOKEN` and
414
+ `OPENCODE_SCHEDULER_TELEGRAM_CHAT_ID` so no secret is stored in `settings.json`;
415
+ the token is masked in every error message and log line.
416
+ - **Native OS notifications:** Windows Toast (PowerShell/WinRT), macOS Notification
417
+ Center (`osascript`) and Linux `notify-send`. No extra dependency: `node-notifier`
418
+ is not required. `notifications.native.sound` toggles the sound where supported.
408
419
  - **Templates:** `templates.success` and `templates.error` accept placeholders
409
- `{task}`, `{status}`, `{duration}`, `{error}`, `{emoji}`.
420
+ `{task}`, `{status}`, `{duration}`, `{error}`, `{emoji}`, `{cost}` and `{tokens}`.
421
+ When token/cost data is present the message gains a ` · 1500 tok · $0.0060` suffix.
410
422
  - **Filters:** `filters.include` / `filters.exclude` are task-name patterns with `*`
411
423
  wildcards; an empty include list means all tasks, exclude wins.
424
+ - **Quiet hours:** `quietHours.enabled` with `from`/`to` in `HH:MM` (an overnight
425
+ range such as 22:00 → 08:00 is supported). During the window `success` and
426
+ `partial` are suppressed while `error` and `timeout` are still delivered.
412
427
  - **Matrix notifications:** on family completion — success, `partial` (`onPartial`)
413
428
  and all clones failed (`onAllFailed`). A stuck detector reports clones running
414
429
  longer than `matrix.stuckAfterMinutes` (default 60, `0` disables) once per run.
415
430
  - **Digest:** `digest.enabled` sends a daily (`frequency: "daily"`, at `digest.time`)
416
431
  or weekly (Mondays, catch-up afterwards) summary: runs, success rate, cost, tokens
417
- and top errors. Also available as the `send_digest` RPC and the GUI's
418
- «📊 Отправить дайджест сейчас» button (manual sends do not move the schedule).
419
- - **ntfy.sh is intentionally not implemented** (excluded by the assignment); the
420
- network channel is the webhook, plus GUI toasts for manual runs.
432
+ and top errors through every enabled channel. Also available as the
433
+ `send_digest` RPC and the GUI's «📊 Отправить дайджест сейчас» button (manual sends
434
+ do not move the schedule).
435
+ - **Test button:** sends a test message to `all`, `webhook`, `telegram` or `native`
436
+ and reports per-channel success/failure. Failures in one channel never block the
437
+ others and never throw into the task run.
421
438
 
422
439
  ### Crash recovery
423
440
 
@@ -0,0 +1,217 @@
1
+ # opencode-windows-scheduler
2
+
3
+ > Плагин для планирования и оркестрации задач AI-агентов в OpenCode v2: cron, одноразовые запуски, DAG-пайплайны, матричные сборки, Quality Gates и наблюдаемость. Бесплатно, с открытым кодом (MIT).
4
+
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
+ [![npm](https://img.shields.io/npm/v/opencode-windows-scheduler.svg)](https://www.npmjs.com/package/opencode-windows-scheduler)
7
+ [![license](https://img.shields.io/npm/l/opencode-windows-scheduler.svg)](../LICENSE)
8
+ [![node](https://img.shields.io/node/v/opencode-windows-scheduler.svg)](../package.json)
9
+
10
+ English version: [README.md](../README.md).
11
+
12
+ ---
13
+
14
+ ![Локальный веб-дашборд: матричные сборки, граф DAG, метрики и история запусков](dashboard.png)
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, Telegram, нативные toast), тихие часы, дайджест, настройки |
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`), `channel?` (`all`/`webhook`/`telegram`/`native`) | Проверка каналов уведомлений или отправка дайджеста |
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
+ **Как включить уведомления в Telegram?**
196
+ Создайте бота у [@BotFather](https://t.me/BotFather), скопируйте токен, напишите боту сообщение и возьмите `chat_id` из `getUpdates` (или используйте ID группы/канала). Укажите оба значения в панели или через `manage_settings` → `notifications.telegram` (`enabled`, `botToken`, `chatId`, при необходимости `parseMode`). Чтобы не хранить секреты в `settings.json`, задайте `OPENCODE_SCHEDULER_TELEGRAM_BOT_TOKEN` и `OPENCODE_SCHEDULER_TELEGRAM_CHAT_ID` — переменные используются, если поля пусты. Проверка: `send_notification` с `channel: "telegram"`.
197
+
198
+ **Нужен ли отдельный пакет для системных уведомлений?**
199
+ Нет. Windows Toast (PowerShell/WinRT), macOS Notification Center (`osascript`) и Linux `notify-send` вызываются напрямую, `node-notifier` не требуется. Включается через `notifications.native.enabled`.
200
+
201
+ **Можно ли отключить уведомления на ночь?**
202
+ Да. Задайте `notifications.quietHours` (`enabled`, `from`, `to` в `HH:MM`). В этом окне успешные и `partial` запуски не отправляются, а ошибки и таймауты приходят всегда.
203
+
204
+ **Чем это отличается от `experimental.schedules` в OpenCode?**
205
+ Встроенный планировщик выполняет задачи, пока OpenCode запущен. Этот плагин использует нативный планировщик ОС и добавляет DAG-пайплайны, матричные сборки, Quality Gates, webhooks и наблюдаемость.
206
+
207
+ **Можно ли запускать задачи в других репозиториях?**
208
+ Да. Workspaces задают путь к проекту, а матричная сборка запускает один шаблон по нескольким workspace сразу.
209
+
210
+ ## Дальнейшее развитие
211
+
212
+ - [ROADMAP.md](../ROADMAP.md) — история спринтов и ближайшие планы.
213
+ - [ROADMAP-STRATEGY.md](../ROADMAP-STRATEGY.md) — позиционирование и горизонт 0–6 месяцев.
214
+
215
+ ## Лицензия
216
+
217
+ [MIT](../LICENSE).