opencode-windows-scheduler 1.4.0 → 1.5.1
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 +61 -1
- package/LICENSE +21 -21
- package/README.md +26 -4
- package/ROADMAP-STRATEGY.md +43 -24
- package/ROADMAP.md +549 -31
- package/dist/core/dry-run.d.ts +41 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +165 -16
- package/dist/core/file-watcher.d.ts.map +1 -1
- package/dist/core/file-watcher.js +53 -10
- package/dist/core/git-trigger.d.ts +80 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +294 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +48 -22
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +7 -0
- package/dist/core/schedule-gate.js +55 -30
- package/dist/core/schedule-v2.d.ts +29 -1
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +107 -17
- package/dist/core/scheduler/types.d.ts +7 -1
- package/dist/core/scheduler/types.d.ts.map +1 -1
- package/dist/core/scheduler/windows.d.ts +6 -2
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +25 -10
- package/dist/core/telegram.d.ts.map +1 -1
- package/dist/core/telegram.js +13 -10
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +4 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +8 -0
- package/dist/i18n.d.ts +52 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +292 -0
- package/dist/index.d.ts +50 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1020 -197
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +74 -40
- package/dist/rpc.d.ts +238 -2
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +79 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +89 -48
- package/dist/settings.d.ts +3 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +20 -8
- package/dist/task-transfer.d.ts +43 -3
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +94 -6
- package/dist/templates.d.ts +1 -1
- package/dist/templates.d.ts.map +1 -1
- package/dist/types.d.ts +11 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +32 -0
- package/docs/ARCHITECTURE.md +37 -1
- package/docs/FEATURES.md +70 -0
- package/docs/README.ru.md +19 -3
- package/gui-experimental.cjs +9 -4
- package/locales/en.json +695 -0
- package/locales/ru.json +695 -0
- package/package.json +9 -3
- package/scripts/test-locale.mjs +44 -0
- package/src/core/dry-run.ts +244 -19
- package/src/core/file-watcher.ts +65 -10
- package/src/core/git-trigger.ts +373 -0
- package/src/core/glob.ts +226 -0
- package/src/core/matrix.ts +52 -26
- package/src/core/ps-wrapper.ts +7 -0
- package/src/core/schedule-gate.ts +67 -33
- package/src/core/schedule-v2.ts +152 -17
- package/src/core/scheduler/types.ts +7 -1
- package/src/core/scheduler/windows.ts +25 -10
- package/src/core/telegram.ts +16 -10
- package/src/core/wrappers/bash.ts +4 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/schema.ts +8 -0
- package/src/gui.tsx +772 -456
- package/src/i18n.ts +339 -0
- package/src/index.ts +1274 -212
- package/src/notifications.ts +83 -42
- package/src/rpc.ts +79 -2
- package/src/server.ts +89 -48
- package/src/settings.ts +38 -10
- package/src/task-transfer.ts +148 -5
- package/src/templates.ts +1 -1
- package/src/types.ts +37 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,64 @@ All notable changes to this project are documented here. Format follows [Keep a
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [1.5.1] - 2026-11-15
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **i18n-фундамент (Спринт 28):** каталоги строк `locales/ru.json` и `locales/en.json` с плоскими ключами, загрузчик `src/i18n.ts` с fallback `en → ru → ключ` и ICU-подмножеством (`{param}`, `{count, plural, …}`) на встроенном `Intl` — без внешних зависимостей.
|
|
12
|
+
- **Язык интерфейса:** настройка `locale` (`ru` по умолчанию, `en` опционально) в `settings.json`, RPC `save_settings`/`get_settings` и инструменте `manage_settings`. Переключение применяется сразу, без перезапуска плагина.
|
|
13
|
+
- **Перевод сервера дашборда:** 404/405-ответы, отсутствующая матрица/задача, отклонённый webhook и заголовок HTML-страницы берутся из каталогов; `<html lang>` соответствует активной локали.
|
|
14
|
+
- **Тесты:** `test-i18n.mjs` (43 проверки) и проверка паритета ключей локалей в `test-docs.mjs` — рассинхронизация каталогов валит CI.
|
|
15
|
+
- **i18n GUI (Спринт 28.2):** все пользовательские строки GUI (`src/gui.tsx`) перенесены в каталоги `locales/*.json` — 454 ключа ru/en в паритете; в компоненте нет ни одного пользовательского кириллического литерала вне каталога. Переключение `ru`/`en` меняет язык панели без перезапуска (реактивный `localeTick`, `applyLocale` после чтения/сохранения настроек). Строки валидации, тосты, пустые состояния, подписи и подсказки формы — всё whole-phrase шаблоны, без конкатенации.
|
|
16
|
+
- **i18n уведомлений (Спринт 28.3):** шаблоны success/error, матричные сообщения, stuck-clone, дайджест, заголовки Telegram и нативных тостов, ошибки webhook/Telegram вынесены в 42 ключа `notify.*` обоих каталогов. Встроенные шаблоны в `settings.json` следуют за активной локалью, пользовательские не переписываются; тесты уведомлений сравнивают `t()`, а не русские литералы.
|
|
17
|
+
- **i18n dry-run и ошибок инструментов (Спринт 28.4):** 189 ключей `dryRun.*`, `gitTrigger.*`, `matrix.*`, `schedule.*`, `tool.*` покрывают предупреждения dry-run, cron/окно/дни недели, git-триггер, lifecycle и конфликты матриц, результаты и валидации инструментов агента в обеих поверхностях (MCP и plugin/RPC). Технические `console.*`-диагностики остаются русскими, описания инструментов — английскими.
|
|
18
|
+
- **Тесты в двух локалях (Спринт 28.5):** локаль запуска задаётся `OPENCODE_SCHEDULER_LOCALE`; `npm run test:en` (`scripts/test-locale.mjs`) прогоняет все 33 сюиты в английской локали, CI делает это на Ubuntu. Ассерты, завязанные на русский текст, заменены на `t()` и ключи; обе локали зелёные.
|
|
19
|
+
- **Резерв имени npm (Спринт 28.6):** опубликован пакет-заглушка `opencode-pipeline@0.0.1`, README ссылается на основной пакет.
|
|
20
|
+
- **Документация i18n (Спринт 28.7):** в `docs/ARCHITECTURE.md` добавлен раздел Localization — каталоги и формат ключей, порядок fallback, ICU-подмножество и плюрализация через `Intl.PluralRules`, правила для переводов и тестов. README (EN/RU) описывает переключение языка, что остаётся английским и сервисную роль `OPENCODE_SCHEDULER_LOCALE`; в разделе разработки появился `npm run test:en`.
|
|
21
|
+
- **Режим входа задачи (27.5.4):** новое поле `runWhenLoggedOff` (`schedule_task`, `update_task`, импорт/экспорт, RPC `create_task`) — по умолчанию `false`, задача интерактивная и выполняется только при входе пользователя. `true` регистрирует задачу как `schtasks /ru SYSTEM`: запуск без входа, в session 0 без профиля, сетевых дисков и сохранённых учётных данных; обычно требует повышенных прав. На Linux/macOS опция игнорируется (crontab работает без входа, launchd-агент — в сессии). Режим виден в `list_tasks` (`runWhenLoggedOff` + `logonMode`), `dry_run` (`runWhenLoggedOff`/`logonMode`) и RPC `get_tasks`; описан в README (EN/RU), FEATURES и FAQ.
|
|
22
|
+
- **Переключатель режима входа в GUI (27.5.9):** в форме задачи появился чекбокс «Запускать без входа пользователя» (только Windows, по данным `get_platform`) с предупреждением о session 0 и необходимости прав администратора; флаг отправляется в `create_task`/`update_task`, заполняется при редактировании и сбрасывается при создании и отмене. В карточке задачи — бейдж «🌙 без входа» с фактическим `logonMode` из планировщика. Ключи добавлены в оба каталога локалей.
|
|
23
|
+
- **`runWhenLoggedOff` в экспорте/импорте задач (27.5.10):** поле mode входа теперь сохраняется в экспортный JSON (`buildExportJson`) и читается при импорте (`parseImportJson`), RPC `import_tasks` прокидывает его в `schedulerCreateTask` вместе с `paused`. Перенос задачи между профилями больше не сбрасывает режим входа в интерактивный.
|
|
24
|
+
- **Ранняя проверка длины имени задачи (27.5.11):** `validateTaskName` отвергает имя длинее 209 символов (лимит schtasks /tn — 237 с учётом папки планировщика) с понятной ошибкой и фактической длиной. Проверка срабатывает в `schedulerCreateTask` до создания wrapper/prompt-файлов и записи в БД, поэтому длинное имя не оставляет хвостовых файлов.
|
|
25
|
+
|
|
26
|
+
### Fixed
|
|
27
|
+
|
|
28
|
+
- **Откат частично созданной матрицы (27.5.7):** разворачивание матрицы выполняется в общем `try` — ошибка любого клона (лимит длины имени schtasks, отказ ОС, неизвестный workspace) прерывает прогон и удаляет всё, что успело появиться: созданные в этом прогоне клоны (вместе с определениями, очередью и файлами обёртки), агрегатор и — для новой задачи — сам родитель. Раньше сбой второго клона оставлял в планировщике первого клона, а в БД — родителя с половиной семьи. Сообщение называет клон и workspace, например `Не удалось развернуть матрицу "…": клон "…" (workspace "…"): … Созданные клоны удалены.`
|
|
29
|
+
- **`update_task` откатывается при сбое (27.5.6):** обновление по-прежнему пересоздаёт задачу (delete + create), но теперь перед удалением запоминается определение из БД и отслеживается факт удаления. Если удалить старую версию не удалось — возвращается `restored: true` с пояснением, что прежняя задача не тронута. Если старая версия удалена, а создать новую не вышло (некорректный cron, нет прав на `/ru SYSTEM`, ошибка ОС), возможный частичный результат удаляется, задача пересоздаётся из сохранённого определения (`recreateTaskFromDefinition`), триггеры пересобираются, а ответ содержит `success: false` и `restored: true` с исходной причиной. Если не удалось и восстановить — `restored: false` и явное сообщение, что задачу нужно создать заново.
|
|
30
|
+
- **`update_task` больше не снимает паузу (27.5.8):** бессрочная пауза теперь хранится в определении задачи (`paused: true`) и участвует в экспорте/импорте, поэтому пересоздание задачи при обновлении регистрирует её в ОС и сразу снова ставит на паузу (для матрицы — на клонах). Если пауза не восстановилась, задача всё равно создаётся, а причина пишется в лог. `update_task`, `list_tasks` и RPC `get_tasks` отдают `paused` из определения, ОС или `pausedUntil`, а `resume_task` и авто-возобновление сбрасывают флаг.
|
|
31
|
+
- **Безопасные имена задач (hotfix 1.5.1, 27.5.5):** `schtasks` вызывается через `execFile` без `cmd.exe`; имена валидируются до записи в БД (буквы/цифры/пробел/точка/`_`/`-`), а после `/create` плагин проверяет наличие задачи в ОС и при провале удаляет wrapper/prompt/лог и не сохраняет определение.
|
|
32
|
+
- **`nextRun` сразу после мутации (27.5.2):** `schedule_task`, `update_task`, `pause_task` и `resume_task` возвращают `nextRun`, рассчитанный из cron/`runAt`/окна (`computeTaskNextRun`), не дожидаясь обновления `schtasks`. `list_tasks` и RPC `get_tasks` используют тот же расчёт, поэтому GUI/дашборд больше не показывают `nextRun: null` сразу после `resume_task`; при паузе отдаётся `paused: true` и `nextRun: null`, для `pause_task until` — `pausedUntil`.
|
|
33
|
+
- **`list_tasks` без ложного пустого списка (27.5.3):** при пустом ответе ОС сразу после мутации выполняется один retry (300 мс). Если ОС по-прежнему пуста или недоступна, `list_tasks` отдаёт состояние из БД с `osAvailable:false`, `osError` и задачами `orphaned:true`, а не `[]`; то же состояние возвращает RPC `get_tasks`, дашборд продолжает работать на данных БД.
|
|
34
|
+
- **`logonMode` в `list_tasks` (27.5.4):** `schtasks /query` вызывался без `/v`, поэтому ОС не отдавала «Режим входа» и поле всегда было `null`; добавлен `/v` и маппинг русского ключа «Режим входа в систему». Теперь `list_tasks`, GUI и RPC `get_tasks` показывают фактический режим (`Только интерактивный` / фоновая задача SYSTEM).
|
|
35
|
+
- **Очистка файлов при удалении (27.5.1):** `delete_task` удаляет wrapper, prompt, лог, lock и env-файлы; при старте плагин вычищает осиротевшие wrapper-ы (с логом `wrappers.cleaned`); повторный `delete_task` идемпотентен, включая русскую ошибку schtasks «Не удается найти».
|
|
36
|
+
- **GUI в webview OpenCode:** каталоги `locales/*.json` теперь встраиваются в бандл на этапе сборки (`registerCatalog`). Раньше загрузчик не находил файлы пакета внутри webview, и панель показывала сырые ключи `gui.*` вместо текста.
|
|
37
|
+
- **GUI: подписи дней недели** — чипы использовали несуществующие ключи `gui.weekdayShort.*`, из-за чего отображались как есть; теперь `gui.weekday.*` (Пн…Вс / Sun…Sat).
|
|
38
|
+
- **GUI: свёрнутые карточки** больше не сжимаются до 2 px в короткой панели (`flex-shrink: 0` у секций), шапки уведомлений/истории/аудита/workspace всегда видны; шапка формы переносится на узких экранах.
|
|
39
|
+
- **Веб-дашборд:** длительности в истории и What-If показываются человекочитаемо (`3.5 мин` вместо `212000 мс`), стоимость — с двумя знаками после запятой, у матрицы подпись `❌ ошибок: N` вместо безымянного числа, нулевые значения не засоряют график, KPI укладываются в одну строку, таблицы аналитики не слипаются на узких экранах, первая колонка таблицы задач закреплена и полоса прокрутки видна, текст в узлах DAG не вылезает за рамки.
|
|
40
|
+
|
|
41
|
+
## [1.5.0] - 2026-11-14
|
|
42
|
+
|
|
43
|
+
### Added
|
|
44
|
+
|
|
45
|
+
- **Git-триггеры (Спринт 27):** задача с `triggerType: "git"` запускается при новых коммитах в её рабочей директории. Первый опрос запоминает текущий `HEAD` без запуска задачи (baseline); последующие опросы сравнивают `git diff --name-only <last>..HEAD`. Состояние хранится в таблице SQLite `git_state`.
|
|
46
|
+
- **Фильтры git-триггера:** `gitBranch` (ветка или glob, через запятую), `gitPaths` (glob-маски изменённых файлов), `gitIgnore` (исключения), `gitPollSeconds` (период опроса, минимум 5, по умолчанию 60).
|
|
47
|
+
- **Glob-маски для файловых триггеров:** `watchGlobs` и `watchIgnore` для `triggerType: "file"` — зависимость от путей, поддержка `*`, `**`, `?`, `[abc]`, `{a,b}`, отрицания `!`. Реализовано без внешних зависимостей в `src/core/glob.ts`.
|
|
48
|
+
- **Временные окна и дни недели:** `activeDays` (0=Вс…6=Сб) и `windowPolicy` (`skip` | `postpone` | `run`, по умолчанию `postpone`) для всех типов триггеров. Окно проверяется в `schedule-gate` (cron) и в обработчике события (file/git/mcp-event). `postpone` ждёт открытия окна до 12 часов, `skip` пропускает тик, `run` выполняет в любом случае.
|
|
49
|
+
- **schedule-gate:** новые аргументы `--days 1,2,3,4,5` и `--window-policy skip|postpone|run`, перenos через defer-файл с проверкой каждую 60 с.
|
|
50
|
+
- **GUI:** радиокнопка «Новый коммит (Git)», поля ветки/путей/исключений/периода опроса для git-триггера, два текстовых поля с масками для файлового триггера, 7 чекбоксов дней недели и селект политики окна.
|
|
51
|
+
- **Dry-run:** `triggerDetails` в отчёте — тип триггера, объяснение, активное окно (`activeWindow`), git/файловая информация, предупреждения о причине пропуска.
|
|
52
|
+
- **Тесты:** `test-glob.mjs` (42 проверки), `test-git-trigger.mjs` (31 проверка), `test-window-v3.mjs` (33 проверки) добавлены в цепочку `npm test` (29 → 32 сюит).
|
|
53
|
+
|
|
54
|
+
### Changed
|
|
55
|
+
|
|
56
|
+
- `triggerType` enum во всех схемах (`schedule_task`, `update_task`, импорт, RPC, GUI) теперь включает `"git"`.
|
|
57
|
+
- `scheduleTaskExecute` и `updateTaskFromInput` принимают 8 новых полей (`activeDays`, `windowPolicy`, `watchGlobs`, `watchIgnore`, `gitBranch`, `gitPaths`, `gitIgnore`, `gitPollSeconds`) через объект `TriggerExtras`.
|
|
58
|
+
- Обновление задачи объединяет (`clearableString`/`mergeStringList`) новые значения со старыми; пустой массив чистит списки, пустая строка чистит строку.
|
|
59
|
+
|
|
60
|
+
### Fixed
|
|
61
|
+
|
|
62
|
+
- Файловый триггер теперь реагирует на `add` и `unlink` (переименование/удаление файла), а не только на `change`.
|
|
63
|
+
- Watcher пересобирается при изменении пути или масок триггера.
|
|
64
|
+
|
|
7
65
|
## [1.4.0] - 2026-11-14
|
|
8
66
|
|
|
9
67
|
### Added
|
|
@@ -179,7 +237,9 @@ First public release.
|
|
|
179
237
|
- Deleting a matrix parent deletes its family, but deleting a workspace does not touch existing matrix jobs.
|
|
180
238
|
- Agent tools cover a subset of the RPC surface (see roadmap item 0.4).
|
|
181
239
|
|
|
182
|
-
[Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.
|
|
240
|
+
[Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.5.1...HEAD
|
|
241
|
+
[1.5.1]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.5.0...v1.5.1
|
|
242
|
+
[1.5.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.4.0...v1.5.0
|
|
183
243
|
[1.4.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.3.0...v1.4.0
|
|
184
244
|
[1.3.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.3...v1.3.0
|
|
185
245
|
[1.2.3]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.2...v1.2.3
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 opencode-windows-scheduler contributors
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 opencode-windows-scheduler contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -36,12 +36,23 @@ Want to see it without installing OpenCode? `node scripts/demo-dashboard.mjs` st
|
|
|
36
36
|
| Reliability | lock-file no-overlap protection, timeouts with hard kill, retries with delay, crash recovery |
|
|
37
37
|
| Quality | Quality Gate command, before/after hooks, per-task allowed/denied tool lists |
|
|
38
38
|
| Orchestration | `dependsOn` DAG, `nextTaskOnSuccess` / `nextTaskOnError` chains, matrix fan-out (parallel/sequential, `continue`/`stop`, concurrency, per-workspace overrides, aggregator task) |
|
|
39
|
-
| Triggers | cron, one-shot (`triggerType: "once"`), file change (chokidar), MCP events, incoming webhooks (`POST /api/hooks/:task` with HMAC) |
|
|
39
|
+
| Triggers | cron, one-shot (`triggerType: "once"`), git commits (`triggerType: "git"`, branch/path/ignore filters), file change (chokidar, with glob masks `watchGlobs`/`watchIgnore`), MCP events, incoming webhooks (`POST /api/hooks/:task` with HMAC) |
|
|
40
40
|
| Multi-repo | workspaces with path validation, per-workspace runs, matrix over one parent task |
|
|
41
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 |
|
|
42
42
|
| Operations | dry-run preview, export/import JSON, templates, multi-channel notifications (webhook, Telegram, native OS toasts), quiet hours, digest, encrypted secrets (`${secret:NAME}`), audit log, settings |
|
|
43
43
|
| Interfaces | OpenCode GUI panel, web dashboard, 24 agent tools, built-in agent skill |
|
|
44
44
|
|
|
45
|
+
### Language
|
|
46
|
+
|
|
47
|
+
The interface ships in Russian (default) and English. Switch it in the sidebar settings
|
|
48
|
+
(Settings → Language) or with the `manage_settings` tool (`action: "update"`,
|
|
49
|
+
`locale: "en"`). The change applies immediately to the GUI, notifications and digest,
|
|
50
|
+
the dashboard and agent tool results — no restart. Agent tool descriptions and schemas
|
|
51
|
+
stay English by design, and diagnostics printed to the console stay Russian.
|
|
52
|
+
|
|
53
|
+
Catalogs live in `locales/ru.json` and `locales/en.json`; every key must exist in both,
|
|
54
|
+
otherwise CI fails.
|
|
55
|
+
|
|
45
56
|
## Install
|
|
46
57
|
|
|
47
58
|
Requires OpenCode v2 and Node.js 20+.
|
|
@@ -81,11 +92,11 @@ npm run build && npm run build:gui
|
|
|
81
92
|
|
|
82
93
|
## Agent tools
|
|
83
94
|
|
|
84
|
-
The agent gets the full feature set —
|
|
95
|
+
The agent gets the full feature set — 24 tools covering scheduling, pipelines, operations, observability and administration:
|
|
85
96
|
|
|
86
97
|
| Tool | Arguments | What it does |
|
|
87
98
|
|---|---|---|
|
|
88
|
-
| `schedule_task` | `name`, `prompt`, `schedule` for cron or `runAt` / `delaySeconds` for one-shot, optional `session` / `sessionMaxRuns`, `timeoutSeconds`, `model`, `priority`, `beforeScript`, `afterScript`, `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`, `nextTaskOnSuccess`, `nextTaskOnError`, `triggerType
|
|
99
|
+
| `schedule_task` | `name`, `prompt`, `schedule` for cron or `runAt` / `delaySeconds` for one-shot, optional `session` / `sessionMaxRuns`, `timeoutSeconds`, `model`, `priority`, `beforeScript`, `afterScript`, `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`, `nextTaskOnSuccess`, `nextTaskOnError`, `triggerType` (`cron`/`file`/`git`/`mcp-event`/`once`), `mcpEvent`, `watchPath`, `watchGlobs`, `watchIgnore`, `gitBranch`, `gitPaths`, `gitIgnore`, `gitPollSeconds`, `activeDays`, `windowPolicy` (`skip`/`postpone`/`run`), `workingDirectory`, `workspaceId`, `allowedTools`, `deniedTools`, `matrix` | Registers a job with the OS scheduler (cron, one-shot, file, git or MCP-event trigger) |
|
|
89
100
|
| `list_tasks` | — | Returns jobs with schedule, status, next run, chains, workspace and matrix summary |
|
|
90
101
|
| `update_task` | `name` + any field to change | Partial update; omitted fields keep their values, empty values clear them, `matrix: null` removes the matrix |
|
|
91
102
|
| `delete_task` | `name` | Deletes a job (a matrix parent deletes clones and aggregator) |
|
|
@@ -167,15 +178,23 @@ src/
|
|
|
167
178
|
|
|
168
179
|
Job wrappers run `opencode run` in the task working directory, so project MCP servers are picked up automatically.
|
|
169
180
|
|
|
181
|
+
### Logon mode (Windows)
|
|
182
|
+
|
|
183
|
+
Tasks are **interactive only** by default: Task Scheduler starts them only while the user who created them is logged on, with the normal profile, drives and saved credentials. Pass `runWhenLoggedOff: true` to run a job without a logged-on user (`schtasks /ru SYSTEM`). Such a task runs in session 0 — no user profile, mapped drives, network shares or saved credentials — so jobs that need your environment may fail; test them with `dry_run` first. On Linux crontab already runs without a login, and a macOS launchd agent runs only inside a user session.
|
|
184
|
+
|
|
170
185
|
## Development
|
|
171
186
|
|
|
172
187
|
```bash
|
|
173
188
|
npm install
|
|
174
189
|
npm run build # tsc
|
|
175
190
|
npm run build:gui # vite
|
|
176
|
-
npm test #
|
|
191
|
+
npm test # 33 test suites, 500+ checks
|
|
192
|
+
npm run test:en # same suites with the English locale
|
|
177
193
|
```
|
|
178
194
|
|
|
195
|
+
`npm run test:en` sets `OPENCODE_SCHEDULER_LOCALE=en` for every suite; the variable is a
|
|
196
|
+
service hook, not a user setting.
|
|
197
|
+
|
|
179
198
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
|
180
199
|
|
|
181
200
|
## Documentation
|
|
@@ -190,6 +209,9 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
|
|
190
209
|
**Does it work when OpenCode is closed?**
|
|
191
210
|
Yes. Jobs are registered with the native OS scheduler, so they run without an open OpenCode window.
|
|
192
211
|
|
|
212
|
+
**Do jobs run when nobody is logged on?**
|
|
213
|
+
On Windows, only if you opt in with `runWhenLoggedOff: true`: the task is then registered as `schtasks /ru SYSTEM` and runs in session 0 without your profile, mapped drives or saved credentials. The default is interactive only — the job runs while the user is logged on. Linux crontab always runs without a login; a macOS launchd agent runs only inside a user session.
|
|
214
|
+
|
|
193
215
|
**Which platforms are supported?**
|
|
194
216
|
Windows (Task Scheduler), macOS (launchd) and Linux (crontab). Backend differences are documented in [CROSS_PLATFORM.md](CROSS_PLATFORM.md).
|
|
195
217
|
|
package/ROADMAP-STRATEGY.md
CHANGED
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
| **Open source-first** | Публичный roadmap, CI на 3 ОС, английская документация |
|
|
18
18
|
| **Оркестрация, а не таймер** | Ров — DAG, матрицы, Quality Gates, наблюдаемость. Cron скопируют за неделю |
|
|
19
19
|
|
|
20
|
-
**Текущая точка (1.
|
|
20
|
+
**Текущая точка (1.5.1):**
|
|
21
21
|
|
|
22
22
|
- опубликован в npm, CI зелёный на Windows / macOS / Linux;
|
|
23
23
|
- 24 инструмента агента — паритет с RPC-поверхностью;
|
|
@@ -25,47 +25,65 @@
|
|
|
25
25
|
- зашифрованные секреты (${secret:NAME}) и журнал аудита — есть;
|
|
26
26
|
- английский README и `docs/` — основные, русский синхронизирован в `docs/README.ru.md`.
|
|
27
27
|
|
|
28
|
-
**Чего ещё нет:**
|
|
28
|
+
**Чего ещё нет:** enforced permissions (`allowedTools` пока advisory), локальный ИИ, pipeline-as-code, Docker-runner, approvals и remote runners.
|
|
29
29
|
|
|
30
30
|
---
|
|
31
31
|
|
|
32
|
-
## Горизонт 0–1 месяц:
|
|
32
|
+
## Горизонт 0–1 месяц: доверие и тишина
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
Сделано: уведомления (1.3.0), секреты и аудит (1.4.0), git-триггеры и окна (1.5.0).
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
### 1. i18n-фундамент (P1) — 1.5.1
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
Все пользовательские строки в `locales/en.json` + `locales/ru.json`, ICU-подмножество на `Intl.PluralRules`, паритет ключей в CI, RU по умолчанию. Без этого нельзя масштабировать аудиторию.
|
|
39
39
|
|
|
40
|
-
### 2.
|
|
40
|
+
### 2. Security slice A (P1) — 1.5.2
|
|
41
41
|
|
|
42
|
-
|
|
42
|
+
Enforced `allowedTools` / `deniedTools` вместо advisory, scoped-инъекция `${secret:NAME}`, аудит `tool.blocked`. До запуска флагмана приватности: обещание не должно расходиться с реализацией.
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
### 3. Локальный помощник v1 (P1) — 1.5.3
|
|
45
45
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
Новые коммиты в ветке, фильтр по путям, glob-маски, временные окна. Сейчас `watchPath` — один файл или папка.
|
|
46
|
+
Триаж уведомлений локальной моделью с fail-open на правила, shadow mode 14 дней, `manage_local_ai`, bench. Меньше шума без потери важного — и работает без модели.
|
|
49
47
|
|
|
50
48
|
---
|
|
51
49
|
|
|
52
50
|
## Горизонт 2–4 месяца: CI/CD-оркестрация
|
|
53
51
|
|
|
54
|
-
### 4.
|
|
52
|
+
### 4. Локальный помощник v2 (P2) — 1.5.4
|
|
53
|
+
|
|
54
|
+
Саммари логов в 3 строки, дедуп на эмбеддингах, GUI-wizard, счётчик экономии с пометкой «оценка».
|
|
55
|
+
|
|
56
|
+
### 5. Pipeline-as-code (P2) — 1.5.5
|
|
55
57
|
|
|
56
58
|
`opencode.pipeline.yaml` в репозитории + CLI `opencode pipeline validate|run|export`. DAG, матрицы и Quality Gates описываются файлом, который можно ревьюить в PR.
|
|
57
59
|
|
|
58
60
|
**Почему:** это водораздел между «планировщиком» и «оркестратором». Ни один плагин экосистемы пока не умеет pipeline-as-code.
|
|
59
61
|
|
|
60
|
-
###
|
|
62
|
+
### 6. Worktree-изоляция и guard-условия (P2) — 1.5.6
|
|
63
|
+
|
|
64
|
+
Одноразовый `git worktree` на запуск, политика очистки, shell- и семантические guard-условия, статус `skipped`. 80% ценности безопасного fan-out без инфраструктуры Docker.
|
|
65
|
+
|
|
66
|
+
### 7. Экономика v2 (P2) — 1.5.7
|
|
67
|
+
|
|
68
|
+
Бюджеты на день/неделю с авто-паузой и алертом, per-task token budgets, token efficiency score, прогноз, Grafana JSON, local vs cloud.
|
|
69
|
+
|
|
70
|
+
### 8. Docker runner (P3) — 1.5.8
|
|
71
|
+
|
|
72
|
+
Локальный процесс, Docker, SSH-хост. Задача описывает *что* делать, runner — *где*. Изоляцию не изобретаем: Docker / Landstrip. Opt-in, по умолчанию выключен.
|
|
73
|
+
|
|
74
|
+
### 9. Durable DAG (P1 для 1.6.0) — 1.5.9
|
|
75
|
+
|
|
76
|
+
Персистентная state-машина прогона, resume после краша, идемпотентные шаги, DLQ, chaos `kill -9` в nightly.
|
|
77
|
+
|
|
78
|
+
### 10. Rename-only + daemon + config v2 (P2) — 1.5.10
|
|
61
79
|
|
|
62
|
-
|
|
80
|
+
Переименование в `opencode-pipeline` отдельным релизом без фич (старый пакет живой), `scheduler.backend: native|daemon|off|auto`, автомиграция конфига.
|
|
63
81
|
|
|
64
|
-
###
|
|
82
|
+
### 11. Approvals, окружения, артефакты (MAJOR) — 1.6.0
|
|
65
83
|
|
|
66
|
-
Ручное подтверждение перед деплоем, dev / staging / prod, отчёты и coverage как артефакты
|
|
84
|
+
Ручное подтверждение перед деплоем, dev / staging / prod, отчёты и coverage как артефакты запуска, docs-сайт и 4 локали.
|
|
67
85
|
|
|
68
|
-
###
|
|
86
|
+
### 12. Remote runners (P3)
|
|
69
87
|
|
|
70
88
|
Агент на удалённой машине, центральный дашборд, очередь и конкурентность на кластере. Делать после подтверждения спроса.
|
|
71
89
|
|
|
@@ -84,14 +102,14 @@ Telegram Bot API и нативные уведомления ОС, фильтры
|
|
|
84
102
|
|
|
85
103
|
## Метрики успеха
|
|
86
104
|
|
|
87
|
-
| Метрика | Сейчас (1.
|
|
105
|
+
| Метрика | Сейчас (1.5.1) | Через 2 мес | Через 6 мес |
|
|
88
106
|
|---|---|---|---|
|
|
89
|
-
| npm latest | 1.
|
|
107
|
+
| npm latest | 1.5.1 | регулярные патчи | 1.6.x |
|
|
90
108
|
| CI на 3 ОС | ✅ | ✅ | ✅ |
|
|
91
109
|
| Покрытие RPC инструментами агента | 100% | 100% | 100% |
|
|
92
110
|
| Telegram / toast | ✅ | ✅ | ✅ |
|
|
93
111
|
| Secrets / audit | ✅ | ✅ | ✅ |
|
|
94
|
-
| Git-триггеры |
|
|
112
|
+
| Git-триггеры | ✅ | ✅ | ✅ |
|
|
95
113
|
| Pipeline-as-code | ❌ | прототип | ✅ |
|
|
96
114
|
| Docker runner | ❌ | ❌ | ✅ |
|
|
97
115
|
| Загрузки npm / мес | первые | 300+ | 1500+ |
|
|
@@ -113,7 +131,8 @@ Telegram Bot API и нативные уведомления ОС, фильтры
|
|
|
113
131
|
|
|
114
132
|
## Ближайшие две недели
|
|
115
133
|
|
|
116
|
-
1.
|
|
117
|
-
2.
|
|
134
|
+
1. i18n-фундамент (1.5.1) — каталоги локалей, паритет ключей в CI, RU по умолчанию.
|
|
135
|
+
2. Security slice A (1.5.2) — спайк по правам агента, затем enforced `allowedTools` / `deniedTools`.
|
|
136
|
+
3. Docker runner — после подтверждения спроса.
|
|
118
137
|
|
|
119
|
-
**Критерий месяца:** пользователь ставит плагин одной командой, получает уведомление в Telegram о падении задачи,
|
|
138
|
+
**Критерий месяца:** пользователь ставит плагин одной командой, получает уведомление в Telegram о падении задачи, токены и доступы не лежат открытым текстом в `tasks.json`, а интерфейс говорит на его языке.
|