@triflux/remote 10.1.0 → 10.25.1

package/hub/team/consensus-meta.mjs

@@ -0,0 +1,176 @@
+const VALID_SHAPES = new Set(["consensus", "debate", "panel"]);
+const VALID_ACTIONS = new Set([
+  "merge",
+  "FIX_FIRST",
+  "close",
+  "defer",
+  "split",
+]);
+const DEFAULT_SHAPE = "consensus";
+
+export const CONSENSUS_SHAPE_COMPLEXITY = Object.freeze({
+  consensus: 1.0,
+  debate: 1.2,
+  panel: 1.4,
+});
+
+export const CONSENSUS_MARKDOWN_SECTIONS = Object.freeze({
+  consensus: Object.freeze([
+    "## 합의 결과: {topic}",
+    "### Consensus Score",
+    "### 합의 항목",
+    "### disputed items",
+    "### resolved items",
+    "### user decision needed",
+    "### meta judgment",
+  ]),
+  debate: Object.freeze([
+    "## 토론 결과: {topic}",
+    "### 비교 대상",
+    "### 평가 기준",
+    "### 합의 사항",
+    "### 최종 추천",
+    "### 리스크 및 완화 방안",
+    "### meta judgment",
+  ]),
+  panel: Object.freeze([
+    "## 전문가 패널 보고서: {topic}",
+    "### 패널 구성",
+    "### 패널 합의",
+    "### 소수 견해",
+    "### 핵심 추천",
+    "### 미해결 쟁점",
+    "### 다음 단계",
+    "### meta judgment",
+  ]),
+});
+
+function toArray(value) {
+  if (Array.isArray(value)) return value.filter(Boolean);
+  if (value == null) return [];
+  return [value].filter(Boolean);
+}
+
+function normalizeShape(shape) {
+  return VALID_SHAPES.has(shape) ? shape : DEFAULT_SHAPE;
+}
+
+function normalizeRecommendedAction(action) {
+  return VALID_ACTIONS.has(action) ? action : "defer";
+}
+
+function normalizeStringList(items) {
+  return [
+    ...new Set(
+      toArray(items)
+        .map((item) => String(item).trim())
+        .filter(Boolean),
+    ),
+  ];
+}
+
+function normalizeSeverityBucket(items) {
+  return toArray(items).map((item) =>
+    typeof item === "string" ? { id: item, summary: item } : { ...item },
+  );
+}
+
+function buildSeverityClassification({ p1 = [], p2 = [], p3 = [] } = {}) {
+  return {
+    p1: normalizeSeverityBucket(p1),
+    p2: normalizeSeverityBucket(p2),
+    p3: normalizeSeverityBucket(p3),
+  };
+}
+
+function buildConsensusVsDispute({ agreements = [], conflicts = [] } = {}) {
+  return {
+    agreements: toArray(agreements).map((item) =>
+      typeof item === "string" ? { summary: item } : { ...item },
+    ),
+    conflicts: toArray(conflicts).map((item) =>
+      typeof item === "string"
+        ? { summary: item, parties: [] }
+        : { parties: [], ...item },
+    ),
+  };
+}
+
+function inferStatus(participants) {
+  const statuses = participants.map((participant) => participant.status);
+  if (statuses.length === 0) return "needs_user_input";
+  if (statuses.every((status) => status === "success")) return "complete";
+  if (statuses.some((status) => status === "needs_user_input"))
+    return "needs_user_input";
+  return "partial";
+}
+
+export function normalizeParticipants(participants = []) {
+  return toArray(participants).map((participant) => {
+    if (typeof participant === "string") {
+      return { name: participant, status: "success" };
+    }
+
+    return {
+      name: participant?.name ?? "unknown",
+      status: participant?.status ?? "success",
+      ...participant,
+    };
+  });
+}
+
+export function buildMetaJudgment({
+  severity = {},
+  consensus = {},
+  recommendedAction = "defer",
+  followupIssues = [],
+  modeSpecificMeta = {},
+} = {}) {
+  return {
+    severity_classification: buildSeverityClassification(severity),
+    consensus_vs_dispute: buildConsensusVsDispute(consensus),
+    recommended_action: normalizeRecommendedAction(recommendedAction),
+    followup_issues: normalizeStringList(followupIssues),
+    mode_specific_meta: { ...modeSpecificMeta },
+  };
+}
+
+export function buildConsensusArtifactMeta({
+  shape = DEFAULT_SHAPE,
+  topic = "",
+  cliSet = "triad",
+  participants = [],
+  status,
+} = {}) {
+  const normalizedParticipants = normalizeParticipants(participants);
+  return {
+    mode: "consensus",
+    shape: normalizeShape(shape),
+    topic,
+    cli_set: cliSet,
+    participants: normalizedParticipants,
+    status: status ?? inferStatus(normalizedParticipants),
+  };
+}
+
+export function buildConsensusEnvelope({
+  shape = DEFAULT_SHAPE,
+  topic = "",
+  cliSet = "triad",
+  participants = [],
+  metaJudgment = {},
+} = {}) {
+  return {
+    ...buildConsensusArtifactMeta({ shape, topic, cliSet, participants }),
+    meta_judgment: buildMetaJudgment(metaJudgment),
+  };
+}
+
+export function getShapeContract(shape = DEFAULT_SHAPE) {
+  const normalizedShape = normalizeShape(shape);
+  return {
+    shape: normalizedShape,
+    complexity: CONSENSUS_SHAPE_COMPLEXITY[normalizedShape],
+    required_markdown_sections: CONSENSUS_MARKDOWN_SECTIONS[normalizedShape],
+  };
+}

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,28 +1,9 @@
-import { spawn } from "node:child_process";
-
-import { psmuxExec } from "./psmux.mjs";
-import {
-  detectMultiplexer,
-  focusWtPane,
-  hasWindowsTerminal,
-  resolveAttachCommand,
-  tmuxExec,
-} from "./session.mjs";
-
-function sanitizeWindowTitle(value, fallback = "triflux") {
-  const text = String(value || "").replace(/[\r\n]+/g, " ").trim();
-  return text || fallback;
-}
+import { createTerminalOpener } from "./terminal-opener.mjs";
 
 function sanitizeSessionName(value) {
   return String(value || "").replace(/[^a-zA-Z0-9_-]/g, "") || "tfx-session";
 }
 
