agent-steward 0.0.1 → 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/README.md +306 -15
- 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 +133 -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 +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,424 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Аналитика по истории запусков (Спринт 18).
|
|
3
|
+
*
|
|
4
|
+
* Чистые функции без БД и HTTP: дашборд и RPC отдают JSON, экспорт — CSV.
|
|
5
|
+
* Так агрегаты легко тестировать без запуска сервера.
|
|
6
|
+
*/
|
|
7
|
+
import {
|
|
8
|
+
computeSavings,
|
|
9
|
+
type SavingsRecord,
|
|
10
|
+
type SavingsReport,
|
|
11
|
+
} from "./savings.js";
|
|
12
|
+
|
|
13
|
+
/** Оценка стоимости, если запись истории не содержит costUsd. */
|
|
14
|
+
export const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
|
|
15
|
+
|
|
16
|
+
/** Минимальный вид записи истории, нужный аналитике. */
|
|
17
|
+
export interface AnalyticsRecord {
|
|
18
|
+
taskName: string;
|
|
19
|
+
status: string;
|
|
20
|
+
startedAt: string;
|
|
21
|
+
finishedAt?: string | null;
|
|
22
|
+
durationMs?: number | null;
|
|
23
|
+
error?: string | null;
|
|
24
|
+
tokens?: number;
|
|
25
|
+
costUsd?: number;
|
|
26
|
+
model?: string;
|
|
27
|
+
workspaceId?: string | null;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Описание задачи для группировки по матрицам. */
|
|
31
|
+
export interface AnalyticsTaskRef {
|
|
32
|
+
name: string;
|
|
33
|
+
matrixParentId?: string | null;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export interface DailyBucket {
|
|
37
|
+
/** YYYY-MM-DD (UTC). */
|
|
38
|
+
date: string;
|
|
39
|
+
total: number;
|
|
40
|
+
success: number;
|
|
41
|
+
error: number;
|
|
42
|
+
partial: number;
|
|
43
|
+
tokens: number;
|
|
44
|
+
costUsd: number;
|
|
45
|
+
avgDurationMs: number;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
export interface TaskAnalyticsRow {
|
|
49
|
+
taskName: string;
|
|
50
|
+
total: number;
|
|
51
|
+
success: number;
|
|
52
|
+
error: number;
|
|
53
|
+
/** Процент успешных запусков (0..100, один знак после запятой). */
|
|
54
|
+
successRate: number;
|
|
55
|
+
avgDurationMs: number;
|
|
56
|
+
tokens: number;
|
|
57
|
+
costUsd: number;
|
|
58
|
+
/** Задача — клон матрицы (matrixParentId задан). */
|
|
59
|
+
isMatrixClone: boolean;
|
|
60
|
+
matrixParentId: string | null;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export interface MatrixAnalyticsRow {
|
|
64
|
+
parentId: string;
|
|
65
|
+
clones: number;
|
|
66
|
+
total: number;
|
|
67
|
+
success: number;
|
|
68
|
+
error: number;
|
|
69
|
+
successRate: number;
|
|
70
|
+
tokens: number;
|
|
71
|
+
costUsd: number;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export interface ModelAnalyticsRow {
|
|
75
|
+
model: string;
|
|
76
|
+
total: number;
|
|
77
|
+
costUsd: number;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/** Агрегат по тексту ошибки — топ ошибок для дайджеста (Спринт 20). */
|
|
81
|
+
export interface ErrorAnalyticsRow {
|
|
82
|
+
/** Текст ошибки (обрезан до 160 символов). */
|
|
83
|
+
message: string;
|
|
84
|
+
count: number;
|
|
85
|
+
/** Последнее появление (ISO). */
|
|
86
|
+
lastAt: string;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
export interface AnalyticsReport {
|
|
90
|
+
generatedAt: string;
|
|
91
|
+
/** Окно анализа в днях. */
|
|
92
|
+
windowDays: number;
|
|
93
|
+
totals: {
|
|
94
|
+
total: number;
|
|
95
|
+
success: number;
|
|
96
|
+
error: number;
|
|
97
|
+
partial: number;
|
|
98
|
+
successRate: number;
|
|
99
|
+
avgDurationMs: number;
|
|
100
|
+
tokens: number;
|
|
101
|
+
costUsd: number;
|
|
102
|
+
};
|
|
103
|
+
daily: DailyBucket[];
|
|
104
|
+
tasks: TaskAnalyticsRow[];
|
|
105
|
+
topByCost: TaskAnalyticsRow[];
|
|
106
|
+
matrices: MatrixAnalyticsRow[];
|
|
107
|
+
byModel: ModelAnalyticsRow[];
|
|
108
|
+
/** Топ ошибок по частоте (Спринт 20). */
|
|
109
|
+
errors: ErrorAnalyticsRow[];
|
|
110
|
+
/** Оценка экономии по контрфактике (Спринт 31.6). */
|
|
111
|
+
savings: SavingsReport;
|
|
112
|
+
sources: {
|
|
113
|
+
historyRecords: number;
|
|
114
|
+
/** Сколько записей попало в окно. */
|
|
115
|
+
recordsInWindow: number;
|
|
116
|
+
/** Ограничение по количеству строк в топах. */
|
|
117
|
+
topLimit: number;
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
export interface BuildAnalyticsOptions {
|
|
122
|
+
/** Окно анализа в днях (по умолчанию 14). */
|
|
123
|
+
days?: number;
|
|
124
|
+
/** Опорный момент (для тестов). */
|
|
125
|
+
now?: Date;
|
|
126
|
+
/** Сколько строк оставлять в топах (по умолчанию 10). */
|
|
127
|
+
topLimit?: number;
|
|
128
|
+
/** Известные задачи — нужны для группировки матриц. */
|
|
129
|
+
tasks?: AnalyticsTaskRef[];
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function toNumber(value: unknown): number {
|
|
133
|
+
const n = Number(value);
|
|
134
|
+
return Number.isFinite(n) && n > 0 ? n : 0;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/** Стоимость записи: явная цена, иначе оценка по токенам. */
|
|
138
|
+
export function recordCost(record: AnalyticsRecord): number {
|
|
139
|
+
const cost = toNumber(record.costUsd);
|
|
140
|
+
if (cost > 0) return cost;
|
|
141
|
+
const tokens = toNumber(record.tokens);
|
|
142
|
+
return tokens > 0 ? (tokens / 1000) * ESTIMATED_COST_PER_1K_TOKENS_USD : 0;
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/** Дата записи в UTC-формате YYYY-MM-DD. */
|
|
146
|
+
export function recordDate(record: AnalyticsRecord): string {
|
|
147
|
+
const time = new Date(record.startedAt).getTime();
|
|
148
|
+
if (!Number.isFinite(time)) return "";
|
|
149
|
+
return new Date(time).toISOString().slice(0, 10);
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
function utcDayKey(date: Date): string {
|
|
153
|
+
return date.toISOString().slice(0, 10);
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
function percent(part: number, total: number): number {
|
|
157
|
+
if (total <= 0) return 0;
|
|
158
|
+
return Math.round((part / total) * 1000) / 10;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
/**
|
|
162
|
+
* Строит отчёт по истории: итоги, дневные бакеты, разбивка по задачам,
|
|
163
|
+
* матрицам и моделям.
|
|
164
|
+
*/
|
|
165
|
+
export function buildAnalytics(
|
|
166
|
+
records: AnalyticsRecord[],
|
|
167
|
+
options: BuildAnalyticsOptions = {}
|
|
168
|
+
): AnalyticsReport {
|
|
169
|
+
const windowDays = Math.max(1, Math.floor(options.days ?? 14));
|
|
170
|
+
const topLimit = Math.max(1, Math.floor(options.topLimit ?? 10));
|
|
171
|
+
const now = options.now ?? new Date();
|
|
172
|
+
|
|
173
|
+
const dayKeys: string[] = [];
|
|
174
|
+
const dayBuckets = new Map<string, DailyBucket>();
|
|
175
|
+
for (let i = windowDays - 1; i >= 0; i -= 1) {
|
|
176
|
+
const key = utcDayKey(new Date(now.getTime() - i * 24 * 60 * 60 * 1000));
|
|
177
|
+
dayKeys.push(key);
|
|
178
|
+
dayBuckets.set(key, {
|
|
179
|
+
date: key,
|
|
180
|
+
total: 0,
|
|
181
|
+
success: 0,
|
|
182
|
+
error: 0,
|
|
183
|
+
partial: 0,
|
|
184
|
+
tokens: 0,
|
|
185
|
+
costUsd: 0,
|
|
186
|
+
avgDurationMs: 0,
|
|
187
|
+
});
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
const byTask = new Map<string, TaskAnalyticsRow>();
|
|
191
|
+
const byModel = new Map<string, ModelAnalyticsRow>();
|
|
192
|
+
const byError = new Map<string, ErrorAnalyticsRow>();
|
|
193
|
+
const cloneParent = new Map<string, string>();
|
|
194
|
+
for (const task of options.tasks ?? []) {
|
|
195
|
+
const parentId = task.matrixParentId?.trim();
|
|
196
|
+
if (parentId) cloneParent.set(task.name.toLowerCase(), parentId);
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
let totalsTotal = 0;
|
|
200
|
+
let totalsSuccess = 0;
|
|
201
|
+
let totalsError = 0;
|
|
202
|
+
let totalsPartial = 0;
|
|
203
|
+
let totalsTokens = 0;
|
|
204
|
+
let totalsCost = 0;
|
|
205
|
+
let durationsSum = 0;
|
|
206
|
+
let durationsCount = 0;
|
|
207
|
+
let recordsInWindow = 0;
|
|
208
|
+
const windowRecords: SavingsRecord[] = [];
|
|
209
|
+
|
|
210
|
+
for (const record of records) {
|
|
211
|
+
const date = recordDate(record);
|
|
212
|
+
if (!date) continue;
|
|
213
|
+
const bucket = dayBuckets.get(date);
|
|
214
|
+
// Итоги считаются только по окну — это «аналитика за период».
|
|
215
|
+
if (!bucket) continue;
|
|
216
|
+
recordsInWindow += 1;
|
|
217
|
+
|
|
218
|
+
const tokens = toNumber(record.tokens);
|
|
219
|
+
const cost = recordCost(record);
|
|
220
|
+
const status = String(record.status ?? "");
|
|
221
|
+
// Незавершённые запуски не участвуют в аналитике: их ещё нельзя оценить.
|
|
222
|
+
if (status === "running") continue;
|
|
223
|
+
windowRecords.push(record);
|
|
224
|
+
const duration = toNumber(record.durationMs);
|
|
225
|
+
|
|
226
|
+
bucket.total += 1;
|
|
227
|
+
bucket.tokens += tokens;
|
|
228
|
+
bucket.costUsd += cost;
|
|
229
|
+
if (status === "success") bucket.success += 1;
|
|
230
|
+
else if (status === "partial") bucket.partial += 1;
|
|
231
|
+
else bucket.error += 1;
|
|
232
|
+
if (duration > 0) {
|
|
233
|
+
bucket.avgDurationMs =
|
|
234
|
+
(bucket.avgDurationMs * (bucket.total - 1) + duration) / bucket.total;
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
totalsTotal += 1;
|
|
238
|
+
totalsTokens += tokens;
|
|
239
|
+
totalsCost += cost;
|
|
240
|
+
if (status === "success") totalsSuccess += 1;
|
|
241
|
+
else if (status === "partial") totalsPartial += 1;
|
|
242
|
+
else totalsError += 1;
|
|
243
|
+
if (duration > 0) {
|
|
244
|
+
durationsSum += duration;
|
|
245
|
+
durationsCount += 1;
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
const taskKey = record.taskName.toLowerCase();
|
|
249
|
+
const existing = byTask.get(taskKey) ?? {
|
|
250
|
+
taskName: record.taskName,
|
|
251
|
+
total: 0,
|
|
252
|
+
success: 0,
|
|
253
|
+
error: 0,
|
|
254
|
+
successRate: 0,
|
|
255
|
+
avgDurationMs: 0,
|
|
256
|
+
tokens: 0,
|
|
257
|
+
costUsd: 0,
|
|
258
|
+
isMatrixClone: cloneParent.has(taskKey),
|
|
259
|
+
matrixParentId: cloneParent.get(taskKey) ?? null,
|
|
260
|
+
};
|
|
261
|
+
existing.total += 1;
|
|
262
|
+
if (status === "success") existing.success += 1;
|
|
263
|
+
else existing.error += 1;
|
|
264
|
+
existing.tokens += tokens;
|
|
265
|
+
existing.costUsd += cost;
|
|
266
|
+
if (duration > 0) {
|
|
267
|
+
existing.avgDurationMs =
|
|
268
|
+
(existing.avgDurationMs * (existing.total - 1) + duration) / existing.total;
|
|
269
|
+
}
|
|
270
|
+
byTask.set(taskKey, existing);
|
|
271
|
+
|
|
272
|
+
const model = record.model?.trim() || "(default)";
|
|
273
|
+
const modelRow = byModel.get(model) ?? { model, total: 0, costUsd: 0 };
|
|
274
|
+
modelRow.total += 1;
|
|
275
|
+
modelRow.costUsd += cost;
|
|
276
|
+
byModel.set(model, modelRow);
|
|
277
|
+
|
|
278
|
+
// Топ ошибок: группируем по тексту, чтобы дайджест показывал частые причины.
|
|
279
|
+
if (status !== "success" && status !== "partial") {
|
|
280
|
+
const message =
|
|
281
|
+
typeof record.error === "string" && record.error.trim()
|
|
282
|
+
? record.error.trim().slice(0, 160)
|
|
283
|
+
: "(без текста)";
|
|
284
|
+
const errorRow = byError.get(message) ?? {
|
|
285
|
+
message,
|
|
286
|
+
count: 0,
|
|
287
|
+
lastAt: record.startedAt,
|
|
288
|
+
};
|
|
289
|
+
errorRow.count += 1;
|
|
290
|
+
if (
|
|
291
|
+
new Date(record.startedAt).getTime() >
|
|
292
|
+
new Date(errorRow.lastAt).getTime()
|
|
293
|
+
) {
|
|
294
|
+
errorRow.lastAt = record.startedAt;
|
|
295
|
+
}
|
|
296
|
+
byError.set(message, errorRow);
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
const tasks = [...byTask.values()]
|
|
301
|
+
.map((row) => ({
|
|
302
|
+
...row,
|
|
303
|
+
successRate: percent(row.success, row.total),
|
|
304
|
+
avgDurationMs: Math.round(row.avgDurationMs),
|
|
305
|
+
costUsd: Math.round(row.costUsd * 1e6) / 1e6,
|
|
306
|
+
}))
|
|
307
|
+
.sort((a, b) => b.total - a.total || a.taskName.localeCompare(b.taskName));
|
|
308
|
+
|
|
309
|
+
const matrices = new Map<string, MatrixAnalyticsRow>();
|
|
310
|
+
for (const row of tasks) {
|
|
311
|
+
if (!row.matrixParentId) continue;
|
|
312
|
+
const key = row.matrixParentId.toLowerCase();
|
|
313
|
+
const matrix = matrices.get(key) ?? {
|
|
314
|
+
parentId: row.matrixParentId,
|
|
315
|
+
clones: 0,
|
|
316
|
+
total: 0,
|
|
317
|
+
success: 0,
|
|
318
|
+
error: 0,
|
|
319
|
+
successRate: 0,
|
|
320
|
+
tokens: 0,
|
|
321
|
+
costUsd: 0,
|
|
322
|
+
};
|
|
323
|
+
matrix.clones += 1;
|
|
324
|
+
matrix.total += row.total;
|
|
325
|
+
matrix.success += row.success;
|
|
326
|
+
matrix.error += row.error;
|
|
327
|
+
matrix.tokens += row.tokens;
|
|
328
|
+
matrix.costUsd += row.costUsd;
|
|
329
|
+
matrices.set(key, matrix);
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
const daily = dayKeys.map((key) => {
|
|
333
|
+
const bucket = dayBuckets.get(key)!;
|
|
334
|
+
return {
|
|
335
|
+
...bucket,
|
|
336
|
+
avgDurationMs: Math.round(bucket.avgDurationMs),
|
|
337
|
+
costUsd: Math.round(bucket.costUsd * 1e6) / 1e6,
|
|
338
|
+
};
|
|
339
|
+
});
|
|
340
|
+
|
|
341
|
+
return {
|
|
342
|
+
generatedAt: new Date().toISOString(),
|
|
343
|
+
windowDays,
|
|
344
|
+
totals: {
|
|
345
|
+
total: totalsTotal,
|
|
346
|
+
success: totalsSuccess,
|
|
347
|
+
error: totalsError,
|
|
348
|
+
partial: totalsPartial,
|
|
349
|
+
successRate: percent(totalsSuccess, totalsTotal),
|
|
350
|
+
avgDurationMs: durationsCount > 0 ? Math.round(durationsSum / durationsCount) : 0,
|
|
351
|
+
tokens: totalsTokens,
|
|
352
|
+
costUsd: Math.round(totalsCost * 1e6) / 1e6,
|
|
353
|
+
},
|
|
354
|
+
daily,
|
|
355
|
+
tasks,
|
|
356
|
+
topByCost: [...tasks].sort((a, b) => b.costUsd - a.costUsd).slice(0, topLimit),
|
|
357
|
+
matrices: [...matrices.values()]
|
|
358
|
+
.map((row) => ({
|
|
359
|
+
...row,
|
|
360
|
+
successRate: percent(row.success, row.total),
|
|
361
|
+
costUsd: Math.round(row.costUsd * 1e6) / 1e6,
|
|
362
|
+
}))
|
|
363
|
+
.sort((a, b) => b.costUsd - a.costUsd),
|
|
364
|
+
byModel: [...byModel.values()]
|
|
365
|
+
.map((row) => ({ ...row, costUsd: Math.round(row.costUsd * 1e6) / 1e6 }))
|
|
366
|
+
.sort((a, b) => b.costUsd - a.costUsd),
|
|
367
|
+
errors: [...byError.values()]
|
|
368
|
+
.sort((a, b) => b.count - a.count || a.message.localeCompare(b.message))
|
|
369
|
+
.slice(0, topLimit),
|
|
370
|
+
savings: computeSavings(windowRecords, { topLimit }),
|
|
371
|
+
sources: {
|
|
372
|
+
historyRecords: records.length,
|
|
373
|
+
recordsInWindow,
|
|
374
|
+
topLimit,
|
|
375
|
+
},
|
|
376
|
+
};
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
/** Экранирование значения для CSV (RFC 4180). */
|
|
380
|
+
export function csvCell(value: unknown): string {
|
|
381
|
+
if (value === null || value === undefined) return "";
|
|
382
|
+
const text = String(value);
|
|
383
|
+
if (/[",\r\n;]/.test(text)) return `"${text.replace(/"/g, '""')}"`;
|
|
384
|
+
return text;
|
|
385
|
+
}
|
|
386
|
+
|
|
387
|
+
/** Заголовок CSV-экспорта истории. */
|
|
388
|
+
export const HISTORY_CSV_HEADER = [
|
|
389
|
+
"startedAt",
|
|
390
|
+
"finishedAt",
|
|
391
|
+
"taskName",
|
|
392
|
+
"status",
|
|
393
|
+
"durationMs",
|
|
394
|
+
"tokens",
|
|
395
|
+
"costUsd",
|
|
396
|
+
"model",
|
|
397
|
+
"workspaceId",
|
|
398
|
+
"error",
|
|
399
|
+
] as const;
|
|
400
|
+
|
|
401
|
+
/** История в CSV: точки с запятой как разделитель — дружелюбно к Excel (RU). */
|
|
402
|
+
export function historyToCsv(records: AnalyticsRecord[]): string {
|
|
403
|
+
const rows = [HISTORY_CSV_HEADER.join(";")];
|
|
404
|
+
for (const record of records) {
|
|
405
|
+
rows.push(
|
|
406
|
+
[
|
|
407
|
+
record.startedAt,
|
|
408
|
+
record.finishedAt ?? "",
|
|
409
|
+
record.taskName,
|
|
410
|
+
record.status,
|
|
411
|
+
record.durationMs ?? "",
|
|
412
|
+
record.tokens ?? "",
|
|
413
|
+
record.costUsd ?? "",
|
|
414
|
+
record.model ?? "",
|
|
415
|
+
record.workspaceId ?? "",
|
|
416
|
+
record.error ?? "",
|
|
417
|
+
]
|
|
418
|
+
.map(csvCell)
|
|
419
|
+
.join(";")
|
|
420
|
+
);
|
|
421
|
+
}
|
|
422
|
+
// BOM, чтобы Excel корректно открыл UTF-8 с кириллицей.
|
|
423
|
+
return `\uFEFF${rows.join("\r\n")}`;
|
|
424
|
+
}
|