agent-steward 0.0.0-stage → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +376 -0
- package/CROSS_PLATFORM.md +149 -0
- package/LICENSE +21 -0
- package/README.md +314 -2
- package/ROADMAP-STRATEGY.md +147 -0
- package/ROADMAP.md +1069 -0
- package/dist/core/analytics.d.ts +132 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +290 -0
- package/dist/core/audit.d.ts +96 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +297 -0
- package/dist/core/cron-to-schtasks.d.ts +20 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +250 -0
- package/dist/core/dry-run.d.ts +102 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +447 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +186 -0
- package/dist/core/git-trigger.d.ts +82 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +312 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- package/dist/core/local-ai.d.ts +52 -0
- package/dist/core/local-ai.d.ts.map +1 -0
- package/dist/core/local-ai.js +119 -0
- package/dist/core/lock.d.ts +57 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +195 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +724 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +113 -0
- package/dist/core/one-shot.d.ts +68 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +139 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- package/dist/core/permissions.d.ts +69 -0
- package/dist/core/permissions.d.ts.map +1 -0
- package/dist/core/permissions.js +143 -0
- package/dist/core/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +73 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +1071 -0
- package/dist/core/record-history.d.ts +25 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +471 -0
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/savings.d.ts +70 -0
- package/dist/core/savings.d.ts.map +1 -0
- package/dist/core/savings.js +87 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +211 -0
- package/dist/core/schedule-v2.d.ts +116 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +586 -0
- package/dist/core/scheduler/index.d.ts +32 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +63 -0
- package/dist/core/scheduler/linux.d.ts +44 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +225 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +40 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +207 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +89 -0
- package/dist/core/scheduler/registry.d.ts +41 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +57 -0
- package/dist/core/scheduler/types.d.ts +86 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +99 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +596 -0
- package/dist/core/secrets.d.ts +66 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +433 -0
- package/dist/core/self-analysis.d.ts +117 -0
- package/dist/core/self-analysis.d.ts.map +1 -0
- package/dist/core/self-analysis.js +539 -0
- package/dist/core/self-analysis.test.d.ts +2 -0
- package/dist/core/self-analysis.test.d.ts.map +1 -0
- package/dist/core/self-analysis.test.js +219 -0
- package/dist/core/session.d.ts +42 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +134 -0
- package/dist/core/shutdown.d.ts +26 -0
- package/dist/core/shutdown.d.ts.map +1 -0
- package/dist/core/shutdown.js +49 -0
- package/dist/core/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +146 -0
- package/dist/core/summary.d.ts +69 -0
- package/dist/core/summary.d.ts.map +1 -0
- package/dist/core/summary.js +250 -0
- package/dist/core/telegram.d.ts +55 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +344 -0
- package/dist/core/triage-chain.d.ts +40 -0
- package/dist/core/triage-chain.d.ts.map +1 -0
- package/dist/core/triage-chain.js +80 -0
- package/dist/core/triage-compare.d.ts +68 -0
- package/dist/core/triage-compare.d.ts.map +1 -0
- package/dist/core/triage-compare.js +184 -0
- package/dist/core/triage-rules.d.ts +23 -0
- package/dist/core/triage-rules.d.ts.map +1 -0
- package/dist/core/triage-rules.js +196 -0
- package/dist/core/triage-shadow.d.ts +91 -0
- package/dist/core/triage-shadow.d.ts.map +1 -0
- package/dist/core/triage-shadow.js +160 -0
- package/dist/core/triage-worker.d.ts +55 -0
- package/dist/core/triage-worker.d.ts.map +1 -0
- package/dist/core/triage-worker.js +314 -0
- package/dist/core/triage.d.ts +76 -0
- package/dist/core/triage.d.ts.map +1 -0
- package/dist/core/triage.js +271 -0
- package/dist/core/watch-paths.d.ts +6 -0
- package/dist/core/watch-paths.d.ts.map +1 -0
- package/dist/core/watch-paths.js +62 -0
- package/dist/core/wrappers/bash.d.ts +95 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +413 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/history-repo.d.ts +110 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +300 -0
- package/dist/db/index.d.ts +47 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +120 -0
- package/dist/db/metrics-repo.d.ts +46 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +103 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +244 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -0
- package/dist/db/schema.d.ts +24 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +170 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/gui-experimental.cjs +1 -0
- package/dist/history.d.ts +60 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +70 -0
- package/dist/i18n.d.ts +75 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +357 -0
- package/dist/index.d.ts +858 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5179 -0
- package/dist/integrations.d.ts +72 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +233 -0
- package/dist/notifications.d.ts +199 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +967 -0
- package/dist/profiles.d.ts +60 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +227 -0
- package/dist/rpc.d.ts +3806 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1507 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +128 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +2413 -0
- package/dist/settings.d.ts +389 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +770 -0
- package/dist/shared/jobs-view.d.ts +59 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +146 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +252 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +628 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +96 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +130 -0
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +113 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +393 -0
- package/docs/ARCHITECTURE.md +457 -0
- package/docs/COMPATIBILITY.md +233 -0
- package/docs/CONCEPT.md +230 -0
- package/docs/CROSS_PLATFORM.ru.md +150 -0
- package/docs/CROSS_PLATFORM.zh.md +146 -0
- package/docs/FAQ.md +52 -0
- package/docs/FAQ.ru.md +53 -0
- package/docs/FAQ.zh.md +43 -0
- package/docs/FEATURES.md +698 -0
- package/docs/FEATURES.zh.md +655 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +355 -0
- package/docs/README.ru.md +268 -0
- package/docs/README.zh.md +305 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/dashboard.png +0 -0
- package/docs/spikes/local-model-structured-output.md +81 -0
- package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
- package/docs/spikes/ollama-qwen3-4b.json +163 -0
- package/gui-experimental.cjs +9 -0
- package/index.js +1 -0
- package/locales/en.json +780 -0
- package/locales/ru.json +780 -0
- package/locales/zh.json +780 -0
- package/package.json +149 -4
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/demo-dashboard.mjs +209 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +45 -0
- package/skills/scheduled-job-best-practices/SKILL.md +158 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
- package/src/core/analytics.ts +424 -0
- package/src/core/audit.ts +418 -0
- package/src/core/cron-to-schtasks.ts +288 -0
- package/src/core/dry-run.ts +601 -0
- package/src/core/file-watcher.ts +245 -0
- package/src/core/git-trigger.ts +391 -0
- package/src/core/glob.ts +226 -0
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +219 -0
- package/src/core/matrix.ts +947 -0
- package/src/core/native-notify.ts +157 -0
- package/src/core/one-shot.ts +189 -0
- package/src/core/otel.ts +128 -0
- package/src/core/permissions.ts +200 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +1140 -0
- package/src/core/record-history.ts +615 -0
- package/src/core/retention.ts +141 -0
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +253 -0
- package/src/core/schedule-v2.ts +668 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +257 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +270 -0
- package/src/core/scheduler/posix.ts +114 -0
- package/src/core/scheduler/registry.ts +99 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +711 -0
- package/src/core/secrets.ts +503 -0
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +150 -0
- package/src/core/shutdown.ts +69 -0
- package/src/core/structured-log.ts +214 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +436 -0
- package/src/core/triage-chain.ts +125 -0
- package/src/core/triage-compare.ts +277 -0
- package/src/core/triage-rules.ts +238 -0
- package/src/core/triage-shadow.ts +240 -0
- package/src/core/triage-worker.ts +344 -0
- package/src/core/triage.ts +366 -0
- package/src/core/watch-paths.ts +70 -0
- package/src/core/wrappers/bash.ts +532 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/history-repo.ts +492 -0
- package/src/db/index.ts +166 -0
- package/src/db/metrics-repo.ts +170 -0
- package/src/db/migrate.ts +328 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/schema.ts +188 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +5222 -0
- package/src/history.ts +128 -0
- package/src/i18n.ts +413 -0
- package/src/index.ts +6605 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +254 -0
- package/src/rpc.ts +1609 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2662 -0
- package/src/settings.ts +1369 -0
- package/src/shared/jobs-view.ts +188 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +944 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +191 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
package/src/core/glob.ts
ADDED
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Glob-маски без внешних зависимостей (Спринт 27).
|
|
3
|
+
*
|
|
4
|
+
* Поддерживается подмножество, достаточное для фильтров файловых и git-триггеров:
|
|
5
|
+
* * — любые символы, кроме "/"
|
|
6
|
+
* ** — любые символы, включая "/" (в т.ч. ноль сегментов: `src/**\/x.ts`)
|
|
7
|
+
* ? — один символ, кроме "/"
|
|
8
|
+
* [abc] — класс символов, [a-z] — диапазон, [!abc] / [^abc] — отрицание
|
|
9
|
+
* {a,b} — альтернативы (в т.ч. вложенные)
|
|
10
|
+
* !pattern — отрицание маски (для ignore-списков, обрабатывается matchesAnyGlob)
|
|
11
|
+
*
|
|
12
|
+
* Пути нормализуются к POSIX-виду ("\" → "/"), ведущий "./" отбрасывается.
|
|
13
|
+
* На Windows сравнение регистронезависимое, на остальных платформах — точное.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
const WINDOWS = process.platform === "win32";
|
|
17
|
+
|
|
18
|
+
/** Нормализует путь или маску: "/" как разделитель, без ведущего "./". */
|
|
19
|
+
export function normalizePath(value: unknown): string {
|
|
20
|
+
let text = String(value ?? "").trim().replace(/\\/g, "/");
|
|
21
|
+
if (!text) return "";
|
|
22
|
+
while (text.startsWith("./")) text = text.slice(2);
|
|
23
|
+
// Схлопываем повторные слэши, но не трогаем начало (UNC уже приведён к "/").
|
|
24
|
+
text = text.replace(/\/{2,}/g, "/");
|
|
25
|
+
return text;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** Экранирует символ регулярного выражения. */
|
|
29
|
+
function escapeRe(ch: string): string {
|
|
30
|
+
return /[.+^$()|[\]\\]/.test(ch) ? `\\${ch}` : ch;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Преобразует glob-маску в регулярное выражение.
|
|
35
|
+
* Маска предполагается полной (от начала до конца строки).
|
|
36
|
+
*/
|
|
37
|
+
export function globToRegExp(pattern: unknown): RegExp {
|
|
38
|
+
const source = normalizePath(pattern);
|
|
39
|
+
let out = "^";
|
|
40
|
+
|
|
41
|
+
const compile = (text: string): string => {
|
|
42
|
+
let result = "";
|
|
43
|
+
let j = 0;
|
|
44
|
+
while (j < text.length) {
|
|
45
|
+
const ch = text[j];
|
|
46
|
+
if (ch === "*") {
|
|
47
|
+
if (text[j + 1] === "*") {
|
|
48
|
+
const isSegment = (j === 0 || text[j - 1] === "/") && text[j + 2] === "/";
|
|
49
|
+
if (isSegment) {
|
|
50
|
+
// "**/" — ноль или более сегментов пути.
|
|
51
|
+
result += "(?:[^/]+/)*";
|
|
52
|
+
j += 3;
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
if (j > 0 && text[j - 1] === "/") {
|
|
56
|
+
result += "(?:[^/]+/)*[^/]*";
|
|
57
|
+
} else {
|
|
58
|
+
result += ".*";
|
|
59
|
+
}
|
|
60
|
+
j += 2;
|
|
61
|
+
continue;
|
|
62
|
+
}
|
|
63
|
+
result += "[^/]*";
|
|
64
|
+
j += 1;
|
|
65
|
+
continue;
|
|
66
|
+
}
|
|
67
|
+
if (ch === "?") {
|
|
68
|
+
result += "[^/]";
|
|
69
|
+
j += 1;
|
|
70
|
+
continue;
|
|
71
|
+
}
|
|
72
|
+
if (ch === "[") {
|
|
73
|
+
const close = text.indexOf("]", j + 1);
|
|
74
|
+
if (close === -1) {
|
|
75
|
+
result += "\\[";
|
|
76
|
+
j += 1;
|
|
77
|
+
continue;
|
|
78
|
+
}
|
|
79
|
+
let body = text.slice(j + 1, close);
|
|
80
|
+
if (body.startsWith("!")) body = `^${body.slice(1)}`;
|
|
81
|
+
else if (body.startsWith("^")) body = `\\${body}`;
|
|
82
|
+
result += `[${body}]`;
|
|
83
|
+
j = close + 1;
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
if (ch === "{") {
|
|
87
|
+
// Находим парную закрывающую скобку.
|
|
88
|
+
let depth = 0;
|
|
89
|
+
let end = -1;
|
|
90
|
+
for (let k = j; k < text.length; k++) {
|
|
91
|
+
if (text[k] === "{") depth++;
|
|
92
|
+
else if (text[k] === "}") {
|
|
93
|
+
depth--;
|
|
94
|
+
if (depth === 0) {
|
|
95
|
+
end = k;
|
|
96
|
+
break;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
if (end === -1) {
|
|
101
|
+
result += "\\{";
|
|
102
|
+
j += 1;
|
|
103
|
+
continue;
|
|
104
|
+
}
|
|
105
|
+
const body = text.slice(j + 1, end);
|
|
106
|
+
const parts = splitAlternatives(body);
|
|
107
|
+
result += `(?:${parts.map((part) => compile(part)).join("|")})`;
|
|
108
|
+
j = end + 1;
|
|
109
|
+
continue;
|
|
110
|
+
}
|
|
111
|
+
if (ch === "}") {
|
|
112
|
+
result += "\\}";
|
|
113
|
+
j += 1;
|
|
114
|
+
continue;
|
|
115
|
+
}
|
|
116
|
+
result += escapeRe(ch);
|
|
117
|
+
j += 1;
|
|
118
|
+
}
|
|
119
|
+
return result;
|
|
120
|
+
};
|
|
121
|
+
|
|
122
|
+
out += compile(source);
|
|
123
|
+
out += "$";
|
|
124
|
+
return new RegExp(out, WINDOWS ? "i" : "");
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/** Разбивает "{a,b,c}" по запятым верхнего уровня. */
|
|
128
|
+
function splitAlternatives(body: string): string[] {
|
|
129
|
+
const parts: string[] = [];
|
|
130
|
+
let depth = 0;
|
|
131
|
+
let current = "";
|
|
132
|
+
for (const ch of body) {
|
|
133
|
+
if (ch === "{") depth++;
|
|
134
|
+
if (ch === "}") depth--;
|
|
135
|
+
if (ch === "," && depth === 0) {
|
|
136
|
+
parts.push(current);
|
|
137
|
+
current = "";
|
|
138
|
+
continue;
|
|
139
|
+
}
|
|
140
|
+
current += ch;
|
|
141
|
+
}
|
|
142
|
+
parts.push(current);
|
|
143
|
+
return parts;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/** true, если путь матчится хотя бы одной маске. */
|
|
147
|
+
export function matchesGlob(path: unknown, pattern: unknown): boolean {
|
|
148
|
+
const candidate = normalizePath(path);
|
|
149
|
+
if (!candidate) return false;
|
|
150
|
+
const re = globToRegExp(pattern);
|
|
151
|
+
if (re.test(candidate)) return true;
|
|
152
|
+
// Маска каталога "src/**" должна матчить и сам "src".
|
|
153
|
+
const raw = normalizePath(pattern).replace(/\/$/, "");
|
|
154
|
+
if (raw.endsWith("/**")) {
|
|
155
|
+
return globToRegExp(raw.slice(0, -3)).test(candidate);
|
|
156
|
+
}
|
|
157
|
+
return false;
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
/**
|
|
161
|
+
* Проверяет путь по списку масок с поддержкой отрицаний.
|
|
162
|
+
* `!pattern` исключает совпадение; порядок важен (последнее правило побеждает).
|
|
163
|
+
*/
|
|
164
|
+
export function matchesAnyGlob(path: unknown, patterns: unknown): boolean {
|
|
165
|
+
if (!Array.isArray(patterns)) return false;
|
|
166
|
+
let matched = false;
|
|
167
|
+
for (const pattern of patterns) {
|
|
168
|
+
const text = String(pattern ?? "").trim();
|
|
169
|
+
if (!text) continue;
|
|
170
|
+
if (text.startsWith("!")) {
|
|
171
|
+
if (matchesGlob(path, text.slice(1))) matched = false;
|
|
172
|
+
} else if (matchesGlob(path, text)) {
|
|
173
|
+
matched = true;
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
return matched;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/** true, если путь не попал ни в одну маску из ignore-списка (или список пуст). */
|
|
180
|
+
export function isIgnored(path: unknown, ignore: unknown): boolean {
|
|
181
|
+
if (!Array.isArray(ignore) || ignore.length === 0) return false;
|
|
182
|
+
const candidate = normalizePath(path);
|
|
183
|
+
for (const pattern of ignore) {
|
|
184
|
+
const text = String(pattern ?? "").trim();
|
|
185
|
+
if (!text) continue;
|
|
186
|
+
if (text.startsWith("!")) continue;
|
|
187
|
+
if (matchesGlob(candidate, text)) return true;
|
|
188
|
+
}
|
|
189
|
+
return false;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* Отбирает файлы по include-маскам с учётом ignore-списка.
|
|
194
|
+
* Пустой include-список означает «любой файл».
|
|
195
|
+
*/
|
|
196
|
+
export function filterPaths(
|
|
197
|
+
files: string[],
|
|
198
|
+
include?: string[] | null,
|
|
199
|
+
ignore?: string[] | null
|
|
200
|
+
): string[] {
|
|
201
|
+
const list = Array.isArray(files) ? files : [];
|
|
202
|
+
const includes = Array.isArray(include) ? include.filter(Boolean) : [];
|
|
203
|
+
return list.filter((file) => {
|
|
204
|
+
const path = normalizePath(file);
|
|
205
|
+
if (!path) return false;
|
|
206
|
+
if (isIgnored(path, ignore)) return false;
|
|
207
|
+
if (includes.length === 0) return true;
|
|
208
|
+
return matchesAnyGlob(path, includes);
|
|
209
|
+
});
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/** Относительный путь файла от каталога; null, если файл вне каталога. */
|
|
213
|
+
export function relativeTo(base: unknown, file: unknown): string | null {
|
|
214
|
+
const root = normalizePath(base).replace(/\/$/, "");
|
|
215
|
+
const target = normalizePath(file);
|
|
216
|
+
if (!root) return target;
|
|
217
|
+
if (target === root) return "";
|
|
218
|
+
const prefix = root.endsWith("/") ? root : `${root}/`;
|
|
219
|
+
if (WINDOWS) {
|
|
220
|
+
if (target.toLowerCase().startsWith(prefix.toLowerCase())) {
|
|
221
|
+
return target.slice(prefix.length);
|
|
222
|
+
}
|
|
223
|
+
return null;
|
|
224
|
+
}
|
|
225
|
+
return target.startsWith(prefix) ? target.slice(prefix.length) : null;
|
|
226
|
+
}
|
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
TriageFallback,
|
|
3
|
+
TriageMode,
|
|
4
|
+
TriageSettings,
|
|
5
|
+
TriageShadowSettings,
|
|
6
|
+
} from "../settings.js";
|
|
7
|
+
import { DEFAULT_SHADOW_DAYS, isShadowActive } from "../settings.js";
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Настройки локального ассистента (Спринт 30.7 `manage_local_ai`).
|
|
11
|
+
*
|
|
12
|
+
* Здесь только чистые функции: слияние патча с текущими настройками
|
|
13
|
+
* триажа, нормализация значений и человекочитаемая сводка. Никаких
|
|
14
|
+
* сетевых вызовов и записи на диск — их делают инструмент и GUI.
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
export const LOCAL_AI_TIMEOUT_MIN = 1_000;
|
|
18
|
+
export const LOCAL_AI_TIMEOUT_MAX = 120_000;
|
|
19
|
+
export const LOCAL_AI_SELF_TEST_PROMPT =
|
|
20
|
+
"Тест связи: задача завершилась ошибкой Quality Gate (2 упавших теста).";
|
|
21
|
+
|
|
22
|
+
/** Патч настроек: любое подмножество полей. */
|
|
23
|
+
export interface LocalAiPatch {
|
|
24
|
+
mode?: TriageMode;
|
|
25
|
+
baseUrl?: string;
|
|
26
|
+
model?: string;
|
|
27
|
+
timeoutMs?: number;
|
|
28
|
+
fallback?: TriageFallback;
|
|
29
|
+
confidenceThreshold?: number;
|
|
30
|
+
shadow?: Partial<TriageShadowSettings>;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** Сводка настроек для ответа инструмента и GUI. */
|
|
34
|
+
export interface LocalAiSummary {
|
|
35
|
+
mode: TriageMode;
|
|
36
|
+
baseUrl: string;
|
|
37
|
+
model: string;
|
|
38
|
+
timeoutMs: number;
|
|
39
|
+
fallback: TriageFallback;
|
|
40
|
+
confidenceThreshold: number;
|
|
41
|
+
/** Сколько пользовательских правил задано; null — встроенный набор. */
|
|
42
|
+
rules: number | null;
|
|
43
|
+
shadow: TriageShadowSettings;
|
|
44
|
+
/** Триаж реально спрашивает модель (mode llm/auto и заполнены baseUrl+model). */
|
|
45
|
+
llmReady: boolean;
|
|
46
|
+
/** Идёт shadow-период: решения пишутся в отчёт, но не подавляют. */
|
|
47
|
+
shadowActive: boolean;
|
|
48
|
+
/** Протокол по baseUrl: `.../v1` — OpenAI-совместимый, иначе Ollama. */
|
|
49
|
+
protocol: "openai" | "ollama";
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
function clamp(value: number, min: number, max: number, fallback: number): number {
|
|
53
|
+
if (!Number.isFinite(value)) return fallback;
|
|
54
|
+
return Math.min(max, Math.max(min, Math.round(value)));
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function trimUrl(value: string): string {
|
|
58
|
+
return value.trim().replace(/\/+$/, "");
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** Протокол по базовому URL — то же правило, что в `classifyNotification`. */
|
|
62
|
+
export function protocolFor(baseUrl: string): "openai" | "ollama" {
|
|
63
|
+
const trimmed = trimUrl(baseUrl);
|
|
64
|
+
return /\/v1$/i.test(trimmed) ? "openai" : "ollama";
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* Сливает патч с текущими настройками. Возвращает новые настройки и
|
|
69
|
+
* список имён изменённых полей (для ответа инструмента и аудита).
|
|
70
|
+
*/
|
|
71
|
+
export function applyLocalAiPatch(
|
|
72
|
+
current: TriageSettings,
|
|
73
|
+
patch: LocalAiPatch
|
|
74
|
+
): { settings: TriageSettings; changed: string[] } {
|
|
75
|
+
const next: TriageSettings = { ...current, shadow: { ...current.shadow } as TriageShadowSettings };
|
|
76
|
+
const changed: string[] = [];
|
|
77
|
+
|
|
78
|
+
if (patch.mode !== undefined && patch.mode !== current.mode) {
|
|
79
|
+
next.mode = patch.mode;
|
|
80
|
+
changed.push("mode");
|
|
81
|
+
}
|
|
82
|
+
if (patch.baseUrl !== undefined) {
|
|
83
|
+
const baseUrl = trimUrl(patch.baseUrl);
|
|
84
|
+
if (baseUrl !== current.baseUrl) {
|
|
85
|
+
next.baseUrl = baseUrl;
|
|
86
|
+
changed.push("baseUrl");
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
if (patch.model !== undefined) {
|
|
90
|
+
const model = patch.model.trim().slice(0, 200);
|
|
91
|
+
if (model !== current.model) {
|
|
92
|
+
next.model = model;
|
|
93
|
+
changed.push("model");
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
if (patch.timeoutMs !== undefined) {
|
|
97
|
+
const timeoutMs = clamp(
|
|
98
|
+
patch.timeoutMs,
|
|
99
|
+
LOCAL_AI_TIMEOUT_MIN,
|
|
100
|
+
LOCAL_AI_TIMEOUT_MAX,
|
|
101
|
+
current.timeoutMs
|
|
102
|
+
);
|
|
103
|
+
if (timeoutMs !== current.timeoutMs) {
|
|
104
|
+
next.timeoutMs = timeoutMs;
|
|
105
|
+
changed.push("timeoutMs");
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
if (patch.fallback !== undefined && patch.fallback !== current.fallback) {
|
|
109
|
+
next.fallback = patch.fallback;
|
|
110
|
+
changed.push("fallback");
|
|
111
|
+
}
|
|
112
|
+
if (patch.confidenceThreshold !== undefined) {
|
|
113
|
+
const threshold = clamp(patch.confidenceThreshold, 0, 1, current.confidenceThreshold);
|
|
114
|
+
if (threshold !== current.confidenceThreshold) {
|
|
115
|
+
next.confidenceThreshold = threshold;
|
|
116
|
+
changed.push("confidenceThreshold");
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
const shadow = next.shadow ?? {
|
|
120
|
+
enabled: false,
|
|
121
|
+
days: DEFAULT_SHADOW_DAYS,
|
|
122
|
+
startedAt: null,
|
|
123
|
+
};
|
|
124
|
+
const shadowPatch = patch.shadow;
|
|
125
|
+
if (shadowPatch && typeof shadowPatch === "object") {
|
|
126
|
+
if (shadowPatch.enabled !== undefined && Boolean(shadowPatch.enabled) !== shadow.enabled) {
|
|
127
|
+
shadow.enabled = Boolean(shadowPatch.enabled);
|
|
128
|
+
changed.push("shadow.enabled");
|
|
129
|
+
}
|
|
130
|
+
if (shadowPatch.days !== undefined) {
|
|
131
|
+
const days = clamp(shadowPatch.days, 1, 365, shadow.days);
|
|
132
|
+
if (days !== shadow.days) {
|
|
133
|
+
shadow.days = days;
|
|
134
|
+
changed.push("shadow.days");
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
if (shadowPatch.startedAt !== undefined && shadowPatch.startedAt !== shadow.startedAt) {
|
|
138
|
+
shadow.startedAt = shadowPatch.startedAt;
|
|
139
|
+
changed.push("shadow.startedAt");
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
next.shadow = shadow;
|
|
143
|
+
|
|
144
|
+
return { settings: next, changed };
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/** Компактная сводка настроек для ответа инструмента. */
|
|
148
|
+
export function summarizeLocalAi(settings: TriageSettings): LocalAiSummary {
|
|
149
|
+
const shadow = settings.shadow ?? {
|
|
150
|
+
enabled: false,
|
|
151
|
+
days: DEFAULT_SHADOW_DAYS,
|
|
152
|
+
startedAt: null,
|
|
153
|
+
};
|
|
154
|
+
const baseUrl = settings.baseUrl ?? "";
|
|
155
|
+
const model = settings.model ?? "";
|
|
156
|
+
return {
|
|
157
|
+
mode: settings.mode,
|
|
158
|
+
baseUrl,
|
|
159
|
+
model,
|
|
160
|
+
timeoutMs: settings.timeoutMs,
|
|
161
|
+
fallback: settings.fallback,
|
|
162
|
+
confidenceThreshold: settings.confidenceThreshold,
|
|
163
|
+
rules: Array.isArray(settings.rules) ? settings.rules.length : null,
|
|
164
|
+
shadow,
|
|
165
|
+
llmReady:
|
|
166
|
+
settings.mode !== "off" &&
|
|
167
|
+
settings.mode !== "rules" &&
|
|
168
|
+
baseUrl.trim().length > 0 &&
|
|
169
|
+
model.trim().length > 0,
|
|
170
|
+
shadowActive: isShadowActive(shadow),
|
|
171
|
+
protocol: protocolFor(baseUrl),
|
|
172
|
+
};
|
|
173
|
+
}
|
package/src/core/lock.ts
ADDED
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
import fs from "node:fs/promises";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { LOCK_DIR, STALE_LOCK_MAX_AGE_MS } from "../types.js";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
|
|
7
|
+
*
|
|
8
|
+
* Блокировка реализуется через атомарное создание файла с флагом 'wx' (exclusive create).
|
|
9
|
+
* Если файл уже существует — блокировка удерживается другим запуском.
|
|
10
|
+
* После завершения задачи файл удаляется.
|
|
11
|
+
* Зависшие блокировки (старше STALE_LOCK_MAX_AGE_MS) удаляются при инициализации.
|
|
12
|
+
*/
|
|
13
|
+
export class LockManager {
|
|
14
|
+
private readonly lockDir: string;
|
|
15
|
+
|
|
16
|
+
constructor(lockDir: string = LOCK_DIR) {
|
|
17
|
+
this.lockDir = lockDir;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** Имя lock-файла для задачи. */
|
|
21
|
+
private lockFileName(taskName: string): string {
|
|
22
|
+
return `${taskName}.lock`;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** Полный путь к lock-файлу задачи. */
|
|
26
|
+
private lockFilePath(taskName: string): string {
|
|
27
|
+
return path.join(this.lockDir, this.lockFileName(taskName));
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Публичный путь к lock-файлу (для ожидания/вытеснения зависших lock). */
|
|
31
|
+
pathFor(taskName: string): string {
|
|
32
|
+
return this.lockFilePath(taskName);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Инициализация директории блокировок и очистка зависших (старых) файлов.
|
|
37
|
+
* Вызывается при старте плагина.
|
|
38
|
+
*/
|
|
39
|
+
async initialize(): Promise<void> {
|
|
40
|
+
await fs.mkdir(this.lockDir, { recursive: true });
|
|
41
|
+
|
|
42
|
+
const files = await fs.readdir(this.lockDir).catch(() => []);
|
|
43
|
+
const now = Date.now();
|
|
44
|
+
|
|
45
|
+
for (const file of files) {
|
|
46
|
+
const fullPath = path.join(this.lockDir, file);
|
|
47
|
+
// Каталог <task>.lock.d держит POSIX-обёртка (mkdir-блокировка).
|
|
48
|
+
// После kill -9 он остаётся навсегда, поэтому чистим его так же, как .lock.
|
|
49
|
+
const isLockFile = file.endsWith(".lock");
|
|
50
|
+
const isLockDir = file.endsWith(".lock.d");
|
|
51
|
+
const isStaleArtifact = /\.lock(\.d)?\.stale-/.test(file);
|
|
52
|
+
if (!isLockFile && !isLockDir && !isStaleArtifact) continue;
|
|
53
|
+
try {
|
|
54
|
+
// Артефакт предыдущего вытеснения валидным lock быть не может,
|
|
55
|
+
// поэтому убираем его независимо от возраста.
|
|
56
|
+
if (isStaleArtifact) {
|
|
57
|
+
await fs.rm(fullPath, { recursive: true, force: true }).catch(() => {});
|
|
58
|
+
continue;
|
|
59
|
+
}
|
|
60
|
+
const stat = await fs.stat(fullPath);
|
|
61
|
+
const age = now - stat.mtimeMs;
|
|
62
|
+
if (age > STALE_LOCK_MAX_AGE_MS) {
|
|
63
|
+
// T-03: не удаляем lock напрямую. Два воркера могли одновременно
|
|
64
|
+
// снести один и тот же файл, после чего один из них удалял свежий
|
|
65
|
+
// lock, созданный другим, и задача запускалась повторно. Атомарный
|
|
66
|
+
// rename в уникальное имя выигрывает только один процесс; второй
|
|
67
|
+
// получает ENOENT и не трогает чужой lock.
|
|
68
|
+
const stalePath = `${fullPath}.stale-${process.pid}-${Date.now()}`;
|
|
69
|
+
try {
|
|
70
|
+
await fs.rename(fullPath, stalePath);
|
|
71
|
+
} catch {
|
|
72
|
+
continue;
|
|
73
|
+
}
|
|
74
|
+
await fs.rm(stalePath, { recursive: true, force: true }).catch(() => {});
|
|
75
|
+
// eslint-disable-next-line no-console
|
|
76
|
+
console.log(
|
|
77
|
+
`[windows-scheduler] Вытеснен зависший lock: ${file} (возраст ${Math.round(
|
|
78
|
+
age / 1000
|
|
79
|
+
)} с)`
|
|
80
|
+
);
|
|
81
|
+
}
|
|
82
|
+
} catch {
|
|
83
|
+
// Игнорируем ошибки чтения отдельных файлов при очистке.
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Пытается захватить блокировку для задачи.
|
|
90
|
+
* Возвращает true, если блокировка захвачена (файл создан).
|
|
91
|
+
* Возвращает false, если блокировка уже удерживается другим запуском.
|
|
92
|
+
*/
|
|
93
|
+
async acquire(taskName: string): Promise<boolean> {
|
|
94
|
+
await fs.mkdir(this.lockDir, { recursive: true });
|
|
95
|
+
const lockPath = this.lockFilePath(taskName);
|
|
96
|
+
|
|
97
|
+
try {
|
|
98
|
+
// 'wx' — exclusive create: ошибка если файл уже существует.
|
|
99
|
+
await fs.writeFile(lockPath, String(Date.now()), { flag: "wx" });
|
|
100
|
+
return true;
|
|
101
|
+
} catch (err: any) {
|
|
102
|
+
if (err.code === "EEXIST") {
|
|
103
|
+
return false;
|
|
104
|
+
}
|
|
105
|
+
throw err;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Освобождает блокировку задачи (удаляет lock-файл).
|
|
111
|
+
* Не выбрасывает ошибку, если файл уже удалён.
|
|
112
|
+
*/
|
|
113
|
+
async release(taskName: string): Promise<void> {
|
|
114
|
+
const lockPath = this.lockFilePath(taskName);
|
|
115
|
+
try {
|
|
116
|
+
await fs.unlink(lockPath);
|
|
117
|
+
} catch (err: any) {
|
|
118
|
+
if (err.code !== "ENOENT") throw err;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* Проверяет, удерживается ли блокировка задачей в данный момент.
|
|
124
|
+
*/
|
|
125
|
+
async isLocked(taskName: string): Promise<boolean> {
|
|
126
|
+
const lockPath = this.lockFilePath(taskName);
|
|
127
|
+
try {
|
|
128
|
+
await fs.stat(lockPath);
|
|
129
|
+
return true;
|
|
130
|
+
} catch (err: any) {
|
|
131
|
+
if (err.code === "ENOENT") return false;
|
|
132
|
+
throw err;
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* Выполняет функцию с захватом файловых блокировок.
|
|
139
|
+
* Если блокировка уже удерживается — пропускает выполнение и возвращает null.
|
|
140
|
+
* Гарантирует освобождение блокировки в finally (включая при ошибках).
|
|
141
|
+
*/
|
|
142
|
+
export async function withLock<T>(
|
|
143
|
+
lockManager: LockManager,
|
|
144
|
+
taskName: string,
|
|
145
|
+
fn: () => Promise<T>
|
|
146
|
+
): Promise<T | null> {
|
|
147
|
+
const acquired = await lockManager.acquire(taskName);
|
|
148
|
+
if (!acquired) {
|
|
149
|
+
// eslint-disable-next-line no-console
|
|
150
|
+
console.log(
|
|
151
|
+
`[windows-scheduler] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`
|
|
152
|
+
);
|
|
153
|
+
return null;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
try {
|
|
157
|
+
return await fn();
|
|
158
|
+
} finally {
|
|
159
|
+
await lockManager.release(taskName);
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* Выполняет функцию с ожиданием освобождения файловой блокировки.
|
|
165
|
+
* В отличие от withLock не пропускает выполнение, а ждёт: критично для
|
|
166
|
+
* read-modify-write операций (crontab), где пропуск ломает состояние.
|
|
167
|
+
* Если lock удерживается дольше staleMs — считается осиротевшим и вытесняется
|
|
168
|
+
* атомарным rename (как в T-03), чтобы зависший процесс не блокировал навсегда.
|
|
169
|
+
*/
|
|
170
|
+
export async function withLockWait<T>(
|
|
171
|
+
lockManager: LockManager,
|
|
172
|
+
taskName: string,
|
|
173
|
+
fn: () => Promise<T>,
|
|
174
|
+
options: { timeoutMs?: number; retryDelayMs?: number; staleMs?: number } = {}
|
|
175
|
+
): Promise<T> {
|
|
176
|
+
const timeoutMs = options.timeoutMs ?? 15000;
|
|
177
|
+
const retryDelayMs = options.retryDelayMs ?? 50;
|
|
178
|
+
const staleMs = options.staleMs ?? 60000;
|
|
179
|
+
const deadline = Date.now() + timeoutMs;
|
|
180
|
+
const lockPath = lockManager.pathFor(taskName);
|
|
181
|
+
|
|
182
|
+
for (;;) {
|
|
183
|
+
if (await lockManager.acquire(taskName)) break;
|
|
184
|
+
|
|
185
|
+
// Осиротевший lock: короткая операция не может длиться дольше staleMs.
|
|
186
|
+
if (staleMs > 0) {
|
|
187
|
+
try {
|
|
188
|
+
const stat = await fs.stat(lockPath);
|
|
189
|
+
if (Date.now() - stat.mtimeMs > staleMs) {
|
|
190
|
+
// T-03-совместимое вытеснение: атомарный rename выигрывает ровно
|
|
191
|
+
// один процесс, остальные получают ENOENT и повторяют попытку.
|
|
192
|
+
const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
|
|
193
|
+
try {
|
|
194
|
+
await fs.rename(lockPath, stalePath);
|
|
195
|
+
await fs.rm(stalePath, { force: true }).catch(() => {});
|
|
196
|
+
} catch {
|
|
197
|
+
// Кто-то успел раньше — просто повторяем acquire.
|
|
198
|
+
}
|
|
199
|
+
continue;
|
|
200
|
+
}
|
|
201
|
+
} catch {
|
|
202
|
+
// lock исчез — сразу пробуем acquire снова.
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
if (Date.now() >= deadline) {
|
|
207
|
+
throw new Error(
|
|
208
|
+
`Не удалось получить блокировку "${taskName}" за ${timeoutMs} мс.`
|
|
209
|
+
);
|
|
210
|
+
}
|
|
211
|
+
await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
try {
|
|
215
|
+
return await fn();
|
|
216
|
+
} finally {
|
|
217
|
+
await lockManager.release(taskName);
|
|
218
|
+
}
|
|
219
|
+
}
|