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
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
export declare const GATE_SNAPSHOT_VERSION = 1;
|
|
2
|
+
export declare const GATE_SNAPSHOT_DIR: string;
|
|
3
|
+
export interface GateSnapshotInputs {
|
|
4
|
+
/** Текст гейта: на Windows — содержимое hook-файла, на POSIX — команда. */
|
|
5
|
+
gate: string;
|
|
6
|
+
/** Текст промпта задачи. */
|
|
7
|
+
prompt: string;
|
|
8
|
+
/** Таймаут гейта в секундах. */
|
|
9
|
+
gateTimeoutSeconds: number;
|
|
10
|
+
}
|
|
11
|
+
export interface GateSnapshot {
|
|
12
|
+
version: number;
|
|
13
|
+
taskName: string;
|
|
14
|
+
createdAt: string;
|
|
15
|
+
hash: string;
|
|
16
|
+
}
|
|
17
|
+
/** Канонический хэш входов гейта. Порядок полей фиксирован контрактом. */
|
|
18
|
+
export declare function gateInputsHash(inputs: GateSnapshotInputs): string;
|
|
19
|
+
/** Путь snapshot'а задачи — вне рабочей директории задачи. */
|
|
20
|
+
export declare function gateSnapshotPath(taskName: string): string;
|
|
21
|
+
/** Пишет snapshot задачам на этапе создания обёртки (fail-closed при ошибке). */
|
|
22
|
+
export declare function createGateSnapshot(taskName: string, inputs: GateSnapshotInputs, snapshotFile?: string): string;
|
|
23
|
+
export declare function readGateSnapshot(file: string): GateSnapshot | null;
|
|
24
|
+
/** Сверяет текущие входы гейта с зафиксированными. При расхождении — fail-closed. */
|
|
25
|
+
export declare function verifyGateSnapshot(snapshotFile: string, inputs: GateSnapshotInputs): {
|
|
26
|
+
ok: boolean;
|
|
27
|
+
reason?: string;
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
* PL-25: состояние отслеживаемых исходников на границе прогона.
|
|
31
|
+
*
|
|
32
|
+
* Хэш входов гейта (G-1.2) защищает от подмены самой команды, но не от
|
|
33
|
+
* чужого незакоммиченного кода: параллельная задача может изменить `src/`
|
|
34
|
+
* между стартом runners и post-flight гейтом, и гейт «позеленеет» на
|
|
35
|
+
* уже другом дереве. Фиксируем HEAD + `git status --porcelain` для `src/`.
|
|
36
|
+
*/
|
|
37
|
+
export interface WorktreeSnapshot {
|
|
38
|
+
version: number;
|
|
39
|
+
head: string;
|
|
40
|
+
status: string;
|
|
41
|
+
capturedAt: string;
|
|
42
|
+
}
|
|
43
|
+
export declare const WORKTREE_SNAPSHOT_VERSION = 1;
|
|
44
|
+
/** Пути, за которыми следит гейт; по умолчанию только исходники плагина. */
|
|
45
|
+
export declare function worktreeGuardPaths(env?: NodeJS.ProcessEnv): string[];
|
|
46
|
+
/**
|
|
47
|
+
* PL-47: пути, которые задача изменить вправе (обычно из `-Files` afterScript).
|
|
48
|
+
* Исключаются из сравнения со snapshot: агент спокойно правит свои файлы,
|
|
49
|
+
* а чужие правки в остальной части `src/` по-прежнему срывают гейт.
|
|
50
|
+
*/
|
|
51
|
+
export declare function worktreeAllowPaths(env?: NodeJS.ProcessEnv): string[];
|
|
52
|
+
/** Возвращает null, если каталог не git-репозиторий или git недоступен. */
|
|
53
|
+
export declare function readWorktreeState(dir: string, env?: NodeJS.ProcessEnv): {
|
|
54
|
+
head: string;
|
|
55
|
+
status: string;
|
|
56
|
+
} | null;
|
|
57
|
+
/** Пишет snapshot дерева; null — не git-репозиторий (гейт не блокируем). */
|
|
58
|
+
export declare function captureWorktreeSnapshot(dir: string, outFile: string, env?: NodeJS.ProcessEnv): string | null;
|
|
59
|
+
export declare function readWorktreeSnapshot(file: string): WorktreeSnapshot | null;
|
|
60
|
+
/** Сверяет дерево со snapshot'ом, снятым на старте задачи. */
|
|
61
|
+
export declare function verifyWorktreeSnapshot(dir: string, file: string, env?: NodeJS.ProcessEnv): {
|
|
62
|
+
ok: boolean;
|
|
63
|
+
reason?: string;
|
|
64
|
+
};
|
|
65
|
+
/**
|
|
66
|
+
* CLI для обёрток: `node gate-integrity.js verify --snapshot <file>
|
|
67
|
+
* --gate-file <file> | --gate-command <text> --prompt-file <file> --timeout <n>`.
|
|
68
|
+
* exit 0 — входы совпадают, exit 1 — расхождение/отсутствие snapshot'а.
|
|
69
|
+
*/
|
|
70
|
+
export declare function main(argv?: string[]): Promise<number>;
|
|
71
|
+
//# sourceMappingURL=gate-integrity.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gate-integrity.d.ts","sourceRoot":"","sources":["../../src/core/gate-integrity.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,iBAAiB,QAA0C,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAQjE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAWD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,YAAY,SAA6B,GACxC,MAAM,CAaR;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAgBlE;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,kBAAkB,GACzB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAclC;AAOD;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAKjF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAOjF;AAmBD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBzC;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,IAAI,CAWf;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAgB1E;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBlC;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDxE"}
|
|
@@ -0,0 +1,275 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* G-1.2: проверяемый snapshot входов Quality Gate.
|
|
3
|
+
*
|
|
4
|
+
* Обёртка фиксирует хэш команды/хука гейта, промпта и таймаута в момент
|
|
5
|
+
* создания задачи (файл лежит в PLUGIN_DIR, вне write-scope агента) и
|
|
6
|
+
* сверяет его непосредственно перед запуском гейта. Подмена гейта или
|
|
7
|
+
* промпта после создания задачи приводит к fail-closed: гейт не выполняется,
|
|
8
|
+
* запуск помечается ошибкой. Snapshot защищает от подмены *definition*
|
|
9
|
+
* гейта; исходники, которые гейт проверяет, в хэш не входят (агент
|
|
10
|
+
* legitimately меняет их в ходе задачи).
|
|
11
|
+
*/
|
|
12
|
+
import { execFileSync } from "node:child_process";
|
|
13
|
+
import crypto from "node:crypto";
|
|
14
|
+
import fs from "node:fs";
|
|
15
|
+
import path from "node:path";
|
|
16
|
+
import { fileURLToPath } from "node:url";
|
|
17
|
+
import { PLUGIN_DIR, sanitizeName } from "../types.js";
|
|
18
|
+
export const GATE_SNAPSHOT_VERSION = 1;
|
|
19
|
+
export const GATE_SNAPSHOT_DIR = path.join(PLUGIN_DIR, "gate-snapshots");
|
|
20
|
+
/** Канонический хэш входов гейта. Порядок полей фиксирован контрактом. */
|
|
21
|
+
export function gateInputsHash(inputs) {
|
|
22
|
+
const canonical = JSON.stringify({
|
|
23
|
+
version: GATE_SNAPSHOT_VERSION,
|
|
24
|
+
gate: inputs.gate,
|
|
25
|
+
prompt: inputs.prompt,
|
|
26
|
+
gateTimeoutSeconds: inputs.gateTimeoutSeconds,
|
|
27
|
+
});
|
|
28
|
+
return crypto.createHash("sha256").update(canonical, "utf8").digest("hex");
|
|
29
|
+
}
|
|
30
|
+
/** Путь snapshot'а задачи — вне рабочей директории задачи. */
|
|
31
|
+
export function gateSnapshotPath(taskName) {
|
|
32
|
+
const segment = sanitizeName(taskName).slice(0, 80) || "task";
|
|
33
|
+
return path.join(GATE_SNAPSHOT_DIR, `${segment}.json`);
|
|
34
|
+
}
|
|
35
|
+
function readText(file) {
|
|
36
|
+
if (!file)
|
|
37
|
+
return "";
|
|
38
|
+
try {
|
|
39
|
+
return fs.readFileSync(file, "utf8");
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
return "";
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
/** Пишет snapshot задачам на этапе создания обёртки (fail-closed при ошибке). */
|
|
46
|
+
export function createGateSnapshot(taskName, inputs, snapshotFile = gateSnapshotPath(taskName)) {
|
|
47
|
+
const snapshot = {
|
|
48
|
+
version: GATE_SNAPSHOT_VERSION,
|
|
49
|
+
taskName,
|
|
50
|
+
createdAt: new Date().toISOString(),
|
|
51
|
+
hash: gateInputsHash(inputs),
|
|
52
|
+
};
|
|
53
|
+
fs.mkdirSync(path.dirname(snapshotFile), { recursive: true });
|
|
54
|
+
fs.writeFileSync(snapshotFile, `${JSON.stringify(snapshot, null, 2)}\n`, {
|
|
55
|
+
encoding: "utf8",
|
|
56
|
+
mode: 0o600,
|
|
57
|
+
});
|
|
58
|
+
return snapshotFile;
|
|
59
|
+
}
|
|
60
|
+
export function readGateSnapshot(file) {
|
|
61
|
+
try {
|
|
62
|
+
const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
|
|
63
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
|
|
64
|
+
return null;
|
|
65
|
+
const value = parsed;
|
|
66
|
+
if (value.version !== GATE_SNAPSHOT_VERSION)
|
|
67
|
+
return null;
|
|
68
|
+
if (typeof value.hash !== "string" || !/^[0-9a-f]{64}$/.test(value.hash))
|
|
69
|
+
return null;
|
|
70
|
+
return {
|
|
71
|
+
version: value.version,
|
|
72
|
+
taskName: typeof value.taskName === "string" ? value.taskName : "",
|
|
73
|
+
createdAt: typeof value.createdAt === "string" ? value.createdAt : "",
|
|
74
|
+
hash: value.hash,
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
catch {
|
|
78
|
+
return null;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
/** Сверяет текущие входы гейта с зафиксированными. При расхождении — fail-closed. */
|
|
82
|
+
export function verifyGateSnapshot(snapshotFile, inputs) {
|
|
83
|
+
const snapshot = readGateSnapshot(snapshotFile);
|
|
84
|
+
if (!snapshot) {
|
|
85
|
+
return { ok: false, reason: "snapshot гейта отсутствует или повреждён" };
|
|
86
|
+
}
|
|
87
|
+
const actual = gateInputsHash(inputs);
|
|
88
|
+
const expected = snapshot.hash;
|
|
89
|
+
const same = Buffer.byteLength(actual) === Buffer.byteLength(expected) &&
|
|
90
|
+
crypto.timingSafeEqual(Buffer.from(actual, "utf8"), Buffer.from(expected, "utf8"));
|
|
91
|
+
if (!same) {
|
|
92
|
+
return { ok: false, reason: "входы Quality Gate изменены с момента создания задачи" };
|
|
93
|
+
}
|
|
94
|
+
return { ok: true };
|
|
95
|
+
}
|
|
96
|
+
function optionValue(argv, name) {
|
|
97
|
+
const index = argv.indexOf(name);
|
|
98
|
+
return index >= 0 ? argv[index + 1] : undefined;
|
|
99
|
+
}
|
|
100
|
+
export const WORKTREE_SNAPSHOT_VERSION = 1;
|
|
101
|
+
/** Пути, за которыми следит гейт; по умолчанию только исходники плагина. */
|
|
102
|
+
export function worktreeGuardPaths(env = process.env) {
|
|
103
|
+
const raw = env.AGENT_STEWARD_GATE_GUARD_PATHS?.trim();
|
|
104
|
+
if (!raw)
|
|
105
|
+
return ["src"];
|
|
106
|
+
const parts = raw.split(/[|;]/).map((item) => item.trim()).filter(Boolean);
|
|
107
|
+
return parts.length ? parts : ["src"];
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* PL-47: пути, которые задача изменить вправе (обычно из `-Files` afterScript).
|
|
111
|
+
* Исключаются из сравнения со snapshot: агент спокойно правит свои файлы,
|
|
112
|
+
* а чужие правки в остальной части `src/` по-прежнему срывают гейт.
|
|
113
|
+
*/
|
|
114
|
+
export function worktreeAllowPaths(env = process.env) {
|
|
115
|
+
const raw = env.AGENT_STEWARD_GATE_ALLOW_PATHS?.trim();
|
|
116
|
+
if (!raw)
|
|
117
|
+
return [];
|
|
118
|
+
return raw
|
|
119
|
+
.split(/[|;]/)
|
|
120
|
+
.map((item) => item.trim().replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, ""))
|
|
121
|
+
.filter(Boolean);
|
|
122
|
+
}
|
|
123
|
+
function pathIsAllowed(relative, allowed) {
|
|
124
|
+
const normalized = relative.replace(/\\/g, "/").replace(/^\.\//, "").trim();
|
|
125
|
+
return allowed.some((prefix) => normalized === prefix || normalized.startsWith(`${prefix}/`));
|
|
126
|
+
}
|
|
127
|
+
function gitOutput(dir, args) {
|
|
128
|
+
try {
|
|
129
|
+
return execFileSync("git", ["-C", dir, ...args], {
|
|
130
|
+
encoding: "utf8",
|
|
131
|
+
windowsHide: true,
|
|
132
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
133
|
+
});
|
|
134
|
+
}
|
|
135
|
+
catch {
|
|
136
|
+
return null;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
/** Возвращает null, если каталог не git-репозиторий или git недоступен. */
|
|
140
|
+
export function readWorktreeState(dir, env = process.env) {
|
|
141
|
+
const head = gitOutput(dir, ["rev-parse", "HEAD"]);
|
|
142
|
+
if (head === null)
|
|
143
|
+
return null;
|
|
144
|
+
const status = gitOutput(dir, ["status", "--porcelain", "--untracked-files=no", "--", ...worktreeGuardPaths(env)]);
|
|
145
|
+
if (status === null)
|
|
146
|
+
return null;
|
|
147
|
+
const allowed = worktreeAllowPaths(env);
|
|
148
|
+
let filtered = status;
|
|
149
|
+
if (allowed.length > 0) {
|
|
150
|
+
filtered = status
|
|
151
|
+
.split("\n")
|
|
152
|
+
.filter((line) => {
|
|
153
|
+
if (line.length < 4)
|
|
154
|
+
return false;
|
|
155
|
+
const relative = line.slice(3).split(" -> ").pop()?.trim() ?? "";
|
|
156
|
+
return !pathIsAllowed(relative, allowed);
|
|
157
|
+
})
|
|
158
|
+
.join("\n");
|
|
159
|
+
}
|
|
160
|
+
return { head: head.trim(), status: filtered };
|
|
161
|
+
}
|
|
162
|
+
/** Пишет snapshot дерева; null — не git-репозиторий (гейт не блокируем). */
|
|
163
|
+
export function captureWorktreeSnapshot(dir, outFile, env = process.env) {
|
|
164
|
+
const state = readWorktreeState(dir, env);
|
|
165
|
+
if (!state)
|
|
166
|
+
return null;
|
|
167
|
+
const snapshot = {
|
|
168
|
+
version: WORKTREE_SNAPSHOT_VERSION,
|
|
169
|
+
...state,
|
|
170
|
+
capturedAt: new Date().toISOString(),
|
|
171
|
+
};
|
|
172
|
+
fs.mkdirSync(path.dirname(outFile), { recursive: true });
|
|
173
|
+
fs.writeFileSync(outFile, `${JSON.stringify(snapshot, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
|
|
174
|
+
return outFile;
|
|
175
|
+
}
|
|
176
|
+
export function readWorktreeSnapshot(file) {
|
|
177
|
+
try {
|
|
178
|
+
const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
|
|
179
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
|
|
180
|
+
return null;
|
|
181
|
+
const value = parsed;
|
|
182
|
+
if (value.version !== WORKTREE_SNAPSHOT_VERSION)
|
|
183
|
+
return null;
|
|
184
|
+
if (typeof value.head !== "string" || typeof value.status !== "string")
|
|
185
|
+
return null;
|
|
186
|
+
return {
|
|
187
|
+
version: WORKTREE_SNAPSHOT_VERSION,
|
|
188
|
+
head: value.head,
|
|
189
|
+
status: value.status,
|
|
190
|
+
capturedAt: typeof value.capturedAt === "string" ? value.capturedAt : "",
|
|
191
|
+
};
|
|
192
|
+
}
|
|
193
|
+
catch {
|
|
194
|
+
return null;
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
/** Сверяет дерево со snapshot'ом, снятым на старте задачи. */
|
|
198
|
+
export function verifyWorktreeSnapshot(dir, file, env = process.env) {
|
|
199
|
+
const snapshot = readWorktreeSnapshot(file);
|
|
200
|
+
if (!snapshot) {
|
|
201
|
+
return { ok: false, reason: "snapshot рабочего дерева отсутствует или повреждён" };
|
|
202
|
+
}
|
|
203
|
+
const actual = readWorktreeState(dir, env);
|
|
204
|
+
// Не git-репозиторий: нечего сравнивать, гейт работает по старой схеме.
|
|
205
|
+
if (!actual)
|
|
206
|
+
return { ok: true };
|
|
207
|
+
if (actual.head !== snapshot.head) {
|
|
208
|
+
return { ok: false, reason: "HEAD изменился с момента старта задачи" };
|
|
209
|
+
}
|
|
210
|
+
if (actual.status !== snapshot.status) {
|
|
211
|
+
const paths = worktreeGuardPaths(env).join(", ");
|
|
212
|
+
return { ok: false, reason: `защищённые пути (${paths}) изменились с момента старта задачи` };
|
|
213
|
+
}
|
|
214
|
+
return { ok: true };
|
|
215
|
+
}
|
|
216
|
+
/**
|
|
217
|
+
* CLI для обёрток: `node gate-integrity.js verify --snapshot <file>
|
|
218
|
+
* --gate-file <file> | --gate-command <text> --prompt-file <file> --timeout <n>`.
|
|
219
|
+
* exit 0 — входы совпадают, exit 1 — расхождение/отсутствие snapshot'а.
|
|
220
|
+
*/
|
|
221
|
+
export async function main(argv = process.argv.slice(2)) {
|
|
222
|
+
if (argv[0] === "worktree-snapshot") {
|
|
223
|
+
const dir = optionValue(argv, "--dir");
|
|
224
|
+
const outFile = optionValue(argv, "--out");
|
|
225
|
+
if (!dir || !outFile) {
|
|
226
|
+
console.error("gate-integrity: worktree-snapshot требует --dir и --out");
|
|
227
|
+
return 2;
|
|
228
|
+
}
|
|
229
|
+
const allow = optionValue(argv, "--allow");
|
|
230
|
+
captureWorktreeSnapshot(dir, outFile, allow ? { ...process.env, AGENT_STEWARD_GATE_ALLOW_PATHS: allow } : process.env);
|
|
231
|
+
return 0;
|
|
232
|
+
}
|
|
233
|
+
if (argv[0] === "worktree-verify") {
|
|
234
|
+
const dir = optionValue(argv, "--dir");
|
|
235
|
+
const file = optionValue(argv, "--snapshot");
|
|
236
|
+
if (!dir || !file) {
|
|
237
|
+
console.error("gate-integrity: worktree-verify требует --dir и --snapshot");
|
|
238
|
+
return 2;
|
|
239
|
+
}
|
|
240
|
+
const allow = optionValue(argv, "--allow");
|
|
241
|
+
const result = verifyWorktreeSnapshot(dir, file, allow ? { ...process.env, AGENT_STEWARD_GATE_ALLOW_PATHS: allow } : process.env);
|
|
242
|
+
if (!result.ok) {
|
|
243
|
+
console.error(`gate-integrity: ${result.reason ?? "рабочее дерево изменилось"}`);
|
|
244
|
+
return 1;
|
|
245
|
+
}
|
|
246
|
+
return 0;
|
|
247
|
+
}
|
|
248
|
+
if (argv[0] !== "verify") {
|
|
249
|
+
console.error("gate-integrity: поддерживаются verify, worktree-snapshot, worktree-verify");
|
|
250
|
+
return 2;
|
|
251
|
+
}
|
|
252
|
+
const snapshotFile = optionValue(argv, "--snapshot");
|
|
253
|
+
if (!snapshotFile) {
|
|
254
|
+
console.error("gate-integrity: не задан --snapshot");
|
|
255
|
+
return 2;
|
|
256
|
+
}
|
|
257
|
+
const gateFile = optionValue(argv, "--gate-file");
|
|
258
|
+
const gateCommand = optionValue(argv, "--gate-command");
|
|
259
|
+
const gate = gateFile ? readText(gateFile) : gateCommand ?? "";
|
|
260
|
+
const timeoutRaw = Number(optionValue(argv, "--timeout") ?? 300);
|
|
261
|
+
const inputs = {
|
|
262
|
+
gate,
|
|
263
|
+
prompt: readText(optionValue(argv, "--prompt-file")),
|
|
264
|
+
gateTimeoutSeconds: Number.isFinite(timeoutRaw) ? timeoutRaw : 300,
|
|
265
|
+
};
|
|
266
|
+
const result = verifyGateSnapshot(snapshotFile, inputs);
|
|
267
|
+
if (!result.ok) {
|
|
268
|
+
console.error(`gate-integrity: ${result.reason ?? "проверка целостности не пройдена"}`);
|
|
269
|
+
return 1;
|
|
270
|
+
}
|
|
271
|
+
return 0;
|
|
272
|
+
}
|
|
273
|
+
if (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url))) {
|
|
274
|
+
process.exitCode = await main();
|
|
275
|
+
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"git-trigger.d.ts","sourceRoot":"","sources":["../../src/core/git-trigger.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AAEH,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,UAAU,GACV,YAAY,GACZ,iBAAiB,GACjB,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnH,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"git-trigger.d.ts","sourceRoot":"","sources":["../../src/core/git-trigger.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AAEH,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,UAAU,GACV,YAAY,GACZ,iBAAiB,GACjB,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnH,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAwCzE,+DAA+D;AAC/D,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,SAAyB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAgBpG;AAED;;0EAE0E;AAC1E,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,EAAE,EAAE,MAAM,EACV,GAAG,GAAE,SAAyB,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB;AAsBD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,cAAc,CAAC,CAuGzB;AAmBD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAY;gBAErB,OAAO,EAAE,iBAAiB,EAAE,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,SAAS,CAAA;KAAO;IAKzE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0EAA0E;IACpE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAgChC,qDAAqD;IAC/C,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAY7D,OAAO,CAAC,QAAQ;YAWF,IAAI;IAsBZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAG/B;AAED,yDAAyD;AACzD,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAIhF;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}
|
package/dist/core/git-trigger.js
CHANGED
|
@@ -19,8 +19,20 @@ import { t } from "../i18n.js";
|
|
|
19
19
|
export const GIT_TRIGGER_DEFAULT_POLL_SECONDS = 60;
|
|
20
20
|
export const GIT_TRIGGER_MIN_POLL_SECONDS = 5;
|
|
21
21
|
export const GIT_COMMAND_TIMEOUT_MS = 10000;
|
|
22
|
+
/**
|
|
23
|
+
* W-1 (0.0.6): опрос репозитория — служебная операция, а не пользовательская.
|
|
24
|
+
* Игнорируем пользовательские хуки и запрещаем интерактивный ввод пароля,
|
|
25
|
+
* чтобы длинная цепочка хуков или запрос credentials не блокировали опрос.
|
|
26
|
+
*/
|
|
27
|
+
const GIT_SAFE_ARGS = ["-c", `core.hooksPath=${process.platform === "win32" ? "NUL" : "/dev/null"}`];
|
|
28
|
+
const GIT_SAFE_ENV = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
|
|
22
29
|
const defaultRunner = (cwd, args) => new Promise((resolve, reject) => {
|
|
23
|
-
execFile("git", ["-C", cwd, ...args], {
|
|
30
|
+
execFile("git", ["-C", cwd, ...GIT_SAFE_ARGS, ...args], {
|
|
31
|
+
timeout: GIT_COMMAND_TIMEOUT_MS,
|
|
32
|
+
windowsHide: true,
|
|
33
|
+
maxBuffer: 4 * 1024 * 1024,
|
|
34
|
+
env: GIT_SAFE_ENV,
|
|
35
|
+
}, (err, stdout) => {
|
|
24
36
|
if (err) {
|
|
25
37
|
reject(err instanceof Error ? err : new Error(String(err)));
|
|
26
38
|
return;
|
|
@@ -162,7 +174,7 @@ export async function checkGitTrigger(task, options = {}) {
|
|
|
162
174
|
files: [],
|
|
163
175
|
matched: [],
|
|
164
176
|
message: t("gitTrigger.diffFailed", {
|
|
165
|
-
error: err
|
|
177
|
+
error: err instanceof Error ? err.message : String(err),
|
|
166
178
|
}),
|
|
167
179
|
};
|
|
168
180
|
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"guard-run.d.ts","sourceRoot":"","sources":["../../src/core/guard-run.ts"],"names":[],"mappings":";AA8DA,yEAAyE;AACzE,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClF"}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* W-3 (0.0.6): CLI-помощник guard-условий.
|
|
4
|
+
*
|
|
5
|
+
* Вызывается из сгенерированных обёрток до запуска opencode:
|
|
6
|
+
* node guard-run.js --cwd "<workdir>" --guards-b64 "<base64 json>" [--json]
|
|
7
|
+
*
|
|
8
|
+
* Коды выхода:
|
|
9
|
+
* 0 — все guard-проверки пройдены, можно запускать;
|
|
10
|
+
* 4 — проверки не пройдены, прогон нужно пропустить (skip);
|
|
11
|
+
* 1 — некорректные аргументы или конфигурация (fail-closed).
|
|
12
|
+
*
|
|
13
|
+
* В stdout печатается человекочитаемая причина (или JSON с --json),
|
|
14
|
+
* диагностика — в stderr. Модуль ничего не завершает при импорте.
|
|
15
|
+
*/
|
|
16
|
+
import path from "node:path";
|
|
17
|
+
import { pathToFileURL } from "node:url";
|
|
18
|
+
import { evaluateGuards, GUARD_SKIP_EXIT_CODE, normalizeTaskGuards, } from "./guard.js";
|
|
19
|
+
function parseArgs(argv) {
|
|
20
|
+
const args = { json: false };
|
|
21
|
+
for (let index = 0; index < argv.length; index += 1) {
|
|
22
|
+
const flag = argv[index];
|
|
23
|
+
const value = argv[index + 1];
|
|
24
|
+
switch (flag) {
|
|
25
|
+
case "--json":
|
|
26
|
+
args.json = true;
|
|
27
|
+
break;
|
|
28
|
+
case "--cwd":
|
|
29
|
+
case "--guards-b64": {
|
|
30
|
+
if (!value || value.startsWith("--")) {
|
|
31
|
+
return { args, error: `Флаг ${flag} требует значение.` };
|
|
32
|
+
}
|
|
33
|
+
if (flag === "--cwd")
|
|
34
|
+
args.cwd = value;
|
|
35
|
+
if (flag === "--guards-b64")
|
|
36
|
+
args.guardsB64 = value;
|
|
37
|
+
index += 1;
|
|
38
|
+
break;
|
|
39
|
+
}
|
|
40
|
+
default:
|
|
41
|
+
return { args, error: `Неизвестный аргумент: ${flag}` };
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
return { args };
|
|
45
|
+
}
|
|
46
|
+
function usage() {
|
|
47
|
+
return [
|
|
48
|
+
"Использование:",
|
|
49
|
+
' guard-run.js --cwd <dir> --guards-b64 "<base64 json>" [--json]',
|
|
50
|
+
].join("\n");
|
|
51
|
+
}
|
|
52
|
+
/** Точка входа для тестов: возвращает exit code, ничего не завершает. */
|
|
53
|
+
export async function main(argv = process.argv.slice(2)) {
|
|
54
|
+
const parsed = parseArgs(argv);
|
|
55
|
+
if (parsed.error) {
|
|
56
|
+
process.stderr.write(`[guard] ${parsed.error}\n`);
|
|
57
|
+
return 1;
|
|
58
|
+
}
|
|
59
|
+
const { cwd, guardsB64 } = parsed.args;
|
|
60
|
+
if (!cwd || !guardsB64) {
|
|
61
|
+
process.stderr.write(`[guard] ${usage()}\n`);
|
|
62
|
+
return 1;
|
|
63
|
+
}
|
|
64
|
+
let raw;
|
|
65
|
+
try {
|
|
66
|
+
raw = JSON.parse(Buffer.from(guardsB64, "base64").toString("utf8"));
|
|
67
|
+
}
|
|
68
|
+
catch (error) {
|
|
69
|
+
process.stderr.write(`[guard] не удалось разобрать guards: ${error instanceof Error ? error.message : String(error)}\n`);
|
|
70
|
+
return 1;
|
|
71
|
+
}
|
|
72
|
+
const normalized = normalizeTaskGuards(raw);
|
|
73
|
+
if (!normalized.ok) {
|
|
74
|
+
process.stderr.write(`[guard] ${normalized.error}\n`);
|
|
75
|
+
return 1;
|
|
76
|
+
}
|
|
77
|
+
if (!normalized.guards) {
|
|
78
|
+
process.stderr.write("[guard] пустая конфигурация guard.\n");
|
|
79
|
+
return 1;
|
|
80
|
+
}
|
|
81
|
+
const result = await evaluateGuards(normalized.guards, { cwd });
|
|
82
|
+
if (parsed.args.json) {
|
|
83
|
+
process.stdout.write(`${JSON.stringify(result)}\n`);
|
|
84
|
+
}
|
|
85
|
+
else if (result.passed) {
|
|
86
|
+
process.stdout.write(`[guard] OK: ${result.checks.length} проверок пройдено\n`);
|
|
87
|
+
}
|
|
88
|
+
else {
|
|
89
|
+
process.stdout.write(`[guard] skipped: ${result.reasons.join("; ")}\n`);
|
|
90
|
+
}
|
|
91
|
+
return result.passed ? 0 : GUARD_SKIP_EXIT_CODE;
|
|
92
|
+
}
|
|
93
|
+
const invokedPath = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : "";
|
|
94
|
+
if (import.meta.url === invokedPath) {
|
|
95
|
+
main().then((code) => {
|
|
96
|
+
process.exitCode = code;
|
|
97
|
+
}, (error) => {
|
|
98
|
+
process.stderr.write(`[guard] ${error instanceof Error ? error.message : String(error)}\n`);
|
|
99
|
+
process.exitCode = 1;
|
|
100
|
+
});
|
|
101
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/** Код выхода CLI-помощника: guard не пройден, прогон нужно пропустить. */
|
|
2
|
+
export declare const GUARD_SKIP_EXIT_CODE = 4;
|
|
3
|
+
/** Таймаут shell-guard по умолчанию. */
|
|
4
|
+
export declare const DEFAULT_GUARD_TIMEOUT_SECONDS = 60;
|
|
5
|
+
export interface SemanticGuardConfig {
|
|
6
|
+
/** Все пути должны существовать (относительно рабочей директории). */
|
|
7
|
+
filesExist?: string[];
|
|
8
|
+
/** Ни один из путей не должен существовать. */
|
|
9
|
+
filesMissing?: string[];
|
|
10
|
+
/** Glob-шаблон текущей git-ветки, например `feature/*`. */
|
|
11
|
+
branch?: string;
|
|
12
|
+
/** Glob-шаблоны изменённых путей; достаточно совпадения хотя бы с одним. */
|
|
13
|
+
changedPaths?: string[];
|
|
14
|
+
/** Git-ref для сравнения изменений. По умолчанию `HEAD~1`. */
|
|
15
|
+
changedSince?: string;
|
|
16
|
+
}
|
|
17
|
+
export interface TaskGuards {
|
|
18
|
+
/** Shell-команда: exit 0 — запускать, любой другой код — пропустить. */
|
|
19
|
+
command?: string;
|
|
20
|
+
/** Таймаут shell-guard в секундах (1..3600, по умолчанию 60). */
|
|
21
|
+
timeoutSeconds?: number;
|
|
22
|
+
/** Семантические проверки рабочей директории. */
|
|
23
|
+
semantic?: SemanticGuardConfig;
|
|
24
|
+
}
|
|
25
|
+
export interface GuardEvaluation {
|
|
26
|
+
/** true — все проверки пройдены, задачу можно запускать. */
|
|
27
|
+
passed: boolean;
|
|
28
|
+
/** Причины пропуска (человекочитаемые). */
|
|
29
|
+
reasons: string[];
|
|
30
|
+
/** Выполненные проверки (для лога). */
|
|
31
|
+
checks: string[];
|
|
32
|
+
}
|
|
33
|
+
export type NormalizeGuardsResult = {
|
|
34
|
+
ok: true;
|
|
35
|
+
guards?: TaskGuards;
|
|
36
|
+
} | {
|
|
37
|
+
ok: false;
|
|
38
|
+
error: string;
|
|
39
|
+
};
|
|
40
|
+
/**
|
|
41
|
+
* Валидирует guard-конфигурацию из JSON/инструмента/импорта.
|
|
42
|
+
* Возвращает нормализованный объект либо ошибку; никогда не бросает.
|
|
43
|
+
*/
|
|
44
|
+
export declare function normalizeTaskGuards(input: unknown): NormalizeGuardsResult;
|
|
45
|
+
/**
|
|
46
|
+
* Выполняет guard-проверки в указанной рабочей директории.
|
|
47
|
+
* Никогда не бросает: любая ошибка означает «пропустить».
|
|
48
|
+
*/
|
|
49
|
+
export declare function evaluateGuards(guards: TaskGuards, options: {
|
|
50
|
+
cwd: string;
|
|
51
|
+
}): Promise<GuardEvaluation>;
|
|
52
|
+
//# sourceMappingURL=guard.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/core/guard.ts"],"names":[],"mappings":"AAmBA,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,wCAAwC;AACxC,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAMhD,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAqHjC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAsDzE;AAoFD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC,eAAe,CAAC,CAuG1B"}
|