agent-steward 0.0.3 → 0.0.4
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 +20 -0
- package/README.md +3 -3
- package/ROADMAP-STRATEGY.md +9 -9
- package/ROADMAP.md +50 -34
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +18 -1
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +97 -22
- package/dist/core/one-shot.d.ts +5 -1
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +33 -8
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- 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 +11 -1
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +56 -32
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +85 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +34 -0
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +91 -5
- package/dist/core/scheduler/at-fallback.d.ts +55 -2
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
- package/dist/core/scheduler/at-fallback.js +135 -5
- package/dist/core/scheduler/linux.d.ts +10 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +29 -11
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +25 -1
- package/dist/core/scheduler/registry.d.ts +11 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +125 -28
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +49 -4
- package/dist/db/capability-repo.d.ts +83 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +182 -0
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +19 -0
- package/dist/db/index.d.ts +4 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +39 -1
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-resume.d.ts +5 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +30 -11
- package/dist/db/runs-repo.d.ts +13 -5
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +28 -5
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +154 -2
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/index.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +102 -4
- package/dist/rpc.d.ts +678 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +235 -0
- package/dist/server.d.ts +31 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +95 -35
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +7 -0
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +43 -8
- package/docs/ARCHITECTURE.md +229 -5
- package/docs/CONCEPT.md +171 -91
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/README.ru.md +2 -2
- package/docs/README.zh.md +3 -3
- package/docs/SAFETY.md +122 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/gui-experimental.cjs +8 -8
- package/locales/en.json +67 -0
- package/locales/ru.json +67 -0
- package/locales/zh.json +67 -0
- package/package.json +28 -3
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +25 -1
- package/src/core/lock.ts +95 -22
- package/src/core/one-shot.ts +36 -8
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/ps-wrapper.ts +11 -1
- package/src/core/record-history.ts +75 -37
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +109 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +6 -2
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +32 -10
- package/src/core/scheduler/posix.ts +20 -1
- package/src/core/scheduler/registry.ts +107 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/secrets.ts +127 -27
- package/src/core/session.ts +23 -10
- package/src/core/task-name.ts +67 -0
- package/src/core/wrappers/bash.ts +49 -4
- package/src/db/capability-repo.ts +285 -0
- package/src/db/history-repo.ts +22 -0
- package/src/db/index.ts +37 -1
- package/src/db/migrate.ts +3 -1
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-resume.ts +48 -12
- package/src/db/runs-repo.ts +30 -7
- package/src/db/schema.ts +154 -2
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +515 -0
- package/src/index.ts +124 -4
- package/src/rpc.ts +251 -0
- package/src/server.ts +112 -36
- package/src/types.ts +9 -0
- package/src/workspaces.ts +58 -9
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GUI/RPC-фасад над dead-letter queue (Спринт 36.6).
|
|
3
|
+
*
|
|
4
|
+
* Тонкий слой между `src/db/run-dlq.ts` и RPC: приводит вход от GUI к
|
|
5
|
+
* безопасным значениям (статус, лимит), не даёт панике БД выйти наружу и
|
|
6
|
+
* возвращает единый `{ success, error }`-контракт. Логика очереди (идемпотентный
|
|
7
|
+
* enqueue, retry через reopenRun, discard) остаётся в БД-слое.
|
|
8
|
+
*
|
|
9
|
+
* Retry здесь только готовит шаг к повторному выполнению: переоткрывает запуск,
|
|
10
|
+
* переводит шаг в `running` и закрывает запись DLQ. Сам обработчик шага
|
|
11
|
+
* запускает resume (Спринт 36.7), поэтому фасад не притворяется, что шаг уже
|
|
12
|
+
* выполнен.
|
|
13
|
+
*/
|
|
14
|
+
import {
|
|
15
|
+
countDeadLetters,
|
|
16
|
+
discardDeadLetter,
|
|
17
|
+
listDeadLetters,
|
|
18
|
+
retryDeadLetter,
|
|
19
|
+
type DlqEntry,
|
|
20
|
+
type DlqStatus,
|
|
21
|
+
} from "../db/run-dlq.js";
|
|
22
|
+
|
|
23
|
+
/** Фильтр списка: конкретный статус или все записи. */
|
|
24
|
+
export type DlqFilter = DlqStatus | "all";
|
|
25
|
+
|
|
26
|
+
export interface DlqListResult {
|
|
27
|
+
success: boolean;
|
|
28
|
+
entries: DlqEntry[];
|
|
29
|
+
/** Сколько записей открыто (для бейджа в заголовке панели). */
|
|
30
|
+
open: number;
|
|
31
|
+
error?: string;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export interface DlqActionResult {
|
|
35
|
+
success: boolean;
|
|
36
|
+
error?: string;
|
|
37
|
+
entry?: DlqEntry;
|
|
38
|
+
runId?: string;
|
|
39
|
+
stepName?: string;
|
|
40
|
+
/** true, если retry переоткрыл упавший запуск. */
|
|
41
|
+
runReopened?: boolean;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function errorText(err: unknown): string {
|
|
45
|
+
return err instanceof Error ? err.message : String(err);
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** Неизвестный статус трактуем как `open`: безопасный дефолт очереди. */
|
|
49
|
+
export function normalizeDlqFilter(value: unknown): DlqFilter {
|
|
50
|
+
return value === "all" || value === "retried" || value === "discarded" || value === "open"
|
|
51
|
+
? value
|
|
52
|
+
: "open";
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
function normalizeLimit(value: unknown, fallback = 100): number {
|
|
56
|
+
const num = Math.floor(Number(value));
|
|
57
|
+
if (!Number.isFinite(num) || num < 1) return fallback;
|
|
58
|
+
return Math.min(num, 500);
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** Список записей DLQ и счётчик открытых. */
|
|
62
|
+
export function listDlq(options: { status?: unknown; limit?: unknown } = {}): DlqListResult {
|
|
63
|
+
try {
|
|
64
|
+
const status = normalizeDlqFilter(options.status);
|
|
65
|
+
return {
|
|
66
|
+
success: true,
|
|
67
|
+
entries: listDeadLetters({ status, limit: normalizeLimit(options.limit) }),
|
|
68
|
+
open: countDeadLetters("open"),
|
|
69
|
+
};
|
|
70
|
+
} catch (err) {
|
|
71
|
+
return { success: false, entries: [], open: 0, error: errorText(err) };
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** Ручной retry: готовит шаг к выполнению и закрывает запись DLQ. */
|
|
76
|
+
export function retryDlq(id: string): DlqActionResult {
|
|
77
|
+
try {
|
|
78
|
+
const result = retryDeadLetter(id);
|
|
79
|
+
return {
|
|
80
|
+
success: true,
|
|
81
|
+
entry: result.entry,
|
|
82
|
+
runId: result.run.id,
|
|
83
|
+
stepName: result.step.stepName,
|
|
84
|
+
runReopened: result.runReopened,
|
|
85
|
+
};
|
|
86
|
+
} catch (err) {
|
|
87
|
+
return { success: false, error: errorText(err) };
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/** Осознанный отказ от повтора: запись закрывается, шаг остаётся failed. */
|
|
92
|
+
export function discardDlq(id: string, resolution = "discarded"): DlqActionResult {
|
|
93
|
+
try {
|
|
94
|
+
return { success: true, entry: discardDeadLetter(id, resolution) };
|
|
95
|
+
} catch (err) {
|
|
96
|
+
return { success: false, error: errorText(err) };
|
|
97
|
+
}
|
|
98
|
+
}
|
package/src/core/dry-run.ts
CHANGED
|
@@ -10,7 +10,7 @@ import { loadTaskDefinitions } from "../task-transfer.js";
|
|
|
10
10
|
import { getHistory } from "../db/history-repo.js";
|
|
11
11
|
import { getWorkspace } from "../workspaces.js";
|
|
12
12
|
import { expandMatrixTask } from "./matrix.js";
|
|
13
|
-
import { nextRun, activeWindowState } from "./schedule-v2.js";
|
|
13
|
+
import { nextRun, activeWindowState, assessCronWindowFeasibility, windowFeasibilityReasonText } from "./schedule-v2.js";
|
|
14
14
|
import { checkGitTrigger } from "./git-trigger.js";
|
|
15
15
|
import { t } from "../i18n.js";
|
|
16
16
|
import type { TaskDefinition } from "../task-transfer.js";
|
|
@@ -283,6 +283,30 @@ async function describeTrigger(opts: DescribeTriggerOptions): Promise<DryRunTrig
|
|
|
283
283
|
}),
|
|
284
284
|
);
|
|
285
285
|
}
|
|
286
|
+
|
|
287
|
+
// P2-24: даже если сейчас окно откроется, cron может никогда в него не
|
|
288
|
+
// попадать (например, daily 09:00 при окне 22:00–06:00). Предупреждаем
|
|
289
|
+
// заранее — иначе задача молча не выполняется из-за лимита переноса 12 ч.
|
|
290
|
+
if ((def.triggerType ?? "cron") === "cron" && def.schedule) {
|
|
291
|
+
const feasibility = assessCronWindowFeasibility(
|
|
292
|
+
def.schedule,
|
|
293
|
+
{
|
|
294
|
+
notBefore: def.notBefore ?? undefined,
|
|
295
|
+
notAfter: def.notAfter ?? undefined,
|
|
296
|
+
days: def.activeDays ?? undefined,
|
|
297
|
+
timeZone: def.timezone ?? undefined,
|
|
298
|
+
},
|
|
299
|
+
policy,
|
|
300
|
+
);
|
|
301
|
+
if (!feasibility.feasible) {
|
|
302
|
+
warnings.push(
|
|
303
|
+
t("dryRun.window.unreachable", {
|
|
304
|
+
cron: def.schedule,
|
|
305
|
+
reason: windowFeasibilityReasonText(feasibility.reason),
|
|
306
|
+
}),
|
|
307
|
+
);
|
|
308
|
+
}
|
|
309
|
+
}
|
|
286
310
|
}
|
|
287
311
|
|
|
288
312
|
return base;
|
package/src/core/lock.ts
CHANGED
|
@@ -1,7 +1,36 @@
|
|
|
1
1
|
import fs from "node:fs/promises";
|
|
2
2
|
import path from "node:path";
|
|
3
|
+
import { randomUUID } from "node:crypto";
|
|
3
4
|
import { LOCK_DIR, STALE_LOCK_MAX_AGE_MS } from "../types.js";
|
|
4
5
|
|
|
6
|
+
/**
|
|
7
|
+
* Проверяет, жив ли процесс-владелец lock-файла.
|
|
8
|
+
*
|
|
9
|
+
* `process.kill(pid, 0)` не посылает сигнал, а только проверяет существование.
|
|
10
|
+
* EPERM означает, что процесс есть, но у нас нет прав на сигнал — считаем живым.
|
|
11
|
+
* Остальные ошибки трактуем консервативно как «жив», чтобы не вытеснить
|
|
12
|
+
* чужую критическую секцию.
|
|
13
|
+
*/
|
|
14
|
+
export function isProcessAlive(pid: number): boolean {
|
|
15
|
+
if (!Number.isInteger(pid) || pid <= 0) return false;
|
|
16
|
+
try {
|
|
17
|
+
process.kill(pid, 0);
|
|
18
|
+
return true;
|
|
19
|
+
} catch (err: any) {
|
|
20
|
+
if (err?.code === "ESRCH") return false;
|
|
21
|
+
return true;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** PID владельца из токена lock-файла (`<pid>-<timestamp>-<uuid>`). */
|
|
26
|
+
function ownerPidFromToken(content: string): number | null {
|
|
27
|
+
const match = /^(\d+)-/.exec(content.trim());
|
|
28
|
+
if (!match) return null;
|
|
29
|
+
const pid = Number.parseInt(match[1], 10);
|
|
30
|
+
return Number.isInteger(pid) ? pid : null;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
|
|
5
34
|
/**
|
|
6
35
|
* Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
|
|
7
36
|
*
|
|
@@ -60,6 +89,21 @@ export class LockManager {
|
|
|
60
89
|
const stat = await fs.stat(fullPath);
|
|
61
90
|
const age = now - stat.mtimeMs;
|
|
62
91
|
if (age > STALE_LOCK_MAX_AGE_MS) {
|
|
92
|
+
// P2-18: возраст — только повод проверить владельца. Задача может
|
|
93
|
+
// легально работать дольше 24 ч (timeoutSeconds: 0), поэтому живой
|
|
94
|
+
// процесс не вытесняем: иначе после рестарта плагина появится дубль.
|
|
95
|
+
if (isLockFile) {
|
|
96
|
+
const content = await fs.readFile(fullPath, "utf8").catch(() => "");
|
|
97
|
+
const ownerPid = ownerPidFromToken(content);
|
|
98
|
+
if (ownerPid !== null && isProcessAlive(ownerPid)) {
|
|
99
|
+
console.log(
|
|
100
|
+
`[agent-steward] Lock ${file} старше ${Math.round(
|
|
101
|
+
age / 1000,
|
|
102
|
+
)} с, но процесс ${ownerPid} жив — оставляем.`,
|
|
103
|
+
);
|
|
104
|
+
continue;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
63
107
|
// T-03: не удаляем lock напрямую. Два воркера могли одновременно
|
|
64
108
|
// снести один и тот же файл, после чего один из них удалял свежий
|
|
65
109
|
// lock, созданный другим, и задача запускалась повторно. Атомарный
|
|
@@ -87,20 +131,24 @@ export class LockManager {
|
|
|
87
131
|
|
|
88
132
|
/**
|
|
89
133
|
* Пытается захватить блокировку для задачи.
|
|
90
|
-
* Возвращает
|
|
91
|
-
*
|
|
134
|
+
* Возвращает уникальный токен владельца (он же содержимое lock-файла) или
|
|
135
|
+
* null, если блокировка уже удерживается другим запуском.
|
|
136
|
+
*
|
|
137
|
+
* Токен нужен release(): процесс, чей lock был вытеснен по stale-таймауту,
|
|
138
|
+
* не должен удалять файл нового владельца.
|
|
92
139
|
*/
|
|
93
|
-
async acquire(taskName: string): Promise<
|
|
140
|
+
async acquire(taskName: string): Promise<string | null> {
|
|
94
141
|
await fs.mkdir(this.lockDir, { recursive: true });
|
|
95
142
|
const lockPath = this.lockFilePath(taskName);
|
|
143
|
+
const token = `${process.pid}-${Date.now()}-${randomUUID()}`;
|
|
96
144
|
|
|
97
145
|
try {
|
|
98
146
|
// 'wx' — exclusive create: ошибка если файл уже существует.
|
|
99
|
-
await fs.writeFile(lockPath,
|
|
100
|
-
return
|
|
147
|
+
await fs.writeFile(lockPath, token, { flag: "wx" });
|
|
148
|
+
return token;
|
|
101
149
|
} catch (err: any) {
|
|
102
150
|
if (err.code === "EEXIST") {
|
|
103
|
-
return
|
|
151
|
+
return null;
|
|
104
152
|
}
|
|
105
153
|
throw err;
|
|
106
154
|
}
|
|
@@ -108,14 +156,28 @@ export class LockManager {
|
|
|
108
156
|
|
|
109
157
|
/**
|
|
110
158
|
* Освобождает блокировку задачи (удаляет lock-файл).
|
|
159
|
+
*
|
|
160
|
+
* Удаляет файл только если в нём лежит токен этого владельца. Если lock
|
|
161
|
+
* успели вытеснить и перехватить, release ничего не трогает и возвращает
|
|
162
|
+
* false — иначе старый процесс снёс бы чужую критическую секцию.
|
|
111
163
|
* Не выбрасывает ошибку, если файл уже удалён.
|
|
112
164
|
*/
|
|
113
|
-
async release(taskName: string): Promise<
|
|
165
|
+
async release(taskName: string, token: string): Promise<boolean> {
|
|
114
166
|
const lockPath = this.lockFilePath(taskName);
|
|
167
|
+
let current: string;
|
|
168
|
+
try {
|
|
169
|
+
current = await fs.readFile(lockPath, "utf8");
|
|
170
|
+
} catch (err: any) {
|
|
171
|
+
if (err.code === "ENOENT") return false;
|
|
172
|
+
throw err;
|
|
173
|
+
}
|
|
174
|
+
if (current !== token) return false;
|
|
115
175
|
try {
|
|
116
176
|
await fs.unlink(lockPath);
|
|
177
|
+
return true;
|
|
117
178
|
} catch (err: any) {
|
|
118
|
-
if (err.code
|
|
179
|
+
if (err.code === "ENOENT") return false;
|
|
180
|
+
throw err;
|
|
119
181
|
}
|
|
120
182
|
}
|
|
121
183
|
|
|
@@ -144,8 +206,8 @@ export async function withLock<T>(
|
|
|
144
206
|
taskName: string,
|
|
145
207
|
fn: () => Promise<T>,
|
|
146
208
|
): Promise<T | null> {
|
|
147
|
-
const
|
|
148
|
-
if (!
|
|
209
|
+
const token = await lockManager.acquire(taskName);
|
|
210
|
+
if (!token) {
|
|
149
211
|
|
|
150
212
|
console.log(
|
|
151
213
|
`[agent-steward] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`,
|
|
@@ -156,7 +218,7 @@ export async function withLock<T>(
|
|
|
156
218
|
try {
|
|
157
219
|
return await fn();
|
|
158
220
|
} finally {
|
|
159
|
-
await lockManager.release(taskName);
|
|
221
|
+
await lockManager.release(taskName, token);
|
|
160
222
|
}
|
|
161
223
|
}
|
|
162
224
|
|
|
@@ -178,25 +240,36 @@ export async function withLockWait<T>(
|
|
|
178
240
|
const staleMs = options.staleMs ?? 60000;
|
|
179
241
|
const deadline = Date.now() + timeoutMs;
|
|
180
242
|
const lockPath = lockManager.pathFor(taskName);
|
|
243
|
+
let token: string | null = null;
|
|
181
244
|
|
|
182
245
|
for (;;) {
|
|
183
|
-
|
|
246
|
+
token = await lockManager.acquire(taskName);
|
|
247
|
+
if (token) break;
|
|
184
248
|
|
|
185
249
|
// Осиротевший lock: короткая операция не может длиться дольше staleMs.
|
|
186
250
|
if (staleMs > 0) {
|
|
187
251
|
try {
|
|
188
252
|
const stat = await fs.stat(lockPath);
|
|
189
253
|
if (Date.now() - stat.mtimeMs > staleMs) {
|
|
190
|
-
//
|
|
191
|
-
//
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
254
|
+
// P2-18: staleMs — не приговор. Если владелец ещё жив, его
|
|
255
|
+
// критическая секция может быть легально долгой (crontab RMW,
|
|
256
|
+
// длинная задача). Вытесняем только мёртвый/неизвестный lock.
|
|
257
|
+
const content = await fs.readFile(lockPath, "utf8").catch(() => "");
|
|
258
|
+
const ownerPid = ownerPidFromToken(content);
|
|
259
|
+
if (ownerPid !== null && isProcessAlive(ownerPid)) {
|
|
260
|
+
// Ждём дальше; по deadline вернём понятную ошибку.
|
|
261
|
+
} else {
|
|
262
|
+
// T-03-совместимое вытеснение: атомарный rename выигрывает ровно
|
|
263
|
+
// один процесс, остальные получают ENOENT и повторяют попытку.
|
|
264
|
+
const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
|
|
265
|
+
try {
|
|
266
|
+
await fs.rename(lockPath, stalePath);
|
|
267
|
+
await fs.rm(stalePath, { force: true }).catch(() => {});
|
|
268
|
+
} catch {
|
|
269
|
+
// Кто-то успел раньше — просто повторяем acquire.
|
|
270
|
+
}
|
|
271
|
+
continue;
|
|
198
272
|
}
|
|
199
|
-
continue;
|
|
200
273
|
}
|
|
201
274
|
} catch {
|
|
202
275
|
// lock исчез — сразу пробуем acquire снова.
|
|
@@ -214,6 +287,6 @@ export async function withLockWait<T>(
|
|
|
214
287
|
try {
|
|
215
288
|
return await fn();
|
|
216
289
|
} finally {
|
|
217
|
-
await lockManager.release(taskName);
|
|
290
|
+
if (token) await lockManager.release(taskName, token);
|
|
218
291
|
}
|
|
219
292
|
}
|
package/src/core/one-shot.ts
CHANGED
|
@@ -143,17 +143,45 @@ export function buildWindowsOneShotFlags(
|
|
|
143
143
|
/**
|
|
144
144
|
* Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
|
|
145
145
|
* (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
|
|
146
|
-
* y/yy/yyyy. Неизвестные символы копируются как есть.
|
|
146
|
+
* MMM/MMMM (название месяца), y/yy/yyyy. Неизвестные символы копируются как есть.
|
|
147
|
+
*
|
|
148
|
+
* P2-26: раньше последовательные replace(/MM/) и replace(/M/) превращали
|
|
149
|
+
* «MMM» в число месяца («2030. 011 2.»). Теперь разбор идёт одним проходом
|
|
150
|
+
* по токенам, поэтому MMM/MMMM не пересекаются с MM/M.
|
|
147
151
|
*/
|
|
148
152
|
export function formatDateByLocalePattern(date: Date, pattern: string): string {
|
|
149
153
|
const pad2 = (v: number) => String(v).padStart(2, "0");
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
154
|
+
const monthShort = new Intl.DateTimeFormat(undefined, {
|
|
155
|
+
month: "short",
|
|
156
|
+
}).format(date);
|
|
157
|
+
const monthLong = new Intl.DateTimeFormat(undefined, {
|
|
158
|
+
month: "long",
|
|
159
|
+
}).format(date);
|
|
160
|
+
return pattern.replace(
|
|
161
|
+
/yyyy|yy|MMMM|MMM|MM|M|dd|d/g,
|
|
162
|
+
(token) => {
|
|
163
|
+
switch (token) {
|
|
164
|
+
case "yyyy":
|
|
165
|
+
return String(date.getFullYear());
|
|
166
|
+
case "yy":
|
|
167
|
+
return String(date.getFullYear()).slice(-2);
|
|
168
|
+
case "MMMM":
|
|
169
|
+
return monthLong;
|
|
170
|
+
case "MMM":
|
|
171
|
+
return monthShort;
|
|
172
|
+
case "MM":
|
|
173
|
+
return pad2(date.getMonth() + 1);
|
|
174
|
+
case "M":
|
|
175
|
+
return String(date.getMonth() + 1);
|
|
176
|
+
case "dd":
|
|
177
|
+
return pad2(date.getDate());
|
|
178
|
+
case "d":
|
|
179
|
+
return String(date.getDate());
|
|
180
|
+
default:
|
|
181
|
+
return token;
|
|
182
|
+
}
|
|
183
|
+
},
|
|
184
|
+
);
|
|
157
185
|
}
|
|
158
186
|
|
|
159
187
|
/** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Кроссплатформенный запуск OpenCode CLI.
|
|
3
|
+
*
|
|
4
|
+
* На Windows `opencode` — это `opencode.cmd`. Node с 18.20/20.12 запрещает
|
|
5
|
+
* запускать `.cmd`/`.bat` через `execFile` без shell (EINVAL), а имя без
|
|
6
|
+
* расширения не находится вовсе (ENOENT). Поэтому на Windows команда идёт
|
|
7
|
+
* через `cmd.exe /d /s /c` — ровно так же, как в `opencode-models.ts`.
|
|
8
|
+
*
|
|
9
|
+
* Модуль не бросает: результат запуска возвращается объектом, чтобы вызывающий
|
|
10
|
+
* сам решал, писать предупреждение или продолжать молча.
|
|
11
|
+
*/
|
|
12
|
+
import { execFile } from "node:child_process";
|
|
13
|
+
|
|
14
|
+
/** Готовая команда для `execFile`/`execFileSync`. */
|
|
15
|
+
export interface OpencodeCommand {
|
|
16
|
+
file: string;
|
|
17
|
+
args: string[];
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** Аргументы без спецсимволов cmd.exe можно передавать как есть. */
|
|
21
|
+
const SAFE_ARG = /^[A-Za-z0-9_.,:@/\\+=-]+$/;
|
|
22
|
+
|
|
23
|
+
/** Результат запуска CLI. */
|
|
24
|
+
export interface RunOpencodeResult {
|
|
25
|
+
ok: boolean;
|
|
26
|
+
stdout: string;
|
|
27
|
+
stderr: string;
|
|
28
|
+
/** Текст ошибки запуска (только при ok = false). */
|
|
29
|
+
error?: string;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Экранирует аргумент для командной строки cmd.exe.
|
|
34
|
+
* Бросает на переводы строк: они разрывают команду на две.
|
|
35
|
+
*/
|
|
36
|
+
export function quoteCmdArg(arg: string): string {
|
|
37
|
+
if (/[\r\n]/.test(arg)) {
|
|
38
|
+
throw new Error("Аргумент командной строки не может содержать перевод строки");
|
|
39
|
+
}
|
|
40
|
+
if (SAFE_ARG.test(arg)) return arg;
|
|
41
|
+
return `"${arg.replace(/"/g, '""')}"`;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Команда запуска OpenCode для указанной платформы (чистая функция). */
|
|
45
|
+
export function opencodeCommandFor(
|
|
46
|
+
platform: NodeJS.Platform,
|
|
47
|
+
args: string[],
|
|
48
|
+
): OpencodeCommand {
|
|
49
|
+
if (platform !== "win32") return { file: "opencode", args: args.slice() };
|
|
50
|
+
const line = ["opencode", ...args].map(quoteCmdArg).join(" ");
|
|
51
|
+
return { file: "cmd.exe", args: ["/d", "/s", "/c", line] };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** Команда запуска OpenCode на текущей платформе. */
|
|
55
|
+
export function opencodeCommand(args: string[]): OpencodeCommand {
|
|
56
|
+
return opencodeCommandFor(process.platform, args);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Запускает OpenCode CLI и ждёт завершения. Никогда не бросает.
|
|
61
|
+
* `timeoutMs` защищает от зависшего процесса: CLI не должен держать ротацию.
|
|
62
|
+
*/
|
|
63
|
+
export function runOpencode(
|
|
64
|
+
args: string[],
|
|
65
|
+
timeoutMs = 30_000,
|
|
66
|
+
): Promise<RunOpencodeResult> {
|
|
67
|
+
let command: OpencodeCommand;
|
|
68
|
+
try {
|
|
69
|
+
command = opencodeCommand(args);
|
|
70
|
+
} catch (error) {
|
|
71
|
+
return Promise.resolve({
|
|
72
|
+
ok: false,
|
|
73
|
+
stdout: "",
|
|
74
|
+
stderr: "",
|
|
75
|
+
error: error instanceof Error ? error.message : String(error),
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
return new Promise<RunOpencodeResult>((resolve) => {
|
|
80
|
+
execFile(
|
|
81
|
+
command.file,
|
|
82
|
+
command.args,
|
|
83
|
+
{
|
|
84
|
+
timeout: timeoutMs,
|
|
85
|
+
windowsHide: true,
|
|
86
|
+
encoding: "utf8",
|
|
87
|
+
maxBuffer: 4 * 1024 * 1024,
|
|
88
|
+
},
|
|
89
|
+
(error, stdout, stderr) => {
|
|
90
|
+
if (error) {
|
|
91
|
+
resolve({
|
|
92
|
+
ok: false,
|
|
93
|
+
stdout: String(stdout ?? ""),
|
|
94
|
+
stderr: String(stderr ?? ""),
|
|
95
|
+
error: error.message,
|
|
96
|
+
});
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
resolve({ ok: true, stdout: String(stdout ?? ""), stderr: String(stderr ?? "") });
|
|
100
|
+
},
|
|
101
|
+
);
|
|
102
|
+
});
|
|
103
|
+
}
|