Дмитрий
d221ba499d
Аудит М6 (audit-context-building + sharp-edges + корректность; комплекс М1–М6), 4 практичных фикса (TDD): - FIX-1: enforce-mcp-classification печатает точный FLOOR-ESCAPE токен в egress/verdict-блоке (G-5 для egress). - FIX-2: escape-grant.findOpenGrant — единый предикат свежести для open и consume (гасит ИМЕННО открывший грант; чинит утечку one-shot при дублях/future-ts). - FIX-3: enforce-supreme-gate.runGate — best-effort журнал escape (escape:true), указатель не двигается, сбой журнала не блокирует. - FIX-4: enforce-snapshot — уникальный дефолтный id снимка (ts-pid-счётчик) против ms-коллизии refs/floor-snapshots. Регрессия tools-only 2843 passed + 2 skip (+9, 0 регрессий). FIX-5 (подпись гранта) сознательно не делали (нулевая защита без ключа; protected-path уже гарантирует).
60 lines
3.5 KiB
JavaScript
60 lines
3.5 KiB
JavaScript
#!/usr/bin/env node
|
||
/**
|
||
* enforce-snapshot (М6, Блок 2) — PreToolUse после enforce-floor. Перед разрушительным
|
||
* (snapshotNeeded) делает git-точку возврата (git stash create + update-ref
|
||
* refs/floor-snapshots/<id>), пишет restore-points.jsonl. Чистое дерево → ref=HEAD (успех);
|
||
* реальная ошибка git → fail-CLOSE (block). Пишет в runtime как процесс-хук (легитимно).
|
||
*/
|
||
import { appendFileSync, mkdirSync } from 'node:fs';
|
||
import { join, dirname } from 'node:path';
|
||
import { homedir } from 'node:os';
|
||
import { execFileSync } from 'node:child_process';
|
||
import { readStdin, parseEventJson, exitDecision } from './enforce-hook-helpers.mjs';
|
||
import { snapshotNeeded, resolveGitState } from './snapshot-decide.mjs';
|
||
import { canonicalAction } from './escape-grant.mjs';
|
||
|
||
function defaultGit() {
|
||
try {
|
||
const stashOut = execFileSync('git', ['stash', 'create'], { encoding: 'utf-8' });
|
||
const headOut = execFileSync('git', ['rev-parse', 'HEAD'], { encoding: 'utf-8' });
|
||
return { stashOut, headOut, error: false };
|
||
} catch { return { stashOut: '', headOut: '', error: true }; }
|
||
}
|
||
function defaultWrite(rec) {
|
||
const path = join(homedir(), '.claude', 'runtime', 'restore-points.jsonl');
|
||
try { mkdirSync(dirname(path), { recursive: true }); } catch {}
|
||
try { appendFileSync(path, JSON.stringify(rec) + '\n'); } catch {}
|
||
}
|
||
|
||
// FIX-4: уникальный id снимка по умолчанию — ts + pid + монотонный счётчик, чтобы два
|
||
// разрушительных в одну миллисекунду не записали один и тот же refs/floor-snapshots/<id>
|
||
// (update-ref второго клобберил бы точку возврата первого).
|
||
let __snapSeq = 0;
|
||
function defaultSnapId(now) { __snapSeq += 1; return `${now}-${process.pid}-${__snapSeq}`; }
|
||
|
||
/** Чистое решение (инъекция git/write/id/now для тестов). */
|
||
export function snapshotDecision(event, { gitImpl = defaultGit, writeImpl = defaultWrite, idImpl, now = Date.now() } = {}) {
|
||
if (!snapshotNeeded(event.tool_name, event.tool_input || {})) return { block: false };
|
||
const st = resolveGitState(gitImpl());
|
||
if (!st.ok) return { block: true, message: '[snapshot] не смог сделать точку возврата (ошибка git) — действие остановлено' };
|
||
const id = (idImpl ? idImpl() : defaultSnapId(now)) + '';
|
||
if (gitImpl === defaultGit) {
|
||
try { execFileSync('git', ['update-ref', `refs/floor-snapshots/${id}`, st.ref]); }
|
||
catch { return { block: true, message: '[snapshot] update-ref не удался — fail-close' }; }
|
||
}
|
||
writeImpl({ ts: now, action: canonicalAction(event.tool_name, event.tool_input || {}), head: st.ref,
|
||
snapshot_ref: `refs/floor-snapshots/${id}`, restore_command: `git checkout refs/floor-snapshots/${id} -- .` });
|
||
return { block: false };
|
||
}
|
||
|
||
async function main() {
|
||
try {
|
||
const ev = parseEventJson(await readStdin());
|
||
const r = snapshotDecision(ev);
|
||
exitDecision({ block: r.block, message: r.block ? r.message : undefined });
|
||
} catch { exitDecision({ block: false }); } // снимок — страховка; своя инфра-ошибка не должна клинить (но git-ошибка выше = block)
|
||
}
|
||
import { fileURLToPath } from 'node:url';
|
||
const isCli = process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1];
|
||
if (isCli) main();
|