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
@@ -0,0 +1,166 @@
1
+ /**
2
+ * Роутер, слой 3: декомпозиция миссии.
3
+ *
4
+ * Локальная модель вызывается только здесь и только для того, чтобы разбить
5
+ * миссию на шаги с типом задачи. Маршрут каждого шага (транспорт и исполнитель)
6
+ * определяется слоями 1–2: статическими правилами и Capability Map. Если
7
+ * декомпозера нет, работает эвристика по ключевым словам — она не обращается
8
+ * ни к модели, ни к сети.
9
+ */
10
+
11
+ import { isStaticTaskType, normalizeTaskType, type RouterExecutor, type RouterTransport } from "./rules.js";
12
+
13
+ /** Один шаг плана: имя для журнала и тип задачи для маршрутизации. */
14
+ export interface MissionStep {
15
+ stepName: string;
16
+ taskType: string;
17
+ }
18
+
19
+ /** Источник плана: модель или эвристика. */
20
+ export type PlanSource = "model" | "heuristic";
21
+
22
+ /** Результат декомпозиции миссии. */
23
+ export interface MissionPlan {
24
+ mission: string;
25
+ steps: MissionStep[];
26
+ source: PlanSource;
27
+ /** Типы шагов, которых нет в статических правилах: их маршрут решают слои 2–3. */
28
+ ambiguousTaskTypes: string[];
29
+ }
30
+
31
+ /** Декомпозер, который поставляет локальная модель. */
32
+ export interface MissionDecomposer {
33
+ decompose(mission: string): Promise<MissionStep[]> | MissionStep[];
34
+ }
35
+
36
+ /** Опции декомпозиции. */
37
+ export interface PlanOptions {
38
+ decomposer?: MissionDecomposer;
39
+ /** Предохранитель от «простыни» шагов, по умолчанию 12. */
40
+ maxSteps?: number;
41
+ }
42
+
43
+ /** Маршрут шага, собранный из слоёв 1–2 (для удобства интеграции). */
44
+ export interface ResolvedStepRoute {
45
+ step: MissionStep;
46
+ transport?: RouterTransport;
47
+ executor?: RouterExecutor;
48
+ source: "static" | "capability" | "unknown";
49
+ }
50
+
51
+ const DEFAULT_MAX_STEPS = 12;
52
+
53
+ /**
54
+ * Ключевые слова эвристики. Порядок важен: более специфичные типы идут первыми,
55
+ * иначе «проверь тесты в PR» уедет в run_tests вместо github_create_pr.
56
+ */
57
+ const HEURISTIC_KEYWORDS: readonly { taskType: string; keywords: readonly string[] }[] = Object.freeze([
58
+ { taskType: "github_create_pr", keywords: ["pull request", "merge request", " pr ", "pr ", "пуш", "push"] },
59
+ { taskType: "jira_update_task", keywords: ["jira", "джира", "тикет", "ticket", "задач"] },
60
+ { taskType: "run_tests", keywords: ["тест", "test", "прогон", "проверк"] },
61
+ { taskType: "apply_diff", keywords: ["исправ", "поправ", "измени", "правк", "patch", "diff", "refactor", "рефактор"] },
62
+ { taskType: "write_file", keywords: ["запиши", "создай", "напиши", "write", "сохрани"] },
63
+ { taskType: "read_file", keywords: ["прочит", "прочитай", "посмотр", "открой", "read", "inspect"] },
64
+ ]);
65
+
66
+ /** Разделители шагов в миссии. */
67
+ const STEP_SPLIT_PATTERN = /\r?\n|;|,\s*(?:затем|потом|после чего)\s*|\s+(?:затем|потом|после чего)\s+/iu;
68
+
69
+ /** Нужна ли декомпозиция: одна короткая задача обходится без модели. */
70
+ export function needsDecomposition(mission: string): boolean {
71
+ const text = mission.trim();
72
+ if (!text) {
73
+ return false;
74
+ }
75
+ if (STEP_SPLIT_PATTERN.test(text)) {
76
+ return true;
77
+ }
78
+ return !isStaticTaskType(text);
79
+ }
80
+
81
+ /** Определяет тип задачи по ключевым словам фрагмента; неизвестно — `unknown`. */
82
+ export function guessTaskType(fragment: string): string {
83
+ const haystack = ` ${fragment.toLowerCase().replace(/ё/gu, "е")} `;
84
+ for (const entry of HEURISTIC_KEYWORDS) {
85
+ if (entry.keywords.some((keyword) => haystack.includes(keyword))) {
86
+ return entry.taskType;
87
+ }
88
+ }
89
+ return "unknown";
90
+ }
91
+
92
+ /** Эвристическая декомпозиция: без модели, без сети, детерминированно. */
93
+ export function decomposeHeuristically(mission: string, maxSteps: number = DEFAULT_MAX_STEPS): MissionStep[] {
94
+ const text = mission.trim();
95
+ if (!text) {
96
+ throw new Error("Пустая миссия: декомпозиция невозможна");
97
+ }
98
+ const fragments = text
99
+ .split(STEP_SPLIT_PATTERN)
100
+ .map((fragment) => fragment.trim().replace(/^[-*\d.)\s]+/u, "").trim())
101
+ .filter((fragment) => fragment.length > 0);
102
+
103
+ const steps = fragments.slice(0, Math.max(1, maxSteps)).map((fragment) => ({
104
+ stepName: fragment.length > 120 ? `${fragment.slice(0, 117)}...` : fragment,
105
+ taskType: guessTaskType(fragment),
106
+ }));
107
+
108
+ if (steps.length === 0) {
109
+ throw new Error("Пустая миссия: декомпозиция невозможна");
110
+ }
111
+ return steps;
112
+ }
113
+
114
+ function assertMaxSteps(maxSteps: number): void {
115
+ if (!Number.isInteger(maxSteps) || maxSteps < 1) {
116
+ throw new Error(`Некорректный maxSteps: ${String(maxSteps)}`);
117
+ }
118
+ }
119
+
120
+ function normalizeSteps(raw: readonly MissionStep[], maxSteps: number): MissionStep[] {
121
+ if (!Array.isArray(raw) || raw.length === 0) {
122
+ throw new Error("Декомпозер вернул пустой план");
123
+ }
124
+ const steps: MissionStep[] = [];
125
+ for (const item of raw.slice(0, maxSteps)) {
126
+ const stepName = typeof item?.stepName === "string" ? item.stepName.trim() : "";
127
+ const taskType = typeof item?.taskType === "string" ? normalizeTaskType(item.taskType) : "";
128
+ if (!stepName || !taskType) {
129
+ throw new Error("Декомпозер вернул шаг без имени или типа задачи");
130
+ }
131
+ steps.push({ stepName, taskType });
132
+ }
133
+ return steps;
134
+ }
135
+
136
+ function buildPlan(mission: string, steps: MissionStep[], source: PlanSource): MissionPlan {
137
+ const ambiguousTaskTypes = [...new Set(steps.filter((step) => !isStaticTaskType(step.taskType)).map((step) => step.taskType))];
138
+ return { mission, steps, source, ambiguousTaskTypes };
139
+ }
140
+
141
+ /** Асинхронная декомпозиция: модель, если передана, иначе эвристика. */
142
+ export async function planMission(mission: string, options: PlanOptions = {}): Promise<MissionPlan> {
143
+ const text = mission.trim();
144
+ if (!text) {
145
+ throw new Error("Пустая миссия: декомпозиция невозможна");
146
+ }
147
+ const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
148
+ assertMaxSteps(maxSteps);
149
+
150
+ if (options.decomposer) {
151
+ const raw = await options.decomposer.decompose(text);
152
+ return buildPlan(text, normalizeSteps(raw, maxSteps), "model");
153
+ }
154
+ return buildPlan(text, decomposeHeuristically(text, maxSteps), "heuristic");
155
+ }
156
+
157
+ /** Синхронный вариант для мест, где промис неудобен. */
158
+ export function planMissionSync(mission: string, options: Omit<PlanOptions, "decomposer"> = {}): MissionPlan {
159
+ const text = mission.trim();
160
+ if (!text) {
161
+ throw new Error("Пустая миссия: декомпозиция невозможна");
162
+ }
163
+ const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
164
+ assertMaxSteps(maxSteps);
165
+ return buildPlan(text, decomposeHeuristically(text, maxSteps), "heuristic");
166
+ }
@@ -0,0 +1,109 @@
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
+ /** Транспорт доставки шага. */
16
+ export type RouterTransport = "direct" | "mcp" | "cloud";
17
+
18
+ /** Исполнитель шага: локальный процесс или облачная модель. */
19
+ export type RouterExecutor = "local" | "cloud";
20
+
21
+ /** Правило статической маршрутизации для одного типа задачи. */
22
+ export interface StaticRouteRule {
23
+ /** Тип шага в нормализованном виде (нижний регистр, подчёркивания). */
24
+ taskType: string;
25
+ transport: RouterTransport;
26
+ executor: RouterExecutor;
27
+ /** Почему правило выглядит именно так — для логов и отчётов. */
28
+ description: string;
29
+ }
30
+
31
+ /**
32
+ * Встроенная таблица слоя 1.
33
+ *
34
+ * Совпадает с docs/ARCHITECTURE.md → «Слой 1 — статические правила»: известные
35
+ * операции обслуживаются локально и напрямую, внешние системы — через MCP,
36
+ * облачная модель — только там, где локально сделать нельзя.
37
+ */
38
+ export const STATIC_ROUTE_RULES: readonly StaticRouteRule[] = Object.freeze([
39
+ {
40
+ taskType: "read_file",
41
+ transport: "direct",
42
+ executor: "local",
43
+ description: "Чтение файла — прямое обращение к ФС, модель не нужна.",
44
+ },
45
+ {
46
+ taskType: "write_file",
47
+ transport: "direct",
48
+ executor: "local",
49
+ description: "Запись файла — прямое обращение к ФС, модель не нужна.",
50
+ },
51
+ {
52
+ taskType: "run_tests",
53
+ transport: "direct",
54
+ executor: "local",
55
+ description: "Тесты запускаются локальным процессом.",
56
+ },
57
+ {
58
+ taskType: "apply_diff",
59
+ transport: "direct",
60
+ executor: "local",
61
+ description: "Патч применяется локально, без внешних вызовов.",
62
+ },
63
+ {
64
+ taskType: "github_create_pr",
65
+ transport: "mcp",
66
+ executor: "local",
67
+ description: "Внешняя система GitHub — транспорт MCP, исполнитель локальный.",
68
+ },
69
+ {
70
+ taskType: "jira_update_task",
71
+ transport: "mcp",
72
+ executor: "cloud",
73
+ description: "Jira доступна только через MCP и облачный исполнитель.",
74
+ },
75
+ ]);
76
+
77
+ const ROUTE_TABLE: ReadonlyMap<string, StaticRouteRule> = new Map(
78
+ STATIC_ROUTE_RULES.map((rule) => [rule.taskType, rule]),
79
+ );
80
+
81
+ /**
82
+ * Нормализует тип задачи: `Run Tests`, `run-tests`, ` RUN_TESTS ` → `run_tests`.
83
+ * Нужна, потому что план миссии может прийти из модели в свободной форме.
84
+ */
85
+ export function normalizeTaskType(value: string): string {
86
+ return value
87
+ .trim()
88
+ .toLowerCase()
89
+ .replace(/[\s-]+/g, "_")
90
+ .replace(/_+/g, "_");
91
+ }
92
+
93
+ /** Возвращает правило слоя 1 для типа задачи или `undefined`, если тип неизвестен. */
94
+ export function routeStaticStep(taskType: string): StaticRouteRule | undefined {
95
+ if (typeof taskType !== "string" || taskType.trim() === "") {
96
+ return undefined;
97
+ }
98
+ return ROUTE_TABLE.get(normalizeTaskType(taskType));
99
+ }
100
+
101
+ /** Есть ли для типа задачи статическое правило (0 токенов, без БД). */
102
+ export function isStaticTaskType(taskType: string): boolean {
103
+ return routeStaticStep(taskType) !== undefined;
104
+ }
105
+
106
+ /** Снимок таблицы слоя 1 — для отчётов, GUI и тестов. */
107
+ export function listStaticRouteRules(): readonly StaticRouteRule[] {
108
+ return STATIC_ROUTE_RULES;
109
+ }
@@ -0,0 +1,262 @@
1
+ /**
2
+ * GUI/RPC-фасад над durable-запусками (Спринт 36.8).
3
+ *
4
+ * Тонкий слой между `runs-repo`/`run-context`/`run-resume` и RPC: приводит
5
+ * фильтр и лимит к безопасным значениям, отдаёт панели компактное описание
6
+ * запуска (текущий шаг, прогресс, история контекста) и не выпускает панику
7
+ * БД наружу.
8
+ *
9
+ * Resume здесь, как и retry в DLQ (36.6), только готовит запуск: снимает
10
+ * паузу/переоткрывает failed и возвращает первый незавершённый шаг.
11
+ * Выполнение шагов запускает исполнитель DAG через `resumeRun`, поэтому
12
+ * фасад не притворяется, что работа уже сделана.
13
+ */
14
+ import {
15
+ getRun,
16
+ listRuns,
17
+ listRunSteps,
18
+ reopenRun,
19
+ type RunRecord,
20
+ type RunStatus,
21
+ type RunStepRecord,
22
+ } from "../db/runs-repo.js";
23
+ import {
24
+ listRunInjections,
25
+ pauseRun,
26
+ type RunInjection,
27
+ type PauseRunInput,
28
+ } from "../db/run-context.js";
29
+ import { findResumeStep } from "../db/run-resume.js";
30
+
31
+ /** Фильтр панели: конкретный статус, все записи или активные. */
32
+ export type RunPanelFilter = RunStatus | "all" | "active";
33
+
34
+ /** Компактная вставка контекста для истории панели. */
35
+ export interface RunPanelInjection {
36
+ id: string;
37
+ kind: string;
38
+ /** Обрезанный до 500 символов текст (секреты уже замаскированы в БД). */
39
+ content: string;
40
+ contentLength: number;
41
+ author: string;
42
+ createdAt: string;
43
+ consumedAt: string | null;
44
+ consumedByStep: string | null;
45
+ }
46
+
47
+ /** Шаг запуска для панели. */
48
+ export interface RunPanelStep {
49
+ stepName: string;
50
+ position: number;
51
+ status: string;
52
+ attempt: number;
53
+ error: string | null;
54
+ /** Якорь для ссылки «текущий шаг». */
55
+ anchor: string;
56
+ }
57
+
58
+ /** Описание одного durable-запуска. */
59
+ export interface RunPanelRun {
60
+ id: string;
61
+ taskName: string;
62
+ status: RunStatus;
63
+ createdAt: string;
64
+ startedAt: string | null;
65
+ finishedAt: string | null;
66
+ error: string | null;
67
+ steps: RunPanelStep[];
68
+ /** Первый незавершённый шаг или null, если все шаги закрыты. */
69
+ currentStep: RunPanelStep | null;
70
+ /** Сколько шагов уже passed/skipped. */
71
+ doneSteps: number;
72
+ totalSteps: number;
73
+ injections: RunPanelInjection[];
74
+ pendingInjections: number;
75
+ }
76
+
77
+ export interface RunPanelListResult {
78
+ success: boolean;
79
+ runs: RunPanelRun[];
80
+ /** Сколько активных запусков (pending/running/paused/failed) для бейджа. */
81
+ active: number;
82
+ error?: string;
83
+ }
84
+
85
+ export interface RunPanelActionResult {
86
+ success: boolean;
87
+ error?: string;
88
+ run?: RunPanelRun;
89
+ /** Шаг, который получит контекст паузы или продолжит работу. */
90
+ stepName?: string | null;
91
+ /** true, если resume только переоткрыл запуск и подготовил шаг. */
92
+ prepared?: boolean;
93
+ }
94
+
95
+ const MAX_CONTENT_PREVIEW = 500;
96
+ const DEFAULT_LIMIT = 20;
97
+ const MAX_LIMIT = 100;
98
+ const ACTIVE_STATUSES: RunStatus[] = ["pending", "running", "paused", "failed"];
99
+
100
+ function errorText(err: unknown): string {
101
+ return err instanceof Error ? err.message : String(err);
102
+ }
103
+
104
+ /** Неизвестный фильтр трактуем как `active` — безопасный дефолт панели. */
105
+ export function normalizeRunPanelFilter(value: unknown): RunPanelFilter {
106
+ if (value === "all" || value === "active") return value;
107
+ if (
108
+ value === "pending" ||
109
+ value === "running" ||
110
+ value === "paused" ||
111
+ value === "passed" ||
112
+ value === "failed" ||
113
+ value === "cancelled"
114
+ ) {
115
+ return value;
116
+ }
117
+ return "active";
118
+ }
119
+
120
+ function normalizeLimit(value: unknown, fallback = DEFAULT_LIMIT): number {
121
+ const num = Math.floor(Number(value));
122
+ if (!Number.isFinite(num) || num < 1) return fallback;
123
+ return Math.min(num, MAX_LIMIT);
124
+ }
125
+
126
+ function stepAnchor(runId: string, stepName: string): string {
127
+ return `run-step-${runId}-${stepName.replace(/[^A-Za-z0-9_-]/g, "_")}`;
128
+ }
129
+
130
+ function toPanelStep(runId: string, step: RunStepRecord): RunPanelStep {
131
+ return {
132
+ stepName: step.stepName,
133
+ position: step.position,
134
+ status: step.status,
135
+ attempt: step.attempt,
136
+ error: step.error,
137
+ anchor: stepAnchor(runId, step.stepName),
138
+ };
139
+ }
140
+
141
+ function toPanelInjection(injection: RunInjection): RunPanelInjection {
142
+ return {
143
+ id: injection.id,
144
+ kind: injection.kind,
145
+ content:
146
+ injection.content.length > MAX_CONTENT_PREVIEW
147
+ ? `${injection.content.slice(0, MAX_CONTENT_PREVIEW)}…`
148
+ : injection.content,
149
+ contentLength: injection.content.length,
150
+ author: injection.author,
151
+ createdAt: injection.createdAt,
152
+ consumedAt: injection.consumedAt,
153
+ consumedByStep: injection.consumedByStep,
154
+ };
155
+ }
156
+
157
+ function isDone(step: RunStepRecord): boolean {
158
+ return step.status === "passed" || step.status === "skipped";
159
+ }
160
+
161
+ /** Собирает компактное описание запуска. */
162
+ export function getRunPanelRun(runId: string): RunPanelRun | undefined {
163
+ const run = getRun(runId);
164
+ if (!run) return undefined;
165
+ return toPanelRun(run);
166
+ }
167
+
168
+ function toPanelRun(run: RunRecord): RunPanelRun {
169
+ const steps = listRunSteps(run.id);
170
+ const panelSteps = steps.map((step) => toPanelStep(run.id, step));
171
+ const current = steps.find((step) => !isDone(step));
172
+ const allInjections = listRunInjections(run.id);
173
+ const injections = allInjections.slice(-20).map(toPanelInjection);
174
+ return {
175
+ id: run.id,
176
+ taskName: run.taskName,
177
+ status: run.status,
178
+ createdAt: run.createdAt,
179
+ startedAt: run.startedAt,
180
+ finishedAt: run.finishedAt,
181
+ error: run.error,
182
+ steps: panelSteps,
183
+ currentStep: current ? toPanelStep(run.id, current) : null,
184
+ doneSteps: steps.filter(isDone).length,
185
+ totalSteps: steps.length,
186
+ injections,
187
+ pendingInjections: allInjections.filter((item) => item.consumedAt === null).length,
188
+ };
189
+ }
190
+
191
+ /** Список запусков для панели и счётчик активных. */
192
+ export function listRunPanel(
193
+ options: { filter?: unknown; limit?: unknown } = {},
194
+ ): RunPanelListResult {
195
+ try {
196
+ const filter = normalizeRunPanelFilter(options.filter);
197
+ const limit = normalizeLimit(options.limit);
198
+ const all = listRuns(undefined, MAX_LIMIT);
199
+ const matching = all.filter((run) =>
200
+ filter === "all"
201
+ ? true
202
+ : filter === "active"
203
+ ? ACTIVE_STATUSES.includes(run.status)
204
+ : run.status === filter,
205
+ );
206
+ return {
207
+ success: true,
208
+ runs: matching.slice(0, limit).map(toPanelRun),
209
+ active: all.filter((run) => ACTIVE_STATUSES.includes(run.status)).length,
210
+ };
211
+ } catch (err) {
212
+ return { success: false, runs: [], active: 0, error: errorText(err) };
213
+ }
214
+ }
215
+
216
+ /**
217
+ * Пауза с комментарием. Ошибки (running-шаг, терминальный запуск, нет
218
+ * незавершённых шагов) возвращаются как `{ success: false }`, чтобы GUI
219
+ * показал их рядом с кнопкой.
220
+ */
221
+ export function pauseRunPanel(
222
+ runId: string,
223
+ input: Omit<PauseRunInput, "file" | "artifact"> = {},
224
+ ): RunPanelActionResult {
225
+ try {
226
+ const result = pauseRun(runId, input);
227
+ return {
228
+ success: true,
229
+ run: toPanelRun(result.run),
230
+ stepName: result.stepName,
231
+ };
232
+ } catch (err) {
233
+ return { success: false, error: errorText(err) };
234
+ }
235
+ }
236
+
237
+ /**
238
+ * Resume только готовит запуск: paused/failed → running, шаг остаётся
239
+ * незавершённым. Дальше его выполняет `resumeRun`/внешний исполнитель DAG.
240
+ */
241
+ export function resumeRunPanel(runId: string): RunPanelActionResult {
242
+ try {
243
+ const run = getRun(runId);
244
+ if (!run) return { success: false, error: `Запуск не найден: ${runId}` };
245
+ if (run.status !== "paused" && run.status !== "failed") {
246
+ return {
247
+ success: false,
248
+ error: `Запуск в статусе ${run.status} нельзя возобновить: ${runId}`,
249
+ };
250
+ }
251
+ reopenRun(runId);
252
+ const next = findResumeStep(runId);
253
+ return {
254
+ success: true,
255
+ run: toPanelRun(getRun(runId)!),
256
+ stepName: next?.stepName ?? null,
257
+ prepared: true,
258
+ };
259
+ } catch (err) {
260
+ return { success: false, error: errorText(err) };
261
+ }
262
+ }
@@ -85,7 +85,7 @@ function roundUsd(value: number): number {
85
85
  */
86
86
  export function computeSavings(
87
87
  records: SavingsRecord[],
88
- options: ComputeSavingsOptions = {}
88
+ options: ComputeSavingsOptions = {},
89
89
  ): SavingsReport {
90
90
  const reference = positiveNumber(options.referenceCostPer1kTokensUsd)
91
91
  || CLOUD_REFERENCE_COST_PER_1K_TOKENS_USD;
@@ -124,11 +124,11 @@ async function main(): Promise<number> {
124
124
 
125
125
  const days = daysArg
126
126
  ? normalizeActiveDays(
127
- daysArg
128
- .split(",")
129
- .map((value) => Number(value.trim()))
130
- .filter((value) => Number.isFinite(value))
131
- )
127
+ daysArg
128
+ .split(",")
129
+ .map((value) => Number(value.trim()))
130
+ .filter((value) => Number.isFinite(value)),
131
+ )
132
132
  : undefined;
133
133
  const policy: "skip" | "postpone" | "run" =
134
134
  policyArg === "skip" || policyArg === "run" ? policyArg : "postpone";
@@ -161,11 +161,15 @@ async function main(): Promise<number> {
161
161
  try {
162
162
  spec = parseCron(cronExpr);
163
163
  } catch (err: any) {
164
+ // Fail-closed: при повреждённом cron проверка расписания невозможна.
165
+ // Если пропустить её (fail-open), задача с окном/днями будет
166
+ // запускаться на каждом минутном тике — включая дорогие LLM-агенты.
164
167
  console.error(
165
- `[schedule-gate] Невалидный cron «${cronExpr}»: ${
168
+ `[schedule-gate] ОШИБКА: невалидный cron «${cronExpr}»: ${
166
169
  err instanceof Error ? err.message : String(err)
167
- } — пропускаем проверку cron.`
170
+ }. Запуск пропущен (fail-closed). Исправьте расписание задачи.`,
168
171
  );
172
+ return 3;
169
173
  }
170
174
  }
171
175
 
@@ -191,7 +195,7 @@ async function main(): Promise<number> {
191
195
  // Окно закрыто, но время его открытия неизвестно (например, окно
192
196
  // выходит за горизонт поиска). Разрешать запуск в этом случае нельзя.
193
197
  console.error(
194
- `[schedule-gate] ${state.reason ?? "вне окна"} — время открытия окна неизвестно, запуск пропущен.`
198
+ `[schedule-gate] ${state.reason ?? "вне окна"} — время открытия окна неизвестно, запуск пропущен.`,
195
199
  );
196
200
  return 3;
197
201
  }
@@ -199,7 +203,7 @@ async function main(): Promise<number> {
199
203
  if (wait <= 0) return 0;
200
204
  if (wait > MAX_POSTPONE_MS) {
201
205
  console.error(
202
- `[schedule-gate] ${state.reason ?? "вне окна"} — до открытия больше 12 часов, тик пропущен.`
206
+ `[schedule-gate] ${state.reason ?? "вне окна"} — до открытия больше 12 часов, тик пропущен.`,
203
207
  );
204
208
  return 3;
205
209
  }
@@ -219,8 +223,8 @@ async function main(): Promise<number> {
219
223
 
220
224
  console.error(
221
225
  `[schedule-gate] ${state.reason ?? "Вне окна"} — запуск перенесён на ~${Math.round(
222
- wait / 60000
223
- )} мин.`
226
+ wait / 60000,
227
+ )} мин.`,
224
228
  );
225
229
  let remaining = wait;
226
230
  while (remaining > 0) {
@@ -246,8 +250,8 @@ main().then(
246
250
  (code) => process.exit(code),
247
251
  (err) => {
248
252
  console.error(
249
- `[schedule-gate] Непредвиденная ошибка: ${err instanceof Error ? err.message : String(err)} — запускаем.`
253
+ `[schedule-gate] Непредвиденная ошибка: ${err instanceof Error ? err.message : String(err)} — запускаем.`,
250
254
  );
251
255
  process.exit(1);
252
- }
256
+ },
253
257
  );