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,150 @@
|
|
|
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
|
+
|
|
9
|
+
export const SESSION_MODES = ["new", "reuse", "last"] as const;
|
|
10
|
+
export type SessionMode = (typeof SESSION_MODES)[number];
|
|
11
|
+
|
|
12
|
+
const SESSION_ID_PATTERN = /^ses_[A-Za-z0-9]{10,64}$/;
|
|
13
|
+
|
|
14
|
+
/** Генерация id сессии в формате `ses_<26+ base36>`. */
|
|
15
|
+
export function generateSessionId(): string {
|
|
16
|
+
const alphabet = "abcdefghijklmnopqrstuvwxyz0123456789";
|
|
17
|
+
const bytes = crypto.randomBytes(13);
|
|
18
|
+
let suffix = "";
|
|
19
|
+
for (const byte of bytes) {
|
|
20
|
+
suffix += alphabet[byte % 36];
|
|
21
|
+
}
|
|
22
|
+
// 13 байт → 20 символов base36; добавляем 6 случайных, чтобы было ≥26.
|
|
23
|
+
const extra = crypto.randomBytes(3).toString("hex");
|
|
24
|
+
return `ses_${suffix}${extra}`;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** Проверка формата id сессии. */
|
|
28
|
+
export function isValidSessionId(value: unknown): value is string {
|
|
29
|
+
return typeof value === "string" && SESSION_ID_PATTERN.test(value);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Нормализация режима сессии. undefined → "new".
|
|
34
|
+
* Возвращает undefined для мусора, чтобы вызывающий мог решить, падать или нет.
|
|
35
|
+
*/
|
|
36
|
+
export function normalizeSessionMode(value: unknown): SessionMode | undefined {
|
|
37
|
+
if (value === undefined || value === null) return "new";
|
|
38
|
+
if (value === "new" || value === "reuse" || value === "last") return value;
|
|
39
|
+
return undefined;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** Аргументы для `opencode run` в зависимости от режима. */
|
|
43
|
+
export function buildSessionArgs(mode: SessionMode, sessionId?: string): string[] {
|
|
44
|
+
switch (mode) {
|
|
45
|
+
case "reuse":
|
|
46
|
+
return sessionId && isValidSessionId(sessionId) ? ["--session", sessionId] : [];
|
|
47
|
+
case "last":
|
|
48
|
+
return ["--continue"];
|
|
49
|
+
default:
|
|
50
|
+
return [];
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** Признак того, что сессию пора ротировать после N запусков. */
|
|
55
|
+
export function shouldRotateSession(runCount: number, maxRuns: number): boolean {
|
|
56
|
+
return maxRuns > 0 && runCount >= maxRuns;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Счётчик запусков сессии при сохранении определения задачи.
|
|
61
|
+
*
|
|
62
|
+
* Редактирование не должно обнулять прогресс к sessionMaxRuns, если сессия
|
|
63
|
+
* осталась прежней. При смене режима или id сессии счётчик начинается заново.
|
|
64
|
+
*/
|
|
65
|
+
export function preservedSessionRunCount(
|
|
66
|
+
previous:
|
|
67
|
+
| { session?: SessionMode; sessionId?: string; sessionRunCount?: number }
|
|
68
|
+
| undefined,
|
|
69
|
+
session: SessionMode,
|
|
70
|
+
sessionId: string | undefined
|
|
71
|
+
): number {
|
|
72
|
+
if (!previous) return 0;
|
|
73
|
+
if (previous.session !== session || previous.sessionId !== sessionId) return 0;
|
|
74
|
+
return previous.sessionRunCount ?? 0;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** Путь к sidecar-файлу с актуальным id сессии задачи. */
|
|
78
|
+
export function sessionStatePath(taskName: string): string {
|
|
79
|
+
return path.join(WRAPPER_DIR, `${sanitizeName(taskName)}.session`);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Записывает актуальный id сессии в sidecar-файл, который обёртка читает
|
|
84
|
+
* непосредственно перед запуском opencode. `undefined` удаляет файл.
|
|
85
|
+
* Никогда не бросает.
|
|
86
|
+
*/
|
|
87
|
+
export async function writeSessionStateFile(
|
|
88
|
+
taskName: string,
|
|
89
|
+
sessionId: string | undefined
|
|
90
|
+
): Promise<void> {
|
|
91
|
+
try {
|
|
92
|
+
const file = sessionStatePath(taskName);
|
|
93
|
+
await fs.mkdir(WRAPPER_DIR, { recursive: true });
|
|
94
|
+
if (sessionId) {
|
|
95
|
+
await fs.writeFile(file, `${sessionId}\n`, "utf8");
|
|
96
|
+
} else {
|
|
97
|
+
await fs.unlink(file).catch(() => undefined);
|
|
98
|
+
}
|
|
99
|
+
} catch (error) {
|
|
100
|
+
console.warn(
|
|
101
|
+
`[session] Не удалось обновить файл сессии задачи "${taskName}":`,
|
|
102
|
+
error
|
|
103
|
+
);
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Best-effort ротация переиспользуемой сессии после завершения запуска.
|
|
109
|
+
* Удаляет сессию через opencode CLI, генерирует новый id, обновляет
|
|
110
|
+
* определение задачи и sidecar-файл обёртки. Никогда не бросает — сбой
|
|
111
|
+
* ротации не должен ломать историю запуска.
|
|
112
|
+
*/
|
|
113
|
+
export async function rotateSessionIfNeeded(taskName: string): Promise<void> {
|
|
114
|
+
try {
|
|
115
|
+
const def = await getTask(taskName);
|
|
116
|
+
if (!def || def.session !== "reuse") return;
|
|
117
|
+
|
|
118
|
+
const maxRuns = def.sessionMaxRuns ?? 0;
|
|
119
|
+
const count = (def.sessionRunCount ?? 0) + 1;
|
|
120
|
+
|
|
121
|
+
if (shouldRotateSession(count, maxRuns)) {
|
|
122
|
+
const sessionId = def.sessionId;
|
|
123
|
+
if (sessionId && isValidSessionId(sessionId)) {
|
|
124
|
+
try {
|
|
125
|
+
await new Promise<void>((resolve) => {
|
|
126
|
+
execFile("opencode", ["session", "delete", sessionId], () => resolve());
|
|
127
|
+
});
|
|
128
|
+
} catch {
|
|
129
|
+
// Удаление не должно мешать: просто фиксируем в логе ниже.
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
const newSessionId = generateSessionId();
|
|
133
|
+
await saveTask({
|
|
134
|
+
...def,
|
|
135
|
+
sessionId: newSessionId,
|
|
136
|
+
sessionRunCount: 0,
|
|
137
|
+
});
|
|
138
|
+
await writeSessionStateFile(taskName, newSessionId);
|
|
139
|
+
appendStructuredLog({
|
|
140
|
+
event: "session.rotated",
|
|
141
|
+
task: taskName,
|
|
142
|
+
reason: `maxRuns=${maxRuns} достигнут; сессия удалена, создана новая, счётчик сброшен`,
|
|
143
|
+
});
|
|
144
|
+
} else {
|
|
145
|
+
await saveTask({ ...def, sessionRunCount: count });
|
|
146
|
+
}
|
|
147
|
+
} catch (error) {
|
|
148
|
+
console.warn(`[session] Ротация сессии задачи "${taskName}" не выполнена:`, error);
|
|
149
|
+
}
|
|
150
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Д6: ворота выгрузки плагина.
|
|
3
|
+
*
|
|
4
|
+
* Позволяют перестать принимать новые запуски и дождаться уже начатых
|
|
5
|
+
* in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
|
|
6
|
+
* SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
|
|
7
|
+
* отслеживают: их жизненным циклом управляет сама ОС.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
export interface ShutdownWaitResult {
|
|
11
|
+
timedOut: boolean;
|
|
12
|
+
remaining: number;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export interface ShutdownGate {
|
|
16
|
+
/** true после begin(): новые запуски должны отклоняться. */
|
|
17
|
+
isShuttingDown(): boolean;
|
|
18
|
+
/** Переводит ворота в режим выгрузки. */
|
|
19
|
+
begin(): void;
|
|
20
|
+
/** Учитывает промис до его завершения (успех или ошибка). */
|
|
21
|
+
track<T>(promise: Promise<T>): Promise<T>;
|
|
22
|
+
/** Сколько операций ещё выполняется. */
|
|
23
|
+
activeCount(): number;
|
|
24
|
+
/** Ждёт завершения активных операций не дольше timeoutMs. */
|
|
25
|
+
waitForIdle(timeoutMs: number): Promise<ShutdownWaitResult>;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export function createShutdownGate(): ShutdownGate {
|
|
29
|
+
let shuttingDown = false;
|
|
30
|
+
const active = new Set<Promise<unknown>>();
|
|
31
|
+
|
|
32
|
+
return {
|
|
33
|
+
isShuttingDown: () => shuttingDown,
|
|
34
|
+
begin: () => {
|
|
35
|
+
shuttingDown = true;
|
|
36
|
+
},
|
|
37
|
+
track<T>(promise: Promise<T>): Promise<T> {
|
|
38
|
+
const tracked = promise.finally(() => {
|
|
39
|
+
active.delete(tracked);
|
|
40
|
+
});
|
|
41
|
+
active.add(tracked);
|
|
42
|
+
return tracked;
|
|
43
|
+
},
|
|
44
|
+
activeCount: () => active.size,
|
|
45
|
+
async waitForIdle(timeoutMs: number): Promise<ShutdownWaitResult> {
|
|
46
|
+
if (active.size === 0) {
|
|
47
|
+
return { timedOut: false, remaining: 0 };
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
let timer: ReturnType<typeof setTimeout> | undefined;
|
|
51
|
+
const timeout = new Promise<"timeout">((resolve) => {
|
|
52
|
+
timer = setTimeout(() => resolve("timeout"), Math.max(0, timeoutMs));
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
try {
|
|
56
|
+
const outcome = await Promise.race([
|
|
57
|
+
Promise.allSettled(Array.from(active)).then(() => "done" as const),
|
|
58
|
+
timeout,
|
|
59
|
+
]);
|
|
60
|
+
return {
|
|
61
|
+
timedOut: outcome === "timeout",
|
|
62
|
+
remaining: active.size,
|
|
63
|
+
};
|
|
64
|
+
} finally {
|
|
65
|
+
if (timer) clearTimeout(timer);
|
|
66
|
+
}
|
|
67
|
+
},
|
|
68
|
+
};
|
|
69
|
+
}
|
|
@@ -0,0 +1,214 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { LOG_DIR } from "../types.js";
|
|
4
|
+
import { redactSecretsInText } from "./secrets.js";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Машиночитаемые логи запусков (Спринт 22).
|
|
8
|
+
*
|
|
9
|
+
* Формат — JSONL: одна строка = один JSON-объект. Файл лежит рядом с
|
|
10
|
+
* человекочитаемыми логами задач: `<PLUGIN_DIR>/logs/runs.jsonl`.
|
|
11
|
+
*
|
|
12
|
+
* Ротация простая: при превышении лимита текущий файл переименовывается
|
|
13
|
+
* в `runs.jsonl.1` (предыдущий `.1` перезаписывается). Этого достаточно,
|
|
14
|
+
* чтобы лог не рос бесконечно, и не требуется внешних зависимостей.
|
|
15
|
+
*
|
|
16
|
+
* Любая ошибка записи логируется в console.warn и **никогда** не ломает
|
|
17
|
+
* запуск задачи: наблюдаемость не должна влиять на планировщик.
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
/** События структурированного лога. */
|
|
21
|
+
export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | string;
|
|
22
|
+
|
|
23
|
+
export interface StructuredLogRecord {
|
|
24
|
+
/** Время записи (ISO). */
|
|
25
|
+
ts: string;
|
|
26
|
+
event: StructuredLogEvent;
|
|
27
|
+
/** id записи history (для run.*). */
|
|
28
|
+
runId?: number;
|
|
29
|
+
task?: string;
|
|
30
|
+
status?: string;
|
|
31
|
+
startedAt?: string;
|
|
32
|
+
finishedAt?: string | null;
|
|
33
|
+
durationMs?: number | null;
|
|
34
|
+
error?: string | null;
|
|
35
|
+
nextTask?: string | null;
|
|
36
|
+
tokens?: number;
|
|
37
|
+
costUsd?: number;
|
|
38
|
+
model?: string;
|
|
39
|
+
workspaceId?: string | null;
|
|
40
|
+
preFlightStatus?: string;
|
|
41
|
+
postFlightStatus?: string;
|
|
42
|
+
/** Источник события: schedule, dashboard, hook, cli, mcp и т.п. */
|
|
43
|
+
source?: string;
|
|
44
|
+
/** HTTP-статус ответа на hook.received. */
|
|
45
|
+
httpStatus?: number;
|
|
46
|
+
/** Адрес отправителя хука (без порта). */
|
|
47
|
+
remote?: string | null;
|
|
48
|
+
/** Размер тела хука в байтах. */
|
|
49
|
+
payloadBytes?: number;
|
|
50
|
+
/** Причина отказа/пропуска. */
|
|
51
|
+
reason?: string;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export interface ReadStructuredLogsFilter {
|
|
55
|
+
task?: string;
|
|
56
|
+
status?: string;
|
|
57
|
+
event?: string;
|
|
58
|
+
/** ISO-время: записи не раньше. */
|
|
59
|
+
since?: string;
|
|
60
|
+
/** ISO-время: записи не позже. */
|
|
61
|
+
until?: string;
|
|
62
|
+
limit?: number;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export interface ReadStructuredLogsResult {
|
|
66
|
+
records: StructuredLogRecord[];
|
|
67
|
+
/** Сколько всего записей подошло под фильтр (до применения limit). */
|
|
68
|
+
total: number;
|
|
69
|
+
/** Сколько строк не удалось разобрать как JSON. */
|
|
70
|
+
malformed: number;
|
|
71
|
+
file: string;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** Текущий файл и его архив после ротации. */
|
|
75
|
+
export const STRUCTURED_LOG_FILE = path.join(LOG_DIR, "runs.jsonl");
|
|
76
|
+
export const STRUCTURED_LOG_ARCHIVE = `${STRUCTURED_LOG_FILE}.1`;
|
|
77
|
+
export const STRUCTURED_LOG_MAX_BYTES = 10 * 1024 * 1024;
|
|
78
|
+
|
|
79
|
+
function warn(message: string, err: unknown): void {
|
|
80
|
+
try {
|
|
81
|
+
console.warn(
|
|
82
|
+
`[structured-log] ${message}: ${err instanceof Error ? err.message : String(err)}`
|
|
83
|
+
);
|
|
84
|
+
} catch {
|
|
85
|
+
// console может быть недоступен в урезанном окружении — молча игнорируем.
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
function ensureLogDir(): void {
|
|
90
|
+
fs.mkdirSync(LOG_DIR, { recursive: true });
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/** Ротирует лог, если он превысил лимит. Вызывается перед append. */
|
|
94
|
+
function rotateIfNeeded(): void {
|
|
95
|
+
try {
|
|
96
|
+
const stat = fs.statSync(STRUCTURED_LOG_FILE);
|
|
97
|
+
if (stat.size < STRUCTURED_LOG_MAX_BYTES) return;
|
|
98
|
+
try {
|
|
99
|
+
fs.rmSync(STRUCTURED_LOG_ARCHIVE, { force: true });
|
|
100
|
+
} catch {
|
|
101
|
+
// Нет старого архива — не страшно.
|
|
102
|
+
}
|
|
103
|
+
fs.renameSync(STRUCTURED_LOG_FILE, STRUCTURED_LOG_ARCHIVE);
|
|
104
|
+
} catch (err: any) {
|
|
105
|
+
// ENOENT — файла ещё нет, это нормально.
|
|
106
|
+
if (err?.code !== "ENOENT") warn("не удалось ротировать лог", err);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Добавляет запись в JSONL-лог. Возвращает true при успешной записи.
|
|
112
|
+
* Не бросает исключений.
|
|
113
|
+
*/
|
|
114
|
+
export function appendStructuredLog(
|
|
115
|
+
record: Omit<StructuredLogRecord, "ts"> & { ts?: string }
|
|
116
|
+
): boolean {
|
|
117
|
+
try {
|
|
118
|
+
ensureLogDir();
|
|
119
|
+
rotateIfNeeded();
|
|
120
|
+
const payload: StructuredLogRecord = {
|
|
121
|
+
...record,
|
|
122
|
+
ts: record.ts ?? new Date().toISOString(),
|
|
123
|
+
};
|
|
124
|
+
// Спринт 26: даже если ошибка пришла из внешнего процесса, известные
|
|
125
|
+
// значения секретов и присваивания TOKEN=/password: вырезаются.
|
|
126
|
+
if (typeof payload.error === "string") {
|
|
127
|
+
payload.error = redactSecretsInText(payload.error);
|
|
128
|
+
}
|
|
129
|
+
if (typeof payload.reason === "string") {
|
|
130
|
+
payload.reason = redactSecretsInText(payload.reason);
|
|
131
|
+
}
|
|
132
|
+
fs.appendFileSync(STRUCTURED_LOG_FILE, `${JSON.stringify(payload)}\n`, "utf8");
|
|
133
|
+
return true;
|
|
134
|
+
} catch (err) {
|
|
135
|
+
warn("не удалось записать событие", err);
|
|
136
|
+
return false;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
function readLines(file: string): string[] {
|
|
141
|
+
try {
|
|
142
|
+
return fs
|
|
143
|
+
.readFileSync(file, "utf8")
|
|
144
|
+
.split(/\r?\n/)
|
|
145
|
+
.filter((line) => line.trim().length > 0);
|
|
146
|
+
} catch (err: any) {
|
|
147
|
+
if (err?.code !== "ENOENT") warn(`не удалось прочитать ${file}`, err);
|
|
148
|
+
return [];
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/**
|
|
153
|
+
* Читает JSONL-лог (текущий + архив), фильтрует и сортирует новые сверху.
|
|
154
|
+
*
|
|
155
|
+
* `limit` по умолчанию 200, максимум 5000 — как у HTTP-эндпоинта.
|
|
156
|
+
* `total` считается до применения limit, чтобы клиент знал полный объём.
|
|
157
|
+
*/
|
|
158
|
+
export function readStructuredLogs(
|
|
159
|
+
filter: ReadStructuredLogsFilter = {}
|
|
160
|
+
): ReadStructuredLogsResult {
|
|
161
|
+
const limit = Math.max(1, Math.min(5000, Math.floor(filter.limit ?? 200) || 200));
|
|
162
|
+
const task = filter.task?.trim().toLowerCase();
|
|
163
|
+
const status = filter.status?.trim().toLowerCase();
|
|
164
|
+
const event = filter.event?.trim().toLowerCase();
|
|
165
|
+
const since = filter.since?.trim();
|
|
166
|
+
const until = filter.until?.trim();
|
|
167
|
+
|
|
168
|
+
const records: StructuredLogRecord[] = [];
|
|
169
|
+
let malformed = 0;
|
|
170
|
+
|
|
171
|
+
// Архив старше текущего файла; порядок не важен, ниже сортируем по ts.
|
|
172
|
+
for (const file of [STRUCTURED_LOG_ARCHIVE, STRUCTURED_LOG_FILE]) {
|
|
173
|
+
for (const line of readLines(file)) {
|
|
174
|
+
let parsed: any;
|
|
175
|
+
try {
|
|
176
|
+
parsed = JSON.parse(line);
|
|
177
|
+
} catch {
|
|
178
|
+
malformed += 1;
|
|
179
|
+
continue;
|
|
180
|
+
}
|
|
181
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
|
|
182
|
+
malformed += 1;
|
|
183
|
+
continue;
|
|
184
|
+
}
|
|
185
|
+
if (typeof parsed.ts !== "string") parsed.ts = "";
|
|
186
|
+
if (typeof parsed.event !== "string") parsed.event = "";
|
|
187
|
+
if (task && String(parsed.task ?? "").toLowerCase() !== task) continue;
|
|
188
|
+
if (status && String(parsed.status ?? "").toLowerCase() !== status) continue;
|
|
189
|
+
if (event && String(parsed.event).toLowerCase() !== event) continue;
|
|
190
|
+
if (since && String(parsed.ts) < since) continue;
|
|
191
|
+
if (until && String(parsed.ts) > until) continue;
|
|
192
|
+
records.push(parsed as StructuredLogRecord);
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
const total = records.length;
|
|
197
|
+
records.sort((a, b) => String(b.ts).localeCompare(String(a.ts)));
|
|
198
|
+
return {
|
|
199
|
+
records: records.slice(0, limit),
|
|
200
|
+
total,
|
|
201
|
+
malformed,
|
|
202
|
+
file: STRUCTURED_LOG_FILE,
|
|
203
|
+
};
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/** Удаляет JSONL-логи (для тестов и обслуживания). */
|
|
207
|
+
export function clearStructuredLogs(): void {
|
|
208
|
+
try {
|
|
209
|
+
fs.rmSync(STRUCTURED_LOG_FILE, { force: true });
|
|
210
|
+
fs.rmSync(STRUCTURED_LOG_ARCHIVE, { force: true });
|
|
211
|
+
} catch (err) {
|
|
212
|
+
warn("не удалось очистить лог", err);
|
|
213
|
+
}
|
|
214
|
+
}
|