@su-record/vibe 3.2.64 → 4.0.1

package/hooks/scripts/session-start.js

@@ -1,229 +0,0 @@
-/**
- * SessionStart Hook - 세션 시작 시 메모리/시간 로드 + 버전 체크
- */
-import { getToolsBaseUrl, getGlobalNpmPath, PROJECT_DIR, projectVibePath, projectVibeRoot } from './utils.js';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import https from 'https';
-
-const BASE_URL = getToolsBaseUrl();
-
-/**
- * npm 레지스트리에서 최신 버전 조회 (타임아웃 3초)
- */
-function fetchLatestVersion() {
-  return new Promise((resolve) => {
-    const req = https.get(
-      'https://registry.npmjs.org/@su-record/vibe/latest',
-      { timeout: 3000, headers: { 'Accept': 'application/json' } },
-      (res) => {
-        let data = '';
-        res.on('data', (chunk) => { data += chunk; });
-        res.on('end', () => {
-          try {
-            resolve(JSON.parse(data).version || null);
-          } catch { resolve(null); }
-        });
-      },
-    );
-    req.on('error', () => resolve(null));
-    req.on('timeout', () => { req.destroy(); resolve(null); });
-  });
-}
-
-// 버전 체크 결과 24시간 파일 캐시 — 매 SessionStart마다 npm registry에
-// HTTP 요청(타임아웃 시 3초 블로킹)을 보내지 않도록 한다. 릴리즈 주기 대비
-// 하루 1회 확인이면 충분하다.
-const VERSION_CACHE_PATH = path.join(os.homedir(), '.vibe', 'version-check.json');
-const VERSION_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
-
-async function getLatestVersionCached() {
-  try {
-    const cached = JSON.parse(fs.readFileSync(VERSION_CACHE_PATH, 'utf8'));
-    if (cached.version && Date.now() - cached.checkedAt < VERSION_CACHE_TTL_MS) {
-      return cached.version;
-    }
-  } catch { /* 캐시 없음/손상 → 네트워크 조회 */ }
-
-  const version = await fetchLatestVersion();
-  if (version) {
-    try {
-      fs.mkdirSync(path.dirname(VERSION_CACHE_PATH), { recursive: true });
-      fs.writeFileSync(VERSION_CACHE_PATH, JSON.stringify({ version, checkedAt: Date.now() }));
-    } catch { /* 캐시 기록 실패는 무시 */ }
-  }
-  return version;
-}
-
-function compareVersions(a, b) {
-  const partsA = a.replace(/^v/, '').split('.').map(Number);
-  const partsB = b.replace(/^v/, '').split('.').map(Number);
-  for (let i = 0; i < 3; i++) {
-    const numA = partsA[i] || 0;
-    const numB = partsB[i] || 0;
-    if (numA > numB) return 1;
-    if (numA < numB) return -1;
-  }
-  return 0;
-}
-
-function getCurrentVersion() {
-  try {
-    // getToolsBaseUrl()이 이미 `npm root -g` 결과를 캐싱하므로 재사용 — 중복 spawn 제거
-    const pkgPath = path.join(getGlobalNpmPath(), '@su-record', 'vibe', 'package.json');
-    if (fs.existsSync(pkgPath)) {
-      return JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version || null;
-    }
-  } catch { /* ignore */ }
-  return null;
-}
-
-async function main() {
-  try {
-    const [memoryModule, timeModule] = await Promise.all([
-      import(`${BASE_URL}memory/index.js`),
-      import(`${BASE_URL}time/index.js`),
-    ]);
-
-    // 인덱스만 주입 (harness-review-2026-07-01 P1-5):
-    // 이전에는 startSession 전체 요약(git log·테스트 상태·관찰·리플렉션·RAG
-    // goals/constraints/decisions)을 매 세션 덤프했다. 이제는 1줄 인덱스만
-    // 주입하고, 전체 컨텍스트 복원은 명시적 `/vibe.continue` 전용.
-    const [time, memories, latestVersion] = await Promise.all([
-      timeModule.getCurrentTime({ format: 'human', timezone: 'Asia/Seoul' }),
-      memoryModule.listMemories({ limit: 5, projectPath: PROJECT_DIR }),
-      getLatestVersionCached(),
-    ]);
-
-    // ─── 안정 블록 먼저 ────────────────────────────────────────────────
-    // 세션마다 값이 달라지는 것(현재 시각·진행 카운터·버전 체크)은 아래 휘발 블록으로
-    // 모아 뒤에 붙인다. 세션 컨텍스트의 앞부분을 가능한 한 세션 간 동일하게 유지하려는
-    // 배치다 — 휘발 데이터를 앞에 두면 어떤 합성 방식에서도 이득이 없다.
-    console.log('[Memory Index — bodies on demand via recall_memory]');
-    console.log(memories.content[0].text);
-
-    // Phase 3 — Recipes + anti-patterns 인덱스 (post-task curation)
-    // 본문이 아닌 1줄 요약만. session-context 가 비대해지지 않도록 N=5 상한.
-    try {
-      const { loadCurationIndex } = await import('./lib/curation-index.js');
-      const index = loadCurationIndex(PROJECT_DIR, { recipeLimit: 5, antiPatternLimit: 5 });
-      if (index.recipes.length > 0) {
-        console.log('\n[Recipes — succeeded patterns]');
-        for (const r of index.recipes) {
-          console.log(`  • ${r.slug} — ${r.summary}`);
-        }
-      }
-      if (index.antiPatterns.length > 0) {
-        console.log('\n[Anti-patterns — known pitfalls]');
-        for (const a of index.antiPatterns) {
-          console.log(`  ⚠ ${a.tag}: ${a.summary}`);
-        }
-      }
-    } catch { /* curation is best-effort */ }
-
-    // Scope sync — 기본 OFF (opt-in: scopeGuard.enabled=true). SSOT: scope-from-spec.js.
-    try {
-      const { syncScopeFile, isScopeGuardEnabled } = await import('./lib/scope-from-spec.js');
-      const guardOn = isScopeGuardEnabled(PROJECT_DIR);
-      if (guardOn) {
-        const result = syncScopeFile(PROJECT_DIR);
-        if (result.action === 'created' || result.action === 'updated' || result.action === 'removed') {
-          console.log(`\n🚧 Scope ${result.action} from active SPECs (${path.relative(PROJECT_DIR, path.join(projectVibeRoot(PROJECT_DIR), 'scope.json'))})`);
-        }
-      }
-      // scope 상태 1줄 알림 — 활성 scope.json 이 있을 때만 (opt-out 사용자에게 노이즈 금지)
-      const scopeJsonPath = path.join(projectVibeRoot(PROJECT_DIR), 'scope.json');
-      if (fs.existsSync(scopeJsonPath)) {
-        try {
-          const scopeData = JSON.parse(fs.readFileSync(scopeJsonPath, 'utf-8'));
-          const featureLabel = scopeData.reason || path.basename(scopeJsonPath);
-          const modeLabel = scopeData.mode || 'warn';
-          console.log(`\nscope-guard: ${featureLabel} (${modeLabel})`);
-        } catch { /* ignore */ }
-      } else if (guardOn) {
-        console.log('\nscope-guard: no active scope (no active SPEC or no derivable paths) — out-of-scope edits are not monitored');
-      }
-    } catch { /* scope sync is best-effort */ }
-
-    // Autonomy status summary
-    try {
-      const fs = await import('fs');
-      const configPath = projectVibePath(PROJECT_DIR, 'config.json');
-      let autonomyMode = 'suggest';
-      let sentinelEnabled = true;
-
-      if (fs.existsSync(configPath)) {
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-        autonomyMode = config.autonomy?.mode || 'suggest';
-        sentinelEnabled = config.sentinel?.enabled !== false;
-      }
-
-      const LIB_BASE_A = (await import('./utils.js')).getLibBaseUrl();
-      const memModA = await import(`${LIB_BASE_A}memory/MemoryStorage.js`);
-      const storageA = new memModA.MemoryStorage(PROJECT_DIR);
-      const db = storageA.getDatabase();
-
-      const last24h = new Date(Date.now() - 86_400_000).toISOString();
-      let totalActions = 0;
-      let allowedActions = 0;
-      let blockedActions = 0;
-      let pendingSuggestions = 0;
-      let pendingConfirmations = 0;
-
-      try {
-        totalActions = db.prepare('SELECT COUNT(*) as c FROM audit_events WHERE createdAt >= ?').get(last24h)?.c ?? 0;
-        allowedActions = db.prepare("SELECT COUNT(*) as c FROM audit_events WHERE createdAt >= ? AND outcome = 'allowed'").get(last24h)?.c ?? 0;
-        blockedActions = db.prepare("SELECT COUNT(*) as c FROM audit_events WHERE createdAt >= ? AND outcome = 'blocked'").get(last24h)?.c ?? 0;
-      } catch { /* table not initialized yet */ }
-
-      try {
-        pendingSuggestions = db.prepare("SELECT COUNT(*) as c FROM suggestions WHERE status = 'pending'").get()?.c ?? 0;
-      } catch { /* table not initialized yet */ }
-
-      try {
-        pendingConfirmations = db.prepare("SELECT COUNT(*) as c FROM confirmations WHERE status = 'pending'").get()?.c ?? 0;
-      } catch { /* table not initialized yet */ }
-
-      const parts = [`${autonomyMode} mode`];
-      if (sentinelEnabled) parts.push('sentinel ON');
-      if (pendingConfirmations > 0) parts.push(`${pendingConfirmations} pending confirmations`);
-      if (pendingSuggestions > 0) parts.push(`${pendingSuggestions} suggestions`);
-      if (totalActions > 0) parts.push(`${totalActions} actions (${allowedActions} ok, ${blockedActions} blocked)`);
-
-      console.log(`\n🤖 Autonomy: ${parts.join(' | ')}`);
-      storageA.close();
-    } catch { /* autonomy not yet initialized, skip */ }
-
-    // Evolution 상태 요약은 제거 — evolution 은 동결(opt-in) 상태이며
-    // 사용자는 `vibe evolution` CLI 로 명시적으로 조회한다 (P3-3).
-
-    // ─── 휘발 블록 마지막 ──────────────────────────────────────────────
-    // 현재 시각·진행 카운터·버전 체크는 세션마다 값이 달라진다. 위의 안정 블록을
-    // 앞에 두기 위해 여기로 모았다. 내용은 이전과 동일하고 순서만 바뀐다.
-    console.log(`\n${time.content[0].text}`);
-
-    try {
-      const LIB_BASE_P = (await import('./utils.js')).getLibBaseUrl();
-      const iterMod = await import(`${LIB_BASE_P}IterationTracker.js`);
-      const progressLine = iterMod.getProgressSummary(PROJECT_DIR);
-      if (progressLine) {
-        console.log(`📋 ${progressLine} — resume full context: /vibe.continue`);
-      }
-    } catch { /* progress index is best-effort */ }
-
-    if (latestVersion) {
-      const currentVersion = getCurrentVersion();
-      if (currentVersion && compareVersions(latestVersion, currentVersion) > 0) {
-        console.log(`\n⬆️ Harness update available: v${currentVersion} → v${latestVersion}`);
-        console.log('   Run: vibe upgrade');
-      }
-    }
-  } catch (e) {
-    // 훅 실패를 stdout 으로 보내면 "실패 신호" 가 아니라 모델에게 주입되는
-    // 컨텍스트 문자열이 된다 — 가드의 생사가 관측 불가능해진다.
-    console.error('[Session] Error:', e.message);
-  }
-}
-
-main();

