opencode-windows-scheduler 1.3.0 → 1.5.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 (85) hide show
  1. package/CHANGELOG.md +47 -1
  2. package/README.md +11 -5
  3. package/ROADMAP-STRATEGY.md +45 -26
  4. package/ROADMAP.md +279 -35
  5. package/dist/core/audit.d.ts +68 -0
  6. package/dist/core/audit.d.ts.map +1 -0
  7. package/dist/core/audit.js +206 -0
  8. package/dist/core/dry-run.d.ts +31 -0
  9. package/dist/core/dry-run.d.ts.map +1 -1
  10. package/dist/core/dry-run.js +129 -1
  11. package/dist/core/file-watcher.d.ts.map +1 -1
  12. package/dist/core/file-watcher.js +53 -10
  13. package/dist/core/git-trigger.d.ts +80 -0
  14. package/dist/core/git-trigger.d.ts.map +1 -0
  15. package/dist/core/git-trigger.js +288 -0
  16. package/dist/core/glob.d.ts +38 -0
  17. package/dist/core/glob.d.ts.map +1 -0
  18. package/dist/core/glob.js +233 -0
  19. package/dist/core/ps-wrapper.d.ts.map +1 -1
  20. package/dist/core/ps-wrapper.js +7 -0
  21. package/dist/core/schedule-gate.js +55 -30
  22. package/dist/core/schedule-v2.d.ts +29 -1
  23. package/dist/core/schedule-v2.d.ts.map +1 -1
  24. package/dist/core/schedule-v2.js +81 -3
  25. package/dist/core/scheduler/types.d.ts +1 -1
  26. package/dist/core/scheduler/types.d.ts.map +1 -1
  27. package/dist/core/secrets.d.ts +57 -0
  28. package/dist/core/secrets.d.ts.map +1 -0
  29. package/dist/core/secrets.js +331 -0
  30. package/dist/core/structured-log.d.ts.map +1 -1
  31. package/dist/core/structured-log.js +9 -0
  32. package/dist/core/wrappers/bash.d.ts.map +1 -1
  33. package/dist/core/wrappers/bash.js +4 -0
  34. package/dist/db/git-state-repo.d.ts +16 -0
  35. package/dist/db/git-state-repo.d.ts.map +1 -0
  36. package/dist/db/git-state-repo.js +38 -0
  37. package/dist/db/schema.d.ts +1 -1
  38. package/dist/db/schema.d.ts.map +1 -1
  39. package/dist/db/schema.js +23 -0
  40. package/dist/index.d.ts +68 -4
  41. package/dist/index.d.ts.map +1 -1
  42. package/dist/index.js +589 -45
  43. package/dist/rpc.d.ts +623 -0
  44. package/dist/rpc.d.ts.map +1 -1
  45. package/dist/rpc.js +219 -0
  46. package/dist/server.d.ts.map +1 -1
  47. package/dist/server.js +67 -0
  48. package/dist/settings.d.ts +16 -0
  49. package/dist/settings.d.ts.map +1 -1
  50. package/dist/settings.js +29 -0
  51. package/dist/task-transfer.d.ts +30 -3
  52. package/dist/task-transfer.d.ts.map +1 -1
  53. package/dist/task-transfer.js +83 -6
  54. package/dist/templates.d.ts +1 -1
  55. package/dist/templates.d.ts.map +1 -1
  56. package/dist/workspaces.d.ts +8 -2
  57. package/dist/workspaces.d.ts.map +1 -1
  58. package/dist/workspaces.js +21 -4
  59. package/docs/ARCHITECTURE.md +14 -5
  60. package/docs/FEATURES.md +80 -1
  61. package/docs/README.ru.md +15 -5
  62. package/gui-experimental.cjs +9 -4
  63. package/package.json +8 -3
  64. package/src/core/audit.ts +291 -0
  65. package/src/core/dry-run.ts +188 -1
  66. package/src/core/file-watcher.ts +65 -10
  67. package/src/core/git-trigger.ts +367 -0
  68. package/src/core/glob.ts +226 -0
  69. package/src/core/ps-wrapper.ts +7 -0
  70. package/src/core/schedule-gate.ts +67 -33
  71. package/src/core/schedule-v2.ts +108 -3
  72. package/src/core/scheduler/types.ts +1 -1
  73. package/src/core/secrets.ts +385 -0
  74. package/src/core/structured-log.ts +9 -0
  75. package/src/core/wrappers/bash.ts +4 -0
  76. package/src/db/git-state-repo.ts +62 -0
  77. package/src/db/schema.ts +23 -0
  78. package/src/gui.tsx +548 -4
  79. package/src/index.ts +790 -47
  80. package/src/rpc.ts +230 -0
  81. package/src/server.ts +67 -0
  82. package/src/settings.ts +51 -0
  83. package/src/task-transfer.ts +124 -5
  84. package/src/templates.ts +1 -1
  85. package/src/workspaces.ts +22 -4
