triflux 10.0.6 → 10.1.0

package/CLAUDE.md

@@ -1,3 +1,4 @@
+<!-- prompt-hygiene:ignore line_count_warning -->
 # triflux — Claude Code 운영 가이드
 
 <core-systems>
@@ -81,6 +82,12 @@ tfx-deep-review, tfx-deep-qa, tfx-deep-plan, tfx-deep-research, tfx-consensus, t
 - "auto" 단독 → tfx-auto. "알아서 해" → tfx-autopilot
 - "코드에서 찾아" → tfx-find. "알아봐" → tfx-research
 - 복합 의도: "구현하고 리뷰까지" → tfx-auto → cross-review hook
+
+### Q-Learning 동적 라우팅 (실험적)
+
+- `TRIFLUX_DYNAMIC_ROUTING=true` 설정 시 Q-Learning 기반 동적 스킬 라우팅 활성화
+- `routing-weights.json` + Q-table로 스킬 선택 최적화
+- 기본 비활성
 </routing>
 
 <session-context>
@@ -161,6 +168,21 @@ codex를 SSH 너머로 직접 실행하지 않는다. config.toml 충돌 + TTY
 - `~` → `$HOME` 변환 필수, 원격 기본 셸 = PowerShell
 </remote>
 
+<headless-retrieval>
+## Headless 결과 회수
+
+background로 실행한 headless 결과는 **반드시 task-notification 완료 후** 읽는다.
+
+| 패턴 | 올바름 | 이유 |
+|------|--------|------|
+| task-notification 후 output 파일 읽기 | YES | 프로세스 종료 = 워커 전부 완료 |
+| task-notification 전 output 파일 tail | NO | 시작 메시지만 보이고 "실패"로 오진 |
+| psmux capture-pane으로 중간 체크 | NO | 워커 진행 중이면 빈 화면일 수 있음 |
+
+완료 마커: `=== HEADLESS_COMPLETE succeeded=N failed=N total=N ===`
+워커 상세: `$TMPDIR/tfx-headless/{sessionName}-worker-N.txt`
+</headless-retrieval>
+
 <cross-review>
 ## 교차 검증
 

package/bin/triflux.mjs

