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/src/server.ts CHANGED
@@ -12,6 +12,13 @@ import { listWorkspaces } from "./workspaces.js";
12
12
  import { getProfileName, getProfilePort } from "./profiles.js";
13
13
  import { simulatePipeline } from "./core/dry-run.js";
14
14
  import { loadSettings } from "./settings.js";
15
+ import {
16
+ DEFAULT_MODEL_PRICE_PER_MILLION,
17
+ DEFAULT_PRICE_PER_MILLION,
18
+ catalogPricePerMillion,
19
+ normalizeModelId,
20
+ resolveWhatIfModels,
21
+ } from "./core/opencode-models.js";
15
22
  import {
16
23
  authenticateHookRequest,
17
24
  extractHookSignature,
@@ -158,25 +165,42 @@ export interface ModelAnalysis {
158
165
  successRate: number;
159
166
  }
160
167
 
168
+ /** Чтение JSON из переменной окружения с фолбэком на значение по умолчанию. */
169
+ function envJson<T>(name: string, fallback: T): T {
170
+ const raw = process.env[name];
171
+ if (!raw) return fallback;
172
+ try {
173
+ return JSON.parse(raw) as T;
174
+ } catch {
175
+ console.warn(
176
+ `[scheduler] Неверный JSON в переменной ${name}, используются значения по умолчанию.`,
177
+ );
178
+ return fallback;
179
+ }
180
+ }
181
+
182
+ /** Ручное переопределение цен: OPENCODE_SCHEDULER_MODEL_PRICES (JSON). */
183
+ const envModelPrices = envJson<Record<string, number>>(
184
+ "OPENCODE_SCHEDULER_MODEL_PRICES",
185
+ {},
186
+ );
187
+
161
188
  /**
162
- * Приблизительные цены моделей в USD за 1M токенов.
163
- * Используются для What-If-анализа, когда в логе нет точной стоимости.
189
+ * Цена модели за 1M токенов.
190
+ *
191
+ * Порядок: ручное переопределение → каталог цен OpenCode (models.dev) →
192
+ * встроенная таблица → средняя оценка.
164
193
  */
165
- const MODEL_PRICE_PER_MILLION: Record<string, number> = {
166
- "openai/gpt-4o": 10,
167
- "openai/gpt-4o-mini": 0.6,
168
- "deepseek/deepseek-coder": 0.28,
169
- "anthropic/claude-3-5-sonnet": 9,
170
- "anthropic/claude-3-5-haiku": 1.2,
171
- "google/gemini-2.5-pro": 3.5,
172
- "google/gemini-2.0-flash": 0.3,
173
- };
174
- const DEFAULT_PRICE_PER_MILLION = 3;
175
-
176
- /** Цена модели за 1M токенов (fallback — средняя оценка). */
177
- function modelPrice(model: string | undefined): number {
178
- const key = (model ?? "").trim().toLowerCase();
179
- return MODEL_PRICE_PER_MILLION[key] ?? DEFAULT_PRICE_PER_MILLION;
194
+ export function modelPrice(model: string | undefined): number {
195
+ const key = normalizeModelId(model);
196
+
197
+ const override = envModelPrices[key];
198
+ if (typeof override === "number" && Number.isFinite(override)) return override;
199
+
200
+ const fromOpencode = catalogPricePerMillion(key);
201
+ if (fromOpencode !== null) return fromOpencode;
202
+
203
+ return DEFAULT_MODEL_PRICE_PER_MILLION[key] ?? DEFAULT_PRICE_PER_MILLION;
180
204
  }
181
205
 
182
206
  /** Оценка стоимости запуска по токенам (если точная цена неизвестна). */
@@ -188,7 +212,7 @@ function estimateCost(tokens: number, model: string | undefined): number {
188
212
  * Агрегирует историю по моделям и считает сценарии What-If.
189
213
  * Возвращает данные для GET /api/models-analysis и блока дашборда.
190
214
  */
191
- function aggregateModels(
215
+ export function aggregateModels(
192
216
  history: {
193
217
  status: string;
194
218
  durationMs: number;
@@ -239,14 +263,33 @@ function aggregateModels(
239
263
  }))
240
264
  .sort((a, b) => b.totalRuns - a.totalRuns);
241
265
 
242
- const whatIfModels = ["openai/gpt-4o", "deepseek/deepseek-coder"];
243
- const whatIf = whatIfModels.map((model) => ({
266
+ // What-If: сначала модели, которые реально запускались, затем по одной
267
+ // модели на каждую цену из доступных в OpenCode. Явный список из
268
+ // окружения главнее.
269
+ const usedModels = models
270
+ .map((item) => item.model)
271
+ .filter((model) => model !== "по умолчанию");
272
+ const envWhatIfModels = envJson<string[] | null>(
273
+ "OPENCODE_SCHEDULER_WHAT_IF_MODELS",
274
+ null,
275
+ );
276
+ const selection =
277
+ Array.isArray(envWhatIfModels) && envWhatIfModels.length > 0
278
+ ? { models: envWhatIfModels, source: "env" as const }
279
+ : resolveWhatIfModels(usedModels);
280
+
281
+ const whatIf = selection.models.map((model) => ({
244
282
  model,
245
283
  pricePerMillion: modelPrice(model),
246
284
  cost: Number(((totalTokens * modelPrice(model)) / 1_000_000).toFixed(4)),
247
285
  }));
248
286
 
249
- return { models, totals: { totalRuns, totalTokens, totalCost: Number(totalCost.toFixed(6)) }, whatIf };
287
+ return {
288
+ models,
289
+ totals: { totalRuns, totalTokens, totalCost: Number(totalCost.toFixed(6)) },
290
+ whatIf,
291
+ whatIfSource: selection.source,
292
+ };
250
293
  }
251
294
 
252
295
  /**
@@ -1721,6 +1764,7 @@ function renderPage(): string {
1721
1764
  var updated = document.getElementById('updated');
1722
1765
  var allTasks = [];
1723
1766
  var allWorkspaces = [];
1767
+ var allAnalytics = null;
1724
1768
  var activeWorkspace = 'all';
1725
1769
  /** Раскрытые родители матриц (имя → true). */
1726
1770
  var expandedMatrixParents = {};
@@ -1732,6 +1776,8 @@ function renderPage(): string {
1732
1776
  // (HTTP 499), и тогда в консоли появляется ошибка при каждой загрузке.
1733
1777
  var preferSummaryMetrics = true;
1734
1778
  var metricsFallbackLogged = false;
1779
+ // P3-29: тяжёлая аналитика обновляется реже остальных блоков.
1780
+ var ANALYTICS_INTERVAL_MS = 60000;
1735
1781
 
1736
1782
  function esc(s) {
1737
1783
  var d = document.createElement('div');
@@ -2076,18 +2122,18 @@ function renderPage(): string {
2076
2122
  html += '</tbody></table>';
2077
2123
  box.innerHTML = html;
2078
2124
 
2079
- var gpt = null;
2080
- var deepseek = null;
2081
- for (var j = 0; j < whatIf.length; j++) {
2082
- if (whatIf[j].model === 'openai/gpt-4o') gpt = whatIf[j];
2083
- if (whatIf[j].model === 'deepseek/deepseek-coder') deepseek = whatIf[j];
2084
- }
2085
2125
  var parts = [];
2086
- if (gpt) {
2087
- parts.push('Если бы все запуски выполнялись через <b>openai/gpt-4o</b>, это стоило бы ~<b>' + money(gpt.cost) + '</b> (' + gpt.pricePerMillion + ' $/1M токенов).');
2126
+ var source = data && data.whatIfSource;
2127
+ if (source === 'opencode') {
2128
+ parts.push('Модели и цены — из OpenCode (ваши доступные модели):');
2129
+ } else if (source === 'history') {
2130
+ parts.push('Модели для сравнения — те, что уже запускались:');
2131
+ } else if (source === 'default') {
2132
+ parts.push('OpenCode недоступен, показаны модели по умолчанию:');
2088
2133
  }
2089
- if (deepseek) {
2090
- parts.push('Если через <b>deepseek/deepseek-coder</b> — <b>' + money(deepseek.cost) + '</b> (' + deepseek.pricePerMillion + ' $/1M токенов).');
2134
+ for (var j = 0; j < whatIf.length; j++) {
2135
+ var w = whatIf[j];
2136
+ parts.push('Если бы все запуски выполнялись через <b>' + esc(w.model) + '</b>, это стоило бы ~<b>' + money(w.cost) + '</b> (' + w.pricePerMillion + ' $/1M токенов).');
2091
2137
  }
2092
2138
  parts.push('Всего запусков: <b>' + totals.totalRuns + '</b>, токенов: <b>' + Number(totals.totalTokens || 0).toLocaleString('ru-RU') + '</b>, фактическая стоимость: <b>' + money(totals.totalCost) + '</b>.');
2093
2139
  text.innerHTML = parts.join(' ');
@@ -2314,7 +2360,7 @@ function renderPage(): string {
2314
2360
  }
2315
2361
 
2316
2362
  if (visible.length === 0) {
2317
- rows.innerHTML = '<tr><td colspan="9" class="empty">🎄 Задач пока нет. Самое время украсить ёлку!</td></tr>';
2363
+ rows.innerHTML = '<tr><td colspan="9" class="empty">' + EMPTY_TASKS_HTML + '</td></tr>';
2318
2364
  return;
2319
2365
  }
2320
2366
  var html = '';
@@ -2335,7 +2381,7 @@ function renderPage(): string {
2335
2381
  }
2336
2382
  }
2337
2383
  if (shown === 0) {
2338
- rows.innerHTML = '<tr><td colspan="9" class="empty">🎄 Задач пока нет. Самое время украсить ёлку!</td></tr>';
2384
+ rows.innerHTML = '<tr><td colspan="9" class="empty">' + EMPTY_TASKS_HTML + '</td></tr>';
2339
2385
  return;
2340
2386
  }
2341
2387
  rows.innerHTML = html;
@@ -2398,6 +2444,16 @@ function renderPage(): string {
2398
2444
  // Без него кросс-сайтовый fetch не пройдёт (нужен CORS-preflight, которого нет).
2399
2445
  var CLIENT_HEADERS = { 'X-Scheduler-Client': 'dashboard' };
2400
2446
 
2447
+ // P3-29: новогоднее оформление (снежинки и «украсить ёлку») — только по
2448
+ // явному флагу ?snow=1, чтобы не крутить 18 анимаций круглый год.
2449
+ var FESTIVE = false;
2450
+ try {
2451
+ FESTIVE = new URLSearchParams(location.search).get('snow') === '1';
2452
+ } catch (_) {}
2453
+ var EMPTY_TASKS_HTML = FESTIVE
2454
+ ? '🎄 Задач пока нет. Самое время украсить ёлку!'
2455
+ : 'Задач пока нет. Самое время создать!';
2456
+
2401
2457
  // Устойчивая загрузка: антивирусы иногда блокируют отдельные URL
2402
2458
  // (например, /api/metrics) статусом 499 и картинкой вместо JSON.
2403
2459
  // Один сбой не должен ломать весь дашборд.
@@ -2445,8 +2501,7 @@ function renderPage(): string {
2445
2501
  loadMetricsJson(),
2446
2502
  safeJson('/api/history', { records: [] }),
2447
2503
  safeJson('/api/models-analysis', { models: [], totals: {}, whatIf: [] }),
2448
- safeJson('/api/workspaces', { workspaces: [] }),
2449
- safeJson('/api/analytics?days=14', null)
2504
+ safeJson('/api/workspaces', { workspaces: [] })
2450
2505
  ]);
2451
2506
  var tasks = (results[0] && results[0].tasks) || [];
2452
2507
  var m = results[1] || {};
@@ -2466,7 +2521,7 @@ function renderPage(): string {
2466
2521
  renderGraph(tasks);
2467
2522
  renderHistory(history);
2468
2523
  renderModelsAnalysis(modelsAnalysis);
2469
- renderAnalytics(results[5]);
2524
+ renderAnalytics(allAnalytics);
2470
2525
  showServerWarn(results[0] ? null : 'Не удалось загрузить список задач — остальные блоки обновлены. Подробности в консоли (F12).');
2471
2526
  updated.textContent = 'Обновлено: ' + new Date().toLocaleTimeString();
2472
2527
  } catch (err) {
@@ -2476,6 +2531,25 @@ function renderPage(): string {
2476
2531
  }
2477
2532
  }
2478
2533
 
2534
+ // P3-29: аналитика — тяжёлая агрегация SQLite, грузим реже основных блоков
2535
+ // и используем ETag/If-None-Match, чтобы не перезапрашивать неизменённые данные.
2536
+ var analyticsEtag = null;
2537
+ async function loadAnalytics() {
2538
+ try {
2539
+ var headers = { 'X-Scheduler-Client': 'dashboard' };
2540
+ if (analyticsEtag) headers['If-None-Match'] = analyticsEtag;
2541
+ var res = await fetch('/api/analytics?days=14', { cache: 'no-store', headers: headers });
2542
+ if (res.status === 304) return; // не изменилось с прошлого раза
2543
+ analyticsEtag = res.headers.get('ETag');
2544
+ allAnalytics = await readJson(res);
2545
+ if (allAnalytics && allAnalytics.totals) {
2546
+ renderAnalytics(allAnalytics);
2547
+ }
2548
+ } catch (err) {
2549
+ console.error('Аналитика недоступна:', err);
2550
+ }
2551
+ }
2552
+
2479
2553
  document.addEventListener('click', function (e) {
2480
2554
  var matrixBtn = e.target && e.target.closest ? e.target.closest('button[data-matrix]') : null;
2481
2555
  if (!matrixBtn) return;
@@ -2640,6 +2714,8 @@ function renderPage(): string {
2640
2714
 
2641
2715
  loadAll();
2642
2716
  setInterval(loadAll, 5000);
2717
+ loadAnalytics();
2718
+ setInterval(loadAnalytics, ANALYTICS_INTERVAL_MS);
2643
2719
  })();
2644
2720
  </script>
2645
2721
 
package/src/types.ts CHANGED
@@ -112,6 +112,15 @@ export function validateTaskName(raw: string): string | null {
112
112
  if (!name) {
113
113
  return "Имя задачи не может быть пустым.";
114
114
  }
115
+ // P1-10.T1.3: имена из одних разделителей («---», «...», «.») после
116
+ // sanitizeName превращаются в «task» и молча конфликтуют с реальной
117
+ // задачей «task». Требуем хотя бы одну букву или цифру.
118
+ if (!/[\p{L}\p{N}]/u.test(name)) {
119
+ return (
120
+ `Имя задачи «${name}» не содержит букв или цифр: после нормализации ` +
121
+ "оно стало бы «task». Добавьте буквы или цифры."
122
+ );
123
+ }
115
124
  if (/[\u0000-\u001f\u007f]/.test(name)) {
116
125
  return "Имя задачи не должно содержать управляющие символы.";
117
126
  }
package/src/workspaces.ts CHANGED
@@ -133,25 +133,60 @@ export function readWorkspaceEnvFile(envFile?: string): Record<string, string> {
133
133
  }
134
134
  }
135
135
 
136
+ /** Ошибка конфигурации: в env workspace остались неразрешённые `${secret:NAME}`. */
137
+ export class MissingWorkspaceSecretsError extends Error {
138
+ readonly workspaceName: string;
139
+ readonly secrets: string[];
140
+
141
+ constructor(workspaceName: string, secrets: string[]) {
142
+ super(
143
+ `Workspace "${workspaceName}": не найдены секреты: ${secrets.join(", ")}. ` +
144
+ "Запуск отменён, чтобы не подставлять литералы ${secret:...} в окружение задачи.",
145
+ );
146
+ this.name = "MissingWorkspaceSecretsError";
147
+ this.workspaceName = workspaceName;
148
+ this.secrets = secrets;
149
+ }
150
+ }
151
+
152
+ interface ResolvedWorkspaceEnv {
153
+ env: Record<string, string>;
154
+ missing: string[];
155
+ }
156
+
136
157
  /**
137
- * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
138
- * (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
139
- * зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
140
- * строку и предупреждение с именем — без значения. Никогда не бросает.
158
+ * Итоговые env-переменные workspace вместе со списком отсутствующих секретов.
159
+ * Ссылки `${secret:NAME}` не подменяются пустой строкой: имя попадает в
160
+ * `missing`, а сама ссылка остаётся в env — вызывающая сторона решает,
161
+ * прервать запуск или только предупредить.
141
162
  */
142
- export function resolveWorkspaceEnv(
163
+ export function resolveWorkspaceEnvDetailed(
143
164
  workspace: Workspace | undefined,
144
165
  allowedSecretNames?: string[],
145
- ): Record<string, string> {
146
- if (!workspace) return {};
166
+ ): ResolvedWorkspaceEnv {
167
+ if (!workspace) return { env: {}, missing: [] };
147
168
  const merged = {
148
169
  ...readWorkspaceEnvFile(workspace.envFile),
149
170
  ...(workspace.env ?? {}),
150
171
  };
151
172
  const resolved = resolveSecretRefs(merged, allowedSecretNames);
173
+ return { env: resolved.env, missing: resolved.missing };
174
+ }
175
+
176
+ /**
177
+ * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
178
+ * (пары важнее файла). Отсутствующий секрет даёт предупреждение с именем,
179
+ * но не значение. Никогда не бросает — для запуска задачи используйте
180
+ * writeWorkspaceEnvFile(), который в этом случае отказывает.
181
+ */
182
+ export function resolveWorkspaceEnv(
183
+ workspace: Workspace | undefined,
184
+ allowedSecretNames?: string[],
185
+ ): Record<string, string> {
186
+ const resolved = resolveWorkspaceEnvDetailed(workspace, allowedSecretNames);
152
187
  if (resolved.missing.length > 0) {
153
188
  console.warn(
154
- `[workspace] "${workspace.name}": не найдены секреты: ${resolved.missing.join(", ")}`,
189
+ `[workspace] "${workspace?.name ?? ""}": не найдены секреты: ${resolved.missing.join(", ")}`,
155
190
  );
156
191
  }
157
192
  return resolved.env;
@@ -195,6 +230,10 @@ export function workspaceEnvDir(pluginDir: string): string {
195
230
  *
196
231
  * Возвращает путь к файлу или undefined, если у workspace нет переменных.
197
232
  * Пустой env удаляет ранее созданный файл. На POSIX права 0600.
233
+ *
234
+ * Если хотя бы один `${secret:NAME}` не разрешён, старый env-файл удаляется
235
+ * и бросается MissingWorkspaceSecretsError: задача не должна запускаться с
236
+ * литералом `${secret:...}` вместо значения (P2-21).
198
237
  */
199
238
  export function writeWorkspaceEnvFile(
200
239
  workspace: Workspace | undefined,
@@ -204,7 +243,17 @@ export function writeWorkspaceEnvFile(
204
243
  ): string | undefined {
205
244
  if (!workspace) return undefined;
206
245
  const file = join(workspaceEnvDir(pluginDir), `${sanitizedName}.env`);
207
- const env = resolveWorkspaceEnv(workspace, allowedSecretNames);
246
+ const { env, missing } = resolveWorkspaceEnvDetailed(workspace, allowedSecretNames);
247
+ if (missing.length > 0) {
248
+ // Fail closed: не оставляем старый файл, иначе обёртка продолжит
249
+ // подхватывать устаревшие значения секретов.
250
+ try {
251
+ rmSync(file, { force: true });
252
+ } catch {
253
+ // файла нет — не ошибка
254
+ }
255
+ throw new MissingWorkspaceSecretsError(workspace.name, missing);
256
+ }
208
257
  const keys = Object.keys(env);
209
258
  if (!keys.length) {
210
259
  try {