agent-steward 0.0.4 → 0.0.6

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 (279) hide show
  1. package/CHANGELOG.md +309 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +55 -8
  4. package/ROADMAP-STRATEGY.md +22 -19
  5. package/ROADMAP.md +230 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +356 -0
  9. package/dist/core/analytics.d.ts +6 -0
  10. package/dist/core/analytics.d.ts.map +1 -1
  11. package/dist/core/analytics.js +20 -3
  12. package/dist/core/audit.d.ts +6 -0
  13. package/dist/core/audit.d.ts.map +1 -1
  14. package/dist/core/audit.js +24 -0
  15. package/dist/core/budget.d.ts +118 -0
  16. package/dist/core/budget.d.ts.map +1 -0
  17. package/dist/core/budget.js +206 -0
  18. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  19. package/dist/core/cron-to-schtasks.js +38 -0
  20. package/dist/core/dry-run.d.ts +26 -1
  21. package/dist/core/dry-run.d.ts.map +1 -1
  22. package/dist/core/dry-run.js +199 -8
  23. package/dist/core/execution.d.ts +203 -0
  24. package/dist/core/execution.d.ts.map +1 -0
  25. package/dist/core/execution.js +309 -0
  26. package/dist/core/feedback.d.ts +192 -0
  27. package/dist/core/feedback.d.ts.map +1 -0
  28. package/dist/core/feedback.js +426 -0
  29. package/dist/core/gate-integrity.d.ts +71 -0
  30. package/dist/core/gate-integrity.d.ts.map +1 -0
  31. package/dist/core/gate-integrity.js +275 -0
  32. package/dist/core/git-trigger.d.ts.map +1 -1
  33. package/dist/core/git-trigger.js +14 -2
  34. package/dist/core/guard-run.d.ts +4 -0
  35. package/dist/core/guard-run.d.ts.map +1 -0
  36. package/dist/core/guard-run.js +101 -0
  37. package/dist/core/guard.d.ts +52 -0
  38. package/dist/core/guard.d.ts.map +1 -0
  39. package/dist/core/guard.js +362 -0
  40. package/dist/core/local-ai.d.ts.map +1 -1
  41. package/dist/core/local-ai.js +7 -3
  42. package/dist/core/lock.d.ts +41 -0
  43. package/dist/core/lock.d.ts.map +1 -1
  44. package/dist/core/lock.js +141 -29
  45. package/dist/core/matrix.d.ts +8 -0
  46. package/dist/core/matrix.d.ts.map +1 -1
  47. package/dist/core/matrix.js +132 -17
  48. package/dist/core/mission.d.ts +103 -0
  49. package/dist/core/mission.d.ts.map +1 -0
  50. package/dist/core/mission.js +374 -0
  51. package/dist/core/opencode-models.d.ts +2 -2
  52. package/dist/core/opencode-models.d.ts.map +1 -1
  53. package/dist/core/opencode-models.js +28 -21
  54. package/dist/core/opencode-usage.d.ts +35 -0
  55. package/dist/core/opencode-usage.d.ts.map +1 -0
  56. package/dist/core/opencode-usage.js +132 -0
  57. package/dist/core/pipeline-apply.d.ts +38 -0
  58. package/dist/core/pipeline-apply.d.ts.map +1 -0
  59. package/dist/core/pipeline-apply.js +117 -0
  60. package/dist/core/pipeline-io.d.ts +13 -0
  61. package/dist/core/pipeline-io.d.ts.map +1 -0
  62. package/dist/core/pipeline-io.js +78 -0
  63. package/dist/core/pipeline-map.d.ts +52 -0
  64. package/dist/core/pipeline-map.d.ts.map +1 -0
  65. package/dist/core/pipeline-map.js +208 -0
  66. package/dist/core/pipeline-spec.d.ts +109 -0
  67. package/dist/core/pipeline-spec.d.ts.map +1 -0
  68. package/dist/core/pipeline-spec.js +554 -0
  69. package/dist/core/ps-wrapper.d.ts +27 -2
  70. package/dist/core/ps-wrapper.d.ts.map +1 -1
  71. package/dist/core/ps-wrapper.js +424 -65
  72. package/dist/core/record-history.d.ts.map +1 -1
  73. package/dist/core/record-history.js +206 -33
  74. package/dist/core/router/rules.d.ts.map +1 -1
  75. package/dist/core/router/rules.js +6 -0
  76. package/dist/core/run-mode.d.ts +12 -0
  77. package/dist/core/run-mode.d.ts.map +1 -0
  78. package/dist/core/run-mode.js +17 -0
  79. package/dist/core/scheduler/linux.d.ts +8 -1
  80. package/dist/core/scheduler/linux.d.ts.map +1 -1
  81. package/dist/core/scheduler/linux.js +34 -9
  82. package/dist/core/scheduler/logs.d.ts +4 -0
  83. package/dist/core/scheduler/logs.d.ts.map +1 -1
  84. package/dist/core/scheduler/logs.js +25 -1
  85. package/dist/core/scheduler/mac.d.ts +44 -2
  86. package/dist/core/scheduler/mac.d.ts.map +1 -1
  87. package/dist/core/scheduler/mac.js +126 -15
  88. package/dist/core/scheduler/windows.d.ts.map +1 -1
  89. package/dist/core/scheduler/windows.js +15 -12
  90. package/dist/core/secrets.d.ts.map +1 -1
  91. package/dist/core/secrets.js +18 -8
  92. package/dist/core/self-analysis.d.ts +32 -2
  93. package/dist/core/self-analysis.d.ts.map +1 -1
  94. package/dist/core/self-analysis.js +38 -27
  95. package/dist/core/shutdown.d.ts +33 -2
  96. package/dist/core/shutdown.d.ts.map +1 -1
  97. package/dist/core/shutdown.js +58 -2
  98. package/dist/core/structured-log.d.ts +37 -1
  99. package/dist/core/structured-log.d.ts.map +1 -1
  100. package/dist/core/structured-log.js +37 -0
  101. package/dist/core/usage-surface.d.ts +25 -0
  102. package/dist/core/usage-surface.d.ts.map +1 -0
  103. package/dist/core/usage-surface.js +41 -0
  104. package/dist/core/worktree-run.d.ts +4 -0
  105. package/dist/core/worktree-run.d.ts.map +1 -0
  106. package/dist/core/worktree-run.js +164 -0
  107. package/dist/core/worktree.d.ts +115 -0
  108. package/dist/core/worktree.d.ts.map +1 -0
  109. package/dist/core/worktree.js +462 -0
  110. package/dist/core/wrappers/bash.d.ts +19 -0
  111. package/dist/core/wrappers/bash.d.ts.map +1 -1
  112. package/dist/core/wrappers/bash.js +230 -27
  113. package/dist/db/capability-repo.d.ts +43 -2
  114. package/dist/db/capability-repo.d.ts.map +1 -1
  115. package/dist/db/capability-repo.js +96 -11
  116. package/dist/db/history-repo.d.ts +70 -5
  117. package/dist/db/history-repo.d.ts.map +1 -1
  118. package/dist/db/history-repo.js +170 -29
  119. package/dist/db/metrics-repo.d.ts +20 -2
  120. package/dist/db/metrics-repo.d.ts.map +1 -1
  121. package/dist/db/metrics-repo.js +35 -13
  122. package/dist/db/migrate.d.ts.map +1 -1
  123. package/dist/db/migrate.js +37 -17
  124. package/dist/db/recovery.d.ts +3 -1
  125. package/dist/db/recovery.d.ts.map +1 -1
  126. package/dist/db/recovery.js +11 -5
  127. package/dist/db/run-journal.d.ts +33 -5
  128. package/dist/db/run-journal.d.ts.map +1 -1
  129. package/dist/db/run-journal.js +78 -14
  130. package/dist/db/run-resume.d.ts +5 -0
  131. package/dist/db/run-resume.d.ts.map +1 -1
  132. package/dist/db/run-resume.js +9 -2
  133. package/dist/db/runs-repo.d.ts +19 -2
  134. package/dist/db/runs-repo.d.ts.map +1 -1
  135. package/dist/db/runs-repo.js +91 -60
  136. package/dist/db/schema.d.ts +2 -2
  137. package/dist/db/schema.d.ts.map +1 -1
  138. package/dist/db/schema.js +132 -2
  139. package/dist/db/templates-repo.d.ts +2 -2
  140. package/dist/db/templates-repo.d.ts.map +1 -1
  141. package/dist/db/templates-repo.js +5 -3
  142. package/dist/history.d.ts +7 -2
  143. package/dist/history.d.ts.map +1 -1
  144. package/dist/history.js +4 -2
  145. package/dist/hook-output.d.ts +2 -0
  146. package/dist/hook-output.d.ts.map +1 -0
  147. package/dist/hook-output.js +31 -0
  148. package/dist/i18n.d.ts +5 -0
  149. package/dist/i18n.d.ts.map +1 -1
  150. package/dist/i18n.js +11 -4
  151. package/dist/index.d.ts +375 -47
  152. package/dist/index.d.ts.map +1 -1
  153. package/dist/index.js +1344 -192
  154. package/dist/notifications.d.ts +53 -2
  155. package/dist/notifications.d.ts.map +1 -1
  156. package/dist/notifications.js +168 -21
  157. package/dist/profiles.d.ts.map +1 -1
  158. package/dist/profiles.js +82 -10
  159. package/dist/rpc.d.ts +354 -0
  160. package/dist/rpc.d.ts.map +1 -1
  161. package/dist/rpc.js +145 -0
  162. package/dist/server.d.ts +32 -2
  163. package/dist/server.d.ts.map +1 -1
  164. package/dist/server.js +154 -30
  165. package/dist/settings.d.ts +44 -2
  166. package/dist/settings.d.ts.map +1 -1
  167. package/dist/settings.js +85 -3
  168. package/dist/shared/jobs-view.d.ts +1 -1
  169. package/dist/shared/jobs-view.d.ts.map +1 -1
  170. package/dist/shared/jobs-view.js +2 -0
  171. package/dist/task-transfer.d.ts +21 -0
  172. package/dist/task-transfer.d.ts.map +1 -1
  173. package/dist/task-transfer.js +64 -3
  174. package/dist/templates.d.ts +2 -2
  175. package/dist/templates.d.ts.map +1 -1
  176. package/dist/templates.js +3 -3
  177. package/dist/types.d.ts +22 -2
  178. package/dist/types.d.ts.map +1 -1
  179. package/dist/workspaces.d.ts.map +1 -1
  180. package/dist/workspaces.js +34 -11
  181. package/docs/ARCHITECTURE.md +319 -66
  182. package/docs/COMPATIBILITY.md +2 -2
  183. package/docs/CONCEPT.md +18 -4
  184. package/docs/CROSS_PLATFORM.ru.md +20 -0
  185. package/docs/CROSS_PLATFORM.zh.md +18 -0
  186. package/docs/EXECUTION-LOOP.md +28 -10
  187. package/docs/FEATURES.md +129 -7
  188. package/docs/FEATURES.zh.md +97 -6
  189. package/docs/MIGRATION.md +2 -2
  190. package/docs/PIPELINE.md +293 -0
  191. package/docs/QA-A2-GUI-TUI.md +205 -0
  192. package/docs/README.ru.md +43 -4
  193. package/docs/README.zh.md +44 -4
  194. package/docs/SAFETY.md +23 -3
  195. package/gui-experimental.cjs +9 -8
  196. package/locales/en.json +58 -3
  197. package/locales/ru.json +58 -3
  198. package/locales/zh.json +58 -3
  199. package/opencode.pipeline.yaml +35 -0
  200. package/package.json +36 -4
  201. package/scripts/check-eslint-baseline.mjs +139 -0
  202. package/scripts/gen-test-plan-counters.mjs +117 -0
  203. package/scripts/github-ci-fetch.ps1 +37 -0
  204. package/scripts/pl-commit.ps1 +112 -0
  205. package/scripts/qa-a2-commit.ps1 +104 -0
  206. package/scripts/test-home.mjs +107 -0
  207. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  208. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  209. package/src/cli.ts +417 -0
  210. package/src/core/analytics.ts +27 -4
  211. package/src/core/audit.ts +25 -0
  212. package/src/core/budget.ts +340 -0
  213. package/src/core/cron-to-schtasks.ts +42 -0
  214. package/src/core/dry-run.ts +235 -12
  215. package/src/core/execution.ts +538 -0
  216. package/src/core/feedback.ts +582 -0
  217. package/src/core/file-watcher.ts +2 -2
  218. package/src/core/gate-integrity.ts +330 -0
  219. package/src/core/git-trigger.ts +18 -5
  220. package/src/core/guard-run.ts +119 -0
  221. package/src/core/guard.ts +431 -0
  222. package/src/core/local-ai.ts +7 -3
  223. package/src/core/lock.ts +178 -37
  224. package/src/core/matrix.ts +158 -52
  225. package/src/core/mission.ts +531 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/opencode-models.ts +30 -21
  228. package/src/core/opencode-usage.ts +182 -0
  229. package/src/core/pipeline-apply.ts +158 -0
  230. package/src/core/pipeline-io.ts +96 -0
  231. package/src/core/pipeline-map.ts +283 -0
  232. package/src/core/pipeline-spec.ts +775 -0
  233. package/src/core/ps-wrapper.ts +435 -66
  234. package/src/core/record-history.ts +258 -81
  235. package/src/core/router/rules.ts +6 -0
  236. package/src/core/run-mode.ts +19 -0
  237. package/src/core/schedule-gate.ts +1 -1
  238. package/src/core/scheduler/at-fallback.ts +1 -1
  239. package/src/core/scheduler/linux.ts +40 -11
  240. package/src/core/scheduler/logs.ts +34 -3
  241. package/src/core/scheduler/mac.ts +174 -14
  242. package/src/core/scheduler/registry.ts +2 -2
  243. package/src/core/scheduler/windows.ts +19 -15
  244. package/src/core/secrets.ts +26 -19
  245. package/src/core/self-analysis.ts +75 -29
  246. package/src/core/shutdown.ts +90 -4
  247. package/src/core/structured-log.ts +89 -5
  248. package/src/core/telegram.ts +2 -2
  249. package/src/core/triage-worker.ts +7 -7
  250. package/src/core/triage.ts +2 -2
  251. package/src/core/usage-surface.ts +70 -0
  252. package/src/core/worktree-run.ts +199 -0
  253. package/src/core/worktree.ts +600 -0
  254. package/src/core/wrappers/bash.ts +248 -26
  255. package/src/db/capability-repo.ts +127 -10
  256. package/src/db/history-repo.ts +281 -40
  257. package/src/db/metrics-repo.ts +40 -13
  258. package/src/db/migrate.ts +57 -32
  259. package/src/db/recovery.ts +12 -5
  260. package/src/db/run-journal.ts +100 -13
  261. package/src/db/run-resume.ts +17 -1
  262. package/src/db/runs-repo.ts +147 -65
  263. package/src/db/schema.ts +134 -2
  264. package/src/db/templates-repo.ts +5 -3
  265. package/src/gui.tsx +438 -18
  266. package/src/history.ts +11 -4
  267. package/src/hook-output.ts +39 -0
  268. package/src/i18n.ts +12 -4
  269. package/src/index.ts +1902 -320
  270. package/src/notifications.ts +227 -47
  271. package/src/profiles.ts +88 -10
  272. package/src/rpc.ts +158 -0
  273. package/src/server.ts +201 -41
  274. package/src/settings.ts +125 -5
  275. package/src/shared/jobs-view.ts +3 -1
  276. package/src/task-transfer.ts +90 -6
  277. package/src/templates.ts +3 -3
  278. package/src/types.ts +23 -2
  279. package/src/workspaces.ts +37 -14
