triflux 9.2.3 → 9.2.4

package/bin/triflux.mjs

@@ -20,7 +20,7 @@ const CODEX_CONFIG_PATH = join(CODEX_DIR, "config.toml");
 const PKG = JSON.parse(readFileSync(join(PKG_ROOT, "package.json"), "utf8"));
 
 // 이 배열에 포함된 버전에서만 star prompt를 표시한다 (빈 배열 = 모든 버전에서 표시)
-const STAR_PROMPT_VERSIONS = ["9.2.2"];
+const STAR_PROMPT_VERSIONS = [];
 
 const REQUIRED_CODEX_PROFILES = [
   {
@@ -161,6 +161,19 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
       { name: "command-or-tool", type: "string", description: "예: doctor, setup, delegate, delegate-reply, status" },
     ],
   },
+  hooks: {
+    usage: "tfx hooks <scan|diff|apply|restore|status|set-priority|toggle>",
+    description: "훅 우선순위 관리 — 오케스트레이터 적용/복원, 우선순위 조정",
+    subcommands: {
+      scan: "현재 settings.json 훅 스캔",
+      diff: "오케스트레이터 적용 시 변경점 미리보기",
+      apply: "오케스트레이터 적용 (settings.json 통합)",
+      restore: "원래 settings.json 훅 복원",
+      status: "오케스트레이터 적용 상태 확인",
+      "set-priority": "특정 훅 우선순위 변경: hooks set-priority <hookId> <priority>",
+      toggle: "특정 훅 활성/비활성 토글: hooks toggle <hookId>",
+    },
+  },
   hub: {
     usage: "tfx hub <start|stop|status> [--port N] [--json]",
     description: "tfx-hub 프로세스 제어",
@@ -2720,6 +2733,20 @@ async function main() {
       }
       return;
     }
+    case "hooks": {
+      const hookManagerPath = join(PKG_ROOT, "hooks", "hook-manager.mjs");
+      const sub = cmdArgs[0] || "status";
+      try {
+        execFileSync(process.execPath, [hookManagerPath, sub, ...cmdArgs.slice(1)], {
+          stdio: "inherit",
+          timeout: 30000,
+          windowsHide: true,
+        });
+      } catch (e) {
+        if (e.status) process.exitCode = e.status;
+      }
+      return;
+    }
     case "version":
     case "--version":
     case "-v":

package/hooks/hook-manager.mjs

