@triflux/core 10.51.0 → 10.53.0

package/hub/middleware/request-logger.mjs

@@ -1,191 +0,0 @@
-/**
- * Hub HTTP 서버 요청 로깅 미들웨어.
- *
- * raw http.createServer에 맞춘 래퍼. Express가 아닌 triflux Hub 전용.
- *
- * 사용법 (server.mjs에서):
- *   import { wrapRequestHandler } from './middleware/request-logger.mjs';
- *   const httpServer = createHttpServer(wrapRequestHandler(originalHandler));
- *
- * 각 요청에 correlationId를 할당하고, 응답 완료 시 구조화 로그를 남긴다.
- * health/status 체크는 로깅을 건너뛴다.
- */
-
-import { HUB_REQUEST_MONITOR_CACHE_PATH } from "../../hud/constants.mjs";
-import { createContextMonitor } from "../../hud/context-monitor.mjs";
-import {
-  getCorrelationId,
-  withRequestContext,
-} from "../../scripts/lib/context.mjs";
-import { createModuleLogger } from "../../scripts/lib/logger.mjs";
-
-const log = createModuleLogger("hub");
-const contextMonitor = createContextMonitor({
-  cachePath: HUB_REQUEST_MONITOR_CACHE_PATH,
-});
-
-const SKIP_PATHS = new Set(["/health", "/healthz", "/status", "/ready"]);
-const MAX_CAPTURE_BYTES = 256 * 1024;
-
-/**
- * 원본 request handler를 래핑하여 로깅 + 컨텍스트 전파를 추가한다.
- *
- * @param {function(import('http').IncomingMessage, import('http').ServerResponse): void} handler
- * @returns {function(import('http').IncomingMessage, import('http').ServerResponse): void}
- */
-export function wrapRequestHandler(handler) {
-  return (req, res) => {
-    const path = getRequestPath(req.url);
-
-    if (SKIP_PATHS.has(path)) {
-      return handler(req, res);
-    }
-
-    const correlationId =
-      req.headers["x-correlation-id"] ||
-      req.headers["x-request-id"] ||
-      undefined; // withRequestContext will generate one
-
-    withRequestContext(
-      {
-        correlationId,
-        method: req.method,
-        path,
-      },
-      () => {
-        const startTime = process.hrtime.bigint();
-        const reqChunks = [];
-        let reqBytes = 0;
-        let reqOverflow = false;
-
-        req.on("data", (chunk) => {
-          if (reqOverflow) return;
-          const buf = Buffer.isBuffer(chunk)
-            ? chunk
-            : Buffer.from(String(chunk));
-          reqBytes += buf.length;
-          if (reqBytes > MAX_CAPTURE_BYTES) {
-            reqOverflow = true;
-            reqChunks.length = 0;
-            return;
-          }
-          reqChunks.push(buf);
-        });
-
-        const resChunks = [];
-        let resBytes = 0;
-        let resOverflow = false;
-
-        const originalWrite = res.write.bind(res);
-        const originalEnd = res.end.bind(res);
-
-        function captureResponseChunk(chunk) {
-          if (resOverflow || chunk == null) return;
-          const buf = Buffer.isBuffer(chunk)
-            ? chunk
-            : Buffer.from(String(chunk));
-          resBytes += buf.length;
-          if (resBytes > MAX_CAPTURE_BYTES) {
-            resOverflow = true;
-            resChunks.length = 0;
-            return;
-          }
-          resChunks.push(buf);
-        }
-
-        res.write = function writePatched(chunk, ...args) {
-          captureResponseChunk(chunk);
-          return originalWrite(chunk, ...args);
-        };
-
-        res.end = function endPatched(chunk, ...args) {
-          captureResponseChunk(chunk);
-          return originalEnd(chunk, ...args);
-        };
-
-        // 응답 헤더에 상관 ID 포함
-        const cid = getCorrelationId();
-        if (cid) res.setHeader("X-Correlation-ID", cid);
-
-        // 응답 완료 시 로깅
-        res.on("finish", () => {
-          const duration =
-            Number(process.hrtime.bigint() - startTime) / 1_000_000;
-          const level =
-            res.statusCode >= 500
-              ? "error"
-              : res.statusCode >= 400
-                ? "warn"
-                : "info";
-          const reqBodyText = reqOverflow
-            ? ""
-            : Buffer.concat(reqChunks).toString("utf8");
-          const resBodyText = resOverflow
-            ? ""
-            : Buffer.concat(resChunks).toString("utf8");
-          const tokenSummary = contextMonitor.record({
-            requestBody: reqBodyText,
-            requestBytes:
-              reqBytes || Number(req.headers["content-length"] || 0),
-            responseBody: resBodyText,
-            responseBytes:
-              resBytes || Number(res.getHeader("content-length") || 0),
-          });
-
-          log[level](
-            {
-              status: res.statusCode,
-              duration: Math.round(duration * 100) / 100,
-              contentLength: res.getHeader("content-length") || 0,
-              tokenUsage: {
-                request: tokenSummary.requestTokens,
-                response: tokenSummary.responseTokens,
-                total: tokenSummary.totalTokens,
-                context: tokenSummary.display,
-                warningLevel: tokenSummary.warningLevel,
-                overheadMs: tokenSummary.overheadMs,
-              },
-            },
-            "http.response",
-          );
-
-          if (tokenSummary.warningLevel === "critical") {
-            log.error(
-              {
-                context: tokenSummary.display,
-                message: tokenSummary.warningMessage,
-              },
-              "context.critical",
-            );
-          } else if (tokenSummary.warningLevel === "warn") {
-            log.warn(
-              {
-                context: tokenSummary.display,
-                message: tokenSummary.warningMessage,
-              },
-              "context.warn",
-            );
-          } else if (tokenSummary.warningLevel === "info") {
-            log.info(
-              {
-                context: tokenSummary.display,
-                message: tokenSummary.warningMessage,
-              },
-              "context.info",
-            );
-          }
-        });
-
-        handler(req, res);
-      },
-    );
-  };
-}
-
-function getRequestPath(url = "/") {
-  try {
-    return new URL(url, "http://127.0.0.1").pathname;
-  } catch {
-    return String(url).replace(/\?.*/, "") || "/";
-  }
-}

