@su-record/vibe 3.2.64 → 4.0.1

package/hooks/scripts/loop-ledger.js

@@ -1,167 +0,0 @@
-#!/usr/bin/env node
-/**
- * loop-ledger CLI — 루프 실행 이력 기록 및 stuck 감지.
- *
- * 사용법:
- *   node hooks/scripts/loop-ledger.js start <name>
- *   node hooks/scripts/loop-ledger.js end <name> <ok|fail|stuck> [summary]
- *   node hooks/scripts/loop-ledger.js check-stuck <name> <discoverHash>
- *   node hooks/scripts/loop-ledger.js anchor [feature]
- *   node hooks/scripts/loop-ledger.js inbox <name> <ok|fail|stuck> [line...]
- *   node hooks/scripts/loop-ledger.js gate open <id> <question> [option...]
- *   node hooks/scripts/loop-ledger.js gate list
- *   node hooks/scripts/loop-ledger.js gate answer <id> <answer>
- *   node hooks/scripts/loop-ledger.js iteration <name> <verified|unverified>
- *   node hooks/scripts/loop-ledger.js budget <name> [maxIterations]
- *
- * iteration: 회전을 기록하면서 비용(경과 시간·도구 호출 수·서브에이전트 수)을 함께 잰다.
- *   수치의 출처는 코드다 — 모델이 보고한 값을 받는 인자는 두지 않는다.
- *   node hooks/scripts/loop-ledger.js trial <name> [trialIterations]
- *   node hooks/scripts/loop-ledger.js trial-approve <name>
- *
- * check-stuck: 'stuck' 또는 'ok'를 stdout에 출력하고 항상 exit 0.
- * anchor: 재고정 번들 JSON을 stdout에 출력한다 (loop-contract ANCHOR 절).
- * 항상 exit 0 (fail-open).
- */
-
-import {
-  appendLoopEvent, isStuck, recordIteration, readBudget, readTrialGate, approveTrial,
-} from './lib/loop-ledger.js';
-import { buildAnchor } from './lib/anchor.js';
-import { prependInboxBlock } from './lib/inbox.js';
-import { openGate, listOpenGates, answerGate, formatOpenGates } from './lib/gates.js';
-
-const [, , subcommand, ...args] = process.argv;
-const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-
-if (subcommand === 'start') {
-  const loop = args[0];
-  if (!loop) {
-    process.stdout.write('[loop-ledger] error: start 에 루프 이름이 필요합니다\n');
-    process.exit(0);
-  }
-  appendLoopEvent(projectDir, { loop, event: 'start' });
-  process.stdout.write(`[loop-ledger] start recorded: loop=${loop}\n`);
-
-} else if (subcommand === 'end') {
-  const [loop, result, ...summaryParts] = args;
-  if (!loop || !result) {
-    process.stdout.write('[loop-ledger] error: end 에 루프 이름과 결과(ok|fail|stuck)가 필요합니다\n');
-    process.exit(0);
-  }
-  const summary = summaryParts.length > 0 ? summaryParts.join(' ') : undefined;
-  appendLoopEvent(projectDir, { loop, event: 'end', result, summary });
-  process.stdout.write(`[loop-ledger] end recorded: loop=${loop} result=${result}\n`);
-
-} else if (subcommand === 'check-stuck') {
-  const [loop, discoverHash] = args;
-  if (!loop || !discoverHash) {
-    process.stdout.write('[loop-ledger] error: check-stuck 에 루프 이름과 discoverHash가 필요합니다\n');
-    process.stdout.write('ok\n');
-    process.exit(0);
-  }
-  const stuck = isStuck(projectDir, loop, discoverHash);
-  // 판정 직후 이번 발견 해시를 기록 — 다음 실행의 비교 기준이 된다
-  appendLoopEvent(projectDir, { loop, event: 'discover', discoverHash });
-  process.stdout.write(stuck ? 'stuck\n' : 'ok\n');
-
-} else if (subcommand === 'anchor') {
-  // 회전 시작 시 디스크 재고정 — 모델이 무엇을 다시 읽어야 하는지 결정론적으로 답한다
-  process.stdout.write(JSON.stringify(buildAnchor(projectDir, args[0]), null, 2) + '\n');
-
-} else if (subcommand === 'inbox') {
-  const [loop, result, ...lines] = args;
-  if (!loop || !result) {
-    process.stdout.write('[loop-ledger] error: inbox 에 루프 이름과 결과(ok|fail|stuck)가 필요합니다\n');
-    process.exit(0);
-  }
-  const at = new Date().toISOString();
-  const ok = prependInboxBlock(projectDir, { loop, result, at, lines });
-  process.stdout.write(
-    ok ? `[loop-ledger] inbox recorded: loop=${loop} result=${result}\n`
-       : '[loop-ledger] WARNING: inbox write failed\n'
-  );
-
-} else if (subcommand === 'iteration') {
-  // 회전 계수는 코드가 한다 — max_iterations 를 모델이 세면 폭주 방어가 양심이 된다
-  const [loop, verifiedArg] = args;
-  if (!loop || !['verified', 'unverified'].includes(verifiedArg || '')) {
-    process.stdout.write('[loop-ledger] error: iteration 에 루프 이름과 verified|unverified 가 필요합니다\n');
-    process.exit(0);
-  }
-  recordIteration(projectDir, loop, verifiedArg === 'verified');
-  const b = readBudget(projectDir, loop);
-  // 비용은 계측이지 판정이 아니다 — 재지 못한 회전은 0 이 아니라 '미측정' 으로 보인다
-  const c = b.cost;
-  const costNote = c.measuredIterations > 0
-    ? `도구 ${c.toolCalls} / 서브에이전트 ${c.subagents} / ${Math.round(c.elapsedMs / 1000)}s (측정 ${c.measuredIterations}회전)`
-    : '비용 미측정';
-  process.stdout.write(`[loop-ledger] iteration recorded: ${loop} ${verifiedArg} (${b.iterations} 회전 / 검증 ${b.verified}) — ${costNote}\n`);
-
-} else if (subcommand === 'budget') {
-  const [loop, maxRaw] = args;
-  if (!loop) {
-    process.stdout.write('[loop-ledger] error: budget 에 루프 이름이 필요합니다\n');
-    process.exit(0);
-  }
-  const max = Number.parseInt(maxRaw ?? '10', 10);
-  const b = readBudget(projectDir, loop, Number.isInteger(max) && max > 0 ? max : 10);
-  process.stdout.write(JSON.stringify(b) + '\n');
-
-} else if (subcommand === 'trial') {
-  // 처음 거는 루프는 몇 바퀴만 돌고 멈춘다 — 정의가 틀린 채로 성실히 반복하는 것을 막는다
-  const [loop, capRaw] = args;
-  if (!loop) {
-    process.stdout.write('[loop-ledger] error: trial 에 루프 이름이 필요합니다\n');
-    process.exit(0);
-  }
-  const cap = Number.parseInt(capRaw ?? '2', 10);
-  const t = readTrialGate(projectDir, loop, Number.isInteger(cap) && cap > 0 ? cap : 2);
-  process.stdout.write(JSON.stringify(t) + '\n');
-
-} else if (subcommand === 'trial-approve') {
-  const [loop] = args;
-  if (!loop) {
-    process.stdout.write('[loop-ledger] error: trial-approve 에 루프 이름이 필요합니다\n');
-    process.exit(0);
-  }
-  approveTrial(projectDir, loop);
-  process.stdout.write(`[loop-ledger] ${loop} 시운전 해제 — 이후 max_iterations 예산으로 돈다\n`);
-
-} else if (subcommand === 'gate') {
-  // 사람 판단 지점을 디스크에 남긴다 — 세션이 죽어도 무엇을 묻고 있었는지 남는다
-  const [action, id, ...rest] = args;
-
-  if (action === 'list') {
-    process.stdout.write(formatOpenGates(listOpenGates(projectDir)) + '\n');
-
-  } else if (action === 'open') {
-    const [question, ...options] = rest;
-    if (!id || !question) {
-      process.stdout.write('[loop-ledger] error: gate open 에 id 와 구체적 질문이 필요합니다\n');
-      process.exit(0);
-    }
-    const file = openGate(projectDir, { id, question, options, at: new Date().toISOString() });
-    process.stdout.write(file
-      ? `[loop-ledger] gate opened: ${id}\n`
-      : '[loop-ledger] WARNING: gate open failed (질문이 너무 짧거나 쓰기 실패)\n');
-
-  } else if (action === 'answer') {
-    const answer = rest.join(' ');
-    const ok = answerGate(projectDir, id, answer, new Date().toISOString());
-    process.stdout.write(ok
-      ? `[loop-ledger] gate answered: ${id}\n`
-      : `[loop-ledger] WARNING: gate not found or already answered: ${id}\n`);
-
-  } else {
-    process.stdout.write('[loop-ledger] 사용법: gate open <id> <question> [option...] | gate list | gate answer <id> <answer>\n');
-  }
-
-} else {
-  process.stdout.write(
-    '[loop-ledger] 사용법: start <name> | end <name> <ok|fail|stuck> [summary] | '
-    + 'check-stuck <name> <hash> | anchor [feature] | inbox <name> <ok|fail|stuck> [line...] | gate <open|list|answer> | iteration <name> <verified|unverified> | budget <name> [max]\n'
-  );
-}
-
-process.exit(0);

