opencode-windows-scheduler 0.0.0-stage → 1.1.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.
Files changed (183) hide show
  1. package/CHANGELOG.md +52 -0
  2. package/CROSS_PLATFORM.md +113 -0
  3. package/LICENSE +21 -0
  4. package/README.md +173 -2
  5. package/README.ru.md +131 -0
  6. package/ROADMAP-STRATEGY.md +217 -0
  7. package/ROADMAP.md +90 -0
  8. package/dist/core/analytics.d.ts +119 -0
  9. package/dist/core/analytics.d.ts.map +1 -0
  10. package/dist/core/analytics.js +265 -0
  11. package/dist/core/cron-to-schtasks.d.ts +20 -0
  12. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  13. package/dist/core/cron-to-schtasks.js +233 -0
  14. package/dist/core/dry-run.d.ts +44 -0
  15. package/dist/core/dry-run.d.ts.map +1 -0
  16. package/dist/core/dry-run.js +252 -0
  17. package/dist/core/file-watcher.d.ts +31 -0
  18. package/dist/core/file-watcher.d.ts.map +1 -0
  19. package/dist/core/file-watcher.js +128 -0
  20. package/dist/core/lock.d.ts +43 -0
  21. package/dist/core/lock.d.ts.map +1 -0
  22. package/dist/core/lock.js +118 -0
  23. package/dist/core/matrix.d.ts +167 -0
  24. package/dist/core/matrix.d.ts.map +1 -0
  25. package/dist/core/matrix.js +687 -0
  26. package/dist/core/ps-wrapper.d.ts +60 -0
  27. package/dist/core/ps-wrapper.d.ts.map +1 -0
  28. package/dist/core/ps-wrapper.js +538 -0
  29. package/dist/core/record-history.d.ts +14 -0
  30. package/dist/core/record-history.d.ts.map +1 -0
  31. package/dist/core/record-history.js +360 -0
  32. package/dist/core/retention.d.ts +29 -0
  33. package/dist/core/retention.d.ts.map +1 -0
  34. package/dist/core/retention.js +98 -0
  35. package/dist/core/scheduler/index.d.ts +20 -0
  36. package/dist/core/scheduler/index.d.ts.map +1 -0
  37. package/dist/core/scheduler/index.js +32 -0
  38. package/dist/core/scheduler/linux.d.ts +32 -0
  39. package/dist/core/scheduler/linux.d.ts.map +1 -0
  40. package/dist/core/scheduler/linux.js +115 -0
  41. package/dist/core/scheduler/logs.d.ts +11 -0
  42. package/dist/core/scheduler/logs.d.ts.map +1 -0
  43. package/dist/core/scheduler/logs.js +34 -0
  44. package/dist/core/scheduler/mac.d.ts +39 -0
  45. package/dist/core/scheduler/mac.d.ts.map +1 -0
  46. package/dist/core/scheduler/mac.js +175 -0
  47. package/dist/core/scheduler/posix.d.ts +40 -0
  48. package/dist/core/scheduler/posix.d.ts.map +1 -0
  49. package/dist/core/scheduler/posix.js +86 -0
  50. package/dist/core/scheduler/registry.d.ts +36 -0
  51. package/dist/core/scheduler/registry.d.ts.map +1 -0
  52. package/dist/core/scheduler/registry.js +56 -0
  53. package/dist/core/scheduler/types.d.ts +63 -0
  54. package/dist/core/scheduler/types.d.ts.map +1 -0
  55. package/dist/core/scheduler/types.js +1 -0
  56. package/dist/core/scheduler/windows.d.ts +47 -0
  57. package/dist/core/scheduler/windows.d.ts.map +1 -0
  58. package/dist/core/scheduler/windows.js +375 -0
  59. package/dist/core/wrappers/bash.d.ts +58 -0
  60. package/dist/core/wrappers/bash.d.ts.map +1 -0
  61. package/dist/core/wrappers/bash.js +223 -0
  62. package/dist/db/history-repo.d.ts +102 -0
  63. package/dist/db/history-repo.d.ts.map +1 -0
  64. package/dist/db/history-repo.js +215 -0
  65. package/dist/db/index.d.ts +47 -0
  66. package/dist/db/index.d.ts.map +1 -0
  67. package/dist/db/index.js +120 -0
  68. package/dist/db/metrics-repo.d.ts +43 -0
  69. package/dist/db/metrics-repo.d.ts.map +1 -0
  70. package/dist/db/metrics-repo.js +95 -0
  71. package/dist/db/migrate.d.ts +24 -0
  72. package/dist/db/migrate.d.ts.map +1 -0
  73. package/dist/db/migrate.js +237 -0
  74. package/dist/db/recovery.d.ts +11 -0
  75. package/dist/db/recovery.d.ts.map +1 -0
  76. package/dist/db/recovery.js +38 -0
  77. package/dist/db/schema.d.ts +24 -0
  78. package/dist/db/schema.d.ts.map +1 -0
  79. package/dist/db/schema.js +97 -0
  80. package/dist/db/settings-repo.d.ts +8 -0
  81. package/dist/db/settings-repo.d.ts.map +1 -0
  82. package/dist/db/settings-repo.js +27 -0
  83. package/dist/db/tasks-repo.d.ts +26 -0
  84. package/dist/db/tasks-repo.d.ts.map +1 -0
  85. package/dist/db/tasks-repo.js +120 -0
  86. package/dist/db/templates-repo.d.ts +17 -0
  87. package/dist/db/templates-repo.d.ts.map +1 -0
  88. package/dist/db/templates-repo.js +57 -0
  89. package/dist/history.d.ts +53 -0
  90. package/dist/history.d.ts.map +1 -0
  91. package/dist/history.js +57 -0
  92. package/dist/index.d.ts +156 -0
  93. package/dist/index.d.ts.map +1 -0
  94. package/dist/index.js +2159 -0
  95. package/dist/notifications.d.ts +45 -0
  96. package/dist/notifications.d.ts.map +1 -0
  97. package/dist/notifications.js +135 -0
  98. package/dist/rpc.d.ts +2186 -0
  99. package/dist/rpc.d.ts.map +1 -0
  100. package/dist/rpc.js +924 -0
  101. package/dist/schtasks.d.ts +32 -0
  102. package/dist/schtasks.d.ts.map +1 -0
  103. package/dist/schtasks.js +45 -0
  104. package/dist/server.d.ts +106 -0
  105. package/dist/server.d.ts.map +1 -0
  106. package/dist/server.js +1668 -0
  107. package/dist/settings.d.ts +66 -0
  108. package/dist/settings.d.ts.map +1 -0
  109. package/dist/settings.js +137 -0
  110. package/dist/shared/jobs-view.d.ts +21 -0
  111. package/dist/shared/jobs-view.d.ts.map +1 -0
  112. package/dist/shared/jobs-view.js +28 -0
  113. package/dist/skill.d.ts +15 -0
  114. package/dist/skill.d.ts.map +1 -0
  115. package/dist/skill.js +93 -0
  116. package/dist/task-transfer.d.ts +176 -0
  117. package/dist/task-transfer.d.ts.map +1 -0
  118. package/dist/task-transfer.js +442 -0
  119. package/dist/templates.d.ts +57 -0
  120. package/dist/templates.d.ts.map +1 -0
  121. package/dist/templates.js +16 -0
  122. package/dist/types.d.ts +78 -0
  123. package/dist/types.d.ts.map +1 -0
  124. package/dist/types.js +88 -0
  125. package/dist/version.d.ts +8 -0
  126. package/dist/version.d.ts.map +1 -0
  127. package/dist/version.js +27 -0
  128. package/dist/workspaces.d.ts +55 -0
  129. package/dist/workspaces.d.ts.map +1 -0
  130. package/dist/workspaces.js +183 -0
  131. package/docs/ARCHITECTURE.md +314 -0
  132. package/docs/FEATURES.md +300 -0
  133. package/docs/MIGRATION.md +266 -0
  134. package/docs/dashboard.png +0 -0
  135. package/gui-experimental.cjs +2 -0
  136. package/index.js +1 -0
  137. package/package.json +94 -4
  138. package/scripts/demo-dashboard.mjs +199 -0
  139. package/skills/scheduled-job-best-practices/SKILL.md +155 -0
  140. package/skills/scheduled-job-best-practices/references/recipes.md +123 -0
  141. package/src/core/analytics.ts +378 -0
  142. package/src/core/cron-to-schtasks.ts +269 -0
  143. package/src/core/dry-run.ts +315 -0
  144. package/src/core/file-watcher.ts +171 -0
  145. package/src/core/lock.ts +134 -0
  146. package/src/core/matrix.ts +907 -0
  147. package/src/core/ps-wrapper.ts +572 -0
  148. package/src/core/record-history.ts +493 -0
  149. package/src/core/retention.ts +141 -0
  150. package/src/core/scheduler/index.ts +44 -0
  151. package/src/core/scheduler/linux.ts +125 -0
  152. package/src/core/scheduler/logs.ts +37 -0
  153. package/src/core/scheduler/mac.ts +222 -0
  154. package/src/core/scheduler/posix.ts +111 -0
  155. package/src/core/scheduler/registry.ts +93 -0
  156. package/src/core/scheduler/types.ts +67 -0
  157. package/src/core/scheduler/windows.ts +469 -0
  158. package/src/core/wrappers/bash.ts +282 -0
  159. package/src/db/history-repo.ts +396 -0
  160. package/src/db/index.ts +166 -0
  161. package/src/db/metrics-repo.ts +158 -0
  162. package/src/db/migrate.ts +322 -0
  163. package/src/db/recovery.ts +46 -0
  164. package/src/db/schema.ts +109 -0
  165. package/src/db/settings-repo.ts +31 -0
  166. package/src/db/tasks-repo.ts +162 -0
  167. package/src/db/templates-repo.ts +77 -0
  168. package/src/gui.tsx +2868 -0
  169. package/src/history.ts +107 -0
  170. package/src/index.ts +2768 -0
  171. package/src/notifications.ts +174 -0
  172. package/src/rpc.ts +999 -0
  173. package/src/schtasks.ts +75 -0
  174. package/src/server.ts +1879 -0
  175. package/src/settings.ts +228 -0
  176. package/src/shared/jobs-view.ts +38 -0
  177. package/src/skill.ts +113 -0
  178. package/src/task-transfer.ts +648 -0
  179. package/src/templates.ts +67 -0
  180. package/src/tui.tsx +46 -0
  181. package/src/types.ts +145 -0
  182. package/src/version.ts +27 -0
  183. package/src/workspaces.ts +236 -0
