agent-steward 0.0.3 → 0.0.4

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 (171) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +3 -3
  3. package/ROADMAP-STRATEGY.md +9 -9
  4. package/ROADMAP.md +50 -34
  5. package/dist/core/dlq-api.d.ts +44 -0
  6. package/dist/core/dlq-api.d.ts.map +1 -0
  7. package/dist/core/dlq-api.js +68 -0
  8. package/dist/core/dry-run.d.ts.map +1 -1
  9. package/dist/core/dry-run.js +18 -1
  10. package/dist/core/lock.d.ts +20 -4
  11. package/dist/core/lock.d.ts.map +1 -1
  12. package/dist/core/lock.js +97 -22
  13. package/dist/core/one-shot.d.ts +5 -1
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +33 -8
  16. package/dist/core/opencode-cli.d.ts +28 -0
  17. package/dist/core/opencode-cli.d.ts.map +1 -0
  18. package/dist/core/opencode-cli.js +74 -0
  19. package/dist/core/opencode-models.d.ts +62 -0
  20. package/dist/core/opencode-models.d.ts.map +1 -0
  21. package/dist/core/opencode-models.js +277 -0
  22. package/dist/core/ps-wrapper.d.ts +1 -1
  23. package/dist/core/ps-wrapper.d.ts.map +1 -1
  24. package/dist/core/ps-wrapper.js +11 -1
  25. package/dist/core/record-history.d.ts +15 -0
  26. package/dist/core/record-history.d.ts.map +1 -1
  27. package/dist/core/record-history.js +56 -32
  28. package/dist/core/router/dispatch.d.ts +36 -0
  29. package/dist/core/router/dispatch.d.ts.map +1 -0
  30. package/dist/core/router/dispatch.js +59 -0
  31. package/dist/core/router/escalation.d.ts +47 -0
  32. package/dist/core/router/escalation.d.ts.map +1 -0
  33. package/dist/core/router/escalation.js +87 -0
  34. package/dist/core/router/planner.d.ts +53 -0
  35. package/dist/core/router/planner.d.ts.map +1 -0
  36. package/dist/core/router/planner.js +113 -0
  37. package/dist/core/router/rules.d.ts +46 -0
  38. package/dist/core/router/rules.d.ts.map +1 -0
  39. package/dist/core/router/rules.js +85 -0
  40. package/dist/core/run-panel-api.d.ts +94 -0
  41. package/dist/core/run-panel-api.d.ts.map +1 -0
  42. package/dist/core/run-panel-api.js +169 -0
  43. package/dist/core/schedule-gate.js +5 -1
  44. package/dist/core/schedule-v2.d.ts +34 -0
  45. package/dist/core/schedule-v2.d.ts.map +1 -1
  46. package/dist/core/schedule-v2.js +91 -5
  47. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  48. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  49. package/dist/core/scheduler/at-fallback.js +135 -5
  50. package/dist/core/scheduler/linux.d.ts +10 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +29 -11
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +25 -1
  55. package/dist/core/scheduler/registry.d.ts +11 -0
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +83 -21
  58. package/dist/core/scheduler/run-now.d.ts +16 -0
  59. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  60. package/dist/core/scheduler/run-now.js +28 -0
  61. package/dist/core/secrets.d.ts.map +1 -1
  62. package/dist/core/secrets.js +125 -28
  63. package/dist/core/session.d.ts.map +1 -1
  64. package/dist/core/session.js +18 -11
  65. package/dist/core/task-name.d.ts +24 -0
  66. package/dist/core/task-name.d.ts.map +1 -0
  67. package/dist/core/task-name.js +40 -0
  68. package/dist/core/wrappers/bash.d.ts.map +1 -1
  69. package/dist/core/wrappers/bash.js +49 -4
  70. package/dist/db/capability-repo.d.ts +83 -0
  71. package/dist/db/capability-repo.d.ts.map +1 -0
  72. package/dist/db/capability-repo.js +182 -0
  73. package/dist/db/history-repo.d.ts +8 -0
  74. package/dist/db/history-repo.d.ts.map +1 -1
  75. package/dist/db/history-repo.js +19 -0
  76. package/dist/db/index.d.ts +4 -0
  77. package/dist/db/index.d.ts.map +1 -1
  78. package/dist/db/index.js +39 -1
  79. package/dist/db/migrate.d.ts.map +1 -1
  80. package/dist/db/migrate.js +3 -1
  81. package/dist/db/run-context.d.ts +103 -0
  82. package/dist/db/run-context.d.ts.map +1 -0
  83. package/dist/db/run-context.js +224 -0
  84. package/dist/db/run-dlq.d.ts +100 -0
  85. package/dist/db/run-dlq.d.ts.map +1 -0
  86. package/dist/db/run-dlq.js +191 -0
  87. package/dist/db/run-resume.d.ts +5 -2
  88. package/dist/db/run-resume.d.ts.map +1 -1
  89. package/dist/db/run-resume.js +30 -11
  90. package/dist/db/runs-repo.d.ts +13 -5
  91. package/dist/db/runs-repo.d.ts.map +1 -1
  92. package/dist/db/runs-repo.js +28 -5
  93. package/dist/db/schema.d.ts +2 -2
  94. package/dist/db/schema.d.ts.map +1 -1
  95. package/dist/db/schema.js +154 -2
  96. package/dist/db/settings-repo.d.ts +11 -0
  97. package/dist/db/settings-repo.d.ts.map +1 -1
  98. package/dist/db/settings-repo.js +25 -0
  99. package/dist/db/step-idempotency.d.ts +51 -0
  100. package/dist/db/step-idempotency.d.ts.map +1 -0
  101. package/dist/db/step-idempotency.js +136 -0
  102. package/dist/index.d.ts +4 -4
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.js +102 -4
  105. package/dist/rpc.d.ts +678 -0
  106. package/dist/rpc.d.ts.map +1 -1
  107. package/dist/rpc.js +235 -0
  108. package/dist/server.d.ts +31 -0
  109. package/dist/server.d.ts.map +1 -1
  110. package/dist/server.js +95 -35
  111. package/dist/types.d.ts.map +1 -1
  112. package/dist/types.js +7 -0
  113. package/dist/workspaces.d.ts +25 -3
  114. package/dist/workspaces.d.ts.map +1 -1
  115. package/dist/workspaces.js +43 -8
  116. package/docs/ARCHITECTURE.md +229 -5
  117. package/docs/CONCEPT.md +171 -91
  118. package/docs/EXECUTION-LOOP.md +196 -0
  119. package/docs/README.ru.md +2 -2
  120. package/docs/README.zh.md +3 -3
  121. package/docs/SAFETY.md +122 -0
  122. package/docs/SAVINGS.md +29 -0
  123. package/docs/SAVINGS.ru.md +29 -0
  124. package/docs/SAVINGS.zh.md +18 -0
  125. package/gui-experimental.cjs +8 -8
  126. package/locales/en.json +67 -0
  127. package/locales/ru.json +67 -0
  128. package/locales/zh.json +67 -0
  129. package/package.json +28 -3
  130. package/scripts/audit-bundle.mjs +215 -0
  131. package/src/core/dlq-api.ts +98 -0
  132. package/src/core/dry-run.ts +25 -1
  133. package/src/core/lock.ts +95 -22
  134. package/src/core/one-shot.ts +36 -8
  135. package/src/core/opencode-cli.ts +103 -0
  136. package/src/core/opencode-models.ts +315 -0
  137. package/src/core/ps-wrapper.ts +11 -1
  138. package/src/core/record-history.ts +75 -37
  139. package/src/core/router/dispatch.ts +94 -0
  140. package/src/core/router/escalation.ts +129 -0
  141. package/src/core/router/planner.ts +166 -0
  142. package/src/core/router/rules.ts +109 -0
  143. package/src/core/run-panel-api.ts +262 -0
  144. package/src/core/schedule-gate.ts +6 -2
  145. package/src/core/schedule-v2.ts +114 -5
  146. package/src/core/scheduler/at-fallback.ts +190 -5
  147. package/src/core/scheduler/linux.ts +32 -10
  148. package/src/core/scheduler/posix.ts +20 -1
  149. package/src/core/scheduler/registry.ts +107 -26
  150. package/src/core/scheduler/run-now.ts +32 -0
  151. package/src/core/secrets.ts +127 -27
  152. package/src/core/session.ts +23 -10
  153. package/src/core/task-name.ts +67 -0
  154. package/src/core/wrappers/bash.ts +49 -4
  155. package/src/db/capability-repo.ts +285 -0
  156. package/src/db/history-repo.ts +22 -0
  157. package/src/db/index.ts +37 -1
  158. package/src/db/migrate.ts +3 -1
  159. package/src/db/run-context.ts +370 -0
  160. package/src/db/run-dlq.ts +310 -0
  161. package/src/db/run-resume.ts +48 -12
  162. package/src/db/runs-repo.ts +30 -7
  163. package/src/db/schema.ts +154 -2
  164. package/src/db/settings-repo.ts +31 -0
  165. package/src/db/step-idempotency.ts +185 -0
  166. package/src/gui.tsx +515 -0
  167. package/src/index.ts +124 -4
  168. package/src/rpc.ts +251 -0
  169. package/src/server.ts +112 -36
  170. package/src/types.ts +9 -0
  171. package/src/workspaces.ts +58 -9