package/hooks/scripts/plugin-hook-entry.js

@@ -1,57 +0,0 @@
-/**
- * 플러그인 훅의 단일 진입점 — 이중 실행을 막는다.
- *
- * 실측한 사건: vibe 를 npm 으로 설치하면 프로젝트에 `.claude/settings.local.json`
- * 훅 6개가 설치된다. 여기에 플러그인까지 설치하면 **같은 6개 이벤트가 두 벌** 등록돼
- * 모든 게이트가 2회 돌고, Stop 의 auto-commit·devlog 도 2회 돈다. 게이트가 두 번
- * 도는 건 느린 정도지만 커밋이 두 번 나는 건 되돌릴 일이 생긴다.
- *
- * 그래서 플러그인 훅은 전부 이 진입점을 거친다. 프로젝트에 vibe 훅이 이미 있으면
- * **플러그인 쪽이 물러난다** — 프로젝트 설정이 사용자가 명시적으로 설치한 것이고,
- * 경로도 그쪽이 정확하기 때문이다(플러그인 트리에는 node_modules 가 없다).
- *
- * 실행은 spawn 이 아니라 in-process `import` 다 — 훅 레이턴시 규약(CLAUDE.md
- * "dispatcher in-process 평탄화")을 플러그인 경로에서도 깨지 않는다.
- */
-import fs from 'fs';
-import path from 'path';
-import { pathToFileURL } from 'url';
-
-/** 프로젝트에 vibe 훅이 이미 설치돼 있는가 — 있으면 플러그인은 실행하지 않는다 */
-export function projectHooksInstalled(projectDir) {
-  const settings = path.join(projectDir, '.claude', 'settings.local.json');
-  try {
-    const parsed = JSON.parse(fs.readFileSync(settings, 'utf-8'));
-    const hooks = parsed?.hooks;
-    if (!hooks || typeof hooks !== 'object') return false;
-    // vibe 훅인지까지 확인한다 — 사용자가 자기 훅만 넣어둔 경우에는 물러날 이유가 없다
-    return JSON.stringify(hooks).includes('hooks/scripts/');
-  } catch {
-    return false;
-  }
-}
-
-async function main() {
-  const [, , script, ...rest] = process.argv;
-  if (!script) {
-    process.stderr.write('plugin-hook-entry: 실행할 스크립트가 지정되지 않았다\n');
-    process.exit(0);   // 훅은 사용자 작업을 막지 않는다
-  }
-
-  if (projectHooksInstalled(process.cwd())) process.exit(0);
-
-  const target = path.resolve(import.meta.dirname, script);
-  if (!fs.existsSync(target)) {
-    process.stderr.write(`plugin-hook-entry: 스크립트를 찾지 못했다 — ${target}\n`);
-    process.exit(0);
-  }
-
-  // 대상 스크립트가 자기 argv 를 그대로 읽도록 맞춘다 (pre-tool-dispatcher.js Bash 등)
-  process.argv = [process.argv[0], target, ...rest];
-  await import(pathToFileURL(target).href);
-}
-
-// 테스트에서 import 할 때는 실행하지 않는다
-if (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(import.meta.filename)) {
-  await main();
-}

