triflux 7.1.4 → 7.2.2

package/hub/pipeline/gates/confidence.mjs

@@ -52,5 +52,5 @@ export function runConfidenceCheck(planArtifact, context = {}) {
     reasoning = `확신도 ${totalScore}%: 기준 미달. 실행 중단.`;
   }
 
-  return { score: totalScore, breakdown, decision, reasoning };
+  return { score: totalScore, breakdown, decision, reasoning, needsReview: decision === 'alternative' };
 }

package/hub/pipeline/gates/selfcheck.mjs

@@ -58,10 +58,8 @@ function detectRedFlags(text, context = {}) {
  * @returns {{ passed: boolean, score: number, flags: Array, checklist: Array }}
  */
 export function runSelfCheck(execResult, verifyResult, requirements = {}) {
-  const text = [
-    typeof execResult === 'string' ? execResult : JSON.stringify(execResult || ''),
-    typeof verifyResult === 'string' ? verifyResult : JSON.stringify(verifyResult || ''),
-  ].join('\n');
+  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);
 

package/hub/pipeline/state.mjs

@@ -1,187 +1,191 @@
-// hub/pipeline/state.mjs — Hub SQLite 파이프라인 상태 저장/로드
-//
-// store.mjs의 기존 SQLite 연결(db)을 활용한다.
-// pipeline_state 테이블은 schema.sql에 정의.
-
-import { join } from 'node:path';
-
-import { TFX_STATE_DIR, ensureTfxDirs } 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 = {}) {
-  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) {
-  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);
-}
+// hub/pipeline/state.mjs — Hub SQLite 파이프라인 상태 저장/로드
+//
+// store.mjs의 기존 SQLite 연결(db)을 활용한다.
+// pipeline_state 테이블은 schema.sql에 정의.
+
+import { join } from 'node:path';
+
+import { TFX_STATE_DIR, ensureTfxDirs } 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,120 +1,124 @@
-// 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 초과: ${next.fix_attempt}/${state.fix_max || 3}회. ralph loop로 승격 필요.`,
-      };
-    }
-  }
-
-  // fix → exec 재진입 시 (fix 후 재실행)
-  if (current === 'fix' && nextPhase === 'exec') {
-    // fix_attempt 유지 (이미 fix 진입 시 증가됨)
-  }
-
-  // verify → fix → ... → verify 반복 후 fix_max 초과 시 ralph loop
-  if (nextPhase === 'failed' && current === 'fix') {
-    // ralph loop 반복 증가
-    next.ralph_iteration = (state.ralph_iteration || 0) + 1;
-    if (next.ralph_iteration > (state.ralph_max || 10)) {
-      // 최종 실패 — ralph loop도 초과
-      next.phase = 'failed';
-    }
-  }
-
-  // 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) {
-  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(),
-    },
-  };
-}
+// 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}회 도달`,
+      };
+    }
+  }
+
+  // fix → exec 재진입 시 (fix 후 재실행)
+  if (current === 'fix' && nextPhase === 'exec') {
+    // fix_attempt 유지 (이미 fix 진입 시 증가됨)
+  }
+
+  // verify → fix → ... → verify 반복 후 fix_max 초과 시 ralph loop
+  if (nextPhase === 'failed' && current === 'fix') {
+    // ralph loop 반복 증가
+    next.ralph_iteration = (state.ralph_iteration || 0) + 1;
+    if (next.ralph_iteration > (state.ralph_max || 10)) {
+      // 최종 실패 — ralph loop도 초과
+      next.phase = 'failed';
+    }
+  }
+
+  // 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(),
+    },
+  };
+}