agent-steward 0.0.4 → 0.0.6
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 +309 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +55 -8
- package/ROADMAP-STRATEGY.md +22 -19
- package/ROADMAP.md +230 -159
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +356 -0
- package/dist/core/analytics.d.ts +6 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +20 -3
- package/dist/core/audit.d.ts +6 -0
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +24 -0
- package/dist/core/budget.d.ts +118 -0
- package/dist/core/budget.d.ts.map +1 -0
- package/dist/core/budget.js +206 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +38 -0
- package/dist/core/dry-run.d.ts +26 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +199 -8
- 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/feedback.d.ts +192 -0
- package/dist/core/feedback.d.ts.map +1 -0
- package/dist/core/feedback.js +426 -0
- package/dist/core/gate-integrity.d.ts +71 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +275 -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/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/lock.d.ts +41 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +141 -29
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +132 -17
- package/dist/core/mission.d.ts +103 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +374 -0
- package/dist/core/opencode-models.d.ts +2 -2
- package/dist/core/opencode-models.d.ts.map +1 -1
- package/dist/core/opencode-models.js +28 -21
- package/dist/core/opencode-usage.d.ts +35 -0
- package/dist/core/opencode-usage.d.ts.map +1 -0
- package/dist/core/opencode-usage.js +132 -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 +78 -0
- package/dist/core/pipeline-map.d.ts +52 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +208 -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 +27 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +424 -65
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +206 -33
- package/dist/core/router/rules.d.ts.map +1 -1
- package/dist/core/router/rules.js +6 -0
- package/dist/core/run-mode.d.ts +12 -0
- package/dist/core/run-mode.d.ts.map +1 -0
- package/dist/core/run-mode.js +17 -0
- package/dist/core/scheduler/linux.d.ts +8 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +34 -9
- package/dist/core/scheduler/logs.d.ts +4 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -1
- package/dist/core/scheduler/logs.js +25 -1
- 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/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 +18 -8
- package/dist/core/self-analysis.d.ts +32 -2
- package/dist/core/self-analysis.d.ts.map +1 -1
- package/dist/core/self-analysis.js +38 -27
- package/dist/core/shutdown.d.ts +33 -2
- package/dist/core/shutdown.d.ts.map +1 -1
- package/dist/core/shutdown.js +58 -2
- package/dist/core/structured-log.d.ts +37 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +37 -0
- package/dist/core/usage-surface.d.ts +25 -0
- package/dist/core/usage-surface.d.ts.map +1 -0
- package/dist/core/usage-surface.js +41 -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 +19 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +230 -27
- package/dist/db/capability-repo.d.ts +43 -2
- package/dist/db/capability-repo.d.ts.map +1 -1
- package/dist/db/capability-repo.js +96 -11
- package/dist/db/history-repo.d.ts +70 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +170 -29
- package/dist/db/metrics-repo.d.ts +20 -2
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +35 -13
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +37 -17
- package/dist/db/recovery.d.ts +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +11 -5
- 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 +5 -0
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +9 -2
- package/dist/db/runs-repo.d.ts +19 -2
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +91 -60
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +132 -2
- package/dist/db/templates-repo.d.ts +2 -2
- package/dist/db/templates-repo.d.ts.map +1 -1
- package/dist/db/templates-repo.js +5 -3
- package/dist/history.d.ts +7 -2
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +4 -2
- package/dist/hook-output.d.ts +2 -0
- package/dist/hook-output.d.ts.map +1 -0
- package/dist/hook-output.js +31 -0
- 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 +375 -47
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1344 -192
- package/dist/notifications.d.ts +53 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +168 -21
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +82 -10
- package/dist/rpc.d.ts +354 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +145 -0
- package/dist/server.d.ts +32 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +154 -30
- package/dist/settings.d.ts +44 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +85 -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 +21 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +64 -3
- package/dist/templates.d.ts +2 -2
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +3 -3
- package/dist/types.d.ts +22 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +34 -11
- package/docs/ARCHITECTURE.md +319 -66
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +18 -4
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +28 -10
- package/docs/FEATURES.md +129 -7
- package/docs/FEATURES.zh.md +97 -6
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +43 -4
- package/docs/README.zh.md +44 -4
- package/docs/SAFETY.md +23 -3
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +58 -3
- package/locales/ru.json +58 -3
- package/locales/zh.json +58 -3
- package/opencode.pipeline.yaml +35 -0
- package/package.json +36 -4
- package/scripts/check-eslint-baseline.mjs +139 -0
- package/scripts/gen-test-plan-counters.mjs +117 -0
- package/scripts/github-ci-fetch.ps1 +37 -0
- package/scripts/pl-commit.ps1 +112 -0
- package/scripts/qa-a2-commit.ps1 +104 -0
- package/scripts/test-home.mjs +107 -0
- package/skills/scheduled-job-best-practices/SKILL.md +95 -1
- package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
- package/src/cli.ts +417 -0
- package/src/core/analytics.ts +27 -4
- package/src/core/audit.ts +25 -0
- package/src/core/budget.ts +340 -0
- package/src/core/cron-to-schtasks.ts +42 -0
- package/src/core/dry-run.ts +235 -12
- package/src/core/execution.ts +538 -0
- package/src/core/feedback.ts +582 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +330 -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/local-ai.ts +7 -3
- package/src/core/lock.ts +178 -37
- package/src/core/matrix.ts +158 -52
- package/src/core/mission.ts +531 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +96 -0
- package/src/core/pipeline-map.ts +283 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +435 -66
- package/src/core/record-history.ts +258 -81
- package/src/core/router/rules.ts +6 -0
- package/src/core/run-mode.ts +19 -0
- package/src/core/schedule-gate.ts +1 -1
- package/src/core/scheduler/at-fallback.ts +1 -1
- package/src/core/scheduler/linux.ts +40 -11
- package/src/core/scheduler/logs.ts +34 -3
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/registry.ts +2 -2
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +26 -19
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +89 -5
- 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/usage-surface.ts +70 -0
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +248 -26
- package/src/db/capability-repo.ts +127 -10
- package/src/db/history-repo.ts +281 -40
- package/src/db/metrics-repo.ts +40 -13
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +12 -5
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +17 -1
- package/src/db/runs-repo.ts +147 -65
- package/src/db/schema.ts +134 -2
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +438 -18
- package/src/history.ts +11 -4
- package/src/hook-output.ts +39 -0
- package/src/i18n.ts +12 -4
- package/src/index.ts +1902 -320
- package/src/notifications.ts +227 -47
- package/src/profiles.ts +88 -10
- package/src/rpc.ts +158 -0
- package/src/server.ts +201 -41
- package/src/settings.ts +125 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +90 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
|
@@ -8,6 +8,15 @@ export const CLOUD_FAILURE_THRESHOLD = 0.3;
|
|
|
8
8
|
export const MIN_RUNS_FOR_DECISION = 3;
|
|
9
9
|
/** Сколько последних исходов хранить (1 — гейт пройден, 0 — провал). */
|
|
10
10
|
export const RECENT_RUNS_LIMIT = 10;
|
|
11
|
+
/**
|
|
12
|
+
* B13: полураспад веса исхода в последних прогонах. Исход давностью
|
|
13
|
+
* `SUCCESS_HALF_LIFE_RUNS` прогонов весит вдвое меньше свежего.
|
|
14
|
+
*/
|
|
15
|
+
export const SUCCESS_HALF_LIFE_RUNS = 8;
|
|
16
|
+
/** B13: доля затухающего success rate в итоговой надёжности. */
|
|
17
|
+
export const DECAY_WEIGHT = 0.7;
|
|
18
|
+
/** B13: доля first-pass rate в итоговой надёжности. */
|
|
19
|
+
export const FIRST_PASS_WEIGHT = 0.3;
|
|
11
20
|
const DEFAULT_MODEL = "local";
|
|
12
21
|
function nowIso() {
|
|
13
22
|
return new Date().toISOString();
|
|
@@ -24,6 +33,13 @@ function requireNonNegative(value, field) {
|
|
|
24
33
|
}
|
|
25
34
|
return value;
|
|
26
35
|
}
|
|
36
|
+
/** B13: номер попытки — целое ≥ 1. */
|
|
37
|
+
function requireAttempts(value) {
|
|
38
|
+
if (!Number.isInteger(value) || value < 1) {
|
|
39
|
+
throw new Error(`Некорректное значение attempts: ожидалось целое ≥ 1, получено ${value}.`);
|
|
40
|
+
}
|
|
41
|
+
return value;
|
|
42
|
+
}
|
|
27
43
|
function parseRecentRuns(raw) {
|
|
28
44
|
if (typeof raw !== "string" || raw.trim() === "") {
|
|
29
45
|
return [];
|
|
@@ -42,18 +58,57 @@ function parseRecentRuns(raw) {
|
|
|
42
58
|
return [];
|
|
43
59
|
}
|
|
44
60
|
}
|
|
61
|
+
/**
|
|
62
|
+
* B13: экспоненциально взвешенный success rate последних исходов.
|
|
63
|
+
*
|
|
64
|
+
* Свежий исход весит 1, исход давностью `halfLife` прогонов — 0.5.
|
|
65
|
+
* Так старые успехи не перевешивают свежие провалы, а `last_10_runs`
|
|
66
|
+
* участвует в решении, а не только хранится для отчёта.
|
|
67
|
+
*/
|
|
68
|
+
export function decayedSuccessRate(runs, halfLife = SUCCESS_HALF_LIFE_RUNS) {
|
|
69
|
+
const recent = runs
|
|
70
|
+
.filter((value) => value === 0 || value === 1)
|
|
71
|
+
.slice(-RECENT_RUNS_LIMIT);
|
|
72
|
+
if (recent.length === 0)
|
|
73
|
+
return 0;
|
|
74
|
+
const hl = Number.isFinite(halfLife) && halfLife > 0 ? halfLife : SUCCESS_HALF_LIFE_RUNS;
|
|
75
|
+
let weighted = 0;
|
|
76
|
+
let weights = 0;
|
|
77
|
+
recent.forEach((value, index) => {
|
|
78
|
+
const age = recent.length - 1 - index;
|
|
79
|
+
const weight = Math.pow(0.5, age / hl);
|
|
80
|
+
weighted += weight * value;
|
|
81
|
+
weights += weight;
|
|
82
|
+
});
|
|
83
|
+
return weights > 0 ? weighted / weights : 0;
|
|
84
|
+
}
|
|
85
|
+
/** B13: надёжность для маршрутизации — затухание плюс успех с первой попытки. */
|
|
86
|
+
export function effectiveReliability(decayedRate, firstPassRate) {
|
|
87
|
+
const decayed = Math.min(1, Math.max(0, decayedRate));
|
|
88
|
+
const firstPass = Math.min(1, Math.max(0, firstPassRate));
|
|
89
|
+
return DECAY_WEIGHT * decayed + FIRST_PASS_WEIGHT * firstPass;
|
|
90
|
+
}
|
|
45
91
|
function rowToRecord(row) {
|
|
46
92
|
const runsTotal = Number(row.runs_total) || 0;
|
|
47
93
|
const runsPassed = Number(row.runs_passed) || 0;
|
|
94
|
+
const successRate = Number(row.success_rate) || (runsTotal > 0 ? runsPassed / runsTotal : 0);
|
|
95
|
+
const firstPassCount = Number(row.first_pass_count) || 0;
|
|
96
|
+
const firstPassRate = runsTotal > 0 ? Math.min(1, firstPassCount / runsTotal) : 0;
|
|
97
|
+
const last10Runs = parseRecentRuns(row.last_10_runs);
|
|
98
|
+
const decayed = last10Runs.length > 0 ? decayedSuccessRate(last10Runs) : successRate;
|
|
48
99
|
return {
|
|
49
100
|
taskType: String(row.task_type),
|
|
50
101
|
model: String(row.model ?? DEFAULT_MODEL),
|
|
51
102
|
runsTotal,
|
|
52
103
|
runsPassed,
|
|
53
|
-
|
|
104
|
+
firstPassCount,
|
|
105
|
+
firstPassRate,
|
|
106
|
+
successRate,
|
|
107
|
+
decayedSuccessRate: decayed,
|
|
108
|
+
effectiveSuccessRate: effectiveReliability(decayed, firstPassRate),
|
|
54
109
|
avgCostUsd: Number(row.avg_cost_usd) || 0,
|
|
55
110
|
avgTimeMs: Number(row.avg_time_ms) || 0,
|
|
56
|
-
last10Runs
|
|
111
|
+
last10Runs,
|
|
57
112
|
createdAt: String(row.created_at),
|
|
58
113
|
updatedAt: String(row.updated_at),
|
|
59
114
|
};
|
|
@@ -89,15 +144,24 @@ export function recordCapabilityOutcome(outcome) {
|
|
|
89
144
|
const time = outcome.timeMs === undefined ? 0 : requireNonNegative(outcome.timeMs, "timeMs");
|
|
90
145
|
const model = (outcome.model ?? DEFAULT_MODEL).trim() || DEFAULT_MODEL;
|
|
91
146
|
const passed = outcome.passed ? 1 : 0;
|
|
147
|
+
const attempts = outcome.attempts === undefined ? undefined : requireAttempts(outcome.attempts);
|
|
148
|
+
if (outcome.firstPass !== undefined && typeof outcome.firstPass !== "boolean") {
|
|
149
|
+
throw new Error("Признак firstPass должен быть boolean.");
|
|
150
|
+
}
|
|
151
|
+
// B13: без явного признака успех считается первым, если попытка одна
|
|
152
|
+
// (или число попыток не передано — обратная совместимость).
|
|
153
|
+
const firstPass = passed === 1 &&
|
|
154
|
+
(outcome.firstPass ?? (attempts === undefined || attempts === 1));
|
|
155
|
+
const firstPassIncrement = firstPass ? 1 : 0;
|
|
92
156
|
return withTransaction(() => {
|
|
93
157
|
const db = getDb();
|
|
94
158
|
const timestamp = nowIso();
|
|
95
159
|
const existing = getCapability(key);
|
|
96
160
|
if (!existing) {
|
|
97
161
|
db.prepare(`INSERT INTO capability_map (
|
|
98
|
-
task_type, model, runs_total, runs_passed, success_rate,
|
|
162
|
+
task_type, model, runs_total, runs_passed, first_pass_count, success_rate,
|
|
99
163
|
avg_cost_usd, avg_time_ms, last_10_runs, created_at, updated_at
|
|
100
|
-
) VALUES (?, ?, 1, ?, ?, ?, ?, ?, ?, ?)`).run(key, model, passed, passed, cost, time, JSON.stringify([passed]), timestamp, timestamp);
|
|
164
|
+
) VALUES (?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?)`).run(key, model, passed, firstPassIncrement, passed, cost, time, JSON.stringify([passed]), timestamp, timestamp);
|
|
101
165
|
}
|
|
102
166
|
else {
|
|
103
167
|
const runsTotal = existing.runsTotal + 1;
|
|
@@ -106,9 +170,11 @@ export function recordCapabilityOutcome(outcome) {
|
|
|
106
170
|
const avgTime = (existing.avgTimeMs * existing.runsTotal + time) / runsTotal;
|
|
107
171
|
const recent = [...existing.last10Runs, passed].slice(-RECENT_RUNS_LIMIT);
|
|
108
172
|
db.prepare(`UPDATE capability_map
|
|
109
|
-
SET model = ?, runs_total = ?, runs_passed = ?,
|
|
110
|
-
|
|
111
|
-
|
|
173
|
+
SET model = ?, runs_total = ?, runs_passed = ?,
|
|
174
|
+
first_pass_count = COALESCE(first_pass_count, 0) + ?,
|
|
175
|
+
success_rate = ?, avg_cost_usd = ?, avg_time_ms = ?,
|
|
176
|
+
last_10_runs = ?, updated_at = ?
|
|
177
|
+
WHERE task_type = ?`).run(model, runsTotal, runsPassed, firstPassIncrement, runsPassed / runsTotal, avgCost, avgTime, JSON.stringify(recent), timestamp, key);
|
|
112
178
|
}
|
|
113
179
|
const record = getCapability(key);
|
|
114
180
|
if (!record) {
|
|
@@ -120,9 +186,13 @@ export function recordCapabilityOutcome(outcome) {
|
|
|
120
186
|
/**
|
|
121
187
|
* Решение слоя 2 по порогам (0 токенов).
|
|
122
188
|
*
|
|
189
|
+
* Пороги применяются к `effectiveSuccessRate` — 0.7 затухающего success rate
|
|
190
|
+
* последних прогонов плюс 0.3 first-pass rate (B13), а не к кумулятивному
|
|
191
|
+
* success rate. Поэтому старые успехи не перевешивают свежие провалы.
|
|
192
|
+
*
|
|
123
193
|
* - данных меньше `minRuns` → `explore` (решает слой 3);
|
|
124
|
-
* - `
|
|
125
|
-
* - `
|
|
194
|
+
* - `effectiveSuccessRate ≥ 0.85` → `local`;
|
|
195
|
+
* - `effectiveSuccessRate ≤ 0.30` → `cloud` (эскалация);
|
|
126
196
|
* - между порогами → `review` (нужен человек или облачный ревьюер).
|
|
127
197
|
*/
|
|
128
198
|
export function decideCapabilityRoute(taskType, thresholds = {}) {
|
|
@@ -134,32 +204,44 @@ export function decideCapabilityRoute(taskType, thresholds = {}) {
|
|
|
134
204
|
throw new Error("Порог localSuccess должен быть больше cloudFailure.");
|
|
135
205
|
}
|
|
136
206
|
const capability = getCapability(key);
|
|
207
|
+
const effectiveSuccessRate = capability?.effectiveSuccessRate ?? 0;
|
|
208
|
+
const decayedSuccessRate = capability?.decayedSuccessRate ?? 0;
|
|
209
|
+
const firstPassRate = capability?.firstPassRate ?? 0;
|
|
137
210
|
if (!capability || capability.runsTotal < minRuns) {
|
|
138
211
|
return {
|
|
139
212
|
taskType: key,
|
|
140
213
|
target: "explore",
|
|
141
214
|
reason: "no-data",
|
|
142
215
|
successRate: capability?.successRate ?? 0,
|
|
216
|
+
effectiveSuccessRate,
|
|
217
|
+
decayedSuccessRate,
|
|
218
|
+
firstPassRate,
|
|
143
219
|
runsTotal: capability?.runsTotal ?? 0,
|
|
144
220
|
capability,
|
|
145
221
|
};
|
|
146
222
|
}
|
|
147
|
-
if (
|
|
223
|
+
if (effectiveSuccessRate >= localSuccess) {
|
|
148
224
|
return {
|
|
149
225
|
taskType: key,
|
|
150
226
|
target: "local",
|
|
151
227
|
reason: "local-reliable",
|
|
152
228
|
successRate: capability.successRate,
|
|
229
|
+
effectiveSuccessRate,
|
|
230
|
+
decayedSuccessRate,
|
|
231
|
+
firstPassRate,
|
|
153
232
|
runsTotal: capability.runsTotal,
|
|
154
233
|
capability,
|
|
155
234
|
};
|
|
156
235
|
}
|
|
157
|
-
if (
|
|
236
|
+
if (effectiveSuccessRate <= cloudFailure) {
|
|
158
237
|
return {
|
|
159
238
|
taskType: key,
|
|
160
239
|
target: "cloud",
|
|
161
240
|
reason: "escalate",
|
|
162
241
|
successRate: capability.successRate,
|
|
242
|
+
effectiveSuccessRate,
|
|
243
|
+
decayedSuccessRate,
|
|
244
|
+
firstPassRate,
|
|
163
245
|
runsTotal: capability.runsTotal,
|
|
164
246
|
capability,
|
|
165
247
|
};
|
|
@@ -169,6 +251,9 @@ export function decideCapabilityRoute(taskType, thresholds = {}) {
|
|
|
169
251
|
target: "review",
|
|
170
252
|
reason: "review",
|
|
171
253
|
successRate: capability.successRate,
|
|
254
|
+
effectiveSuccessRate,
|
|
255
|
+
decayedSuccessRate,
|
|
256
|
+
firstPassRate,
|
|
172
257
|
runsTotal: capability.runsTotal,
|
|
173
258
|
capability,
|
|
174
259
|
};
|
|
@@ -7,6 +7,13 @@ import type { TaskStatus } from "../history.js";
|
|
|
7
7
|
* в crash recovery.
|
|
8
8
|
*/
|
|
9
9
|
export type HistoryStatus = TaskStatus | "running";
|
|
10
|
+
/**
|
|
11
|
+
* QA-P1.5: прочерк и пустая строка — не текст ошибки, а маркер «нет данных».
|
|
12
|
+
* PowerShell-обёртка исторически передавала "-" для успешных запусков, и он
|
|
13
|
+
* попадал в history и структурированные логи как сообщение об ошибке.
|
|
14
|
+
* Нормализуем и при записи, и при чтении (легаси-записи уже есть в БД).
|
|
15
|
+
*/
|
|
16
|
+
export declare function normalizeErrorText(error: string | null | undefined): string | null;
|
|
10
17
|
export interface StoredHistoryRecord {
|
|
11
18
|
id?: number;
|
|
12
19
|
taskName: string;
|
|
@@ -24,6 +31,10 @@ export interface StoredHistoryRecord {
|
|
|
24
31
|
workspaceId?: string | null;
|
|
25
32
|
allowedTools?: string[] | null;
|
|
26
33
|
deniedTools?: string[] | null;
|
|
34
|
+
/** Владелец незавершённого запуска (схема v8). */
|
|
35
|
+
ownerPid?: number | null;
|
|
36
|
+
ownerHost?: string | null;
|
|
37
|
+
ownerStartedAt?: string | null;
|
|
27
38
|
}
|
|
28
39
|
/** Поля, которые пишутся в history при завершении запуска. */
|
|
29
40
|
export interface RunResult {
|
|
@@ -43,7 +54,11 @@ export interface RunResult {
|
|
|
43
54
|
/** Вставляет запись истории без инкремента метрик (совместимость с appendHistory). */
|
|
44
55
|
export declare function insertHistory(record: StoredHistoryRecord): number;
|
|
45
56
|
/** Начало запуска: строка с finished_at = NULL (переживёт сбой процесса). */
|
|
46
|
-
export declare function startRun(taskName: string, startedAt?: string, workspaceId?: string | null, allowedTools?: string[] | null, deniedTools?: string[] | null
|
|
57
|
+
export declare function startRun(taskName: string, startedAt?: string, workspaceId?: string | null, allowedTools?: string[] | null, deniedTools?: string[] | null, owner?: {
|
|
58
|
+
pid?: number | null;
|
|
59
|
+
host?: string | null;
|
|
60
|
+
startedAt?: string | null;
|
|
61
|
+
}): number;
|
|
47
62
|
/**
|
|
48
63
|
* Завершает ранее начатый запуск и инкрементирует метрики.
|
|
49
64
|
* Возвращает false, если запись уже завершена/не найдена (защита от двойного учёта).
|
|
@@ -56,6 +71,15 @@ export declare function finishRun(id: number, status: TaskStatus, durationMs: nu
|
|
|
56
71
|
export declare function recordRun(taskName: string, status: TaskStatus, startedAt: string, durationMs: number, error?: string | null, nextTask?: string | null, tokens?: number, costUsd?: number, model?: string, preFlightStatus?: "success" | "error" | "skipped", postFlightStatus?: "success" | "error" | "skipped", finishedAt?: string, workspaceId?: string | null, allowedTools?: string[] | null, deniedTools?: string[] | null): number;
|
|
57
72
|
/** История запусков (новые сверху). Без taskName — по всем задачам. */
|
|
58
73
|
export declare function getHistory(taskName?: string | null, limit?: number, status?: string | null): StoredHistoryRecord[];
|
|
74
|
+
/**
|
|
75
|
+
* История для проверки бюджетов: записи, учётный момент которых
|
|
76
|
+
* (`finished_at`, при отсутствии `started_at`) не раньше `periodStart`.
|
|
77
|
+
*
|
|
78
|
+
* В отличие от `getHistorySince()` учитывает запуски, начатые в предыдущем
|
|
79
|
+
* периоде, но завершённые в текущем — именно по ним считается расход в
|
|
80
|
+
* `src/core/budget.ts`. Лимит 100000 совпадает с максимумом `getHistory`.
|
|
81
|
+
*/
|
|
82
|
+
export declare function getHistoryForBudget(periodStart: string, limit?: number): StoredHistoryRecord[];
|
|
59
83
|
/**
|
|
60
84
|
* Последняя запись по каждой задаче (P2-29).
|
|
61
85
|
*
|
|
@@ -64,14 +88,55 @@ export declare function getHistory(taskName?: string | null, limit?: number, sta
|
|
|
64
88
|
* Здесь SQL сам выбирает по одной самой свежей записи на задачу.
|
|
65
89
|
*/
|
|
66
90
|
export declare function getLatestHistoryByTask(limit?: number): StoredHistoryRecord[];
|
|
91
|
+
/**
|
|
92
|
+
* История для аналитики за окно `days` дней: все запуски, которые могут
|
|
93
|
+
* попасть в период по времени начала. Окно на один день шире запрашиваемого,
|
|
94
|
+
* чтобы полностью покрыть самый ранний UTC-день (buildAnalytics всё равно
|
|
95
|
+
* отфильтрует лишнее по дате). Лимит 100000 снимает потолок в 20000 записей,
|
|
96
|
+
* из-за которого отчёты за 365 дней молча недосчитывали запуски и расход.
|
|
97
|
+
*/
|
|
98
|
+
export declare function getHistoryForAnalytics(days: number, now?: Date, includeInternal?: boolean): StoredHistoryRecord[];
|
|
67
99
|
/** История запусков, начатых не раньше timestamp (ISO-строка). */
|
|
68
100
|
export declare function getHistorySince(timestamp: string, limit?: number): StoredHistoryRecord[];
|
|
69
101
|
/**
|
|
70
|
-
* Crash recovery
|
|
71
|
-
*
|
|
72
|
-
*
|
|
102
|
+
* Crash recovery для истории.
|
|
103
|
+
*
|
|
104
|
+
* Незавершённая запись (finished_at IS NULL) финализируется как error, только
|
|
105
|
+
* если её владелец больше не может её завершить:
|
|
106
|
+
* - владелец известен, жив и на этом же хосте → запись оставляем (B1);
|
|
107
|
+
* - владелец известен и мёртв → финализируем сразу;
|
|
108
|
+
* - владелец неизвестен (legacy-строка или другой хост) → финализируем,
|
|
109
|
+
* только когда запись старше `maxUnverifiableAgeMs`.
|
|
73
110
|
*/
|
|
74
|
-
|
|
111
|
+
/** Возраст, после которого запись с непроверяемым владельцем считается осиротевшей. */
|
|
112
|
+
export declare const UNVERIFIABLE_OWNER_MAX_AGE_MS: number;
|
|
113
|
+
export interface RecoverInterruptedResult {
|
|
114
|
+
/** Сколько записей финализировано как error. */
|
|
115
|
+
recovered: number;
|
|
116
|
+
/** Сколько записей оставлено живым владельцам. */
|
|
117
|
+
keptAlive: number;
|
|
118
|
+
}
|
|
119
|
+
export interface RecoverInterruptedOptions {
|
|
120
|
+
/** Текущий момент (для тестов). */
|
|
121
|
+
now?: Date;
|
|
122
|
+
/** Порог возраста для записей с непроверяемым владельцем. */
|
|
123
|
+
maxUnverifiableAgeMs?: number;
|
|
124
|
+
/**
|
|
125
|
+
* PL-46: порог, после которого запись живого владельца считается
|
|
126
|
+
* «зависшей» (например, процесс убит через schtasks /End) и финализируется
|
|
127
|
+
* как timeout. 0 отключает проверку. По умолчанию 0 — прямой вызов
|
|
128
|
+
* recoverInterrupted() сохраняет crash-recovery-поведение; порог задаёт
|
|
129
|
+
* recoverInterruptedRuns() (см. db/recovery.ts).
|
|
130
|
+
*/
|
|
131
|
+
staleAfterMs?: number;
|
|
132
|
+
/** Имя текущего хоста (для тестов). */
|
|
133
|
+
hostname?: string;
|
|
134
|
+
/** Проверка живости PID (для тестов). */
|
|
135
|
+
isAlive?: (pid: number) => boolean;
|
|
136
|
+
}
|
|
137
|
+
/** Проверяет существование процесса: signal 0 не убивает, только пробует. */
|
|
138
|
+
export declare function isProcessAlive(pid: number): boolean;
|
|
139
|
+
export declare function recoverInterrupted(options?: RecoverInterruptedOptions): RecoverInterruptedResult;
|
|
75
140
|
/** Количество записей истории (для миграции и тестов). */
|
|
76
141
|
export declare function countHistory(): number;
|
|
77
142
|
/** Число активных (незавершённых) запусков: глубина очереди для /api/health. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"history-repo.d.ts","sourceRoot":"","sources":["../../src/db/history-repo.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"history-repo.d.ts","sourceRoot":"","sources":["../../src/db/history-repo.ts"],"names":[],"mappings":"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"}
|