triflux 10.3.4 → 10.7.0

package/hub/team/conductor.mjs

@@ -8,7 +8,7 @@
 // 3. Auto-restart (maxRestarts=3)
 // 4. JSONL event log (블랙박스 리코더)
 
-import { execFile, spawn } from "node:child_process";
+import { execFile, spawn } from "../lib/spawn-trace.mjs";
 import { EventEmitter } from "node:events";
 import {
   copyFileSync,
@@ -22,7 +22,10 @@ import { createRegistry } from "../../mesh/mesh-registry.mjs";
 import { broker } from "../account-broker.mjs";
 import { killProcess } from "../platform.mjs";
 import { createConductorMeshBridge } from "./conductor-mesh-bridge.mjs";
-import { ensureConductorRegistry, getConductorRegistry } from "./conductor-registry.mjs";
+import {
+  ensureConductorRegistry,
+  getConductorRegistry,
+} from "./conductor-registry.mjs";
 import { createEventLog } from "./event-log.mjs";
 import { createHealthProbe } from "./health-probe.mjs";
 import { buildLauncher } from "./launcher-template.mjs";
@@ -86,7 +89,7 @@ export function createConductor(opts = {}) {
   const emitter = new EventEmitter();
   const sessions = new Map();
   let shuttingDown = false;
-  let publicApi = null;
+  const publicApi = null;
 
   // 공유 event log (모든 세션 이벤트를 하나의 JSONL에)
   const eventLog = createEventLog(join(logsDir, "conductor-events.jsonl"));
@@ -180,7 +183,7 @@ export function createConductor(opts = {}) {
     execFn(
       "ssh",
       [`${sshUser}@${sshIp}`, "psmux", "kill-session", "-t", session.id],
-      { timeout: 10_000 },
+      { timeout: 10_000, reason: "conductor:killRemoteSession" },
       () => {},
     );
     eventLog.append("remote_kill", {
@@ -376,6 +379,7 @@ export function createConductor(opts = {}) {
       child = spawn(launcher.command, {
         shell: true,
         env: { ...process.env, ...launcher.env, ...(session.config.env || {}) },
+        reason: `conductor:respawnSession:${session.id}`,
         stdio: ["pipe", "pipe", "pipe"],
         windowsHide: true,
       });

package/hub/team/dashboard-anchor.mjs

@@ -1,10 +1,9 @@
-const DASHBOARD_ANCHORS = new Set([
-  "window",
-  "tab",
-]);
+const DASHBOARD_ANCHORS = new Set(["window", "tab"]);
 
 export function normalizeDashboardAnchor(value) {
-  const normalized = String(value ?? "").trim().toLowerCase();
+  const normalized = String(value ?? "")
+    .trim()
+    .toLowerCase();
   if (!normalized) return "window";
   return DASHBOARD_ANCHORS.has(normalized) ? normalized : "window";
 }

package/hub/team/dashboard-layout.mjs

@@ -12,7 +12,9 @@ const DASHBOARD_LAYOUTS = new Set([
 ]);
 
 export function normalizeDashboardLayout(value, { allowAuto = true } = {}) {
-  const normalized = String(value ?? "").trim().toLowerCase();
+  const normalized = String(value ?? "")
+    .trim()
+    .toLowerCase();
   if (!normalized) return "single";
   if (normalized === "auto" && !allowAuto) return "single";
   return DASHBOARD_LAYOUTS.has(normalized) ? normalized : "single";

package/hub/team/dashboard-open.mjs

@@ -1,4 +1,4 @@
-import { spawn } from "node:child_process";
+import { spawn } from "../lib/spawn-trace.mjs";
 
 import { psmuxExec } from "./psmux.mjs";
 import {
@@ -10,7 +10,9 @@ import {
 } from "./session.mjs";
 
 function sanitizeWindowTitle(value, fallback = "triflux") {
-  const text = String(value || "").replace(/[\r\n]+/g, " ").trim();
+  const text = String(value || "")
+    .replace(/[\r\n]+/g, " ")
+    .trim();
   return text || fallback;
 }
 
@@ -19,7 +21,9 @@ function sanitizeSessionName(value) {
 }
 
 function sanitizeWorkingDirectory(value) {
-  const text = String(value || "").replace(/[\r\n\x00-\x1f]/g, "").trim();
+  const text = String(value || "")
+    .replace(/[\r\n\x00-\x1f]/g, "")
+    .trim();
   return text || process.cwd();
 }
 
@@ -32,7 +36,10 @@ export function parseWorkerNumber(value) {
   return null;
 }
 
-export function decideDashboardOpenMode({ openAll = false, hasWtSession = !!process.env.WT_SESSION } = {}) {
+export function decideDashboardOpenMode({
+  openAll = false,
+  hasWtSession = !!process.env.WT_SESSION,
+} = {}) {
   if (openAll) return hasWtSession ? "tab" : "window";
   return hasWtSession ? "split" : "window";
 }
@@ -44,19 +51,32 @@ function spawnWindowsTerminal(spec, opts = {}) {
     mode = "window",
     title = "triflux",
     cwd = process.cwd(),
-    split = { orientation: "H", size: 0.50 },
+    split = { orientation: "H", size: 0.5 },
   } = opts;
 
   const safeTitle = sanitizeWindowTitle(title);
   const safeCwd = sanitizeWorkingDirectory(cwd);
   const orientation = split?.orientation === "V" ? "V" : "H";
-  const size = Number.isFinite(split?.size) ? Math.min(0.8, Math.max(0.2, split.size)) : 0.50;
-  const baseArgs = ["--profile", "triflux", "--title", safeTitle, "-d", safeCwd, "--", spec.command, ...spec.args];
-  const args = mode === "split"
-    ? ["-w", "0", "sp", `-${orientation}`, "-s", String(size), ...baseArgs]
-    : mode === "tab"
-      ? ["-w", "0", "nt", ...baseArgs]
-      : ["-w", "new", ...baseArgs];
+  const size = Number.isFinite(split?.size)
+    ? Math.min(0.8, Math.max(0.2, split.size))
+    : 0.5;
+  const baseArgs = [
+    "--profile",
+    "triflux",
+    "--title",
+    safeTitle,
+    "-d",
+    safeCwd,
+    "--",
+    spec.command,
+    ...spec.args,
+  ];
+  const args =
+    mode === "split"
+      ? ["-w", "0", "sp", `-${orientation}`, "-s", String(size), ...baseArgs]
+      : mode === "tab"
+        ? ["-w", "0", "nt", ...baseArgs]
+        : ["-w", "new", ...baseArgs];
 
   const child = spawn("wt.exe", args, {
     detached: true,
@@ -78,7 +98,8 @@ export function focusManagedPane(target, opts = {}) {
 
   if (!paneRef) return false;
   try {
-    if (detectMultiplexer() === "psmux") psmuxExec(["select-pane", "-t", paneRef]);
+    if (detectMultiplexer() === "psmux")
+      psmuxExec(["select-pane", "-t", paneRef]);
     else tmuxExec(`select-pane -t ${paneRef}`);
     return true;
   } catch {
@@ -87,12 +108,7 @@ export function focusManagedPane(target, opts = {}) {
 }
 
 export function openHeadlessDashboardTarget(sessionName, opts = {}) {
-  const {
-    worker = null,
-    openAll = false,
-    cwd = process.cwd(),
-    title,
-  } = opts;
+  const { worker = null, openAll = false, cwd = process.cwd(), title } = opts;
 
   const safeSession = sanitizeSessionName(sessionName);
   const workerNumber = worker == null ? null : parseWorkerNumber(worker);
@@ -136,12 +152,16 @@ export function openDashboardRuntimeTarget(runtime, opts = {}) {
     });
   }
 
-  if ((teammateMode === "wt" || String(targetPane).startsWith("wt:")) && !openAll) {
+  if (
+    (teammateMode === "wt" || String(targetPane).startsWith("wt:")) &&
+    !openAll
+  ) {
     return focusManagedPane(targetPane, { teammateMode: "wt", layout });
   }
 
   try {
-    if (!openAll && targetPane) focusManagedPane(targetPane, { teammateMode, layout });
+    if (!openAll && targetPane)
+      focusManagedPane(targetPane, { teammateMode, layout });
     return spawnWindowsTerminal(resolveAttachCommand(sessionName), {
       mode: decideDashboardOpenMode({ openAll }),
       title: title || `▲ ${sanitizeSessionName(sessionName)}`,

package/hub/team/dashboard.mjs

@@ -6,7 +6,7 @@
 //   node hub/team/dashboard.mjs --session <세션이름> [--interval 2]
 //   node hub/team/dashboard.mjs --team <팀이름> [--interval 2]
 import { get } from "node:http";
-import { AMBER, GREEN, RED, GRAY, DIM, BOLD, RESET } from "./shared.mjs";
+import { AMBER, BOLD, DIM, GRAY, GREEN, RED, RESET } from "./shared.mjs";
 
 /**
  * HTTP GET JSON
@@ -19,11 +19,18 @@ function fetchJson(url) {
       let data = "";
       res.on("data", (chunk) => (data += chunk));
       res.on("end", () => {
-        try { resolve(JSON.parse(data)); } catch { resolve(null); }
+        try {
+          resolve(JSON.parse(data));
+        } catch {
+          resolve(null);
+        }
       });
     });
     req.on("error", () => resolve(null));
-    req.on("timeout", () => { req.destroy(); resolve(null); });
+    req.on("timeout", () => {
+      req.destroy();
+      resolve(null);
+    });
   });
 }
 
@@ -77,10 +84,14 @@ function formatUptime(ms) {
  */
 function statusIcon(status) {
   switch (status) {
-    case "completed": return `${GREEN}✓${RESET}`;
-    case "in_progress": return `${AMBER}●${RESET}`;
-    case "failed": return `${RED}✗${RESET}`;
-    default: return `${GRAY}○${RESET}`;
+    case "completed":
+      return `${GREEN}✓${RESET}`;
+    case "in_progress":
+      return `${AMBER}●${RESET}`;
+    case "failed":
+      return `${RED}✗${RESET}`;
+    default:
+      return `${GRAY}○${RESET}`;
   }
 }
 
@@ -118,7 +129,12 @@ function buildMemberList(hubTasks, supervisorMembers, teamState) {
       members.push({
         name: m.name,
         cli: m.cli || "",
-        status: m.status === "running" ? "in_progress" : m.status === "exited" ? "completed" : m.status,
+        status:
+          m.status === "running"
+            ? "in_progress"
+            : m.status === "exited"
+              ? "completed"
+              : m.status,
         subject: "",
         preview: m.lastPreview || "",
       });
@@ -128,7 +144,9 @@ function buildMemberList(hubTasks, supervisorMembers, teamState) {
 
   // teamState 폴백 (하위 호환)
   const panes = teamState?.panes || {};
-  for (const [, paneInfo] of Object.entries(panes).filter(([, v]) => v.role !== "dashboard" && v.role !== "lead")) {
+  for (const [, paneInfo] of Object.entries(panes).filter(
+    ([, v]) => v.role !== "dashboard" && v.role !== "lead",
+  )) {
     members.push({
       name: paneInfo.agentId || paneInfo.name || "?",
       cli: paneInfo.cli || "",
@@ -162,27 +180,41 @@ export async function renderDashboard(sessionName, opts = {}) {
   // 데이터 수집 (병렬)
   const [hubStatus, taskListRes, supervisorRes] = await Promise.all([
     fetchJson(`${hubUrl}/status`),
-    teamName ? fetchPost(`${hubUrl}/bridge/team/task-list`, { team_name: teamName }) : null,
+    teamName
+      ? fetchPost(`${hubUrl}/bridge/team/task-list`, { team_name: teamName })
+      : null,
     supervisorUrl ? fetchJson(`${supervisorUrl}/status`) : null,
   ]);
 
   const hubOnline = !!hubStatus;
-  const hubState = hubOnline ? `${GREEN}● online${RESET}` : `${RED}● offline${RESET}`;
-  const uptime = hubStatus?.hub?.uptime ? formatUptime(hubStatus.hub.uptime) : "-";
+  const hubState = hubOnline
+    ? `${GREEN}● online${RESET}`
+    : `${RED}● offline${RESET}`;
+  const uptime = hubStatus?.hub?.uptime
+    ? formatUptime(hubStatus.hub.uptime)
+    : "-";
   const queueSize = hubStatus?.hub?.queue_depth ?? 0;
 
   // Hub task 데이터
-  const hubTasks = taskListRes?.ok ? (taskListRes.data?.tasks || []) : [];
-  const completedCount = hubTasks.filter((t) => t.status === "completed").length;
+  const hubTasks = taskListRes?.ok ? taskListRes.data?.tasks || [] : [];
+  const completedCount = hubTasks.filter(
+    (t) => t.status === "completed",
+  ).length;
   const totalCount = hubTasks.length;
 
   // Supervisor 멤버 데이터
-  const supervisorMembers = supervisorRes?.ok ? (supervisorRes.data?.members || []) : [];
+  const supervisorMembers = supervisorRes?.ok
+    ? supervisorRes.data?.members || []
+    : [];
 
   // 헤더
   const progress = totalCount > 0 ? ` ${completedCount}/${totalCount}` : "";
-  console.log(`${AMBER}┌─ ${sessionName}${progress} ${GRAY}${"─".repeat(Math.max(0, W - sessionName.length - progress.length - 3))}${AMBER}┐${RESET}`);
-  console.log(`${AMBER}│${RESET} Hub: ${hubState}  Uptime: ${DIM}${uptime}${RESET}  Queue: ${DIM}${queueSize}${RESET}`);
+  console.log(
+    `${AMBER}┌─ ${sessionName}${progress} ${GRAY}${"─".repeat(Math.max(0, W - sessionName.length - progress.length - 3))}${AMBER}┐${RESET}`,
+  );
+  console.log(
+    `${AMBER}│${RESET} Hub: ${hubState}  Uptime: ${DIM}${uptime}${RESET}  Queue: ${DIM}${queueSize}${RESET}`,
+  );
   console.log(`${AMBER}│${RESET}`);
 
   // 멤버/워커 렌더링
@@ -194,20 +226,29 @@ export async function renderDashboard(sessionName, opts = {}) {
     for (const m of members) {
       const icon = statusIcon(m.status);
       const label = `[${m.name}]`;
-      const cliTag = m.cli ? m.cli.charAt(0).toUpperCase() + m.cli.slice(1) : "";
+      const cliTag = m.cli
+        ? m.cli.charAt(0).toUpperCase() + m.cli.slice(1)
+        : "";
 
       // 진행률 추정
-      const pct = m.status === "completed" ? 100
-        : m.status === "in_progress" ? 50
-        : m.status === "failed" ? 100
-        : 0;
+      const pct =
+        m.status === "completed"
+          ? 100
+          : m.status === "in_progress"
+            ? 50
+            : m.status === "failed"
+              ? 100
+              : 0;
 
-      console.log(`${AMBER}│${RESET}  ${BOLD}${label}${RESET} ${cliTag}  ${icon} ${m.status || "pending"}  ${progressBar(pct)}`);
+      console.log(
+        `${AMBER}│${RESET}  ${BOLD}${label}${RESET} ${cliTag}  ${icon} ${m.status || "pending"}  ${progressBar(pct)}`,
+      );
 
       // 미리보기: supervisor lastPreview > task subject
       const preview = m.preview || m.subject || "";
       if (preview) {
-        const truncated = preview.length > W - 8 ? preview.slice(0, W - 11) + "..." : preview;
+        const truncated =
+          preview.length > W - 8 ? preview.slice(0, W - 11) + "..." : preview;
         console.log(`${AMBER}│${RESET}    ${DIM}> ${truncated}${RESET}`);
       }
       console.log(`${AMBER}│${RESET}`);
@@ -228,10 +269,12 @@ async function loadTeamState() {
     const sessionId = process.env.CLAUDE_SESSION_ID;
     if (sessionId) {
       const sessionPath = join(hubDir, `team-state-${sessionId}.json`);
-      if (existsSync(sessionPath)) return JSON.parse(readFileSync(sessionPath, "utf8"));
+      if (existsSync(sessionPath))
+        return JSON.parse(readFileSync(sessionPath, "utf8"));
     }
     const legacyPath = join(hubDir, "team-state.json");
-    if (existsSync(legacyPath)) return JSON.parse(readFileSync(legacyPath, "utf8"));
+    if (existsSync(legacyPath))
+      return JSON.parse(readFileSync(legacyPath, "utf8"));
     return {};
   } catch {
     return {};
@@ -244,11 +287,16 @@ if (process.argv[1]?.includes("dashboard.mjs")) {
   const teamIdx = process.argv.indexOf("--team");
   const sessionName = sessionIdx !== -1 ? process.argv[sessionIdx + 1] : null;
   const teamName = teamIdx !== -1 ? process.argv[teamIdx + 1] : null;
-  const intervalSec = parseInt(process.argv[process.argv.indexOf("--interval") + 1] || "2", 10);
+  const intervalSec = parseInt(
+    process.argv[process.argv.indexOf("--interval") + 1] || "2",
+    10,
+  );
 
   const displayName = sessionName || teamName;
   if (!displayName) {
-    console.error("사용법: node dashboard.mjs --session <세션이름> [--team <팀이름>] [--interval 2]");
+    console.error(
+      "사용법: node dashboard.mjs --session <세션이름> [--team <팀이름>] [--interval 2]",
+    );
     process.exit(1);
   }
 

package/hub/team/event-log.mjs

@@ -2,8 +2,8 @@
 // Conductor 세션 lifecycle 이벤트를 JSONL 파일에 기록한다.
 // 기존 hub/server.mjs의 batch-events.jsonl(MCP 이벤트)과 독립. 공존.
 
-import { createWriteStream, mkdirSync } from 'node:fs';
-import { dirname } from 'node:path';
+import { createWriteStream, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
 
 /**
  * JSONL event log 팩토리.
@@ -16,7 +16,7 @@ export function createEventLog(filePath, opts = {}) {
   const { sessionId } = opts;
 
   mkdirSync(dirname(filePath), { recursive: true });
-  const stream = createWriteStream(filePath, { flags: 'a' });
+  const stream = createWriteStream(filePath, { flags: "a" });
 
   let closed = false;
   let pending = 0;
@@ -35,7 +35,9 @@ export function createEventLog(filePath, opts = {}) {
       ...data,
     };
     pending += 1;
-    stream.write(JSON.stringify(entry) + '\n', () => { pending -= 1; });
+    stream.write(JSON.stringify(entry) + "\n", () => {
+      pending -= 1;
+    });
   }
 
   /**
@@ -45,9 +47,9 @@ export function createEventLog(filePath, opts = {}) {
   function flush() {
     if (closed) return Promise.resolve();
     return new Promise((resolve, reject) => {
-      stream.once('error', reject);
-      stream.write('', () => {
-        stream.removeListener('error', reject);
+      stream.once("error", reject);
+      stream.write("", () => {
+        stream.removeListener("error", reject);
         resolve();
       });
     });
@@ -69,8 +71,14 @@ export function createEventLog(filePath, opts = {}) {
     append,
     flush,
     close,
-    get filePath() { return filePath; },
-    get pending() { return pending; },
-    get closed() { return closed; },
+    get filePath() {
+      return filePath;
+    },
+    get pending() {
+      return pending;
+    },
+    get closed() {
+      return closed;
+    },
   });
 }

package/hub/team/handoff.mjs

@@ -44,8 +44,7 @@ Rules:
 /**
  * CLI 프롬프트 길이 제한을 고려한 축약 HANDOFF 지시
  */
-export const HANDOFF_INSTRUCTION_SHORT =
-`After completing, output this block at the end:
+export const HANDOFF_INSTRUCTION_SHORT = `After completing, output this block at the end:
 --- HANDOFF ---
 status: ok | partial | failed
 lead_action: accept | needs_read | retry | reassign
@@ -71,13 +70,20 @@ export function parseHandoff(rawText) {
   const endIdx = rest.indexOf("\n---");
   const block = endIdx === -1 ? rest : rest.slice(0, endIdx);
 
-  const lines = block.split("\n").map((l) => l.trim()).filter(Boolean);
+  const lines = block
+    .split("\n")
+    .map((l) => l.trim())
+    .filter(Boolean);
   const parsed = {};
 
   for (const line of lines) {
     const colonIdx = line.indexOf(":");
     if (colonIdx === -1) continue;
-    const key = line.slice(0, colonIdx).trim().toLowerCase().replace(/\s+/g, "_");
+    const key = line
+      .slice(0, colonIdx)
+      .trim()
+      .toLowerCase()
+      .replace(/\s+/g, "_");
     const value = line.slice(colonIdx + 1).trim();
     if (key && value) parsed[key] = value;
   }
@@ -169,14 +175,18 @@ export function validateHandoff(parsed, context = {}) {
   if (h.status === "failed" || h.status === "partial") {
     if (h.error_stage) {
       const v = validateEnum(h.error_stage, ERROR_STAGE_VALUES);
-      if (!v) { warnings.push(`error_stage: "${h.error_stage}" invalid`); delete h.error_stage; }
-      else h.error_stage = v;
+      if (!v) {
+        warnings.push(`error_stage: "${h.error_stage}" invalid`);
+        delete h.error_stage;
+      } else h.error_stage = v;
     }
     for (const f of ["retryable", "partial_output"]) {
       if (h[f]) {
         const v = validateEnum(h[f], YES_NO);
-        if (!v) { warnings.push(`${f}: "${h[f]}" invalid`); delete h[f]; }
-        else h[f] = v;
+        if (!v) {
+          warnings.push(`${f}: "${h[f]}" invalid`);
+          delete h[f];
+        } else h[f] = v;
       }
     }
   }
@@ -204,7 +214,9 @@ export function validateHandoff(parsed, context = {}) {
       const rest = h.files_changed.length - 3;
       h.files_changed = [...h.files_changed.slice(0, 3), `+${rest} more`];
     }
-    warnings.push(`token cap exceeded (${tokens} > ${TOKEN_HARD_CAP}), trimmed`);
+    warnings.push(
+      `token cap exceeded (${tokens} > ${TOKEN_HARD_CAP}), trimmed`,
+    );
   }
 
   const missingCore = coreRequired.filter((f) => !h[f]);
@@ -232,10 +244,12 @@ export function buildFallbackHandoff(exitCode, resultFile, cli) {
     confidence: "low",
     risk: "low",
     detail: resultFile || "none",
-    ...(ok ? {} : {
-      error_stage: exitCode === 124 ? "timeout" : "execution",
-      retryable: exitCode === 124 ? "no" : "yes",
-    }),
+    ...(ok
+      ? {}
+      : {
+          error_stage: exitCode === 124 ? "timeout" : "execution",
+          retryable: exitCode === 124 ? "no" : "yes",
+        }),
     _fallback: true,
   };
 }
@@ -248,8 +262,10 @@ export function buildFallbackHandoff(exitCode, resultFile, cli) {
 export function formatHandoffForLead(handoff) {
   const h = handoff;
   const files = Array.isArray(h.files_changed)
-    ? (h.files_changed.length > 0 ? h.files_changed.join(", ") : "none")
-    : (h.files_changed || "none");
+    ? h.files_changed.length > 0
+      ? h.files_changed.join(", ")
+      : "none"
+    : h.files_changed || "none";
 
   const lines = [
     `[HANDOFF] status=${h.status || "?"} action=${h.lead_action || "?"} confidence=${h.confidence || "?"}`,

package/hub/team/headless.mjs

@@ -4,7 +4,8 @@
 // v6.0.0: Lead-direct 모드 (runHeadlessInteractive, autoAttachTerminal)
 // 의존성: psmux.mjs (Node.js 내장 모듈만 사용)
 
-import { execSync, spawn } from "node:child_process";
+import { execSync } from "node:child_process";
+import { spawn } from "../lib/spawn-trace.mjs";
 import { randomUUID } from "node:crypto";
 import {
   existsSync,