triflux 10.3.4 → 10.7.0

package/hooks/agent-route-guard.mjs

@@ -5,20 +5,23 @@
 // - tfx-multi 활성 상태 시 headless dispatch 강제
 // - 프로젝트 컨텍스트 자동 첨부
 
-import { readFileSync, existsSync } from "node:fs";
-import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
 import { tmpdir } from "node:os";
+import { join } from "node:path";
 
 const TFX_MULTI_STATE = join(tmpdir(), "tfx-multi-state.json");
 const EXPIRE_MS = 30 * 60 * 1000; // 30분
 
 // 서브에이전트 타입별 라우팅 힌트
 const AGENT_HINTS = {
-  "general-purpose": "범용 에이전트. tfx 스킬이 활성이면 스킬 MD의 라우팅을 우선한다.",
+  "general-purpose":
+    "범용 에이전트. tfx 스킬이 활성이면 스킬 MD의 라우팅을 우선한다.",
   Explore: "탐색 전용. 파일 수정 불가. Glob/Grep/Read만 사용.",
   Plan: "설계 전용. 파일 수정 불가. 구현 계획 반환.",
-  "oh-my-claudecode:executor": "OMC executor. triflux 프로젝트에서는 tfx-auto 라우팅을 우선.",
-  "oh-my-claudecode:code-reviewer": "OMC 리뷰어. 교차 리뷰 시 CLAUDE.md 교차 검증 규칙 준수.",
+  "oh-my-claudecode:executor":
+    "OMC executor. triflux 프로젝트에서는 tfx-auto 라우팅을 우선.",
+  "oh-my-claudecode:code-reviewer":
+    "OMC 리뷰어. 교차 리뷰 시 CLAUDE.md 교차 검증 규칙 준수.",
   "oh-my-claudecode:architect": "OMC 아키텍트. READ-ONLY.",
   "oh-my-claudecode:debugger": "OMC 디버거. 근본 원인 분석 집중.",
   "oh-my-claudecode:test-engineer": "OMC 테스트. npm test 실행 후 결과 반환.",
@@ -51,7 +54,7 @@ function buildContext(agentType, prompt) {
   if (multiState) {
     parts.push(
       "[tfx-multi ACTIVE] headless dispatch 모드. " +
-        "CLI 작업은 Bash(tfx-route.sh)를 통해 실행하세요."
+        "CLI 작업은 Bash(tfx-route.sh)를 통해 실행하세요.",
     );
   }
 
@@ -64,7 +67,7 @@ function buildContext(agentType, prompt) {
   // 3. 프로젝트 컨텍스트
   parts.push(
     "triflux 프로젝트: subagent_type 미지정 시 'general-purpose' 기본. " +
-      "tfx-* 스킬 활성 시 스킬 MD 라우팅 우선."
+      "tfx-* 스킬 활성 시 스킬 MD 라우팅 우선.",
   );
 
   return parts.join("\n");
@@ -84,7 +87,8 @@ function main() {
   if (input.tool_name !== "Agent") process.exit(0);
 
   const toolInput = input.tool_input || {};
-  const agentType = toolInput.subagent_type || toolInput.agent || "general-purpose";
+  const agentType =
+    toolInput.subagent_type || toolInput.agent || "general-purpose";
   const prompt = toolInput.prompt || "";
 
   const context = buildContext(agentType, prompt);

package/hooks/cross-review-tracker.mjs

@@ -9,9 +9,9 @@
 //   2. 일정 수(REVIEW_THRESHOLD) 이상 미검증 파일이 쌓이면 nudge 메시지 주입
 //   3. git commit 전 미검증 파일 경고
 
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
-import { join, relative } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
+import { join, relative } from "node:path";
 
 const STATE_DIR = join(tmpdir(), "tfx-cross-review");
 const STATE_FILE = join(STATE_DIR, "pending-review.json");
@@ -20,9 +20,24 @@ const EXPIRE_MS = 60 * 60 * 1000; // 1시간 후 자동 만료
 
 // 코드 파일만 추적 (설정/문서/빌드 산출물 제외)
 const CODE_EXTENSIONS = new Set([
-  ".js", ".mjs", ".cjs", ".ts", ".tsx", ".jsx",
-  ".py", ".rs", ".go", ".java", ".c", ".cpp", ".h",
-  ".vue", ".svelte", ".sh", ".bash", ".ps1",
+  ".js",
+  ".mjs",
+  ".cjs",
+  ".ts",
+  ".tsx",
+  ".jsx",
+  ".py",
+  ".rs",
+  ".go",
+  ".java",
+  ".c",
+  ".cpp",
+  ".h",
+  ".vue",
+  ".svelte",
+  ".sh",
+  ".bash",
+  ".ps1",
 ]);
 
 function isCodeFile(filePath) {
@@ -93,9 +108,7 @@ function main() {
   saveState(state);
 
   // 미검증 파일 수 체크
-  const unreviewed = Object.entries(state.files).filter(
-    ([, v]) => !v.reviewed
-  );
+  const unreviewed = Object.entries(state.files).filter(([, v]) => !v.reviewed);
   const count = unreviewed.length;
 
   if (count >= REVIEW_THRESHOLD) {

package/hooks/error-context.mjs

@@ -4,7 +4,7 @@
 // 도구 실패 시 에러 패턴을 분석하여 해결 힌트를 additionalContext로 주입한다.
 // Claude가 동일 에러를 반복하지 않도록 구체적 가이드를 제공.
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
 // ── 에러 패턴 → 해결 힌트 매핑 ─────────────────────────────
@@ -130,7 +130,8 @@ function main() {
   ].join("\n");
 
   // ── reflexion 적응형 학습: safety-guard/headless-guard 차단을 패널티로 기록 ──
-  const isSafetyBlock = /\[(?:safety-guard|headless-guard)\].*(?:BLOCKED|차단)/i.test(errorText);
+  const isSafetyBlock =
+    /\[(?:safety-guard|headless-guard)\].*(?:BLOCKED|차단)/i.test(errorText);
   if (isSafetyBlock) {
     try {
       const home = process.env.HOME || process.env.USERPROFILE || "";
@@ -142,12 +143,18 @@ function main() {
         ts: new Date().toISOString(),
         type: "guard_block",
         tool: input.tool_name || "Bash",
-        error_pattern: errorText.match(/\[.*?\]\s*(.{0,120})/)?.[1] || errorText.slice(0, 120),
+        error_pattern:
+          errorText.match(/\[.*?\]\s*(.{0,120})/)?.[1] ||
+          errorText.slice(0, 120),
         command_preview: command.slice(0, 200),
-        source: errorText.includes("safety-guard") ? "safety-guard" : "headless-guard",
+        source: errorText.includes("safety-guard")
+          ? "safety-guard"
+          : "headless-guard",
       };
       writeFileSync(penaltyFile, JSON.stringify(entry) + "\n", { flag: "a" });
-    } catch { /* reflexion 기록 실패는 무시 — 힌트 출력에 영향 주지 않음 */ }
+    } catch {
+      /* reflexion 기록 실패는 무시 — 힌트 출력에 영향 주지 않음 */
+    }
   }
 
   const hints = findHints(errorText);
@@ -157,10 +164,15 @@ function main() {
   const toolName = input.tool_name || "Unknown";
   const parts = [];
   if (hints.length > 0) {
-    parts.push(`[error-context] ${toolName} 실패 — 해결 힌트:\n` + hints.map((h) => `  → ${h}`).join("\n"));
+    parts.push(
+      `[error-context] ${toolName} 실패 — 해결 힌트:\n` +
+        hints.map((h) => `  → ${h}`).join("\n"),
+    );
   }
   if (isSafetyBlock) {
-    parts.push("[reflexion] 이 패턴이 적응형 학습에 기록되었습니다. 다음 세션에서 동일 패턴 시 사전 차단됩니다.");
+    parts.push(
+      "[reflexion] 이 패턴이 적응형 학습에 기록되었습니다. 다음 세션에서 동일 패턴 시 사전 차단됩니다.",
+    );
   }
 
   if (parts.length === 0) process.exit(0);

package/hooks/hook-adaptive-collector.mjs

@@ -1,31 +1,32 @@
 #!/usr/bin/env node
 
-import { existsSync, readFileSync } from 'node:fs';
-import { basename, join } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { pathToFileURL } from "node:url";
 
-import { createAdaptiveEngine } from '../hub/adaptive.mjs';
+import { createAdaptiveEngine } from "../hub/adaptive.mjs";
 
 let engine = null;
 let createEngine = createAdaptiveEngine;
 
 function readStdin() {
   try {
-    return readFileSync(0, 'utf8');
+    return readFileSync(0, "utf8");
   } catch {
-    return '';
+    return "";
   }
 }
 
 function inferProjectSlug(cwd = process.cwd()) {
-  const packagePath = join(cwd, 'package.json');
+  const packagePath = join(cwd, "package.json");
   if (existsSync(packagePath)) {
     try {
-      const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
-      if (typeof pkg.name === 'string' && pkg.name.trim()) return pkg.name.trim();
+      const pkg = JSON.parse(readFileSync(packagePath, "utf8"));
+      if (typeof pkg.name === "string" && pkg.name.trim())
+        return pkg.name.trim();
     } catch {}
   }
-  return basename(cwd) || 'default';
+  return basename(cwd) || "default";
 }
 
 function getEngine() {
@@ -41,22 +42,22 @@ function getEngine() {
 function buildErrorContext(event = {}) {
   return {
     exitCode: event.exitCode,
-    stderr: String(event.stderr || '').slice(0, 500),
+    stderr: String(event.stderr || "").slice(0, 500),
     tool: event.tool,
-    command: String(event.command || '').slice(0, 200),
+    command: String(event.command || "").slice(0, 200),
     timestamp: new Date().toISOString(),
   };
 }
 
 export default function hookAdaptiveCollector(event = {}) {
   if (Number(event.exitCode) === 0) return null;
-  if (!event.tool || event.tool === 'Read') return null;
+  if (!event.tool || event.tool === "Read") return null;
 
   const result = getEngine().handleError(buildErrorContext(event));
   if (result?.diagnosed) {
-    console.error(`[adaptive] 에러 패턴 감지: ${result.rule?.id || 'unknown'}`);
+    console.error(`[adaptive] 에러 패턴 감지: ${result.rule?.id || "unknown"}`);
     if (result.promoted) {
-      console.error(`[adaptive] 규칙 승격 → Tier ${result.rule?.tier ?? '?'}`);
+      console.error(`[adaptive] 규칙 승격 → Tier ${result.rule?.tier ?? "?"}`);
     }
   }
   return result;
@@ -80,7 +81,8 @@ function main() {
   } catch {}
 }
 
-const isEntrypoint = process.argv[1] && pathToFileURL(process.argv[1]).href === import.meta.url;
+const isEntrypoint =
+  process.argv[1] && pathToFileURL(process.argv[1]).href === import.meta.url;
 if (isEntrypoint) {
   main();
 }

package/hooks/hook-manager.mjs

@@ -12,8 +12,8 @@
 //
 // Claude 대화에서 AskUserQuestion으로 UI를 제공하며 내부적으로 이 명령들을 호출합니다.
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { PLUGIN_ROOT } from "./lib/resolve-root.mjs";
 
@@ -27,7 +27,11 @@ const REGISTRY_PATH = join(HOME, ".claude", "cache", "hook-registry.json");
 function ensureUserRegistry() {
   if (!existsSync(REGISTRY_PATH) && existsSync(BUNDLED_REGISTRY_PATH)) {
     mkdirSync(dirname(REGISTRY_PATH), { recursive: true });
-    writeFileSync(REGISTRY_PATH, readFileSync(BUNDLED_REGISTRY_PATH, "utf8"), "utf8");
+    writeFileSync(
+      REGISTRY_PATH,
+      readFileSync(BUNDLED_REGISTRY_PATH, "utf8"),
+      "utf8",
+    );
   }
 }
 
@@ -56,7 +60,11 @@ function scan() {
   ensureUserRegistry();
   const settings = loadJSON(SETTINGS_PATH);
   if (!settings?.hooks) {
-    return { status: "no_hooks", message: "settings.json에 훅이 없습니다.", events: {} };
+    return {
+      status: "no_hooks",
+      message: "settings.json에 훅이 없습니다.",
+      events: {},
+    };
   }
 
   const registry = loadJSON(REGISTRY_PATH);
@@ -81,7 +89,7 @@ function scan() {
         // 레지스트리에서 매칭 찾기
         if (registry?.events?.[event]) {
           const match = registry.events[event].find(
-            (r) => normalizeCmd(resolveVars(r.command)) === normalizeCmd(cmd)
+            (r) => normalizeCmd(resolveVars(r.command)) === normalizeCmd(cmd),
           );
           if (match) {
             hookInfo.registryMatch = { id: match.id, priority: match.priority };
@@ -100,7 +108,8 @@ function scan() {
 }
 
 function identifySource(cmd) {
-  if (/triflux/i.test(cmd) || /\$\{?CLAUDE_PLUGIN_ROOT\}?/i.test(cmd)) return "triflux";
+  if (/triflux/i.test(cmd) || /\$\{?CLAUDE_PLUGIN_ROOT\}?/i.test(cmd))
+    return "triflux";
   if (/oh-my-claudecode|omc/i.test(cmd)) return "omc";
   if (/session-vault/i.test(cmd)) return "session-vault";
   if (/compact-helper/i.test(cmd)) return "compact-helper";
@@ -110,7 +119,12 @@ function identifySource(cmd) {
 }
 
 function normalizeCmd(cmd) {
-  return cmd.replace(/["']/g, "").replace(/\\/g, "/").replace(/\s+/g, " ").trim().toLowerCase();
+  return cmd
+    .replace(/["']/g, "")
+    .replace(/\\/g, "/")
+    .replace(/\s+/g, " ")
+    .trim()
+    .toLowerCase();
 }
 
 function resolveVars(cmd) {
@@ -140,11 +154,21 @@ function diff() {
     const currentHooks = settings.hooks[event] || [];
     const registryHooks = registry.events[event] || [];
 
-    const currentCount = currentHooks.reduce((n, m) => n + (m.hooks?.length || 0), 0);
-    const registryCount = registryHooks.filter((h) => h.enabled !== false).length;
+    const currentCount = currentHooks.reduce(
+      (n, m) => n + (m.hooks?.length || 0),
+      0,
+    );
+    const registryCount = registryHooks.filter(
+      (h) => h.enabled !== false,
+    ).length;
 
     if (currentCount === 1 && isOrchestrator(currentHooks)) {
-      changes.push({ event, action: "already_orchestrated", currentCount, registryCount });
+      changes.push({
+        event,
+        action: "already_orchestrated",
+        currentCount,
+        registryCount,
+      });
     } else if (currentCount > 0 || registryCount > 0) {
       changes.push({
         event,
@@ -162,7 +186,10 @@ function diff() {
 function isOrchestrator(matchers) {
   if (!matchers || matchers.length !== 1) return false;
   const hooks = matchers[0]?.hooks || [];
-  return hooks.length === 1 && (hooks[0]?.command || "").includes("hook-orchestrator");
+  return (
+    hooks.length === 1 &&
+    (hooks[0]?.command || "").includes("hook-orchestrator")
+  );
 }
 
 // ── apply: 오케스트레이터 적용 ──────────────────────────────
@@ -170,14 +197,22 @@ function isOrchestrator(matchers) {
 function apply() {
   ensureUserRegistry();
   const settings = loadJSON(SETTINGS_PATH);
-  if (!settings) return { status: "error", message: "settings.json을 찾을 수 없습니다." };
+  if (!settings)
+    return { status: "error", message: "settings.json을 찾을 수 없습니다." };
 
   const registry = loadJSON(REGISTRY_PATH);
-  if (!registry) return { status: "error", message: "hook-registry.json을 찾을 수 없습니다." };
+  if (!registry)
+    return {
+      status: "error",
+      message: "hook-registry.json을 찾을 수 없습니다.",
+    };
 
   // 백업
   if (settings.hooks && !existsSync(BACKUP_PATH)) {
-    saveJSON(BACKUP_PATH, { hooks: settings.hooks, backedUpAt: new Date().toISOString() });
+    saveJSON(BACKUP_PATH, {
+      hooks: settings.hooks,
+      backedUpAt: new Date().toISOString(),
+    });
   }
 
   // 오케스트레이터 명령 생성
@@ -201,7 +236,8 @@ function apply() {
     if (enabledEntries.length > 0) {
       // 레지스트리에 있으면 → 오케스트레이터로 교체
       // 가장 큰 timeout을 기준으로 오케스트레이터 timeout 설정
-      const maxTimeout = Math.max(...enabledEntries.map((h) => h.timeout || 10)) + 5;
+      const maxTimeout =
+        Math.max(...enabledEntries.map((h) => h.timeout || 10)) + 5;
 
       newHooks[event] = [
         {
@@ -238,7 +274,10 @@ function apply() {
 
 function restore() {
   if (!existsSync(BACKUP_PATH)) {
-    return { status: "no_backup", message: "백업 파일이 없습니다. apply 전에는 복원할 수 없습니다." };
+    return {
+      status: "no_backup",
+      message: "백업 파일이 없습니다. apply 전에는 복원할 수 없습니다.",
+    };
   }
 
   const backup = loadJSON(BACKUP_PATH);
@@ -247,7 +286,8 @@ function restore() {
   }
 
   const settings = loadJSON(SETTINGS_PATH);
-  if (!settings) return { status: "error", message: "settings.json을 찾을 수 없습니다." };
+  if (!settings)
+    return { status: "error", message: "settings.json을 찾을 수 없습니다." };
 
   settings.hooks = backup.hooks;
   saveJSON(SETTINGS_PATH, settings);
@@ -263,10 +303,12 @@ function restore() {
 function setPriority(hookId, priority) {
   ensureUserRegistry();
   const registry = loadJSON(REGISTRY_PATH);
-  if (!registry) return { status: "error", message: "레지스트리를 찾을 수 없습니다." };
+  if (!registry)
+    return { status: "error", message: "레지스트리를 찾을 수 없습니다." };
 
   const numPriority = parseInt(priority, 10);
-  if (isNaN(numPriority)) return { status: "error", message: "priority는 숫자여야 합니다." };
+  if (Number.isNaN(numPriority))
+    return { status: "error", message: "priority는 숫자여야 합니다." };
 
   let found = false;
   for (const hooks of Object.values(registry.events)) {
@@ -278,10 +320,17 @@ function setPriority(hookId, priority) {
     }
   }
 
-  if (!found) return { status: "not_found", message: `훅 '${hookId}'를 찾을 수 없습니다.` };
+  if (!found)
+    return {
+      status: "not_found",
+      message: `훅 '${hookId}'를 찾을 수 없습니다.`,
+    };
 
   saveJSON(REGISTRY_PATH, registry);
-  return { status: "ok", message: `${hookId}의 우선순위가 ${numPriority}로 변경되었습니다.` };
+  return {
+    status: "ok",
+    message: `${hookId}의 우선순위가 ${numPriority}로 변경되었습니다.`,
+  };
 }
 
 // ── toggle: 활성/비활성 토글 ────────────────────────────────
@@ -289,7 +338,8 @@ function setPriority(hookId, priority) {
 function toggle(hookId) {
   ensureUserRegistry();
   const registry = loadJSON(REGISTRY_PATH);
-  if (!registry) return { status: "error", message: "레지스트리를 찾을 수 없습니다." };
+  if (!registry)
+    return { status: "error", message: "레지스트리를 찾을 수 없습니다." };
 
   let found = false;
   let newState = false;
@@ -303,10 +353,17 @@ function toggle(hookId) {
     }
   }
 
-  if (!found) return { status: "not_found", message: `훅 '${hookId}'를 찾을 수 없습니다.` };
+  if (!found)
+    return {
+      status: "not_found",
+      message: `훅 '${hookId}'를 찾을 수 없습니다.`,
+    };
 
   saveJSON(REGISTRY_PATH, registry);
-  return { status: "ok", message: `${hookId}: ${newState ? "활성화" : "비활성화"}` };
+  return {
+    status: "ok",
+    message: `${hookId}: ${newState ? "활성화" : "비활성화"}`,
+  };
 }
 
 // ── status: 현재 적용 상태 ──────────────────────────────────
@@ -318,7 +375,7 @@ function status() {
   let orchestrated = 0;
   let individual = 0;
 
-  for (const [event, matchers] of Object.entries(settings.hooks)) {
+  for (const [_event, matchers] of Object.entries(settings.hooks)) {
     if (isOrchestrator(matchers)) {
       orchestrated++;
     } else {
@@ -333,9 +390,10 @@ function status() {
     orchestratedEvents: orchestrated,
     individualEvents: individual,
     hasBackup,
-    message: orchestrated > 0
-      ? `오케스트레이터 적용 중: ${orchestrated}개 이벤트 통합, ${individual}개 개별 유지`
-      : `오케스트레이터 미적용. ${individual}개 이벤트가 개별 훅으로 실행 중`,
+    message:
+      orchestrated > 0
+        ? `오케스트레이터 적용 중: ${orchestrated}개 이벤트 통합, ${individual}개 개별 유지`
+        : `오케스트레이터 미적용. ${individual}개 이벤트가 개별 훅으로 실행 중`,
   };
 }
 
@@ -354,10 +412,13 @@ const commands = {
 };
 
 if (!command || !commands[command]) {
-  console.log(JSON.stringify({
-    error: "사용법: node hook-manager.mjs <scan|diff|apply|restore|set-priority|toggle|status>",
-    commands: Object.keys(commands),
-  }));
+  console.log(
+    JSON.stringify({
+      error:
+        "사용법: node hook-manager.mjs <scan|diff|apply|restore|set-priority|toggle|status>",
+      commands: Object.keys(commands),
+    }),
+  );
   process.exit(1);
 }