triflux 7.1.4 → 7.2.2

package/scripts/__tests__/keyword-detector.test.mjs

@@ -1,234 +1,234 @@
-import assert from "node:assert/strict";
-import { spawnSync } from "node:child_process";
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import test from "node:test";
-import { fileURLToPath } from "node:url";
-import { compileRules, loadRules, matchRules, resolveConflicts } from "../lib/keyword-rules.mjs";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const projectRoot = resolve(__dirname, "..", "..");
-const rulesPath = join(projectRoot, "hooks", "keyword-rules.json");
-const detectorScriptPath = join(projectRoot, "scripts", "keyword-detector.mjs");
-
-// keyword-detector는 import 시 main()이 실행되므로, 테스트 로딩 단계에서만 안전하게 비활성화한다.
-const previousDisable = process.env.TRIFLUX_DISABLE_MAGICWORDS;
-const previousLog = console.log;
-process.env.TRIFLUX_DISABLE_MAGICWORDS = "1";
-console.log = () => {};
-const detectorModule = await import("../keyword-detector.mjs");
-console.log = previousLog;
-if (previousDisable === undefined) {
-  delete process.env.TRIFLUX_DISABLE_MAGICWORDS;
-} else {
-  process.env.TRIFLUX_DISABLE_MAGICWORDS = previousDisable;
-}
-
-const { extractPrompt, sanitizeForKeywordDetection } = detectorModule;
-
-function loadCompiledRules() {
-  const rules = loadRules(rulesPath);
-  assert.equal(rules.length, 21);
-  return compileRules(rules);
-}
-
-function runDetector(prompt) {
-  const payload = { prompt, cwd: projectRoot };
-  const result = spawnSync(process.execPath, [detectorScriptPath], {
-    input: JSON.stringify(payload),
-    encoding: "utf8"
-  });
-
-  assert.equal(result.status, 0, result.stderr);
-  assert.ok(result.stdout.trim(), "keyword-detector 출력이 비어 있습니다.");
-  return JSON.parse(result.stdout.trim());
-}
-
-test("extractPrompt: prompt/message.content/parts[].text 우선순위", () => {
-  assert.equal(
-    extractPrompt({
-      prompt: "from prompt",
-      message: { content: "from message" },
-      parts: [{ text: "from parts" }]
-    }),
-    "from prompt"
-  );
-
-  assert.equal(
-    extractPrompt({
-      prompt: "   ",
-      message: { content: "from message" },
-      parts: [{ text: "from parts" }]
-    }),
-    "from message"
-  );
-
-  assert.equal(
-    extractPrompt({
-      message: { content: [{ text: "from message-part" }] },
-      parts: [{ text: "from parts" }]
-    }),
-    "from message-part"
-  );
-
-  assert.equal(extractPrompt({ parts: [{ text: "from parts" }] }), "from parts");
-});
-
-test("sanitizeForKeywordDetection: 코드블록/URL/파일경로/XML 태그 제거", () => {
-  const input = [
-    "정상 문장",
-    "```sh",
-    "tfx multi",
-    "```",
-    "https://example.com/path?q=1",
-    "C:\\Users\\SSAFY\\Desktop\\Projects\\tools\\triflux",
-    "./hooks/keyword-rules.json",
-    "<tag>jira 이슈 생성</tag>"
-  ].join("\n");
-
-  const sanitized = sanitizeForKeywordDetection(input);
-
-  assert.ok(sanitized.includes("정상 문장"));
-  assert.ok(!sanitized.includes("tfx multi"));
-  assert.ok(!sanitized.includes("https://"));
-  assert.ok(!sanitized.includes("C:\\Users\\"));
-  assert.ok(!sanitized.includes("./hooks/keyword-rules.json"));
-  assert.ok(!sanitized.includes("<tag>"));
-  assert.ok(!sanitized.includes("jira 이슈 생성"));
-});
-
-test("loadRules: 유효한 JSON 로드", () => {
-  const rules = loadRules(rulesPath);
-  assert.equal(rules.length, 21);
-  assert.equal(rules.filter((rule) => rule.skill).length, 10);
-  assert.equal(rules.filter((rule) => rule.mcp_route).length, 10);
-});
-
-test("loadRules: 잘못된 파일 처리", () => {
-  const tempDir = mkdtempSync(join(tmpdir(), "triflux-rules-"));
-  const invalidPath = join(tempDir, "invalid.json");
-  writeFileSync(invalidPath, "{ invalid json", "utf8");
-
-  const malformed = loadRules(invalidPath);
-  const missing = loadRules(join(tempDir, "missing.json"));
-
-  assert.deepEqual(malformed, []);
-  assert.deepEqual(missing, []);
-
-  rmSync(tempDir, { recursive: true, force: true });
-});
-
-test("compileRules: 정규식 컴파일 성공", () => {
-  const rules = loadRules(rulesPath);
-  const compiled = compileRules(rules);
-  assert.equal(compiled.length, 21);
-  for (const rule of compiled) {
-    assert.ok(Array.isArray(rule.compiledPatterns));
-    assert.ok(rule.compiledPatterns.length > 0);
-    for (const pattern of rule.compiledPatterns) {
-      assert.ok(pattern instanceof RegExp);
-    }
-  }
-});
-
-test("compileRules: 정규식 컴파일 실패", () => {
-  const compiled = compileRules([
-    {
-      id: "bad-pattern",
-      priority: 1,
-      patterns: [{ source: "[", flags: "" }],
-      skill: "tfx-multi",
-      supersedes: [],
-      exclusive: false,
-      state: null,
-      mcp_route: null
-    }
-  ]);
-
-  assert.deepEqual(compiled, []);
-});
-
-test("matchRules: tfx 키워드 매칭", () => {
-  const compiledRules = loadCompiledRules();
-  const cases = [
-    { text: "tfx multi 세션 시작", expectedId: "tfx-multi" },
-    { text: "tfx auto 돌려줘", expectedId: "tfx-auto" },
-    { text: "tfx codex 로 실행", expectedId: "tfx-codex" },
-    { text: "tfx gemini 로 실행", expectedId: "tfx-gemini" },
-    { text: "canceltfx", expectedId: "tfx-cancel" }
-  ];
-
-  for (const { text, expectedId } of cases) {
-    const clean = sanitizeForKeywordDetection(text);
-    const matches = matchRules(compiledRules, clean);
-    assert.ok(matches.some((match) => match.id === expectedId), `${text} => ${expectedId} 미매칭`);
-  }
-});
-
-test("matchRules: MCP 라우팅 매칭", () => {
-  const compiledRules = loadCompiledRules();
-  const cases = [
-    { text: "노션 페이지 조회해줘", expectedId: "notion-route", expectedRoute: "gemini" },
-    { text: "jira 이슈 생성", expectedId: "jira-route", expectedRoute: "codex" },
-    { text: "크롬 열고 로그인", expectedId: "chrome-route", expectedRoute: "gemini" },
-    { text: "이메일 보내줘", expectedId: "mail-route", expectedRoute: "gemini" },
-    { text: "캘린더 일정 생성", expectedId: "calendar-route", expectedRoute: "gemini" },
-    { text: "playwright 테스트 작성", expectedId: "playwright-route", expectedRoute: "gemini" },
-    { text: "canva 디자인 생성", expectedId: "canva-route", expectedRoute: "gemini" }
-  ];
-
-  for (const { text, expectedId, expectedRoute } of cases) {
-    const matches = matchRules(compiledRules, sanitizeForKeywordDetection(text));
-    const matched = matches.find((match) => match.id === expectedId);
-    assert.ok(matched, `${text} => ${expectedId} 미매칭`);
-    assert.equal(matched.mcp_route, expectedRoute);
-  }
-});
-
-test("matchRules: 일반 대화는 매칭 없음", () => {
-  const compiledRules = loadCompiledRules();
-  const matches = matchRules(compiledRules, sanitizeForKeywordDetection("오늘 점심 메뉴 추천해줘"));
-  assert.deepEqual(matches, []);
-});
-
-test("resolveConflicts: priority 정렬 및 supersedes 처리", () => {
-  const resolved = resolveConflicts([
-    { id: "rule-c", priority: 3, supersedes: [], exclusive: false },
-    { id: "rule-b", priority: 2, supersedes: ["rule-c"], exclusive: false },
-    { id: "rule-a", priority: 1, supersedes: [], exclusive: false },
-    { id: "rule-a", priority: 1, supersedes: [], exclusive: false }
-  ]);
-
-  assert.deepEqual(
-    resolved.map((rule) => rule.id),
-    ["rule-a", "rule-b"]
-  );
-});
-
-test("resolveConflicts: exclusive 처리", () => {
-  const resolved = resolveConflicts([
-    { id: "normal", priority: 1, supersedes: [], exclusive: false },
-    { id: "exclusive", priority: 0, supersedes: [], exclusive: true },
-    { id: "later", priority: 2, supersedes: [], exclusive: false }
-  ]);
-
-  assert.deepEqual(resolved.map((rule) => rule.id), ["exclusive"]);
-});
-
-test("코드블록 내 키워드: sanitize 후 매칭 안 됨", () => {
-  const compiledRules = loadCompiledRules();
-  const input = ["```txt", "tfx multi", "jira 이슈 생성", "```"].join("\n");
-  const clean = sanitizeForKeywordDetection(input);
-  const matches = matchRules(compiledRules, clean);
-  assert.deepEqual(matches, []);
-});
-
-test("OMC 키워드와 triflux 키워드 비간섭 + TRIFLUX 네임스페이스", () => {
-  const omcLike = runDetector("my tfx multi 세션 보여줘");
-  assert.equal(omcLike.suppressOutput, true);
-
-  const triflux = runDetector("tfx multi 세션 시작");
-  const additionalContext = triflux?.hookSpecificOutput?.additionalContext || "";
-  assert.match(additionalContext, /^\[TRIFLUX MAGIC KEYWORD: tfx-multi\]/);
-});
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+import { compileRules, loadRules, matchRules, resolveConflicts } from "../lib/keyword-rules.mjs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = resolve(__dirname, "..", "..");
+const rulesPath = join(projectRoot, "hooks", "keyword-rules.json");
+const detectorScriptPath = join(projectRoot, "scripts", "keyword-detector.mjs");
+
+// keyword-detector는 import 시 main()이 실행되므로, 테스트 로딩 단계에서만 안전하게 비활성화한다.
+const previousDisable = process.env.TRIFLUX_DISABLE_MAGICWORDS;
+const previousLog = console.log;
+process.env.TRIFLUX_DISABLE_MAGICWORDS = "1";
+console.log = () => {};
+const detectorModule = await import("../keyword-detector.mjs");
+console.log = previousLog;
+if (previousDisable === undefined) {
+  delete process.env.TRIFLUX_DISABLE_MAGICWORDS;
+} else {
+  process.env.TRIFLUX_DISABLE_MAGICWORDS = previousDisable;
+}
+
+const { extractPrompt, sanitizeForKeywordDetection } = detectorModule;
+
+function loadCompiledRules() {
+  const rules = loadRules(rulesPath);
+  assert.equal(rules.length, 23);
+  return compileRules(rules);
+}
+
+function runDetector(prompt) {
+  const payload = { prompt, cwd: projectRoot };
+  const result = spawnSync(process.execPath, [detectorScriptPath], {
+    input: JSON.stringify(payload),
+    encoding: "utf8"
+  });
+
+  assert.equal(result.status, 0, result.stderr);
+  assert.ok(result.stdout.trim(), "keyword-detector 출력이 비어 있습니다.");
+  return JSON.parse(result.stdout.trim());
+}
+
+test("extractPrompt: prompt/message.content/parts[].text 우선순위", () => {
+  assert.equal(
+    extractPrompt({
+      prompt: "from prompt",
+      message: { content: "from message" },
+      parts: [{ text: "from parts" }]
+    }),
+    "from prompt"
+  );
+
+  assert.equal(
+    extractPrompt({
+      prompt: "   ",
+      message: { content: "from message" },
+      parts: [{ text: "from parts" }]
+    }),
+    "from message"
+  );
+
+  assert.equal(
+    extractPrompt({
+      message: { content: [{ text: "from message-part" }] },
+      parts: [{ text: "from parts" }]
+    }),
+    "from message-part"
+  );
+
+  assert.equal(extractPrompt({ parts: [{ text: "from parts" }] }), "from parts");
+});
+
+test("sanitizeForKeywordDetection: 코드블록/URL/파일경로/XML 태그 제거", () => {
+  const input = [
+    "정상 문장",
+    "```sh",
+    "tfx multi",
+    "```",
+    "https://example.com/path?q=1",
+    "C:\\Users\\SSAFY\\Desktop\\Projects\\tools\\triflux",
+    "./hooks/keyword-rules.json",
+    "<tag>jira 이슈 생성</tag>"
+  ].join("\n");
+
+  const sanitized = sanitizeForKeywordDetection(input);
+
+  assert.ok(sanitized.includes("정상 문장"));
+  assert.ok(!sanitized.includes("tfx multi"));
+  assert.ok(!sanitized.includes("https://"));
+  assert.ok(!sanitized.includes("C:\\Users\\"));
+  assert.ok(!sanitized.includes("./hooks/keyword-rules.json"));
+  assert.ok(!sanitized.includes("<tag>"));
+  assert.ok(!sanitized.includes("jira 이슈 생성"));
+});
+
+test("loadRules: 유효한 JSON 로드", () => {
+  const rules = loadRules(rulesPath);
+  assert.equal(rules.length, 23);
+  assert.equal(rules.filter((rule) => rule.skill).length, 10);
+  assert.equal(rules.filter((rule) => rule.mcp_route).length, 10);
+});
+
+test("loadRules: 잘못된 파일 처리", () => {
+  const tempDir = mkdtempSync(join(tmpdir(), "triflux-rules-"));
+  const invalidPath = join(tempDir, "invalid.json");
+  writeFileSync(invalidPath, "{ invalid json", "utf8");
+
+  const malformed = loadRules(invalidPath);
+  const missing = loadRules(join(tempDir, "missing.json"));
+
+  assert.deepEqual(malformed, []);
+  assert.deepEqual(missing, []);
+
+  rmSync(tempDir, { recursive: true, force: true });
+});
+
+test("compileRules: 정규식 컴파일 성공", () => {
+  const rules = loadRules(rulesPath);
+  const compiled = compileRules(rules);
+  assert.equal(compiled.length, 23);
+  for (const rule of compiled) {
+    assert.ok(Array.isArray(rule.compiledPatterns));
+    assert.ok(rule.compiledPatterns.length > 0);
+    for (const pattern of rule.compiledPatterns) {
+      assert.ok(pattern instanceof RegExp);
+    }
+  }
+});
+
+test("compileRules: 정규식 컴파일 실패", () => {
+  const compiled = compileRules([
+    {
+      id: "bad-pattern",
+      priority: 1,
+      patterns: [{ source: "[", flags: "" }],
+      skill: "tfx-multi",
+      supersedes: [],
+      exclusive: false,
+      state: null,
+      mcp_route: null
+    }
+  ]);
+
+  assert.deepEqual(compiled, []);
+});
+
+test("matchRules: tfx 키워드 매칭", () => {
+  const compiledRules = loadCompiledRules();
+  const cases = [
+    { text: "tfx multi 세션 시작", expectedId: "tfx-multi" },
+    { text: "tfx auto 돌려줘", expectedId: "tfx-auto" },
+    { text: "tfx codex 로 실행", expectedId: "tfx-codex" },
+    { text: "tfx gemini 로 실행", expectedId: "tfx-gemini" },
+    { text: "canceltfx", expectedId: "tfx-cancel" }
+  ];
+
+  for (const { text, expectedId } of cases) {
+    const clean = sanitizeForKeywordDetection(text);
+    const matches = matchRules(compiledRules, clean);
+    assert.ok(matches.some((match) => match.id === expectedId), `${text} => ${expectedId} 미매칭`);
+  }
+});
+
+test("matchRules: MCP 라우팅 매칭", () => {
+  const compiledRules = loadCompiledRules();
+  const cases = [
+    { text: "노션 페이지 조회해줘", expectedId: "notion-route", expectedRoute: "gemini" },
+    { text: "jira 이슈 생성", expectedId: "jira-route", expectedRoute: "codex" },
+    { text: "크롬 열고 로그인", expectedId: "chrome-route", expectedRoute: "gemini" },
+    { text: "이메일 보내줘", expectedId: "mail-route", expectedRoute: "gemini" },
+    { text: "캘린더 일정 생성", expectedId: "calendar-route", expectedRoute: "gemini" },
+    { text: "playwright 테스트 작성", expectedId: "playwright-route", expectedRoute: "gemini" },
+    { text: "canva 디자인 생성", expectedId: "canva-route", expectedRoute: "gemini" }
+  ];
+
+  for (const { text, expectedId, expectedRoute } of cases) {
+    const matches = matchRules(compiledRules, sanitizeForKeywordDetection(text));
+    const matched = matches.find((match) => match.id === expectedId);
+    assert.ok(matched, `${text} => ${expectedId} 미매칭`);
+    assert.equal(matched.mcp_route, expectedRoute);
+  }
+});
+
+test("matchRules: 일반 대화는 매칭 없음", () => {
+  const compiledRules = loadCompiledRules();
+  const matches = matchRules(compiledRules, sanitizeForKeywordDetection("오늘 점심 메뉴 추천해줘"));
+  assert.deepEqual(matches, []);
+});
+
+test("resolveConflicts: priority 정렬 및 supersedes 처리", () => {
+  const resolved = resolveConflicts([
+    { id: "rule-c", priority: 3, supersedes: [], exclusive: false },
+    { id: "rule-b", priority: 2, supersedes: ["rule-c"], exclusive: false },
+    { id: "rule-a", priority: 1, supersedes: [], exclusive: false },
+    { id: "rule-a", priority: 1, supersedes: [], exclusive: false }
+  ]);
+
+  assert.deepEqual(
+    resolved.map((rule) => rule.id),
+    ["rule-a", "rule-b"]
+  );
+});
+
+test("resolveConflicts: exclusive 처리", () => {
+  const resolved = resolveConflicts([
+    { id: "normal", priority: 1, supersedes: [], exclusive: false },
+    { id: "exclusive", priority: 0, supersedes: [], exclusive: true },
+    { id: "later", priority: 2, supersedes: [], exclusive: false }
+  ]);
+
+  assert.deepEqual(resolved.map((rule) => rule.id), ["exclusive"]);
+});
+
+test("코드블록 내 키워드: sanitize 후 매칭 안 됨", () => {
+  const compiledRules = loadCompiledRules();
+  const input = ["```txt", "tfx multi", "jira 이슈 생성", "```"].join("\n");
+  const clean = sanitizeForKeywordDetection(input);
+  const matches = matchRules(compiledRules, clean);
+  assert.deepEqual(matches, []);
+});
+
+test("OMC 키워드와 triflux 키워드 비간섭 + TRIFLUX 네임스페이스", () => {
+  const omcLike = runDetector("my tfx multi 세션 보여줘");
+  assert.equal(omcLike.suppressOutput, true);
+
+  const triflux = runDetector("tfx multi 세션 시작");
+  const additionalContext = triflux?.hookSpecificOutput?.additionalContext || "";
+  assert.match(additionalContext, /^\[TRIFLUX MAGIC KEYWORD: tfx-multi\]/);
+});

