@triflux/core 10.29.0 → 10.30.0

package/hooks/hook-orchestrator.mjs

@@ -441,6 +441,30 @@ async function main() {
     }
   }
 
+  // ── UserPromptSubmit: interactive 세션 liveness heartbeat ──
+  // SessionStart 가 register, 매 프롬프트가 갱신한다(사용자 활동 = liveness). 이
+  // 갱신이 없으면 hub monitor 가 5분 TTL 후 세션을 stale 로 전이시켜 `cto status`
+  // 의 live_sessions 가 항상 비어 보인다. fire-and-forget POST 는 process.exit 가
+  // 버리므로(cf. [[project_process_exit_drops_fire_and_forget]]) 발사 직후 바로
+  // drain 한다 — 아래 registry hook 이 없어 early-exit 하는 경로에서도 flush 를
+  // 보장하기 위해서다. drain 은 localhost POST 라 보통 즉시 반환되고, hub stall
+  // 시에만 짧은 상한(500ms)으로 프롬프트 지연을 막는다. keyword-detector /
+  // north-star 등 registry hook 은 그 뒤로 평소대로 실행된다.
+  if (eventName === "UserPromptSubmit") {
+    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 실패가 프롬프트 턴을 막지 않는다 */
+    }
+  }
+
   // 이벤트에 해당하는 훅 목록
   const hooks = registry.events[eventName];
   if (!hooks || hooks.length === 0) process.exit(0);

package/hooks/session-start-fast.mjs

@@ -14,6 +14,7 @@ import { execFile } from "node:child_process";
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import {
+  buildSynapseTaskSummary,
   drainPendingSynapse,
   heartbeatSynapseSession,
   registerSynapseSession,
@@ -131,6 +132,40 @@ export function registerInteractiveSession(stdinData, seams = {}) {
   }
 }
 