package/hooks/scripts/post-edit-dispatcher.js

@@ -1,101 +0,0 @@
-#!/usr/bin/env node
-/**
- * PostToolUse dispatcher — Write/Edit 이후 후처리.
- *
- * in-process 평탄화 (2026-06): 자식 node spawn 없이 import 실행.
- * 실작업(prettier/vitest 등)은 각 step이 자체 timeout을 가진 비동기 자식으로
- * 실행하므로 step 간 병렬성(Promise.all)은 spawn 시절과 동일하게 유지된다.
- *
- * 실행 step (모두 비차단, config.hooks.{name}.enabled로 개별 토글):
- *   auto-format — 코드 스타일 정규화 (변경 시 finding 반환)
- *   code-check  — 하드룰(any/console.log) 탐지 (additionalContext 주입만, 커밋 게이트 미연동)
- *   auto-test   — 관련 테스트 실행 (debounce 지원)
- *
- * post-edit.js 는 여기서 돌리지 않는다 — console.log 감지는 code-check 가 같은
- * 허용 경로 규칙(lib/console-allow.js)으로 이미 수행한다. 둘 다 돌리면 허용
- * 경로에서도 경고가 남는다. post-edit.js 는 antigravity-hooks.json 단독 등록용.
- *
- * 출력 계약 (Claude Code PostToolUse):
- *   findings 있음 → stdout에 JSON hookSpecificOutput 1개 출력, exit 0
- *   findings 없음 → stdout 없음, exit 0
- *   절대 exit 2 없음 — 차단은 downstream 게이트에서 (SPEC 설계 원칙)
- *
- * Codex 경로: codex-hook-adapter.js가 이 스크립트를 spawn하고
- *   combinedOutput(stdout+stderr)을 writeAdditionalContext로 래핑함.
- *   → stdout이 JSON hookSpecificOutput이면 어댑터가 이중 래핑함.
- *   → 어댑터에서 JSON hookSpecificOutput 형식 감지 후 bypass 처리.
- *
- * 실패 격리: step별 try/catch — 한 step이 throw해도 나머지는 계속 진행.
- */
-import { readStdinSync, buildCtx } from './lib/hook-context.js';
-import { readProjectConfig } from './utils.js';
-import fs from 'fs';
-import path from 'path';
-
-// ─── step 임포트 ─────────────────────────────────────────────────────
-import { run as autoFormat } from './auto-format.js';
-import { run as codeCheck } from './code-check.js';
-import { run as autoTest } from './auto-test.js';
-
-// ─── 설정 로딩 ────────────────────────────────────────────────────────
-function loadHookConfig() {
-  try {
-    return readProjectConfig()?.hooks || {};
-  } catch {
-    return {};
-  }
-}
-
-function isEnabled(hookConfig, name) {
-  const entry = hookConfig[name];
-  if (entry && typeof entry === 'object' && entry.enabled === false) return false;
-  return true;
-}
-
-// ─── 메인 ─────────────────────────────────────────────────────────────
-const { raw, parsed } = readStdinSync();
-const ctx = buildCtx({ rawInput: raw, payload: parsed });
-const hookConfig = loadHookConfig();
-
-const steps = [
-  { name: 'auto-format', run: autoFormat },
-  { name: 'code-check',  run: codeCheck  },
-  { name: 'auto-test',   run: autoTest   },
-];
-
-const enabledSteps = steps.filter(s => isEnabled(hookConfig, s.name));
-
-// 모든 step을 병렬 실행해 findings 수집
-const results = await Promise.all(
-  enabledSteps.map(async (step) => {
-    try {
-      const result = await step.run(ctx);
-      // findings 배열을 반환하는 새 구조 지원 + 구형 숫자 반환 폴백
-      if (result && typeof result === 'object' && Array.isArray(result.findings)) {
-        return result.findings;
-      }
-      return [];
-    } catch {
-      // 크래시 격리 — 해당 step만 건너뜀
-      return [];
-    }
-  })
-);
-
-const allFindings = results.flat().filter(f => typeof f === 'string' && f.trim().length > 0);
-
-// findings가 있을 때만 stdout 출력
-// Claude Code: JSON hookSpecificOutput → 모델이 additionalContext로 인식
-// findings 없음: 조용히 종료
-if (allFindings.length > 0) {
-  const summary = allFindings.join('\n');
-  const output = JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PostToolUse',
-      additionalContext: summary,
-    },
-  });
-  process.stdout.write(output + '\n');
-}
-
-process.exit(0);

