@su-record/vibe 3.2.64 → 4.0.0

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

@@ -1,278 +0,0 @@
-#!/usr/bin/env node
-/**
- * Pre-Tool Guard
- * 위험한 도구 사용 전 검증 및 경고
- */
-
-// 위험한 명령어 패턴
-//
-// 각 엔트리의 `target`은 매칭 대상 필드:
-//   - 'command'   → tool_input.command (Bash)
-//   - 'file_path' → tool_input.file_path (Write, Edit)
-//   - 'raw'       → 전체 문자열 (스키마 모를 때 폴백)
-//
-// 예전 버전은 항상 stringify된 tool_input 전체에 매칭하여 file content가
-// 패턴(예: /etc/, .env)과 일치하면 false positive로 차단되는 버그가 있었음.
-// 회귀: .claude/vibe/regressions/pre-tool-guard-content-false-positive.md
-const DANGEROUS_PATTERNS = {
-  bash: [
-    // `/` or `~` must be the *entire* argument (optionally followed by `*`, `/`, or `/*`).
-    // Prevents false positives on safe absolute paths like `/tmp/foo` or `/Users/me/proj`.
-    // The lookahead requires an arg boundary (whitespace, shell separator, or end-of-string).
-    { pattern: /rm\s+-rf?\s+(\/|\/\*|~|~\/|~\/\*)(?=\s|[;&|]|$)/, target: 'command', severity: 'critical', message: 'Deleting root or home directory' },
-    { pattern: /rm\s+-rf?\s+\*/, target: 'command', severity: 'high', message: 'Wildcard deletion detected' },
-    { pattern: /git\s+push\s+.*--force/, target: 'command', severity: 'high', message: 'Force push detected' },
-    { pattern: /git\s+reset\s+--hard/, target: 'command', severity: 'medium', message: 'Hard reset will discard changes' },
-    { pattern: /drop\s+(table|database)/i, target: 'command', severity: 'critical', message: 'Database drop detected' },
-    { pattern: /truncate\s+table/i, target: 'command', severity: 'high', message: 'Table truncate detected' },
-    { pattern: /:(){ :|:& };:/, target: 'command', severity: 'critical', message: 'Fork bomb detected' },
-    { pattern: /mkfs|fdisk|dd\s+if=/, target: 'command', severity: 'critical', message: 'Disk operation detected' },
-    { pattern: /chmod\s+-R\s+777/, target: 'command', severity: 'medium', message: 'Insecure permission change' },
-    { pattern: /curl.*\|\s*(ba)?sh/, target: 'command', severity: 'high', message: 'Piping curl to shell' },
-  ],
-  edit: [
-    { pattern: /\.env|credentials|secret|password|api[_-]?key/i, target: 'file_path', severity: 'medium', message: 'Editing sensitive file' },
-    { pattern: /package-lock\.json|yarn\.lock|pnpm-lock/, target: 'file_path', severity: 'low', message: 'Editing lock file directly' },
-  ],
-  write: [
-    { pattern: /\.env|credentials|secret/i, target: 'file_path', severity: 'medium', message: 'Writing to sensitive file' },
-    { pattern: /\/etc\/|\/usr\/|C:\\Windows/i, target: 'file_path', severity: 'critical', message: 'Writing to system directory' },
-  ],
-};
-
-// 도구 입력 스키마 검증 (경량 — 외부 의존성 없음)
-const TOOL_INPUT_SCHEMAS = {
-  Bash: { required: ['command'], types: { command: 'string', timeout: 'number' } },
-  Read: { required: ['file_path'], types: { file_path: 'string', offset: 'number', limit: 'number' } },
-  Edit: { required: ['file_path', 'old_string', 'new_string'], types: { file_path: 'string', old_string: 'string', new_string: 'string' } },
-  Write: { required: ['file_path', 'content'], types: { file_path: 'string', content: 'string' } },
-  Glob: { required: ['pattern'], types: { pattern: 'string', path: 'string' } },
-  Grep: { required: ['pattern'], types: { pattern: 'string', path: 'string' } },
-};
-
-function validateInputSchema(toolName, rawInput) {
-  const schema = TOOL_INPUT_SCHEMAS[toolName];
-  if (!schema) return { valid: true, errors: [] }; // 스키마 없으면 통과
-
-  let input;
-  try {
-    input = typeof rawInput === 'string' ? JSON.parse(rawInput) : rawInput;
-  } catch {
-    return { valid: true, errors: [] }; // JSON 아니면 레거시 모드 — 통과
-  }
-  if (typeof input !== 'object' || !input) return { valid: true, errors: [] };
-
-  const errors = [];
-  // 필수 필드 검증
-  for (const field of schema.required || []) {
-    if (input[field] === undefined || input[field] === null) {
-      errors.push(`Missing required field: ${field}`);
-    }
-  }
-  // 타입 검증
-  for (const [field, expectedType] of Object.entries(schema.types || {})) {
-    if (input[field] !== undefined && typeof input[field] !== expectedType) {
-      errors.push(`Field '${field}' expected ${expectedType}, got ${typeof input[field]}`);
-    }
-  }
-  // 경로 검증 (path traversal 기본 방어)
-  if (input.file_path && typeof input.file_path === 'string') {
-    if (input.file_path.includes('\0')) errors.push('Null byte in file_path');
-  }
-
-  return { valid: errors.length === 0, errors };
-}
-
-// 안전한 대안 제안
-const SAFE_ALTERNATIVES = {
-  'rm -rf': 'Use trash-cli (trash-put) or move to a backup directory first',
-  'git push --force': 'Use git push --force-with-lease instead',
-  'git reset --hard': 'Create a backup branch first: git branch backup-$(date +%s)',
-  'drop table': 'Consider soft delete or backup first',
-  'chmod 777': 'Use specific permissions (e.g., chmod 755 for directories)',
-};
-
-/**
- * 패턴 매칭 대상 추출
- *
- * tool_input이 객체이면 target 필드만 뽑아 반환. 객체가 아니거나(레거시 argv 모드)
- * target='raw'이면 입력 전체를 그대로 반환.
- *
- * 핵심: write/edit 패턴은 file_path만 봐야 한다. content에 우연히 들어간
- * 리터럴(예: 코드 안의 '/etc/machine-id' 문자열)이 차단을 일으키지 않도록.
- */
-function extractTarget(rawInput, target) {
-  if (target === 'raw') return typeof rawInput === 'string' ? rawInput : JSON.stringify(rawInput);
-
-  // 객체로 파싱 시도
-  let obj = rawInput;
-  if (typeof rawInput === 'string') {
-    try {
-      obj = JSON.parse(rawInput);
-    } catch {
-      // JSON 아님 → 레거시 argv 모드. argv[3]은 보통 file_path 또는 command 단일 문자열.
-      // 안전하게 그 문자열을 target 값으로 간주.
-      return rawInput;
-    }
-  }
-
-  if (typeof obj !== 'object' || obj === null) return '';
-  const value = obj[target];
-  return typeof value === 'string' ? value : '';
-}
-
-/**
- * 명령어 검증
- */
-function validateCommand(toolName, rawInput) {
-  const results = {
-    allowed: true,
-    severity: 'none',
-    warnings: [],
-    suggestions: [],
-  };
-
-  const patterns = DANGEROUS_PATTERNS[toolName.toLowerCase()] || [];
-
-  for (const { pattern, target, severity, message } of patterns) {
-    const haystack = extractTarget(rawInput, target || 'raw');
-    if (!haystack) continue;
-
-    if (pattern.test(haystack)) {
-      results.warnings.push(`[${severity.toUpperCase()}] ${message}`);
-
-      // 심각도에 따른 처리
-      if (severity === 'critical') {
-        results.allowed = false;
-        results.severity = 'critical';
-      } else if (severity === 'high' && results.severity !== 'critical') {
-        results.severity = 'high';
-      } else if (results.severity === 'none') {
-        results.severity = severity;
-      }
-
-      // 대안 제안 — 매칭된 target 필드에서만 검색
-      for (const [dangerous, safe] of Object.entries(SAFE_ALTERNATIVES)) {
-        if (haystack.includes(dangerous)) {
-          results.suggestions.push(safe);
-        }
-      }
-    }
-  }
-
-  return results;
-}
-
-/**
- * 출력 포맷
- */
-function formatOutput(toolName, validation) {
-  const lines = [];
-
-  if (validation.warnings.length === 0) {
-    return ''; // 경고 없으면 출력 없음
-  }
-
-  lines.push(`⚠️ PRE-TOOL GUARD: ${toolName}`);
-
-  for (const warning of validation.warnings) {
-    lines.push(`  ${warning}`);
-  }
-
-  if (validation.suggestions.length > 0) {
-    lines.push('');
-    lines.push('💡 Suggestions:');
-    for (const suggestion of validation.suggestions) {
-      lines.push(`  - ${suggestion}`);
-    }
-  }
-
-  if (!validation.allowed) {
-    lines.push('');
-    lines.push('🚫 BLOCKED: This operation is too dangerous. Please review and modify.');
-  }
-
-  return lines.join('\n');
-}
-
-import { logHookDecision, PROJECT_DIR } from './utils.js';
-import { buildCliCtx, isDirectRun } from './lib/hook-context.js';
-import { runPrTestGate } from './lib/pr-gate-runner.js';
-import { ephemeralPathsInGitCommand, formatEphemeralBlock } from './lib/ephemeral-lane.js';
-
-/** gh pr create 감지 정규식 (단어 경계 기준, 플래그 허용). */
-const GH_PR_CREATE_RE = /\bgh\s+pr\s+create\b/;
-
-/**
- * in-process 진입점 — 디스패처가 ctx를 전달해 직접 호출.
- * @param {{ toolName: string, toolInput: string, payload: object|null }} ctx
- * @returns {Promise<number>} exit code (0 = allowed, 2 = denied)
- */
-export async function run(ctx) {
-  const toolName = ctx.toolName || 'Bash';
-  const toolInput = ctx.toolInput;
-
-  // 1단계: 입력 스키마 검증 (구조적 오류 탐지)
-  const schemaResult = validateInputSchema(toolName, ctx.payload?.tool_input || toolInput);
-  if (!schemaResult.valid) {
-    // stderr: Claude Code surfaces stderr in hook-error notifications; stdout is injected
-    // into the assistant's context and never shown to the user. Guard messages target the user.
-    console.error(`⚠️ INPUT VALIDATION: ${toolName}`);
-    for (const err of schemaResult.errors) {
-      console.error(`  [SCHEMA] ${err}`);
-    }
-    logHookDecision('pre-tool-guard', toolName, 'warn', `schema: ${schemaResult.errors.join('; ')}`);
-    // 스키마 오류는 경고만 (차단하지 않음 — 레거시 호환)
-  }
-
-  // 2단계: gh pr create Bash 명령 → PR 테스트 게이트
-  if (toolName === 'Bash' || toolName === 'bash') {
-    const command = extractTarget(toolInput, 'command') || toolInput;
-    if (GH_PR_CREATE_RE.test(command)) {
-      const gateResult = runPrTestGate(PROJECT_DIR);
-      if (!gateResult.passed) {
-        console.error(`[PR-GATE] Tests failed — gh pr create blocked\n${gateResult.output}`);
-        logHookDecision('pre-tool-guard', 'Bash', 'block', 'gh pr create: test gate failed');
-        return 2;
-      }
-    }
-  }
-
-  // 2-b단계: 일회성 경로를 커밋하려는 시도 차단 (심층 방어)
-  //
-  // 1차 방어는 gitignore 다 — `git add` 는 무시된 경로를 그냥 거부한다. 실제로 뚫리는
-  // 경로는 `git add -f` 하나뿐이고 여기서 그것을 막는다. 훅은 프로젝트 로컬이라
-  // 미설치가 흔하므로 이것을 1차라고 부르지 않는다.
-  if (toolName === 'Bash' || toolName === 'bash') {
-    const command = extractTarget(toolInput, 'command') || toolInput;
-    const ephemeral = ephemeralPathsInGitCommand(command);
-    if (ephemeral.length > 0) {
-      console.error(formatEphemeralBlock(ephemeral));
-      logHookDecision('pre-tool-guard', 'Bash', 'block', `ephemeral commit: ${ephemeral.join(', ')}`);
-      return 2;
-    }
-  }
-
-  // 3단계: 위험 패턴 검증 (보안 탐지)
-  const validation = validateCommand(toolName, toolInput);
-  const output = formatOutput(toolName, validation);
-
-  if (output) {
-    console.error(output);
-  }
-
-  // Hook trace logging
-  if (!validation.allowed) {
-    logHookDecision('pre-tool-guard', toolName, 'block', validation.warnings.join('; '));
-  } else if (validation.warnings.length > 0) {
-    logHookDecision('pre-tool-guard', toolName, 'warn', validation.warnings.join('; '));
-  }
-
-  // Exit code: 0 = allowed, 2 = denied (claw-code 규약)
-  return validation.allowed ? 0 : 2;
-}
-
-// standalone CLI 모드: stdin JSON 우선, argv 폴백
-if (isDirectRun(import.meta.url)) {
-  process.exit(await run(buildCliCtx()));
-}

