@triflux/core 10.50.1 → 10.50.2

package/hub/lib/path-utils.mjs

@@ -1,165 +0,0 @@
-// hub/lib/path-utils.mjs — Windows/POSIX 경로 변환 유틸리티
-
-/**
- * Windows 경로를 Git Bash 스타일 POSIX 경로로 변환한다.
- * C:\foo\bar → /c/foo/bar
- * 이미 POSIX 경로면 그대로 반환.
- * null/undefined → 빈 문자열
- * @param {string|null|undefined} windowsPath
- * @returns {string}
- */
-export function toPosixPath(windowsPath) {
-  if (windowsPath == null) return "";
-  const p = String(windowsPath);
-  if (!p) return "";
-
-  // 이미 POSIX 경로 (/ 로 시작하거나 드라이브 레터 없음)
-  const winDriveMatch = p.match(/^([A-Za-z]):[/\\](.*)/);
-  if (!winDriveMatch) {
-    // 백슬래시만 있는 상대 경로도 forward slash로 변환
-    return p.replace(/\\/g, "/");
-  }
-
-  const drive = winDriveMatch[1].toLowerCase();
-  const rest = winDriveMatch[2].replace(/\\/g, "/");
-  return `/${drive}/${rest}`;
-}
-
-/**
- * POSIX 경로(Git Bash 스타일)를 Windows 경로로 변환한다.
- * /c/foo/bar → C:\foo\bar
- * 이미 Windows 경로면 그대로 반환.
- * null/undefined → 빈 문자열
- * @param {string|null|undefined} posixPath
- * @returns {string}
- */
-export function toWindowsPath(posixPath) {
-  if (posixPath == null) return "";
-  const p = String(posixPath);
-  if (!p) return "";
-
-  // 이미 Windows 경로
-  if (/^[A-Za-z]:/.test(p)) {
-    return p.replace(/\//g, "\\");
-  }
-
-  // Git Bash 스타일: /c/foo/bar
-  const gitBashMatch = p.match(/^\/([a-zA-Z])(\/.*)?$/);
-  if (gitBashMatch) {
-    const drive = gitBashMatch[1].toUpperCase();
-    const rest = gitBashMatch[2] ? gitBashMatch[2].replace(/\//g, "\\") : "\\";
-    return `${drive}:${rest}`;
-  }
-
-  return p;
-}
-
-/**
- * 현재 OS에 맞게 경로를 정규화한다.
- * win32: backslash, 그 외: forward slash
- * @param {string|null|undefined} p
- * @returns {string}
- */
-export function normalizePath(p) {
-  if (p == null) return "";
-  const str = String(p);
-  if (process.platform === "win32") {
-    return str.replace(/\//g, "\\");
-  }
-  return str.replace(/\\/g, "/");
-}
-
-/**
- * 쉘 타입에 맞는 경로로 변환한다.
- * @param {string|null|undefined} path
- * @param {'git-bash'|'wsl'|'cmd'|'powershell'} shellType
- * @returns {string}
- */
-export function resolveShellPath(path, shellType) {
-  if (path == null) return "";
-  const p = String(path);
-
-  switch (shellType) {
-    case "git-bash":
-      return toPosixPath(p);
-
-    case "wsl": {
-      // Git Bash 경로를 먼저 Windows로 변환 후 WSL 형식으로
-      const winPath = /^[A-Za-z]:/.test(p) ? p : toWindowsPath(p);
-      const wslDriveMatch = winPath.match(/^([A-Za-z]):[/\\](.*)/);
-      if (wslDriveMatch) {
-        const drive = wslDriveMatch[1].toLowerCase();
-        const rest = wslDriveMatch[2].replace(/\\/g, "/");
-        return rest ? `/mnt/${drive}/${rest}` : `/mnt/${drive}`;
-      }
-      // 이미 /mnt/ 형식이면 그대로
-      if (p.startsWith("/mnt/")) return p;
-      return p.replace(/\\/g, "/");
-    }
-
-    case "cmd":
-    case "powershell":
-      return toWindowsPath(p);
-
-    default:
-      return p;
-  }
-}
-
-/**
- * 환경 변수와 플랫폼 정보로 현재 쉘 타입을 추론한다.
- * @returns {'git-bash'|'wsl'|'cmd'|'powershell'|'unix'}
- */
-export function detectShellType() {
-  // WSL 감지: WSL_DISTRO_NAME 또는 WSLENV
-  if (process.env.WSL_DISTRO_NAME || process.env.WSLENV) {
-    return "wsl";
-  }
-
-  // Windows 플랫폼
-  if (process.platform === "win32") {
-    const shell = process.env.SHELL || "";
-    const term = process.env.TERM || "";
-    const msystem = process.env.MSYSTEM || "";
-
-    // Git Bash 감지: SHELL=/usr/bin/bash + MSYSTEM=MINGW64 등
-    if (
-      shell.includes("bash") ||
-      msystem.startsWith("MINGW") ||
-      msystem.startsWith("MSYS") ||
-      term === "xterm"
-    ) {
-      return "git-bash";
-    }
-
-    // PowerShell 감지
-    if (process.env.PSModulePath || process.env.PSHOME) {
-      return "powershell";
-    }
-
-    return "cmd";
-  }
-
-  // 비-Windows
-  return "unix";
-}
-
-/**
- * WSL 경로 여부를 확인한다 (/mnt/ 시작).
- * @param {string|null|undefined} p
- * @returns {boolean}
- */
-export function isWslPath(p) {
-  if (p == null) return false;
-  return String(p).startsWith("/mnt/");
-}
-
-/**
- * Git Bash 경로 여부를 확인한다 (/c/ 또는 /d/ 등 단일 소문자 드라이브 레터).
- * @param {string|null|undefined} p
- * @returns {boolean}
- */
-export function isGitBashPath(p) {
-  if (p == null) return false;
-  return /^\/[a-zA-Z](\/|$)/.test(String(p));
-}

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",
-  };
-}

package/hub/pipeline/gates/consensus.mjs

@@ -1,106 +0,0 @@
-// hub/pipeline/gates/consensus.mjs — Consensus Quality Gate
-//
-// N개 결과의 합의도를 평가하여 5단계 분기 결정
-// proceed(>=90%) / proceed_warn(>=75%) / retry(<75%+재시도) / escalate(<75%+감독) / abort
-
-/** 단계별 합의 임계값 (%) */
-export const STAGE_THRESHOLDS = {
-  plan: 50,
-  define: 75,
-  execute: 75,
-  verify: 80,
-  security: 100,
-};
-
-/** 환경변수 기반 기본 임계값 (기본 75) */
-function getDefaultThreshold() {
-  const env =
-    typeof process !== "undefined" && process.env?.TRIFLUX_CONSENSUS_THRESHOLD;
-  if (env != null && env !== "") {
-    const parsed = Number(env);
-    if (!Number.isNaN(parsed) && parsed >= 0 && parsed <= 100) return parsed;
-  }
-  return 75;
-}
-
-/**
- * 성공률 기반 5단계 분기 결정
- * @param {number} successRate - 합의 성공률 (0-100)
- * @param {number} retryCount - 현재 재시도 횟수
- * @param {number} maxRetries - 최대 재시도 횟수
- * @param {string} [mode] - 실행 모드 ('supervised' | 기타)
- * @returns {'proceed' | 'proceed_warn' | 'retry' | 'escalate' | 'abort'}
- */
-export function evaluateQualityBranch(
-  successRate,
-  retryCount,
-  maxRetries,
-  mode,
-) {
-  if (successRate >= 90) return "proceed";
-  if (successRate >= 75) return "proceed_warn";
-
-  // <75%: 재시도 가능 여부에 따라 분기
-  if (retryCount < maxRetries) return "retry";
-  if (mode === "supervised") return "escalate";
-  return "abort";
-}
-
-/**
- * N개 결과의 합의도 평가
- * @param {Array<{ success: boolean }>} results - 평가 대상 결과 배열
- * @param {object} [options]
- * @param {string} [options.stage] - 파이프라인 단계 (STAGE_THRESHOLDS 키)
- * @param {number} [options.threshold] - 합의 임계값 직접 지정 (stage보다 우선)
- * @param {number} [options.retryCount=0] - 현재 재시도 횟수
- * @param {number} [options.maxRetries=2] - 최대 재시도 횟수
- * @param {string} [options.mode] - 실행 모드 ('supervised' 등)
- * @returns {{ successRate: number, threshold: number, decision: string, reasoning: string, results: Array }}
- */
-export function evaluateConsensus(results, options = {}) {
-  if (!Array.isArray(results) || results.length === 0) {
-    return {
-      successRate: 0,
-      threshold: options.threshold ?? getDefaultThreshold(),
-      decision: "abort",
-      reasoning: "평가 대상 결과가 없습니다.",
-      results: [],
-    };
-  }
-
-  const retryCount = options.retryCount ?? 0;
-  const maxRetries = options.maxRetries ?? 2;
-  const mode = options.mode;
-
-  // 임계값 결정: 직접 지정 > stage별 > 환경변수 > 기본 75
-  const threshold =
-    options.threshold ??
-    (options.stage && STAGE_THRESHOLDS[options.stage]) ??
-    getDefaultThreshold();
-
-  const successCount = results.filter((r) => r.success).length;
-  const successRate = Math.round((successCount / results.length) * 100);
-
-  const decision = evaluateQualityBranch(
-    successRate,
-    retryCount,
-    maxRetries,
-    mode,
-  );
-
-  const reasoningMap = {
-    proceed: `합의율 ${successRate}% (>= 90%): 전원 합의. 진행.`,
-    proceed_warn: `합의율 ${successRate}% (>= 75%): 부분 합의. 경고와 함께 진행.`,
-    retry: `합의율 ${successRate}% (< 75%): 재시도 ${retryCount + 1}/${maxRetries} 가능.`,
-    escalate: `합의율 ${successRate}% (< 75%): 감독 모드 에스컬레이션.`,
-    abort: `합의율 ${successRate}% (< 75%): 합의 실패. 중단.`,
-  };
-
-  return {
-    successRate,
-    threshold,
-    decision,
-    reasoning: reasoningMap[decision],
-    results,
-  };
-}

package/hub/pipeline/gates/index.mjs

@@ -1,9 +0,0 @@
-// hub/pipeline/gates/index.mjs — Quality Gates re-export
-
-export { CRITERIA, runConfidenceCheck } from "./confidence.mjs";
-export {
-  evaluateConsensus,
-  evaluateQualityBranch,
-  STAGE_THRESHOLDS,
-} from "./consensus.mjs";
-export { QUESTIONS, RED_FLAGS, runSelfCheck } from "./selfcheck.mjs";

package/hub/pipeline/gates/selfcheck.mjs

@@ -1,120 +0,0 @@
-// hub/pipeline/gates/selfcheck.mjs — Post-Execution Self-Check (Hallucination Detection)
-//
-// exec → verify → [selfcheck] → complete/fix
-// 4대 필수 질문 + 7대 할루시네이션 Red Flag 탐지
-
-export const RED_FLAGS = [
-  {
-    id: "test_pass_no_output",
-    pattern: /테스트\s*(?:가\s*)?통과/,
-    label: '"테스트 통과" (출력 없이)',
-  },
-  {
-    id: "everything_works",
-    pattern: /모든\s*게?\s*작동/,
-    label: '"모든게 작동" (증거 없이)',
-  },
-  {
-    id: "no_changes_with_diff",
-    pattern: /변경\s*(?:사항\s*)?없/,
-    label: '"변경 없음" (diff 있는데)',
-  },
-  {
-    id: "backward_compatible",
-    pattern: /호환성\s*(?:이\s*)?유지/,
-    label: '"호환성 유지" (검증 없이)',
-  },
-  {
-    id: "performance_improved",
-    pattern: /성능\s*(?:이\s*)?개선/,
-    label: '"성능 개선" (벤치마크 없이)',
-  },
-  {
-    id: "security_enhanced",
-    pattern: /보안\s*(?:이\s*)?강화/,
-    label: '"보안 강화" (증거 없이)',
-  },
-  {
-    id: "error_handling_done",
-    pattern: /에러\s*처리\s*(?:가\s*)?완료/,
-    label: '"에러 처리 완료" (catch 블록만)',
-  },
-];
-
-export const QUESTIONS = [
-  {
-    id: "tests_passing",
-    label: "모든 테스트 통과?",
-    evidenceKey: "testOutput",
-  },
-  {
-    id: "requirements_met",
-    label: "모든 요구사항 충족?",
-    evidenceKey: "requirementChecklist",
-  },
-  { id: "no_assumptions", label: "검증 없는 가정?", evidenceKey: "references" },
-  { id: "evidence_provided", label: "증거 있는가?", evidenceKey: "artifacts" },
-];
-
-/**
- * Red Flag 스캔 — 텍스트에서 할루시네이션 패턴 탐지
- * @param {string} text - 스캔 대상 텍스트
- * @param {object} context - { hasDiff?, evidence? }
- * @returns {Array<{ id: string, label: string }>}
- */
-function detectRedFlags(text, context = {}) {
-  const flags = [];
-  const evidence = context.evidence || {};
-
-  for (const rf of RED_FLAGS) {
-    if (!rf.pattern.test(text)) continue;
-
-    // "변경 없음"은 실제 diff가 있을 때만 Red Flag
-    if (rf.id === "no_changes_with_diff" && !context.hasDiff) continue;
-
-    // "테스트 통과"는 testOutput 증거가 없을 때만 Red Flag
-    if (rf.id === "test_pass_no_output" && evidence.testOutput) continue;
-
-    // 기타 Red Flag는 해당 id의 반증이 있으면 스킵
-    if (evidence[rf.id]) continue;
-
-    flags.push({ id: rf.id, label: rf.label });
-  }
-
-  return flags;
-}
-
-/**
- * Self-Check 실행
- * @param {string|object} execResult - 실행 결과 (텍스트 또는 객체)
- * @param {string|object} verifyResult - 검증 결과 (텍스트 또는 객체)
- * @param {object} requirements - { hasDiff?, evidence? }
- * @param {boolean} [requirements.hasDiff] - diff 존재 여부
- * @param {object} [requirements.evidence] - { testOutput, requirementChecklist, references, artifacts }
- * @returns {{ passed: boolean, score: number, flags: Array, checklist: Array }}
- */
-export function runSelfCheck(execResult, verifyResult, requirements = {}) {
-  const normalize = (v) =>
-    typeof v === "string" ? v : v != null ? JSON.stringify(v) : "";
-  const text = [normalize(execResult), normalize(verifyResult)].join("\n");
-
-  const flags = detectRedFlags(text, requirements);
-
-  const evidence = requirements.evidence || {};
-  const checklist = QUESTIONS.map((q) => {
-    const ev = evidence[q.evidenceKey];
-    const passed =
-      ev != null && (typeof ev === "string" ? ev.trim().length > 0 : true);
-    return { id: q.id, label: q.label, passed, evidence: ev || null };
-  });
-
-  const allQuestionsPassed = checklist.every((q) => q.passed);
-  const passed = flags.length === 0 && allQuestionsPassed;
-
-  // 점수: 기본 100, Red Flag당 -15, 실패 질문당 -20
-  const flagPenalty = flags.length * 15;
-  const questionPenalty = checklist.filter((q) => !q.passed).length * 20;
-  const score = Math.max(0, 100 - flagPenalty - questionPenalty);
-
-  return { passed, score, flags, checklist };
-}