agent-steward 0.0.5 → 0.0.6
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 +176 -1
- package/README.md +9 -7
- package/ROADMAP-STRATEGY.md +5 -5
- package/ROADMAP.md +107 -17
- package/dist/cli.js +5 -0
- package/dist/core/analytics.d.ts +6 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +20 -3
- package/dist/core/audit.d.ts +6 -0
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +24 -0
- package/dist/core/budget.d.ts +118 -0
- package/dist/core/budget.d.ts.map +1 -0
- package/dist/core/budget.js +206 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +38 -0
- package/dist/core/dry-run.d.ts +26 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +199 -8
- package/dist/core/feedback.d.ts +192 -0
- package/dist/core/feedback.d.ts.map +1 -0
- package/dist/core/feedback.js +426 -0
- package/dist/core/gate-integrity.d.ts +36 -0
- package/dist/core/gate-integrity.d.ts.map +1 -1
- package/dist/core/gate-integrity.js +144 -1
- package/dist/core/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +57 -2
- package/dist/core/mission.d.ts +20 -0
- package/dist/core/mission.d.ts.map +1 -1
- package/dist/core/mission.js +45 -5
- package/dist/core/opencode-models.d.ts +2 -2
- package/dist/core/opencode-models.d.ts.map +1 -1
- package/dist/core/opencode-models.js +28 -21
- package/dist/core/opencode-usage.d.ts +35 -0
- package/dist/core/opencode-usage.d.ts.map +1 -0
- package/dist/core/opencode-usage.js +132 -0
- package/dist/core/pipeline-io.d.ts +1 -1
- package/dist/core/pipeline-io.d.ts.map +1 -1
- package/dist/core/pipeline-io.js +26 -12
- package/dist/core/pipeline-map.d.ts +6 -0
- package/dist/core/pipeline-map.d.ts.map +1 -1
- package/dist/core/pipeline-map.js +12 -0
- package/dist/core/ps-wrapper.d.ts +10 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +176 -5
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +76 -4
- package/dist/core/run-mode.d.ts +12 -0
- package/dist/core/run-mode.d.ts.map +1 -0
- package/dist/core/run-mode.js +17 -0
- package/dist/core/scheduler/logs.d.ts +4 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -1
- package/dist/core/scheduler/logs.js +25 -1
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +18 -8
- package/dist/core/self-analysis.d.ts +32 -2
- package/dist/core/self-analysis.d.ts.map +1 -1
- package/dist/core/self-analysis.js +38 -27
- package/dist/core/shutdown.d.ts +33 -2
- package/dist/core/shutdown.d.ts.map +1 -1
- package/dist/core/shutdown.js +58 -2
- package/dist/core/structured-log.d.ts +30 -0
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +37 -0
- package/dist/core/usage-surface.d.ts +25 -0
- package/dist/core/usage-surface.d.ts.map +1 -0
- package/dist/core/usage-surface.js +41 -0
- package/dist/core/wrappers/bash.d.ts +2 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +58 -6
- package/dist/db/history-repo.d.ts +32 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +85 -7
- package/dist/db/metrics-repo.d.ts +20 -2
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +33 -11
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +37 -17
- package/dist/db/recovery.d.ts +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +9 -4
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +71 -56
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +70 -1
- package/dist/db/templates-repo.d.ts +2 -2
- package/dist/db/templates-repo.d.ts.map +1 -1
- package/dist/db/templates-repo.js +5 -3
- package/dist/history.d.ts +6 -1
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +4 -2
- package/dist/hook-output.d.ts +2 -0
- package/dist/hook-output.d.ts.map +1 -0
- package/dist/hook-output.js +31 -0
- package/dist/index.d.ts +247 -53
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +999 -211
- package/dist/notifications.d.ts +31 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +132 -13
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +66 -15
- package/dist/rpc.d.ts +108 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +28 -0
- package/dist/server.d.ts +17 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +77 -12
- package/dist/settings.d.ts +42 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +82 -0
- package/dist/task-transfer.d.ts +5 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +48 -3
- package/dist/templates.d.ts +2 -2
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +3 -3
- package/dist/types.d.ts +22 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +34 -11
- package/docs/ARCHITECTURE.md +49 -12
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/EXECUTION-LOOP.md +6 -3
- package/docs/FEATURES.md +65 -4
- package/docs/FEATURES.zh.md +45 -2
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +3 -3
- package/docs/README.zh.md +2 -2
- package/gui-experimental.cjs +9 -9
- package/locales/en.json +42 -3
- package/locales/ru.json +42 -3
- package/locales/zh.json +42 -3
- package/package.json +15 -2
- package/scripts/check-eslint-baseline.mjs +139 -0
- package/scripts/gen-test-plan-counters.mjs +117 -0
- package/scripts/github-ci-fetch.ps1 +37 -0
- package/scripts/pl-commit.ps1 +112 -0
- package/scripts/qa-a2-commit.ps1 +104 -0
- package/scripts/test-home.mjs +26 -2
- package/skills/scheduled-job-best-practices/SKILL.md +95 -1
- package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
- package/src/cli.ts +5 -0
- package/src/core/analytics.ts +27 -4
- package/src/core/audit.ts +25 -0
- package/src/core/budget.ts +340 -0
- package/src/core/cron-to-schtasks.ts +42 -0
- package/src/core/dry-run.ts +233 -10
- package/src/core/feedback.ts +582 -0
- package/src/core/gate-integrity.ts +171 -1
- package/src/core/local-ai.ts +7 -3
- package/src/core/matrix.ts +63 -2
- package/src/core/mission.ts +51 -5
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-io.ts +28 -11
- package/src/core/pipeline-map.ts +19 -0
- package/src/core/ps-wrapper.ts +173 -4
- package/src/core/record-history.ts +94 -4
- package/src/core/run-mode.ts +19 -0
- package/src/core/scheduler/logs.ts +32 -1
- package/src/core/secrets.ts +18 -11
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +67 -0
- package/src/core/usage-surface.ts +70 -0
- package/src/core/wrappers/bash.ts +60 -5
- package/src/db/history-repo.ts +153 -19
- package/src/db/metrics-repo.ts +38 -11
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +10 -4
- package/src/db/runs-repo.ts +113 -61
- package/src/db/schema.ts +70 -1
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +261 -5
- package/src/history.ts +10 -3
- package/src/hook-output.ts +39 -0
- package/src/index.ts +1407 -345
- package/src/notifications.ts +189 -39
- package/src/profiles.ts +72 -16
- package/src/rpc.ts +30 -0
- package/src/server.ts +107 -23
- package/src/settings.ts +120 -0
- package/src/task-transfer.ts +59 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Бюджеты день/неделя (Экономика v2, E-1.1).
|
|
3
|
+
*
|
|
4
|
+
* Чистые функции без БД, HTTP и ОС: расход считается из уже загруженной
|
|
5
|
+
* истории запусков, лимиты задаются пользователем в settings.json.
|
|
6
|
+
* Fail-open по умолчанию: выключенная группа или нулевой лимит никогда
|
|
7
|
+
* не блокируют запуски — они только перестают проверяться.
|
|
8
|
+
*/
|
|
9
|
+
import { recordCost } from "./analytics.js";
|
|
10
|
+
export const DEFAULT_BUDGET_SETTINGS = {
|
|
11
|
+
enabled: false,
|
|
12
|
+
dailyUsd: 0,
|
|
13
|
+
weeklyUsd: 0,
|
|
14
|
+
};
|
|
15
|
+
export function defaultBudgetSettings() {
|
|
16
|
+
return { ...DEFAULT_BUDGET_SETTINGS };
|
|
17
|
+
}
|
|
18
|
+
function roundUsd(value) {
|
|
19
|
+
return Math.round(value * 1e6) / 1e6;
|
|
20
|
+
}
|
|
21
|
+
/** Начало UTC-дня, в котором находится `now`. */
|
|
22
|
+
export function startOfUtcDay(now) {
|
|
23
|
+
return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
|
|
24
|
+
}
|
|
25
|
+
/** Начало UTC-недели (понедельник 00:00), в которой находится `now`. */
|
|
26
|
+
export function startOfUtcWeek(now) {
|
|
27
|
+
const day = startOfUtcDay(now);
|
|
28
|
+
const weekday = day.getUTCDay(); // 0 = воскресенье
|
|
29
|
+
const mondayOffset = weekday === 0 ? 6 : weekday - 1;
|
|
30
|
+
return new Date(day.getTime() - mondayOffset * 24 * 60 * 60 * 1000);
|
|
31
|
+
}
|
|
32
|
+
function periodLimit(settings, period) {
|
|
33
|
+
const raw = period === "day" ? settings.dailyUsd : settings.weeklyUsd;
|
|
34
|
+
const value = Number(raw);
|
|
35
|
+
return Number.isFinite(value) && value > 0 ? value : 0;
|
|
36
|
+
}
|
|
37
|
+
function computeUsage(records, settings, period, start, now) {
|
|
38
|
+
const startMs = start.getTime();
|
|
39
|
+
const endMs = now.getTime();
|
|
40
|
+
let spent = 0;
|
|
41
|
+
let runs = 0;
|
|
42
|
+
for (const record of records) {
|
|
43
|
+
// Незавершённые запуски ещё нельзя оценить — как и в buildAnalytics.
|
|
44
|
+
if (record.status === "running")
|
|
45
|
+
continue;
|
|
46
|
+
// Расход относится к моменту завершения: запуск, начатый до полуночи,
|
|
47
|
+
// но закончившийся внутри периода, должен попасть именно в этот период.
|
|
48
|
+
// Для старых записей без finishedAt сохраняем прежнюю атрибуцию по startedAt.
|
|
49
|
+
const finishedMs = record.finishedAt
|
|
50
|
+
? new Date(record.finishedAt).getTime()
|
|
51
|
+
: NaN;
|
|
52
|
+
const startedMs = new Date(record.startedAt).getTime();
|
|
53
|
+
const time = Number.isFinite(finishedMs) ? finishedMs : startedMs;
|
|
54
|
+
if (!Number.isFinite(time) || time < startMs || time > endMs)
|
|
55
|
+
continue;
|
|
56
|
+
spent += recordCost(record);
|
|
57
|
+
runs += 1;
|
|
58
|
+
}
|
|
59
|
+
const limitUsd = periodLimit(settings, period);
|
|
60
|
+
const spentUsd = roundUsd(spent);
|
|
61
|
+
const disabled = !settings.enabled || limitUsd <= 0;
|
|
62
|
+
const ratio = limitUsd > 0 ? spentUsd / limitUsd : 0;
|
|
63
|
+
return {
|
|
64
|
+
period,
|
|
65
|
+
periodStart: start.toISOString(),
|
|
66
|
+
limitUsd,
|
|
67
|
+
spentUsd,
|
|
68
|
+
runs,
|
|
69
|
+
remainingUsd: disabled ? 0 : roundUsd(Math.max(0, limitUsd - spentUsd)),
|
|
70
|
+
ratio: disabled ? 0 : Math.round(ratio * 1e6) / 1e6,
|
|
71
|
+
exceeded: !disabled && spentUsd >= limitUsd,
|
|
72
|
+
disabled,
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Считает расход за текущий UTC-день и UTC-неделю (с понедельника).
|
|
77
|
+
* Запуск относится к периоду по времени завершения (`finishedAt`, при
|
|
78
|
+
* отсутствии — `startedAt`); даты вне периода и статус `running` игнорируются.
|
|
79
|
+
*/
|
|
80
|
+
export function buildBudgetReport(records, settings = DEFAULT_BUDGET_SETTINGS, now = new Date()) {
|
|
81
|
+
const day = computeUsage(records, settings, "day", startOfUtcDay(now), now);
|
|
82
|
+
const week = computeUsage(records, settings, "week", startOfUtcWeek(now), now);
|
|
83
|
+
return {
|
|
84
|
+
generatedAt: now.toISOString(),
|
|
85
|
+
enabled: settings.enabled,
|
|
86
|
+
day,
|
|
87
|
+
week,
|
|
88
|
+
exceeded: day.exceeded || week.exceeded,
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* E-1.2: авто-пауза при превышении лимита.
|
|
93
|
+
*
|
|
94
|
+
* Fail-open: если группа выключена или оба лимита нулевые, запуски не
|
|
95
|
+
* блокируются. Иначе новый запуск пропускается, как только расход за
|
|
96
|
+
* текущий день/неделю достиг лимита. Дневной лимит проверяется первым.
|
|
97
|
+
*/
|
|
98
|
+
export function evaluateBudgetGate(records, settings = DEFAULT_BUDGET_SETTINGS, now = new Date()) {
|
|
99
|
+
const report = buildBudgetReport(records, settings, now);
|
|
100
|
+
if (!settings.enabled || (report.day.disabled && report.week.disabled)) {
|
|
101
|
+
return { allowed: true, reason: "disabled", report };
|
|
102
|
+
}
|
|
103
|
+
if (report.day.exceeded) {
|
|
104
|
+
return { allowed: false, reason: "day_exceeded", period: "day", report };
|
|
105
|
+
}
|
|
106
|
+
if (report.week.exceeded) {
|
|
107
|
+
return { allowed: false, reason: "week_exceeded", period: "week", report };
|
|
108
|
+
}
|
|
109
|
+
return { allowed: true, reason: "within_limit", report };
|
|
110
|
+
}
|
|
111
|
+
/** Человекочитаемая причина пропуска; пустая строка, если запуск разрешён. */
|
|
112
|
+
export function formatBudgetSkipMessage(decision) {
|
|
113
|
+
if (decision.allowed)
|
|
114
|
+
return "";
|
|
115
|
+
const usage = decision.period === "week" ? decision.report.week : decision.report.day;
|
|
116
|
+
const label = decision.period === "week" ? "weekly" : "daily";
|
|
117
|
+
return `Budget limit exceeded: ${label} spend $${usage.spentUsd.toFixed(2)} of $${usage.limitUsd.toFixed(2)} — run skipped.`;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* E-1.3: текст алерта о превышении бюджета. Пустая строка, если лимит не
|
|
121
|
+
* превышен. Отличается от сообщения о пропуске запуска (E-1.2) тем, что
|
|
122
|
+
* явно сообщает об остановке всех новых запусков.
|
|
123
|
+
*/
|
|
124
|
+
export function formatBudgetAlertMessage(decision) {
|
|
125
|
+
if (decision.allowed)
|
|
126
|
+
return "";
|
|
127
|
+
const usage = decision.period === "week" ? decision.report.week : decision.report.day;
|
|
128
|
+
const label = decision.period === "week" ? "Weekly" : "Daily";
|
|
129
|
+
return `⚠️ Agent-steward budget alert: ${label} spend $${usage.spentUsd.toFixed(2)} of $${usage.limitUsd.toFixed(2)} — new runs are paused.`;
|
|
130
|
+
}
|
|
131
|
+
function normalizeTokenBudget(value) {
|
|
132
|
+
const n = Number(value);
|
|
133
|
+
return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
|
|
134
|
+
}
|
|
135
|
+
function maxRunTokensInWindow(records, taskKey, startMs, endMs) {
|
|
136
|
+
let max = 0;
|
|
137
|
+
for (const record of records) {
|
|
138
|
+
if (record.status === "running")
|
|
139
|
+
continue;
|
|
140
|
+
if ((record.taskName ?? "").trim().toLowerCase() !== taskKey)
|
|
141
|
+
continue;
|
|
142
|
+
// Расход относится к моменту завершения (как и в глобальном бюджете):
|
|
143
|
+
// запуск, начатый в прошлом периоде, но закончившийся в текущем, учитывается
|
|
144
|
+
// именно в текущем. Для легаси-записей без finishedAt — по startedAt.
|
|
145
|
+
const finishedMs = record.finishedAt
|
|
146
|
+
? new Date(record.finishedAt).getTime()
|
|
147
|
+
: NaN;
|
|
148
|
+
const startedMs = new Date(record.startedAt).getTime();
|
|
149
|
+
const time = Number.isFinite(finishedMs) ? finishedMs : startedMs;
|
|
150
|
+
if (!Number.isFinite(time) || time < startMs || time > endMs)
|
|
151
|
+
continue;
|
|
152
|
+
const tokens = Number(record.tokens);
|
|
153
|
+
if (Number.isFinite(tokens) && tokens > max)
|
|
154
|
+
max = tokens;
|
|
155
|
+
}
|
|
156
|
+
return max;
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* Решение гейта персонального токен-бюджета задачи.
|
|
160
|
+
*
|
|
161
|
+
* Источник данных — уже загруженная история (`getHistoryForBudget`). Как и в
|
|
162
|
+
* аналитике (QA-B.1), превышение считается по одному прогону, а не по сумме за
|
|
163
|
+
* период; дневное окно проверяется первым (как дневной лимит в E-1.2).
|
|
164
|
+
*/
|
|
165
|
+
export function evaluateTaskTokenBudgetGate(records, taskName, tokenBudget, now = new Date()) {
|
|
166
|
+
const budget = normalizeTokenBudget(tokenBudget);
|
|
167
|
+
const key = (taskName ?? "").trim().toLowerCase();
|
|
168
|
+
const base = {
|
|
169
|
+
allowed: true,
|
|
170
|
+
reason: budget > 0 ? "within_limit" : "no_budget",
|
|
171
|
+
taskName,
|
|
172
|
+
tokenBudget: budget,
|
|
173
|
+
maxRunTokens: 0,
|
|
174
|
+
};
|
|
175
|
+
if (!budget || !key)
|
|
176
|
+
return base;
|
|
177
|
+
const endMs = now.getTime();
|
|
178
|
+
const dayMax = maxRunTokensInWindow(records, key, startOfUtcDay(now).getTime(), endMs);
|
|
179
|
+
if (dayMax > budget) {
|
|
180
|
+
return {
|
|
181
|
+
...base,
|
|
182
|
+
allowed: false,
|
|
183
|
+
reason: "day_exceeded",
|
|
184
|
+
maxRunTokens: dayMax,
|
|
185
|
+
period: "day",
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
const weekMax = maxRunTokensInWindow(records, key, startOfUtcWeek(now).getTime(), endMs);
|
|
189
|
+
if (weekMax > budget) {
|
|
190
|
+
return {
|
|
191
|
+
...base,
|
|
192
|
+
allowed: false,
|
|
193
|
+
reason: "week_exceeded",
|
|
194
|
+
maxRunTokens: weekMax,
|
|
195
|
+
period: "week",
|
|
196
|
+
};
|
|
197
|
+
}
|
|
198
|
+
return { ...base, maxRunTokens: Math.max(dayMax, weekMax) };
|
|
199
|
+
}
|
|
200
|
+
/** Человекочитаемая причина пропуска; пустая строка, если запуск разрешён. */
|
|
201
|
+
export function formatTaskTokenBudgetSkipMessage(decision) {
|
|
202
|
+
if (decision.allowed)
|
|
203
|
+
return "";
|
|
204
|
+
const period = decision.period === "week" ? "weekly" : "daily";
|
|
205
|
+
return `Task token budget exceeded: "${decision.taskName}" used ${decision.maxRunTokens} tokens in one run (${period} limit ${decision.tokenBudget}) — run skipped.`;
|
|
206
|
+
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cron-to-schtasks.d.ts","sourceRoot":"","sources":["../../src/core/cron-to-schtasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"cron-to-schtasks.d.ts","sourceRoot":"","sources":["../../src/core/cron-to-schtasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkFlD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAoJlE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,EAAE,CAUvE"}
|
|
@@ -11,6 +11,8 @@ const UNSUPPORTED_ERROR = "Неподдерживаемое cron-выражен
|
|
|
11
11
|
" M * * * * -> HOURLY, ежечасно в MM минут (/st 00:MM)\n" +
|
|
12
12
|
" M H * * * -> DAILY, ежедневно в HH:MM (/st HH:MM)\n" +
|
|
13
13
|
" M H * * D -> WEEKLY, по неделям в день D в HH:MM (/d D /st HH:MM)\n" +
|
|
14
|
+
" M H D * * -> MONTHLY, первого числа каждого месяца (/d D /st HH:MM)\n" +
|
|
15
|
+
" M H D M * -> MONTHLY в указанном месяце (/m MONTH), раз в год\n" +
|
|
14
16
|
"\n" +
|
|
15
17
|
"Не поддерживаются: диапазоны (1-5), списки (1,2,3), комбинации месяца и дня недели,\n" +
|
|
16
18
|
"*/N в поле дня месяца или дня недели, а также любые другие сложные выражения.\n" +
|
|
@@ -29,6 +31,21 @@ const DAY_OF_WEEK_MAP = {
|
|
|
29
31
|
"6": "SAT",
|
|
30
32
|
"7": "SUN",
|
|
31
33
|
};
|
|
34
|
+
/** Месяцы для schtasks /m (номер месяца cron 1..12). */
|
|
35
|
+
const MONTH_MAP = {
|
|
36
|
+
"1": "JANUARY",
|
|
37
|
+
"2": "FEBRUARY",
|
|
38
|
+
"3": "MARCH",
|
|
39
|
+
"4": "APRIL",
|
|
40
|
+
"5": "MAY",
|
|
41
|
+
"6": "JUNE",
|
|
42
|
+
"7": "JULY",
|
|
43
|
+
"8": "AUGUST",
|
|
44
|
+
"9": "SEPTEMBER",
|
|
45
|
+
"10": "OCTOBER",
|
|
46
|
+
"11": "NOVEMBER",
|
|
47
|
+
"12": "DECEMBER",
|
|
48
|
+
};
|
|
32
49
|
/**
|
|
33
50
|
* Проверяет, является ли строка звездочкой "*".
|
|
34
51
|
*/
|
|
@@ -158,6 +175,27 @@ export function convertCronToSchTasks(cron) {
|
|
|
158
175
|
days: dayName,
|
|
159
176
|
};
|
|
160
177
|
}
|
|
178
|
+
// --- ПАТТЕРН 5: M H D [*|M] * -> MONTHLY (/d D [/m MONTH] /st HH:MM) ---
|
|
179
|
+
// QV-10: годовое выражение `0 4 1 1 *` раньше не конвертировалось и уходило
|
|
180
|
+
// в минутный опрос ОС. Теперь оно выражается нативно: schtasks MONTHLY с /m
|
|
181
|
+
// фиксирует месяц, а /d — день, поэтому тик один раз в год без пустых опросов.
|
|
182
|
+
const dom = parseIntInRange(dayOfMonth, 1, 31);
|
|
183
|
+
if (m !== undefined && h !== undefined && dom !== undefined && isStar(dayOfWeek)) {
|
|
184
|
+
const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
|
|
185
|
+
const extraFlags = ["/d", String(dom)];
|
|
186
|
+
if (!isStar(month)) {
|
|
187
|
+
const monthName = MONTH_MAP[month];
|
|
188
|
+
if (!monthName) {
|
|
189
|
+
throw new Error("Неподдерживаемое поле месяца: " + month + ".\n\n" + UNSUPPORTED_ERROR);
|
|
190
|
+
}
|
|
191
|
+
extraFlags.push("/m", monthName);
|
|
192
|
+
}
|
|
193
|
+
return {
|
|
194
|
+
sc: "MONTHLY",
|
|
195
|
+
extraFlags,
|
|
196
|
+
startTime,
|
|
197
|
+
};
|
|
198
|
+
}
|
|
161
199
|
// Ни один поддерживаемый паттерн не совпал.
|
|
162
200
|
throw new Error(UNSUPPORTED_ERROR);
|
|
163
201
|
}
|
package/dist/core/dry-run.d.ts
CHANGED
|
@@ -1,3 +1,16 @@
|
|
|
1
|
+
import type { TaskDefinition } from "../task-transfer.js";
|
|
2
|
+
/**
|
|
3
|
+
* QV-9: cron срабатывает чаще, чем раз в 5 минут, круглосуточно.
|
|
4
|
+
* Поддерживаются `* * * * *`, каждый N-ю минуту (N <= 5) и списки минут с
|
|
5
|
+
* минимальным циклическим шагом <= 5. Часовой/дневной фильтр означает,
|
|
6
|
+
* что задача не является «постоянным опросом» и отдельно не предупреждается.
|
|
7
|
+
*/
|
|
8
|
+
export declare function isFrequentCron(schedule: string): boolean;
|
|
9
|
+
/**
|
|
10
|
+
* PL-49: минимальный интервал срабатывания cron в минутах для простых
|
|
11
|
+
* выражений. Возвращает null, если интервал нельзя надёжно вывести.
|
|
12
|
+
*/
|
|
13
|
+
export declare function minimumCronIntervalMinutes(schedule: string): number | null;
|
|
1
14
|
export interface DryRunRoleScoped {
|
|
2
15
|
allowed?: string[];
|
|
3
16
|
denied?: string[];
|
|
@@ -10,6 +23,8 @@ export interface DryRunTriggerDetails {
|
|
|
10
23
|
type: "manual" | "cron" | "file" | "git" | "mcp-event" | "once";
|
|
11
24
|
/** Человекочитаемое объяснение условия запуска. */
|
|
12
25
|
explanation: string;
|
|
26
|
+
/** PL-50: cron не expressible в schtasks — ОС опрашивает его каждую минуту. */
|
|
27
|
+
polling?: boolean;
|
|
13
28
|
/** Состояние окна запуска и разрешённых дней недели (если заданы). */
|
|
14
29
|
activeWindow?: {
|
|
15
30
|
active: boolean;
|
|
@@ -34,7 +49,10 @@ export interface DryRunTriggerDetails {
|
|
|
34
49
|
export interface DryRunTaskItem {
|
|
35
50
|
name: string;
|
|
36
51
|
order: number;
|
|
37
|
-
|
|
52
|
+
/** PL-26/PL-30: реальный triggerType definition (совпадает с triggerDetails.type). */
|
|
53
|
+
trigger: DryRunTriggerDetails["type"];
|
|
54
|
+
/** Как задача попала в симуляцию: manual — корень, dag — через dependsOn. */
|
|
55
|
+
entryMode: "manual" | "dag";
|
|
38
56
|
cwd: string;
|
|
39
57
|
command: string;
|
|
40
58
|
workspace?: {
|
|
@@ -94,6 +112,13 @@ export interface DryRunReport {
|
|
|
94
112
|
}
|
|
95
113
|
/** Средняя цена за 1K токенов (должна совпадать с dashboards/server.ts). */
|
|
96
114
|
export declare const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
|
|
115
|
+
/**
|
|
116
|
+
* PL-8.1: рабочая директория могла уйти вперёд с момента постановки задачи —
|
|
117
|
+
* Quality Gate тогда проверяет уже другой код (расхождение счётчиков и т.п.).
|
|
118
|
+
* Сравниваем время HEAD-коммита с createdAt задачи. Fail-open: нет git, нет
|
|
119
|
+
* даты или команда недоступна — предупреждения нет.
|
|
120
|
+
*/
|
|
121
|
+
export declare function workingDirectoryDriftWarning(def: TaskDefinition, cwd: string): string | null;
|
|
97
122
|
/**
|
|
98
123
|
* Симулирует конвейер задачи: сама задача + все зависимости (dependsOn)
|
|
99
124
|
* в топологическом порядке. Возвращает отчёт без реального запуска.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"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"}
|
package/dist/core/dry-run.js
CHANGED
|
@@ -6,13 +6,72 @@
|
|
|
6
6
|
* Никогда не исполняет команды — только анализ определений.
|
|
7
7
|
*/
|
|
8
8
|
import fs from "node:fs";
|
|
9
|
+
import { execFileSync } from "node:child_process";
|
|
9
10
|
import { loadTaskDefinitions } from "../task-transfer.js";
|
|
10
11
|
import { getHistory } from "../db/history-repo.js";
|
|
11
12
|
import { getWorkspace } from "../workspaces.js";
|
|
12
13
|
import { expandMatrixTask } from "./matrix.js";
|
|
13
|
-
import { nextRun, activeWindowState, assessCronWindowFeasibility, windowFeasibilityReasonText } from "./schedule-v2.js";
|
|
14
|
+
import { nextRun, activeWindowState, assessCronWindowFeasibility, needsPollMode, windowFeasibilityReasonText } from "./schedule-v2.js";
|
|
14
15
|
import { checkGitTrigger } from "./git-trigger.js";
|
|
15
16
|
import { t } from "../i18n.js";
|
|
17
|
+
/**
|
|
18
|
+
* QV-9: cron срабатывает чаще, чем раз в 5 минут, круглосуточно.
|
|
19
|
+
* Поддерживаются `* * * * *`, каждый N-ю минуту (N <= 5) и списки минут с
|
|
20
|
+
* минимальным циклическим шагом <= 5. Часовой/дневной фильтр означает,
|
|
21
|
+
* что задача не является «постоянным опросом» и отдельно не предупреждается.
|
|
22
|
+
*/
|
|
23
|
+
export function isFrequentCron(schedule) {
|
|
24
|
+
const parts = schedule.trim().split(/\s+/);
|
|
25
|
+
if (parts.length < 5)
|
|
26
|
+
return false;
|
|
27
|
+
const [minute, hour, dom, month, dow] = parts;
|
|
28
|
+
if (hour !== "*" || dom !== "*" || month !== "*" || dow !== "*")
|
|
29
|
+
return false;
|
|
30
|
+
if (minute === "*")
|
|
31
|
+
return true;
|
|
32
|
+
const step = /^\*\/(\d+)$/.exec(minute);
|
|
33
|
+
if (step)
|
|
34
|
+
return Number(step[1]) <= 5;
|
|
35
|
+
const minutes = minute.split(",").map((m) => Number(m));
|
|
36
|
+
if (minutes.length > 1 && minutes.every((n) => Number.isInteger(n) && n >= 0 && n < 60)) {
|
|
37
|
+
const sorted = [...minutes].sort((a, b) => a - b);
|
|
38
|
+
let minStep = 60 - sorted[sorted.length - 1] + sorted[0];
|
|
39
|
+
for (let i = 1; i < sorted.length; i++) {
|
|
40
|
+
minStep = Math.min(minStep, sorted[i] - sorted[i - 1]);
|
|
41
|
+
}
|
|
42
|
+
return minStep <= 5;
|
|
43
|
+
}
|
|
44
|
+
return false;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* PL-49: минимальный интервал срабатывания cron в минутах для простых
|
|
48
|
+
* выражений. Возвращает null, если интервал нельзя надёжно вывести.
|
|
49
|
+
*/
|
|
50
|
+
export function minimumCronIntervalMinutes(schedule) {
|
|
51
|
+
const parts = schedule.trim().split(/\s+/);
|
|
52
|
+
if (parts.length < 5)
|
|
53
|
+
return null;
|
|
54
|
+
const [minute, hour, dom, month, dow] = parts;
|
|
55
|
+
if (hour !== "*" || dom !== "*" || month !== "*" || dow !== "*")
|
|
56
|
+
return null;
|
|
57
|
+
if (minute === "*")
|
|
58
|
+
return 1;
|
|
59
|
+
const step = /^\*\/(\d+)$/.exec(minute);
|
|
60
|
+
if (step) {
|
|
61
|
+
const n = Number(step[1]);
|
|
62
|
+
return n >= 1 && n <= 60 ? n : null;
|
|
63
|
+
}
|
|
64
|
+
const minutes = minute.split(",").map((m) => Number(m));
|
|
65
|
+
if (minutes.length > 1 && minutes.every((n) => Number.isInteger(n) && n >= 0 && n < 60)) {
|
|
66
|
+
const sorted = [...minutes].sort((a, b) => a - b);
|
|
67
|
+
let minStep = 60 - sorted[sorted.length - 1] + sorted[0];
|
|
68
|
+
for (let i = 1; i < sorted.length; i++) {
|
|
69
|
+
minStep = Math.min(minStep, sorted[i] - sorted[i - 1]);
|
|
70
|
+
}
|
|
71
|
+
return minStep;
|
|
72
|
+
}
|
|
73
|
+
return null;
|
|
74
|
+
}
|
|
16
75
|
/** Сколько последних успешных/любых запусков усредняем для оценки. */
|
|
17
76
|
const ESTIMATE_SAMPLE = 10;
|
|
18
77
|
/** Средняя цена за 1K токенов (должна совпадать с dashboards/server.ts). */
|
|
@@ -22,6 +81,86 @@ const DANGEROUS_PATTERNS = [
|
|
|
22
81
|
{ test: /rm\s+-rf\s+\/(?:\s|$)/, messageKey: "dryRun.danger.rmRoot" },
|
|
23
82
|
{ test: /git\s+push\s+.*--force(?:\s|$)/, messageKey: "dryRun.danger.forcePush" },
|
|
24
83
|
];
|
|
84
|
+
/**
|
|
85
|
+
* PL-2.2: команды самопроверки, которые агент не выполнит без инструмента
|
|
86
|
+
* shell. Если они есть в промпте, а shell запрещён, агент получает tool.blocked
|
|
87
|
+
* и рапортует об «успешной проверке», ничего не проверив.
|
|
88
|
+
*/
|
|
89
|
+
const SELF_CHECK_PATTERNS = [
|
|
90
|
+
/\bnpm\s+(?:test|run\s+[\w-]*test[\w-]*)\b/i,
|
|
91
|
+
/\bnode(?:\.exe)?\s+\S/i,
|
|
92
|
+
/\bpytest\b/i,
|
|
93
|
+
/\b(?:go|dotnet)\s+test\b/i,
|
|
94
|
+
/\btest\b/i,
|
|
95
|
+
/тест/iu,
|
|
96
|
+
];
|
|
97
|
+
/** PL-2.2: эффективный запрет shell с учётом legacy-режима и политик. */
|
|
98
|
+
function shellIsForbidden(def) {
|
|
99
|
+
if (def.legacyShell === true)
|
|
100
|
+
return false;
|
|
101
|
+
const isShell = (tool) => /^(?:shell|bash)$/i.test(tool.trim());
|
|
102
|
+
const allowed = Array.isArray(def.allowedTools) ? def.allowedTools : [];
|
|
103
|
+
const denied = Array.isArray(def.deniedTools) ? def.deniedTools : [];
|
|
104
|
+
if (allowed.length > 0)
|
|
105
|
+
return !allowed.some(isShell);
|
|
106
|
+
if (denied.length > 0)
|
|
107
|
+
return denied.some(isShell);
|
|
108
|
+
// Политика hybrid по умолчанию запрещает shell (см. SKILL.md §4).
|
|
109
|
+
return true;
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* PL-5.1: цепочка и DAG могут указывать на один и тот же переход. Тогда при
|
|
113
|
+
* завершении шага он будет запущен дважды: как chainTarget и как зависимый.
|
|
114
|
+
* Возвращаем имя конфликтующей задачи или null. Fail-open: нет данных — тишина.
|
|
115
|
+
*/
|
|
116
|
+
function findChainDagOverlap(def, allDefs) {
|
|
117
|
+
const next = (def.nextTaskOnSuccess ?? "").trim();
|
|
118
|
+
if (!next)
|
|
119
|
+
return null;
|
|
120
|
+
const nextLower = next.toLowerCase();
|
|
121
|
+
// Случай 1: преемник прямо перечислен в dependsOn текущей задачи.
|
|
122
|
+
if ((def.dependsOn ?? []).some((dep) => (dep ?? "").trim().toLowerCase() === nextLower)) {
|
|
123
|
+
return next;
|
|
124
|
+
}
|
|
125
|
+
// Случай 2 (типичная линейная цепочка): преемник сам зависит от текущей.
|
|
126
|
+
const nextDef = allDefs.find((d) => d.name.toLowerCase() === nextLower);
|
|
127
|
+
if (nextDef &&
|
|
128
|
+
(nextDef.dependsOn ?? []).some((dep) => (dep ?? "").trim().toLowerCase() === def.name.toLowerCase())) {
|
|
129
|
+
return next;
|
|
130
|
+
}
|
|
131
|
+
return null;
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
* PL-8.1: рабочая директория могла уйти вперёд с момента постановки задачи —
|
|
135
|
+
* Quality Gate тогда проверяет уже другой код (расхождение счётчиков и т.п.).
|
|
136
|
+
* Сравниваем время HEAD-коммита с createdAt задачи. Fail-open: нет git, нет
|
|
137
|
+
* даты или команда недоступна — предупреждения нет.
|
|
138
|
+
*/
|
|
139
|
+
export function workingDirectoryDriftWarning(def, cwd) {
|
|
140
|
+
if (!def.createdAt || !cwd)
|
|
141
|
+
return null;
|
|
142
|
+
const created = new Date(def.createdAt).getTime();
|
|
143
|
+
if (!Number.isFinite(created))
|
|
144
|
+
return null;
|
|
145
|
+
try {
|
|
146
|
+
const headIso = execFileSync("git", ["log", "-1", "--format=%cI"], {
|
|
147
|
+
cwd,
|
|
148
|
+
encoding: "utf8",
|
|
149
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
150
|
+
timeout: 5000,
|
|
151
|
+
}).trim();
|
|
152
|
+
const headTime = new Date(headIso).getTime();
|
|
153
|
+
if (!Number.isFinite(headTime) || headTime <= created)
|
|
154
|
+
return null;
|
|
155
|
+
return (`PL-8.1: рабочая директория ушла вперёд с момента постановки задачи (${def.createdAt}); ` +
|
|
156
|
+
`HEAD датирован ${headIso}. Quality Gate может упасть на чужих правках. ` +
|
|
157
|
+
"Зафиксируйте commit, на котором гейт считается валидным (например, проверьте HEAD внутри qualityGate), " +
|
|
158
|
+
"или используйте изолированный worktree.");
|
|
159
|
+
}
|
|
160
|
+
catch {
|
|
161
|
+
return null;
|
|
162
|
+
}
|
|
163
|
+
}
|
|
25
164
|
/**
|
|
26
165
|
* Описывает триггер задачи: что запускает задачу, не будет ли запуск
|
|
27
166
|
* пропущен из-за окна/дней недели, и (для git) состояние репозитория.
|
|
@@ -108,6 +247,11 @@ async function describeTrigger(opts) {
|
|
|
108
247
|
timezone: def.timezone,
|
|
109
248
|
})
|
|
110
249
|
: t("dryRun.cron", { schedule: def.schedule });
|
|
250
|
+
// PL-50: показываем, что расписание не зарегистрировано напрямую
|
|
251
|
+
// в schtasks, а проверяется минутным poll с schedule gate в обёртке.
|
|
252
|
+
if (def.schedule && needsPollMode(def.schedule, def.timezone ?? undefined)) {
|
|
253
|
+
base.polling = true;
|
|
254
|
+
}
|
|
111
255
|
break;
|
|
112
256
|
}
|
|
113
257
|
case "once": {
|
|
@@ -303,14 +447,19 @@ export async function simulatePipeline(taskName) {
|
|
|
303
447
|
taskWarnings.push(t("dryRun.cwdMissing", { path: cwd }));
|
|
304
448
|
}
|
|
305
449
|
}
|
|
306
|
-
//
|
|
307
|
-
//
|
|
450
|
+
// PL-8.1: HEAD мог уйти вперёд с момента постановки задачи — гейт проверяет
|
|
451
|
+
// уже другой код. Предупреждаем и советуем зафиксировать commit.
|
|
452
|
+
const drift = workingDirectoryDriftWarning(def, cwd);
|
|
453
|
+
if (drift)
|
|
454
|
+
taskWarnings.push(drift);
|
|
455
|
+
// PL-26/PL-30: trigger отражает реальный triggerType задачи и совпадает
|
|
456
|
+
// с triggerDetails.type. Режим входа в симуляцию вынесен в entryMode,
|
|
457
|
+
// чтобы не подменять тип триггера значениями manual/dag.
|
|
308
458
|
const triggerType = def.triggerType ?? "cron";
|
|
309
|
-
const trigger = triggerType
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
: "dag";
|
|
459
|
+
const trigger = triggerType;
|
|
460
|
+
const entryMode = lower === rootLower || (matrixParent && matrixParent.toLowerCase() === rootLower)
|
|
461
|
+
? "manual"
|
|
462
|
+
: "dag";
|
|
314
463
|
// Детали триггера (Спринт 27): состояние окна/дней недели, git-статус.
|
|
315
464
|
const triggerDetails = await describeTrigger({
|
|
316
465
|
def,
|
|
@@ -354,6 +503,47 @@ export async function simulatePipeline(taskName) {
|
|
|
354
503
|
taskWarnings.push(t("dryRun.dangerPattern", { message: t(messageKey) }));
|
|
355
504
|
}
|
|
356
505
|
}
|
|
506
|
+
// PL-5.1: nextTaskOnSuccess и dependsOn на одну задачу = дубль запуска.
|
|
507
|
+
const overlap = findChainDagOverlap(def, allDefs);
|
|
508
|
+
if (overlap) {
|
|
509
|
+
taskWarnings.push(`PL-5.1: nextTaskOnSuccess="${overlap}" и dependsOn указывают на одну задачу: ` +
|
|
510
|
+
`при завершении "${def.name}" шаг "${overlap}" будет запущен дважды. ` +
|
|
511
|
+
"Используйте только один механизм перехода (nextTaskOnSuccess ИЛИ dependsOn; см. SKILL.md §6).");
|
|
512
|
+
}
|
|
513
|
+
// PL-2.2: самопроверка через node/тесты при запрещённом shell — источник
|
|
514
|
+
// tool.blocked в аудите и ложного «проверено» в отчёте агента.
|
|
515
|
+
if (shellIsForbidden(def) &&
|
|
516
|
+
typeof def.prompt === "string" &&
|
|
517
|
+
SELF_CHECK_PATTERNS.some((pattern) => pattern.test(def.prompt ?? ""))) {
|
|
518
|
+
taskWarnings.push("PL-2.2: промпт требует самопроверки (node/тесты), но shell запрещён: добавьте shell в allowedTools или перенесите проверки в qualityGate/afterScript.");
|
|
519
|
+
}
|
|
520
|
+
// QV-9: частый cron + тяжёлый промпт (`opencode run`) — антипаттерн из
|
|
521
|
+
// SKILL.md: каждый тик поднимает полную сессию агента и сжигает квоту.
|
|
522
|
+
if (triggerType === "cron" &&
|
|
523
|
+
def.schedule &&
|
|
524
|
+
isFrequentCron(def.schedule) &&
|
|
525
|
+
/\bopencode\s+run\b/i.test(def.prompt ?? "")) {
|
|
526
|
+
taskWarnings.push(`QV-9: cron "${def.schedule}" запускает opencode run чаще, чем раз в 5 минут: ` +
|
|
527
|
+
"каждый тик поднимает полную сессию агента. Используйте редкое расписание или событийный триггер (mcp-event/file/git).");
|
|
528
|
+
}
|
|
529
|
+
// PL-49: таймаут длиннее интервала cron — следующий тик наступит до
|
|
530
|
+
// завершения текущего, и запуск будет пропущен (lock-skip).
|
|
531
|
+
const intervalMinutes = triggerType === "cron" && def.schedule
|
|
532
|
+
? minimumCronIntervalMinutes(def.schedule)
|
|
533
|
+
: null;
|
|
534
|
+
if (intervalMinutes !== null &&
|
|
535
|
+
typeof def.timeoutSeconds === "number" &&
|
|
536
|
+
def.timeoutSeconds > intervalMinutes * 60) {
|
|
537
|
+
taskWarnings.push(`PL-49: timeoutSeconds=${def.timeoutSeconds}с больше интервала cron "${def.schedule}" ` +
|
|
538
|
+
`(${intervalMinutes} мин): следующий тик наступит до завершения текущего прогона. ` +
|
|
539
|
+
"Увеличьте интервал или уменьшите таймаут.");
|
|
540
|
+
}
|
|
541
|
+
// PL-50: cron вне подмножества schtasks тикает каждую минуту — это не
|
|
542
|
+
// частота задачи, а частота опроса planner'а; без пометки легко ошибиться.
|
|
543
|
+
if (triggerDetails.polling) {
|
|
544
|
+
taskWarnings.push(`PL-50: cron "${def.schedule}" не выражается в планировщике ОС: ` +
|
|
545
|
+
"записана ежеминутная проверка с schedule gate. Фактическая частота запуска — по cron, но каждую минуту создаётся ProcessID для проверки расписания.");
|
|
546
|
+
}
|
|
357
547
|
const roleScoped = Array.isArray(def.allowedTools) && def.allowedTools.length > 0
|
|
358
548
|
? { allowed: def.allowedTools, denied: def.deniedTools }
|
|
359
549
|
: Array.isArray(def.deniedTools) && def.deniedTools.length > 0
|
|
@@ -402,6 +592,7 @@ export async function simulatePipeline(taskName) {
|
|
|
402
592
|
name: def.name,
|
|
403
593
|
order: index,
|
|
404
594
|
trigger,
|
|
595
|
+
entryMode,
|
|
405
596
|
session: def.session ?? "new",
|
|
406
597
|
sessionId: def.session === "reuse" ? def.sessionId ?? null : null,
|
|
407
598
|
// Спринт 27.5.4: показываем режим входа до регистрации в ОС.
|