package/hooks/scripts/step-counter.js

@@ -1,364 +0,0 @@
-#!/usr/bin/env node
-/**
- * PostToolUse Hook — 툴콜 스텝 카운터 + 패턴 로거 + 3-fail 감지기
- *
- * hooks.json matcher: "Edit|Write|Bash|Agent|Skill|Task|SlashCommand|NotebookEdit"
- * → Read/Grep/Glob/WebFetch/WebSearch/TodoWrite/ToolSearch/ListMcpResourcesTool
- *   는 matcher 단에서 제외되어 이 프로세스 자체가 spawn 되지 않는다.
- *   아래 READ_ONLY_TOOLS 는 defense-in-depth 용 추가 가드이다.
- *
- * ⚠️ **툴 이름은 하네스가 바꾼다 — 옛 이름을 지우지 않는다.**
- * 서브에이전트 툴이 `Task` → `Agent` 로 바뀌었는데 matcher 가 옛 이름만 갖고 있어
- * 에이전트 스폰이 **한 건도 집계되지 않고 있었다**(2026-08 실측: 세션 로그 60개에서
- * `Agent` 13회 / `Task` 0회). 슬래시 명령도 `SlashCommand` → `Skill` 로 옮겨갔다
- * (`Skill` 116회 / `SlashCommand` 0회).
- *
- * 이 실패는 조용하다 — 카운터가 에러 없이 0을 센다. 그래서 규칙은 한 방향이다:
- * **과다 매칭은 안전하고(스크립트가 걸러낸다) 과소 매칭은 소리 없이 데이터를 잃는다.**
- * 새 이름은 추가하고 옛 이름은 남긴다 — 구버전 하네스 호환도 같이 얻는다.
- *
- * 책임 1) 액션 툴콜을 1 스텝으로 집계 → `current-run.json`
- *        ↳ /vibe.verify 가 history.jsonl에 append 후 출력
- *        ↳ recipe-extractor 가 meta(startedAt, steps) 소비
- *        [쓰기 스로틀] current-run.json 전체 재작성은 (a) 마지막 재작성 후
- *        ≥2초 경과, 또는 (b) 10이벤트마다 1회로 제한.
- *        액션 툴(Edit/Write/Bash) 호출 + ≥2초 조건을 동시 충족할 때도 재작성.
- *        Stop 경로 등 최종 상태가 필요한 소비자는 staleness ≤10 이벤트를 허용.
- * 책임 2) 각 툴콜 한 줄을 `current-run.jsonl` 에 append (항상 즉시 — 스로틀 없음)
- *        ↳ Phase 3 의 recipe extractor 가 소비
- * 책임 3) (Phase 2) 실패 메시지 분류 + 같은 (file, category) 3회 반복 감지 →
- *        `.vibe/anti-patterns/<slug>.md` 로 자동 저장.
- *
- * 세 책임은 독립 — 어느 한쪽 실패가 다른 쪽을 막지 않는다.
- * PostToolUse 는 hot path 이므로 LLM 호출/외부 spawn 금지, fs 만 사용.
- */
-import fs from 'fs';
-import path from 'path';
-import { PROJECT_DIR, projectVibePath } from './utils.js';
-import { buildCliCtx } from './lib/hook-context.js';
-
-const METRICS_DIR = projectVibePath(PROJECT_DIR, 'metrics');
-const ANTI_PATTERNS_DIR = projectVibePath(PROJECT_DIR, 'anti-patterns');
-const CURRENT_RUN_JSON = path.join(METRICS_DIR, 'current-run.json');
-const CURRENT_RUN_JSONL = path.join(METRICS_DIR, 'current-run.jsonl');
-// 회전 마커 — jsonl 앞부분이 잘린 사실을 소비자가 추측하지 않게 남긴다 (iteration-cost.js 가 읽는다)
-const CURRENT_RUN_ROTATION = path.join(METRICS_DIR, 'current-run-rotation.json');
-const MAX_JSONL_LINES = 5000;
-const FAIL_WINDOW = 10;
-const FAIL_THRESHOLD = 3;
-
-// 스로틀 파라미터
-const REWRITE_INTERVAL_MS = 2000; // 최소 재작성 간격
-const REWRITE_EVERY_N = 10;       // N이벤트마다 강제 재작성
-
-// 읽기 전용 툴 — defense-in-depth (matcher 단에서 이미 제거됨)
-const READ_ONLY_TOOLS = new Set([
-  'Read', 'Grep', 'Glob', 'WebFetch', 'WebSearch',
-  'TodoWrite', 'ToolSearch', 'ListMcpResourcesTool',
-]);
-
-function extractTargetFile(filePath) {
-  if (!filePath) return null;
-  try {
-    const abs = path.isAbsolute(filePath) ? filePath : path.resolve(PROJECT_DIR, filePath);
-    const rel = path.relative(path.resolve(PROJECT_DIR), abs).replace(/\\/g, '/');
-    return rel || path.basename(filePath);
-  } catch {
-    return filePath;
-  }
-}
-
-function isResponseError(toolResponse) {
-  if (!toolResponse) return false;
-  if (typeof toolResponse === 'object') {
-    if (toolResponse.is_error === true) return true;
-    if (toolResponse.error) return true;
-    if (Array.isArray(toolResponse.errors) && toolResponse.errors.length > 0) return true;
-  }
-  return false;
-}
-
-// ─────────────────────────────────────────────────────
-// 책임 3a: error_category 분류 (regex 만 — regress tag enum 일부)
-// ─────────────────────────────────────────────────────
-const ERROR_CATEGORIES = [
-  { tag: 'nullability', re: /Cannot read propert(?:y|ies) of (?:undefined|null)|TypeError[^\n]*(?:undefined|null)/i },
-  { tag: 'type-narrow', re: /\bTS2345\b|not assignable to (?:parameter|type)/i },
-  { tag: 'compilation', re: /\bTS\d{4}\b|cannot find name|build failed|compilation (?:error|failed)/i },
-  { tag: 'syntax', re: /SyntaxError|Unexpected token/i },
-  { tag: 'integration', re: /ECONNREFUSED|ENOTFOUND|ETIMEDOUT|ECONNRESET|connect failed/i },
-  { tag: 'auth', re: /\b(?:401|403)\b|unauthori[sz]ed|forbidden|invalid (?:token|credentials)/i },
-  { tag: 'permission', re: /EACCES|permission denied/i },
-  { tag: 'not-found', re: /ENOENT|no such file|not found/i },
-];
-
-function classifyError(toolResponse) {
-  if (!toolResponse) return null;
-  let text;
-  if (typeof toolResponse === 'string') text = toolResponse;
-  else if (toolResponse.error) text = String(toolResponse.error);
-  else if (Array.isArray(toolResponse.errors)) text = JSON.stringify(toolResponse.errors);
-  else if (toolResponse.content) text = JSON.stringify(toolResponse.content);
-  else text = JSON.stringify(toolResponse);
-
-  for (const { tag, re } of ERROR_CATEGORIES) {
-    if (re.test(text)) return tag;
-  }
-  return 'other';
-}
-
-// ─────────────────────────────────────────────────────
-// 스로틀: current-run.json 재작성 여부 결정
-// ─────────────────────────────────────────────────────
-/**
- * 재작성해야 하는지 판단.
- * - jsonlLineCount: jsonl 에 추가한 후의 총 라인 수 (이벤트 카운터 대리)
- * - toolName: Edit/Write/Bash 인 경우 mtime 조건 충족 시 강제 재작성
- * @param {string} toolName
- * @param {number} jsonlLineCount
- * @returns {boolean}
- */
-function shouldRewriteJson(toolName, jsonlLineCount) {
-  // N이벤트마다 강제 재작성 (race-tolerant — jsonl 줄 수가 카운터 역할)
-  if (jsonlLineCount % REWRITE_EVERY_N === 0) return true;
-
-  // 마지막 재작성 후 ≥2초 경과 여부 (mtime 기반)
-  try {
-    const stat = fs.statSync(CURRENT_RUN_JSON);
-    const elapsed = Date.now() - stat.mtimeMs;
-    if (elapsed >= REWRITE_INTERVAL_MS) return true;
-  } catch {
-    // 파일 없음 → 첫 쓰기, 허용
-    return true;
-  }
-
-  return false;
-}
-
-// ─────────────────────────────────────────────────────
-// 책임 1: current-run.json 카운터 (스로틀 적용)
-//
-// steps 는 current-run.jsonl 의 라인 수에서 파생한다.
-// 이렇게 하면 스로틀로 재작성을 건너뛰어도 재작성 시점에
-// 정확한 steps 가 보장되며, 프로세스간 누적도 자연스럽게 처리된다.
-// ─────────────────────────────────────────────────────
-function bumpCounter(toolName, currentLineCount) {
-  if (!shouldRewriteJson(toolName, currentLineCount)) return; // 스로틀 — 재작성 생략
-
-  let data = { feature: null, startedAt: null, steps: 0 };
-  if (fs.existsSync(CURRENT_RUN_JSON)) {
-    try {
-      data = JSON.parse(fs.readFileSync(CURRENT_RUN_JSON, 'utf-8'));
-    } catch { /* 손상 → 새로 시작 */ }
-  }
-  if (!data.startedAt) data.startedAt = new Date().toISOString();
-  // steps = jsonl 라인 수에서 파생 (매 재작성 시 최신값 보장)
-  data.steps = currentLineCount;
-
-  // 원자적 쓰기 (tmp → rename) — 동시 에이전트 파일 손상 방지
-  const tmp = CURRENT_RUN_JSON + '.tmp';
-  try {
-    fs.writeFileSync(tmp, JSON.stringify(data, null, 2));
-    fs.renameSync(tmp, CURRENT_RUN_JSON);
-  } catch {
-    // rename 실패 시 직접 쓰기 (fail-open)
-    try { fs.writeFileSync(CURRENT_RUN_JSON, JSON.stringify(data, null, 2)); } catch { /* ignore */ }
-    try { fs.unlinkSync(tmp); } catch { /* ignore */ }
-  }
-}
-
-// ─────────────────────────────────────────────────────
-// 책임 2: current-run.jsonl append + error_category 채움
-// 항상 즉시 append — 스로틀 없음 (3-fail detector, recipe-extractor 가 소비)
-// ─────────────────────────────────────────────────────
-
-/**
- * 회전 사실을 **기록한다** — 소비자가 추측하지 않게.
- *
- * 회전은 로그의 앞부분을 지우므로, 그 뒤로 계산되는 구간 집계는 전부 하한이 된다.
- * 그런데 "로그의 첫 줄이 구간 시작보다 뒤" 라는 추측으로는 회전을 알아낼 수 없다 —
- * 그건 회전이 없어도 항상 참이다(구간 시작 직후에 툴콜이 없었을 뿐일 수 있다).
- * 추측으로 두면 소비자가 멀쩡한 구간을 조용히 버린다.
- *
- * 별도 파일에 쓰는 이유: jsonl 에 마커 줄을 끼우면 이 파일을 툴콜 기록으로 읽는
- * 기존 소비자(recipe-extractor · 3-fail detector)가 그것을 툴콜로 센다.
- *
- * @param {string[]} keptLines 회전 후 남긴 줄들
- */
-function writeRotationMarker(keptLines) {
-  try {
-    let keptFrom = null;
-    for (const line of keptLines) {
-      try { keptFrom = JSON.parse(line).ts || null; break; } catch { /* 손상된 줄 건너뜀 */ }
-    }
-    fs.writeFileSync(
-      CURRENT_RUN_ROTATION,
-      JSON.stringify({ rotatedAt: new Date().toISOString(), keptFrom }, null, 2),
-    );
-  } catch { /* 마커 실패는 무시 — 회전 자체를 막지 않는다 */ }
-}
-function appendJsonl(ctx) {
-  const toolName = ctx.toolName;
-  if (!toolName) return null;
-
-  const ok = !isResponseError(ctx.payload?.tool_response);
-  const errorCategory = ok ? null : classifyError(ctx.payload?.tool_response);
-
-  const record = {
-    ts: new Date().toISOString(),
-    tool: toolName,
-    ok,
-    target_file: extractTargetFile(ctx.filePath),
-    error_category: errorCategory,
-  };
-
-  fs.appendFileSync(CURRENT_RUN_JSONL, JSON.stringify(record) + '\n');
-
-  // 회전: 라인 수가 상한 초과 시 마지막 절반만 남김.
-  try {
-    const stat = fs.statSync(CURRENT_RUN_JSONL);
-    if (stat.size > 2 * 1024 * 1024) {
-      const lines = fs.readFileSync(CURRENT_RUN_JSONL, 'utf-8').split('\n').filter(Boolean);
-      if (lines.length > MAX_JSONL_LINES) {
-        const keep = lines.slice(-Math.floor(MAX_JSONL_LINES / 2));
-        fs.writeFileSync(CURRENT_RUN_JSONL, keep.join('\n') + '\n');
-        writeRotationMarker(keep);
-      }
-    }
-  } catch { /* 회전 실패는 무시 */ }
-
-  return record;
-}
-
-/**
- * current-run.jsonl 을 1회만 읽어 (a) 스로틀 판단용 총 라인 수와
- * (b) 3-fail detector 용 최근 FAIL_WINDOW 줄을 함께 파생한다.
- *
- * 이전에는 jsonlLineCount()·readTailWindow() 가 각자 파일 전체를 다시 읽어
- * 실패 이벤트마다 이벤트당 최대 2회 풀리드가 발생했다 — 여기서 1회로 통합.
- * 파일은 회전 상한(2MB / MAX_JSONL_LINES)을 벗어나지 않도록 유지되므로
- * (appendJsonl의 회전 로직 참고) 이 read 로도 기존과 동일하게 정확한 라인 수를
- * 얻는다 — 스로틀/3-fail 판정 결과는 회전 상한 이내 파일에서 이전과 동일하다.
- * @returns {{ lineCount: number, tail: object[] }}
- */
-function readJsonlState() {
-  let lines;
-  try {
-    lines = fs.readFileSync(CURRENT_RUN_JSONL, 'utf-8').split('\n').filter(Boolean);
-  } catch {
-    return { lineCount: 1, tail: [] }; // 파일 없음 → 첫 이벤트로 간주
-  }
-  const tail = lines.slice(-FAIL_WINDOW).map((l) => {
-    try { return JSON.parse(l); } catch { return null; }
-  }).filter(Boolean);
-  return { lineCount: lines.length, tail };
-}
-
-// ─────────────────────────────────────────────────────
-// 책임 3b: 3-fail detector → anti-pattern md
-// ─────────────────────────────────────────────────────
-const SUGGESTED_STOPS = {
-  nullability: '같은 위치 null/undefined 처리 반복 — 타입 가드 또는 옵셔널 체이닝 필요',
-  'type-narrow': '같은 위치 타입 좁히기 반복 — 타입 정의 점검 필요',
-  compilation: '컴파일 실패 반복 — 타입/임포트 정의 확인 필요',
-  syntax: '구문 오류 반복 — 파서 호환성/버전 확인 필요',
-  integration: '외부 서비스 연결 실패 반복 — endpoint/포트/네트워크 점검 필요',
-  auth: '인증 실패 반복 — 토큰/자격증명 점검 필요',
-  permission: '권한 실패 반복 — 파일/디렉토리 권한 점검 필요',
-  'not-found': '리소스 부재 반복 — 경로/존재 확인 필요',
-  other: '같은 패턴 실패 반복 — 접근 방식 재검토 필요',
-};
-
-function fileSlug(targetFile) {
-  if (!targetFile) return 'global';
-  return targetFile.replace(/[\/\.]/g, '-');
-}
-
-function detectThreeFail(window) {
-  const groups = new Map();
-  for (const r of window) {
-    if (r.ok || !r.error_category) continue;
-    const key = `${r.target_file ?? 'null'}::${r.error_category}`;
-    const cur = groups.get(key) ?? 0;
-    groups.set(key, cur + 1);
-  }
-  for (const [key, count] of groups) {
-    if (count >= FAIL_THRESHOLD) {
-      const sep = key.indexOf('::');
-      const file = key.slice(0, sep);
-      const cat = key.slice(sep + 2);
-      return { category: cat, targetFile: file === 'null' ? null : file, count };
-    }
-  }
-  return null;
-}
-
-function writeAntiPattern({ category, targetFile, count }) {
-  if (!fs.existsSync(ANTI_PATTERNS_DIR)) {
-    fs.mkdirSync(ANTI_PATTERNS_DIR, { recursive: true });
-  }
-  const today = new Date().toISOString().slice(0, 10);
-  const dateSlug = today.replace(/-/g, '');
-  const fSlug = fileSlug(targetFile);
-  const slug = `${category}__${fSlug}__${dateSlug}`;
-  const filePath = path.join(ANTI_PATTERNS_DIR, `${slug}.md`);
-  if (fs.existsSync(filePath)) return; // dedup
-
-  const trigger = `(file=${targetFile ?? 'null'}, category=${category})`;
-  const stop = SUGGESTED_STOPS[category] ?? SUGGESTED_STOPS.other;
-  const content = `---
-slug: ${slug}
-type: anti-pattern
-root-cause-tag: ${category}
-trigger-signature: "${trigger}"
-fail-count: ${count}
-suggested-stop: "${stop}"
-created: ${today}
----
-
-## Trigger
-${trigger} 이 ${FAIL_WINDOW} 툴콜 윈도우 내 ${count} 회 발생.
-
-## Suggested Stop
-${stop}
-
-> 자동 생성 — 같은 패턴 반복 시 다른 접근법을 고려하거나 사용자에게 조언을 구할 것.
-`;
-  fs.writeFileSync(filePath, content);
-}
-
-// ─────────────────────────────────────────────────────
-// 메인 — 세 책임을 독립적으로 try
-// ─────────────────────────────────────────────────────
-try {
-  if (!fs.existsSync(METRICS_DIR)) {
-    fs.mkdirSync(METRICS_DIR, { recursive: true });
-  }
-
-  const ctx = buildCliCtx();
-  const toolName = ctx.toolName;
-
-  // defense-in-depth: 읽기 전용 툴은 조기 종료 (matcher 단에서 이미 제거됨)
-  if (toolName && READ_ONLY_TOOLS.has(toolName)) {
-    process.exit(0);
-  }
-
-  // 책임 2를 먼저 실행 — jsonl 라인 수가 bumpCounter 스로틀 판단에 쓰임
-  let lastRecord = null;
-  try { lastRecord = appendJsonl(ctx); } catch { /* 로깅 실패 무시 */ }
-
-  // 책임 1: jsonl append 후 라인 수로 스로틀 판단 (책임 3의 tail window 와 1회 읽기 공유)
-  const { lineCount, tail } = readJsonlState();
-  try { bumpCounter(toolName, lineCount); } catch { /* 카운터 실패 무시 */ }
-
-  // 책임 3
-  try {
-    if (lastRecord && !lastRecord.ok && lastRecord.error_category) {
-      const trip = detectThreeFail(tail);
-      if (trip) writeAntiPattern(trip);
-    }
-  } catch { /* anti-pattern 작성 실패 무시 */ }
-} catch {
-  // Never block on counter failure
-}
-process.exit(0);

