triflux 3.2.0-dev.3 → 3.2.0-dev.6

package/README.ko.md

@@ -85,19 +85,25 @@ tfx doctor
 /analyze "결제 모듈 보안 리뷰"
 /research "최신 React Server Components 패턴"
 
-# 단일 CLI 모드
-/tfx-codex "리팩터링 + 리뷰"    # Codex만 사용
-/tfx-gemini "구현 + 문서화"      # Gemini만 사용
-```
-
-## 스킬
-
-| 스킬 | 모드 | 설명 |
-|------|------|------|
-| `/tfx-auto` | 자동 | 트리아지 → 분해 → DAG 병렬 실행 |
-| `/tfx-codex` | Codex 전용 | 모든 CLI 작업을 Codex로 라우팅 |
-| `/tfx-gemini` | Gemini 전용 | 모든 CLI 작업을 Gemini로 라우팅 |
-| `/tfx-setup` | 설정 | 파일 동기화, HUD 설정, CLI 진단 |
+# 단일 CLI 모드
+/tfx-auto-codex "리팩터링 + 테스트 + 리뷰"  # Codex 리드 + Gemini 유지, Claude 네이티브 역할 제거
+/tfx-codex "리팩터링 + 리뷰"    # Codex만 사용
+/tfx-gemini "구현 + 문서화"      # Gemini만 사용
+```
+
+## 문서
+
+- [docs/INDEX.md](docs/INDEX.md) — 문서 인덱스
+
+## 스킬
+
+| 스킬 | 모드 | 설명 |
+|------|------|------|
+| `/tfx-auto` | 자동 | 트리아지 → 분해 → DAG 병렬 실행 |
+| `/tfx-auto-codex` | Codex 리드 | Claude 네이티브 역할을 Codex로 치환, Gemini 경로 유지 |
+| `/tfx-codex` | Codex 전용 | 모든 CLI 작업을 Codex로 라우팅 |
+| `/tfx-gemini` | Gemini 전용 | 모든 CLI 작업을 Gemini로 라우팅 |
+| `/tfx-setup` | 설정 | 파일 동기화, HUD 설정, CLI 진단 |
 
 ### 커맨드 숏컷
 

package/README.md

@@ -85,19 +85,25 @@ tfx doctor
 /analyze "security review of payment module"
 /research "latest React Server Components patterns"
 
-# Single-CLI modes
-/tfx-codex "refactor + review"     # Codex only
-/tfx-gemini "implement + document"  # Gemini only
-```
-
-## Skills
-
-| Skill | Mode | Description |
-|-------|------|-------------|
-| `/tfx-auto` | Auto | Triage → decompose → parallel execute via DAG |
-| `/tfx-codex` | Codex-only | All CLI tasks routed to Codex |
-| `/tfx-gemini` | Gemini-only | All CLI tasks routed to Gemini |
-| `/tfx-setup` | Setup | File sync, HUD config, CLI diagnostics |
+# Single-CLI modes
+/tfx-auto-codex "refactor + test + review"  # Codex lead + Gemini kept, no Claude-native roles
+/tfx-codex "refactor + review"     # Codex only
+/tfx-gemini "implement + document"  # Gemini only
+```
+
+## Docs
+
+- [docs/INDEX.md](docs/INDEX.md) — central documentation index
+
+## Skills
+
+| Skill | Mode | Description |
+|-------|------|-------------|
+| `/tfx-auto` | Auto | Triage → decompose → parallel execute via DAG |
+| `/tfx-auto-codex` | Codex-lead | Replace Claude-native roles with Codex, keep Gemini path |
+| `/tfx-codex` | Codex-only | All CLI tasks routed to Codex |
+| `/tfx-gemini` | Gemini-only | All CLI tasks routed to Gemini |
+| `/tfx-setup` | Setup | File sync, HUD config, CLI diagnostics |
 
 ### Command Shortcuts
 

package/bin/triflux.mjs

@@ -923,11 +923,12 @@ ${updateNotice}
     ${WHITE_BRIGHT}tfx notion-read${RESET} ${GRAY}Notion 페이지 → 마크다운 (Codex/Gemini MCP)${RESET}
     ${WHITE_BRIGHT}tfx version${RESET}    ${GRAY}버전 표시${RESET}
 