package/CHANGELOG.md CHANGED
@@ -2,6 +2,26 @@
2
2
 
3
3
  All notable changes to this project are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning follows [Semantic Versioning](https://semver.org/).
4
4
 
5
+ ## [0.0.4] - 2026-11-18
6
+
7
+ ### Added
8
+
9
+ - **Идемпотентные ключи шагов (Sprint 36.3):** `src/db/step-idempotency.ts` (`runStepOnce`/`runStepOnceAsync`) — повторный вызов с тем же ключом возвращает сохранённый результат без побочных эффектов; `SCHEMA_VERSION = 4` добавляет частичный уникальный индекс `idx_run_steps_key_unique` с дедупликацией старых ключей.
10
+ - **DLQ (Sprint 36.4):** `src/db/run-dlq.ts` — детерминированно упавшие шаги попадают в очередь `run_dlq` (`SCHEMA_VERSION = 5`), доступны список, ручной retry с переоткрытием запуска и discard; вложенные транзакции работают через `SAVEPOINT`.
11
+ - **Роутер, слой 1 (Sprint 36.5.a):** `src/core/router/rules.ts` — таблица «тип задачи → транспорт + исполнитель» с нормализацией типа (`Run Tests` → `run_tests`). Модуль не импортирует ни БД, ни модель, ни транспорт: горячий путь стоит 0 токенов, неизвестный тип передаётся слоям 2–3.
12
+ - **Роутер, слой 2 (Sprint 36.5.b):** `SCHEMA_VERSION = 6` и таблица `capability_map`; `src/db/capability-repo.ts` учится на исходах гейта (`success_rate`, скользящие средние стоимости/времени, последние 10 исходов) и выбирает `local` / `cloud` / `review` по порогам без модели. Данных меньше трёх исходов — решение `explore`, его принимает слой 3.
13
+ - **Роутер, слой 3 (Sprint 36.5.c):** `src/core/router/planner.ts` — декомпозиция миссии: модель вызывается один раз на миссию и только чтобы вернуть шаги с типами, без модели работает эвристика по ключевым словам. Шаг несёт `stepName` и `taskType`, маршрут по-прежнему выбирают слои 1–2; незнакомые типы собираются в `ambiguousTaskTypes`.
14
+ - **Эскалация при провале гейта (Sprint 36.5.d):** `src/core/router/escalation.ts` — `escalateAfterGate` поднимает шаг по таблице `local → cloud → review → blocked` по одному флагу `passed`, без БД и модели; `escalationChain` и `isEscalationExhausted` описывают всю цепочку. Сборка маршрута — `src/core/router/dispatch.ts` (`routeStep`: слой 1 → слой 2, `review`/`explore` без транспорта).
15
+ - **Маршрутизация без модели (Sprint 36.5.e):** `test-router-dispatch.mjs` доказывает, что известные типы решаются статикой до инициализации БД, статика не пишет в `capability_map`, а `dispatch.ts` не импортирует `planner`; 1000 маршрутов укладываются в миллисекунды.
16
+ - **Ночной chaos-тест DAG (Sprint 36.5):** `test-chaos-dag.mjs` убивает `SIGKILL` дочерний процесс посреди цепочки шагов и проверяет, что durable-состояние переживает крах: завершённые шаги остаются `passed`, прерванный шаг восстанавливается с `attempt + 1`, resume доводит запуск до `passed`, `PRAGMA integrity_check` возвращает `ok`. Ночной workflow `.github/workflows/nightly.yml` гоняет сценарий по расписанию на Windows и Ubuntu; локально — `npm run test:chaos`.
17
+ - **DLQ в GUI (Sprint 36.6):** панель «♻️ Dead-letter queue» в `src/gui.tsx` показывает открытые записи с причиной, ошибкой и числом попыток; фильтр `open`/`all`/`retried`/`discarded` и счётчик открытых. RPC `list_dlq`/`retry_dlq`/`discard_dlq` работают через фасад `src/core/dlq-api.ts`; retry переоткрывает запуск и готовит шаг к выполнению (`attempt + 1`), discard закрывает запись, не меняя статус шага; мутации пишутся в аудит (`dlq.retry`, `dlq.discard`).
18
+ - **Пауза с инъекцией контекста (Sprint 36.7):** `SCHEMA_VERSION = 7` и новая таблица `run_injections` (comment / file / artifact, автор, metadata, `consumed_at`). Статус запуска `paused` с переходами `pending → paused`, `running → paused`, `paused → running/passed`. `src/db/run-context.ts` позволяет поставить запуск на паузу между шагами с комментарием, файлом и структурированным артефактом (`pauseRun`, `listRunInjections`, `pendingInjectionsForStep`, `consumeInjections`); секреты маскируются при записи (`redactSecretsInText`, чувствительные ключи JSON → `***`), максимальный размер вставки 100 кБ. При `resumeRunSync`/`resumeRun` обработчик шага получает `StepContext {injections}`, вставки передаются ровно один раз и помечаются потреблёнными, осиротевшие вставки закрываются в `finalize`. Тест `test-run-context.mjs`.
19
+ - **Пауза и resume в GUI (Sprint 36.8):** панель «⏯️ Запуски DAG» в `src/gui.tsx` показывает durable-запуски, прогресс, текущий шаг со ссылкой-якорем и историю контекста (автор, время, получатель). Фильтр `active`/`all`/`running`/`paused`/`failed`, поле комментария, кнопки pause/resume с подтверждением. Пауза во время выполняющегося шага блокируется и сопровождается предупреждением. RPC `list_durable_runs`/`pause_durable_run`/`resume_durable_run` работают через фасад `src/core/run-panel-api.ts`; resume только снимает паузу и готовит первый незавершённый шаг, выполнение продолжает `resumeRun`/исполнитель DAG. Мутации пишутся в аудит (`run.pause`, `run.resume`), локали ru/en/zh синхронны, тест `test-pause-gui.mjs`.
20
+
21
+ ### Fixed
22
+
23
+ - **GNU at e2e (P1-7.T1.3):** `test-at-e2e.mjs` запускает реальный `at` только на Linux и требует GNU-версию (`at -V`); на Windows Git Bash находил `C:\Windows\System32\at.exe`, а на macOS `atrun` по умолчанию выключен. На этих платформах тест делает SKIP, one-shot покрыт через schtasks/launchd.
24
+
5
25
  ## [0.0.3] - 2026-11-17
6
26
 
7
27
  ### Added
package/README.md CHANGED
@@ -19,7 +19,7 @@ Translations: [Russian](docs/README.ru.md) · [中文](docs/README.zh.md).
19
19
 
20
20
  > Schedule a task "morning-report" that runs every day at 09:00 with the prompt: "Summarize yesterday's git commits and write the report to ~/reports/".
21
21
 
22
- 3. Open the dashboard to watch it run: the agent prints the URL when the task is created (default `http://localhost:4380`), or ask for it later with the `get_dashboard_info` tool. Prefer a preview without installing anything? `node scripts/demo-dashboard.mjs` starts a demo dashboard at `http://localhost:4380`.
22
+ 3. Open the dashboard to watch it run: the agent prints the URL when the task is created (default `http://localhost:3782`), or ask for it later with the `get_dashboard_info` tool. Prefer a preview without installing anything? `node scripts/demo-dashboard.mjs` starts a demo dashboard at `http://localhost:3782`.
23
23
 
24
24
  ## Why
25
25
 
@@ -35,7 +35,7 @@ Everything runs on your machine. No SaaS, no telemetry, no accounts.
35
35
 
36
36
  ![Local web dashboard: matrix builds, DAG graph, metrics and run history](docs/dashboard.png)
37
37
 
38
- Want to see it without installing OpenCode? `node scripts/demo-dashboard.mjs` starts the dashboard with demo data at http://localhost:4380.
38
+ Want to see it without installing OpenCode? `node scripts/demo-dashboard.mjs` starts the dashboard with demo data at http://localhost:3782.
39
39
 
40
40
  ## Features
41
41
 
@@ -239,7 +239,7 @@ Tasks are **interactive only** by default: Task Scheduler starts them only while
239
239
  npm install
240
240
  npm run build # tsc
241
241
  npm run build:gui # vite
242
- npm test # 73 test suites, 600+ checks
242
+ npm test # 83 test suites, 600+ checks
243
243
  npm run test:en # same suites with the English locale
244
244
  ```
245
245
 
@@ -81,23 +81,23 @@ Enforced `allowedTools` / `deniedTools` вместо advisory, scoped-инъек
81
81
 
82
82
  ## Горизонт 1–3 месяца: verifiable orchestration
83
83
 
84
- **Фактический порядок (17.11.2026):** первым идёт Durable DAG (пункт 9, `0.0.3`), затем Pipeline-as-code (`0.0.4`) и остальные P2. Номер версии присваивается по факту релиза.
84
+ **Фактический порядок (18.11.2026):** Durable DAG (пункт 9, `0.0.3`–`0.0.4`) выпущен, следующим идёт Pipeline-as-code (`0.0.5`), затем остальные P2. Номер версии присваивается по факту релиза.
85
85
 
86
86
  ### 4. Локальный помощник v2 (P2) — 1.5.5–1.5.6 ✅
87
87
 
88
88
  Дедуп уведомлений (правила + эмбеддинги), саммари логов в 3 строки, GUI-wizard настройки триажа, счётчик «сэкономлено $» с пометкой «оценка», асинхронный триаж, persistent-аудит решений. Закрыто срезами 31.1–31.13.
89
89
 
90
- ### 5. Pipeline-as-code (P2) — 0.0.4
90
+ ### 5. Pipeline-as-code (P2) — 0.0.5
91
91
 
92
92
  `opencode.pipeline.yaml` в репозитории + CLI `opencode pipeline validate\|run\|export`. DAG, матрицы и Quality Gates описываются файлом, который можно ревьюить в PR.
93
93
 
94
94
  Это водораздел между «планировщиком» и «оркестратором» (CONCEPT §3: фреймворк-супервизор, а не просто таймер).
95
95
 
96
- ### 6. Worktree-изоляция и guard-условия (P2) — 0.0.5
96
+ ### 6. Worktree-изоляция и guard-условия (P2) — 0.0.6
97
97
 
98
98
  Одноразовый `git worktree` на запуск, политика очистки, shell- и семантические guard-условия, статус `skipped`. 80% ценности безопасного fan-out без инфраструктуры Docker.
99
99
 
100
- ### 7. Экономика v2 (P2) — 0.0.6
100
+ ### 7. Экономика v2 (P2) — 0.0.7
101
101
 
102
102
  Бюджеты на день/неделю с авто-паузой и алертом, per-task token budgets, token efficiency score, прогноз, Grafana JSON, local vs cloud.
103
103
 
@@ -105,11 +105,11 @@ Enforced `allowedTools` / `deniedTools` вместо advisory, scoped-инъек
105
105
 
106
106
  ## Горизонт 3–6 месяцев: масштаб и надёжность
107
107
 
108
- ### 8. Docker runner (P3) — 0.0.7
108
+ ### 8. Docker runner (P3) — 0.0.8
109
109
 
110
110
  Локальный процесс, Docker, SSH-хост. Задача описывает *что* делать, runner — *где*. Изоляцию не изобретаем: Docker / Landstrip. Opt-in, по умолчанию выключен.
111
111
 
112
- ### 9. Durable DAG (P1 для 0.1.0) — 0.0.3 ⬅️ следующий релиз
112
+ ### 9. Durable DAG (P1 для 0.1.0) — 0.0.3–0.0.4 ✅
113
113
 
114
114
  Персистентная state-машина прогона, resume после краша, идемпотентные шаги, DLQ, chaos `kill -9` в nightly.
115
115
 
@@ -183,9 +183,9 @@ Enforced `allowedTools` / `deniedTools` вместо advisory, scoped-инъек
183
183
 
184
184
  ## Ближайшие две недели
185
185
 
186
- 1. Durable DAG (0.0.3) — подзадача 36.1.a: схема `runs`/`run_steps` и запись перехода; далее 36.1.b, resume 36.2, идемпотентность 36.3.
187
- 2. Роутер, слои 1–2 (спринт 36.5.X) — статические правила горячего пути + Capability Map в SQLite.
188
- 3. Pipeline-as-code (0.0.4) — спецификация формата, парсер, CLI — после P1-ядра.
186
+ 1. Durable DAG (0.0.3–0.0.4, закрыт) — 36.1–36.8 выполнены и выпущены: state-машина, resume, идемпотентность, DLQ, роутер.
187
+ 2. Pipeline-as-code (0.0.5) — спецификация формата, парсер, CLI — следующий релиз.
188
+ 3. Worktree-изоляция (0.0.6) и экономика v2 (0.0.7) — после Pipeline-as-code.
189
189
 
190
190
  **Критерий месяца:** пользователь ставит плагин одной командой, получает уведомление в Telegram о падении задачи, токены и доступы не лежат открытым текстом в `tasks.json`, а интерфейс говорит на его языке.
191
191
 
package/ROADMAP.md CHANGED
@@ -22,14 +22,13 @@
22
22
 
23
23
  ### Что в приоритете прямо сейчас
24
24
 
25
- Точка на 17.11.2026: **спринты 28–31 закрыты и выпущены** (1.5.1–1.5.6), **спринт 36 начат**. Подзадачи **36.1.a** и **36.1.b** выполнены: схема `runs`/`run_steps` (SCHEMA_VERSION 3, колонка `position`), журнал переходов с восстановлением после `kill -9`, resume с середины (`run-resume.ts`) и тесты `test-run-state.mjs`, `test-run-journal.mjs`, `test-run-resume.mjs`. Следующая подзадача в работу: **36.3** (идемпотентные ключи шагов).
25
+ Точка на 18.11.2026: **спринты 28–31 закрыты и выпущены** (1.5.1–1.5.6), **спринт 36 закрыт и выпущен как `agent-steward@0.0.4`**. Подзадачи **36.1.a**, **36.1.b**, **36.2**, **36.3**, **36.4**, **36.5.a**, **36.5.b**, **36.5.c**, **36.5.d**, **36.5.e**, **36.5 Chaos-тест nightly**, **36.6 DLQ в GUI**, **36.7 Пауза с инъекцией контекста** и **36.8 Пауза и resume в GUI** выполнены: durable DAG (SCHEMA_VERSION 7, `runs`/`run_steps`/`run_dlq`/`run_injections`/`capability_map`), журнал переходов с восстановлением после `kill -9`, resume с середины, идемпотентные ключи, DLQ с ручным retry, все три слоя роутера (`rules.ts`, `capability-repo.ts`, `planner.ts`), сборка маршрута `dispatch.ts` и эскалация `escalation.ts` без модели, ночной chaos-тест с `kill -9` посреди DAG, панель DLQ в GUI со списком, причинами, retry и discard, пауза с комментарием/файлом/артефактом и передачей контекста следующему шагу при resume, панель durable-запусков с pause/resume, комментарием и ссылкой на текущий шаг. Приёмка пройдена: CI по коммиту `b5b130e` зелёный на Windows, Ubuntu и macOS. Следующий шаг: **спринт 32 — Pipeline-as-code (`0.0.5`)**.
26
26
 
27
27
  | Приоритет | Что | Почему |
28
28
  |-----------|-----|--------|
29
- | P1 | Durable DAG (спринт 36, задача 36.1) | Персистентная state-машина — фундамент resume, идемпотентности и DLQ; без неё 0.1.0 не выпустить |
30
- | P1 | Роутер, слои 1–2 (спринт 36.5.X) | 0 токенов на горячем пути, learning-loop из исходов гейта |
31
- | P2 | Pipeline-as-code (спринт 32) | `opencode.pipeline.yaml` — водораздел планировщик → оркестратор |
32
- | P2 | Worktree-изоляция (33), экономика v2 (34) | Идут после P1-ядра; номера версий — по факту релиза |
29
+ | P2 | Pipeline-as-code (спринт 32, `0.0.5`) | `opencode.pipeline.yaml` — водораздел планировщик → оркестратор |
30
+ | P2 | Worktree-изоляция (33, `0.0.6`), экономика v2 (34, `0.0.7`) | Идут после Pipeline-as-code; номера версий — по факту релиза |
31
+ | P3 | Docker runner (35, `0.0.8`) | Opt-in, после P2-направлений |
33
32
 
34
33
  ---
35
34
 
@@ -82,16 +81,16 @@ GATE — keystone (§5 CONCEPT): никогда «готово» на слово
82
81
  | 30 | Local assistant v1 (триаж + shadow) | P1 | ✅ завершён | 1.5.3 |
83
82
  | 31 | Local assistant v2 (дедуп, эмбеддинги, саммари, wizard, экономия) | P2 | ✅ завершён (31.1–31.13) | 1.5.5–1.5.6 |
84
83
  | 31.A | Спайк маршрутизации local/cloud | P3 | ⬜ бэклог | — |
85
- | 32 | Pipeline-as-code (`opencode.pipeline.yaml`) | P2 | ⬜ запланирован | 0.0.4 |
86
- | 33 | Worktree-изоляция + guard-условия | P2 | ⬜ запланирован | 0.0.5 |
87
- | 34 | Экономика v2 (бюджеты, token efficiency, прогноз) | P2 | ⬜ запланирован | 0.0.6 |
88
- | 35 | Docker runner (opt-in) | P3 | ⬜ запланирован | 0.0.7 |
89
- | 36 | Durable DAG (resume, идемпотентность, DLQ) + роутер | P1 (для 0.1.0) | 🔄 активен (спека готова, код не начат) | 0.0.3 |
84
+ | 32 | Pipeline-as-code (`opencode.pipeline.yaml`) | P2 | ⬜ запланирован | 0.0.5 |
85
+ | 33 | Worktree-изоляция + guard-условия | P2 | ⬜ запланирован | 0.0.6 |
86
+ | 34 | Экономика v2 (бюджеты, token efficiency, прогноз) | P2 | ⬜ запланирован | 0.0.7 |
87
+ | 35 | Docker runner (opt-in) | P3 | ⬜ запланирован | 0.0.8 |
88
+ | 36 | Durable DAG (resume, идемпотентность, DLQ) + роутер | P1 (для 0.1.0) | ✅ завершён (36.1–36.8) | 0.0.3–0.0.4 |
90
89
  | 37 | Rename-only + daemon + config v2 | P2 | ✅ завершён (Д7) | 0.0.2 |
91
90
  | 38 | Approvals, окружения, артефакты, docs-сайт | MAJOR | ⬜ запланирован | 0.1.0 |
92
91
  | 39 | Запуск и сообщество | — | ⬜ запланирован | 0.1.x |
93
92
 
94
- **Версии:** rename-релиз Д7 дал `agent-steward@0.0.2`. **Версия присваивается по факту релиза, а не заранее.** Следующий релиз — спринт 36 (`0.0.3`); 32–35 сдвигаются на `0.0.4`–`0.0.7` в порядке фактического выпуска. Переход на `0.1.0` — при спринте 38 (Approvals).
93
+ **Версии:** rename-релиз Д7 дал `agent-steward@0.0.2`, спринт 36 — `0.0.3`–`0.0.4`. **Версия присваивается по факту релиза, а не заранее.** Следующий релиз — Pipeline-as-code (`0.0.5`); 33–35 сдвигаются на `0.0.6`–`0.0.8` в порядке фактического выпуска. Переход на `0.1.0` — при спринте 38 (Approvals).
95
94
 
96
95
  ---
97
96
 
@@ -111,7 +110,7 @@ GATE — keystone (§5 CONCEPT): никогда «готово» на слово
111
110
 
112
111
  ---
113
112
 
114
- ## 5. Спринт 36 — Durable DAG + роутер (0.0.3, P1 для 0.1.0)
113
+ ## 5. Спринт 36 — Durable DAG + роутер (0.0.3–0.0.4, P1 для 0.1.0)
115
114
 
116
115
  **Цель:** пережить крах посреди прогона + реализовать трёхслойный роутер исполнения (CONCEPT §5 capability-aware роутинг).
117
116
 
@@ -125,29 +124,46 @@ GATE — keystone (§5 CONCEPT): никогда «готово» на слово
125
124
  - [x] **36.2 Resume с середины** — сложная.
126
125
  - [x] Продолжение с того же шага после краха.
127
126
  - [x] Тест: `kill -9` посреди линейной цепочки.
128
- - [ ] **36.3 Идемпотентные ключи шагов** — сложная.
129
- - [ ] Ключ шага и защита от дублей побочных эффектов.
130
- - [ ] Тест повторного запуска шага.
131
- - [ ] **36.4 DLQ** — средняя.
132
- - [ ] Очередь окончательно упавших шагов.
133
- - [ ] Ручной retry из DLQ.
127
+ - [x] **36.3 Идемпотентные ключи шагов** — сложная.
128
+ - [x] Ключ шага и защита от дублей побочных эффектов.
129
+ - [x] Тест повторного запуска шага.
130
+ - [x] **36.4 DLQ** — средняя.
131
+ - [x] Очередь окончательно упавших шагов.
132
+ - [x] Ручной retry из DLQ.
134
133
  - [ ] **36.5.X Реализация роутера** — сложная.
135
- - [ ] Слой 1: статические правила для горячего пути (таблица соответствий типа задачи → транспорт + исполнитель, 0 токенов, мгновенно).
136
- - [ ] Слой 2: Capability Map в SQLite (тип задачи → модель / success_rate / средняя стоимость / среднее время / последние 10 запусков; обучается на исходах гейта, 0 токенов, быстро).
137
- - [ ] Слой 3: локальная модель только для декомпозиции миссии и разрешения неоднозначности (не для маршрутизации каждого шага).
138
- - [ ] Эскалация при провале гейта — по правилу, без участия модели.
139
- - [ ] Тест: маршрутизация без вызова модели для известных типов задач.
140
- - [ ] **36.5 Chaos-тест nightly** — средняя.
141
- - [ ] `kill -9` посреди DAG в nightly workflow.
142
- - [ ] **36.6 DLQ в GUI** — средняя.
143
- - [ ] Список, причина, retry.
144
- - [ ] **36.7 Пауза с инъекцией контекста** — средняя.
145
- - [ ] На паузе можно оставить комментарий / файл / структурированный артефакт.
146
- - [ ] При resume следующий шаг получает вставку как контекст.
147
- - [ ] Комментарий и автор видны в истории; секреты маскируются.
148
- - [ ] **36.8 Пауза и resume в GUI/Telegram** — средняя.
149
- - [ ] Кнопки pause/resume, поле комментария, ссылка на текущий шаг.
150
- - [ ] Предупреждение, если шаг уже выполняется.
134
+ - [x] **36.5.a** Слой 1: статические правила для горячего пути (таблица тип задачи → транспорт + исполнитель, 0 токенов).
135
+ - Готово, когда: `src/core/router/rules.ts` маршрутизирует известные типы без импорта модели/БД; неизвестный тип возвращает `undefined` и уходит слою 2; `test-router-rules.mjs` зелёный.
136
+ - Сделано: `src/core/router/rules.ts`, `test-router-rules.mjs` (22 проверки).
137
+ - [x] **36.5.b** Слой 2: Capability Map в SQLite (тип задачи → модель / success_rate / средняя стоимость / среднее время / последние 10 запусков; обучается на исходах гейта, 0 токенов).
138
+ - Готово, когда: таблица создаётся миграцией, исходы гейта обновляют карту, для известного типа маршрут выбирается без модели.
139
+ - Сделано: `SCHEMA_VERSION` 6, `capability_map`, `src/db/capability-repo.ts`, `test-capability-map.mjs`.
140
+ - [x] **36.5.c** Слой 3: локальная модель только для декомпозиции миссии и разрешения неоднозначности (не для маршрутизации каждого шага).
141
+ - Готово, когда: декомпозиция возвращает шаги с типами, а маршрут каждого шага выбирают слои 1–2.
142
+ - Сделано: `src/core/router/planner.ts` (`planMission`, `planMissionSync`, `decomposeHeuristically`, `needsDecomposition`), `test-planner.mjs`.
143
+ - [x] **36.5.d** Эскалация при провале гейта — по правилу, без участия модели.
144
+ - Готово, когда: провал гейта поднимает шаг local → cloud → review, на review останавливается, модель не вызывается.
145
+ - Сделано: `src/core/router/escalation.ts` (`escalateAfterGate`, `escalationChain`), сборка маршрута `src/core/router/dispatch.ts` (`routeStep`), `test-escalation.mjs`.
146
+ - [x] **36.5.e** Тест: маршрутизация без вызова модели для известных типов задач.
147
+ - Готово, когда: тест доказывает, что известный тип решается слоем 1 до БД, статика не пишет в Capability Map, а `dispatch.ts` не импортирует planner.
148
+ - Сделано: `test-router-dispatch.mjs`.
149
+ - [x] **36.5 Chaos-тест nightly** — средняя.
150
+ - [x] `kill -9` посреди DAG в nightly workflow.
151
+ - Готово, когда: ночной workflow убивает процесс посреди цепочки, а следующий запуск/восстановление продолжает с прерванного шага; завершённые шаги не переигрываются.
152
+ - Сделано: `test-chaos-dag.mjs` (два сценария `kill -9` — на `build` и `test`), `.github/workflows/nightly.yml` (cron 03:17 UTC, Windows + Ubuntu), `npm run test:chaos`.
153
+ - [x] **36.6 DLQ в GUI** — средняя.
154
+ - [x] Список, причина, retry.
155
+ - Готово, когда: панель показывает открытые записи DLQ с причиной и ошибкой; retry переоткрывает запуск и готовит шаг (attempt + 1), discard закрывает запись без повтора; локали ru/en/zh синхронны.
156
+ - Сделано: `src/core/dlq-api.ts` (фасад `listDlq`/`retryDlq`/`discardDlq`, безопасные фильтр и лимит), RPC `list_dlq`/`retry_dlq`/`discard_dlq` в `src/rpc.ts` и `src/index.ts` (+ аудит `dlq.retry`/`dlq.discard`), секция «♻️ Dead-letter queue» в `src/gui.tsx` (фильтр open/all/retried/discarded, refresh, retry/discard с подтверждением), `test-dlq-gui.mjs`.
157
+ - [x] **36.7 Пауза с инъекцией контекста** — средняя.
158
+ - [x] На паузе можно оставить комментарий / файл / структурированный артефакт.
159
+ - [x] При resume следующий шаг получает вставку как контекст.
160
+ - [x] Комментарий и автор видны в истории; секреты маскируются.
161
+ - Сделано: `SCHEMA_VERSION` 7 и таблица `run_injections` (`src/db/schema.ts`), статус `paused` и `pauseRunRecord` (`src/db/runs-repo.ts`), модуль `src/db/run-context.ts` (`pauseRun`, `listRunInjections`, `pendingInjectionsForStep`, `consumeInjections`, `consumeOrphanInjections`, `StepContext`), передача контекста в `resumeRun`/`resumeRunSync` (`src/db/run-resume.ts`), маскирование JSON-ключей в `redactSecretsInText`, тест `test-run-context.mjs`.
162
+ - [x] **36.8 Пауза и resume в GUI/Telegram** — средняя.
163
+ - [x] Кнопки pause/resume, поле комментария, ссылка на текущий шаг.
164
+ - [x] Предупреждение, если шаг уже выполняется.
165
+ - Готово, когда: панель показывает durable-запуски с текущим шагом и прогрессом; pause сохраняет комментарий и автора, resume снимает паузу и готовит шаг; пауза во время running-шага предупреждает и блокируется; локали ru/en/zh синхронны.
166
+ - Сделано: `src/core/run-panel-api.ts` (`listRunPanel`, `pauseRunPanel`, `resumeRunPanel`, безопасные фильтр/лимит, обрезка истории контекста), RPC `list_durable_runs`/`pause_durable_run`/`resume_durable_run` в `src/rpc.ts` и `src/index.ts` (+ аудит `run.pause`/`run.resume`), секция «⏯️ Запуски DAG» в `src/gui.tsx` (фильтр active/all/running/paused/failed, текущий шаг-якорь, поле комментария, pause/resume, предупреждение о running-шаге, история контекста), `test-pause-gui.mjs`.
151
167
 
152
168
  **Готово, когда:** `kill -9` посреди DAG → продолжение с того же шага; повторный запуск шага не дублирует побочные эффекты; DLQ видна в GUI; роутер маршрутизирует известные типы задач без вызова модели; пауза с комментарием доходит до следующего шага.
153
169
 
@@ -0,0 +1,44 @@
1
+ /**
2
+ * GUI/RPC-фасад над dead-letter queue (Спринт 36.6).
3
+ *
4
+ * Тонкий слой между `src/db/run-dlq.ts` и RPC: приводит вход от GUI к
5
+ * безопасным значениям (статус, лимит), не даёт панике БД выйти наружу и
6
+ * возвращает единый `{ success, error }`-контракт. Логика очереди (идемпотентный
7
+ * enqueue, retry через reopenRun, discard) остаётся в БД-слое.
8
+ *
9
+ * Retry здесь только готовит шаг к повторному выполнению: переоткрывает запуск,
10
+ * переводит шаг в `running` и закрывает запись DLQ. Сам обработчик шага
11
+ * запускает resume (Спринт 36.7), поэтому фасад не притворяется, что шаг уже
12
+ * выполнен.
13
+ */
14
+ import { type DlqEntry, type DlqStatus } from "../db/run-dlq.js";
15
+ /** Фильтр списка: конкретный статус или все записи. */
16
+ export type DlqFilter = DlqStatus | "all";
17
+ export interface DlqListResult {
18
+ success: boolean;
19
+ entries: DlqEntry[];
20
+ /** Сколько записей открыто (для бейджа в заголовке панели). */
21
+ open: number;
22
+ error?: string;
23
+ }
24
+ export interface DlqActionResult {
25
+ success: boolean;
26
+ error?: string;
27
+ entry?: DlqEntry;
28
+ runId?: string;
29
+ stepName?: string;
30
+ /** true, если retry переоткрыл упавший запуск. */
31
+ runReopened?: boolean;
32
+ }
33
+ /** Неизвестный статус трактуем как `open`: безопасный дефолт очереди. */
34
+ export declare function normalizeDlqFilter(value: unknown): DlqFilter;
35
+ /** Список записей DLQ и счётчик открытых. */
36
+ export declare function listDlq(options?: {
37
+ status?: unknown;
38
+ limit?: unknown;
39
+ }): DlqListResult;
40
+ /** Ручной retry: готовит шаг к выполнению и закрывает запись DLQ. */
41
+ export declare function retryDlq(id: string): DlqActionResult;
42
+ /** Осознанный отказ от повтора: запись закрывается, шаг остаётся failed. */
43
+ export declare function discardDlq(id: string, resolution?: string): DlqActionResult;
44
+ //# sourceMappingURL=dlq-api.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dlq-api.d.ts","sourceRoot":"","sources":["../../src/core/dlq-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC;AAE1B,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAI5D;AAQD,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,CAW1F;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAapD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,SAAc,GAAG,eAAe,CAMhF"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * GUI/RPC-фасад над dead-letter queue (Спринт 36.6).
3
+ *
4
+ * Тонкий слой между `src/db/run-dlq.ts` и RPC: приводит вход от GUI к
5
+ * безопасным значениям (статус, лимит), не даёт панике БД выйти наружу и
6
+ * возвращает единый `{ success, error }`-контракт. Логика очереди (идемпотентный
7
+ * enqueue, retry через reopenRun, discard) остаётся в БД-слое.
8
+ *
9
+ * Retry здесь только готовит шаг к повторному выполнению: переоткрывает запуск,
10
+ * переводит шаг в `running` и закрывает запись DLQ. Сам обработчик шага
11
+ * запускает resume (Спринт 36.7), поэтому фасад не притворяется, что шаг уже
12
+ * выполнен.
13
+ */
14
+ import { countDeadLetters, discardDeadLetter, listDeadLetters, retryDeadLetter, } from "../db/run-dlq.js";
15
+ function errorText(err) {
16
+ return err instanceof Error ? err.message : String(err);
17
+ }
18
+ /** Неизвестный статус трактуем как `open`: безопасный дефолт очереди. */
19
+ export function normalizeDlqFilter(value) {
20
+ return value === "all" || value === "retried" || value === "discarded" || value === "open"
21
+ ? value
22
+ : "open";
23
+ }
24
+ function normalizeLimit(value, fallback = 100) {
25
+ const num = Math.floor(Number(value));
26
+ if (!Number.isFinite(num) || num < 1)
27
+ return fallback;
28
+ return Math.min(num, 500);
29
+ }
30
+ /** Список записей DLQ и счётчик открытых. */
31
+ export function listDlq(options = {}) {
32
+ try {
33
+ const status = normalizeDlqFilter(options.status);
34
+ return {
35
+ success: true,
36
+ entries: listDeadLetters({ status, limit: normalizeLimit(options.limit) }),
37
+ open: countDeadLetters("open"),
38
+ };
39
+ }
40
+ catch (err) {
41
+ return { success: false, entries: [], open: 0, error: errorText(err) };
42
+ }
43
+ }
44
+ /** Ручной retry: готовит шаг к выполнению и закрывает запись DLQ. */
45
+ export function retryDlq(id) {
46
+ try {
47
+ const result = retryDeadLetter(id);
48
+ return {
49
+ success: true,
50
+ entry: result.entry,
51
+ runId: result.run.id,
52
+ stepName: result.step.stepName,
53
+ runReopened: result.runReopened,
54
+ };
55
+ }
56
+ catch (err) {
57
+ return { success: false, error: errorText(err) };
58
+ }
59
+ }
60
+ /** Осознанный отказ от повтора: запись закрывается, шаг остаётся failed. */
61
+ export function discardDlq(id, resolution = "discarded") {
62
+ try {
63
+ return { success: true, entry: discardDeadLetter(id, resolution) };
64
+ }
65
+ catch (err) {
66
+ return { success: false, error: errorText(err) };
67
+ }
68
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"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"}
@@ -10,7 +10,7 @@ import { loadTaskDefinitions } from "../task-transfer.js";
10
10
  import { getHistory } from "../db/history-repo.js";
11
11
  import { getWorkspace } from "../workspaces.js";
12
12
  import { expandMatrixTask } from "./matrix.js";
13
- import { nextRun, activeWindowState } from "./schedule-v2.js";
13
+ import { nextRun, activeWindowState, assessCronWindowFeasibility, windowFeasibilityReasonText } from "./schedule-v2.js";
14
14
  import { checkGitTrigger } from "./git-trigger.js";
15
15
  import { t } from "../i18n.js";
16
16
  /** Сколько последних успешных/любых запусков усредняем для оценки. */
@@ -153,6 +153,23 @@ async function describeTrigger(opts) {
153
153
  reason: state.reason ?? t("dryRun.window.outside"),
154
154
  }));
155
155
  }
156
+ // P2-24: даже если сейчас окно откроется, cron может никогда в него не
157
+ // попадать (например, daily 09:00 при окне 22:00–06:00). Предупреждаем
158
+ // заранее — иначе задача молча не выполняется из-за лимита переноса 12 ч.
159
+ if ((def.triggerType ?? "cron") === "cron" && def.schedule) {
160
+ const feasibility = assessCronWindowFeasibility(def.schedule, {
161
+ notBefore: def.notBefore ?? undefined,
162
+ notAfter: def.notAfter ?? undefined,
163
+ days: def.activeDays ?? undefined,
164
+ timeZone: def.timezone ?? undefined,
165
+ }, policy);
166
+ if (!feasibility.feasible) {
167
+ warnings.push(t("dryRun.window.unreachable", {
168
+ cron: def.schedule,
169
+ reason: windowFeasibilityReasonText(feasibility.reason),
170
+ }));
171
+ }
172
+ }
156
173
  }
157
174
  return base;
158
175
  }
@@ -1,3 +1,12 @@
1
+ /**
2
+ * Проверяет, жив ли процесс-владелец lock-файла.
3
+ *
4
+ * `process.kill(pid, 0)` не посылает сигнал, а только проверяет существование.
5
+ * EPERM означает, что процесс есть, но у нас нет прав на сигнал — считаем живым.
6
+ * Остальные ошибки трактуем консервативно как «жив», чтобы не вытеснить
7
+ * чужую критическую секцию.
8
+ */
9
+ export declare function isProcessAlive(pid: number): boolean;
1
10
  /**
2
11
  * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
3
12
  *
@@ -22,15 +31,22 @@ export declare class LockManager {
22
31
  initialize(): Promise<void>;
23
32
  /**
24
33
  * Пытается захватить блокировку для задачи.
25
- * Возвращает true, если блокировка захвачена (файл создан).
26
- * Возвращает false, если блокировка уже удерживается другим запуском.
34
+ * Возвращает уникальный токен владельца (он же содержимое lock-файла) или
35
+ * null, если блокировка уже удерживается другим запуском.
36
+ *
37
+ * Токен нужен release(): процесс, чей lock был вытеснен по stale-таймауту,
38
+ * не должен удалять файл нового владельца.
27
39
  */
28
- acquire(taskName: string): Promise<boolean>;
40
+ acquire(taskName: string): Promise<string | null>;
29
41
  /**
30
42
  * Освобождает блокировку задачи (удаляет lock-файл).
43
+ *
44
+ * Удаляет файл только если в нём лежит токен этого владельца. Если lock
45
+ * успели вытеснить и перехватить, release ничего не трогает и возвращает
46
+ * false — иначе старый процесс снёс бы чужую критическую секцию.
31
47
  * Не выбрасывает ошибку, если файл уже удалён.
32
48
  */
33
- release(taskName: string): Promise<void>;
49
+ release(taskName: string, token: string): Promise<boolean>;
34
50
  /**
35
51
  * Проверяет, удерживается ли блокировка задачей в данный момент.
36
52
  */
@@ -1 +1 @@
1
- {"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAiB;IAItC,iCAAiC;IACjC,OAAO,CAAC,YAAY;IAIpB,uCAAuC;IACvC,OAAO,CAAC,YAAY;IAIpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDjC;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBjD;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC,CAAC,CAAC,CA4CZ"}
1
+ {"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAWD;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAiB;IAItC,iCAAiC;IACjC,OAAO,CAAC,YAAY;IAIpB,uCAAuC;IACvC,OAAO,CAAC,YAAY;IAIpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgEjC;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBvD;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBhE;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC,CAAC,CAAC,CAuDZ"}