package/ROADMAP.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🗺️ Roadmap — opencode-windows-scheduler
2
2
 
3
- Текущая версия: **1.3.0** (14.11.2026). Плагин опубликован в npm, CI зелёный на Windows / macOS / Linux, 22 инструмента агента, 27 тестовых сюит.
3
+ Текущая версия: **1.5.0** (14.11.2026). Плагин опубликован в npm, CI зелёный на Windows / macOS / Linux, 24 инструмента агента, 32 тестовых сюит.
4
4
 
5
5
  - Стратегия и позиционирование — [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
6
6
  - Что уже выпущено — [CHANGELOG.md](./CHANGELOG.md).
@@ -19,72 +19,316 @@
19
19
  | 1.2.2 | 13.11.2026 | Кроссплатформенный дашборд: снятие зомби-процесса на macOS/Linux (`lsof`, `ss`), ожидание освобождения порта после SIGKILL, платформо-независимый тест заголовка. |
20
20
  | 1.2.3 | 13.11.2026 | Документация и дистрибуция: установка через `plugins` и `opencode plugin add` (ключ `plugin` устарел), FAQ, английский README для npm, русский README в `docs/README.ru.md`, расширенные описание и keywords пакета. |
21
21
  | 1.3.0 | 14.11.2026 | Уведомления: Telegram Bot API (HTML / MarkdownV2 / Markdown, тема форума, ссылка на дашборд), нативные toast на Windows / macOS / Linux без внешних зависимостей, тихие часы, стоимость и токены в сообщениях, тестовая отправка по выбранному каналу. |
22
+ | 1.4.0 | 14.11.2026 | Секреты и аудит: зашифрованное хранилище (AES-256-GCM, secrets.key 0600) с ссылками ${secret:NAME}, маскирование в логах и истории, журнал аудита (audit_log в SQLite, ротация 90 дней / 10 000 записей), инструменты manage_secrets и get_audit_log, GUI-панели секретов и аудита, HTTP-аудит мутаций. |
23
+ | 1.5.0 | 14.11.2026 | Git-триггеры (HEAD против последнего запуска, фильтр по ветке и путям), glob-маски и ignore-списки для файловых триггеров, временные окна с активными днями недели и политикой вне окна (skip / postpone / run), активное окно проверяется в dry-run и при событии, триггеры настраиваются через schedule_task и GUI, 3 новых тестовых сюита (glob, git-trigger, window-v3). |
22
24
 
23
25
  ---
24
26
 
25
- ## Ближайшие спринты
27
+ ## План 1.6.0 → 2.0.0
26
28
 
27
- Порядок отражает приоритет: сначала то, что мешает пользователям каждый день, затем переход к CI/CD-оркестрации.
29
+ План собран 14.11.2026 после выпуска 1.5.0: 11 релизов от i18n-фундамента до 2.0.0. Порядок отражает приоритет по боли пользователя, а не по красоте темы. Каждый спринт — один вертикальный срез не длиннее двух недель.
28
30
 
29
- ### Спринт 26 — Секреты и аудит (P1)
31
+ ### Принципы планирования
30
32
 
31
- - Secrets management: Windows Credential Manager / macOS Keychain / Linux Secret Service (keytar) или внешний Vault; подстановка в env задачи, маскирование в логах, истории и экспорте.
32
- - Audit log: кто создал / изменил / запустил / удалил задачу, когда и через какой интерфейс (агент, GUI, HTTP); поверх structured-log, с ротацией.
33
- - **Готово, когда:** секреты не хранятся в открытом виде, экспорт их не раскрывает, аудит покрывает все мутации задач и проверен тестом.
33
+ 1. **Один спринт = один вертикальный срез ≤ 2 недель.** Если не влезает — режем, а не растягиваем.
34
+ 2. **Никаких переименований и миграций внутри функциональных релизов.** Отдельный релиз = отдельный риск.
35
+ 3. **Каждая фича приходит с тестом и документацией.** Без этого спринт не закрыт.
36
+ 4. **Приоритет — по боли пользователя, а не по красоте темы.** P1 = без этого нельзя рекомендовать плагин.
37
+ 5. **Fail-open по умолчанию.** Любая необязательная подсистема (локальный ИИ, Docker, daemon) при отказе деградирует, а не блокирует планировщик.
38
+ 6. **Честность в маркетинге.** «Сэкономлено $» — оценка контрфактики, а не факт. Методика публикуется рядом с цифрой.
34
39
 
35
- ### Спринт 27 — Git-триггеры и условия запуска (P2)
40
+ ### Карта версий
36
41
 
37
- - Git-триггер: запуск только при новых коммитах (`HEAD` против последнего запуска), фильтр по ветке и путям (`git diff --name-only`).
38
- - Glob-маски и ignore-списки для файловых триггеров (сейчас `watchPath` — конкретный файл или папка).
39
- - Временные окна: «только 09:00–19:00 по будням» и поведение вне окна (skip / перенести / выполнить).
40
- - **Готово, когда:** триггеры настраиваются через `schedule_task` и GUI, dry-run показывает причину пропуска, есть тест на git- и glob-сценарии.
42
+ | Версия | Спринт | Тема | Приоритет | Риск |
43
+ |---|---|---|---|---|
44
+ | 1.6.0 | 28 | i18n-фундамент + резерв имени пакета | P1 | средний |
45
+ | 1.7.0 | 29 | Security slice A: enforced permissions + scoped secrets | P1 | высокий (спайк API) |
46
+ | 1.8.0 | 30 | ⭐ Local assistant v1: триаж + shadow mode | P1 | высокий |
47
+ | 1.9.0 | 31 | Local assistant v2: саммари + дедуп + wizard | P2 | средний |
48
+ | 1.10.0 | 32 | Pipeline-as-code | P2 | средний |
49
+ | 1.11.0 | 33 | Worktree-изоляция + guard-условия | P2 | средний |
50
+ | 1.12.0 | 34 | Экономика v2: бюджеты | P2 | низкий |
51
+ | 1.13.0 | 35 | Docker runner (opt-in) | P3 | высокий |
52
+ | 1.14.0 | 36 | Durable DAG: resume, идемпотентность, DLQ | P1 (для 2.0) | очень высокий |
53
+ | 1.15.0 | 37 | Rename-only релиз + scheduler daemon + config v2 | P2 | высокий |
54
+ | 2.0.0 | 38 | Approvals, окружения, артефакты, docs-сайт | MAJOR | высокий |
55
+ | 2.0.x | 39 | Запуск и сообщество | — | средний |
41
56
 
42
- ### Спринт 28 — Pipeline-as-code (P2)
57
+ **Если ресурсов меньше:** можно слить 31→30 и 33→32 (получится 9 релизов вместо 11), но **не** сливать 36→37 и не сливать rename с фичами.
43
58
 
44
- - `opencode.pipeline.yaml` в репозитории: versioned, reviewable, без новых зависимостей (парсер YAML — или JSON-совместимый подформат).
45
- - CLI `opencode pipeline validate|run|export`: проверка, запуск, экспорт в JSON задач плагина.
46
- - Импорт/экспорт пайплайна, конфликты с задачами из GUI — в лог и историю.
47
- - **Готово, когда:** пайплайн из репозитория запускается одной командой, DAG и матрицы описываются в файле, спецификация покрыта тестом и документацией.
59
+ ### Что изменено относительно исходного плана и почему
48
60
 
49
- ### Спринт 29 — Docker runner (P2)
61
+ | Исходный пункт | Проблема | Решение здесь |
62
+ |---|---|---|
63
+ | «Спринт 27 — Фундамент переезда (1.5.0)» | **1.5.0 уже выпущен** — это git-триггеры. Номер и версия заняты | Фундамент становится **1.6.0 / спринт 28** |
64
+ | «Спринт 29 — Git-триггеры (1.7.0)» | Работа **уже в 1.5.0**: `glob.ts`, `git-trigger.ts`, окна с `activeDays` и `windowPolicy` | Спринт удалён из плана как выполненный |
65
+ | Фундамент: i18n + имя + bench + рецепт Ollama в одном спринте | i18n по 4300-строчному `gui.tsx`, `server.ts`, уведомлениям и тестам — это 2+ недели само по себе | Фундамент = **только i18n + резерв имени**. Bench и рецепт переезжают в спринт локального помощника, где реально проверяются |
66
+ | «Локальный помощник v1» = triage + дедуп эмбеддингами + саммари + wizard + shadow + инструменты | 4–5 вертикальных срезов в одном релизе; риск не выпустить ничего | Разрезан на **v1 (триаж + shadow)** и **v2 (саммари + дедуп + wizard)** |
67
+ | Security & isolation на 1.9.0, flagship на 1.6.0 | Флагман продаёт приватность и локальность, а `allowedTools`/`deniedTools` **advisory** — это прямо заявлено в `docs/FEATURES.md`. Обещание расходится с реализацией | **Security slice A** (enforced permissions) поднят до 1.7.0, до флагмана |
68
+ | Docker runner + chaos + 24-часовой soak + zh/tr в одном спринте | Docker на Windows-CI болезненный; soak — это nightly-процесс, а не спринт | Docker — отдельный opt-in релиз; chaos/soak — **nightly workflow**, а не блокер релиза |
69
+ | 2.0.0 = переименование + daemon + durable DAG + approvals + config v2 + docs-сайт | Самое тяжёлое в проекте (durable DAG) сложено с самым рискованным (переименование npm-пакета) | Разрезано на **3 релиза**: Durable DAG → Rename+daemon → 2.0.0 Approvals |
70
+ | Переименование внутри 2.0.0 | Переименование ломает установку у всех пользователей; смешивать его с фичами — худший способ отладить регрессию | **Rename — отдельный релиз без функциональных изменений**, старый пакет остаётся живым re-export'ом и **не** депрекейтится сразу |
71
+
72
+ ### Спринт 28 — i18n-фундамент (1.6.0, P1)
73
+
74
+ **Цель:** вынести все пользовательские строки в каталоги и не дать им разъехаться.
75
+
76
+ **Объём:**
77
+ - Каталоги `locales/en.json` + `locales/ru.json`, загрузчик с fallback.
78
+ - Экстракция строк: GUI (`gui.tsx`), сервер (`server.ts`), уведомления, сообщения dry-run, ошибки инструментов.
79
+ - ICU-подмножество на встроенном `Intl.PluralRules` (без зависимостей): `{count, plural, one/few/many/other}`. Для русского обязательны `one/few/many`.
80
+ - Целые фразы-шаблоны, без конкатенации — иначе TR/ZH разваливаются.
81
+ - **RU остаётся локалью по умолчанию** (см. риск ниже).
82
+ - CI-тест паритета ключей в `test-docs.mjs`: нет ключа → красный CI.
83
+ - Резерв имени npm: `opencode-pipeline` заглушкой **в день старта спринта** (см. «Немедленные действия»).
84
+
85
+ **Вне объёма:** перевод на zh/tr, docs-сайт, bench, рецепт Ollama (переносим в 30).
86
+
87
+ **Готово, когда:**
88
+ - CI падает при рассинхроне локалей (проверено намеренной поломкой);
89
+ - `npm run build`, `build:gui`, все 32+ сюита зелёные;
90
+ - ни одного пользовательского литерала вне каталога в GUI/уведомлениях;
91
+ - переключение локали меняет язык без перезапуска.
92
+
93
+ **Риски:**
94
+ - **Тесты ассертят русские строки** (`«Прервано (сбой/перезагрузка)»`, сообщения dry-run, заголовки в docs-тестах). Миграция: ассерты переводим на ключи или на локаль-независимые идентификаторы. Это отдельная задача внутри спринта, её нельзя «забыть».
95
+ - Описания агентных инструментов и API **остаются EN** — это уже так, тест это фиксирует.
96
+
97
+ ---
98
+
99
+ ### Спринт 29 — Security slice A (1.7.0, P1)
100
+
101
+ **Цель:** закрыть разрыв между обещанием и реальностью до запуска флагмана.
102
+
103
+ **Объём:**
104
+ - **Спайк (2 дня):** проверить, что `@opencode/plugin` позволяет задавать permission-конфиг на запуск. Если нет — блокировка на уровне обёртки + честная документация ограничения.
105
+ - Enforced `allowedTools` / `deniedTools`: обёртка генерирует конфиг прав агента.
106
+ - Scoped-инъекция секретов: в env попадают только реально используемые `${secret:NAME}`.
107
+ - Аудит заблокированных действий в `audit_log`.
108
+
109
+ **Вне объёма:** worktree-изоляция (спринт 33), Docker.
110
+
111
+ **Готово, когда:**
112
+ - Запрещённый инструмент физически недоступен агенту (тест на попытку обхода);
113
+ - задача без ссылок на секреты не получает ни одного секрета в env;
114
+ - в аудите видно `tool.blocked` с задачей и инструментом;
115
+ - `docs/FEATURES.md` обновлён: advisory → enforced.
116
+
117
+ ---
118
+
119
+ ### Спринт 30 — ⭐ Local assistant v1: триаж + shadow (1.8.0, P1)
120
+
121
+ **Цель:** меньше шума в уведомлениях без потери важного. Работает даже без локальной модели.
122
+
123
+ **Объём:**
124
+ - `notifications.triage`: `mode` (`off`/`rules`/`llm`/`auto`), `baseUrl`, `model`, `timeoutMs`, `fallback`.
125
+ - Цепочка деградации: **LLM-классификатор → правила → пропустить триаж (fail-open)**.
126
+ - Клиент решений **провайдер-агностик**: конфигурируемый endpoint + модель, без хардкода конкретного стороннего проекта. Пресеты — в документации, не в коде.
127
+ - Rules-движок как всегда доступный fallback (статус, задача, текст ошибки, стоимость).
128
+ - **Shadow mode** (по умолчанию 14 дней): триаж только логирует вердикты, ничего не глушит.
129
+ - Отчёт shadow: false-skip, сколько уведомлений было бы подавлено.
130
+ - `scripts/bench-local.mjs` v1: tok/s, подбор тира по RAM, **версионированный JSON** (формат фиксируется под краудсорсинг).
131
+ - Рецепт «задача целиком на локальной модели» в `references/recipes.md` + docs: модель, `OLLAMA_CONTEXT_LENGTH=65536` как troubleshooting, а не как требование кода.
132
+ - Инструмент `manage_local_ai` + минимальный GUI-блок настроек.
133
+ - **Спайк:** проверить формат id моделей Ollama в текущей версии OpenCode и надёжность structured output у 4B-моделей.
134
+
135
+ **Вне объёма:** эмбеддинги, дедуп, саммари, wizard, счётчик экономии (спринт 31).
136
+
137
+ **Готово, когда:**
138
+ - Ollama недоступна → работают правила, уведомления **никогда** не блокируются (тест на таймаут и на отказ соединения);
139
+ - shadow-отчёт показывает false-skip и подавленные уведомления;
140
+ - ответ модели валидируется по схеме, при невалидном JSON — fallback на правила;
141
+ - bench выдаёт стабильный JSON на 16 ГБ CPU-машине;
142
+ - порог уверенности настраивается и покрыт тестом.
143
+
144
+ **Формулировка приёмки (важно):** не «первое саммари < 10 минут после установки» — это зависит от скорости скачивания модели и не контролируется нами. Вместо этого: «установка и работа планировщика не ухудшаются, если локальной модели нет».
145
+
146
+ ---
147
+
148
+ ### Спринт 31 — Local assistant v2 (1.9.0, P2)
149
+
150
+ **Объём:**
151
+ - Эмбеддинги для дедупа (`nomic-embed-text-v2-moe` или аналог): векторы в SQLite, косинус брутфорсом, без новых зависимостей.
152
+ - Подавление повторов со счётчиком.
153
+ - Саммари логов в 3 строки для Telegram/тостов, structured output + валидация.
154
+ - GUI value-first: wizard из 3 экранов, карточки моделей с последствиями отказа, пресеты Minimal/Recommended, кнопка «Сравнить» (before/after на одном событии).
155
+ - Счётчик «сэкономлено $» с явной пометкой «оценка» и ссылкой на методику.
156
+
157
+ **Готово, когда:** дедуп не подавляет важные уведомления (проверено на корпусе из shadow-периода); wizard проходится без документации; счётчик объясняет методику.
158
+
159
+ ---
160
+
161
+ ### Спринт 32 — Pipeline-as-code (1.10.0, P2)
162
+
163
+ **Объём:**
164
+ - `opencode.pipeline.yaml` (или JSON-совместимый подформат — без новых зависимостей).
165
+ - CLI `validate | run | export | diff`; drift-детект файл ↔ БД; конфликты — в лог и историю.
166
+ - DAG и матрицы описываются файлом.
167
+
168
+ **Готово, когда:** пайплайн из репозитория запускается одной командой без расписаний и без открытого OpenCode; спецификация покрыта тестом и документацией.
169
+
170
+ ---
171
+
172
+ ### Спринт 33 — Worktree-изоляция + guards (1.11.0, P2)
173
+
174
+ **Объём:**
175
+ - Одноразовый `git worktree` на запуск: политика очистки, защита незакоммиченных изменений, снятие lock-файлов после краша.
176
+ - Guard-условия: shell-команда (exit-код) + семантический `guardPrompt` через локальный тир.
177
+ - Статус `skipped`, причина в dry-run.
178
+
179
+ **Готово, когда:** два клона матрицы на одном репозитории не конфликтуют; семантический guard прошёл shadow-проверку; тесты на git/glob/окна/guard.
180
+
181
+ **Почему раньше Docker:** worktree даёт 80% ценности «безопасный параллельный fan-out на одном репо» без инфраструктуры и без проблем Windows-CI.
182
+
183
+ ---
50
184
 
51
- - Runner abstraction: локальный процесс (сейчас), Docker, SSH-хост. Задача описывает *что* делать, runner — *где*.
52
- - Docker: образ, монтирование workspace, лимиты CPU/RAM, сеть on/off; по умолчанию выключен.
53
- - Интеграция, а не собственный sandbox: Docker / Landstrip вместо изобретения изоляции.
54
- - **Готово, когда:** задача выполняется в контейнере с теми же хуками, Quality Gate, историей и метриками, что и локально.
185
+ ### Спринт 34 — Экономика v2 (1.12.0, P2)
186
+
187
+ **Объём:**
188
+ - Бюджеты: дневной/недельный лимит стоимости → авто-пауза очереди + алерт; per-task token budgets.
189
+ - Token efficiency score, прогноз стоимости (скользящее среднее), Grafana dashboard JSON.
190
+ - Аналитика local vs cloud.
191
+ - Tier-router v1 (advisory): GUI предлагает тир по истории задачи.
192
+
193
+ **Готово, когда:** лимит исчерпан → очередь встала и пришёл алерт; возобновление работает; аналитика разделяет local/cloud; тесты на паузу/возобновление.
194
+
195
+ ---
196
+
197
+ ### Спринт 35 — Docker runner (1.13.0, P3)
198
+
199
+ **Объём:**
200
+ - Runner-абстракция: `local | docker` (SSH — в горизонт 3.x).
201
+ - Docker: образ, монтирование workspace, лимиты CPU/RAM, сеть off по умолчанию.
202
+ - По умолчанию выключен.
203
+
204
+ **Готово, когда:** задача в контейнере проходит те же хуки, Quality Gate, историю и метрики, что и локально.
205
+
206
+ **Вне объёма:** 24-часовой soak и chaos-тесты — это **nightly workflow**, отдельно от релиза.
207
+
208
+ ---
209
+
210
+ ### Спринт 36 — Durable DAG (1.14.0, P1 для 2.0)
211
+
212
+ **Цель:** пережить краш посреди прогона.
213
+
214
+ **Объём:**
215
+ - Персистентная state-машина прогона (шаг → статус → попытка).
216
+ - Resume с середины после краша.
217
+ - Идемпотентные ключи шагов.
218
+ - DLQ для окончательно упавших шагов.
219
+ - Chaos-тест `kill -9` посреди DAG в nightly.
220
+
221
+ **Готово, когда:** `kill -9` посреди DAG → продолжение с того же шага; повторный запуск шага не дублирует побочные эффекты; DLQ видна в GUI.
222
+
223
+ **Почему отдельно:** это самое сложное изменение ядра за весь план. Оно трогает цикл запуска, схему истории и планировщик. Смешивать его с переименованием нельзя.
224
+
225
+ ---
226
+
227
+ ### Спринт 37 — Rename-only + daemon + config v2 (1.15.0 → 2.0-rc, P2)
228
+
229
+ **Часть A — переименование (отдельный коммит/релиз, без фич):**
230
+ - Публикация `opencode-pipeline` как тонкого re-export поверх текущего пакета.
231
+ - GitHub-переименование с редиректами.
232
+ - Trusted publishing на новый пакет.
233
+ - **Старый пакет остаётся живым** и продолжает получать патчи. `npm deprecate` — только после того, как новый пакет наберёт сопоставимые загрузки.
234
+
235
+ **Часть B — daemon:**
236
+ - `scheduler.backend: native | daemon | off | auto`.
237
+ - daemon: systemd user / launchd agent / Windows-сервис, catch-up политика.
238
+ - `off` = чистый событийный оркестратор.
239
+
240
+ **Часть C — config v2:**
241
+ - Автомиграция, `OPENCODE_PIPELINE_*` с fallback на старый префикс.
242
+ - Migration guide, проверенный на реальном старом экспорте.
243
+
244
+ **Готово, когда:** старый пакет работает через обёртку; `off`-режим живёт только на событиях; миграция проверена на старом экспорте; ни одна фича не сломана переименованием.
245
+
246
+ ---
247
+
248
+ ### Спринт 38 — 2.0.0: Approvals & environments (MAJOR)
249
+
250
+ **Объём:**
251
+ - Ручное подтверждение (GUI/Telegram), dev → staging → prod.
252
+ - Артефакты запуска.
253
+ - Docs-сайт, 4 локали (en/ru/zh/tr) с паритетом ключей.
254
+ - ZH/TR черновики через локальную модель + CODEOWNERS на locale-файлы + good-first-issues.
255
+
256
+ **Готово, когда:** краш посреди DAG → resume; `off`-режим работает; 4 локали зелёные; migration guide проверен; approvals блокируют prod-деплой без подтверждения.
257
+
258
+ ---
259
+
260
+ ### Спринт 39 — Запуск и сообщество (2.0.x)
261
+
262
+ - Четыре волны анонсов: EN (HN/Reddit + PR в ecosystem opencode.ai), RU (Habr/Pikabu), ZH (juejin/V2EX), TR.
263
+ - Демо «тишина в уведомлениях + сэкономлено $», пакет `local-recipes`, краудсорсинговая таблица bench в docs.
264
+ - **Готово, когда:** заявка в ecosystem подана и обработана; первые внешние PR; загрузки растут после анонсов (бот-всплеск не в счёт).
265
+
266
+ ---
267
+
268
+ ### Решения по плану (согласованы 14.11.2026)
269
+
270
+ 1. **Security до флагмана — принято.** Enforced `allowedTools` / `deniedTools` выходит в **1.7.0**, до локального помощника. Флагман не может продавать приватность на advisory-правах.
271
+ 2. **Переименование — зарезервировать сейчас, решать перед 1.15.0.** Имя `opencode-pipeline` резервируется заглушкой в день старта спринта 28. Окончательное решение о переезде принимается перед rename-релизом, по факту загрузок и обратной связи. Аргументы против переезда: «pipeline» сужает продукт (мы — планировщик + оркестратор), ломает установки, требует поддерживать два пакета. Аргументы за: «windows-scheduler» уже неточен (три ОС) и мешает позиционированию.
272
+ 3. **11 релизов — принято.** Каждый спринт ≤ 2 недель и один вертикальный срез. Слияние 31→30 и 33→32 остаётся аварийным вариантом при нехватке ресурсов, но не планом по умолчанию.
273
+ 4. **Локальный ИИ — строго опция.** `mode: off` по умолчанию, включение через wizard. Решено на уровне архитектуры, не только документации.
274
+ 5. **Открыто:** кто владелец locale-файлов (CODEOWNERS) — нужен до 1.9.0, иначе zh/tr будут мертворождёнными.
275
+
276
+ ### Немедленные действия (до спринта 28)
277
+
278
+ 1. **Зарезервировать имя npm.** Опубликовать `opencode-pipeline` заглушкой (`0.0.1`, README со ссылкой на основной пакет) в день старта спринта 28. Не `0.0.0-stage`: версия без обновлений выглядит заброшенной, а `0.0.1` можно переиздавать по мере надобности.
279
+ 2. **Спайк по правам агента (2 дня).** Проверить, позволяет ли `@opencode/plugin` задавать permission-конфиг на запуск. От результата зависит объём спринта 29.
280
+ 3. **Зафиксировать формат `bench-local.json`** до публикации краудсорсинговой таблицы (спринт 30) — иначе данные будут несравнимы.
281
+ 4. **Проверить формат id моделей Ollama** в текущей версии OpenCode и надёжность structured output у 4B-моделей.
282
+
283
+ ### Риски
284
+
285
+ | Риск | Триггер | Ответ |
286
+ |---|---|---|
287
+ | Переименование убивает установки | Падение загрузок после rename-релиза | Старый пакет остаётся живым, deprecate не раньше 2.1 |
288
+ | i18n ломает тесты | Массовые падения после экстракции | Ассерты на ключи; RU по умолчанию; отдельная задача в спринте 28 |
289
+ | Локальная модель даёт мусор | Невалидный JSON > 5% | Схема + retry + порог уверенности + fallback на правила |
290
+ | Durable DAG расползается | Спринт 36 > 3 недель | Резать: сначала resume для линейных цепочек, потом матрицы |
291
+ | Docker на Windows-CI | Падения CI | Docker-тесты только на Linux-раннере, opt-in |
292
+ | Bus factor = 1 | >5 issues без ответа | Заморозить P3, искать мейнтейнеров, сузить scope |
293
+ | Scope creep | Спринт длиннее 2 недель | P3 — в бэклог без обсуждения |
55
294
 
56
- ### Спринт 30 — Метрики v2 (P3)
295
+ ### Горизонт 3.x (без обязательств)
57
296
 
58
- - Token efficiency score: успешные запуски на потраченные токены, отдельно успех и ошибки, по задачам и моделям.
59
- - Cost forecasting: скользящее среднее, тренд, бюджет на день/неделю с алертом.
60
- - Готовый Grafana dashboard JSON + инструкция (Prometheus и OTLP уже есть).
297
+ - Remote runners (SSH).
298
+ - Мульти-агентные шаблоны: planner → worker → reviewer + cross-model review gate.
299
+ - Worktree → auto-PR (описание PR пишет локальная модель).
300
+ - Адаптеры других CLI (Claude Code / Gemini / aider).
301
+ - Экспорт в GitHub Actions.
61
302
 
62
- ### Спринт 31 — Локализация документации (P3)
303
+ ### Метрики плана
63
304
 
64
- - `docs/README.zh.md` и `docs/README.es.md`, синхронизированные с английским.
65
- - Переводы обновляются вместе с релизом; PR-шаблон для сообщества.
305
+ | Метрика | Сейчас (1.5.0) | 1.8.0 | 2.0.0 |
306
+ |---|---|---|---|
307
+ | Локали | ru (en в docs) | en + ru | en/ru/zh/tr |
308
+ | Enforced permissions | ❌ advisory | ✅ | ✅ |
309
+ | Локальный триаж | ❌ | ✅ shadow | ✅ + саммари/дедуп |
310
+ | Pipeline-as-code | ❌ | ❌ | ✅ |
311
+ | Durable DAG | ❌ | ❌ | ✅ |
312
+ | Docker runner | ❌ | ❌ | ✅ opt-in |
313
+ | Загрузки npm / мес | первые | 300+ | 1500+ |
314
+ | GitHub stars | единицы | 100+ | 500+ |
66
315
 
67
316
  ---
68
317
 
69
318
  ## Идеи без спринта
70
319
 
71
- - **Guard-условия**: shell-команда, ненулевой код = пропуск запуска, статус `skipped` в истории.
72
- - **Worktree-изоляция**: одноразовый `git worktree` на запуск, политика очистки, защита незакоммиченных изменений.
73
- - **Approvals и окружения**: ручное подтверждение перед деплоем, dev / staging / prod, артефакты запусков.
74
320
  - **Remote runners**: агент на удалённой машине, центральный дашборд, очередь и конкурентность на кластере.
75
321
  - **Экспорт в CI**: адаптеры GitHub Actions и GitLab CI из pipeline-as-code (не наоборот).
76
322
  - **Библиотека рецептов**: встроенные шаблоны (`nightly-refactor`, `dependency-audit`, `doc-sync`, `coverage-report`) + `manage_templates action=install`.
77
323
  - **DAG в GUI**: клик по узлу → карточка задачи, zoom/pan, подсветка пути, дорожка матричных клонов.
78
- - **Per-task permissions**: строгая реализация `allowedTools` / `deniedTools` (сейчас они advisory — см. `docs/FEATURES.md`).
79
324
  - **Нативный scheduler OpenCode**: режим `nativeScheduler: auto|on|off` вместо рекомендации отключать `experimental.schedules`.
80
- - **Имя и позиционирование**: алиас `opencode-pipeline` для 2.0, чтобы название не ограничивало кроссплатформенность.
81
325
 
82
326
  ---
83
327
 
84
328
  ## Правила разработки
85
329
 
86
330
  - Node.js 20+ (`engines`), CI — Node 24 на Windows, macOS и Linux.
87
- - Обязательны `npm run build` и `npm run build:gui`; `npm test` включает 26 сюит, включая `test-docs.mjs`.
331
+ - Обязательны `npm run build` и `npm run build:gui`; `npm test` включает 32 сюита, включая `test-docs.mjs`.
88
332
  - Новые runtime-зависимости — только с обоснованием; предпочтение optional dependencies и нативным командам ОС.
89
333
  - Обратная совместимость: старые `tasks.json` и экспорт читаются без миграции пользователем.
90
334
  - Каждый релиз обновляет CHANGELOG, README (EN + RU) и `docs/`; устаревшие отчёты спринтов не хранятся в корне — история живёт здесь и в CHANGELOG.
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Журнал аудита мутаций (Спринт 26).
3
+ *
4
+ * Фиксирует кто, когда и через какой интерфейс создал / изменил / запустил /
5
+ * удалил задачу или настройки. Записи лежат в SQLite рядом с историей, поэтому
6
+ * аудит не зависит от файловых логов и переживает перезапуск. Любая ошибка
7
+ * записи проглатывается: аудит не должен ломать основную операцию.
8
+ */
9
+ export type AuditActor = "mcp" | "gui" | "http" | "system" | string;
10
+ export interface AuditEntryInput {
11
+ action: string;
12
+ targetType?: string | null;
13
+ target?: string | null;
14
+ actor: AuditActor;
15
+ /** Конкретный инструмент / RPC-метод / HTTP-маршрут. */
16
+ source?: string | null;
17
+ details?: unknown;
18
+ remote?: string | null;
19
+ /** Время события (ISO). По умолчанию — сейчас. */
20
+ ts?: string;
21
+ }
22
+ export interface AuditRecord {
23
+ id: number;
24
+ ts: string;
25
+ action: string;
26
+ targetType: string | null;
27
+ target: string | null;
28
+ actor: string;
29
+ source: string | null;
30
+ details: unknown;
31
+ remote: string | null;
32
+ }
33
+ export interface ReadAuditFilter {
34
+ action?: string;
35
+ target?: string;
36
+ actor?: string;
37
+ since?: string;
38
+ until?: string;
39
+ limit?: number;
40
+ }
41
+ export interface ReadAuditResult {
42
+ records: AuditRecord[];
43
+ total: number;
44
+ }
45
+ export declare const DEFAULT_AUDIT_RETENTION_DAYS = 90;
46
+ export declare const DEFAULT_AUDIT_MAX_RECORDS = 10000;
47
+ /** Рекурсивно вычищает секреты из произвольной структуры details. */
48
+ export declare function redactAuditDetails(value: unknown, depth?: number): unknown;
49
+ /**
50
+ * Записывает событие аудита. Никогда не бросает исключение.
51
+ * Возвращает id записи или null при ошибке.
52
+ */
53
+ export declare function recordAudit(entry: AuditEntryInput): number | null;
54
+ /** Читает журнал аудита (новые сверху). */
55
+ export declare function readAuditLog(filter?: ReadAuditFilter): ReadAuditResult;
56
+ /**
57
+ * Удаляет старые записи и лишние сверх maxRecords.
58
+ * Возвращает количество удалённых строк.
59
+ */
60
+ export declare function cleanupAuditLog(options?: {
61
+ retentionDays?: number;
62
+ maxRecords?: number;
63
+ }): number;
64
+ /** Удаляет все записи (тесты / обслуживание). */
65
+ export declare function clearAuditLog(): void;
66
+ /** Сбрасывает троттлинг очистки (для тестов). */
67
+ export declare function resetAuditCleanupThrottle(): void;
68
+ //# sourceMappingURL=audit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAShD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAoBrE;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAiCjE;AA0CD,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,MAAM,GAAE,eAAoB,GAAG,eAAe,CA8C1E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA4Cd;AAED,iDAAiD;AACjD,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}