-  ${BOLD}Skills${RESET} ${GRAY}(Claude Code 슬래시 커맨드)${RESET}
-
-    ${AMBER}/tfx-auto${RESET}       ${GRAY}자동 분류 + 병렬 실행${RESET}
-    ${WHITE_BRIGHT}/tfx-codex${RESET}      ${GRAY}Codex 전용 모드${RESET}
-    ${BLUE}/tfx-gemini${RESET}     ${GRAY}Gemini 전용 모드${RESET}
+  ${BOLD}Skills${RESET} ${GRAY}(Claude Code 슬래시 커맨드)${RESET}
+
+    ${AMBER}/tfx-auto${RESET}       ${GRAY}자동 분류 + 병렬 실행${RESET}
+    ${WHITE_BRIGHT}/tfx-auto-codex${RESET} ${GRAY}Codex 리드 + Gemini 유지 (no-Claude-native)${RESET}
+    ${WHITE_BRIGHT}/tfx-codex${RESET}      ${GRAY}Codex 전용 모드${RESET}
+    ${BLUE}/tfx-gemini${RESET}     ${GRAY}Gemini 전용 모드${RESET}
     ${AMBER}/tfx-setup${RESET}      ${GRAY}HUD 설정 + 진단${RESET}
     ${YELLOW}/tfx-doctor${RESET}     ${GRAY}진단 + 수리 + 캐시 초기화${RESET}
 
@@ -960,27 +961,31 @@ async function cmdCodexTeam() {
     return;
   }
 
-  const hasAgents = args.includes("--agents");
-  const hasLead = args.includes("--lead");
-  const hasLayout = args.includes("--layout");
-  const isControl = passthrough.has(sub);
-  const inject = [];
-  if (!isControl && !hasLead) inject.push("--lead", "codex");
-  if (!isControl && !hasAgents) inject.push("--agents", "codex,codex");
-  if (!isControl && !hasLayout) inject.push("--layout", "1xN");
-  const forwarded = isControl ? args : [...inject, ...args];
-
-  const { pathToFileURL } = await import("node:url");
-  const { cmdTeam } = await import(pathToFileURL(join(PKG_ROOT, "hub", "team", "cli.mjs")).href);
-
-  const prevArgv = process.argv;
-  process.argv = [prevArgv[0], prevArgv[1], "team", ...forwarded];
-  try {
-    await cmdTeam();
-  } finally {
-    process.argv = prevArgv;
-  }
-}
+  const hasAgents = args.includes("--agents");
+  const hasLead = args.includes("--lead");
+  const hasLayout = args.includes("--layout");
+  const isControl = passthrough.has(sub);
+  const normalizedArgs = isControl && args.length ? [sub, ...args.slice(1)] : args;
+  const inject = [];
+  if (!isControl && !hasLead) inject.push("--lead", "codex");
+  if (!isControl && !hasAgents) inject.push("--agents", "codex,codex");
+  if (!isControl && !hasLayout) inject.push("--layout", "1xN");
+  const forwarded = isControl ? normalizedArgs : [...inject, ...args];
+
+  const prevArgv = process.argv;
+  const prevProfile = process.env.TFX_TEAM_PROFILE;
+  process.env.TFX_TEAM_PROFILE = "codex-team";
+  const { pathToFileURL } = await import("node:url");
+  const { cmdTeam } = await import(pathToFileURL(join(PKG_ROOT, "hub", "team", "cli.mjs")).href);
+  process.argv = [prevArgv[0], prevArgv[1], "team", ...forwarded];
+  try {
+    await cmdTeam();
+  } finally {
+    process.argv = prevArgv;
+    if (typeof prevProfile === "string") process.env.TFX_TEAM_PROFILE = prevProfile;
+    else delete process.env.TFX_TEAM_PROFILE;
+  }
+}
 
 // ── hub 서브커맨드 ──
 
@@ -1061,10 +1066,40 @@ function autoRegisterMcp(mcpUrl) {
   } catch (e) { warn(`Claude 등록 실패: ${e.message}`); }
 }
 