@@ -0,0 +1,351 @@
+#!/usr/bin/env node
+// hooks/hook-manager.mjs — 훅 우선순위 매니저
+//
+// 사용법:
+//   node hook-manager.mjs scan            — 현재 settings.json 훅 스캔 → JSON 리포트
+//   node hook-manager.mjs diff            — 오케스트레이터 적용 시 변경점 미리보기
+//   node hook-manager.mjs apply           — settings.json에 오케스트레이터 적용
+//   node hook-manager.mjs restore         — 백업에서 원래 settings.json 훅 복원
+//   node hook-manager.mjs set-priority <hookId> <priority>  — 특정 훅 우선순위 변경
+//   node hook-manager.mjs toggle <hookId>                   — 특정 훅 활성/비활성 토글
+//   node hook-manager.mjs status          — 오케스트레이터 적용 상태 확인
+//
+// Claude 대화에서 AskUserQuestion으로 UI를 제공하며 내부적으로 이 명령들을 호출합니다.
+
+import { readFileSync, writeFileSync, existsSync, copyFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOME = process.env.HOME || process.env.USERPROFILE || "";
+const SETTINGS_PATH = join(HOME, ".claude", "settings.json");
+const BACKUP_PATH = join(HOME, ".claude", "settings.hooks-backup.json");
+const REGISTRY_PATH = join(__dirname, "hook-registry.json");
+const ORCHESTRATOR_PATH = join(__dirname, "hook-orchestrator.mjs");
+
+// ── 유틸리티 ────────────────────────────────────────────────
+
+function loadJSON(path) {
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+function saveJSON(path, data) {
+  writeFileSync(path, JSON.stringify(data, null, 2) + "\n", "utf8");
+}
+
+function getNodeExe() {
+  return process.execPath || "node";
+}
+
+// ── scan: 현재 settings.json 훅 분석 ───────────────────────
+
+function scan() {
+  const settings = loadJSON(SETTINGS_PATH);
+  if (!settings?.hooks) {
+    return { status: "no_hooks", message: "settings.json에 훅이 없습니다.", events: {} };
+  }
+
+  const registry = loadJSON(REGISTRY_PATH);
+  const report = { status: "ok", events: {}, unregistered: [] };
+
+  for (const [event, matchers] of Object.entries(settings.hooks)) {
+    report.events[event] = { hooks: [], count: 0 };
+
+    for (const matcher of matchers) {
+      for (const hook of matcher.hooks || []) {
+        const cmd = hook.command || "";
+        const hookInfo = {
+          event,
+          matcher: matcher.matcher || "*",
+          command: cmd,
+          timeout: hook.timeout,
+          type: hook.type || "command",
+          source: identifySource(cmd),
+          registryMatch: null,
+        };
+
+        // 레지스트리에서 매칭 찾기
+        if (registry?.events?.[event]) {
+          const match = registry.events[event].find(
+            (r) => normalizeCmd(resolveVars(r.command)) === normalizeCmd(cmd)
+          );
+          if (match) {
+            hookInfo.registryMatch = { id: match.id, priority: match.priority };
+          } else {
+            report.unregistered.push(hookInfo);
+          }
+        }
+
+        report.events[event].hooks.push(hookInfo);
+        report.events[event].count++;
+      }
+    }
+  }
+
+  return report;
+}
+
+function identifySource(cmd) {
+  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";
+  if (/headless-guard|tfx-gate/i.test(cmd)) return "omc";
+  if (/mcp-cleanup/i.test(cmd)) return "system";
+  return "unknown";
+}
+
+function normalizeCmd(cmd) {
+  return cmd.replace(/["']/g, "").replace(/\\/g, "/").replace(/\s+/g, " ").trim().toLowerCase();
+}
+
+function resolveVars(cmd) {
+  const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || __dirname.replace(/[\\/]hooks$/, "");
+  return cmd
+    .replace(/\$\{PLUGIN_ROOT\}/g, pluginRoot)
+    .replace(/\$\{HOME\}/g, HOME)
+    .replace(/\$HOME\b/g, HOME);
+}
+
+// ── diff: 적용 시 변경점 미리보기 ───────────────────────────
+
+function diff() {
+  const settings = loadJSON(SETTINGS_PATH);
+  if (!settings?.hooks) return { status: "no_hooks", changes: [] };
+
+  const registry = loadJSON(REGISTRY_PATH);
+  if (!registry) return { status: "no_registry", changes: [] };
+
+  const changes = [];
+  const currentEvents = Object.keys(settings.hooks);
+  const registryEvents = Object.keys(registry.events);
+  const allEvents = [...new Set([...currentEvents, ...registryEvents])];
+
+  for (const event of allEvents) {
+    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;
+
+    if (currentCount === 1 && isOrchestrator(currentHooks)) {
+      changes.push({ event, action: "already_orchestrated", currentCount, registryCount });
+    } else if (currentCount > 0 || registryCount > 0) {
+      changes.push({
+        event,
+        action: "will_replace",
+        currentCount,
+        registryCount,
+        detail: `${currentCount}개 개별 훅 → 1개 오케스트레이터 (내부 ${registryCount}개 순차 실행)`,
+      });
+    }
+  }
+
+  return { status: "ok", changes };
+}
+
+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");
+}
+
+// ── apply: 오케스트레이터 적용 ──────────────────────────────
+
+function apply() {
+  const settings = loadJSON(SETTINGS_PATH);
+  if (!settings) return { status: "error", message: "settings.json을 찾을 수 없습니다." };
+
+  const registry = loadJSON(REGISTRY_PATH);
+  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() });
+  }
+
+  // 오케스트레이터 명령 생성
+  const nodeExe = getNodeExe();
+  const orchestratorCmd = `"${nodeExe}" "${ORCHESTRATOR_PATH}"`;
+
+  // 모든 이벤트를 하나의 오케스트레이터로 통합
+  const newHooks = {};
+  const registryEvents = Object.keys(registry.events);
+
+  // 레지스트리에 없는 기존 이벤트도 보존
+  const allEvents = [
+    ...new Set([...registryEvents, ...Object.keys(settings.hooks || {})]),
+  ];
+
+  for (const event of allEvents) {
+    const registryEntries = registry.events[event] || [];
+    const enabledEntries = registryEntries.filter((h) => h.enabled !== false);
+
+    if (enabledEntries.length > 0) {
+      // 레지스트리에 있으면 → 오케스트레이터로 교체
+      // 가장 큰 timeout을 기준으로 오케스트레이터 timeout 설정
+      const maxTimeout = Math.max(...enabledEntries.map((h) => h.timeout || 10)) + 5;
+
+      newHooks[event] = [
+        {
+          matcher: "*",
+          hooks: [
+            {
+              type: "command",
+              command: orchestratorCmd,
+              timeout: maxTimeout,
+            },
+          ],
+        },
+      ];
+    } else {
+      // 레지스트리에 없으면 기존 유지
+      if (settings.hooks?.[event]) {
+        newHooks[event] = settings.hooks[event];
+      }
+    }
+  }
+
+  settings.hooks = newHooks;
+  saveJSON(SETTINGS_PATH, settings);
+
+  return {
+    status: "applied",
+    message: `오케스트레이터 적용 완료. ${registryEvents.length}개 이벤트가 순차 실행으로 전환됩니다.`,
+    events: registryEvents,
+    backupPath: BACKUP_PATH,
+  };
+}
+
+// ── restore: 백업에서 복원 ──────────────────────────────────
+
+function restore() {
+  if (!existsSync(BACKUP_PATH)) {
+    return { status: "no_backup", message: "백업 파일이 없습니다. apply 전에는 복원할 수 없습니다." };
+  }
+
+  const backup = loadJSON(BACKUP_PATH);
+  if (!backup?.hooks) {
+    return { status: "error", message: "백업 파일이 손상되었습니다." };
+  }
+
+  const settings = loadJSON(SETTINGS_PATH);
+  if (!settings) return { status: "error", message: "settings.json을 찾을 수 없습니다." };
+
+  settings.hooks = backup.hooks;
+  saveJSON(SETTINGS_PATH, settings);
+
+  return {
+    status: "restored",
+    message: `원래 훅 설정이 복원되었습니다. (백업 시점: ${backup.backedUpAt})`,
+  };
+}
+
+// ── set-priority: 우선순위 변경 ─────────────────────────────
+
+function setPriority(hookId, priority) {
+  const registry = loadJSON(REGISTRY_PATH);
+  if (!registry) return { status: "error", message: "레지스트리를 찾을 수 없습니다." };
+
+  const numPriority = parseInt(priority, 10);
+  if (isNaN(numPriority)) return { status: "error", message: "priority는 숫자여야 합니다." };
+
+  let found = false;
+  for (const hooks of Object.values(registry.events)) {
+    const hook = hooks.find((h) => h.id === hookId);
+    if (hook) {
+      hook.priority = numPriority;
+      found = true;
+      break;
+    }
+  }
+
+  if (!found) return { status: "not_found", message: `훅 '${hookId}'를 찾을 수 없습니다.` };
+
+  saveJSON(REGISTRY_PATH, registry);
+  return { status: "ok", message: `${hookId}의 우선순위가 ${numPriority}로 변경되었습니다.` };
+}
+
+// ── toggle: 활성/비활성 토글 ────────────────────────────────
+
+function toggle(hookId) {
+  const registry = loadJSON(REGISTRY_PATH);
+  if (!registry) return { status: "error", message: "레지스트리를 찾을 수 없습니다." };
+
+  let found = false;
+  let newState = false;
+  for (const hooks of Object.values(registry.events)) {
+    const hook = hooks.find((h) => h.id === hookId);
+    if (hook) {
+      hook.enabled = !(hook.enabled !== false);
+      newState = hook.enabled;
+      found = true;
+      break;
+    }
+  }
+
+  if (!found) return { status: "not_found", message: `훅 '${hookId}'를 찾을 수 없습니다.` };
+
+  saveJSON(REGISTRY_PATH, registry);
+  return { status: "ok", message: `${hookId}: ${newState ? "활성화" : "비활성화"}` };
+}
+
+// ── status: 현재 적용 상태 ──────────────────────────────────
+
+function status() {
+  const settings = loadJSON(SETTINGS_PATH);
+  if (!settings?.hooks) return { orchestrated: false, message: "훅 없음" };
+
+  let orchestrated = 0;
+  let individual = 0;
+
+  for (const [event, matchers] of Object.entries(settings.hooks)) {
+    if (isOrchestrator(matchers)) {
+      orchestrated++;
+    } else {
+      individual++;
+    }
+  }
+
+  const hasBackup = existsSync(BACKUP_PATH);
+
+  return {
+    orchestrated: orchestrated > 0,
+    orchestratedEvents: orchestrated,
+    individualEvents: individual,
+    hasBackup,
+    message: orchestrated > 0
+      ? `오케스트레이터 적용 중: ${orchestrated}개 이벤트 통합, ${individual}개 개별 유지`
+      : `오케스트레이터 미적용. ${individual}개 이벤트가 개별 훅으로 실행 중`,
+  };
+}
+
+// ── CLI 진입점 ──────────────────────────────────────────────
+
+const [, , command, ...args] = process.argv;
+
+const commands = {
+  scan: () => scan(),
+  diff: () => diff(),
+  apply: () => apply(),
+  restore: () => restore(),
+  "set-priority": () => setPriority(args[0], args[1]),
+  toggle: () => toggle(args[0]),
+  status: () => status(),
+};
+
+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),
+  }));
+  process.exit(1);
+}
+
+const result = commands[command]();
+console.log(JSON.stringify(result, null, 2));

