@su-record/vibe 2.9.32 → 2.9.34

package/hooks/scripts/keyword-detector.js

@@ -1,214 +1,214 @@
-#!/usr/bin/env node
-/**
- * Keyword Detector & Combiner
- * 매직 키워드 감지 및 조합 처리
- */
-
-import { VIBE_PATH, PROJECT_DIR } from './utils.js';
-
-// 매직 키워드 정의
-const MAGIC_KEYWORDS = {
-  // 지속성 모드 (완료까지 계속)
-  ralph: {
-    name: 'Ralph Loop',
-    description: 'Continue until task is verified complete',
-    flags: ['persistence', 'verification'],
-    output: '[RALPH MODE] Self-referential completion loop activated. Will continue until ALL tasks verified complete. NO early stopping.',
-  },
-
-  // 울트라워크 모드 (병렬 + 자동 계속)
-  ultrawork: {
-    name: 'Ultrawork',
-    description: 'Maximum parallel execution, no pause',
-    flags: ['parallel', 'auto_continue', 'no_confirmation'],
-    output: '[ULTRAWORK MODE] Use PARALLEL Task calls. Auto-continue through ALL phases. Auto-retry on errors up to 3 times. Do NOT ask for confirmation between phases.',
-  },
-  ulw: {
-    alias: 'ultrawork',
-  },
-  울트라워크: {
-    alias: 'ultrawork',
-  },
-
-  // 계획 모드
-  plan: {
-    name: 'Plan Mode',
-    description: 'Planning interview mode',
-    flags: ['planning', 'interview'],
-    output: '[PLAN MODE] Enter planning interview mode. Gather requirements before implementation.',
-  },
-
-  // Ralph + Plan 조합
-  ralplan: {
-    name: 'Ralph Plan',
-    description: 'Iterative planning with persistence',
-    flags: ['persistence', 'planning', 'iteration'],
-    output: '[RALPLAN MODE] Iterative planning with consensus. Will refine plan until approved, then execute with Ralph persistence.',
-  },
-
-  // 검증 모드
-  verify: {
-    name: 'Verify Mode',
-    description: 'Strict verification after each step',
-    flags: ['verification', 'strict'],
-    output: '[VERIFY MODE] Strict verification enabled. Every change must be verified before proceeding.',
-  },
-
-  // 탐색 모드
-  explore: {
-    name: 'Explore Mode',
-    description: 'Deep codebase exploration',
-    flags: ['exploration', 'thorough'],
-    output: '[EXPLORE MODE] Deep exploration enabled. Use multiple Explore agents for thorough codebase analysis.',
-  },
-
-  // 빠른 모드
-  quick: {
-    name: 'Quick Mode',
-    description: 'Fast execution, minimal verification',
-    flags: ['fast', 'minimal_verification'],
-    output: '[QUICK MODE] Fast execution mode. Minimal verification, single round reviews.',
-  },
-};
-
-// 키워드 조합 시너지
-const KEYWORD_SYNERGIES = {
-  'ralph+ultrawork': {
-    name: 'Ralph Ultrawork',
-    output: '[RALPH+ULTRAWORK] Maximum persistence AND parallel execution. Will NOT stop until ALL phases complete with verification.',
-  },
-  'ralph+verify': {
-    name: 'Ralph Verify',
-    output: '[RALPH+VERIFY] Persistent completion with strict verification at each step.',
-  },
-  'ultrawork+explore': {
-    name: 'Ultrawork Explore',
-    output: '[ULTRAWORK+EXPLORE] Parallel exploration agents for maximum coverage.',
-  },
-};
-
-/**
- * 텍스트에서 키워드 추출
- */
-function detectKeywords(text) {
-  const lowerText = text.toLowerCase();
-  const detected = [];
-  const resolvedKeywords = new Map();
-
-  for (const [keyword, config] of Object.entries(MAGIC_KEYWORDS)) {
-    // 키워드 매칭 (단어 경계)
-    const regex = new RegExp(`\\b${keyword}\\b`, 'i');
-    if (regex.test(lowerText)) {
-      // alias 해결
-      const resolved = config.alias ? MAGIC_KEYWORDS[config.alias] : config;
-      const resolvedName = config.alias || keyword;
-
-      if (!resolvedKeywords.has(resolvedName)) {
-        resolvedKeywords.set(resolvedName, resolved);
-        detected.push({
-          keyword: resolvedName,
-          original: keyword,
-          ...resolved,
-        });
-      }
-    }
-  }
-
-  return detected;
-}
-
-/**
- * 키워드 조합 처리
- */
-function processCombinations(detected) {
-  if (detected.length <= 1) {
-    return null;
-  }
-
-  // 키워드 이름 정렬하여 조합 키 생성
-  const keywordNames = detected.map(d => d.keyword).sort();
-
-  // 모든 2-조합 확인
-  for (let i = 0; i < keywordNames.length; i++) {
-    for (let j = i + 1; j < keywordNames.length; j++) {
-      const comboKey = `${keywordNames[i]}+${keywordNames[j]}`;
-      if (KEYWORD_SYNERGIES[comboKey]) {
-        return KEYWORD_SYNERGIES[comboKey];
-      }
-    }
-  }
-
-  return null;
-}
-
-/**
- * 모든 플래그 수집
- */
-function collectFlags(detected) {
-  const flags = new Set();
-  for (const d of detected) {
-    if (d.flags) {
-      d.flags.forEach(f => flags.add(f));
-    }
-  }
-  return Array.from(flags);
-}
-
-/**
- * 출력 생성
- */
-function generateOutput(detected, combination) {
-  const outputs = [];
-
-  // 시너지 조합 우선
-  if (combination) {
-    outputs.push(combination.output);
-  } else {
-    // 개별 키워드 출력
-    for (const d of detected) {
-      if (d.output) {
-        outputs.push(d.output);
-      }
-    }
-  }
-
-  // 모든 플래그 수집
-  const flags = collectFlags(detected);
-  if (flags.length > 0) {
-    outputs.push(`[FLAGS] ${flags.join(', ')}`);
-  }
-
-  return outputs.join('\n');
-}
-
-// 메인 실행
-const input = process.argv.slice(2).join(' ') || process.env.USER_PROMPT || '';
-
-if (!input) {
-  console.log(`
-VIBE Keyword Detector
-
-Available magic keywords:
-${Object.entries(MAGIC_KEYWORDS)
-  .filter(([_, v]) => !v.alias)
-  .map(([k, v]) => `  ${k.padEnd(12)} - ${v.description}`)
-  .join('\n')}
-
-Keyword combinations:
-${Object.entries(KEYWORD_SYNERGIES)
-  .map(([k, v]) => `  ${k.padEnd(20)} - ${v.name}`)
-  .join('\n')}
-
-Usage:
-  node keyword-detector.js "implement login ralph ultrawork"
-  `);
-  process.exit(0);
-}
-
-const detected = detectKeywords(input);
-
-if (detected.length > 0) {
-  const combination = processCombinations(detected);
-  const output = generateOutput(detected, combination);
-  console.log(output);
-}
+#!/usr/bin/env node
+/**
+ * Keyword Detector & Combiner
+ * 매직 키워드 감지 및 조합 처리
+ */
+
+import { VIBE_PATH, PROJECT_DIR } from './utils.js';
+
+// 매직 키워드 정의
+const MAGIC_KEYWORDS = {
+  // 지속성 모드 (완료까지 계속)
+  ralph: {
+    name: 'Ralph Loop',
+    description: 'Continue until task is verified complete',
+    flags: ['persistence', 'verification'],
+    output: '[RALPH MODE] Self-referential completion loop activated. Will continue until ALL tasks verified complete. NO early stopping.',
+  },
+
+  // 울트라워크 모드 (병렬 + 자동 계속)
+  ultrawork: {
+    name: 'Ultrawork',
+    description: 'Maximum parallel execution, no pause',
+    flags: ['parallel', 'auto_continue', 'no_confirmation'],
+    output: '[ULTRAWORK MODE] Use PARALLEL Task calls. Auto-continue through ALL phases. Auto-retry on errors up to 3 times. Do NOT ask for confirmation between phases.',
+  },
+  ulw: {
+    alias: 'ultrawork',
+  },
+  울트라워크: {
+    alias: 'ultrawork',
+  },
+
+  // 계획 모드
+  plan: {
+    name: 'Plan Mode',
+    description: 'Planning interview mode',
+    flags: ['planning', 'interview'],
+    output: '[PLAN MODE] Enter planning interview mode. Gather requirements before implementation.',
+  },
+
+  // Ralph + Plan 조합
+  ralplan: {
+    name: 'Ralph Plan',
+    description: 'Iterative planning with persistence',
+    flags: ['persistence', 'planning', 'iteration'],
+    output: '[RALPLAN MODE] Iterative planning with consensus. Will refine plan until approved, then execute with Ralph persistence.',
+  },
+
+  // 검증 모드
+  verify: {
+    name: 'Verify Mode',
+    description: 'Strict verification after each step',
+    flags: ['verification', 'strict'],
+    output: '[VERIFY MODE] Strict verification enabled. Every change must be verified before proceeding.',
+  },
+
+  // 탐색 모드
+  explore: {
+    name: 'Explore Mode',
+    description: 'Deep codebase exploration',
+    flags: ['exploration', 'thorough'],
+    output: '[EXPLORE MODE] Deep exploration enabled. Use multiple Explore agents for thorough codebase analysis.',
+  },
+
+  // 빠른 모드
+  quick: {
+    name: 'Quick Mode',
+    description: 'Fast execution, minimal verification',
+    flags: ['fast', 'minimal_verification'],
+    output: '[QUICK MODE] Fast execution mode. Minimal verification, single round reviews.',
+  },
+};
+
+// 키워드 조합 시너지
+const KEYWORD_SYNERGIES = {
+  'ralph+ultrawork': {
+    name: 'Ralph Ultrawork',
+    output: '[RALPH+ULTRAWORK] Maximum persistence AND parallel execution. Will NOT stop until ALL phases complete with verification.',
+  },
+  'ralph+verify': {
+    name: 'Ralph Verify',
+    output: '[RALPH+VERIFY] Persistent completion with strict verification at each step.',
+  },
+  'ultrawork+explore': {
+    name: 'Ultrawork Explore',
+    output: '[ULTRAWORK+EXPLORE] Parallel exploration agents for maximum coverage.',
+  },
+};
+
+/**
+ * 텍스트에서 키워드 추출
+ */
+function detectKeywords(text) {
+  const lowerText = text.toLowerCase();
+  const detected = [];
+  const resolvedKeywords = new Map();
+
+  for (const [keyword, config] of Object.entries(MAGIC_KEYWORDS)) {
+    // 키워드 매칭 (단어 경계)
+    const regex = new RegExp(`\\b${keyword}\\b`, 'i');
+    if (regex.test(lowerText)) {
+      // alias 해결
+      const resolved = config.alias ? MAGIC_KEYWORDS[config.alias] : config;
+      const resolvedName = config.alias || keyword;
+
+      if (!resolvedKeywords.has(resolvedName)) {
+        resolvedKeywords.set(resolvedName, resolved);
+        detected.push({
+          keyword: resolvedName,
+          original: keyword,
+          ...resolved,
+        });
+      }
+    }
+  }
+
+  return detected;
+}
+
+/**
+ * 키워드 조합 처리
+ */
+function processCombinations(detected) {
+  if (detected.length <= 1) {
+    return null;
+  }
+
+  // 키워드 이름 정렬하여 조합 키 생성
+  const keywordNames = detected.map(d => d.keyword).sort();
+
+  // 모든 2-조합 확인
+  for (let i = 0; i < keywordNames.length; i++) {
+    for (let j = i + 1; j < keywordNames.length; j++) {
+      const comboKey = `${keywordNames[i]}+${keywordNames[j]}`;
+      if (KEYWORD_SYNERGIES[comboKey]) {
+        return KEYWORD_SYNERGIES[comboKey];
+      }
+    }
+  }
+
+  return null;
+}
+
+/**
+ * 모든 플래그 수집
+ */
+function collectFlags(detected) {
+  const flags = new Set();
+  for (const d of detected) {
+    if (d.flags) {
+      d.flags.forEach(f => flags.add(f));
+    }
+  }
+  return Array.from(flags);
+}
+
+/**
+ * 출력 생성
+ */
+function generateOutput(detected, combination) {
+  const outputs = [];
+
+  // 시너지 조합 우선
+  if (combination) {
+    outputs.push(combination.output);
+  } else {
+    // 개별 키워드 출력
+    for (const d of detected) {
+      if (d.output) {
+        outputs.push(d.output);
+      }
+    }
+  }
+
+  // 모든 플래그 수집
+  const flags = collectFlags(detected);
+  if (flags.length > 0) {
+    outputs.push(`[FLAGS] ${flags.join(', ')}`);
+  }
+
+  return outputs.join('\n');
+}
+
+// 메인 실행
+const input = process.argv.slice(2).join(' ') || process.env.USER_PROMPT || '';
+
+if (!input) {
+  console.log(`
+VIBE Keyword Detector
+
+Available magic keywords:
+${Object.entries(MAGIC_KEYWORDS)
+  .filter(([_, v]) => !v.alias)
+  .map(([k, v]) => `  ${k.padEnd(12)} - ${v.description}`)
+  .join('\n')}
+
+Keyword combinations:
+${Object.entries(KEYWORD_SYNERGIES)
+  .map(([k, v]) => `  ${k.padEnd(20)} - ${v.name}`)
+  .join('\n')}
+
+Usage:
+  node keyword-detector.js "implement login ralph ultrawork"
+  `);
+  process.exit(0);
+}
+
+const detected = detectKeywords(input);
+
+if (detected.length > 0) {
+  const combination = processCombinations(detected);
+  const output = generateOutput(detected, combination);
+  console.log(output);
+}

