triflux 10.3.4 → 10.7.0

package/scripts/hub-ensure.mjs

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
+
 // SessionStart 훅에서 호출되는 Hub 보장 스크립트.
 // - /status 기반 헬스체크
 // - 비정상 시 Hub를 detached로 기동
 
+import { spawn } from "child_process";
 import { existsSync, readFileSync } from "fs";
-import { join, dirname } from "path";
 import { homedir } from "os";
-import { spawn } from "child_process";
+import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 
 const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1"]);
@@ -23,7 +24,8 @@ function buildHubBaseUrl(host, port) {
 
 function resolveHubTarget() {
   const envPortRaw = Number(process.env.TFX_HUB_PORT || "");
-  const envPort = Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : null;
+  const envPort =
+    Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : null;
   const target = {
     host: "127.0.0.1",
     port: envPort || 27888,
@@ -68,13 +70,15 @@ function startHubDetached(port) {
   try {
     const env = { ...process.env, TFX_HUB_PORT: String(port) };
     if (process.platform === "win32") {
-      // Windows: cmd.exe /c start /b → 완전 독립 프로세스 트리 생성
-      // hook timeout 시 프로세스 트리 킬에서 살아남음
-      const child = spawn("cmd.exe", ["/c", "start", "/b", "", process.execPath, serverPath], {
-        env,
-        stdio: "ignore",
-        windowsHide: true,
-      });
+      const child = spawn(
+        "cmd.exe",
+        ["/c", "start", "/b", "", process.execPath, serverPath],
+        {
+          env,
+          stdio: "ignore",
+          windowsHide: true,
+        },
+      );
       child.unref();
     } else {
       const child = spawn(process.execPath, [serverPath], {
@@ -90,31 +94,46 @@ function startHubDetached(port) {
   }
 }
 
-/** Hub 기동 후 ready 상태까지 대기 (최대 maxWaitMs) */
 async function waitForHubReady(host, port, maxWaitMs = 5000) {
   const interval = 250;
   const deadline = Date.now() + maxWaitMs;
   while (Date.now() < deadline) {
     if (await isHubHealthy(host, port)) return true;
-    await new Promise((r) => setTimeout(r, interval));
+    await new Promise((resolve) => setTimeout(resolve, interval));
   }
   return false;
 }
 
-const { host, port } = resolveHubTarget();
-if (!(await isHubHealthy(host, port))) {
+export async function run(stdinData) {
+  void stdinData;
+
+  const { host, port } = resolveHubTarget();
+  if (await isHubHealthy(host, port)) {
+    return { code: 0, stdout: "hub: ok", stderr: "" };
+  }
+
   const started = startHubDetached(port);
-  if (started) {
-    const ready = await waitForHubReady(host, port, 3000);
-    if (ready) {
-      process.stdout.write("hub: ok");
-    } else {
-      // fire-and-forget: hub이 아직 기동 중일 수 있음 — 에러가 아닌 경고
-      process.stdout.write("hub: starting");
-    }
-  } else {
-    process.stderr.write("[hub-ensure] hub 시작 실패");
+  if (!started) {
+    return { code: 0, stdout: "", stderr: "[hub-ensure] hub 시작 실패" };
   }
-} else {
-  process.stdout.write("hub: ok");
+
+  const ready = await waitForHubReady(host, port, 3000);
+  return {
+    code: 0,
+    stdout: ready ? "hub: ok" : "hub: starting",
+    stderr: "",
+  };
+}
+
+const isMain =
+  process.argv[1] &&
+  import.meta.url.endsWith(
+    process.argv[1].replace(/\\/g, "/").split("/").pop(),
+  );
+
+if (isMain) {
+  const result = await run();
+  if (result.stdout) process.stdout.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+  process.exit(result.code);
 }

package/scripts/keyword-detector.mjs

@@ -3,7 +3,12 @@
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { compileRules, loadRules, matchRules, resolveConflicts } from "./lib/keyword-rules.mjs";
+import {
+  compileRules,
+  loadRules,
+  matchRules,
+  resolveConflicts,
+} from "./lib/keyword-rules.mjs";
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
 const PROJECT_ROOT = dirname(SCRIPT_DIR);
@@ -33,7 +38,10 @@ export function extractPrompt(payload) {
     return payload.prompt;
   }
 
-  if (typeof payload.message?.content === "string" && payload.message.content.trim()) {
+  if (
+    typeof payload.message?.content === "string" &&
+    payload.message.content.trim()
+  ) {
     return payload.message.content;
   }
 
@@ -87,8 +95,8 @@ function createHookOutput(additionalContext) {
     continue: true,
     hookSpecificOutput: {
       hookEventName: "UserPromptSubmit",
-      additionalContext
-    }
+      additionalContext,
+    },
   };
 }
 
@@ -144,17 +152,19 @@ function isSkipRequested() {
 }
 
 function activateState(baseDir, stateConfig, prompt, payload) {
-  if (!stateConfig || stateConfig.activate !== true || !stateConfig.name) return;
+  if (!stateConfig || stateConfig.activate !== true || !stateConfig.name)
+    return;
 
   try {
     const stateRoot = join(baseDir, ".triflux", "state");
     mkdirSync(stateRoot, { recursive: true });
 
-    const sessionId = typeof payload?.session_id === "string"
-      ? payload.session_id
-      : typeof payload?.sessionId === "string"
-        ? payload.sessionId
-        : "";
+    const sessionId =
+      typeof payload?.session_id === "string"
+        ? payload.session_id
+        : typeof payload?.sessionId === "string"
+          ? payload.sessionId
+          : "";
 
     let stateDir = stateRoot;
     if (sessionId && /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,255}$/.test(sessionId)) {
@@ -167,12 +177,14 @@ function activateState(baseDir, stateConfig, prompt, payload) {
       active: true,
       name: stateConfig.name,
       started_at: new Date().toISOString(),
-      original_prompt: prompt
+      original_prompt: prompt,
     };
 
     writeFileSync(statePath, JSON.stringify(statePayload, null, 2), "utf8");
   } catch (error) {
-    console.error(`[triflux-keyword-detector] 상태 저장 실패: ${error.message}`);
+    console.error(
+      `[triflux-keyword-detector] 상태 저장 실패: ${error.message}`,
+    );
   }
 }
 
@@ -238,26 +250,35 @@ function main() {
   }
 
   const selected = resolvedMatches[0];
-  const baseDir = typeof payload.cwd === "string" && payload.cwd
-    ? payload.cwd
-    : typeof payload.directory === "string" && payload.directory
-      ? payload.directory
-      : process.cwd();
+  const baseDir =
+    typeof payload.cwd === "string" && payload.cwd
+      ? payload.cwd
+      : typeof payload.directory === "string" && payload.directory
+        ? payload.directory
+        : process.cwd();
 
   activateState(baseDir, selected.state, prompt, payload);
 
   if (selected.action === "suppress_omc") {
-    console.log(JSON.stringify(createHookOutput(createSuppressOmcContext(selected, prompt))));
+    console.log(
+      JSON.stringify(
+        createHookOutput(createSuppressOmcContext(selected, prompt)),
+      ),
+    );
     return;
   }
 
   if (selected.skill) {
-    console.log(JSON.stringify(createHookOutput(createSkillContext(selected, prompt))));
+    console.log(
+      JSON.stringify(createHookOutput(createSkillContext(selected, prompt))),
+    );
     return;
   }
 
   if (selected.mcp_route) {
-    console.log(JSON.stringify(createHookOutput(createMcpRouteContext(selected, prompt))));
+    console.log(
+      JSON.stringify(createHookOutput(createMcpRouteContext(selected, prompt))),
+    );
     return;
   }
 

package/scripts/keyword-rules-expander.mjs

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
+
 // session-vault 태그 빈도 기반으로 keyword-rules.json 확장 후보를 제안하는 스크립트
 
-import Database from "better-sqlite3";
 import { readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import Database from "better-sqlite3";
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
 const PROJECT_ROOT = dirname(SCRIPT_DIR);
@@ -25,7 +26,7 @@ const MCP_SERVICE_ROUTE_MAP = {
   gmail: "gemini",
   email: "gemini",
   github: "codex",
-  figma: "gemini"
+  figma: "gemini",
 };
 
 const MCP_SERVICE_NAMES = new Set([
@@ -37,7 +38,7 @@ const MCP_SERVICE_NAMES = new Set([
   "asana",
   "drive",
   "sheets",
-  "docs"
+  "docs",
 ]);
 
 function printUsage() {
@@ -54,7 +55,7 @@ function parseArgs(argv) {
     apply: false,
     threshold: DEFAULT_THRESHOLD,
     dbPath: DEFAULT_DB_PATH,
-    help: false
+    help: false,
   };
 
   for (let i = 0; i < argv.length; i += 1) {
@@ -202,7 +203,7 @@ function aggregateByNormalizedTag(rows) {
         normalized,
         frequency: 0,
         variants: new Set(),
-        sources: new Set()
+        sources: new Set(),
       });
     }
 
@@ -230,8 +231,11 @@ function readRulesDocument(rulesPath) {
 }
 
 function extractLiteralWords(patternSource) {
-  const words = patternSource.toLowerCase().match(/[a-z0-9][a-z0-9-]{1,}/g) || [];
-  return words.filter((word) => !["true", "false", "null", "route", "skill"].includes(word));
+  const words =
+    patternSource.toLowerCase().match(/[a-z0-9][a-z0-9-]{1,}/g) || [];
+  return words.filter(
+    (word) => !["true", "false", "null", "route", "skill"].includes(word),
+  );
 }
 
 function buildRuleIndex(rules) {
@@ -243,16 +247,24 @@ function buildRuleIndex(rules) {
 
     const ruleId = typeof rule.id === "string" ? rule.id.trim() : "";
     const skill = typeof rule.skill === "string" ? rule.skill.trim() : "";
-    const route = typeof rule.mcp_route === "string" ? rule.mcp_route.trim() : "";
+    const route =
+      typeof rule.mcp_route === "string" ? rule.mcp_route.trim() : "";
 
     if (ruleId) aliases.add(normalizeKeyword(ruleId));
-    if (ruleId.endsWith("-route")) aliases.add(normalizeKeyword(ruleId.slice(0, -"-route".length)));
-    if (ruleId.endsWith("-skill")) aliases.add(normalizeKeyword(ruleId.slice(0, -"-skill".length)));
+    if (ruleId.endsWith("-route"))
+      aliases.add(normalizeKeyword(ruleId.slice(0, -"-route".length)));
+    if (ruleId.endsWith("-skill"))
+      aliases.add(normalizeKeyword(ruleId.slice(0, -"-skill".length)));
     if (skill) aliases.add(normalizeKeyword(skill));
     if (route) aliases.add(normalizeKeyword(route));
 
     for (const pattern of Array.isArray(rule.patterns) ? rule.patterns : []) {
-      if (!pattern || typeof pattern.source !== "string" || typeof pattern.flags !== "string") continue;
+      if (
+        !pattern ||
+        typeof pattern.source !== "string" ||
+        typeof pattern.flags !== "string"
+      )
+        continue;
       try {
         regexes.push(new RegExp(pattern.source, pattern.flags));
       } catch {
@@ -267,7 +279,7 @@ function buildRuleIndex(rules) {
     indexed.push({
       id: ruleId || "(unknown-rule)",
       aliases,
-      regexes
+      regexes,
     });
   }
 
@@ -300,7 +312,7 @@ function classifyCandidate(keyword) {
       type: "skill",
       label: "skill 규칙 후보",
       skill: normalized,
-      mcpRoute: null
+      mcpRoute: null,
     };
   }
 
@@ -309,7 +321,7 @@ function classifyCandidate(keyword) {
       type: "mcp_route",
       label: "mcp_route 규칙 후보",
       skill: null,
-      mcpRoute: MCP_SERVICE_ROUTE_MAP[normalized] || "gemini"
+      mcpRoute: MCP_SERVICE_ROUTE_MAP[normalized] || "gemini",
     };
   }
 
@@ -317,7 +329,7 @@ function classifyCandidate(keyword) {
     type: "general",
     label: "분류 미정",
     skill: null,
-    mcpRoute: null
+    mcpRoute: null,
   };
 }
 
@@ -353,15 +365,15 @@ function buildRuleFromCandidate(candidate, existingIds) {
       patterns: [
         {
           source: createPatternSource(candidate.keyword),
-          flags: "i"
-        }
+          flags: "i",
+        },
       ],
       skill: candidate.classification.skill,
       priority: 20,
       supersedes: [],
       exclusive: false,
       state: null,
-      mcp_route: null
+      mcp_route: null,
     };
   }
 
@@ -373,15 +385,15 @@ function buildRuleFromCandidate(candidate, existingIds) {
       patterns: [
         {
           source: createPatternSource(candidate.keyword),
-          flags: "i"
-        }
+          flags: "i",
+        },
       ],
       skill: null,
       priority: 20,
       supersedes: [],
       exclusive: false,
       state: null,
-      mcp_route: candidate.classification.mcpRoute
+      mcp_route: candidate.classification.mcpRoute,
     };
   }
 
@@ -405,7 +417,7 @@ function printAnalysis({
   coveredCount,
   threshold,
   candidates,
-  covered
+  covered,
 }) {
   console.log("=== keyword-rules-expander 분석 결과 ===");
   console.log("");
@@ -419,7 +431,9 @@ function printAnalysis({
     console.log("  (없음)");
   } else {
     for (const item of candidates) {
-      console.log(`  ${item.keyword} (${item.frequency}회) → ${item.classification.label}`);
+      console.log(
+        `  ${item.keyword} (${item.frequency}회) → ${item.classification.label}`,
+      );
     }
   }
 
@@ -429,7 +443,9 @@ function printAnalysis({
     console.log("  (없음)");
   } else {
     for (const item of covered) {
-      console.log(`  ${item.keyword} (${item.frequency}회) → ${item.ruleId} 규칙 있음`);
+      console.log(
+        `  ${item.keyword} (${item.frequency}회) → ${item.ruleId} 규칙 있음`,
+      );
     }
   }
 }
@@ -458,7 +474,7 @@ function main() {
       covered.push({
         keyword: tag.keyword,
         frequency: tag.frequency,
-        ruleId: matchedRuleId
+        ruleId: matchedRuleId,
       });
       continue;
     }
@@ -469,7 +485,7 @@ function main() {
       keyword: tag.keyword,
       normalized: tag.normalized,
       frequency: tag.frequency,
-      classification: classifyCandidate(tag.keyword)
+      classification: classifyCandidate(tag.keyword),
     });
   }
 
@@ -480,7 +496,7 @@ function main() {
     coveredCount: covered.length,
     threshold: args.threshold,
     candidates,
-    covered
+    covered,
   });
 
   if (!args.apply) return;
@@ -488,10 +504,12 @@ function main() {
   const existingIds = new Set(
     rulesDoc.rules
       .map((rule) => (typeof rule.id === "string" ? rule.id.trim() : ""))
-      .filter(Boolean)
+      .filter(Boolean),
   );
 
-  const autoApplicable = candidates.filter((item) => item.classification.type !== "general");
+  const autoApplicable = candidates.filter(
+    (item) => item.classification.type !== "general",
+  );
   const manualReviewCount = candidates.length - autoApplicable.length;
 
   const newRules = autoApplicable
@@ -518,4 +536,3 @@ try {
   console.error(`[keyword-rules-expander] 오류: ${error.message}`);
   process.exit(1);
 }
-

package/scripts/lib/claudemd-scanner.mjs

@@ -23,7 +23,12 @@ const DEFAULT_TFX_TEMPLATE = [
 ].join("\n");
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
-const DEFAULT_TEMPLATE_PATH = join(SCRIPT_DIR, "..", "templates", "claudemd-tfx-section.md");
+const DEFAULT_TEMPLATE_PATH = join(
+  SCRIPT_DIR,
+  "..",
+  "templates",
+  "claudemd-tfx-section.md",
+);
 
 function resolveVersion(version) {
   if (version) return version;

package/scripts/lib/context.mjs

@@ -19,10 +19,10 @@
  *     log.info('result.processed'); // correlationId 자동 포함
  *   }
  */
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { randomUUID } from 'node:crypto';
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
 
-import { logger } from './logger.mjs';
+import { logger } from "./logger.mjs";
 
 /** @type {AsyncLocalStorage<{logger: import('pino').Logger, correlationId: string}>} */
 export const asyncLocalStorage = new AsyncLocalStorage();

package/scripts/lib/cross-review-utils.mjs

@@ -28,8 +28,10 @@ export function nowSec() {
 }
 
 export function resolveBaseDir(payload) {
-  if (typeof payload?.cwd === "string" && payload.cwd.trim()) return payload.cwd;
-  if (typeof payload?.directory === "string" && payload.directory.trim()) return payload.directory;
+  if (typeof payload?.cwd === "string" && payload.cwd.trim())
+    return payload.cwd;
+  if (typeof payload?.directory === "string" && payload.directory.trim())
+    return payload.directory;
   return process.cwd();
 }
 
@@ -38,7 +40,8 @@ export function shouldTrackPath(filePath) {
 
   const lower = filePath.toLowerCase();
   if (lower.startsWith(".omc/") || lower.startsWith(".claude/")) return false;
-  if (lower === "package-lock.json" || lower.endsWith("/package-lock.json")) return false;
+  if (lower === "package-lock.json" || lower.endsWith("/package-lock.json"))
+    return false;
   if (/\.(md|lock|yml|yaml)$/i.test(lower)) return false;
   return true;
 }

package/scripts/lib/env-probe.mjs

@@ -1,9 +1,9 @@
+import { execSync, spawn } from "node:child_process";
+import { createHash } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
 import { homedir } from "node:os";
-import { execSync, spawn } from "node:child_process";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { createHash } from "node:crypto";
 import { whichCommand, whichCommandAsync } from "../../hub/platform.mjs";
 
 const DEFAULT_STATUS_URL = "http://127.0.0.1:27888/status";
@@ -73,10 +73,13 @@ function normalizeCliNames(names) {
 }
 
 function mapCliResults(names, results) {
-  return names.reduce((acc, name, index) => ({
-    ...acc,
-    [name]: results[index],
-  }), {});
+  return names.reduce(
+    (acc, name, index) => ({
+      ...acc,
+      [name]: results[index],
+    }),
+    {},
+  );
 }
 
 async function resolveCliProbe(name, options = {}) {
@@ -115,13 +118,18 @@ export function checkCliSync(name, options = {}) {
   const cached = readCachedCliResult(cliName);
   if (cached) return cached;
 
-  const path = (options.whichCommandFn || whichCommand)(cliName, buildCliProbeOptions(options));
+  const path = (options.whichCommandFn || whichCommand)(
+    cliName,
+    buildCliProbeOptions(options),
+  );
   return storeCliResult(cliName, toCliResult(path));
 }
 
 export async function probeClis(names, options = {}) {
   const cliNames = normalizeCliNames(names);
-  const results = await Promise.all(cliNames.map((name) => checkCli(name, options)));
+  const results = await Promise.all(
+    cliNames.map((name) => checkCli(name, options)),
+  );
   return mapCliResults(cliNames, results);
 }
 
@@ -137,15 +145,18 @@ export function detectCodexAuthState({
 } = {}) {
   try {
     const authPath = join(homeDir, ".codex", "auth.json");
-    if (!existsSyncFn(authPath)) return { plan: "unknown", source: "no_auth", fingerprint: "no_auth" };
+    if (!existsSyncFn(authPath))
+      return { plan: "unknown", source: "no_auth", fingerprint: "no_auth" };
 
     const auth = JSON.parse(readFileSyncFn(authPath, "utf8"));
     if (auth.auth_mode !== "chatgpt") {
       const fingerprint = createHash("sha256")
-        .update(JSON.stringify({
-          auth_mode: auth.auth_mode || "api_key",
-          has_api_key: Boolean(auth.api_key || auth.apiKey),
-        }))
+        .update(
+          JSON.stringify({
+            auth_mode: auth.auth_mode || "api_key",
+            has_api_key: Boolean(auth.api_key || auth.apiKey),
+          }),
+        )
         .digest("hex");
       return { plan: "api", source: "api_key", fingerprint };
     }
@@ -156,20 +167,30 @@ export function detectCodexAuthState({
         plan: "unknown",
         source: "no_token",
         fingerprint: createHash("sha256")
-          .update(JSON.stringify({ auth_mode: auth.auth_mode || "chatgpt", token: null }))
+          .update(
+            JSON.stringify({
+              auth_mode: auth.auth_mode || "chatgpt",
+              token: null,
+            }),
+          )
           .digest("hex"),
       };
     }
 
-    const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64url").toString());
-    const plan = payload?.["https://api.openai.com/auth"]?.chatgpt_plan_type || "unknown";
+    const payload = JSON.parse(
+      Buffer.from(token.split(".")[1], "base64url").toString(),
+    );
+    const plan =
+      payload?.["https://api.openai.com/auth"]?.chatgpt_plan_type || "unknown";
     const fingerprint = createHash("sha256")
-      .update(JSON.stringify({
-        auth_mode: auth.auth_mode || "chatgpt",
-        plan,
-        sub: payload?.sub || null,
-        exp: payload?.exp || null,
-      }))
+      .update(
+        JSON.stringify({
+          auth_mode: auth.auth_mode || "chatgpt",
+          plan,
+          sub: payload?.sub || null,
+          exp: payload?.exp || null,
+        }),
+      )
       .digest("hex");
     return { plan, source: "jwt", fingerprint };
   } catch {
@@ -205,7 +226,8 @@ export function checkHub({
   if (!restart) return { ok: false, state: "unreachable", restart: "disabled" };
 
   const serverPath = join(pkgRoot, "hub", "server.mjs");
-  if (!existsSyncFn(serverPath)) return { ok: false, state: "unreachable", restart: "no_server" };
+  if (!existsSyncFn(serverPath))
+    return { ok: false, state: "unreachable", restart: "no_server" };
 
   try {
     const child = spawnFn(process.execPath, [serverPath], {
@@ -235,7 +257,4 @@ export function checkHub({
   return { ok: false, state: "unreachable", restart: "timeout" };
 }
 
-export {
-  DEFAULT_PKG_ROOT,
-  DEFAULT_STATUS_URL,
-};
+export { DEFAULT_PKG_ROOT, DEFAULT_STATUS_URL };