@triflux/core 10.0.3 → 10.25.1

package/scripts/lib/async.mjs

@@ -0,0 +1,174 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  statSync,
+  writeFileSync,
+} from "node:fs";
+import { join } from "node:path";
+
+function jobDir(jobsDir, jobId) {
+  return join(jobsDir, jobId);
+}
+
+function readState(dir) {
+  const path = join(dir, "state.json");
+  if (!existsSync(path)) return null;
+  return JSON.parse(readFileSync(path, "utf8"));
+}
+
+function writeState(dir, state) {
+  writeFileSync(join(dir, "state.json"), `${JSON.stringify(state, null, 2)}\n`);
+}
+
+function fileSize(path) {
+  try {
+    return statSync(path).size;
+  } catch {
+    return 0;
+  }
+}
+
+function isAlive(pid) {
+  if (!pid || pid === "starting") return false;
+  try {
+    process.kill(Number(pid), 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function createJob({
+  jobsDir,
+  command,
+  args = [],
+  env = process.env,
+  cwd = process.cwd(),
+  timeoutMs = 0,
+}) {
+  mkdirSync(jobsDir, { recursive: true });
+  const id = randomUUID();
+  const dir = jobDir(jobsDir, id);
+  mkdirSync(dir, { recursive: true });
+  const startedAt = Date.now();
+  const stdoutPath = join(dir, "result.log");
+  const stderrPath = join(dir, "stderr.log");
+  writeState(dir, {
+    id,
+    state: "starting",
+    startedAt,
+    command,
+    args,
+    timeoutMs,
+  });
+  writeFileSync(join(dir, "pid"), "starting");
+  writeFileSync(join(dir, "start_time"), String(Math.floor(startedAt / 1000)));
+
+  const child = spawn(command, args, {
+    cwd,
+    env,
+    detached: true,
+    stdio: ["ignore", "pipe", "pipe"],
+  });
+  child.unref?.();
+  writeFileSync(join(dir, "pid"), String(child.pid));
+  writeState(dir, {
+    id,
+    state: "running",
+    pid: child.pid,
+    startedAt,
+    command,
+    args,
+    timeoutMs,
+  });
+  child.stdout?.on("data", (chunk) => {
+    writeFileSync(stdoutPath, chunk, { flag: "a" });
+  });
+  child.stderr?.on("data", (chunk) => {
+    writeFileSync(stderrPath, chunk, { flag: "a" });
+  });
+  let timer = null;
+  let timedOut = false;
+  if (timeoutMs > 0) {
+    timer = setTimeout(() => {
+      timedOut = true;
+      try {
+        process.kill(child.pid, "SIGTERM");
+      } catch {
+        // Process already exited.
+      }
+    }, timeoutMs);
+    timer.unref?.();
+  }
+  child.on("exit", (code) => {
+    if (timer) clearTimeout(timer);
+    const exitCode = timedOut ? 124 : (code ?? 1);
+    writeFileSync(join(dir, "exit_code"), String(exitCode));
+    writeFileSync(join(dir, "done"), "");
+    writeState(dir, {
+      id,
+      state: exitCode === 0 ? "done" : exitCode === 124 ? "timeout" : "failed",
+      pid: child.pid,
+      startedAt,
+      finishedAt: Date.now(),
+      exitCode,
+      command,
+      args,
+      timeoutMs,
+    });
+  });
+
+  return { id, dir, pid: child.pid };
+}
+
+export function getJobStatus(jobId, { jobsDir }) {
+  const dir = jobDir(jobsDir, jobId);
+  if (!existsSync(dir))
+    return { state: "error", text: "error: job not found", exitCode: 1 };
+  const state = readState(dir);
+  if (state?.state === "done") return { ...state, text: "done" };
+  if (state?.state === "timeout") return { ...state, text: "timeout" };
+  if (state?.state === "failed") return { ...state, text: "failed" };
+  const pidText = existsSync(join(dir, "pid"))
+    ? readFileSync(join(dir, "pid"), "utf8").trim()
+    : "";
+  if (pidText === "starting")
+    return { ...(state ?? {}), state: "starting", text: "starting" };
+  if (isAlive(pidText)) {
+    const start =
+      Number(readFileSync(join(dir, "start_time"), "utf8")) ||
+      Math.floor(Date.now() / 1000);
+    const elapsed = Math.max(0, Math.floor(Date.now() / 1000) - start);
+    const bytes = fileSize(join(dir, "result.log"));
+    return {
+      ...(state ?? {}),
+      state: "running",
+      text: `running elapsed=${elapsed}s output=${bytes}B`,
+    };
+  }
+  return { ...(state ?? {}), state: "failed", text: "failed" };
+}
+
+export function getJobResult(jobId, { jobsDir }) {
+  const dir = jobDir(jobsDir, jobId);
+  if (!existsSync(dir)) throw new Error("job not found");
+  const status = getJobStatus(jobId, { jobsDir });
+  if (!["done", "timeout", "failed"].includes(status.state)) {
+    throw new Error("job still running");
+  }
+  const stdout = existsSync(join(dir, "result.log"))
+    ? readFileSync(join(dir, "result.log"), "utf8")
+    : "";
+  const stderr = existsSync(join(dir, "stderr.log"))
+    ? readFileSync(join(dir, "stderr.log"), "utf8")
+    : "";
+  return {
+    state: status.state,
+    exitCode: status.exitCode ?? 1,
+    stdout: stdout || stderr,
+    stderr,
+  };
+}

package/scripts/lib/claudemd-scanner.mjs

@@ -23,7 +23,12 @@ const DEFAULT_TFX_TEMPLATE = [
 ].join("\n");
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
-const DEFAULT_TEMPLATE_PATH = join(SCRIPT_DIR, "..", "templates", "claudemd-tfx-section.md");
+const DEFAULT_TEMPLATE_PATH = join(
+  SCRIPT_DIR,
+  "..",
+  "templates",
+  "claudemd-tfx-section.md",
+);
 
 function resolveVersion(version) {
   if (version) return version;

package/scripts/lib/cli-agy.mjs

@@ -0,0 +1,62 @@
+// cli-agy.mjs — Antigravity (agy) CLI adapter (Phase 0 PoC).
+//
+// 책임: agy --print 는 stdin-only 이므로 plan() 에서 stdinMode="pipe" 시그널을 반환한다.
+// positional prompt 패턴은 환영 메시지 폴백을 유발하므로 사용 금지.
+//
+// 출처: scripts/tfx-route.sh route_agent() L1052-L1059, run_codex_exec() L2036-L2046.
+//        .claude/rules/tfx-update-logic.md Antigravity CLI 1.0.0 정밀 sanity matrix.
+
+export const id = "agy";
+export const cliType = "antigravity";
+export const command = "agy";
+
+const AGENT_PROFILES = {
+  antigravity: {
+    profile: "agy_v1",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "docs",
+  },
+  agy: {
+    profile: "agy_v1",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "docs",
+  },
+};
+
+const DEFAULT_PROFILE = AGENT_PROFILES.antigravity;
+
+export function plan({
+  agent,
+  prompt = "",
+  mcpProfile = "auto",
+  timeoutSec,
+  contextFile,
+} = {}) {
+  if (!agent) {
+    throw new Error("[cli-agy] 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: ["--print", "--dangerously-skip-permissions"],
+    stdinMode: "pipe",
+    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-claude.mjs

@@ -0,0 +1,78 @@
+// cli-claude.mjs — Claude native adapter (Phase 0 PoC).
+//
+// 책임: Claude 는 외부 CLI 가 아닌 Claude Code Agent 도구로 dispatch 된다. plan() 은
+// command=null 을 반환하고 호출자가 Agent() 로 라우팅하도록 신호한다.
+//
+// 출처: scripts/tfx-route.sh route_agent() L1062-L1063 (explore|claude),
+//        L1196-L1203 (TFX_CLI_MODE=gemini fallback), TFX_VERIFIER_OVERRIDE=claude.
+
+export const id = "claude";
+export const cliType = "claude-native";
+export const command = null;
+
+const AGENT_PROFILES = {
+  explore: {
+    timeoutSec: 600,
+    runMode: "fg",
+    opusOversight: false,
+    model: "haiku",
+  },
+  claude: {
+    timeoutSec: 600,
+    runMode: "fg",
+    opusOversight: false,
+    model: "haiku",
+  },
+  "test-engineer": {
+    timeoutSec: 1200,
+    runMode: "bg",
+    opusOversight: false,
+    model: "sonnet",
+  },
+  "qa-tester": {
+    timeoutSec: 1200,
+    runMode: "bg",
+    opusOversight: false,
+    model: "sonnet",
+  },
+  verifier: {
+    timeoutSec: 1200,
+    runMode: "fg",
+    opusOversight: false,
+    model: "sonnet",
+  },
+};
+
+const DEFAULT_PROFILE = AGENT_PROFILES.explore;
+
+export function plan({
+  agent,
+  prompt = "",
+  mcpProfile = "auto",
+  timeoutSec,
+  contextFile,
+} = {}) {
+  if (!agent) {
+    throw new Error("[cli-claude] agent required");
+  }
+  const cfg = AGENT_PROFILES[agent] ?? DEFAULT_PROFILE;
+  const effectiveTimeoutSec =
+    Number.isFinite(timeoutSec) && timeoutSec > 0 ? timeoutSec : cfg.timeoutSec;
+  return {
+    command,
+    profile: "claude-native",
+    effort: "n/a",
+    timeoutMs: effectiveTimeoutSec * 1000,
+    runMode: cfg.runMode,
+    opusOversight: cfg.opusOversight,
+    model: cfg.model,
+    mcpProfile: mcpProfile === "auto" ? null : mcpProfile,
+    promptLength: prompt.length,
+    contextFile: contextFile || null,
+    note: "Claude native — dispatched via Claude Code Agent tool, not CLI",
+  };
+}
+
+export function describe() {
+  return { id, cliType, command, agents: Object.keys(AGENT_PROFILES) };
+}

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

@@ -19,10 +19,10 @@
  *     log.info('result.processed'); // correlationId 자동 포함
  *   }
  */
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { randomUUID } from 'node:crypto';
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
 
-import { logger } from './logger.mjs';
+import { logger } from "./logger.mjs";
 
 /** @type {AsyncLocalStorage<{logger: import('pino').Logger, correlationId: string}>} */
 export const asyncLocalStorage = new AsyncLocalStorage();

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

@@ -1,7 +1,7 @@
 import { join } from "node:path";
 
 export const SESSION_TTL_SEC = 30 * 60;
-export const STATE_REL_PATH = join(".omc", "state", "cross-review.json");
+export const STATE_REL_PATH = join(".triflux", "state", "cross-review.json");
 
 export function readStdin() {
   return new Promise((resolve) => {
@@ -28,8 +28,10 @@ export function nowSec() {
 }
 
 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;
+  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();
 }
 
@@ -37,8 +39,14 @@ export function shouldTrackPath(filePath) {
   if (typeof filePath !== "string" || !filePath.trim()) return false;
 
   const lower = filePath.toLowerCase();
-  if (lower.startsWith(".omc/") || lower.startsWith(".claude/")) return false;
-  if (lower === "package-lock.json" || lower.endsWith("/package-lock.json")) return false;
+  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;
 }