+/**
+ * UserPromptSubmit 마다 interactive 세션의 liveness 를 갱신한다.
+ * SessionStart 가 register, 이후 매 프롬프트가 heartbeat — 사용자 활동이 곧
+ * liveness 다. 이 갱신이 없으면 hub monitor 가 5분 TTL 후 세션을 stale 로 전이시켜
+ * `cto status` 의 live_sessions 가 항상 비어 보인다.
+ *
+ * heartbeat 는 fire-and-forget POST 이므로 호출측(hook-orchestrator)이
+ * process.exit 전에 drainPendingSynapse 로 flush 해야 drop 되지 않는다
+ * (cf. SessionStart 의 execute() 자체 drain).
+ *
+ * pid 는 register 와 동일하게 보내지 않는다(91-92 주석): liveness 는 TTL +
+ * heartbeat 가 담당한다.
+ *
+ * @param {string} stdinData UserPromptSubmit stdin JSON
+ * @param {object} [seams] 테스트용 injectable seam
+ * @param {Function} [seams.heartbeat] heartbeatSynapseSession 대체
+ * @returns {void}
+ */
+export function heartbeatInteractiveSession(stdinData, seams = {}) {
+  const heartbeat = seams.heartbeat || heartbeatSynapseSession;
+  try {
+    const payload = parseStartPayload(stdinData);
+    const sessionId = String(payload?.session_id || "").trim();
+    if (!sessionId) return;
+    const cwd = typeof payload?.cwd === "string" ? payload.cwd : process.cwd();
+    const partial = { worktreePath: cwd, host: "local" };
+    const prompt = typeof payload?.prompt === "string" ? payload.prompt : "";
+    if (prompt) partial.taskSummary = buildSynapseTaskSummary(prompt);
+    heartbeat(sessionId, partial);
+  } catch {
+    /* best-effort — never affects the prompt turn */
+  }
+}
+
 /**
  * BLOCKING 훅을 순차 실행. 하나라도 throw하면 로그만 남기고 계속.
  * @param {string} stdinData

package/hub/team/synapse-http.mjs

@@ -124,13 +124,18 @@ export function drainPendingSynapse(timeoutMs = 1000) {
   const settled = Promise.allSettled([...inFlightSynapse]);
   const ms = Number(timeoutMs);
   if (!Number.isFinite(ms) || ms <= 0) return settled;
-  return Promise.race([
-    settled,
-    new Promise((resolve) => {
-      const t = setTimeout(resolve, ms);
-      if (typeof t.unref === "function") t.unref();
-    }),
-  ]);
+  let timeout = null;
+  const timeoutPromise = new Promise((resolve) => {
+    // Keep this timer ref'ed: drainPendingSynapse() is awaited specifically
+    // to hold the process open until either in-flight POSTs settle or the
+    // bounded drain budget expires. An unref'ed timer can let Node's test
+    // runner/process exit before the Promise resolves when no other handles
+    // remain.
+    timeout = setTimeout(resolve, ms);
+  });
+  return Promise.race([settled, timeoutPromise]).finally(() => {
+    if (timeout) clearTimeout(timeout);
+  });
 }
 
 export function registerSynapseSession(meta, opts = {}) {

package/hud/constants.mjs

@@ -36,6 +36,13 @@ export const TEAM_STATE_PATH = join(
   "tfx-hub",
   "team-state.json",
 );
+export const CTO_LAKE_CURRENT_RELATIVE_PATH = join(
+  ".triflux",
+  "lake",
+  "current.md",
+);
+export const CTO_STATUS_STALE_MS = 60 * 60 * 1000; // 1시간
+export const CTO_STATUS_LINE_MAX_CHARS = 140;
 export const CONTEXT_MONITOR_CACHE_PATH = join(
   homedir(),
   ".claude",

package/hud/hud-qos-status.mjs

@@ -47,6 +47,7 @@ import {
   refreshCodexRateLimitsCache,
   scheduleCodexRateLimitRefresh,
 } from "./providers/codex.mjs";
+import { readCtoStatus } from "./providers/cto.mjs";
 // Gemini provider
 import {
   buildGeminiAuthContext,
@@ -82,6 +83,7 @@ import {
   getProviderAccountId,
   readJson,
   readStdinJson,
+  stripAnsi,
 } from "./utils.mjs";
 
 // ============================================================================
@@ -290,6 +292,19 @@ async function main() {
     ),
   ];
 
+  const ctoStatus = readCtoStatus();
+  if (ctoStatus) {
+    const rightTag =
+      CURRENT_TIER === "nano" || CURRENT_TIER === "micro"
+        ? ""
+        : stripAnsi(ctoStatus.rightTag || "").trim();
+    rows.push({
+      prefix: `${bold(claudeOrange("^"))}:`,
+      left: `${dim("cto:")}${stripAnsi(ctoStatus.line)}`,
+      right: rightTag ? dim(rightTag) : "",
+    });
+  }
+
   // tfx-multi 활성 시 팀 상태 행 추가 (v2.2)
   const teamRow = getTeamRow(CURRENT_TIER);
   if (teamRow) rows.push(teamRow);

package/hud/providers/claude.mjs

@@ -395,7 +395,7 @@ export function parseClaudeUsageResponse(response) {
   // 키 자체가 부재하면 percent=null (HUD --% placeholder), utilization=null 만 0%로 처리
   const fiveHourPresent = response.five_hour != null;
   const sevenDayPresent = response.seven_day != null;
-  const result = {
+  return {
     fiveHourPercent: fiveHourPresent
       ? clampPercent(response.five_hour.utilization ?? 0)
       : null,
@@ -405,19 +405,6 @@ export function parseClaudeUsageResponse(response) {
     fiveHourResetsAt: response.five_hour?.resets_at || null,
     weeklyResetsAt: response.seven_day?.resets_at || null,
   };
-  if (response.seven_day_sonnet != null) {
-    result.sonnetWeeklyPercent = clampPercent(
-      response.seven_day_sonnet.utilization ?? 0,
-    );
-    result.sonnetWeeklyResetsAt = response.seven_day_sonnet.resets_at || null;
-  }
-  if (response.seven_day_opus != null) {
-    result.opusWeeklyPercent = clampPercent(
-      response.seven_day_opus.utilization ?? 0,
-    );
-    result.opusWeeklyResetsAt = response.seven_day_opus.resets_at || null;
-  }
-  return result;
 }
 
 // stale 캐시의 과거 resetsAt → 다음 주기로 순환 추정 (null 대신 다음 reset 시간 계산)
@@ -438,20 +425,6 @@ export function stripStaleResets(data) {
         advanceToNextCycle(t, SEVEN_DAY_MS),
       ).toISOString();
   }
-  if (copy.sonnetWeeklyResetsAt) {
-    const t = new Date(copy.sonnetWeeklyResetsAt).getTime();
-    if (!Number.isNaN(t))
-      copy.sonnetWeeklyResetsAt = new Date(
-        advanceToNextCycle(t, SEVEN_DAY_MS),
-      ).toISOString();
-  }
-  if (copy.opusWeeklyResetsAt) {
-    const t = new Date(copy.opusWeeklyResetsAt).getTime();
-    if (!Number.isNaN(t))
-      copy.opusWeeklyResetsAt = new Date(
-        advanceToNextCycle(t, SEVEN_DAY_MS),
-      ).toISOString();
-  }
   return copy;
 }
 

package/hud/providers/cto.mjs

@@ -0,0 +1,73 @@
+import { readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import {
+  CTO_LAKE_CURRENT_RELATIVE_PATH,
+  CTO_STATUS_LINE_MAX_CHARS,
+  CTO_STATUS_STALE_MS,
+} from "../constants.mjs";
+
+function oneLine(value) {
+  return String(value || "")
+    .replace(/\x1b\[[0-9;]*m/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function capLine(line) {
+  const text = oneLine(line);
+  if (text.length <= CTO_STATUS_LINE_MAX_CHARS) return text;
+  return `${text.slice(0, CTO_STATUS_LINE_MAX_CHARS - 3)}...`;
+}
+
+function resolveCurrentPath({ currentPath, rootDir } = {}) {
+  if (currentPath) return currentPath;
+  return join(rootDir || process.cwd(), CTO_LAKE_CURRENT_RELATIVE_PATH);
+}
+
+function extractBriefVersion(lines) {
+  const versionLine = lines.find((line) => /^brief_version:\s*/i.test(line));
+  return oneLine(versionLine?.replace(/^brief_version:\s*/i, "")) || null;
+}
+
+function extractStatusLine(lines) {
+  const summaryLine = lines.find((line) => /^summary:\s*/i.test(line));
+  const summary = oneLine(summaryLine?.replace(/^summary:\s*/i, ""));
+  if (summary) return capLine(summary);
+
+  const sectionHeaders = new Set([
+    "repo_state",
+    "active_goals",
+    "swarm_shards",
+    "hub_status",
+    "recent_events",
+    "generated_at",
+    "injection_note",
+  ]);
+  const fallback = lines.find((line) => {
+    const clean = oneLine(line);
+    return (
+      clean && !/^brief_version:\s*/i.test(clean) && !sectionHeaders.has(clean)
+    );
+  });
+  return fallback ? capLine(fallback) : null;
+}
+
+export function readCtoStatus(options = {}) {
+  try {
+    const currentPath = resolveCurrentPath(options);
+    const stat = statSync(currentPath);
+    const raw = readFileSync(currentPath, "utf8");
+    const lines = raw.split(/\r?\n/u).map(oneLine).filter(Boolean);
+    const line = extractStatusLine(lines);
+    if (!line) return null;
+
+    const version = extractBriefVersion(lines);
+    const isStale = Date.now() - stat.mtimeMs > CTO_STATUS_STALE_MS;
+    return {
+      line,
+      rightTag: isStale ? "stale" : version || "cto",
+    };
+  } catch {
+    return null;
+  }
+}

