triflux 10.0.0 → 10.0.2

package/hooks/hook-orchestrator.mjs

@@ -0,0 +1,312 @@
+#!/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, execFile } from "node:child_process";
+import { PLUGIN_ROOT } from "./lib/resolve-root.mjs";
+
+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 || "";
+
+  return cmd
+    .replace(/\$\{PLUGIN_ROOT\}/g, PLUGIN_ROOT)
+    .replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, PLUGIN_ROOT)
+    .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 executeHookAsync(hook, stdinData) {
+  return new Promise((resolve) => {
+    const cmd = resolveCommand(hook.command);
+    const timeout = (hook.timeout || 10) * 1000;
+    const parts = parseCommand(cmd);
+    if (parts.length === 0) { resolve({ code: 1, stdout: "", stderr: "empty command" }); return; }
+    const [executable, ...args] = parts;
+    const child = execFile(executable, args, {
+      timeout,
+      encoding: "utf8",
+      windowsHide: true,
+      cwd: process.cwd(),
+      env: { ...process.env },
+    }, (err, stdout, stderr) => {
+      if (err) resolve({ code: err.status ?? 1, stdout: stdout || "", stderr: stderr || "" });
+      else resolve({ code: 0, stdout: stdout || "", stderr: "" });
+    });
+    if (stdinData) { child.stdin.write(stdinData); child.stdin.end(); }
+    else child.stdin.end();
+  });
+}
+
+// ── 명령어 파싱 (따옴표 처리) ───────────────────────────────
+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 머지 — additionalContext는 누적, 나머지는 덮어쓰기
+    if (parsed.hookSpecificOutput) {
+      if (accumulated.hookSpecificOutput?.additionalContext && parsed.hookSpecificOutput.additionalContext) {
+        parsed.hookSpecificOutput.additionalContext =
+          accumulated.hookSpecificOutput.additionalContext + "\n" + parsed.hookSpecificOutput.additionalContext;
+      }
+      accumulated.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;
+  }
+}
+
+// ── 메인 ────────────────────────────────────────────────────
+async 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));
+
+  // 매처 필터링
+  const matched = sorted.filter((h) => matchesMatcher(h.matcher, toolName));
+
+  // 같은 priority 그룹별 병렬 실행
+  const groups = [];
+  for (const hook of matched) {
+    const p = hook.priority ?? 999;
+    if (groups.length === 0 || groups[groups.length - 1].priority !== p) {
+      groups.push({ priority: p, hooks: [hook] });
+    } else {
+      groups[groups.length - 1].hooks.push(hook);
+    }
+  }
+
+  let mergedOutput = null;
+  let blocked = false;
+
+  for (const group of groups) {
+    if (blocked) break;
+
+    if (group.hooks.length === 1) {
+      // 단일 훅 — 기존 동기 실행
+      const result = executeHook(group.hooks[0], stdinRaw);
+      if (result.code === 2) {
+        if (result.stderr) process.stderr.write(result.stderr);
+        blocked = true;
+        break;
+      }
+      if (result.code === 0 && result.stdout.trim()) {
+        mergedOutput = mergeOutputs(mergedOutput, result.stdout.trim());
+      }
+    } else {
+      // 같은 priority 다중 훅 — 비동기 병렬 실행
+      const results = await Promise.all(group.hooks.map((h) => executeHookAsync(h, stdinRaw)));
+      for (const result of results) {
+        if (result.code === 2) {
+          if (result.stderr) process.stderr.write(result.stderr);
+          blocked = true;
+          break;
+        }
+        if (result.code === 0 && result.stdout.trim()) {
+          mergedOutput = mergeOutputs(mergedOutput, result.stdout.trim());
+        }
+      }
+    }
+  }
+
+  // 결과 출력
+  if (blocked) {
+    process.exit(2);
+  }
+
+  if (mergedOutput) {
+    process.stdout.write(JSON.stringify(mergedOutput));
+  }
+
+  process.exit(0);
+}
+
+main().catch((err) => {
+  // 오케스트레이터 자체 실패 → 비차단
+  process.stderr.write(`[hook-orchestrator] error: ${err.message}\n`);
+  process.exit(0);
+});

package/hooks/hook-registry.json

@@ -0,0 +1,246 @@
+{
+  "$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": "tfx-cross-review-gate",
+        "source": "triflux",
+        "matcher": "Bash",
+        "command": "node \"${PLUGIN_ROOT}/scripts/cross-review-gate.mjs\"",
+        "priority": 1,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": true,
+        "description": "git commit 전 교차 리뷰 미검증 파일 차단/경고"
+      },
+      {
+        "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"
+      },
+      {
+        "id": "tfx-mcp-config-watcher",
+        "source": "triflux",
+        "matcher": "Edit|Write",
+        "command": "node \"${PLUGIN_ROOT}/hooks/mcp-config-watcher.mjs\"",
+        "priority": 1,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "감시 대상 MCP 설정 변경 감지 → stdio MCP 자동 치환"
+      }
+    ],
+    "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": "도구 실패 시 에러 힌트 자동 주입"
+      },
+      {
+        "id": "tfx-adaptive-collector",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/hook-adaptive-collector.mjs\"",
+        "priority": 1,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "에러 패턴 수집 → Neural Memory adaptive engine 학습"
+      }
+    ],
+    "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-mcp-safety-guard",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/scripts/mcp-safety-guard.mjs\"",
+        "priority": 1,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "Gemini stdio MCP 자동 감지 + 제거 (spawn EPERM 방지)"
+      },
+      {
+        "id": "tfx-hub-ensure",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/scripts/hub-ensure.mjs\"",
+        "priority": 2,
+        "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": 3,
+        "enabled": true,
+        "timeout": 5,
+        "blocking": false,
+        "description": "CLI/Hub 가용성 캐시 (hub-ensure 완료 후 실행)"
+      },
+      {
+        "id": "tfx-mcp-gateway-ensure",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/scripts/mcp-gateway-ensure.mjs\"",
+        "priority": 4,
+        "enabled": true,
+        "timeout": 8,
+        "blocking": false,
+        "description": "supergateway MCP 서비스 헬스체크 및 자동 기동"
+      },
+      {
+        "id": "ext-session-vault-start",
+        "source": "session-vault",
+        "matcher": "*",
+        "command": "bash \"${HOME}/Desktop/Projects/tools/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": "bash \"${HOME}/Desktop/Projects/tools/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

@@ -0,0 +1,89 @@
+{
+  "description": "triflux lifecycle hooks v2 — hook-orchestrator 기반 순차 실행. 우선순위는 hook-registry.json에서 관리.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash|Agent|Skill",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 35
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}