@triflux/core 10.50.1 → 10.51.0

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);
-}

package/hub/lib/timeline-adapter.mjs

@@ -1,190 +0,0 @@
-import { execFile } from "node:child_process";
-import { existsSync } from "node:fs";
-import { appendFile, mkdir, readFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { promisify } from "node:util";
-
-const execFileAsync = promisify(execFile);
-
-/**
- * @typedef {object} TimelineEvent
- * @property {string} skill
- * @property {string} event
- * @property {string} branch
- * @property {string} session
- * @property {string | undefined} [outcome]
- * @property {number | undefined} [durationS]
- * @property {string} ts
- */
-
-/**
- * @typedef {object} LogEventInput
- * @property {string} skill
- * @property {string} event
- * @property {string} branch
- * @property {string} session
- * @property {string | undefined} [outcome]
- * @property {number | undefined} [durationS]
- */
-
-/**
- * @typedef {object} LastSessionQuery
- * @property {string} branch
- * @property {string | undefined} [skill]
- */
-
-/**
- * @typedef {object} TimelineAdapter
- * @property {(event: LogEventInput) => Promise<void>} logEvent
- * @property {(n?: number) => Promise<TimelineEvent[]>} readRecent
- * @property {(query: LastSessionQuery) => Promise<TimelineEvent | null>} getLastSession
- */
-
-/**
- * @typedef {object} DetectedTimelineAdapter
- * @property {TimelineAdapter} adapter
- * @property {"gstack" | "null"} kind
- */
-
-/**
- * @param {string} filePath
- * @returns {Promise<TimelineEvent[]>}
- */
-async function readTimeline(filePath) {
-  try {
-    const content = await readFile(filePath, "utf8");
-    /** @type {TimelineEvent[]} */
-    const events = [];
-
-    for (const line of content.split(/\r?\n/)) {
-      if (!line.trim()) continue;
-
-      try {
-        events.push(JSON.parse(line));
-      } catch {
-        // Skip malformed lines to preserve remaining timeline history.
-      }
-    }
-
-    return events;
-  } catch (error) {
-    if (
-      error &&
-      typeof error === "object" &&
-      "code" in error &&
-      error.code === "ENOENT"
-    ) {
-      return [];
-    }
-    throw error;
-  }
-}
-
-/**
- * @param {string} filePath
- * @param {LogEventInput} event
- * @returns {Promise<void>}
- */
-async function appendTimeline(filePath, event) {
-  await mkdir(path.dirname(filePath), { recursive: true });
-  const entry = {
-    ...event,
-    ts: new Date().toISOString(),
-  };
-  await appendFile(filePath, `${JSON.stringify(entry)}\n`, "utf8");
-}
-
-/**
- * @param {() => Promise<string>} resolveFilePath
- * @returns {TimelineAdapter}
- */
-function createTimelineAdapter(resolveFilePath) {
-  return {
-    async logEvent(event) {
-      const filePath = await resolveFilePath();
-      await appendTimeline(filePath, event);
-    },
-
-    async readRecent(n = 10) {
-      const filePath = await resolveFilePath();
-      const events = await readTimeline(filePath);
-      const limit = Number.isFinite(n) ? Math.trunc(n) : 10;
-      if (limit <= 0) return [];
-      return events.slice(-limit);
-    },
-
-    async getLastSession({ branch, skill }) {
-      const filePath = await resolveFilePath();
-      const events = await readTimeline(filePath);
-
-      for (let index = events.length - 1; index >= 0; index -= 1) {
-        const entry = events[index];
-        if (!entry?.session) continue;
-        if (entry.branch !== branch) continue;
-        if (skill && entry.skill !== skill) continue;
-        return entry;
-      }
-
-      return null;
-    },
-  };
-}
-
-/**
- * @returns {Promise<string>}
- */
-async function resolveRepoSlug() {
-  const { stdout } = await execFileAsync(
-    "git",
-    ["rev-parse", "--show-toplevel"],
-    {
-      cwd: process.cwd(),
-      encoding: "utf8",
-    },
-  );
-  return path.basename(stdout.trim());
-}
-
-/**
- * @returns {Promise<string>}
- */
-async function resolveGstackTimelinePath() {
-  const slug = await resolveRepoSlug();
-  return path.join(os.homedir(), ".gstack", "projects", slug, "timeline.jsonl");
-}
-
-/**
- * @returns {Promise<string>}
- */
-async function resolveNullTimelinePath() {
-  return path.join(process.cwd(), ".omc", "timeline.jsonl");
-}
-
-/** @type {TimelineAdapter} */
-export const gstackTimelineAdapter = createTimelineAdapter(
-  resolveGstackTimelinePath,
-);
-
-/** @type {TimelineAdapter} */
-export const nullTimelineAdapter = createTimelineAdapter(
-  resolveNullTimelinePath,
-);
-
-/**
- * @returns {DetectedTimelineAdapter}
- */
-export function detectAdapter() {
-  const gstackRoot = path.join(os.homedir(), ".gstack");
-  if (existsSync(gstackRoot)) {
-    return {
-      adapter: gstackTimelineAdapter,
-      kind: "gstack",
-    };
-  }
-
-  return {
-    adapter: nullTimelineAdapter,
-    kind: "null",
-  };
-}

package/hub/pipeline/gates/confidence.mjs

@@ -1,75 +0,0 @@
-// hub/pipeline/gates/confidence.mjs — Pre-Execution Confidence Gate
-//
-// plan → prd → [confidence] → exec
-// 5단계 확신도 검증: >=90% proceed / 70-89% alternative / <70% abort
-
-export const CRITERIA = [
-  { id: "no_duplicate", label: "중복 구현 없는지?", weight: 0.25 },
-  { id: "architecture", label: "아키텍처 준수?", weight: 0.25 },
-  { id: "docs_verified", label: "공식 문서 확인?", weight: 0.2 },
-  { id: "oss_reference", label: "OSS 레퍼런스?", weight: 0.15 },
-  { id: "root_cause", label: "근본 원인 파악?", weight: 0.15 },
-];
-
-/**
- * 확신도 검증 실행
- * @param {string|object} planArtifact - plan 단계에서 생성된 구현 계획
- * @param {object} context - { checks?, codebaseFiles?, existingTests? }
- * @param {object} [context.checks] - 각 기준별 점수 (boolean 또는 0-1 숫자)
- * @returns {{ score: number, breakdown: Array, decision: string, reasoning: string }}
- */
-export function runConfidenceCheck(planArtifact, context = {}) {
-  if (!planArtifact) {
-    return {
-      score: 0,
-      breakdown: CRITERIA.map((c) => ({
-        id: c.id,
-        label: c.label,
-        weight: c.weight,
-        score: 0,
-        passed: false,
-      })),
-      decision: "abort",
-      reasoning: "planArtifact가 제공되지 않았습니다.",
-    };
-  }
-
-  const checks = context.checks || {};
-
-  const breakdown = CRITERIA.map((c) => {
-    const raw = checks[c.id];
-    const score =
-      typeof raw === "number" ? Math.max(0, Math.min(1, raw)) : raw ? 1 : 0;
-    return {
-      id: c.id,
-      label: c.label,
-      weight: c.weight,
-      score,
-      passed: score >= 0.7,
-    };
-  });
-
-  const totalScore = Math.round(
-    breakdown.reduce((sum, b) => sum + b.score * b.weight, 0) * 100,
-  );
-
-  let decision, reasoning;
-  if (totalScore >= 90) {
-    decision = "proceed";
-    reasoning = `확신도 ${totalScore}%: 모든 기준 충족. 실행 진행.`;
-  } else if (totalScore >= 70) {
-    decision = "alternative";
-    reasoning = `확신도 ${totalScore}%: 일부 기준 미달. 대안 검토 필요.`;
-  } else {
-    decision = "abort";
-    reasoning = `확신도 ${totalScore}%: 기준 미달. 실행 중단.`;
-  }
-
-  return {
-    score: totalScore,
-    breakdown,
-    decision,
-    reasoning,
-    needsReview: decision === "alternative",
-  };
-}