triflux 10.4.0 → 10.7.0

package/hub/pipeline/index.mjs

@@ -2,21 +2,25 @@
 //
 // 상태(state.mjs) + 전이(transitions.mjs) 통합 인터페이스
 
-import { writeFileSync, mkdirSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { homedir } from 'node:os';
-
-import { canTransition, transitionPhase, ralphRestart, TERMINAL } from './transitions.mjs';
+import { mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { classifyIntent as _classifyIntent } from "../intent.mjs";
+import { runConfidenceCheck } from "./gates/confidence.mjs";
+import { runSelfCheck } from "./gates/selfcheck.mjs";
 import {
   ensurePipelineTable,
   initPipelineState,
   readPipelineState,
-  updatePipelineState,
   removePipelineState,
-} from './state.mjs';
-import { runConfidenceCheck } from './gates/confidence.mjs';
-import { runSelfCheck } from './gates/selfcheck.mjs';
-import { classifyIntent as _classifyIntent } from '../intent.mjs';
+  updatePipelineState,
+} from "./state.mjs";
+import {
+  canTransition,
+  ralphRestart,
+  TERMINAL,
+  transitionPhase,
+} from "./transitions.mjs";
 // deslop gate: 호출자가 scanDirectory/detectSlop 결과를 전달
 
 /**
@@ -127,12 +131,12 @@ export function createPipeline(db, teamName, opts = {}) {
      * @returns {string} 절대 경로
      */
     writePlanFile(content) {
-      const safeName = teamName.replace(/[<>:"/\\|?*\x00-\x1f]/g, '_');
-      const planDir = resolve(process.cwd(), '.tfx', 'plans');
+      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);
+      writeFileSync(planPath, content, "utf8");
+      this.setArtifact("plan_path", planPath);
       return planPath;
     },
 
@@ -170,20 +174,23 @@ export function createPipeline(db, teamName, opts = {}) {
       const current = readPipelineState(db, teamName);
       if (!current) return { ok: false, error: `파이프라인 없음: ${teamName}` };
 
-      if (current.phase !== 'confidence') {
-        return { ok: false, error: `confidence gate는 confidence 단계에서만 실행 가능 (현재: ${current.phase})` };
+      if (current.phase !== "confidence") {
+        return {
+          ok: false,
+          error: `confidence gate는 confidence 단계에서만 실행 가능 (현재: ${current.phase})`,
+        };
       }
 
       const gate = runConfidenceCheck(planArtifact, context);
-      this.setArtifact('confidence_result', gate);
+      this.setArtifact("confidence_result", gate);
 
-      if (gate.decision === 'abort') {
-        const result = this.advance('failed');
+      if (gate.decision === "abort") {
+        const result = this.advance("failed");
         return { ok: true, gate, state: result.state };
       }
 
       // proceed 또는 alternative → exec로 전이
-      const result = this.advance('exec');
+      const result = this.advance("exec");
       return { ok: result.ok, gate, state: result.state, error: result.error };
     },
 
@@ -198,15 +205,21 @@ export function createPipeline(db, teamName, opts = {}) {
       const current = readPipelineState(db, teamName);
       if (!current) return { ok: false, error: `파이프라인 없음: ${teamName}` };
 
-      if (current.phase !== 'deslop') {
-        return { ok: false, error: `deslop gate는 deslop 단계에서만 실행 가능 (현재: ${current.phase})` };
+      if (current.phase !== "deslop") {
+        return {
+          ok: false,
+          error: `deslop gate는 deslop 단계에서만 실행 가능 (현재: ${current.phase})`,
+        };
       }
 
-      const gate = deslopResult || { files: [], summary: { total: 0, clean: 0 } };
-      this.setArtifact('deslop_result', gate);
+      const gate = deslopResult || {
+        files: [],
+        summary: { total: 0, clean: 0 },
+      };
+      this.setArtifact("deslop_result", gate);
 
       // deslop은 항상 verify로 전이 (정보 제공 게이트, 차단 없음)
-      const result = this.advance('verify');
+      const result = this.advance("verify");
       return { ok: result.ok, gate, state: result.state, error: result.error };
     },
 
@@ -222,20 +235,28 @@ export function createPipeline(db, teamName, opts = {}) {
       const current = readPipelineState(db, teamName);
       if (!current) return { ok: false, error: `파이프라인 없음: ${teamName}` };
 
-      if (current.phase !== 'selfcheck') {
-        return { ok: false, error: `selfcheck gate는 selfcheck 단계에서만 실행 가능 (현재: ${current.phase})` };
+      if (current.phase !== "selfcheck") {
+        return {
+          ok: false,
+          error: `selfcheck gate는 selfcheck 단계에서만 실행 가능 (현재: ${current.phase})`,
+        };
       }
 
       const gate = runSelfCheck(execResult, verifyResult, requirements);
-      this.setArtifact('selfcheck_result', gate);
+      this.setArtifact("selfcheck_result", gate);
 
       if (gate.passed) {
-        const result = this.advance('complete');
-        return { ok: result.ok, gate, state: result.state, error: result.error };
+        const result = this.advance("complete");
+        return {
+          ok: result.ok,
+          gate,
+          state: result.state,
+          error: result.error,
+        };
       }
 
       // Red Flag 탐지 또는 필수 질문 실패 → fix
-      const result = this.advance('fix');
+      const result = this.advance("fix");
       return { ok: result.ok, gate, state: result.state, error: result.error };
     },
   };
@@ -248,7 +269,7 @@ let _tokenSnapshotMod = null;
 async function loadTokenSnapshot() {
   if (_tokenSnapshotMod) return _tokenSnapshotMod;
   try {
-    _tokenSnapshotMod = await import('../../scripts/token-snapshot.mjs');
+    _tokenSnapshotMod = await import("../../scripts/token-snapshot.mjs");
   } catch {
     _tokenSnapshotMod = null;
   }
@@ -266,7 +287,9 @@ export async function benchmarkStart(label) {
   try {
     const snapshot = mod.takeSnapshot(label);
     return { label, snapshot };
-  } catch { return null; }
+  } catch {
+    return null;
+  }
 }
 
 /**
@@ -286,14 +309,22 @@ export async function benchmarkEnd(preLabel, postLabel, options = {}) {
     const diff = mod.computeDiff(preLabel, postLabel, options);
 
     // 추가로 타임스탬프 기반 사본 저장
-    const diffsDir = join(homedir(), '.omc', 'state', 'cx-auto-tokens', 'diffs');
+    const diffsDir = join(
+      homedir(),
+      ".omc",
+      "state",
+      "cx-auto-tokens",
+      "diffs",
+    );
     mkdirSync(diffsDir, { recursive: true });
-    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const ts = new Date().toISOString().replace(/[:.]/g, "-");
     const outPath = join(diffsDir, `${ts}.json`);
     writeFileSync(outPath, JSON.stringify(diff, null, 2));
 
     return diff;
-  } catch { return null; }
+  } catch {
+    return null;
+  }
 }
 
 /**
@@ -310,9 +341,13 @@ export function triageWithIntent(prompt, threshold = 0.8) {
   return { skip: false, routing: null, classification };
 }
 
-export { ensurePipelineTable } from './state.mjs';
-export { PHASES, TERMINAL, ALLOWED, canTransition } from './transitions.mjs';
-export { CRITERIA, runConfidenceCheck } from './gates/confidence.mjs';
-export { RED_FLAGS, QUESTIONS, runSelfCheck } from './gates/selfcheck.mjs';
-export { detectSlop, autoFixSlop, scanDirectory } from '../quality/deslop.mjs';
-export { quickClassify, classifyIntent, INTENT_CATEGORIES } from '../intent.mjs';
+export {
+  classifyIntent,
+  INTENT_CATEGORIES,
+  quickClassify,
+} from "../intent.mjs";
+export { autoFixSlop, detectSlop, scanDirectory } from "../quality/deslop.mjs";
+export { CRITERIA, runConfidenceCheck } from "./gates/confidence.mjs";
+export { QUESTIONS, RED_FLAGS, runSelfCheck } from "./gates/selfcheck.mjs";
+export { ensurePipelineTable } from "./state.mjs";
+export { ALLOWED, canTransition, PHASES, TERMINAL } from "./transitions.mjs";

package/hub/pipeline/state.mjs

@@ -3,9 +3,9 @@
 // store.mjs의 기존 SQLite 연결(db)을 활용한다.
 // pipeline_state 테이블은 schema.sql에 정의.
 
-import { join } from 'node:path';
+import { join } from "node:path";
 
-import { TFX_STATE_DIR, ensureTfxDirs } from '../paths.mjs';
+import { ensureTfxDirs, TFX_STATE_DIR } from "../paths.mjs";
 
 /**
  * 파이프라인 상태 DB 경로를 계산한다.
@@ -13,7 +13,7 @@ import { TFX_STATE_DIR, ensureTfxDirs } from '../paths.mjs';
  * @returns {string}
  */
 export function getPipelineStateDbPath(baseDir) {
-  return join(baseDir, TFX_STATE_DIR, 'state.db');
+  return join(baseDir, TFX_STATE_DIR, "state.db");
 }
 
 /**
@@ -54,7 +54,7 @@ function getStatements(db) {
   if (s) return s;
 
   s = {
-    get: db.prepare('SELECT * FROM pipeline_state WHERE team_name = ?'),
+    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)
@@ -71,8 +71,8 @@ function getStatements(db) {
         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'),
+    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;
@@ -82,15 +82,15 @@ function parseRow(row) {
   if (!row) return null;
   return {
     ...row,
-    artifacts: JSON.parse(row.artifacts || '{}'),
-    phase_history: JSON.parse(row.phase_history || '[]'),
+    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',
+    phase: state.phase || "plan",
     fix_attempt: state.fix_attempt ?? 0,
     fix_max: state.fix_max ?? 3,
     ralph_iteration: state.ralph_iteration ?? 0,
@@ -115,7 +115,7 @@ export function initPipelineState(db, teamName, opts = {}) {
     const now = Date.now();
     const state = {
       team_name: teamName,
-      phase: 'plan',
+      phase: "plan",
       fix_attempt: 0,
       fix_max: opts.fix_max ?? 3,
       ralph_iteration: 0,

package/hub/pipeline/transitions.mjs

@@ -5,23 +5,31 @@
 // complete, failed = 터미널 상태
 
 export const PHASES = [
-  'plan', 'prd', 'confidence', 'exec', 'deslop', 'verify', 'selfcheck',
-  'fix', 'complete', 'failed',
+  "plan",
+  "prd",
+  "confidence",
+  "exec",
+  "deslop",
+  "verify",
+  "selfcheck",
+  "fix",
+  "complete",
+  "failed",
 ];
 
-export const TERMINAL = new Set(['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':     [],
+  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: [],
 };
 
 /**
@@ -48,14 +56,14 @@ export function transitionPhase(state, nextPhase) {
   if (!canTransition(current, nextPhase)) {
     return {
       ok: false,
-      error: `전이 불가: ${current} → ${nextPhase}. 허용: [${(ALLOWED[current] || []).join(', ')}]`,
+      error: `전이 불가: ${current} → ${nextPhase}. 허용: [${(ALLOWED[current] || []).join(", ")}]`,
     };
   }
 
   const next = { ...state, phase: nextPhase, updated_at: Date.now() };
 
   // fix 단계 진입 시 attempt 증가 + 바운딩
-  if (nextPhase === 'fix') {
+  if (nextPhase === "fix") {
     next.fix_attempt = (state.fix_attempt || 0) + 1;
     if (next.fix_attempt > (state.fix_max || 3)) {
       return {
@@ -66,22 +74,24 @@ export function transitionPhase(state, nextPhase) {
   }
 
   // fix → exec 재진입 시 (fix 후 재실행)
-  if (current === 'fix' && nextPhase === 'exec') {
+  if (current === "fix" && nextPhase === "exec") {
     // fix_attempt 유지 (이미 fix 진입 시 증가됨)
   }
 
   // verify → fix → ... → verify 반복 후 fix_max 초과 시 ralph loop
-  if (nextPhase === 'failed' && current === 'fix') {
+  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';
+      next.phase = "failed";
     }
   }
 
   // phase_history 기록
-  const history = Array.isArray(state.phase_history) ? [...state.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;
 
@@ -96,7 +106,7 @@ export function transitionPhase(state, nextPhase) {
  */
 export function ralphRestart(state) {
   if (TERMINAL.has(state.phase)) {
-    return { ok: false, error: '터미널 상태에서 재시작 불가' };
+    return { ok: false, error: "터미널 상태에서 재시작 불가" };
   }
 
   const iteration = (state.ralph_iteration || 0) + 1;
@@ -107,14 +117,21 @@ export function ralphRestart(state) {
     };
   }
 
-  const history = Array.isArray(state.phase_history) ? [...state.phase_history] : [];
-  history.push({ from: state.phase, to: 'plan', at: Date.now(), ralph_restart: true });
+  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',
+      phase: "plan",
       fix_attempt: 0,
       ralph_iteration: iteration,
       phase_history: history,

package/hub/platform.mjs

@@ -1,45 +1,45 @@
-import os from 'node:os';
-import path from 'node:path';
-import { execFile, execFileSync, execSync } from 'node:child_process';
-
-export const IS_WINDOWS = process.platform === 'win32';
-export const IS_MAC = process.platform === 'darwin';
-export const IS_LINUX = process.platform === 'linux';
-export const TEMP_DIR = IS_WINDOWS ? os.tmpdir() : '/tmp';
+import { execFile, execFileSync, execSync } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+
+export const IS_WINDOWS = process.platform === "win32";
+export const IS_MAC = process.platform === "darwin";
+export const IS_LINUX = process.platform === "linux";
+export const TEMP_DIR = IS_WINDOWS ? os.tmpdir() : "/tmp";
 export const PATH_SEP = path.sep;
 
 function getPathApi(platform) {
-  return platform === 'win32' ? path.win32 : path.posix;
+  return platform === "win32" ? path.win32 : path.posix;
 }
 
 function coercePathInput(value, platform) {
-  const text = String(value ?? '');
-  if (platform === 'win32') {
-    return text.replaceAll('/', '\\');
+  const text = String(value ?? "");
+  if (platform === "win32") {
+    return text.replaceAll("/", "\\");
   }
-  return text.replaceAll('\\', '/');
+  return text.replaceAll("\\", "/");
 }
 
 function sanitizePipeSegment(value) {
-  return String(value ?? '')
+  return String(value ?? "")
     .trim()
-    .replace(/[<>:"/\\|?*\u0000-\u001f]+/gu, '-')
-    .replace(/-+/g, '-')
-    .replace(/^-|-$/g, '');
+    .replace(/[<>:"/\\|?*\u0000-\u001f]+/gu, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
 }
 
 function buildWhichCommandSpec(name, options = {}) {
-  const commandName = String(name ?? '').trim();
+  const commandName = String(name ?? "").trim();
   if (!commandName) return null;
 
   const platform = options.platform || process.platform;
   return {
-    lookupCommand: platform === 'win32' ? 'where' : 'which',
+    lookupCommand: platform === "win32" ? "where" : "which",
     args: [commandName],
     execOptions: {
-      encoding: 'utf8',
+      encoding: "utf8",
       timeout: options.timeout ?? 5000,
-      stdio: ['ignore', 'pipe', 'ignore'],
+      stdio: ["ignore", "pipe", "ignore"],
       windowsHide: true,
       env: options.env || process.env,
       cwd: options.cwd,
@@ -48,10 +48,12 @@ function buildWhichCommandSpec(name, options = {}) {
 }
 
 function parseWhichCommandOutput(output) {
-  return String(output)
-    .split(/\r?\n/u)
-    .map((line) => line.trim())
-    .find(Boolean) || null;
+  return (
+    String(output)
+      .split(/\r?\n/u)
+      .map((line) => line.trim())
+      .find(Boolean) || null
+  );
 }
 
 function execFileAsync(command, args, options, execFileFn = execFile) {
@@ -69,7 +71,7 @@ function execFileAsync(command, args, options, execFileFn = execFile) {
 /**
  * 경로를 플랫폼에 맞게 정규화합니다.
  * Windows 환경에서는 역슬래시(\)를 슬래시(/)로 변환하여 반환합니다.
- * 
+ *
  * @param {string} value - 정규화할 경로 문자열
  * @param {object} [options] - 옵션
  * @param {string} [options.platform] - 대상 플랫폼 (기본값: process.platform)
@@ -80,8 +82,8 @@ export function normalizePath(value, options = {}) {
   const pathApi = getPathApi(platform);
   const normalized = pathApi.normalize(coercePathInput(value, platform));
 
-  if (platform === 'win32') {
-    return normalized.replaceAll('\\', '/');
+  if (platform === "win32") {
+    return normalized.replaceAll("\\", "/");
   }
   return normalized;
 }
@@ -89,7 +91,7 @@ export function normalizePath(value, options = {}) {
 /**
  * 시스템에서 실행 가능한 명령의 절대 경로를 찾습니다.
  * Windows에서는 'where', Unix 계열에서는 'which' 명령을 사용합니다.
- * 
+ *
  * @param {string} name - 찾을 명령어 이름
  * @param {object} [options] - 옵션
  * @param {string} [options.platform] - 대상 플랫폼
@@ -103,7 +105,11 @@ export function whichCommand(name, options = {}) {
   if (!spec) return null;
 
   try {
-    const output = execFileSync(spec.lookupCommand, spec.args, spec.execOptions);
+    const output = execFileSync(
+      spec.lookupCommand,
+      spec.args,
+      spec.execOptions,
+    );
     return parseWhichCommandOutput(output);
   } catch {
     return null;
@@ -130,7 +136,7 @@ export async function whichCommandAsync(name, options = {}) {
 /**
  * 프로세스를 종료합니다.
  * Windows에서는 트리 구조 종료(/T) 및 강제 종료(/F)를 지원합니다.
- * 
+ *
  * @param {number|string} pid - 종료할 프로세스 ID
  * @param {object} [options] - 옵션
  * @param {string} [options.platform] - 대상 플랫폼
@@ -145,23 +151,23 @@ export function killProcess(pid, options = {}) {
   if (!Number.isInteger(numericPid) || numericPid <= 0) return false;
 
   const platform = options.platform || process.platform;
-  const signal = options.signal || 'SIGTERM';
+  const signal = options.signal || "SIGTERM";
   const tree = options.tree === true;
-  const force = options.force === true || signal === 'SIGKILL';
+  const force = options.force === true || signal === "SIGKILL";
 
   try {
-    if (platform === 'win32' && (tree || force)) {
+    if (platform === "win32" && (tree || force)) {
       const command = [
-        'taskkill',
-        '/PID',
+        "taskkill",
+        "/PID",
         String(numericPid),
-        tree ? '/T' : '',
-        force ? '/F' : '',
+        tree ? "/T" : "",
+        force ? "/F" : "",
       ]
         .filter(Boolean)
-        .join(' ');
+        .join(" ");
       execSync(command, {
-        stdio: 'ignore',
+        stdio: "ignore",
         timeout: options.timeout ?? 5000,
         windowsHide: true,
       });
@@ -178,7 +184,7 @@ export function killProcess(pid, options = {}) {
 /**
  * 플랫폼별 IPC 파이프 또는 소켓 경로를 생성합니다.
  * Windows에서는 네임드 파이프 경로를, Unix 계열에서는 도메인 소켓 파일 경로를 반환합니다.
- * 
+ *
  * @param {string} name - 파이프/소켓 기본 이름
  * @param {number|string} [pid=process.pid] - 프로세스 ID (식별자 추가용)
  * @param {object} [options] - 옵션
@@ -188,10 +194,10 @@ export function killProcess(pid, options = {}) {
  */
 export function pipePath(name, pid = process.pid, options = {}) {
   const platform = options.platform || process.platform;
-  const safeName = sanitizePipeSegment(name) || 'triflux';
-  const suffix = pid == null || pid === '' ? safeName : `${safeName}-${pid}`;
+  const safeName = sanitizePipeSegment(name) || "triflux";
+  const suffix = pid == null || pid === "" ? safeName : `${safeName}-${pid}`;
 
-  if (platform === 'win32') {
+  if (platform === "win32") {
     return `\\\\.\\pipe\\${suffix}`;
   }
 
@@ -202,7 +208,7 @@ export function pipePath(name, pid = process.pid, options = {}) {
 /**
  * 특정 경로가 대상 디렉토리 내부에 포함되는지 확인합니다.
  * 대소문자 구분 및 상대 경로 처리를 플랫폼 규격에 맞게 수행합니다.
- * 
+ *
  * @param {string} resolvedPath - 검사할 절대 경로
  * @param {string} dir - 기준이 되는 대상 디렉토리 경로
  * @param {object} [options] - 옵션
@@ -217,9 +223,12 @@ export function isPathWithin(resolvedPath, dir, options = {}) {
   const left = pathApi.resolve(coercePathInput(resolvedPath, platform));
   const right = pathApi.resolve(coercePathInput(dir, platform));
 
-  const normalizedLeft = platform === 'win32' ? left.toLowerCase() : left;
-  const normalizedRight = platform === 'win32' ? right.toLowerCase() : right;
+  const normalizedLeft = platform === "win32" ? left.toLowerCase() : left;
+  const normalizedRight = platform === "win32" ? right.toLowerCase() : right;
   const relative = pathApi.relative(normalizedRight, normalizedLeft);
 
-  return relative === '' || (!relative.startsWith('..') && !pathApi.isAbsolute(relative));
+  return (
+    relative === "" ||
+    (!relative.startsWith("..") && !pathApi.isAbsolute(relative))
+  );
 }