agent-steward 0.0.4 → 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 +309 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +55 -8
- package/ROADMAP-STRATEGY.md +22 -19
- package/ROADMAP.md +230 -159
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +356 -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/execution.d.ts +203 -0
- package/dist/core/execution.d.ts.map +1 -0
- package/dist/core/execution.js +309 -0
- 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 +71 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +275 -0
- package/dist/core/git-trigger.d.ts.map +1 -1
- package/dist/core/git-trigger.js +14 -2
- package/dist/core/guard-run.d.ts +4 -0
- package/dist/core/guard-run.d.ts.map +1 -0
- package/dist/core/guard-run.js +101 -0
- package/dist/core/guard.d.ts +52 -0
- package/dist/core/guard.d.ts.map +1 -0
- package/dist/core/guard.js +362 -0
- package/dist/core/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/lock.d.ts +41 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +141 -29
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +132 -17
- package/dist/core/mission.d.ts +103 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +374 -0
- 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-apply.d.ts +38 -0
- package/dist/core/pipeline-apply.d.ts.map +1 -0
- package/dist/core/pipeline-apply.js +117 -0
- package/dist/core/pipeline-io.d.ts +13 -0
- package/dist/core/pipeline-io.d.ts.map +1 -0
- package/dist/core/pipeline-io.js +78 -0
- package/dist/core/pipeline-map.d.ts +52 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +208 -0
- package/dist/core/pipeline-spec.d.ts +109 -0
- package/dist/core/pipeline-spec.d.ts.map +1 -0
- package/dist/core/pipeline-spec.js +554 -0
- package/dist/core/ps-wrapper.d.ts +27 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +424 -65
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +206 -33
- package/dist/core/router/rules.d.ts.map +1 -1
- package/dist/core/router/rules.js +6 -0
- 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/linux.d.ts +8 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +34 -9
- 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/scheduler/mac.d.ts +44 -2
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +126 -15
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +15 -12
- 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 +37 -1
- 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/worktree-run.d.ts +4 -0
- package/dist/core/worktree-run.d.ts.map +1 -0
- package/dist/core/worktree-run.js +164 -0
- package/dist/core/worktree.d.ts +115 -0
- package/dist/core/worktree.d.ts.map +1 -0
- package/dist/core/worktree.js +462 -0
- package/dist/core/wrappers/bash.d.ts +19 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +230 -27
- package/dist/db/capability-repo.d.ts +43 -2
- package/dist/db/capability-repo.d.ts.map +1 -1
- package/dist/db/capability-repo.js +96 -11
- package/dist/db/history-repo.d.ts +70 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +170 -29
- 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 +35 -13
- 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 +11 -5
- package/dist/db/run-journal.d.ts +33 -5
- package/dist/db/run-journal.d.ts.map +1 -1
- package/dist/db/run-journal.js +78 -14
- package/dist/db/run-resume.d.ts +5 -0
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +9 -2
- package/dist/db/runs-repo.d.ts +19 -2
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +91 -60
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +132 -2
- 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 +7 -2
- 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/i18n.d.ts +5 -0
- package/dist/i18n.d.ts.map +1 -1
- package/dist/i18n.js +11 -4
- package/dist/index.d.ts +375 -47
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1344 -192
- package/dist/notifications.d.ts +53 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +168 -21
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +82 -10
- package/dist/rpc.d.ts +354 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +145 -0
- package/dist/server.d.ts +32 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +154 -30
- package/dist/settings.d.ts +44 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +85 -3
- package/dist/shared/jobs-view.d.ts +1 -1
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/shared/jobs-view.js +2 -0
- package/dist/task-transfer.d.ts +21 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +64 -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 +319 -66
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +18 -4
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +28 -10
- package/docs/FEATURES.md +129 -7
- package/docs/FEATURES.zh.md +97 -6
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +43 -4
- package/docs/README.zh.md +44 -4
- package/docs/SAFETY.md +23 -3
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +58 -3
- package/locales/ru.json +58 -3
- package/locales/zh.json +58 -3
- package/opencode.pipeline.yaml +35 -0
- package/package.json +36 -4
- 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 +107 -0
- 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 +417 -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 +235 -12
- package/src/core/execution.ts +538 -0
- package/src/core/feedback.ts +582 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +330 -0
- package/src/core/git-trigger.ts +18 -5
- package/src/core/guard-run.ts +119 -0
- package/src/core/guard.ts +431 -0
- package/src/core/local-ai.ts +7 -3
- package/src/core/lock.ts +178 -37
- package/src/core/matrix.ts +158 -52
- package/src/core/mission.ts +531 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +96 -0
- package/src/core/pipeline-map.ts +283 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +435 -66
- package/src/core/record-history.ts +258 -81
- package/src/core/router/rules.ts +6 -0
- package/src/core/run-mode.ts +19 -0
- package/src/core/schedule-gate.ts +1 -1
- package/src/core/scheduler/at-fallback.ts +1 -1
- package/src/core/scheduler/linux.ts +40 -11
- package/src/core/scheduler/logs.ts +34 -3
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/registry.ts +2 -2
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +26 -19
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +89 -5
- package/src/core/telegram.ts +2 -2
- package/src/core/triage-worker.ts +7 -7
- package/src/core/triage.ts +2 -2
- package/src/core/usage-surface.ts +70 -0
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +248 -26
- package/src/db/capability-repo.ts +127 -10
- package/src/db/history-repo.ts +281 -40
- package/src/db/metrics-repo.ts +40 -13
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +12 -5
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +17 -1
- package/src/db/runs-repo.ts +147 -65
- package/src/db/schema.ts +134 -2
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +438 -18
- package/src/history.ts +11 -4
- package/src/hook-output.ts +39 -0
- package/src/i18n.ts +12 -4
- package/src/index.ts +1902 -320
- package/src/notifications.ts +227 -47
- package/src/profiles.ts +88 -10
- package/src/rpc.ts +158 -0
- package/src/server.ts +201 -41
- package/src/settings.ts +125 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +90 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
package/src/core/dry-run.ts
CHANGED
|
@@ -6,15 +6,69 @@
|
|
|
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";
|
|
16
17
|
import type { TaskDefinition } from "../task-transfer.js";
|
|
17
18
|
|
|
19
|
+
/**
|
|
20
|
+
* QV-9: cron срабатывает чаще, чем раз в 5 минут, круглосуточно.
|
|
21
|
+
* Поддерживаются `* * * * *`, каждый N-ю минуту (N <= 5) и списки минут с
|
|
22
|
+
* минимальным циклическим шагом <= 5. Часовой/дневной фильтр означает,
|
|
23
|
+
* что задача не является «постоянным опросом» и отдельно не предупреждается.
|
|
24
|
+
*/
|
|
25
|
+
export function isFrequentCron(schedule: string): boolean {
|
|
26
|
+
const parts = schedule.trim().split(/\s+/);
|
|
27
|
+
if (parts.length < 5) return false;
|
|
28
|
+
const [minute, hour, dom, month, dow] = parts;
|
|
29
|
+
if (hour !== "*" || dom !== "*" || month !== "*" || dow !== "*") return false;
|
|
30
|
+
if (minute === "*") return true;
|
|
31
|
+
const step = /^\*\/(\d+)$/.exec(minute);
|
|
32
|
+
if (step) return Number(step[1]) <= 5;
|
|
33
|
+
const minutes = minute.split(",").map((m) => Number(m));
|
|
34
|
+
if (minutes.length > 1 && minutes.every((n) => Number.isInteger(n) && n >= 0 && n < 60)) {
|
|
35
|
+
const sorted = [...minutes].sort((a, b) => a - b);
|
|
36
|
+
let minStep = 60 - sorted[sorted.length - 1] + sorted[0];
|
|
37
|
+
for (let i = 1; i < sorted.length; i++) {
|
|
38
|
+
minStep = Math.min(minStep, sorted[i] - sorted[i - 1]);
|
|
39
|
+
}
|
|
40
|
+
return minStep <= 5;
|
|
41
|
+
}
|
|
42
|
+
return false;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* PL-49: минимальный интервал срабатывания cron в минутах для простых
|
|
47
|
+
* выражений. Возвращает null, если интервал нельзя надёжно вывести.
|
|
48
|
+
*/
|
|
49
|
+
export function minimumCronIntervalMinutes(schedule: string): number | null {
|
|
50
|
+
const parts = schedule.trim().split(/\s+/);
|
|
51
|
+
if (parts.length < 5) return null;
|
|
52
|
+
const [minute, hour, dom, month, dow] = parts;
|
|
53
|
+
if (hour !== "*" || dom !== "*" || month !== "*" || dow !== "*") return null;
|
|
54
|
+
if (minute === "*") return 1;
|
|
55
|
+
const step = /^\*\/(\d+)$/.exec(minute);
|
|
56
|
+
if (step) {
|
|
57
|
+
const n = Number(step[1]);
|
|
58
|
+
return n >= 1 && n <= 60 ? n : null;
|
|
59
|
+
}
|
|
60
|
+
const minutes = minute.split(",").map((m) => Number(m));
|
|
61
|
+
if (minutes.length > 1 && minutes.every((n) => Number.isInteger(n) && n >= 0 && n < 60)) {
|
|
62
|
+
const sorted = [...minutes].sort((a, b) => a - b);
|
|
63
|
+
let minStep = 60 - sorted[sorted.length - 1] + sorted[0];
|
|
64
|
+
for (let i = 1; i < sorted.length; i++) {
|
|
65
|
+
minStep = Math.min(minStep, sorted[i] - sorted[i - 1]);
|
|
66
|
+
}
|
|
67
|
+
return minStep;
|
|
68
|
+
}
|
|
69
|
+
return null;
|
|
70
|
+
}
|
|
71
|
+
|
|
18
72
|
export interface DryRunRoleScoped {
|
|
19
73
|
allowed?: string[];
|
|
20
74
|
denied?: string[];
|
|
@@ -28,6 +82,8 @@ export interface DryRunTriggerDetails {
|
|
|
28
82
|
type: "manual" | "cron" | "file" | "git" | "mcp-event" | "once";
|
|
29
83
|
/** Человекочитаемое объяснение условия запуска. */
|
|
30
84
|
explanation: string;
|
|
85
|
+
/** PL-50: cron не expressible в schtasks — ОС опрашивает его каждую минуту. */
|
|
86
|
+
polling?: boolean;
|
|
31
87
|
/** Состояние окна запуска и разрешённых дней недели (если заданы). */
|
|
32
88
|
activeWindow?: {
|
|
33
89
|
active: boolean;
|
|
@@ -53,7 +109,10 @@ export interface DryRunTriggerDetails {
|
|
|
53
109
|
export interface DryRunTaskItem {
|
|
54
110
|
name: string;
|
|
55
111
|
order: number;
|
|
56
|
-
|
|
112
|
+
/** PL-26/PL-30: реальный triggerType definition (совпадает с triggerDetails.type). */
|
|
113
|
+
trigger: DryRunTriggerDetails["type"];
|
|
114
|
+
/** Как задача попала в симуляцию: manual — корень, dag — через dependsOn. */
|
|
115
|
+
entryMode: "manual" | "dag";
|
|
57
116
|
cwd: string;
|
|
58
117
|
command: string;
|
|
59
118
|
workspace?: { name: string; path: string };
|
|
@@ -123,6 +182,97 @@ const DANGEROUS_PATTERNS: { test: RegExp; messageKey: string }[] = [
|
|
|
123
182
|
{ test: /git\s+push\s+.*--force(?:\s|$)/, messageKey: "dryRun.danger.forcePush" },
|
|
124
183
|
];
|
|
125
184
|
|
|
185
|
+
/**
|
|
186
|
+
* PL-2.2: команды самопроверки, которые агент не выполнит без инструмента
|
|
187
|
+
* shell. Если они есть в промпте, а shell запрещён, агент получает tool.blocked
|
|
188
|
+
* и рапортует об «успешной проверке», ничего не проверив.
|
|
189
|
+
*/
|
|
190
|
+
const SELF_CHECK_PATTERNS: readonly RegExp[] = [
|
|
191
|
+
/\bnpm\s+(?:test|run\s+[\w-]*test[\w-]*)\b/i,
|
|
192
|
+
/\bnode(?:\.exe)?\s+\S/i,
|
|
193
|
+
/\bpytest\b/i,
|
|
194
|
+
/\b(?:go|dotnet)\s+test\b/i,
|
|
195
|
+
/\btest\b/i,
|
|
196
|
+
/тест/iu,
|
|
197
|
+
];
|
|
198
|
+
|
|
199
|
+
/** PL-2.2: эффективный запрет shell с учётом legacy-режима и политик. */
|
|
200
|
+
function shellIsForbidden(def: TaskDefinition): boolean {
|
|
201
|
+
if (def.legacyShell === true) return false;
|
|
202
|
+
const isShell = (tool: string): boolean => /^(?:shell|bash)$/i.test(tool.trim());
|
|
203
|
+
const allowed = Array.isArray(def.allowedTools) ? def.allowedTools : [];
|
|
204
|
+
const denied = Array.isArray(def.deniedTools) ? def.deniedTools : [];
|
|
205
|
+
if (allowed.length > 0) return !allowed.some(isShell);
|
|
206
|
+
if (denied.length > 0) return denied.some(isShell);
|
|
207
|
+
// Политика hybrid по умолчанию запрещает shell (см. SKILL.md §4).
|
|
208
|
+
return true;
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
/**
|
|
212
|
+
* PL-5.1: цепочка и DAG могут указывать на один и тот же переход. Тогда при
|
|
213
|
+
* завершении шага он будет запущен дважды: как chainTarget и как зависимый.
|
|
214
|
+
* Возвращаем имя конфликтующей задачи или null. Fail-open: нет данных — тишина.
|
|
215
|
+
*/
|
|
216
|
+
function findChainDagOverlap(
|
|
217
|
+
def: TaskDefinition,
|
|
218
|
+
allDefs: TaskDefinition[],
|
|
219
|
+
): string | null {
|
|
220
|
+
const next = (def.nextTaskOnSuccess ?? "").trim();
|
|
221
|
+
if (!next) return null;
|
|
222
|
+
const nextLower = next.toLowerCase();
|
|
223
|
+
|
|
224
|
+
// Случай 1: преемник прямо перечислен в dependsOn текущей задачи.
|
|
225
|
+
if (
|
|
226
|
+
(def.dependsOn ?? []).some(
|
|
227
|
+
(dep) => (dep ?? "").trim().toLowerCase() === nextLower,
|
|
228
|
+
)
|
|
229
|
+
) {
|
|
230
|
+
return next;
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
// Случай 2 (типичная линейная цепочка): преемник сам зависит от текущей.
|
|
234
|
+
const nextDef = allDefs.find((d) => d.name.toLowerCase() === nextLower);
|
|
235
|
+
if (
|
|
236
|
+
nextDef &&
|
|
237
|
+
(nextDef.dependsOn ?? []).some(
|
|
238
|
+
(dep) => (dep ?? "").trim().toLowerCase() === def.name.toLowerCase(),
|
|
239
|
+
)
|
|
240
|
+
) {
|
|
241
|
+
return next;
|
|
242
|
+
}
|
|
243
|
+
return null;
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
/**
|
|
247
|
+
* PL-8.1: рабочая директория могла уйти вперёд с момента постановки задачи —
|
|
248
|
+
* Quality Gate тогда проверяет уже другой код (расхождение счётчиков и т.п.).
|
|
249
|
+
* Сравниваем время HEAD-коммита с createdAt задачи. Fail-open: нет git, нет
|
|
250
|
+
* даты или команда недоступна — предупреждения нет.
|
|
251
|
+
*/
|
|
252
|
+
export function workingDirectoryDriftWarning(def: TaskDefinition, cwd: string): string | null {
|
|
253
|
+
if (!def.createdAt || !cwd) return null;
|
|
254
|
+
const created = new Date(def.createdAt).getTime();
|
|
255
|
+
if (!Number.isFinite(created)) return null;
|
|
256
|
+
try {
|
|
257
|
+
const headIso = execFileSync("git", ["log", "-1", "--format=%cI"], {
|
|
258
|
+
cwd,
|
|
259
|
+
encoding: "utf8",
|
|
260
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
261
|
+
timeout: 5000,
|
|
262
|
+
}).trim();
|
|
263
|
+
const headTime = new Date(headIso).getTime();
|
|
264
|
+
if (!Number.isFinite(headTime) || headTime <= created) return null;
|
|
265
|
+
return (
|
|
266
|
+
`PL-8.1: рабочая директория ушла вперёд с момента постановки задачи (${def.createdAt}); ` +
|
|
267
|
+
`HEAD датирован ${headIso}. Quality Gate может упасть на чужих правках. ` +
|
|
268
|
+
"Зафиксируйте commit, на котором гейт считается валидным (например, проверьте HEAD внутри qualityGate), " +
|
|
269
|
+
"или используйте изолированный worktree."
|
|
270
|
+
);
|
|
271
|
+
} catch {
|
|
272
|
+
return null;
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
|
|
126
276
|
/**
|
|
127
277
|
* Свойства для описания триггера задачи в dry-run (Спринт 27).
|
|
128
278
|
*/
|
|
@@ -183,7 +333,7 @@ async function describeTrigger(opts: DescribeTriggerOptions): Promise<DryRunTrig
|
|
|
183
333
|
t("dryRun.git.branchMismatch", { branch: def.gitBranch ?? "" }),
|
|
184
334
|
);
|
|
185
335
|
}
|
|
186
|
-
} catch (err:
|
|
336
|
+
} catch (err: unknown) {
|
|
187
337
|
base.explanation = t("dryRun.git.checkError", {
|
|
188
338
|
error: err instanceof Error ? err.message : String(err),
|
|
189
339
|
});
|
|
@@ -232,6 +382,11 @@ async function describeTrigger(opts: DescribeTriggerOptions): Promise<DryRunTrig
|
|
|
232
382
|
timezone: def.timezone,
|
|
233
383
|
})
|
|
234
384
|
: t("dryRun.cron", { schedule: def.schedule });
|
|
385
|
+
// PL-50: показываем, что расписание не зарегистрировано напрямую
|
|
386
|
+
// в schtasks, а проверяется минутным poll с schedule gate в обёртке.
|
|
387
|
+
if (def.schedule && needsPollMode(def.schedule, def.timezone ?? undefined)) {
|
|
388
|
+
base.polling = true;
|
|
389
|
+
}
|
|
235
390
|
break;
|
|
236
391
|
}
|
|
237
392
|
|
|
@@ -409,7 +564,7 @@ export async function simulatePipeline(taskName: string): Promise<DryRunReport>
|
|
|
409
564
|
t("dryRun.matrix.parent", { name: def.name, count: clones.length }),
|
|
410
565
|
);
|
|
411
566
|
for (const clone of clones) units.push({ def: clone, matrixParent: def.name });
|
|
412
|
-
} catch (err:
|
|
567
|
+
} catch (err: unknown) {
|
|
413
568
|
const list = warningsPerTask.get(def.name.toLowerCase()) ?? [];
|
|
414
569
|
list.push(
|
|
415
570
|
t("dryRun.matrix.expandError", {
|
|
@@ -453,15 +608,20 @@ export async function simulatePipeline(taskName: string): Promise<DryRunReport>
|
|
|
453
608
|
}
|
|
454
609
|
}
|
|
455
610
|
|
|
456
|
-
//
|
|
457
|
-
//
|
|
611
|
+
// PL-8.1: HEAD мог уйти вперёд с момента постановки задачи — гейт проверяет
|
|
612
|
+
// уже другой код. Предупреждаем и советуем зафиксировать commit.
|
|
613
|
+
const drift = workingDirectoryDriftWarning(def, cwd);
|
|
614
|
+
if (drift) taskWarnings.push(drift);
|
|
615
|
+
|
|
616
|
+
// PL-26/PL-30: trigger отражает реальный triggerType задачи и совпадает
|
|
617
|
+
// с triggerDetails.type. Режим входа в симуляцию вынесен в entryMode,
|
|
618
|
+
// чтобы не подменять тип триггера значениями manual/dag.
|
|
458
619
|
const triggerType = def.triggerType ?? "cron";
|
|
459
|
-
const trigger
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
: "dag";
|
|
620
|
+
const trigger = triggerType as DryRunTaskItem["trigger"];
|
|
621
|
+
const entryMode: DryRunTaskItem["entryMode"] =
|
|
622
|
+
lower === rootLower || (matrixParent && matrixParent.toLowerCase() === rootLower)
|
|
623
|
+
? "manual"
|
|
624
|
+
: "dag";
|
|
465
625
|
|
|
466
626
|
// Детали триггера (Спринт 27): состояние окна/дней недели, git-статус.
|
|
467
627
|
const triggerDetails = await describeTrigger({
|
|
@@ -510,6 +670,68 @@ export async function simulatePipeline(taskName: string): Promise<DryRunReport>
|
|
|
510
670
|
}
|
|
511
671
|
}
|
|
512
672
|
|
|
673
|
+
// PL-5.1: nextTaskOnSuccess и dependsOn на одну задачу = дубль запуска.
|
|
674
|
+
const overlap = findChainDagOverlap(def, allDefs);
|
|
675
|
+
if (overlap) {
|
|
676
|
+
taskWarnings.push(
|
|
677
|
+
`PL-5.1: nextTaskOnSuccess="${overlap}" и dependsOn указывают на одну задачу: ` +
|
|
678
|
+
`при завершении "${def.name}" шаг "${overlap}" будет запущен дважды. ` +
|
|
679
|
+
"Используйте только один механизм перехода (nextTaskOnSuccess ИЛИ dependsOn; см. SKILL.md §6).",
|
|
680
|
+
);
|
|
681
|
+
}
|
|
682
|
+
|
|
683
|
+
// PL-2.2: самопроверка через node/тесты при запрещённом shell — источник
|
|
684
|
+
// tool.blocked в аудите и ложного «проверено» в отчёте агента.
|
|
685
|
+
if (
|
|
686
|
+
shellIsForbidden(def) &&
|
|
687
|
+
typeof def.prompt === "string" &&
|
|
688
|
+
SELF_CHECK_PATTERNS.some((pattern) => pattern.test(def.prompt ?? ""))
|
|
689
|
+
) {
|
|
690
|
+
taskWarnings.push(
|
|
691
|
+
"PL-2.2: промпт требует самопроверки (node/тесты), но shell запрещён: добавьте shell в allowedTools или перенесите проверки в qualityGate/afterScript.",
|
|
692
|
+
);
|
|
693
|
+
}
|
|
694
|
+
|
|
695
|
+
// QV-9: частый cron + тяжёлый промпт (`opencode run`) — антипаттерн из
|
|
696
|
+
// SKILL.md: каждый тик поднимает полную сессию агента и сжигает квоту.
|
|
697
|
+
if (
|
|
698
|
+
triggerType === "cron" &&
|
|
699
|
+
def.schedule &&
|
|
700
|
+
isFrequentCron(def.schedule) &&
|
|
701
|
+
/\bopencode\s+run\b/i.test(def.prompt ?? "")
|
|
702
|
+
) {
|
|
703
|
+
taskWarnings.push(
|
|
704
|
+
`QV-9: cron "${def.schedule}" запускает opencode run чаще, чем раз в 5 минут: ` +
|
|
705
|
+
"каждый тик поднимает полную сессию агента. Используйте редкое расписание или событийный триггер (mcp-event/file/git).",
|
|
706
|
+
);
|
|
707
|
+
}
|
|
708
|
+
|
|
709
|
+
// PL-49: таймаут длиннее интервала cron — следующий тик наступит до
|
|
710
|
+
// завершения текущего, и запуск будет пропущен (lock-skip).
|
|
711
|
+
const intervalMinutes = triggerType === "cron" && def.schedule
|
|
712
|
+
? minimumCronIntervalMinutes(def.schedule)
|
|
713
|
+
: null;
|
|
714
|
+
if (
|
|
715
|
+
intervalMinutes !== null &&
|
|
716
|
+
typeof def.timeoutSeconds === "number" &&
|
|
717
|
+
def.timeoutSeconds > intervalMinutes * 60
|
|
718
|
+
) {
|
|
719
|
+
taskWarnings.push(
|
|
720
|
+
`PL-49: timeoutSeconds=${def.timeoutSeconds}с больше интервала cron "${def.schedule}" ` +
|
|
721
|
+
`(${intervalMinutes} мин): следующий тик наступит до завершения текущего прогона. ` +
|
|
722
|
+
"Увеличьте интервал или уменьшите таймаут.",
|
|
723
|
+
);
|
|
724
|
+
}
|
|
725
|
+
|
|
726
|
+
// PL-50: cron вне подмножества schtasks тикает каждую минуту — это не
|
|
727
|
+
// частота задачи, а частота опроса planner'а; без пометки легко ошибиться.
|
|
728
|
+
if (triggerDetails.polling) {
|
|
729
|
+
taskWarnings.push(
|
|
730
|
+
`PL-50: cron "${def.schedule}" не выражается в планировщике ОС: ` +
|
|
731
|
+
"записана ежеминутная проверка с schedule gate. Фактическая частота запуска — по cron, но каждую минуту создаётся ProcessID для проверки расписания.",
|
|
732
|
+
);
|
|
733
|
+
}
|
|
734
|
+
|
|
513
735
|
const roleScoped: DryRunRoleScoped | null =
|
|
514
736
|
Array.isArray(def.allowedTools) && def.allowedTools.length > 0
|
|
515
737
|
? { allowed: def.allowedTools, denied: def.deniedTools }
|
|
@@ -560,6 +782,7 @@ export async function simulatePipeline(taskName: string): Promise<DryRunReport>
|
|
|
560
782
|
name: def.name,
|
|
561
783
|
order: index,
|
|
562
784
|
trigger,
|
|
785
|
+
entryMode,
|
|
563
786
|
session: def.session ?? "new",
|
|
564
787
|
sessionId: def.session === "reuse" ? def.sessionId ?? null : null,
|
|
565
788
|
// Спринт 27.5.4: показываем режим входа до регистрации в ОС.
|