@@ -5,16 +5,47 @@
5
5
  * in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
6
6
  * SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
7
7
  * отслеживают: их жизненным циклом управляет сама ОС.
8
+ *
9
+ * PL-10/QV-2: состояние ворот наблюдаемо (причина, время, PID, активные
10
+ * операции), а «зависшие» ворота (begin без complete, нет активных операций,
11
+ * прошло больше STALE_MS) автоматически открываются при первом же запросе.
12
+ * Так hot-reload каталога инструментов не блокирует in-process запуски,
13
+ * пока ОС-планировщик продолжает тикать.
8
14
  */
9
15
  export interface ShutdownWaitResult {
10
16
  timedOut: boolean;
11
17
  remaining: number;
12
18
  }
19
+ export interface ShutdownGateState {
20
+ shuttingDown: boolean;
21
+ /** Причина, по которой ворота были закрыты (обычно «plugin unload»). */
22
+ reason: string | null;
23
+ /** ISO-время вызова begin(). */
24
+ startedAt: string | null;
25
+ /** PID процесса, в котором ворота закрыты. */
26
+ pid: number;
27
+ /** Число ещё выполняемых in-process операций. */
28
+ activeCount: number;
29
+ /** true после complete() — выгрузка действительно завершена. */
30
+ unloadCompleted: boolean;
31
+ /** Диагностика последнего автоматического сброса. */
32
+ lastAutoReset: string | null;
33
+ }
13
34
  export interface ShutdownGate {
14
- /** true после begin(): новые запуски должны отклоняться. */
35
+ /** true после begin(), пока ворота не открылись повторно. */
15
36
  isShuttingDown(): boolean;
16
37
  /** Переводит ворота в режим выгрузки. */
17
- begin(): void;
38
+ begin(reason?: string): void;
39
+ /** Подтверждает, что выгрузка завершена (запрещает автосброс). */
40
+ complete(): void;
41
+ /**
42
+ * PL-45: принудительно открывает ворота. Вызывается при повторной
43
+ * регистрации плагина (V2 setup / V1 hooks), когда хост ранее вызвал
44
+ * begin()+complete(), но модуль остался в памяти (Code Mode / hot-reload).
45
+ */
46
+ reset(): void;
47
+ /** Снимок состояния для диагностики и структурированных ошибок. */
48
+ state(): ShutdownGateState;
18
49
  /** Учитывает промис до его завершения (успех или ошибка). */
19
50
  track<T>(promise: Promise<T>): Promise<T>;
20
51
  /** Сколько операций ещё выполняется. */
@@ -1 +1 @@
1
- {"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,cAAc,IAAI,OAAO,CAAC;IAC1B,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,6DAA6D;IAC7D,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,wCAAwC;IACxC,WAAW,IAAI,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAyCjD"}
1
+ {"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,eAAe,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,cAAc,IAAI,OAAO,CAAC;IAC1B,yCAAyC;IACzC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,IAAI,IAAI,CAAC;IACjB;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IACd,mEAAmE;IACnE,KAAK,IAAI,iBAAiB,CAAC;IAC3B,6DAA6D;IAC7D,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,wCAAwC;IACxC,WAAW,IAAI,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CA4FjD"}
@@ -5,15 +5,71 @@
5
5
  * in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
6
6
  * SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
7
7
  * отслеживают: их жизненным циклом управляет сама ОС.
8
+ *
9
+ * PL-10/QV-2: состояние ворот наблюдаемо (причина, время, PID, активные
10
+ * операции), а «зависшие» ворота (begin без complete, нет активных операций,
11
+ * прошло больше STALE_MS) автоматически открываются при первом же запросе.
12
+ * Так hot-reload каталога инструментов не блокирует in-process запуски,
13
+ * пока ОС-планировщик продолжает тикать.
8
14
  */
15
+ /** Порог «зависших» ворот; переопределяется для тестов через env. */
16
+ const STALE_GATE_MS = Number(process.env.AGENT_STEWARD_SHUTDOWN_STALE_MS ?? 30000);
9
17
  export function createShutdownGate() {
10
18
  let shuttingDown = false;
19
+ let reason = null;
20
+ let startedAtMs = null;
21
+ let unloadCompleted = false;
22
+ let lastAutoReset = null;
11
23
  const active = new Set();
24
+ const maybeResetStale = () => {
25
+ if (!shuttingDown ||
26
+ active.size !== 0 ||
27
+ startedAtMs === null ||
28
+ Date.now() - startedAtMs < STALE_GATE_MS) {
29
+ return;
30
+ }
31
+ const waitedMs = Date.now() - startedAtMs;
32
+ lastAutoReset =
33
+ `ворота оставались закрытыми ${waitedMs} мс без активных операций ` +
34
+ (unloadCompleted
35
+ ? "после complete() без выгрузки модуля — автосброс в Code Mode"
36
+ : "и без complete() — автосброс после hot-reload");
37
+ shuttingDown = false;
38
+ reason = null;
39
+ startedAtMs = null;
40
+ };
12
41
  return {
13
- isShuttingDown: () => shuttingDown,
14
- begin: () => {
42
+ isShuttingDown: () => {
43
+ maybeResetStale();
44
+ return shuttingDown;
45
+ },
46
+ begin: (why = "plugin unload") => {
15
47
  shuttingDown = true;
48
+ reason = why;
49
+ startedAtMs = Date.now();
50
+ unloadCompleted = false;
51
+ },
52
+ complete: () => {
53
+ unloadCompleted = true;
54
+ },
55
+ reset: () => {
56
+ if (shuttingDown) {
57
+ lastAutoReset = "ворота открыты повторной регистрацией плагина (PL-45)";
58
+ }
59
+ shuttingDown = false;
60
+ reason = null;
61
+ startedAtMs = null;
62
+ unloadCompleted = false;
16
63
  },
64
+ state: () => ({
65
+ shuttingDown,
66
+ reason,
67
+ startedAt: startedAtMs === null ? null : new Date(startedAtMs).toISOString(),
68
+ pid: process.pid,
69
+ activeCount: active.size,
70
+ unloadCompleted,
71
+ lastAutoReset,
72
+ }),
17
73
  track(promise) {
18
74
  const tracked = promise.finally(() => {
19
75
  active.delete(tracked);
@@ -12,7 +12,7 @@
12
12
  * запуск задачи: наблюдаемость не должна влиять на планировщик.
13
13
  */
14
14
  /** События структурированного лога. */
15
- export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | string;
15
+ export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | "matrix.started" | "matrix.advanced" | "matrix.queue_started" | "matrix.cancelled" | "matrix.aggregated" | "matrix.aggregator_started" | "matrix.error" | string;
16
16
  export interface StructuredLogRecord {
17
17
  /** Время записи (ISO). */
18
18
  ts: string;
@@ -32,6 +32,22 @@ export interface StructuredLogRecord {
32
32
  workspaceId?: string | null;
33
33
  preFlightStatus?: string;
34
34
  postFlightStatus?: string;
35
+ /**
36
+ * PL-7.2: реальный код завершения хуков. Диагностика Git уходит в stderr
37
+ * даже при успешном push — без разделения потоков «пуш не состоялся» и
38
+ * «Git пишет в stderr» неразличимы.
39
+ */
40
+ preFlightExitCode?: number | null;
41
+ /** PL-7.2: stdout beforeScript — отдельно от диагностики. */
42
+ preFlightStdout?: string;
43
+ /** PL-7.2: stderr beforeScript. */
44
+ preFlightStderr?: string;
45
+ /** PL-7.2: реальный код завершения afterScript (post-flight). */
46
+ postFlightExitCode?: number | null;
47
+ /** PL-7.2: stdout afterScript — отдельно от диагностики. */
48
+ postFlightStdout?: string;
49
+ /** PL-7.2: stderr afterScript — может содержать diagnostics успешного git push. */
50
+ postFlightStderr?: string;
35
51
  /** Источник события: schedule, dashboard, hook, cli, mcp и т.п. */
36
52
  source?: string;
37
53
  /** HTTP-статус ответа на hook.received. */
@@ -42,6 +58,12 @@ export interface StructuredLogRecord {
42
58
  payloadBytes?: number;
43
59
  /** Причина отказа/пропуска. */
44
60
  reason?: string;
61
+ /** Родительская задача матрицы (matrixId === task для событий matrix.*). */
62
+ matrixId?: string;
63
+ /** Имя клона матрицы, к которому относится событие. */
64
+ cloneName?: string;
65
+ /** Шаг матричного сценария: started, advanced, cancelled, aggregated и т.п. */
66
+ step?: string;
45
67
  }
46
68
  export interface ReadStructuredLogsFilter {
47
69
  task?: string;
@@ -72,6 +94,20 @@ export declare const STRUCTURED_LOG_MAX_BYTES: number;
72
94
  export declare function appendStructuredLog(record: Omit<StructuredLogRecord, "ts"> & {
73
95
  ts?: string;
74
96
  }): boolean;
97
+ /** PL-7.2: данные одного хука (pre/post-flight) для журнала. */
98
+ export interface HookOutputDetails {
99
+ /** Реальный код завершения процесса, а не «успех/ошибка» обёртки. */
100
+ exitCode: number | null;
101
+ stdout?: string;
102
+ stderr?: string;
103
+ }
104
+ /**
105
+ * PL-7.2: пишет отдельное событие `hook.output` с разделёнными stdout/stderr и
106
+ * реальным exit code. Обёртка вызывает его, когда хочет отличить «команда не
107
+ * выполнилась» от «команда выполнилась, но написала диагностику в stderr»
108
+ * (типичный случай git push под PowerShell $ErrorActionPreference='Stop').
109
+ */
110
+ export declare function appendHookOutputLog(phase: "preFlight" | "postFlight", task: string, details: HookOutputDetails, runId?: number): boolean;
75
111
  /**
76
112
  * Читает JSONL-лог (текущий + архив), фильтрует и сортирует новые сверху.
77
113
  *
@@ -1 +1 @@
1
- {"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAmC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAsBT;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA4C1B;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
1
+ {"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"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"}
@@ -57,6 +57,20 @@ export function appendStructuredLog(record) {
57
57
  if (typeof payload.reason === "string") {
58
58
  payload.reason = redactSecretsInText(payload.reason);
59
59
  }
60
+ // PL-7.2: потоки хуков тоже могут содержать токены/URL — применяем ту же
61
+ // редакцию, что и к error/reason, до записи в JSONL.
62
+ if (typeof payload.preFlightStdout === "string") {
63
+ payload.preFlightStdout = redactSecretsInText(payload.preFlightStdout);
64
+ }
65
+ if (typeof payload.preFlightStderr === "string") {
66
+ payload.preFlightStderr = redactSecretsInText(payload.preFlightStderr);
67
+ }
68
+ if (typeof payload.postFlightStdout === "string") {
69
+ payload.postFlightStdout = redactSecretsInText(payload.postFlightStdout);
70
+ }
71
+ if (typeof payload.postFlightStderr === "string") {
72
+ payload.postFlightStderr = redactSecretsInText(payload.postFlightStderr);
73
+ }
60
74
  fs.appendFileSync(STRUCTURED_LOG_FILE, `${JSON.stringify(payload)}\n`, "utf8");
61
75
  return true;
62
76
  }
@@ -65,6 +79,29 @@ export function appendStructuredLog(record) {
65
79
  return false;
66
80
  }
67
81
  }
82
+ /**
83
+ * PL-7.2: пишет отдельное событие `hook.output` с разделёнными stdout/stderr и
84
+ * реальным exit code. Обёртка вызывает его, когда хочет отличить «команда не
85
+ * выполнилась» от «команда выполнилась, но написала диагностику в stderr»
86
+ * (типичный случай git push под PowerShell $ErrorActionPreference='Stop').
87
+ */
88
+ export function appendHookOutputLog(phase, task, details, runId) {
89
+ const base = { event: "hook.output", task, runId };
90
+ if (phase === "postFlight") {
91
+ return appendStructuredLog({
92
+ ...base,
93
+ postFlightExitCode: details.exitCode,
94
+ postFlightStdout: details.stdout ?? "",
95
+ postFlightStderr: details.stderr ?? "",
96
+ });
97
+ }
98
+ return appendStructuredLog({
99
+ ...base,
100
+ preFlightExitCode: details.exitCode,
101
+ preFlightStdout: details.stdout ?? "",
102
+ preFlightStderr: details.stderr ?? "",
103
+ });
104
+ }
68
105
  function readLines(file) {
69
106
  try {
70
107
  return fs
@@ -0,0 +1,25 @@
1
+ /**
2
+ * QV-11.1: офлайн-оценка размера поверхности инструментов без вызова платной
3
+ * модели. Точный tiktoken не нужен: нам важна сравнимая метрика «было/стало»
4
+ * и число description', чтобы видеть раздувание реестра.
5
+ */
6
+ export interface ToolSurfaceSpec {
7
+ name: string;
8
+ description?: string;
9
+ input?: unknown;
10
+ }
11
+ export interface ToolSurfaceMeasurement {
12
+ tools: number;
13
+ descriptionChars: number;
14
+ schemaChars: number;
15
+ descriptionCount: number;
16
+ estimatedTokens: number;
17
+ }
18
+ /** Резервная грубая оценка: ~4 символа на токен (только без токенайзера). */
19
+ export declare function estimateTokens(text: string): number;
20
+ export interface MeasureToolSurfaceOptions {
21
+ /** Реальный офлайн-токенайзер (например, encode из gpt-tokenizer). */
22
+ countTokens?: (text: string) => number;
23
+ }
24
+ export declare function measureToolSurface(specs: readonly ToolSurfaceSpec[], options?: MeasureToolSurfaceOptions): ToolSurfaceMeasurement;
25
+ //# sourceMappingURL=usage-surface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage-surface.d.ts","sourceRoot":"","sources":["../../src/core/usage-surface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,OAAO,GAAE,yBAA8B,GACtC,sBAAsB,CAoCxB"}
@@ -0,0 +1,41 @@
1
+ /**
2
+ * QV-11.1: офлайн-оценка размера поверхности инструментов без вызова платной
3
+ * модели. Точный tiktoken не нужен: нам важна сравнимая метрика «было/стало»
4
+ * и число description', чтобы видеть раздувание реестра.
5
+ */
6
+ /** Резервная грубая оценка: ~4 символа на токен (только без токенайзера). */
7
+ export function estimateTokens(text) {
8
+ return Math.ceil(text.length / 4);
9
+ }
10
+ export function measureToolSurface(specs, options = {}) {
11
+ let descriptionChars = 0;
12
+ let schemaChars = 0;
13
+ let descriptionCount = 0;
14
+ for (const spec of specs) {
15
+ if (spec.description) {
16
+ descriptionChars += spec.description.length;
17
+ descriptionCount += 1;
18
+ }
19
+ if (spec.input !== undefined) {
20
+ try {
21
+ schemaChars += JSON.stringify(spec.input).length;
22
+ }
23
+ catch {
24
+ schemaChars += "[unserializable]".length;
25
+ }
26
+ }
27
+ }
28
+ return {
29
+ tools: specs.length,
30
+ descriptionChars,
31
+ schemaChars,
32
+ descriptionCount,
33
+ estimatedTokens: options.countTokens
34
+ ? options.countTokens(specs
35
+ .map((spec) => `${spec.name} ${spec.description ?? ""} ${JSON.stringify(spec.input ?? null)}`)
36
+ .join("\n"))
37
+ : estimateTokens(specs
38
+ .map((spec) => `${spec.name} ${spec.description ?? ""} ${JSON.stringify(spec.input ?? null)}`)
39
+ .join("\n")),
40
+ };
41
+ }
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env node
2
+ /** Точка входа для тестов: возвращает exit code, ничего не завершает. */
3
+ export declare function main(argv?: string[]): Promise<number>;
4
+ //# sourceMappingURL=worktree-run.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worktree-run.d.ts","sourceRoot":"","sources":["../../src/core/worktree-run.ts"],"names":[],"mappings":";AAiLA,yEAAyE;AACzE,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlF"}
@@ -0,0 +1,164 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * W-1/W-2 (0.0.6): CLI-помощник обёртки для одноразовых git worktree.
4
+ *
5
+ * Создание (вызывается из сгенерированного .cmd/.sh):
6
+ * node worktree-run.js --repo "<workdir>" --task "<task name>" [--root <dir>] [--json]
7
+ * node worktree-run.js create --repo ... --task ...
8
+ *
9
+ * Очистка (после прогона и для остатков):
10
+ * node worktree-run.js cleanup --path "<worktree>" [--repo <root>] [--root <dir>] [--keep-branch] [--json]
11
+ * node worktree-run.js cleanup --stale [--root <dir>] [--max-age-hours <n>] [--json]
12
+ *
13
+ * При создании в stdout печатается только путь к worktree (одна строка) —
14
+ * обёртка ловит его и переходит туда. Диагностика и ошибки идут в stderr.
15
+ * При ошибке exit 1: обёртка обязана упасть fail-closed, а не работать в
16
+ * основном дереве.
17
+ */
18
+ import path from "node:path";
19
+ import { pathToFileURL } from "node:url";
20
+ import { cleanupStaleWorktrees, createRunWorktree, DEFAULT_STALE_AFTER_MS, removeRunWorktree, } from "./worktree.js";
21
+ function parseArgs(argv) {
22
+ const args = { mode: "create", keepBranch: false, stale: false, json: false };
23
+ let index = 0;
24
+ // Подкоманда необязательна: старые обёртки вызывают помощник без неё.
25
+ if (argv[0] === "create" || argv[0] === "cleanup") {
26
+ args.mode = argv[0];
27
+ index = 1;
28
+ }
29
+ for (; index < argv.length; index += 1) {
30
+ const flag = argv[index];
31
+ const value = argv[index + 1];
32
+ switch (flag) {
33
+ case "--json":
34
+ args.json = true;
35
+ break;
36
+ case "--keep-branch":
37
+ args.keepBranch = true;
38
+ break;
39
+ case "--stale":
40
+ args.stale = true;
41
+ break;
42
+ case "--repo":
43
+ case "--task":
44
+ case "--root":
45
+ case "--path":
46
+ case "--branch":
47
+ case "--max-age-hours": {
48
+ if (!value || value.startsWith("--")) {
49
+ return { args, error: `Флаг ${flag} требует значение.` };
50
+ }
51
+ if (flag === "--repo")
52
+ args.repo = value;
53
+ if (flag === "--task")
54
+ args.task = value;
55
+ if (flag === "--root")
56
+ args.root = value;
57
+ if (flag === "--path")
58
+ args.path = value;
59
+ if (flag === "--branch")
60
+ args.branch = value;
61
+ if (flag === "--max-age-hours") {
62
+ const hours = Number(value);
63
+ if (!Number.isFinite(hours) || hours < 0) {
64
+ return { args, error: "Флаг --max-age-hours требует неотрицательное число." };
65
+ }
66
+ args.maxAgeHours = hours;
67
+ }
68
+ index += 1;
69
+ break;
70
+ }
71
+ default:
72
+ return { args, error: `Неизвестный аргумент: ${flag}` };
73
+ }
74
+ }
75
+ return { args };
76
+ }
77
+ function usage() {
78
+ return [
79
+ "Использование:",
80
+ " worktree-run.js --repo <dir> --task <name> [--root <dir>] [--json]",
81
+ " worktree-run.js create --repo <dir> --task <name> [--root <dir>] [--json]",
82
+ " worktree-run.js cleanup --path <worktree> [--repo <root>] [--root <dir>] [--keep-branch] [--json]",
83
+ " worktree-run.js cleanup --stale [--root <dir>] [--max-age-hours <n>] [--json]",
84
+ ].join("\n");
85
+ }
86
+ async function runCreate(args) {
87
+ if (!args.repo || !args.task) {
88
+ process.stderr.write(`[worktree] ${usage()}\n`);
89
+ return 1;
90
+ }
91
+ // W-2.2: попутная уборка остатков. Не влияет на создание: ошибки уборки
92
+ // игнорируются, свежие worktree не трогаются.
93
+ await cleanupStaleWorktrees({ rootDir: args.root }).catch(() => undefined);
94
+ const result = await createRunWorktree({
95
+ repoDir: args.repo,
96
+ taskName: args.task,
97
+ rootDir: args.root,
98
+ });
99
+ if (!result.ok) {
100
+ process.stderr.write(`[worktree] ${result.error}\n`);
101
+ return 1;
102
+ }
103
+ process.stdout.write(args.json ? `${JSON.stringify(result.worktree)}\n` : `${result.worktree.path}\n`);
104
+ return 0;
105
+ }
106
+ async function runCleanup(args) {
107
+ if (args.stale && args.path) {
108
+ process.stderr.write("[worktree] Нельзя совмещать --stale и --path.\n");
109
+ return 1;
110
+ }
111
+ if (args.stale) {
112
+ const summary = await cleanupStaleWorktrees({
113
+ rootDir: args.root,
114
+ maxAgeMs: args.maxAgeHours === undefined
115
+ ? DEFAULT_STALE_AFTER_MS
116
+ : args.maxAgeHours * 60 * 60 * 1000,
117
+ });
118
+ process.stdout.write(args.json
119
+ ? `${JSON.stringify(summary)}\n`
120
+ : `[worktree] Удалено: ${summary.removed.length}, пропущено: ${summary.skipped.length}, sidecar: ${summary.pruned.length}, ошибок: ${summary.errors.length}${summary.locked ? " (уборка уже выполняется)" : ""}\n`);
121
+ if (summary.errors.length > 0) {
122
+ for (const error of summary.errors)
123
+ process.stderr.write(`[worktree] ${error}\n`);
124
+ return 1;
125
+ }
126
+ return 0;
127
+ }
128
+ if (!args.path) {
129
+ process.stderr.write(`[worktree] ${usage()}\n`);
130
+ return 1;
131
+ }
132
+ const result = await removeRunWorktree({
133
+ path: args.path,
134
+ repoRoot: args.repo,
135
+ branch: args.branch,
136
+ rootDir: args.root,
137
+ deleteBranch: !args.keepBranch,
138
+ });
139
+ if (!result.ok) {
140
+ process.stderr.write(`[worktree] ${result.error}\n`);
141
+ return 1;
142
+ }
143
+ if (args.json)
144
+ process.stdout.write(`${JSON.stringify({ ok: true, path: args.path })}\n`);
145
+ return 0;
146
+ }
147
+ /** Точка входа для тестов: возвращает exit code, ничего не завершает. */
148
+ export async function main(argv = process.argv.slice(2)) {
149
+ const parsed = parseArgs(argv);
150
+ if (parsed.error) {
151
+ process.stderr.write(`[worktree] ${parsed.error}\n`);
152
+ return 1;
153
+ }
154
+ return parsed.args.mode === "cleanup" ? runCleanup(parsed.args) : runCreate(parsed.args);
155
+ }
156
+ const invokedPath = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : "";
157
+ if (import.meta.url === invokedPath) {
158
+ main().then((code) => {
159
+ process.exitCode = code;
160
+ }, (err) => {
161
+ process.stderr.write(`[worktree] ${err instanceof Error ? err.message : String(err)}\n`);
162
+ process.exitCode = 1;
163
+ });
164
+ }
@@ -0,0 +1,115 @@
1
+ /** Каталог одноразовых worktree. Лежит рядом с prompts/logs и вне репозитория. */
2
+ export declare const WORKTREE_ROOT_DIR: string;
3
+ /** Описание созданного worktree. */
4
+ export interface RunWorktree {
5
+ /** Абсолютный путь рабочей копии. */
6
+ path: string;
7
+ /** Ветка, созданная под запуск. */
8
+ branch: string;
9
+ /** Корень основного репозитория. */
10
+ repoRoot: string;
11
+ /** Коммит, от которого создан worktree. */
12
+ baseCommit: string;
13
+ /** Время создания (ISO-8601). */
14
+ createdAt: string;
15
+ /** Корень, в котором создан worktree (для безопасной очистки). */
16
+ rootDir: string;
17
+ }
18
+ export type CreateWorktreeResult = {
19
+ ok: true;
20
+ worktree: RunWorktree;
21
+ } | {
22
+ ok: false;
23
+ error: string;
24
+ };
25
+ export interface CreateWorktreeOptions {
26
+ /** Рабочая директория задачи: репозиторий (или его подкаталог). */
27
+ repoDir: string;
28
+ /** Имя задачи — основа для пути и ветки. */
29
+ taskName: string;
30
+ /** Куда создавать worktree. По умолчанию PLUGIN_DIR/worktrees. */
31
+ rootDir?: string;
32
+ /** Базовая ссылка (ветка/коммит). По умолчанию HEAD. */
33
+ baseRef?: string;
34
+ }
35
+ /**
36
+ * Возвращает корень git-репозитория для `dir` или null, если это не репозиторий.
37
+ * Работает и для подкаталога, и для уже связанного worktree.
38
+ */
39
+ export declare function isGitRepository(dir: string): Promise<string | null>;
40
+ /**
41
+ * Ошибки, которые стоит перепробовать: гонки lock-файлов и ANTIVIRUS/FS.
42
+ *
43
+ * W-2: общий `No such file` убран из списка. Он маскировал отсутствующий
44
+ * `baseRef` и повреждённый репозиторий под транзиентную гонку: `addWorktree`
45
+ * делал 3 попытки с задержками 50 + 100 мс, а затем возвращал ту же ошибку.
46
+ * Гонки lock-файлов по-прежнему распознаются по `index.lock`, `cannot lock ref`
47
+ * и `Unable to create` — `No such file` может встречаться внутри их текста,
48
+ * но сам по себе больше не является признаком транзиентности.
49
+ */
50
+ export declare function isTransientGitError(message: string): boolean;
51
+ /**
52
+ * Создаёт одноразовый worktree под запуск задачи.
53
+ *
54
+ * Никогда не бросает: ошибки git и файловой системы возвращаются как
55
+ * `{ok:false, error}` — обёртка должна упасть fail-closed с понятным сообщением.
56
+ */
57
+ export declare function createRunWorktree(options: CreateWorktreeOptions): Promise<CreateWorktreeResult>;
58
+ /** Результат удаления одного worktree. */
59
+ export type RemoveWorktreeResult = {
60
+ ok: true;
61
+ } | {
62
+ ok: false;
63
+ error: string;
64
+ };
65
+ export interface RemoveWorktreeOptions {
66
+ /** Абсолютный путь рабочей копии. */
67
+ path: string;
68
+ /** Корень основного репозитория (иначе берётся из sidecar). */
69
+ repoRoot?: string;
70
+ /** Ветка запуска (иначе берётся из sidecar). */
71
+ branch?: string;
72
+ /** Корень worktree (иначе берётся из sidecar или WORKTREE_ROOT_DIR). */
73
+ rootDir?: string;
74
+ /** Удалять ли ветку запуска. По умолчанию true. */
75
+ deleteBranch?: boolean;
76
+ }
77
+ /**
78
+ * Удаляет созданный плагином worktree и его ветку.
79
+ *
80
+ * Защита W-2.2: удаляется только путь внутри каталога worktree, только
81
+ * зарегистрированный в git (или оставшийся каталог со sidecar) и только
82
+ * ветка с префиксом `agent-steward/`. Повторный вызов идемпотентен.
83
+ */
84
+ export declare function removeRunWorktree(options: RemoveWorktreeOptions): Promise<RemoveWorktreeResult>;
85
+ /** Сколько живёт lock уборки, прежде чем считать его осиротевшим. */
86
+ export declare const CLEANUP_LOCK_STALE_MS: number;
87
+ /** По умолчанию осиротевшим считается worktree старше суток. */
88
+ export declare const DEFAULT_STALE_AFTER_MS: number;
89
+ export interface StaleCleanupOptions {
90
+ rootDir?: string;
91
+ /** Возраст, после которого worktree считается остатком. */
92
+ maxAgeMs?: number;
93
+ /** Текущее время (для тестов). */
94
+ now?: number;
95
+ }
96
+ export interface StaleCleanupResult {
97
+ /** Удалённые рабочие копии. */
98
+ removed: string[];
99
+ /** Свежие worktree, которые трогать нельзя. */
100
+ skipped: string[];
101
+ /** Sidecar без рабочей копии — убраны. */
102
+ pruned: string[];
103
+ errors: string[];
104
+ /** Уборку уже выполняет другой процесс. */
105
+ locked: boolean;
106
+ }
107
+ /**
108
+ * Убирает осиротевшие worktree старше `maxAgeMs` и sidecar без рабочей копии.
109
+ *
110
+ * Гонки W-2.2: уборка сериализуется каталогом `.cleanup-lock`; свежие worktree
111
+ * (моложе порога) не трогаются, поэтому активный запуск не будет удалён.
112
+ * Каталоги без sidecar не удаляются — это чужие данные.
113
+ */
114
+ export declare function cleanupStaleWorktrees(options?: StaleCleanupOptions): Promise<StaleCleanupResult>;
115
+ //# sourceMappingURL=worktree.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/core/worktree.ts"],"names":[],"mappings":"AAoBA,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAqC,CAAC;AAcpE,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8BD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKzE;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI5D;AAkDD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA4D/B;AAKD,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAqED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAmG/B;AAED,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,QAAiB,CAAC;AAEpD,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;CACjB;AAgCD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA6E7B"}