@triflux/remote 10.0.1 → 10.25.1

package/scripts/lib/cli-codex.mjs

@@ -0,0 +1,199 @@
+// cli-codex.mjs — Codex CLI adapter (Phase 0 PoC).
+//
+// 책임: agent 이름과 입력 파라미터를 받아 Codex 실행 계획(profile/effort/timeout/runMode)을
+// 산출한다. 실제 spawn 은 Phase 1 에서 이관된다 (현재는 tfx-route.sh 가 수행).
+//
+// 진입점: tfx-route.mjs → selectAdapter("codex") → plan({...}).
+// 출처: scripts/tfx-route.sh route_agent() L1001-L1079 case 문 미러.
+
+export const id = "codex";
+export const cliType = "codex";
+export const command = "codex";
+
+const AGENT_PROFILES = {
+  executor: {
+    profile: "gpt55_high",
+    timeoutSec: 1080,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+  },
+  codex: {
+    profile: "gpt55_high",
+    timeoutSec: 1080,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+  },
+  "build-fixer": {
+    profile: "gpt55_low",
+    timeoutSec: 540,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+  },
+  cleanup: {
+    profile: "mini54_med",
+    timeoutSec: 540,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+  },
+  deslop: {
+    profile: "mini54_med",
+    timeoutSec: 540,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+  },
+  debugger: {
+    profile: "gpt55_xhigh",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "implement",
+  },
+  "deep-executor": {
+    profile: "gpt55_xhigh",
+    timeoutSec: 3600,
+    runMode: "bg",
+    opusOversight: true,
+    mcpHint: "implement",
+  },
+  architect: {
+    profile: "gpt55_xhigh",
+    timeoutSec: 3600,
+    runMode: "bg",
+    opusOversight: true,
+    mcpHint: "analyze",
+  },
+  critic: {
+    profile: "gpt55_xhigh",
+    timeoutSec: 3600,
+    runMode: "bg",
+    opusOversight: true,
+    mcpHint: "analyze",
+  },
+  planner: {
+    profile: "gpt55_xhigh",
+    timeoutSec: 3600,
+    runMode: "fg",
+    opusOversight: true,
+    mcpHint: "analyze",
+  },
+  analyst: {
+    profile: "gpt55_xhigh",
+    timeoutSec: 3600,
+    runMode: "fg",
+    opusOversight: true,
+    mcpHint: "analyze",
+  },
+  "code-reviewer": {
+    profile: "gpt55_high",
+    timeoutSec: 1800,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  "quality-reviewer": {
+    profile: "gpt55_high",
+    timeoutSec: 1800,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  "security-reviewer": {
+    profile: "gpt55_xhigh",
+    timeoutSec: 1800,
+    runMode: "bg",
+    opusOversight: true,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  scientist: {
+    profile: "gpt55_high",
+    timeoutSec: 1440,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "analyze",
+  },
+  "document-specialist": {
+    profile: "gpt55_high",
+    timeoutSec: 1440,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "analyze",
+  },
+  "scientist-deep": {
+    profile: "gpt55_xhigh",
+    timeoutSec: 3600,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "analyze",
+  },
+  verifier: {
+    profile: "gpt55_high",
+    timeoutSec: 1200,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  "test-engineer": {
+    profile: "gpt55_high",
+    timeoutSec: 1200,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "implement",
+  },
+  "qa-tester": {
+    profile: "gpt55_high",
+    timeoutSec: 1200,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  spark: {
+    profile: "spark53_low",
+    timeoutSec: 180,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+  },
+};
+
+const DEFAULT_PROFILE = AGENT_PROFILES.executor;
+
+export function plan({
+  agent,
+  prompt = "",
+  mcpProfile = "auto",
+  timeoutSec,
+  contextFile,
+} = {}) {
+  if (!agent) {
+    throw new Error("[cli-codex] agent required");
+  }
+  const cfg = AGENT_PROFILES[agent] ?? DEFAULT_PROFILE;
+  const effectiveTimeoutSec =
+    Number.isFinite(timeoutSec) && timeoutSec > 0 ? timeoutSec : cfg.timeoutSec;
+  return {
+    command,
+    subcommand: cfg.subcommand ?? "exec",
+    profile: cfg.profile,
+    effort: cfg.profile,
+    timeoutMs: effectiveTimeoutSec * 1000,
+    runMode: cfg.runMode,
+    opusOversight: cfg.opusOversight,
+    mcpProfile: mcpProfile === "auto" ? cfg.mcpHint : mcpProfile,
+    promptLength: prompt.length,
+    contextFile: contextFile || null,
+  };
+}
+
+export function describe() {
+  return { id, cliType, command, agents: Object.keys(AGENT_PROFILES) };
+}

package/scripts/lib/cli-gemini.mjs

@@ -0,0 +1,67 @@
+// cli-gemini.mjs — Gemini CLI adapter (Phase 0 PoC).
+//
+// 책임: Gemini 프로파일/모델/timeout 매핑. resolve_gemini_profile() 의 결과는 Phase 1 에서
+// 통합한다 (Phase 0 은 라벨만 전달).
+//
+// 출처: scripts/tfx-route.sh route_agent() L1045-L1050.
+
+export const id = "gemini";
+export const cliType = "gemini";
+export const command = "gemini";
+
+const AGENT_PROFILES = {
+  designer: {
+    profile: "pro31",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "docs",
+  },
+  gemini: {
+    profile: "pro31",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "docs",
+  },
+  writer: {
+    profile: "flash3",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "docs",
+  },
+};
+
+const DEFAULT_PROFILE = AGENT_PROFILES.gemini;
+
+export function plan({
+  agent,
+  prompt = "",
+  mcpProfile = "auto",
+  timeoutSec,
+  contextFile,
+} = {}) {
+  if (!agent) {
+    throw new Error("[cli-gemini] agent required");
+  }
+  const cfg = AGENT_PROFILES[agent] ?? DEFAULT_PROFILE;
+  const effectiveTimeoutSec =
+    Number.isFinite(timeoutSec) && timeoutSec > 0 ? timeoutSec : cfg.timeoutSec;
+  return {
+    command,
+    profile: cfg.profile,
+    effort: cfg.profile,
+    args: ["-m", cfg.profile, "-y", "--prompt"],
+    timeoutMs: effectiveTimeoutSec * 1000,
+    runMode: cfg.runMode,
+    opusOversight: cfg.opusOversight,
+    mcpProfile: mcpProfile === "auto" ? cfg.mcpHint : mcpProfile,
+    promptLength: prompt.length,
+    contextFile: contextFile || null,
+  };
+}
+
+export function describe() {
+  return { id, cliType, command, agents: Object.keys(AGENT_PROFILES) };
+}

package/scripts/lib/codex-recovery.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# codex-recovery.sh — codex exec stdout 4계단 recovery helper.
+# 사용: STDOUT_LOG / STDERR_LOG env 설정 후 `source` + `recover_codex_stdout`.
+#
+# 1차 codex marker  → stderr 의 마지막 "codex" 라인 이후 본문 회수
+# 2차 node parser   → MCP/header/sandbox 로그 제외, 응답 부분만 추출
+# 3차 stderr tail   → "tokens used" 직전까지 tail buffer 회수
+# 4차 FALLBACK_FAILED → 모두 실패 시 marker + stderr_log 경로 출력
+
+recover_codex_stdout() {
+  if [[ -s "$STDOUT_LOG" || ! -s "$STDERR_LOG" ]]; then
+    return 0
+  fi
+
+  # 1차: codex marker
+  sed 's/\r$//' "$STDERR_LOG" \
+    | awk '/^codex$/{found=NR;content=""} found && NR>found{content=content RS $0} END{if(content) print substr(content,2)}' \
+    > "$STDOUT_LOG"
+
+  # 2차: node parser (MCP/header/sandbox 로그 제외)
+  if [[ ! -s "$STDOUT_LOG" ]]; then
+    node -e '
+      const fs=require("fs"),lines=fs.readFileSync(process.argv[1],"utf-8").split(/\r?\n/);
+      const skip=/^(mcp[: ]|OpenAI Codex|--------|workdir:|model:|provider:|approval:|sandbox:|reasoning|session id:|user$|tokens used|EXIT:|exec$|"[A-Z]:|succeeded in |\s*$)/;
+      const out=lines.filter(l=>!skip.test(l));
+      if(out.length) fs.writeFileSync(process.argv[2],out.join("\n"));
+    ' -- "$STDERR_LOG" "$STDOUT_LOG" 2>/dev/null || true
+  fi
+
+  # 3차: stderr tail before "tokens used"
+  if [[ ! -s "$STDOUT_LOG" ]]; then
+    sed 's/\r$//' "$STDERR_LOG" \
+      | awk '
+          /^tokens used/ { exit }
+          { buf[NR]=$0 }
+          END {
+            start=NR-200; if (start<1) start=1
+            for (i=start; i<=NR; i++) if (i in buf) print buf[i]
+          }' \
+      > "$STDOUT_LOG"
+  fi
+
+  if [[ -s "$STDOUT_LOG" ]]; then
+    echo "[tfx-route] 경고: codex stdout 비어있음, stderr에서 응답 복구 ($(wc -c < "$STDOUT_LOG" | tr -d ' ') bytes)" >&2
+  else
+    # 4차: FALLBACK_FAILED
+    echo "[tfx-route] FALLBACK_FAILED stderr_log=$STDERR_LOG" >&2
+    echo "[tfx-route] 경고: codex stdout 비어있음, stderr 복구도 실패. 위 stderr_log 경로에서 raw codex 출력 확인 가능." >&2
+  fi
+}

package/scripts/lib/context.mjs

@@ -0,0 +1,67 @@
+/**
+ * 요청별 로그 컨텍스트 전파 (AsyncLocalStorage 기반).
+ *
+ * Hub HTTP 서버의 요청마다 correlationId를 자동 할당하여,
+ * 하나의 요청에서 발생한 모든 로그를 추적할 수 있다.
+ *
+ * 사용법:
+ *   import { getLogger, getCorrelationId, withRequestContext } from './lib/context.mjs';
+ *
+ *   // 미들웨어에서 컨텍스트 생성
+ *   withRequestContext({ method: 'POST', path: '/bridge/result' }, () => {
+ *     const log = getLogger();
+ *     log.info({ agentId }, 'bridge.result_received');
+ *   });
+ *
+ *   // 내부 함수에서 자동 상관 ID
+ *   function processResult() {
+ *     const log = getLogger();
+ *     log.info('result.processed'); // correlationId 자동 포함
+ *   }
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
+
+import { logger } from "./logger.mjs";
+
+/** @type {AsyncLocalStorage<{logger: import('pino').Logger, correlationId: string}>} */
+export const asyncLocalStorage = new AsyncLocalStorage();
+
+/**
+ * 현재 요청 컨텍스트의 로거를 반환한다.
+ * 요청 컨텍스트 밖에서 호출하면 기본 로거를 반환한다.
+ *
+ * @returns {import('pino').Logger}
+ */
+export function getLogger() {
+  return asyncLocalStorage.getStore()?.logger || logger;
+}
+
+/**
+ * 현재 요청의 상관 ID를 반환한다.
+ *
+ * @returns {string|undefined}
+ */
+export function getCorrelationId() {
+  return asyncLocalStorage.getStore()?.correlationId;
+}
+
+/**
+ * 요청 컨텍스트를 생성하고 콜백을 실행한다.
+ *
+ * @param {object} context — 컨텍스트 필드 (method, path 등)
+ * @param {string} [context.correlationId] — 외부에서 전달된 상관 ID (없으면 자동 생성)
+ * @param {function} callback — 컨텍스트 내에서 실행할 함수
+ * @returns {*}
+ */
+export function withRequestContext(context, callback) {
+  const correlationId = context.correlationId || randomUUID();
+  const { correlationId: _, ...rest } = context;
+
+  const store = {
+    correlationId,
+    logger: logger.child({ correlationId, ...rest }),
+  };
+
+  return asyncLocalStorage.run(store, callback);
+}

package/scripts/lib/cross-review-utils.mjs

@@ -0,0 +1,59 @@
+import { join } from "node:path";
+
+export const SESSION_TTL_SEC = 30 * 60;
+export const STATE_REL_PATH = join(".triflux", "state", "cross-review.json");
+
+export function readStdin() {
+  return new Promise((resolve) => {
+    let raw = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      raw += chunk;
+    });
+    process.stdin.on("end", () => resolve(raw));
+    process.stdin.on("error", () => resolve(""));
+  });
+}
+
+export function parseJson(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+export function nowSec() {
+  return Math.floor(Date.now() / 1000);
+}
+
+export function resolveBaseDir(payload) {
+  if (typeof payload?.cwd === "string" && payload.cwd.trim())
+    return payload.cwd;
+  if (typeof payload?.directory === "string" && payload.directory.trim())
+    return payload.directory;
+  return process.cwd();
+}
+
+export function shouldTrackPath(filePath) {
+  if (typeof filePath !== "string" || !filePath.trim()) return false;
+
+  const lower = filePath.toLowerCase();
+  if (
+    lower.startsWith(".triflux/") ||
+    lower.startsWith(".omc/") ||
+    lower.startsWith(".claude/")
+  )
+    return false;
+  if (lower === "package-lock.json" || lower.endsWith("/package-lock.json"))
+    return false;
+  if (/\.(md|lock|yml|yaml)$/i.test(lower)) return false;
+  return true;
+}
+
+export function expectedReviewer(author) {
+  if (author === "claude") return "codex";
+  if (author === "codex") return "claude";
+  if (author === "gemini") return "claude";
+  return "";
+}

package/scripts/lib/doctor-env-checks.mjs

@@ -0,0 +1,121 @@
+import { execFileSync } from "node:child_process";
+
+export function commandExists(name) {
+  try {
+    execFileSync("sh", ["-c", 'command -v "$1" >/dev/null 2>&1', "sh", name], {
+      stdio: "ignore",
+      timeout: 2000,
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function inspectMacTimeoutDependency({
+  platform = process.platform,
+  commandExists: exists = commandExists,
+} = {}) {
+  if (platform !== "darwin") {
+    return { ok: true, status: "skipped", platform };
+  }
+
+  if (exists("gtimeout")) {
+    return { ok: true, status: "ok", platform, provider: "gtimeout" };
+  }
+  if (exists("timeout")) {
+    return { ok: true, status: "ok", platform, provider: "timeout" };
+  }
+
+  return {
+    ok: false,
+    status: "missing",
+    platform,
+    fix: "brew install coreutils",
+  };
+}
+
+export function addPluginRootFallbackToCommand(command, pluginRoot) {
+  if (typeof command !== "string") return command;
+  const fallbackRoot = String(pluginRoot || "").replace(/\\/g, "/");
+  if (!fallbackRoot) return command;
+  return command
+    .replaceAll("${PLUGIN_ROOT}", `\${PLUGIN_ROOT:-${fallbackRoot}}`)
+    .replaceAll(
+      "${CLAUDE_PLUGIN_ROOT}",
+      `\${CLAUDE_PLUGIN_ROOT:-${fallbackRoot}}`,
+    )
+    .replace(
+      /(^|[\s"'])\/(hooks|scripts)\//g,
+      `$1\${PLUGIN_ROOT:-${fallbackRoot}}/$2/`,
+    );
+}
+
+function hasBarePluginRootReference(command) {
+  if (typeof command !== "string") return false;
+  return (
+    command.includes("${PLUGIN_ROOT}/") ||
+    command.includes("${CLAUDE_PLUGIN_ROOT}/")
+  );
+}
+
+function hasCollapsedRootHookPath(command) {
+  if (typeof command !== "string") return false;
+  return /(^|[\s"'])\/(?:hooks|scripts)\//.test(command);
+}
+
+export function findPluginRootHookIssues(settings) {
+  const hooksByEvent =
+    settings?.hooks && typeof settings.hooks === "object" ? settings.hooks : {};
+  const issues = [];
+
+  for (const [event, entries] of Object.entries(hooksByEvent)) {
+    if (!Array.isArray(entries)) continue;
+    for (const entry of entries) {
+      const hooks = Array.isArray(entry?.hooks) ? entry.hooks : [];
+      for (const hook of hooks) {
+        const command = hook?.command;
+        if (
+          !hasBarePluginRootReference(command) &&
+          !hasCollapsedRootHookPath(command)
+        ) {
+          continue;
+        }
+        issues.push({
+          event,
+          matcher: entry?.matcher || "*",
+          command,
+          reason: hasCollapsedRootHookPath(command)
+            ? "collapsed-root-path"
+            : "missing-plugin-root-fallback",
+        });
+      }
+    }
+  }
+
+  return issues;
+}
+
+export function applyPluginRootHookFallbacks(settings, { pluginRoot } = {}) {
+  if (!settings?.hooks || typeof settings.hooks !== "object") {
+    return { changed: false, count: 0, settings };
+  }
+
+  let count = 0;
+  for (const entries of Object.values(settings.hooks)) {
+    if (!Array.isArray(entries)) continue;
+    for (const entry of entries) {
+      const hooks = Array.isArray(entry?.hooks) ? entry.hooks : [];
+      for (const hook of hooks) {
+        if (typeof hook?.command !== "string") continue;
+        const next = addPluginRootFallbackToCommand(hook.command, pluginRoot);
+        if (next !== hook.command) {
+          hook.command = next;
+          count++;
+        }
+      }
+    }
+  }
+
+  return { changed: count > 0, count, settings };
+}

package/scripts/lib/dynamic-route-cli.mjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+// scripts/lib/dynamic-route-cli.mjs
+//
+// Phase 1 Wire-up 3 helper — tfx-route.sh 등 sh 경로에서 dynamic routing
+// decision 을 받아 단일 CLI 문자열 (또는 JSON) 으로 출력한다.
+//
+// 사용:
+//   node scripts/lib/dynamic-route-cli.mjs --agent-hint codex
+//   → "codex"
+//   node scripts/lib/dynamic-route-cli.mjs --agent-hint codex --json
+//   → {"scenario":"fallback","mode":"codex-default","shards":[{"cli":"codex",...}]}
+//   node scripts/lib/dynamic-route-cli.mjs --agent-hint codex --field scenario
+//   → "fallback"
+//
+// 정책:
+//   - opt-in env TRIFLUX_DYNAMIC_ROUTING=1|true 미설정 시 즉시 silent exit 0
+//     (override 없음 = stdout empty, sh caller 가 graceful no-op).
+//   - error 발생 시 stderr 에 한 줄 + exit 0 (sh caller 가 fallback path 진행).
+
+import { createDynamicRouter } from "@triflux/core/hub/dynamic-routing-engine.mjs";
+
+function parseArgs(argv) {
+  const args = {
+    taskId: `tfx-route-${process.pid}-${Date.now()}`,
+    agentHint: "codex",
+    teamSize: 1,
+    json: false,
+    field: null,
+  };
+  for (let i = 2; i < argv.length; i++) {
+    const v = argv[i];
+    switch (v) {
+      case "--task-id":
+        args.taskId = argv[++i] || args.taskId;
+        break;
+      case "--agent-hint":
+        args.agentHint = argv[++i] || args.agentHint;
+        break;
+      case "--team-size":
+        args.teamSize = Number(argv[++i]) || args.teamSize;
+        break;
+      case "--json":
+        args.json = true;
+        break;
+      case "--field":
+        args.field = argv[++i] || null;
+        break;
+      case "--help":
+      case "-h":
+        process.stdout.write(
+          "Usage: dynamic-route-cli.mjs [--task-id ID] [--agent-hint CLI] [--team-size N] [--json|--field FIELD]\n",
+        );
+        process.exit(0);
+        break;
+    }
+  }
+  return args;
+}
+
+async function main() {
+  const args = parseArgs(process.argv);
+
+  // opt-in env 미설정 시 silent no-op (sh caller graceful path)
+  const flag = process.env.TRIFLUX_DYNAMIC_ROUTING;
+  if (flag !== "1" && flag !== "true") return;
+
+  let decision;
+  try {
+    const router = createDynamicRouter();
+    decision = await router.routeRequest({
+      task_id: args.taskId,
+      team_size: args.teamSize,
+      agent_hint: args.agentHint,
+    });
+  } catch (err) {
+    process.stderr.write(
+      `[dynamic-route-cli] error: ${err?.message || String(err)}\n`,
+    );
+    return;
+  }
+
+  if (args.json) {
+    process.stdout.write(JSON.stringify(decision));
+    return;
+  }
+
+  if (args.field) {
+    const value = decision?.[args.field];
+    if (value !== undefined && value !== null) {
+      process.stdout.write(String(value));
+    }
+    return;
+  }
+
+  // 기본 — shards[0].cli 만 stdout 으로 (sh caller 가 즉시 비교)
+  const cli = decision?.shards?.[0]?.cli;
+  if (cli) {
+    process.stdout.write(String(cli));
+  }
+}
+
+main().catch((err) => {
+  process.stderr.write(
+    `[dynamic-route-cli] fatal: ${err?.message || String(err)}\n`,
+  );
+  process.exit(0); // sh caller 가 정상 fallback 하도록 always 0
+});