agent-steward 0.0.3 → 0.0.5
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.
- package/CHANGELOG.md +154 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +54 -9
- package/ROADMAP-STRATEGY.md +23 -20
- package/ROADMAP.md +140 -143
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +351 -0
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +18 -1
- package/dist/core/execution.d.ts +203 -0
- package/dist/core/execution.d.ts.map +1 -0
- package/dist/core/execution.js +309 -0
- package/dist/core/gate-integrity.d.ts +35 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +132 -0
- package/dist/core/git-trigger.d.ts.map +1 -1
- package/dist/core/git-trigger.js +14 -2
- package/dist/core/guard-run.d.ts +4 -0
- package/dist/core/guard-run.d.ts.map +1 -0
- package/dist/core/guard-run.js +101 -0
- package/dist/core/guard.d.ts +52 -0
- package/dist/core/guard.d.ts.map +1 -0
- package/dist/core/guard.js +362 -0
- package/dist/core/lock.d.ts +61 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +213 -26
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +75 -15
- package/dist/core/mission.d.ts +83 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +334 -0
- package/dist/core/one-shot.d.ts +5 -1
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +33 -8
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- package/dist/core/pipeline-apply.d.ts +38 -0
- package/dist/core/pipeline-apply.d.ts.map +1 -0
- package/dist/core/pipeline-apply.js +117 -0
- package/dist/core/pipeline-io.d.ts +13 -0
- package/dist/core/pipeline-io.d.ts.map +1 -0
- package/dist/core/pipeline-io.js +64 -0
- package/dist/core/pipeline-map.d.ts +46 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +196 -0
- package/dist/core/pipeline-spec.d.ts +109 -0
- package/dist/core/pipeline-spec.d.ts.map +1 -0
- package/dist/core/pipeline-spec.js +554 -0
- package/dist/core/ps-wrapper.d.ts +19 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +261 -63
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +183 -58
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +91 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +34 -0
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +91 -5
- package/dist/core/scheduler/at-fallback.d.ts +55 -2
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
- package/dist/core/scheduler/at-fallback.js +135 -5
- package/dist/core/scheduler/linux.d.ts +18 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +63 -20
- package/dist/core/scheduler/mac.d.ts +44 -2
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +126 -15
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +25 -1
- package/dist/core/scheduler/registry.d.ts +11 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +15 -12
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +125 -28
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/structured-log.d.ts +7 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/worktree-run.d.ts +4 -0
- package/dist/core/worktree-run.d.ts.map +1 -0
- package/dist/core/worktree-run.js +164 -0
- package/dist/core/worktree.d.ts +115 -0
- package/dist/core/worktree.d.ts.map +1 -0
- package/dist/core/worktree.js +462 -0
- package/dist/core/wrappers/bash.d.ts +17 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +224 -28
- package/dist/db/capability-repo.d.ts +124 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +267 -0
- package/dist/db/history-repo.d.ts +46 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +107 -25
- package/dist/db/index.d.ts +4 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +39 -1
- package/dist/db/metrics-repo.js +2 -2
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +5 -4
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-journal.d.ts +33 -5
- package/dist/db/run-journal.d.ts.map +1 -1
- package/dist/db/run-journal.js +78 -14
- package/dist/db/run-resume.d.ts +10 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +39 -13
- package/dist/db/runs-repo.d.ts +32 -7
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +50 -11
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +216 -3
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/history.d.ts +1 -1
- package/dist/history.d.ts.map +1 -1
- package/dist/i18n.d.ts +5 -0
- package/dist/i18n.d.ts.map +1 -1
- package/dist/i18n.js +11 -4
- package/dist/index.d.ts +140 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +480 -18
- package/dist/notifications.d.ts +22 -0
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +36 -8
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +25 -4
- package/dist/rpc.d.ts +924 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +352 -0
- package/dist/server.d.ts +46 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +172 -53
- package/dist/settings.d.ts +2 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +3 -3
- package/dist/shared/jobs-view.d.ts +1 -1
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/shared/jobs-view.js +2 -0
- package/dist/task-transfer.d.ts +16 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +16 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +7 -0
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +43 -8
- package/docs/ARCHITECTURE.md +498 -58
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +185 -91
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +211 -0
- package/docs/FEATURES.md +65 -4
- package/docs/FEATURES.zh.md +52 -4
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/README.ru.md +44 -5
- package/docs/README.zh.md +46 -6
- package/docs/SAFETY.md +142 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +84 -1
- package/locales/ru.json +84 -1
- package/locales/zh.json +84 -1
- package/opencode.pipeline.yaml +35 -0
- package/package.json +46 -2
- package/scripts/audit-bundle.mjs +215 -0
- package/scripts/test-home.mjs +83 -0
- package/src/cli.ts +412 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +27 -3
- package/src/core/execution.ts +538 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +160 -0
- package/src/core/git-trigger.ts +18 -5
- package/src/core/guard-run.ts +119 -0
- package/src/core/guard.ts +431 -0
- package/src/core/lock.ts +244 -30
- package/src/core/matrix.ts +95 -50
- package/src/core/mission.ts +485 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/one-shot.ts +36 -8
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +79 -0
- package/src/core/pipeline-map.ts +264 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +274 -64
- package/src/core/record-history.ts +229 -104
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +115 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +7 -3
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +72 -21
- package/src/core/scheduler/logs.ts +2 -2
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/posix.ts +20 -1
- package/src/core/scheduler/registry.ts +107 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +131 -31
- package/src/core/session.ts +23 -10
- package/src/core/structured-log.ts +22 -5
- package/src/core/task-name.ts +67 -0
- package/src/core/telegram.ts +2 -2
- package/src/core/triage-worker.ts +7 -7
- package/src/core/triage.ts +2 -2
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +239 -27
- package/src/db/capability-repo.ts +402 -0
- package/src/db/history-repo.ts +151 -22
- package/src/db/index.ts +37 -1
- package/src/db/metrics-repo.ts +2 -2
- package/src/db/migrate.ts +3 -1
- package/src/db/recovery.ts +5 -4
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +65 -13
- package/src/db/runs-repo.ts +66 -13
- package/src/db/schema.ts +218 -3
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +692 -13
- package/src/history.ts +1 -1
- package/src/i18n.ts +12 -4
- package/src/index.ts +648 -8
- package/src/notifications.ts +38 -8
- package/src/profiles.ts +26 -4
- package/src/rpc.ts +379 -0
- package/src/server.ts +206 -54
- package/src/settings.ts +5 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +31 -0
- package/src/types.ts +9 -0
- package/src/workspaces.ts +58 -9
|
@@ -1,14 +1,38 @@
|
|
|
1
1
|
import { spawn } from "node:child_process";
|
|
2
2
|
import fs from "node:fs";
|
|
3
|
+
import os from "node:os";
|
|
3
4
|
import { pathToFileURL } from "node:url";
|
|
5
|
+
import { runTaskNow } from "./scheduler/run-now.js";
|
|
4
6
|
import { createSchedulerBackend } from "./scheduler/index.js";
|
|
5
7
|
import { notifyTaskCompletion } from "../notifications.js";
|
|
6
|
-
import { finishRun,
|
|
7
|
-
import {
|
|
8
|
+
import { finishRun, getLatestHistoryByTask, recordRun, startRun } from "../db/history-repo.js";
|
|
9
|
+
import { deleteSetting, decrementCounterSetting } from "../db/settings-repo.js";
|
|
8
10
|
import { getTask, listTasks } from "../db/tasks-repo.js";
|
|
9
11
|
import { rotateSessionIfNeeded } from "./session.js";
|
|
10
12
|
import { advanceMatrixAfterClone, finalizeMatrixIfComplete, } from "./matrix.js";
|
|
11
|
-
|
|
13
|
+
import { appendStructuredLog } from "./structured-log.js";
|
|
14
|
+
/**
|
|
15
|
+
* Диагностика рекордера пишется в runs.jsonl: цепочки, DAG, повторы и
|
|
16
|
+
* one-shot-очистка иначе не видны в машиночитаемом логе. Human-readable
|
|
17
|
+
* вывод остаётся только в логе задачи; stdout `--start` не трогаем — обёртка
|
|
18
|
+
* читает оттуда runId.
|
|
19
|
+
*/
|
|
20
|
+
function logRecorderEvent(event, task, details = {}) {
|
|
21
|
+
appendStructuredLog({
|
|
22
|
+
event,
|
|
23
|
+
task,
|
|
24
|
+
runId: details.runId,
|
|
25
|
+
status: details.status,
|
|
26
|
+
error: details.error,
|
|
27
|
+
reason: details.reason,
|
|
28
|
+
nextTask: details.nextTask,
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
/** Префикс ключа настроек со счётчиком повторов конкретной задачи. */
|
|
32
|
+
const RETRY_STATE_PREFIX = "retry_state:";
|
|
33
|
+
function retryStateKey(taskName) {
|
|
34
|
+
return `${RETRY_STATE_PREFIX}${taskName.toLowerCase()}`;
|
|
35
|
+
}
|
|
12
36
|
/** Сколько последних строк лога сканировать при поиске токенов/стоимости. */
|
|
13
37
|
const LOG_TAIL_LINES = 500;
|
|
14
38
|
/**
|
|
@@ -110,29 +134,23 @@ async function loadRetryConfig(taskName) {
|
|
|
110
134
|
*/
|
|
111
135
|
async function triggerTask(taskName) {
|
|
112
136
|
try {
|
|
113
|
-
await
|
|
137
|
+
await runTaskNow(taskName);
|
|
114
138
|
return true;
|
|
115
139
|
}
|
|
116
140
|
catch (err) {
|
|
117
|
-
|
|
141
|
+
logRecorderEvent("chain.trigger_failed", taskName, {
|
|
142
|
+
nextTask: taskName,
|
|
143
|
+
error: err instanceof Error ? err.message : String(err),
|
|
144
|
+
});
|
|
118
145
|
return false;
|
|
119
146
|
}
|
|
120
147
|
}
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
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
|
-
}
|
|
148
|
+
/*
|
|
149
|
+
* P2-30: раньше счётчики повторов лежали одним JSON-объектом в настройках.
|
|
150
|
+
* Каждое завершение задачи — отдельный процесс record-history, поэтому
|
|
151
|
+
* параллельные завершения перезаписывали map и теряли декременты. Теперь
|
|
152
|
+
* на задачу отдельный ключ и атомарный UPDATE ... RETURNING.
|
|
153
|
+
*/
|
|
136
154
|
/**
|
|
137
155
|
* Планирует повторный запуск упавшей задачи.
|
|
138
156
|
*
|
|
@@ -146,18 +164,13 @@ async function scheduleRetry(taskName) {
|
|
|
146
164
|
const { count, delay } = await loadRetryConfig(taskName);
|
|
147
165
|
if (count <= 0)
|
|
148
166
|
return false;
|
|
149
|
-
const
|
|
150
|
-
const
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
:
|
|
154
|
-
if (remaining <= 0) {
|
|
155
|
-
await clearRetryState(taskName);
|
|
156
|
-
console.log(`[agent-steward] Повторы для "${taskName}" исчерпаны.`);
|
|
167
|
+
const key = retryStateKey(taskName);
|
|
168
|
+
const remaining = decrementCounterSetting(key, count);
|
|
169
|
+
if (remaining === null) {
|
|
170
|
+
deleteSetting(key);
|
|
171
|
+
logRecorderEvent("retry.exhausted", taskName, { reason: "retries exhausted" });
|
|
157
172
|
return false;
|
|
158
173
|
}
|
|
159
|
-
state[key] = remaining - 1;
|
|
160
|
-
await writeRetryState(state);
|
|
161
174
|
const script = process.argv[1];
|
|
162
175
|
if (!script)
|
|
163
176
|
return false;
|
|
@@ -169,12 +182,15 @@ async function scheduleRetry(taskName) {
|
|
|
169
182
|
windowsHide: true,
|
|
170
183
|
});
|
|
171
184
|
child.unref();
|
|
172
|
-
|
|
173
|
-
`
|
|
185
|
+
logRecorderEvent("retry.scheduled", taskName, {
|
|
186
|
+
reason: `delay=${delay}s, remaining=${remaining}`,
|
|
187
|
+
});
|
|
174
188
|
return true;
|
|
175
189
|
}
|
|
176
190
|
catch (err) {
|
|
177
|
-
|
|
191
|
+
logRecorderEvent("retry.schedule_failed", taskName, {
|
|
192
|
+
error: err instanceof Error ? err.message : String(err),
|
|
193
|
+
});
|
|
178
194
|
return false;
|
|
179
195
|
}
|
|
180
196
|
}
|
|
@@ -188,11 +204,13 @@ async function runRetry(taskName, delaySec) {
|
|
|
188
204
|
const delay = Math.max(1, Math.floor(Number(delaySec) || 60));
|
|
189
205
|
await new Promise((resolve) => setTimeout(resolve, delay * 1000));
|
|
190
206
|
try {
|
|
191
|
-
await
|
|
192
|
-
|
|
207
|
+
await runTaskNow(taskName);
|
|
208
|
+
logRecorderEvent("retry.started", taskName);
|
|
193
209
|
}
|
|
194
210
|
catch (err) {
|
|
195
|
-
|
|
211
|
+
logRecorderEvent("retry.failed", taskName, {
|
|
212
|
+
error: err instanceof Error ? err.message : String(err),
|
|
213
|
+
});
|
|
196
214
|
}
|
|
197
215
|
}
|
|
198
216
|
/**
|
|
@@ -280,6 +298,36 @@ async function main() {
|
|
|
280
298
|
await runRetry(second, Number(third));
|
|
281
299
|
return;
|
|
282
300
|
}
|
|
301
|
+
/**
|
|
302
|
+
* W-4: режим пропуска — node record-history.js --skip "<task>" "<reasonB64>" "<logFile>" [durationMs]
|
|
303
|
+
* Вызывается обёртками при срабатывании guard (код 4). Причина передаётся
|
|
304
|
+
* base64, чтобы не подставлять произвольный текст в командную строку. Пропуск
|
|
305
|
+
* попадает в историю и total-метрику, но не считается ошибкой, не шлёт
|
|
306
|
+
* уведомление, не запускает цепочки/повторы и не запускает DAG.
|
|
307
|
+
*/
|
|
308
|
+
if (first === "--skip") {
|
|
309
|
+
const taskName = second;
|
|
310
|
+
if (!taskName)
|
|
311
|
+
process.exit(1);
|
|
312
|
+
let reason = "guard conditions not met";
|
|
313
|
+
if (third) {
|
|
314
|
+
try {
|
|
315
|
+
const decoded = Buffer.from(third, "base64").toString("utf8").trim();
|
|
316
|
+
if (decoded)
|
|
317
|
+
reason = decoded;
|
|
318
|
+
}
|
|
319
|
+
catch {
|
|
320
|
+
// Битая base64 — оставляем причину по умолчанию.
|
|
321
|
+
}
|
|
322
|
+
}
|
|
323
|
+
const durationMs = Math.max(0, Number(fifth) || 0);
|
|
324
|
+
const finishedAt = new Date().toISOString();
|
|
325
|
+
const startedAt = new Date(Date.now() - durationMs).toISOString();
|
|
326
|
+
const definition = getTask(taskName);
|
|
327
|
+
recordRun(taskName, "skipped", startedAt, durationMs, reason, null, undefined, undefined, undefined, undefined, undefined, finishedAt, definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
|
|
328
|
+
await handleCompletion(taskName, "skipped", null, reason, durationMs);
|
|
329
|
+
return;
|
|
330
|
+
}
|
|
283
331
|
const parseOptionalNumber = (value) => {
|
|
284
332
|
if (!value || value === "-")
|
|
285
333
|
return undefined;
|
|
@@ -305,7 +353,14 @@ async function main() {
|
|
|
305
353
|
process.exit(1);
|
|
306
354
|
const startedAt = third ?? new Date().toISOString();
|
|
307
355
|
const definition = getTask(taskName);
|
|
308
|
-
|
|
356
|
+
// Владелец — процесс-обёртка, запустивший recorder. Он живёт дольше
|
|
357
|
+
// короткоживущего recorder'а, поэтому именно его PID проверяет recovery.
|
|
358
|
+
const owner = {
|
|
359
|
+
pid: process.ppid && process.ppid > 0 ? process.ppid : null,
|
|
360
|
+
host: os.hostname(),
|
|
361
|
+
startedAt: new Date().toISOString(),
|
|
362
|
+
};
|
|
363
|
+
const runId = startRun(taskName, startedAt, definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null, owner);
|
|
309
364
|
console.log(String(runId));
|
|
310
365
|
return;
|
|
311
366
|
}
|
|
@@ -342,14 +397,19 @@ async function main() {
|
|
|
342
397
|
const model = ninth && ninth !== "-" ? ninth.trim() || undefined : undefined;
|
|
343
398
|
const preFlightStatus = parseHookStatus(tenth);
|
|
344
399
|
const postFlightStatus = parseHookStatus(eleventh);
|
|
345
|
-
const st = status === "success" ? "success" : status === "timeout" ? "timeout" : "error";
|
|
400
|
+
const st = status === "success" ? "success" : status === "timeout" ? "timeout" : status === "skipped" ? "skipped" : "error";
|
|
346
401
|
const definition = getTask(taskName);
|
|
347
402
|
const chainTarget = st === "success"
|
|
348
403
|
? definition?.nextTaskOnSuccess || null
|
|
349
|
-
:
|
|
404
|
+
: st === "skipped"
|
|
405
|
+
? null
|
|
406
|
+
: definition?.nextTaskOnError || null;
|
|
350
407
|
const completed = finishRun(runId, st, durationMs, error, chainTarget, tokensResolved, costResolved, model, preFlightStatus, postFlightStatus);
|
|
351
408
|
if (!completed) {
|
|
352
|
-
|
|
409
|
+
logRecorderEvent("run.finish_skipped", taskName, {
|
|
410
|
+
runId,
|
|
411
|
+
reason: "already finished or not found",
|
|
412
|
+
});
|
|
353
413
|
return;
|
|
354
414
|
}
|
|
355
415
|
await handleCompletion(taskName, st, chainTarget, error, durationMs, tokensResolved, costResolved);
|
|
@@ -368,18 +428,66 @@ async function main() {
|
|
|
368
428
|
// "-" означает «данных нет» (openCode не печатал usage в лог).
|
|
369
429
|
const tokens = parseOptionalNumber(sixth);
|
|
370
430
|
const costUsd = parseOptionalNumber(seventh);
|
|
431
|
+
// B10: 11-й аргумент — лог-файл задачи. Раньше legacy-режим его не читал,
|
|
432
|
+
// поэтому при "-" в токенах/стоимости usage терялся. Парсим лог так же,
|
|
433
|
+
// как режим --finish; отсутствие файла — graceful fallback (parseUsageFromLog
|
|
434
|
+
// возвращает пустой объект и не бросает).
|
|
435
|
+
const logFile = eleventh && eleventh !== "-" ? eleventh : undefined;
|
|
436
|
+
let tokensResolved = tokens;
|
|
437
|
+
let costResolved = costUsd;
|
|
438
|
+
if ((tokensResolved === undefined || costResolved === undefined) && logFile) {
|
|
439
|
+
const usage = parseUsageFromLog(logFile);
|
|
440
|
+
if (tokensResolved === undefined && usage.tokens !== undefined) {
|
|
441
|
+
tokensResolved = usage.tokens;
|
|
442
|
+
}
|
|
443
|
+
if (costResolved === undefined && usage.costUsd !== undefined) {
|
|
444
|
+
costResolved = usage.costUsd;
|
|
445
|
+
}
|
|
446
|
+
}
|
|
371
447
|
// Восьмой аргумент — модель; "-" означает, что модель не задана.
|
|
372
448
|
const model = eighth && eighth !== "-" ? eighth.trim() || undefined : undefined;
|
|
373
449
|
// Девятый и десятый — итоги pre/post-flight хуков.
|
|
374
450
|
const preFlightStatus = parseHookStatus(ninth);
|
|
375
451
|
const postFlightStatus = parseHookStatus(tenth);
|
|
376
|
-
const st = status === "success" ? "success" : status === "timeout" ? "timeout" : "error";
|
|
452
|
+
const st = status === "success" ? "success" : status === "timeout" ? "timeout" : status === "skipped" ? "skipped" : "error";
|
|
377
453
|
const definition = getTask(taskName);
|
|
378
454
|
const chainTarget = st === "success"
|
|
379
455
|
? definition?.nextTaskOnSuccess || null
|
|
380
|
-
:
|
|
381
|
-
|
|
382
|
-
|
|
456
|
+
: st === "skipped"
|
|
457
|
+
? null
|
|
458
|
+
: definition?.nextTaskOnError || null;
|
|
459
|
+
recordRun(taskName, st, startedAt, durationMs, error, chainTarget, tokensResolved, costResolved, model, preFlightStatus, postFlightStatus, new Date().toISOString(), definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
|
|
460
|
+
await handleCompletion(taskName, st, chainTarget, error, durationMs, tokensResolved, costResolved);
|
|
461
|
+
}
|
|
462
|
+
/**
|
|
463
|
+
* Удаляет отработавшую ONCE-задачу из Планировщика Windows.
|
|
464
|
+
*
|
|
465
|
+
* `schtasks /create ... /z` должен был делать это сам, но на Win10/11
|
|
466
|
+
* возвращает «The task XML is missing a required element ... EndBoundary»
|
|
467
|
+
* и задача вообще не создаётся. Поэтому чистим после запуска вручную.
|
|
468
|
+
* На Linux/macOS очистка не нужна: `at` и launchd убирают one-shot сами.
|
|
469
|
+
*/
|
|
470
|
+
export async function cleanupWindowsOneShotTask(taskName, deps = {}) {
|
|
471
|
+
const platform = deps.platform ?? process.platform;
|
|
472
|
+
if (platform !== "win32")
|
|
473
|
+
return false;
|
|
474
|
+
const getDefinition = deps.getDefinition ?? getTask;
|
|
475
|
+
const definition = getDefinition(taskName);
|
|
476
|
+
if (!definition || definition.triggerType !== "once")
|
|
477
|
+
return false;
|
|
478
|
+
const deleteTask = deps.deleteTask ??
|
|
479
|
+
((name) => createSchedulerBackend().deleteTask(name));
|
|
480
|
+
try {
|
|
481
|
+
await deleteTask(taskName);
|
|
482
|
+
logRecorderEvent("oneshot.cleaned", taskName);
|
|
483
|
+
return true;
|
|
484
|
+
}
|
|
485
|
+
catch (err) {
|
|
486
|
+
logRecorderEvent("oneshot.cleanup_failed", taskName, {
|
|
487
|
+
error: err instanceof Error ? err.message : String(err),
|
|
488
|
+
});
|
|
489
|
+
return false;
|
|
490
|
+
}
|
|
383
491
|
}
|
|
384
492
|
/**
|
|
385
493
|
* Общая пост-обработка завершённого запуска: уведомление, цепочки задач,
|
|
@@ -387,10 +495,17 @@ async function main() {
|
|
|
387
495
|
*/
|
|
388
496
|
async function handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd) {
|
|
389
497
|
// Уведомление о завершении (webhook). Ошибки отправки логируются внутри
|
|
390
|
-
// и не влияют на историю, цепочки и повторы.
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
498
|
+
// и не влияют на историю, цепочки и повторы. Пропуск guard не уведомляем:
|
|
499
|
+
// для него нет отдельного шаблона, а шум в уведомлениях не нужен.
|
|
500
|
+
if (st !== "skipped") {
|
|
501
|
+
await notifyTaskCompletion(taskName, st, durationMs, error, tokens, costUsd, {
|
|
502
|
+
asyncTriage: true,
|
|
503
|
+
});
|
|
504
|
+
}
|
|
505
|
+
// P2-27: Windows не удаляет ONCE-задачи сам, а флаг schtasks `/z` на
|
|
506
|
+
// практике ломает создание задачи («task XML ... EndBoundary»).
|
|
507
|
+
// Поэтому снимаем отработавшую one-shot задачу из Планировщика здесь.
|
|
508
|
+
await cleanupWindowsOneShotTask(taskName);
|
|
394
509
|
// Matrix (Спринт 15): клон завершился — двигаем sequential-цепочку или
|
|
395
510
|
// очередь concurrency-лимита (Спринт 17), а когда все клоны готовы —
|
|
396
511
|
// фиксируем агрегат и запускаем matrix-complete.
|
|
@@ -399,43 +514,49 @@ async function handleCompletion(taskName, st, chainTarget, error, durationMs, to
|
|
|
399
514
|
await finalizeMatrixIfComplete(taskName);
|
|
400
515
|
}
|
|
401
516
|
catch (err) {
|
|
402
|
-
|
|
517
|
+
logRecorderEvent("matrix.error", taskName, {
|
|
518
|
+
error: err instanceof Error ? err.message : String(err),
|
|
519
|
+
});
|
|
403
520
|
}
|
|
404
521
|
if (st === "success") {
|
|
405
522
|
// Успешный запуск сбрасывает счётчик повторов.
|
|
406
|
-
await
|
|
523
|
+
await deleteSetting(retryStateKey(taskName));
|
|
407
524
|
if (chainTarget) {
|
|
408
525
|
const started = await triggerTask(chainTarget);
|
|
409
526
|
if (started) {
|
|
410
|
-
|
|
527
|
+
logRecorderEvent("chain.triggered", taskName, { nextTask: chainTarget });
|
|
411
528
|
}
|
|
412
529
|
}
|
|
413
530
|
// DAG: после успеха проверяем задачи, у которых эта задача — одна из
|
|
414
531
|
// зависимостей. Запускаем только если ВСЕ зависимости уже успешны и
|
|
415
532
|
// зависимая задача ещё не запускалась после их завершения.
|
|
416
533
|
try {
|
|
417
|
-
|
|
534
|
+
// P2-29: по одной последней записи на задачу, а не «последние 200 строк».
|
|
535
|
+
const history = getLatestHistoryByTask();
|
|
418
536
|
const definitions = listTasks();
|
|
419
537
|
const dependents = selectDependentsToTrigger(taskName, definitions, history);
|
|
420
538
|
for (const dependent of dependents) {
|
|
421
539
|
const started = await triggerTask(dependent);
|
|
422
540
|
if (started) {
|
|
423
|
-
|
|
541
|
+
logRecorderEvent("dag.triggered", taskName, { nextTask: dependent });
|
|
424
542
|
}
|
|
425
543
|
}
|
|
426
544
|
}
|
|
427
545
|
catch (err) {
|
|
428
|
-
|
|
546
|
+
logRecorderEvent("dag.trigger_failed", taskName, {
|
|
547
|
+
error: err instanceof Error ? err.message : String(err),
|
|
548
|
+
});
|
|
429
549
|
}
|
|
430
550
|
}
|
|
431
|
-
else {
|
|
551
|
+
else if (st !== "skipped") {
|
|
432
552
|
// Сначала пытаемся повторить саму задачу; компенсирующая задача запускается
|
|
433
553
|
// только когда повторы исчерпаны (или не настроены).
|
|
554
|
+
// Пропуск guard — не ошибка: повторы и компенсации не запускаются.
|
|
434
555
|
const retryScheduled = await scheduleRetry(taskName);
|
|
435
556
|
if (!retryScheduled && chainTarget) {
|
|
436
557
|
const started = await triggerTask(chainTarget);
|
|
437
558
|
if (started) {
|
|
438
|
-
|
|
559
|
+
logRecorderEvent("compensation.triggered", taskName, { nextTask: chainTarget });
|
|
439
560
|
}
|
|
440
561
|
}
|
|
441
562
|
}
|
|
@@ -445,7 +566,9 @@ async function handleCompletion(taskName, st, chainTarget, error, durationMs, to
|
|
|
445
566
|
await rotateSessionIfNeeded(taskName);
|
|
446
567
|
}
|
|
447
568
|
catch (err) {
|
|
448
|
-
|
|
569
|
+
logRecorderEvent("session.rotate_failed", taskName, {
|
|
570
|
+
error: err instanceof Error ? err.message : String(err),
|
|
571
|
+
});
|
|
449
572
|
}
|
|
450
573
|
}
|
|
451
574
|
/**
|
|
@@ -465,7 +588,9 @@ function isDirectInvocation() {
|
|
|
465
588
|
}
|
|
466
589
|
if (isDirectInvocation()) {
|
|
467
590
|
main().catch((err) => {
|
|
468
|
-
|
|
591
|
+
logRecorderEvent("record_history.fatal", "record-history", {
|
|
592
|
+
error: err instanceof Error ? err.message : String(err),
|
|
593
|
+
});
|
|
469
594
|
process.exit(1);
|
|
470
595
|
});
|
|
471
596
|
}
|
|
@@ -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
|
+
}
|