@@ -27,7 +27,7 @@ import {
 import {
   SYNC_MAP, SKILL_ALIASES, REQUIRED_CODEX_PROFILES, LEGACY_CODEX_MODELS,
   syncAliasedSkillDir, hasProfileSection, replaceProfileSection,
-  ensureCodexProfiles, getVersion, cleanupStaleSkills, DEPRECATED_SKILLS,
+  ensureCodexProfiles, getVersion, cleanupStaleSkills, 
   extractManagedHookFilename, getManagedRegistryHooks, ensureHooksInSettings,
   ensureCodexHubServerConfig,
 } from "../scripts/setup.mjs";
@@ -65,14 +65,14 @@ const GREEN_BRIGHT = "\x1b[38;5;82m";
 const RED_BRIGHT = "\x1b[38;5;196m";
 
 // ── 브랜드 요소 ──
-const BRAND = `${AMBER}${BOLD}triflux${RESET}`;
+const _BRAND = `${AMBER}${BOLD}triflux${RESET}`;
 const VER = `${DIM}v${PKG.version}${RESET}`;
 const LINE = `${GRAY}${"─".repeat(48)}${RESET}`;
-const DOT = `${GRAY}·${RESET}`;
+const _DOT = `${GRAY}·${RESET}`;
 const STALE_TEAM_MAX_AGE_SEC = 3600;
 const ANSI_PATTERN = /\x1B\[[0-?]*[ -/]*[@-~]/g;
 
-const EXIT_SUCCESS = 0;
+const _EXIT_SUCCESS = 0;
 const EXIT_ERROR = 1;
 const EXIT_ARG_ERROR = 2;
 const EXIT_CLI_MISSING = 3;
@@ -719,12 +719,11 @@ function previewMcpRegistrationActions(mcpUrl) {
 function previewClaudeRoutingAction() {
   const globalClaudePath = join(CLAUDE_DIR, "CLAUDE.md");
   const projectClaudePath = join(PKG_ROOT, "CLAUDE.md");
-  const projectContent = existsSync(projectClaudePath)
-    ? readFileSync(projectClaudePath, "utf8")
-    : "";
-  const projectSection = extractMarkdownSection(projectContent, TFX_SECTION_HEADING);
 
-  if (!projectSection) {
+  let _routingTable;
+  try {
+    _routingTable = getLatestRoutingTable();
+  } catch {
     return {
       type: "claude-guidance",
       path: globalClaudePath,
@@ -734,18 +733,23 @@ function previewClaudeRoutingAction() {
     };
   }
 
-  const globalContent = existsSync(globalClaudePath)
-    ? readFileSync(globalClaudePath, "utf8")
-    : "";
-  const preview = ensureTfxSection(globalContent, { scope: "global", projectSection });
+  if (!existsSync(globalClaudePath)) {
+    return {
+      type: "claude-guidance",
+      path: globalClaudePath,
+      source: projectClaudePath,
+      change: "create",
+    };
+  }
+
+  const globalContent = readFileSync(globalClaudePath, "utf8");
+  const hasRouting = globalContent.includes("<routing>") || globalContent.includes("## triflux CLI 라우팅");
 
   return {
     type: "claude-guidance",
     path: globalClaudePath,
     source: projectClaudePath,
-    change: preview.changed ? (existsSync(globalClaudePath) ? "update" : "create") : "noop",
-    heading: TFX_SECTION_HEADING,
-    summary: TFX_GLOBAL_SUMMARY_SECTION,
+    change: hasRouting ? "noop" : "create",
   };
 }
 
@@ -2073,7 +2077,7 @@ async function cmdDoctor(options = {}) {
   // 14. Stale Teams (Claude teams/ + tasks/ 자동 감지)
   section("Stale Teams");
   const teamsDir = join(CLAUDE_DIR, "teams");
-  const tasksDir = join(CLAUDE_DIR, "tasks");
+  const _tasksDir = join(CLAUDE_DIR, "tasks");
   if (existsSync(teamsDir)) {
     try {
       const teamDirs = readdirSync(teamsDir).filter(d => {
@@ -2130,8 +2134,8 @@ async function cmdDoctor(options = {}) {
             // 프로세스 명령줄에서 세션 ID 매칭 (tmux 없는 in-process 팀 지원)
             if (!hasActiveMember && teamConfig.leadSessionId) {
               try {
-                const sessionToken = teamConfig.leadSessionId.toLowerCase();
-                const safeToken = teamConfig.leadSessionId.slice(0, 8).replace(/[^a-zA-Z0-9\-]/g, '');
+                const _sessionToken = teamConfig.leadSessionId.toLowerCase();
+                const safeToken = teamConfig.leadSessionId.slice(0, 8).replace(/[^a-zA-Z0-9-]/g, '');
                 // Claude Code 프로세스에서 세션 ID 검색
                 if (process.platform === "win32") {
                   const psOut = execSync(
@@ -3723,7 +3727,7 @@ async function cmdHub(args = [], options = {}) {
         process.kill(info.pid, "SIGTERM");
         try { unlinkSync(HUB_PID_FILE); } catch {}
         console.log(`\n  ${GREEN_BRIGHT}✓${RESET} hub 종료됨 (PID ${info.pid})\n`);
-      } catch (e) {
+      } catch (_e) {
         try { unlinkSync(HUB_PID_FILE); } catch {}
         console.log(`\n  ${DIM}hub 프로세스 없음 — PID 파일 정리됨${RESET}\n`);
       }
@@ -3884,6 +3888,12 @@ async function main() {
     case "hub":
       await cmdHub(cmdArgs, { json: JSON_OUTPUT && (cmdArgs[0] || "status") === "status" });
       return;
+    case "monitor": {
+      const { createMonitor } = await import("../tui/monitor.mjs");
+      const mon = createMonitor();
+      await mon.start();
+      break;
+    }
     case "tray": {
       const trayUrl = new URL("../hub/tray.mjs", import.meta.url);
       const trayPath = fileURLToPath(trayUrl);

package/hooks/error-context.mjs

@@ -4,7 +4,8 @@
 // 도구 실패 시 에러 패턴을 분석하여 해결 힌트를 additionalContext로 주입한다.
 // Claude가 동일 에러를 반복하지 않도록 구체적 가이드를 제공.
 
-import { readFileSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
 
 // ── 에러 패턴 → 해결 힌트 매핑 ─────────────────────────────
 const ERROR_HINTS = [
@@ -128,16 +129,43 @@ function main() {
     JSON.stringify(input.tool_result || ""),
   ].join("\n");
 
+  // ── reflexion 적응형 학습: safety-guard/headless-guard 차단을 패널티로 기록 ──
+  const isSafetyBlock = /\[(?:safety-guard|headless-guard)\].*(?:BLOCKED|차단)/i.test(errorText);
+  if (isSafetyBlock) {
+    try {
+      const home = process.env.HOME || process.env.USERPROFILE || "";
+      const penaltyDir = join(home, ".triflux", "reflexion");
+      mkdirSync(penaltyDir, { recursive: true });
+      const penaltyFile = join(penaltyDir, "pending-penalties.jsonl");
+      const command = input.tool_input?.command || "";
+      const entry = {
+        ts: new Date().toISOString(),
+        type: "guard_block",
+        tool: input.tool_name || "Bash",
+        error_pattern: errorText.match(/\[.*?\]\s*(.{0,120})/)?.[1] || errorText.slice(0, 120),
+        command_preview: command.slice(0, 200),
+        source: errorText.includes("safety-guard") ? "safety-guard" : "headless-guard",
+      };
+      writeFileSync(penaltyFile, JSON.stringify(entry) + "\n", { flag: "a" });
+    } catch { /* reflexion 기록 실패는 무시 — 힌트 출력에 영향 주지 않음 */ }
+  }
+
   const hints = findHints(errorText);
-  if (hints.length === 0) process.exit(0);
+  // safety-guard 차단에는 guard가 이미 구체적 안내를 제공하므로 추가 힌트 불필요
+  if (hints.length === 0 && !isSafetyBlock) process.exit(0);
 
   const toolName = input.tool_name || "Unknown";
-  const output = {
-    systemMessage:
-      `[error-context] ${toolName} 실패 — 해결 힌트:\n` +
-      hints.map((h) => `  → ${h}`).join("\n"),
-  };
+  const parts = [];
+  if (hints.length > 0) {
+    parts.push(`[error-context] ${toolName} 실패 — 해결 힌트:\n` + hints.map((h) => `  → ${h}`).join("\n"));
+  }
+  if (isSafetyBlock) {
+    parts.push("[reflexion] 이 패턴이 적응형 학습에 기록되었습니다. 다음 세션에서 동일 패턴 시 사전 차단됩니다.");
+  }
+
+  if (parts.length === 0) process.exit(0);
 
+  const output = { systemMessage: parts.join("\n") };
   process.stdout.write(JSON.stringify(output));
 }
 

package/hooks/hook-orchestrator.mjs

@@ -340,6 +340,20 @@ async function main() {
     }
   }
 
+  // ── PostToolUse:Skill 완료 시 라우팅 가중치 기록 ──
+  if (eventName === "PostToolUse" && toolName === "Skill" && !blocked) {
+    try {
+      const input = JSON.parse(stdinRaw);
+      const skillName = input.tool_input?.skill || "";
+      if (skillName && skillName.startsWith("tfx-")) {
+        const mode = skillName.replace(/^tfx-/, "");
+        const gitRoot = process.env.GIT_WORK_TREE || process.cwd();
+        const slug = gitRoot.split(/[\\/]/).pop() || "unknown";
+        recordRouteOutcome(slug, mode, "completion");
+      }
+    } catch { /* 가중치 기록 실패 무시 */ }
+  }
+
   // 결과 출력
   if (blocked) {
     process.exit(2);