-function sanitizeWorkingDirectory(value) {
-  const text = String(value || "").replace(/[\r\n\x00-\x1f]/g, "").trim();
-  return text || process.cwd();
-}
-
 export function parseWorkerNumber(value) {
   const text = String(value || "").trim();
   const workerMatch = text.match(/^worker-(\d+)$/i);
@@ -32,121 +13,42 @@ export function parseWorkerNumber(value) {
   return null;
 }
 
-export function decideDashboardOpenMode({ openAll = false, hasWtSession = !!process.env.WT_SESSION } = {}) {
-  if (openAll) return hasWtSession ? "tab" : "window";
-  return hasWtSession ? "split" : "window";
-}
-
-function spawnWindowsTerminal(spec, opts = {}) {
-  if (!hasWindowsTerminal()) return false;
-
-  const {
-    mode = "window",
-    title = "triflux",
-    cwd = process.cwd(),
-    split = { orientation: "H", size: 0.50 },
-  } = 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 child = spawn("wt.exe", args, {
-    detached: true,
-    stdio: "ignore",
-    windowsHide: false,
-  });
-  child.unref();
-  return true;
+function ignoreAsyncFailure(value) {
+  if (value && typeof value.then === "function") void value.catch(() => {});
 }
 
-export function focusManagedPane(target, opts = {}) {
-  const { teammateMode = "", layout = "1xN" } = opts;
-  const paneRef = String(target || "");
-
-  if (teammateMode === "wt" || paneRef.startsWith("wt:")) {
-    const paneIndex = parseWorkerNumber(paneRef);
-    return paneIndex != null && focusWtPane(paneIndex, { layout });
-  }
+export async function openHeadlessDashboardTarget(sessionName, opts = {}) {
+  const { openAll = false, cwd = process.cwd(), title } = opts;
+  const safeSession = sanitizeSessionName(sessionName);
+  const workerNumber =
+    opts.workerNumber ??
+    (opts.worker == null ? null : parseWorkerNumber(opts.worker));
 
-  if (!paneRef) return false;
+  let opener;
   try {
-    if (detectMultiplexer() === "psmux") psmuxExec(["select-pane", "-t", paneRef]);
-    else tmuxExec(`select-pane -t ${paneRef}`);
-    return true;
+    const deps = opts._deps ?? {};
+    const openerFactory = deps.createTerminalOpener ?? createTerminalOpener;
+    opener = openerFactory(deps);
   } catch {
-    return false;
+    return !openAll && workerNumber != null;
   }
-}
-
-export function openHeadlessDashboardTarget(sessionName, opts = {}) {
-  const {
-    worker = null,
-    openAll = false,
-    cwd = process.cwd(),
-    title,
-  } = opts;
-
-  const safeSession = sanitizeSessionName(sessionName);
-  const workerNumber = worker == null ? null : parseWorkerNumber(worker);
 
   // 선택 워커 → pane focus만 (새 창 열지 않음)
   if (!openAll && workerNumber != null) {
     try {
-      psmuxExec(["select-pane", "-t", `${safeSession}:0.${workerNumber}`]);
+      ignoreAsyncFailure(opener.focusPane(safeSession, workerNumber));
     } catch {}
     return true;
   }
 
-  // 전체 열기 (Shift+Enter) → 새 WT 창으로 세션 attach
-  return spawnWindowsTerminal(
-    { command: "psmux", args: ["attach-session", "-t", safeSession] },
-    {
-      mode: decideDashboardOpenMode({ openAll }),
-      title: title || `▲ ${safeSession}`,
-      cwd,
-    },
-  );
-}
-
-export function openDashboardRuntimeTarget(runtime, opts = {}) {
-  const {
-    teammateMode = "",
-    sessionName = "",
-    targetPane = "",
-    layout = "1xN",
-    openAll = false,
-    cwd = process.cwd(),
-    title = "",
-  } = { ...runtime, ...opts };
-
-  if (teammateMode === "headless") {
-    return openHeadlessDashboardTarget(sessionName, {
-      worker: openAll ? null : targetPane,
-      openAll,
-      cwd,
-      title,
-    });
-  }
-
-  if ((teammateMode === "wt" || String(targetPane).startsWith("wt:")) && !openAll) {
-    return focusManagedPane(targetPane, { teammateMode: "wt", layout });
-  }
-
+  // 전체 열기 (Shift+Enter) → 새 창으로 세션 attach
   try {
-    if (!openAll && targetPane) focusManagedPane(targetPane, { teammateMode, layout });
-    return spawnWindowsTerminal(resolveAttachCommand(sessionName), {
-      mode: decideDashboardOpenMode({ openAll }),
-      title: title || `▲ ${sanitizeSessionName(sessionName)}`,
+    const opened = opener.openSession(safeSession, {
+      title: title || `▲ ${safeSession}`,
       cwd,
+      profile: opts.profile ?? "triflux",
     });
+    return await opened;
   } catch {
     return false;
   }

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