agent-steward 0.0.0-stage → 0.0.2
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 +376 -0
- package/CROSS_PLATFORM.md +149 -0
- package/LICENSE +21 -0
- package/README.md +314 -2
- package/ROADMAP-STRATEGY.md +147 -0
- package/ROADMAP.md +1069 -0
- package/dist/core/analytics.d.ts +132 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +290 -0
- package/dist/core/audit.d.ts +96 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +297 -0
- package/dist/core/cron-to-schtasks.d.ts +20 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +250 -0
- package/dist/core/dry-run.d.ts +102 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +447 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +186 -0
- package/dist/core/git-trigger.d.ts +82 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +312 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- package/dist/core/local-ai.d.ts +52 -0
- package/dist/core/local-ai.d.ts.map +1 -0
- package/dist/core/local-ai.js +119 -0
- package/dist/core/lock.d.ts +57 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +195 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +724 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +113 -0
- package/dist/core/one-shot.d.ts +68 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +139 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- package/dist/core/permissions.d.ts +69 -0
- package/dist/core/permissions.d.ts.map +1 -0
- package/dist/core/permissions.js +143 -0
- package/dist/core/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +73 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +1071 -0
- package/dist/core/record-history.d.ts +25 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +471 -0
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/savings.d.ts +70 -0
- package/dist/core/savings.d.ts.map +1 -0
- package/dist/core/savings.js +87 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +211 -0
- package/dist/core/schedule-v2.d.ts +116 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +586 -0
- package/dist/core/scheduler/index.d.ts +32 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +63 -0
- package/dist/core/scheduler/linux.d.ts +44 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +225 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +40 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +207 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +89 -0
- package/dist/core/scheduler/registry.d.ts +41 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +57 -0
- package/dist/core/scheduler/types.d.ts +86 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +99 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +596 -0
- package/dist/core/secrets.d.ts +66 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +433 -0
- package/dist/core/self-analysis.d.ts +117 -0
- package/dist/core/self-analysis.d.ts.map +1 -0
- package/dist/core/self-analysis.js +539 -0
- package/dist/core/self-analysis.test.d.ts +2 -0
- package/dist/core/self-analysis.test.d.ts.map +1 -0
- package/dist/core/self-analysis.test.js +219 -0
- package/dist/core/session.d.ts +42 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +134 -0
- package/dist/core/shutdown.d.ts +26 -0
- package/dist/core/shutdown.d.ts.map +1 -0
- package/dist/core/shutdown.js +49 -0
- package/dist/core/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +146 -0
- package/dist/core/summary.d.ts +69 -0
- package/dist/core/summary.d.ts.map +1 -0
- package/dist/core/summary.js +250 -0
- package/dist/core/telegram.d.ts +55 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +344 -0
- package/dist/core/triage-chain.d.ts +40 -0
- package/dist/core/triage-chain.d.ts.map +1 -0
- package/dist/core/triage-chain.js +80 -0
- package/dist/core/triage-compare.d.ts +68 -0
- package/dist/core/triage-compare.d.ts.map +1 -0
- package/dist/core/triage-compare.js +184 -0
- package/dist/core/triage-rules.d.ts +23 -0
- package/dist/core/triage-rules.d.ts.map +1 -0
- package/dist/core/triage-rules.js +196 -0
- package/dist/core/triage-shadow.d.ts +91 -0
- package/dist/core/triage-shadow.d.ts.map +1 -0
- package/dist/core/triage-shadow.js +160 -0
- package/dist/core/triage-worker.d.ts +55 -0
- package/dist/core/triage-worker.d.ts.map +1 -0
- package/dist/core/triage-worker.js +314 -0
- package/dist/core/triage.d.ts +76 -0
- package/dist/core/triage.d.ts.map +1 -0
- package/dist/core/triage.js +271 -0
- package/dist/core/watch-paths.d.ts +6 -0
- package/dist/core/watch-paths.d.ts.map +1 -0
- package/dist/core/watch-paths.js +62 -0
- package/dist/core/wrappers/bash.d.ts +95 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +413 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/history-repo.d.ts +110 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +300 -0
- package/dist/db/index.d.ts +47 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +120 -0
- package/dist/db/metrics-repo.d.ts +46 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +103 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +244 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -0
- package/dist/db/schema.d.ts +24 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +170 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/gui-experimental.cjs +1 -0
- package/dist/history.d.ts +60 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +70 -0
- package/dist/i18n.d.ts +75 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +357 -0
- package/dist/index.d.ts +858 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5179 -0
- package/dist/integrations.d.ts +72 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +233 -0
- package/dist/notifications.d.ts +199 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +967 -0
- package/dist/profiles.d.ts +60 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +227 -0
- package/dist/rpc.d.ts +3806 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1507 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +128 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +2413 -0
- package/dist/settings.d.ts +389 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +770 -0
- package/dist/shared/jobs-view.d.ts +59 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +146 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +252 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +628 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +96 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +130 -0
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +113 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +393 -0
- package/docs/ARCHITECTURE.md +457 -0
- package/docs/COMPATIBILITY.md +233 -0
- package/docs/CONCEPT.md +230 -0
- package/docs/CROSS_PLATFORM.ru.md +150 -0
- package/docs/CROSS_PLATFORM.zh.md +146 -0
- package/docs/FAQ.md +52 -0
- package/docs/FAQ.ru.md +53 -0
- package/docs/FAQ.zh.md +43 -0
- package/docs/FEATURES.md +698 -0
- package/docs/FEATURES.zh.md +655 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +355 -0
- package/docs/README.ru.md +268 -0
- package/docs/README.zh.md +305 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/dashboard.png +0 -0
- package/docs/spikes/local-model-structured-output.md +81 -0
- package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
- package/docs/spikes/ollama-qwen3-4b.json +163 -0
- package/gui-experimental.cjs +9 -0
- package/index.js +1 -0
- package/locales/en.json +780 -0
- package/locales/ru.json +780 -0
- package/locales/zh.json +780 -0
- package/package.json +149 -4
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/demo-dashboard.mjs +209 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +45 -0
- package/skills/scheduled-job-best-practices/SKILL.md +158 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
- package/src/core/analytics.ts +424 -0
- package/src/core/audit.ts +418 -0
- package/src/core/cron-to-schtasks.ts +288 -0
- package/src/core/dry-run.ts +601 -0
- package/src/core/file-watcher.ts +245 -0
- package/src/core/git-trigger.ts +391 -0
- package/src/core/glob.ts +226 -0
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +219 -0
- package/src/core/matrix.ts +947 -0
- package/src/core/native-notify.ts +157 -0
- package/src/core/one-shot.ts +189 -0
- package/src/core/otel.ts +128 -0
- package/src/core/permissions.ts +200 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +1140 -0
- package/src/core/record-history.ts +615 -0
- package/src/core/retention.ts +141 -0
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +253 -0
- package/src/core/schedule-v2.ts +668 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +257 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +270 -0
- package/src/core/scheduler/posix.ts +114 -0
- package/src/core/scheduler/registry.ts +99 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +711 -0
- package/src/core/secrets.ts +503 -0
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +150 -0
- package/src/core/shutdown.ts +69 -0
- package/src/core/structured-log.ts +214 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +436 -0
- package/src/core/triage-chain.ts +125 -0
- package/src/core/triage-compare.ts +277 -0
- package/src/core/triage-rules.ts +238 -0
- package/src/core/triage-shadow.ts +240 -0
- package/src/core/triage-worker.ts +344 -0
- package/src/core/triage.ts +366 -0
- package/src/core/watch-paths.ts +70 -0
- package/src/core/wrappers/bash.ts +532 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/history-repo.ts +492 -0
- package/src/db/index.ts +166 -0
- package/src/db/metrics-repo.ts +170 -0
- package/src/db/migrate.ts +328 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/schema.ts +188 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +5222 -0
- package/src/history.ts +128 -0
- package/src/i18n.ts +413 -0
- package/src/index.ts +6605 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +254 -0
- package/src/rpc.ts +1609 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2662 -0
- package/src/settings.ts +1369 -0
- package/src/shared/jobs-view.ts +188 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +944 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +191 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Тесты системы самоанализа (Спринт 32).
|
|
3
|
+
*/
|
|
4
|
+
import { describe, it, expect } from "vitest";
|
|
5
|
+
import { calculateHealthScore, detectAnomalies, analyzeTrends, generateSelfAnalysisReport } from "./self-analysis.js";
|
|
6
|
+
import { buildAnalytics } from "./analytics.js";
|
|
7
|
+
// ==================== Вспомогательные функции ====================
|
|
8
|
+
function createRecord(overrides = {}) {
|
|
9
|
+
return {
|
|
10
|
+
taskName: "test-task",
|
|
11
|
+
status: "success",
|
|
12
|
+
startedAt: "2026-11-16T10:00:00.000Z",
|
|
13
|
+
finishedAt: "2026-11-16T10:01:00.000Z",
|
|
14
|
+
durationMs: 60000,
|
|
15
|
+
tokens: 1000,
|
|
16
|
+
costUsd: 0.003,
|
|
17
|
+
model: "test-model",
|
|
18
|
+
...overrides
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
function createRecords(count, overrides = {}) {
|
|
22
|
+
return Array.from({ length: count }, (_, i) => createRecord({
|
|
23
|
+
startedAt: new Date(Date.now() - i * 24 * 60 * 60 * 1000).toISOString(),
|
|
24
|
+
...overrides
|
|
25
|
+
}));
|
|
26
|
+
}
|
|
27
|
+
// ==================== Health Score ====================
|
|
28
|
+
describe("calculateHealthScore", () => {
|
|
29
|
+
it("should return excellent health for perfect records", () => {
|
|
30
|
+
const records = createRecords(10, { status: "success" });
|
|
31
|
+
const report = buildAnalytics(records, { days: 14 });
|
|
32
|
+
const health = calculateHealthScore(report);
|
|
33
|
+
expect(health.score).toBeGreaterThanOrEqual(90);
|
|
34
|
+
expect(health.level).toBe("excellent");
|
|
35
|
+
});
|
|
36
|
+
it("should return poor health for mostly failed records", () => {
|
|
37
|
+
const records = createRecords(10, { status: "error" });
|
|
38
|
+
const report = buildAnalytics(records, { days: 14 });
|
|
39
|
+
const health = calculateHealthScore(report);
|
|
40
|
+
expect(health.score).toBeLessThan(60);
|
|
41
|
+
expect(["poor", "critical"]).toContain(health.level);
|
|
42
|
+
});
|
|
43
|
+
it("should include recommendations for poor health", () => {
|
|
44
|
+
const records = createRecords(10, { status: "error" });
|
|
45
|
+
const report = buildAnalytics(records, { days: 14 });
|
|
46
|
+
const health = calculateHealthScore(report);
|
|
47
|
+
expect(health.recommendations.length).toBeGreaterThan(0);
|
|
48
|
+
});
|
|
49
|
+
it("should calculate components correctly", () => {
|
|
50
|
+
const records = createRecords(10, { status: "success" });
|
|
51
|
+
const report = buildAnalytics(records, { days: 14 });
|
|
52
|
+
const health = calculateHealthScore(report);
|
|
53
|
+
expect(health.components.successRate).toBeGreaterThanOrEqual(90);
|
|
54
|
+
expect(health.components.errorRate).toBeGreaterThanOrEqual(90);
|
|
55
|
+
});
|
|
56
|
+
});
|
|
57
|
+
// ==================== Anomaly Detection ====================
|
|
58
|
+
describe("detectAnomalies", () => {
|
|
59
|
+
it("should detect error spike", () => {
|
|
60
|
+
const records = [
|
|
61
|
+
...createRecords(5, { status: "error" }),
|
|
62
|
+
...createRecords(5, { status: "success" })
|
|
63
|
+
];
|
|
64
|
+
const anomalies = detectAnomalies(records, { days: 14 });
|
|
65
|
+
const errorSpike = anomalies.find(a => a.type === "error_spike");
|
|
66
|
+
expect(errorSpike).toBeDefined();
|
|
67
|
+
expect(errorSpike.severity).toBeGreaterThan(0);
|
|
68
|
+
});
|
|
69
|
+
it("should detect duration spike", () => {
|
|
70
|
+
const records = [
|
|
71
|
+
createRecord({ durationMs: 300000, status: "success" }), // 5 минут
|
|
72
|
+
...createRecords(5, { durationMs: 60000, status: "success" }) // 1 минута
|
|
73
|
+
];
|
|
74
|
+
const anomalies = detectAnomalies(records, { days: 14 });
|
|
75
|
+
const durationSpike = anomalies.find(a => a.type === "duration_spike");
|
|
76
|
+
expect(durationSpike).toBeDefined();
|
|
77
|
+
});
|
|
78
|
+
it("should detect timeout spike", () => {
|
|
79
|
+
const records = [
|
|
80
|
+
createRecord({ status: "error", error: "timeout exceeded" }),
|
|
81
|
+
createRecord({ status: "error", error: "timeout exceeded" }),
|
|
82
|
+
createRecord({ status: "error", error: "timeout exceeded" }),
|
|
83
|
+
...createRecords(7, { status: "success" })
|
|
84
|
+
];
|
|
85
|
+
const anomalies = detectAnomalies(records, { days: 14 });
|
|
86
|
+
const timeoutSpike = anomalies.find(a => a.type === "timeout_spike");
|
|
87
|
+
expect(timeoutSpike).toBeDefined();
|
|
88
|
+
});
|
|
89
|
+
it("should detect cost spike", () => {
|
|
90
|
+
const records = [
|
|
91
|
+
createRecord({ costUsd: 0.1, status: "success" }),
|
|
92
|
+
...createRecords(5, { costUsd: 0.003, status: "success" })
|
|
93
|
+
];
|
|
94
|
+
const anomalies = detectAnomalies(records, { days: 14 });
|
|
95
|
+
const costSpike = anomalies.find(a => a.type === "cost_spike");
|
|
96
|
+
expect(costSpike).toBeDefined();
|
|
97
|
+
});
|
|
98
|
+
it("should detect stalled run", () => {
|
|
99
|
+
const records = [
|
|
100
|
+
createRecord({ status: "running", startedAt: "2026-11-16T10:00:00.000Z" }),
|
|
101
|
+
...createRecords(5, { status: "success" })
|
|
102
|
+
];
|
|
103
|
+
const anomalies = detectAnomalies(records, { days: 14, now: new Date("2026-11-16T13:00:00.000Z") });
|
|
104
|
+
const stalledRun = anomalies.find(a => a.type === "stalled_run");
|
|
105
|
+
expect(stalledRun).toBeDefined();
|
|
106
|
+
expect(stalledRun.severity).toBeGreaterThan(0);
|
|
107
|
+
});
|
|
108
|
+
it("should return empty array for clean records", () => {
|
|
109
|
+
const records = createRecords(10, { status: "success", durationMs: 60000, costUsd: 0.003 });
|
|
110
|
+
const anomalies = detectAnomalies(records, { days: 14 });
|
|
111
|
+
expect(anomalies.length).toBe(0);
|
|
112
|
+
});
|
|
113
|
+
});
|
|
114
|
+
// ==================== Trend Analysis ====================
|
|
115
|
+
describe("analyzeTrends", () => {
|
|
116
|
+
it("should detect improving success rate", () => {
|
|
117
|
+
const records = [
|
|
118
|
+
...createRecords(5, { status: "success" }),
|
|
119
|
+
...createRecords(5, { status: "error" })
|
|
120
|
+
];
|
|
121
|
+
const trends = analyzeTrends(records, { days: 14 });
|
|
122
|
+
const successTrend = trends.find(t => t.metric === "success_rate");
|
|
123
|
+
expect(successTrend).toBeDefined();
|
|
124
|
+
expect(successTrend.direction).toBe("improving");
|
|
125
|
+
expect(successTrend.changePercent).toBeGreaterThan(0);
|
|
126
|
+
});
|
|
127
|
+
it("should detect degrading success rate", () => {
|
|
128
|
+
const records = [
|
|
129
|
+
...createRecords(5, { status: "error" }),
|
|
130
|
+
...createRecords(5, { status: "success" })
|
|
131
|
+
];
|
|
132
|
+
const trends = analyzeTrends(records, { days: 14 });
|
|
133
|
+
const successTrend = trends.find(t => t.metric === "success_rate");
|
|
134
|
+
expect(successTrend).toBeDefined();
|
|
135
|
+
expect(successTrend.direction).toBe("degrading");
|
|
136
|
+
expect(successTrend.changePercent).toBeLessThan(0);
|
|
137
|
+
});
|
|
138
|
+
it("should detect stable success rate", () => {
|
|
139
|
+
const records = [
|
|
140
|
+
...createRecords(5, { status: "success" }),
|
|
141
|
+
...createRecords(5, { status: "success" })
|
|
142
|
+
];
|
|
143
|
+
const trends = analyzeTrends(records, { days: 14 });
|
|
144
|
+
const successTrend = trends.find(t => t.metric === "success_rate");
|
|
145
|
+
expect(successTrend).toBeDefined();
|
|
146
|
+
expect(successTrend.direction).toBe("stable");
|
|
147
|
+
});
|
|
148
|
+
it("should return empty array for insufficient data", () => {
|
|
149
|
+
const records = createRecords(3, { status: "success" });
|
|
150
|
+
const trends = analyzeTrends(records, { days: 14 });
|
|
151
|
+
expect(trends.length).toBe(0);
|
|
152
|
+
});
|
|
153
|
+
});
|
|
154
|
+
// ==================== Recommendations ====================
|
|
155
|
+
describe("generateRecommendations", () => {
|
|
156
|
+
it("should generate recommendations for poor success rate", () => {
|
|
157
|
+
const records = createRecords(10, { status: "error" });
|
|
158
|
+
const report = generateSelfAnalysisReport(records, { days: 14 });
|
|
159
|
+
expect(report.recommendations.length).toBeGreaterThan(0);
|
|
160
|
+
const successRec = report.recommendations.find(r => r.title.includes("успешность"));
|
|
161
|
+
expect(successRec).toBeDefined();
|
|
162
|
+
expect(successRec.priority).toBeGreaterThanOrEqual(7);
|
|
163
|
+
});
|
|
164
|
+
it("should generate recommendations for high cost", () => {
|
|
165
|
+
const records = createRecords(10, { status: "success", costUsd: 20 });
|
|
166
|
+
const report = generateSelfAnalysisReport(records, { days: 14 });
|
|
167
|
+
const costRec = report.recommendations.find(r => r.category === "cost");
|
|
168
|
+
expect(costRec).toBeDefined();
|
|
169
|
+
expect(costRec.priority).toBeGreaterThanOrEqual(6);
|
|
170
|
+
});
|
|
171
|
+
it("should generate recommendations for long duration", () => {
|
|
172
|
+
const records = createRecords(10, { status: "success", durationMs: 400000 });
|
|
173
|
+
const report = generateSelfAnalysisReport(records, { days: 14 });
|
|
174
|
+
const durationRec = report.recommendations.find(r => r.title.includes("длительность"));
|
|
175
|
+
expect(durationRec).toBeDefined();
|
|
176
|
+
});
|
|
177
|
+
it("should sort recommendations by priority", () => {
|
|
178
|
+
const records = createRecords(10, { status: "error", costUsd: 20, durationMs: 400000 });
|
|
179
|
+
const report = generateSelfAnalysisReport(records, { days: 14 });
|
|
180
|
+
for (let i = 1; i < report.recommendations.length; i++) {
|
|
181
|
+
expect(report.recommendations[i - 1].priority).toBeGreaterThanOrEqual(report.recommendations[i].priority);
|
|
182
|
+
}
|
|
183
|
+
});
|
|
184
|
+
});
|
|
185
|
+
// ==================== Self Analysis Report ====================
|
|
186
|
+
describe("generateSelfAnalysisReport", () => {
|
|
187
|
+
it("should generate complete report", () => {
|
|
188
|
+
const records = createRecords(20, { status: "success" });
|
|
189
|
+
const report = generateSelfAnalysisReport(records, { days: 14 });
|
|
190
|
+
expect(report.generatedAt).toBeDefined();
|
|
191
|
+
expect(report.windowDays).toBe(14);
|
|
192
|
+
expect(report.health).toBeDefined();
|
|
193
|
+
expect(report.anomalies).toBeDefined();
|
|
194
|
+
expect(report.trends).toBeDefined();
|
|
195
|
+
expect(report.recommendations).toBeDefined();
|
|
196
|
+
expect(report.summary).toBeDefined();
|
|
197
|
+
expect(report.sources).toBeDefined();
|
|
198
|
+
});
|
|
199
|
+
it("should include correct sources", () => {
|
|
200
|
+
const records = createRecords(20, { status: "success" });
|
|
201
|
+
const report = generateSelfAnalysisReport(records, { days: 14 });
|
|
202
|
+
expect(report.sources.historyRecords).toBe(20);
|
|
203
|
+
expect(report.sources.recordsInWindow).toBeGreaterThan(0);
|
|
204
|
+
expect(report.sources.tasksAnalyzed).toBeGreaterThan(0);
|
|
205
|
+
});
|
|
206
|
+
it("should generate summary", () => {
|
|
207
|
+
const records = createRecords(20, { status: "success" });
|
|
208
|
+
const report = generateSelfAnalysisReport(records, { days: 14 });
|
|
209
|
+
expect(report.summary.length).toBeGreaterThan(0);
|
|
210
|
+
expect(report.summary).toContain("Здоровье системы");
|
|
211
|
+
});
|
|
212
|
+
it("should handle empty records", () => {
|
|
213
|
+
const report = generateSelfAnalysisReport([], { days: 14 });
|
|
214
|
+
expect(report.health.score).toBeGreaterThanOrEqual(0);
|
|
215
|
+
expect(report.anomalies.length).toBe(0);
|
|
216
|
+
expect(report.trends.length).toBe(0);
|
|
217
|
+
expect(report.recommendations.length).toBe(0);
|
|
218
|
+
});
|
|
219
|
+
});
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
export declare const SESSION_MODES: readonly ["new", "reuse", "last"];
|
|
2
|
+
export type SessionMode = (typeof SESSION_MODES)[number];
|
|
3
|
+
/** Генерация id сессии в формате `ses_<26+ base36>`. */
|
|
4
|
+
export declare function generateSessionId(): string;
|
|
5
|
+
/** Проверка формата id сессии. */
|
|
6
|
+
export declare function isValidSessionId(value: unknown): value is string;
|
|
7
|
+
/**
|
|
8
|
+
* Нормализация режима сессии. undefined → "new".
|
|
9
|
+
* Возвращает undefined для мусора, чтобы вызывающий мог решить, падать или нет.
|
|
10
|
+
*/
|
|
11
|
+
export declare function normalizeSessionMode(value: unknown): SessionMode | undefined;
|
|
12
|
+
/** Аргументы для `opencode run` в зависимости от режима. */
|
|
13
|
+
export declare function buildSessionArgs(mode: SessionMode, sessionId?: string): string[];
|
|
14
|
+
/** Признак того, что сессию пора ротировать после N запусков. */
|
|
15
|
+
export declare function shouldRotateSession(runCount: number, maxRuns: number): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* Счётчик запусков сессии при сохранении определения задачи.
|
|
18
|
+
*
|
|
19
|
+
* Редактирование не должно обнулять прогресс к sessionMaxRuns, если сессия
|
|
20
|
+
* осталась прежней. При смене режима или id сессии счётчик начинается заново.
|
|
21
|
+
*/
|
|
22
|
+
export declare function preservedSessionRunCount(previous: {
|
|
23
|
+
session?: SessionMode;
|
|
24
|
+
sessionId?: string;
|
|
25
|
+
sessionRunCount?: number;
|
|
26
|
+
} | undefined, session: SessionMode, sessionId: string | undefined): number;
|
|
27
|
+
/** Путь к sidecar-файлу с актуальным id сессии задачи. */
|
|
28
|
+
export declare function sessionStatePath(taskName: string): string;
|
|
29
|
+
/**
|
|
30
|
+
* Записывает актуальный id сессии в sidecar-файл, который обёртка читает
|
|
31
|
+
* непосредственно перед запуском opencode. `undefined` удаляет файл.
|
|
32
|
+
* Никогда не бросает.
|
|
33
|
+
*/
|
|
34
|
+
export declare function writeSessionStateFile(taskName: string, sessionId: string | undefined): Promise<void>;
|
|
35
|
+
/**
|
|
36
|
+
* Best-effort ротация переиспользуемой сессии после завершения запуска.
|
|
37
|
+
* Удаляет сессию через opencode CLI, генерирует новый id, обновляет
|
|
38
|
+
* определение задачи и sidecar-файл обёртки. Никогда не бросает — сбой
|
|
39
|
+
* ротации не должен ломать историю запуска.
|
|
40
|
+
*/
|
|
41
|
+
export declare function rotateSessionIfNeeded(taskName: string): Promise<void>;
|
|
42
|
+
//# sourceMappingURL=session.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,mCAAoC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,wDAAwD;AACxD,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAI5E;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAShF;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EACJ;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,SAAS,EACb,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,CAIR;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC3E"}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
2
|
+
import fs from "node:fs/promises";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import { execFile } from "node:child_process";
|
|
5
|
+
import { getTask, saveTask } from "../db/tasks-repo.js";
|
|
6
|
+
import { appendStructuredLog } from "./structured-log.js";
|
|
7
|
+
import { WRAPPER_DIR, sanitizeName } from "../types.js";
|
|
8
|
+
export const SESSION_MODES = ["new", "reuse", "last"];
|
|
9
|
+
const SESSION_ID_PATTERN = /^ses_[A-Za-z0-9]{10,64}$/;
|
|
10
|
+
/** Генерация id сессии в формате `ses_<26+ base36>`. */
|
|
11
|
+
export function generateSessionId() {
|
|
12
|
+
const alphabet = "abcdefghijklmnopqrstuvwxyz0123456789";
|
|
13
|
+
const bytes = crypto.randomBytes(13);
|
|
14
|
+
let suffix = "";
|
|
15
|
+
for (const byte of bytes) {
|
|
16
|
+
suffix += alphabet[byte % 36];
|
|
17
|
+
}
|
|
18
|
+
// 13 байт → 20 символов base36; добавляем 6 случайных, чтобы было ≥26.
|
|
19
|
+
const extra = crypto.randomBytes(3).toString("hex");
|
|
20
|
+
return `ses_${suffix}${extra}`;
|
|
21
|
+
}
|
|
22
|
+
/** Проверка формата id сессии. */
|
|
23
|
+
export function isValidSessionId(value) {
|
|
24
|
+
return typeof value === "string" && SESSION_ID_PATTERN.test(value);
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Нормализация режима сессии. undefined → "new".
|
|
28
|
+
* Возвращает undefined для мусора, чтобы вызывающий мог решить, падать или нет.
|
|
29
|
+
*/
|
|
30
|
+
export function normalizeSessionMode(value) {
|
|
31
|
+
if (value === undefined || value === null)
|
|
32
|
+
return "new";
|
|
33
|
+
if (value === "new" || value === "reuse" || value === "last")
|
|
34
|
+
return value;
|
|
35
|
+
return undefined;
|
|
36
|
+
}
|
|
37
|
+
/** Аргументы для `opencode run` в зависимости от режима. */
|
|
38
|
+
export function buildSessionArgs(mode, sessionId) {
|
|
39
|
+
switch (mode) {
|
|
40
|
+
case "reuse":
|
|
41
|
+
return sessionId && isValidSessionId(sessionId) ? ["--session", sessionId] : [];
|
|
42
|
+
case "last":
|
|
43
|
+
return ["--continue"];
|
|
44
|
+
default:
|
|
45
|
+
return [];
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
/** Признак того, что сессию пора ротировать после N запусков. */
|
|
49
|
+
export function shouldRotateSession(runCount, maxRuns) {
|
|
50
|
+
return maxRuns > 0 && runCount >= maxRuns;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Счётчик запусков сессии при сохранении определения задачи.
|
|
54
|
+
*
|
|
55
|
+
* Редактирование не должно обнулять прогресс к sessionMaxRuns, если сессия
|
|
56
|
+
* осталась прежней. При смене режима или id сессии счётчик начинается заново.
|
|
57
|
+
*/
|
|
58
|
+
export function preservedSessionRunCount(previous, session, sessionId) {
|
|
59
|
+
if (!previous)
|
|
60
|
+
return 0;
|
|
61
|
+
if (previous.session !== session || previous.sessionId !== sessionId)
|
|
62
|
+
return 0;
|
|
63
|
+
return previous.sessionRunCount ?? 0;
|
|
64
|
+
}
|
|
65
|
+
/** Путь к sidecar-файлу с актуальным id сессии задачи. */
|
|
66
|
+
export function sessionStatePath(taskName) {
|
|
67
|
+
return path.join(WRAPPER_DIR, `${sanitizeName(taskName)}.session`);
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Записывает актуальный id сессии в sidecar-файл, который обёртка читает
|
|
71
|
+
* непосредственно перед запуском opencode. `undefined` удаляет файл.
|
|
72
|
+
* Никогда не бросает.
|
|
73
|
+
*/
|
|
74
|
+
export async function writeSessionStateFile(taskName, sessionId) {
|
|
75
|
+
try {
|
|
76
|
+
const file = sessionStatePath(taskName);
|
|
77
|
+
await fs.mkdir(WRAPPER_DIR, { recursive: true });
|
|
78
|
+
if (sessionId) {
|
|
79
|
+
await fs.writeFile(file, `${sessionId}\n`, "utf8");
|
|
80
|
+
}
|
|
81
|
+
else {
|
|
82
|
+
await fs.unlink(file).catch(() => undefined);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
catch (error) {
|
|
86
|
+
console.warn(`[session] Не удалось обновить файл сессии задачи "${taskName}":`, error);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Best-effort ротация переиспользуемой сессии после завершения запуска.
|
|
91
|
+
* Удаляет сессию через opencode CLI, генерирует новый id, обновляет
|
|
92
|
+
* определение задачи и sidecar-файл обёртки. Никогда не бросает — сбой
|
|
93
|
+
* ротации не должен ломать историю запуска.
|
|
94
|
+
*/
|
|
95
|
+
export async function rotateSessionIfNeeded(taskName) {
|
|
96
|
+
try {
|
|
97
|
+
const def = await getTask(taskName);
|
|
98
|
+
if (!def || def.session !== "reuse")
|
|
99
|
+
return;
|
|
100
|
+
const maxRuns = def.sessionMaxRuns ?? 0;
|
|
101
|
+
const count = (def.sessionRunCount ?? 0) + 1;
|
|
102
|
+
if (shouldRotateSession(count, maxRuns)) {
|
|
103
|
+
const sessionId = def.sessionId;
|
|
104
|
+
if (sessionId && isValidSessionId(sessionId)) {
|
|
105
|
+
try {
|
|
106
|
+
await new Promise((resolve) => {
|
|
107
|
+
execFile("opencode", ["session", "delete", sessionId], () => resolve());
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
catch {
|
|
111
|
+
// Удаление не должно мешать: просто фиксируем в логе ниже.
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
const newSessionId = generateSessionId();
|
|
115
|
+
await saveTask({
|
|
116
|
+
...def,
|
|
117
|
+
sessionId: newSessionId,
|
|
118
|
+
sessionRunCount: 0,
|
|
119
|
+
});
|
|
120
|
+
await writeSessionStateFile(taskName, newSessionId);
|
|
121
|
+
appendStructuredLog({
|
|
122
|
+
event: "session.rotated",
|
|
123
|
+
task: taskName,
|
|
124
|
+
reason: `maxRuns=${maxRuns} достигнут; сессия удалена, создана новая, счётчик сброшен`,
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
else {
|
|
128
|
+
await saveTask({ ...def, sessionRunCount: count });
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
catch (error) {
|
|
132
|
+
console.warn(`[session] Ротация сессии задачи "${taskName}" не выполнена:`, error);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Д6: ворота выгрузки плагина.
|
|
3
|
+
*
|
|
4
|
+
* Позволяют перестать принимать новые запуски и дождаться уже начатых
|
|
5
|
+
* in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
|
|
6
|
+
* SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
|
|
7
|
+
* отслеживают: их жизненным циклом управляет сама ОС.
|
|
8
|
+
*/
|
|
9
|
+
export interface ShutdownWaitResult {
|
|
10
|
+
timedOut: boolean;
|
|
11
|
+
remaining: number;
|
|
12
|
+
}
|
|
13
|
+
export interface ShutdownGate {
|
|
14
|
+
/** true после begin(): новые запуски должны отклоняться. */
|
|
15
|
+
isShuttingDown(): boolean;
|
|
16
|
+
/** Переводит ворота в режим выгрузки. */
|
|
17
|
+
begin(): void;
|
|
18
|
+
/** Учитывает промис до его завершения (успех или ошибка). */
|
|
19
|
+
track<T>(promise: Promise<T>): Promise<T>;
|
|
20
|
+
/** Сколько операций ещё выполняется. */
|
|
21
|
+
activeCount(): number;
|
|
22
|
+
/** Ждёт завершения активных операций не дольше timeoutMs. */
|
|
23
|
+
waitForIdle(timeoutMs: number): Promise<ShutdownWaitResult>;
|
|
24
|
+
}
|
|
25
|
+
export declare function createShutdownGate(): ShutdownGate;
|
|
26
|
+
//# sourceMappingURL=shutdown.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,cAAc,IAAI,OAAO,CAAC;IAC1B,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,6DAA6D;IAC7D,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,wCAAwC;IACxC,WAAW,IAAI,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAyCjD"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Д6: ворота выгрузки плагина.
|
|
3
|
+
*
|
|
4
|
+
* Позволяют перестать принимать новые запуски и дождаться уже начатых
|
|
5
|
+
* in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
|
|
6
|
+
* SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
|
|
7
|
+
* отслеживают: их жизненным циклом управляет сама ОС.
|
|
8
|
+
*/
|
|
9
|
+
export function createShutdownGate() {
|
|
10
|
+
let shuttingDown = false;
|
|
11
|
+
const active = new Set();
|
|
12
|
+
return {
|
|
13
|
+
isShuttingDown: () => shuttingDown,
|
|
14
|
+
begin: () => {
|
|
15
|
+
shuttingDown = true;
|
|
16
|
+
},
|
|
17
|
+
track(promise) {
|
|
18
|
+
const tracked = promise.finally(() => {
|
|
19
|
+
active.delete(tracked);
|
|
20
|
+
});
|
|
21
|
+
active.add(tracked);
|
|
22
|
+
return tracked;
|
|
23
|
+
},
|
|
24
|
+
activeCount: () => active.size,
|
|
25
|
+
async waitForIdle(timeoutMs) {
|
|
26
|
+
if (active.size === 0) {
|
|
27
|
+
return { timedOut: false, remaining: 0 };
|
|
28
|
+
}
|
|
29
|
+
let timer;
|
|
30
|
+
const timeout = new Promise((resolve) => {
|
|
31
|
+
timer = setTimeout(() => resolve("timeout"), Math.max(0, timeoutMs));
|
|
32
|
+
});
|
|
33
|
+
try {
|
|
34
|
+
const outcome = await Promise.race([
|
|
35
|
+
Promise.allSettled(Array.from(active)).then(() => "done"),
|
|
36
|
+
timeout,
|
|
37
|
+
]);
|
|
38
|
+
return {
|
|
39
|
+
timedOut: outcome === "timeout",
|
|
40
|
+
remaining: active.size,
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
finally {
|
|
44
|
+
if (timer)
|
|
45
|
+
clearTimeout(timer);
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
};
|
|
49
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Машиночитаемые логи запусков (Спринт 22).
|
|
3
|
+
*
|
|
4
|
+
* Формат — JSONL: одна строка = один JSON-объект. Файл лежит рядом с
|
|
5
|
+
* человекочитаемыми логами задач: `<PLUGIN_DIR>/logs/runs.jsonl`.
|
|
6
|
+
*
|
|
7
|
+
* Ротация простая: при превышении лимита текущий файл переименовывается
|
|
8
|
+
* в `runs.jsonl.1` (предыдущий `.1` перезаписывается). Этого достаточно,
|
|
9
|
+
* чтобы лог не рос бесконечно, и не требуется внешних зависимостей.
|
|
10
|
+
*
|
|
11
|
+
* Любая ошибка записи логируется в console.warn и **никогда** не ломает
|
|
12
|
+
* запуск задачи: наблюдаемость не должна влиять на планировщик.
|
|
13
|
+
*/
|
|
14
|
+
/** События структурированного лога. */
|
|
15
|
+
export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | string;
|
|
16
|
+
export interface StructuredLogRecord {
|
|
17
|
+
/** Время записи (ISO). */
|
|
18
|
+
ts: string;
|
|
19
|
+
event: StructuredLogEvent;
|
|
20
|
+
/** id записи history (для run.*). */
|
|
21
|
+
runId?: number;
|
|
22
|
+
task?: string;
|
|
23
|
+
status?: string;
|
|
24
|
+
startedAt?: string;
|
|
25
|
+
finishedAt?: string | null;
|
|
26
|
+
durationMs?: number | null;
|
|
27
|
+
error?: string | null;
|
|
28
|
+
nextTask?: string | null;
|
|
29
|
+
tokens?: number;
|
|
30
|
+
costUsd?: number;
|
|
31
|
+
model?: string;
|
|
32
|
+
workspaceId?: string | null;
|
|
33
|
+
preFlightStatus?: string;
|
|
34
|
+
postFlightStatus?: string;
|
|
35
|
+
/** Источник события: schedule, dashboard, hook, cli, mcp и т.п. */
|
|
36
|
+
source?: string;
|
|
37
|
+
/** HTTP-статус ответа на hook.received. */
|
|
38
|
+
httpStatus?: number;
|
|
39
|
+
/** Адрес отправителя хука (без порта). */
|
|
40
|
+
remote?: string | null;
|
|
41
|
+
/** Размер тела хука в байтах. */
|
|
42
|
+
payloadBytes?: number;
|
|
43
|
+
/** Причина отказа/пропуска. */
|
|
44
|
+
reason?: string;
|
|
45
|
+
}
|
|
46
|
+
export interface ReadStructuredLogsFilter {
|
|
47
|
+
task?: string;
|
|
48
|
+
status?: string;
|
|
49
|
+
event?: string;
|
|
50
|
+
/** ISO-время: записи не раньше. */
|
|
51
|
+
since?: string;
|
|
52
|
+
/** ISO-время: записи не позже. */
|
|
53
|
+
until?: string;
|
|
54
|
+
limit?: number;
|
|
55
|
+
}
|
|
56
|
+
export interface ReadStructuredLogsResult {
|
|
57
|
+
records: StructuredLogRecord[];
|
|
58
|
+
/** Сколько всего записей подошло под фильтр (до применения limit). */
|
|
59
|
+
total: number;
|
|
60
|
+
/** Сколько строк не удалось разобрать как JSON. */
|
|
61
|
+
malformed: number;
|
|
62
|
+
file: string;
|
|
63
|
+
}
|
|
64
|
+
/** Текущий файл и его архив после ротации. */
|
|
65
|
+
export declare const STRUCTURED_LOG_FILE: string;
|
|
66
|
+
export declare const STRUCTURED_LOG_ARCHIVE: string;
|
|
67
|
+
export declare const STRUCTURED_LOG_MAX_BYTES: number;
|
|
68
|
+
/**
|
|
69
|
+
* Добавляет запись в JSONL-лог. Возвращает true при успешной записи.
|
|
70
|
+
* Не бросает исключений.
|
|
71
|
+
*/
|
|
72
|
+
export declare function appendStructuredLog(record: Omit<StructuredLogRecord, "ts"> & {
|
|
73
|
+
ts?: string;
|
|
74
|
+
}): boolean;
|
|
75
|
+
/**
|
|
76
|
+
* Читает JSONL-лог (текущий + архив), фильтрует и сортирует новые сверху.
|
|
77
|
+
*
|
|
78
|
+
* `limit` по умолчанию 200, максимум 5000 — как у HTTP-эндпоинта.
|
|
79
|
+
* `total` считается до применения limit, чтобы клиент знал полный объём.
|
|
80
|
+
*/
|
|
81
|
+
export declare function readStructuredLogs(filter?: ReadStructuredLogsFilter): ReadStructuredLogsResult;
|
|
82
|
+
/** Удаляет JSONL-логи (для тестов и обслуживания). */
|
|
83
|
+
export declare function clearStructuredLogs(): void;
|
|
84
|
+
//# sourceMappingURL=structured-log.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAmC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAsBT;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA4C1B;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
|