package/hooks/scripts/post-edit.js

@@ -1,55 +0,0 @@
-/**
- * PostToolUse Hook - Edit 후 console.log 감지
- *
- * NOTE: tsc, prettier 제거 — 빌드/커밋 시점에 실행하므로 Edit마다 불필요
- * grep spawn 대신 fs.readFileSync + regex로 프로세스 오버헤드 제거
- *
- * findings를 console.log가 아닌 반환값으로 전달.
- * (console.log 출력은 CC PostToolUse에서 transcript-only — 모델이 보지 못함)
- */
-import { existsSync, readFileSync } from 'fs';
-import path from 'path';
-import { buildCliCtx, isDirectRun } from './lib/hook-context.js';
-import { shouldCheckConsole } from './lib/console-allow.js';
-
-const CONSOLE_LOG_RE = /console\.log\(/;
-
-/**
- * in-process 진입점 — console.log 감지만 수행.
- * findings 배열 반환 (디스패처가 수집해 additionalContext에 주입).
- * @param {{ filePath: string }} ctx
- * @returns {Promise<{ exitCode: number, findings: string[] }>}
- */
-export async function run(ctx) {
-  const findings = [];
-  try {
-    const filePath = ctx.filePath;
-
-    if (filePath && shouldCheckConsole(filePath)) {
-      const resolved = path.resolve(filePath);
-      if (existsSync(resolved)) {
-        const lines = readFileSync(resolved, 'utf-8').split('\n');
-        const hits = [];
-        for (let i = 0; i < lines.length && hits.length < 3; i++) {
-          if (CONSOLE_LOG_RE.test(lines[i])) hits.push(i + 1);
-        }
-        if (hits.length > 0) {
-          findings.push(`[POST-EDIT] ${path.basename(resolved)}: console.log at line ${hits.join(',')}`);
-        }
-      }
-    }
-  } catch {
-    // 조용히 실패
-  }
-  return { exitCode: 0, findings };
-}
-
-// standalone CLI 모드 — 전역 예외 흡수는 단독 프로세스일 때만 등록
-// (in-process import 시 디스패처의 전역 핸들러를 오염시키지 않도록)
-if (isDirectRun(import.meta.url)) {
-  process.on('uncaughtException', () => {});
-  process.on('unhandledRejection', () => {});
-  const { exitCode, findings } = await run(buildCliCtx());
-  if (findings.length > 0) process.stdout.write(findings.join('\n') + '\n');
-  process.exit(exitCode);
-}

package/hooks/scripts/pr-test-gate.js

@@ -1,23 +0,0 @@
-/**
- * PreToolUse Hook - PR 생성 전 테스트 게이트
- *
- * mcp__github__create_pull_request 호출 시 테스트가 통과해야만 PR 생성 허용.
- * exit 2 = 차단, exit 0 = 통과
- */
-import { PROJECT_DIR } from './utils.js';
-import { runPrTestGate } from './lib/pr-gate-runner.js';
-
-const { passed, testCmd, output } = runPrTestGate(PROJECT_DIR);
-
-if (!testCmd) {
-  // 테스트 커맨드 없음 → PR 허용
-  process.exit(0);
-}
-
-if (passed) {
-  console.log('[PR-GATE] Tests passed — PR creation allowed');
-  process.exit(0);
-} else {
-  console.log(`[PR-GATE] Tests failed — PR creation blocked\n${output}`);
-  process.exit(2);
-}

package/hooks/scripts/pre-tool-dispatcher.js

@@ -1,46 +0,0 @@
-#!/usr/bin/env node
-/**
- * PreToolUse dispatcher — Bash/Edit/Write 공용.
- *
- * in-process 평탄화 (2026-06): 가드를 자식 node로 spawn하지 않고 import해서
- * 같은 프로세스에서 실행한다. 자식 VM 기동(~20ms × N)과 stdin 재읽기 제거.
- * daemon/IPC는 금지 (CLAUDE.md Gotchas) — 디스패처 프로세스 자체는 유지.
- *
- * Deny 시맨틱 보존:
- *   sentinel-guard / pre-tool-guard / scope-guard의 run(ctx)이 2를 반환하면
- *   dispatchInProcess가 process.exit(2)로 상위에 전파 → Claude Code가 도구 실행 차단.
- *
- * 사용법: node pre-tool-dispatcher.js <Bash|Edit|Write>
- */
-import { dispatchInProcess } from './lib/dispatcher.js';
-import { run as sentinelGuard } from './sentinel-guard.js';
-import { run as preToolGuard } from './pre-tool-guard.js';
-import { run as scopeGuard } from './scope-guard.js';
-import { run as commandLog } from './command-log.js';
-
-const toolName = process.argv[2] || '';
-
-const steps = [
-  { name: 'sentinel-guard', run: sentinelGuard, denyOnExit2: true },
-  { name: 'pre-tool-guard', run: preToolGuard, denyOnExit2: true },
-];
-
-// scope-guard는 Edit/Write에만 의미 있음
-if (toolName === 'Edit' || toolName === 'Write') {
-  steps.push({ name: 'scope-guard', run: scopeGuard, denyOnExit2: true });
-}
-
-// command-log은 Bash 전용
-if (toolName === 'Bash') {
-  steps.push({ name: 'command-log', run: commandLog });
-}
-
-// 하네스에 노이즈를 주지 않도록 디스패처 자체의 예외는 모두 흡수.
-// exit 2 (deny 전파)는 dispatchInProcess 내부에서 process.exit(2)로 처리되므로
-// 여기까지 오면 "deny 아님" → 항상 exit 0.
-try {
-  await dispatchInProcess(steps, { argvToolName: toolName });
-} catch {
-  // ignore — step 크래시가 상위 훅 실패로 표시되지 않도록
-}
-process.exit(0);