@su-record/vibe 2.8.41 → 2.8.44

package/dist/infra/lib/evolution/HookTraceReader.js

@@ -0,0 +1,108 @@
+// HookTraceReader — JSONL hook trace 파일 읽기 및 집계
+// Guard hooks가 ~/.vibe/hook-traces.jsonl에 기록한 로그를 읽고 분석
+import { readFileSync, existsSync } from 'fs';
+import path from 'path';
+import os from 'os';
+const TRACE_FILENAME = 'hook-traces.jsonl';
+const MIN_CLUSTER_SIZE = 3;
+/**
+ * hook-traces.jsonl 파일 경로 반환
+ */
+function getTracePath() {
+    const home = os.homedir();
+    return path.join(home, '.vibe', TRACE_FILENAME);
+}
+/**
+ * JSONL 파일에서 최근 N일간 trace 항목 읽기
+ */
+export function readTraces(daysBack = 7) {
+    const tracePath = getTracePath();
+    if (!existsSync(tracePath))
+        return [];
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - daysBack);
+    const cutoffIso = cutoff.toISOString();
+    const raw = readFileSync(tracePath, 'utf-8');
+    const traces = [];
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            if (entry.ts >= cutoffIso) {
+                traces.push(entry);
+            }
+        }
+        catch {
+            // 깨진 줄 무시
+        }
+    }
+    return traces;
+}
+/**
+ * 사유 문자열을 정규화 (파일 경로, 명령어 세부 사항 제거)
+ */
+function normalizeReason(reason) {
+    return reason
+        .replace(/\/[\w/._-]+/g, '<path>')
+        .replace(/`[^`]+`/g, '<cmd>')
+        .replace(/:\s+.*$/, '')
+        .trim();
+}
+/**
+ * Trace 목록을 패턴별로 클러스터링
+ */
+export function clusterTraces(traces) {
+    const actionable = traces.filter(t => t.decision !== 'allow');
+    const groups = new Map();
+    for (const trace of actionable) {
+        const key = `${trace.hook}:${normalizeReason(trace.reason)}`;
+        const group = groups.get(key) ?? [];
+        group.push(trace);
+        groups.set(key, group);
+    }
+    const clusters = [];
+    for (const [, group] of groups) {
+        if (group.length < MIN_CLUSTER_SIZE)
+            continue;
+        const sorted = group.sort((a, b) => a.ts.localeCompare(b.ts));
+        const tools = [...new Set(group.map(t => t.tool))];
+        clusters.push({
+            pattern: normalizeReason(group[0].reason),
+            hook: group[0].hook,
+            decision: group[0].decision,
+            count: group.length,
+            tools,
+            firstSeen: sorted[0].ts,
+            lastSeen: sorted[sorted.length - 1].ts,
+        });
+    }
+    return clusters.sort((a, b) => b.count - a.count);
+}
+/**
+ * 전체 통계 + 클러스터 분석 수행
+ */
+export function analyzeTraces(daysBack = 7) {
+    const traces = readTraces(daysBack);
+    const byHook = {};
+    const byTool = {};
+    let blockCount = 0;
+    let warnCount = 0;
+    for (const t of traces) {
+        byHook[t.hook] = (byHook[t.hook] ?? 0) + 1;
+        byTool[t.tool] = (byTool[t.tool] ?? 0) + 1;
+        if (t.decision === 'block')
+            blockCount++;
+        if (t.decision === 'warn')
+            warnCount++;
+    }
+    return {
+        totalTraces: traces.length,
+        blockCount,
+        warnCount,
+        byHook,
+        byTool,
+        clusters: clusterTraces(traces),
+    };
+}
+//# sourceMappingURL=HookTraceReader.js.map

package/dist/infra/lib/evolution/HookTraceReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookTraceReader.js","sourceRoot":"","sources":["../../../../src/infra/lib/evolution/HookTraceReader.ts"],"names":[],"mappings":"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"}

package/dist/infra/lib/evolution/index.d.ts

@@ -32,4 +32,8 @@ export { DeprecationDetector } from './DeprecationDetector.js';
 export type { DeprecationCandidate, DeprecationReport } from './DeprecationDetector.js';
 export { ParityTester, PARITY_THRESHOLDS } from './ParityTester.js';
 export type { ParityTestResult, ModelVersion, EvalComparison } from './ParityTester.js';
+export { readTraces, clusterTraces, analyzeTraces } from './HookTraceReader.js';
+export type { HookTrace, TraceCluster, TraceStats } from './HookTraceReader.js';
+export { GuardAnalyzer } from './GuardAnalyzer.js';
+export type { GuardAnalysisResult } from './GuardAnalyzer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/infra/lib/evolution/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/infra/lib/evolution/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGnH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAC3D,UAAU,EAAE,YAAY,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,GAC3E,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,GAC3E,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGxF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/infra/lib/evolution/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGnH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAC3D,UAAU,EAAE,YAAY,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,GAC3E,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,GAC3E,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGxF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChF,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/infra/lib/evolution/index.js

@@ -26,4 +26,7 @@ export { DescriptionOptimizer } from './DescriptionOptimizer.js';
 export { DeprecationDetector } from './DeprecationDetector.js';
 // Phase 5b: Model Parity Testing
 export { ParityTester, PARITY_THRESHOLDS } from './ParityTester.js';
+// Phase 6: Harness Self-Improvement (Hook Trace Analysis)
+export { readTraces, clusterTraces, analyzeTraces } from './HookTraceReader.js';
+export { GuardAnalyzer } from './GuardAnalyzer.js';
 //# sourceMappingURL=index.js.map

package/dist/infra/lib/evolution/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/infra/lib/evolution/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,2BAA2B;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,2BAA2B;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,kCAAkC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/infra/lib/evolution/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,2BAA2B;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,2BAA2B;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,kCAAkC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGpE,0DAA0D;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/hooks/scripts/evolution-engine.js

@@ -39,7 +39,29 @@ async function main() {
       const extractor = new extractorMod.InsightExtractor(storage);
       const extractResult = extractor.extractFromRecent(20);
 
-      if (extractResult.newInsights.length === 0 && extractResult.mergedInsights.length === 0) {
+      // Phase 2b: Guard trace 분석 (하네스 자기 개선)
+      let guardInsightCount = 0;
+      try {
+        const guardMod = await import(`${LIB_BASE}evolution/GuardAnalyzer.js`);
+        const insightMod = await import(`${LIB_BASE}evolution/InsightStore.js`);
+        const insightStore = new insightMod.InsightStore(storage);
+        const guardAnalyzer = new guardMod.GuardAnalyzer(insightStore);
+        const guardResult = guardAnalyzer.analyze(7);
+        guardInsightCount = guardResult.newInsights.length;
+        if (guardInsightCount > 0) {
+          process.stderr.write(
+            `[Evolution] Guard analysis: ${guardInsightCount} new insights from hook traces\n`
+          );
+        }
+      } catch (e) {
+        process.stderr.write(`[Evolution] Guard analysis skipped: ${e.message}\n`);
+      }
+
+      if (
+        extractResult.newInsights.length === 0 &&
+        extractResult.mergedInsights.length === 0 &&
+        guardInsightCount === 0
+      ) {
         storage.close();
         return;
       }

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

@@ -139,6 +139,8 @@ const toolInput = stdinPayload?.tool_input
     : JSON.stringify(stdinPayload.tool_input))
   : (process.argv[3] || process.env.TOOL_INPUT || '');
 
+import { logHookDecision } from './utils.js';
+
 const validation = validateCommand(toolName, toolInput);
 const output = formatOutput(toolName, validation);
 
@@ -146,5 +148,12 @@ if (output) {
   console.log(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 규약), 1 = 레거시 호환
 process.exit(validation.allowed ? 0 : 2);

package/hooks/scripts/sentinel-guard.js

@@ -118,9 +118,12 @@ const toolInput = stdinPayload?.tool_input
     : JSON.stringify(stdinPayload.tool_input))
   : (process.argv[3] || process.env.TOOL_INPUT || '');
 
+import { logHookDecision } from './utils.js';
+
 const result = guard(toolName, toolInput);
 
 if (result) {
+  logHookDecision('sentinel-guard', toolName, 'block', result.reason);
   console.log(JSON.stringify(result));
   process.exit(2); // deny 규약
 }

package/hooks/scripts/utils.js

@@ -146,3 +146,41 @@ export function getToolsBaseUrl() {
 export function getLibBaseUrl() {
   return getPackageUrl(path.join('dist', 'infra', 'lib'), 'gpt-api.js');
 }
+
+// ─── Hook Trace Logging ───
+
+const HOOK_TRACE_PATH = path.join(VIBE_HOME_DIR, 'hook-traces.jsonl');
+const MAX_TRACE_SIZE_BYTES = 5 * 1024 * 1024; // 5MB rotation
+
+/**
+ * Guard/Hook 결정 사항을 JSONL로 로깅
+ * evolution GuardAnalyzer가 이 로그를 분석해 하네스 자기 개선에 활용
+ *
+ * @param {string} hookName - 훅 이름 (e.g., 'sentinel-guard', 'pre-tool-guard')
+ * @param {string} toolName - 대상 도구 (e.g., 'Bash', 'Write')
+ * @param {'allow'|'block'|'warn'} decision - 판정 결과
+ * @param {string} reason - 판정 사유
+ */
+export function logHookDecision(hookName, toolName, decision, reason) {
+  try {
+    // 로그 로테이션: 5MB 초과 시 이전 파일 교체
+    if (fs.existsSync(HOOK_TRACE_PATH)) {
+      const stat = fs.statSync(HOOK_TRACE_PATH);
+      if (stat.size > MAX_TRACE_SIZE_BYTES) {
+        const rotated = HOOK_TRACE_PATH + '.prev';
+        try { fs.unlinkSync(rotated); } catch { /* ignore */ }
+        fs.renameSync(HOOK_TRACE_PATH, rotated);
+      }
+    }
+
+    const entry = JSON.stringify({
+      ts: new Date().toISOString(),
+      hook: hookName,
+      tool: toolName,
+      decision,
+      reason,
+      project: PROJECT_DIR,
+    });
+    fs.appendFileSync(HOOK_TRACE_PATH, entry + '\n');
+  } catch { /* 트레이스 실패가 훅 실행을 방해해선 안 됨 */ }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "2.8.41",
+  "version": "2.8.44",
   "description": "AI Coding Framework for Claude Code — 56 agents, 45 skills, multi-LLM orchestration",
   "type": "module",
   "main": "dist/cli/index.js",

package/skills/chub-usage/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: chub-usage
+tier: optional
+description: "Context Hub (chub) — 검수된 최신 API 문서 조회. 외부 API/SDK 코드 작성 시 training data 대신 최신 문서를 기반으로 정확한 코드 작성."
+triggers: [chub, context hub, API docs, latest API, deprecated API, SDK documentation, api reference, 최신 문서]
+priority: 65
+---
+
+# Context Hub (chub) Usage
+
+외부 API/SDK 코드 작성 전 검수된 최신 문서를 가져오는 스킬.
+Training data의 지식 컷오프 문제를 해결합니다.
+
+## Why?
+
+| Problem | Solution |
+|---------|----------|
+| Training data에 의존 → deprecated API 사용 | chub get → 검수된 최신 문서 기반 코드 |
+| 웹 검색 → 노이즈 섞인 결과 | chub search → 큐레이션된 문서만 |
+| 세션마다 같은 실수 반복 | chub annotate → 학습 누적 |
+
+## Prerequisites
+
+```bash
+npm install -g @aisuite/chub
+```
+
+## When to Use
+
+| Situation | Example |
+|-----------|---------|
+| 외부 API 코드 작성 | "Stripe 결제 연동해줘" |
+| SDK 최신 버전 확인 | "OpenAI 최신 모델 호출" |
+| 공식 문서 필요 | "Supabase auth 설정" |
+| Deprecated 패턴 방지 | "Firebase v10 마이그레이션" |
+
+## Workflow
+
+```
+외부 API/SDK 코드 작성 요청
+    ↓
+Step 1: chub search "<라이브러리명>"
+    ↓
+Step 2: chub get <id> --lang ts
+    ↓
+Step 3: 문서 기반 코드 작성
+    ↓
+Step 4: gotcha 발견 시 chub annotate
+```
+
+## Usage
+
+### Step 1 — 문서 검색
+
+```bash
+chub search "stripe"
+chub search "openai"
+chub search ""           # 전체 목록 확인
+```
+
+### Step 2 — 최신 문서 fetch
+
+```bash
+chub get stripe/api --lang ts
+chub get openai/chat --lang py
+chub get supabase/auth --lang js
+```
+
+### Step 3 — 문서 기반 코드 작성
+
+fetch한 문서 내용을 기반으로 정확한 코드 작성.
+**절대 training data에 의존하지 않는다. 문서 먼저, 코드 나중.**
+
+### Step 4 — 학습 내용 기록
+
+작업 중 발견한 gotcha, workaround, 버전 이슈:
+
+```bash
+chub annotate stripe/api "한국 결제는 pg 파라미터 필수"
+chub annotate openai/chat "streaming에서 tool_calls는 delta로 옴"
+chub annotate firebase/auth "v10에서 getAuth() import 경로 변경"
+```
+
+Annotation은 로컬 저장, 다음 세션에서 `chub get` 시 자동으로 같이 나옴.
+
+## Implementation Pattern (Subagent)
+
+컨텍스트 블로트 방지를 위해 서브에이전트에서 실행:
+
+```
+Task tool call:
+- subagent_type: Explore
+- model: haiku
+- prompt: "Run `chub search <library>` then `chub get <id> --lang <lang>` to fetch latest API documentation for [topic]. Return only the relevant API usage examples, key changes from previous versions, and any annotations."
+```
+
+서브에이전트가 chub 호출을 처리하고 요약만 반환 → 메인 컨텍스트 깨끗하게 유지.
+
+## Supported APIs (1,000+)
+
+OpenAI, Anthropic, Stripe, Firebase, Supabase, Vercel, AWS S3, Cloudflare Workers, Auth0, Clerk 등.
+
+```bash
+chub search    # 인자 없이 실행하면 전체 목록 확인 가능
+```
+
+## Fallback Chain
+
+```
+chub 설치 안 됨
+    ↓
+Prompt: npm install -g @aisuite/chub
+    ↓
+If still unavailable: context7 또는 Web Search fallback
+```

package/skills/vibe.figma/SKILL.md

@@ -36,44 +36,44 @@ Figma 트리가 코드의 원천이다. 스크린샷은 검증용이다.
 
 ```
 /vibe.figma
+  입력: 모든 URL을 한번에 받는다
+    Storyboard: https://figma.com/...?node-id=aaa (있으면)
+    MO Design: https://figma.com/...?node-id=xxx
+    PC Design: https://figma.com/...?node-id=yyy (있으면)
+
   → Phase 0: Setup (스택 감지, 디렉토리 생성, 기존 자산 인덱싱)
   → Phase 1: Storyboard (스토리보드 → 기능 스펙 문서 작성, 파일 생성 없음)
-  → Phase 2: 재료 확보 (디자인 URL → 트리 + 노드 렌더링 이미지 + 스크린샷)
-  → Phase 3: 구조적 코드 생성 (트리 → HTML+SCSS 매핑 + 시맨틱 보강)
-  → Phase 3.5: 컴파일 게이트 (tsc → build → dev 확인)
-  → Phase 4: 시각 검증 루프 (렌더링 vs 스크린샷 비교 → 수정)
-  ─── 추가 브레이크포인트가 있으면 Phase 2~4 반복 ───
-  → Phase 5: 공통화 (브레이크포인트별 작업 병합 → 최종 프로젝트 구조)
-
-브레이크포인트별 작업 구조:
+  → Phase 2: 재료 확보 (모든 BP의 트리 + 노드 렌더링 이미지 + 스크린샷)
+  → Phase 3: 리매핑 (tree.json → remapped.json, BP 간 노드 매칭 + CSS diff)
+  → Phase 4: 순차 코드 생성 (remapped.json → 섹션별 HTML+SCSS)
+  → Phase 5: 컴파일 게이트 (tsc → build → dev 확인)
+  → Phase 6: 시각 검증 루프 (렌더링 vs 스크린샷 비교 → 수정)
+
+작업 디렉토리 구조:
   각 Figma URL의 ROOT name에서 폴더명 추출 (kebab-case):
     "MO_Main ..."  → /tmp/{feature}/mo-main/
     "PC_Main ..."  → /tmp/{feature}/pc-main/
 
   /tmp/{feature}/
-  ├── mo-main/              ← 첫 번째 URL (모바일)
-  │   ├── tree.json
-  │   ├── bg/
-  │   ├── content/
-  │   └── sections/
-  ├── pc-main/              ← 두 번째 URL (데스크탑)
+  ├── mo-main/              ← 모바일 Phase 2 추출 결과
   │   ├── tree.json
-  │   ├── bg/
-  │   ├── content/
-  │   └── sections/
-  └── final/                ← Phase 5 공통화 결과
-      ├── components/{feature}/
-      └── styles/{feature}/
+  │   ├── bg/               ← BG 프레임 렌더링
+  │   ├── content/          ← 콘텐츠 노드 렌더링
+  │   └── sections/         ← Phase 4 검증용 스크린샷
+  ├── pc-main/              ← 데스크탑 Phase 2 추출 결과
+  │   └── (동일 구조)
+  └── remapped.json         ← Phase 3 리매핑 결과 (모든 BP 통합)
+
+  remapped.json이 Phase 4의 유일한 입력.
+  → BP 간 노드 매칭 완료
+  → CSS diff (mo/pc) 포함
+  → 이미지 렌더링 파일 경로 포함
+  → Phase 4에서 바로 코드 생성 가능
 
-Phase 5 공통화:
-  1. 각 브레이크포인트의 컴포넌트 diff
-     → 구조 동일: 1개로 병합
-     → 구조 다름: props로 분기 또는 별도 유지
-  2. SCSS diff
-     → 같은 값: 기본 스타일
-     → 다른 값: @media 오버라이드
-  3. 토큰 diff → 합집합 정리
-  4. /tmp/ 임시 폴더 → 프로젝트 디렉토리에 최종 배치
+  코드 출력: 프로젝트 디렉토리에 직접 배치
+    components/{feature}/HeroSection.vue
+    styles/{feature}/layout/_hero.scss (모바일 기본 + @media PC)
+    styles/{feature}/components/_hero.scss
 ```
 
 ---
@@ -202,7 +202,7 @@ Phase 5 공통화:
 - question: "스토리보드 Figma URL을 입력해주세요. (없으면 '없음')"
 - options 제공 금지 — 자유 텍스트 입력만 허용
 
-"없음" 응답 시 → Phase 2로 건너뜀
+"없음" 응답 시 → 스토리보드 분석 스킵
 
 ### 1-1. 스토리보드 분석
 
@@ -238,8 +238,8 @@ URL에서 fileKey, nodeId 추출
 
 ```
 ❌ Phase 1에서 코드 파일을 생성하지 않는다.
-   → Phase 1 HTML 구조와 Phase 3 트리 매핑이 충돌하면 이중 작업
-   → Phase 3에서 tree.json 기반으로 코드를 생성
+   → Phase 1 HTML 구조와 Phase 4 트리 매핑이 충돌하면 이중 작업
+   → Phase 4에서 remapped.json 기반으로 코드를 생성
 
 ✅ Phase 1의 출력물은 기능 스펙 문서 (텍스트):
 
@@ -283,7 +283,7 @@ Phase 1 완료 조건:
   □ 공통 컴포넌트가 식별되어 있다
   □ 파일을 하나도 생성하지 않았다
 
-Phase 3에서 이 스펙 + tree.json을 합쳐서 코드를 생성한다.
+Phase 4에서 이 스펙 + remapped.json을 합쳐서 코드를 생성한다.
 ```
 
 ---
@@ -425,7 +425,7 @@ UI 요소 → vw 비례:
 
 ---
 
-## Phase 2.5: 공통 패턴 분석 (멀티 프레임 전용)
+## Phase 3: 리매핑 (tree.json → remapped.json)
 
 **URL 2개 이상일 때만 실행. 단일 URL이면 Phase 3으로 건너뜀.**
 **프레임 간 공통 요소를 식별하여 공유 컴포넌트로 추출한다.**
@@ -466,7 +466,7 @@ UI 요소 → vw 비례:
 
 ---
 
-## Phase 3: 퍼즐 조립
+## Phase 4: 순차 코드 생성
 
 **Phase 1에서 만든 컴포넌트에 Phase 2의 재료로 디자인을 입힌다.**
 **스크린샷을 보면서 퍼즐을 맞추듯 조립한다.**
@@ -688,11 +688,11 @@ URL 있으면:
 
 ---
 
-## Phase 3.5: 컴파일 게이트
+## Phase 5: 컴파일 게이트
 
 **Phase 3 퍼즐 조립 완료 후, 브라우저 검증 전에 컴파일 성공을 보장한다.**
 **컴파일 에러는 스킵 불가 — 반드시 수정 또는 사용자 보고.**
-**Phase 3.5 실패 시 Phase 4 진행 불가 (hard gate).**
+**Phase 5 실패 시 Phase 4 진행 불가 (hard gate).**
 
 ```
 자동 반복: 컴파일 성공까지. 최대 3라운드.
@@ -705,7 +705,7 @@ Phase 3 시작 전에 기존 프로젝트의 에러를 캡처:
   1. 타입 체크 베이스라인: (3.5-1에서 선택한 동일 명령 사용) > /tmp/{feature}/baseline-typecheck.txt 2>&1
   2. 빌드 베이스라인: npm run build > /tmp/{feature}/baseline-build.txt 2>&1
 
-Phase 3.5에서는 baseline에 없는 **새로 발생한 에러만** 수정 대상.
+Phase 5에서는 baseline에 없는 **새로 발생한 에러만** 수정 대상.
 baseline에 존재하던 에러는 무시하고 별도 보고 ("기존 에러 {N}개 유지").
 vibe.figma가 생성/수정한 파일 외의 에러는 자동 수정 금지.
 ```
@@ -783,13 +783,13 @@ vibe.figma가 생성/수정한 파일 외의 에러는 자동 수정 금지.
 컴파일 게이트 결과 보고:
 
   ✅ 통과:
-    "Phase 3.5: 컴파일 게이트 PASS (라운드 {N})"
+    "Phase 5: 컴파일 게이트 PASS (라운드 {N})"
     - tsc: 0 errors
     - build: success
     - dev server: running on localhost:{port}
 
   ❌ 실패 (3라운드 후):
-    "Phase 3.5: 컴파일 게이트 FAIL"
+    "Phase 5: 컴파일 게이트 FAIL"
     - 남은 에러 목록 (파일, 줄, 메시지)
     - 시도한 수정 내역
     - 사용자 수동 수정 필요
@@ -798,7 +798,7 @@ vibe.figma가 생성/수정한 파일 외의 에러는 자동 수정 금지.
 
 ---
 
-## Phase 4: 검증 루프
+## Phase 6: 시각 검증 루프
 
 **Puppeteer + CDP로 실제 렌더링 결과를 확인하며 자동 수정한다.**
 **사람이 브라우저 보면서 고치는 것과 동일한 루프.**
@@ -812,7 +812,7 @@ vibe.figma가 생성/수정한 파일 외의 에러는 자동 수정 금지.
 
 ```
 1. dev 서버 시작:
-   Phase 3.5에서 이미 시작된 dev 서버 사용 (재시작 불필요)
+   Phase 5에서 이미 시작된 dev 서버 사용 (재시작 불필요)
    → localhost:{port} 확인
 
 2. Puppeteer 브라우저 시작: