triflux 2.4.7 → 3.0.0

package/scripts/mcp-check.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 // MCP 인벤토리 — 백그라운드 비동기 실행
-// Codex/Gemini의 MCP 서버 상태를 캐싱하여 cli-route.sh가 동적 힌트 생성에 사용
+// Codex/Gemini의 MCP 서버 상태를 캐싱하여 tfx-route.sh가 동적 힌트 생성에 사용
 //
 // 출력: ~/.claude/cache/mcp-inventory.json
-// 사용: cli-route.sh의 get_mcp_hint()에서 읽음
+// 사용: tfx-route.sh의 get_mcp_hint()에서 읽음
 
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
 import { join } from "path";

package/scripts/notion-read.mjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
-// notion-read.mjs v1.1 — Notion 대형 페이지 리더 (Codex/Gemini/Claude MCP 위임)
+// notion-read.mjs v1.2 — Notion 대형 페이지 리더 (Codex/Gemini/Claude MCP 위임)
 //
 // Codex/Gemini/Claude CLI에 설치된 Notion MCP를 활용하여 대형 페이지를 마크다운으로 추출.
 // 폴백 체인: Codex(무료) → Gemini(무료) → Claude(최후) → 에러
+// 이관 모드(--delegate): Claude(notion-guest 우선) 단독 실행 + 결과 파일 저장
 //
 // 사용법:
 //   node notion-read.mjs <notion-url-or-page-id> [옵션]
@@ -14,27 +15,28 @@
 //   --cli, -c <codex|gemini> CLI 강제 지정 (기본: 자동 + 폴백)
 //   --depth, -d <n>          중첩 블록 최대 깊이 (기본: 3)
 //   --guest                  notion-guest 통합 사용 (기본: notion)
+//   --delegate               Claude 이관 모드 (notion-guest 우선, 파일 저장)
 
-import { execSync } from "child_process";
-import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync, unlinkSync } from "fs";
-import { join, dirname } from "path";
-import { homedir, tmpdir } from "os";
+import { execSync } from 'child_process';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync, unlinkSync } from 'fs';
+import { join, dirname, resolve } from 'path';
+import { homedir, tmpdir } from 'os';
 
-const VERSION = "1.1";
-const CLAUDE_DIR = join(homedir(), ".claude");
-const MCP_CACHE = join(CLAUDE_DIR, "cache", "mcp-inventory.json");
-const LOG_FILE = join(CLAUDE_DIR, "logs", "cli-route-stats.jsonl");
-const ACC_FILE = join(CLAUDE_DIR, "cache", "sv-accumulator.json");
+const VERSION = '1.2';
+const CLAUDE_DIR = join(homedir(), '.claude');
+const MCP_CACHE = join(CLAUDE_DIR, 'cache', 'mcp-inventory.json');
+const LOG_FILE = join(CLAUDE_DIR, 'logs', 'tfx-route-stats.jsonl');
+const ACC_FILE = join(CLAUDE_DIR, 'cache', 'sv-accumulator.json');
 
 // ── ANSI 색상 ──
-const AMBER = "\x1b[38;5;214m";
-const GREEN = "\x1b[38;5;82m";
-const RED = "\x1b[38;5;196m";
-const YELLOW = "\x1b[33m";
-const DIM = "\x1b[2m";
-const BOLD = "\x1b[1m";
-const RESET = "\x1b[0m";
-const GRAY = "\x1b[38;5;245m";
+const AMBER = '\x1b[38;5;214m';
+const GREEN = '\x1b[38;5;82m';
+const RED = '\x1b[38;5;196m';
+const YELLOW = '\x1b[33m';
+const DIM = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const RESET = '\x1b[0m';
+const GRAY = '\x1b[38;5;245m';
 
 // ── URL 파싱 ──
 function parseNotionUrl(input) {
@@ -165,24 +167,24 @@ ${mcpServer} MCP 서버의 도구를 사용하라.
 }
 
 // ── CLI 실행 (임시 파일 + execSync — Windows .cmd 호환) ──
-function runWithCli(cliType, prompt, timeout) {
-  const cliName = cliType === "claude" ? "claude" : cliType === "codex" ? "codex" : "gemini";
+function runWithCli(cliType, prompt, timeout, runMode = 'fg') {
+  const cliName = cliType === 'claude' ? 'claude' : cliType === 'codex' ? 'codex' : 'gemini';
   if (!cliExists(cliName)) {
-    return { success: false, output: "", error: `${cliType} CLI 미설치`, cli: cliType };
+    return { success: false, output: '', error: `${cliType} CLI 미설치`, cli: cliType };
   }
 
   // 프롬프트를 임시 파일에 저장 (shell escaping 회피)
   const promptFile = join(tmpdir(), `notion-prompt-${Date.now()}.md`);
-  writeFileSync(promptFile, prompt, "utf8");
-  const promptPath = promptFile.replace(/\\/g, "/");
+  writeFileSync(promptFile, prompt, 'utf8');
+  const promptPath = promptFile.replace(/\\/g, '/');
 
   // CLI에 전달할 짧은 메타 프롬프트
   const metaPrompt = `Read the file at ${promptPath} and execute all instructions in it exactly as described. Output only the final markdown result.`;
 
   let cmd;
-  if (cliType === "codex") {
+  if (cliType === 'codex') {
     cmd = `codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check "${metaPrompt}"`;
-  } else if (cliType === "gemini") {
+  } else if (cliType === 'gemini') {
     cmd = `gemini -m gemini-3-flash-preview -y --allowed-mcp-server-names notion,notion-guest --prompt "${metaPrompt}"`;
   } else {
     // Claude CLI — print 모드 (MCP 도구 자동 접근)
@@ -192,16 +194,16 @@ function runWithCli(cliType, prompt, timeout) {
   console.error(`${AMBER}▸${RESET} ${cliType}로 실행 중... (timeout: ${timeout}s)`);
   const startTime = Date.now();
 
-  let stdout = "";
-  let stderr = "";
+  let stdout = '';
+  let stderr = '';
   let exitCode = 0;
 
   try {
     stdout = execSync(cmd, {
-      encoding: "utf8",
+      encoding: 'utf8',
       timeout: (timeout + 30) * 1000,
       maxBuffer: 10 * 1024 * 1024,
-      stdio: ["pipe", "pipe", "pipe"],
+      stdio: ['pipe', 'pipe', 'pipe'],
       cwd: process.cwd(),
     });
   } catch (e) {
@@ -216,7 +218,7 @@ function runWithCli(cliType, prompt, timeout) {
   try { unlinkSync(promptFile); } catch {}
 
   // 실행 로그 기록
-  logExecution(cliType, exitCode, elapsed, timeout, stderr);
+  logExecution(cliType, exitCode, elapsed, timeout, stderr, runMode);
 
   if (exitCode === 0 && stdout) {
     return { success: true, output: stdout, cli: cliType, elapsed };
@@ -262,31 +264,31 @@ function cleanCodexOutput(raw) {
   return texts.join("\n");
 }
 
-// ── 실행 로그 (cli-route.sh 호환) ──
-function logExecution(cliType, exitCode, elapsed, timeout, stderr) {
+// ── 실행 로그 (tfx-route.sh 호환) ──
+function logExecution(cliType, exitCode, elapsed, timeout, stderr, runMode = 'fg') {
   try {
     const logDir = dirname(LOG_FILE);
     if (!existsSync(logDir)) mkdirSync(logDir, { recursive: true });
 
     const ts = new Date().toISOString();
-    const status = exitCode === 0 ? "success" : exitCode === 124 ? "timeout" : "failed";
+    const status = exitCode === 0 ? 'success' : exitCode === 124 ? 'timeout' : 'failed';
     const entry = JSON.stringify({
       ts,
-      agent: "notion-read",
+      agent: 'notion-read',
       cli: cliType,
-      effort: cliType === "codex" ? "high" : cliType === "claude" ? "sonnet" : "flash",
-      run_mode: "fg",
-      opus_oversight: "false",
+      effort: cliType === 'codex' ? 'high' : cliType === 'claude' ? 'sonnet' : 'flash',
+      run_mode: runMode,
+      opus_oversight: 'false',
       status,
       exit_code: exitCode,
       elapsed_sec: elapsed,
       timeout_sec: timeout,
-      mcp_profile: "notion",
+      mcp_profile: runMode === 'delegate' ? 'notion-guest' : 'notion',
       input_tokens: 0,
       output_tokens: 0,
       total_tokens: 0,
     });
-    appendFileSync(LOG_FILE, entry + "\n");
+    appendFileSync(LOG_FILE, entry + '\n');
   } catch {}
 }
 
@@ -309,6 +311,7 @@ function main() {
     --depth, -d <n>           중첩 블록 최대 깊이 (기본: 3)
     --comments                블록/페이지 댓글 포함
     --guest                   notion-guest 통합 사용
+    --delegate                Claude 이관 모드 (notion-guest 우선, 파일 저장)
 
   ${BOLD}폴백 체인${RESET}
     Codex(무료) → Gemini(무료) → Claude(최후) → 에러
@@ -318,6 +321,8 @@ function main() {
     tfx notion-read abc123def456... --output page.md --comments
     tfx notion-read abc123def456... --cli gemini --timeout 900
     tfx notion-read abc123def456... --guest --comments
+    tfx notion-read abc123def456... --delegate
+    tfx notion-read abc123def456... --delegate --output .notion-cache/page.md
 `);
     return;
   }
@@ -330,6 +335,7 @@ function main() {
   let depth = 3;
   let useGuest = false;
   let includeComments = false;
+  let delegateMode = false;
 
   for (let i = 1; i < args.length; i++) {
     switch (args[i]) {
@@ -355,6 +361,9 @@ function main() {
       case "--comments":
         includeComments = true;
         break;
+      case '--delegate':
+        delegateMode = true;
+        break;
     }
   }
 
@@ -368,7 +377,62 @@ function main() {
   console.error(
     `${AMBER}▸${RESET} 페이지: ${parsed.pageId}${parsed.blockId ? ` (블록: ${parsed.blockId})` : ""}`,
   );
-  console.error(`${GRAY}  통합: ${useGuest ? "notion-guest" : "notion"} | 깊이: ${depth} | 댓글: ${includeComments ? "O" : "X"} | 타임아웃: ${timeout}s${RESET}`);
+  console.error(`${GRAY}  통합: ${delegateMode ? 'notion-guest(우선)' : useGuest ? 'notion-guest' : 'notion'} | 깊이: ${depth} | 댓글: ${includeComments ? 'O' : 'X'} | 타임아웃: ${timeout}s${RESET}`);
+
+  // 프롬프트 생성
+  const prompt = buildPrompt(parsed.pageId, parsed.blockId, depth, useGuest, includeComments);
+  // Claude 폴백용: notion/notion-guest 양쪽 시도 프롬프트
+  const claudePrompt = buildPrompt(parsed.pageId, parsed.blockId, depth, false, includeComments)
+    .replace(
+      'notion MCP 서버의 도구를 사용하라.',
+      '가능하면 notion-guest MCP 서버를 먼저 사용하라. 실패하면 notion MCP 서버를 사용하라.',
+    );
+
+  // delegate 모드: Claude 단독 + notion-guest 우선 + 파일 저장
+  if (delegateMode) {
+    console.error(`${AMBER}▸${RESET} delegate 모드 활성화: Claude로 notion-guest 우선 접근`);
+
+    const delegatePrompt = `${claudePrompt}
+
+### delegate 모드 추가 지시
+- notion-guest MCP 서버를 최우선으로 먼저 시도하라.
+- notion-guest가 실패하거나 미구성일 때만 notion 서버로 폴백하라.
+- 도구 호출 결과를 바탕으로 최종 마크다운만 출력하라.`;
+
+    const delegateResult = runWithCli('claude', delegatePrompt, timeout, 'delegate');
+    if (!delegateResult.success) {
+      console.error(`${RED}✗${RESET} delegate 모드 실패: ${delegateResult.error}`);
+      if (delegateResult.stderr) {
+        console.error(`${GRAY}  stderr: ${delegateResult.stderr.slice(0, 250)}${RESET}`);
+      }
+      console.error(`${GRAY}  대안: --delegate 없이 실행해 기존 폴백 체인을 사용하세요.${RESET}`);
+      console.error(`${GRAY}  예: tfx notion-read ${parsed.pageId} --comments${RESET}`);
+      process.exit(1);
+    }
+
+    const delegateOutput = delegateResult.output.trim();
+    const isDelegateFailureOutput =
+      (delegateOutput.includes('조회 실패') || delegateOutput.includes('읽기 실패') || delegateOutput.includes('not_found')) &&
+      delegateOutput.length < 500;
+
+    if (delegateOutput.length <= 100 || isDelegateFailureOutput) {
+      console.error(`${RED}✗${RESET} delegate 모드 실패: Claude 결과가 비정상적입니다.`);
+      console.error(`${GRAY}  대안: --delegate 없이 실행해 Codex/Gemini/Claude 폴백 체인을 사용하세요.${RESET}`);
+      process.exit(1);
+    }
+
+    const delegateTarget = outputFile || join('.notion-cache', `${parsed.pageId}.md`);
+    const delegateDir = dirname(delegateTarget);
+    if (delegateDir && delegateDir !== '.' && !existsSync(delegateDir)) {
+      mkdirSync(delegateDir, { recursive: true });
+    }
+    writeFileSync(delegateTarget, delegateOutput, 'utf8');
+
+    const savedPath = resolve(delegateTarget);
+    console.error(`${GREEN}✓${RESET} delegate 결과 저장: ${savedPath}`);
+    console.error(`${GRAY}  후속 작업 참조 경로: ${savedPath}${RESET}`);
+    return;
+  }
 
   // MCP 가용성 확인
   const mcpAvail = getNotionMcpClis(useGuest);
@@ -400,15 +464,6 @@ function main() {
     cliOrder.push("claude");
   }
 
-  // 프롬프트 생성
-  const prompt = buildPrompt(parsed.pageId, parsed.blockId, depth, useGuest, includeComments);
-  // Claude 폴백용: notion/notion-guest 양쪽 시도 프롬프트
-  const claudePrompt = buildPrompt(parsed.pageId, parsed.blockId, depth, false, includeComments)
-    .replace(
-      "404 에러가 나면 notion-guest 서버로 재시도하라.",
-      "404 에러가 나면 반드시 notion-guest 서버로 재시도하라. notion, notion-guest, claude_ai_Notion 등 사용 가능한 모든 Notion MCP 서버를 시도하라.",
-    );
-
   // 실행 + 폴백
   let lastResult = null;
   let notionAccessFailed = false;

package/scripts/setup.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // triflux 세션 시작 시 자동 설정 스크립트
-// - cli-route.sh를 ~/.claude/scripts/에 동기화
+// - tfx-route.sh를 ~/.claude/scripts/에 동기화
 // - hud-qos-status.mjs를 ~/.claude/hud/에 동기화
 // - skills/를 ~/.claude/skills/에 동기화
 
@@ -15,9 +15,14 @@ const CLAUDE_DIR = join(homedir(), ".claude");
 
 const SYNC_MAP = [
   {
-    src: join(PLUGIN_ROOT, "scripts", "cli-route.sh"),
-    dst: join(CLAUDE_DIR, "scripts", "cli-route.sh"),
-    label: "cli-route.sh",
+    src: join(PLUGIN_ROOT, "scripts", "tfx-route.sh"),
+    dst: join(CLAUDE_DIR, "scripts", "tfx-route.sh"),
+    label: "tfx-route.sh",
+  },
+  {
+    src: join(PLUGIN_ROOT, "scripts", "tfx-route-post.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "tfx-route-post.mjs"),
+    label: "tfx-route-post.mjs",
   },
   {
     src: join(PLUGIN_ROOT, "hud", "hud-qos-status.mjs"),
@@ -212,7 +217,7 @@ ${B}╔════════════════════════
 ${B}║${R}  ${C}triflux${R} ${D}v${ver}${R} ${B}— Setup Complete${R}             ${B}║${R}
 ${B}╚═══════════════════════════════════════════════╝${R}
 
-  ${G}✓${R} cli-route.sh     → ~/.claude/scripts/
+  ${G}✓${R} tfx-route.sh     → ~/.claude/scripts/
   ${G}✓${R} hud-qos-status   → ~/.claude/hud/
   ${G}✓${R} ${synced > 0 ? synced + " files synced" : "all files up to date"}
   ${G}✓${R} HUD statusLine   → settings.json

package/scripts/tfx-batch-stats.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// tfx-batch-stats.mjs v1.0 — batch-events.jsonl 소비자
+//
+// tfx-route-post.mjs가 기록한 AIMD 이벤트를 읽어서:
+//   1. 에이전트별 성공/실패/타임아웃 통계 집계
+//   2. AIMD(Additive Increase / Multiplicative Decrease) batch_size 계산
+//
+// 사용법:
+//   node tfx-batch-stats.mjs stats [--recent]     에이전트별 통계 (--recent: 30분)
+//   node tfx-batch-stats.mjs batch                 현재 권장 batch_size
+//   node tfx-batch-stats.mjs agent <name>          특정 에이전트 통계
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+const CACHE_DIR = join(homedir(), ".claude", "cache");
+const EVENTS_FILE = join(CACHE_DIR, "batch-events.jsonl");
+
+// AIMD 파라미터
+const AIMD_INITIAL = 3;
+const AIMD_MIN = 1;
+const AIMD_MAX = 10;
+const AIMD_INC = 1;        // 성공 시 +1
+const AIMD_DEC = 0.5;      // 실패 시 ×0.5
+const WINDOW_MS = 30 * 60 * 1000; // 30분 윈도우
+
+// ── 이벤트 읽기 ──
+export function readBatchEvents(opts = {}) {
+  const { sinceMs = 0, agent = null } = opts;
+  try {
+    const lines = readFileSync(EVENTS_FILE, "utf-8").trim().split("\n").filter(Boolean);
+    return lines
+      .map((l) => { try { return JSON.parse(l); } catch { return null; } })
+      .filter((e) => e && (!sinceMs || e.ts >= sinceMs) && (!agent || e.agent === agent));
+  } catch {
+    return [];
+  }
+}
+
+// ── 에이전트별 통계 ──
+export function getAgentStats(opts = {}) {
+  const events = readBatchEvents(opts);
+  const stats = {};
+
+  for (const ev of events) {
+    if (!stats[ev.agent]) stats[ev.agent] = { success: 0, fail: 0, timeout: 0, total: 0 };
+    const s = stats[ev.agent];
+    if (ev.result === "success" || ev.result === "success_with_warnings") s.success++;
+    else if (ev.result === "timeout") s.timeout++;
+    else s.fail++;
+    s.total++;
+  }
+
+  for (const s of Object.values(stats)) {
+    s.successRate = s.total > 0 ? +(s.success / s.total).toFixed(2) : 0;
+  }
+
+  return { total: events.length, agents: stats };
+}
+
+// ── AIMD batch_size 계산 ──
+// 최근 윈도우 이벤트를 순회하며 성공 시 +1, 실패 시 ×0.5
+export function getAimdBatchSize() {
+  const since = Date.now() - WINDOW_MS;
+  const events = readBatchEvents({ sinceMs: since });
+  if (events.length === 0) return AIMD_INITIAL;
+
+  let batch = AIMD_INITIAL;
+  for (const ev of events) {
+    if (ev.result === "success" || ev.result === "success_with_warnings") {
+      batch = Math.min(AIMD_MAX, batch + AIMD_INC);
+    } else {
+      batch = Math.max(AIMD_MIN, Math.floor(batch * AIMD_DEC));
+    }
+  }
+  return batch;
+}
+
+// ── CLI 진입점 ──
+const scriptName = process.argv[1] || "";
+if (scriptName.endsWith("tfx-batch-stats.mjs")) {
+  const cmd = process.argv[2] || "stats";
+  const recent = process.argv.includes("--recent");
+  const sinceMs = recent ? Date.now() - WINDOW_MS : 0;
+
+  if (cmd === "batch") {
+    console.log(JSON.stringify({ batchSize: getAimdBatchSize(), window: "30m" }));
+  } else if (cmd === "agent") {
+    const name = process.argv[3];
+    if (!name) { console.error("에이전트명 필수: node tfx-batch-stats.mjs agent executor"); process.exit(1); }
+    console.log(JSON.stringify(getAgentStats({ sinceMs, agent: name }), null, 2));
+  } else {
+    console.log(JSON.stringify(getAgentStats({ sinceMs }), null, 2));
+  }
+}