package/hooks/hook-orchestrator.mjs

@@ -0,0 +1,264 @@
+#!/usr/bin/env node
+// hooks/hook-orchestrator.mjs — 범용 훅 체이닝 엔진
+//
+// settings.json에 이벤트당 하나만 등록. stdin JSON에서 이벤트명+툴명을 읽고
+// hook-registry.json의 우선순위대로 훅을 순차 실행한다.
+//
+// 실행 규칙:
+//   - priority 낮을수록 먼저 실행 (triflux=0, omc=50, external=100)
+//   - blocking:true 훅이 exit 2 반환 → 즉시 중단, 이후 훅 건너뜀
+//   - 출력(stdout JSON)은 마지막 유효 출력으로 머지
+//   - 훅 실패(exit !0 && !2)는 무시하고 다음 훅 진행
+//
+// 사용법:
+//   settings.json에서:
+//   { "type": "command", "command": "node .../hook-orchestrator.mjs", "timeout": 30 }
+//
+// 환경변수:
+//   TRIFLUX_HOOK_REGISTRY — registry 경로 오버라이드
+//   CLAUDE_PLUGIN_ROOT    — ${PLUGIN_ROOT} 치환용
+//   HOME / USERPROFILE    — ${HOME} 치환용
+
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execFileSync } from "node:child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REGISTRY_PATH =
+  process.env.TRIFLUX_HOOK_REGISTRY || join(__dirname, "hook-registry.json");
+
+// ── stdin 읽기 ──────────────────────────────────────────────
+function readStdin() {
+  try {
+    return readFileSync(0, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+// ── 레지스트리 로드 ─────────────────────────────────────────
+function loadRegistry() {
+  if (!existsSync(REGISTRY_PATH)) return null;
+  try {
+    return JSON.parse(readFileSync(REGISTRY_PATH, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+// ── 경로 변수 치환 ──────────────────────────────────────────
+function resolveCommand(cmd) {
+  const home = process.env.HOME || process.env.USERPROFILE || "";
+  const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || __dirname.replace(/[\\/]hooks$/, "");
+
+  return cmd
+    .replace(/\$\{PLUGIN_ROOT\}/g, pluginRoot)
+    .replace(/\$\{HOME\}/g, home)
+    .replace(/\$HOME\b/g, home);
+}
+
+// ── 매처 매칭 ───────────────────────────────────────────────
+function matchesMatcher(hookMatcher, toolName, eventInput) {
+  if (!hookMatcher || hookMatcher === "*") return true;
+  if (!toolName) return true;
+
+  // 파이프 구분 OR 매칭 (예: "Bash|Agent")
+  const patterns = hookMatcher.split("|").map((p) => p.trim());
+  return patterns.some((p) => {
+    try {
+      return new RegExp(`^${p}$`).test(toolName);
+    } catch {
+      return p === toolName;
+    }
+  });
+}
+
+// ── 단일 훅 실행 ────────────────────────────────────────────
+function executeHook(hook, stdinData) {
+  const cmd = resolveCommand(hook.command);
+  const timeout = (hook.timeout || 10) * 1000;
+
+  // command 파싱: "node script.mjs" → ["node", ["script.mjs"]]
+  // "bash script.sh" → ["bash", ["script.sh"]]
+  // 따옴표 처리 포함
+  const parts = parseCommand(cmd);
+  if (parts.length === 0) return { code: 1, stdout: "", stderr: "empty command" };
+
+  const [executable, ...args] = parts;
+
+  try {
+    const stdout = execFileSync(executable, args, {
+      input: stdinData,
+      timeout,
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+      windowsHide: true,
+      cwd: process.cwd(),
+      env: { ...process.env },
+    });
+    return { code: 0, stdout: stdout || "", stderr: "" };
+  } catch (err) {
+    const code = err.status ?? 1;
+    return {
+      code,
+      stdout: err.stdout || "",
+      stderr: err.stderr || "",
+    };
+  }
+}
+
+// ── 명령어 파싱 (따옴표 처리) ───────────────────────────────
+function parseCommand(cmd) {
+  const parts = [];
+  let current = "";
+  let inQuote = null;
+
+  for (let i = 0; i < cmd.length; i++) {
+    const ch = cmd[i];
+    if (inQuote) {
+      if (ch === inQuote) {
+        inQuote = null;
+      } else {
+        current += ch;
+      }
+    } else if (ch === '"' || ch === "'") {
+      inQuote = ch;
+    } else if (ch === " " || ch === "\t") {
+      if (current) {
+        parts.push(current);
+        current = "";
+      }
+    } else {
+      current += ch;
+    }
+  }
+  if (current) parts.push(current);
+  return parts;
+}
+
+// ── JSON 출력 머지 ──────────────────────────────────────────
+function mergeOutputs(accumulated, newOutput) {
+  if (!newOutput) return accumulated;
+
+  try {
+    const parsed = JSON.parse(newOutput);
+    if (!accumulated) return parsed;
+
+    // hookSpecificOutput는 마지막 것이 이김
+    if (parsed.hookSpecificOutput) {
+      accumulated.hookSpecificOutput = parsed.hookSpecificOutput;
+    }
+    // systemMessage는 누적
+    if (parsed.systemMessage) {
+      accumulated.systemMessage = accumulated.systemMessage
+        ? accumulated.systemMessage + "\n" + parsed.systemMessage
+        : parsed.systemMessage;
+    }
+    // additionalContext는 누적
+    if (parsed.additionalContext) {
+      accumulated.additionalContext = accumulated.additionalContext
+        ? accumulated.additionalContext + "\n" + parsed.additionalContext
+        : parsed.additionalContext;
+    }
+    // decision: block이 하나라도 있으면 block
+    if (parsed.decision === "block") {
+      accumulated.decision = "block";
+      accumulated.reason = parsed.reason || accumulated.reason;
+    }
+    // continue: false가 하나라도 있으면 false
+    if (parsed.continue === false) {
+      accumulated.continue = false;
+      accumulated.stopReason = parsed.stopReason || accumulated.stopReason;
+    }
+
+    return accumulated;
+  } catch {
+    // JSON이 아니면 additionalContext로 취급
+    if (!accumulated) accumulated = {};
+    accumulated.additionalContext = accumulated.additionalContext
+      ? accumulated.additionalContext + "\n" + newOutput.trim()
+      : newOutput.trim();
+    return accumulated;
+  }
+}
+
+// ── 메인 ────────────────────────────────────────────────────
+function main() {
+  const stdinRaw = readStdin();
+  const registry = loadRegistry();
+
+  if (!registry) {
+    // 레지스트리 없으면 패스스루
+    if (stdinRaw.trim()) process.stdout.write(stdinRaw);
+    process.exit(0);
+  }
+
+  // stdin에서 이벤트명, 툴명 추출
+  let eventName = "";
+  let toolName = "";
+  if (stdinRaw.trim()) {
+    try {
+      const input = JSON.parse(stdinRaw);
+      eventName = input.hook_event_name || "";
+      toolName = input.tool_name || "";
+    } catch {
+      // 파싱 실패 시 그냥 통과
+      process.exit(0);
+    }
+  }
+
+  if (!eventName) process.exit(0);
+
+  // 이벤트에 해당하는 훅 목록
+  const hooks = registry.events[eventName];
+  if (!hooks || hooks.length === 0) process.exit(0);
+
+  // 우선순위 정렬 (낮을수록 먼저)
+  const sorted = [...hooks]
+    .filter((h) => h.enabled !== false)
+    .sort((a, b) => (a.priority ?? 999) - (b.priority ?? 999));
+
+  // 매처 필터링 + 순차 실행
+  let mergedOutput = null;
+  let blocked = false;
+
+  for (const hook of sorted) {
+    // 매처 체크
+    if (!matchesMatcher(hook.matcher, toolName)) continue;
+
+    const result = executeHook(hook, stdinRaw);
+
+    if (result.code === 2) {
+      // BLOCK — stderr를 에러로 전달하고 즉시 중단
+      if (result.stderr) process.stderr.write(result.stderr);
+      blocked = true;
+      break;
+    }
+
+    if (result.code === 0 && result.stdout.trim()) {
+      mergedOutput = mergeOutputs(mergedOutput, result.stdout.trim());
+    }
+
+    // exit 0이 아닌 다른 코드(1, 3+ 등)는 무시하고 계속
+  }
+
+  // 결과 출력
+  if (blocked) {
+    process.exit(2);
+  }
+
+  if (mergedOutput) {
+    process.stdout.write(JSON.stringify(mergedOutput));
+  }
+
+  process.exit(0);
+}
+
+try {
+  main();
+} catch (err) {
+  // 오케스트레이터 자체 실패 → 비차단
+  process.stderr.write(`[hook-orchestrator] error: ${err.message}\n`);
+  process.exit(0);
+}

package/hooks/hook-registry.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "hook-registry-schema",
+  "version": 1,
+  "description": "훅 우선순위 레지스트리 — 오케스트레이터가 이 파일을 읽어 순차 실행한다. priority 낮을수록 먼저 실행.",
+  "defaults": {
+    "triflux_priority": 0,
+    "omc_priority": 50,
+    "external_priority": 100
+  },
+  "events": {
+    "PreToolUse": [
+      {
+        "id": "tfx-safety-guard",
+        "source": "triflux",
+        "matcher": "Bash",
+        "command": "node \"${PLUGIN_ROOT}/hooks/safety-guard.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": true,
+        "description": "위험 Bash 명령 사전 차단 (rm -rf, force push 등)"
+      },
+      {
+        "id": "tfx-agent-route-guard",
+        "source": "triflux",
+        "matcher": "Agent",
+        "command": "node \"${PLUGIN_ROOT}/hooks/agent-route-guard.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "서브에이전트 스폰 시 triflux 컨텍스트 주입"
+      },
+      {
+        "id": "omc-headless-guard",
+        "source": "omc",
+        "matcher": "Bash|Agent",
+        "command": "bash \"${HOME}/.claude/scripts/headless-guard-fast.sh\"",
+        "priority": 50,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "psmux headless 가드"
+      },
+      {
+        "id": "omc-tfx-gate-activate",
+        "source": "omc",
+        "matcher": "Skill",
+        "command": "node \"${HOME}/.claude/scripts/tfx-gate-activate.mjs\"",
+        "priority": 50,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "tfx-multi 상태 추적 게이트"
+      }
+    ],
+    "PostToolUse": [
+      {
+        "id": "tfx-cross-review-tracker",
+        "source": "triflux",
+        "matcher": "Edit|Write",
+        "command": "node \"${PLUGIN_ROOT}/hooks/cross-review-tracker.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "파일 수정 추적 → 교차 리뷰 nudge"
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "id": "tfx-error-context",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/error-context.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "도구 실패 시 에러 힌트 자동 주입"
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "id": "tfx-keyword-detector",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/scripts/run.cjs\" \"${PLUGIN_ROOT}/scripts/keyword-detector.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 5,
+        "blocking": false,
+        "description": "키워드 매칭 → 스킬 자동 라우팅"
+      }
+    ],
+    "SessionStart": [
+      {
+        "id": "tfx-setup",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/scripts/setup.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 10,
+        "blocking": false,
+        "description": "triflux 환경 초기화"
+      },
+      {
+        "id": "tfx-hub-ensure",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/scripts/hub-ensure.mjs\"",
+        "priority": 1,
+        "enabled": true,
+        "timeout": 8,
+        "blocking": false,
+        "description": "tfx-hub 서비스 헬스체크 및 시작"
+      },
+      {
+        "id": "tfx-preflight-cache",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/scripts/preflight-cache.mjs\"",
+        "priority": 2,
+        "enabled": true,
+        "timeout": 5,
+        "blocking": false,
+        "description": "CLI/Hub 가용성 캐시"
+      },
+      {
+        "id": "ext-session-vault-start",
+        "source": "session-vault",
+        "matcher": "*",
+        "command": "${HOME}/Desktop/Projects/cli/session-vault/scripts/start_hook.sh",
+        "priority": 100,
+        "enabled": true,
+        "timeout": 10,
+        "blocking": false,
+        "description": "세션 볼트 로깅 시작"
+      }
+    ],
+    "Stop": [
+      {
+        "id": "tfx-pipeline-stop",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/pipeline-stop.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 5,
+        "blocking": true,
+        "description": "활성 파이프라인 감지 → 종료 차단"
+      },
+      {
+        "id": "ext-session-vault-export",
+        "source": "session-vault",
+        "matcher": "*",
+        "command": "${HOME}/Desktop/Projects/cli/session-vault/scripts/export_hook.sh",
+        "priority": 100,
+        "enabled": true,
+        "timeout": 30,
+        "blocking": false,
+        "description": "세션 트랜스크립트 내보내기"
+      },
+      {
+        "id": "ext-mcp-cleanup",
+        "source": "system",
+        "matcher": "*",
+        "command": "powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File \"${HOME}/.claude/scripts/mcp-cleanup.ps1\"",
+        "priority": 100,
+        "enabled": true,
+        "timeout": 8,
+        "blocking": false,
+        "description": "MCP 고아 프로세스 정리"
+      }
+    ],
+    "SubagentStop": [
+      {
+        "id": "tfx-subagent-verifier",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/subagent-verifier.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "서브에이전트 결과 품질 체크"
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "triflux lifecycle hooks — CLI routing setup and HUD integration",
+  "description": "triflux lifecycle hooks v2 — hook-orchestrator 기반 순차 실행. 우선순위는 hook-registry.json에서 관리.",
   "hooks": {
     "SessionStart": [
       {
@@ -7,58 +7,79 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/setup.mjs\"",
-            "timeout": 10
-          },
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hub-ensure.mjs\"",
-            "timeout": 8
-          },
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash|Agent|Skill",
+        "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/mcp-gateway-ensure.mjs\"",
-            "timeout": 8
-          },
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/preflight-cache.mjs\"",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
             "timeout": 5
           }
         ]
       }
     ],
-    "UserPromptSubmit": [
+    "PostToolUseFailure": [
       {
         "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/run.cjs\" \"${CLAUDE_PLUGIN_ROOT}/scripts/keyword-detector.mjs\"",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
             "timeout": 5
           }
         ]
       }
     ],
-    "PreToolUse": [
+    "Stop": [
       {
-        "matcher": "Agent",
+        "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/agent-route-guard.mjs\"",
-            "timeout": 3
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 35
           }
         ]
       }
     ],
-    "Stop": [
+    "SubagentStop": [
       {
         "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/pipeline-stop.mjs\"",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
             "timeout": 5
           }
         ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "9.2.3",
+  "version": "9.2.4",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {