@triflux/core 10.49.0 → 10.50.1

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);
-}