@triflux/core 10.0.3 → 10.25.1

package/hooks/hook-orchestrator.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+
 // hooks/hook-orchestrator.mjs — 범용 훅 체이닝 엔진
 //
 // settings.json에 이벤트당 하나만 등록. stdin JSON에서 이벤트명+툴명을 읽고
@@ -19,15 +20,30 @@
 //   CLAUDE_PLUGIN_ROOT    — ${PLUGIN_ROOT} 치환용
 //   HOME / USERPROFILE    — ${HOME} 치환용
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { execFile, execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } 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");
+const HOOK_CACHE_DIR =
+  process.env.TRIFLUX_HOOK_CACHE_DIR ||
+  join(tmpdir(), "triflux-hook-orchestrator-cache");
+const HOOK_CACHE_TTL_MS = Math.max(
+  0,
+  Number.parseInt(process.env.TRIFLUX_HOOK_CACHE_TTL_MS || "1500", 10) || 1500,
+);
 
 // ── stdin 읽기 ──────────────────────────────────────────────
 function readStdin() {
@@ -75,6 +91,57 @@ function matchesMatcher(hookMatcher, toolName, eventInput) {
   });
 }
 
+function shouldDedupePreToolUseBash(eventName, toolName) {
+  return eventName === "PreToolUse" && toolName === "Bash";
+}
+
+function buildHookCachePath(stdinData) {
+  const digest = createHash("sha1").update(stdinData).digest("hex");
+  return join(HOOK_CACHE_DIR, `pretool-bash-${digest}.json`);
+}
+
+function readHookCache(stdinData) {
+  if (HOOK_CACHE_TTL_MS <= 0) return null;
+
+  const cachePath = buildHookCachePath(stdinData);
+  if (!existsSync(cachePath)) return null;
+
+  try {
+    const cached = JSON.parse(readFileSync(cachePath, "utf8"));
+    const ageMs = Date.now() - Number(cached?.ts || 0);
+    if (!Number.isFinite(ageMs) || ageMs < 0 || ageMs > HOOK_CACHE_TTL_MS) {
+      unlinkSync(cachePath);
+      return null;
+    }
+    return cached;
+  } catch {
+    try {
+      unlinkSync(cachePath);
+    } catch {}
+    return null;
+  }
+}
+
+function writeHookCache(stdinData, payload) {
+  if (HOOK_CACHE_TTL_MS <= 0) return;
+
+  try {
+    mkdirSync(HOOK_CACHE_DIR, { recursive: true });
+    writeFileSync(
+      buildHookCachePath(stdinData),
+      JSON.stringify({ ts: Date.now(), ...payload }),
+      "utf8",
+    );
+  } catch {
+    // 캐시 실패는 훅 실행에 영향 주지 않음
+  }
+}
+
+function shouldShortCircuitPreToolUseBash(result) {
+  if (!result || result.code === 2) return true;
+  return result.code === 0 && Boolean(result.stdout?.trim());
+}
+
 // ── 단일 훅 실행 ────────────────────────────────────────────
 function executeHook(hook, stdinData) {
   const cmd = resolveCommand(hook.command);
@@ -84,7 +151,8 @@ function executeHook(hook, stdinData) {
   // "bash script.sh" → ["bash", ["script.sh"]]
   // 따옴표 처리 포함
   const parts = parseCommand(cmd);
-  if (parts.length === 0) return { code: 1, stdout: "", stderr: "empty command" };
+  if (parts.length === 0)
+    return { code: 1, stdout: "", stderr: "empty command" };
 
   const [executable, ...args] = parts;
 
@@ -114,20 +182,35 @@ function executeHookAsync(hook, stdinData) {
     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; }
+    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();
+    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();
   });
 }
 
