@triflux/remote 10.35.1 → 10.35.3

package/cto/collect.mjs

@@ -17,6 +17,7 @@ import { basename, dirname, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { renderBrief } from "./brief.mjs";
+import { resolveLakeRootDir } from "./lake-root.mjs";
 
 const SCHEMA_VERSION = "cto-lake.v1";
 const SOURCE_REGISTRY = [
@@ -785,7 +786,7 @@ function hasFlag(args, flag) {
 }
 
 export async function runCollect(args = [], opts = {}) {
-  const rootDir = opts.rootDir || process.cwd();
+  const rootDir = opts.rootDir || resolveLakeRootDir(process.cwd());
   const lakeRoot = opts.lakeRoot || join(rootDir, ".triflux", "lake");
   const stdout = opts.stdout || process.stdout;
   const stderr = opts.stderr || process.stderr;

package/cto/lake-root.mjs

@@ -0,0 +1,44 @@
+// cto/lake-root.mjs - resolve the git repo toplevel for the CTO lake.
+//
+// CTO lake (.triflux/lake/current.json) 는 repo 루트에 하나만 둔다. 그런데
+// runStatus/runCollect/runDashboard 는 process.cwd() 를 기본 rootDir 로 쓰므로,
+// repo 루트가 아닌 하위 폴더(예: packages/triflux)에서 `tfx cto` 를 부르면 lake
+// 를 못 찾아 "run tfx cto collect" 가 반복되고, collect 는 엉뚱한 하위 폴더에
+// 새 .triflux/lake 를 만든다. cwd 에서 `.git` 마커를 위로 탐색해 toplevel 로
+// 올려 이 불일치를 없앤다.
+//
+// git worktree 는 자체 `.git` 파일을 가지므로 worktree 루트에서 멈춘다 — lake
+// 격리(워크트리별 collect)가 그대로 유지된다. `.git` 을 못 찾으면 cwd 를 그대로
+// 반환해 기존 동작을 보존한다.
+
+import { existsSync as defaultExistsSync } from "node:fs";
+import { dirname, join, parse } from "node:path";
+
+const MAX_DEPTH = 64;
+
+/**
+ * cwd 에서 가장 가까운 git toplevel(`.git` 디렉토리 또는 파일이 있는 폴더)을
+ * 찾아 반환한다. 못 찾으면 cwd 를 그대로 돌려준다(기존 동작 보존).
+ *
+ * @param {string} cwd 시작 디렉토리(보통 process.cwd())
+ * @param {object} [opts]
+ * @param {(path: string) => boolean} [opts.existsSync] 테스트용 주입 seam
+ * @returns {string}
+ */
+export function resolveLakeRootDir(cwd, opts = {}) {
+  const exists = opts?.existsSync || defaultExistsSync;
+  // 비문자열(객체/숫자 등 truthy 포함) 또는 빈 문자열이면 항상 "" 를 반환해
+  // @returns {string} 계약을 지킨다 — truthy 비문자열을 그대로 누설하지 않는다.
+  if (typeof cwd !== "string" || !cwd) return "";
+
+  let dir = cwd;
+  const { root } = parse(dir);
+  for (let depth = 0; depth < MAX_DEPTH; depth++) {
+    if (exists(join(dir, ".git"))) return dir;
+    if (dir === root) break;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return cwd;
+}

package/cto/status.mjs

@@ -2,6 +2,8 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
+import { resolveLakeRootDir } from "./lake-root.mjs";
+
 const SCHEMA_VERSION = "cto-lake.v1";
 const SYNAPSE_TIMEOUT_MS = 1500;
 
@@ -304,7 +306,7 @@ function renderHumanStatus(status) {
 }
 
 export async function runStatus(args = [], opts = {}) {
-  const rootDir = opts.rootDir || process.cwd();
+  const rootDir = opts.rootDir || resolveLakeRootDir(process.cwd());
   const lakeRoot = opts.lakeRoot || join(rootDir, ".triflux", "lake");
   const stdout = opts.stdout || process.stdout;
   const jsonOut = opts.json === true || hasFlag(args, "--json");

package/hub/mac-tray.swift

@@ -47,6 +47,8 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSPopoverDelegate {
 class WebViewController: NSViewController, WKNavigationDelegate, WKScriptMessageHandler {
     var webView: WKWebView!
     var port: String = "27888"
+    let canonicalPort = "27888"
+    var consecutiveFailures = 0
     var retryWorkItem: DispatchWorkItem?
     var onFocusComplete: (() -> Void)?
 
@@ -101,6 +103,14 @@ class WebViewController: NSViewController, WKNavigationDelegate, WKScriptMessage
 
     func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
         logError("Failed to load: \(error.localizedDescription)")
+        consecutiveFailures += 1
+        if consecutiveFailures >= 3 && port != canonicalPort {
+            port = canonicalPort
+            consecutiveFailures = 0
+            logError("Switching to canonical port \(canonicalPort) after repeated failures")
+            loadTray()
+            return
+        }
         let retry = DispatchWorkItem { [weak self] in
             self?.loadTray()
         }
@@ -111,6 +121,7 @@ class WebViewController: NSViewController, WKNavigationDelegate, WKScriptMessage
     func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
         retryWorkItem?.cancel()
         retryWorkItem = nil
+        consecutiveFailures = 0
         logError("Successfully loaded URL")
     }
 

package/hub/team/cto-auto-collect.mjs

@@ -1,6 +1,8 @@
 import { existsSync, statSync } from "node:fs";
 import { join } from "node:path";
 
+import { resolveLakeRootDir } from "../../cto/lake-root.mjs";
+
 const DEFAULT_DEBOUNCE_MS = 120_000;
 const OFF_VALUES = new Set(["0", "false", "off", "no"]);
 
@@ -45,7 +47,7 @@ export function createCtoAutoCollector(opts = {}) {
     const cwd = typeof session?.cwd === "string" ? session.cwd : "";
     const worktree =
       typeof session?.worktreePath === "string" ? session.worktreePath : "";
-    const projectRoot = worktree || cwd;
+    const projectRoot = resolveLakeRootDir(worktree || cwd);
     if (!projectRoot)
       return { triggered: false, reason: "missing-project-root" };
 
@@ -61,11 +63,19 @@ export function createCtoAutoCollector(opts = {}) {
         { sessionId, err: String(error?.message || error) },
         "cto.auto_collect.query_failed",
       );
-      return { triggered: false, reason: "query-failed" };
-    }
-    if (!Array.isArray(peers) || peers.length < 1) {
-      return { triggered: false, reason: "no-peers" };
+      // peer 조회 실패는 collect 를 막지 않는다 — peer 정보는 이제 라벨 용도뿐이라
+      // registry 일시 장애에도 solo 로 진행해 collect 회복력을 유지한다.
+      peers = [];
     }
+    // 단일 세션(peer 0개)도 허용한다 — 사용자 선택. peer 유무와 무관하게
+    // 아래 debounce + fresh-lake 게이트가 collect 빈도를 제어한다.
+    //
+    // 주의: peerCount 는 best-effort 라벨이다. querySessions 는 raw
+    // cwd/worktreePath 로 매칭하지만 projectRoot 는 resolved git toplevel 이라,
+    // 같은 repo 의 다른 하위 폴더 세션은 peer 로 안 잡혀 triggered-solo 로 보고될
+    // 수 있다. 즉 라벨은 repo-scoped 가 아니라 exact-cwd-scoped 다 — 향후 peer
+    // 기반 로직을 이 라벨 위에 다시 올릴 때 주의한다.
+    const peerCount = Array.isArray(peers) ? peers.length : 0;
 
     const currentTime = now();
     const last = lastCollectMs.get(projectRoot) || 0;
@@ -92,9 +102,9 @@ export function createCtoAutoCollector(opts = {}) {
     inFlight.add(promise);
     return {
       triggered: true,
-      reason: "triggered",
+      reason: peerCount > 0 ? "triggered" : "triggered-solo",
       projectRoot,
-      peerCount: peers.length,
+      peerCount,
     };
   }
 

package/hub/tray.mjs

@@ -9,12 +9,26 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { resolveHubPortForContext } from "./hub-lifecycle.mjs";
 import { IS_MAC, IS_WINDOWS } from "@triflux/core/hub/platform.mjs";
 import { ensureHubForTray } from "./tray-lifecycle.mjs";
 
 const HUB_PID_FILE = join(homedir(), ".claude", "cache", "tfx-hub", "hub.pid");
 const DEFAULT_HUB_PORT = "27888";
 
+export function resolveTrayHubPort({
+  env = process.env,
+  cwd = process.cwd(),
+} = {}) {
+  return String(
+    resolveHubPortForContext({
+      env,
+      cwd,
+      defaultPort: Number(DEFAULT_HUB_PORT),
+    }),
+  );
+}
+
 function sleep(ms) {
   return new Promise((resolveSleep) => setTimeout(resolveSleep, ms));
 }
@@ -416,7 +430,7 @@ async function shutdown(reason = "shutdown") {
 export async function startTray() {
   if (IS_MAC) {
     const trayScript = fileURLToPath(import.meta.url);
-    const port = process.env.TFX_HUB_PORT || DEFAULT_HUB_PORT;
+    const port = resolveTrayHubPort();
     const serverPath = join(dirname(trayScript), "server.mjs");
     await ensureHubForTray({ port, serverPath });
     const reaped = reapExistingMacTrayProcesses({ scriptPath: trayScript });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triflux/remote",
-  "version": "10.35.1",
+  "version": "10.35.3",
   "description": "triflux remote — team mode, psmux, MCP workers, SQLite store.",
   "type": "module",
   "main": "hub/index.mjs",