package/hooks/scripts/lib/dispatcher.js

@@ -1,87 +1,95 @@
-/**
- * Hook dispatcher library — 여러 hook script를 단일 이벤트에서 직렬 실행.
- *
- * 목적:
- * - 동일 이벤트에 등록된 N개 스크립트의 **병렬 spawn 폭주**를 순차화
- * - stdin을 한 번만 읽어 각 자식에 그대로 pipe (중복 파싱/읽기 방지)
- * - config.hooks[name].enabled 로 개별 토글
- * - 한 스크립트 실패가 다음 실행을 막지 않도록 cascade 격리
- * - PreToolUse 계열: 자식이 exit 2(deny)면 즉시 상위에 전파
- */
-import { spawn } from 'child_process';
-import path from 'path';
-import fs from 'fs';
-import { fileURLToPath } from 'url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SCRIPTS_DIR = path.resolve(__dirname, '..');
-
-function loadHookConfig() {
-  try {
-    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.COCO_PROJECT_DIR || process.cwd();
-    // Vibe config 탐색 — `.vibe/` 를 SSOT 로 삼고, legacy `.claude/vibe/`, `.coco/vibe/` fallback
-    const candidates = [
-      path.join(projectDir, '.vibe', 'config.json'),
-      path.join(projectDir, '.claude', 'vibe', 'config.json'),
-      path.join(projectDir, '.coco', 'vibe', 'config.json'),
-    ];
-    const configPath = candidates.find(p => fs.existsSync(p));
-    if (!configPath) return {};
-    return JSON.parse(fs.readFileSync(configPath, 'utf-8')).hooks || {};
-  } catch {
-    return {};
-  }
-}
-
-function isEnabled(hookConfig, name) {
-  const entry = hookConfig[name];
-  if (entry && typeof entry === 'object' && entry.enabled === false) return false;
-  return true;
-}
-
-async function readStdin() {
-  if (process.stdin.isTTY) return '';
-  let data = '';
-  for await (const chunk of process.stdin) data += chunk;
-  return data;
-}
-
-/**
- * 단일 스크립트 실행. stdin을 통해 입력 전달, stdout은 메인 stdout으로 통과.
- * @returns {Promise<number>} exit code
- */
-function runScript(scriptName, args, stdinData, timeoutMs) {
-  return new Promise((resolve) => {
-    const scriptPath = path.join(SCRIPTS_DIR, scriptName);
-    const proc = spawn(process.execPath, [scriptPath, ...args], {
-      stdio: ['pipe', 'inherit', 'inherit'],
-      timeout: timeoutMs,
-    });
-    if (stdinData) proc.stdin.end(stdinData);
-    else proc.stdin.end();
-    proc.on('close', (code) => resolve(code ?? 0));
-    proc.on('error', () => resolve(1));
-  });
-}
-
-/**
- * 디스패처 실행.
- * @param {Array<{name: string, script: string, args?: string[], denyOnExit2?: boolean, timeoutMs?: number}>} steps
- */
-export async function dispatch(steps) {
-  const stdinData = await readStdin();
-  const hookConfig = loadHookConfig();
-
-  for (const step of steps) {
-    if (!isEnabled(hookConfig, step.name)) continue;
-    const code = await runScript(
-      step.script,
-      step.args || [],
-      stdinData,
-      step.timeoutMs || 30000
-    );
-    if (step.denyOnExit2 && code === 2) {
-      process.exit(2);
-    }
-  }
-}
+/**
+ * Hook dispatcher library — 여러 hook script를 단일 이벤트에서 병렬 실행.
+ *
+ * 목적:
+ * - stdin을 한 번만 읽어 각 자식에 동일 버퍼로 pipe (중복 파싱/읽기 방지)
+ * - config.hooks[name].enabled 로 개별 토글
+ * - 한 스크립트 실패가 다른 스크립트를 막지 않도록 cascade 격리
+ * - PreToolUse 계열: 자식 중 하나라도 exit 2(deny)면 상위에 전파
+ *
+ * 직렬 → 병렬 전환 (2026-04):
+ *   기존 직렬 실행은 tool당 150~300ms 누적 오버헤드를 유발.
+ *   PreToolUse 가드는 모두 독립적 검증자이므로 병렬화해도 의미상 문제 없음.
+ *   트레이드오프:
+ *     - early-deny 낭비: sentinel-guard가 block이어도 pre-tool/scope-guard가
+ *       이미 spawn됨. 실측 μs 수준이라 무시.
+ *     - stderr 인터리빙: 가드 2개가 동시 block 시 경고 메시지가 섞일 수 있음.
+ *       각 메시지는 자체적으로 완결된 라인이라 가독성 문제 없음.
+ */
+import { spawn } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const SCRIPTS_DIR = path.resolve(__dirname, '..');
+
+function loadHookConfig() {
+  try {
+    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.COCO_PROJECT_DIR || process.cwd();
+    // Vibe config 탐색 — `.vibe/` 를 SSOT 로 삼고, legacy `.claude/vibe/`, `.coco/vibe/` fallback
+    const candidates = [
+      path.join(projectDir, '.vibe', 'config.json'),
+      path.join(projectDir, '.claude', 'vibe', 'config.json'),
+      path.join(projectDir, '.coco', 'vibe', 'config.json'),
+    ];
+    const configPath = candidates.find(p => fs.existsSync(p));
+    if (!configPath) return {};
+    return JSON.parse(fs.readFileSync(configPath, 'utf-8')).hooks || {};
+  } catch {
+    return {};
+  }
+}
+
+function isEnabled(hookConfig, name) {
+  const entry = hookConfig[name];
+  if (entry && typeof entry === 'object' && entry.enabled === false) return false;
+  return true;
+}
+
+async function readStdin() {
+  if (process.stdin.isTTY) return '';
+  let data = '';
+  for await (const chunk of process.stdin) data += chunk;
+  return data;
+}
+
+/**
+ * 단일 스크립트 실행. stdin을 통해 입력 전달, stdout은 메인 stdout으로 통과.
+ * @returns {Promise<number>} exit code
+ */
+function runScript(scriptName, args, stdinData, timeoutMs) {
+  return new Promise((resolve) => {
+    const scriptPath = path.join(SCRIPTS_DIR, scriptName);
+    const proc = spawn(process.execPath, [scriptPath, ...args], {
+      stdio: ['pipe', 'inherit', 'inherit'],
+      timeout: timeoutMs,
+    });
+    if (stdinData) proc.stdin.end(stdinData);
+    else proc.stdin.end();
+    proc.on('close', (code) => resolve(code ?? 0));
+    proc.on('error', () => resolve(1));
+  });
+}
+
+/**
+ * 디스패처 실행 — 활성화된 스텝을 병렬로 spawn.
+ * @param {Array<{name: string, script: string, args?: string[], denyOnExit2?: boolean, timeoutMs?: number}>} steps
+ */
+export async function dispatch(steps) {
+  const stdinData = await readStdin();
+  const hookConfig = loadHookConfig();
+
+  const enabledSteps = steps.filter(s => isEnabled(hookConfig, s.name));
+  const results = await Promise.all(
+    enabledSteps.map(step =>
+      runScript(step.script, step.args || [], stdinData, step.timeoutMs || 30000)
+        .then(code => ({ step, code }))
+    )
+  );
+
+  // 하나라도 deny(exit 2) 반환 → 상위에 전파
+  if (results.some(({ step, code }) => step.denyOnExit2 && code === 2)) {
+    process.exit(2);
+  }
+}