triflux 3.2.0-dev.8 → 3.3.0-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "3.2.0-dev.8",
+  "version": "3.3.0-dev.1",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -27,6 +27,9 @@
   "scripts": {
     "setup": "node scripts/setup.mjs",
     "postinstall": "node scripts/setup.mjs",
+    "test": "node --test tests/**/*.test.mjs",
+    "test:unit": "node --test tests/unit/**/*.test.mjs",
+    "test:integration": "node --test tests/integration/**/*.test.mjs",
     "test:route-smoke": "node --test scripts/test-tfx-route-no-claude-native.mjs"
   },
   "engines": {

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

@@ -79,7 +79,7 @@ test("sanitizeForKeywordDetection: 코드블록/URL/파일경로/XML 태그 제
   const input = [
     "정상 문장",
     "```sh",
-    "tfx team",
+    "tfx multi",
     "```",
     "https://example.com/path?q=1",
     "C:\\Users\\SSAFY\\Desktop\\Projects\\tools\\triflux",
@@ -90,7 +90,7 @@ test("sanitizeForKeywordDetection: 코드블록/URL/파일경로/XML 태그 제
   const sanitized = sanitizeForKeywordDetection(input);
 
   assert.ok(sanitized.includes("정상 문장"));
-  assert.ok(!sanitized.includes("tfx team"));
+  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"));
@@ -138,7 +138,7 @@ test("compileRules: 정규식 컴파일 실패", () => {
       id: "bad-pattern",
       priority: 1,
       patterns: [{ source: "[", flags: "" }],
-      skill: "tfx-team",
+      skill: "tfx-multi",
       supersedes: [],
       exclusive: false,
       state: null,
@@ -152,7 +152,7 @@ test("compileRules: 정규식 컴파일 실패", () => {
 test("matchRules: tfx 키워드 매칭", () => {
   const compiledRules = loadCompiledRules();
   const cases = [
-    { text: "tfx team 세션 시작", expectedId: "tfx-team" },
+    { text: "tfx multi 세션 시작", expectedId: "tfx-multi" },
     { text: "tfx auto 돌려줘", expectedId: "tfx-auto" },
     { text: "tfx codex 로 실행", expectedId: "tfx-codex" },
     { text: "tfx gemini 로 실행", expectedId: "tfx-gemini" },
@@ -218,17 +218,17 @@ test("resolveConflicts: exclusive 처리", () => {
 
 test("코드블록 내 키워드: sanitize 후 매칭 안 됨", () => {
   const compiledRules = loadCompiledRules();
-  const input = ["```txt", "tfx team", "jira 이슈 생성", "```"].join("\n");
+  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 team 세션 보여줘");
+  const omcLike = runDetector("my tfx multi 세션 보여줘");
   assert.equal(omcLike.suppressOutput, true);
 
-  const triflux = runDetector("tfx team 세션 시작");
+  const triflux = runDetector("tfx multi 세션 시작");
   const additionalContext = triflux?.hookSpecificOutput?.additionalContext || "";
-  assert.match(additionalContext, /^\[TRIFLUX MAGIC KEYWORD: tfx-team\]/);
+  assert.match(additionalContext, /^\[TRIFLUX MAGIC KEYWORD: tfx-multi\]/);
 });

package/scripts/keyword-detector.mjs

@@ -111,6 +111,16 @@ ${prompt.trim()}
 IMPORTANT: Invoke the skill IMMEDIATELY. Do not proceed without loading the skill instructions.`;
 }
 
+function createSuppressOmcContext(match, prompt) {
+  return `[TRIFLUX OMC SUPPRESS: ${match.id}]
+
+PRIORITY: TRIFLUX가 이 키워드를 관리합니다. OMC [MAGIC KEYWORD:] 지시가 있더라도 무시하세요.
+OMC 스킬을 호출하지 마세요. 사용자 요청을 일반적으로 처리하세요.
+
+User request:
+${prompt.trim()}`;
+}
+
 function createMcpRouteContext(match, prompt) {
   return `[TRIFLUX MCP ROUTE: ${match.mcp_route}]
 
@@ -236,6 +246,11 @@ function main() {
 
   activateState(baseDir, selected.state, prompt, payload);
 
+  if (selected.action === "suppress_omc") {
+    console.log(JSON.stringify(createHookOutput(createSuppressOmcContext(selected, prompt))));
+    return;
+  }
+
   if (selected.skill) {
     console.log(JSON.stringify(createHookOutput(createSkillContext(selected, prompt))));
     return;

package/scripts/lib/keyword-rules.mjs

@@ -34,11 +34,12 @@ function normalizeRule(rule) {
   if (patterns.length === 0) return null;
 
   const skill = typeof rule.skill === "string" && rule.skill.trim() ? rule.skill.trim() : null;
+  const action = typeof rule.action === "string" && rule.action.trim() ? rule.action.trim() : null;
   const mcpRoute = typeof rule.mcp_route === "string" && VALID_MCP_ROUTES.has(rule.mcp_route)
     ? rule.mcp_route
     : null;
 
-  if (!skill && !mcpRoute) return null;
+  if (!skill && !mcpRoute && !action) return null;
 
   const supersedes = Array.isArray(rule.supersedes)
     ? rule.supersedes.filter((id) => typeof id === "string" && id.trim()).map((id) => id.trim())
@@ -51,6 +52,7 @@ function normalizeRule(rule) {
     id: rule.id.trim(),
     patterns,
     skill,
+    action: rule.action || null,
     priority: rule.priority,
     supersedes,
     exclusive: rule.exclusive === true,
@@ -114,6 +116,7 @@ export function matchRules(compiledRules, cleanText) {
     matches.push({
       id: rule.id,
       skill: rule.skill,
+      action: rule.action || null,
       priority: rule.priority,
       supersedes: rule.supersedes || [],
       exclusive: rule.exclusive === true,

package/scripts/preflight-cache.mjs

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+// scripts/preflight-cache.mjs — 세션 시작 시 preflight 점검 캐싱
+
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+
+const CACHE_DIR = join(homedir(), ".claude", "cache");
+const CACHE_FILE = join(CACHE_DIR, "tfx-preflight.json");
+const CACHE_TTL_MS = 30_000; // 30초
+
+function checkHub() {
+  try {
+    const res = execSync("curl -sf http://127.0.0.1:27888/status", { timeout: 3000, encoding: "utf8" });
+    const data = JSON.parse(res);
+    return { ok: true, state: data?.hub?.state || "unknown", pid: data?.pid };
+  } catch {
+    return { ok: false, state: "unreachable" };
+  }
+}
+
+function checkRoute() {
+  const routePath = join(homedir(), ".claude", "scripts", "tfx-route.sh");
+  return { ok: existsSync(routePath), path: routePath };
+}
+
+function checkCli(name) {
+  try {
+    const path = execSync(`which ${name} 2>/dev/null || where ${name} 2>nul`, { encoding: "utf8", timeout: 2000 }).trim();
+    return { ok: !!path, path };
+  } catch {
+    return { ok: false };
+  }
+}
+
+function runPreflight() {
+  const result = {
+    timestamp: Date.now(),
+    hub: checkHub(),
+    route: checkRoute(),
+    codex: checkCli("codex"),
+    gemini: checkCli("gemini"),
+    ok: false,
+  };
+  result.ok = result.hub.ok && result.route.ok;
+  return result;
+}
+
+// 캐시 읽기 (TTL 검증 포함)
+export function readPreflightCache() {
+  try {
+    const data = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
+    if (Date.now() - data.timestamp < CACHE_TTL_MS) return data;
+  } catch {}
+  return null;
+}
+
+// 메인 실행
+if (process.argv[1]?.endsWith("preflight-cache.mjs")) {
+  const result = runPreflight();
+  mkdirSync(CACHE_DIR, { recursive: true });
+  writeFileSync(CACHE_FILE, JSON.stringify(result, null, 2));
+  // 간결 출력 (hook stdout)
+  const summary = result.ok ? "preflight: ok" : "preflight: FAIL";
+  const details = [];
+  if (!result.hub.ok) details.push("hub:" + result.hub.state);
+  if (!result.route.ok) details.push("route:missing");
+  console.log(details.length ? `${summary} (${details.join(", ")})` : summary);
+}
+
+export { runPreflight, CACHE_FILE, CACHE_TTL_MS };

package/scripts/psmux-steering-prototype.sh

@@ -0,0 +1,368 @@
+#!/usr/bin/env bash
+# psmux-steering-prototype.sh
+# Windows psmux 환경에서 lead/codex-worker/gemini-worker pane을 만들고
+# send-keys + pipe-pane 기반으로 실시간 CLI 스티어링을 실험하는 프로토타입.
+
+set -euo pipefail
+
+PSMUX_BIN="${PSMUX_BIN:-psmux}"
+SESSION_NAME="${PSMUX_SESSION_NAME:-triflux-steering}"
+WINDOW_NAME="${PSMUX_WINDOW_NAME:-control}"
+PANE_LEAD="lead"
+PANE_CODEX="codex-worker"
+PANE_GEMINI="gemini-worker"
+SHELL_COMMAND="${PSMUX_SHELL_COMMAND:-powershell.exe -NoLogo}"
+CAPTURE_ROOT="${PSMUX_CAPTURE_ROOT:-${TMPDIR:-/tmp}/psmux-steering}"
+CAPTURE_DIR="${CAPTURE_ROOT}/${SESSION_NAME}"
+CAPTURE_HELPER_PATH="${CAPTURE_ROOT}/pipe-pane-capture.ps1"
+COMPLETION_PREFIX="__TRIFLUX_DONE__:"
+POLL_INTERVAL_SEC="${PSMUX_POLL_INTERVAL_SEC:-1}"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  scripts/psmux-steering-prototype.sh start
+  scripts/psmux-steering-prototype.sh demo
+  scripts/psmux-steering-prototype.sh attach
+  scripts/psmux-steering-prototype.sh send <pane-name> <command text>
+  scripts/psmux-steering-prototype.sh send-no-enter <pane-name> <text>
+  scripts/psmux-steering-prototype.sh steer-ps <pane-name> <powershell command>
+  scripts/psmux-steering-prototype.sh wait <pane-name> <regex> [timeout-sec]
+  scripts/psmux-steering-prototype.sh logs
+  scripts/psmux-steering-prototype.sh cleanup
+
+Pane names:
+  lead | codex-worker | gemini-worker
+
+Environment overrides:
+  PSMUX_BIN
+  PSMUX_SESSION_NAME
+  PSMUX_WINDOW_NAME
+  PSMUX_SHELL_COMMAND
+  PSMUX_CAPTURE_ROOT
+  PSMUX_POLL_INTERVAL_SEC
+EOF
+}
+
+log() {
+  printf '[psmux-steering] %s\n' "$*"
+}
+
+die() {
+  printf '[psmux-steering] ERROR: %s\n' "$*" >&2
+  exit 1
+}
+
+require_psmux() {
+  command -v "$PSMUX_BIN" >/dev/null 2>&1 || die "Cannot find '$PSMUX_BIN' in PATH."
+}
+
+session_target() {
+  printf '%s:%s' "$SESSION_NAME" "$WINDOW_NAME"
+}
+
+pane_target_from_index() {
+  local pane_index="$1"
+  printf '%s.%s' "$(session_target)" "$pane_index"
+}
+
+log_file_for() {
+  local pane_name="$1"
+  printf '%s/%s.log' "$CAPTURE_DIR" "$pane_name"
+}
+
+to_windows_path() {
+  local path_value="$1"
+
+  if command -v cygpath >/dev/null 2>&1; then
+    cygpath -aw "$path_value"
+    return 0
+  fi
+
+  printf '%s\n' "$path_value"
+}
+
+ensure_capture_helper() {
+  mkdir -p "$CAPTURE_ROOT"
+
+  cat >"$CAPTURE_HELPER_PATH" <<'EOF'
+param(
+  [Parameter(Mandatory = $true)][string]$Path
+)
+
+$parent = Split-Path -Parent $Path
+if ($parent) {
+  New-Item -ItemType Directory -Force -Path $parent | Out-Null
+}
+
+$reader = [Console]::In
+while (($line = $reader.ReadLine()) -ne $null) {
+  Add-Content -LiteralPath $Path -Value $line -Encoding utf8
+}
+EOF
+}
+
+session_exists() {
+  "$PSMUX_BIN" has-session -t "$SESSION_NAME" >/dev/null 2>&1
+}
+
+resolve_pane_target() {
+  local pane_name="$1"
+  local pane_index
+
+  pane_index="$("$PSMUX_BIN" list-panes -t "$(session_target)" -F '#{pane_index} #{pane_title}' \
+    | awk -v wanted="$pane_name" '$2 == wanted { print $1; exit }')"
+
+  [[ -n "$pane_index" ]] || return 1
+  pane_target_from_index "$pane_index"
+}
+
+require_pane_target() {
+  local pane_name="$1"
+  local pane_target
+
+  pane_target="$(resolve_pane_target "$pane_name")"
+  [[ -n "$pane_target" ]] || die "Pane '$pane_name' not found in session '$SESSION_NAME'."
+  printf '%s\n' "$pane_target"
+}
+
+set_pane_title() {
+  local pane_target="$1"
+  local pane_name="$2"
+
+  "$PSMUX_BIN" select-pane -t "$pane_target" -T "$pane_name" >/dev/null
+}
+
+start_capture_for_pane() {
+  local pane_name="$1"
+  local pane_target log_file helper_windows_path log_windows_path
+
+  pane_target="$(require_pane_target "$pane_name")"
+  log_file="$(log_file_for "$pane_name")"
+  ensure_capture_helper
+  helper_windows_path="$(to_windows_path "$CAPTURE_HELPER_PATH")"
+  log_windows_path="$(to_windows_path "$log_file")"
+
+  mkdir -p "$CAPTURE_DIR"
+  : >"$log_file"
+
+  "$PSMUX_BIN" pipe-pane -t "$pane_target" >/dev/null 2>&1 || true
+  "$PSMUX_BIN" pipe-pane -t "$pane_target" powershell.exe -NoLogo -NoProfile -File "$helper_windows_path" "$log_windows_path" >/dev/null
+  refresh_snapshot_for_pane "$pane_name"
+}
+
+start_capture_for_all_panes() {
+  start_capture_for_pane "$PANE_LEAD"
+  start_capture_for_pane "$PANE_CODEX"
+  start_capture_for_pane "$PANE_GEMINI"
+}
+
+stop_capture_for_pane() {
+  local pane_name="$1"
+  local pane_target
+
+  pane_target="$(resolve_pane_target "$pane_name" || true)"
+  [[ -n "$pane_target" ]] || return 0
+  "$PSMUX_BIN" pipe-pane -t "$pane_target" >/dev/null 2>&1 || true
+}
+
+refresh_snapshot_for_pane() {
+  local pane_name="$1"
+  local pane_target log_file
+
+  pane_target="$(require_pane_target "$pane_name")"
+  log_file="$(log_file_for "$pane_name")"
+  mkdir -p "$CAPTURE_DIR"
+
+  # Detached Windows sessions may not flush pipe-pane reliably yet.
+  # Overwriting the log with a fresh capture-pane snapshot keeps
+  # completion detection deterministic for the prototype.
+  "$PSMUX_BIN" capture-pane -t "$pane_target" -p >"$log_file"
+}
+
+send_keys_to_pane() {
+  local pane_name="$1"
+  local text="$2"
+  local submit="${3:-1}"
+  local pane_target
+
+  pane_target="$(require_pane_target "$pane_name")"
+  "$PSMUX_BIN" send-keys -t "$pane_target" -l "$text"
+  if [[ "$submit" != "0" ]]; then
+    "$PSMUX_BIN" send-keys -t "$pane_target" C-m
+  fi
+}
+
+dispatch_powershell_command() {
+  local pane_name="$1"
+  local command_text="$2"
+  local token wrapped
+
+  token="${pane_name}-$(date +%s)-$RANDOM"
+  wrapped="${command_text}; \$trifluxExit = if (\$null -ne \$LASTEXITCODE) { [int]\$LASTEXITCODE } else { 0 }; Write-Output \"${COMPLETION_PREFIX}${token}:\$trifluxExit\""
+
+  send_keys_to_pane "$pane_name" "$wrapped" 1
+  printf '%s\n' "$token"
+}
+
+wait_for_pattern() {
+  local pane_name="$1"
+  local pattern="$2"
+  local timeout_sec="${3:-300}"
+  local log_file deadline
+
+  log_file="$(log_file_for "$pane_name")"
+  [[ -f "$log_file" ]] || die "Log file for pane '$pane_name' does not exist. Start capture first."
+
+  deadline=$((SECONDS + timeout_sec))
+  while (( SECONDS <= deadline )); do
+    refresh_snapshot_for_pane "$pane_name"
+    if grep -Eq -- "$pattern" "$log_file"; then
+      return 0
+    fi
+    sleep "$POLL_INTERVAL_SEC"
+  done
+
+  return 1
+}
+
+wait_for_completion_token() {
+  local pane_name="$1"
+  local token="$2"
+  local timeout_sec="${3:-300}"
+  local pattern
+
+  pattern="${COMPLETION_PREFIX}${token}:[0-9]+"
+  wait_for_pattern "$pane_name" "$pattern" "$timeout_sec"
+}
+
+print_log_locations() {
+  mkdir -p "$CAPTURE_DIR"
+  printf '%s\t%s\n' "$PANE_LEAD" "$(log_file_for "$PANE_LEAD")"
+  printf '%s\t%s\n' "$PANE_CODEX" "$(log_file_for "$PANE_CODEX")"
+  printf '%s\t%s\n' "$PANE_GEMINI" "$(log_file_for "$PANE_GEMINI")"
+}
+
+create_session_layout() {
+  local lead_index codex_index gemini_index
+
+  require_psmux
+
+  if session_exists; then
+    die "Session '$SESSION_NAME' already exists. Run cleanup first or set PSMUX_SESSION_NAME."
+  fi
+
+  mkdir -p "$CAPTURE_DIR"
+
+  lead_index="$("$PSMUX_BIN" new-session -d -P -F '#{pane_index}' -s "$SESSION_NAME" -n "$WINDOW_NAME" -- $SHELL_COMMAND)"
+  codex_index="$("$PSMUX_BIN" split-window -h -P -F '#{pane_index}' -t "$(session_target)" -- $SHELL_COMMAND)"
+  gemini_index="$("$PSMUX_BIN" split-window -v -P -F '#{pane_index}' -t "$(pane_target_from_index "$codex_index")" -- $SHELL_COMMAND)"
+
+  set_pane_title "$(pane_target_from_index "$lead_index")" "$PANE_LEAD"
+  set_pane_title "$(pane_target_from_index "$codex_index")" "$PANE_CODEX"
+  set_pane_title "$(pane_target_from_index "$gemini_index")" "$PANE_GEMINI"
+
+  "$PSMUX_BIN" select-layout -t "$(session_target)" tiled >/dev/null
+  "$PSMUX_BIN" select-pane -t "$(pane_target_from_index "$lead_index")" >/dev/null
+
+  start_capture_for_all_panes
+}
+
+show_start_summary() {
+  log "Session created: $SESSION_NAME"
+  log "Window: $WINDOW_NAME"
+  log "Attach with: $PSMUX_BIN attach -t $SESSION_NAME"
+  print_log_locations
+}
+
+run_demo() {
+  local lead_token codex_token gemini_token
+
+  create_session_layout
+
+  lead_token="$(dispatch_powershell_command "$PANE_LEAD" 'Write-Host "lead pane ready"')"
+  codex_token="$(dispatch_powershell_command "$PANE_CODEX" 'Write-Host "codex-worker pane ready"')"
+  gemini_token="$(dispatch_powershell_command "$PANE_GEMINI" 'Write-Host "gemini-worker pane ready"')"
+
+  wait_for_completion_token "$PANE_LEAD" "$lead_token" 30 || die "Lead pane demo command timed out."
+  wait_for_completion_token "$PANE_CODEX" "$codex_token" 30 || die "Codex pane demo command timed out."
+  wait_for_completion_token "$PANE_GEMINI" "$gemini_token" 30 || die "Gemini pane demo command timed out."
+
+  show_start_summary
+}
+
+cleanup() {
+  stop_capture_for_pane "$PANE_LEAD"
+  stop_capture_for_pane "$PANE_CODEX"
+  stop_capture_for_pane "$PANE_GEMINI"
+
+  if session_exists; then
+    "$PSMUX_BIN" kill-session -t "$SESSION_NAME" >/dev/null 2>&1 || true
+  fi
+}
+
+main() {
+  local action="${1:-demo}"
+
+  case "$action" in
+    start)
+      create_session_layout
+      show_start_summary
+      ;;
+    demo)
+      run_demo
+      ;;
+    attach)
+      require_psmux
+      "$PSMUX_BIN" attach -t "$SESSION_NAME"
+      ;;
+    send)
+      [[ $# -ge 3 ]] || die "Usage: $0 send <pane-name> <command text>"
+      shift
+      local pane_name="$1"
+      shift
+      send_keys_to_pane "$pane_name" "$*" 1
+      ;;
+    send-no-enter)
+      [[ $# -ge 3 ]] || die "Usage: $0 send-no-enter <pane-name> <text>"
+      shift
+      local pane_name="$1"
+      shift
+      send_keys_to_pane "$pane_name" "$*" 0
+      ;;
+    steer-ps)
+      [[ $# -ge 3 ]] || die "Usage: $0 steer-ps <pane-name> <powershell command>"
+      shift
+      local pane_name="$1"
+      shift
+      dispatch_powershell_command "$pane_name" "$*"
+      ;;
+    wait)
+      [[ $# -ge 3 ]] || die "Usage: $0 wait <pane-name> <regex> [timeout-sec]"
+      shift
+      local pane_name="$1"
+      local pattern="$2"
+      local timeout_sec="${3:-300}"
+      if wait_for_pattern "$pane_name" "$pattern" "$timeout_sec"; then
+        log "Matched pattern for pane '$pane_name': $pattern"
+      else
+        die "Timed out waiting for pane '$pane_name' pattern: $pattern"
+      fi
+      ;;
+    logs)
+      print_log_locations
+      ;;
+    cleanup)
+      cleanup
+      ;;
+    -h|--help|help)
+      usage
+      ;;
+    *)
+      usage
+      die "Unknown action: $action"
+      ;;
+  esac
+}
+
+main "$@"