@triflux/core 10.48.1 → 10.50.0

package/hooks/subagent-tracker.mjs

@@ -1,281 +0,0 @@
-#!/usr/bin/env node
-// hooks/subagent-tracker.mjs — SubagentStart/SubagentStop lifecycle tracker
-//
-// Maintains a small repo-local JSON store of running and recently completed
-// subagents so paired lifecycle hooks can add bounded context without blocking.
-
-import {
-  mkdirSync,
-  readFileSync,
-  renameSync,
-  rmSync,
-  writeFileSync,
-} from "node:fs";
-import { dirname, join } from "node:path";
-
-const STATE_VERSION = 1;
-const DEFAULT_TTL_MS = 2 * 60 * 60 * 1000;
-const MAX_COMPLETED = 20;
-// Lifecycle hooks are best-effort, but under CI/Linux process contention a
-// 30-way SubagentStart burst can legitimately take around a second to drain.
-// Keep this bounded so hooks do not hang indefinitely, while avoiding silent
-// lifecycle drops during normal high-concurrency fan-out.
-const DEFAULT_LOCK_TIMEOUT_MS = 3000;
-const LOCK_RETRY_MS = 20;
-
-function readStdin() {
-  try {
-    return readFileSync(0, "utf8");
-  } catch {
-    return "";
-  }
-}
-
-function isObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
-function stateDirFromEnv(env = process.env, cwd = process.cwd()) {
-  return (
-    env.TRIFLUX_SUBAGENT_STATE_DIR ||
-    join(env.CLAUDE_CWD || cwd, ".triflux", "subagents")
-  );
-}
-
-function emptyState(now = new Date()) {
-  return {
-    version: STATE_VERSION,
-    updatedAt: now.toISOString(),
-    agents: {},
-    completed: [],
-  };
-}
-
-function normalizeState(value, now) {
-  const state = isObject(value) ? value : {};
-  return {
-    version: STATE_VERSION,
-    updatedAt:
-      typeof state.updatedAt === "string" ? state.updatedAt : now.toISOString(),
-    agents: isObject(state.agents) ? state.agents : {},
-    completed: Array.isArray(state.completed) ? state.completed : [],
-  };
-}
-
-function readState(path, now) {
-  try {
-    return normalizeState(JSON.parse(readFileSync(path, "utf8")), now);
-  } catch {
-    return emptyState(now);
-  }
-}
-
-function writeState(path, state) {
-  mkdirSync(dirname(path), { recursive: true });
-  const tmpPath = `${path}.${process.pid}.${Date.now()}.tmp`;
-  writeFileSync(tmpPath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
-  renameSync(tmpPath, path);
-}
-
-function sleepSync(ms) {
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-
-function withStateLock(statePath, fn, timeoutMs = DEFAULT_LOCK_TIMEOUT_MS) {
-  const lockDir = `${statePath}.lock`;
-  const started = Date.now();
-  while (true) {
-    try {
-      mkdirSync(lockDir, { recursive: false });
-      try {
-        return fn();
-      } finally {
-        rmSync(lockDir, { recursive: true, force: true });
-      }
-    } catch (error) {
-      if (error?.code !== "EEXIST") throw error;
-      if (Date.now() - started >= timeoutMs) return undefined;
-      sleepSync(LOCK_RETRY_MS);
-    }
-  }
-}
-
-function lockTimeoutMsFromOptions(opts = {}) {
-  if (Number.isFinite(opts.lockTimeoutMs)) return opts.lockTimeoutMs;
-  const raw = opts.env?.TRIFLUX_SUBAGENT_LOCK_TIMEOUT_MS;
-  if (raw === undefined || raw === "") return DEFAULT_LOCK_TIMEOUT_MS;
-  const parsed = Number(raw);
-  return Number.isFinite(parsed) && parsed > 0
-    ? Math.trunc(parsed)
-    : DEFAULT_LOCK_TIMEOUT_MS;
-}
-
-function lifecycleKey(input) {
-  if (typeof input.agent_id === "string" && input.agent_id.trim()) {
-    return input.agent_id;
-  }
-  if (typeof input.subagent_id === "string" && input.subagent_id.trim()) {
-    return input.subagent_id;
-  }
-  const sessionId =
-    typeof input.session_id === "string" && input.session_id.trim()
-      ? input.session_id
-      : "unknown";
-  const agentType =
-    (typeof input.agent_type === "string" && input.agent_type.trim()) ||
-    (typeof input.subagent_type === "string" && input.subagent_type.trim()) ||
-    "unknown";
-  return `${sessionId}:${agentType}`;
-}
-
-function agentType(input, existing) {
-  return (
-    (typeof input.agent_type === "string" && input.agent_type.trim()) ||
-    (typeof input.subagent_type === "string" && input.subagent_type.trim()) ||
-    existing?.agentType ||
-    "unknown"
-  );
-}
-
-function expectedDeliverables(input) {
-  if (input.expectedDeliverables !== undefined)
-    return input.expectedDeliverables;
-  if (input.expected_deliverables !== undefined)
-    return input.expected_deliverables;
-  if (input.expected_deliverable !== undefined)
-    return input.expected_deliverable;
-  return undefined;
-}
-
-function cleanupStaleAgents(state, nowMs, ttlMs) {
-  for (const [key, agent] of Object.entries(state.agents)) {
-    const startedMs = Date.parse(agent?.startedAt || "");
-    if (!Number.isFinite(startedMs) || nowMs - startedMs > ttlMs) {
-      delete state.agents[key];
-    }
-  }
-}
-
-function boundedCompleted(completed) {
-  return completed.slice(-MAX_COMPLETED);
-}
-
-function completionSummary({ key, input, running, now, durationMs }) {
-  const summary = {
-    key,
-    stoppedAt: now.toISOString(),
-    sessionId:
-      (typeof input.session_id === "string" && input.session_id.trim()) ||
-      running?.sessionId ||
-      undefined,
-    agentType: agentType(input, running),
-    durationMs,
-  };
-  if (running?.startedAt) summary.startedAt = running.startedAt;
-  if (running?.expectedDeliverables !== undefined) {
-    summary.expectedDeliverables = running.expectedDeliverables;
-  }
-  return Object.fromEntries(
-    Object.entries(summary).filter(([, value]) => value !== undefined),
-  );
-}
-
-function stopOutput({ summary, runningCount, completedCount }) {
-  const message =
-    `[subagent-tracker] ${summary.agentType} ` +
-    `duration=${summary.durationMs}ms ` +
-    `running=${runningCount} completed=${completedCount}`;
-  return { systemMessage: message };
-}
-
-export function recordLifecycle(input, opts = {}) {
-  if (!isObject(input)) return undefined;
-  const eventName = input.hook_event_name;
-  if (eventName !== "SubagentStart" && eventName !== "SubagentStop") {
-    return undefined;
-  }
-
-  const now = opts.now instanceof Date ? opts.now : new Date();
-  const nowMs = now.getTime();
-  const ttlMs = Number.isFinite(opts.ttlMs) ? opts.ttlMs : DEFAULT_TTL_MS;
-  const stateDir = opts.stateDir || stateDirFromEnv(opts.env, opts.cwd);
-  const statePath = join(stateDir, "subagents.json");
-  mkdirSync(stateDir, { recursive: true });
-  return withStateLock(
-    statePath,
-    () => {
-      const state = readState(statePath, now);
-
-      cleanupStaleAgents(state, nowMs, ttlMs);
-
-      const key = lifecycleKey(input);
-      let output;
-
-      if (eventName === "SubagentStart") {
-        const existing = state.agents[key];
-        const deliverables = expectedDeliverables(input);
-        state.agents[key] = {
-          key,
-          startedAt: existing?.startedAt || now.toISOString(),
-          sessionId:
-            (typeof input.session_id === "string" && input.session_id.trim()) ||
-            existing?.sessionId ||
-            undefined,
-          agentType: agentType(input, existing),
-          ...(deliverables !== undefined
-            ? { expectedDeliverables: deliverables }
-            : existing?.expectedDeliverables !== undefined
-              ? { expectedDeliverables: existing.expectedDeliverables }
-              : {}),
-        };
-      } else {
-        const running = state.agents[key];
-        if (running) delete state.agents[key];
-        const startedMs = Date.parse(running?.startedAt || "");
-        const durationMs = Number.isFinite(startedMs)
-          ? Math.max(0, nowMs - startedMs)
-          : 0;
-        const summary = completionSummary({
-          key,
-          input,
-          running,
-          now,
-          durationMs,
-        });
-        state.completed = boundedCompleted([...state.completed, summary]);
-        output = stopOutput({
-          summary,
-          runningCount: Object.keys(state.agents).length,
-          completedCount: state.completed.length,
-        });
-      }
-
-      state.updatedAt = now.toISOString();
-      state.completed = boundedCompleted(state.completed);
-      writeState(statePath, state);
-      return output;
-    },
-    lockTimeoutMsFromOptions(opts),
-  );
-}
-
-function main() {
-  const raw = readStdin();
-  if (!raw.trim()) return;
-
-  let input;
-  try {
-    input = JSON.parse(raw);
-  } catch {
-    return;
-  }
-
-  const output = recordLifecycle(input);
-  if (output) process.stdout.write(JSON.stringify(output));
-}
-
-try {
-  main();
-} catch {
-  process.exit(0);
-}

package/hooks/subagent-verifier.mjs

@@ -1,85 +0,0 @@
-#!/usr/bin/env node
-// hooks/subagent-verifier.mjs — SubagentStop 훅
-//
-// 서브에이전트 완료 시 결과 품질을 체크한다:
-//   - 빈 결과 감지 → 재시도 제안
-//   - 에러 종료 감지 → 원인 분석 컨텍스트 주입
-//   - 과도한 토큰 사용 감지 → 효율성 알림
-
-import { readFileSync } from "node:fs";
-
-function readStdin() {
-  try {
-    return readFileSync(0, "utf8");
-  } catch {
-    return "";
-  }
-}
-
-function main() {
-  const raw = readStdin();
-  if (!raw.trim()) process.exit(0);
-
-  let input;
-  try {
-    input = JSON.parse(raw);
-  } catch {
-    process.exit(0);
-  }
-
-  if (input.hook_event_name && input.hook_event_name !== "SubagentStop") {
-    process.exit(0);
-  }
-
-  const agentType = input.agent_type || input.subagent_type || "unknown";
-  const result = input.tool_output || input.result || "";
-  const resultStr =
-    typeof result === "string" ? result : JSON.stringify(result);
-
-  const issues = [];
-
-  // 1. 빈 결과 체크
-  if (!resultStr.trim() || resultStr.trim().length < 20) {
-    issues.push(
-      `서브에이전트(${agentType})가 거의 빈 결과를 반환했습니다. ` +
-        "프롬프트를 더 구체적으로 작성하거나, 다른 subagent_type을 시도하세요.",
-    );
-  }
-
-  // 2. 에러 키워드 감지
-  const errorPatterns = [
-    /error:|exception:|traceback|failed to|fatal:/i,
-    /❌|FAILED|ERROR/,
-  ];
-  const hasError = errorPatterns.some((p) => p.test(resultStr));
-  if (hasError && resultStr.length > 50) {
-    issues.push(
-      `서브에이전트(${agentType}) 결과에 에러 신호가 감지되었습니다. ` +
-        "결과를 검토하고, 필요 시 다른 접근 방식을 사용하세요.",
-    );
-  }
-
-  // 3. 결과가 너무 길면 요약 필요 알림
-  if (resultStr.length > 15000) {
-    issues.push(
-      `서브에이전트(${agentType}) 결과가 ${Math.round(resultStr.length / 1000)}K 자입니다. ` +
-        "핵심만 추출하여 컨텍스트 윈도우를 절약하세요.",
-    );
-  }
-
-  if (issues.length === 0) process.exit(0);
-
-  const output = {
-    systemMessage:
-      `[subagent-verifier] ${agentType} 완료 — 주의사항:\n` +
-      issues.map((i) => `  → ${i}`).join("\n"),
-  };
-
-  process.stdout.write(JSON.stringify(output));
-}
-
-try {
-  main();
-} catch {
-  process.exit(0);
-}

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

@@ -1,59 +0,0 @@
-import { join } from "node:path";
-
-export const SESSION_TTL_SEC = 30 * 60;
-export const STATE_REL_PATH = join(".triflux", "state", "cross-review.json");
-
-export function readStdin() {
-  return new Promise((resolve) => {
-    let raw = "";
-    process.stdin.setEncoding("utf8");
-    process.stdin.on("data", (chunk) => {
-      raw += chunk;
-    });
-    process.stdin.on("end", () => resolve(raw));
-    process.stdin.on("error", () => resolve(""));
-  });
-}
-
-export function parseJson(raw) {
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-}
-
-export function nowSec() {
-  return Math.floor(Date.now() / 1000);
-}
-
-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;
-  return process.cwd();
-}
-
-export function shouldTrackPath(filePath) {
-  if (typeof filePath !== "string" || !filePath.trim()) return false;
-
-  const lower = filePath.toLowerCase();
-  if (
-    lower.startsWith(".triflux/") ||
-    lower.startsWith(".omc/") ||
-    lower.startsWith(".claude/")
-  )
-    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;
-}
-
-export function expectedReviewer(author) {
-  if (author === "claude") return "codex";
-  if (author === "codex") return "claude";
-  if (author === "gemini") return "claude";
-  return "";
-}

package/scripts/lib/hook-utils.mjs

@@ -1,16 +0,0 @@
-export function nudge(message) {
-  process.stdout.write(
-    JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: "PreToolUse",
-        additionalContext: message,
-      },
-    }),
-  );
-  process.exit(0);
-}
-
-export function deny(reason) {
-  process.stderr.write(reason);
-  process.exit(2);
-}

