opencode-windows-scheduler 1.0.0 → 1.1.0

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 CHANGED
@@ -4,6 +4,12 @@ All notable changes to this project are documented here. Format follows [Keep a
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ### Planned
8
+
9
+ - One-shot scheduling, session continuity, guards, worktree isolation, declarative job files.
10
+
11
+ ## [1.1.0] - 2026-11-13
12
+
7
13
  ### Added
8
14
 
9
15
  - **Full agent parity:** `schedule_task` now accepts `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`, `nextTaskOnSuccess`, `nextTaskOnError` and the complete matrix configuration (`concurrency`, `overrides`).
@@ -13,13 +19,13 @@ All notable changes to this project are documented here. Format follows [Keep a
13
19
  - `update_task` keeps every field that is not passed, so the agent can change one setting without resending the whole task.
14
20
  - **Built-in agent skill** `scheduled-job-best-practices`, registered by the plugin itself: guidance on schedule design, prompt structure, safety defaults, matrix concurrency, DAG rules and failure diagnosis, plus `references/recipes.md` with seven complete examples. No manual `.opencode/skills` setup.
15
21
  - **Documentation:** `docs/ARCHITECTURE.md` (process model, modules, backends, data model, security model), `docs/FEATURES.md` (full feature catalog with examples and limits) and `docs/MIGRATION.md` (from cron, systemd timers, launchd and Windows Task Scheduler), linked from both READMEs.
16
- - `test-docs.mjs` — 30 checks that the guides exist, stay complete and ship in the npm package.
17
-
18
- ### Planned
19
-
20
- - One-shot scheduling, session continuity, guards, worktree isolation, declarative job files.
22
+ - `test-docs.mjs` - 30 checks that the guides exist, stay complete and ship in the npm package.
23
+ - **History retention:** `history.retentionDays` (default 30) and `history.maxRecords` (default 5000) in settings (`0` disables either limit); daily auto-cleanup on plugin start plus `PRAGMA incremental_vacuum`; `cleanup_history` RPC and a «🧹 История и ретеншн» panel in the GUI with last-cleanup stats and an «Очистить сейчас» button.
24
+ - **14-day analytics:** `get_analytics` RPC and `GET /api/analytics` (runs, success rate, tokens, cost per day/task/model/matrix); dashboard «📊 Аналитика за период» block (KPIs, daily bar chart, top tasks by cost, matrices); history export to CSV/JSON (`GET /api/history/export?format=csv|json`) — `recordCost` falls back to a token-based estimate when `costUsd` is missing.
25
+ - **`/api/health`** now reports `version` (from package.json), `scheduler` (backend title), `queueDepth` (unfinished runs) and `db` status.
26
+ - `test-retention.mjs` - 19 checks; `test-metrics.mjs` - 25 checks; both wired into `npm test`.
21
27
 
22
- ## [1.0.0] — 2026-11-13
28
+ ## [1.0.0] - 2026-11-13
23
29
 
24
30
  First public release.
25
31
 
@@ -41,5 +47,6 @@ First public release.
41
47
  - Deleting a matrix parent deletes its family, but deleting a workspace does not touch existing matrix jobs.
42
48
  - Agent tools cover a subset of the RPC surface (see roadmap item 0.4).
43
49
 
44
- [Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.0.0...HEAD
50
+ [Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.1.0...HEAD
51
+ [1.1.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.0.0...v1.1.0
45
52
  [1.0.0]: https://github.com/DeadSno/opencode-windows-scheduler/releases/tag/v1.0.0
package/README.md CHANGED
@@ -37,7 +37,7 @@ Want to see it without installing OpenCode? `node scripts/demo-dashboard.mjs` st
37
37
  | Orchestration | `dependsOn` DAG, `nextTaskOnSuccess` / `nextTaskOnError` chains, matrix fan-out (parallel/sequential, `continue`/`stop`, concurrency, per-workspace overrides, aggregator task) |
38
38
  | Triggers | cron, file change (chokidar), MCP events |
39
39
  | Multi-repo | workspaces with path validation, per-workspace runs, matrix over one parent task |
40
- | Observability | SQLite history (success / error / timeout / partial / running), metrics (duration, tokens, cost), per-task logs, local web dashboard |
40
+ | Observability | SQLite history (success / error / timeout / partial / running), metrics (duration, tokens, cost), per-task logs, local web dashboard with 14-day analytics, history retention (age and size limits) and CSV/JSON export |
41
41
  | Operations | dry-run preview, export/import JSON, templates, webhook notifications, settings |
42
42
  | Interfaces | OpenCode GUI panel, web dashboard, 12 agent tools, built-in agent skill |
43
43
 
@@ -153,7 +153,7 @@ Job wrappers run `opencode run` in the task working directory, so project MCP se
153
153
  npm install
154
154
  npm run build # tsc
155
155
  npm run build:gui # vite
156
- npm test # 11 test suites, 200+ checks
156
+ npm test # 13 test suites, 300+ checks
157
157
  ```
158
158
 
159
159
  See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
package/README.ru.md CHANGED
@@ -28,7 +28,7 @@ English version: [README.md](README.md).
28
28
  | Оркестрация | DAG `dependsOn`, цепочки success/error, матрицы (parallel/sequential, continue/stop, concurrency, overrides, агрегатор) |
29
29
  | Триггеры | cron, изменение файла (chokidar), MCP-события |
30
30
  | Мультирепо | workspaces с валидацией путей, запуск по workspace, матрица поверх родительской задачи |
31
- | Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики, логи, веб-дашборд |
31
+ | Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики (длительность, токены, стоимость), логи, веб-дашборд: аналитика за 14 дней, ретеншн истории (лимиты по возрасту и размеру), экспорт CSV/JSON |
32
32
  | Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, webhook-уведомления, настройки |
33
33
  | Интерфейсы | панель OpenCode GUI, веб-дашборд, 12 инструментов для агента, встроенный скилл |
34
34
 
@@ -108,7 +108,7 @@ npm run build:gui # gui-experimental.cjs
108
108
  ```bash
109
109
  npm run build # tsc: серверная часть плагина
110
110
  npm run build:gui # vite: GUI-бандл gui-experimental.cjs
111
- npm test # 11 сюит, 200+ проверок
111
+ npm test # 13 сюит, 300+ проверок
112
112
  ```
113
113
 
114
114
  ## Документация
package/ROADMAP.md CHANGED
@@ -18,8 +18,10 @@
18
18
  | 14 | Экспорт/импорт задач, шаблоны | `src/task-transfer.ts`, `src/templates.ts` |
19
19
  | 15 | Matrix Builds (fan-out): клоны по workspace, parallel/sequential, failureMode, агрегация, DAG | `src/core/matrix.ts`, `SPRINT15` в истории |
20
20
  | 16 | Lifecycle матриц: каскадное удаление, отмена, чистка сирот, guard на удаление клона | `src/core/matrix.ts`, `test-matrix-lifecycle.mjs` |
21
+ | 17 | Синхронизация матриц (`syncMatrixFamily`) + per-workspace overrides + concurrency | `src/core/matrix.ts`, `SPRINT17` (отчёт не писался) |
22
+ | 18 | Ретеншн истории (30 дней / 5000 записей), аналитика за 14 дней, CSV/JSON-экспорт, `/api/health` | `SPRINT18.md` |
21
23
 
22
- ## Спринт 17 — Синхронизация матриц + per-workspace настройки ⬅️ СЛЕДУЮЩИЙ
24
+ ## Спринт 17 — Синхронизация матриц + per-workspace настройки ✅ Готово
23
25
 
24
26
  **Проблема:** после создания матрицы изменение `matrix.workspaceIds` (или промпта/хуков) в `update_task`/GUI не пересоздаёт клонов — семья рассинхронизируется, появляются устаревшие клоны. Плюс нельзя задать клону отличия от родителя (свой промпт, модель, QG).
25
27
 
@@ -42,15 +44,16 @@
42
44
 
43
45
  **Ограничения на потом:** история удалённых при синхронизации клонов остаётся (чистится ретеншном — Спринт 18).
44
46
 
45
- ## Спринт 18 — Ретеншн истории и аналитика
47
+ ## Спринт 18 — Ретеншн истории и аналитика ✅ Готово
46
48
 
47
- 1. Настройки ретеншна: `history.retentionDays`, `history.maxRecords`, ежедневная автоочистка + `PRAGMA incremental_vacuum`.
48
- 2. RPC/CLI: `cleanup_history`, `get_metrics` (агрегаты по задачам/матрицам: запуски, success rate, средняя длительность, токены, стоимость).
49
- 3. Дашборд: вкладка «📊 Аналитика» (топ задач по стоимости, success rate, график по дням), экспорт истории в CSV/JSON.
50
- 4. `/api/health` для внешнего мониторинга (БД, планировщик, осиротевшие задачи).
51
- 5. Тесты: `test-retention.mjs`, `test-metrics.mjs`.
49
+ Отчёт: `SPRINT18.md`. По факту:
50
+ 1. Настройки `history.retentionDays` / `history.maxRecords` в settings.json (дефолт 30 дней / 5000 записей, 0 — выкл.), автоочистка раз в сутки при старте плагина + `PRAGMA incremental_vacuum`; ручная кнопка «🧹 Очистить сейчас» и RPC `cleanup_history`. GUI: сворачиваемая секция «🧹 История и ретеншн».
51
+ 2. RPC: `cleanup_history` + отдельный `get_analytics` (`days` 1..365, `topLimit >= 1`): агрегаты по дням/задачам/моделям/матрицам, success rate, токены, стоимость. All-time RPC `get_metrics` оставлен как был — отдельное имя, см. SPRINT18.md (расхождение с этим пунктом).
52
+ 3. Дашборд: блок «📊 Аналитика за период» (KPI, график по дням, топ задач по стоимости, матрицы), экспорт истории в CSV/JSON (`/api/history/export?format=csv|json`).
53
+ 4. `/api/health`: `version` (из package.json), `scheduler`, `queueDepth` (незавершённые запуски), `db` (`getDbStatus()`). Статистику осиротевших задач health не отдаёт — сироты остаются в матричных инструментах (`matrix_control`).
54
+ 5. Тесты: `test-retention.mjs` (19 проверок) + `test-metrics.mjs` (25 проверок), оба в цепочке `npm test`.
52
55
 
53
- ## Спринт 19 — Планирование 2.0
56
+ ## Спринт 19 — Планирование 2.0 ⬅️ СЛЕДУЮЩИЙ
54
57
 
55
58
  1. `timezone` на задачу (IANA), корректный пересчёт cron → schtasks и в dry-run.
56
59
  2. Окна запуска: `notBefore` / `notAfter` (например, деплой только 22:00–06:00) — перенос запуска, а не пропуск.
@@ -0,0 +1,119 @@
1
+ /**
2
+ * Аналитика по истории запусков (Спринт 18).
3
+ *
4
+ * Чистые функции без БД и HTTP: дашборд и RPC отдают JSON, экспорт — CSV.
5
+ * Так агрегаты легко тестировать без запуска сервера.
6
+ */
7
+ /** Оценка стоимости, если запись истории не содержит costUsd. */
8
+ export declare const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
9
+ /** Минимальный вид записи истории, нужный аналитике. */
10
+ export interface AnalyticsRecord {
11
+ taskName: string;
12
+ status: string;
13
+ startedAt: string;
14
+ finishedAt?: string | null;
15
+ durationMs?: number | null;
16
+ error?: string | null;
17
+ tokens?: number;
18
+ costUsd?: number;
19
+ model?: string;
20
+ workspaceId?: string | null;
21
+ }
22
+ /** Описание задачи для группировки по матрицам. */
23
+ export interface AnalyticsTaskRef {
24
+ name: string;
25
+ matrixParentId?: string | null;
26
+ }
27
+ export interface DailyBucket {
28
+ /** YYYY-MM-DD (UTC). */
29
+ date: string;
30
+ total: number;
31
+ success: number;
32
+ error: number;
33
+ partial: number;
34
+ tokens: number;
35
+ costUsd: number;
36
+ avgDurationMs: number;
37
+ }
38
+ export interface TaskAnalyticsRow {
39
+ taskName: string;
40
+ total: number;
41
+ success: number;
42
+ error: number;
43
+ /** Процент успешных запусков (0..100, один знак после запятой). */
44
+ successRate: number;
45
+ avgDurationMs: number;
46
+ tokens: number;
47
+ costUsd: number;
48
+ /** Задача — клон матрицы (matrixParentId задан). */
49
+ isMatrixClone: boolean;
50
+ matrixParentId: string | null;
51
+ }
52
+ export interface MatrixAnalyticsRow {
53
+ parentId: string;
54
+ clones: number;
55
+ total: number;
56
+ success: number;
57
+ error: number;
58
+ successRate: number;
59
+ tokens: number;
60
+ costUsd: number;
61
+ }
62
+ export interface ModelAnalyticsRow {
63
+ model: string;
64
+ total: number;
65
+ costUsd: number;
66
+ }
67
+ export interface AnalyticsReport {
68
+ generatedAt: string;
69
+ /** Окно анализа в днях. */
70
+ windowDays: number;
71
+ totals: {
72
+ total: number;
73
+ success: number;
74
+ error: number;
75
+ partial: number;
76
+ successRate: number;
77
+ avgDurationMs: number;
78
+ tokens: number;
79
+ costUsd: number;
80
+ };
81
+ daily: DailyBucket[];
82
+ tasks: TaskAnalyticsRow[];
83
+ topByCost: TaskAnalyticsRow[];
84
+ matrices: MatrixAnalyticsRow[];
85
+ byModel: ModelAnalyticsRow[];
86
+ sources: {
87
+ historyRecords: number;
88
+ /** Сколько записей попало в окно. */
89
+ recordsInWindow: number;
90
+ /** Ограничение по количеству строк в топах. */
91
+ topLimit: number;
92
+ };
93
+ }
94
+ export interface BuildAnalyticsOptions {
95
+ /** Окно анализа в днях (по умолчанию 14). */
96
+ days?: number;
97
+ /** Опорный момент (для тестов). */
98
+ now?: Date;
99
+ /** Сколько строк оставлять в топах (по умолчанию 10). */
100
+ topLimit?: number;
101
+ /** Известные задачи — нужны для группировки матриц. */
102
+ tasks?: AnalyticsTaskRef[];
103
+ }
104
+ /** Стоимость записи: явная цена, иначе оценка по токенам. */
105
+ export declare function recordCost(record: AnalyticsRecord): number;
106
+ /** Дата записи в UTC-формате YYYY-MM-DD. */
107
+ export declare function recordDate(record: AnalyticsRecord): string;
108
+ /**
109
+ * Строит отчёт по истории: итоги, дневные бакеты, разбивка по задачам,
110
+ * матрицам и моделям.
111
+ */
112
+ export declare function buildAnalytics(records: AnalyticsRecord[], options?: BuildAnalyticsOptions): AnalyticsReport;
113
+ /** Экранирование значения для CSV (RFC 4180). */
114
+ export declare function csvCell(value: unknown): string;
115
+ /** Заголовок CSV-экспорта истории. */
116
+ export declare const HISTORY_CSV_HEADER: readonly ["startedAt", "finishedAt", "taskName", "status", "durationMs", "tokens", "costUsd", "model", "workspaceId", "error"];
117
+ /** История в CSV: точки с запятой как разделитель — дружелюбно к Excel (RU). */
118
+ export declare function historyToCsv(records: AnalyticsRecord[]): string;
119
+ //# sourceMappingURL=analytics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,265 @@
1
+ /**
2
+ * Аналитика по истории запусков (Спринт 18).
3
+ *
4
+ * Чистые функции без БД и HTTP: дашборд и RPC отдают JSON, экспорт — CSV.
5
+ * Так агрегаты легко тестировать без запуска сервера.
6
+ */
7
+ /** Оценка стоимости, если запись истории не содержит costUsd. */
8
+ export const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
9
+ function toNumber(value) {
10
+ const n = Number(value);
11
+ return Number.isFinite(n) && n > 0 ? n : 0;
12
+ }
13
+ /** Стоимость записи: явная цена, иначе оценка по токенам. */
14
+ export function recordCost(record) {
15
+ const cost = toNumber(record.costUsd);
16
+ if (cost > 0)
17
+ return cost;
18
+ const tokens = toNumber(record.tokens);
19
+ return tokens > 0 ? (tokens / 1000) * ESTIMATED_COST_PER_1K_TOKENS_USD : 0;
20
+ }
21
+ /** Дата записи в UTC-формате YYYY-MM-DD. */
22
+ export function recordDate(record) {
23
+ const time = new Date(record.startedAt).getTime();
24
+ if (!Number.isFinite(time))
25
+ return "";
26
+ return new Date(time).toISOString().slice(0, 10);
27
+ }
28
+ function utcDayKey(date) {
29
+ return date.toISOString().slice(0, 10);
30
+ }
31
+ function percent(part, total) {
32
+ if (total <= 0)
33
+ return 0;
34
+ return Math.round((part / total) * 1000) / 10;
35
+ }
36
+ /**
37
+ * Строит отчёт по истории: итоги, дневные бакеты, разбивка по задачам,
38
+ * матрицам и моделям.
39
+ */
40
+ export function buildAnalytics(records, options = {}) {
41
+ const windowDays = Math.max(1, Math.floor(options.days ?? 14));
42
+ const topLimit = Math.max(1, Math.floor(options.topLimit ?? 10));
43
+ const now = options.now ?? new Date();
44
+ const dayKeys = [];
45
+ const dayBuckets = new Map();
46
+ for (let i = windowDays - 1; i >= 0; i -= 1) {
47
+ const key = utcDayKey(new Date(now.getTime() - i * 24 * 60 * 60 * 1000));
48
+ dayKeys.push(key);
49
+ dayBuckets.set(key, {
50
+ date: key,
51
+ total: 0,
52
+ success: 0,
53
+ error: 0,
54
+ partial: 0,
55
+ tokens: 0,
56
+ costUsd: 0,
57
+ avgDurationMs: 0,
58
+ });
59
+ }
60
+ const byTask = new Map();
61
+ const byModel = new Map();
62
+ const cloneParent = new Map();
63
+ for (const task of options.tasks ?? []) {
64
+ const parentId = task.matrixParentId?.trim();
65
+ if (parentId)
66
+ cloneParent.set(task.name.toLowerCase(), parentId);
67
+ }
68
+ let totalsTotal = 0;
69
+ let totalsSuccess = 0;
70
+ let totalsError = 0;
71
+ let totalsPartial = 0;
72
+ let totalsTokens = 0;
73
+ let totalsCost = 0;
74
+ let durationsSum = 0;
75
+ let durationsCount = 0;
76
+ let recordsInWindow = 0;
77
+ for (const record of records) {
78
+ const date = recordDate(record);
79
+ if (!date)
80
+ continue;
81
+ const bucket = dayBuckets.get(date);
82
+ // Итоги считаются только по окну — это «аналитика за период».
83
+ if (!bucket)
84
+ continue;
85
+ recordsInWindow += 1;
86
+ const tokens = toNumber(record.tokens);
87
+ const cost = recordCost(record);
88
+ const status = String(record.status ?? "");
89
+ // Незавершённые запуски не участвуют в аналитике: их ещё нельзя оценить.
90
+ if (status === "running")
91
+ continue;
92
+ const duration = toNumber(record.durationMs);
93
+ bucket.total += 1;
94
+ bucket.tokens += tokens;
95
+ bucket.costUsd += cost;
96
+ if (status === "success")
97
+ bucket.success += 1;
98
+ else if (status === "partial")
99
+ bucket.partial += 1;
100
+ else
101
+ bucket.error += 1;
102
+ if (duration > 0) {
103
+ bucket.avgDurationMs =
104
+ (bucket.avgDurationMs * (bucket.total - 1) + duration) / bucket.total;
105
+ }
106
+ totalsTotal += 1;
107
+ totalsTokens += tokens;
108
+ totalsCost += cost;
109
+ if (status === "success")
110
+ totalsSuccess += 1;
111
+ else if (status === "partial")
112
+ totalsPartial += 1;
113
+ else
114
+ totalsError += 1;
115
+ if (duration > 0) {
116
+ durationsSum += duration;
117
+ durationsCount += 1;
118
+ }
119
+ const taskKey = record.taskName.toLowerCase();
120
+ const existing = byTask.get(taskKey) ?? {
121
+ taskName: record.taskName,
122
+ total: 0,
123
+ success: 0,
124
+ error: 0,
125
+ successRate: 0,
126
+ avgDurationMs: 0,
127
+ tokens: 0,
128
+ costUsd: 0,
129
+ isMatrixClone: cloneParent.has(taskKey),
130
+ matrixParentId: cloneParent.get(taskKey) ?? null,
131
+ };
132
+ existing.total += 1;
133
+ if (status === "success")
134
+ existing.success += 1;
135
+ else
136
+ existing.error += 1;
137
+ existing.tokens += tokens;
138
+ existing.costUsd += cost;
139
+ if (duration > 0) {
140
+ existing.avgDurationMs =
141
+ (existing.avgDurationMs * (existing.total - 1) + duration) / existing.total;
142
+ }
143
+ byTask.set(taskKey, existing);
144
+ const model = record.model?.trim() || "(default)";
145
+ const modelRow = byModel.get(model) ?? { model, total: 0, costUsd: 0 };
146
+ modelRow.total += 1;
147
+ modelRow.costUsd += cost;
148
+ byModel.set(model, modelRow);
149
+ }
150
+ const tasks = [...byTask.values()]
151
+ .map((row) => ({
152
+ ...row,
153
+ successRate: percent(row.success, row.total),
154
+ avgDurationMs: Math.round(row.avgDurationMs),
155
+ costUsd: Math.round(row.costUsd * 1e6) / 1e6,
156
+ }))
157
+ .sort((a, b) => b.total - a.total || a.taskName.localeCompare(b.taskName));
158
+ const matrices = new Map();
159
+ for (const row of tasks) {
160
+ if (!row.matrixParentId)
161
+ continue;
162
+ const key = row.matrixParentId.toLowerCase();
163
+ const matrix = matrices.get(key) ?? {
164
+ parentId: row.matrixParentId,
165
+ clones: 0,
166
+ total: 0,
167
+ success: 0,
168
+ error: 0,
169
+ successRate: 0,
170
+ tokens: 0,
171
+ costUsd: 0,
172
+ };
173
+ matrix.clones += 1;
174
+ matrix.total += row.total;
175
+ matrix.success += row.success;
176
+ matrix.error += row.error;
177
+ matrix.tokens += row.tokens;
178
+ matrix.costUsd += row.costUsd;
179
+ matrices.set(key, matrix);
180
+ }
181
+ const daily = dayKeys.map((key) => {
182
+ const bucket = dayBuckets.get(key);
183
+ return {
184
+ ...bucket,
185
+ avgDurationMs: Math.round(bucket.avgDurationMs),
186
+ costUsd: Math.round(bucket.costUsd * 1e6) / 1e6,
187
+ };
188
+ });
189
+ return {
190
+ generatedAt: new Date().toISOString(),
191
+ windowDays,
192
+ totals: {
193
+ total: totalsTotal,
194
+ success: totalsSuccess,
195
+ error: totalsError,
196
+ partial: totalsPartial,
197
+ successRate: percent(totalsSuccess, totalsTotal),
198
+ avgDurationMs: durationsCount > 0 ? Math.round(durationsSum / durationsCount) : 0,
199
+ tokens: totalsTokens,
200
+ costUsd: Math.round(totalsCost * 1e6) / 1e6,
201
+ },
202
+ daily,
203
+ tasks,
204
+ topByCost: [...tasks].sort((a, b) => b.costUsd - a.costUsd).slice(0, topLimit),
205
+ matrices: [...matrices.values()]
206
+ .map((row) => ({
207
+ ...row,
208
+ successRate: percent(row.success, row.total),
209
+ costUsd: Math.round(row.costUsd * 1e6) / 1e6,
210
+ }))
211
+ .sort((a, b) => b.costUsd - a.costUsd),
212
+ byModel: [...byModel.values()]
213
+ .map((row) => ({ ...row, costUsd: Math.round(row.costUsd * 1e6) / 1e6 }))
214
+ .sort((a, b) => b.costUsd - a.costUsd),
215
+ sources: {
216
+ historyRecords: records.length,
217
+ recordsInWindow,
218
+ topLimit,
219
+ },
220
+ };
221
+ }
222
+ /** Экранирование значения для CSV (RFC 4180). */
223
+ export function csvCell(value) {
224
+ if (value === null || value === undefined)
225
+ return "";
226
+ const text = String(value);
227
+ if (/[",\r\n;]/.test(text))
228
+ return `"${text.replace(/"/g, '""')}"`;
229
+ return text;
230
+ }
231
+ /** Заголовок CSV-экспорта истории. */
232
+ export const HISTORY_CSV_HEADER = [
233
+ "startedAt",
234
+ "finishedAt",
235
+ "taskName",
236
+ "status",
237
+ "durationMs",
238
+ "tokens",
239
+ "costUsd",
240
+ "model",
241
+ "workspaceId",
242
+ "error",
243
+ ];
244
+ /** История в CSV: точки с запятой как разделитель — дружелюбно к Excel (RU). */
245
+ export function historyToCsv(records) {
246
+ const rows = [HISTORY_CSV_HEADER.join(";")];
247
+ for (const record of records) {
248
+ rows.push([
249
+ record.startedAt,
250
+ record.finishedAt ?? "",
251
+ record.taskName,
252
+ record.status,
253
+ record.durationMs ?? "",
254
+ record.tokens ?? "",
255
+ record.costUsd ?? "",
256
+ record.model ?? "",
257
+ record.workspaceId ?? "",
258
+ record.error ?? "",
259
+ ]
260
+ .map(csvCell)
261
+ .join(";"));
262
+ }
263
+ // BOM, чтобы Excel корректно открыл UTF-8 с кириллицей.
264
+ return `\uFEFF${rows.join("\r\n")}`;
265
+ }
@@ -0,0 +1,29 @@
1
+ import { type PruneHistoryResult } from "../db/history-repo.js";
2
+ /** Период автоочистки: раз в сутки. */
3
+ export declare const CLEANUP_INTERVAL_MS: number;
4
+ /** Переопределения лимитов для одного прогона `cleanup_history`. */
5
+ export interface RetentionOverrides {
6
+ retentionDays?: number;
7
+ maxRecords?: number;
8
+ }
9
+ export interface RetentionReport extends PruneHistoryResult {
10
+ retentionDays: number;
11
+ maxRecords: number;
12
+ /** Удалось ли выполнить PRAGMA incremental_vacuum. */
13
+ vacuumed: boolean;
14
+ /** Причина, по которой очистка пропущена (лимиты выключены). */
15
+ skipped: string | null;
16
+ ranAt: string;
17
+ }
18
+ /**
19
+ * Выполняет очистку истории по текущим настройкам.
20
+ * Переопределения (если переданы) сохраняются в settings.json — так
21
+ * `cleanup_history` заодно настраивает ретеншн.
22
+ */
23
+ export declare function runHistoryRetention(overrides?: RetentionOverrides): Promise<RetentionReport>;
24
+ /**
25
+ * Автоочистка при старте плагина: не чаще одного раза в сутки.
26
+ * `force` игнорирует интервал (используется в тестах).
27
+ */
28
+ export declare function maybeRunHistoryRetention(force?: boolean): Promise<RetentionReport | undefined>;
29
+ //# sourceMappingURL=retention.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/core/retention.ts"],"names":[],"mappings":"AAiBA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,QAAsB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAsBD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,GAAE,kBAAuB,GACjC,OAAO,CAAC,eAAe,CAAC,CAoD1B;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,UAAQ,GACZ,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAUtC"}
@@ -0,0 +1,98 @@
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 { defaultHistorySettings, loadSettings, saveSettings, } from "../settings.js";
13
+ import { countHistory, pruneHistory, vacuumHistory, } from "../db/history-repo.js";
14
+ /** Период автоочистки: раз в сутки. */
15
+ export const CLEANUP_INTERVAL_MS = 24 * 60 * 60 * 1000;
16
+ /** Приводит переопределение к безопасному целому (>= 0) или undefined. */
17
+ function normalizeOverride(value) {
18
+ if (value === undefined || value === null)
19
+ return undefined;
20
+ const n = Number(value);
21
+ if (!Number.isFinite(n))
22
+ return undefined;
23
+ const int = Math.floor(n);
24
+ return int >= 0 ? int : undefined;
25
+ }
26
+ function effectiveLimits(settings, overrides) {
27
+ return {
28
+ retentionDays: normalizeOverride(overrides.retentionDays) ?? settings.retentionDays,
29
+ maxRecords: normalizeOverride(overrides.maxRecords) ?? settings.maxRecords,
30
+ };
31
+ }
32
+ /**
33
+ * Выполняет очистку истории по текущим настройкам.
34
+ * Переопределения (если переданы) сохраняются в settings.json — так
35
+ * `cleanup_history` заодно настраивает ретеншн.
36
+ */
37
+ export async function runHistoryRetention(overrides = {}) {
38
+ const settings = await loadSettings();
39
+ const base = settings.history ?? defaultHistorySettings();
40
+ const limits = effectiveLimits(base, overrides);
41
+ const ranAt = new Date().toISOString();
42
+ const shouldPersistLimits = normalizeOverride(overrides.retentionDays) !== undefined ||
43
+ normalizeOverride(overrides.maxRecords) !== undefined;
44
+ if (limits.retentionDays === 0 && limits.maxRecords === 0) {
45
+ const report = {
46
+ deletedByAge: 0,
47
+ deletedByCount: 0,
48
+ deleted: 0,
49
+ kept: countHistory(),
50
+ cutoff: null,
51
+ retentionDays: 0,
52
+ maxRecords: 0,
53
+ vacuumed: false,
54
+ skipped: "Ретеншн выключен: history.retentionDays и history.maxRecords равны 0.",
55
+ ranAt,
56
+ };
57
+ if (shouldPersistLimits) {
58
+ await saveSettings({ history: { ...base, ...limits, lastCleanupAt: ranAt, lastCleanupDeleted: 0 } });
59
+ }
60
+ return report;
61
+ }
62
+ const pruned = pruneHistory({
63
+ retentionDays: limits.retentionDays,
64
+ maxRecords: limits.maxRecords,
65
+ });
66
+ const vacuumed = pruned.deleted > 0 ? vacuumHistory() : false;
67
+ await saveSettings({
68
+ history: {
69
+ ...base,
70
+ ...limits,
71
+ lastCleanupAt: ranAt,
72
+ lastCleanupDeleted: pruned.deleted,
73
+ },
74
+ });
75
+ return {
76
+ ...pruned,
77
+ retentionDays: limits.retentionDays,
78
+ maxRecords: limits.maxRecords,
79
+ vacuumed,
80
+ skipped: null,
81
+ ranAt,
82
+ };
83
+ }
84
+ /**
85
+ * Автоочистка при старте плагина: не чаще одного раза в сутки.
86
+ * `force` игнорирует интервал (используется в тестах).
87
+ */
88
+ export async function maybeRunHistoryRetention(force = false) {
89
+ const settings = await loadSettings();
90
+ const history = settings.history ?? defaultHistorySettings();
91
+ if (!force && history.lastCleanupAt) {
92
+ const last = new Date(history.lastCleanupAt).getTime();
93
+ if (Number.isFinite(last) && Date.now() - last < CLEANUP_INTERVAL_MS) {
94
+ return undefined;
95
+ }
96
+ }
97
+ return await runHistoryRetention();
98
+ }