package/hooks/scripts/prompt-dispatcher.js

@@ -1,237 +0,0 @@
-#!/usr/bin/env node
-/**
- * UserPromptSubmit 디스패처
- *
- * UserPromptSubmit은 matcher를 지원하지 않아 모든 hook이 매번 실행됨.
- * 이 디스패처가 stdin에서 prompt를 읽고, 패턴 매칭 후 해당 스크립트만 실행.
- *
- * 이점:
- * - 외부 LLM 호출(GPT/Antigravity)이 패턴 매칭 없이 발동하지 않음
- * - context window에 불필요한 응답이 주입되지 않음
- * - 단일 프로세스에서 매칭 후 필요한 스크립트만 fork
- */
-import { execFile } from 'child_process';
-import { fileURLToPath } from 'url';
-import path from 'path';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-// 하네스 노이즈 억제 — 비동기 체인/setImmediate 내부에서 unhandledRejection이 발생해도
-// UserPromptSubmit 훅이 "failed (exit 1)"로 표시되지 않도록 한다.
-process.on('unhandledRejection', () => { /* swallow */ });
-process.on('uncaughtException', () => { /* swallow */ });
-
-// 재귀 가드 — 자식 Claude 세션에서 이 hook이 다시 실행되는 것 차단.
-// llm-orchestrate.js의 callClaudeCli가 VIBE_HOOK_DEPTH=1을 주입하므로,
-// 값이 있으면 즉시 종료해 프로세스 폭탄을 막는다.
-if (process.env.VIBE_HOOK_DEPTH) process.exit(0);
-
-// stdin에서 prompt 읽기
-let inputData = '';
-for await (const chunk of process.stdin) {
-  inputData += chunk;
-}
-
-let prompt = '';
-try {
-  const parsed = JSON.parse(inputData);
-  prompt = parsed.prompt || '';
-} catch {
-  process.exit(0);
-}
-
-if (!prompt) process.exit(0);
-
-// vibe.run 감지 — runStarted 기록 및 verifyPassed 리셋 (in-process, stdout 없음).
-{
-  const { isVibeRunPrompt, extractRunFeature, recordRunStart } = await import('./lib/run-ledger.js');
-  if (isVibeRunPrompt(prompt)) {
-    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-    const feature = extractRunFeature(prompt);
-    recordRunStart(projectDir, feature);
-  }
-}
-
-// 레거시 SSOT 통합 — `/vibe.*` 진입 시 `.claude/vibe/` → `.vibe/` 자동 이동.
-// `vibe init`/`update` 와 동일한 `consolidateLegacyVibe` (dist/cli/setup/LegacyMigration.js) 를 직접 재사용. Idempotent.
-if (/^\s*\/vibe\b/i.test(prompt)) {
-  try {
-    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-    const utils = await import('./utils.js');
-    const CLI_BASE = utils.getCliBaseUrl();
-    const { consolidateLegacyVibe } = await import(`${CLI_BASE}setup/LegacyMigration.js`);
-    const moved = consolidateLegacyVibe(projectDir);
-    if (moved.length > 0) {
-      process.stdout.write(`[vibe] Migrated legacy dirs → .vibe/ (${moved.join(', ')})\n`);
-    }
-  } catch { /* migration is best-effort */ }
-}
-
-// 패턴 → 실행할 스크립트 매핑
-// 각 항목: { pattern, script, args, label }
-// (참고: 매직 키워드 배너 주입(keyword-detector)은 제거됨 — deprecated 별칭
-//  매핑은 CLAUDE.md 의 "Deprecated aliases" 표가 SSOT이며 모델이 직접 해석한다.)
-const DISPATCH_RULES = [
-  // echo 전용 (stdout으로 직접 출력)
-  {
-    pattern: /e2e.*테스트|e2e.*test|playwright|브라우저.*테스트|browser.*test/i,
-    script: null,
-    echo: '[E2E MODE] Use /vibe.verify --e2e for Playwright-based browser testing. Supports visual regression and video recording.',
-    label: 'e2e-echo',
-  },
-
-  // 외부 LLM 호출 (GPT/Antigravity) — 명시적 provider 접두사 필수.
-  //
-  // 과거에는 "추론해", "코드 리뷰", "디버깅해" 같은 자연어 패턴이 prompt
-  // 어디서든 매칭되어, 평범한 한국어/영어 요청에도 외부 LLM이 동기로 spawn되고
-  // 그 응답이 컨텍스트에 주입되었다(컨텍스트 오염 + 최대 30s 블로킹).
-  // 이제는 prompt가 `gpt`/`agy`/`antigravity` 로 **시작**할 때만 발동한다.
-  // 즉 사용자가 외부 LLM을 콕 집어 부를 때만 동작하고, 일상 요청엔 걸리지 않는다.
-  // (참고: `/vibe.reason` 스킬이 일반 추론을 담당하므로 자연어 자동호출은 불필요)
-  // `s` 플래그(dotAll)로 여러 줄 prompt 의 역할 키워드도 매칭한다.
-  {
-    pattern: /^\s*gpt\b.*(아키텍처|architecture|설계|구조)/is,
-    script: 'llm-orchestrate.js',
-    args: ['gpt', 'orchestrate', 'You are a software architect. Analyze and review the architecture.'],
-    label: 'gpt-architecture',
-  },
-  {
-    pattern: /^\s*(agy|antigravity)\b.*(ui|ux|디자인|design|사용자.*경험)/is,
-    script: 'llm-orchestrate.js',
-    args: ['antigravity', 'orchestrate', 'You are a UI/UX expert. Analyze and provide feedback.'],
-    label: 'antigravity-uiux',
-  },
-  {
-    pattern: /^\s*gpt\b.*(디버깅|debug|버그|bug)/is,
-    script: 'llm-orchestrate.js',
-    args: ['gpt', 'orchestrate', 'You are a debugging expert. Find bugs and suggest fixes.'],
-    label: 'gpt-debug',
-  },
-  {
-    pattern: /^\s*(agy|antigravity)\b.*(분석|analyz|코드.*품질|code.*quality)/is,
-    script: 'llm-orchestrate.js',
-    args: ['antigravity', 'orchestrate', 'You are a code analysis expert. Review and analyze the code.'],
-    label: 'antigravity-analysis',
-  },
-  {
-    pattern: /^\s*gpt\b.*(리뷰|review)/is,
-    script: 'llm-orchestrate.js',
-    args: ['gpt', 'orchestrate', 'You are a code review expert. Review the code for best practices, security, and performance.'],
-    label: 'gpt-codereview',
-  },
-  {
-    pattern: /^\s*gpt\b.*(추론|reasoning|복잡.*분석|deep.*analysis)/is,
-    script: 'llm-orchestrate.js',
-    args: ['gpt', 'orchestrate', 'You are a reasoning expert. Analyze the problem deeply and provide detailed reasoning.'],
-    label: 'gpt-reasoning',
-  },
-
-  // 테스트용
-  {
-    pattern: /^test-gpt/i,
-    script: 'llm-orchestrate.js',
-    args: ['gpt', 'orchestrate', 'You are a helpful assistant. Answer the user\'s question clearly and concisely.'],
-    label: 'test-gpt',
-  },
-  {
-    pattern: /^test-(antigravity|agy)/i,
-    script: 'llm-orchestrate.js',
-    args: ['antigravity', 'orchestrate', 'You are a helpful assistant. Answer the user\'s question clearly and concisely.'],
-    label: 'test-antigravity',
-  },
-];
-
-// 매칭된 스크립트 실행
-const execPromises = [];
-
-for (const rule of DISPATCH_RULES) {
-  if (rule.label === 'skip') continue;
-
-  // pattern이 null이면 항상 실행, 아니면 매칭 확인
-  if (rule.pattern !== null && !rule.pattern.test(prompt)) continue;
-
-  // echo 규칙: 직접 stdout 출력
-  if (rule.echo) {
-    process.stdout.write(rule.echo + '\n');
-    continue;
-  }
-
-  if (!rule.script) continue;
-
-  const scriptPath = path.join(__dirname, rule.script);
-  const args = rule.args || [];
-
-  // 외부 LLM 호출(llm-orchestrate)은 부모/자식 timeout 을 정합시킨다 (B-2):
-  // 자식은 hook 모드(primary 45s, fallback 없음, retry 없음)로 단일 시도 후 스스로
-  // 정리하고, 부모는 그보다 약간 긴 50s 로 감싸 hard-kill 을 피한다.
-  // 경량 스크립트는 기존 30s 유지.
-  const isLlm = rule.script === 'llm-orchestrate.js';
-  const execTimeout = isLlm ? 50000 : 30000;
-  const childEnv = isLlm
-    ? { ...process.env, VIBE_LLM_HOOK_MODE: '1', VIBE_LLM_PRIMARY_TIMEOUT_MS: '45000', VIBE_LLM_MAX_RETRIES: '1' }
-    : { ...process.env };
-
-  execPromises.push(
-    new Promise((resolve) => {
-      execFile('node', [scriptPath, ...args], {
-        timeout: execTimeout,
-        env: childEnv,
-      }, (error, stdout, stderr) => {
-        if (stdout?.trim()) {
-          process.stdout.write(stdout);
-        } else if (error) {
-          // 무음실패 방지 — 외부 LLM 호출이 timeout 또는 에러로 결과 없이 죽을 때,
-          // 사용자가 원인을 알 수 있도록 한 줄만 노출한다.
-          const reason = error.killed ? `timed out (${execTimeout / 1000}s)` : (error.message || 'failed');
-          process.stdout.write(`[${rule.label}] external LLM call ${reason} — no result injected.\n`);
-        }
-        resolve();
-      });
-    })
-  );
-}
-
-await Promise.all(execPromises);
-
-// Evolution: Gap detection — log unmatched prompts for skill gap analysis
-const matched = DISPATCH_RULES.some(r =>
-  r.pattern !== null && r.pattern.test(prompt) &&
-  (r.script || r.echo)
-);
-
-if (!matched) {
-  setImmediate(async () => {
-    try {
-      const utils = await import('./utils.js');
-      const projectDir = process.env.CLAUDE_PROJECT_DIR || '.';
-      const configPath = utils.projectVibePath(projectDir, 'config.json');
-      // Evolution 은 동결(opt-in) — evolution.enabled === true 로 명시했을 때만
-      // gap 로깅을 수행한다 (기본 OFF, P3-3).
-      let gapEnabled = false;
-      try {
-        const fs = await import('fs');
-        if (fs.existsSync(configPath)) {
-          const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-          gapEnabled = config.evolution?.enabled === true && config.evolution?.gapDetection !== false;
-        }
-      } catch { /* ignore */ }
-
-      if (gapEnabled) {
-        const LIB_BASE = utils.getLibBaseUrl();
-        const [memMod, gapMod] = await Promise.all([
-          import(`${LIB_BASE}memory/MemoryStorage.js`),
-          import(`${LIB_BASE}evolution/SkillGapDetector.js`),
-        ]);
-        const storage = new memMod.MemoryStorage(projectDir);
-        const detector = new gapMod.SkillGapDetector(storage);
-        detector.logMiss(prompt.slice(0, 200));
-        storage.close();
-      }
-    } catch (e) {
-      process.stderr.write(`[Evolution] Gap log error: ${e.message}\n`);
-    }
-  });
-}
-
-// 명시적 성공 종료 — 하네스에 exit 1로 비치지 않도록.
-process.exit(0);