agent-steward 0.0.1 → 0.0.3
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 +399 -0
- package/CROSS_PLATFORM.md +151 -0
- package/README.md +307 -15
- package/ROADMAP-STRATEGY.md +196 -0
- package/ROADMAP.md +184 -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 +12 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +175 -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 +193 -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 +90 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +182 -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 +1091 -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/at-fallback.d.ts +42 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +70 -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 +46 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +261 -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 +46 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +256 -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 +100 -0
- package/dist/core/scheduler/registry.d.ts +43 -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 +112 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +749 -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/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 +49 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +128 -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/run-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +48 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +137 -0
- package/dist/db/runs-repo.d.ts +120 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +319 -0
- package/dist/db/schema.d.ts +38 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +325 -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/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 +5209 -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 +64 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +305 -0
- package/dist/rpc.d.ts +3915 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1596 -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 +2414 -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 +632 -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 +112 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +158 -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 +559 -0
- package/docs/COMPATIBILITY.md +237 -0
- package/docs/CONCEPT.md +242 -0
- package/docs/CROSS_PLATFORM.ru.md +152 -0
- package/docs/CROSS_PLATFORM.zh.md +148 -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 +699 -0
- package/docs/FEATURES.zh.md +656 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +363 -0
- package/docs/README.ru.md +287 -0
- package/docs/README.zh.md +306 -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 +2 -0
- package/locales/en.json +781 -0
- package/locales/ru.json +781 -0
- package/locales/zh.json +781 -0
- package/package.json +154 -13
- 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 +209 -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 +239 -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 +1160 -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/at-fallback.ts +113 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +308 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +322 -0
- package/src/core/scheduler/posix.ts +128 -0
- package/src/core/scheduler/registry.ts +101 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +881 -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 +176 -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/run-journal.ts +212 -0
- package/src/db/run-resume.ts +220 -0
- package/src/db/runs-repo.ts +481 -0
- package/src/db/schema.ts +349 -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 +6642 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +345 -0
- package/src/rpc.ts +1704 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2663 -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 +946 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +226 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Ретеншн истории (Спринт 18).
|
|
3
|
+
*
|
|
4
|
+
* Раз в сутки (и по запросу `cleanup_history`) плагин чистит сырую историю
|
|
5
|
+
* запусков: удаляет записи старше `history.retentionDays` и всё, что выходит
|
|
6
|
+
* за `history.maxRecords`. Агрегированные метрики (таблица metrics) при этом
|
|
7
|
+
* не меняются — «Всего запусков» и суммарная стоимость остаются корректными.
|
|
8
|
+
*
|
|
9
|
+
* Очистка никогда не удаляет незавершённые запуски (`finished_at IS NULL`):
|
|
10
|
+
* их обрабатывает crash recovery.
|
|
11
|
+
*/
|
|
12
|
+
import {
|
|
13
|
+
defaultHistorySettings,
|
|
14
|
+
loadSettings,
|
|
15
|
+
saveSettings,
|
|
16
|
+
type HistorySettings,
|
|
17
|
+
} from "../settings.js";
|
|
18
|
+
import {
|
|
19
|
+
countHistory,
|
|
20
|
+
pruneHistory,
|
|
21
|
+
vacuumHistory,
|
|
22
|
+
type PruneHistoryResult,
|
|
23
|
+
} from "../db/history-repo.js";
|
|
24
|
+
|
|
25
|
+
/** Период автоочистки: раз в сутки. */
|
|
26
|
+
export const CLEANUP_INTERVAL_MS = 24 * 60 * 60 * 1000;
|
|
27
|
+
|
|
28
|
+
/** Переопределения лимитов для одного прогона `cleanup_history`. */
|
|
29
|
+
export interface RetentionOverrides {
|
|
30
|
+
retentionDays?: number;
|
|
31
|
+
maxRecords?: number;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export interface RetentionReport extends PruneHistoryResult {
|
|
35
|
+
retentionDays: number;
|
|
36
|
+
maxRecords: number;
|
|
37
|
+
/** Удалось ли выполнить PRAGMA incremental_vacuum. */
|
|
38
|
+
vacuumed: boolean;
|
|
39
|
+
/** Причина, по которой очистка пропущена (лимиты выключены). */
|
|
40
|
+
skipped: string | null;
|
|
41
|
+
ranAt: string;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Приводит переопределение к безопасному целому (>= 0) или undefined. */
|
|
45
|
+
function normalizeOverride(value: unknown): number | undefined {
|
|
46
|
+
if (value === undefined || value === null) return undefined;
|
|
47
|
+
const n = Number(value);
|
|
48
|
+
if (!Number.isFinite(n)) return undefined;
|
|
49
|
+
const int = Math.floor(n);
|
|
50
|
+
return int >= 0 ? int : undefined;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function effectiveLimits(
|
|
54
|
+
settings: HistorySettings,
|
|
55
|
+
overrides: RetentionOverrides,
|
|
56
|
+
): { retentionDays: number; maxRecords: number } {
|
|
57
|
+
return {
|
|
58
|
+
retentionDays:
|
|
59
|
+
normalizeOverride(overrides.retentionDays) ?? settings.retentionDays,
|
|
60
|
+
maxRecords: normalizeOverride(overrides.maxRecords) ?? settings.maxRecords,
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Выполняет очистку истории по текущим настройкам.
|
|
66
|
+
* Переопределения (если переданы) сохраняются в settings.json — так
|
|
67
|
+
* `cleanup_history` заодно настраивает ретеншн.
|
|
68
|
+
*/
|
|
69
|
+
export async function runHistoryRetention(
|
|
70
|
+
overrides: RetentionOverrides = {},
|
|
71
|
+
): Promise<RetentionReport> {
|
|
72
|
+
const settings = await loadSettings();
|
|
73
|
+
const base = settings.history ?? defaultHistorySettings();
|
|
74
|
+
const limits = effectiveLimits(base, overrides);
|
|
75
|
+
const ranAt = new Date().toISOString();
|
|
76
|
+
|
|
77
|
+
const shouldPersistLimits =
|
|
78
|
+
normalizeOverride(overrides.retentionDays) !== undefined ||
|
|
79
|
+
normalizeOverride(overrides.maxRecords) !== undefined;
|
|
80
|
+
|
|
81
|
+
if (limits.retentionDays === 0 && limits.maxRecords === 0) {
|
|
82
|
+
const report: RetentionReport = {
|
|
83
|
+
deletedByAge: 0,
|
|
84
|
+
deletedByCount: 0,
|
|
85
|
+
deleted: 0,
|
|
86
|
+
kept: countHistory(),
|
|
87
|
+
cutoff: null,
|
|
88
|
+
retentionDays: 0,
|
|
89
|
+
maxRecords: 0,
|
|
90
|
+
vacuumed: false,
|
|
91
|
+
skipped: "Ретеншн выключен: history.retentionDays и history.maxRecords равны 0.",
|
|
92
|
+
ranAt,
|
|
93
|
+
};
|
|
94
|
+
if (shouldPersistLimits) {
|
|
95
|
+
await saveSettings({ history: { ...base, ...limits, lastCleanupAt: ranAt, lastCleanupDeleted: 0 } });
|
|
96
|
+
}
|
|
97
|
+
return report;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
const pruned = pruneHistory({
|
|
101
|
+
retentionDays: limits.retentionDays,
|
|
102
|
+
maxRecords: limits.maxRecords,
|
|
103
|
+
});
|
|
104
|
+
const vacuumed = pruned.deleted > 0 ? vacuumHistory() : false;
|
|
105
|
+
|
|
106
|
+
await saveSettings({
|
|
107
|
+
history: {
|
|
108
|
+
...base,
|
|
109
|
+
...limits,
|
|
110
|
+
lastCleanupAt: ranAt,
|
|
111
|
+
lastCleanupDeleted: pruned.deleted,
|
|
112
|
+
},
|
|
113
|
+
});
|
|
114
|
+
|
|
115
|
+
return {
|
|
116
|
+
...pruned,
|
|
117
|
+
retentionDays: limits.retentionDays,
|
|
118
|
+
maxRecords: limits.maxRecords,
|
|
119
|
+
vacuumed,
|
|
120
|
+
skipped: null,
|
|
121
|
+
ranAt,
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* Автоочистка при старте плагина: не чаще одного раза в сутки.
|
|
127
|
+
* `force` игнорирует интервал (используется в тестах).
|
|
128
|
+
*/
|
|
129
|
+
export async function maybeRunHistoryRetention(
|
|
130
|
+
force = false,
|
|
131
|
+
): Promise<RetentionReport | undefined> {
|
|
132
|
+
const settings = await loadSettings();
|
|
133
|
+
const history = settings.history ?? defaultHistorySettings();
|
|
134
|
+
if (!force && history.lastCleanupAt) {
|
|
135
|
+
const last = new Date(history.lastCleanupAt).getTime();
|
|
136
|
+
if (Number.isFinite(last) && Date.now() - last < CLEANUP_INTERVAL_MS) {
|
|
137
|
+
return undefined;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
return await runHistoryRetention();
|
|
141
|
+
}
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Счётчик «сэкономлено $» (Спринт 31.6).
|
|
3
|
+
*
|
|
4
|
+
* Метод — контрфактика по истории: запуски, которые потратили токены, но не
|
|
5
|
+
* записали стоимость (локальная модель, подписка, неизвестная цена), считаются
|
|
6
|
+
* так, как если бы те же токены обрабатывались по эталонной облачной цене.
|
|
7
|
+
* Это ОЦЕНКА, а не бухгалтерия: она не видит кеш, повторные запросы и скидки.
|
|
8
|
+
*
|
|
9
|
+
* Модуль чистый (без БД и HTTP), поэтому методику легко проверить тестом на
|
|
10
|
+
* фиксированных данных.
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
/** Эталонная облачная цена за 1k токенов (вход+выход, смешанно), USD. */
|
|
14
|
+
export const CLOUD_REFERENCE_COST_PER_1K_TOKENS_USD = 0.01;
|
|
15
|
+
|
|
16
|
+
/** Ссылка на методику — её показывают GUI и дашборд рядом с оценкой. */
|
|
17
|
+
export const SAVINGS_METHODOLOGY_URL =
|
|
18
|
+
"https://github.com/DeadSno/agent-steward/blob/main/docs/SAVINGS.md#methodology";
|
|
19
|
+
|
|
20
|
+
/** Минимальный вид записи истории, нужный счётчику экономии. */
|
|
21
|
+
export interface SavingsRecord {
|
|
22
|
+
taskName: string;
|
|
23
|
+
status: string;
|
|
24
|
+
startedAt: string;
|
|
25
|
+
tokens?: number | null;
|
|
26
|
+
costUsd?: number | null;
|
|
27
|
+
model?: string | null;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Экономия по одной задаче. */
|
|
31
|
+
export interface SavingsTaskRow {
|
|
32
|
+
taskName: string;
|
|
33
|
+
/** Сколько запусков попало в контрфактику. */
|
|
34
|
+
runs: number;
|
|
35
|
+
/** Сколько токенов эти запуски потратили. */
|
|
36
|
+
tokens: number;
|
|
37
|
+
/** Оценка экономии, USD. */
|
|
38
|
+
savedUsd: number;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export interface SavingsReport {
|
|
42
|
+
/** Всегда "estimate": счётчик показывает оценку, а не факт. */
|
|
43
|
+
kind: "estimate";
|
|
44
|
+
/** Эталонная цена, на которой построена оценка. */
|
|
45
|
+
referenceCostPer1kTokensUsd: number;
|
|
46
|
+
/** Ссылка на описание методики. */
|
|
47
|
+
methodologyUrl: string;
|
|
48
|
+
/** Запусков, попавших в контрфактику (токены есть, стоимость не записана). */
|
|
49
|
+
runs: number;
|
|
50
|
+
/** Токенов в этих запусках. */
|
|
51
|
+
tokens: number;
|
|
52
|
+
/** Оценка экономии, USD. */
|
|
53
|
+
savedUsd: number;
|
|
54
|
+
/** Фактически записанная стоимость этих же запусков (обычно 0). */
|
|
55
|
+
actualCostUsd: number;
|
|
56
|
+
/** Полная записанная стоимость всех запусков окна — для контекста. */
|
|
57
|
+
totalCostUsd: number;
|
|
58
|
+
/** Разбивка по задачам, самые экономные сверху. */
|
|
59
|
+
byTask: SavingsTaskRow[];
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
export interface ComputeSavingsOptions {
|
|
63
|
+
/** Эталонная цена за 1k токенов; по умолчанию 0.01 USD. */
|
|
64
|
+
referenceCostPer1kTokensUsd?: number;
|
|
65
|
+
/** Сколько строк оставить в разбивке по задачам (по умолчанию 10). */
|
|
66
|
+
topLimit?: number;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
function positiveNumber(value: unknown): number {
|
|
70
|
+
const n = Number(value);
|
|
71
|
+
return Number.isFinite(n) && n > 0 ? n : 0;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
function roundUsd(value: number): number {
|
|
75
|
+
return Math.round(value * 10_000) / 10_000;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Считает оценку экономии по записям истории.
|
|
80
|
+
*
|
|
81
|
+
* Запуск попадает в контрфактику, если он потратил токены и при этом не
|
|
82
|
+
* записал стоимость (`costUsd` пустой или 0). Такие запуски обычно означают
|
|
83
|
+
* локальную модель или уже оплаченную подписку — деньги за токены не списаны,
|
|
84
|
+
* но при облачном провайдере они бы стоили `tokens / 1000 * reference`.
|
|
85
|
+
*/
|
|
86
|
+
export function computeSavings(
|
|
87
|
+
records: SavingsRecord[],
|
|
88
|
+
options: ComputeSavingsOptions = {},
|
|
89
|
+
): SavingsReport {
|
|
90
|
+
const reference = positiveNumber(options.referenceCostPer1kTokensUsd)
|
|
91
|
+
|| CLOUD_REFERENCE_COST_PER_1K_TOKENS_USD;
|
|
92
|
+
const topLimit = Math.max(1, Math.floor(options.topLimit ?? 10));
|
|
93
|
+
|
|
94
|
+
let runs = 0;
|
|
95
|
+
let tokens = 0;
|
|
96
|
+
let savedUsd = 0;
|
|
97
|
+
let actualCostUsd = 0;
|
|
98
|
+
let totalCostUsd = 0;
|
|
99
|
+
const byTask = new Map<string, SavingsTaskRow>();
|
|
100
|
+
|
|
101
|
+
for (const record of records) {
|
|
102
|
+
const recordTokens = positiveNumber(record.tokens);
|
|
103
|
+
const recordCost = positiveNumber(record.costUsd);
|
|
104
|
+
totalCostUsd += recordCost;
|
|
105
|
+
|
|
106
|
+
// Незавершённые запуски не оцениваем: их стоимость ещё не финальна.
|
|
107
|
+
if (String(record.status ?? "") === "running") continue;
|
|
108
|
+
if (recordTokens <= 0 || recordCost > 0) continue;
|
|
109
|
+
|
|
110
|
+
const saved = (recordTokens / 1000) * reference;
|
|
111
|
+
runs += 1;
|
|
112
|
+
tokens += recordTokens;
|
|
113
|
+
savedUsd += saved;
|
|
114
|
+
actualCostUsd += recordCost;
|
|
115
|
+
|
|
116
|
+
const key = record.taskName || "(без имени)";
|
|
117
|
+
const row = byTask.get(key) ?? {
|
|
118
|
+
taskName: key,
|
|
119
|
+
runs: 0,
|
|
120
|
+
tokens: 0,
|
|
121
|
+
savedUsd: 0,
|
|
122
|
+
};
|
|
123
|
+
row.runs += 1;
|
|
124
|
+
row.tokens += recordTokens;
|
|
125
|
+
row.savedUsd += saved;
|
|
126
|
+
byTask.set(key, row);
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
const rows = [...byTask.values()]
|
|
130
|
+
.sort((a, b) => b.savedUsd - a.savedUsd || a.taskName.localeCompare(b.taskName))
|
|
131
|
+
.slice(0, topLimit)
|
|
132
|
+
.map((row) => ({
|
|
133
|
+
taskName: row.taskName,
|
|
134
|
+
runs: row.runs,
|
|
135
|
+
tokens: row.tokens,
|
|
136
|
+
savedUsd: roundUsd(row.savedUsd),
|
|
137
|
+
}));
|
|
138
|
+
|
|
139
|
+
return {
|
|
140
|
+
kind: "estimate",
|
|
141
|
+
referenceCostPer1kTokensUsd: reference,
|
|
142
|
+
methodologyUrl: SAVINGS_METHODOLOGY_URL,
|
|
143
|
+
runs,
|
|
144
|
+
tokens,
|
|
145
|
+
savedUsd: roundUsd(savedUsd),
|
|
146
|
+
actualCostUsd: roundUsd(actualCostUsd),
|
|
147
|
+
totalCostUsd: roundUsd(totalCostUsd),
|
|
148
|
+
byTask: rows,
|
|
149
|
+
};
|
|
150
|
+
}
|
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* schedule-gate: вызывается враппером (.cmd / bash) сразу после срабатывания
|
|
3
|
+
* планировщика, ДО запуска агента.
|
|
4
|
+
*
|
|
5
|
+
* Проверяет расширенное cron-выражение и окно запуска (notBefore/notAfter):
|
|
6
|
+
* node dist/core/schedule-gate.js --cron "0 9 * * *" [--tz "Europe/Moscow"]
|
|
7
|
+
* [--not-before 22:00 --not-after 06:00]
|
|
8
|
+
* [--defer-file "C:\...\name.lock.defer"]
|
|
9
|
+
* [--force-file "C:\...\name.lock.force"]
|
|
10
|
+
* [--now 2026-11-13T12:00:00.000Z] (для тестов)
|
|
11
|
+
*
|
|
12
|
+
* --force-file — маркер ручного запуска (run_task_now, файловый триггер,
|
|
13
|
+
* catch-up). Если файл существует и моложе FORCE_TTL_MS, проверка cron/окна
|
|
14
|
+
* пропускается, а маркер удаляется. Протухший маркер не действует — иначе
|
|
15
|
+
* забытый файл однажды обошёл бы расписание.
|
|
16
|
+
*
|
|
17
|
+
* Коды выхода:
|
|
18
|
+
* 0 — можно запускать (wrapper выполняет агента);
|
|
19
|
+
* 3 — не время (cron не совпал, уже есть отложенный запуск или не в окне),
|
|
20
|
+
* wrapper тихо завершается;
|
|
21
|
+
* 1 — некорректные аргументы (ошибка логируется; запуск разрешён, чтобы не
|
|
22
|
+
* ломать задачу из-за опечатки в конфигурации).
|
|
23
|
+
*
|
|
24
|
+
* Окно запуска реализовано как ПЕРЕНОС, а не пропуск: если cron совпал, но
|
|
25
|
+
* сейчас вне окна, gate ждёт открытия окна. Дубликаты отложенных запусков
|
|
26
|
+
* отсекаются по defer-файлу (атомарное создание); файл запись удаляет сам gate
|
|
27
|
+
* после пробуждения; если файл протух (> 25 часов) — считается stale и
|
|
28
|
+
* перезаписывается.
|
|
29
|
+
*/
|
|
30
|
+
import fs from "node:fs";
|
|
31
|
+
import {
|
|
32
|
+
activeWindowState,
|
|
33
|
+
cronMatches,
|
|
34
|
+
isValidIanaTimeZone,
|
|
35
|
+
normalizeActiveDays,
|
|
36
|
+
parseCron,
|
|
37
|
+
validateLaunchWindow,
|
|
38
|
+
} from "./schedule-v2.js";
|
|
39
|
+
|
|
40
|
+
const STALE_DEFER_MS = 25 * 60 * 60 * 1000;
|
|
41
|
+
|
|
42
|
+
/** Сколько живёт маркер ручного запуска. */
|
|
43
|
+
const FORCE_TTL_MS = 2 * 60 * 1000;
|
|
44
|
+
|
|
45
|
+
/** Дольше 12 часов перенос не ждём — тик просто пропускается. */
|
|
46
|
+
const MAX_POSTPONE_MS = 12 * 60 * 60 * 1000;
|
|
47
|
+
|
|
48
|
+
function argValue(args: string[], name: string): string | undefined {
|
|
49
|
+
const idx = args.indexOf(name);
|
|
50
|
+
if (idx === -1 || idx + 1 >= args.length) return undefined;
|
|
51
|
+
return args[idx + 1];
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function sleepMs(ms: number): Promise<void> {
|
|
55
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** true, если defer-файл сейчас занят другим отложенным запуском. */
|
|
59
|
+
function deferFileBusy(path: string, nowMs: number): boolean {
|
|
60
|
+
try {
|
|
61
|
+
const raw = fs.readFileSync(path, "utf8").trim();
|
|
62
|
+
const ts = Date.parse(raw);
|
|
63
|
+
if (Number.isFinite(ts) && nowMs - ts < STALE_DEFER_MS) return true;
|
|
64
|
+
// Протухший файл — удаляем и занимаем сами.
|
|
65
|
+
fs.unlinkSync(path);
|
|
66
|
+
return false;
|
|
67
|
+
} catch {
|
|
68
|
+
return false;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Атомарно занимает defer-слот; true, если занят успешно. */
|
|
73
|
+
function acquireDefer(path: string, nowMs: number): boolean {
|
|
74
|
+
try {
|
|
75
|
+
const fd = fs.openSync(path, "wx");
|
|
76
|
+
fs.writeSync(fd, new Date(nowMs).toISOString());
|
|
77
|
+
fs.closeSync(fd);
|
|
78
|
+
return true;
|
|
79
|
+
} catch {
|
|
80
|
+
return false;
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
function releaseDefer(path: string): void {
|
|
85
|
+
try {
|
|
86
|
+
fs.unlinkSync(path);
|
|
87
|
+
} catch {
|
|
88
|
+
/* удалён раньше — не страшно */
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* Проверяет и поглощает маркер ручного запуска.
|
|
94
|
+
*
|
|
95
|
+
* Возвращает true, если маркер свежий (значит, запуск инициирован вручную:
|
|
96
|
+
* инструментом, файловым триггером, MCP-событием или catch-up) — тогда гейт
|
|
97
|
+
* расписания не должен блокировать запуск. Маркер удаляется в любом случае.
|
|
98
|
+
*
|
|
99
|
+
* Возраст считается по реальным часам, а не по --now, иначе тестовый --now
|
|
100
|
+
* ломал бы проверку. Протухший маркер (например, задача не стартовала)
|
|
101
|
+
* просто удаляется и не влияет на расписание.
|
|
102
|
+
*/
|
|
103
|
+
function consumeForceMarker(path: string): boolean {
|
|
104
|
+
try {
|
|
105
|
+
const stat = fs.statSync(path);
|
|
106
|
+
fs.unlinkSync(path);
|
|
107
|
+
return Date.now() - stat.mtimeMs <= FORCE_TTL_MS;
|
|
108
|
+
} catch {
|
|
109
|
+
return false;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
async function main(): Promise<number> {
|
|
114
|
+
const args = process.argv.slice(2);
|
|
115
|
+
const cronExpr = argValue(args, "--cron");
|
|
116
|
+
const tz = argValue(args, "--tz");
|
|
117
|
+
const notBefore = argValue(args, "--not-before");
|
|
118
|
+
const notAfter = argValue(args, "--not-after");
|
|
119
|
+
const daysArg = argValue(args, "--days");
|
|
120
|
+
const policyArg = argValue(args, "--window-policy");
|
|
121
|
+
const deferFile = argValue(args, "--defer-file");
|
|
122
|
+
const forceFile = argValue(args, "--force-file");
|
|
123
|
+
const nowArg = argValue(args, "--now");
|
|
124
|
+
|
|
125
|
+
const days = daysArg
|
|
126
|
+
? normalizeActiveDays(
|
|
127
|
+
daysArg
|
|
128
|
+
.split(",")
|
|
129
|
+
.map((value) => Number(value.trim()))
|
|
130
|
+
.filter((value) => Number.isFinite(value)),
|
|
131
|
+
)
|
|
132
|
+
: undefined;
|
|
133
|
+
const policy: "skip" | "postpone" | "run" =
|
|
134
|
+
policyArg === "skip" || policyArg === "run" ? policyArg : "postpone";
|
|
135
|
+
|
|
136
|
+
const now = nowArg ? new Date(nowArg) : new Date();
|
|
137
|
+
if (Number.isNaN(now.getTime())) {
|
|
138
|
+
console.error(`[schedule-gate] Некорректное значение --now: ${nowArg}`);
|
|
139
|
+
return 1;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// Ручной запуск (run_task_now, файловый триггер, MCP-событие, catch-up):
|
|
143
|
+
// маркер свежий — расписание и окно не проверяем.
|
|
144
|
+
if (forceFile && consumeForceMarker(forceFile)) {
|
|
145
|
+
console.error("[schedule-gate] Ручной запуск — проверка расписания пропущена.");
|
|
146
|
+
return 0;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
// Невалидный timezone/окно — не блокируем задачу, логируем и продолжаем.
|
|
150
|
+
const zone = tz && isValidIanaTimeZone(tz) ? tz : undefined;
|
|
151
|
+
if (tz && !zone) {
|
|
152
|
+
console.error(`[schedule-gate] Неизвестный timezone «${tz}» — игнорируем его.`);
|
|
153
|
+
}
|
|
154
|
+
const windowError = validateLaunchWindow(notBefore, notAfter);
|
|
155
|
+
if (windowError) {
|
|
156
|
+
console.error(`[schedule-gate] Окно запуска игнорируется: ${windowError}`);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
let spec = null;
|
|
160
|
+
if (cronExpr) {
|
|
161
|
+
try {
|
|
162
|
+
spec = parseCron(cronExpr);
|
|
163
|
+
} catch (err: any) {
|
|
164
|
+
console.error(
|
|
165
|
+
`[schedule-gate] Невалидный cron «${cronExpr}»: ${
|
|
166
|
+
err instanceof Error ? err.message : String(err)
|
|
167
|
+
} — пропускаем проверку cron.`,
|
|
168
|
+
);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
if (spec && !cronMatches(spec, now, zone)) {
|
|
173
|
+
// По расширенному cron сейчас не время.
|
|
174
|
+
return 3;
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
// Дни недели и окно запуска (Спринт 27). Политика вне окна:
|
|
178
|
+
// postpone (по умолчанию) — ждём открытия окна;
|
|
179
|
+
// skip — тихо пропускаем тик;
|
|
180
|
+
// run — выполняем, несмотря на окно.
|
|
181
|
+
const windowOptions = { notBefore, notAfter, days, timeZone: zone };
|
|
182
|
+
if (policy !== "run") {
|
|
183
|
+
const state = activeWindowState(now, windowOptions);
|
|
184
|
+
if (!state.active) {
|
|
185
|
+
if (policy === "skip") {
|
|
186
|
+
console.error(`[schedule-gate] Пропуск: ${state.reason ?? "вне окна"}.`);
|
|
187
|
+
return 3;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
if (!state.nextOpenAt) {
|
|
191
|
+
// Окно закрыто, но время его открытия неизвестно (например, окно
|
|
192
|
+
// выходит за горизонт поиска). Разрешать запуск в этом случае нельзя.
|
|
193
|
+
console.error(
|
|
194
|
+
`[schedule-gate] ${state.reason ?? "вне окна"} — время открытия окна неизвестно, запуск пропущен.`,
|
|
195
|
+
);
|
|
196
|
+
return 3;
|
|
197
|
+
}
|
|
198
|
+
const wait = Math.max(0, state.nextOpenAt.getTime() - now.getTime());
|
|
199
|
+
if (wait <= 0) return 0;
|
|
200
|
+
if (wait > MAX_POSTPONE_MS) {
|
|
201
|
+
console.error(
|
|
202
|
+
`[schedule-gate] ${state.reason ?? "вне окна"} — до открытия больше 12 часов, тик пропущен.`,
|
|
203
|
+
);
|
|
204
|
+
return 3;
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
// ПЕРЕНОС: ждём открытия окна. Откладываем один запуск, остальные тики
|
|
208
|
+
// отсекаются по defer-файлу.
|
|
209
|
+
if (deferFile) {
|
|
210
|
+
if (deferFileBusy(deferFile, now.getTime())) {
|
|
211
|
+
console.error("[schedule-gate] Отложенный запуск уже ожидает открытия окна.");
|
|
212
|
+
return 3;
|
|
213
|
+
}
|
|
214
|
+
if (!acquireDefer(deferFile, now.getTime())) {
|
|
215
|
+
console.error("[schedule-gate] Не удалось захватить defer-файл — пропускаем.");
|
|
216
|
+
return 3;
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
console.error(
|
|
221
|
+
`[schedule-gate] ${state.reason ?? "Вне окна"} — запуск перенесён на ~${Math.round(
|
|
222
|
+
wait / 60000,
|
|
223
|
+
)} мин.`,
|
|
224
|
+
);
|
|
225
|
+
let remaining = wait;
|
|
226
|
+
while (remaining > 0) {
|
|
227
|
+
const chunk = Math.min(remaining, 60_000);
|
|
228
|
+
await sleepMs(chunk);
|
|
229
|
+
remaining -= chunk;
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
const woke = new Date();
|
|
233
|
+
if (deferFile) releaseDefer(deferFile);
|
|
234
|
+
|
|
235
|
+
if (!activeWindowState(woke, windowOptions).active) {
|
|
236
|
+
console.error("[schedule-gate] Окно не открылось за отведённое время — не запускаем.");
|
|
237
|
+
return 3;
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
return 0;
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
main().then(
|
|
246
|
+
(code) => process.exit(code),
|
|
247
|
+
(err) => {
|
|
248
|
+
console.error(
|
|
249
|
+
`[schedule-gate] Непредвиденная ошибка: ${err instanceof Error ? err.message : String(err)} — запускаем.`,
|
|
250
|
+
);
|
|
251
|
+
process.exit(1);
|
|
252
|
+
},
|
|
253
|
+
);
|