@@ -170,11 +253,19 @@ function mergeOutputs(accumulated, newOutput) {
 
     // hookSpecificOutput 머지 — additionalContext는 누적, 나머지는 덮어쓰기
     if (parsed.hookSpecificOutput) {
-      if (accumulated.hookSpecificOutput?.additionalContext && parsed.hookSpecificOutput.additionalContext) {
+      if (
+        accumulated.hookSpecificOutput?.additionalContext &&
+        parsed.hookSpecificOutput.additionalContext
+      ) {
         parsed.hookSpecificOutput.additionalContext =
-          accumulated.hookSpecificOutput.additionalContext + "\n" + parsed.hookSpecificOutput.additionalContext;
+          accumulated.hookSpecificOutput.additionalContext +
+          "\n" +
+          parsed.hookSpecificOutput.additionalContext;
       }
-      accumulated.hookSpecificOutput = { ...accumulated.hookSpecificOutput, ...parsed.hookSpecificOutput };
+      accumulated.hookSpecificOutput = {
+        ...accumulated.hookSpecificOutput,
+        ...parsed.hookSpecificOutput,
+      };
     }
     // systemMessage는 누적
     if (parsed.systemMessage) {
@@ -220,7 +311,12 @@ function recordRouteOutcome(slug, mode, outcome) {
 
   const weights = existsSync(weightsPath)
     ? JSON.parse(readFileSync(weightsPath, "utf8"))
-    : { updated_at: null, total_routes: 0, overrides: 0, weights: { mode_bias: {}, profile_bias: {}, depth_bias: {} } };
+    : {
+        updated_at: null,
+        total_routes: 0,
+        overrides: 0,
+        weights: { mode_bias: {}, profile_bias: {}, depth_bias: {} },
+      };
 
   weights.total_routes++;
   weights.updated_at = new Date().toISOString();
@@ -247,6 +343,23 @@ function recordRouteOutcome(slug, mode, outcome) {
   writeFileSync(weightsPath, JSON.stringify(weights, null, 2), "utf8");
 }
 
+function isHubTokenMonitorSnapshot(snapshot) {
+  if (!snapshot || typeof snapshot !== "object") return false;
+  return (
+    Object.hasOwn(snapshot, "requestTokens") ||
+    Object.hasOwn(snapshot, "responseTokens") ||
+    Object.hasOwn(snapshot, "totalUpdates") ||
+    (snapshot.byTool && typeof snapshot.byTool === "object")
+  );
+}
+
+function readCompactNudgePercent(snapshot) {
+  if (isHubTokenMonitorSnapshot(snapshot)) return null;
+  const percent = Number(snapshot?.percent ?? 0);
+  if (!Number.isFinite(percent)) return null;
+  return Math.max(0, Math.min(100, percent));
+}
+
 // ── 메인 ────────────────────────────────────────────────────
 async function main() {
   // CLI: --record-route <slug> <mode> <outcome>
@@ -284,6 +397,50 @@ async function main() {
 
   if (!eventName) process.exit(0);
 
+  const dedupePreToolUseBash = shouldDedupePreToolUseBash(eventName, toolName);
+  if (dedupePreToolUseBash) {
+    const cached = readHookCache(stdinRaw);
+    if (cached?.stderr) process.stderr.write(cached.stderr);
+    if (cached?.blocked) process.exit(2);
+    if (cached?.mergedOutput) {
+      process.stdout.write(JSON.stringify(cached.mergedOutput));
+    }
+    if (cached) process.exit(0);
+  }
+
+  // ── SessionStart fast-path ──
+  // TRIFLUX_HOOK_FAST_PATH=false로 비활성화 가능 (rollback)
+  if (
+    eventName === "SessionStart" &&
+    process.env.TRIFLUX_HOOK_FAST_PATH !== "false"
+  ) {
+    try {
+      const { execute } = await import("./session-start-fast.mjs");
+      const result = await execute(stdinRaw);
+      if (result.stdout?.trim()) {
+        const output = { additionalContext: result.stdout.trim() };
+        process.stdout.write(JSON.stringify(output));
+      }
+
+      // external source 훅 (session-vault 등)은 기존 방식으로 실행
+      const allHooks = registry.events.SessionStart || [];
+      const externalHooks = allHooks.filter(
+        (h) => h.enabled !== false && h.source !== "triflux",
+      );
+      for (const hook of externalHooks) {
+        const hookResult = executeHookAsync(hook, stdinRaw);
+        hookResult.catch(() => {}); // fire-and-forget for external hooks
+      }
+
+      process.exit(0);
+    } catch (err) {
+      // fast-path 실패 시 기존 방식으로 폴백
+      process.stderr.write(
+        `[orchestrator] fast-path failed, falling back: ${err.message}\n`,
+      );
+    }
+  }
+
   // 이벤트에 해당하는 훅 목록
   const hooks = registry.events[eventName];
   if (!hooks || hooks.length === 0) process.exit(0);
@@ -309,42 +466,131 @@ async function main() {
 
   let mergedOutput = null;
   let blocked = false;
+  let blockingStderr = "";
 
-  for (const group of groups) {
-    if (blocked) break;
-
-    if (group.hooks.length === 1) {
-      // 단일 훅 — 기존 동기 실행
-      const result = executeHook(group.hooks[0], stdinRaw);
+  if (dedupePreToolUseBash) {
+    for (const hook of matched) {
+      const result = executeHook(hook, stdinRaw);
       if (result.code === 2) {
-        if (result.stderr) process.stderr.write(result.stderr);
+        blockingStderr = result.stderr || "";
+        if (blockingStderr) process.stderr.write(blockingStderr);
         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 (shouldShortCircuitPreToolUseBash(result)) {
+        break;
+      }
+    }
+  } else {
+    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);
+          blockingStderr = result.stderr || "";
+          if (blockingStderr) process.stderr.write(blockingStderr);
           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) {
+            blockingStderr = result.stderr || "";
+            if (blockingStderr) process.stderr.write(blockingStderr);
+            blocked = true;
+            break;
+          }
+          if (result.code === 0 && result.stdout.trim()) {
+            mergedOutput = mergeOutputs(mergedOutput, result.stdout.trim());
+          }
+        }
       }
     }
   }
 
+  // ── PostToolUse: 컨텍스트 압축 nudge (인라인, 프로세스 추가 없음) ──
+  if (eventName === "PostToolUse" && toolName !== "Bash" && !blocked) {
+    try {
+      const home = process.env.HOME || process.env.USERPROFILE || "";
+      const snapshotPath = join(
+        home,
+        ".claude",
+        "cache",
+        "tfx-hub",
+        "context-monitor.json",
+      );
+      const nudgeMarker = join(tmpdir(), "tfx-compact-nudge-sent");
+      if (existsSync(snapshotPath) && !existsSync(nudgeMarker)) {
+        const snap = JSON.parse(readFileSync(snapshotPath, "utf8"));
+        const percent = readCompactNudgePercent(snap);
+        if (percent != null && percent >= 80) {
+          const level = percent >= 90 ? "critical" : "warn";
+          const msg =
+            level === "critical"
+              ? `[context ${percent}%] 컨텍스트 ${percent}% 사용. /compact 또는 에이전트 분할을 강력 권장합니다.`
+              : `[context ${percent}%] 컨텍스트 ${percent}% 사용. 마일스톤이면 /compact를 권장합니다.`;
+          mergedOutput = mergeOutputs(
+            mergedOutput,
+            JSON.stringify({ systemMessage: msg }),
+          );
+          if (level === "warn") {
+            writeFileSync(nudgeMarker, new Date().toISOString());
+          }
+        }
+      }
+    } catch {
+      /* 컨텍스트 모니터 읽기 실패 무시 */
+    }
+  }
+
+  // ── PostToolUse:Skill 완료 시 라우팅 가중치 기록 ──
+  if (eventName === "PostToolUse" && toolName === "Skill" && !blocked) {
+    try {
+      const input = JSON.parse(stdinRaw);
+      const skillName = input.tool_input?.skill || "";
+      if (skillName?.startsWith("tfx-")) {
+        const mode = skillName.replace(/^tfx-/, "");
+        const gitRoot = process.env.GIT_WORK_TREE || process.cwd();
+        const slug = gitRoot.split(/[\\/]/).pop() || "unknown";
+        recordRouteOutcome(slug, mode, "completion");
+      }
+    } catch {
+      /* 가중치 기록 실패 무시 */
+    }
+  }
+
   // 결과 출력
   if (blocked) {
+    if (dedupePreToolUseBash) {
+      writeHookCache(stdinRaw, {
+        blocked: true,
+        mergedOutput: null,
+        stderr: blockingStderr,
+      });
+    }
     process.exit(2);
   }
 
+  if (dedupePreToolUseBash) {
+    writeHookCache(stdinRaw, {
+      blocked: false,
+      mergedOutput,
+      stderr: "",
+    });
+  }
+
   if (mergedOutput) {
     process.stdout.write(JSON.stringify(mergedOutput));
   }

package/hooks/hook-registry.json

@@ -8,6 +8,19 @@
     "external_priority": 100
   },
   "events": {
+    "PermissionRequest": [
+      {
+        "id": "tfx-permission-safe-allow",
+        "source": "triflux",
+        "matcher": "Bash",
+        "command": "node \"${PLUGIN_ROOT}/hooks/permission-safe-allow.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "안전한 repo-local Bash PermissionRequest 자동 허용 (#245)"
+      }
+    ],
     "PreToolUse": [
       {
         "id": "tfx-safety-guard",
@@ -63,6 +76,16 @@
         "timeout": 2,
         "blocking": false,
         "description": "tfx-multi 상태 추적 게이트"
+      },
+      {
+        "id": "tfx-write-edit-passthrough",
+        "source": "triflux",
+        "matcher": "Edit|Write",
+        "command": "exit 0",
+        "priority": 999,
+        "enabled": true,
+        "blocking": false,
+        "description": "Edit/Write passthrough"
       }
     ],
     "PostToolUse": [
@@ -87,6 +110,17 @@
         "timeout": 3,
         "blocking": false,
         "description": "감시 대상 MCP 설정 변경 감지 → stdio MCP 자동 치환"
+      },
+      {
+        "id": "tfx-post-tool-tips",
+        "source": "triflux",
+        "matcher": "Bash|Edit|Write",
+        "command": "node \"${PLUGIN_ROOT}/hooks/post-tool-tips.mjs\"",
+        "priority": 2,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "중요 경로 변경 시 opt-in rules reminder 주입 (#245)"
       }
     ],
     "PostToolUseFailure": [
@@ -157,8 +191,8 @@
         "priority": 2,
         "enabled": true,
         "timeout": 8,
-        "blocking": false,
-        "description": "tfx-hub 서비스 헬스체크 및 시작"
+        "blocking": true,
+        "description": "tfx-hub 서비스 헬스체크 및 시작 (BLOCKING — 세션 시작 전 Hub 준비 보장)"
       },
       {
         "id": "tfx-preflight-cache",
@@ -182,13 +216,25 @@
         "blocking": false,
         "description": "supergateway MCP 서비스 헬스체크 및 자동 기동"
       },
+      {
+        "id": "tfx-session-stale-cleanup",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/scripts/session-stale-cleanup.mjs\"",
+        "priority": 5,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "이전 세션의 stale tfx-multi 상태 파일 정리 (#62)"
+      },
       {
         "id": "ext-session-vault-start",
         "source": "session-vault",
+        "requires": "$HOME/Desktop/Projects/tools/session-vault",
         "matcher": "*",
         "command": "bash \"${HOME}/Desktop/Projects/tools/session-vault/scripts/start_hook.sh\"",
         "priority": 100,
-        "enabled": true,
+        "enabled": false,
         "timeout": 10,
         "blocking": false,
         "description": "세션 볼트 로깅 시작"
@@ -204,15 +250,16 @@
         "enabled": true,
         "timeout": 5,
         "blocking": true,
-        "description": "활성 파이프라인 감지 → 종료 차단"
+        "description": "컨텍스트 guard/retry cap + 활성 파이프라인 감지 → Stop 차단"
       },
       {
         "id": "ext-session-vault-export",
         "source": "session-vault",
+        "requires": "$HOME/Desktop/Projects/tools/session-vault",
         "matcher": "*",
         "command": "bash \"${HOME}/Desktop/Projects/tools/session-vault/scripts/export_hook.sh\"",
         "priority": 100,
-        "enabled": true,
+        "enabled": false,
         "timeout": 30,
         "blocking": false,
         "description": "세션 트랜스크립트 내보내기"
@@ -223,24 +270,74 @@
         "matcher": "*",
         "command": "powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File \"${HOME}/.claude/scripts/mcp-cleanup.ps1\"",
         "priority": 100,
-        "enabled": true,
+        "enabled": false,
         "timeout": 8,
         "blocking": false,
         "description": "MCP 고아 프로세스 정리"
       }
     ],
+    "SessionEnd": [
+      {
+        "id": "tfx-session-end-cleanup",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/session-end-cleanup.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "세션 종료 시 lifecycle 상태 보고 및 opt-in 정리 (#245)"
+      }
+    ],
+    "SubagentStart": [
+      {
+        "id": "tfx-subagent-tracker",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/subagent-tracker.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "서브에이전트 lifecycle 시작/종료 상태 추적 (#245)"
+      }
+    ],
     "SubagentStop": [
+      {
+        "id": "tfx-subagent-tracker",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/subagent-tracker.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "서브에이전트 lifecycle 시작/종료 상태 추적 (#245)"
+      },
       {
         "id": "tfx-subagent-verifier",
         "source": "triflux",
         "matcher": "*",
         "command": "node \"${PLUGIN_ROOT}/hooks/subagent-verifier.mjs\"",
-        "priority": 0,
+        "priority": 1,
         "enabled": true,
         "timeout": 3,
         "blocking": false,
         "description": "서브에이전트 결과 품질 체크"
       }
+    ],
+    "PreCompact": [
+      {
+        "id": "tfx-pre-compact-snapshot",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/pre-compact-snapshot.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "compact 직전 repo-local 진행 상태 스냅샷 주입 (#245)"
+      }
     ]
   }
 }

package/hooks/hooks.json

@@ -25,6 +25,18 @@
         ]
       }
     ],
+    "PermissionRequest": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
     "PreToolUse": [
       {
         "matcher": "Bash|Agent|Skill",
@@ -39,7 +51,7 @@
     ],
     "PostToolUse": [
       {
-        "matcher": "Edit|Write",
+        "matcher": "Bash|Edit|Write",
         "hooks": [
           {
             "type": "command",
@@ -73,6 +85,30 @@
         ]
       }
     ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "SubagentStop": [
       {
         "matcher": "*",
@@ -84,6 +120,18 @@
           }
         ]
       }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
     ]
   }
 }