agent-steward 0.0.2 → 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 (263) hide show
  1. package/CHANGELOG.md +45 -2
  2. package/CROSS_PLATFORM.md +11 -9
  3. package/README.md +11 -10
  4. package/ROADMAP-STRATEGY.md +93 -44
  5. package/ROADMAP.md +148 -1017
  6. package/dist/core/cron-to-schtasks.d.ts +0 -8
  7. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  8. package/dist/core/cron-to-schtasks.js +11 -86
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +19 -2
  14. package/dist/core/file-watcher.js +9 -9
  15. package/dist/core/git-trigger.js +4 -4
  16. package/dist/core/lock.d.ts +20 -4
  17. package/dist/core/lock.d.ts.map +1 -1
  18. package/dist/core/lock.js +99 -26
  19. package/dist/core/one-shot.d.ts +31 -5
  20. package/dist/core/one-shot.d.ts.map +1 -1
  21. package/dist/core/one-shot.js +78 -10
  22. package/dist/core/opencode-cli.d.ts +28 -0
  23. package/dist/core/opencode-cli.d.ts.map +1 -0
  24. package/dist/core/opencode-cli.js +74 -0
  25. package/dist/core/opencode-models.d.ts +62 -0
  26. package/dist/core/opencode-models.d.ts.map +1 -0
  27. package/dist/core/opencode-models.js +277 -0
  28. package/dist/core/otel.js +2 -2
  29. package/dist/core/ps-wrapper.d.ts +1 -1
  30. package/dist/core/ps-wrapper.d.ts.map +1 -1
  31. package/dist/core/ps-wrapper.js +66 -36
  32. package/dist/core/record-history.d.ts +15 -0
  33. package/dist/core/record-history.d.ts.map +1 -1
  34. package/dist/core/record-history.js +78 -54
  35. package/dist/core/router/dispatch.d.ts +36 -0
  36. package/dist/core/router/dispatch.d.ts.map +1 -0
  37. package/dist/core/router/dispatch.js +59 -0
  38. package/dist/core/router/escalation.d.ts +47 -0
  39. package/dist/core/router/escalation.d.ts.map +1 -0
  40. package/dist/core/router/escalation.js +87 -0
  41. package/dist/core/router/planner.d.ts +53 -0
  42. package/dist/core/router/planner.d.ts.map +1 -0
  43. package/dist/core/router/planner.js +113 -0
  44. package/dist/core/router/rules.d.ts +46 -0
  45. package/dist/core/router/rules.d.ts.map +1 -0
  46. package/dist/core/router/rules.js +85 -0
  47. package/dist/core/run-panel-api.d.ts +94 -0
  48. package/dist/core/run-panel-api.d.ts.map +1 -0
  49. package/dist/core/run-panel-api.js +169 -0
  50. package/dist/core/schedule-gate.js +5 -1
  51. package/dist/core/schedule-v2.d.ts +36 -2
  52. package/dist/core/schedule-v2.d.ts.map +1 -1
  53. package/dist/core/schedule-v2.js +98 -12
  54. package/dist/core/scheduler/at-fallback.d.ts +95 -0
  55. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  56. package/dist/core/scheduler/at-fallback.js +200 -0
  57. package/dist/core/scheduler/linux.d.ts +13 -2
  58. package/dist/core/scheduler/linux.d.ts.map +1 -1
  59. package/dist/core/scheduler/linux.js +67 -13
  60. package/dist/core/scheduler/mac.d.ts +14 -8
  61. package/dist/core/scheduler/mac.d.ts.map +1 -1
  62. package/dist/core/scheduler/mac.js +71 -22
  63. package/dist/core/scheduler/posix.d.ts.map +1 -1
  64. package/dist/core/scheduler/posix.js +37 -2
  65. package/dist/core/scheduler/registry.d.ts +13 -0
  66. package/dist/core/scheduler/registry.d.ts.map +1 -1
  67. package/dist/core/scheduler/registry.js +83 -21
  68. package/dist/core/scheduler/run-now.d.ts +16 -0
  69. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  70. package/dist/core/scheduler/run-now.js +28 -0
  71. package/dist/core/scheduler/windows.d.ts +16 -3
  72. package/dist/core/scheduler/windows.d.ts.map +1 -1
  73. package/dist/core/scheduler/windows.js +249 -96
  74. package/dist/core/secrets.d.ts.map +1 -1
  75. package/dist/core/secrets.js +127 -30
  76. package/dist/core/self-analysis.js +55 -55
  77. package/dist/core/session.d.ts.map +1 -1
  78. package/dist/core/session.js +18 -11
  79. package/dist/core/summary.js +1 -1
  80. package/dist/core/task-name.d.ts +24 -0
  81. package/dist/core/task-name.d.ts.map +1 -0
  82. package/dist/core/task-name.js +40 -0
  83. package/dist/core/triage-chain.js +1 -1
  84. package/dist/core/triage-worker.js +2 -2
  85. package/dist/core/triage.js +1 -1
  86. package/dist/core/wrappers/bash.d.ts.map +1 -1
  87. package/dist/core/wrappers/bash.js +82 -37
  88. package/dist/db/capability-repo.d.ts +83 -0
  89. package/dist/db/capability-repo.d.ts.map +1 -0
  90. package/dist/db/capability-repo.js +182 -0
  91. package/dist/db/history-repo.d.ts +8 -0
  92. package/dist/db/history-repo.d.ts.map +1 -1
  93. package/dist/db/history-repo.js +19 -0
  94. package/dist/db/index.d.ts +6 -0
  95. package/dist/db/index.d.ts.map +1 -1
  96. package/dist/db/index.js +48 -2
  97. package/dist/db/migrate.d.ts.map +1 -1
  98. package/dist/db/migrate.js +3 -1
  99. package/dist/db/run-context.d.ts +103 -0
  100. package/dist/db/run-context.d.ts.map +1 -0
  101. package/dist/db/run-context.js +224 -0
  102. package/dist/db/run-dlq.d.ts +100 -0
  103. package/dist/db/run-dlq.d.ts.map +1 -0
  104. package/dist/db/run-dlq.js +191 -0
  105. package/dist/db/run-journal.d.ts +60 -0
  106. package/dist/db/run-journal.d.ts.map +1 -0
  107. package/dist/db/run-journal.js +143 -0
  108. package/dist/db/run-resume.d.ts +51 -0
  109. package/dist/db/run-resume.d.ts.map +1 -0
  110. package/dist/db/run-resume.js +156 -0
  111. package/dist/db/runs-repo.d.ts +128 -0
  112. package/dist/db/runs-repo.d.ts.map +1 -0
  113. package/dist/db/runs-repo.js +342 -0
  114. package/dist/db/schema.d.ts +16 -2
  115. package/dist/db/schema.d.ts.map +1 -1
  116. package/dist/db/schema.js +342 -35
  117. package/dist/db/settings-repo.d.ts +11 -0
  118. package/dist/db/settings-repo.d.ts.map +1 -1
  119. package/dist/db/settings-repo.js +25 -0
  120. package/dist/db/step-idempotency.d.ts +51 -0
  121. package/dist/db/step-idempotency.d.ts.map +1 -0
  122. package/dist/db/step-idempotency.js +136 -0
  123. package/dist/index.d.ts +5 -5
  124. package/dist/index.d.ts.map +1 -1
  125. package/dist/index.js +168 -40
  126. package/dist/notifications.js +18 -18
  127. package/dist/profiles.d.ts +7 -3
  128. package/dist/profiles.d.ts.map +1 -1
  129. package/dist/profiles.js +85 -7
  130. package/dist/rpc.d.ts +787 -0
  131. package/dist/rpc.d.ts.map +1 -1
  132. package/dist/rpc.js +324 -0
  133. package/dist/server.d.ts +33 -2
  134. package/dist/server.d.ts.map +1 -1
  135. package/dist/server.js +115 -54
  136. package/dist/shared/jobs-view.d.ts.map +1 -1
  137. package/dist/skill.js +1 -1
  138. package/dist/task-transfer.d.ts +1 -1
  139. package/dist/task-transfer.d.ts.map +1 -1
  140. package/dist/task-transfer.js +14 -10
  141. package/dist/types.d.ts +20 -4
  142. package/dist/types.d.ts.map +1 -1
  143. package/dist/types.js +44 -9
  144. package/dist/workspaces.d.ts +25 -3
  145. package/dist/workspaces.d.ts.map +1 -1
  146. package/dist/workspaces.js +44 -9
  147. package/docs/ARCHITECTURE.md +335 -9
  148. package/docs/COMPATIBILITY.md +10 -6
  149. package/docs/CONCEPT.md +183 -91
  150. package/docs/CROSS_PLATFORM.ru.md +11 -9
  151. package/docs/CROSS_PLATFORM.zh.md +11 -9
  152. package/docs/EXECUTION-LOOP.md +196 -0
  153. package/docs/FAQ.md +2 -2
  154. package/docs/FAQ.ru.md +2 -2
  155. package/docs/FAQ.zh.md +2 -2
  156. package/docs/FEATURES.md +5 -4
  157. package/docs/FEATURES.zh.md +5 -4
  158. package/docs/MIGRATION.md +34 -26
  159. package/docs/README.ru.md +27 -8
  160. package/docs/README.zh.md +11 -10
  161. package/docs/SAFETY.md +122 -0
  162. package/docs/SAVINGS.md +29 -0
  163. package/docs/SAVINGS.ru.md +29 -0
  164. package/docs/SAVINGS.zh.md +18 -0
  165. package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
  166. package/gui-experimental.cjs +8 -8
  167. package/index.js +1 -0
  168. package/locales/en.json +68 -0
  169. package/locales/ru.json +68 -0
  170. package/locales/zh.json +68 -0
  171. package/package.json +57 -11
  172. package/scripts/audit-bundle.mjs +215 -0
  173. package/src/core/analytics.ts +2 -2
  174. package/src/core/audit.ts +17 -17
  175. package/src/core/cron-to-schtasks.ts +14 -93
  176. package/src/core/dlq-api.ts +98 -0
  177. package/src/core/dry-run.ts +51 -27
  178. package/src/core/file-watcher.ts +17 -17
  179. package/src/core/git-trigger.ts +9 -9
  180. package/src/core/glob.ts +1 -1
  181. package/src/core/local-ai.ts +2 -2
  182. package/src/core/lock.ts +104 -31
  183. package/src/core/matrix.ts +31 -31
  184. package/src/core/native-notify.ts +2 -2
  185. package/src/core/one-shot.ts +91 -13
  186. package/src/core/opencode-cli.ts +103 -0
  187. package/src/core/opencode-models.ts +315 -0
  188. package/src/core/otel.ts +4 -4
  189. package/src/core/permissions.ts +5 -5
  190. package/src/core/prometheus.ts +17 -17
  191. package/src/core/ps-wrapper.ts +68 -38
  192. package/src/core/record-history.ts +114 -76
  193. package/src/core/retention.ts +3 -3
  194. package/src/core/router/dispatch.ts +94 -0
  195. package/src/core/router/escalation.ts +129 -0
  196. package/src/core/router/planner.ts +166 -0
  197. package/src/core/router/rules.ts +109 -0
  198. package/src/core/run-panel-api.ts +262 -0
  199. package/src/core/savings.ts +1 -1
  200. package/src/core/schedule-gate.ts +17 -13
  201. package/src/core/schedule-v2.ts +138 -29
  202. package/src/core/scheduler/at-fallback.ts +298 -0
  203. package/src/core/scheduler/index.ts +3 -3
  204. package/src/core/scheduler/linux.ts +92 -19
  205. package/src/core/scheduler/logs.ts +1 -1
  206. package/src/core/scheduler/mac.ts +112 -60
  207. package/src/core/scheduler/posix.ts +35 -2
  208. package/src/core/scheduler/registry.ts +109 -26
  209. package/src/core/scheduler/run-now.ts +32 -0
  210. package/src/core/scheduler/windows.ts +295 -125
  211. package/src/core/secrets.ts +139 -39
  212. package/src/core/self-analysis.ts +61 -61
  213. package/src/core/session.ts +26 -13
  214. package/src/core/structured-log.ts +3 -3
  215. package/src/core/summary.ts +25 -25
  216. package/src/core/task-name.ts +67 -0
  217. package/src/core/telegram.ts +16 -16
  218. package/src/core/triage-chain.ts +4 -4
  219. package/src/core/triage-compare.ts +8 -8
  220. package/src/core/triage-rules.ts +4 -4
  221. package/src/core/triage-shadow.ts +7 -7
  222. package/src/core/triage-worker.ts +6 -6
  223. package/src/core/triage.ts +23 -23
  224. package/src/core/watch-paths.ts +1 -1
  225. package/src/core/wrappers/bash.ts +90 -45
  226. package/src/db/capability-repo.ts +285 -0
  227. package/src/db/git-state-repo.ts +1 -1
  228. package/src/db/history-repo.ts +44 -22
  229. package/src/db/index.ts +53 -7
  230. package/src/db/metrics-repo.ts +10 -10
  231. package/src/db/migrate.ts +13 -11
  232. package/src/db/recovery.ts +3 -3
  233. package/src/db/run-context.ts +370 -0
  234. package/src/db/run-dlq.ts +310 -0
  235. package/src/db/run-journal.ts +212 -0
  236. package/src/db/run-resume.ts +256 -0
  237. package/src/db/runs-repo.ts +504 -0
  238. package/src/db/schema.ts +357 -44
  239. package/src/db/settings-repo.ts +33 -2
  240. package/src/db/step-idempotency.ts +185 -0
  241. package/src/db/tasks-repo.ts +10 -10
  242. package/src/db/templates-repo.ts +7 -7
  243. package/src/gui.tsx +516 -1
  244. package/src/history.ts +4 -4
  245. package/src/i18n.ts +7 -7
  246. package/src/index.ts +465 -308
  247. package/src/integrations.ts +6 -6
  248. package/src/notifications.ts +76 -76
  249. package/src/profiles.ts +98 -7
  250. package/src/rpc.ts +347 -1
  251. package/src/schtasks.ts +2 -2
  252. package/src/server.ts +155 -78
  253. package/src/settings.ts +44 -44
  254. package/src/shared/jobs-view.ts +60 -60
  255. package/src/skill.ts +1 -1
  256. package/src/task-transfer.ts +58 -56
  257. package/src/templates.ts +1 -1
  258. package/src/types.ts +54 -10
  259. package/src/workspaces.ts +73 -24
  260. package/dist/core/self-analysis.test.d.ts +0 -2
  261. package/dist/core/self-analysis.test.d.ts.map +0 -1
  262. package/dist/core/self-analysis.test.js +0 -219
  263. package/dist/gui-experimental.cjs +0 -1