package/scripts/lib/keyword-rules.mjs

@@ -1,219 +0,0 @@
-import { readFileSync } from "node:fs";
-
-const VALID_MCP_ROUTES = new Set(["codex", "antigravity", "gemini", "claude"]);
-
-function logRuleError(message, error) {
-  if (error) {
-    console.error(`[triflux-keyword-rules] ${message}: ${error.message}`);
-    return;
-  }
-  console.error(`[triflux-keyword-rules] ${message}`);
-}
-
-function normalizePattern(pattern) {
-  if (!pattern || typeof pattern.source !== "string") return null;
-  if (typeof pattern.flags !== "string") return null;
-  return { source: pattern.source, flags: pattern.flags };
-}
-
-function normalizeState(state) {
-  if (state == null) return null;
-  if (typeof state !== "object") return null;
-  if (typeof state.activate !== "boolean") return null;
-  if (typeof state.name !== "string" || !state.name.trim()) return null;
-  return { activate: state.activate, name: state.name.trim() };
-}
-
-function normalizeRule(rule) {
-  if (!rule || typeof rule !== "object") return null;
-  if (rule.disabled === true) return null;
-  if (typeof rule.id !== "string" || !rule.id.trim()) return null;
-  if (!Array.isArray(rule.patterns) || rule.patterns.length === 0) return null;
-  if (typeof rule.priority !== "number" || !Number.isFinite(rule.priority))
-    return null;
-
-  const patterns = rule.patterns.map(normalizePattern).filter(Boolean);
-  if (patterns.length === 0) return null;
-
-  const skill =
-    typeof rule.skill === "string" && rule.skill.trim()
-      ? rule.skill.trim()
-      : null;
-  const action =
-    typeof rule.action === "string" && rule.action.trim()
-      ? rule.action.trim()
-      : null;
-  const mcpRoute =
-    typeof rule.mcp_route === "string" && VALID_MCP_ROUTES.has(rule.mcp_route)
-      ? rule.mcp_route
-      : null;
-
-  if (!skill && !mcpRoute && !action) return null;
-
-  const hint =
-    typeof rule.hint === "string" && rule.hint.trim() ? rule.hint.trim() : null;
-
-  const supersedes = Array.isArray(rule.supersedes)
-    ? rule.supersedes
-        .filter((id) => typeof id === "string" && id.trim())
-        .map((id) => id.trim())
-    : [];
-
-  const state = normalizeState(rule.state);
-  if (rule.state != null && state == null) return null;
-
-  // repo_scope: path segment 화이트리스트 (빈 배열 = 전역). explicit: 종결 라우팅 마커.
-  const repoScope = Array.isArray(rule.repo_scope)
-    ? rule.repo_scope
-        .filter((s) => typeof s === "string" && s.trim())
-        .map((s) => s.trim())
-    : [];
-
-  // platform: process.platform 화이트리스트 (빈 배열 = 전 플랫폼). Windows 전용
-  // 스킬(tfx-wt 등)이 macOS/Linux 프롬프트에 오탐하는 것을 막는다. 배열이 아닌
-  // 값은 규칙 자체를 무효로 본다.
-  if (rule.platform != null && !Array.isArray(rule.platform)) return null;
-  const platform = Array.isArray(rule.platform)
-    ? rule.platform
-        .filter((s) => typeof s === "string" && s.trim())
-        .map((s) => s.trim())
-    : [];
-
-  return {
-    id: rule.id.trim(),
-    patterns,
-    skill,
-    action,
-    hint,
-    priority: rule.priority,
-    supersedes,
-    exclusive: rule.exclusive === true,
-    state,
-    mcp_route: mcpRoute,
-    repo_scope: repoScope,
-    platform,
-    explicit: rule.explicit === true,
-  };
-}
-
-// 외부 JSON 규칙 로드 + 스키마 검증
-export function loadRules(rulesPath) {
-  try {
-    const raw = readFileSync(rulesPath, "utf8");
-    const parsed = JSON.parse(raw);
-    if (!parsed || !Array.isArray(parsed.rules)) {
-      logRuleError(`규칙 형식이 올바르지 않습니다: ${rulesPath}`);
-      return [];
-    }
-
-    const normalized = parsed.rules.map(normalizeRule).filter(Boolean);
-    return normalized;
-  } catch (error) {
-    logRuleError(`규칙 파일을 읽을 수 없습니다: ${rulesPath}`, error);
-    return [];
-  }
-}
-
-// pattern.source / flags를 RegExp로 컴파일
-export function compileRules(rules) {
-  return rules
-    .map((rule) => {
-      try {
-        return {
-          ...rule,
-          compiledPatterns: rule.patterns.map(
-            (p) => new RegExp(p.source, p.flags),
-          ),
-        };
-      } catch (error) {
-        logRuleError(`정규식 컴파일 실패: ${rule.id}`, error);
-        return null;
-      }
-    })
-    .filter(Boolean);
-}
-
-// 입력 텍스트에서 매칭된 규칙 목록 반환
-export function matchRules(compiledRules, cleanText) {
-  if (
-    !Array.isArray(compiledRules) ||
-    typeof cleanText !== "string" ||
-    !cleanText
-  ) {
-    return [];
-  }
-
-  const matches = [];
-
-  for (const rule of compiledRules) {
-    if (
-      !Array.isArray(rule.compiledPatterns) ||
-      rule.compiledPatterns.length === 0
-    ) {
-      continue;
-    }
-
-    const matched = rule.compiledPatterns.some((pattern) => {
-      pattern.lastIndex = 0;
-      return pattern.test(cleanText);
-    });
-
-    if (!matched) continue;
-
-    matches.push({
-      id: rule.id,
-      skill: rule.skill,
-      action: rule.action,
-      hint: rule.hint || null,
-      priority: rule.priority,
-      supersedes: rule.supersedes || [],
-      exclusive: rule.exclusive === true,
-      state: rule.state || null,
-      mcp_route: rule.mcp_route || null,
-      repo_scope: rule.repo_scope || [],
-      platform: rule.platform || [],
-      explicit: rule.explicit === true,
-    });
-  }
-
-  return matches;
-}
-
-// priority 정렬 + supersedes + exclusive 처리
-export function resolveConflicts(matches) {
-  try {
-    if (!Array.isArray(matches) || matches.length === 0) return [];
-
-    const sorted = [...matches].sort((a, b) => {
-      if (a.priority !== b.priority) return a.priority - b.priority;
-      return String(a.id).localeCompare(String(b.id));
-    });
-
-    const deduped = [];
-    const seen = new Set();
-    for (const match of sorted) {
-      if (seen.has(match.id)) continue;
-      deduped.push(match);
-      seen.add(match.id);
-    }
-
-    const superseded = new Set();
-    const resolved = [];
-
-    for (const match of deduped) {
-      if (superseded.has(match.id)) continue;
-      resolved.push(match);
-      for (const targetId of match.supersedes || []) {
-        superseded.add(targetId);
-      }
-    }
-
-    const exclusiveMatch = resolved.find((match) => match.exclusive === true);
-    if (exclusiveMatch) return [exclusiveMatch];
-
-    return resolved;
-  } catch (error) {
-    logRuleError("규칙 충돌 해결 실패", error);
-    return [];
-  }
-}