package/hooks/scripts/stop-dispatcher.js

@@ -1,56 +0,0 @@
-#!/usr/bin/env node
-/**
- * Stop dispatcher — Claude 응답 종료 시 4개 스크립트 순차 실행.
- *
- * 기존: Stop 배열에 4개 병렬 spawn (codex-review-gate + stop-notify + auto-commit + devlog-gen)
- *       → auto-commit의 git cascade와 겹쳐 프로세스 폭주 유발 가능.
- * 현재: 단일 디스패처에서 순차 실행.
- *
- * 실행 순서:
- *   0. verify-skip 경고/차단 (in-process)
- *   1. codex-review-gate — 리뷰 필요 여부 판단 (stdout → Claude 지시 주입)
- *   2. stop-notify       — 완료 알림
- *   3. auto-commit       — 변경 자동 커밋 (git hook cascade 주의)
- *   4. devlog-gen        — 개발 로그 기록
- *
- * 재귀 가드 상속: callClaudeCli가 VIBE_HOOK_DEPTH=1 env를 자식에 주입했다면
- * 이 Stop dispatcher도 건너뛴다 (자식 세션에서 auto-commit 등이 돌 이유 없음).
- */
-import { dispatch } from './lib/dispatcher.js';
-import { readLedger, markStopWarned } from './lib/run-ledger.js';
-import { PROJECT_DIR, readProjectConfig } from './utils.js';
-
-if (process.env.VIBE_HOOK_DEPTH) process.exit(0);
-
-// verify-skip 게이트 — runStarted가 있고 verifyPassed가 false이면 경고 또는 차단.
-// stopWarned가 이미 true이면 루프 방지를 위해 스킵.
-try {
-  const ledger = readLedger(PROJECT_DIR);
-  if (ledger && ledger.runStarted && !ledger.verifyPassed && !ledger.stopWarned) {
-    const config = readProjectConfig();
-    const gateMode = config?.verifyGate?.mode;
-
-    if (gateMode === 'block') {
-      // 1회에 한해 Stop 차단 — 루프 방지 플래그 먼저 세팅
-      markStopWarned(PROJECT_DIR);
-      const reason = '/vibe.verify not run after /vibe.run — stop blocked (verifyGate.mode=block)';
-      process.stdout.write(JSON.stringify({ decision: 'block', reason }) + '\n');
-      process.exit(0);
-    } else {
-      // 기본: warn 모드 — stderr에 경고, 루프 방지 플래그 세팅
-      markStopWarned(PROJECT_DIR);
-      const feature = ledger.runFeature ? ` (feature: ${ledger.runFeature})` : '';
-      process.stderr.write(`[vibe] WARNING: /vibe.run${feature} completed but /vibe.verify was not run.\n`);
-    }
-  }
-} catch { /* verify-skip 게이트 실패는 이후 실행을 막지 않음 */ }
-
-try {
-  await dispatch([
-    { name: 'codex-review-gate', script: 'codex-review-gate.js' },
-    { name: 'stop-notify',       script: 'stop-notify.js'       },
-    { name: 'auto-commit',       script: 'auto-commit.js'       },
-    { name: 'devlog-gen',        script: 'devlog-gen.js'        },
-  ]);
-} catch { /* noise suppression */ }
-process.exit(0);