package/dist/types.js CHANGED
@@ -1,20 +1,27 @@
1
1
  import path from "node:path";
2
2
  import { z } from "zod";
3
3
  import { getProfileDir, getProfileName } from "./profiles.js";
4
- /** Префикс всех задач плагина (историческое имя, сохраняется для совместимости). */
5
- export const TASK_PREFIX = "OpenCode\\windows-scheduler";
6
4
  /** Папка задач плагина в планировщике ОС (Windows). */
7
5
  export const TASK_FOLDER = "OpenCode";
8
6
  /**
9
7
  * Имя папки/блока задач. У нестандартного профиля своё пространство имён,
10
8
  * иначе профили делят одну папку Планировщика Windows и один блок crontab.
11
- * Для default сохраняем историческое имя (совместимость с уже созданными
12
- * задачами и обновлением плагина).
9
+ * Новое имя — agent-steward; историческое windows-scheduler поддерживается
10
+ * как legacy (см. legacyTaskFolderNameForProfile).
13
11
  */
14
12
  export function taskFolderNameForProfile(profile = getProfileName()) {
13
+ return profile === "default" ? "agent-steward" : `agent-steward-${profile}`;
14
+ }
15
+ /** Историческое имя папки/блока задач — для чтения и удаления старых задач. */
16
+ export function legacyTaskFolderNameForProfile(profile = getProfileName()) {
15
17
  return profile === "default" ? "windows-scheduler" : `windows-scheduler-${profile}`;
16
18
  }
