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
@@ -1 +1 @@
1
- {"version":3,"file":"record-history.d.ts","sourceRoot":"","sources":["../../src/core/record-history.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AA4BnD,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAwBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAmC5D;AAgID;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,cAAc,EAAE,EAC7B,OAAO,EAAE,aAAa,EAAE,GACvB,MAAM,EAAE,CA0EV"}
1
+ {"version":3,"file":"record-history.d.ts","sourceRoot":"","sources":["../../src/core/record-history.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAiCnD,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAwBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAmC5D;AA6GD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,cAAc,EAAE,EAC7B,OAAO,EAAE,aAAa,EAAE,GACvB,MAAM,EAAE,CA0EV;AAiLD,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAC7D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAyBlB"}
@@ -1,14 +1,19 @@
1
1
  import { spawn } from "node:child_process";
2
2
  import fs from "node:fs";
3
3
  import { pathToFileURL } from "node:url";
4
+ import { runTaskNow } from "./scheduler/run-now.js";
4
5
  import { createSchedulerBackend } from "./scheduler/index.js";
5
6
  import { notifyTaskCompletion } from "../notifications.js";
6
- import { finishRun, getHistory, recordRun, startRun } from "../db/history-repo.js";
7
- import { getSetting, setSetting } from "../db/settings-repo.js";
7
+ import { finishRun, getLatestHistoryByTask, recordRun, startRun } from "../db/history-repo.js";
8
+ import { deleteSetting, decrementCounterSetting } from "../db/settings-repo.js";
8
9
  import { getTask, listTasks } from "../db/tasks-repo.js";
9
10
  import { rotateSessionIfNeeded } from "./session.js";
10
11
  import { advanceMatrixAfterClone, finalizeMatrixIfComplete, } from "./matrix.js";
11
- const RETRY_STATE_KEY = "retry_state";
12
+ /** Префикс ключа настроек со счётчиком повторов конкретной задачи. */
13
+ const RETRY_STATE_PREFIX = "retry_state:";
14
+ function retryStateKey(taskName) {
15
+ return `${RETRY_STATE_PREFIX}${taskName.toLowerCase()}`;
16
+ }
12
17
  /** Сколько последних строк лога сканировать при поиске токенов/стоимости. */
13
18
  const LOG_TAIL_LINES = 500;
14
19
  /**
@@ -110,7 +115,7 @@ async function loadRetryConfig(taskName) {
110
115
  */
111
116
  async function triggerTask(taskName) {
112
117
  try {
113
- await createSchedulerBackend().runTask(taskName);
118
+ await runTaskNow(taskName);
114
119
  return true;
115
120
  }
116
121
  catch (err) {
@@ -118,21 +123,12 @@ async function triggerTask(taskName) {
118
123
  return false;
119
124
  }
120
125
  }
121
- async function loadRetryState() {
122
- const raw = getSetting(RETRY_STATE_KEY, {});
123
- return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
124
- }
125
- async function writeRetryState(state) {
126
- setSetting(RETRY_STATE_KEY, state);
127
- }
128
- async function clearRetryState(taskName) {
129
- const state = await loadRetryState();
130
- const key = Object.keys(state).find((k) => k.toLowerCase() === taskName.toLowerCase());
131
- if (!key)
132
- return;
133
- delete state[key];
134
- await writeRetryState(state);
135
- }
126
+ /*
127
+ * P2-30: раньше счётчики повторов лежали одним JSON-объектом в настройках.
128
+ * Каждое завершение задачи — отдельный процесс record-history, поэтому
129
+ * параллельные завершения перезаписывали map и теряли декременты. Теперь
130
+ * на задачу отдельный ключ и атомарный UPDATE ... RETURNING.
131
+ */
136
132
  /**
137
133
  * Планирует повторный запуск упавшей задачи.
138
134
  *
@@ -146,18 +142,13 @@ async function scheduleRetry(taskName) {
146
142
  const { count, delay } = await loadRetryConfig(taskName);
147
143
  if (count <= 0)
148
144
  return false;
149
- const state = await loadRetryState();
150
- const key = taskName.toLowerCase();
151
- const remaining = Object.prototype.hasOwnProperty.call(state, key)
152
- ? Number(state[key]) || 0
153
- : count;
154
- if (remaining <= 0) {
155
- await clearRetryState(taskName);
145
+ const key = retryStateKey(taskName);
146
+ const remaining = decrementCounterSetting(key, count);
147
+ if (remaining === null) {
148
+ deleteSetting(key);
156
149
  console.log(`[agent-steward] Повторы для "${taskName}" исчерпаны.`);
157
150
  return false;
158
151
  }
159
- state[key] = remaining - 1;
160
- await writeRetryState(state);
161
152
  const script = process.argv[1];
162
153
  if (!script)
163
154
  return false;
@@ -170,7 +161,7 @@ async function scheduleRetry(taskName) {
170
161
  });
171
162
  child.unref();
172
163
  console.log(`[agent-steward] Задача "${taskName}" будет повторена через ${delay} с ` +
173
- `(осталось повторов: ${remaining - 1}).`);
164
+ `(осталось повторов: ${remaining}).`);
174
165
  return true;
175
166
  }
176
167
  catch (err) {
@@ -188,7 +179,7 @@ async function runRetry(taskName, delaySec) {
188
179
  const delay = Math.max(1, Math.floor(Number(delaySec) || 60));
189
180
  await new Promise((resolve) => setTimeout(resolve, delay * 1000));
190
181
  try {
191
- await createSchedulerBackend().runTask(taskName);
182
+ await runTaskNow(taskName);
192
183
  console.log(`[agent-steward] Повторный запуск задачи "${taskName}".`);
193
184
  }
194
185
  catch (err) {
@@ -381,6 +372,34 @@ async function main() {
381
372
  recordRun(taskName, st, startedAt, durationMs, error, chainTarget, tokens, costUsd, model, preFlightStatus, postFlightStatus, new Date().toISOString(), definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
382
373
  await handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd);
383
374
  }
375
+ /**
376
+ * Удаляет отработавшую ONCE-задачу из Планировщика Windows.
377
+ *
378
+ * `schtasks /create ... /z` должен был делать это сам, но на Win10/11
379
+ * возвращает «The task XML is missing a required element ... EndBoundary»
380
+ * и задача вообще не создаётся. Поэтому чистим после запуска вручную.
381
+ * На Linux/macOS очистка не нужна: `at` и launchd убирают one-shot сами.
382
+ */
383
+ export async function cleanupWindowsOneShotTask(taskName, deps = {}) {
384
+ const platform = deps.platform ?? process.platform;
385
+ if (platform !== "win32")
386
+ return false;
387
+ const getDefinition = deps.getDefinition ?? getTask;
388
+ const definition = getDefinition(taskName);
389
+ if (!definition || definition.triggerType !== "once")
390
+ return false;
391
+ const deleteTask = deps.deleteTask ??
392
+ ((name) => createSchedulerBackend().deleteTask(name));
393
+ try {
394
+ await deleteTask(taskName);
395
+ console.log(`[agent-steward] One-shot "${taskName}": задача удалена из Планировщика Windows.`);
396
+ return true;
397
+ }
398
+ catch (err) {
399
+ console.warn(`[agent-steward] One-shot "${taskName}": не удалось удалить задачу из Планировщика Windows: ${err instanceof Error ? err.message : String(err)}`);
400
+ return false;
401
+ }
402
+ }
384
403
  /**
385
404
  * Общая пост-обработка завершённого запуска: уведомление, цепочки задач,
386
405
  * DAG-зависимости и повторы. Используется и legacy-режимом, и --finish.
@@ -391,6 +410,10 @@ async function handleCompletion(taskName, st, chainTarget, error, durationMs, to
391
410
  await notifyTaskCompletion(taskName, st, durationMs, error, tokens, costUsd, {
392
411
  asyncTriage: true,
393
412
  });
413
+ // P2-27: Windows не удаляет ONCE-задачи сам, а флаг schtasks `/z` на
414
+ // практике ломает создание задачи («task XML ... EndBoundary»).
415
+ // Поэтому снимаем отработавшую one-shot задачу из Планировщика здесь.
416
+ await cleanupWindowsOneShotTask(taskName);
394
417
  // Matrix (Спринт 15): клон завершился — двигаем sequential-цепочку или
395
418
  // очередь concurrency-лимита (Спринт 17), а когда все клоны готовы —
396
419
  // фиксируем агрегат и запускаем matrix-complete.
@@ -403,7 +426,7 @@ async function handleCompletion(taskName, st, chainTarget, error, durationMs, to
403
426
  }
404
427
  if (st === "success") {
405
428
  // Успешный запуск сбрасывает счётчик повторов.
406
- await clearRetryState(taskName);
429
+ await deleteSetting(retryStateKey(taskName));
407
430
  if (chainTarget) {
408
431
  const started = await triggerTask(chainTarget);
409
432
  if (started) {
@@ -414,7 +437,8 @@ async function handleCompletion(taskName, st, chainTarget, error, durationMs, to
414
437
  // зависимостей. Запускаем только если ВСЕ зависимости уже успешны и
415
438
  // зависимая задача ещё не запускалась после их завершения.
416
439
  try {
417
- const history = getHistory(null, 200);
440
+ // P2-29: по одной последней записи на задачу, а не «последние 200 строк».
441
+ const history = getLatestHistoryByTask();
418
442
  const definitions = listTasks();
419
443
  const dependents = selectDependentsToTrigger(taskName, definitions, history);
420
444
  for (const dependent of dependents) {
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Сборка маршрута шага из слоёв 1–2 (Спринт 36.5.d).
3
+ *
4
+ * Слой 1 отвечает мгновенно по таблице правил, слой 2 — по Capability Map.
5
+ * Модель здесь не участвует: `routeStep` не импортирует planner и ничего не
6
+ * декомпозирует, поэтому известный тип задачи обходится в 0 токенов.
7
+ */
8
+ import type { CapabilityDecision, CapabilityThresholds } from "../../db/capability-repo.js";
9
+ import type { RouterExecutor, RouterTransport } from "./rules.js";
10
+ /** Откуда взято решение о маршруте. */
11
+ export type RouteSource = "static" | "capability";
12
+ /** Куда направляется шаг: исполнение или ручной разбор. */
13
+ export type RouteTarget = "local" | "cloud" | "review" | "explore";
14
+ /** Готовый маршрут шага. */
15
+ export interface StepRoute {
16
+ /** Нормализованный тип задачи. */
17
+ taskType: string;
18
+ /** Кто исполняет шаг либо почему шаг уходит человеку. */
19
+ target: RouteTarget;
20
+ /** Транспорт; `null` для `review`/`explore`, где исполнения пока нет. */
21
+ transport: RouterTransport | null;
22
+ /** Исполнитель; `null` для `review`/`explore`. */
23
+ executor: RouterExecutor | null;
24
+ /** Слой, принявший решение. */
25
+ source: RouteSource;
26
+ /** Стабильный код причины: `static-rule` либо решение Capability Map. */
27
+ reason: string;
28
+ /** Решение слоя 2, если он участвовал. */
29
+ decision?: CapabilityDecision;
30
+ }
31
+ /**
32
+ * Строит маршрут для типа задачи: статическое правило, затем Capability Map.
33
+ * Пустой тип — ошибка, а не молчаливый `explore`: маршрутизировать нечего.
34
+ */
35
+ export declare function routeStep(taskType: string, thresholds?: CapabilityThresholds): StepRoute;
36
+ //# sourceMappingURL=dispatch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/core/router/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAElD,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE,4BAA4B;AAC5B,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,MAAM,EAAE,WAAW,CAAC;IACpB,yEAAyE;IACzE,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,kDAAkD;IAClD,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,+BAA+B;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,oBAAyB,GACpC,SAAS,CA6BX"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Сборка маршрута шага из слоёв 1–2 (Спринт 36.5.d).
3
+ *
4
+ * Слой 1 отвечает мгновенно по таблице правил, слой 2 — по Capability Map.
5
+ * Модель здесь не участвует: `routeStep` не импортирует planner и ничего не
6
+ * декомпозирует, поэтому известный тип задачи обходится в 0 токенов.
7
+ */
8
+ import { decideCapabilityRoute } from "../../db/capability-repo.js";
9
+ import { normalizeTaskType, routeStaticStep } from "./rules.js";
10
+ /**
11
+ * Строит маршрут для типа задачи: статическое правило, затем Capability Map.
12
+ * Пустой тип — ошибка, а не молчаливый `explore`: маршрутизировать нечего.
13
+ */
14
+ export function routeStep(taskType, thresholds = {}) {
15
+ const key = normalizeTaskType(taskType);
16
+ if (key === "") {
17
+ throw new Error("Пустой тип задачи: маршрутизация невозможна.");
18
+ }
19
+ const rule = routeStaticStep(key);
20
+ if (rule !== undefined) {
21
+ return {
22
+ taskType: key,
23
+ target: rule.executor,
24
+ transport: rule.transport,
25
+ executor: rule.executor,
26
+ source: "static",
27
+ reason: "static-rule",
28
+ };
29
+ }
30
+ const decision = decideCapabilityRoute(key, thresholds);
31
+ const target = decision.target;
32
+ return {
33
+ taskType: key,
34
+ target,
35
+ transport: transportForTarget(target),
36
+ executor: executorForTarget(target),
37
+ source: "capability",
38
+ reason: decision.reason,
39
+ decision,
40
+ };
41
+ }
42
+ function transportForTarget(target) {
43
+ if (target === "cloud") {
44
+ return "cloud";
45
+ }
46
+ if (target === "local") {
47
+ return "direct";
48
+ }
49
+ return null;
50
+ }
51
+ function executorForTarget(target) {
52
+ if (target === "cloud") {
53
+ return "cloud";
54
+ }
55
+ if (target === "local") {
56
+ return "local";
57
+ }
58
+ return null;
59
+ }
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Эскалация после провала Quality Gate (Спринт 36.5.d).
3
+ *
4
+ * Правило детерминированное и не обращается ни к БД, ни к модели, ни к сети:
5
+ * провал на локальном исполнителе ведёт в облако, провал в облаке — на ручной
6
+ * review, провал review означает, что автоматических уровней больше нет.
7
+ * Решение принимается по одному флагу `passed`, поэтому его можно вызывать
8
+ * в горячем пути без затрат токенов.
9
+ */
10
+ /** Уровень исполнения, на котором сработал Quality Gate. */
11
+ export type GateTarget = "local" | "cloud" | "review";
12
+ /** Что делать после проверки гейта. */
13
+ export type EscalationAction = "accept" | "escalate-cloud" | "escalate-review" | "blocked";
14
+ /** Результат Quality Gate, который видит роутер. */
15
+ export interface GateResult {
16
+ /** Прошёл ли шаг проверку. */
17
+ passed: boolean;
18
+ /** Свободное пояснение для журнала и уведомлений. */
19
+ reason?: string;
20
+ }
21
+ /** Решение об эскалации с текущего уровня. */
22
+ export interface EscalationDecision {
23
+ /** Уровень, на котором гейт сработал. */
24
+ from: GateTarget;
25
+ /** Куда переходим (при `accept` совпадает с `from`). */
26
+ next: GateTarget;
27
+ action: EscalationAction;
28
+ /** Почему принято решение: стабильный код, а не текст ошибки. */
29
+ reason: "gate-passed" | "local-failed" | "cloud-failed" | "review-failed";
30
+ }
31
+ /** Сколько автоматических эскалаций допускает цепочка local → cloud → review. */
32
+ export declare const MAX_ESCALATION_STEPS = 2;
33
+ /** Следующий уровень эскалации; `null` — автоматических уровней больше нет. */
34
+ export declare function nextGateTarget(current: GateTarget): GateTarget | null;
35
+ /** Исчерпаны ли автоматические уровни для текущего исполнителя. */
36
+ export declare function isEscalationExhausted(current: GateTarget): boolean;
37
+ /**
38
+ * Решает, что делать после гейта: принять результат или подняться на уровень
39
+ * выше. Модель здесь не вызывается — только таблица переходов.
40
+ */
41
+ export declare function escalateAfterGate(current: GateTarget, gate: GateResult): EscalationDecision;
42
+ /**
43
+ * Полная цепочка уровней, которые предстоит пройти начиная с текущего
44
+ * (включая его). Полезно для dry-run и объяснения решения оператору.
45
+ */
46
+ export declare function escalationChain(current: GateTarget): GateTarget[];
47
+ //# sourceMappingURL=escalation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../../src/core/router/escalation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,gBAAgB,GAChB,iBAAiB,GACjB,SAAS,CAAC;AAEd,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,wDAAwD;IACxD,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,iEAAiE;IACjE,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,CAAC;CAC3E;AAWD,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAiBtC,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAGrE;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAElE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,UAAU,GACf,kBAAkB,CA6BpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,EAAE,CASjE"}
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Эскалация после провала Quality Gate (Спринт 36.5.d).
3
+ *
4
+ * Правило детерминированное и не обращается ни к БД, ни к модели, ни к сети:
5
+ * провал на локальном исполнителе ведёт в облако, провал в облаке — на ручной
6
+ * review, провал review означает, что автоматических уровней больше нет.
7
+ * Решение принимается по одному флагу `passed`, поэтому его можно вызывать
8
+ * в горячем пути без затрат токенов.
9
+ */
10
+ /** Следующий уровень эскалации или `null`, если уровни закончились. */
11
+ const NEXT_TARGET = Object.freeze({
12
+ local: "cloud",
13
+ cloud: "review",
14
+ review: null,
15
+ });
16
+ /** Сколько автоматических эскалаций допускает цепочка local → cloud → review. */
17
+ export const MAX_ESCALATION_STEPS = 2;
18
+ function assertTarget(target) {
19
+ if (!Object.prototype.hasOwnProperty.call(NEXT_TARGET, target)) {
20
+ throw new Error(`Неизвестный уровень гейта: ${String(target)}`);
21
+ }
22
+ }
23
+ function assertGate(gate) {
24
+ if (gate === null || typeof gate !== "object") {
25
+ throw new Error("Результат Quality Gate должен быть объектом.");
26
+ }
27
+ if (typeof gate.passed !== "boolean") {
28
+ throw new Error("Результат Quality Gate должен содержать boolean (passed).");
29
+ }
30
+ }
31
+ /** Следующий уровень эскалации; `null` — автоматических уровней больше нет. */
32
+ export function nextGateTarget(current) {
33
+ assertTarget(current);
34
+ return NEXT_TARGET[current];
35
+ }
36
+ /** Исчерпаны ли автоматические уровни для текущего исполнителя. */
37
+ export function isEscalationExhausted(current) {
38
+ return nextGateTarget(current) === null;
39
+ }
40
+ /**
41
+ * Решает, что делать после гейта: принять результат или подняться на уровень
42
+ * выше. Модель здесь не вызывается — только таблица переходов.
43
+ */
44
+ export function escalateAfterGate(current, gate) {
45
+ assertTarget(current);
46
+ assertGate(gate);
47
+ if (gate.passed) {
48
+ return { from: current, next: current, action: "accept", reason: "gate-passed" };
49
+ }
50
+ const next = NEXT_TARGET[current];
51
+ if (next === null) {
52
+ return {
53
+ from: current,
54
+ next: current,
55
+ action: "blocked",
56
+ reason: "review-failed",
57
+ };
58
+ }
59
+ if (next === "cloud") {
60
+ return {
61
+ from: current,
62
+ next,
63
+ action: "escalate-cloud",
64
+ reason: "local-failed",
65
+ };
66
+ }
67
+ return {
68
+ from: current,
69
+ next,
70
+ action: "escalate-review",
71
+ reason: "cloud-failed",
72
+ };
73
+ }
74
+ /**
75
+ * Полная цепочка уровней, которые предстоит пройти начиная с текущего
76
+ * (включая его). Полезно для dry-run и объяснения решения оператору.
77
+ */
78
+ export function escalationChain(current) {
79
+ assertTarget(current);
80
+ const chain = [];
81
+ let target = current;
82
+ while (target !== null) {
83
+ chain.push(target);
84
+ target = NEXT_TARGET[target];
85
+ }
86
+ return chain;
87
+ }
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Роутер, слой 3: декомпозиция миссии.
3
+ *
4
+ * Локальная модель вызывается только здесь и только для того, чтобы разбить
5
+ * миссию на шаги с типом задачи. Маршрут каждого шага (транспорт и исполнитель)
6
+ * определяется слоями 1–2: статическими правилами и Capability Map. Если
7
+ * декомпозера нет, работает эвристика по ключевым словам — она не обращается
8
+ * ни к модели, ни к сети.
9
+ */
10
+ import { type RouterExecutor, type RouterTransport } from "./rules.js";
11
+ /** Один шаг плана: имя для журнала и тип задачи для маршрутизации. */
12
+ export interface MissionStep {
13
+ stepName: string;
14
+ taskType: string;
15
+ }
16
+ /** Источник плана: модель или эвристика. */
17
+ export type PlanSource = "model" | "heuristic";
18
+ /** Результат декомпозиции миссии. */
19
+ export interface MissionPlan {
20
+ mission: string;
21
+ steps: MissionStep[];
22
+ source: PlanSource;
23
+ /** Типы шагов, которых нет в статических правилах: их маршрут решают слои 2–3. */
24
+ ambiguousTaskTypes: string[];
25
+ }
26
+ /** Декомпозер, который поставляет локальная модель. */
27
+ export interface MissionDecomposer {
28
+ decompose(mission: string): Promise<MissionStep[]> | MissionStep[];
29
+ }
30
+ /** Опции декомпозиции. */
31
+ export interface PlanOptions {
32
+ decomposer?: MissionDecomposer;
33
+ /** Предохранитель от «простыни» шагов, по умолчанию 12. */
34
+ maxSteps?: number;
35
+ }
36
+ /** Маршрут шага, собранный из слоёв 1–2 (для удобства интеграции). */
37
+ export interface ResolvedStepRoute {
38
+ step: MissionStep;
39
+ transport?: RouterTransport;
40
+ executor?: RouterExecutor;
41
+ source: "static" | "capability" | "unknown";
42
+ }
43
+ /** Нужна ли декомпозиция: одна короткая задача обходится без модели. */
44
+ export declare function needsDecomposition(mission: string): boolean;
45
+ /** Определяет тип задачи по ключевым словам фрагмента; неизвестно — `unknown`. */
46
+ export declare function guessTaskType(fragment: string): string;
47
+ /** Эвристическая декомпозиция: без модели, без сети, детерминированно. */
48
+ export declare function decomposeHeuristically(mission: string, maxSteps?: number): MissionStep[];
49
+ /** Асинхронная декомпозиция: модель, если передана, иначе эвристика. */
50
+ export declare function planMission(mission: string, options?: PlanOptions): Promise<MissionPlan>;
51
+ /** Синхронный вариант для мест, где промис неудобен. */
52
+ export declare function planMissionSync(mission: string, options?: Omit<PlanOptions, "decomposer">): MissionPlan;
53
+ //# sourceMappingURL=planner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/core/router/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAuC,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5G,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE/C,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,kFAAkF;IAClF,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC;CACpE;AAED,0BAA0B;AAC1B,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;CAC7C;AAoBD,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAS3D;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA0B,GAAG,WAAW,EAAE,CAmB3G;AA6BD,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAalG;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAM,GAAG,WAAW,CAQ3G"}
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Роутер, слой 3: декомпозиция миссии.
3
+ *
4
+ * Локальная модель вызывается только здесь и только для того, чтобы разбить
5
+ * миссию на шаги с типом задачи. Маршрут каждого шага (транспорт и исполнитель)
6
+ * определяется слоями 1–2: статическими правилами и Capability Map. Если
7
+ * декомпозера нет, работает эвристика по ключевым словам — она не обращается
8
+ * ни к модели, ни к сети.
9
+ */
10
+ import { isStaticTaskType, normalizeTaskType } from "./rules.js";
11
+ const DEFAULT_MAX_STEPS = 12;
12
+ /**
13
+ * Ключевые слова эвристики. Порядок важен: более специфичные типы идут первыми,
14
+ * иначе «проверь тесты в PR» уедет в run_tests вместо github_create_pr.
15
+ */
16
+ const HEURISTIC_KEYWORDS = Object.freeze([
17
+ { taskType: "github_create_pr", keywords: ["pull request", "merge request", " pr ", "pr ", "пуш", "push"] },
18
+ { taskType: "jira_update_task", keywords: ["jira", "джира", "тикет", "ticket", "задач"] },
19
+ { taskType: "run_tests", keywords: ["тест", "test", "прогон", "проверк"] },
20
+ { taskType: "apply_diff", keywords: ["исправ", "поправ", "измени", "правк", "patch", "diff", "refactor", "рефактор"] },
21
+ { taskType: "write_file", keywords: ["запиши", "создай", "напиши", "write", "сохрани"] },
22
+ { taskType: "read_file", keywords: ["прочит", "прочитай", "посмотр", "открой", "read", "inspect"] },
23
+ ]);
24
+ /** Разделители шагов в миссии. */
25
+ const STEP_SPLIT_PATTERN = /\r?\n|;|,\s*(?:затем|потом|после чего)\s*|\s+(?:затем|потом|после чего)\s+/iu;
26
+ /** Нужна ли декомпозиция: одна короткая задача обходится без модели. */
27
+ export function needsDecomposition(mission) {
28
+ const text = mission.trim();
29
+ if (!text) {
30
+ return false;
31
+ }
32
+ if (STEP_SPLIT_PATTERN.test(text)) {
33
+ return true;
34
+ }
35
+ return !isStaticTaskType(text);
36
+ }
37
+ /** Определяет тип задачи по ключевым словам фрагмента; неизвестно — `unknown`. */
38
+ export function guessTaskType(fragment) {
39
+ const haystack = ` ${fragment.toLowerCase().replace(/ё/gu, "е")} `;
40
+ for (const entry of HEURISTIC_KEYWORDS) {
41
+ if (entry.keywords.some((keyword) => haystack.includes(keyword))) {
42
+ return entry.taskType;
43
+ }
44
+ }
45
+ return "unknown";
46
+ }
47
+ /** Эвристическая декомпозиция: без модели, без сети, детерминированно. */
48
+ export function decomposeHeuristically(mission, maxSteps = DEFAULT_MAX_STEPS) {
49
+ const text = mission.trim();
50
+ if (!text) {
51
+ throw new Error("Пустая миссия: декомпозиция невозможна");
52
+ }
53
+ const fragments = text
54
+ .split(STEP_SPLIT_PATTERN)
55
+ .map((fragment) => fragment.trim().replace(/^[-*\d.)\s]+/u, "").trim())
56
+ .filter((fragment) => fragment.length > 0);
57
+ const steps = fragments.slice(0, Math.max(1, maxSteps)).map((fragment) => ({
58
+ stepName: fragment.length > 120 ? `${fragment.slice(0, 117)}...` : fragment,
59
+ taskType: guessTaskType(fragment),
60
+ }));
61
+ if (steps.length === 0) {
62
+ throw new Error("Пустая миссия: декомпозиция невозможна");
63
+ }
64
+ return steps;
65
+ }
66
+ function assertMaxSteps(maxSteps) {
67
+ if (!Number.isInteger(maxSteps) || maxSteps < 1) {
68
+ throw new Error(`Некорректный maxSteps: ${String(maxSteps)}`);
69
+ }
70
+ }
71
+ function normalizeSteps(raw, maxSteps) {
72
+ if (!Array.isArray(raw) || raw.length === 0) {
73
+ throw new Error("Декомпозер вернул пустой план");
74
+ }
75
+ const steps = [];
76
+ for (const item of raw.slice(0, maxSteps)) {
77
+ const stepName = typeof item?.stepName === "string" ? item.stepName.trim() : "";
78
+ const taskType = typeof item?.taskType === "string" ? normalizeTaskType(item.taskType) : "";
79
+ if (!stepName || !taskType) {
80
+ throw new Error("Декомпозер вернул шаг без имени или типа задачи");
81
+ }
82
+ steps.push({ stepName, taskType });
83
+ }
84
+ return steps;
85
+ }
86
+ function buildPlan(mission, steps, source) {
87
+ const ambiguousTaskTypes = [...new Set(steps.filter((step) => !isStaticTaskType(step.taskType)).map((step) => step.taskType))];
88
+ return { mission, steps, source, ambiguousTaskTypes };
89
+ }
90
+ /** Асинхронная декомпозиция: модель, если передана, иначе эвристика. */
91
+ export async function planMission(mission, options = {}) {
92
+ const text = mission.trim();
93
+ if (!text) {
94
+ throw new Error("Пустая миссия: декомпозиция невозможна");
95
+ }
96
+ const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
97
+ assertMaxSteps(maxSteps);
98
+ if (options.decomposer) {
99
+ const raw = await options.decomposer.decompose(text);
100
+ return buildPlan(text, normalizeSteps(raw, maxSteps), "model");
101
+ }
102
+ return buildPlan(text, decomposeHeuristically(text, maxSteps), "heuristic");
103
+ }
104
+ /** Синхронный вариант для мест, где промис неудобен. */
105
+ export function planMissionSync(mission, options = {}) {
106
+ const text = mission.trim();
107
+ if (!text) {
108
+ throw new Error("Пустая миссия: декомпозиция невозможна");
109
+ }
110
+ const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
111
+ assertMaxSteps(maxSteps);
112
+ return buildPlan(text, decomposeHeuristically(text, maxSteps), "heuristic");
113
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Слой 1 роутера — статические правила горячего пути (Спринт 36.5.a).
3
+ *
4
+ * Таблица «тип задачи → транспорт + исполнитель» отвечает на вопрос «как
5
+ * выполнять шаг» без модели: 0 токенов, чистая функция, мгновенный ответ.
6
+ * Модель (слой 3) сюда не заглядывает — она только разбивает миссию на шаги
7
+ * с типами, а маршрут выбирается по этой таблице (и по Capability Map из
8
+ * слоя 2, см. src/db/capability-repo.ts).
9
+ *
10
+ * Модуль намеренно не импортирует ничего: ни БД, ни локальную модель, ни
11
+ * транспорт. Это гарантирует, что горячий путь не тянет за собой побочных
12
+ * эффектов и не может случайно вызвать модель.
13
+ */
14
+ /** Транспорт доставки шага. */
15
+ export type RouterTransport = "direct" | "mcp" | "cloud";
16
+ /** Исполнитель шага: локальный процесс или облачная модель. */
17
+ export type RouterExecutor = "local" | "cloud";
18
+ /** Правило статической маршрутизации для одного типа задачи. */
19
+ export interface StaticRouteRule {
20
+ /** Тип шага в нормализованном виде (нижний регистр, подчёркивания). */
21
+ taskType: string;
22
+ transport: RouterTransport;
23
+ executor: RouterExecutor;
24
+ /** Почему правило выглядит именно так — для логов и отчётов. */
25
+ description: string;
26
+ }
27
+ /**
28
+ * Встроенная таблица слоя 1.
29
+ *
30
+ * Совпадает с docs/ARCHITECTURE.md → «Слой 1 — статические правила»: известные
31
+ * операции обслуживаются локально и напрямую, внешние системы — через MCP,
32
+ * облачная модель — только там, где локально сделать нельзя.
33
+ */
34
+ export declare const STATIC_ROUTE_RULES: readonly StaticRouteRule[];
35
+ /**
36
+ * Нормализует тип задачи: `Run Tests`, `run-tests`, ` RUN_TESTS ` → `run_tests`.
37
+ * Нужна, потому что план миссии может прийти из модели в свободной форме.
38
+ */
39
+ export declare function normalizeTaskType(value: string): string;
40
+ /** Возвращает правило слоя 1 для типа задачи или `undefined`, если тип неизвестен. */
41
+ export declare function routeStaticStep(taskType: string): StaticRouteRule | undefined;
42
+ /** Есть ли для типа задачи статическое правило (0 токенов, без БД). */
43
+ export declare function isStaticTaskType(taskType: string): boolean;
44
+ /** Снимок таблицы слоя 1 — для отчётов, GUI и тестов. */
45
+ export declare function listStaticRouteRules(): readonly StaticRouteRule[];
46
+ //# sourceMappingURL=rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/core/router/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAEzD,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAqCvD,CAAC;AAMH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAK7E;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,IAAI,SAAS,eAAe,EAAE,CAEjE"}