package/hud/renderers.mjs

@@ -375,34 +375,6 @@ export function getClaudeRows(
       : tierDimBar(currentTier);
   const fTime = formatTimeCell(fiveHourReset);
   const wTime = formatTimeCellDH(weeklyReset);
-  const modelWeeklyPart = (label, percent, resetsAt, { includeTime }) => {
-    if (!hasData || percent == null || percent <= 0) return null;
-    const value = colorByProvider(
-      percent,
-      formatPercentCell(percent),
-      claudeOrange,
-    );
-    const reset = resetsAt
-      ? formatResetRemainingDayHour(resetsAt, SEVEN_DAY_MS)
-      : null;
-    const time = includeTime && reset ? ` ${dim(formatTimeCellDH(reset))}` : "";
-    return `${dim(`${label}:`)}${value}${time}`;
-  };
-  const modelWeeklyParts = ({ includeTime = false } = {}) =>
-    [
-      modelWeeklyPart(
-        "Sn",
-        claudeUsage?.sonnetWeeklyPercent,
-        claudeUsage?.sonnetWeeklyResetsAt,
-        { includeTime },
-      ),
-      modelWeeklyPart(
-        "Op",
-        claudeUsage?.opusWeeklyPercent,
-        claudeUsage?.opusWeeklyResetsAt,
-        { includeTime },
-      ),
-    ].filter(Boolean);
 
   if (currentTier === "nano" || currentTier === "micro") {
     const fShort =
@@ -419,18 +391,14 @@ export function getClaudeRows(
 
   if (currentTier === "minimal") {
     const staleTag = claudeUsage?.stale ? ` ${dim("[stale]")}` : "";
-    const modelSection = modelWeeklyParts();
-    const modelSuffix = modelSection.length ? ` ${modelSection.join(" ")}` : "";
-    const quotaSection = `${dim("5h:")}${fStr} ${dim("1w:")}${wStr}${modelSuffix}${staleTag}`;
+    const quotaSection = `${dim("5h:")}${fStr} ${dim("1w:")}${wStr}${staleTag}`;
     const right = `${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}`;
     return [{ prefix, left: quotaSection, right }];
   }
 
   if (currentTier === "compact") {
     const staleTag = claudeUsage?.stale ? ` ${dim("[stale]")}` : "";
-    const modelSection = modelWeeklyParts();
-    const modelSuffix = modelSection.length ? ` ${modelSection.join(" ")}` : "";
-    const quotaSection = `${dim("5h:")}${fStr} ${dim(fTime)} ${dim("1w:")}${wStr} ${dim(wTime)}${modelSuffix}${staleTag}`;
+    const quotaSection = `${dim("5h:")}${fStr} ${dim(fTime)} ${dim("1w:")}${wStr} ${dim(wTime)}${staleTag}`;
     const warning = ctxView.warningTag
       ? ` ${dim("|")} ${yellow(ctxView.warningTag)}`
       : "";
@@ -440,9 +408,7 @@ export function getClaudeRows(
 
   // full tier (>= 120 cols)
   const staleTag = claudeUsage?.stale ? ` ${dim("[stale]")}` : "";
-  const modelSection = modelWeeklyParts({ includeTime: true });
-  const modelSuffix = modelSection.length ? ` ${modelSection.join(" ")}` : "";
-  const quotaSection = `${dim("5h:")}${fBar}${fStr} ${dim(fTime)} ${dim("1w:")}${wBar}${wStr} ${dim(wTime)}${modelSuffix}${staleTag}`;
+  const quotaSection = `${dim("5h:")}${fBar}${fStr} ${dim(fTime)} ${dim("1w:")}${wBar}${wStr} ${dim(wTime)}${staleTag}`;
   const warning = ctxView.warningTag
     ? ` ${dim("|")} ${yellow(ctxView.warningTag)}`
     : "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triflux/core",
-  "version": "10.29.0",
+  "version": "10.30.0",
   "description": "triflux core — CLI routing, pipeline, adapters. Zero native dependencies.",
   "type": "module",
   "main": "hub/index.mjs",