@@ -0,0 +1,217 @@
1
+ # 🎯 Стратегический роадмап — opencode-windows-scheduler
2
+
3
+ > Цель: **стать лучшим планировщиком/оркестратором для OpenCode, оставаясь бесплатным и open source.**
4
+ > Основано на аудите плагина (ноябрь 2026). Тактический спринт-план — в [ROADMAP.md](./ROADMAP.md).
5
+
6
+ ---
7
+
8
+ ## Позиционирование
9
+
10
+ **Мы не «cron для OpenCode». Мы — локальная платформа оркестрации AI-задач:**
11
+ расписание + зависимости (DAG) + матрицы (fan-out) + политики качества + наблюдаемость.
12
+
13
+ | Принцип | Что это значит на практике |
14
+ |---|---|
15
+ | **Бесплатно навсегда** | MIT, без SaaS, без телеметрии, без «pro»-функций за деньги |
16
+ | **Локально по умолчанию** | Данные, история и логи — на машине пользователя, без облака |
17
+ | **Open source-first** | Публичный roadmap, good-first-issues, CI на 3 ОС, англоязычная документация |
18
+ | **Оркестрация, а не таймер** | Ров — DAG, матрицы, политики, дашборд. Cron — commodity, его скопируют |
19
+
20
+ **Текущая точка:** функционально сильнее всех в экосистеме, но:
21
+ - нет LICENSE / npm / CI / английского README → нас не находят;
22
+ - агент видит 4 инструмента из ~30 RPC-методов (~35–40% функционала);
23
+ - нет table stakes: one-shot, session continuity, guard, worktree, декларативные job-файлы, TUI.
24
+
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/БД):
54
+
55
+ - [x] `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`.
56
+ - [x] `nextTaskOnSuccess`, `nextTaskOnError`.
57
+ - [x] `matrix.concurrency`, `matrix.overrides`.
58
+ - [x] Английские `description` инструментов в схемах и при регистрации.
59
+
60
+ **Готово, когда:** агентом можно создать задачу с QG, DAG, retry и матрицей с лимитом — без GUI.
61
+
62
+ ### 0.4 Паритет агента — часть 2: новые инструменты (3–4 дня)
63
+
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 в одном инструменте.
70
+
71
+ **Готово, когда:** покрытие RPC-поверхности инструментами агента = 100% (кроме чисто-GUI настроек).
72
+
73
+ ### 0.5 Native skill для агента (1–2 дня)
74
+
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-пакет.
79
+
80
+ **Готово, когда:** агент, получив задачу «настрой автоматизацию», сам выбирает правильный паттерн и безопасные настройки.
81
+
82
+ ### 0.6 Документация (2 дня)
83
+
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`).
88
+
89
+ **Итог горизонта:** продукт находится, устанавливается одной командой, агент умеет всё, документация на английском.
90
+
91
+ ---
92
+
93
+ ## Горизонт 1–2 месяца: закрыть table stakes
94
+
95
+ > Базовые сценарии, которые ожидают от планировщика. Без них мы «мощнее, но неудобнее».
96
+
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`.
101
+
102
+ ### 1.2 Session continuity (4–5 дней)
103
+ - Режимы `session: "new" | "reuse" | "last"`; хранение `sessionId` у задачи.
104
+ - Наследование `agent`/`model` из сессии (как у pan17), опционально.
105
+ - Очистка/компакция сессии по политике.
106
+
107
+ ### 1.3 Guard-условия (2–3 дня)
108
+ - `guard?: string` — shell-команда; ненулевой код = пропуск запуска.
109
+ - Статус `skipped` с причиной в истории; не влияет на DAG-зависимых.
110
+ - Примеры: «только если есть изменения», «только если CI зелёный».
111
+
112
+ ### 1.4 Worktree-изоляция (3–4 дня)
113
+ - `worktree: true` — одноразовый `git worktree` на запуск, базовый ref настраивается.
114
+ - Политика очистки (успех/ошибка/через N дней), защита от незакоммиченных изменений.
115
+ - Отображение в истории: путь worktree, ветка/ref.
116
+
117
+ ### 1.5 Декларативные job-файлы (5–6 дней)
118
+ - Source of truth: `.opencode/scheduler/*.json` (или `.yaml` без новых зависимостей — JSON).
119
+ - Синхронизация при активации плагина + file-watcher; конфликты — в лог/историю.
120
+ - `export`/`init` в репозиторий; git-committable, ревью через PR.
121
+
122
+ ### 1.6 TUI-центр задач (5–6 дней)
123
+ - Список задач со статусами, группировка матриц, run/pause/resume, хвост логов.
124
+ - Замена 46-строчной заглушки `src/tui.tsx`; навигация с клавиатуры.
125
+
126
+ ### 1.7 Per-task permissions (4–5 дней)
127
+ - Модель `action / resource / effect` либо строгая реализация текущих `allowedTools`/`deniedTools`.
128
+ - Реальное применение на уровне исполнения, аудит-лог решений.
129
+
130
+ **Готово, когда:** базовые сценарии (one-shot, reuse session, guard, worktree, md/json в репо, TUI) закрыты; `npm test` и CI зелёные; документация обновлена.
131
+
132
+ ---
133
+
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).
155
+
156
+ ### 2.5 Интеграции и наблюдаемость
157
+ - Входящий webhook-триггер `POST /api/hooks/:task` с HMAC — запуск из GitHub Actions/GitLab CI.
158
+ - Prometheus `/metrics`, JSONL-логи, экспорт истории в OpenTelemetry.
159
+ - Плагин-хуки: `beforeRun`/`afterRun` для расширений сообщества.
160
+
161
+ ### 2.6 Сообщество и устойчивость
162
+ - `good-first-issue`, discussions, «awesome-recipes», шаблоны задач.
163
+ - Semver, changelog, процесс релизов, ответ на issues ≤ 72 ч.
164
+ - Русская и английская документация синхронно.
165
+
166
+ ---
167
+
168
+ ## Метрики успеха
169
+
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) |
195
+
196
+ ---
197
+
198
+ ## Риски и триггеры пересмотра
199
+
200
+ | Риск | Триггер пересмотра | Ответ |
201
+ |---|---|---|
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 инструментов и ошибок |
206
+
207
+ ---
208
+
209
+ ## Что делаем на этой неделе
210
+
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).
216
+
217
+ **Критерий недели:** пользователь ставит плагин из npm одной командой, CI зелёный, а агент может создать и сопроводить задачу с Quality Gate и зависимостями без GUI.
package/ROADMAP.md ADDED
@@ -0,0 +1,90 @@
1
+ # 🗺️ Roadmap — opencode-windows-scheduler
2
+
3
+ План развития плагина. Тактический спринт-план; стратегические приоритеты — в [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
4
+
5
+ > **Важно:** согласно стратегическому роадмапу (после аудита плагина) перед Спринтом 18 идут два внеплановых спринта:
6
+ > **17.5 — OSS-упаковка** (LICENSE, npm, CI, английский README) и **17.6 — Паритет агента** (полный доступ к функционалу через инструменты). Детали — в `ROADMAP-STRATEGY.md`.
7
+
8
+ ## Сделано (Спринты 1–16)
9
+
10
+ | # | Тема | Артефакты |
11
+ |---|---|---|
12
+ | 1–8 | Ядро: cron → schtasks, lock-файлы, таймауты, повторы, Quality Gate, цепочки (DAG), файловые триггеры, dry-run | `src/core/*`, `src/schtasks.ts` |
13
+ | 9 | SQLite-хранилище задач и истории | `src/db/*` |
14
+ | 10 | Восстановление после краха, незавершённые записи → error | `src/db/recovery.ts` |
15
+ | 11 | Лёгкие уведомления: webhook (Discord/Slack-совместимый) + тосты GUI | `src/notifications.ts`, `src/settings.ts` |
16
+ | 12 | Workspace-ы: отдельные директории задач, роль-скоуп tools | `src/workspaces.ts` |
17
+ | 13 | Дашборд (HTTP): задачи, история, dry-run, фильтры | `src/server.ts` |
18
+ | 14 | Экспорт/импорт задач, шаблоны | `src/task-transfer.ts`, `src/templates.ts` |
19
+ | 15 | Matrix Builds (fan-out): клоны по workspace, parallel/sequential, failureMode, агрегация, DAG | `src/core/matrix.ts`, `SPRINT15` в истории |
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
+
24
+ ## Спринт 17 — Синхронизация матриц + per-workspace настройки ✅ Готово
25
+
26
+ **Проблема:** после создания матрицы изменение `matrix.workspaceIds` (или промпта/хуков) в `update_task`/GUI не пересоздаёт клонов — семья рассинхронизируется, появляются устаревшие клоны. Плюс нельзя задать клону отличия от родителя (свой промпт, модель, QG).
27
+
28
+ **Объём:**
29
+ 1. `syncMatrixFamily(parent)` в `src/core/matrix.ts`:
30
+ - diff текущих клонов (по `matrixParentId`) и `expandMatrixTask(parent)`;
31
+ - удалить лишних (ОС + БД, терпимо), создать недостающих, обновить изменившихся (промпт/модель/хуки/QG/tools);
32
+ - обновить агрегатор (`ensureMatrixCompleteTask` / удалить, если `createAggregator` выключили);
33
+ - защита: не трогать клонов со статусом `running` (вернуть предупреждение).
34
+ 2. Вызвать `syncMatrixFamily` из `update_task` (RPC) и из `schedulerUpdateTask`, если определена матрица.
35
+ 3. Per-workspace overrides: `matrix.overrides?: Record<workspaceId, { prompt?, model?, qualityGate?, beforeScript?, afterScript? }>` — применяются в `expandMatrixTask`; валидация в `task-transfer.ts` (workspaceId должен входить в `workspaceIds`); round-trip экспорт/импорт.
36
+ 4. `matrix.concurrency?: number` — максимум одновременно работающих клонов матрицы (в дополнение к глобальному `maxConcurrent`): sequential = 1, parallel без значения = без лимита. Учёт в `runMatrix`/`advanceSequentialMatrix`.
37
+ 5. GUI: редактор overrides на workspace в матричном блоке, поле «параллелизм», превью с учётом overrides; дашборд — бейдж лимита.
38
+
39
+ **Готово, когда:**
40
+ - изменение `workspaceIds` (добавление/удаление/замена) корректно синхронизирует клонов и агрегатор;
41
+ - `running`-клоны не удаляются, возвращается предупреждение;
42
+ - overrides и `concurrency` проходят export/import round-trip;
43
+ - тесты: `test-matrix-sync.mjs` (≥15 проверок) + весь `npm test` зелёный.
44
+
45
+ **Ограничения на потом:** история удалённых при синхронизации клонов остаётся (чистится ретеншном — Спринт 18).
46
+
47
+ ## Спринт 18 — Ретеншн истории и аналитика ✅ Готово
48
+
49
+ Отчёт: `SPRINT18.md`. По факту:
50
+ 1. Настройки `history.retentionDays` / `history.maxRecords` в settings.json (дефолт 30 дней / 5000 записей, 0 — выкл.), автоочистка раз в сутки при старте плагина + `PRAGMA incremental_vacuum`; ручная кнопка «🧹 Очистить сейчас» и RPC `cleanup_history`. GUI: сворачиваемая секция «🧹 История и ретеншн».
51
+ 2. RPC: `cleanup_history` + отдельный `get_analytics` (`days` 1..365, `topLimit >= 1`): агрегаты по дням/задачам/моделям/матрицам, success rate, токены, стоимость. All-time RPC `get_metrics` оставлен как был — отдельное имя, см. SPRINT18.md (расхождение с этим пунктом).
52
+ 3. Дашборд: блок «📊 Аналитика за период» (KPI, график по дням, топ задач по стоимости, матрицы), экспорт истории в CSV/JSON (`/api/history/export?format=csv|json`).
53
+ 4. `/api/health`: `version` (из package.json), `scheduler`, `queueDepth` (незавершённые запуски), `db` (`getDbStatus()`). Статистику осиротевших задач health не отдаёт — сироты остаются в матричных инструментах (`matrix_control`).
54
+ 5. Тесты: `test-retention.mjs` (19 проверок) + `test-metrics.mjs` (25 проверок), оба в цепочке `npm test`.
55
+
56
+ ## Спринт 19 — Планирование 2.0 ⬅️ СЛЕДУЮЩИЙ
57
+
58
+ 1. `timezone` на задачу (IANA), корректный пересчёт cron → schtasks и в dry-run.
59
+ 2. Окна запуска: `notBefore` / `notAfter` (например, деплой только 22:00–06:00) — перенос запуска, а не пропуск.
60
+ 3. Расширенный cron: `@every 15m`, `L` (последний день месяца), `#` (N-й день недели).
61
+ 4. Пауза до даты (`pausedUntil`) с автопродолжением.
62
+ 5. Тесты: `test-schedule-v2.mjs` (включая DST и переходы суток).
63
+
64
+ ## Спринт 20 — Уведомления v2
65
+
66
+ 1. Дайджест (ежедневный/еженедельный): сколько запусков, success rate, стоимость, топ ошибок.
67
+ 2. Уведомления о матрицах: `partial`, «матрица зависла» (клоны running дольше N минут), «все клоны упали».
68
+ 3. Настраиваемые шаблоны сообщений + отдельные фильтры по задачам.
69
+ 4. Повтор отправки при сетевой ошибке (backoff), таймаут webhook.
70
+ 5. **ntfy.sh не реализуем** (исключён заданием), каналы: webhook + тосты.
71
+
72
+ ## Спринт 21 — Мультипроектность
73
+
74
+ 1. Профили (`default`, `work`, …): отдельные БД/настройки/дашборд-порт.
75
+ 2. Группировка задач по проекту в GUI/дашборде, переключение профиля.
76
+ 3. Env-переменные на workspace (`.env`-файл или пары ключ-значение) с маскировкой секретов в логах.
77
+ 4. Тесты: `test-profiles.mjs`, `test-env.mjs`.
78
+
79
+ ## Спринт 22 — Интеграции и наблюдаемость
80
+
81
+ 1. Входящий webhook-триггер: `POST /api/hooks/:task?token=…` (HMAC-подпись) — запуск из GitHub Actions/GitLab CI.
82
+ 2. Structured logs (JSONL) + `/api/logs` с фильтрами.
83
+ 3. Метрики в формате Prometheus (`/metrics`): запуски, длительность, ошибки, очередь.
84
+ 4. Экспорт истории в OpenTelemetry-совместимом виде (опционально).
85
+
86
+ ## Правила спринта (не меняются)
87
+
88
+ - Без новых зависимостей, Node 24, `npm run build` + `npm run build:gui` обязательны.
89
+ - Каждый спринт: новый `test-*.mjs` в цепочку `npm test`, отчёт `SPRINT<n>.md`.
90
+ - Обратная совместимость: старые `tasks.json`/экспорт читаются без миграции пользователем.
@@ -0,0 +1,119 @@
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
+ export interface AnalyticsReport {
68
+ generatedAt: string;
69
+ /** Окно анализа в днях. */
70
+ windowDays: number;
71
+ totals: {
72
+ total: number;
73
+ success: number;
74
+ error: number;
75
+ partial: number;
76
+ successRate: number;
77
+ avgDurationMs: number;
78
+ tokens: number;
79
+ costUsd: number;
80
+ };
81
+ daily: DailyBucket[];
82
+ tasks: TaskAnalyticsRow[];
83
+ topByCost: TaskAnalyticsRow[];
84
+ matrices: MatrixAnalyticsRow[];
85
+ byModel: ModelAnalyticsRow[];
86
+ sources: {
87
+ historyRecords: number;
88
+ /** Сколько записей попало в окно. */
89
+ recordsInWindow: number;
90
+ /** Ограничение по количеству строк в топах. */
91
+ topLimit: number;
92
+ };
93
+ }
94
+ export interface BuildAnalyticsOptions {
95
+ /** Окно анализа в днях (по умолчанию 14). */
96
+ days?: number;
97
+ /** Опорный момент (для тестов). */
98
+ now?: Date;
99
+ /** Сколько строк оставлять в топах (по умолчанию 10). */
100
+ topLimit?: number;
101
+ /** Известные задачи — нужны для группировки матриц. */
102
+ tasks?: AnalyticsTaskRef[];
103
+ }
104
+ /** Стоимость записи: явная цена, иначе оценка по токенам. */
105
+ export declare function recordCost(record: AnalyticsRecord): number;
106
+ /** Дата записи в UTC-формате YYYY-MM-DD. */
107
+ export declare function recordDate(record: AnalyticsRecord): string;
108
+ /**
109
+ * Строит отчёт по истории: итоги, дневные бакеты, разбивка по задачам,
110
+ * матрицам и моделям.
111
+ */
112
+ export declare function buildAnalytics(records: AnalyticsRecord[], options?: BuildAnalyticsOptions): AnalyticsReport;
113
+ /** Экранирование значения для CSV (RFC 4180). */
114
+ export declare function csvCell(value: unknown): string;
115
+ /** Заголовок CSV-экспорта истории. */
116
+ export declare const HISTORY_CSV_HEADER: readonly ["startedAt", "finishedAt", "taskName", "status", "durationMs", "tokens", "costUsd", "model", "workspaceId", "error"];
117
+ /** История в CSV: точки с запятой как разделитель — дружелюбно к Excel (RU). */
118
+ export declare function historyToCsv(records: AnalyticsRecord[]): string;
119
+ //# 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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"}