triflux 9.8.3 → 9.8.5

package/bin/triflux.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // triflux CLI — setup, doctor, version
 import { copyFileSync, existsSync, readFileSync, readSync, writeFileSync, mkdirSync, chmodSync, readdirSync, unlinkSync, statSync, openSync, closeSync } from "fs";
-import { join, dirname, basename } from "path";
+import { join, dirname, basename, resolve } from "path";
 import { homedir, tmpdir } from "os";
 import { execSync, execFileSync, spawn } from "child_process";
 import { fileURLToPath } from "url";
@@ -11,6 +11,7 @@ import { detectMultiplexer, getSessionAttachedCount, killSession, listSessions,
 import { forceCleanupTeam } from "../hub/team/nativeProxy.mjs";
 import { cleanupStaleOmcTeams, inspectStaleOmcTeams } from "../hub/team/staleState.mjs";
 import { getPipelineStateDbPath } from "../hub/pipeline/state.mjs";
+import { serializeHandoff } from "../scripts/lib/handoff.mjs";
 import { ensureGeminiProfiles } from "../scripts/lib/gemini-profiles.mjs";
 import { probePsmuxSupport, formatPsmuxInstallGuidance, formatPsmuxUpdateGuidance } from "../scripts/lib/psmux-info.mjs";
 import {
@@ -98,6 +99,17 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
       { name: "--json", type: "boolean", description: "버전 정보를 JSON으로 출력" },
     ],
   },
