opencode-windows-scheduler 0.0.0-stage → 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 +52 -0
- package/CROSS_PLATFORM.md +113 -0
- package/LICENSE +21 -0
- package/README.md +173 -2
- package/README.ru.md +131 -0
- package/ROADMAP-STRATEGY.md +217 -0
- package/ROADMAP.md +90 -0
- package/dist/core/analytics.d.ts +119 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +265 -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 +233 -0
- package/dist/core/dry-run.d.ts +44 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +252 -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 +128 -0
- package/dist/core/lock.d.ts +43 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +118 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +687 -0
- package/dist/core/ps-wrapper.d.ts +60 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +538 -0
- package/dist/core/record-history.d.ts +14 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +360 -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/scheduler/index.d.ts +20 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +32 -0
- package/dist/core/scheduler/linux.d.ts +32 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +115 -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 +39 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +175 -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 +86 -0
- package/dist/core/scheduler/registry.d.ts +36 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +56 -0
- package/dist/core/scheduler/types.d.ts +63 -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 +47 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +375 -0
- package/dist/core/wrappers/bash.d.ts +58 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +223 -0
- package/dist/db/history-repo.d.ts +102 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +215 -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 +43 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +95 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +237 -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 +97 -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 +53 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +57 -0
- package/dist/index.d.ts +156 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2159 -0
- package/dist/notifications.d.ts +45 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +135 -0
- package/dist/rpc.d.ts +2186 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +924 -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 +106 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +1668 -0
- package/dist/settings.d.ts +66 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +137 -0
- package/dist/shared/jobs-view.d.ts +21 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +28 -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 +176 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +442 -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 +78 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +88 -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 +55 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +183 -0
- package/docs/ARCHITECTURE.md +314 -0
- package/docs/FEATURES.md +300 -0
- package/docs/MIGRATION.md +266 -0
- package/docs/dashboard.png +0 -0
- package/gui-experimental.cjs +2 -0
- package/index.js +1 -0
- package/package.json +94 -4
- package/scripts/demo-dashboard.mjs +199 -0
- package/skills/scheduled-job-best-practices/SKILL.md +155 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +123 -0
- package/src/core/analytics.ts +378 -0
- package/src/core/cron-to-schtasks.ts +269 -0
- package/src/core/dry-run.ts +315 -0
- package/src/core/file-watcher.ts +171 -0
- package/src/core/lock.ts +134 -0
- package/src/core/matrix.ts +907 -0
- package/src/core/ps-wrapper.ts +572 -0
- package/src/core/record-history.ts +493 -0
- package/src/core/retention.ts +141 -0
- package/src/core/scheduler/index.ts +44 -0
- package/src/core/scheduler/linux.ts +125 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +222 -0
- package/src/core/scheduler/posix.ts +111 -0
- package/src/core/scheduler/registry.ts +93 -0
- package/src/core/scheduler/types.ts +67 -0
- package/src/core/scheduler/windows.ts +469 -0
- package/src/core/wrappers/bash.ts +282 -0
- package/src/db/history-repo.ts +396 -0
- package/src/db/index.ts +166 -0
- package/src/db/metrics-repo.ts +158 -0
- package/src/db/migrate.ts +322 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/schema.ts +109 -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 +2868 -0
- package/src/history.ts +107 -0
- package/src/index.ts +2768 -0
- package/src/notifications.ts +174 -0
- package/src/rpc.ts +999 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +1879 -0
- package/src/settings.ts +228 -0
- package/src/shared/jobs-view.ts +38 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +648 -0
- package/src/templates.ts +67 -0
- package/src/tui.tsx +46 -0
- package/src/types.ts +145 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +236 -0
|
@@ -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,20 @@
|
|
|
1
|
+
import type { CronConversion } from "../types.js";
|
|
2
|
+
/**
|
|
3
|
+
* Валидирует и преобразует 5-полевое cron-выражение во флаги schtasks.
|
|
4
|
+
* Возвращает CronConversion или выбрасывает Error с понятным сообщением.
|
|
5
|
+
*/
|
|
6
|
+
export declare function convertCronToSchTasks(cron: string): CronConversion;
|
|
7
|
+
/**
|
|
8
|
+
* Вычисляет ближайшее прошедшее (<= now) время срабатывания для поддерживаемых
|
|
9
|
+
* cron-выражений. Нужно для восстановления пропущенных запусков (catch-up):
|
|
10
|
+
* сравнивая это время с историей, можно понять, выполнялась ли задача.
|
|
11
|
+
*
|
|
12
|
+
* Возвращает null, если выражение не поддерживается или не распознано.
|
|
13
|
+
*/
|
|
14
|
+
export declare function previousRunTime(cron: string, now?: Date): Date | null;
|
|
15
|
+
/**
|
|
16
|
+
* Формирует массив флагов расписания для schtasks на основе CronConversion.
|
|
17
|
+
* Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
|
|
18
|
+
*/
|
|
19
|
+
export declare function buildScheduleFlags(conversion: CronConversion): string[];
|
|
20
|
+
//# sourceMappingURL=cron-to-schtasks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cron-to-schtasks.d.ts","sourceRoot":"","sources":["../../src/core/cron-to-schtasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4DlD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA0GlE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,GAAG,IAAI,CAyEjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,EAAE,CAUvE"}
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Сообщение об ошибке, возвращаемое при встрече неподдерживаемого cron-выражения.
|
|
3
|
+
* Содержит описание поддерживаемого подмножества.
|
|
4
|
+
* Собрано конкатенацией, чтобы избежать последовательности закрывающего комментария внутри строк.
|
|
5
|
+
*/
|
|
6
|
+
const UNSUPPORTED_ERROR = "Неподдерживаемое cron-выражение.\n" +
|
|
7
|
+
"\n" +
|
|
8
|
+
"Поддерживаемое подмножество cron (5 полей: минута час день_месяца месяц день_недели):\n" +
|
|
9
|
+
" * * * * * -> MINUTE, каждую минуту (/mo 1)\n" +
|
|
10
|
+
" */N * * * * -> MINUTE, каждые N минут (/mo N)\n" +
|
|
11
|
+
" M H * * * -> DAILY, ежедневно в HH:MM (/st HH:MM)\n" +
|
|
12
|
+
" M H * * D -> WEEKLY, по неделям в день D в HH:MM (/d D /st HH:MM)\n" +
|
|
13
|
+
"\n" +
|
|
14
|
+
"Не поддерживаются: диапазоны (1-5), списки (1,2,3), комбинации месяца и дня недели,\n" +
|
|
15
|
+
"*/N на месяце или дне недели, а также любые другие сложные выражения.\n" +
|
|
16
|
+
"Пожалуйста, упростите расписание, используя одно из поддерживаемых выше выражений.";
|
|
17
|
+
/** Дни недели для schtasks /d (0 и 7 = воскресенье). */
|
|
18
|
+
const DAY_OF_WEEK_MAP = {
|
|
19
|
+
"0": "SUN",
|
|
20
|
+
"1": "MON",
|
|
21
|
+
"2": "TUE",
|
|
22
|
+
"3": "WED",
|
|
23
|
+
"4": "THU",
|
|
24
|
+
"5": "FRI",
|
|
25
|
+
"6": "SAT",
|
|
26
|
+
"7": "SUN",
|
|
27
|
+
};
|
|
28
|
+
/**
|
|
29
|
+
* Проверяет, является ли строка звездочкой "*".
|
|
30
|
+
*/
|
|
31
|
+
function isStar(value) {
|
|
32
|
+
return value === "*";
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Проверяет, является ли строка шаблоном звездочка-слэш-N (N — положительное целое).
|
|
36
|
+
* Возвращает N или undefined.
|
|
37
|
+
*/
|
|
38
|
+
function parseStep(value) {
|
|
39
|
+
const match = value.match(/^\*\/(\d+)$/);
|
|
40
|
+
if (!match)
|
|
41
|
+
return undefined;
|
|
42
|
+
const n = parseInt(match[1], 10);
|
|
43
|
+
return n > 0 ? n : undefined;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Проверяет, является ли строка одиночным целым числом в диапазоне [min, max].
|
|
47
|
+
* Возвращает число или undefined.
|
|
48
|
+
*/
|
|
49
|
+
function parseIntInRange(value, min, max) {
|
|
50
|
+
if (!/^\d+$/.test(value))
|
|
51
|
+
return undefined;
|
|
52
|
+
const n = parseInt(value, 10);
|
|
53
|
+
return n >= min && n <= max ? n : undefined;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Валидирует и преобразует 5-полевое cron-выражение во флаги schtasks.
|
|
57
|
+
* Возвращает CronConversion или выбрасывает Error с понятным сообщением.
|
|
58
|
+
*/
|
|
59
|
+
export function convertCronToSchTasks(cron) {
|
|
60
|
+
const fields = cron.trim().split(/\s+/);
|
|
61
|
+
if (fields.length !== 5) {
|
|
62
|
+
throw new Error("Ожидалось 5 полей cron-выражения (минута час день_месяца месяц день_недели), получено " +
|
|
63
|
+
fields.length +
|
|
64
|
+
".\n\n" +
|
|
65
|
+
UNSUPPORTED_ERROR);
|
|
66
|
+
}
|
|
67
|
+
const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
|
|
68
|
+
// --- ПАТТЕРН 1: * * * * * -> MINUTE /mo 1 ---
|
|
69
|
+
if (isStar(minute) &&
|
|
70
|
+
isStar(hour) &&
|
|
71
|
+
isStar(dayOfMonth) &&
|
|
72
|
+
isStar(month) &&
|
|
73
|
+
isStar(dayOfWeek)) {
|
|
74
|
+
return {
|
|
75
|
+
sc: "MINUTE",
|
|
76
|
+
extraFlags: ["/mo", "1"],
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
// --- ПАТТЕРН 2: */N * * * * -> MINUTE /mo N ---
|
|
80
|
+
const stepN = parseStep(minute);
|
|
81
|
+
if (stepN !== undefined &&
|
|
82
|
+
isStar(hour) &&
|
|
83
|
+
isStar(dayOfMonth) &&
|
|
84
|
+
isStar(month) &&
|
|
85
|
+
isStar(dayOfWeek)) {
|
|
86
|
+
if (stepN > 1439) {
|
|
87
|
+
throw new Error("Интервал /mo " +
|
|
88
|
+
stepN +
|
|
89
|
+
" минут превышает максимально допустимый для schtasks (1439 минут).\n\n" +
|
|
90
|
+
UNSUPPORTED_ERROR);
|
|
91
|
+
}
|
|
92
|
+
return {
|
|
93
|
+
sc: "MINUTE",
|
|
94
|
+
extraFlags: ["/mo", String(stepN)],
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
// --- ПАТТЕРН 3: M * * * * -> HOURLY /mo 1 /st 00:MM (каждый час в минуту M) ---
|
|
98
|
+
const mHourly = parseIntInRange(minute, 0, 59);
|
|
99
|
+
if (mHourly !== undefined &&
|
|
100
|
+
isStar(hour) &&
|
|
101
|
+
isStar(dayOfMonth) &&
|
|
102
|
+
isStar(month) &&
|
|
103
|
+
isStar(dayOfWeek)) {
|
|
104
|
+
return {
|
|
105
|
+
sc: "HOURLY",
|
|
106
|
+
extraFlags: ["/mo", "1"],
|
|
107
|
+
startTime: "00:" + String(mHourly).padStart(2, "0"),
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
// --- ПАТТЕРН 4: M H * * * -> DAILY /st HH:MM ---
|
|
111
|
+
const m = parseIntInRange(minute, 0, 59);
|
|
112
|
+
const h = parseIntInRange(hour, 0, 23);
|
|
113
|
+
if (m !== undefined &&
|
|
114
|
+
h !== undefined &&
|
|
115
|
+
isStar(dayOfMonth) &&
|
|
116
|
+
isStar(month) &&
|
|
117
|
+
isStar(dayOfWeek)) {
|
|
118
|
+
const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
|
|
119
|
+
return {
|
|
120
|
+
sc: "DAILY",
|
|
121
|
+
extraFlags: [],
|
|
122
|
+
startTime,
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
// --- ПАТТЕРН 4: M H * * D -> WEEKLY /d D /st HH:MM ---
|
|
126
|
+
const d = parseIntInRange(dayOfWeek, 0, 7);
|
|
127
|
+
if (m !== undefined &&
|
|
128
|
+
h !== undefined &&
|
|
129
|
+
isStar(dayOfMonth) &&
|
|
130
|
+
isStar(month) &&
|
|
131
|
+
d !== undefined) {
|
|
132
|
+
const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
|
|
133
|
+
const dayName = DAY_OF_WEEK_MAP[String(d)];
|
|
134
|
+
return {
|
|
135
|
+
sc: "WEEKLY",
|
|
136
|
+
extraFlags: ["/d", dayName],
|
|
137
|
+
startTime,
|
|
138
|
+
days: dayName,
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
// Ни один поддерживаемый паттерн не совпал.
|
|
142
|
+
throw new Error(UNSUPPORTED_ERROR);
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* Вычисляет ближайшее прошедшее (<= now) время срабатывания для поддерживаемых
|
|
146
|
+
* cron-выражений. Нужно для восстановления пропущенных запусков (catch-up):
|
|
147
|
+
* сравнивая это время с историей, можно понять, выполнялась ли задача.
|
|
148
|
+
*
|
|
149
|
+
* Возвращает null, если выражение не поддерживается или не распознано.
|
|
150
|
+
*/
|
|
151
|
+
export function previousRunTime(cron, now = new Date()) {
|
|
152
|
+
const fields = cron.trim().split(/\s+/);
|
|
153
|
+
if (fields.length !== 5)
|
|
154
|
+
return null;
|
|
155
|
+
const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
|
|
156
|
+
const star = (value) => value === "*";
|
|
157
|
+
const intIn = (value, min, max) => {
|
|
158
|
+
if (!/^\d+$/.test(value))
|
|
159
|
+
return undefined;
|
|
160
|
+
const n = parseInt(value, 10);
|
|
161
|
+
return n >= min && n <= max ? n : undefined;
|
|
162
|
+
};
|
|
163
|
+
const nowMs = now.getTime();
|
|
164
|
+
// * * * * * — каждую минуту: последняя граница минуты.
|
|
165
|
+
if (star(minute) && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
|
|
166
|
+
return new Date(Math.floor(nowMs / 60000) * 60000);
|
|
167
|
+
}
|
|
168
|
+
// */N * * * * — каждые N минут (выравнивание по эпохе, как /mo N в schtasks).
|
|
169
|
+
const step = /^\*\/(\d+)$/.exec(minute);
|
|
170
|
+
if (step && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
|
|
171
|
+
const n = parseInt(step[1], 10);
|
|
172
|
+
if (n > 0) {
|
|
173
|
+
const minutes = Math.floor(nowMs / 60000);
|
|
174
|
+
return new Date((minutes - (minutes % n)) * 60000);
|
|
175
|
+
}
|
|
176
|
+
return null;
|
|
177
|
+
}
|
|
178
|
+
// M * * * * — каждый час в минуту M.
|
|
179
|
+
const hourlyMinute = intIn(minute, 0, 59);
|
|
180
|
+
if (hourlyMinute !== undefined &&
|
|
181
|
+
star(hour) &&
|
|
182
|
+
star(dayOfMonth) &&
|
|
183
|
+
star(month) &&
|
|
184
|
+
star(dayOfWeek)) {
|
|
185
|
+
const result = new Date(now);
|
|
186
|
+
result.setSeconds(0, 0);
|
|
187
|
+
result.setMinutes(hourlyMinute);
|
|
188
|
+
if (result.getTime() > nowMs)
|
|
189
|
+
result.setHours(result.getHours() - 1);
|
|
190
|
+
return result;
|
|
191
|
+
}
|
|
192
|
+
const m = intIn(minute, 0, 59);
|
|
193
|
+
const h = intIn(hour, 0, 23);
|
|
194
|
+
if (m === undefined || h === undefined || !star(dayOfMonth) || !star(month)) {
|
|
195
|
+
return null;
|
|
196
|
+
}
|
|
197
|
+
// M H * * * — ежедневно в HH:MM.
|
|
198
|
+
if (star(dayOfWeek)) {
|
|
199
|
+
const result = new Date(now);
|
|
200
|
+
result.setSeconds(0, 0);
|
|
201
|
+
result.setHours(h, m, 0, 0);
|
|
202
|
+
if (result.getTime() > nowMs)
|
|
203
|
+
result.setDate(result.getDate() - 1);
|
|
204
|
+
return result;
|
|
205
|
+
}
|
|
206
|
+
// M H * * D — еженедельно в день D (0 и 7 — воскресенье) в HH:MM.
|
|
207
|
+
const dow = intIn(dayOfWeek, 0, 7);
|
|
208
|
+
if (dow === undefined)
|
|
209
|
+
return null;
|
|
210
|
+
const targetDow = dow === 7 ? 0 : dow;
|
|
211
|
+
const result = new Date(now);
|
|
212
|
+
result.setSeconds(0, 0);
|
|
213
|
+
result.setHours(h, m, 0, 0);
|
|
214
|
+
// Не больше 8 итераций: одна неделя гарантированно содержит нужный день.
|
|
215
|
+
for (let i = 0; i <= 8; i += 1) {
|
|
216
|
+
if (result.getTime() <= nowMs && result.getDay() === targetDow)
|
|
217
|
+
return result;
|
|
218
|
+
result.setDate(result.getDate() - 1);
|
|
219
|
+
}
|
|
220
|
+
return null;
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* Формирует массив флагов расписания для schtasks на основе CronConversion.
|
|
224
|
+
* Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
|
|
225
|
+
*/
|
|
226
|
+
export function buildScheduleFlags(conversion) {
|
|
227
|
+
const flags = ["/sc", conversion.sc];
|
|
228
|
+
if (conversion.startTime) {
|
|
229
|
+
flags.push("/st", conversion.startTime);
|
|
230
|
+
}
|
|
231
|
+
flags.push(...conversion.extraFlags);
|
|
232
|
+
return flags;
|
|
233
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
export interface DryRunRoleScoped {
|
|
2
|
+
allowed?: string[];
|
|
3
|
+
denied?: string[];
|
|
4
|
+
}
|
|
5
|
+
export interface DryRunTaskItem {
|
|
6
|
+
name: string;
|
|
7
|
+
order: number;
|
|
8
|
+
trigger: "manual" | "cron" | "dag";
|
|
9
|
+
cwd: string;
|
|
10
|
+
command: string;
|
|
11
|
+
workspace?: {
|
|
12
|
+
name: string;
|
|
13
|
+
path: string;
|
|
14
|
+
};
|
|
15
|
+
preFlight?: string | null;
|
|
16
|
+
postFlight?: string | null;
|
|
17
|
+
qualityGate?: string | null;
|
|
18
|
+
roleScoped?: DryRunRoleScoped | null;
|
|
19
|
+
estimatedDurationSec?: number | null;
|
|
20
|
+
estimatedCostUsd?: number | null;
|
|
21
|
+
estimatedTokens?: number | null;
|
|
22
|
+
/** Для клона матрицы — имя родителя-шаблона (Спринт 15). */
|
|
23
|
+
matrixParent?: string;
|
|
24
|
+
}
|
|
25
|
+
export interface DryRunTotals {
|
|
26
|
+
estimatedDurationSec?: number | null;
|
|
27
|
+
estimatedCostUsd?: number | null;
|
|
28
|
+
estimatedTokens?: number | null;
|
|
29
|
+
}
|
|
30
|
+
export interface DryRunReport {
|
|
31
|
+
success: boolean;
|
|
32
|
+
taskName: string;
|
|
33
|
+
tasks: DryRunTaskItem[];
|
|
34
|
+
totals: DryRunTotals;
|
|
35
|
+
warnings: string[];
|
|
36
|
+
}
|
|
37
|
+
/** Средняя цена за 1K токенов (должна совпадать с dashboards/server.ts). */
|
|
38
|
+
export declare const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
|
|
39
|
+
/**
|
|
40
|
+
* Симулирует конвейер задачи: сама задача + все зависимости (dependsOn)
|
|
41
|
+
* в топологическом порядке. Возвращает отчёт без реального запуска.
|
|
42
|
+
*/
|
|
43
|
+
export declare function simulatePipeline(taskName: string): Promise<DryRunReport>;
|
|
44
|
+
//# sourceMappingURL=dry-run.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,4EAA4E;AAC5E,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AAQtD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAuP9E"}
|