import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs'; import { join } from 'node:path'; const DIFF_REVIEWS = new Set(['review', 'adversarial-review', 'codex-review', 'design-review-lite', 'ship']); export function captureReviewStart(skill: string, env = process.env): string { if (!DIFF_REVIEWS.has(skill) || !env.GSTACK_STAMP_WTREE || !env.GSTACK_REVIEW_REPO) { throw new Error('cannot capture a diff review without a working-tree fingerprint'); } const dir = join(env.GSTACK_REVIEW_DIR!, '.review-starts'); mkdirSync(dir, { recursive: true, mode: 0o700 }); const token = crypto.randomUUID(); writeFileSync(join(dir, `${token}.json`), JSON.stringify({ skill, repo: env.GSTACK_REVIEW_REPO, branch: env.GSTACK_REVIEW_BRANCH, wtree: env.GSTACK_STAMP_WTREE, started_at: new Date().toISOString(), }), { mode: 0o600, flag: 'wx' }); return token; } export function bindReview(rec: Record, token: string, env = process.env): Record { for (const key of ['commit_full', 'tree', 'wtree', 'dirty', 'review_binding', 'review_freshness']) delete rec[key]; if (env.GSTACK_STAMP_COMMIT_FULL) rec.commit_full = env.GSTACK_STAMP_COMMIT_FULL; if (env.GSTACK_STAMP_TREE) rec.tree = env.GSTACK_STAMP_TREE; if (env.GSTACK_STAMP_DIRTY) rec.dirty = env.GSTACK_STAMP_DIRTY === 'true'; if (!DIFF_REVIEWS.has(rec.skill)) { if (env.GSTACK_STAMP_WTREE) rec.wtree = env.GSTACK_STAMP_WTREE; return rec; } let start; if (/^[0-9a-f-]{36}$/.test(token)) { const file = join(env.GSTACK_REVIEW_DIR!, '.review-starts', `${token}.json`); try { const saved = readFileSync(file, 'utf8'); unlinkSync(file); const parsed = JSON.parse(saved); if (parsed.skill === rec.skill && parsed.repo === env.GSTACK_REVIEW_REPO && parsed.branch === env.GSTACK_REVIEW_BRANCH && parsed.wtree) start = parsed; } catch (error: any) { if (error.code !== 'ENOENT') console.error(`gstack-review-log: cannot consume review start: ${error.message}`); } } const end = env.GSTACK_STAMP_WTREE; const state = !start || !end ? 'uncaptured' : start.wtree !== end ? 'changed' : rec.completed !== true || rec.converged !== true ? 'incomplete' : 'verified'; rec.review_binding = { state, start_wtree: start?.wtree, end_wtree: end, started_at: start?.started_at }; if (state === 'verified') rec.wtree = end; return rec; } export function reviewFreshness(rec: Record, currentWtree: string): { status: string; reason: string } | undefined { if (!DIFF_REVIEWS.has(rec.skill)) return; if (rec.skill === 'ship') return { status: 'UNVERIFIED', reason: 'ship telemetry is not a review pass' }; const binding = rec.review_binding; if (binding?.state === 'changed') return { status: 'STALE', reason: 'content changed during review' }; if (binding?.state !== 'verified' || rec.completed !== true || rec.converged !== true || !rec.wtree || binding.start_wtree !== rec.wtree || binding.end_wtree !== rec.wtree) { return { status: 'UNVERIFIED', reason: 'missing start capture or incomplete/nonconverged pass' }; } if (!currentWtree || currentWtree === 'unknown' || rec.wtree !== currentWtree) { return { status: 'STALE', reason: 'working-tree content differs from reviewed content' }; } if (rec.status !== 'clean' || rec.issues_found > 0 || rec.critical > 0 || (rec.skill === 'codex-review' && rec.findings > (rec.findings_fixed ?? 0))) { return { status: 'UNVERIFIED', reason: 'review has unresolved findings or did not finish clean' }; } return { status: 'CURRENT', reason: 'completed clean pass on unchanged content' }; }