opencode-windows-scheduler 0.0.0-stage → 1.0.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 +45 -0
- package/CROSS_PLATFORM.md +113 -0
- package/LICENSE +21 -0
- package/README.md +173 -2
- package/README.ru.md +131 -0
- package/ROADMAP-STRATEGY.md +217 -0
- package/ROADMAP.md +87 -0
- package/dist/core/cron-to-schtasks.d.ts +20 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +233 -0
- package/dist/core/dry-run.d.ts +44 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +252 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +128 -0
- package/dist/core/lock.d.ts +43 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +118 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +687 -0
- package/dist/core/ps-wrapper.d.ts +60 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +538 -0
- package/dist/core/record-history.d.ts +14 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +360 -0
- package/dist/core/scheduler/index.d.ts +20 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +32 -0
- package/dist/core/scheduler/linux.d.ts +32 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +115 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +39 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +175 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +86 -0
- package/dist/core/scheduler/registry.d.ts +36 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +56 -0
- package/dist/core/scheduler/types.d.ts +63 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +47 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +375 -0
- package/dist/core/wrappers/bash.d.ts +58 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +223 -0
- package/dist/db/history-repo.d.ts +69 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +150 -0
- package/dist/db/index.d.ts +47 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +120 -0
- package/dist/db/metrics-repo.d.ts +43 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +95 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +237 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -0
- package/dist/db/schema.d.ts +24 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +97 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/gui-experimental.cjs +1 -0
- package/dist/history.d.ts +53 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +57 -0
- package/dist/index.d.ts +156 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2077 -0
- package/dist/notifications.d.ts +45 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +135 -0
- package/dist/rpc.d.ts +2052 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +863 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +106 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +1478 -0
- package/dist/settings.d.ts +43 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +96 -0
- package/dist/shared/jobs-view.d.ts +21 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +28 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +176 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +442 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +78 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +88 -0
- package/dist/workspaces.d.ts +55 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +183 -0
- package/docs/ARCHITECTURE.md +302 -0
- package/docs/FEATURES.md +288 -0
- package/docs/MIGRATION.md +266 -0
- package/docs/dashboard.png +0 -0
- package/gui-experimental.cjs +2 -0
- package/index.js +1 -0
- package/package.json +92 -4
- package/scripts/demo-dashboard.mjs +199 -0
- package/skills/scheduled-job-best-practices/SKILL.md +155 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +123 -0
- package/src/core/cron-to-schtasks.ts +269 -0
- package/src/core/dry-run.ts +315 -0
- package/src/core/file-watcher.ts +171 -0
- package/src/core/lock.ts +134 -0
- package/src/core/matrix.ts +907 -0
- package/src/core/ps-wrapper.ts +572 -0
- package/src/core/record-history.ts +493 -0
- package/src/core/scheduler/index.ts +44 -0
- package/src/core/scheduler/linux.ts +125 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +222 -0
- package/src/core/scheduler/posix.ts +111 -0
- package/src/core/scheduler/registry.ts +93 -0
- package/src/core/scheduler/types.ts +67 -0
- package/src/core/scheduler/windows.ts +469 -0
- package/src/core/wrappers/bash.ts +282 -0
- package/src/db/history-repo.ts +303 -0
- package/src/db/index.ts +166 -0
- package/src/db/metrics-repo.ts +158 -0
- package/src/db/migrate.ts +322 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/schema.ts +109 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +2725 -0
- package/src/history.ts +107 -0
- package/src/index.ts +2672 -0
- package/src/notifications.ts +174 -0
- package/src/rpc.ts +933 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +1663 -0
- package/src/settings.ts +157 -0
- package/src/shared/jobs-view.ts +38 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +648 -0
- package/src/templates.ts +67 -0
- package/src/tui.tsx +46 -0
- package/src/types.ts +145 -0
- 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,87 @@
|
|
|
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
|
+
|
|
22
|
+
## Спринт 17 — Синхронизация матриц + per-workspace настройки ⬅️ СЛЕДУЮЩИЙ
|
|
23
|
+
|
|
24
|
+
**Проблема:** после создания матрицы изменение `matrix.workspaceIds` (или промпта/хуков) в `update_task`/GUI не пересоздаёт клонов — семья рассинхронизируется, появляются устаревшие клоны. Плюс нельзя задать клону отличия от родителя (свой промпт, модель, QG).
|
|
25
|
+
|
|
26
|
+
**Объём:**
|
|
27
|
+
1. `syncMatrixFamily(parent)` в `src/core/matrix.ts`:
|
|
28
|
+
- diff текущих клонов (по `matrixParentId`) и `expandMatrixTask(parent)`;
|
|
29
|
+
- удалить лишних (ОС + БД, терпимо), создать недостающих, обновить изменившихся (промпт/модель/хуки/QG/tools);
|
|
30
|
+
- обновить агрегатор (`ensureMatrixCompleteTask` / удалить, если `createAggregator` выключили);
|
|
31
|
+
- защита: не трогать клонов со статусом `running` (вернуть предупреждение).
|
|
32
|
+
2. Вызвать `syncMatrixFamily` из `update_task` (RPC) и из `schedulerUpdateTask`, если определена матрица.
|
|
33
|
+
3. Per-workspace overrides: `matrix.overrides?: Record<workspaceId, { prompt?, model?, qualityGate?, beforeScript?, afterScript? }>` — применяются в `expandMatrixTask`; валидация в `task-transfer.ts` (workspaceId должен входить в `workspaceIds`); round-trip экспорт/импорт.
|
|
34
|
+
4. `matrix.concurrency?: number` — максимум одновременно работающих клонов матрицы (в дополнение к глобальному `maxConcurrent`): sequential = 1, parallel без значения = без лимита. Учёт в `runMatrix`/`advanceSequentialMatrix`.
|
|
35
|
+
5. GUI: редактор overrides на workspace в матричном блоке, поле «параллелизм», превью с учётом overrides; дашборд — бейдж лимита.
|
|
36
|
+
|
|
37
|
+
**Готово, когда:**
|
|
38
|
+
- изменение `workspaceIds` (добавление/удаление/замена) корректно синхронизирует клонов и агрегатор;
|
|
39
|
+
- `running`-клоны не удаляются, возвращается предупреждение;
|
|
40
|
+
- overrides и `concurrency` проходят export/import round-trip;
|
|
41
|
+
- тесты: `test-matrix-sync.mjs` (≥15 проверок) + весь `npm test` зелёный.
|
|
42
|
+
|
|
43
|
+
**Ограничения на потом:** история удалённых при синхронизации клонов остаётся (чистится ретеншном — Спринт 18).
|
|
44
|
+
|
|
45
|
+
## Спринт 18 — Ретеншн истории и аналитика
|
|
46
|
+
|
|
47
|
+
1. Настройки ретеншна: `history.retentionDays`, `history.maxRecords`, ежедневная автоочистка + `PRAGMA incremental_vacuum`.
|
|
48
|
+
2. RPC/CLI: `cleanup_history`, `get_metrics` (агрегаты по задачам/матрицам: запуски, success rate, средняя длительность, токены, стоимость).
|
|
49
|
+
3. Дашборд: вкладка «📊 Аналитика» (топ задач по стоимости, success rate, график по дням), экспорт истории в CSV/JSON.
|
|
50
|
+
4. `/api/health` для внешнего мониторинга (БД, планировщик, осиротевшие задачи).
|
|
51
|
+
5. Тесты: `test-retention.mjs`, `test-metrics.mjs`.
|
|
52
|
+
|
|
53
|
+
## Спринт 19 — Планирование 2.0
|
|
54
|
+
|
|
55
|
+
1. `timezone` на задачу (IANA), корректный пересчёт cron → schtasks и в dry-run.
|
|
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 и переходы суток).
|
|
60
|
+
|
|
61
|
+
## Спринт 20 — Уведомления v2
|
|
62
|
+
|
|
63
|
+
1. Дайджест (ежедневный/еженедельный): сколько запусков, success rate, стоимость, топ ошибок.
|
|
64
|
+
2. Уведомления о матрицах: `partial`, «матрица зависла» (клоны running дольше N минут), «все клоны упали».
|
|
65
|
+
3. Настраиваемые шаблоны сообщений + отдельные фильтры по задачам.
|
|
66
|
+
4. Повтор отправки при сетевой ошибке (backoff), таймаут webhook.
|
|
67
|
+
5. **ntfy.sh не реализуем** (исключён заданием), каналы: webhook + тосты.
|
|
68
|
+
|
|
69
|
+
## Спринт 21 — Мультипроектность
|
|
70
|
+
|
|
71
|
+
1. Профили (`default`, `work`, …): отдельные БД/настройки/дашборд-порт.
|
|
72
|
+
2. Группировка задач по проекту в GUI/дашборде, переключение профиля.
|
|
73
|
+
3. Env-переменные на workspace (`.env`-файл или пары ключ-значение) с маскировкой секретов в логах.
|
|
74
|
+
4. Тесты: `test-profiles.mjs`, `test-env.mjs`.
|
|
75
|
+
|
|
76
|
+
## Спринт 22 — Интеграции и наблюдаемость
|
|
77
|
+
|
|
78
|
+
1. Входящий webhook-триггер: `POST /api/hooks/:task?token=…` (HMAC-подпись) — запуск из GitHub Actions/GitLab CI.
|
|
79
|
+
2. Structured logs (JSONL) + `/api/logs` с фильтрами.
|
|
80
|
+
3. Метрики в формате Prometheus (`/metrics`): запуски, длительность, ошибки, очередь.
|
|
81
|
+
4. Экспорт истории в OpenTelemetry-совместимом виде (опционально).
|
|
82
|
+
|
|
83
|
+
## Правила спринта (не меняются)
|
|
84
|
+
|
|
85
|
+
- Без новых зависимостей, Node 24, `npm run build` + `npm run build:gui` обязательны.
|
|
86
|
+
- Каждый спринт: новый `test-*.mjs` в цепочку `npm test`, отчёт `SPRINT<n>.md`.
|
|
87
|
+
- Обратная совместимость: старые `tasks.json`/экспорт читаются без миграции пользователем.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { CronConversion } from "../types.js";
|
|
2
|
+
/**
|
|
3
|
+
* Валидирует и преобразует 5-полевое cron-выражение во флаги schtasks.
|
|
4
|
+
* Возвращает CronConversion или выбрасывает Error с понятным сообщением.
|
|
5
|
+
*/
|
|
6
|
+
export declare function convertCronToSchTasks(cron: string): CronConversion;
|
|
7
|
+
/**
|
|
8
|
+
* Вычисляет ближайшее прошедшее (<= now) время срабатывания для поддерживаемых
|
|
9
|
+
* cron-выражений. Нужно для восстановления пропущенных запусков (catch-up):
|
|
10
|
+
* сравнивая это время с историей, можно понять, выполнялась ли задача.
|
|
11
|
+
*
|
|
12
|
+
* Возвращает null, если выражение не поддерживается или не распознано.
|
|
13
|
+
*/
|
|
14
|
+
export declare function previousRunTime(cron: string, now?: Date): Date | null;
|
|
15
|
+
/**
|
|
16
|
+
* Формирует массив флагов расписания для schtasks на основе CronConversion.
|
|
17
|
+
* Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
|
|
18
|
+
*/
|
|
19
|
+
export declare function buildScheduleFlags(conversion: CronConversion): string[];
|
|
20
|
+
//# sourceMappingURL=cron-to-schtasks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cron-to-schtasks.d.ts","sourceRoot":"","sources":["../../src/core/cron-to-schtasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4DlD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA0GlE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,GAAG,IAAI,CAyEjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,EAAE,CAUvE"}
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Сообщение об ошибке, возвращаемое при встрече неподдерживаемого cron-выражения.
|
|
3
|
+
* Содержит описание поддерживаемого подмножества.
|
|
4
|
+
* Собрано конкатенацией, чтобы избежать последовательности закрывающего комментария внутри строк.
|
|
5
|
+
*/
|
|
6
|
+
const UNSUPPORTED_ERROR = "Неподдерживаемое cron-выражение.\n" +
|
|
7
|
+
"\n" +
|
|
8
|
+
"Поддерживаемое подмножество cron (5 полей: минута час день_месяца месяц день_недели):\n" +
|
|
9
|
+
" * * * * * -> MINUTE, каждую минуту (/mo 1)\n" +
|
|
10
|
+
" */N * * * * -> MINUTE, каждые N минут (/mo N)\n" +
|
|
11
|
+
" M H * * * -> DAILY, ежедневно в HH:MM (/st HH:MM)\n" +
|
|
12
|
+
" M H * * D -> WEEKLY, по неделям в день D в HH:MM (/d D /st HH:MM)\n" +
|
|
13
|
+
"\n" +
|
|
14
|
+
"Не поддерживаются: диапазоны (1-5), списки (1,2,3), комбинации месяца и дня недели,\n" +
|
|
15
|
+
"*/N на месяце или дне недели, а также любые другие сложные выражения.\n" +
|
|
16
|
+
"Пожалуйста, упростите расписание, используя одно из поддерживаемых выше выражений.";
|
|
17
|
+
/** Дни недели для schtasks /d (0 и 7 = воскресенье). */
|
|
18
|
+
const DAY_OF_WEEK_MAP = {
|
|
19
|
+
"0": "SUN",
|
|
20
|
+
"1": "MON",
|
|
21
|
+
"2": "TUE",
|
|
22
|
+
"3": "WED",
|
|
23
|
+
"4": "THU",
|
|
24
|
+
"5": "FRI",
|
|
25
|
+
"6": "SAT",
|
|
26
|
+
"7": "SUN",
|
|
27
|
+
};
|
|
28
|
+
/**
|
|
29
|
+
* Проверяет, является ли строка звездочкой "*".
|
|
30
|
+
*/
|
|
31
|
+
function isStar(value) {
|
|
32
|
+
return value === "*";
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Проверяет, является ли строка шаблоном звездочка-слэш-N (N — положительное целое).
|
|
36
|
+
* Возвращает N или undefined.
|
|
37
|
+
*/
|
|
38
|
+
function parseStep(value) {
|
|
39
|
+
const match = value.match(/^\*\/(\d+)$/);
|
|
40
|
+
if (!match)
|
|
41
|
+
return undefined;
|
|
42
|
+
const n = parseInt(match[1], 10);
|
|
43
|
+
return n > 0 ? n : undefined;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Проверяет, является ли строка одиночным целым числом в диапазоне [min, max].
|
|
47
|
+
* Возвращает число или undefined.
|
|
48
|
+
*/
|
|
49
|
+
function parseIntInRange(value, min, max) {
|
|
50
|
+
if (!/^\d+$/.test(value))
|
|
51
|
+
return undefined;
|
|
52
|
+
const n = parseInt(value, 10);
|
|
53
|
+
return n >= min && n <= max ? n : undefined;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Валидирует и преобразует 5-полевое cron-выражение во флаги schtasks.
|
|
57
|
+
* Возвращает CronConversion или выбрасывает Error с понятным сообщением.
|
|
58
|
+
*/
|
|
59
|
+
export function convertCronToSchTasks(cron) {
|
|
60
|
+
const fields = cron.trim().split(/\s+/);
|
|
61
|
+
if (fields.length !== 5) {
|
|
62
|
+
throw new Error("Ожидалось 5 полей cron-выражения (минута час день_месяца месяц день_недели), получено " +
|
|
63
|
+
fields.length +
|
|
64
|
+
".\n\n" +
|
|
65
|
+
UNSUPPORTED_ERROR);
|
|
66
|
+
}
|
|
67
|
+
const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
|
|
68
|
+
// --- ПАТТЕРН 1: * * * * * -> MINUTE /mo 1 ---
|
|
69
|
+
if (isStar(minute) &&
|
|
70
|
+
isStar(hour) &&
|
|
71
|
+
isStar(dayOfMonth) &&
|
|
72
|
+
isStar(month) &&
|
|
73
|
+
isStar(dayOfWeek)) {
|
|
74
|
+
return {
|
|
75
|
+
sc: "MINUTE",
|
|
76
|
+
extraFlags: ["/mo", "1"],
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
// --- ПАТТЕРН 2: */N * * * * -> MINUTE /mo N ---
|
|
80
|
+
const stepN = parseStep(minute);
|
|
81
|
+
if (stepN !== undefined &&
|
|
82
|
+
isStar(hour) &&
|
|
83
|
+
isStar(dayOfMonth) &&
|
|
84
|
+
isStar(month) &&
|
|
85
|
+
isStar(dayOfWeek)) {
|
|
86
|
+
if (stepN > 1439) {
|
|
87
|
+
throw new Error("Интервал /mo " +
|
|
88
|
+
stepN +
|
|
89
|
+
" минут превышает максимально допустимый для schtasks (1439 минут).\n\n" +
|
|
90
|
+
UNSUPPORTED_ERROR);
|
|
91
|
+
}
|
|
92
|
+
return {
|
|
93
|
+
sc: "MINUTE",
|
|
94
|
+
extraFlags: ["/mo", String(stepN)],
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
// --- ПАТТЕРН 3: M * * * * -> HOURLY /mo 1 /st 00:MM (каждый час в минуту M) ---
|
|
98
|
+
const mHourly = parseIntInRange(minute, 0, 59);
|
|
99
|
+
if (mHourly !== undefined &&
|
|
100
|
+
isStar(hour) &&
|
|
101
|
+
isStar(dayOfMonth) &&
|
|
102
|
+
isStar(month) &&
|
|
103
|
+
isStar(dayOfWeek)) {
|
|
104
|
+
return {
|
|
105
|
+
sc: "HOURLY",
|
|
106
|
+
extraFlags: ["/mo", "1"],
|
|
107
|
+
startTime: "00:" + String(mHourly).padStart(2, "0"),
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
// --- ПАТТЕРН 4: M H * * * -> DAILY /st HH:MM ---
|
|
111
|
+
const m = parseIntInRange(minute, 0, 59);
|
|
112
|
+
const h = parseIntInRange(hour, 0, 23);
|
|
113
|
+
if (m !== undefined &&
|
|
114
|
+
h !== undefined &&
|
|
115
|
+
isStar(dayOfMonth) &&
|
|
116
|
+
isStar(month) &&
|
|
117
|
+
isStar(dayOfWeek)) {
|
|
118
|
+
const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
|
|
119
|
+
return {
|
|
120
|
+
sc: "DAILY",
|
|
121
|
+
extraFlags: [],
|
|
122
|
+
startTime,
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
// --- ПАТТЕРН 4: M H * * D -> WEEKLY /d D /st HH:MM ---
|
|
126
|
+
const d = parseIntInRange(dayOfWeek, 0, 7);
|
|
127
|
+
if (m !== undefined &&
|
|
128
|
+
h !== undefined &&
|
|
129
|
+
isStar(dayOfMonth) &&
|
|
130
|
+
isStar(month) &&
|
|
131
|
+
d !== undefined) {
|
|
132
|
+
const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
|
|
133
|
+
const dayName = DAY_OF_WEEK_MAP[String(d)];
|
|
134
|
+
return {
|
|
135
|
+
sc: "WEEKLY",
|
|
136
|
+
extraFlags: ["/d", dayName],
|
|
137
|
+
startTime,
|
|
138
|
+
days: dayName,
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
// Ни один поддерживаемый паттерн не совпал.
|
|
142
|
+
throw new Error(UNSUPPORTED_ERROR);
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* Вычисляет ближайшее прошедшее (<= now) время срабатывания для поддерживаемых
|
|
146
|
+
* cron-выражений. Нужно для восстановления пропущенных запусков (catch-up):
|
|
147
|
+
* сравнивая это время с историей, можно понять, выполнялась ли задача.
|
|
148
|
+
*
|
|
149
|
+
* Возвращает null, если выражение не поддерживается или не распознано.
|
|
150
|
+
*/
|
|
151
|
+
export function previousRunTime(cron, now = new Date()) {
|
|
152
|
+
const fields = cron.trim().split(/\s+/);
|
|
153
|
+
if (fields.length !== 5)
|
|
154
|
+
return null;
|
|
155
|
+
const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
|
|
156
|
+
const star = (value) => value === "*";
|
|
157
|
+
const intIn = (value, min, max) => {
|
|
158
|
+
if (!/^\d+$/.test(value))
|
|
159
|
+
return undefined;
|
|
160
|
+
const n = parseInt(value, 10);
|
|
161
|
+
return n >= min && n <= max ? n : undefined;
|
|
162
|
+
};
|
|
163
|
+
const nowMs = now.getTime();
|
|
164
|
+
// * * * * * — каждую минуту: последняя граница минуты.
|
|
165
|
+
if (star(minute) && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
|
|
166
|
+
return new Date(Math.floor(nowMs / 60000) * 60000);
|
|
167
|
+
}
|
|
168
|
+
// */N * * * * — каждые N минут (выравнивание по эпохе, как /mo N в schtasks).
|
|
169
|
+
const step = /^\*\/(\d+)$/.exec(minute);
|
|
170
|
+
if (step && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
|
|
171
|
+
const n = parseInt(step[1], 10);
|
|
172
|
+
if (n > 0) {
|
|
173
|
+
const minutes = Math.floor(nowMs / 60000);
|
|
174
|
+
return new Date((minutes - (minutes % n)) * 60000);
|
|
175
|
+
}
|
|
176
|
+
return null;
|
|
177
|
+
}
|
|
178
|
+
// M * * * * — каждый час в минуту M.
|
|
179
|
+
const hourlyMinute = intIn(minute, 0, 59);
|
|
180
|
+
if (hourlyMinute !== undefined &&
|
|
181
|
+
star(hour) &&
|
|
182
|
+
star(dayOfMonth) &&
|
|
183
|
+
star(month) &&
|
|
184
|
+
star(dayOfWeek)) {
|
|
185
|
+
const result = new Date(now);
|
|
186
|
+
result.setSeconds(0, 0);
|
|
187
|
+
result.setMinutes(hourlyMinute);
|
|
188
|
+
if (result.getTime() > nowMs)
|
|
189
|
+
result.setHours(result.getHours() - 1);
|
|
190
|
+
return result;
|
|
191
|
+
}
|
|
192
|
+
const m = intIn(minute, 0, 59);
|
|
193
|
+
const h = intIn(hour, 0, 23);
|
|
194
|
+
if (m === undefined || h === undefined || !star(dayOfMonth) || !star(month)) {
|
|
195
|
+
return null;
|
|
196
|
+
}
|
|
197
|
+
// M H * * * — ежедневно в HH:MM.
|
|
198
|
+
if (star(dayOfWeek)) {
|
|
199
|
+
const result = new Date(now);
|
|
200
|
+
result.setSeconds(0, 0);
|
|
201
|
+
result.setHours(h, m, 0, 0);
|
|
202
|
+
if (result.getTime() > nowMs)
|
|
203
|
+
result.setDate(result.getDate() - 1);
|
|
204
|
+
return result;
|
|
205
|
+
}
|
|
206
|
+
// M H * * D — еженедельно в день D (0 и 7 — воскресенье) в HH:MM.
|
|
207
|
+
const dow = intIn(dayOfWeek, 0, 7);
|
|
208
|
+
if (dow === undefined)
|
|
209
|
+
return null;
|
|
210
|
+
const targetDow = dow === 7 ? 0 : dow;
|
|
211
|
+
const result = new Date(now);
|
|
212
|
+
result.setSeconds(0, 0);
|
|
213
|
+
result.setHours(h, m, 0, 0);
|
|
214
|
+
// Не больше 8 итераций: одна неделя гарантированно содержит нужный день.
|
|
215
|
+
for (let i = 0; i <= 8; i += 1) {
|
|
216
|
+
if (result.getTime() <= nowMs && result.getDay() === targetDow)
|
|
217
|
+
return result;
|
|
218
|
+
result.setDate(result.getDate() - 1);
|
|
219
|
+
}
|
|
220
|
+
return null;
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* Формирует массив флагов расписания для schtasks на основе CronConversion.
|
|
224
|
+
* Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
|
|
225
|
+
*/
|
|
226
|
+
export function buildScheduleFlags(conversion) {
|
|
227
|
+
const flags = ["/sc", conversion.sc];
|
|
228
|
+
if (conversion.startTime) {
|
|
229
|
+
flags.push("/st", conversion.startTime);
|
|
230
|
+
}
|
|
231
|
+
flags.push(...conversion.extraFlags);
|
|
232
|
+
return flags;
|
|
233
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
export interface DryRunRoleScoped {
|
|
2
|
+
allowed?: string[];
|
|
3
|
+
denied?: string[];
|
|
4
|
+
}
|
|
5
|
+
export interface DryRunTaskItem {
|
|
6
|
+
name: string;
|
|
7
|
+
order: number;
|
|
8
|
+
trigger: "manual" | "cron" | "dag";
|
|
9
|
+
cwd: string;
|
|
10
|
+
command: string;
|
|
11
|
+
workspace?: {
|
|
12
|
+
name: string;
|
|
13
|
+
path: string;
|
|
14
|
+
};
|
|
15
|
+
preFlight?: string | null;
|
|
16
|
+
postFlight?: string | null;
|
|
17
|
+
qualityGate?: string | null;
|
|
18
|
+
roleScoped?: DryRunRoleScoped | null;
|
|
19
|
+
estimatedDurationSec?: number | null;
|
|
20
|
+
estimatedCostUsd?: number | null;
|
|
21
|
+
estimatedTokens?: number | null;
|
|
22
|
+
/** Для клона матрицы — имя родителя-шаблона (Спринт 15). */
|
|
23
|
+
matrixParent?: string;
|
|
24
|
+
}
|
|
25
|
+
export interface DryRunTotals {
|
|
26
|
+
estimatedDurationSec?: number | null;
|
|
27
|
+
estimatedCostUsd?: number | null;
|
|
28
|
+
estimatedTokens?: number | null;
|
|
29
|
+
}
|
|
30
|
+
export interface DryRunReport {
|
|
31
|
+
success: boolean;
|
|
32
|
+
taskName: string;
|
|
33
|
+
tasks: DryRunTaskItem[];
|
|
34
|
+
totals: DryRunTotals;
|
|
35
|
+
warnings: string[];
|
|
36
|
+
}
|
|
37
|
+
/** Средняя цена за 1K токенов (должна совпадать с dashboards/server.ts). */
|
|
38
|
+
export declare const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
|
|
39
|
+
/**
|
|
40
|
+
* Симулирует конвейер задачи: сама задача + все зависимости (dependsOn)
|
|
41
|
+
* в топологическом порядке. Возвращает отчёт без реального запуска.
|
|
42
|
+
*/
|
|
43
|
+
export declare function simulatePipeline(taskName: string): Promise<DryRunReport>;
|
|
44
|
+
//# sourceMappingURL=dry-run.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,4EAA4E;AAC5E,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AAQtD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAuP9E"}
|