+  handoff: {
+    usage: "tfx handoff [--target local|remote] [--decision <text>] [--decision-file <path>] [--output <path>] [--json]",
+    description: "현재 작업 컨텍스트를 세션 핸드오프 프롬프트로 직렬화",
+    options: [
+      { name: "--target", type: "string", description: "주입 대상 (local|remote, 기본값 remote)" },
+      { name: "--decision", type: "string", description: "핸드오프 결정사항 (반복 지정 가능)" },
+      { name: "--decision-file", type: "string", description: "결정사항 파일 (라인/불릿 단위)" },
+      { name: "--output", type: "string", description: "생성한 핸드오프 프롬프트 저장 경로" },
+      { name: "--json", type: "boolean", description: "핸드오프 결과를 JSON으로 출력" },
+    ],
+  },
   list: {
     usage: "tfx list [--json]",
     description: "패키지 스킬과 사용자 스킬 목록 표시",
@@ -2783,6 +2795,128 @@ function cmdVersion(options = {}) {
   console.log("");
 }
 
+function cmdHandoff(args = [], options = {}) {
+  const { json = false } = options;
+  const parsed = {
+    target: "remote",
+    decisions: [],
+    decisionFile: null,
+    output: null,
+    cwd: process.cwd(),
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    const next = args[index + 1];
+
+    if (arg === "--target") {
+      if (!next || next.startsWith("-")) {
+        throw createCliError("--target 값이 필요합니다 (local|remote)", {
+          exitCode: EXIT_ARG_ERROR,
+          reason: "argError",
+          fix: "tfx handoff --target remote",
+        });
+      }
+      if (!["local", "remote"].includes(next)) {
+        throw createCliError(`지원하지 않는 --target 값: ${next}`, {
+          exitCode: EXIT_ARG_ERROR,
+          reason: "argError",
+          fix: "tfx handoff --target local|remote",
+        });
+      }
+      parsed.target = next;
+      index += 1;
+      continue;
+    }
+
+    if (arg === "--decision") {
+      if (!next || next.startsWith("-")) {
+        throw createCliError("--decision 값이 필요합니다", {
+          exitCode: EXIT_ARG_ERROR,
+          reason: "argError",
+          fix: "tfx handoff --decision \"결정사항\"",
+        });
+      }
+      parsed.decisions.push(next);
+      index += 1;
+      continue;
+    }
+
+    if (arg === "--decision-file") {
+      if (!next || next.startsWith("-")) {
+        throw createCliError("--decision-file 경로가 필요합니다", {
+          exitCode: EXIT_ARG_ERROR,
+          reason: "argError",
+          fix: "tfx handoff --decision-file .omx/notepad.md",
+        });
+      }
+      parsed.decisionFile = resolve(next);
+      index += 1;
+      continue;
+    }
+
+    if (arg === "--output" || arg === "--out") {
+      if (!next || next.startsWith("-")) {
+        throw createCliError(`${arg} 경로가 필요합니다`, {
+          exitCode: EXIT_ARG_ERROR,
+          reason: "argError",
+          fix: "tfx handoff --output .omx/handoff.md",
+        });
+      }
+      parsed.output = resolve(next);
+      index += 1;
+      continue;
+    }
+
+    if (arg === "--cwd") {
+      if (!next || next.startsWith("-")) {
+        throw createCliError("--cwd 경로가 필요합니다", {
+          exitCode: EXIT_ARG_ERROR,
+          reason: "argError",
+          fix: "tfx handoff --cwd <project-path>",
+        });
+      }
+      parsed.cwd = resolve(next);
+      index += 1;
+      continue;
+    }
+
+    throw createCliError(`알 수 없는 handoff 옵션: ${arg}`, {
+      exitCode: EXIT_ARG_ERROR,
+      reason: "argError",
+      fix: "tfx handoff --target remote --output .omx/handoff.md",
+    });
+  }
+
+  const result = serializeHandoff({
+    target: parsed.target,
+    decisions: parsed.decisions,
+    decisionFile: parsed.decisionFile,
+    cwd: parsed.cwd,
+  });
+
+  if (parsed.output) {
+    const outputDir = dirname(parsed.output);
+    if (!existsSync(outputDir)) mkdirSync(outputDir, { recursive: true });
+    writeFileSync(parsed.output, `${result.prompt}\n`, "utf8");
+  }
+
+  if (json) {
+    printJson({
+      handoff: {
+        ...result,
+        ...(parsed.output ? { output: parsed.output } : {}),
+      },
+    });
+    return;
+  }
+
+  console.log(result.prompt);
+  if (parsed.output) {
+    console.log(`\n${DIM}saved:${RESET} ${parsed.output}`);
+  }
+}
+
 function cmdSchema(args = []) {
   const bundle = loadDelegatorSchemaBundle();
   const selector = String(args[0] || "").trim();
@@ -3054,6 +3188,7 @@ ${updateNotice}
     ${WHITE_BRIGHT}tfx update${RESET}     ${GRAY}최신 안정 버전으로 업데이트${RESET}
     ${DIM}  --dev / dev${RESET}   ${GRAY}dev 태그로 업데이트${RESET}
     ${WHITE_BRIGHT}tfx list${RESET}       ${GRAY}설치된 스킬 목록${RESET}
+    ${WHITE_BRIGHT}tfx handoff${RESET}    ${GRAY}현재 컨텍스트를 원격/로컬 핸드오프 프롬프트로 생성${RESET}
     ${WHITE_BRIGHT}tfx schema${RESET}     ${GRAY}CLI/Hub schema JSON 출력${RESET}
     ${WHITE_BRIGHT}tfx hub${RESET}        ${GRAY}MCP 메시지 버스 관리 (start/stop/status)${RESET}
     ${WHITE_BRIGHT}tfx tray${RESET}       ${GRAY}Windows 시스템 트레이 실행${RESET}
@@ -3559,6 +3694,9 @@ async function main() {
     case "ls":
       cmdList({ json: JSON_OUTPUT });
       return;
+    case "handoff":
+      cmdHandoff(cmdArgs, { json: JSON_OUTPUT });
+      return;
     case "hub":
       await cmdHub(cmdArgs, { json: JSON_OUTPUT && (cmdArgs[0] || "status") === "status" });
       return;

package/hooks/hook-adaptive-collector.mjs

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { createAdaptiveEngine } from '../hub/adaptive.mjs';
+
+let engine = null;
+let createEngine = createAdaptiveEngine;
+
+function readStdin() {
+  try {
+    return readFileSync(0, 'utf8');
+  } catch {
+    return '';
+  }
+}
+
+function inferProjectSlug(cwd = process.cwd()) {
+  const packagePath = join(cwd, 'package.json');
+  if (existsSync(packagePath)) {
+    try {
+      const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
+      if (typeof pkg.name === 'string' && pkg.name.trim()) return pkg.name.trim();
+    } catch {}
+  }
+  return basename(cwd) || 'default';
+}
+
+function getEngine() {
+  if (engine) return engine;
+  engine = createEngine({
+    projectSlug: inferProjectSlug(),
+    repoRoot: process.cwd(),
+  });
+  engine.startSession?.();
+  return engine;
+}
+
+function buildErrorContext(event = {}) {
+  return {
+    exitCode: event.exitCode,
+    stderr: String(event.stderr || '').slice(0, 500),
+    tool: event.tool,
+    command: String(event.command || '').slice(0, 200),
+    timestamp: new Date().toISOString(),
+  };
+}
+
+export default function hookAdaptiveCollector(event = {}) {
+  if (Number(event.exitCode) === 0) return null;
+  if (!event.tool || event.tool === 'Read') return null;
+
+  const result = getEngine().handleError(buildErrorContext(event));
+  if (result?.diagnosed) {
+    console.error(`[adaptive] 에러 패턴 감지: ${result.rule?.id || 'unknown'}`);
+    if (result.promoted) {
+      console.error(`[adaptive] 규칙 승격 → Tier ${result.rule?.tier ?? '?'}`);
+    }
+  }
+  return result;
+}
+
+export function __setAdaptiveCollectorFactoryForTests(factory) {
+  createEngine = factory;
+  engine = null;
+}
+
+export function __resetAdaptiveCollectorForTests() {
+  createEngine = createAdaptiveEngine;
+  engine = null;
+}
+
+function main() {
+  const raw = readStdin();
+  if (!raw.trim()) return;
+  try {
+    hookAdaptiveCollector(JSON.parse(raw));
+  } catch {}
+}
+
+const isEntrypoint = process.argv[1] && pathToFileURL(process.argv[1]).href === import.meta.url;
+if (isEntrypoint) {
+  main();
+}

package/hooks/hook-registry.json

@@ -153,9 +153,9 @@
         "id": "ext-session-vault-start",
         "source": "session-vault",
         "matcher": "*",
-        "command": "${HOME}/Desktop/Projects/cli/session-vault/scripts/start_hook.sh",
+        "command": "bash \"${HOME}/Desktop/Projects/tools/session-vault/scripts/start_hook.sh\"",
         "priority": 100,
-        "enabled": false,
+        "enabled": true,
         "timeout": 10,
         "blocking": false,
         "description": "세션 볼트 로깅 시작"
@@ -177,9 +177,9 @@
         "id": "ext-session-vault-export",
         "source": "session-vault",
         "matcher": "*",
-        "command": "${HOME}/Desktop/Projects/cli/session-vault/scripts/export_hook.sh",
+        "command": "bash \"${HOME}/Desktop/Projects/tools/session-vault/scripts/export_hook.sh\"",
         "priority": 100,
-        "enabled": false,
+        "enabled": true,
         "timeout": 30,
         "blocking": false,
         "description": "세션 트랜스크립트 내보내기"

package/hooks/keyword-rules.json

@@ -37,6 +37,46 @@
       "state": null,
       "mcp_route": null
     },
+    {
+      "id": "tfx-codex-swarm",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?codex[\\s-]?swarm\\b",
+          "flags": "i"
+        },
+        {
+          "source": "\\bcodex[\\s-]?swarm\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-codex-swarm",
+      "priority": 1,
+      "supersedes": [
+        "tfx-codex"
+      ],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "tfx-remote-spawn",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?remote[\\s-]?spawn\\b",
+          "flags": "i"
+        },
+        {
+          "source": "\\bremote[\\s-]?spawn\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-remote-spawn",
+      "priority": 1,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
     {
       "id": "tfx-auto-codex",
       "patterns": [
@@ -74,7 +114,7 @@
       "id": "tfx-codex",
       "patterns": [
         {
-          "source": "\\btfx[\\s-]?codex\\b",
+          "source": "\\btfx[\\s-]?codex\\b(?![\\s-]?swarm)",
           "flags": "i"
         }
       ],
@@ -373,6 +413,154 @@
       "state": null,
       "mcp_route": "codex"
     },
+    {
+      "id": "gstack-checkpoint",
+      "patterns": [
+        {
+          "source": "(?:어디까지\\s*했|뭐\\s*하고\\s*있었|뭘\\s*해야\\s*하|까먹|기억이\\s*안|이어서\\s*하|중단\\s*지점)",
+          "flags": "i"
+        },
+        {
+          "source": "\\b(?:checkpoint|resume|pick\\s*up|where\\s*was\\s*I)\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "checkpoint",
+      "priority": 5,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "gstack-office-hours",
+      "patterns": [
+        {
+          "source": "(?:아이디어\\s*(?:있|정리|브레인)|뭘\\s*만들|제품\\s*구상)",
+          "flags": "i"
+        },
+        {
+          "source": "\\boffice[\\s-]?hours\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "office-hours",
+      "priority": 5,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "gstack-ship",
+      "patterns": [
+        {
+          "source": "(?:배포해|PR\\s*만들|릴리스\\s*해|머지하고\\s*배포)",
+          "flags": "i"
+        },
+        {
+          "source": "\\bship\\b(?!.*tfx)",
+          "flags": "i"
+        }
+      ],
+      "skill": "ship",
+      "priority": 5,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "gstack-investigate",
+      "patterns": [
+        {
+          "source": "(?:왜\\s*(?:안\\s*돼|터져|에러)|원인\\s*(?:찾아|분석)|root\\s*cause)",
+          "flags": "i"
+        },
+        {
+          "source": "\\binvestigate\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "investigate",
+      "priority": 5,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "gstack-cso",
+      "patterns": [
+        {
+          "source": "(?:보안\\s*(?:감사|점검|리뷰|스캔)|\\bcso\\b|\\bOWASP\\b|\\bSTRIDE\\b)",
+          "flags": "i"
+        }
+      ],
+      "skill": "cso",
+      "priority": 5,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "gstack-qa-browser",
+      "patterns": [
+        {
+          "source": "(?:사이트|브라우저|웹)\\s*(?:QA|테스트|확인|점검)",
+          "flags": "i"
+        },
+        {
+          "source": "(?:클릭|접속).*(?:테스트|확인)",
+          "flags": "i"
+        }
+      ],
+      "skill": "qa",
+      "priority": 5,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "gstack-retro",
+      "patterns": [
+        {
+          "source": "(?:회고|이번\\s*주\\s*뭐\\s*했|주간\\s*리뷰|뭘\\s*했지)",
+          "flags": "i"
+        },
+        {
+          "source": "\\bretro\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "retro",
+      "priority": 5,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "gstack-autoplan",
+      "patterns": [
+        {
+          "source": "(?:자동\\s*리뷰|리뷰\\s*파이프라인|전체\\s*리뷰)",
+          "flags": "i"
+        },
+        {
+          "source": "\\bautoplan\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "autoplan",
+      "priority": 5,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
     {
       "id": "suppress-omc-team",
       "patterns": [

package/hooks/safety-guard.mjs

@@ -22,6 +22,8 @@ const BLOCK_RULES = [
   { pattern: /\bformat\s+[a-z]:/i, reason: "디스크 포맷 차단" },
   { pattern: /\b(del|rmdir)\s+\/[sq]\b/i, reason: "Windows 재귀 삭제 차단" },
   { pattern: /\bgit\s+clean\s+.*-fd/i, reason: "git clean -fd 차단 — 추적되지 않은 파일 소실 위험" },
+  { pattern: /\bpsmux\s+kill-session\b/i, reason: "raw psmux kill-session 차단 — WT ConPTY 프리징 위험. 안전 경로: node hub/team/psmux.mjs kill --session <name>", skipIfGit: true },
+  { pattern: /\bpsmux\s+kill-server\b/i, reason: "psmux kill-server 차단 — 모든 세션이 즉시 종료됩니다. node hub/team/psmux.mjs kill-swarm 사용", skipIfGit: true },
 ];
 
 // ── 경고 규칙 ──────────────────────────────────────────────
@@ -60,8 +62,22 @@ function main() {
   const command = (input.tool_input?.command || "").trim();
   if (!command) process.exit(0);
 
+  // psmux 명령이 실제 CLI 호출인지 판별 (오탐 방지)
+  // git commit 메시지, echo, grep, cat, heredoc 안의 텍스트는 무시
+  function isPsmuxInvocation(cmd) {
+    // 명령을 세그먼트로 분할 (&&, ;, | 기준)
+    const segments = cmd.split(/[;&|]+/);
+    return segments.some((seg) => {
+      const trimmed = seg.trim();
+      if (trimmed.startsWith("#")) return false; // 주석
+      // 세그먼트의 첫 단어가 psmux인 경우만 실제 호출
+      return /^\s*psmux\s+kill-(session|server)\b/i.test(trimmed);
+    });
+  }
+
   // 1. BLOCK 체크 — exit 2로 차단
   for (const rule of BLOCK_RULES) {
+    if (rule.skipIfGit && !isPsmuxInvocation(command)) continue;
     if (rule.pattern.test(command)) {
       process.stderr.write(
         `[triflux safety-guard] BLOCKED: ${rule.reason}\n` +