@triflux/core 10.50.2 → 10.51.0

package/hub/lib/ssh-command.mjs

@@ -1,231 +0,0 @@
-// hub/lib/ssh-command.mjs — OS-aware SSH command builder
-// PowerShell 호스트에 bash 문법(2>/dev/null, &&, $())을 보내는 사고를 방지한다.
-// 모든 SSH 명령 생성 코드에서 이 유틸리티를 사용할 것.
-
-import { readHost, readHosts, resolveHost } from "./hosts-compat.mjs";
-
-/** hosts.json 캐시 (프로세스 수명 동안 유지) */
-let hostsCache = null;
-let hostsCacheRoot = null;
-
-/**
- * hosts.json을 로드하여 캐시한다.
- * @param {string} [repoRoot] — 프로젝트 루트 경로
- */
-function loadHostsCache(repoRoot) {
-  const cacheKey = repoRoot || process.cwd();
-  if (hostsCache && hostsCacheRoot === cacheKey) return;
-  hostsCache = readHosts(repoRoot);
-  hostsCacheRoot = cacheKey;
-}
-
-/**
- * hosts.json에서 호스트 OS를 조회한다.
- * @param {string} hostAlias — hosts.json의 키 (e.g. "ultra4")
- * @param {string} [repoRoot] — 프로젝트 루트 경로
- * @returns {"windows"|"posix"} 호스트 OS 유형
- */
-export function detectHostOs(hostAlias, repoRoot) {
-  loadHostsCache(repoRoot);
-
-  const hostCfg = resolveHost(hostAlias, repoRoot)?.host;
-  if (hostCfg?.os === "windows") return "windows";
-  if (hostCfg?.os) return "posix";
-
-  // IP 주소나 unknown alias → posix 기본값
-  return "posix";
-}
-
-/**
- * OS에 맞는 셸 쿼팅을 적용한다.
- * - posix: 싱글쿼트 래핑 + 내부 싱글쿼트 이스케이프
- * - windows: PowerShell 싱글쿼트 래핑 + 내부 싱글쿼트 더블링
- * @param {string} value
- * @param {"windows"|"posix"} os
- * @returns {string}
- */
-export function shellQuoteForHost(value, os) {
-  const s = String(value);
-  if (os === "windows") {
-    // PowerShell: 싱글쿼트 내부에서 '' 로 이스케이프
-    return `'${s.replace(/'/g, "''")}'`;
-  }
-  // POSIX: 싱글쿼트 내부에서 '\'' 로 이스케이프
-  return `'${s.replace(/'/g, "'\\''")}'`;
-}
-
-/**
- * OS에 맞는 stderr 억제 구문을 반환한다.
- * @param {"windows"|"posix"} os
- * @returns {string} "2>$null" 또는 "2>/dev/null"
- */
-export function suppressStderr(os) {
-  return os === "windows" ? "2>$null" : "2>/dev/null";
-}
-
-/**
- * OS에 맞는 명령 연결자를 반환한다.
- * @param {"windows"|"posix"} os
- * @returns {string} "; " (PowerShell) 또는 " && " (bash)
- */
-export function commandJoin(os) {
-  return os === "windows" ? "; " : " && ";
-}
-
-/**
- * OS에 맞는 null 디바이스 경로를 반환한다.
- * @param {"windows"|"posix"} os
- * @returns {string}
- */
-export function nullDevice(os) {
-  return os === "windows" ? "$null" : "/dev/null";
-}
-
-/**
- * SSH execFileSync 인자 배열을 안전하게 구성한다.
- * psmux 명령처럼 원격 셸에서 실행할 명령을 배열로 받아
- * 적절한 쿼팅을 적용한 SSH 인자 배열을 반환한다.
- *
- * @param {string} host — SSH 호스트 (user@ip 또는 alias)
- * @param {string[]} remoteCmd — 원격에서 실행할 명령 + 인자
- * @param {object} [opts]
- * @param {number} [opts.connectTimeout=5] — SSH 연결 타임아웃(초)
- * @param {boolean} [opts.keepalive=true] — ServerAliveInterval/CountMax 활성화
- * @param {"windows"|"posix"} [opts.os] — 호스트 OS (미지정 시 자동 감지)
- * @param {string} [opts.repoRoot] — hosts.json 탐색 경로
- * @returns {string[]} execFileSync('ssh', returnValue) 형태로 사용
- */
-export function buildSshArgs(host, remoteCmd, opts = {}) {
-  const connectTimeout = opts.connectTimeout ?? 5;
-  const keepalive = opts.keepalive !== false;
-  const hostAlias = host.includes("@") ? host.split("@").pop() : host;
-  const os = opts.os ?? detectHostOs(hostAlias, opts.repoRoot);
-
-  // 명령어(첫 요소)는 쿼팅하지 않고, 인자만 쿼팅
-  const [cmd, ...args] = remoteCmd;
-  const quotedArgs = args.map((a) => shellQuoteForHost(a, os));
-  const remoteCmdStr = [cmd, ...quotedArgs].join(" ");
-
-  const sshArgs = [
-    "-o",
-    `ConnectTimeout=${connectTimeout}`,
-    "-o",
-    "BatchMode=yes",
-  ];
-
-  if (keepalive) {
-    sshArgs.push("-o", "ServerAliveInterval=30", "-o", "ServerAliveCountMax=3");
-  }
-
-  sshArgs.push(host, remoteCmdStr);
-  return sshArgs;
-}
-
-/**
- * 검증: 문자열에 호스트 OS와 맞지 않는 셸 문법이 포함되었는지 검사한다.
- * SSH 명령 생성 시 안전 게이트로 사용.
- *
- * @param {string} command — 원격 실행할 명령 문자열
- * @param {"windows"|"posix"} os — 대상 호스트 OS
- * @returns {{ safe: boolean, violations: string[] }}
- */
-export function validateCommandForOs(command, os) {
-  const violations = [];
-
-  if (os === "windows") {
-    // PowerShell에서 해석 불가능한 bash 문법 검출
-    if (/2>\/dev\/null/.test(command)) {
-      violations.push("2>/dev/null → PowerShell에서는 2>$null 사용");
-    }
-    if (/\$\(/.test(command) && !/\$\(/.test(command) === false) {
-      // $() bash substitution vs PowerShell $() — 문맥 의존
-      // PowerShell도 $()를 사용하므로 여기선 경고만
-    }
-    if (/\s&&\s/.test(command)) {
-      violations.push("&& → PowerShell에서는 ; 또는 -and 사용");
-    }
-    if (/\s\|\|\s/.test(command)) {
-      violations.push("|| → PowerShell에서는 ; 또는 -or 사용");
-    }
-    if (/>\s*\/dev\/null/.test(command)) {
-      violations.push(">/dev/null → PowerShell에서는 >$null 사용");
-    }
-  }
-
-  return { safe: violations.length === 0, violations };
-}
-
-/**
- * hosts.json에서 호스트 전체 설정을 조회한다.
- * @param {string} hostAlias — hosts.json의 키 (e.g. "ultra4")
- * @param {string} [repoRoot]
- * @returns {object|null}
- */
-export function getHostConfig(hostAlias, repoRoot) {
-  loadHostsCache(repoRoot);
-  return readHost(hostAlias, repoRoot);
-}
-
-/**
- * 별칭(alias)으로 호스트 키를 찾는다.
- * @param {string} alias — 호스트 키 또는 aliases 배열 내 값
- * @param {string} [repoRoot]
- * @returns {string|null} 호스트 키 (e.g. "ultra4") 또는 null
- */
-export function resolveHostAlias(alias, repoRoot) {
-  loadHostsCache(repoRoot);
-
-  return resolveHost(alias, repoRoot)?.name ?? null;
-}
-
-/**
- * 특정 capability를 보유한 호스트 목록을 반환한다.
- * 명시적 선택 UI에서 바로 리소스 정보를 보여줄 수 있도록 specs를 평탄화한다.
- * @param {string} capability — e.g. "codex", "claude", "gpu"
- * @param {string} [repoRoot]
- * @returns {Array<{ name: string, config: object, specs: { cores?: number, ram_gb?: number } }>}
- */
-export function selectHostForCapability(capability, repoRoot) {
-  loadHostsCache(repoRoot);
-
-  const matches = [];
-  for (const [name, cfg] of Object.entries(hostsCache.hosts || {})) {
-    if (cfg.capabilities?.includes(capability)) {
-      matches.push({
-        name,
-        config: cfg,
-        specs: {
-          cores: cfg.specs?.cores,
-          ram_gb: cfg.specs?.ram_gb,
-        },
-      });
-    }
-  }
-  return matches;
-}
-
-/**
- * 특정 capability를 가진 호스트를 리소스 기준으로 정렬해 반환한다.
- * 자동 선택은 하지 않고, 명시적 선택 목록 정렬에만 사용한다.
- * @param {string} capability — e.g. "codex", "claude", "gpu"
- * @param {"cores"|"ram_gb"} sortBy
- * @param {string} [repoRoot]
- * @returns {Array<{ name: string, config: object, specs: { cores?: number, ram_gb?: number } }>}
- */
-export function selectHostByResources(capability, sortBy, repoRoot) {
-  if (sortBy !== "cores" && sortBy !== "ram_gb") {
-    throw new TypeError('sortBy must be "cores" or "ram_gb"');
-  }
-
-  return selectHostForCapability(capability, repoRoot).sort((a, b) => {
-    const aValue = a.specs?.[sortBy] ?? -Infinity;
-    const bValue = b.specs?.[sortBy] ?? -Infinity;
-    return bValue - aValue;
-  });
-}
-
-/** hosts.json 캐시 초기화 (테스트용) */
-export function resetHostsCache() {
-  hostsCache = null;
-  hostsCacheRoot = null;
-}

package/hub/lib/staged-file-detect.mjs

@@ -1,43 +0,0 @@
-import { execFileSync } from "node:child_process";
-
-export function detectChangedFiles({
-  cwd = process.cwd(),
-  includeStaged = true,
-  includeUnstaged = true,
-  includeUntracked = true,
-} = {}) {
-  const staged = includeStaged
-    ? runGit(cwd, ["diff", "--cached", "--name-only"])
-    : [];
-  const unstaged = includeUnstaged ? runGit(cwd, ["diff", "--name-only"]) : [];
-  const untracked = includeUntracked
-    ? runGit(cwd, ["ls-files", "--others", "--exclude-standard"])
-    : [];
-  const files = [...new Set([...staged, ...unstaged, ...untracked])];
-
-  return {
-    stagedCount: staged.length,
-    unstagedCount: unstaged.length,
-    untrackedCount: untracked.length,
-    totalChanged: files.length,
-    files,
-  };
-}
-
-export function hasCodeChange(opts) {
-  return detectChangedFiles(opts).totalChanged > 0;
-}
-
-function runGit(cwd, args) {
-  try {
-    return execFileSync("git", args, {
-      cwd,
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-    })
-      .split(/\r?\n/)
-      .filter(Boolean);
-  } catch {
-    return [];
-  }
-}

package/hub/lib/tfx-route-args.mjs

@@ -1,353 +0,0 @@
-// hub/lib/tfx-route-args.mjs
-// Phase 3 Step B — tfx-auto / tfx-route 플래그 파서.
-// 설계 문서: .triflux/plans/phase3-lead-codex-ralph-escalate.md
-//
-// 입력: ARGUMENTS 문자열 또는 토큰 배열.
-// 출력: {cli, mode, parallel, retry, isolation, remote, lead, noClaudeNative,
-//        maxIterations, task, warnings}.
-//
-// 기존 플래그 (Phase 2 v10.9.33+):
-//   --cli {auto|codex|antigravity|claude}
-//   --mode {quick|deep|consensus|live}
-//   --parallel {1|N|swarm}
-//   --retry {0|1|ralph|auto-escalate}    (Phase 3 에서 ralph/auto-escalate 신규)
-//   --isolation {none|worktree}
-//   --remote {none|<host>}
-//   --rounds <N>                          (--mode live 전용, 기본 4)
-//
-// Phase 3 신규:
-//   --lead {claude|codex}             (tfx-auto-codex 의미 흡수)
-//   --no-claude-native                (Claude native sub-agent 경로 disable)
-//   --max-iterations <N>              (ralph / auto-escalate 상한, 0=unlimited)
-
-import { hasCodeChange } from "./staged-file-detect.mjs";
-
-export const DEFAULT_OPTIONS = Object.freeze({
-  cli: "auto",
-  mode: "quick",
-  parallel: "1",
-  retry: "1",
-  isolation: "none",
-  remote: "none",
-  lead: "claude",
-  noClaudeNative: false,
-  maxIterations: 0,
-  rounds: 4,
-});
-
-const VALID_VALUES = Object.freeze({
-  cli: ["auto", "codex", "antigravity", "claude"],
-  mode: ["quick", "deep", "consensus", "live"],
-  retry: ["0", "1", "ralph", "auto-escalate"],
-  isolation: ["none", "worktree"],
-  lead: ["claude", "codex"],
-});
-
-const VALUE_FLAGS = new Set([
-  "--cli",
-  "--mode",
-  "--parallel",
-  "--retry",
-  "--isolation",
-  "--remote",
-  "--lead",
-  "--max-iterations",
-  "--rounds",
-]);
-
-const BOOL_FLAGS = new Set(["--no-claude-native"]);
-
-export function parseArgs(input) {
-  const tokens = Array.isArray(input)
-    ? input.slice()
-    : tokenize(String(input || ""));
-  const opts = { ...DEFAULT_OPTIONS };
-  const warnings = [];
-  const taskTokens = [];
-  const providedFlags = new Set();
-
-  let i = 0;
-  while (i < tokens.length) {
-    const raw = tokens[i];
-
-    if (BOOL_FLAGS.has(raw)) {
-      providedFlags.add(raw);
-      applyBool(opts, raw);
-      i += 1;
-      continue;
-    }
-
-    // --flag=value 지원
-    const eqIdx = raw.indexOf("=");
-    let flag = raw;
-    let value = null;
-    if (eqIdx > 0 && raw.startsWith("--")) {
-      flag = raw.slice(0, eqIdx);
-      value = raw.slice(eqIdx + 1);
-    }
-
-    if (VALUE_FLAGS.has(flag)) {
-      providedFlags.add(flag);
-      if (value === null) {
-        const next = tokens[i + 1];
-        if (next === undefined || next.startsWith("--")) {
-          warnings.push(`${flag} needs a value`);
-          i += 1;
-          continue;
-        }
-        value = next;
-        i += 2;
-      } else {
-        i += 1;
-      }
-      applyValue(opts, flag, value, warnings);
-      continue;
-    }
-
-    if (raw.startsWith("--")) {
-      warnings.push(`unknown flag: ${raw}`);
-      i += 1;
-      continue;
-    }
-
-    taskTokens.push(raw);
-    i += 1;
-  }
-
-  validate(opts, warnings, providedFlags);
-
-  return {
-    ...opts,
-    task: taskTokens.join(" ").trim(),
-    warnings,
-  };
-}
-
-function tokenize(str) {
-  const tokens = [];
-  let cur = "";
-  let quote = null;
-  for (const ch of str) {
-    if (quote) {
-      if (ch === quote) {
-        quote = null;
-      } else {
-        cur += ch;
-      }
-      continue;
-    }
-    if (ch === '"' || ch === "'") {
-      quote = ch;
-      continue;
-    }
-    if (/\s/.test(ch)) {
-      if (cur) {
-        tokens.push(cur);
-        cur = "";
-      }
-      continue;
-    }
-    cur += ch;
-  }
-  if (cur) tokens.push(cur);
-  return tokens;
-}
-
-function applyBool(opts, flag) {
-  switch (flag) {
-    case "--no-claude-native":
-      opts.noClaudeNative = true;
-      break;
-  }
-}
-
-function applyValue(opts, flag, value, warnings) {
-  switch (flag) {
-    case "--cli":
-      if (value === "gemini") {
-        opts.cli = "antigravity";
-        warnings.push(
-          "--cli gemini is deprecated; using --cli antigravity instead",
-        );
-      } else {
-        opts.cli = value;
-      }
-      break;
-    case "--mode":
-      opts.mode = value;
-      break;
-    case "--parallel":
-      opts.parallel = value;
-      break;
-    case "--retry":
-      opts.retry = value;
-      break;
-    case "--isolation":
-      opts.isolation = value;
-      break;
-    case "--remote":
-      opts.remote = value;
-      break;
-    case "--lead":
-      opts.lead = value;
-      break;
-    case "--max-iterations": {
-      const n = Number.parseInt(value, 10);
-      if (Number.isNaN(n) || n < 0) {
-        warnings.push(
-          `invalid --max-iterations=${value}, expected non-negative integer (0=unlimited)`,
-        );
-      } else {
-        opts.maxIterations = n;
-      }
-      break;
-    }
-    case "--rounds": {
-      const n = Number(value);
-      if (!Number.isInteger(n) || n <= 0) {
-        warnings.push(`invalid --rounds=${value}, expected positive integer`);
-      } else {
-        opts.rounds = n;
-      }
-      break;
-    }
-  }
-}
-
-function validate(opts, warnings, providedFlags = new Set()) {
-  for (const key of Object.keys(VALID_VALUES)) {
-    if (!VALID_VALUES[key].includes(opts[key])) {
-      warnings.push(
-        `invalid --${key}=${opts[key]}, expected one of ${VALID_VALUES[key].join("|")}`,
-      );
-    }
-  }
-  if (
-    opts.parallel !== "1" &&
-    opts.parallel !== "swarm" &&
-    !/^\d+$/.test(opts.parallel)
-  ) {
-    warnings.push(`invalid --parallel=${opts.parallel}, expected 1|N|swarm`);
-  }
-
-  if (opts.mode === "live") {
-    const ignored = [
-      ["--parallel", "parallel", DEFAULT_OPTIONS.parallel],
-      ["--isolation", "isolation", DEFAULT_OPTIONS.isolation],
-      ["--remote", "remote", DEFAULT_OPTIONS.remote],
-    ];
-    for (const [flag, key, fallback] of ignored) {
-      if (providedFlags.has(flag)) {
-        warnings.push(`${flag} ignored with --mode live`);
-        opts[key] = fallback;
-      }
-    }
-    if (providedFlags.has("--retry") && opts.retry === "ralph") {
-      warnings.push("--retry ralph ignored with --mode live");
-      opts.retry = DEFAULT_OPTIONS.retry;
-    }
-  } else if (providedFlags.has("--rounds")) {
-    warnings.push("--rounds ignored unless --mode live");
-    opts.rounds = DEFAULT_OPTIONS.rounds;
-  }
-
-  const parallelOne = opts.parallel === "1" || opts.parallel === 1;
-  if (parallelOne && opts.isolation === "worktree") {
-    warnings.push(
-      "--isolation worktree requires --parallel >=2 or swarm; forcing isolation=none",
-    );
-    opts.isolation = "none";
-  }
-  if (opts.remote !== "none" && opts.parallel !== "swarm") {
-    warnings.push(
-      `--remote ${opts.remote} ignored (requires --parallel swarm)`,
-    );
-  }
-}
-
-export { VALID_VALUES };
-
-/**
- * Decide dispatch mode based on parsed args and current git state.
- *
- * Issue #281: auto router code changes should use isolated swarm dispatch for
- * multi-task work unless the user explicitly selected local parallel mode.
- *
- * @param {object} args
- * @param {object} [opts]
- * @param {string} [opts.cwd]
- * @param {Function} [opts.detector]
- * @returns {{
- *   mode: "single" | "multi" | "swarm",
- *   escalated: boolean,
- *   warning: string | null,
- *   reason: string,
- * }}
- */
-export function decideDispatchMode(
-  args = {},
-  { cwd = process.cwd(), detector = hasCodeChange } = {},
-) {
-  const tasksCount = countTasks(args);
-  const parallel = normalizeParallel(args.parallel);
-  const hasUserParallel = parallel !== null && parallel !== "1";
-  const hasUserSwarm = parallel === "swarm" || args.isolation === "worktree";
-  const codeChanged = Boolean(detector({ cwd }));
-
-  if (hasUserSwarm) {
-    return {
-      mode: "swarm",
-      escalated: false,
-      warning: null,
-      reason: "user-explicit-swarm",
-    };
-  }
-
-  if (hasUserParallel && codeChanged) {
-    return {
-      mode: "multi",
-      escalated: false,
-      warning: `[tfx-auto] WARNING: 코드 변경 감지 (cwd race 위험). --parallel swarm --isolation worktree 권장. 사용자 명시 --parallel=${args.parallel} 존중하여 multi 로 진행.`,
-      reason: "user-explicit-multi-with-code-change",
-    };
-  }
-
-  if (tasksCount >= 2 && codeChanged) {
-    return {
-      mode: "swarm",
-      escalated: true,
-      warning: `[tfx-auto] 코드 변경 ${tasksCount}건 태스크 + dirty cwd 감지. swarm dispatch 자동 escalate (--parallel swarm --isolation worktree). Issue #281.`,
-      reason: "auto-escalate-code-change",
-    };
-  }
-
-  if (tasksCount >= 2 || hasUserParallel) {
-    return {
-      mode: "multi",
-      escalated: false,
-      warning: null,
-      reason: "multi-no-code-change",
-    };
-  }
-
-  return {
-    mode: "single",
-    escalated: false,
-    warning: null,
-    reason: "single-task",
-  };
-}
-
-function countTasks(args) {
-  if (Array.isArray(args.tasks)) return args.tasks.length;
-  if (typeof args.tasks === "number") return args.tasks;
-  if (typeof args.tasks === "string") return args.tasks.trim() ? 1 : 0;
-  if (typeof args.task === "string") return args.task.trim() ? 1 : 0;
-  return args.tasks ?? 0;
-}
-
-function normalizeParallel(value) {
-  if (value == null) return null;
-  if (value === "swarm") return value;
-  return String(value);
-}