-function cmdHub() {
-  const sub = process.argv[3] || "status";
-
-  switch (sub) {
+async function cmdHub() {
+  const sub = process.argv[3] || "status";
+  const defaultPortRaw = Number(process.env.TFX_HUB_PORT || "27888");
+  const probePort = Number.isFinite(defaultPortRaw) && defaultPortRaw > 0 ? defaultPortRaw : 27888;
+  const formatHostForUrl = (host) => host.includes(":") ? `[${host}]` : host;
+  const probeHubStatus = async (host = "127.0.0.1", port = probePort, timeoutMs = 3000) => {
+    try {
+      const res = await fetch(`http://${formatHostForUrl(host)}:${port}/status`, {
+        signal: AbortSignal.timeout(timeoutMs),
+      });
+      if (!res.ok) return null;
+      const data = await res.json();
+      return data?.hub ? data : null;
+    } catch {
+      return null;
+    }
+  };
+  const recoverPidFile = (statusData, defaultHost = "127.0.0.1") => {
+    const pid = Number(statusData?.pid);
+    const port = Number(statusData?.port) || probePort;
+    if (!Number.isFinite(pid) || pid <= 0) return;
+    try {
+      mkdirSync(HUB_PID_DIR, { recursive: true });
+      writeFileSync(HUB_PID_FILE, JSON.stringify({
+        pid,
+        port,
+        host: defaultHost,
+        url: `http://${formatHostForUrl(defaultHost)}:${port}/mcp`,
+        started: Date.now(),
+      }));
+    } catch {}
+  };
+
+  switch (sub) {
     case "start": {
       // 이미 실행 중인지 확인
       if (existsSync(HUB_PID_FILE)) {
@@ -1095,13 +1130,13 @@ function cmdHub() {
       });
       child.unref();
 
-      // PID 파일 확인 (최대 3초 대기, 100ms 폴링)
-      let started = false;
-      const deadline = Date.now() + 3000;
-      while (Date.now() < deadline) {
-        if (existsSync(HUB_PID_FILE)) { started = true; break; }
-        execSync("node -e \"setTimeout(()=>{},100)\"", { stdio: "ignore", timeout: 500 });
-      }
+      // PID 파일 확인 (최대 3초 대기, 100ms 폴링)
+      let started = false;
+      const deadline = Date.now() + 3000;
+      while (Date.now() < deadline) {
+        if (existsSync(HUB_PID_FILE)) { started = true; break; }
+        await new Promise((r) => setTimeout(r, 100));
+      }
 
       if (started) {
         const hubInfo = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
@@ -1120,11 +1155,20 @@ function cmdHub() {
       break;
     }
 
-    case "stop": {
-      if (!existsSync(HUB_PID_FILE)) {
-        console.log(`\n  ${DIM}hub 미실행${RESET}\n`);
-        return;
-      }
+    case "stop": {
+      if (!existsSync(HUB_PID_FILE)) {
+        const probed = await probeHubStatus("127.0.0.1", probePort, 1500)
+          || (probePort === 27888 ? null : await probeHubStatus("127.0.0.1", 27888, 1500));
+        if (probed && Number.isFinite(Number(probed.pid))) {
+          try {
+            process.kill(Number(probed.pid), "SIGTERM");
+            console.log(`\n  ${GREEN_BRIGHT}✓${RESET} hub 종료됨 (PID ${probed.pid})${DIM} (probe)${RESET}\n`);
+            return;
+          } catch {}
+        }
+        console.log(`\n  ${DIM}hub 미실행${RESET}\n`);
+        return;
+      }
       try {
         const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
         process.kill(info.pid, "SIGTERM");
@@ -1136,14 +1180,36 @@ function cmdHub() {
       }
       break;
     }
-
-    case "status": {
-      if (!existsSync(HUB_PID_FILE)) {
-        console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${RED}offline${RESET}\n`);
-        return;
-      }
-      try {
-        const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
+
+    case "status": {
+      if (!existsSync(HUB_PID_FILE)) {
+        const probed = await probeHubStatus();
+        if (!probed) {
+          const fallback = probePort === 27888 ? null : await probeHubStatus("127.0.0.1", 27888, 1500);
+          if (fallback) {
+          console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${GREEN_BRIGHT}online${RESET} ${DIM}(default port probe 성공)${RESET}`);
+          console.log(`    URL:     http://127.0.0.1:${fallback.port || 27888}/mcp`);
+          if (fallback.pid !== undefined) console.log(`    PID:     ${fallback.pid}`);
+          if (fallback.hub?.state) console.log(`    State:   ${fallback.hub.state}`);
+          if (fallback.sessions !== undefined) console.log(`    Sessions: ${fallback.sessions}`);
+          recoverPidFile(fallback, "127.0.0.1");
+          console.log("");
+          return;
+        }
+          console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${RED}offline${RESET}\n`);
+          return;
+        }
+        console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${GREEN_BRIGHT}online${RESET} ${DIM}(pid file 없음 / probe 성공)${RESET}`);
+        console.log(`    URL:     http://127.0.0.1:${probed.port || probePort}/mcp`);
+        if (probed.pid !== undefined) console.log(`    PID:     ${probed.pid}`);
+        if (probed.hub?.state) console.log(`    State:   ${probed.hub.state}`);
+        if (probed.sessions !== undefined) console.log(`    Sessions: ${probed.sessions}`);
+        recoverPidFile(probed, "127.0.0.1");
+        console.log("");
+        return;
+      }
+      try {
+        const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
         process.kill(info.pid, 0); // 생존 확인
         const uptime = Date.now() - info.started;
         const uptimeStr = uptime < 60000 ? `${Math.round(uptime / 1000)}초`
@@ -1153,28 +1219,39 @@ function cmdHub() {
         console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${GREEN_BRIGHT}online${RESET}`);
         console.log(`    URL:     ${info.url}`);
         console.log(`    PID:     ${info.pid}`);
-        console.log(`    Uptime:  ${uptimeStr}`);
-
-        // HTTP 상태 조회 시도
-        try {
-          const statusUrl = info.url.replace("/mcp", "/status");
-          const result = execSync(`curl -s "${statusUrl}"`, { encoding: "utf8", timeout: 3000, stdio: ["pipe", "pipe", "ignore"] });
-          const data = JSON.parse(result);
-          if (data.hub) {
-            console.log(`    State:   ${data.hub.state}`);
-          }
+        console.log(`    Uptime:  ${uptimeStr}`);
+
+        // HTTP 상태 조회 시도
+        try {
+          const host = typeof info.host === "string" ? info.host : "127.0.0.1";
+          const port = Number(info.port) || probePort;
+          const data = await probeHubStatus(host, port, 3000);
+          if (data.hub) {
+            console.log(`    State:   ${data.hub.state}`);
+          }
           if (data.sessions !== undefined) {
             console.log(`    Sessions: ${data.sessions}`);
           }
         } catch {}
 
         console.log("");
-      } catch {
-        try { unlinkSync(HUB_PID_FILE); } catch {}
-        console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${RED}offline${RESET} ${DIM}(stale PID 정리됨)${RESET}\n`);
-      }
-      break;
-    }
+      } catch {
+        try { unlinkSync(HUB_PID_FILE); } catch {}
+        const probed = await probeHubStatus();
+        if (!probed) {
+          console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${RED}offline${RESET} ${DIM}(stale PID 정리됨)${RESET}\n`);
+          break;
+        }
+        console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${GREEN_BRIGHT}online${RESET} ${DIM}(stale PID 정리 후 probe 성공)${RESET}`);
+        console.log(`    URL:     http://127.0.0.1:${probed.port || probePort}/mcp`);
+        if (probed.pid !== undefined) console.log(`    PID:     ${probed.pid}`);
+        if (probed.hub?.state) console.log(`    State:   ${probed.hub.state}`);
+        if (probed.sessions !== undefined) console.log(`    Sessions: ${probed.sessions}`);
+        recoverPidFile(probed, "127.0.0.1");
+        console.log("");
+      }
+      break;
+    }
 
     default:
       console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET}\n`);
@@ -1199,7 +1276,7 @@ switch (cmd) {
   }
   case "update":  cmdUpdate(); break;
   case "list": case "ls": cmdList(); break;
-  case "hub":     cmdHub(); break;
+  case "hub":     await cmdHub(); break;
   case "team": {
     const { pathToFileURL } = await import("node:url");
     const { cmdTeam } = await import(pathToFileURL(join(PKG_ROOT, "hub", "team", "cli.mjs")).href);

package/hooks/hooks.json

@@ -19,8 +19,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/team-keyword.mjs\"",
-            "timeout": 3
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/run.cjs\" \"${CLAUDE_PLUGIN_ROOT}/scripts/keyword-detector.mjs\"",
+            "timeout": 5
           }
         ]
       }