17
19
  export const TASK_FOLDER_NAME = taskFolderNameForProfile();
20
+ export const LEGACY_TASK_FOLDER_NAME = legacyTaskFolderNameForProfile();
21
+ /** Префикс всех задач плагина. */
22
+ export const TASK_PREFIX = `OpenCode\\${TASK_FOLDER_NAME}`;
23
+ /** Исторический префикс задач (до переименования). */
24
+ export const LEGACY_TASK_PREFIX = `OpenCode\\${LEGACY_TASK_FOLDER_NAME}`;
18
25
  /**
19
26
  * Директория для хранения файлов плагина (обёртки, логи, блокировки, история).
20
27
  *
@@ -53,6 +60,27 @@ export function sanitizeName(name) {
53
60
  result = result.replace(/-+/g, "-").replace(/^-+|-+$/g, "");
54
61
  return result || "task";
55
62
  }
63
+ /**
64
+ * Проверяет идентификатор LLM-модели перед подстановкой в командную строку.
65
+ *
66
+ * Формат: `provider/model` (вариант — `provider/model#variant`).
67
+ * Разрешены только латиница, цифры и символы `. _ : / -` (плюс `#` для
68
+ * варианта). Это исключает PowerShell-subexpression (`$(...)`, backtick)
69
+ * и прочие спецсимволы. Пустая строка — «модель не задана», это допустимо.
70
+ *
71
+ * @returns текст ошибки или null, если значение допустимо.
72
+ */
73
+ export function validateModelId(raw) {
74
+ const model = raw.trim();
75
+ if (!model)
76
+ return null;
77
+ if (!/^[A-Za-z0-9._:/-]+(?:#[A-Za-z0-9._-]+)?$/.test(model)) {
78
+ return (`Недопустимый идентификатор модели «${raw}». ` +
79
+ "Разрешены латиница, цифры и символы «.», «_», «:», «/», «-» " +
80
+ "(вариант — через «#»).");
81
+ }
82
+ return null;
83
+ }
56
84
  /**
57
85
  * Проверяет имя задачи до создания файлов и записи в БД.
58
86
  *
@@ -68,10 +96,17 @@ export function validateTaskName(raw) {
68
96
  if (!name) {
69
97
  return "Имя задачи не может быть пустым.";
70
98
  }
99
+ // P1-10.T1.3: имена из одних разделителей («---», «...», «.») после
100
+ // sanitizeName превращаются в «task» и молча конфликтуют с реальной
101
+ // задачей «task». Требуем хотя бы одну букву или цифру.
102
+ if (!/[\p{L}\p{N}]/u.test(name)) {
103
+ return (`Имя задачи «${name}» не содержит букв или цифр: после нормализации ` +
104
+ "оно стало бы «task». Добавьте буквы или цифры.");
105
+ }
71
106
  if (/[\u0000-\u001f\u007f]/.test(name)) {
72
107
  return "Имя задачи не должно содержать управляющие символы.";
73
108
  }
74
- const invalid = name.match(/[^\p{L}\p{N}_\-. ]/u);
109
+ const invalid = /[^\p{L}\p{N}_\-. ]/u.exec(name);
75
110
  if (invalid) {
76
111
  return (`Имя задачи содержит недопустимый символ «${invalid[0]}». ` +
77
112
  "Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».");
@@ -79,13 +114,13 @@ export function validateTaskName(raw) {
79
114
  // schtasks ограничивает /tn в 237 символов вместе с полным путём задачи.
80
115
  // Полный путь: \OpenCode\<TASK_FOLDER_NAME>\<taskName>
81
116
  // leading \ + TASK_FOLDER + \ + TASK_FOLDER_NAME + \ — префикс перед именем задачи.
82
- // Для default: \OpenCode\windows-scheduler\ = 30 символов → 207 на имя.
83
- // Для не-default профиля: \OpenCode\windows-scheduler-<profile>\ →чем длиннее профиль, тем меньше места.
117
+ // Для default: \OpenCode\agent-steward\ = 24 символа → 213 на имя.
118
+ // Для не-default профиля: \OpenCode\agent-steward-<profile>\ → чем длиннее профиль, тем меньше места.
84
119
  const prefixLength = 1 + TASK_FOLDER.length + 1 + TASK_FOLDER_NAME.length + 1;
85
120
  const MAX_TASK_NAME_LENGTH = 237 - prefixLength;
86
121
  if (name.length > MAX_TASK_NAME_LENGTH) {
87
122
  return (`Имя задачи "${name}" слишком длинное (${name.length} символов, максимум ${MAX_TASK_NAME_LENGTH} ` +
88
- `с учётом папки планировщика). Сократите имя или имя workspace (для клонов матрицы).`);
123
+ "с учётом папки планировщика). Сократите имя или имя workspace (для клонов матрицы).");
89
124
  }
90
125
  return null;
91
126
  }
@@ -103,7 +138,7 @@ export const ScheduleJobArgs = z.object({
103
138
  ctx.addIssue({ code: z.ZodIssueCode.custom, message: error });
104
139
  }
105
140
  })
106
- .describe("Имя задачи (уникально в рамках префикса OpenCode\\windows-scheduler)"),
141
+ .describe("Имя задачи (уникально в рамках префикса OpenCode\\agent-steward; legacy OpenCode\\windows-scheduler поддерживается)"),
107
142
  schedule: z
108
143
  .string()
109
144
  .min(1)
@@ -48,11 +48,28 @@ export declare function normalizeWorkspaceEnv(value: unknown): Record<string, st
48
48
  export declare function parseEnvFileContent(content: string): Record<string, string>;
49
49
  /** Читает .env-файл workspace (если он задан и существует). */
50
50
  export declare function readWorkspaceEnvFile(envFile?: string): Record<string, string>;
51
+ /** Ошибка конфигурации: в env workspace остались неразрешённые `${secret:NAME}`. */
52
+ export declare class MissingWorkspaceSecretsError extends Error {
53
+ readonly workspaceName: string;
54
+ readonly secrets: string[];
55
+ constructor(workspaceName: string, secrets: string[]);
56
+ }
57
+ interface ResolvedWorkspaceEnv {
58
+ env: Record<string, string>;
59
+ missing: string[];
60
+ }
61
+ /**
62
+ * Итоговые env-переменные workspace вместе со списком отсутствующих секретов.
63
+ * Ссылки `${secret:NAME}` не подменяются пустой строкой: имя попадает в
64
+ * `missing`, а сама ссылка остаётся в env — вызывающая сторона решает,
65
+ * прервать запуск или только предупредить.
66
+ */
67
+ export declare function resolveWorkspaceEnvDetailed(workspace: Workspace | undefined, allowedSecretNames?: string[]): ResolvedWorkspaceEnv;
51
68
  /**
52
69
  * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
53
- * (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
54
- * зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
55
- * строку и предупреждение с именем — без значения. Никогда не бросает.
70
+ * (пары важнее файла). Отсутствующий секрет даёт предупреждение с именем,
71
+ * но не значение. Никогда не бросает — для запуска задачи используйте
72
+ * writeWorkspaceEnvFile(), который в этом случае отказывает.
56
73
  */
57
74
  export declare function resolveWorkspaceEnv(workspace: Workspace | undefined, allowedSecretNames?: string[]): Record<string, string>;
58
75
  /** Маскирует значение секрета для логов. */
@@ -73,6 +90,10 @@ export declare function workspaceEnvDir(pluginDir: string): string;
73
90
  *
74
91
  * Возвращает путь к файлу или undefined, если у workspace нет переменных.
75
92
  * Пустой env удаляет ранее созданный файл. На POSIX права 0600.
93
+ *
94
+ * Если хотя бы один `${secret:NAME}` не разрешён, старый env-файл удаляется
95
+ * и бросается MissingWorkspaceSecretsError: задача не должна запускаться с
96
+ * литералом `${secret:...}` вместо значения (P2-21).
76
97
  */
77
98
  export declare function writeWorkspaceEnvFile(workspace: Workspace | undefined, pluginDir: string, sanitizedName: string, allowedSecretNames?: string[]): string | undefined;
78
99
  /** Проверяет, что путь существует и является директорией. */
@@ -110,4 +131,5 @@ export declare function updateWorkspace(id: string, patch: UpdateWorkspacePatch)
110
131
  export declare function deleteWorkspace(id: string): boolean;
111
132
  /** Количество workspace (для сводок и тестов). */
112
133
  export declare function countWorkspaces(): number;
134
+ export {};
113
135
  //# sourceMappingURL=workspaces.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}
@@ -87,22 +87,42 @@ export function readWorkspaceEnvFile(envFile) {
87
87
  return {};
88
88
  }
89
89
  }
