triflux 10.4.0 → 10.7.0

package/hooks/safety-guard.mjs

@@ -8,23 +8,51 @@
 //   BLOCK (exit 2)  — 복구 불가능한 파괴적 명령
 //   WARN  (allow + context) — 주의가 필요한 명령
 
-import { readFileSync, existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 
 // ── 차단 규칙 ──────────────────────────────────────────────
 const BLOCK_RULES = [
-  { pattern: /\brm\s+(-[^\s]*)?-rf?\s+[/~](?!tmp\b)(?!\S*node_modules)/i, reason: "루트/홈 디렉토리 rm -rf 차단" },
-  { pattern: /\brm\s+(-[^\s]*)?-rf?\s+\.\s*$/i, reason: "현재 디렉토리 rm -rf . 차단" },
-  { pattern: /\bgit\s+push\s+.*--force\s+.*\b(main|master)\b/i, reason: "main/master force push 차단" },
-  { pattern: /\bgit\s+push\s+--force\s*$/i, reason: "대상 미지정 force push 차단" },
-  { pattern: /\bgit\s+reset\s+--hard\s+origin\//i, reason: "remote reset --hard 차단 — 로컬 작업 소실 위험" },
+  {
+    pattern: /\brm\s+(-[^\s]*)?-rf?\s+[/~](?!tmp\b)(?!\S*node_modules)/i,
+    reason: "루트/홈 디렉토리 rm -rf 차단",
+  },
+  {
+    pattern: /\brm\s+(-[^\s]*)?-rf?\s+\.\s*$/i,
+    reason: "현재 디렉토리 rm -rf . 차단",
+  },
+  {
+    pattern: /\bgit\s+push\s+.*--force\s+.*\b(main|master)\b/i,
+    reason: "main/master force push 차단",
+  },
+  {
+    pattern: /\bgit\s+push\s+--force\s*$/i,
+    reason: "대상 미지정 force push 차단",
+  },
+  {
+    pattern: /\bgit\s+reset\s+--hard\s+origin\//i,
+    reason: "remote reset --hard 차단 — 로컬 작업 소실 위험",
+  },
   { pattern: /\bdrop\s+(table|database|schema)\b/i, reason: "SQL DROP 차단" },
   { pattern: /\btruncate\s+table\b/i, reason: "SQL TRUNCATE 차단" },
   { pattern: /\bformat\s+[a-z]:/i, reason: "디스크 포맷 차단" },
   { pattern: /\b(del|rmdir)\s+\/[sq]\b/i, reason: "Windows 재귀 삭제 차단" },
-  { pattern: /\bgit\s+clean\s+.*-fd/i, reason: "git clean -fd 차단 — 추적되지 않은 파일 소실 위험" },
-  { pattern: /\bpsmux\s+kill-session\b/i, reason: "raw psmux kill-session 차단 — WT ConPTY 프리징 위험. 안전 경로: node hub/team/psmux.mjs kill --session <name>", skipIfGit: true },
-  { pattern: /\bpsmux\s+kill-server\b/i, reason: "psmux kill-server 차단 — 모든 세션이 즉시 종료됩니다. node hub/team/psmux.mjs kill-swarm 사용", skipIfGit: true },
+  {
+    pattern: /\bgit\s+clean\s+.*-fd/i,
+    reason: "git clean -fd 차단 — 추적되지 않은 파일 소실 위험",
+  },
+  {
+    pattern: /\bpsmux\s+kill-session\b/i,
+    reason:
+      "raw psmux kill-session 차단 — WT ConPTY 프리징 위험. 안전 경로: node hub/team/psmux.mjs kill --session <name>",
+    skipIfGit: true,
+  },
+  {
+    pattern: /\bpsmux\s+kill-server\b/i,
+    reason:
+      "psmux kill-server 차단 — 모든 세션이 즉시 종료됩니다. node hub/team/psmux.mjs kill-swarm 사용",
+    skipIfGit: true,
+  },
 ];
 
 const WT_DIRECT_PATTERNS = [
@@ -42,12 +70,12 @@ const WT_DIRECT_BLOCK_MESSAGE =
 // ── SSH+PowerShell bash 문법 차단 ────────────────────────────
 // 원격 기본 셸이 PowerShell인 호스트에 bash redirect/glob을 보내면 오동작
 const BASH_SYNTAX_IN_SSH = [
-  /2>\/dev\/null/,          // 2>/dev/null → PowerShell에서 Out-File C:\dev\null
-  />\s*\/dev\/null/,        // >/dev/null
-  /&>\s*\/dev\/null/,       // &>/dev/null
-  /\$\(/,                   // $(cmd) → PowerShell에서 다른 의미
-  /\bsource\s+/,            // source → PowerShell에 없음
-  /\bexport\s+\w+=/,        // export VAR= → PowerShell에 없음
+  /2>\/dev\/null/, // 2>/dev/null → PowerShell에서 Out-File C:\dev\null
+  />\s*\/dev\/null/, // >/dev/null
+  /&>\s*\/dev\/null/, // &>/dev/null
+  /\$\(/, // $(cmd) → PowerShell에서 다른 의미
+  /\bsource\s+/, // source → PowerShell에 없음
+  /\bexport\s+\w+=/, // export VAR= → PowerShell에 없음
 ];
 
 const SSH_POWERSHELL_HINT =
@@ -56,28 +84,59 @@ const SSH_POWERSHELL_HINT =
 
 // ── 경고 규칙 ──────────────────────────────────────────────
 const WARN_RULES = [
-  { pattern: /\bgit\s+push\b(?!.*--force)/i, warn: "git push 감지. 원격 저장소에 반영됩니다." },
-  { pattern: /\bgit\s+rebase\b/i, warn: "git rebase 감지. 커밋 히스토리가 변경됩니다." },
+  {
+    pattern: /\bgit\s+push\b(?!.*--force)/i,
+    warn: "git push 감지. 원격 저장소에 반영됩니다.",
+  },
+  {
+    pattern: /\bgit\s+rebase\b/i,
+    warn: "git rebase 감지. 커밋 히스토리가 변경됩니다.",
+  },
   { pattern: /\bgit\s+branch\s+-[dD]\b/i, warn: "브랜치 삭제 감지." },
-  { pattern: /\bnpm\s+publish\b/i, warn: "npm publish 감지. 공개 레지스트리에 배포됩니다." },
-  { pattern: /\brm\s+(-[^\s]*)?-rf?\s/i, warn: "재귀 삭제 감지. 대상을 확인하세요." },
-  { pattern: /--no-verify\b/i, warn: "--no-verify 감지. 훅 건너뛰기는 권장하지 않습니다." },
+  {
+    pattern: /\bnpm\s+publish\b/i,
+    warn: "npm publish 감지. 공개 레지스트리에 배포됩니다.",
+  },
+  {
+    pattern: /\brm\s+(-[^\s]*)?-rf?\s/i,
+    warn: "재귀 삭제 감지. 대상을 확인하세요.",
+  },
+  {
+    pattern: /--no-verify\b/i,
+    warn: "--no-verify 감지. 훅 건너뛰기는 권장하지 않습니다.",
+  },
   { pattern: /\bchmod\s+777\b/i, warn: "chmod 777 감지. 보안 위험." },
-  { pattern: /\bcurl\s.*\|\s*(bash|sh)\b/i, warn: "curl | sh 감지. 원격 스크립트 실행 주의." },
+  {
+    pattern: /\bcurl\s.*\|\s*(bash|sh)\b/i,
+    warn: "curl | sh 감지. 원격 스크립트 실행 주의.",
+  },
 ];
 
 // ── reflexion 적응형 패널티 로드 ──────────────────────────────
 function loadReflexionPenalties() {
   try {
     const home = process.env.HOME || process.env.USERPROFILE || "";
-    const penaltyFile = join(home, ".triflux", "reflexion", "pending-penalties.jsonl");
+    const penaltyFile = join(
+      home,
+      ".triflux",
+      "reflexion",
+      "pending-penalties.jsonl",
+    );
     if (!existsSync(penaltyFile)) return [];
     return readFileSync(penaltyFile, "utf8")
       .split("\n")
       .filter(Boolean)
-      .map(line => { try { return JSON.parse(line); } catch { return null; } })
+      .map((line) => {
+        try {
+          return JSON.parse(line);
+        } catch {
+          return null;
+        }
+      })
       .filter(Boolean);
-  } catch { return []; }
+  } catch {
+    return [];
+  }
 }
 
 function readStdin() {
@@ -89,7 +148,11 @@ function readStdin() {
 }
 
 function shouldSkipSegment(segment) {
-  return !segment || segment.startsWith("#") || /^\s*(echo|printf|grep|git\s+commit)\b/i.test(segment);
+  return (
+    !segment ||
+    segment.startsWith("#") ||
+    /^\s*(echo|printf|grep|git\s+commit)\b/i.test(segment)
+  );
 }
 
 function hasSegmentInvocation(cmd, patterns) {
@@ -122,7 +185,7 @@ function blockCommand(message, command) {
   process.stderr.write(
     `${message}\n` +
       `명령어: ${command.slice(0, 120)}${command.length > 120 ? "..." : ""}\n` +
-      "이 명령은 실행할 수 없습니다. 안전한 대안을 사용하세요."
+      "이 명령은 실행할 수 없습니다. 안전한 대안을 사용하세요.",
   );
   process.exit(2);
 }
@@ -161,7 +224,15 @@ function main() {
   const penalties = loadReflexionPenalties();
   if (penalties.length > 0) {
     for (const penalty of penalties) {
-      if (penalty.error_pattern && new RegExp(penalty.error_pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").slice(0, 80), "i").test(command)) {
+      if (
+        penalty.error_pattern &&
+        new RegExp(
+          penalty.error_pattern
+            .replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+            .slice(0, 80),
+          "i",
+        ).test(command)
+      ) {
         const output = {
           hookSpecificOutput: {
             hookEventName: "PreToolUse",
@@ -186,7 +257,7 @@ function main() {
       const sshMatch = seg.trim().match(/^ssh\s+\S+\s+(.*)/s);
       if (!sshMatch) continue;
       const sshPayload = sshMatch[1];
-      const bashSyntax = BASH_SYNTAX_IN_SSH.find(p => p.test(sshPayload));
+      const bashSyntax = BASH_SYNTAX_IN_SSH.find((p) => p.test(sshPayload));
       if (bashSyntax) {
         blockCommand(
           `[safety-guard] SSH 명령에 bash 전용 문법 감지: ${bashSyntax}. ${SSH_POWERSHELL_HINT}`,

package/hooks/session-start-fast.mjs

@@ -0,0 +1,143 @@
+// hooks/session-start-fast.mjs — SessionStart in-process fast-path
+//
+// hook-orchestrator.mjs가 SessionStart 이벤트일 때 이 모듈을 dynamic import.
+// 6개 훅을 1개 node 프로세스 안에서 실행하여 콜드스타트 7회 → 1회로 줄인다.
+//
+// 분류:
+//   BLOCKING  (직렬, stdout 반환 전 완료): setup.runCritical, mcp-safety-guard.run
+//   DEFERRED  (병렬, 실패해도 안 죽음):   hub-ensure.run, mcp-gateway-ensure.run, setup.runDeferred
+//   BACKGROUND (fire-and-forget):          preflight-cache.run
+//
+// external source 훅 (session-vault 등)은 여전히 execFile로 실행된다.
+
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createModuleLogger } from "../scripts/lib/logger.mjs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SCRIPTS = join(__dirname, "..", "scripts");
+
+const log = createModuleLogger("session-start-fast");
+
+/**
+ * BLOCKING 훅을 순차 실행. 하나라도 throw하면 로그만 남기고 계속.
+ * @param {string} stdinData
+ * @returns {Promise<{stdout: string, stderr: string}>}
+ */
+async function runBlocking(stdinData) {
+  const output = { stdout: "", stderr: "" };
+  const timings = [];
+
+  // 1. setup.runCritical — 환경 초기화 필수
+  try {
+    const t0 = performance.now();
+    const setup = await import(join(SCRIPTS, "setup.mjs"));
+    const result = await setup.runCritical(stdinData);
+    const dur = performance.now() - t0;
+    timings.push({ hook: "setup.critical", dur_ms: Math.round(dur) });
+    if (result?.stdout) output.stdout += result.stdout + "\n";
+    if (result?.stderr) output.stderr += result.stderr + "\n";
+    log.info({ hook: "setup.critical", dur_ms: Math.round(dur) }, "hook.completed");
+  } catch (err) {
+    log.error({ hook: "setup.critical", err: String(err.message || err) }, "hook.failed");
+  }
+
+  // 2. mcp-safety-guard.run — EPERM 방지
+  try {
+    const t0 = performance.now();
+    const guard = await import(join(SCRIPTS, "mcp-safety-guard.mjs"));
+    guard.run();
+    const dur = performance.now() - t0;
+    timings.push({ hook: "mcp-safety-guard", dur_ms: Math.round(dur) });
+    log.info({ hook: "mcp-safety-guard", dur_ms: Math.round(dur) }, "hook.completed");
+  } catch (err) {
+    log.error({ hook: "mcp-safety-guard", err: String(err.message || err) }, "hook.failed");
+  }
+
+  return { ...output, timings };
+}
+
+/**
+ * DEFERRED 훅을 병렬 실행. 실패해도 crash 안 함, 로그만 남김.
+ * Promise는 의도적으로 관리하지 않음 (fire-and-forget with logging).
+ * @param {string} stdinData
+ */
+function runDeferred(stdinData) {
+  const tasks = [
+    {
+      name: "hub-ensure",
+      fn: async () => {
+        const mod = await import(join(SCRIPTS, "hub-ensure.mjs"));
+        return mod.run(stdinData);
+      },
+    },
+    {
+      name: "mcp-gateway-ensure",
+      fn: async () => {
+        const mod = await import(join(SCRIPTS, "mcp-gateway-ensure.mjs"));
+        return mod.run(stdinData);
+      },
+    },
+    {
+      name: "setup.deferred",
+      fn: async () => {
+        const mod = await import(join(SCRIPTS, "setup.mjs"));
+        return mod.runDeferred(stdinData);
+      },
+    },
+  ];
+
+  for (const task of tasks) {
+    const t0 = performance.now();
+    task.fn()
+      .then((result) => {
+        const dur = performance.now() - t0;
+        log.info({ hook: task.name, dur_ms: Math.round(dur), code: result?.code }, "deferred.completed");
+      })
+      .catch((err) => {
+        const dur = performance.now() - t0;
+        log.error({ hook: task.name, dur_ms: Math.round(dur), err: String(err.message || err) }, "deferred.failed");
+      });
+  }
+}
+
+/**
+ * BACKGROUND 훅. fire-and-forget.
+ * @param {string} stdinData
+ */
+function runBackground(stdinData) {
+  // preflight-cache
+  import(join(SCRIPTS, "preflight-cache.mjs"))
+    .then((mod) => mod.run(stdinData))
+    .catch(() => {}); // 완전 무시
+
+  // session-vault은 external source — hook-orchestrator가 execFile로 실행
+}
+
+/**
+ * SessionStart fast-path 진입점.
+ * hook-orchestrator.mjs에서 호출된다.
+ *
+ * @param {string} stdinData — orchestrator가 전달하는 stdin JSON
+ * @param {Array} externalHooks — source !== 'triflux'인 훅 목록 (orchestrator가 execFile로 실행)
+ * @returns {Promise<{stdout: string, stderr: string, timings: Array}>}
+ */
+export async function execute(stdinData, externalHooks = []) {
+  const totalStart = performance.now();
+
+  // BLOCKING: 프롬프트 전 완료 필수
+  const blocking = await runBlocking(stdinData);
+
+  // DEFERRED + BACKGROUND: fire-and-forget
+  runDeferred(stdinData);
+  runBackground(stdinData);
+
+  const totalDur = performance.now() - totalStart;
+  log.info({ total_ms: Math.round(totalDur), blocking_count: 2, deferred_count: 3, bg_count: 1 }, "session-start.done");
+
+  return {
+    stdout: blocking.stdout,
+    stderr: blocking.stderr,
+    timings: blocking.timings,
+  };
+}

package/hooks/subagent-verifier.mjs

@@ -29,7 +29,8 @@ function main() {
 
   const agentType = input.agent_type || input.subagent_type || "unknown";
   const result = input.tool_output || input.result || "";
-  const resultStr = typeof result === "string" ? result : JSON.stringify(result);
+  const resultStr =
+    typeof result === "string" ? result : JSON.stringify(result);
 
   const issues = [];
 
@@ -37,7 +38,7 @@ function main() {
   if (!resultStr.trim() || resultStr.trim().length < 20) {
     issues.push(
       `서브에이전트(${agentType})가 거의 빈 결과를 반환했습니다. ` +
-        "프롬프트를 더 구체적으로 작성하거나, 다른 subagent_type을 시도하세요."
+        "프롬프트를 더 구체적으로 작성하거나, 다른 subagent_type을 시도하세요.",
     );
   }
 
@@ -50,7 +51,7 @@ function main() {
   if (hasError && resultStr.length > 50) {
     issues.push(
       `서브에이전트(${agentType}) 결과에 에러 신호가 감지되었습니다. ` +
-        "결과를 검토하고, 필요 시 다른 접근 방식을 사용하세요."
+        "결과를 검토하고, 필요 시 다른 접근 방식을 사용하세요.",
     );
   }
 
@@ -58,7 +59,7 @@ function main() {
   if (resultStr.length > 15000) {
     issues.push(
       `서브에이전트(${agentType}) 결과가 ${Math.round(resultStr.length / 1000)}K 자입니다. ` +
-        "핵심만 추출하여 컨텍스트 윈도우를 절약하세요."
+        "핵심만 추출하여 컨텍스트 윈도우를 절약하세요.",
     );
   }