@triflux/core 10.49.0 → 10.50.1

package/hooks/hook-orchestrator.mjs

@@ -1,651 +1,11 @@
 #!/usr/bin/env node
+// ADR-0023 전환 stub. 다음 릴리스에서 지운다.
+import { readFileSync } from "node:fs";
+import { cleanupLegacyHooks } from "../scripts/lib/legacy-hook-cleanup.mjs";
 
-// 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 { 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 { 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() {
-  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 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);
-  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;
-  }
+try {
+  readFileSync(0);
+  cleanupLegacyHooks();
+} catch {
+  // 오래된 Claude hook이 남아 있어도 세션 시작을 막지 않는다.
 }
-
-// ── 라우팅 가중치 기록 ────────────────────────────────────────
-function recordRouteOutcome(slug, mode, outcome) {
-  const home = process.env.HOME || process.env.USERPROFILE || "";
-  const projDir = join(home, ".gstack", "projects", slug);
-  const weightsPath = join(projDir, "routing-weights.json");
-
-  mkdirSync(projDir, { recursive: true });
-
-  const weights = existsSync(weightsPath)
-    ? JSON.parse(readFileSync(weightsPath, "utf8"))
-    : {
-        updated_at: null,
-        total_routes: 0,
-        overrides: 0,
-        weights: { mode_bias: {}, profile_bias: {}, depth_bias: {} },
-      };
-
-  weights.total_routes++;
-  weights.updated_at = new Date().toISOString();
-
-  const bias = weights.weights.mode_bias;
-  const current = bias[mode] || 0;
-
-  if (outcome === "override") {
-    bias[mode] = Math.max(0, current - 0.1);
-    weights.overrides++;
-  } else if (outcome === "completion") {
-    bias[mode] = Math.min(1, current + 0.05);
-  } else if (outcome === "abort") {
-    bias[mode] = Math.max(0, current - 0.1);
-  }
-
-  const total = Object.values(bias).reduce((s, v) => s + v, 0);
-  if (total > 0) {
-    for (const key of Object.keys(bias)) {
-      bias[key] = +(bias[key] / total).toFixed(3);
-    }
-  }
-
-  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>
-  const rrIdx = process.argv.indexOf("--record-route");
-  if (rrIdx !== -1) {
-    const slug = process.argv[rrIdx + 1];
-    const mode = process.argv[rrIdx + 2];
-    const outcome = process.argv[rrIdx + 3];
-    if (slug && mode && outcome) recordRouteOutcome(slug, mode, outcome);
-    process.exit(0);
-  }
-
-  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 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`,
-      );
-    }
-  }
-
-  // ── UserPromptSubmit: interactive 세션 liveness heartbeat ──
-  // SessionStart 가 register, 매 프롬프트가 갱신한다(사용자 활동 = liveness). 이
-  // 갱신이 없으면 hub monitor 가 5분 TTL 후 세션을 stale 로 전이시켜 `cto status`
-  // 의 live_sessions 가 항상 비어 보인다. fire-and-forget POST 는 process.exit 가
-  // 버리므로(cf. [[project_process_exit_drops_fire_and_forget]]) 발사 직후 바로
-  // drain 한다 — 아래 registry hook 이 없어 early-exit 하는 경로에서도 flush 를
-  // 보장하기 위해서다. drain 은 localhost POST 라 보통 즉시 반환되고, hub stall
-  // 시에만 짧은 상한(500ms)으로 프롬프트 지연을 막는다. keyword-detector /
-  // north-star 등 registry hook 은 그 뒤로 평소대로 실행된다.
-  if (eventName === "UserPromptSubmit") {
-    try {
-      const { heartbeatInteractiveSession } = await import(
-        "./session-start-fast.mjs"
-      );
-      heartbeatInteractiveSession(stdinRaw);
-      const { drainPendingSynapse } = await import(
-        "../hub/team/synapse-http.mjs"
-      );
-      await drainPendingSynapse(500);
-    } catch {
-      /* best-effort — heartbeat 실패가 프롬프트 턴을 막지 않는다 */
-    }
-  }
-
-  // ── Stop: interactive 세션 liveness heartbeat (턴 종료 시) ──
-  // UserPromptSubmit 은 턴 *시작* 에, Stop 은 매 어시스턴트 턴 *종료* 에 heartbeat
-  // 한다. 둘이 함께 "대화 중이지만 매 분 새 프롬프트를 보내지는 않는" 세션을 5분
-  // interactive TTL 위로 유지해, 대화 도중 stale 로 떨어져 `cto status`
-  // live_sessions 에서 사라지는 것을 막는다. 진짜 완전 idle(턴 자체가 없음)
-  // 은 여전히 TTL 후 stale 로 가며 — 그게 의도된 dead-session 신호다. UserPromptSubmit
-  // 과 동일하게 fire-and-forget POST 직후 짧은 상한으로 drain 한다.
-  if (eventName === "Stop") {
-    try {
-      const { heartbeatInteractiveSession } = await import(
-        "./session-start-fast.mjs"
-      );
-      heartbeatInteractiveSession(stdinRaw);
-      const { drainPendingSynapse } = await import(
-        "../hub/team/synapse-http.mjs"
-      );
-      await drainPendingSynapse(500);
-    } catch {
-      /* best-effort — heartbeat 실패가 Stop 을 막지 않는다 */
-    }
-  }
-
-  // 이벤트에 해당하는 훅 목록
-  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;
-  let blockingStderr = "";
-
-  if (dedupePreToolUseBash) {
-    for (const hook of matched) {
-      const result = executeHook(hook, stdinRaw);
-      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());
-      }
-      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) {
-          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));
-  }
-
-  process.exit(0);
-}
-
-main().catch((err) => {
-  // 오케스트레이터 자체 실패 → 비차단
-  process.stderr.write(`[hook-orchestrator] error: ${err.message}\n`);
-  process.exit(0);
-});

package/hooks/lib/resolve-root.mjs

@@ -15,7 +15,7 @@ function normalizeCandidate(candidate) {
 function isValidPluginRoot(candidate) {
   const root = normalizeCandidate(candidate);
   if (!root) return false;
-  return existsSync(join(root, "hooks", "hook-orchestrator.mjs"));
+  return existsSync(join(root, "hooks", "codex-session-hook.mjs"));
 }
 
 function toPluginRootFromUrl(url) {