agent-steward 0.0.2 → 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 +25 -2
- package/CROSS_PLATFORM.md +11 -9
- package/README.md +9 -8
- package/ROADMAP-STRATEGY.md +93 -44
- package/ROADMAP.md +114 -999
- package/dist/core/cron-to-schtasks.d.ts +0 -8
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +11 -86
- package/dist/core/dry-run.js +1 -1
- package/dist/core/file-watcher.js +9 -9
- package/dist/core/git-trigger.js +4 -4
- package/dist/core/lock.js +2 -4
- package/dist/core/one-shot.d.ts +27 -5
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +53 -10
- package/dist/core/otel.js +2 -2
- package/dist/core/ps-wrapper.d.ts +1 -1
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +55 -35
- package/dist/core/record-history.js +22 -22
- package/dist/core/schedule-v2.d.ts +2 -2
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +7 -7
- 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/linux.d.ts +3 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +43 -7
- package/dist/core/scheduler/mac.d.ts +14 -8
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +71 -22
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +12 -1
- package/dist/core/scheduler/registry.d.ts +2 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/windows.d.ts +16 -3
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +249 -96
- package/dist/core/secrets.js +2 -2
- package/dist/core/self-analysis.js +55 -55
- package/dist/core/summary.js +1 -1
- package/dist/core/triage-chain.js +1 -1
- package/dist/core/triage-worker.js +2 -2
- package/dist/core/triage.js +1 -1
- package/dist/core/wrappers/bash.js +33 -33
- package/dist/db/index.d.ts +2 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +9 -1
- 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 +16 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +190 -35
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +66 -36
- package/dist/notifications.js +18 -18
- package/dist/profiles.d.ts +7 -3
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +85 -7
- package/dist/rpc.d.ts +109 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +89 -0
- package/dist/server.d.ts +2 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +20 -19
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/skill.js +1 -1
- package/dist/task-transfer.d.ts +1 -1
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +14 -10
- package/dist/types.d.ts +20 -4
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +37 -9
- package/dist/workspaces.js +1 -1
- package/docs/ARCHITECTURE.md +110 -8
- package/docs/COMPATIBILITY.md +10 -6
- package/docs/CONCEPT.md +15 -3
- package/docs/CROSS_PLATFORM.ru.md +11 -9
- package/docs/CROSS_PLATFORM.zh.md +11 -9
- package/docs/FAQ.md +2 -2
- package/docs/FAQ.ru.md +2 -2
- package/docs/FAQ.zh.md +2 -2
- package/docs/FEATURES.md +5 -4
- package/docs/FEATURES.zh.md +5 -4
- package/docs/MIGRATION.md +34 -26
- package/docs/README.ru.md +26 -7
- package/docs/README.zh.md +9 -8
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
- package/gui-experimental.cjs +8 -8
- package/index.js +1 -0
- package/locales/en.json +1 -0
- package/locales/ru.json +1 -0
- package/locales/zh.json +1 -0
- package/package.json +31 -10
- package/src/core/analytics.ts +2 -2
- package/src/core/audit.ts +17 -17
- package/src/core/cron-to-schtasks.ts +14 -93
- package/src/core/dry-run.ts +26 -26
- package/src/core/file-watcher.ts +17 -17
- package/src/core/git-trigger.ts +9 -9
- package/src/core/glob.ts +1 -1
- package/src/core/local-ai.ts +2 -2
- package/src/core/lock.ts +9 -9
- package/src/core/matrix.ts +31 -31
- package/src/core/native-notify.ts +2 -2
- package/src/core/one-shot.ts +63 -13
- package/src/core/otel.ts +4 -4
- package/src/core/permissions.ts +5 -5
- package/src/core/prometheus.ts +17 -17
- package/src/core/ps-wrapper.ts +57 -37
- package/src/core/record-history.ts +40 -40
- package/src/core/retention.ts +3 -3
- package/src/core/savings.ts +1 -1
- package/src/core/schedule-gate.ts +12 -12
- package/src/core/schedule-v2.ts +24 -24
- package/src/core/scheduler/at-fallback.ts +113 -0
- package/src/core/scheduler/index.ts +3 -3
- package/src/core/scheduler/linux.ts +64 -13
- package/src/core/scheduler/logs.ts +1 -1
- package/src/core/scheduler/mac.ts +112 -60
- package/src/core/scheduler/posix.ts +15 -1
- package/src/core/scheduler/registry.ts +6 -4
- package/src/core/scheduler/windows.ts +295 -125
- package/src/core/secrets.ts +13 -13
- package/src/core/self-analysis.ts +61 -61
- package/src/core/session.ts +3 -3
- package/src/core/structured-log.ts +3 -3
- package/src/core/summary.ts +25 -25
- package/src/core/telegram.ts +16 -16
- package/src/core/triage-chain.ts +4 -4
- package/src/core/triage-compare.ts +8 -8
- package/src/core/triage-rules.ts +4 -4
- package/src/core/triage-shadow.ts +7 -7
- package/src/core/triage-worker.ts +6 -6
- package/src/core/triage.ts +23 -23
- package/src/core/watch-paths.ts +1 -1
- package/src/core/wrappers/bash.ts +41 -41
- package/src/db/git-state-repo.ts +1 -1
- package/src/db/history-repo.ts +22 -22
- package/src/db/index.ts +16 -6
- package/src/db/metrics-repo.ts +10 -10
- package/src/db/migrate.ts +10 -10
- package/src/db/recovery.ts +3 -3
- 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 +205 -44
- package/src/db/settings-repo.ts +2 -2
- package/src/db/tasks-repo.ts +10 -10
- package/src/db/templates-repo.ts +7 -7
- package/src/gui.tsx +1 -1
- package/src/history.ts +4 -4
- package/src/i18n.ts +7 -7
- package/src/index.ts +341 -304
- package/src/integrations.ts +6 -6
- package/src/notifications.ts +76 -76
- package/src/profiles.ts +98 -7
- package/src/rpc.ts +96 -1
- package/src/schtasks.ts +2 -2
- package/src/server.ts +43 -42
- package/src/settings.ts +44 -44
- package/src/shared/jobs-view.ts +60 -60
- package/src/skill.ts +1 -1
- package/src/task-transfer.ts +58 -56
- package/src/templates.ts +1 -1
- package/src/types.ts +45 -10
- package/src/workspaces.ts +16 -16
- package/dist/core/self-analysis.test.d.ts +0 -2
- package/dist/core/self-analysis.test.d.ts.map +0 -1
- package/dist/core/self-analysis.test.js +0 -219
- package/dist/gui-experimental.cjs +0 -1
|
@@ -4,14 +4,6 @@ import type { CronConversion } from "../types.js";
|
|
|
4
4
|
* Возвращает CronConversion или выбрасывает Error с понятным сообщением.
|
|
5
5
|
*/
|
|
6
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
7
|
/**
|
|
16
8
|
* Формирует массив флагов расписания для schtasks на основе CronConversion.
|
|
17
9
|
* Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
|
|
@@ -1 +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;AAgElD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,
|
|
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;AAgElD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA4HlE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,EAAE,CAUvE"}
|
|
@@ -40,7 +40,7 @@ function isStar(value) {
|
|
|
40
40
|
* Возвращает N или undefined.
|
|
41
41
|
*/
|
|
42
42
|
function parseStep(value) {
|
|
43
|
-
const match =
|
|
43
|
+
const match = /^\*\/(\d+)$/.exec(value);
|
|
44
44
|
if (!match)
|
|
45
45
|
return undefined;
|
|
46
46
|
const n = parseInt(match[1], 10);
|
|
@@ -93,10 +93,12 @@ export function convertCronToSchTasks(cron) {
|
|
|
93
93
|
" минут превышает максимально допустимый для schtasks (1439 минут).\n\n" +
|
|
94
94
|
UNSUPPORTED_ERROR);
|
|
95
95
|
}
|
|
96
|
-
// schtasks /mo
|
|
97
|
-
//
|
|
98
|
-
//
|
|
99
|
-
//
|
|
96
|
+
// schtasks /mo Nanchors на момент создания задачи, а cron */N означает
|
|
97
|
+
// минуты 0, N, 2N … внутри часа. Семантики совпадают только когда N
|
|
98
|
+
// делит 60 без остатка И есть выровненный старт (00:00), поэтому ниже
|
|
99
|
+
// добавляется startTime: "00:00". Для N, не делящих 60, выбрасывается
|
|
100
|
+
// ошибка — задача уходит в минутный опрос с gate во враппере
|
|
101
|
+
// (needsPollMode в windows.ts), а не конвертируется здесь нативно.
|
|
100
102
|
if (60 % stepN !== 0) {
|
|
101
103
|
throw new Error("Интервал */" +
|
|
102
104
|
stepN +
|
|
@@ -106,6 +108,10 @@ export function convertCronToSchTasks(cron) {
|
|
|
106
108
|
return {
|
|
107
109
|
sc: "MINUTE",
|
|
108
110
|
extraFlags: ["/mo", String(stepN)],
|
|
111
|
+
// schtasks /mo Nanchors на момент создания задачи; cron */N означает
|
|
112
|
+
// минуты 0, N, 2N … внутри часа. Выровненный старт 00:00 делает
|
|
113
|
+
// расписание идентичным cron для любого N, делящего 60.
|
|
114
|
+
startTime: "00:00",
|
|
109
115
|
};
|
|
110
116
|
}
|
|
111
117
|
// --- ПАТТЕРН 3: M * * * * -> HOURLY /mo 1 /st 00:MM (каждый час в минуту M) ---
|
|
@@ -155,87 +161,6 @@ export function convertCronToSchTasks(cron) {
|
|
|
155
161
|
// Ни один поддерживаемый паттерн не совпал.
|
|
156
162
|
throw new Error(UNSUPPORTED_ERROR);
|
|
157
163
|
}
|
|
158
|
-
/**
|
|
159
|
-
* Вычисляет ближайшее прошедшее (<= now) время срабатывания для поддерживаемых
|
|
160
|
-
* cron-выражений. Нужно для восстановления пропущенных запусков (catch-up):
|
|
161
|
-
* сравнивая это время с историей, можно понять, выполнялась ли задача.
|
|
162
|
-
*
|
|
163
|
-
* Возвращает null, если выражение не поддерживается или не распознано.
|
|
164
|
-
*/
|
|
165
|
-
export function previousRunTime(cron, now = new Date()) {
|
|
166
|
-
const fields = cron.trim().split(/\s+/);
|
|
167
|
-
if (fields.length !== 5)
|
|
168
|
-
return null;
|
|
169
|
-
const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
|
|
170
|
-
const star = (value) => value === "*";
|
|
171
|
-
const intIn = (value, min, max) => {
|
|
172
|
-
if (!/^\d+$/.test(value))
|
|
173
|
-
return undefined;
|
|
174
|
-
const n = parseInt(value, 10);
|
|
175
|
-
return n >= min && n <= max ? n : undefined;
|
|
176
|
-
};
|
|
177
|
-
const nowMs = now.getTime();
|
|
178
|
-
// * * * * * — каждую минуту: последняя граница минуты.
|
|
179
|
-
if (star(minute) && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
|
|
180
|
-
return new Date(Math.floor(nowMs / 60000) * 60000);
|
|
181
|
-
}
|
|
182
|
-
// */N * * * * — каждые N минут внутри часа (минуты 0, N, 2N...).
|
|
183
|
-
const step = /^\*\/(\d+)$/.exec(minute);
|
|
184
|
-
if (step && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
|
|
185
|
-
const n = parseInt(step[1], 10);
|
|
186
|
-
if (n > 0) {
|
|
187
|
-
const result = new Date(now);
|
|
188
|
-
result.setSeconds(0, 0);
|
|
189
|
-
const minuteOfHour = result.getMinutes();
|
|
190
|
-
result.setMinutes(n >= 60 ? 0 : minuteOfHour - (minuteOfHour % n));
|
|
191
|
-
return result;
|
|
192
|
-
}
|
|
193
|
-
return null;
|
|
194
|
-
}
|
|
195
|
-
// M * * * * — каждый час в минуту M.
|
|
196
|
-
const hourlyMinute = intIn(minute, 0, 59);
|
|
197
|
-
if (hourlyMinute !== undefined &&
|
|
198
|
-
star(hour) &&
|
|
199
|
-
star(dayOfMonth) &&
|
|
200
|
-
star(month) &&
|
|
201
|
-
star(dayOfWeek)) {
|
|
202
|
-
const result = new Date(now);
|
|
203
|
-
result.setSeconds(0, 0);
|
|
204
|
-
result.setMinutes(hourlyMinute);
|
|
205
|
-
if (result.getTime() > nowMs)
|
|
206
|
-
result.setHours(result.getHours() - 1);
|
|
207
|
-
return result;
|
|
208
|
-
}
|
|
209
|
-
const m = intIn(minute, 0, 59);
|
|
210
|
-
const h = intIn(hour, 0, 23);
|
|
211
|
-
if (m === undefined || h === undefined || !star(dayOfMonth) || !star(month)) {
|
|
212
|
-
return null;
|
|
213
|
-
}
|
|
214
|
-
// M H * * * — ежедневно в HH:MM.
|
|
215
|
-
if (star(dayOfWeek)) {
|
|
216
|
-
const result = new Date(now);
|
|
217
|
-
result.setSeconds(0, 0);
|
|
218
|
-
result.setHours(h, m, 0, 0);
|
|
219
|
-
if (result.getTime() > nowMs)
|
|
220
|
-
result.setDate(result.getDate() - 1);
|
|
221
|
-
return result;
|
|
222
|
-
}
|
|
223
|
-
// M H * * D — еженедельно в день D (0 и 7 — воскресенье) в HH:MM.
|
|
224
|
-
const dow = intIn(dayOfWeek, 0, 7);
|
|
225
|
-
if (dow === undefined)
|
|
226
|
-
return null;
|
|
227
|
-
const targetDow = dow === 7 ? 0 : dow;
|
|
228
|
-
const result = new Date(now);
|
|
229
|
-
result.setSeconds(0, 0);
|
|
230
|
-
result.setHours(h, m, 0, 0);
|
|
231
|
-
// Не больше 8 итераций: одна неделя гарантированно содержит нужный день.
|
|
232
|
-
for (let i = 0; i <= 8; i += 1) {
|
|
233
|
-
if (result.getTime() <= nowMs && result.getDay() === targetDow)
|
|
234
|
-
return result;
|
|
235
|
-
result.setDate(result.getDate() - 1);
|
|
236
|
-
}
|
|
237
|
-
return null;
|
|
238
|
-
}
|
|
239
164
|
/**
|
|
240
165
|
* Формирует массив флагов расписания для schtasks на основе CronConversion.
|
|
241
166
|
* Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
|
package/dist/core/dry-run.js
CHANGED
|
@@ -52,11 +52,11 @@ export class FileWatchManager {
|
|
|
52
52
|
// Защита от legacy-записей и ручного редактирования БД: не запускаем
|
|
53
53
|
// watcher на путях с управляющими символами или выходом через `..`.
|
|
54
54
|
if (hasPathControlChars(d.path)) {
|
|
55
|
-
console.error(`[
|
|
55
|
+
console.error(`[agent-steward] Задача "${d.name}": путь наблюдения содержит управляющие символы — пропущен.`);
|
|
56
56
|
return false;
|
|
57
57
|
}
|
|
58
58
|
if (!isAbsolute(d.path) && d.path.split(/[\\/]/).includes("..")) {
|
|
59
|
-
console.error(`[
|
|
59
|
+
console.error(`[agent-steward] Задача "${d.name}": относительный путь наблюдения выходит за рабочую директорию — пропущен.`);
|
|
60
60
|
return false;
|
|
61
61
|
}
|
|
62
62
|
return true;
|
|
@@ -106,7 +106,7 @@ export class FileWatchManager {
|
|
|
106
106
|
});
|
|
107
107
|
}
|
|
108
108
|
catch (err) {
|
|
109
|
-
console.error(`[
|
|
109
|
+
console.error(`[agent-steward] Не удалось начать отслеживание "${watchPath}" для задачи "${name}": ${err instanceof Error ? err.message : String(err)}`);
|
|
110
110
|
return;
|
|
111
111
|
}
|
|
112
112
|
const entry = {
|
|
@@ -142,14 +142,14 @@ export class FileWatchManager {
|
|
|
142
142
|
return;
|
|
143
143
|
try {
|
|
144
144
|
const result = this.handler(name, changedPath);
|
|
145
|
-
if (result && typeof result.catch === "function") {
|
|
146
|
-
result.catch((err) => {
|
|
147
|
-
console.error(`[
|
|
145
|
+
if (result && typeof (result).catch === "function") {
|
|
146
|
+
(result).catch((err) => {
|
|
147
|
+
console.error(`[agent-steward] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
|
|
148
148
|
});
|
|
149
149
|
}
|
|
150
150
|
}
|
|
151
151
|
catch (err) {
|
|
152
|
-
console.error(`[
|
|
152
|
+
console.error(`[agent-steward] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
|
|
153
153
|
}
|
|
154
154
|
}, this.debounceMs);
|
|
155
155
|
// Таймер не должен удерживать процесс, если хост завершается.
|
|
@@ -162,10 +162,10 @@ export class FileWatchManager {
|
|
|
162
162
|
watcher.on("add", onChange);
|
|
163
163
|
watcher.on("unlink", onChange);
|
|
164
164
|
watcher.on("error", (err) => {
|
|
165
|
-
console.error(`[
|
|
165
|
+
console.error(`[agent-steward] Ошибка наблюдения за "${watchPath}" (задача "${name}"): ${err?.message ?? String(err)}`);
|
|
166
166
|
});
|
|
167
167
|
this.entries.set(name.toLowerCase(), entry);
|
|
168
|
-
console.log(`[
|
|
168
|
+
console.log(`[agent-steward] Слежу за "${watchPath}" — задача "${name}" запускается при изменении файла.`);
|
|
169
169
|
}
|
|
170
170
|
async remove(key) {
|
|
171
171
|
const entry = this.entries.get(key);
|
package/dist/core/git-trigger.js
CHANGED
|
@@ -22,7 +22,7 @@ export const GIT_COMMAND_TIMEOUT_MS = 10000;
|
|
|
22
22
|
const defaultRunner = (cwd, args) => new Promise((resolve, reject) => {
|
|
23
23
|
execFile("git", ["-C", cwd, ...args], { timeout: GIT_COMMAND_TIMEOUT_MS, windowsHide: true, maxBuffer: 4 * 1024 * 1024 }, (err, stdout) => {
|
|
24
24
|
if (err) {
|
|
25
|
-
reject(err);
|
|
25
|
+
reject(err instanceof Error ? err : new Error(String(err)));
|
|
26
26
|
return;
|
|
27
27
|
}
|
|
28
28
|
resolve(String(stdout ?? ""));
|
|
@@ -73,7 +73,7 @@ export async function gitChangedFiles(cwd, from, to, run = defaultRunner) {
|
|
|
73
73
|
.filter(Boolean);
|
|
74
74
|
}
|
|
75
75
|
function branchMatches(branch, pattern) {
|
|
76
|
-
if (!pattern
|
|
76
|
+
if (!pattern?.trim())
|
|
77
77
|
return true;
|
|
78
78
|
if (!branch)
|
|
79
79
|
return false;
|
|
@@ -280,11 +280,11 @@ export class GitTriggerManager {
|
|
|
280
280
|
await this.handler(managed.def.name, { ...result, cwd: cwdOf(managed.def) });
|
|
281
281
|
}
|
|
282
282
|
else if (result.status === "error") {
|
|
283
|
-
console.error(`[
|
|
283
|
+
console.error(`[agent-steward] git-триггер «${managed.def.name}»: ${result.message}`);
|
|
284
284
|
}
|
|
285
285
|
}
|
|
286
286
|
catch (err) {
|
|
287
|
-
console.error(`[
|
|
287
|
+
console.error(`[agent-steward] git-триггер «${managed.def.name}»: ${err instanceof Error ? err.message : String(err)}`);
|
|
288
288
|
}
|
|
289
289
|
finally {
|
|
290
290
|
managed.busy = false;
|
package/dist/core/lock.js
CHANGED
|
@@ -65,8 +65,7 @@ export class LockManager {
|
|
|
65
65
|
continue;
|
|
66
66
|
}
|
|
67
67
|
await fs.rm(stalePath, { recursive: true, force: true }).catch(() => { });
|
|
68
|
-
|
|
69
|
-
console.log(`[windows-scheduler] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
|
|
68
|
+
console.log(`[agent-steward] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
|
|
70
69
|
}
|
|
71
70
|
}
|
|
72
71
|
catch {
|
|
@@ -132,8 +131,7 @@ export class LockManager {
|
|
|
132
131
|
export async function withLock(lockManager, taskName, fn) {
|
|
133
132
|
const acquired = await lockManager.acquire(taskName);
|
|
134
133
|
if (!acquired) {
|
|
135
|
-
|
|
136
|
-
console.log(`[windows-scheduler] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
|
|
134
|
+
console.log(`[agent-steward] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
|
|
137
135
|
return null;
|
|
138
136
|
}
|
|
139
137
|
try {
|
package/dist/core/one-shot.d.ts
CHANGED
|
@@ -40,16 +40,38 @@ export declare function normalizeOneShotRunAt(input: OneShotInput, nowMs?: numbe
|
|
|
40
40
|
/**
|
|
41
41
|
* Формат даты/времени для schtasks /sd и /st.
|
|
42
42
|
*
|
|
43
|
-
* Windows Task Scheduler ожидает дату в формате текущей локали.
|
|
44
|
-
*
|
|
45
|
-
*
|
|
43
|
+
* Windows Task Scheduler ожидает дату в формате текущей локали. На русской
|
|
44
|
+
* Windows — DD.MM.YYYY, на английской — M/d/yyyy и т.д. Жёсткий DD.MM.YYYY
|
|
45
|
+
* ломает создание one-shot и file/git/mcp-задач на не-RU Windows (P1-8).
|
|
46
|
+
* Вызывающий код (windows.ts) передаёт `dateFormat`, полученный из системной
|
|
47
|
+
* локали через PowerShell `(Get-Culture).DateTimeFormat.ShortDatePattern`.
|
|
48
|
+
*
|
|
49
|
+
* @param runAt — ISO-8601 время запуска.
|
|
50
|
+
* @param dateFormat — шаблон даты локали (например, "dd.MM.yyyy" или "M/d/yyyy").
|
|
51
|
+
* Если не задан — используется DD.MM.YYYY (по умолчанию RU).
|
|
52
|
+
*/
|
|
53
|
+
export declare function buildWindowsOneShotFlags(runAt: string, dateFormat?: string): ["/sc", "ONCE", "/sd", string, "/st", string];
|
|
54
|
+
/**
|
|
55
|
+
* Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
|
|
56
|
+
* (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
|
|
57
|
+
* y/yy/yyyy. Неизвестные символы копируются как есть.
|
|
46
58
|
*/
|
|
47
|
-
export declare function
|
|
59
|
+
export declare function formatDateByLocalePattern(date: Date, pattern: string): string;
|
|
48
60
|
/** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
|
|
49
61
|
export declare function buildAtTimestamp(runAt: string): string;
|
|
62
|
+
/**
|
|
63
|
+
* Bash-команда для one-shot в launchd.
|
|
64
|
+
*
|
|
65
|
+
* StartCalendarInterval не поддерживает год: без защиты задача с runAt
|
|
66
|
+
* дальше чем через год сработала бы в ближайшую годовщину, а после
|
|
67
|
+
* выполнения — повторно через год. Гейт сравнивает now с runAt и ставит
|
|
68
|
+
* маркер, привязанный ко времени запуска.
|
|
69
|
+
*/
|
|
70
|
+
export declare function buildOneShotGuardCommand(command: string, runAt: string, stampPath: string): string;
|
|
50
71
|
/**
|
|
51
72
|
* StartCalendarInterval для launchd. launchd не поддерживает год, поэтому
|
|
52
|
-
*
|
|
73
|
+
* обёртка дополнительно проверяет runAt и ставит маркер выполнения
|
|
74
|
+
* (см. buildOneShotGuardCommand).
|
|
53
75
|
*/
|
|
54
76
|
export declare function buildLaunchdCalendar(runAt: string): {
|
|
55
77
|
Month: number;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"one-shot.d.ts","sourceRoot":"","sources":["../../src/core/one-shot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,QAAyB,CAAC;AAEhE,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAYjC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,GAAE,MAAmB,GACzB,oBAAoB,CAoDtB;AAMD
|
|
1
|
+
{"version":3,"file":"one-shot.d.ts","sourceRoot":"","sources":["../../src/core/one-shot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,QAAyB,CAAC;AAEhE,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAYjC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,GAAE,MAAmB,GACzB,oBAAoB,CAoDtB;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAW/C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7E;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAWR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAQA;AAED,sEAAsE;AACtE,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,SAAY,GAClB,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,SAAY,GAAG,MAAM,CAK/E"}
|
package/dist/core/one-shot.js
CHANGED
|
@@ -46,7 +46,7 @@ export function normalizeOneShotRunAt(input, nowMs = Date.now()) {
|
|
|
46
46
|
if (!Number.isFinite(timestamp)) {
|
|
47
47
|
return {
|
|
48
48
|
ok: false,
|
|
49
|
-
error:
|
|
49
|
+
error: "runAt должен быть датой в формате ISO-8601, например " +
|
|
50
50
|
`2026-12-01T09:00:00Z (получено «${rawRunAt}»).`,
|
|
51
51
|
};
|
|
52
52
|
}
|
|
@@ -54,7 +54,7 @@ export function normalizeOneShotRunAt(input, nowMs = Date.now()) {
|
|
|
54
54
|
return {
|
|
55
55
|
ok: false,
|
|
56
56
|
error: `runAt должен быть в будущем (получено «${rawRunAt}»). ` +
|
|
57
|
-
|
|
57
|
+
"Для запуска сразу используйте run_task_now.",
|
|
58
58
|
};
|
|
59
59
|
}
|
|
60
60
|
return {
|
|
@@ -81,21 +81,43 @@ function pad(value) {
|
|
|
81
81
|
/**
|
|
82
82
|
* Формат даты/времени для schtasks /sd и /st.
|
|
83
83
|
*
|
|
84
|
-
* Windows Task Scheduler ожидает дату в формате текущей локали.
|
|
85
|
-
*
|
|
86
|
-
*
|
|
84
|
+
* Windows Task Scheduler ожидает дату в формате текущей локали. На русской
|
|
85
|
+
* Windows — DD.MM.YYYY, на английской — M/d/yyyy и т.д. Жёсткий DD.MM.YYYY
|
|
86
|
+
* ломает создание one-shot и file/git/mcp-задач на не-RU Windows (P1-8).
|
|
87
|
+
* Вызывающий код (windows.ts) передаёт `dateFormat`, полученный из системной
|
|
88
|
+
* локали через PowerShell `(Get-Culture).DateTimeFormat.ShortDatePattern`.
|
|
89
|
+
*
|
|
90
|
+
* @param runAt — ISO-8601 время запуска.
|
|
91
|
+
* @param dateFormat — шаблон даты локали (например, "dd.MM.yyyy" или "M/d/yyyy").
|
|
92
|
+
* Если не задан — используется DD.MM.YYYY (по умолчанию RU).
|
|
87
93
|
*/
|
|
88
|
-
export function buildWindowsOneShotFlags(runAt) {
|
|
94
|
+
export function buildWindowsOneShotFlags(runAt, dateFormat) {
|
|
89
95
|
const date = new Date(runAt);
|
|
96
|
+
const sd = dateFormat ? formatDateByLocalePattern(date, dateFormat) : `${pad(date.getDate())}.${pad(date.getMonth() + 1)}.${date.getFullYear()}`;
|
|
90
97
|
return [
|
|
91
98
|
"/sc",
|
|
92
99
|
"ONCE",
|
|
93
100
|
"/sd",
|
|
94
|
-
|
|
101
|
+
sd,
|
|
95
102
|
"/st",
|
|
96
103
|
`${pad(date.getHours())}:${pad(date.getMinutes())}`,
|
|
97
104
|
];
|
|
98
105
|
}
|
|
106
|
+
/**
|
|
107
|
+
* Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
|
|
108
|
+
* (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
|
|
109
|
+
* y/yy/yyyy. Неизвестные символы копируются как есть.
|
|
110
|
+
*/
|
|
111
|
+
export function formatDateByLocalePattern(date, pattern) {
|
|
112
|
+
const pad2 = (v) => String(v).padStart(2, "0");
|
|
113
|
+
return pattern
|
|
114
|
+
.replace(/yyyy/g, String(date.getFullYear()))
|
|
115
|
+
.replace(/yy/g, String(date.getFullYear()).slice(-2))
|
|
116
|
+
.replace(/MM/g, pad2(date.getMonth() + 1))
|
|
117
|
+
.replace(/M/g, String(date.getMonth() + 1))
|
|
118
|
+
.replace(/dd/g, pad2(date.getDate()))
|
|
119
|
+
.replace(/d/g, String(date.getDate()));
|
|
120
|
+
}
|
|
99
121
|
/** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
|
|
100
122
|
export function buildAtTimestamp(runAt) {
|
|
101
123
|
const date = new Date(runAt);
|
|
@@ -105,9 +127,30 @@ export function buildAtTimestamp(runAt) {
|
|
|
105
127
|
`${pad(date.getHours())}` +
|
|
106
128
|
`${pad(date.getMinutes())}`);
|
|
107
129
|
}
|
|
130
|
+
/**
|
|
131
|
+
* Bash-команда для one-shot в launchd.
|
|
132
|
+
*
|
|
133
|
+
* StartCalendarInterval не поддерживает год: без защиты задача с runAt
|
|
134
|
+
* дальше чем через год сработала бы в ближайшую годовщину, а после
|
|
135
|
+
* выполнения — повторно через год. Гейт сравнивает now с runAt и ставит
|
|
136
|
+
* маркер, привязанный ко времени запуска.
|
|
137
|
+
*/
|
|
138
|
+
export function buildOneShotGuardCommand(command, runAt, stampPath) {
|
|
139
|
+
const epoch = Math.floor(new Date(runAt).getTime() / 1000);
|
|
140
|
+
const quote = (value) => `'${value.replace(/'/g, "'\\''")}'`;
|
|
141
|
+
return [
|
|
142
|
+
`stamp=${quote(stampPath)}`,
|
|
143
|
+
"[ -f \"$stamp\" ] && exit 0",
|
|
144
|
+
`[ "$(date +%s)" -lt ${epoch} ] && exit 0`,
|
|
145
|
+
"mkdir -p \"$(dirname \"$stamp\")\" 2>/dev/null || true",
|
|
146
|
+
": > \"$stamp\" 2>/dev/null || true",
|
|
147
|
+
command,
|
|
148
|
+
].join("; ");
|
|
149
|
+
}
|
|
108
150
|
/**
|
|
109
151
|
* StartCalendarInterval для launchd. launchd не поддерживает год, поэтому
|
|
110
|
-
*
|
|
152
|
+
* обёртка дополнительно проверяет runAt и ставит маркер выполнения
|
|
153
|
+
* (см. buildOneShotGuardCommand).
|
|
111
154
|
*/
|
|
112
155
|
export function buildLaunchdCalendar(runAt) {
|
|
113
156
|
const date = new Date(runAt);
|
|
@@ -121,9 +164,9 @@ export function buildLaunchdCalendar(runAt) {
|
|
|
121
164
|
/** Команда самоочистки launchd-агента после единственного запуска. */
|
|
122
165
|
export function buildLaunchdOneShotCleanup(sanitizedName, profile = "default") {
|
|
123
166
|
const label = launchdLabel(sanitizedName, profile);
|
|
124
|
-
return (
|
|
167
|
+
return ("launchctl bootout \"gui/$(id -u)\" " +
|
|
125
168
|
`"$HOME/Library/LaunchAgents/${label}.plist" ` +
|
|
126
|
-
|
|
169
|
+
">/dev/null 2>&1 || true");
|
|
127
170
|
}
|
|
128
171
|
/**
|
|
129
172
|
* label launchd-агента задачи. Для default сохраняется историческое имя
|
package/dist/core/otel.js
CHANGED
|
@@ -77,7 +77,7 @@ export function buildOtlpExport(records) {
|
|
|
77
77
|
{
|
|
78
78
|
resource: {
|
|
79
79
|
attributes: compact([
|
|
80
|
-
stringAttr("service.name", "
|
|
80
|
+
stringAttr("service.name", "agent-steward"),
|
|
81
81
|
stringAttr("service.version", version),
|
|
82
82
|
stringAttr("scheduler.profile", getProfileName()),
|
|
83
83
|
stringAttr("scheduler.backend", getSchedulerTitle()),
|
|
@@ -86,7 +86,7 @@ export function buildOtlpExport(records) {
|
|
|
86
86
|
scopeSpans: [
|
|
87
87
|
{
|
|
88
88
|
scope: {
|
|
89
|
-
name: "
|
|
89
|
+
name: "agent-steward",
|
|
90
90
|
version,
|
|
91
91
|
},
|
|
92
92
|
spans,
|