triflux 3.1.0-dev.5 → 3.2.0-dev.2

package/hub/tools.mjs

@@ -1,7 +1,14 @@
-// hub/tools.mjs — MCP 도구 8개 정의
-// register, status, publish, ask, poll_messages, handoff, request_human_input, submit_human_input
+// hub/tools.mjs — MCP 도구 정의
+// register/status/publish/ask/poll/handoff/HITL + team proxy
 // 모든 도구 응답: { ok: boolean, error?: { code, message }, data?: ... }
 
+import {
+  teamInfo,
+  teamTaskList,
+  teamTaskUpdate,
+  teamSendMessage,
+} from './team/nativeProxy.mjs';
+
 /**
  * MCP 도구 목록 생성
  * @param {object} store  — createStore() 반환
@@ -145,19 +152,19 @@ export function createTools(store, router, hitl) {
           auto_ack: args.auto_ack,
         });
 
-        // wait_ms > 0 이고 메시지 없으면 짧은 간격으로 반복 재시도
-        if (!messages.length && args.wait_ms > 0) {
-          const interval = Math.min(args.wait_ms, 500);
-          const deadline = Date.now() + Math.min(args.wait_ms, 30000);
-          while (!messages.length && Date.now() < deadline) {
-            await new Promise(r => setTimeout(r, interval));
-            messages = store.pollForAgent(args.agent_id, {
-              max_messages: args.max_messages,
-              include_topics: args.include_topics,
-              auto_ack: args.auto_ack,
-            });
-          }
-        }
+        // wait_ms > 0 이고 메시지 없으면 짧은 간격으로 반복 재시도
+        if (!messages.length && args.wait_ms > 0) {
+          const interval = Math.min(args.wait_ms, 500);
+          const deadline = Date.now() + Math.min(args.wait_ms, 30000);
+          while (!messages.length && Date.now() < deadline) {
+            await new Promise(r => setTimeout(r, interval));
+            messages = store.pollForAgent(args.agent_id, {
+              max_messages: args.max_messages,
+              include_topics: args.include_topics,
+              auto_ack: args.auto_ack,
+            });
+          }
+        }
 
         return {
           ok: true,
@@ -238,5 +245,96 @@ export function createTools(store, router, hitl) {
         return hitl.submitHumanInput(args);
       }),
     },
+
+    // ── 9. team_info ──
+    {
+      name: 'team_info',
+      description: 'Claude Native Teams 메타/멤버/경로 정보를 조회합니다',
+      inputSchema: {
+        type: 'object',
+        required: ['team_name'],
+        properties: {
+          team_name: { type: 'string', minLength: 1, maxLength: 128, pattern: '^[a-z0-9][a-z0-9-]*$' },
+          include_members: { type: 'boolean', default: true },
+          include_paths: { type: 'boolean', default: true },
+        },
+      },
+      handler: wrap('TEAM_INFO_FAILED', (args) => {
+        return teamInfo(args);
+      }),
+    },
+
+    // ── 10. team_task_list ──
+    {
+      name: 'team_task_list',
+      description: 'Claude Native Teams task 목록을 owner/status 조건으로 조회합니다',
+      inputSchema: {
+        type: 'object',
+        required: ['team_name'],
+        properties: {
+          team_name: { type: 'string', pattern: '^[a-z0-9][a-z0-9-]*$' },
+          owner: { type: 'string' },
+          statuses: {
+            type: 'array',
+            items: { type: 'string', enum: ['pending', 'in_progress', 'completed', 'failed', 'deleted'] },
+            maxItems: 8,
+          },
+          include_internal: { type: 'boolean', default: false },
+          limit: { type: 'integer', minimum: 1, maximum: 1000, default: 200 },
+        },
+      },
+      handler: wrap('TEAM_TASK_LIST_FAILED', (args) => {
+        return teamTaskList(args);
+      }),
+    },
+
+    // ── 11. team_task_update ──
+    {
+      name: 'team_task_update',
+      description: 'Claude Native Teams task를 claim/update 합니다',
+      inputSchema: {
+        type: 'object',
+        required: ['team_name', 'task_id'],
+        properties: {
+          team_name: { type: 'string', pattern: '^[a-z0-9][a-z0-9-]*$' },
+          task_id: { type: 'string', minLength: 1, maxLength: 64 },
+          claim: { type: 'boolean', default: false },
+          owner: { type: 'string' },
+          status: { type: 'string', enum: ['pending', 'in_progress', 'completed', 'failed', 'deleted'] },
+          subject: { type: 'string' },
+          description: { type: 'string' },
+          activeForm: { type: 'string' },
+          add_blocks: { type: 'array', items: { type: 'string' } },
+          add_blocked_by: { type: 'array', items: { type: 'string' } },
+          metadata_patch: { type: 'object' },
+          if_match_mtime_ms: { type: 'number' },
+          actor: { type: 'string' },
+        },
+      },
+      handler: wrap('TEAM_TASK_UPDATE_FAILED', (args) => {
+        return teamTaskUpdate(args);
+      }),
+    },
+
+    // ── 12. team_send_message ──
+    {
+      name: 'team_send_message',
+      description: 'Claude Native Teams inbox에 메시지를 append 합니다',
+      inputSchema: {
+        type: 'object',
+        required: ['team_name', 'from', 'text'],
+        properties: {
+          team_name: { type: 'string', pattern: '^[a-z0-9][a-z0-9-]*$' },
+          from: { type: 'string', minLength: 1, maxLength: 128 },
+          to: { type: 'string', default: 'team-lead' },
+          text: { type: 'string', minLength: 1, maxLength: 200000 },
+          summary: { type: 'string', maxLength: 1000 },
+          color: { type: 'string', default: 'blue' },
+        },
+      },
+      handler: wrap('TEAM_SEND_MESSAGE_FAILED', (args) => {
+        return teamSendMessage(args);
+      }),
+    },
   ];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "3.1.0-dev.5",
+  "version": "3.2.0-dev.2",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {

package/scripts/setup.mjs

@@ -10,6 +10,25 @@ import { homedir } from "os";
 
 const PLUGIN_ROOT = dirname(dirname(new URL(import.meta.url).pathname)).replace(/^\/([A-Z]:)/, "$1");
 const CLAUDE_DIR = join(homedir(), ".claude");
+const CODEX_DIR = join(homedir(), ".codex");
+const CODEX_CONFIG_PATH = join(CODEX_DIR, "config.toml");
+
+const REQUIRED_CODEX_PROFILES = [
+  {
+    name: "xhigh",
+    lines: [
+      'model = "gpt-5.3-codex"',
+      'model_reasoning_effort = "xhigh"',
+    ],
+  },
+  {
+    name: "spark_fast",
+    lines: [
+      'model = "gpt-5.1-codex-mini"',
+      'model_reasoning_effort = "low"',
+    ],
+  },
+];
 
 // ── 파일 동기화 ──
 
@@ -41,6 +60,45 @@ function getVersion(filePath) {
   }
 }
 
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function hasProfileSection(tomlContent, profileName) {
+  const section = `^\\[profiles\\.${escapeRegExp(profileName)}\\]\\s*$`;
+  return new RegExp(section, "m").test(tomlContent);
+}
+
+function ensureCodexProfiles() {
+  try {
+    if (!existsSync(CODEX_DIR)) mkdirSync(CODEX_DIR, { recursive: true });
+
+    const original = existsSync(CODEX_CONFIG_PATH)
+      ? readFileSync(CODEX_CONFIG_PATH, "utf8")
+      : "";
+
+    let updated = original;
+    let added = 0;
+
+    for (const profile of REQUIRED_CODEX_PROFILES) {
+      if (hasProfileSection(updated, profile.name)) continue;
+
+      if (updated.length > 0 && !updated.endsWith("\n")) updated += "\n";
+      if (updated.trim().length > 0) updated += "\n";
+      updated += `[profiles.${profile.name}]\n${profile.lines.join("\n")}\n`;
+      added++;
+    }
+
+    if (added > 0) {
+      writeFileSync(CODEX_CONFIG_PATH, updated, "utf8");
+    }
+
+    return added;
+  } catch {
+    return 0;
+  }
+}
+
 let synced = 0;
 
 for (const { src, dst, label } of SYNC_MAP) {
@@ -130,6 +188,36 @@ if (existsSync(hudPath)) {
   }
 }
 
+// ── Agent Teams 환경변수 자동 설정 ──
+
+try {
+  let agentSettings = {};
+  if (existsSync(settingsPath)) {
+    agentSettings = JSON.parse(readFileSync(settingsPath, "utf8"));
+  }
+
+  if (!agentSettings.env) agentSettings.env = {};
+  let agentSettingsChanged = false;
+
+  if (agentSettings.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS !== "1") {
+    agentSettings.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1";
+    agentSettingsChanged = true;
+  }
+
+  // teammateMode: auto (tmux 밖이면 in-process, 안이면 split-pane)
+  if (!agentSettings.teammateMode) {
+    agentSettings.teammateMode = "auto";
+    agentSettingsChanged = true;
+  }
+
+  if (agentSettingsChanged) {
+    writeFileSync(settingsPath, JSON.stringify(agentSettings, null, 2) + "\n", "utf8");
+    synced++;
+  }
+} catch {
+  // settings.json 파싱 실패 시 무시 — 기존 설정 보존
+}
+
 // ── Stale PID 파일 정리 (hub 좀비 방지) ──
 
 const HUB_PID_FILE = join(CLAUDE_DIR, "cache", "tfx-hub", "hub.pid");
@@ -196,6 +284,13 @@ if (process.platform === "win32") {
   }
 }
 
+// ── Codex 프로필 자동 보정 ──
+
+const codexProfilesAdded = ensureCodexProfiles();
+if (codexProfilesAdded > 0) {
+  synced++;
+}
+
 // ── MCP 인벤토리 백그라운드 갱신 ──
 
 import { spawn } from "child_process";

package/scripts/team-keyword.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+// scripts/team-keyword.mjs — "team" 매직 키워드 → /tfx-team 라우팅
+// UserPromptSubmit 훅에서 실행. stdin으로 프롬프트 수신.
+import { readFileSync } from "node:fs";
+
+// stdin에서 프롬프트 읽기
+let prompt = "";
+try {
+  prompt = readFileSync(0, "utf8");
+} catch {
+  process.exit(0);
+}
+
+// 코드 블록 제거 (오탐 방지)
+const cleaned = prompt
+  .replace(/```[\s\S]*?```/g, "")
+  .replace(/`[^`]+`/g, "")
+  .replace(/https?:\/\/\S+/g, "");
+
+// "team" 키워드 감지 (소유격/관사 뒤는 제외)
+const hasTeam =
+  /(?<!\b(?:my|the|our|a|his|her|their|its|omc|oh-my-claudecode)\s)\bteam\b/i.test(cleaned) ||
+  /\btfx[\s-]?team\b/i.test(cleaned);
+
+if (hasTeam) {
+  console.log("[MAGIC KEYWORD: tfx-team]");
+  console.log("");
+  console.log("You MUST invoke the skill using the Skill tool:");
+  console.log("");
+  console.log("Skill: tfx-team");
+  console.log("");
+  console.log(`User request:\n${prompt.trim()}`);
+  console.log("");
+  console.log("IMPORTANT: Invoke the skill IMMEDIATELY. Do not proceed without loading the skill instructions.");
+}

package/scripts/tfx-route.sh

@@ -38,38 +38,6 @@ STDERR_LOG="/tmp/tfx-route-${AGENT_TYPE}-${TIMESTAMP}-stderr.log"
 STDOUT_LOG="/tmp/tfx-route-${AGENT_TYPE}-${TIMESTAMP}-stdout.log"
 TFX_TMP="${TMPDIR:-/tmp}"
 
-# ── Hub 브릿지 (선택적 — Hub 미실행 시 무시) ──
-# 패키지 내 브릿지 탐색 (npm global / git local 모두 대응)
-find_bridge() {
-  # 1. 환경변수 지정
-  [[ -n "${TFX_BRIDGE:-}" && -f "$TFX_BRIDGE" ]] && echo "$TFX_BRIDGE" && return
-  # 2. 같은 패키지 내
-  local script_dir
-  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  local pkg_bridge="${script_dir}/../hub/bridge.mjs"
-  [[ -f "$pkg_bridge" ]] && echo "$pkg_bridge" && return
-  # 3. 설치된 triflux 패키지
-  local npm_bridge
-  npm_bridge="$(npm root -g 2>/dev/null)/triflux/hub/bridge.mjs"
-  [[ -f "$npm_bridge" ]] && echo "$npm_bridge" && return
-  echo ""
-}
-BRIDGE_BIN="$(find_bridge)"
-HUB_ENABLED="false"
-if [[ -n "$BRIDGE_BIN" ]]; then
-  # Hub 핑 (3초 타임아웃, 실패 시 무시)
-  HUB_PING=$(node "$BRIDGE_BIN" ping 2>/dev/null || echo '{"ok":false}')
-  if echo "$HUB_PING" | grep -q '"ok":true'; then
-    HUB_ENABLED="true"
-  fi
-fi
-
-# Hub 브릿지 래퍼 (Hub 꺼져있으면 아무것도 안 함)
-hub_bridge() {
-  [[ "$HUB_ENABLED" != "true" ]] && return 0
-  node "$BRIDGE_BIN" "$@" 2>/dev/null || true
-}
-
 # fallback 시 원래 에이전트 정보 보존
 ORIGINAL_AGENT=""
 ORIGINAL_CLI_ARGS=""
@@ -99,7 +67,7 @@ route_agent() {
       CLI_EFFORT="high"; DEFAULT_TIMEOUT=1080; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     build-fixer)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile fast exec ${codex_base}"
+      CLI_ARGS="exec --profile fast ${codex_base}"
       CLI_EFFORT="fast"; DEFAULT_TIMEOUT=540; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     debugger)
       CLI_TYPE="codex"; CLI_CMD="codex"
@@ -107,39 +75,39 @@ route_agent() {
       CLI_EFFORT="high"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
     deep-executor)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile xhigh exec ${codex_base}"
+      CLI_ARGS="exec --profile xhigh ${codex_base}"
       CLI_EFFORT="xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
 
     # ─── 설계/분석 레인 ───
     architect)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile xhigh exec ${codex_base}"
+      CLI_ARGS="exec --profile xhigh ${codex_base}"
       CLI_EFFORT="xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
     planner)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile xhigh exec ${codex_base}"
+      CLI_ARGS="exec --profile xhigh ${codex_base}"
       CLI_EFFORT="xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="fg"; OPUS_OVERSIGHT="true" ;;
     critic)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile xhigh exec ${codex_base}"
+      CLI_ARGS="exec --profile xhigh ${codex_base}"
       CLI_EFFORT="xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
     analyst)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile xhigh exec ${codex_base}"
+      CLI_ARGS="exec --profile xhigh ${codex_base}"
       CLI_EFFORT="xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="fg"; OPUS_OVERSIGHT="true" ;;
 
     # ─── 리뷰 레인 ───
     code-reviewer)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile thorough exec ${codex_base} review"
+      CLI_ARGS="exec --profile thorough ${codex_base} review"
       CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=1800; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
     security-reviewer)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile thorough exec ${codex_base} review"
+      CLI_ARGS="exec --profile thorough ${codex_base} review"
       CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=1800; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
     quality-reviewer)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile thorough exec ${codex_base} review"
+      CLI_ARGS="exec --profile thorough ${codex_base} review"
       CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=1800; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
 
     # ─── 리서치 레인 ───
@@ -149,7 +117,7 @@ route_agent() {
       CLI_EFFORT="high"; DEFAULT_TIMEOUT=1440; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
     scientist-deep)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile thorough exec ${codex_base}"
+      CLI_ARGS="exec --profile thorough ${codex_base}"
       CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
     document-specialist)
       CLI_TYPE="codex"; CLI_CMD="codex"
@@ -183,7 +151,7 @@ route_agent() {
     # ─── 경량 ───
     spark)
       CLI_TYPE="codex"; CLI_CMD="codex"
-      CLI_ARGS="--profile spark_fast exec ${codex_base}"
+      CLI_ARGS="exec --profile spark_fast ${codex_base}"
       CLI_EFFORT="spark_fast"; DEFAULT_TIMEOUT=180; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     *)
       echo "ERROR: 알 수 없는 에이전트 타입: $agent" >&2
@@ -208,7 +176,7 @@ apply_cli_mode() {
           designer)
             CLI_ARGS="exec ${codex_base}"; CLI_EFFORT="high"; DEFAULT_TIMEOUT=600 ;;
           writer)
-            CLI_ARGS="--profile spark_fast exec ${codex_base}"; CLI_EFFORT="spark_fast"; DEFAULT_TIMEOUT=180 ;;
+            CLI_ARGS="exec --profile spark_fast ${codex_base}"; CLI_EFFORT="spark_fast"; DEFAULT_TIMEOUT=180 ;;
         esac
         echo "[tfx-route] TFX_CLI_MODE=codex: $AGENT_TYPE → codex($CLI_EFFORT)로 리매핑" >&2
       fi ;;
@@ -385,31 +353,11 @@ ${ctx_content}
 
   # 메타정보 (stderr)
   echo "[tfx-route] v${VERSION} type=$CLI_TYPE agent=$AGENT_TYPE effort=$CLI_EFFORT mode=$RUN_MODE timeout=${TIMEOUT_SEC}s" >&2
-  echo "[tfx-route] opus_oversight=$OPUS_OVERSIGHT mcp_profile=$MCP_PROFILE hub=$HUB_ENABLED" >&2
+  echo "[tfx-route] opus_oversight=$OPUS_OVERSIGHT mcp_profile=$MCP_PROFILE" >&2
 
   # Per-process 에이전트 등록
   register_agent
 
-  # Hub 브릿지: 에이전트 등록 (프로세스 수명 기반 lease)
-  local hub_agent_id="${AGENT_TYPE}-$$"
-  local hub_topics="${AGENT_TYPE},task.result"
-  hub_bridge register \
-    --agent "$hub_agent_id" \
-    --cli "$CLI_TYPE" \
-    --timeout "$TIMEOUT_SEC" \
-    --topics "$hub_topics" \
-    --capabilities "code,${AGENT_TYPE}"
-
-  # Hub 브릿지: 선행 컨텍스트 폴링 (DAG 의존 태스크용)
-  if [[ "$HUB_ENABLED" == "true" && -z "$CONTEXT_FILE" ]]; then
-    local hub_ctx_file="${TFX_TMP}/tfx-hub-ctx-${hub_agent_id}.md"
-    hub_bridge context --agent "$hub_agent_id" --topics "$hub_topics" --out "$hub_ctx_file"
-    if [[ -s "$hub_ctx_file" ]]; then
-      CONTEXT_FILE="$hub_ctx_file"
-      echo "[tfx-route] hub: 선행 컨텍스트 수신 ($(wc -c < "$hub_ctx_file") bytes)" >&2
-    fi
-  fi
-
   # CLI 실행 (stderr 분리 + 타임아웃 + 소요시간 측정)
   local exit_code=0
   local start_time
@@ -466,14 +414,6 @@ ${ctx_content}
   end_time=$(date +%s)
   local elapsed=$((end_time - start_time))
 
-  # Hub 브릿지: 결과 발행 + 에이전트 해제
-  hub_bridge result \
-    --agent "$hub_agent_id" \
-    --file "$STDOUT_LOG" \
-    --topic "task.result" \
-    --exit-code "$exit_code"
-  hub_bridge deregister --agent "$hub_agent_id"
-
   # ── 후처리: 단일 node 프로세스로 위임 ──
   # 토큰 추출, 출력 필터링, 로그, 토큰 누적, AIMD, 이슈 추적, 결과 출력 전부 처리
   local post_script="${HOME}/.claude/scripts/tfx-route-post.mjs"