opencode-windows-scheduler 1.0.0 → 1.2.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 +58 -7
- package/README.md +14 -4
- package/README.ru.md +14 -4
- package/ROADMAP.md +30 -20
- package/dist/core/analytics.d.ts +129 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +286 -0
- package/dist/core/dry-run.d.ts +13 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +30 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +10 -0
- package/dist/core/ps-wrapper.d.ts +32 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +101 -3
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +182 -0
- package/dist/core/schedule-v2.d.ts +88 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +496 -0
- package/dist/core/scheduler/types.d.ts +15 -0
- package/dist/core/scheduler/types.d.ts.map +1 -1
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +13 -1
- package/dist/core/wrappers/bash.d.ts +15 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +44 -1
- package/dist/db/history-repo.d.ts +41 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +78 -0
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +11 -0
- package/dist/index.d.ts +117 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1094 -56
- package/dist/notifications.d.ts +112 -6
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +396 -34
- package/dist/profiles.d.ts +60 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +209 -0
- package/dist/rpc.d.ts +645 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +251 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +200 -7
- package/dist/settings.d.ts +80 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +159 -8
- package/dist/task-transfer.d.ts +13 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +26 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +3 -11
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +43 -0
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +174 -8
- package/docs/ARCHITECTURE.md +45 -13
- package/docs/FEATURES.md +103 -12
- package/gui-experimental.cjs +4 -2
- package/package.json +8 -2
- package/src/core/analytics.ts +414 -0
- package/src/core/dry-run.ts +42 -0
- package/src/core/matrix.ts +10 -0
- package/src/core/ps-wrapper.ts +117 -3
- package/src/core/retention.ts +141 -0
- package/src/core/schedule-gate.ts +213 -0
- package/src/core/schedule-v2.ts +533 -0
- package/src/core/scheduler/types.ts +15 -0
- package/src/core/scheduler/windows.ts +13 -1
- package/src/core/wrappers/bash.ts +60 -0
- package/src/db/history-repo.ts +116 -0
- package/src/db/schema.ts +14 -0
- package/src/gui.tsx +3613 -2725
- package/src/index.ts +1325 -55
- package/src/notifications.ts +516 -40
- package/src/profiles.ts +236 -0
- package/src/rpc.ts +267 -2
- package/src/server.ts +226 -7
- package/src/settings.ts +285 -9
- package/src/task-transfer.ts +44 -0
- package/src/types.ts +3 -13
- package/src/version.ts +27 -0
- package/src/workspaces.ts +214 -8
- package/dist/gui-experimental.cjs +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,55 @@ All notable changes to this project are documented here. Format follows [Keep a
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [1.2.0] - 2026-11-13
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **Планирование 2.0:** `timezone` (IANA) на задачу — cron/DST считается в этом поясе, при зоне ≠ системной задача уходит в poll-режим (`MINUTE /mo 1` + `schedule-gate` в обёртке); следующие срабатывания считаются в dry-run.
|
|
12
|
+
- Окна запуска `notBefore`/`notAfter` (HH:MM, можно через полночь) — запуск переносится на открытие окна, не пропускается (postpone с dedup через defer-файл).
|
|
13
|
+
- Расширенный cron: `@every 15m|2h|1d`, `L` (последний день месяца), `d#n` (N-й день недели, напр. `FRI#3`), имена месяцев/дней, диапазоны и списки со шагами.
|
|
14
|
+
- Пауза до даты `pausedUntil` — `pause_task(name, until?)` сохраняет ISO-момент; авто-возобновление при старте плагина и по таймеру каждые 5 мин, `resume_task` снимает паузу досрочно.
|
|
15
|
+
- `test-schedule-v2.mjs` (50 проверок: парсер, nextRun/prevRun, DST, окна, CLI-шлюз) — добавлен в `npm test`.
|
|
16
|
+
- **Уведомления v2:** ретраи webhook (`timeoutMs`, `retryCount`, `retryDelayMs`, backoff до 30 с на сеть/таймаут/5xx/429), шаблоны сообщений с плейсхолдерами и фильтры задач (`include`/`exclude`, маски `*`).
|
|
17
|
+
- Уведомления матриц (успех, `partial`, «все упали») и детектор зависших клонов (`matrix.stuckAfterMinutes`, одно уведомление на запуск).
|
|
18
|
+
- Дайджест (ежедневный/еженедельный): запуски, success rate, стоимость, токены, топ ошибок; RPC `send_digest`, кнопка «📊 Отправить дайджест сейчас», GUI-настройки таймаута/шаблонов/фильтров/матриц/дайджеста. ntfy.sh не реализован (исключён заданием).
|
|
19
|
+
- `test-notifications-v2.mjs` (44 проверки) — добавлен в `npm test`.
|
|
20
|
+
- **Полный паритет агента (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 инструмента).
|
|
21
|
+
|
|
22
|
+
### Profiles (Спринт 21)
|
|
23
|
+
|
|
24
|
+
- Профили (`default`, `work`, …): каждый профиль — отдельная директория со своей БД (`scheduler.db`), настройками (`settings.json`), логами, обёртками и портом дашборда. `default` использует базовую директорию плагина (как раньше — без миграции), остальные живут в `<base>/profiles/<name>`.
|
|
25
|
+
- `OPENCODE_SCHEDULER_PROFILE` > файл-маркер `active-profile` > `default`; переключение требует перезапуска OpenCode. Порт дашборда профиля — из `env OPENCODE_SCHEDULER_PORT` > `profile.json` > дефолт (3782/4782/5782).
|
|
26
|
+
- `src/profiles.ts` — `getProfileName()`, `getProfileDir()`, `listProfiles()`, `createProfile()`, `deleteProfile()`, `setActiveProfile()`, `isProfilePinnedByEnv()`; `resolvePluginDir()` в `src/types.ts` теперь delegates to `getProfileDir(getProfileName())`, так что все каталоги/БД/настройки стали per-profile автоматически.
|
|
27
|
+
- RPC: `get_profiles`, `set_profile`, `create_profile`, `delete_profile`; дашборд показывает имя профиля в заголовке и в `/api/health`.
|
|
28
|
+
|
|
29
|
+
### Workspace env (Спринт 21)
|
|
30
|
+
|
|
31
|
+
- Env-переменные на workspace: `.env`-файл (`envFile`) или пары ключ-значение (`env`); пары переопределяют файл. Валидация имён ключей (`^[A-Za-z_][A-Za-z0-9_]*$`), максимум 100 пар.
|
|
32
|
+
- Файл `<PLUGIN_DIR>/env/<sanitized>.env` (права 0600) передаётся обёрткам: Windows — `-EnvFile "<путь>"`, POSIX — `ENV_FILE=` + `set -a; . "$ENV_FILE"; set +a` перед запуском `opencode run`. Значения не попадают в логи: секретные ключи (Token/Secret/Pass/Password/Key/Credential/Auth) маскируются как `***`.
|
|
33
|
+
- `manage_workspaces` (add/update) принимает `env` и `envFile`; `get_workspaces`/`get_workspace` возвращают env в замаскированном виде.
|
|
34
|
+
|
|
35
|
+
### Tests
|
|
36
|
+
|
|
37
|
+
- `test-profiles.mjs` (58 проверок) — профили: default vs named dir, sanitize/validate, create/list/delete, маркер, порт env > profile.json > null, изоляция БД/настроек через subprocess с разными `OPENCODE_SCHEDULER_HOME`/`OPENCODE_SCHEDULER_PROFILE`.
|
|
38
|
+
- `test-env.mjs` (53 проверок) — парсер `.env` (комментарии, кавычки, `export `), приоритет пар над файлом, валидация ключей и >100 пар, `maskEnvForLog` (секреты → `***`), `writeWorkspaceEnvFile` (содержимое, права 0600, очистка устаревших), круговая запись workspace с env/envFile в БД.
|
|
39
|
+
- Оба теста добавлены в цепочку `npm test` (итого 17 секций, 500+ проверок).
|
|
40
|
+
|
|
41
|
+
### Fixed
|
|
42
|
+
|
|
43
|
+
- **`run_task_now` больше не зависит от расписания.** Одноразовый маркер `--force-file` (срок жизни 2 минуты) снимает проверку cron в `schedule-gate`; маркер ставят все немедленные запуски: инструмент, RPC, файловые триггеры, MCP-события и catch-up.
|
|
44
|
+
- **Файловые триггеры работают без перезапуска OpenCode.** `schedule_task` принимает `watchPath`, а набор watcher-ов пересобирается после создания, обновления и удаления задачи.
|
|
45
|
+
- **`list_tasks` показывает определения, оставшиеся только в БД.** Такие задачи помечаются `orphaned: true` вместо того, чтобы молча исчезать из списка.
|
|
46
|
+
- **`delete_task` честно сообщает об отсутствии задачи.** Вместо ложного `success` возвращается ошибка «не найдена — удалять нечего».
|
|
47
|
+
- **Карточки задач показывают свою статистику.** Раньше каждая карточка выводила общие метрики (одинаковые 201/130/71 у всех); теперь `get_tasks` отдаёт `runsTotal`/`runsSuccess`/`runsError` по задаче, общие итоги вынесены в шапку панели. Окно истории фильтруется по задаче (`get_history` принимает `taskName`).
|
|
48
|
+
- **«+ Создать» в профилях работает.** `window.prompt` не поддерживается в Electron — все семь вызовов заменены на собственный модальный `askText()` (Enter/ОК, Escape/отмена; для env — textarea с Ctrl+Enter).
|
|
49
|
+
|
|
50
|
+
### Planned
|
|
51
|
+
|
|
52
|
+
- One-shot scheduling, session continuity, guards, worktree isolation, declarative job files.
|
|
53
|
+
|
|
54
|
+
## [1.1.0] - 2026-11-13
|
|
55
|
+
|
|
7
56
|
### Added
|
|
8
57
|
|
|
9
58
|
- **Full agent parity:** `schedule_task` now accepts `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`, `nextTaskOnSuccess`, `nextTaskOnError` and the complete matrix configuration (`concurrency`, `overrides`).
|
|
@@ -13,13 +62,13 @@ All notable changes to this project are documented here. Format follows [Keep a
|
|
|
13
62
|
- `update_task` keeps every field that is not passed, so the agent can change one setting without resending the whole task.
|
|
14
63
|
- **Built-in agent skill** `scheduled-job-best-practices`, registered by the plugin itself: guidance on schedule design, prompt structure, safety defaults, matrix concurrency, DAG rules and failure diagnosis, plus `references/recipes.md` with seven complete examples. No manual `.opencode/skills` setup.
|
|
15
64
|
- **Documentation:** `docs/ARCHITECTURE.md` (process model, modules, backends, data model, security model), `docs/FEATURES.md` (full feature catalog with examples and limits) and `docs/MIGRATION.md` (from cron, systemd timers, launchd and Windows Task Scheduler), linked from both READMEs.
|
|
16
|
-
- `test-docs.mjs`
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
65
|
+
- `test-docs.mjs` - 30 checks that the guides exist, stay complete and ship in the npm package.
|
|
66
|
+
- **History retention:** `history.retentionDays` (default 30) and `history.maxRecords` (default 5000) in settings (`0` disables either limit); daily auto-cleanup on plugin start plus `PRAGMA incremental_vacuum`; `cleanup_history` RPC and a «🧹 История и ретеншн» panel in the GUI with last-cleanup stats and an «Очистить сейчас» button.
|
|
67
|
+
- **14-day analytics:** `get_analytics` RPC and `GET /api/analytics` (runs, success rate, tokens, cost per day/task/model/matrix); dashboard «📊 Аналитика за период» block (KPIs, daily bar chart, top tasks by cost, matrices); history export to CSV/JSON (`GET /api/history/export?format=csv|json`) — `recordCost` falls back to a token-based estimate when `costUsd` is missing.
|
|
68
|
+
- **`/api/health`** now reports `version` (from package.json), `scheduler` (backend title), `queueDepth` (unfinished runs) and `db` status.
|
|
69
|
+
- `test-retention.mjs` - 19 checks; `test-metrics.mjs` - 25 checks; both wired into `npm test`.
|
|
21
70
|
|
|
22
|
-
## [1.0.0]
|
|
71
|
+
## [1.0.0] - 2026-11-13
|
|
23
72
|
|
|
24
73
|
First public release.
|
|
25
74
|
|
|
@@ -41,5 +90,7 @@ First public release.
|
|
|
41
90
|
- Deleting a matrix parent deletes its family, but deleting a workspace does not touch existing matrix jobs.
|
|
42
91
|
- Agent tools cover a subset of the RPC surface (see roadmap item 0.4).
|
|
43
92
|
|
|
44
|
-
[Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.
|
|
93
|
+
[Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.0...HEAD
|
|
94
|
+
[1.2.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.1.0...v1.2.0
|
|
95
|
+
[1.1.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.0.0...v1.1.0
|
|
45
96
|
[1.0.0]: https://github.com/DeadSno/opencode-windows-scheduler/releases/tag/v1.0.0
|
package/README.md
CHANGED
|
@@ -37,7 +37,7 @@ Want to see it without installing OpenCode? `node scripts/demo-dashboard.mjs` st
|
|
|
37
37
|
| Orchestration | `dependsOn` DAG, `nextTaskOnSuccess` / `nextTaskOnError` chains, matrix fan-out (parallel/sequential, `continue`/`stop`, concurrency, per-workspace overrides, aggregator task) |
|
|
38
38
|
| Triggers | cron, file change (chokidar), MCP events |
|
|
39
39
|
| Multi-repo | workspaces with path validation, per-workspace runs, matrix over one parent task |
|
|
40
|
-
| Observability | SQLite history (success / error / timeout / partial / running), metrics (duration, tokens, cost), per-task logs, local web dashboard |
|
|
40
|
+
| Observability | SQLite history (success / error / timeout / partial / running), metrics (duration, tokens, cost), per-task logs, local web dashboard with 14-day analytics, history retention (age and size limits) and CSV/JSON export |
|
|
41
41
|
| Operations | dry-run preview, export/import JSON, templates, webhook notifications, settings |
|
|
42
42
|
| Interfaces | OpenCode GUI panel, web dashboard, 12 agent tools, built-in agent skill |
|
|
43
43
|
|
|
@@ -73,7 +73,7 @@ npm run build && npm run build:gui
|
|
|
73
73
|
|
|
74
74
|
## Agent tools
|
|
75
75
|
|
|
76
|
-
The agent gets the full feature set —
|
|
76
|
+
The agent gets the full feature set — 22 tools covering scheduling, pipelines, operations, observability and administration:
|
|
77
77
|
|
|
78
78
|
| Tool | Arguments | What it does |
|
|
79
79
|
|---|---|---|
|
|
@@ -88,7 +88,17 @@ The agent gets the full feature set — 12 tools covering scheduling, pipelines,
|
|
|
88
88
|
| `get_task_logs` | `name`, `lines?` | Tail of the run log |
|
|
89
89
|
| `dry_run` | `name?` | Simulates a pipeline (or every task): order, DAG, matrix fan-out, estimates |
|
|
90
90
|
| `manage_workspaces` | `action`, `id?`, `name?`, `path?`, `color?` | Multi-repo workspaces: list, add, update, delete |
|
|
91
|
-
| `matrix_control` | `action`, `name?` | Matrix results, cancel pending clones, clean up orphans |
|
|
91
|
+
| `matrix_control` | `action`, `name?` | Matrix results, cancel pending clones, clean up orphans, preview clones |
|
|
92
|
+
| `get_metrics` | — | Aggregate runs, successes and failures |
|
|
93
|
+
| `get_analytics` | `days?`, `topLimit?` | Period report: counts, success rate, duration, tokens, cost, top tasks |
|
|
94
|
+
| `manage_settings` | `action`, `maxConcurrent?`, `winterMode?`, `notifications?`, `history?` | Read/update global settings (concurrency, notifications, retention) |
|
|
95
|
+
| `manage_templates` | `action`, template fields | List, save or delete reusable task templates |
|
|
96
|
+
| `manage_profiles` | `action`, `name?`, `port?` | List, create, switch or delete isolated profiles |
|
|
97
|
+
| `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 |
|
|
99
|
+
| `get_dashboard_info` | — | Dashboard port/URL, platform, title, active profile |
|
|
100
|
+
| `cleanup_history` | `retentionDays?`, `maxRecords?` | Delete old history by age and/or record cap |
|
|
101
|
+
| `emit_event` | `eventName`, `payload?` | Start tasks subscribed to an MCP event |
|
|
92
102
|
|
|
93
103
|
`schedule_task` also accepts the full matrix configuration (`workspaceIds`, `strategy`, `failureMode`, `aggregation`, `concurrency`, `overrides`, `createAggregator`).
|
|
94
104
|
|
|
@@ -153,7 +163,7 @@ Job wrappers run `opencode run` in the task working directory, so project MCP se
|
|
|
153
163
|
npm install
|
|
154
164
|
npm run build # tsc
|
|
155
165
|
npm run build:gui # vite
|
|
156
|
-
npm test #
|
|
166
|
+
npm test # 17 test suites, 500+ checks
|
|
157
167
|
```
|
|
158
168
|
|
|
159
169
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
package/README.ru.md
CHANGED
|
@@ -28,7 +28,7 @@ English version: [README.md](README.md).
|
|
|
28
28
|
| Оркестрация | DAG `dependsOn`, цепочки success/error, матрицы (parallel/sequential, continue/stop, concurrency, overrides, агрегатор) |
|
|
29
29
|
| Триггеры | cron, изменение файла (chokidar), MCP-события |
|
|
30
30
|
| Мультирепо | workspaces с валидацией путей, запуск по workspace, матрица поверх родительской задачи |
|
|
31
|
-
| Наблюдаемость | история SQLite (success / error / timeout / partial / running),
|
|
31
|
+
| Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики (длительность, токены, стоимость), логи, веб-дашборд: аналитика за 14 дней, ретеншн истории (лимиты по возрасту и размеру), экспорт CSV/JSON |
|
|
32
32
|
| Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, webhook-уведомления, настройки |
|
|
33
33
|
| Интерфейсы | панель OpenCode GUI, веб-дашборд, 12 инструментов для агента, встроенный скилл |
|
|
34
34
|
|
|
@@ -64,7 +64,7 @@ npm run build && npm run build:gui
|
|
|
64
64
|
|
|
65
65
|
## Инструменты для агента
|
|
66
66
|
|
|
67
|
-
Агенту доступен весь функционал —
|
|
67
|
+
Агенту доступен весь функционал — 22 инструмента: расписание, пайплайны, эксплуатация, аналитика и администрирование.
|
|
68
68
|
|
|
69
69
|
| Инструмент | Аргументы | Что делает |
|
|
70
70
|
|---|---|---|
|
|
@@ -79,7 +79,17 @@ npm run build && npm run build:gui
|
|
|
79
79
|
| `get_task_logs` | `name`, `lines?` | Хвост лога запуска |
|
|
80
80
|
| `dry_run` | `name?` | Симуляция пайплайна (или всех задач): порядок, DAG, fan-out, оценки |
|
|
81
81
|
| `manage_workspaces` | `action`, `id?`, `name?`, `path?`, `color?` | Multi-repo workspace: список, добавление, изменение, удаление |
|
|
82
|
-
| `matrix_control` | `action`, `name?` | Результаты матрицы, отмена клонов, очистка осиротевших
|
|
82
|
+
| `matrix_control` | `action`, `name?` | Результаты матрицы, отмена клонов, очистка осиротевших задач, предпросмотр |
|
|
83
|
+
| `get_metrics` | — | Всего запусков, успехов и падений |
|
|
84
|
+
| `get_analytics` | `days?`, `topLimit?` | Отчёт за период: запуски, успешность, длительность, токены, стоимость, топ задач |
|
|
85
|
+
| `manage_settings` | `action`, `maxConcurrent?`, `winterMode?`, `notifications?`, `history?` | Чтение и изменение глобальных настроек (параллелизм, уведомления, retention) |
|
|
86
|
+
| `manage_templates` | `action`, поля шаблона | Список, сохранение и удаление шаблонов задач |
|
|
87
|
+
| `manage_profiles` | `action`, `name?`, `port?` | Список, создание, переключение и удаление профилей |
|
|
88
|
+
| `transfer_tasks` | `action`, `data?` | Экспорт всех задач в JSON и импорт обратно |
|
|
89
|
+
| `send_notification` | `action` (`test`/`digest`) | Проверка канала уведомлений или отправка дайджеста |
|
|
90
|
+
| `get_dashboard_info` | — | Порт/URL дашборда, платформа, заголовок, активный профиль |
|
|
91
|
+
| `cleanup_history` | `retentionDays?`, `maxRecords?` | Удаление старой истории по возрасту и/или лимиту записей |
|
|
92
|
+
| `emit_event` | `eventName`, `payload?` | Запуск задач, подписанных на MCP-событие |
|
|
83
93
|
|
|
84
94
|
`schedule_task` принимает и полную конфигурацию матрицы (`workspaceIds`, `strategy`, `failureMode`, `aggregation`, `concurrency`, `overrides`, `createAggregator`).
|
|
85
95
|
|
|
@@ -108,7 +118,7 @@ npm run build:gui # gui-experimental.cjs
|
|
|
108
118
|
```bash
|
|
109
119
|
npm run build # tsc: серверная часть плагина
|
|
110
120
|
npm run build:gui # vite: GUI-бандл gui-experimental.cjs
|
|
111
|
-
npm test #
|
|
121
|
+
npm test # 17 сюит, 500+ проверок
|
|
112
122
|
```
|
|
113
123
|
|
|
114
124
|
## Документация
|
package/ROADMAP.md
CHANGED
|
@@ -18,8 +18,13 @@
|
|
|
18
18
|
| 14 | Экспорт/импорт задач, шаблоны | `src/task-transfer.ts`, `src/templates.ts` |
|
|
19
19
|
| 15 | Matrix Builds (fan-out): клоны по workspace, parallel/sequential, failureMode, агрегация, DAG | `src/core/matrix.ts`, `SPRINT15` в истории |
|
|
20
20
|
| 16 | Lifecycle матриц: каскадное удаление, отмена, чистка сирот, guard на удаление клона | `src/core/matrix.ts`, `test-matrix-lifecycle.mjs` |
|
|
21
|
+
| 17 | Синхронизация матриц (`syncMatrixFamily`) + per-workspace overrides + concurrency | `src/core/matrix.ts`, `SPRINT17` (отчёт не писался) |
|
|
22
|
+
| 18 | Ретеншн истории (30 дней / 5000 записей), аналитика за 14 дней, CSV/JSON-экспорт, `/api/health` | `SPRINT18.md` |
|
|
23
|
+
| 19 | Планирование 2.0: timezone на задачу, окна запуска notBefore/notAfter, расширенный cron (@every/L/#), пауза до даты с автопродолжением, следующие срабатывания в dry-run | `SPRINT19.md` |
|
|
24
|
+
| 20 | Уведомления v2: ретраи/таймаут webhook, шаблоны, фильтры по задачам, уведомления матриц, детектор зависших клонов, дайджест (день/неделя) | `SPRINT20.md` |
|
|
25
|
+
| 21 | Мультипроектность: профили (`default`, `work`, …) с отдельными БД/настройками/портом дашборда, группировка задач по workspace в GUI/дашборде, переключение профиля, env-переменные на workspace (`.env` или пары) с маскировкой секретов, тесты `test-profiles.mjs`/`test-env.mjs` | `SPRINT21.md` |
|
|
21
26
|
|
|
22
|
-
## Спринт 17 — Синхронизация матриц + per-workspace настройки
|
|
27
|
+
## Спринт 17 — Синхронизация матриц + per-workspace настройки ✅ Готово
|
|
23
28
|
|
|
24
29
|
**Проблема:** после создания матрицы изменение `matrix.workspaceIds` (или промпта/хуков) в `update_task`/GUI не пересоздаёт клонов — семья рассинхронизируется, появляются устаревшие клоны. Плюс нельзя задать клону отличия от родителя (свой промпт, модель, QG).
|
|
25
30
|
|
|
@@ -42,31 +47,36 @@
|
|
|
42
47
|
|
|
43
48
|
**Ограничения на потом:** история удалённых при синхронизации клонов остаётся (чистится ретеншном — Спринт 18).
|
|
44
49
|
|
|
45
|
-
## Спринт 18 — Ретеншн истории и аналитика
|
|
50
|
+
## Спринт 18 — Ретеншн истории и аналитика ✅ Готово
|
|
46
51
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
+
Отчёт: `SPRINT18.md`. По факту:
|
|
53
|
+
1. Настройки `history.retentionDays` / `history.maxRecords` в settings.json (дефолт 30 дней / 5000 записей, 0 — выкл.), автоочистка раз в сутки при старте плагина + `PRAGMA incremental_vacuum`; ручная кнопка «🧹 Очистить сейчас» и RPC `cleanup_history`. GUI: сворачиваемая секция «🧹 История и ретеншн».
|
|
54
|
+
2. RPC: `cleanup_history` + отдельный `get_analytics` (`days` 1..365, `topLimit >= 1`): агрегаты по дням/задачам/моделям/матрицам, success rate, токены, стоимость. All-time RPC `get_metrics` оставлен как был — отдельное имя, см. SPRINT18.md (расхождение с этим пунктом).
|
|
55
|
+
3. Дашборд: блок «📊 Аналитика за период» (KPI, график по дням, топ задач по стоимости, матрицы), экспорт истории в CSV/JSON (`/api/history/export?format=csv|json`).
|
|
56
|
+
4. `/api/health`: `version` (из package.json), `scheduler`, `queueDepth` (незавершённые запуски), `db` (`getDbStatus()`). Статистику осиротевших задач health не отдаёт — сироты остаются в матричных инструментах (`matrix_control`).
|
|
57
|
+
5. Тесты: `test-retention.mjs` (19 проверок) + `test-metrics.mjs` (25 проверок), оба в цепочке `npm test`.
|
|
52
58
|
|
|
53
|
-
## Спринт 19 — Планирование 2.0
|
|
59
|
+
## Спринт 19 — Планирование 2.0 ✅ Готово
|
|
54
60
|
|
|
55
|
-
|
|
56
|
-
2. Окна запуска: `notBefore` / `notAfter` (например, деплой только 22:00–06:00) — перенос запуска, а не пропуск.
|
|
57
|
-
3. Расширенный cron: `@every 15m`, `L` (последний день месяца), `#` (N-й день недели).
|
|
58
|
-
4. Пауза до даты (`pausedUntil`) с автопродолжением.
|
|
59
|
-
5. Тесты: `test-schedule-v2.mjs` (включая DST и переходы суток).
|
|
61
|
+
**По факту:** все пять пунктов реализованы (отчёт: `SPRINT19.md`).
|
|
60
62
|
|
|
61
|
-
|
|
63
|
+
1. `timezone` на задачу (IANA) — корректный пересчёт cron в этом поясе, DST-безопасный `nextRun`/`prevRun`, для зоны ≠ системной задача уходит в poll-режим (`MINUTE /mo 1` + gate в обёртке); следующий запуск тоже считается в dry-run (`scheduleDetails.nextRuns`).
|
|
64
|
+
2. Окна запуска `notBefore`/`notAfter` (HH:MM, можно через полночь) — запуск переносится на открытие окна, не пропускается (postpone в `schedule-gate` с dedup через defer-файл).
|
|
65
|
+
3. Расширенный cron: `@every 15m|2h|1d`, `L` (последний день месяца), `d#n` (N-й день недели, например `FRI#3`), имена месяцев/дней недели, диапазоны и списки со шагами.
|
|
66
|
+
4. Пауза до даты `pausedUntil` — `pause_task(name, until?)` сохраняет ISO-момент в определении задачи; плагин возобновляет задачи автоматически при старте и по таймеру каждые 5 мин, `resume_task` снимает паузу досрочно.
|
|
67
|
+
5. Тесты: `test-schedule-v2.mjs` (50 проверок: парсер, nextRun/prevRun, DST Берлин весна/осень, окна incl. через полночь, CLI-шлюз exit-коды) — в цепочке `npm test`.
|
|
62
68
|
|
|
63
|
-
|
|
64
|
-
2. Уведомления о матрицах: `partial`, «матрица зависла» (клоны running дольше N минут), «все клоны упали».
|
|
65
|
-
3. Настраиваемые шаблоны сообщений + отдельные фильтры по задачам.
|
|
66
|
-
4. Повтор отправки при сетевой ошибке (backoff), таймаут webhook.
|
|
67
|
-
5. **ntfy.sh не реализуем** (исключён заданием), каналы: webhook + тосты.
|
|
69
|
+
## Спринт 20 — Уведомления v2 ✅ Готово
|
|
68
70
|
|
|
69
|
-
|
|
71
|
+
**По факту:** все пять пунктов реализованы (отчёт: `SPRINT20.md`).
|
|
72
|
+
|
|
73
|
+
1. Дайджест: ежедневный (`daily`) или еженедельный (`weekly`, с догоняющей отправкой после понедельника) — запуски, success rate, стоимость, токены и топ ошибок; планировщик проверяет раз в минуту, есть RPC `send_digest` и кнопка «📊 Отправить дайджест сейчас» (ручная отправка расписание не сдвигает).
|
|
74
|
+
2. Уведомления матриц: успех, `partial` и «все клоны упали» после агрегата; детектор зависших клонов (`matrix.stuckAfterMinutes`, дефолт 60, 0 — выкл.) уведомляет один раз на запуск.
|
|
75
|
+
3. Шаблоны `templates.success`/`templates.error` с плейсхолдерами `{task} {status} {duration} {error} {emoji}` и фильтры `filters.include`/`exclude` (маски `*`, исключения важнее включений).
|
|
76
|
+
4. Webhook: `timeoutMs` (дефолт 10 000), `retryCount` (дефолт 2) и `retryDelayMs` (дефолт 1000), ретраи на сеть/таймаут/5xx/429 с экспоненциальным backoff до 30 с, прочие 4xx без повторов.
|
|
77
|
+
5. **ntfy.sh не реализован** (исключён заданием), каналы: webhook + тосты. Тесты: `test-notifications-v2.mjs` (44 проверки) — в цепочке `npm test`.
|
|
78
|
+
|
|
79
|
+
## Спринт 21 — Мультипроектность ✅ Готово
|
|
70
80
|
|
|
71
81
|
1. Профили (`default`, `work`, …): отдельные БД/настройки/дашборд-порт.
|
|
72
82
|
2. Группировка задач по проекту в GUI/дашборде, переключение профиля.
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Аналитика по истории запусков (Спринт 18).
|
|
3
|
+
*
|
|
4
|
+
* Чистые функции без БД и HTTP: дашборд и RPC отдают JSON, экспорт — CSV.
|
|
5
|
+
* Так агрегаты легко тестировать без запуска сервера.
|
|
6
|
+
*/
|
|
7
|
+
/** Оценка стоимости, если запись истории не содержит costUsd. */
|
|
8
|
+
export declare const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
|
|
9
|
+
/** Минимальный вид записи истории, нужный аналитике. */
|
|
10
|
+
export interface AnalyticsRecord {
|
|
11
|
+
taskName: string;
|
|
12
|
+
status: string;
|
|
13
|
+
startedAt: string;
|
|
14
|
+
finishedAt?: string | null;
|
|
15
|
+
durationMs?: number | null;
|
|
16
|
+
error?: string | null;
|
|
17
|
+
tokens?: number;
|
|
18
|
+
costUsd?: number;
|
|
19
|
+
model?: string;
|
|
20
|
+
workspaceId?: string | null;
|
|
21
|
+
}
|
|
22
|
+
/** Описание задачи для группировки по матрицам. */
|
|
23
|
+
export interface AnalyticsTaskRef {
|
|
24
|
+
name: string;
|
|
25
|
+
matrixParentId?: string | null;
|
|
26
|
+
}
|
|
27
|
+
export interface DailyBucket {
|
|
28
|
+
/** YYYY-MM-DD (UTC). */
|
|
29
|
+
date: string;
|
|
30
|
+
total: number;
|
|
31
|
+
success: number;
|
|
32
|
+
error: number;
|
|
33
|
+
partial: number;
|
|
34
|
+
tokens: number;
|
|
35
|
+
costUsd: number;
|
|
36
|
+
avgDurationMs: number;
|
|
37
|
+
}
|
|
38
|
+
export interface TaskAnalyticsRow {
|
|
39
|
+
taskName: string;
|
|
40
|
+
total: number;
|
|
41
|
+
success: number;
|
|
42
|
+
error: number;
|
|
43
|
+
/** Процент успешных запусков (0..100, один знак после запятой). */
|
|
44
|
+
successRate: number;
|
|
45
|
+
avgDurationMs: number;
|
|
46
|
+
tokens: number;
|
|
47
|
+
costUsd: number;
|
|
48
|
+
/** Задача — клон матрицы (matrixParentId задан). */
|
|
49
|
+
isMatrixClone: boolean;
|
|
50
|
+
matrixParentId: string | null;
|
|
51
|
+
}
|
|
52
|
+
export interface MatrixAnalyticsRow {
|
|
53
|
+
parentId: string;
|
|
54
|
+
clones: number;
|
|
55
|
+
total: number;
|
|
56
|
+
success: number;
|
|
57
|
+
error: number;
|
|
58
|
+
successRate: number;
|
|
59
|
+
tokens: number;
|
|
60
|
+
costUsd: number;
|
|
61
|
+
}
|
|
62
|
+
export interface ModelAnalyticsRow {
|
|
63
|
+
model: string;
|
|
64
|
+
total: number;
|
|
65
|
+
costUsd: number;
|
|
66
|
+
}
|
|
67
|
+
/** Агрегат по тексту ошибки — топ ошибок для дайджеста (Спринт 20). */
|
|
68
|
+
export interface ErrorAnalyticsRow {
|
|
69
|
+
/** Текст ошибки (обрезан до 160 символов). */
|
|
70
|
+
message: string;
|
|
71
|
+
count: number;
|
|
72
|
+
/** Последнее появление (ISO). */
|
|
73
|
+
lastAt: string;
|
|
74
|
+
}
|
|
75
|
+
export interface AnalyticsReport {
|
|
76
|
+
generatedAt: string;
|
|
77
|
+
/** Окно анализа в днях. */
|
|
78
|
+
windowDays: number;
|
|
79
|
+
totals: {
|
|
80
|
+
total: number;
|
|
81
|
+
success: number;
|
|
82
|
+
error: number;
|
|
83
|
+
partial: number;
|
|
84
|
+
successRate: number;
|
|
85
|
+
avgDurationMs: number;
|
|
86
|
+
tokens: number;
|
|
87
|
+
costUsd: number;
|
|
88
|
+
};
|
|
89
|
+
daily: DailyBucket[];
|
|
90
|
+
tasks: TaskAnalyticsRow[];
|
|
91
|
+
topByCost: TaskAnalyticsRow[];
|
|
92
|
+
matrices: MatrixAnalyticsRow[];
|
|
93
|
+
byModel: ModelAnalyticsRow[];
|
|
94
|
+
/** Топ ошибок по частоте (Спринт 20). */
|
|
95
|
+
errors: ErrorAnalyticsRow[];
|
|
96
|
+
sources: {
|
|
97
|
+
historyRecords: number;
|
|
98
|
+
/** Сколько записей попало в окно. */
|
|
99
|
+
recordsInWindow: number;
|
|
100
|
+
/** Ограничение по количеству строк в топах. */
|
|
101
|
+
topLimit: number;
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
export interface BuildAnalyticsOptions {
|
|
105
|
+
/** Окно анализа в днях (по умолчанию 14). */
|
|
106
|
+
days?: number;
|
|
107
|
+
/** Опорный момент (для тестов). */
|
|
108
|
+
now?: Date;
|
|
109
|
+
/** Сколько строк оставлять в топах (по умолчанию 10). */
|
|
110
|
+
topLimit?: number;
|
|
111
|
+
/** Известные задачи — нужны для группировки матриц. */
|
|
112
|
+
tasks?: AnalyticsTaskRef[];
|
|
113
|
+
}
|
|
114
|
+
/** Стоимость записи: явная цена, иначе оценка по токенам. */
|
|
115
|
+
export declare function recordCost(record: AnalyticsRecord): number;
|
|
116
|
+
/** Дата записи в UTC-формате YYYY-MM-DD. */
|
|
117
|
+
export declare function recordDate(record: AnalyticsRecord): string;
|
|
118
|
+
/**
|
|
119
|
+
* Строит отчёт по истории: итоги, дневные бакеты, разбивка по задачам,
|
|
120
|
+
* матрицам и моделям.
|
|
121
|
+
*/
|
|
122
|
+
export declare function buildAnalytics(records: AnalyticsRecord[], options?: BuildAnalyticsOptions): AnalyticsReport;
|
|
123
|
+
/** Экранирование значения для CSV (RFC 4180). */
|
|
124
|
+
export declare function csvCell(value: unknown): string;
|
|
125
|
+
/** Заголовок CSV-экспорта истории. */
|
|
126
|
+
export declare const HISTORY_CSV_HEADER: readonly ["startedAt", "finishedAt", "taskName", "status", "durationMs", "tokens", "costUsd", "model", "workspaceId", "error"];
|
|
127
|
+
/** История в CSV: точки с запятой как разделитель — дружелюбно к Excel (RU). */
|
|
128
|
+
export declare function historyToCsv(records: AnalyticsRecord[]): string;
|
|
129
|
+
//# sourceMappingURL=analytics.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"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"}
|