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
|
@@ -0,0 +1,447 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Dry-Run (Спринт 14): симуляция конвейера задачи без реального запуска.
|
|
3
|
+
*
|
|
4
|
+
* Строит топологический порядок зависимостей, показывает фактические команды,
|
|
5
|
+
* cwd, роли (ограничения инструментов) и оценки по последним запускам.
|
|
6
|
+
* Никогда не исполняет команды — только анализ определений.
|
|
7
|
+
*/
|
|
8
|
+
import fs from "node:fs";
|
|
9
|
+
import { loadTaskDefinitions } from "../task-transfer.js";
|
|
10
|
+
import { getHistory } from "../db/history-repo.js";
|
|
11
|
+
import { getWorkspace } from "../workspaces.js";
|
|
12
|
+
import { expandMatrixTask } from "./matrix.js";
|
|
13
|
+
import { nextRun, activeWindowState } from "./schedule-v2.js";
|
|
14
|
+
import { checkGitTrigger } from "./git-trigger.js";
|
|
15
|
+
import { t } from "../i18n.js";
|
|
16
|
+
/** Сколько последних успешных/любых запусков усредняем для оценки. */
|
|
17
|
+
const ESTIMATE_SAMPLE = 10;
|
|
18
|
+
/** Средняя цена за 1K токенов (должна совпадать с dashboards/server.ts). */
|
|
19
|
+
export const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
|
|
20
|
+
/** Опасные паттерны, о которых обязательно предупреждаем (ключи каталога). */
|
|
21
|
+
const DANGEROUS_PATTERNS = [
|
|
22
|
+
{ test: /rm\s+-rf\s+\/(?:\s|$)/, messageKey: "dryRun.danger.rmRoot" },
|
|
23
|
+
{ test: /git\s+push\s+.*--force(?:\s|$)/, messageKey: "dryRun.danger.forcePush" },
|
|
24
|
+
];
|
|
25
|
+
/**
|
|
26
|
+
* Описывает триггер задачи: что запускает задачу, не будет ли запуск
|
|
27
|
+
* пропущен из-за окна/дней недели, и (для git) состояние репозитория.
|
|
28
|
+
* Не имеет побочных эффектов (для git используется persist: false).
|
|
29
|
+
*/
|
|
30
|
+
async function describeTrigger(opts) {
|
|
31
|
+
const { def, cwd, triggerType, warnings } = opts;
|
|
32
|
+
const policy = def.windowPolicy ?? "postpone";
|
|
33
|
+
const base = {
|
|
34
|
+
type: triggerType,
|
|
35
|
+
explanation: "",
|
|
36
|
+
};
|
|
37
|
+
const hasWindow = Boolean((def.notBefore ?? "").trim() || (def.notAfter ?? "").trim());
|
|
38
|
+
const hasDays = Array.isArray(def.activeDays) && def.activeDays.length > 0;
|
|
39
|
+
switch (triggerType) {
|
|
40
|
+
case "git": {
|
|
41
|
+
try {
|
|
42
|
+
const result = await checkGitTrigger({
|
|
43
|
+
name: def.name,
|
|
44
|
+
cwd,
|
|
45
|
+
branch: def.gitBranch ?? undefined,
|
|
46
|
+
paths: def.gitPaths ?? undefined,
|
|
47
|
+
ignore: def.gitIgnore ?? undefined,
|
|
48
|
+
}, { persist: false });
|
|
49
|
+
base.git = {
|
|
50
|
+
branch: result.branch ?? null,
|
|
51
|
+
head: result.head ?? null,
|
|
52
|
+
lastCommit: result.from ?? null,
|
|
53
|
+
changedFiles: result.files,
|
|
54
|
+
matched: result.matched,
|
|
55
|
+
};
|
|
56
|
+
base.explanation = result.message;
|
|
57
|
+
if (result.status === "no-repo") {
|
|
58
|
+
warnings.push(t("dryRun.git.notRepo"));
|
|
59
|
+
}
|
|
60
|
+
else if (result.status === "branch-mismatch") {
|
|
61
|
+
warnings.push(t("dryRun.git.branchMismatch", { branch: def.gitBranch ?? "" }));
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
catch (err) {
|
|
65
|
+
base.explanation = t("dryRun.git.checkError", {
|
|
66
|
+
error: err instanceof Error ? err.message : String(err),
|
|
67
|
+
});
|
|
68
|
+
warnings.push(base.explanation);
|
|
69
|
+
}
|
|
70
|
+
break;
|
|
71
|
+
}
|
|
72
|
+
case "file": {
|
|
73
|
+
base.file = {
|
|
74
|
+
watchPath: def.watchPath ?? null,
|
|
75
|
+
globs: Array.isArray(def.watchGlobs) ? def.watchGlobs : [],
|
|
76
|
+
ignore: Array.isArray(def.watchIgnore) ? def.watchIgnore : [],
|
|
77
|
+
};
|
|
78
|
+
const parts = [];
|
|
79
|
+
if (def.watchPath)
|
|
80
|
+
parts.push(`«${def.watchPath}»`);
|
|
81
|
+
if (def.watchGlobs?.length)
|
|
82
|
+
parts.push(t("dryRun.file.globs", { count: def.watchGlobs.length }));
|
|
83
|
+
if (def.watchIgnore?.length)
|
|
84
|
+
parts.push(t("dryRun.file.ignore", { count: def.watchIgnore.length }));
|
|
85
|
+
base.explanation =
|
|
86
|
+
parts.length > 0
|
|
87
|
+
? t("dryRun.file.trigger", { parts: parts.join("; ") })
|
|
88
|
+
: t("dryRun.file.any");
|
|
89
|
+
break;
|
|
90
|
+
}
|
|
91
|
+
case "mcp-event": {
|
|
92
|
+
const ev = def.mcpEvent;
|
|
93
|
+
base.explanation = ev && ev.event
|
|
94
|
+
? t("dryRun.mcp.event", {
|
|
95
|
+
server: ev.server,
|
|
96
|
+
event: ev.event,
|
|
97
|
+
filter: ev.filter
|
|
98
|
+
? t("dryRun.mcp.filter", { filter: ev.filter })
|
|
99
|
+
: "",
|
|
100
|
+
})
|
|
101
|
+
: t("dryRun.mcp.missing");
|
|
102
|
+
break;
|
|
103
|
+
}
|
|
104
|
+
case "cron": {
|
|
105
|
+
base.explanation = def.timezone
|
|
106
|
+
? t("dryRun.cronTimezone", {
|
|
107
|
+
schedule: def.schedule,
|
|
108
|
+
timezone: def.timezone,
|
|
109
|
+
})
|
|
110
|
+
: t("dryRun.cron", { schedule: def.schedule });
|
|
111
|
+
break;
|
|
112
|
+
}
|
|
113
|
+
case "once": {
|
|
114
|
+
base.explanation = def.runAt
|
|
115
|
+
? t("dryRun.once.at", { runAt: def.runAt })
|
|
116
|
+
: t("dryRun.once");
|
|
117
|
+
break;
|
|
118
|
+
}
|
|
119
|
+
case "manual":
|
|
120
|
+
default: {
|
|
121
|
+
base.explanation = t("dryRun.manual");
|
|
122
|
+
break;
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
// Окно запуска и дни недели (если заданы).
|
|
126
|
+
if (hasWindow || hasDays) {
|
|
127
|
+
const state = activeWindowState(new Date(), {
|
|
128
|
+
notBefore: def.notBefore ?? undefined,
|
|
129
|
+
notAfter: def.notAfter ?? undefined,
|
|
130
|
+
days: def.activeDays ?? undefined,
|
|
131
|
+
timeZone: def.timezone ?? undefined,
|
|
132
|
+
});
|
|
133
|
+
base.activeWindow = {
|
|
134
|
+
active: state.active,
|
|
135
|
+
...(state.reason ? { reason: state.reason } : {}),
|
|
136
|
+
nextOpenAt: state.nextOpenAt ? state.nextOpenAt.toISOString() : null,
|
|
137
|
+
};
|
|
138
|
+
if (!state.active && policy !== "run") {
|
|
139
|
+
const reason = state.reason ?? t("dryRun.window.outside");
|
|
140
|
+
if (policy === "skip") {
|
|
141
|
+
warnings.push(t("dryRun.window.skip", { reason }));
|
|
142
|
+
}
|
|
143
|
+
else {
|
|
144
|
+
// postpone — переносим на ближайшее открытие.
|
|
145
|
+
const iso = base.activeWindow.nextOpenAt ?? null;
|
|
146
|
+
warnings.push(iso
|
|
147
|
+
? t("dryRun.window.postpone", { reason, nextOpenAt: iso })
|
|
148
|
+
: t("dryRun.window.noOpening", { reason }));
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
else if (!state.active && policy === "run") {
|
|
152
|
+
warnings.push(t("dryRun.window.run", {
|
|
153
|
+
reason: state.reason ?? t("dryRun.window.outside"),
|
|
154
|
+
}));
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
return base;
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* Симулирует конвейер задачи: сама задача + все зависимости (dependsOn)
|
|
161
|
+
* в топологическом порядке. Возвращает отчёт без реального запуска.
|
|
162
|
+
*/
|
|
163
|
+
export async function simulatePipeline(taskName) {
|
|
164
|
+
const warnings = [];
|
|
165
|
+
const allDefs = await loadTaskDefinitions();
|
|
166
|
+
const rootLower = taskName.trim().toLowerCase();
|
|
167
|
+
const root = allDefs.find((d) => d.name.toLowerCase() === rootLower);
|
|
168
|
+
if (!root) {
|
|
169
|
+
throw new Error(t("dryRun.taskNotFound", { task: taskName }));
|
|
170
|
+
}
|
|
171
|
+
// Собираем подграф зависимостей рекурсивно, обнаруживая циклы.
|
|
172
|
+
const byLower = new Map(allDefs.map((d) => [d.name.toLowerCase(), d]));
|
|
173
|
+
const visited = new Map(); // lower -> def
|
|
174
|
+
const visiting = new Set();
|
|
175
|
+
const warningsPerTask = new Map();
|
|
176
|
+
const collect = (lowerName) => {
|
|
177
|
+
if (visiting.has(lowerName)) {
|
|
178
|
+
const list = warningsPerTask.get(lowerName) ?? [];
|
|
179
|
+
list.push(t("dryRun.cycle", { task: lowerName }));
|
|
180
|
+
warningsPerTask.set(lowerName, list);
|
|
181
|
+
return undefined;
|
|
182
|
+
}
|
|
183
|
+
const cached = visited.get(lowerName);
|
|
184
|
+
if (cached)
|
|
185
|
+
return cached;
|
|
186
|
+
const def = byLower.get(lowerName);
|
|
187
|
+
if (!def) {
|
|
188
|
+
const list = warningsPerTask.get(lowerName) ?? [];
|
|
189
|
+
list.push(t("dryRun.dependencyMissing", { task: lowerName }));
|
|
190
|
+
warningsPerTask.set(lowerName, list);
|
|
191
|
+
return undefined;
|
|
192
|
+
}
|
|
193
|
+
visiting.add(lowerName);
|
|
194
|
+
for (const dep of def.dependsOn ?? []) {
|
|
195
|
+
const depLower = (dep ?? "").trim().toLowerCase();
|
|
196
|
+
if (depLower)
|
|
197
|
+
collect(depLower);
|
|
198
|
+
}
|
|
199
|
+
visiting.delete(lowerName);
|
|
200
|
+
visited.set(lowerName, def);
|
|
201
|
+
return def;
|
|
202
|
+
};
|
|
203
|
+
collect(root.name.toLowerCase());
|
|
204
|
+
// Топологический порядок: сначала зависимости (Kahn поверх собранного подграфа).
|
|
205
|
+
const ordered = [];
|
|
206
|
+
{
|
|
207
|
+
const pending = [...visited.values()];
|
|
208
|
+
const emitted = new Set();
|
|
209
|
+
let progress = true;
|
|
210
|
+
while (pending.length > 0 && progress) {
|
|
211
|
+
progress = false;
|
|
212
|
+
for (let i = 0; i < pending.length; i++) {
|
|
213
|
+
const def = pending[i];
|
|
214
|
+
const deps = (def.dependsOn ?? []).map((d) => (d ?? "").trim().toLowerCase()).filter(Boolean);
|
|
215
|
+
const unmet = deps.filter((d) => visited.has(d) && !emitted.has(d));
|
|
216
|
+
if (unmet.length === 0) {
|
|
217
|
+
ordered.push(def);
|
|
218
|
+
emitted.add(def.name.toLowerCase());
|
|
219
|
+
pending.splice(i, 1);
|
|
220
|
+
i--;
|
|
221
|
+
progress = true;
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
// Если остались (цикл), добавляем как есть — предупреждение уже записано.
|
|
226
|
+
for (const leftover of pending)
|
|
227
|
+
ordered.push(leftover);
|
|
228
|
+
}
|
|
229
|
+
const history = getHistory(null, 1000);
|
|
230
|
+
const historyByTask = new Map();
|
|
231
|
+
for (const record of history) {
|
|
232
|
+
const list = historyByTask.get(record.taskName.toLowerCase()) ?? [];
|
|
233
|
+
list.push(record);
|
|
234
|
+
historyByTask.set(record.taskName.toLowerCase(), list);
|
|
235
|
+
}
|
|
236
|
+
const tasks = [];
|
|
237
|
+
let totalDuration = 0;
|
|
238
|
+
let totalCost = 0;
|
|
239
|
+
let totalTokens = 0;
|
|
240
|
+
// Matrix (Спринт 15): родитель сам не выполняется — вместо него в отчёте
|
|
241
|
+
// показываем клоны, по одному на workspace, с их cwd и оценками.
|
|
242
|
+
const units = [];
|
|
243
|
+
for (const def of ordered) {
|
|
244
|
+
if (def.matrix) {
|
|
245
|
+
try {
|
|
246
|
+
const clones = expandMatrixTask(def);
|
|
247
|
+
warnings.push(t("dryRun.matrix.parent", { name: def.name, count: clones.length }));
|
|
248
|
+
for (const clone of clones)
|
|
249
|
+
units.push({ def: clone, matrixParent: def.name });
|
|
250
|
+
}
|
|
251
|
+
catch (err) {
|
|
252
|
+
const list = warningsPerTask.get(def.name.toLowerCase()) ?? [];
|
|
253
|
+
list.push(t("dryRun.matrix.expandError", {
|
|
254
|
+
error: err instanceof Error ? err.message : String(err),
|
|
255
|
+
}));
|
|
256
|
+
warningsPerTask.set(def.name.toLowerCase(), list);
|
|
257
|
+
warnings.push(`[${def.name}] ${list[list.length - 1]}`);
|
|
258
|
+
}
|
|
259
|
+
continue;
|
|
260
|
+
}
|
|
261
|
+
units.push({ def });
|
|
262
|
+
}
|
|
263
|
+
// Родители матриц с параллельной стратегией: их клоны считаются max, не sum.
|
|
264
|
+
const parallelMatrixParents = new Set(allDefs
|
|
265
|
+
.filter((d) => d.matrix && (d.matrix.strategy ?? "parallel") !== "sequential")
|
|
266
|
+
.map((d) => d.name.toLowerCase()));
|
|
267
|
+
const parallelGroups = new Map();
|
|
268
|
+
for (let index = 0; index < units.length; index++) {
|
|
269
|
+
const { def, matrixParent } = units[index];
|
|
270
|
+
const lower = def.name.toLowerCase();
|
|
271
|
+
const taskWarnings = warningsPerTask.get(lower) ?? [];
|
|
272
|
+
// cwd: workspace имеет приоритет над workingDirectory (как в schedulerCreateTask).
|
|
273
|
+
const workspace = def.workspaceId ? getWorkspace(def.workspaceId) : undefined;
|
|
274
|
+
const cwd = workspace?.path || def.workingDirectory || def.workdir || "";
|
|
275
|
+
if (!cwd) {
|
|
276
|
+
taskWarnings.push(t("dryRun.cwdImplicit"));
|
|
277
|
+
}
|
|
278
|
+
else {
|
|
279
|
+
try {
|
|
280
|
+
const stat = fs.statSync(cwd);
|
|
281
|
+
if (!stat.isDirectory()) {
|
|
282
|
+
taskWarnings.push(t("dryRun.cwdNotDir", { path: cwd }));
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
catch {
|
|
286
|
+
taskWarnings.push(t("dryRun.cwdMissing", { path: cwd }));
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
// Триггер: корневая задача (или клон корневой матрицы) — manual,
|
|
290
|
+
// остальные попали в конвейер через dependsOn — dag.
|
|
291
|
+
const triggerType = def.triggerType ?? "cron";
|
|
292
|
+
const trigger = triggerType === "once"
|
|
293
|
+
? "once"
|
|
294
|
+
: lower === rootLower || (matrixParent && matrixParent.toLowerCase() === rootLower)
|
|
295
|
+
? "manual"
|
|
296
|
+
: "dag";
|
|
297
|
+
// Детали триггера (Спринт 27): состояние окна/дней недели, git-статус.
|
|
298
|
+
const triggerDetails = await describeTrigger({
|
|
299
|
+
def,
|
|
300
|
+
cwd,
|
|
301
|
+
triggerType,
|
|
302
|
+
warnings: taskWarnings,
|
|
303
|
+
});
|
|
304
|
+
// Команда, которую выполнит обёртка.
|
|
305
|
+
const modelArg = def.model ? ` --model ${def.model}` : "";
|
|
306
|
+
const promptPreview = (def.prompt ?? "").replace(/\s+/g, " ").trim();
|
|
307
|
+
const command = `opencode run${modelArg} "${promptPreview}"`;
|
|
308
|
+
// Оценки: среднее по последним ESTIMATE_SAMPLE записям истории.
|
|
309
|
+
const records = (historyByTask.get(lower) ?? []).filter((r) => r.status === "success");
|
|
310
|
+
let estimatedDurationSec = null;
|
|
311
|
+
let estimatedCostUsd = null;
|
|
312
|
+
let estimatedTokens = null;
|
|
313
|
+
if (records.length === 0) {
|
|
314
|
+
taskWarnings.push(t("dryRun.noHistory"));
|
|
315
|
+
}
|
|
316
|
+
else {
|
|
317
|
+
const sample = records.slice(0, ESTIMATE_SAMPLE);
|
|
318
|
+
const avg = (pick) => {
|
|
319
|
+
const values = sample.map(pick).filter((v) => typeof v === "number" && Number.isFinite(v));
|
|
320
|
+
return values.length > 0 ? values.reduce((a, b) => a + b, 0) / values.length : null;
|
|
321
|
+
};
|
|
322
|
+
const avgMs = avg((r) => r.durationMs);
|
|
323
|
+
if (avgMs != null)
|
|
324
|
+
estimatedDurationSec = Math.round(avgMs / 100) / 10;
|
|
325
|
+
estimatedTokens = avg((r) => r.tokens) ?? null;
|
|
326
|
+
if (estimatedTokens != null) {
|
|
327
|
+
estimatedCostUsd = (estimatedTokens / 1000) * ESTIMATED_COST_PER_1K_TOKENS_USD;
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
// Проверяем опасные паттерны в промпте и хуках.
|
|
331
|
+
const scanned = [def.prompt, def.beforeScript, def.afterScript, def.qualityGate]
|
|
332
|
+
.filter((s) => typeof s === "string")
|
|
333
|
+
.join("\n")
|
|
334
|
+
.toLowerCase();
|
|
335
|
+
for (const { test, messageKey } of DANGEROUS_PATTERNS) {
|
|
336
|
+
if (test.test(scanned)) {
|
|
337
|
+
taskWarnings.push(t("dryRun.dangerPattern", { message: t(messageKey) }));
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
const roleScoped = Array.isArray(def.allowedTools) && def.allowedTools.length > 0
|
|
341
|
+
? { allowed: def.allowedTools, denied: def.deniedTools }
|
|
342
|
+
: Array.isArray(def.deniedTools) && def.deniedTools.length > 0
|
|
343
|
+
? { allowed: undefined, denied: def.deniedTools }
|
|
344
|
+
: null;
|
|
345
|
+
// Эффективное расписание cron-задачи (Спринт 19): ближайшие срабатывания
|
|
346
|
+
// считаем в часовом поясе задачи, чтобы dry-run показывал то же время, что
|
|
347
|
+
// увидит планировщик после регистрации.
|
|
348
|
+
let scheduleDetails;
|
|
349
|
+
if (triggerType === "once" && def.runAt) {
|
|
350
|
+
// Для разовой задачи dry-run показывает единственное запланированное время.
|
|
351
|
+
scheduleDetails = {
|
|
352
|
+
cron: "once",
|
|
353
|
+
timezone: def.timezone ?? null,
|
|
354
|
+
notBefore: def.notBefore ?? null,
|
|
355
|
+
notAfter: def.notAfter ?? null,
|
|
356
|
+
pausedUntil: def.pausedUntil ?? null,
|
|
357
|
+
nextRuns: [def.runAt],
|
|
358
|
+
};
|
|
359
|
+
}
|
|
360
|
+
else if (triggerType === "cron" && def.schedule) {
|
|
361
|
+
const runs = [];
|
|
362
|
+
try {
|
|
363
|
+
let cursor = new Date();
|
|
364
|
+
for (let i = 0; i < 3; i++) {
|
|
365
|
+
const next = nextRun(def.schedule, cursor, def.timezone);
|
|
366
|
+
if (!next)
|
|
367
|
+
break;
|
|
368
|
+
runs.push(next.toISOString());
|
|
369
|
+
cursor = next;
|
|
370
|
+
}
|
|
371
|
+
}
|
|
372
|
+
catch {
|
|
373
|
+
taskWarnings.push(t("dryRun.cronParseError", { schedule: def.schedule }));
|
|
374
|
+
}
|
|
375
|
+
scheduleDetails = {
|
|
376
|
+
cron: def.schedule,
|
|
377
|
+
timezone: def.timezone ?? null,
|
|
378
|
+
notBefore: def.notBefore ?? null,
|
|
379
|
+
notAfter: def.notAfter ?? null,
|
|
380
|
+
pausedUntil: def.pausedUntil ?? null,
|
|
381
|
+
nextRuns: runs,
|
|
382
|
+
};
|
|
383
|
+
}
|
|
384
|
+
tasks.push({
|
|
385
|
+
name: def.name,
|
|
386
|
+
order: index,
|
|
387
|
+
trigger,
|
|
388
|
+
session: def.session ?? "new",
|
|
389
|
+
sessionId: def.session === "reuse" ? def.sessionId ?? null : null,
|
|
390
|
+
// Спринт 27.5.4: показываем режим входа до регистрации в ОС.
|
|
391
|
+
runWhenLoggedOff: def.runWhenLoggedOff === true,
|
|
392
|
+
logonMode: def.runWhenLoggedOff === true ? "background" : "interactive",
|
|
393
|
+
cwd,
|
|
394
|
+
command,
|
|
395
|
+
workspace: workspace ? { name: workspace.name, path: workspace.path } : undefined,
|
|
396
|
+
preFlight: def.beforeScript ?? null,
|
|
397
|
+
postFlight: def.afterScript ?? null,
|
|
398
|
+
qualityGate: def.qualityGate ?? null,
|
|
399
|
+
roleScoped,
|
|
400
|
+
estimatedDurationSec,
|
|
401
|
+
estimatedCostUsd: estimatedCostUsd != null ? Math.round(estimatedCostUsd * 10000) / 10000 : null,
|
|
402
|
+
estimatedTokens: estimatedTokens != null ? Math.round(estimatedTokens) : null,
|
|
403
|
+
...(matrixParent ? { matrixParent } : {}),
|
|
404
|
+
...(scheduleDetails ? { scheduleDetails } : {}),
|
|
405
|
+
...(triggerDetails ? { triggerDetails } : {}),
|
|
406
|
+
});
|
|
407
|
+
if (taskWarnings.length > 0) {
|
|
408
|
+
for (const warning of taskWarnings) {
|
|
409
|
+
warnings.push(`[${def.name}] ${warning}`);
|
|
410
|
+
}
|
|
411
|
+
}
|
|
412
|
+
// Суммируем оценки (null не ломает сумму). Для параллельных матриц
|
|
413
|
+
// длительность берём максимумом по группе, а не суммой клонов.
|
|
414
|
+
if (matrixParent && parallelMatrixParents.has(matrixParent.toLowerCase())) {
|
|
415
|
+
const key = matrixParent.toLowerCase();
|
|
416
|
+
const current = parallelGroups.get(key) ?? { maxDuration: 0 };
|
|
417
|
+
current.maxDuration = Math.max(current.maxDuration, estimatedDurationSec ?? 0);
|
|
418
|
+
parallelGroups.set(key, current);
|
|
419
|
+
}
|
|
420
|
+
else if (totalDuration != null) {
|
|
421
|
+
totalDuration = totalDuration + (estimatedDurationSec ?? 0);
|
|
422
|
+
}
|
|
423
|
+
if (totalTokens != null)
|
|
424
|
+
totalTokens = totalTokens + (estimatedTokens ?? 0);
|
|
425
|
+
if (totalCost != null)
|
|
426
|
+
totalCost = totalCost + (estimatedCostUsd ?? 0);
|
|
427
|
+
}
|
|
428
|
+
for (const group of parallelGroups.values()) {
|
|
429
|
+
if (totalDuration != null)
|
|
430
|
+
totalDuration = totalDuration + group.maxDuration;
|
|
431
|
+
}
|
|
432
|
+
const hasAnyEstimate = tasks.some((t) => t.estimatedDurationSec != null || t.estimatedCostUsd != null || t.estimatedTokens != null);
|
|
433
|
+
const totals = hasAnyEstimate
|
|
434
|
+
? {
|
|
435
|
+
estimatedDurationSec: totalDuration != null ? Math.round(totalDuration * 10) / 10 : null,
|
|
436
|
+
estimatedCostUsd: totalCost != null ? Math.round(totalCost * 10000) / 10000 : null,
|
|
437
|
+
estimatedTokens: totalTokens != null ? Math.round(totalTokens) : null,
|
|
438
|
+
}
|
|
439
|
+
: { estimatedDurationSec: null, estimatedCostUsd: null, estimatedTokens: null };
|
|
440
|
+
return {
|
|
441
|
+
success: true,
|
|
442
|
+
taskName: root.name,
|
|
443
|
+
tasks,
|
|
444
|
+
totals,
|
|
445
|
+
warnings,
|
|
446
|
+
};
|
|
447
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Задержка между последним изменением файла и запуском задачи.
|
|
3
|
+
* Нужна потому, что редакторы часто пишут файл несколькими порциями
|
|
4
|
+
* (truncate + write + rename) — без дебаунса задача стартовала бы 3-5 раз.
|
|
5
|
+
*/
|
|
6
|
+
export declare const FILE_TRIGGER_DEBOUNCE_MS = 2000;
|
|
7
|
+
export type FileTriggerHandler = (taskName: string, changedPath: string) => void | Promise<void>;
|
|
8
|
+
/**
|
|
9
|
+
* Менеджер файловых триггеров: держит по одному chokidar- watcher'у на задачу
|
|
10
|
+
* с triggerType === "file" и пересобирает их при изменении tasks.json.
|
|
11
|
+
*/
|
|
12
|
+
export declare class FileWatchManager {
|
|
13
|
+
private readonly handler;
|
|
14
|
+
private readonly debounceMs;
|
|
15
|
+
private entries;
|
|
16
|
+
private stopped;
|
|
17
|
+
constructor(handler: FileTriggerHandler, debounceMs?: number);
|
|
18
|
+
/** Сколько задач сейчас отслеживается. */
|
|
19
|
+
get size(): number;
|
|
20
|
+
/**
|
|
21
|
+
* Перечитывает tasks.json и приводит набор watcher'ов в соответствие:
|
|
22
|
+
* новые задачи добавляются, удалённые/изменённые — закрываются.
|
|
23
|
+
* Возвращает количество активных файловых триггеров.
|
|
24
|
+
*/
|
|
25
|
+
refresh(): Promise<number>;
|
|
26
|
+
/** Закрывает все watcher'ы (вызывается при выгрузке плагина). */
|
|
27
|
+
stop(): Promise<void>;
|
|
28
|
+
private add;
|
|
29
|
+
private remove;
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=file-watcher.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/core/file-watcher.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAe1B;;;GAGG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAS;gBAGL,OAAO,EAAE,kBAAkB,EAC3B,UAAU,GAAE,MAAiC;IAGhE,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAkEhC,iEAAiE;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,GAAG;YAsGG,MAAM;CAcrB"}
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
import { watch } from "chokidar";
|
|
2
|
+
import { isAbsolute } from "node:path";
|
|
3
|
+
import { loadTaskDefinitions } from "../task-transfer.js";
|
|
4
|
+
import { filterPaths, relativeTo } from "./glob.js";
|
|
5
|
+
import { hasPathControlChars } from "./watch-paths.js";
|
|
6
|
+
/**
|
|
7
|
+
* Задержка между последним изменением файла и запуском задачи.
|
|
8
|
+
* Нужна потому, что редакторы часто пишут файл несколькими порциями
|
|
9
|
+
* (truncate + write + rename) — без дебаунса задача стартовала бы 3-5 раз.
|
|
10
|
+
*/
|
|
11
|
+
export const FILE_TRIGGER_DEBOUNCE_MS = 2000;
|
|
12
|
+
/**
|
|
13
|
+
* Менеджер файловых триггеров: держит по одному chokidar- watcher'у на задачу
|
|
14
|
+
* с triggerType === "file" и пересобирает их при изменении tasks.json.
|
|
15
|
+
*/
|
|
16
|
+
export class FileWatchManager {
|
|
17
|
+
constructor(handler, debounceMs = FILE_TRIGGER_DEBOUNCE_MS) {
|
|
18
|
+
this.handler = handler;
|
|
19
|
+
this.debounceMs = debounceMs;
|
|
20
|
+
this.entries = new Map();
|
|
21
|
+
this.stopped = false;
|
|
22
|
+
}
|
|
23
|
+
/** Сколько задач сейчас отслеживается. */
|
|
24
|
+
get size() {
|
|
25
|
+
return this.entries.size;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Перечитывает tasks.json и приводит набор watcher'ов в соответствие:
|
|
29
|
+
* новые задачи добавляются, удалённые/изменённые — закрываются.
|
|
30
|
+
* Возвращает количество активных файловых триггеров.
|
|
31
|
+
*/
|
|
32
|
+
async refresh() {
|
|
33
|
+
if (this.stopped)
|
|
34
|
+
return 0;
|
|
35
|
+
const definitions = await loadTaskDefinitions();
|
|
36
|
+
const wanted = definitions
|
|
37
|
+
.filter((d) => d.triggerType === "file" &&
|
|
38
|
+
typeof d.watchPath === "string" &&
|
|
39
|
+
d.watchPath.trim().length > 0)
|
|
40
|
+
.map((d) => ({
|
|
41
|
+
name: d.name.trim(),
|
|
42
|
+
path: d.watchPath.trim(),
|
|
43
|
+
globs: Array.isArray(d.watchGlobs)
|
|
44
|
+
? d.watchGlobs.filter((g) => typeof g === "string" && g.trim().length > 0)
|
|
45
|
+
: [],
|
|
46
|
+
ignore: Array.isArray(d.watchIgnore)
|
|
47
|
+
? d.watchIgnore.filter((g) => typeof g === "string" && g.trim().length > 0)
|
|
48
|
+
: [],
|
|
49
|
+
}))
|
|
50
|
+
.filter((d) => d.name.length > 0)
|
|
51
|
+
.filter((d) => {
|
|
52
|
+
// Защита от legacy-записей и ручного редактирования БД: не запускаем
|
|
53
|
+
// watcher на путях с управляющими символами или выходом через `..`.
|
|
54
|
+
if (hasPathControlChars(d.path)) {
|
|
55
|
+
console.error(`[windows-scheduler] Задача "${d.name}": путь наблюдения содержит управляющие символы — пропущен.`);
|
|
56
|
+
return false;
|
|
57
|
+
}
|
|
58
|
+
if (!isAbsolute(d.path) && d.path.split(/[\\/]/).includes("..")) {
|
|
59
|
+
console.error(`[windows-scheduler] Задача "${d.name}": относительный путь наблюдения выходит за рабочую директорию — пропущен.`);
|
|
60
|
+
return false;
|
|
61
|
+
}
|
|
62
|
+
return true;
|
|
63
|
+
});
|
|
64
|
+
const wantedKeys = new Set(wanted.map((d) => d.name.toLowerCase()));
|
|
65
|
+
// Убираем watcher'ы для задач, которых больше нет или у которых сменился
|
|
66
|
+
// путь/маски (Спринт 27).
|
|
67
|
+
for (const [key, entry] of Array.from(this.entries.entries())) {
|
|
68
|
+
const target = wanted.find((d) => d.name.toLowerCase() === key);
|
|
69
|
+
if (!target ||
|
|
70
|
+
target.path !== entry.path ||
|
|
71
|
+
target.globs.join("\u0000") !== entry.globs.join("\u0000") ||
|
|
72
|
+
target.ignore.join("\u0000") !== entry.ignore.join("\u0000")) {
|
|
73
|
+
await this.remove(key);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
// Добавляем новые.
|
|
77
|
+
for (const item of wanted) {
|
|
78
|
+
const key = item.name.toLowerCase();
|
|
79
|
+
if (this.entries.has(key) || !wantedKeys.has(key))
|
|
80
|
+
continue;
|
|
81
|
+
this.add(item.name, item.path, item.globs, item.ignore);
|
|
82
|
+
}
|
|
83
|
+
return this.entries.size;
|
|
84
|
+
}
|
|
85
|
+
/** Закрывает все watcher'ы (вызывается при выгрузке плагина). */
|
|
86
|
+
async stop() {
|
|
87
|
+
this.stopped = true;
|
|
88
|
+
for (const key of Array.from(this.entries.keys())) {
|
|
89
|
+
await this.remove(key);
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
add(name, watchPath, globs = [], ignore = []) {
|
|
93
|
+
// Спринт 27: маски с "**" требуют рекурсивного обхода директории.
|
|
94
|
+
const needsRecursive = globs.some((g) => g.includes("**"));
|
|
95
|
+
let watcher;
|
|
96
|
+
try {
|
|
97
|
+
watcher = watch(watchPath, {
|
|
98
|
+
// Не считаем уже существующий файл «изменением» при старте.
|
|
99
|
+
ignoreInitial: true,
|
|
100
|
+
// Следим за одним файлом/папкой, без рекурсии в глубину, если маски
|
|
101
|
+
// этого не требуют.
|
|
102
|
+
depth: needsRecursive ? undefined : 0,
|
|
103
|
+
// Файлы могут быть большими: дождёмся, пока запись успокоится.
|
|
104
|
+
awaitWriteFinish: { stabilityThreshold: 500, pollInterval: 100 },
|
|
105
|
+
ignorePermissionErrors: true,
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
catch (err) {
|
|
109
|
+
console.error(`[windows-scheduler] Не удалось начать отслеживание "${watchPath}" для задачи "${name}": ${err instanceof Error ? err.message : String(err)}`);
|
|
110
|
+
return;
|
|
111
|
+
}
|
|
112
|
+
const entry = {
|
|
113
|
+
name,
|
|
114
|
+
path: watchPath,
|
|
115
|
+
globs,
|
|
116
|
+
ignore,
|
|
117
|
+
watcher,
|
|
118
|
+
timer: null,
|
|
119
|
+
};
|
|
120
|
+
/** Спринт 27: маски применяются к пути относительно watchPath. */
|
|
121
|
+
const accepts = (changedPath) => {
|
|
122
|
+
if (globs.length === 0 && ignore.length === 0)
|
|
123
|
+
return true;
|
|
124
|
+
if (globs.length === 0) {
|
|
125
|
+
const rel = relativeTo(watchPath, changedPath) ?? changedPath;
|
|
126
|
+
return filterPaths([rel], undefined, ignore).length > 0;
|
|
127
|
+
}
|
|
128
|
+
const rel = relativeTo(watchPath, changedPath);
|
|
129
|
+
const candidates = rel ? [rel, changedPath] : [changedPath];
|
|
130
|
+
return candidates.some((candidate) => filterPaths([candidate], globs, ignore).length > 0);
|
|
131
|
+
};
|
|
132
|
+
const onChange = (changedPath) => {
|
|
133
|
+
if (this.stopped)
|
|
134
|
+
return;
|
|
135
|
+
if (!accepts(changedPath))
|
|
136
|
+
return;
|
|
137
|
+
if (entry.timer)
|
|
138
|
+
clearTimeout(entry.timer);
|
|
139
|
+
entry.timer = setTimeout(() => {
|
|
140
|
+
entry.timer = null;
|
|
141
|
+
if (this.stopped)
|
|
142
|
+
return;
|
|
143
|
+
try {
|
|
144
|
+
const result = this.handler(name, changedPath);
|
|
145
|
+
if (result && typeof result.catch === "function") {
|
|
146
|
+
result.catch((err) => {
|
|
147
|
+
console.error(`[windows-scheduler] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
|
|
148
|
+
});
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
catch (err) {
|
|
152
|
+
console.error(`[windows-scheduler] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
|
|
153
|
+
}
|
|
154
|
+
}, this.debounceMs);
|
|
155
|
+
// Таймер не должен удерживать процесс, если хост завершается.
|
|
156
|
+
if (typeof entry.timer.unref === "function")
|
|
157
|
+
entry.timer.unref();
|
|
158
|
+
};
|
|
159
|
+
// Спринт 27: переименование/удаление файла тоже считается изменением —
|
|
160
|
+
// иначе mac/win-редакторы, пишущие через rename, «пропадали» бы.
|
|
161
|
+
watcher.on("change", onChange);
|
|
162
|
+
watcher.on("add", onChange);
|
|
163
|
+
watcher.on("unlink", onChange);
|
|
164
|
+
watcher.on("error", (err) => {
|
|
165
|
+
console.error(`[windows-scheduler] Ошибка наблюдения за "${watchPath}" (задача "${name}"): ${err?.message ?? String(err)}`);
|
|
166
|
+
});
|
|
167
|
+
this.entries.set(name.toLowerCase(), entry);
|
|
168
|
+
console.log(`[windows-scheduler] Слежу за "${watchPath}" — задача "${name}" запускается при изменении файла.`);
|
|
169
|
+
}
|
|
170
|
+
async remove(key) {
|
|
171
|
+
const entry = this.entries.get(key);
|
|
172
|
+
if (!entry)
|
|
173
|
+
return;
|
|
174
|
+
this.entries.delete(key);
|
|
175
|
+
if (entry.timer) {
|
|
176
|
+
clearTimeout(entry.timer);
|
|
177
|
+
entry.timer = null;
|
|
178
|
+
}
|
|
179
|
+
try {
|
|
180
|
+
await entry.watcher.close();
|
|
181
|
+
}
|
|
182
|
+
catch {
|
|
183
|
+
// watcher уже мог быть закрыт — не критично.
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
}
|