package/hub/paths.mjs

@@ -1,24 +0,0 @@
-// hub/paths.mjs — triflux 워킹 디렉토리 경로 상수
-
-import { mkdirSync } from "node:fs";
-import { join } from "node:path";
-
-export const TFX_WORK_DIR = ".tfx";
-export const TFX_PLANS_DIR = join(TFX_WORK_DIR, "plans");
-export const TFX_REPORTS_DIR = join(TFX_WORK_DIR, "reports");
-export const TFX_STATE_DIR = join(TFX_WORK_DIR, "state");
-
-/**
- * triflux 워킹 디렉토리 구조를 보장한다.
- * @param {string} baseDir
- */
-export function ensureTfxDirs(baseDir) {
-  for (const relativeDir of [
-    TFX_WORK_DIR,
-    TFX_PLANS_DIR,
-    TFX_REPORTS_DIR,
-    TFX_STATE_DIR,
-  ]) {
-    mkdirSync(join(baseDir, relativeDir), { recursive: true });
-  }
-}

package/hub/pipeline/index.mjs

@@ -1,163 +0,0 @@
-// hub/pipeline/index.mjs — 파이프라인 매니저
-//
-// 상태(state.mjs) + 전이(transitions.mjs) 통합 인터페이스
-
-import { mkdirSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import {
-  ensurePipelineTable,
-  initPipelineState,
-  readPipelineState,
-  removePipelineState,
-  updatePipelineState,
-} from "./state.mjs";
-import {
-  canTransition,
-  ralphRestart,
-  TERMINAL,
-  transitionPhase,
-} from "./transitions.mjs";
-
-/**
- * 파이프라인 매니저 생성
- * @param {object} db - better-sqlite3 인스턴스 (store.db)
- * @param {string} teamName
- * @param {object} opts - { fix_max?, ralph_max? }
- * @returns {object} 파이프라인 API
- */
-export function createPipeline(db, teamName, opts = {}) {
-  ensurePipelineTable(db);
-
-  // 기존 상태가 있으면 로드, 없으면 초기화
-  let state = readPipelineState(db, teamName);
-  if (!state) {
-    state = initPipelineState(db, teamName, opts);
-  }
-
-  return {
-    /**
-     * 현재 상태 조회
-     */
-    getState() {
-      state = readPipelineState(db, teamName) || state;
-      return { ...state };
-    },
-
-    /**
-     * 다음 단계로 전이 가능 여부
-     * @param {string} phase
-     */
-    canAdvance(phase) {
-      const current = readPipelineState(db, teamName);
-      return current ? canTransition(current.phase, phase) : false;
-    },
-
-    /**
-     * 다음 단계로 전이
-     * @param {string} nextPhase
-     * @returns {{ ok: boolean, state?: object, error?: string }}
-     */
-    advance(nextPhase) {
-      const current = readPipelineState(db, teamName);
-      if (!current) {
-        return { ok: false, error: `파이프라인 없음: ${teamName}` };
-      }
-
-      const result = transitionPhase(current, nextPhase);
-      if (!result.ok) return result;
-
-      state = updatePipelineState(db, teamName, result.state);
-      return { ok: true, state: { ...state } };
-    },
-
-    /**
-     * ralph loop 재시작 (plan부터 다시)
-     * @returns {{ ok: boolean, state?: object, error?: string }}
-     */
-    restart() {
-      const current = readPipelineState(db, teamName);
-      if (!current) {
-        return { ok: false, error: `파이프라인 없음: ${teamName}` };
-      }
-
-      const result = ralphRestart(current);
-      if (!result.ok) return result;
-
-      state = updatePipelineState(db, teamName, result.state);
-      return { ok: true, state: { ...state } };
-    },
-
-    /**
-     * DAG 컨텍스트를 파이프라인 상태에 저장
-     * @param {{ dag_width: number, levels: Record<number, string[]>, edges: Array<{from:string, to:string}>, max_complexity: string, taskResults: Record<string, *> }} dagContext
-     */
-    setDagContext(dagContext) {
-      const current = readPipelineState(db, teamName);
-      if (!current) return;
-      const artifacts = { ...(current.artifacts || {}), dagContext };
-      state = updatePipelineState(db, teamName, { artifacts });
-    },
-
-    /**
-     * DAG 컨텍스트 조회 (편의 메서드)
-     * @returns {{ dag_width: number, levels: Record<number, string[]>, edges: Array<{from:string, to:string}>, max_complexity: string, taskResults: Record<string, *> } | null}
-     */
-    getDagContext() {
-      const current = readPipelineState(db, teamName) || state;
-      return current?.artifacts?.dagContext || null;
-    },
-
-    /**
-     * artifact 저장 (plan_path, prd_path, verify_report 등)
-     * @param {string} key
-     * @param {*} value
-     */
-    setArtifact(key, value) {
-      const current = readPipelineState(db, teamName);
-      if (!current) return;
-      const artifacts = { ...(current.artifacts || {}), [key]: value };
-      state = updatePipelineState(db, teamName, { artifacts });
-    },
-
-    /**
-     * Plan 파일을 .tfx/plans/{teamName}-plan.md 에 기록하고
-     * artifact('plan_path')에 절대 경로를 저장한다.
-     * @param {string} content - Plan markdown 내용
-     * @returns {string} 절대 경로
-     */
-    writePlanFile(content) {
-      const safeName = teamName.replace(/[<>:"/\\|?*\x00-\x1f]/g, "_");
-      const planDir = resolve(process.cwd(), ".tfx", "plans");
-      mkdirSync(planDir, { recursive: true });
-      const planPath = join(planDir, `${safeName}-plan.md`);
-      writeFileSync(planPath, content, "utf8");
-      this.setArtifact("plan_path", planPath);
-      return planPath;
-    },
-
-    /**
-     * 터미널 상태 여부
-     */
-    isTerminal() {
-      const current = readPipelineState(db, teamName);
-      return current ? TERMINAL.has(current.phase) : true;
-    },
-
-    /**
-     * 파이프라인 초기화 (리셋)
-     */
-    reset() {
-      state = initPipelineState(db, teamName, opts);
-      return { ...state };
-    },
-
-    /**
-     * 파이프라인 삭제
-     */
-    remove() {
-      return removePipelineState(db, teamName);
-    },
-  };
-}
-export { ensurePipelineTable } from "./state.mjs";
-export { ALLOWED, canTransition, PHASES, TERMINAL } from "./transitions.mjs";

package/hub/pipeline/state.mjs

@@ -1,191 +0,0 @@
-// hub/pipeline/state.mjs — Hub SQLite 파이프라인 상태 저장/로드
-//
-// store.mjs의 기존 SQLite 연결(db)을 활용한다.
-// pipeline_state 테이블은 schema.sql에 정의.
-
-import { join } from "node:path";
-
-import { ensureTfxDirs, TFX_STATE_DIR } from "../paths.mjs";
-
-/**
- * 파이프라인 상태 DB 경로를 계산한다.
- * @param {string} baseDir
- * @returns {string}
- */
-export function getPipelineStateDbPath(baseDir) {
-  return join(baseDir, TFX_STATE_DIR, "state.db");
-}
-
-/**
- * 파이프라인 상태 DB 경로와 .tfx 디렉토리를 준비한다.
- * @param {string} baseDir
- * @returns {string}
- */
-export function ensurePipelineStateDbPath(baseDir) {
-  ensureTfxDirs(baseDir);
-  return getPipelineStateDbPath(baseDir);
-}
-
-/**
- * pipeline_state 테이블 초기화 (store.db에 없으면 생성)
- * @param {object} db - better-sqlite3 인스턴스
- */
-export function ensurePipelineTable(db) {
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS pipeline_state (
-      team_name TEXT PRIMARY KEY,
-      phase TEXT NOT NULL DEFAULT 'plan',
-      fix_attempt INTEGER DEFAULT 0,
-      fix_max INTEGER DEFAULT 3,
-      ralph_iteration INTEGER DEFAULT 0,
-      ralph_max INTEGER DEFAULT 10,
-      artifacts TEXT DEFAULT '{}',
-      phase_history TEXT DEFAULT '[]',
-      created_at INTEGER,
-      updated_at INTEGER
-    )
-  `);
-}
-
-const STATEMENTS = new WeakMap();
-
-function getStatements(db) {
-  let s = STATEMENTS.get(db);
-  if (s) return s;
-
-  s = {
-    get: db.prepare("SELECT * FROM pipeline_state WHERE team_name = ?"),
-    insert: db.prepare(`
-      INSERT INTO pipeline_state (team_name, phase, fix_attempt, fix_max, ralph_iteration, ralph_max, artifacts, phase_history, created_at, updated_at)
-      VALUES (@team_name, @phase, @fix_attempt, @fix_max, @ralph_iteration, @ralph_max, @artifacts, @phase_history, @created_at, @updated_at)
-    `),
-    update: db.prepare(`
-      UPDATE pipeline_state SET
-        phase = @phase,
-        fix_attempt = @fix_attempt,
-        fix_max = @fix_max,
-        ralph_iteration = @ralph_iteration,
-        ralph_max = @ralph_max,
-        artifacts = @artifacts,
-        phase_history = @phase_history,
-        updated_at = @updated_at
-      WHERE team_name = @team_name
-    `),
-    remove: db.prepare("DELETE FROM pipeline_state WHERE team_name = ?"),
-    list: db.prepare("SELECT * FROM pipeline_state ORDER BY updated_at DESC"),
-  };
-  STATEMENTS.set(db, s);
-  return s;
-}
-
-function parseRow(row) {
-  if (!row) return null;
-  return {
-    ...row,
-    artifacts: JSON.parse(row.artifacts || "{}"),
-    phase_history: JSON.parse(row.phase_history || "[]"),
-  };
-}
-
-function serializeState(state) {
-  return {
-    team_name: state.team_name,
-    phase: state.phase || "plan",
-    fix_attempt: state.fix_attempt ?? 0,
-    fix_max: state.fix_max ?? 3,
-    ralph_iteration: state.ralph_iteration ?? 0,
-    ralph_max: state.ralph_max ?? 10,
-    artifacts: JSON.stringify(state.artifacts || {}),
-    phase_history: JSON.stringify(state.phase_history || []),
-    created_at: state.created_at ?? Date.now(),
-    updated_at: state.updated_at ?? Date.now(),
-  };
-}
-
-/**
- * 파이프라인 상태 초기화 (새 파이프라인)
- * @param {object} db - better-sqlite3 인스턴스
- * @param {string} teamName
- * @param {object} opts - { fix_max?, ralph_max? }
- * @returns {object} 초기 상태
- */
-export function initPipelineState(db, teamName, opts = {}) {
-  return db.transaction(() => {
-    const S = getStatements(db);
-    const now = Date.now();
-    const state = {
-      team_name: teamName,
-      phase: "plan",
-      fix_attempt: 0,
-      fix_max: opts.fix_max ?? 3,
-      ralph_iteration: 0,
-      ralph_max: opts.ralph_max ?? 10,
-      artifacts: {},
-      phase_history: [],
-      created_at: now,
-      updated_at: now,
-    };
-
-    // 기존 상태가 있으면 삭제 후 재생성
-    S.remove.run(teamName);
-    S.insert.run(serializeState(state));
-    return state;
-  })();
-}
-
-/**
- * 파이프라인 상태 조회
- * @param {object} db - better-sqlite3 인스턴스
- * @param {string} teamName
- * @returns {object|null}
- */
-export function readPipelineState(db, teamName) {
-  const S = getStatements(db);
-  return parseRow(S.get.get(teamName));
-}
-
-/**
- * 파이프라인 상태 업데이트 (부분 패치)
- * @param {object} db - better-sqlite3 인스턴스
- * @param {string} teamName
- * @param {object} patch - 업데이트할 필드
- * @returns {object|null} 업데이트된 상태
- */
-export function updatePipelineState(db, teamName, patch) {
-  return db.transaction(() => {
-    const S = getStatements(db);
-    const current = parseRow(S.get.get(teamName));
-    if (!current) return null;
-
-    const merged = {
-      ...current,
-      ...patch,
-      team_name: teamName, // team_name 변경 불가
-      updated_at: Date.now(),
-    };
-
-    S.update.run(serializeState(merged));
-    return merged;
-  })();
-}
-
-/**
- * 파이프라인 상태 삭제
- * @param {object} db - better-sqlite3 인스턴스
- * @param {string} teamName
- * @returns {boolean}
- */
-export function removePipelineState(db, teamName) {
-  const S = getStatements(db);
-  return S.remove.run(teamName).changes > 0;
-}
-
-/**
- * 활성 파이프라인 목록
- * @param {object} db - better-sqlite3 인스턴스
- * @returns {object[]}
- */
-export function listPipelineStates(db) {
-  const S = getStatements(db);
-  return S.list.all().map(parseRow);
-}

package/hub/pipeline/transitions.mjs

@@ -1,131 +0,0 @@
-// hub/pipeline/transitions.mjs — 파이프라인 단계 전이 규칙
-//
-// plan → prd → confidence → exec → deslop → verify → selfcheck → complete/fix
-// fix → exec/verify/complete/failed
-// complete, failed = 터미널 상태
-
-export const PHASES = [
-  "plan",
-  "prd",
-  "confidence",
-  "exec",
-  "deslop",
-  "verify",
-  "selfcheck",
-  "fix",
-  "complete",
-  "failed",
-];
-
-export const TERMINAL = new Set(["complete", "failed"]);
-
-export const ALLOWED = {
-  plan: ["prd"],
-  prd: ["confidence"],
-  confidence: ["exec", "failed"],
-  exec: ["deslop"],
-  deslop: ["verify"],
-  verify: ["selfcheck", "fix", "failed"],
-  selfcheck: ["complete", "fix"],
-  fix: ["exec", "verify", "complete", "failed"],
-  complete: [],
-  failed: [],
-};
-
-/**
- * 전이 가능 여부 확인
- * @param {string} from - 현재 단계
- * @param {string} to - 다음 단계
- * @returns {boolean}
- */
-export function canTransition(from, to) {
-  const targets = ALLOWED[from];
-  if (!targets) return false;
-  return targets.includes(to);
-}
-
-/**
- * 상태 전이 실행 — fix loop 바운딩 포함
- * @param {object} state - 파이프라인 상태 객체
- * @param {string} nextPhase - 다음 단계
- * @returns {{ ok: boolean, state?: object, error?: string }}
- */
-export function transitionPhase(state, nextPhase) {
-  const current = state.phase;
-
-  if (!canTransition(current, nextPhase)) {
-    return {
-      ok: false,
-      error: `전이 불가: ${current} → ${nextPhase}. 허용: [${(ALLOWED[current] || []).join(", ")}]`,
-    };
-  }
-
-  const next = { ...state, phase: nextPhase, updated_at: Date.now() };
-
-  // fix 단계 진입 시 attempt 증가 + 바운딩
-  if (nextPhase === "fix") {
-    next.fix_attempt = (state.fix_attempt || 0) + 1;
-    if (next.fix_attempt > (state.fix_max || 3)) {
-      return {
-        ok: false,
-        error: `fix loop 초과: ${state.fix_max || 3}회 도달`,
-      };
-    }
-  }
-
-  // verify → fix → ... → verify 반복 후 fix_max 초과 시 ralph loop
-  if (nextPhase === "failed" && current === "fix") {
-    next.ralph_iteration = (state.ralph_iteration || 0) + 1;
-  }
-
-  // phase_history 기록
-  const history = Array.isArray(state.phase_history)
-    ? [...state.phase_history]
-    : [];
-  history.push({ from: current, to: nextPhase, at: Date.now() });
-  next.phase_history = history;
-
-  return { ok: true, state: next };
-}
-
-/**
- * ralph loop 재시작 전이
- * fix_max 초과 시 plan으로 돌아가며 ralph_iteration 증가
- * @param {object} state - 현재 상태
- * @returns {{ ok: boolean, state?: object, error?: string }}
- */
-export function ralphRestart(state) {
-  if (TERMINAL.has(state.phase)) {
-    return { ok: false, error: "터미널 상태에서 재시작 불가" };
-  }
-
-  const iteration = (state.ralph_iteration || 0) + 1;
-  if (iteration > (state.ralph_max || 10)) {
-    return {
-      ok: false,
-      error: `ralph loop 초과: ${iteration}/${state.ralph_max || 10}회. 최종 실패.`,
-    };
-  }
-
-  const history = Array.isArray(state.phase_history)
-    ? [...state.phase_history]
-    : [];
-  history.push({
-    from: state.phase,
-    to: "plan",
-    at: Date.now(),
-    ralph_restart: true,
-  });
-
-  return {
-    ok: true,
-    state: {
-      ...state,
-      phase: "plan",
-      fix_attempt: 0,
-      ralph_iteration: iteration,
-      phase_history: history,
-      updated_at: Date.now(),
-    },
-  };
-}