package/scripts/headless-guard-fast.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# headless-guard-fast.sh — bash pre-filter for headless-guard.mjs
+# psmux 미설치(캐시 ok=false) 시 Node.js 기동을 생략하여 89ms→~2ms로 단축
+CACHE="${TMPDIR:-${TEMP:-/tmp}}/tfx-psmux-check.json"
+GUARD_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+if [[ -f "$CACHE" ]]; then
+  # jq 없이 순수 bash로 파싱
+  ok_val=$(grep -o '"ok":[[:space:]]*\(true\|false\)' "$CACHE" | grep -o 'true\|false')
+  ts_val=$(grep -o '"ts":[[:space:]]*[0-9]*' "$CACHE" | grep -o '[0-9]*')
+  now_ms=$(($(date +%s) * 1000))
+  age_ms=$((now_ms - ${ts_val:-0}))
+
+  # 캐시 유효(5분 이내) + psmux 미설치 → 즉시 통과
+  if [[ "$ok_val" == "false" && $age_ms -lt 300000 ]]; then
+    exit 0
+  fi
+fi
+
+# 캐시 미스 또는 psmux 설치됨 → Node.js 실행
+exec node "$GUARD_DIR/headless-guard.mjs"

package/scripts/headless-guard.mjs

@@ -82,11 +82,11 @@ function parseRouteCommand(cmd) {
 
   // v3: 원본 명령에서 추가 플래그 추출
   const flags = {};
-  const timeoutMatch = cmd.match(/(?:^|\s)(\d{2,4})(?:\s|$)/);  // 4번째 인자 (timeout)
+  const afterPrompt = cmd.replace(/'.+?'/gs, "").replace(/".+?"/gs, "");
+  const timeoutMatch = afterPrompt.match(/(?:^|\s)(\d{2,4})(?:\s|$)/);  // 4번째 인자 (timeout)
   if (timeoutMatch) flags.timeout = parseInt(timeoutMatch[1], 10);
 
   // 환경변수 기반 글로벌 플래그
-  if (process.env.TFX_DASHBOARD === "1") flags.dashboard = true;
   if (process.env.TFX_VERBOSE === "1") flags.verbose = true;
   if (process.env.TFX_NO_AUTO_ATTACH === "1") flags.noAutoAttach = true;
 
@@ -116,6 +116,11 @@ async function main() {
   let raw = "";
   for await (const chunk of process.stdin) raw += chunk;
 
+  if (!raw || !raw.trim()) {
+    console.error('[headless-guard] stdin이 비어있습니다 — 기본 허용');
+    process.exit(0);
+  }
+
   let input;
   try {
     input = JSON.parse(raw);
@@ -157,6 +162,15 @@ async function main() {
 
       const parsed = parseRouteCommand(cmd);
       if (parsed) {
+        // P1a: 단일 워커는 headless 변환 건너뛰기 (직접 실행이 523~1173ms 절약)
+        // TFX_FORCE_HEADLESS=1이면 단일이어도 headless 변환 강제
+        if (!process.env.TFX_FORCE_HEADLESS) {
+          const isMultiWorker = /\s--(multi|parallel)\b/.test(cmd);
+          if (!isMultiWorker) {
+            process.exit(0);  // 원본 tfx-route.sh 명령 그대로 통과
+          }
+        }
+
         const safePrompt = parsed.prompt.replace(/'/g, "'\\''");
         const VALID_MCP = new Set(["implement", "analyze", "review", "docs"]);
         const f = parsed.flags || {};
@@ -164,7 +178,7 @@ async function main() {
         // v3: 플래그 빌더 — 하드코딩 제거, 원본 의도 보존
         const parts = ["tfx multi --teammate-mode headless"];
         if (!f.noAutoAttach) parts.push("--auto-attach");
-        if (f.dashboard) parts.push("--dashboard");
+        if (!f.noAutoAttach) parts.push("--dashboard");  // 워커 요약 스플릿이 기본
         if (f.verbose) parts.push("--verbose");
         parts.push(`--assign '${parsed.agent}:${safePrompt}:${parsed.agent}'`);
         if (parsed.mcp && VALID_MCP.has(parsed.mcp)) parts.push(`--mcp-profile ${parsed.mcp}`);
@@ -173,7 +187,7 @@ async function main() {
         const builtCmd = parts.join(" ");
         autoRoute(
           builtCmd,
-          `[headless-guard] auto-route: tfx-route.sh ${parsed.agent} → headless. mcp=${parsed.mcp} dashboard=${!!f.dashboard}`,
+          `[headless-guard] auto-route: tfx-route.sh ${parsed.agent} → headless. mcp=${parsed.mcp} dashboard=${!f.noAutoAttach}`,
         );
       }
       deny(
@@ -183,10 +197,16 @@ async function main() {
     }
   }
 
-  // ── Agent: CLI 워커 래핑 → deny ──
+  // ── Agent: CLI 워커 래핑 → deny (Claude native는 통과) ──
   if (toolName === "Agent") {
-    const combined = `${(toolInput.prompt || "").toLowerCase()} ${(toolInput.description || "").toLowerCase()}`;
+    const subType = (toolInput.subagent_type || "").toLowerCase();
+    // Claude native subagent types → 무조건 통과
+    const NATIVE_TYPES = new Set(["explore", "plan", "general-purpose", ""]);
+    if (NATIVE_TYPES.has(subType)) process.exit(0);
+    // oh-my-claudecode 계열도 통과
+    if (subType.startsWith("oh-my-claudecode:")) process.exit(0);
 
+    const combined = `${(toolInput.prompt || "").toLowerCase()} ${(toolInput.description || "").toLowerCase()}`;
     const cliPatterns = [
       /codex\s+(exec|run|실행)/,
       /gemini\s+(-p|run|실행)/,