triflux 9.8.2 → 9.8.3

package/hub/workers/interface.mjs

@@ -18,6 +18,16 @@
  * @property {number} [timeoutMs] - MCP 요청 타임아웃(ms)
  */
 
+/**
+ * 워커 구조화 오류 메타데이터
+ * @typedef {object} WorkerErrorInfo
+ * @property {string} code - 오류 코드
+ * @property {boolean} retryable - 재시도 대상 여부
+ * @property {number} attempts - 실행 시도 횟수
+ * @property {'transient'|'auth'|'config'|'input'} category - 오류 분류
+ * @property {string} recovery - 권장 복구 가이드
+ */
+
 /**
  * 워커 실행 결과
  * @typedef {object} WorkerResult
@@ -25,6 +35,7 @@
  * @property {number} exitCode - 종료 코드(0=성공)
  * @property {string | null} [threadId] - Codex 세션 threadId
  * @property {string | null} [sessionKey] - 내부 세션 키
+ * @property {WorkerErrorInfo} [error] - 구조화 오류 메타데이터
  * @property {unknown} [raw] - 원본 tool call 결과
  */
 
@@ -38,3 +49,4 @@
  * @property {string} type - 'codex' | 'gemini' | 'claude' | 'delegator'
  */
 
+export const WORKER_TYPES = Object.freeze(['codex', 'gemini', 'claude', 'delegator']);

package/hub/workers/worker-utils.mjs

@@ -24,3 +24,81 @@ export function createWorkerError(message, details = {}) {
   Object.assign(error, details);
   return error;
 }
+
+function sleep(delayMs) {
+  return new Promise((resolve) => {
+    const timer = setTimeout(resolve, Math.max(0, delayMs));
+    timer.unref?.();
+  });
+}
+
+export async function withRetry(fn, opts = {}) {
+  const {
+    maxAttempts = 3,
+    baseDelayMs = 1000,
+    maxDelayMs = 15000,
+    shouldRetry = () => true,
+  } = opts;
+
+  let lastError;
+
+  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      if (attempt >= maxAttempts || !shouldRetry(error, attempt)) {
+        throw error;
+      }
+
+      const delay = Math.min(baseDelayMs * 2 ** (attempt - 1), maxDelayMs)
+        * (0.5 + Math.random() * 0.5);
+      await sleep(delay);
+    }
+  }
+
+  throw lastError;
+}
+
+export function appendTextFragments(value, parts) {
+  if (value == null) return;
+
+  if (typeof value === 'string') {
+    const trimmed = value.trim();
+    if (trimmed) parts.push(trimmed);
+    return;
+  }
+
+  if (Array.isArray(value)) {
+    for (const item of value) appendTextFragments(item, parts);
+    return;
+  }
+
+  if (typeof value !== 'object') return;
+
+  if (typeof value.text === 'string') appendTextFragments(value.text, parts);
+  if (typeof value.response === 'string') appendTextFragments(value.response, parts);
+  if (typeof value.result === 'string') appendTextFragments(value.result, parts);
+  if (value.content != null) appendTextFragments(value.content, parts);
+  if (value.message != null) appendTextFragments(value.message, parts);
+}
+
+export function extractText(value) {
+  const parts = [];
+  appendTextFragments(value, parts);
+  return parts.join('\n').trim();
+}
+
+export function terminateChild(child, killGraceMs) {
+  if (!child || child.exitCode !== null || child.killed) return;
+
+  try { child.stdin.end(); } catch {}
+  try { child.kill(); } catch {}
+
+  const timer = setTimeout(() => {
+    if (child.exitCode === null) {
+      try { child.kill('SIGKILL'); } catch {}
+    }
+  }, killGraceMs);
+  timer.unref?.();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "9.8.2",
+  "version": "9.8.3",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -32,6 +32,9 @@
     "setup": "node scripts/setup.mjs",
     "preinstall": "node scripts/preinstall.mjs",
     "postinstall": "node scripts/setup.mjs",
+    "lint": "biome check .",
+    "lint:fix": "biome check --fix .",
+    "health": "npm test && npm run lint",
     "test": "node --test --test-force-exit --test-concurrency=1 \"tests/**/*.test.mjs\" \"scripts/__tests__/**/*.test.mjs\"",
     "test:unit": "node --test --test-force-exit --test-concurrency=1 tests/unit/**/*.test.mjs",
     "test:integration": "node --test --test-force-exit --test-concurrency=1 tests/integration/**/*.test.mjs",
@@ -55,6 +58,9 @@
     "systray2": "^2.1.4",
     "zod": "^4.0.0"
   },
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.0"
+  },
   "keywords": [
     "claude-code",
     "plugin",

package/scripts/headless-guard.mjs

@@ -190,7 +190,13 @@ async function main() {
     }
 
     // codex/gemini 직접 CLI 호출 → deny (인라인 TFX_ALLOW_DIRECT_CLI=1 우회 허용)
-    if (/\bcodex\b.*\bexec\b/.test(cmd) || /\bgemini\s+(-p|--prompt)\b/.test(cmd)) {
+    // 복합 명령(&&, ||, ;) 분리 후 각 세그먼트의 커맨드 위치만 검사 (args/quotes 안의 codex는 무시)
+    const cmdParts = cmd.split(/\s*(?:&&|\|\||;)\s*/);
+    const hasDirectCli = cmdParts.some(part => {
+      const stripped = part.replace(/^\s*(?:[\w_]+=\S+\s+)*/, "");
+      return /^\s*codex\b.*\bexec\b/i.test(stripped) || /^\s*gemini\s+(-p|--prompt)\b/i.test(stripped);
+    });
+    if (hasDirectCli) {
       if (/\bTFX_ALLOW_DIRECT_CLI=1\b/.test(cmd)) {
         nudge("[headless-guard] direct CLI mode (inline TFX_ALLOW_DIRECT_CLI=1)");
       }