triflux 10.33.0 → 10.33.1

package/bin/triflux.mjs

@@ -23,6 +23,7 @@ import { homedir, tmpdir } from "os";
 import { basename, dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
 import { loadDelegatorSchemaBundle } from "../hub/delegator/tool-definitions.mjs";
+import { inspectClaudeRuntimeFlags } from "../hub/diagnostics/claude-runtime-flags.mjs";
 import {
   checkNetworkAvailability,
   validateRuntimeCachePaths,
@@ -2524,6 +2525,15 @@ function addDoctorCheck(report, entry) {
   report.checks.push(entry);
 }
 
+function readJsonIfExists(filePath) {
+  if (!existsSync(filePath)) return {};
+  try {
+    return JSON.parse(readFileSync(filePath, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
 function toHookCoverageName(fileName, fallbackId = "") {
   if (typeof fileName === "string" && fileName.trim()) {
     return basename(fileName).replace(/\.mjs$/i, "");
@@ -3453,6 +3463,22 @@ async function cmdDoctor(options = {}) {
       issues++;
     }
 
+    const claudeSettings = readJsonIfExists(join(CLAUDE_DIR, "settings.json"));
+    const runtimeFlags = inspectClaudeRuntimeFlags({
+      env: process.env,
+      settings: claudeSettings,
+    });
+    addDoctorCheck(report, {
+      name: "claude-runtime-flags",
+      status: runtimeFlags.status,
+      safe_mode: runtimeFlags.safeMode,
+      disable_bundled_skills: runtimeFlags.disableBundledSkills,
+      managed_mcp_policy: runtimeFlags.managedMcpPolicy,
+      summary: runtimeFlags.summary,
+      ...(runtimeFlags.fix ? { fix: runtimeFlags.fix } : {}),
+    });
+    if (runtimeFlags.status === "warning") warn(runtimeFlags.summary);
+
     // 7. psmux (Windows only)
     if (process.platform === "win32") {
       section("psmux (터미널 멀티플렉서)");

package/hooks/claude-cwd-projection-refresh.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { refreshClaudeSessionProjectionCwd } from "../hub/team/claude-session-projection.mjs";
+
+function readStdin() {
+  try {
+    return fs.readFile(0, "utf8");
+  } catch {
+    return Promise.resolve("");
+  }
+}
+
+export function resolveCwdChangedPayload(input = {}, env = process.env) {
+  const sessionId = String(
+    input.session_id ??
+      input.sessionId ??
+      input.session?.id ??
+      env.CLAUDE_CODE_SESSION_ID ??
+      env.CLAUDE_SESSION_ID ??
+      "",
+  ).trim();
+  const cwd = String(
+    input.cwd ??
+      input.new_cwd ??
+      input.newCwd ??
+      input.current_cwd ??
+      input.workspace?.cwd ??
+      input.source?.cwd ??
+      "",
+  ).trim();
+  const configDir = path.resolve(
+    env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude"),
+  );
+  return {
+    eventName: String(input.hook_event_name || ""),
+    sessionId,
+    cwd,
+    sessionsDir: path.join(configDir, "sessions"),
+  };
+}
+
+export async function handleCwdChangedHook(stdinText, env = process.env) {
+  let input = {};
+  try {
+    input = stdinText.trim() ? JSON.parse(stdinText) : {};
+  } catch {
+    return { code: 0, stdout: "" };
+  }
+  const payload = resolveCwdChangedPayload(input, env);
+  if (payload.eventName && payload.eventName !== "CwdChanged") {
+    return { code: 0, stdout: "" };
+  }
+  if (!payload.sessionId || !payload.cwd) return { code: 0, stdout: "" };
+
+  const result = await refreshClaudeSessionProjectionCwd({
+    sessionsDir: payload.sessionsDir,
+    sessionId: payload.sessionId,
+    cwd: payload.cwd,
+  });
+  if (!result.updated) return { code: 0, stdout: "" };
+  return {
+    code: 0,
+    stdout: JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "CwdChanged",
+        additionalContext: `Triflux projection cwd refreshed: ${payload.cwd}`,
+      },
+    }),
+  };
+}
+
+if (
+  process.argv[1] &&
+  path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)
+) {
+  const result = await handleCwdChangedHook(await readStdin());
+  if (result.stdout) process.stdout.write(result.stdout);
+  process.exit(result.code);
+}

package/hooks/codex-session-hook.mjs

@@ -51,6 +51,33 @@ function normalizeMode(mode, payload) {
   return "";
 }
 
+function swallowStdoutWrite(_chunk, encodingOrCallback, callback) {
+  const done =
+    typeof encodingOrCallback === "function" ? encodingOrCallback : callback;
+  if (typeof done === "function") done();
+  return true;
+}
+
+async function runHookSideEffectsWithStdoutSuppressed(fn) {
+  const originalStdoutWrite = stdout.write;
+  const originalConsoleDebug = console.debug;
+  const originalConsoleInfo = console.info;
+  const originalConsoleLog = console.log;
+
+  stdout.write = swallowStdoutWrite;
+  console.debug = () => {};
+  console.info = () => {};
+  console.log = () => {};
+  try {
+    return await fn();
+  } finally {
+    stdout.write = originalStdoutWrite;
+    console.debug = originalConsoleDebug;
+    console.info = originalConsoleInfo;
+    console.log = originalConsoleLog;
+  }
+}
+
 export async function runCodexSessionHook(stdinData, opts = {}) {
   const output = "{}\n";
   const parsed = parsePayload(stdinData);
@@ -66,24 +93,26 @@ export async function runCodexSessionHook(stdinData, opts = {}) {
     opts.drainPendingSynapse || defaultDrainPendingSynapse;
 
   try {
-    if (mode === "register") {
-      try {
-        await hubEnsureRun(stdinData);
-      } catch {}
-      try {
-        registerInteractiveSession(stdinData);
-      } catch {}
-      try {
-        await drainPendingSynapse(1000);
-      } catch {}
-    } else if (mode === "heartbeat") {
-      try {
-        heartbeatInteractiveSession(stdinData);
-      } catch {}
-      try {
-        await drainPendingSynapse(500);
-      } catch {}
-    }
+    await runHookSideEffectsWithStdoutSuppressed(async () => {
+      if (mode === "register") {
+        try {
+          await hubEnsureRun(stdinData);
+        } catch {}
+        try {
+          registerInteractiveSession(stdinData);
+        } catch {}
+        try {
+          await drainPendingSynapse(1000);
+        } catch {}
+      } else if (mode === "heartbeat") {
+        try {
+          heartbeatInteractiveSession(stdinData);
+        } catch {}
+        try {
+          await drainPendingSynapse(500);
+        } catch {}
+      }
+    });
   } catch {
     // Codex session hooks are observational and must never block the session.
   }

package/hooks/hook-orchestrator.mjs

@@ -465,6 +465,28 @@ async function main() {
     }
   }
 
+  // ── Stop: interactive 세션 liveness heartbeat (턴 종료 시) ──
+  // UserPromptSubmit 은 턴 *시작* 에, Stop 은 매 어시스턴트 턴 *종료* 에 heartbeat
+  // 한다. 둘이 함께 "대화 중이지만 매 분 새 프롬프트를 보내지는 않는" 세션을 5분
+  // interactive TTL 위로 유지해, 대화 도중 stale 로 떨어져 `cto status`
+  // live_sessions / tray 에서 사라지는 것을 막는다. 진짜 완전 idle(턴 자체가 없음)
+  // 은 여전히 TTL 후 stale 로 가며 — 그게 의도된 dead-session 신호다. UserPromptSubmit
+  // 과 동일하게 fire-and-forget POST 직후 짧은 상한으로 drain 한다.
+  if (eventName === "Stop") {
+    try {
+      const { heartbeatInteractiveSession } = await import(
+        "./session-start-fast.mjs"
+      );
+      heartbeatInteractiveSession(stdinRaw);
+      const { drainPendingSynapse } = await import(
+        "../hub/team/synapse-http.mjs"
+      );
+      await drainPendingSynapse(500);
+    } catch {
+      /* best-effort — heartbeat 실패가 Stop 을 막지 않는다 */
+    }
+  }
+
   // 이벤트에 해당하는 훅 목록
   const hooks = registry.events[eventName];
   if (!hooks || hooks.length === 0) process.exit(0);

package/hooks/hook-registry.json

@@ -8,6 +8,19 @@
     "external_priority": 100
   },
   "events": {
+    "CwdChanged": [
+      {
+        "id": "tfx-claude-cwd-projection-refresh",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/claude-cwd-projection-refresh.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "Claude /cd CwdChanged 이벤트를 Triflux native-bridge projection cwd에 반영"
+      }
+    ],
     "PermissionRequest": [
       {
         "id": "tfx-permission-safe-allow",

package/hooks/hooks.json

@@ -13,6 +13,18 @@
         ]
       }
     ],
+    "CwdChanged": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/hook-orchestrator.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "UserPromptSubmit": [
       {
         "matcher": "*",

package/hub/bridge.mjs

@@ -1207,6 +1207,7 @@ async function cmdDaemonProbe(args) {
     const payload = readBridgePayload(args);
     const {
       deriveClaudeDaemonPaths,
+      extractClaudeAgentSessions,
       findDaemonJobBySessionId,
       findDaemonJobByShort,
       sendClaudeControlRequest,
@@ -1224,11 +1225,12 @@ async function cmdDaemonProbe(args) {
       : payload.short
         ? findDaemonJobByShort(list, payload.short)
         : null;
+    const sessions = extractClaudeAgentSessions(list);
 
     return emitJson({
       ok: list?.ok !== false,
       controlSock: daemonPaths.controlSock,
-      sessions: list?.jobs || list?.sessions || [],
+      sessions,
       target: target || undefined,
       error: list?.ok === false ? list?.error : undefined,
     });

package/hub/diagnostics/claude-runtime-flags.mjs

@@ -0,0 +1,64 @@
+export function readBooleanRuntimeFlag(value) {
+  const text = String(value ?? "")
+    .trim()
+    .toLowerCase();
+  return text === "1" || text === "true" || text === "yes" || text === "on";
+}
+
+function countStringArray(value) {
+  return Array.isArray(value)
+    ? value.filter((entry) => String(entry ?? "").trim()).length
+    : 0;
+}
+
+export function inspectClaudeRuntimeFlags({
+  env = process.env,
+  settings = {},
+} = {}) {
+  const safeMode = readBooleanRuntimeFlag(env.CLAUDE_CODE_SAFE_MODE);
+  const disableBundledSkills =
+    readBooleanRuntimeFlag(env.CLAUDE_CODE_DISABLE_BUNDLED_SKILLS) ||
+    settings?.disableBundledSkills === true;
+  const allowedCount = countStringArray(settings?.allowedMcpServers);
+  const deniedCount = countStringArray(settings?.deniedMcpServers);
+  const managedMcpPolicy = {
+    active: allowedCount > 0 || deniedCount > 0,
+    allowedCount,
+    deniedCount,
+  };
+
+  const messages = [];
+  if (safeMode) {
+    messages.push(
+      "Claude Code safe mode is enabled; CLAUDE.md, plugins, skills, hooks, and MCP servers may be disabled.",
+    );
+  }
+  if (disableBundledSkills) {
+    messages.push(
+      "Claude bundled skills/workflows are disabled; slash-command and skill discovery may differ from normal sessions.",
+    );
+  }
+  if (managedMcpPolicy.active) {
+    messages.push(
+      `Claude managed MCP policy detected; allowed=${allowedCount}, denied=${deniedCount}.`,
+    );
+  }
+
+  return {
+    status: messages.length > 0 ? "warning" : "ok",
+    safeMode,
+    disableBundledSkills,
+    managedMcpPolicy,
+    summary:
+      messages.length > 0
+        ? messages.join(" ")
+        : "Claude Code runtime flags look normal.",
+    fix: safeMode
+      ? "Unset CLAUDE_CODE_SAFE_MODE or restart Claude Code without --safe-mode for normal Triflux hooks/skills/MCP behavior."
+      : disableBundledSkills
+        ? "Unset CLAUDE_CODE_DISABLE_BUNDLED_SKILLS or set disableBundledSkills=false if bundled skills are expected."
+        : managedMcpPolicy.active
+          ? "Review allowedMcpServers/deniedMcpServers in Claude managed settings if MCP tools are missing."
+          : undefined,
+  };
+}

package/hub/mac-tray.swift

@@ -63,7 +63,7 @@ class WebViewController: NSViewController, WKNavigationDelegate, WKScriptMessage
     override func loadView() {
         let webConfiguration = WKWebViewConfiguration()
         webConfiguration.userContentController.add(self, name: "tray")
-        let initialFrame = NSRect(x: 0, y: 0, width: 320, height: 520)
+        let initialFrame = NSRect(x: 0, y: 0, width: 460, height: 720)
         webView = WKWebView(frame: initialFrame, configuration: webConfiguration)
 
         // Transparent background for Glassmorphism

package/hub/public/tray.html

@@ -5,7 +5,7 @@
   <title>Triflux CTO Tray</title>
   <style>
     :root {
-      --bg-color: rgba(30, 30, 30, 0.68);
+      --bg-color: rgba(30, 30, 30, 0.76);
       --border-color: rgba(255,255,255,0.15);
       --text-main: #ffffff;
       --text-muted: rgba(255,255,255,0.58);
@@ -44,6 +44,12 @@
     .stat-label { font-size: 10px; color: var(--text-muted); margin-bottom: 4px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
     .stat-value { font-size: 18px; font-weight: 650; font-variant-numeric: tabular-nums; display: flex; align-items: baseline; gap: 4px; }
     .stat-unit { font-size: 10px; font-weight: 400; color: var(--text-muted); }
+    .session-overview { display: grid; grid-template-columns: 1.25fr repeat(3, minmax(0, 0.78fr)); gap: 8px; }
+    .summary-card { min-width: 0; border-radius: 10px; padding: 9px 10px; background: rgba(0,0,0,0.18); border: 1px solid rgba(255,255,255,0.07); }
+    .summary-card.primary { background: rgba(10,132,255,0.14); border-color: rgba(10,132,255,0.24); }
+    .summary-kpi { font-size: 18px; line-height: 1; font-weight: 760; font-variant-numeric: tabular-nums; letter-spacing: -0.3px; }
+    .summary-label { margin-top: 4px; font-size: 10px; font-weight: 700; color: rgba(255,255,255,0.76); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+    .summary-sub { margin-top: 2px; font-size: 9px; color: var(--text-muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
     .models-list, .server-list, .session-list { display: flex; flex-direction: column; gap: 8px; }
     .model-row { display: grid; grid-template-columns: minmax(76px, auto) 1fr auto; gap: 10px; align-items: center; font-size: 12px; min-width: 0; }
     .model-name { display: flex; align-items: center; gap: 8px; min-width: 0; }
@@ -60,25 +66,25 @@
     .focus-btn:hover { background: var(--accent); color: #fff; }
     .agent-view { display: flex; flex-direction: column; gap: 8px; }
     .project-group { min-width: 0; border: 1px solid rgba(255,255,255,0.06); background: rgba(0,0,0,0.13); border-radius: 9px; overflow: hidden; }
-    .project-group > summary, .cto-chat > summary, .bubble-wrap > summary { list-style: none; }
-    .project-group > summary::-webkit-details-marker, .cto-chat > summary::-webkit-details-marker, .bubble-wrap > summary::-webkit-details-marker { display: none; }
-    .project-summary { display: grid; grid-template-columns: 16px minmax(0, 1fr) auto; gap: 7px; align-items: center; padding: 8px 9px; cursor: pointer; }
+    .project-group > summary, .session-card > summary, .bubble-wrap > summary { list-style: none; }
+    .project-group > summary::-webkit-details-marker, .session-card > summary::-webkit-details-marker, .bubble-wrap > summary::-webkit-details-marker { display: none; }
+    .project-summary { display: grid; grid-template-columns: 16px minmax(0, 1fr) auto; gap: 8px; align-items: center; padding: 9px 10px; cursor: pointer; }
     .project-chevron { color: rgba(255,255,255,0.44); font-size: 11px; transform: rotate(-90deg); transition: transform 120ms ease; }
     .project-group[open] .project-chevron { transform: rotate(0deg); }
     .project-name { color: #b6b1e8; font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; font-size: 13px; font-weight: 750; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-    .project-count { color: var(--text-muted); font-size: 10px; font-variant-numeric: tabular-nums; }
+    .project-count { display: inline-flex; align-items: center; justify-content: center; min-height: 20px; border-radius: 999px; padding: 2px 7px; color: rgba(255,255,255,0.72); background: rgba(255,255,255,0.07); border: 1px solid rgba(255,255,255,0.07); font-size: 10px; font-variant-numeric: tabular-nums; white-space: nowrap; }
     .project-path { color: var(--text-muted); font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; font-size: 10px; padding: 0 9px 8px 32px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
     .project-body { padding: 0 8px 9px; display: flex; flex-direction: column; gap: 7px; }
-    .cto-chat { border: 1px solid rgba(10,132,255,0.13); background: rgba(255,255,255,0.035); border-radius: 8px; overflow: hidden; }
-    .cto-summary { display: grid; grid-template-columns: 18px minmax(0, 1fr) auto; gap: 7px; align-items: center; padding: 7px 8px; cursor: pointer; }
-    .cto-summary-title { font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; font-size: 11px; font-weight: 700; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-    .cto-summary-sub { color: var(--text-muted); font-size: 10px; margin-top: 1px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-    .chat-panel { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 8px; padding: 8px; border-top: 1px solid rgba(255,255,255,0.05); }
-    .chat-column { min-width: 0; display: flex; flex-direction: column; gap: 7px; }
-    .chat-column-title { color: var(--text-muted); font-size: 9px; font-weight: 800; letter-spacing: 0.5px; text-transform: uppercase; }
-    .chat-empty { color: var(--text-muted); border: 1px dashed rgba(255,255,255,0.10); border-radius: 8px; padding: 8px; font-size: 10px; }
+    .session-card { border: 1px solid rgba(10,132,255,0.13); background: rgba(255,255,255,0.035); border-radius: 9px; overflow: hidden; }
+    .session-summary { display: grid; grid-template-columns: 22px minmax(0, 1fr) auto; gap: 8px; align-items: center; padding: 8px 9px; cursor: pointer; }
+    .session-summary-title { font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; font-size: 11px; font-weight: 740; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .session-summary-sub { color: var(--text-muted); font-size: 10px; margin-top: 2px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .session-detail { display: flex; flex-direction: column; gap: 9px; padding: 9px; border-top: 1px solid rgba(255,255,255,0.05); }
+    .detail-section { min-width: 0; display: flex; flex-direction: column; gap: 7px; }
+    .detail-label { color: var(--text-muted); font-size: 9px; font-weight: 800; letter-spacing: 0.5px; text-transform: uppercase; }
+    .detail-empty { color: var(--text-muted); border: 1px dashed rgba(255,255,255,0.10); border-radius: 8px; padding: 8px; font-size: 10px; }
     .runtime-list { display: flex; flex-direction: column; gap: 7px; }
-    .runtime-card { display: grid; grid-template-columns: 22px minmax(0, 1fr) auto; gap: 7px; align-items: center; padding: 7px; border-radius: 8px; background: rgba(255,255,255,0.045); border: 1px solid rgba(255,255,255,0.07); }
+    .runtime-card { display: grid; grid-template-columns: 22px minmax(0, 1fr) auto; gap: 8px; align-items: center; padding: 8px; border-radius: 8px; background: rgba(255,255,255,0.045); border: 1px solid rgba(255,255,255,0.07); }
     .runtime-main { min-width: 0; }
     .runtime-title { display: flex; align-items: center; gap: 6px; min-width: 0; }
     .runtime-command { color: rgba(255,255,255,0.90); font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; font-size: 11px; font-weight: 750; }
@@ -89,8 +95,8 @@
     .bubble-card { min-width: 0; }
     .bubble-wrap { min-width: 0; }
     .bubble-preview { display: block; cursor: pointer; border-radius: 12px; padding: 8px 9px; font-size: 11px; line-height: 1.35; color: rgba(255,255,255,0.88); background: rgba(255,255,255,0.08); border: 1px solid rgba(255,255,255,0.08); max-height: 48px; overflow: hidden; }
-    .worker-column .bubble-preview { border-top-left-radius: 4px; }
-    .cto-column .bubble-preview { background: rgba(10,132,255,0.14); border-color: rgba(10,132,255,0.18); border-top-right-radius: 4px; }
+    .bubble-card.worker .bubble-preview { border-top-left-radius: 4px; }
+    .bubble-card.cto .bubble-preview { background: rgba(10,132,255,0.14); border-color: rgba(10,132,255,0.18); border-top-right-radius: 4px; }
     .bubble-full { margin: 6px 0 0; white-space: pre-wrap; word-break: break-word; max-height: 190px; overflow: auto; padding: 8px; border-radius: 8px; background: rgba(0,0,0,0.28); color: rgba(255,255,255,0.82); font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; font-size: 10px; line-height: 1.35; }
     .agent-line { display: grid; grid-template-columns: 18px minmax(0, 1fr); gap: 5px; align-items: start; min-width: 0; padding: 3px 0; }
     .agent-line.worker { padding-left: 10px; }
@@ -112,6 +118,12 @@
     .chip.on { color: var(--success); border-color: rgba(50,215,75,0.25); background: rgba(50,215,75,0.08); }
     .chip.partial { color: var(--warning); border-color: rgba(255,214,10,0.25); background: rgba(255,214,10,0.08); }
     .chip.off { color: var(--danger); border-color: rgba(255,69,58,0.25); background: rgba(255,69,58,0.08); }
+    .client-chip-row { display: flex; gap: 7px; flex-wrap: wrap; }
+    .client-chip { display: inline-flex; align-items: center; gap: 6px; min-height: 24px; border-radius: 999px; padding: 4px 8px; background: rgba(255,255,255,0.07); border: 1px solid rgba(255,255,255,0.08); color: rgba(255,255,255,0.82); font-size: 11px; }
+    .client-chip strong { font-variant-numeric: tabular-nums; color: var(--text-main); }
+    .client-chip.on { border-color: rgba(50,215,75,0.24); }
+    .client-chip.partial { border-color: rgba(255,214,10,0.24); }
+    .client-chip.off { border-color: rgba(255,69,58,0.24); }
     .agent-badge { width: 20px; height: 20px; display: inline-grid; place-items: center; flex: 0 0 auto; border-radius: 6px; font-size: 11px; font-weight: 850; font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; border: 1px solid rgba(255,255,255,0.12); }
     .agent-tag { justify-content: center; }
     .agent-tag.claude { color: #d19a66; background: rgba(209,154,102,0.12); border-color: rgba(209,154,102,0.32); }
@@ -202,14 +214,14 @@
 
     function renderRuntimeClients(runtime) {
       const clients = Array.isArray(runtime?.summary?.clients) ? runtime.summary.clients : [];
-      const max = Math.max(1, ...clients.map(client => client.count || 0));
-      return clients.map(client => `
-        <div class="model-row">
-          <div class="model-name"><div class="model-icon" style="color:${escapeHtml(client.color)}">${escapeHtml(client.icon)}</div><span class="model-label">${escapeHtml(client.label)}</span></div>
-          <div class="progress-bar-bg"><div class="progress-bar-fill" style="width:${pct(client.count || 0, max)}%; background:${escapeHtml(client.color)}"></div></div>
-          <div class="value-pill status-text ${escapeHtml(client.status)}">${escapeHtml(client.count || 0)}</div>
-        </div>
-      `).join('');
+      if (clients.length === 0) return '<div class="mini-card muted">No runtime clients reported</div>';
+      return `<div class="client-chip-row">${clients.map(client => `
+        <span class="client-chip ${escapeHtml(client.status)}">
+          <span class="dot ${escapeHtml(client.id)}" style="background:${escapeHtml(client.color)};box-shadow:0 0 6px ${escapeHtml(client.color)}"></span>
+          <span>${escapeHtml(client.label)}</span>
+          <strong>${escapeHtml(client.count || 0)}</strong>
+        </span>
+      `).join('')}</div>`;
     }
 
     function liveFallbackRows(live) {
@@ -246,21 +258,28 @@
       return path.replace(/^\/Users\/[^/]+/, '~');
     }
 
+    function normalizeProjectPath(value) {
+      const path = String(value || '').trim();
+      if (!path) return '';
+      if (path === '/' || /^\/+$/u.test(path) || /^[A-Za-z]:[\\/]$/u.test(path)) return path;
+      return path.replace(/[\\/]+$/u, '') || path;
+    }
+
     function projectName(value) {
-      const path = String(value || '').replace(/\/+$/u, '').trim();
+      const path = normalizeProjectPath(value);
       if (!path) return 'local';
-      return path.split('/').filter(Boolean).pop() || path;
+      return path.split(/[\\/]/u).filter(Boolean).pop() || path;
     }
 
     function projectPathFor(row, hub, fallback = '') {
       const cwd = String(row?.cwd || row?.worktreePath || '').trim();
-      if (cwd && cwd !== 'local' && cwd !== 'local runtime') return cwd;
+      if (cwd && cwd !== 'local' && cwd !== 'local runtime') return normalizeProjectPath(cwd);
       const root = String(hub?.projectRoot || fallback || '').trim();
-      return root || cwd || 'local';
+      return normalizeProjectPath(root || cwd || 'local');
     }
 
     function getProjectGroup(groups, projectPath) {
-      const key = projectPath || 'local';
+      const key = normalizeProjectPath(projectPath) || 'local';
       if (!groups.has(key)) groups.set(key, { projectPath: key, ctos: [], workers: [] });
       return groups.get(key);
     }
@@ -356,9 +375,9 @@
       const focusDisabled = row.synthetic || !sid;
       const badge = side === 'cto'
         ? '<span class="agent-badge">T</span>'
-        : `<span class="agent-marker">└</span>${renderAgentTag(row.agent)}`;
+        : renderAgentTag(row.agent) || '<span class="agent-badge">A</span>';
       return `
-        <div class="bubble-card">
+        <div class="bubble-card ${escapeHtml(side)}">
           <div class="chat-session-title">
             <span style="display:flex;align-items:center;gap:6px;min-width:0;">${badge}<span class="chat-session-id">${escapeHtml(sid || side)}</span></span>
             ${focusDisabled ? '' : `<button class="focus-btn" data-focus-session="1" data-session-id="${dataAttr(sid)}" data-pid="${dataAttr(pid)}" data-agent-id="${dataAttr(agentId)}">Focus</button>`}
@@ -383,7 +402,6 @@
           <div class="runtime-main">
             <div class="runtime-title"><span class="runtime-command">${escapeHtml(commandLabel(row))}</span><span class="agent-state ${escapeHtml(status)}">${escapeHtml(status)}</span></div>
             <div class="runtime-sub">${escapeHtml(displayPath(row.cwd || row.host || 'local runtime'))}${row.elapsed ? ` · ${escapeHtml(row.elapsed)}` : ''}</div>
-            <div class="runtime-meta">${pid ? `<span class="chip">PID ${escapeHtml(pid)}</span>` : ''}${renderCopyChip('ID', sid)}</div>
           </div>
           ${focusDisabled ? '' : `<button class="focus-btn" data-focus-session="1" data-session-id="${dataAttr(sid)}" data-pid="${dataAttr(pid)}" data-agent-id="${dataAttr(agentId)}">Focus</button>`}
         </div>
@@ -392,42 +410,53 @@
 
     function renderCtoChat(ctoRow, workers) {
       const status = ctoRow.status || ctoRow.phase || 'active';
-      const title = compactText(ctoRow.sessionId || ctoRow.taskSummary || 'CTO', 'CTO');
-      const subtitle = compactText(hasPromptText(ctoRow) ? ctoRow.taskSummary || ctoRow.sessionKind || '' : '', '');
+      const title = compactText(ctoRow.sessionId || ctoRow.taskSummary || 'Session', 'Session');
+      const subtitle = compactText(hasPromptText(ctoRow) ? ctoRow.taskSummary || ctoRow.sessionKind || '' : displayPath(ctoRow.cwd || ctoRow.worktreePath || ''), '');
+      const promptHtml = hasPromptText(ctoRow)
+        ? `<div class="detail-section"><div class="detail-label">Prompt</div>${renderChatBubble(ctoRow, { side: 'cto' })}</div>`
+        : '';
+      const agentRows = workers.map(worker => hasPromptText(worker) ? renderChatBubble(worker, { side: 'worker' }) : renderRuntimeCard(worker)).join('');
+      const agentsHtml = workers.length
+        ? `<div class="detail-section"><div class="detail-label">Agents</div><div class="runtime-list">${agentRows}</div></div>`
+        : '';
+      const emptyHtml = promptHtml || agentsHtml ? '' : '<div class="detail-empty">No session details yet</div>';
       return `
-        <details class="cto-chat" data-open-key="cto:${dataAttr(ctoRow.sessionId || title)}">
-          <summary class="cto-summary">
-            <div class="agent-marker">•</div>
+        <details class="session-card" data-open-key="cto:${dataAttr(ctoRow.sessionId || title)}">
+          <summary class="session-summary">
+            <span class="agent-badge">T</span>
             <div style="min-width:0;">
-              <div class="cto-summary-title">${escapeHtml(title)}</div>
-              ${subtitle ? `<div class="cto-summary-sub">${escapeHtml(subtitle)}</div>` : ''}
+              <div class="session-summary-title">${escapeHtml(title)}</div>
+              ${subtitle ? `<div class="session-summary-sub">${escapeHtml(subtitle)}</div>` : ''}
             </div>
             <div class="agent-state ${escapeHtml(status)}">${escapeHtml(status)}</div>
           </summary>
-          <div class="chat-panel">
-            <div class="chat-column worker-column">
-              <div class="chat-column-title">Workers</div>
-              ${workers.length ? `<div class="runtime-list">${workers.map(worker => hasPromptText(worker) ? renderChatBubble(worker, { side: 'worker' }) : renderRuntimeCard(worker)).join('')}</div>` : '<div class="chat-empty">No worker sessions detected</div>'}
-            </div>
-            <div class="chat-column cto-column">
-              <div class="chat-column-title">CTO</div>
-              ${hasPromptText(ctoRow) ? renderChatBubble(ctoRow, { side: 'cto' }) : '<div class="chat-empty">No prompt handoff events captured yet</div>'}
-            </div>
+          <div class="session-detail">
+            ${promptHtml}
+            ${agentsHtml}
+            ${emptyHtml}
           </div>
         </details>
       `;
     }
 
+    function pluralize(count, one, many = `${one}s`) {
+      return `${count} ${count === 1 ? one : many}`;
+    }
+
     function renderProjectGroup(group) {
       const projectDisplayPath = displayPath(group.projectPath);
       const projectLabel = projectName(group.projectPath);
-      const totalChildren = group.ctos.length + group.workers.length;
+      const sessionCount = group.ctos.filter(row => !isSyntheticCto(row)).length;
+      const agentCount = group.workers.length;
+      const projectCount = [sessionCount ? pluralize(sessionCount, 'session') : '', agentCount ? pluralize(agentCount, 'agent') : '']
+        .filter(Boolean)
+        .join(' · ') || 'empty';
       let html = `
         <details class="project-group" data-open-key="project:${dataAttr(group.projectPath)}">
           <summary class="project-summary">
             <span class="project-chevron">▾</span>
             <span class="project-name">${escapeHtml(projectLabel)}</span>
-            <span class="project-count">${escapeHtml(String(totalChildren))}</span>
+            <span class="project-count">${escapeHtml(projectCount)}</span>
           </summary>
           <div class="project-path">${escapeHtml(projectDisplayPath)}</div>
           <div class="project-body">
@@ -452,23 +481,26 @@
       const activeSessions = sessions.filter(s => s.status !== 'stale');
       const liveRows = liveFallbackRows(live);
       const projectGroups = buildProjectGroups(activeSessions.slice(0, 10), liveRows, hub);
+      const activeCount = activeSessions.filter(s => s.status === 'active').length;
+      const idleCount = activeSessions.filter(s => s.status === 'idle').length;
       const staleCount = sessions.filter(s => s.status === 'stale').length;
+      const runtimeTotal = runtime?.summary?.total || liveRows.length || 0;
       let html = `
         <div class="section">
-          <div class="stats-grid">
-            <div class="stat-box"><div class="stat-label">Live Sessions</div><div class="stat-value">${live.length}<span class="stat-unit">nodes</span></div></div>
-            <div class="stat-box"><div class="stat-label">Active Shards</div><div class="stat-value">${cto.active_shards?.length || 0}<span class="stat-unit">shards</span></div></div>
-            <div class="stat-box"><div class="stat-label">Runtime CLIs</div><div class="stat-value">${runtime?.summary?.total || 0}<span class="stat-unit">proc</span></div></div>
-            <div class="stat-box"><div class="stat-label">Hub ID</div><div class="badge-row" style="margin-top:0;">${renderCopyChip('Hub', hub.id || String(hub.pid || ''))}</div></div>
+          <div class="session-overview">
+            <div class="summary-card primary"><div class="summary-kpi">${live.length}</div><div class="summary-label">Live agents</div><div class="summary-sub">${runtimeTotal} runtime CLIs</div></div>
+            <div class="summary-card"><div class="summary-kpi">${activeCount}</div><div class="summary-label">Active</div></div>
+            <div class="summary-card"><div class="summary-kpi">${idleCount}</div><div class="summary-label">Idle</div></div>
+            <div class="summary-card"><div class="summary-kpi">${staleCount}</div><div class="summary-label">Stale</div></div>
           </div>
-          ${staleCount ? `<div class="path-text">${staleCount} stale sessions hidden from active cards</div>` : ''}
+          <div class="path-text">${projectGroups.length} ${projectGroups.length === 1 ? 'workspace' : 'workspaces'} · ${cto.active_shards?.length || 0} shards · ${renderCopyChip('Hub', hub.id || String(hub.pid || ''))}</div>
         </div>
         <div class="section">
-          <div class="section-title">Runtime Clients</div>
+          <div class="section-title">Agent Mix</div>
           <div class="models-list">${renderRuntimeClients(runtime)}</div>
         </div>
         <div class="section">
-          <div class="section-title">Projects / CTO / Workers</div>
+          <div class="section-title">Workspaces</div>
           <div class="agent-view">
       `;
       for (const group of projectGroups) html += renderProjectGroup(group);

package/hub/server.mjs

@@ -33,15 +33,15 @@ import { createAdaptiveEngine } from "./adaptive.mjs";
 import { createAssignCallbackServer } from "./assign-callbacks.mjs";
 import { DelegatorService } from "./delegator/index.mjs";
 import { createHitlManager } from "./hitl.mjs";
+import {
+  reapExistingHubProcesses,
+  resolveHubPortForContext,
+} from "./hub-lifecycle.mjs";
 import {
   cleanupOrphanNodeProcesses,
   cleanupOrphanRuntimeProcesses,
   cleanupStaleFsmonitorDaemons,
 } from "./lib/process-utils.mjs";
-import {
-  reapExistingHubProcesses,
-  resolveHubPortForContext,
-} from "./hub-lifecycle.mjs";
 import * as spawnTrace from "./lib/spawn-trace.mjs";
 import {
   recordRequest,
@@ -659,7 +659,10 @@ export function resolveHubIdleTimeoutMs({
   env = process.env,
   defaultPort = HUB_DEFAULT_PORT,
 } = {}) {
-  const parsed = Number.parseInt(String(env?.TFX_HUB_IDLE_TIMEOUT_MS ?? ""), 10);
+  const parsed = Number.parseInt(
+    String(env?.TFX_HUB_IDLE_TIMEOUT_MS ?? ""),
+    10,
+  );
   if (Number.isFinite(parsed) && parsed >= 0) return parsed;
   return Number(port) === defaultPort ? 0 : HUB_IDLE_TIMEOUT_DEFAULT_MS;
 }
@@ -2440,7 +2443,7 @@ export async function startHub({
           );
           if (port === HUB_DEFAULT_PORT) {
             void reapExistingHubProcesses({ currentPid: process.pid }).then(
-              ({ reaped }) => {
+              ({ reaped, failed }) => {
                 if (reaped.length > 0) {
                   hubLog.info(
                     {
@@ -2451,6 +2454,19 @@ export async function startHub({
                     "hub.startup_reaper",
                   );
                 }
+                // Surface kill-unable orphans (EPERM/defunct). Without this the
+                // reaper's failed[] is dropped and an unreapable hub survives
+                // with zero log signal (FU3 observability gap).
+                if (failed && failed.length > 0) {
+                  hubLog.warn(
+                    {
+                      failed: failed.length,
+                      processes: failed,
+                      caller: "startup",
+                    },
+                    "hub.startup_reaper_failed",
+                  );
+                }
               },
             );
           }

package/hub/team/claude-agent-session-normalizer.mjs

@@ -0,0 +1,53 @@
+function firstString(...values) {
+  for (const value of values) {
+    const text = String(value ?? "").trim();
+    if (text) return text;
+  }
+  return "";
+}
+
+function maybeAssign(target, key, value) {
+  if (value !== "" && value != null) target[key] = value;
+}
+
+export function normalizeClaudeAgentSession(row = {}) {
+  const short = firstString(row.short, row.id, row.jobId, row.job_id);
+  const sessionId = firstString(
+    row.sessionId,
+    row.session_id,
+    row.dispatch?.sessionId,
+    row.dispatch?.session_id,
+    row.d?.sessionId,
+    row.d?.session_id,
+    row.session?.id,
+  );
+  const state = firstString(row.state, row.status, row.tempo, "unknown");
+  const status = firstString(row.status, row.state, row.tempo, "unknown");
+
+  const normalized = {
+    ...row,
+    short,
+    id: firstString(row.id, short),
+    sessionId,
+    session_id: sessionId,
+    state,
+    status,
+  };
+  maybeAssign(normalized, "cwd", row.cwd);
+  maybeAssign(normalized, "name", row.name);
+  maybeAssign(normalized, "kind", row.kind);
+  maybeAssign(normalized, "waitingFor", row.waitingFor ?? row.waiting_for);
+  maybeAssign(normalized, "startedAt", row.startedAt ?? row.started_at);
+  maybeAssign(normalized, "updatedAt", row.updatedAt ?? row.updated_at);
+  maybeAssign(normalized, "pid", row.pid);
+  return normalized;
+}
+
+export function extractClaudeAgentSessions(listResponse = {}) {
+  const rows = Array.isArray(listResponse.jobs)
+    ? listResponse.jobs
+    : Array.isArray(listResponse.sessions)
+      ? listResponse.sessions
+      : [];
+  return rows.map((row) => normalizeClaudeAgentSession(row));
+}

package/hub/team/claude-daemon-control.mjs

@@ -4,6 +4,10 @@ import fs from "node:fs/promises";
 import net from "node:net";
 import os from "node:os";
 import path from "node:path";
+import {
+  extractClaudeAgentSessions,
+  normalizeClaudeAgentSession,
+} from "./claude-agent-session-normalizer.mjs";
 import {
   buildClaudeSessionProjection,
   removeClaudeSessionProjection,
@@ -1055,27 +1059,27 @@ export function buildClaudePromptDispatchPayload({
 }
 
 export function findDaemonJobByShort(listResponse, short) {
-  if (!Array.isArray(listResponse?.jobs)) return null;
-  return listResponse.jobs.find((job) => job?.short === short) || null;
+  const expected = String(short || "").trim();
+  if (!expected) return null;
+  return (
+    extractClaudeAgentSessions(listResponse).find(
+      (job) => job.short === expected || job.id === expected,
+    ) || null
+  );
 }
 
 export function findDaemonJobBySessionId(listResponse, sessionId) {
-  if (!Array.isArray(listResponse?.jobs)) return null;
-  const expected = String(sessionId || "");
+  const expected = String(sessionId || "").trim();
   if (!expected) return null;
   return (
-    listResponse.jobs.find((job) => {
-      const candidate =
-        job?.sessionId ??
-        job?.session_id ??
-        job?.dispatch?.sessionId ??
-        job?.d?.sessionId ??
-        "";
-      return String(candidate) === expected;
-    }) || null
+    extractClaudeAgentSessions(listResponse).find(
+      (job) => String(job.sessionId || job.session_id || "") === expected,
+    ) || null
   );
 }
 
+export { extractClaudeAgentSessions, normalizeClaudeAgentSession };
+
 export async function waitForDaemonJobPid(
   controlSock,
   short,

package/hub/team/claude-session-projection.mjs

@@ -69,6 +69,63 @@ export async function updateClaudeSessionProjection(sessionPath, patch) {
   return next;
 }
 
+function projectionSessionId(projection) {
+  return String(
+    projection?.sessionId ?? projection?.session_id ?? projection?.id ?? "",
+  ).trim();
+}
+
+export async function findClaudeSessionProjectionBySessionId(
+  sessionsDir,
+  sessionId,
+) {
+  const expected = String(sessionId || "").trim();
+  if (!sessionsDir || !expected) return null;
+  let entries;
+  try {
+    entries = await fs.readdir(sessionsDir, { withFileTypes: true });
+  } catch (error) {
+    if (error?.code === "ENOENT") return null;
+    throw error;
+  }
+
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
+    const filePath = path.join(sessionsDir, entry.name);
+    try {
+      const projection = JSON.parse(await fs.readFile(filePath, "utf8"));
+      if (projectionSessionId(projection) === expected) {
+        return { path: filePath, projection };
+      }
+    } catch (error) {
+      if (error instanceof SyntaxError) continue;
+      if (error?.code === "ENOENT") continue;
+      throw error;
+    }
+  }
+  return null;
+}
+
+export async function refreshClaudeSessionProjectionCwd({
+  sessionsDir,
+  sessionId,
+  cwd,
+  updatedAt = Date.now(),
+} = {}) {
+  const nextCwd = String(cwd || "").trim();
+  if (!nextCwd) return { updated: false, reason: "missing_cwd" };
+  const found = await findClaudeSessionProjectionBySessionId(
+    sessionsDir,
+    sessionId,
+  );
+  if (!found) return { updated: false, reason: "projection_not_found" };
+  const projection = await updateClaudeSessionProjection(found.path, {
+    cwd: nextCwd,
+    updatedAt,
+  });
+  return { updated: true, path: found.path, projection };
+}
+
 export async function removeClaudeSessionProjection(sessionPath) {
   await fs.rm(sessionPath, { force: true });
 }

package/hub/team/cli/services/hub-client.mjs

@@ -7,7 +7,7 @@ import {
   writeFileSync,
 } from "node:fs";
 import { join } from "node:path";
-
+import { resolveHubPortForContext } from "../../../hub-lifecycle.mjs";
 import { publishLeadControl as publishLeadControlBridge } from "../../lead-control.mjs";
 import {
   getTeamStatus as fetchTeamStatus,
@@ -117,15 +117,24 @@ export async function startHubDaemon() {
     throw error;
   }
 
+  // Resolve the canonical port. server.mjs forces 27888 in worktree/ephemeral
+  // contexts via resolveHubPortForContext; mirror that here so a polluted
+  // TFX_HUB_PORT does not make us spawn with / probe a port the daemon never
+  // binds (defense-in-depth — do not rely solely on server.mjs's boundary guard).
+  const resolvedPort = resolveHubPortForContext({
+    env: process.env,
+    cwd: process.cwd(),
+  });
+
   const child = spawn(process.execPath, [serverPath], {
-    env: { ...process.env },
+    env: { ...process.env, TFX_HUB_PORT: String(resolvedPort) },
     stdio: "ignore",
     detached: true,
     windowsHide: true,
   });
   child.unref();
 
-  const expectedPort = getDefaultHubPort();
+  const expectedPort = resolvedPort;
   const deadline = Date.now() + 3000;
   while (Date.now() < deadline) {
     const status = await probeHubStatus("127.0.0.1", expectedPort, 500);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.33.0",
+  "version": "10.33.1",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Antigravity, and Claude",
   "type": "module",
   "bin": {

package/scripts/lib/env-probe.mjs

@@ -38,7 +38,10 @@ function fetchHubStatus({
   };
 }
 
-export function resolveDefaultStatusUrl(env = process.env, cwd = process.cwd()) {
+export function resolveDefaultStatusUrl(
+  env = process.env,
+  cwd = process.cwd(),
+) {
   const port = resolveHubPortForContext({
     env,
     cwd,

package/scripts/pack.mjs

@@ -61,6 +61,7 @@ const CORE_DIRS = [
   "hub/lib",
   "hub/middleware",
   "hub/team/retry-state-machine.mjs",
+  "hub/team/claude-agent-session-normalizer.mjs",
   "hub/team/claude-daemon-control.mjs",
   "hub/team/claude-session-projection.mjs",
   // dep-free helper imported by core's session-start/end hooks (peer-discovery)

package/scripts/release/check-packages-mirror.mjs

@@ -42,6 +42,10 @@ const CORE_FILE_MIRRORS = [
     source: "hub/team/retry-state-machine.mjs",
     target: "packages/core/hub/team/retry-state-machine.mjs",
   },
+  {
+    source: "hub/team/claude-agent-session-normalizer.mjs",
+    target: "packages/core/hub/team/claude-agent-session-normalizer.mjs",
+  },
   {
     source: "hub/team/claude-daemon-control.mjs",
     target: "packages/core/hub/team/claude-daemon-control.mjs",
@@ -80,6 +84,77 @@ function walkRelFiles(root, skipRels = new Set()) {
   return out;
 }
 
+// packages/remote is NOT a byte-identical mirror: pack:remote rewrites relative
+// imports of core-owned modules to @triflux/core/* specifiers. So validate it
+// structurally instead — every .mjs import must resolve (relative -> exists
+// under packages/remote; @triflux/core/X -> exists under packages/core), and
+// every non-.mjs file mirrored from root must stay byte-identical. This catches
+// the two drift classes that shipped silently in v10.33.0: a broken remote
+// import (relative specifier to a core-only module) and a stale non-JS asset
+// (the tray UI), neither of which the triflux/core byte-mirror check can see.
+const REMOTE_NON_MIRROR = new Set([
+  "package.json",
+  "package-lock.json",
+  "README.md",
+  "README.ko.md",
+  "LICENSE",
+  "hub/index.mjs", // pack-generated barrel (REMOTE_INDEX), not a root mirror
+]);
+
+function extractImportSpecifiers(content) {
+  // Strip comments first so JSDoc usage examples (`* import x from './y'`) and
+  // commented-out imports are not mistaken for real specifiers.
+  const code = content
+    .replace(/\/\*[\s\S]*?\*\//g, "")
+    .replace(/(^|[^:"'`])\/\/.*$/gm, "$1");
+  const specs = [];
+  const re = /(?:from\s+|import\(\s*)["']([^"']+)["']/g;
+  let match;
+  while ((match = re.exec(code)) !== null) specs.push(match[1]);
+  return specs;
+}
+
+function checkRemoteMirror(repoRoot) {
+  const issues = [];
+  const remoteRoot = join(repoRoot, "packages", "remote");
+  const coreRoot = join(repoRoot, "packages", "core");
+  if (!existsSync(remoteRoot)) return issues;
+
+  for (const rel of walkRelFiles(remoteRoot)) {
+    if (REMOTE_NON_MIRROR.has(rel)) continue;
+    const remotePath = join(remoteRoot, rel);
+    const displayPath = `packages/remote/${rel}`;
+
+    if (rel.endsWith(".mjs")) {
+      const content = readFileSync(remotePath, "utf8");
+      for (const spec of extractImportSpecifiers(content)) {
+        let resolvedPath = null;
+        if (spec.startsWith("@triflux/core/")) {
+          resolvedPath = join(coreRoot, spec.slice("@triflux/core/".length));
+        } else if (spec.startsWith(".")) {
+          resolvedPath = join(dirname(remotePath), spec);
+        } else {
+          continue; // bare specifier (node: builtin or npm dependency)
+        }
+        if (!existsSync(resolvedPath)) {
+          issues.push({
+            path: displayPath,
+            kind: `remote-unresolvable-import (${spec})`,
+          });
+        }
+      }
+    } else {
+      // Non-.mjs mirrored from root: no import rewrite -> must be byte-identical.
+      const rootPath = join(repoRoot, rel);
+      if (!existsSync(rootPath)) continue; // remote-only asset, nothing to mirror
+      if (!readFileSync(rootPath).equals(readFileSync(remotePath))) {
+        issues.push({ path: displayPath, kind: "remote-content-diff" });
+      }
+    }
+  }
+  return issues;
+}
+
 function compareMirror({
   fix = false,
   repoRoot = DEFAULT_REPO_ROOT,
@@ -211,6 +286,9 @@ function compareMirror({
     }
   }
 
+  // packages/remote structural validation (not a byte-mirror — see above).
+  for (const issue of checkRemoteMirror(repoRoot)) issues.push(issue);
+
   return { ok: issues.length === 0, issues, fixed };
 }
 
@@ -231,7 +309,7 @@ function main() {
       }
     } else {
       console.log(
-        "Mirror OK — packages/triflux and packages/core file mirrors match root",
+        "Mirror OK — packages/triflux + packages/core (byte) and packages/remote (imports + assets) match root",
       );
     }
   } else {
@@ -247,7 +325,7 @@ function main() {
     }
     console.log("");
     console.log(
-      "Run with --fix to copy root → packages/triflux and packages/core file mirrors. Orphans must be removed manually.",
+      "Run with --fix to copy root → packages/triflux and packages/core file mirrors. Orphans must be removed manually. packages/remote drift (remote-*) is regenerated by `npm run pack:remote`, not --fix.",
     );
   }
 

package/skills/tfx-setup/SKILL.md

@@ -241,7 +241,7 @@ project_doc_fallback_filenames = ["CODEX.md", "AGENTS.md"]
 **이유:**
 - Codex 전용 진입점 `CODEX.md` 우선 → 프로젝트가 의도한 Codex 컨텍스트 적용
 - `AGENTS.md` 폴백 → 공용 에이전트 지시서 지원
-- **`CLAUDE.md` 포함 금지** — Claude 전용 hint(XML 태그, 한국어 응답 지시 등)가 Codex 로 누설되어 컨텍스트 노이즈 증가 (실측: 약 84% 노이즈 감소)
+- **`CLAUDE.md`는 fallback에 넣지 않기** — Claude 전용 hint가 Codex prompt에 섞일 수 있다. 실제 영향은 `codex debug prompt-input`으로 확인하며, 근거 없는 정량치(예: N% 감소)는 쓰지 않는다.
 
 **감지 규칙:**
 
@@ -249,7 +249,7 @@ project_doc_fallback_filenames = ["CODEX.md", "AGENTS.md"]
 |------|------|------|
 | 키 누락 | 기본값 `["AGENTS.md"]` 로 동작 → `CODEX.md` 무시됨 | AskUserQuestion 으로 추가 제안 |
 | 값 `["CODEX.md", "AGENTS.md"]` | ✅ 표준 | 변경 없음 |
-| `CLAUDE.md` 포함 | 컨텍스트 노이즈 위험 | AskUserQuestion 으로 제거 제안 |
+| `CLAUDE.md` 포함 | Codex prompt 혼입 위험 | AskUserQuestion 으로 제거 제안 |
 | 순서 불일치 (예: AGENTS 먼저) | 우선순위 의도 미반영 | AskUserQuestion 으로 교정 제안 |
 
 **비표준 감지 시 AskUserQuestion:**