90
+ /** Ошибка конфигурации: в env workspace остались неразрешённые `${secret:NAME}`. */
91
+ export class MissingWorkspaceSecretsError extends Error {
92
+ constructor(workspaceName, secrets) {
93
+ super(`Workspace "${workspaceName}": не найдены секреты: ${secrets.join(", ")}. ` +
94
+ "Запуск отменён, чтобы не подставлять литералы ${secret:...} в окружение задачи.");
95
+ this.name = "MissingWorkspaceSecretsError";
96
+ this.workspaceName = workspaceName;
97
+ this.secrets = secrets;
98
+ }
99
+ }
90
100
  /**
91
- * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
92
- * (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
93
- * зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
94
- * строку и предупреждение с именем — без значения. Никогда не бросает.
101
+ * Итоговые env-переменные workspace вместе со списком отсутствующих секретов.
102
+ * Ссылки `${secret:NAME}` не подменяются пустой строкой: имя попадает в
103
+ * `missing`, а сама ссылка остаётся в env — вызывающая сторона решает,
104
+ * прервать запуск или только предупредить.
95
105
  */
96
- export function resolveWorkspaceEnv(workspace, allowedSecretNames) {
106
+ export function resolveWorkspaceEnvDetailed(workspace, allowedSecretNames) {
97
107
  if (!workspace)
98
- return {};
108
+ return { env: {}, missing: [] };
99
109
  const merged = {
100
110
  ...readWorkspaceEnvFile(workspace.envFile),
101
111
  ...(workspace.env ?? {}),
102
112
  };
103
113
  const resolved = resolveSecretRefs(merged, allowedSecretNames);
114
+ return { env: resolved.env, missing: resolved.missing };
115
+ }
116
+ /**
117
+ * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
118
+ * (пары важнее файла). Отсутствующий секрет даёт предупреждение с именем,
119
+ * но не значение. Никогда не бросает — для запуска задачи используйте
120
+ * writeWorkspaceEnvFile(), который в этом случае отказывает.
121
+ */
122
+ export function resolveWorkspaceEnv(workspace, allowedSecretNames) {
123
+ const resolved = resolveWorkspaceEnvDetailed(workspace, allowedSecretNames);
104
124
  if (resolved.missing.length > 0) {
105
- console.warn(`[workspace] "${workspace.name}": не найдены секреты: ${resolved.missing.join(", ")}`);
125
+ console.warn(`[workspace] "${workspace?.name ?? ""}": не найдены секреты: ${resolved.missing.join(", ")}`);
106
126
  }
107
127
  return resolved.env;
108
128
  }
@@ -142,12 +162,27 @@ export function workspaceEnvDir(pluginDir) {
142
162
  *
143
163
  * Возвращает путь к файлу или undefined, если у workspace нет переменных.
144
164
  * Пустой env удаляет ранее созданный файл. На POSIX права 0600.
165
+ *
166
+ * Если хотя бы один `${secret:NAME}` не разрешён, старый env-файл удаляется
167
+ * и бросается MissingWorkspaceSecretsError: задача не должна запускаться с
168
+ * литералом `${secret:...}` вместо значения (P2-21).
145
169
  */
146
170
  export function writeWorkspaceEnvFile(workspace, pluginDir, sanitizedName, allowedSecretNames) {
147
171
  if (!workspace)
148
172
  return undefined;
149
173
  const file = join(workspaceEnvDir(pluginDir), `${sanitizedName}.env`);
150
- const env = resolveWorkspaceEnv(workspace, allowedSecretNames);
174
+ const { env, missing } = resolveWorkspaceEnvDetailed(workspace, allowedSecretNames);
175
+ if (missing.length > 0) {
176
+ // Fail closed: не оставляем старый файл, иначе обёртка продолжит
177
+ // подхватывать устаревшие значения секретов.
178
+ try {
179
+ rmSync(file, { force: true });
180
+ }
181
+ catch {
182
+ // файла нет — не ошибка
183
+ }
184
+ throw new MissingWorkspaceSecretsError(workspace.name, missing);
185
+ }
151
186
  const keys = Object.keys(env);
152
187
  if (!keys.length) {
153
188
  try {
@@ -381,7 +416,7 @@ export function deleteWorkspace(id) {
381
416
  if (affected.length > 0) {
382
417
  console.warn(`[workspace] Удалён workspace '${workspace.name}'. ` +
383
418
  `Отвязано задач: ${affected.length} (${affected.join(", ")}). ` +
384
- `Задачи не удалены, workspaceId очищен.`);
419
+ "Задачи не удалены, workspaceId очищен.");
385
420
  }
386
421
  const result = getDb().prepare("DELETE FROM workspaces WHERE id = ?").run(id);
387
422
  return Number(result.changes) > 0;