@triflux/core 10.53.0 → 10.55.0

package/scripts/lib/tmr-install.mjs

@@ -0,0 +1,183 @@
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import {
+  chmodSync,
+  copyFileSync,
+  linkSync,
+  lstatSync,
+  mkdirSync,
+  mkdtempSync,
+  readdirSync,
+  rmSync,
+  symlinkSync,
+  writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { delimiter, join } from "node:path";
+
+// 버전과 체크섬은 이 상수 한 곳에서만 올린다. 받은 파일은 이 sha256 으로만 믿는다.
+export const TMR_RELEASE = Object.freeze({
+  version: "0.1.0",
+  asset: "tmux-rooms-cli-0.1.0-macos-arm64.zip",
+  sha256: "342b34768a6f054d6bda6d3a63de37aeae08c5304d4531eecedf9631805a282f",
+});
+const releaseBase = ({ version }) =>
+  `https://github.com/tellang/tmux-rooms/releases/download/v${version}`;
+
+export function tmrSupported(platform = process.platform, arch = process.arch) {
+  return platform === "darwin" && arch === "arm64";
+}
+
+export function tmrBinDir(home) {
+  return join(home, ".local", "bin");
+}
+
+export function findTmr({ home, env = process.env }) {
+  const dirs = [
+    tmrBinDir(home),
+    ...String(env.PATH || "").split(delimiter),
+  ].filter(Boolean);
+  // 깨진 링크도 사용자 것으로 보고 건드리지 않는다. 읽을 수 없는 PATH 항목은 건너뛴다.
+  for (const dir of dirs)
+    for (const name of ["tmuxrooms", "tmr"]) {
+      try {
+        if (lstatSync(join(dir, name), { throwIfNoEntry: false }))
+          return join(dir, name);
+      } catch {}
+    }
+  return null;
+}
+
+async function download(url, fetchFn) {
+  const response = await fetchFn(url, { signal: AbortSignal.timeout(60_000) });
+  if (!response.ok) throw new Error(`${url}: HTTP ${response.status}`);
+  return Buffer.from(await response.arrayBuffer());
+}
+
+function sha256(buffer) {
+  return createHash("sha256").update(buffer).digest("hex");
+}
+
+function extractWithDitto(zipPath, directory) {
+  execFileSync("ditto", ["-x", "-k", zipPath, directory], {
+    stdio: "ignore",
+    timeout: 30_000,
+  });
+}
+
+/** 체크섬이 맞는 tmuxrooms 를 ~/.local/bin 에 넣고 상대 링크 tmr 을 만든다. */
+export async function installTmr({
+  home,
+  release = TMR_RELEASE,
+  fetchFn = fetch,
+  extract = extractWithDitto,
+  run = execFileSync,
+  symlink = symlinkSync,
+}) {
+  const base = releaseBase(release);
+  const zip = await download(`${base}/${release.asset}`, fetchFn);
+  if (sha256(zip) !== release.sha256)
+    throw new Error("zip 체크섬이 고정값과 다르다");
+  const sums = (await download(`${base}/SHA256SUMS`, fetchFn))
+    .toString("utf8")
+    .split(/\r?\n/)
+    .map((line) => line.trim().split(/\s+/));
+  const listed = sums.find(([, name]) => name === release.asset)?.[0];
+  if (listed !== release.sha256)
+    throw new Error("SHA256SUMS 의 값이 고정값과 다르다");
+
+  const work = mkdtempSync(join(tmpdir(), "tfx-tmr-"));
+  try {
+    const zipPath = join(work, release.asset);
+    const out = join(work, "out");
+    writeFileSync(zipPath, zip);
+    mkdirSync(out);
+    extract(zipPath, out);
+    const extracted = join(out, "tmuxrooms");
+    // zip 에는 실행 파일 하나만 있어야 한다. 다른 구성이면 받은 것을 쓰지 않는다.
+    const entries = readdirSync(out);
+    if (
+      entries.length !== 1 ||
+      entries[0] !== "tmuxrooms" ||
+      !lstatSync(extracted).isFile()
+    )
+      throw new Error("zip 구성이 예상과 다르다");
+
+    const binDir = tmrBinDir(home);
+    mkdirSync(binDir, { recursive: true, mode: 0o755 });
+    const target = join(binDir, "tmuxrooms");
+    // 임시 파일은 이번 시도만 쓰는 디렉터리에 둔다. 정리할 때 남의 파일을 지우지 않는다.
+    const staging = mkdtempSync(join(binDir, ".tfx-tmr-"));
+    try {
+      const temporary = join(staging, "tmuxrooms");
+      copyFileSync(extracted, temporary);
+      chmodSync(temporary, 0o755);
+      // 묻는 사이 다른 쪽이 tmuxrooms 를 만들었으면 덮지 않고 실패한다(EEXIST).
+      linkSync(temporary, target);
+    } finally {
+      rmSync(staging, { recursive: true, force: true });
+    }
+    const link = join(binDir, "tmr");
+    // 이미 있는 tmr 은 사용자 것일 수 있어 건드리지 않는다. 링크를 못 만들어도
+    // 체크섬이 맞는 tmuxrooms 는 완전한 설치본이라 지우지 않고 안내만 남긴다.
+    let linked = false;
+    try {
+      if (!lstatSync(link, { throwIfNoEntry: false })) {
+        symlink("tmuxrooms", link);
+        linked = true;
+      }
+    } catch {}
+
+    let runs = true;
+    try {
+      run(target, ["--help"], { stdio: "ignore", timeout: 10_000 });
+    } catch {
+      runs = false;
+    }
+    return { target, link, linked, runs };
+  } finally {
+    rmSync(work, { recursive: true, force: true });
+  }
+}
+
+/** setup 동의 단계. macOS arm64 에서 tmr 이 없을 때만 묻고, 물을 수 없으면 안내만 남긴다. */
+export async function offerTmrInstall({
+  interactive,
+  ask,
+  home,
+  env = process.env,
+  platform = process.platform,
+  arch = process.arch,
+  install = installTmr,
+  log = console.log,
+  warn = console.warn,
+}) {
+  if (!tmrSupported(platform, arch)) return "not-needed";
+  if (findTmr({ home, env })) return "present";
+  if (!interactive) {
+    log("tmr 이 없다. tfx setup 에서 설치를 물을 수 있다.");
+    return "deferred";
+  }
+  if (!(await ask("tmr 을 설치할까요? (tmux 세션 목록 도구, ~/.local/bin)"))) {
+    log("tmr 설치를 건너뜀.");
+    return "declined";
+  }
+  try {
+    const { target, link, linked, runs } = await install({ home });
+    log(`tmr ${TMR_RELEASE.version} 설치: ${target}`);
+    if (!linked && !lstatSync(link, { throwIfNoEntry: false }))
+      warn(`tmr 링크를 만들지 못했다. 직접 만든다: ln -s tmuxrooms "${link}"`);
+    if (!runs) warn(`설치한 ${target} 가 실행되지 않는다.`);
+    const binDir = tmrBinDir(home);
+    if (
+      !String(env.PATH || "")
+        .split(delimiter)
+        .includes(binDir)
+    )
+      log(`${binDir} 가 PATH 에 없다. 셸 설정에 추가한다.`);
+    return "installed";
+  } catch (error) {
+    warn(`tmr 설치 실패: ${error?.message || error}`);
+    return "failed";
+  }
+}

package/hooks/agy-session-hook.mjs

@@ -1,155 +0,0 @@
-#!/usr/bin/env node
-
-import { argv, exit, stdin, stdout } from "node:process";
-import { pathToFileURL } from "node:url";
-import {
-  emitParticipantSessionStarted,
-  shouldSkipInteractiveRegistration,
-} from "../scripts/lib/session-presence.mjs";
-
-function parsePayload(stdinData) {
-  try {
-    const raw = typeof stdinData === "string" ? stdinData : "";
-    return raw.trim()
-      ? { ok: true, payload: JSON.parse(raw) }
-      : { ok: false, payload: {} };
-  } catch {
-    return { ok: false, payload: {} };
-  }
-}
-
-/**
- * Convert an Antigravity hook payload into the Codex-shaped session payload
- * consumed by the shared fast session registration helpers.
- *
- * Antigravity hook payloads use camelCase system metadata (`conversationId`,
- * `workspacePaths`) rather than Codex's `session_id`/`cwd`. The
- * `conversationId` is the stable per-conversation UUID; the first mounted
- * workspace path is the effective cwd.
- *
- * @param {Record<string, unknown> | null | undefined} payload
- * @returns {string} JSON string with `{ session_id, cwd, actor_cli }`.
- */
-export function toSessionPayload(payload) {
-  const sessionId = String(payload?.conversationId || "").trim();
-  const workspacePaths = Array.isArray(payload?.workspacePaths)
-    ? payload.workspacePaths
-    : [];
-  const cwd =
-    typeof workspacePaths[0] === "string" && workspacePaths[0]
-      ? workspacePaths[0]
-      : process.cwd();
-  return JSON.stringify({ session_id: sessionId, cwd, actor_cli: "agy" });
-}
-
-/**
- * Decide whether a PreInvocation payload should register or heartbeat.
- *
- * agy has no distinct SessionStart/UserPromptSubmit events. PreInvocation fires
- * before every model call, so per-conversation `invocationNum` gates register
- * (first call) vs heartbeat (later calls). An explicit argv mode overrides this,
- * mirroring the Codex hook.
- *
- * @param {string | null | undefined} argvMode
- * @param {Record<string, unknown> | null | undefined} payload
- * @returns {"register" | "heartbeat"}
- */
-export function normalizeMode(argvMode, payload) {
-  const direct = String(argvMode || "")
-    .trim()
-    .toLowerCase();
-  if (direct === "register" || direct === "heartbeat") return direct;
-
-  const invocationNum = Number(payload?.invocationNum);
-  if (Number.isFinite(invocationNum)) {
-    return invocationNum <= 1 ? "register" : "heartbeat";
-  }
-  // 첫 호출 정보가 없으면 시작 기록을 남긴다.
-  return "register";
-}
-
-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 runAgySessionHook(stdinData, opts = {}) {
-  const output = "{}\n";
-  const parsed = parsePayload(stdinData);
-  if (!parsed.ok) {
-    if (opts.writeStdout !== false) stdout.write(output);
-    return output;
-  }
-
-  const sessionPayload = toSessionPayload(parsed.payload);
-  const sessionId = JSON.parse(sessionPayload).session_id;
-  // No conversation id means nothing to register; stay a silent no-op.
-  if (!sessionId) {
-    if (opts.writeStdout !== false) stdout.write(output);
-    return output;
-  }
-
-  const mode = normalizeMode(opts.argvMode ?? argv[2], parsed.payload);
-  const emitSessionStarted =
-    opts.emitSessionStarted || emitParticipantSessionStarted;
-
-  try {
-    await runHookSideEffectsWithStdoutSuppressed(async () => {
-      if (
-        mode === "register" &&
-        !shouldSkipInteractiveRegistration(JSON.parse(sessionPayload), opts)
-      ) {
-        try {
-          await emitSessionStarted(sessionPayload);
-        } catch {}
-      }
-    });
-  } catch {
-    // 로컬 기록 실패가 세션을 막지 않게 한다.
-  }
-
-  if (opts.writeStdout !== false) {
-    stdout.write(output);
-  }
-  return output;
-}
-
-function readStdin() {
-  return new Promise((resolve) => {
-    let data = "";
-    stdin.setEncoding("utf8");
-    stdin.on("data", (chunk) => {
-      data += chunk;
-    });
-    stdin.on("end", () => resolve(data));
-    stdin.on("error", () => resolve(data));
-  });
-}
-
-if (argv[1] && import.meta.url === pathToFileURL(argv[1]).href) {
-  const stdinData = await readStdin();
-  await runAgySessionHook(stdinData);
-  exit(0);
-}

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

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-// ADR-0023 전환 stub. 다음 릴리스에서 지운다.
-import { readFileSync } from "node:fs";
-import { cleanupLegacyHooks } from "../scripts/lib/legacy-hook-cleanup.mjs";
-
-try {
-  readFileSync(0);
-  cleanupLegacyHooks();
-} catch {
-  // 오래된 Claude hook이 남아 있어도 세션 시작을 막지 않는다.
-}

package/hooks/hook-orchestrator.mjs

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-// ADR-0023 전환 stub. 다음 릴리스에서 지운다.
-import { readFileSync } from "node:fs";
-import { cleanupLegacyHooks } from "../scripts/lib/legacy-hook-cleanup.mjs";
-
-try {
-  readFileSync(0);
-  cleanupLegacyHooks();
-} catch {
-  // 오래된 Claude hook이 남아 있어도 세션 시작을 막지 않는다.
-}

package/hooks/lib/resolve-root.mjs

@@ -1,62 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const BREADCRUMB_PATH = join(homedir(), ".claude", "scripts", ".tfx-pkg-root");
-
-function normalizeCandidate(candidate) {
-  if (typeof candidate !== "string") return null;
-  const value = candidate.trim();
-  if (!value) return null;
-  return value;
-}
-
-function isValidPluginRoot(candidate) {
-  const root = normalizeCandidate(candidate);
-  if (!root) return false;
-  return existsSync(join(root, "hooks", "codex-session-hook.mjs"));
-}
-
-function toPluginRootFromUrl(url) {
-  if (typeof url !== "string" || !url) return null;
-  try {
-    const sourceDir = dirname(fileURLToPath(url));
-    const hookScoped = sourceDir.match(/^(.*?)[\\/]hooks(?:[\\/].*)?$/);
-    if (hookScoped?.[1]) return hookScoped[1];
-    return resolve(sourceDir, "..");
-  } catch {
-    return null;
-  }
-}
-
-function readBreadcrumbRoot() {
-  if (!existsSync(BREADCRUMB_PATH)) return null;
-  try {
-    return normalizeCandidate(readFileSync(BREADCRUMB_PATH, "utf8"));
-  } catch {
-    return null;
-  }
-}
-
-export function resolvePluginRoot(callerUrl) {
-  const breadcrumbRoot = readBreadcrumbRoot();
-  if (isValidPluginRoot(breadcrumbRoot)) return breadcrumbRoot;
-
-  const pluginRoot = normalizeCandidate(process.env.PLUGIN_ROOT);
-  if (isValidPluginRoot(pluginRoot)) return pluginRoot;
-
-  const envRoot = normalizeCandidate(process.env.CLAUDE_PLUGIN_ROOT);
-  if (isValidPluginRoot(envRoot)) return envRoot;
-
-  const callerFallback = toPluginRootFromUrl(callerUrl);
-  if (isValidPluginRoot(callerFallback)) return callerFallback;
-
-  const moduleFallback = toPluginRootFromUrl(import.meta.url) || process.cwd();
-  process.stderr.write(
-    `[resolve-root] warning: failed to resolve plugin root from breadcrumb/env/caller; fallback=${moduleFallback}\n`,
-  );
-  return moduleFallback;
-}
-
-export const PLUGIN_ROOT = resolvePluginRoot(import.meta.url);

package/hub/codex-adapter.mjs

@@ -1,193 +0,0 @@
-import { mkdirSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { codexProfileConfigOverrides } from "../scripts/lib/codex-profile-config.mjs";
-import {
-  buildExecCommand,
-  executeWithAttempts,
-  normalizePathForShell,
-  runProcess,
-  shellQuote,
-} from "./cli-adapter-base.mjs";
-import { runPreflight } from "./codex-preflight.mjs";
-import { isActivityLifecycleEnabled } from "./lib/worker-lifecycle.mjs";
-
-// ── Codex-specific stall inference ──────────────────────────────
-
-function inferStallMode(stdout, stderr) {
-  const text = `${stdout}\n${stderr}`.toLowerCase();
-  if (
-    /(rate.?limit|quota|throttl|too.many.requests|429|usage.limit)/u.test(text)
-  )
-    return "rate_limited";
-  if (/(approval|approve|permission|sandbox|bypass)/u.test(text))
-    return "approval_stall";
-  if (
-    /\bmcp\b|context7|playwright|tavily|exa|brave|sequential|server/u.test(text)
-  )
-    return "mcp_stall";
-  return "timeout";
-}
-
-// ── Codex command building ──────────────────────────────────────
-
-function commandWithOverrides(command, prompt, codexPath, overrides = []) {
-  const next = codexPath
-    ? command.replace(/^codex\b/u, shellQuote(codexPath))
-    : command;
-  if (!overrides.length) return next;
-  const promptArg = JSON.stringify(prompt);
-  const flags = overrides
-    .flatMap((value) => ["-c", shellQuote(value)])
-    .join(" ");
-  return next.endsWith(promptArg)
-    ? `${next.slice(0, -promptArg.length)}${flags} ${promptArg}`
-    : `${next} ${flags}`;
-}
-
-function buildOverrides(requested, excluded) {
-  return [
-    ...new Set(
-      (requested || []).filter((name) => (excluded || []).includes(name)),
-    ),
-  ].map((name) => `mcp_servers.${name}.enabled=false`);
-}
-
-function buildAttempts(opts, preflight) {
-  const timeout = Number.isFinite(opts.timeout) ? opts.timeout : 300_000;
-  const requested = Array.isArray(opts.mcpServers) ? [...opts.mcpServers] : [];
-  const base = {
-    timeout,
-    profile: opts.profile,
-    requested,
-    excluded: [...(preflight.excludeMcpServers || [])],
-    forceBypass: preflight.needsBypass,
-  };
-  if (opts.retryOnFail === false) return [base];
-  const retryTimeout = isActivityLifecycleEnabled() ? timeout : timeout * 2;
-  return [
-    base,
-    { ...base, timeout: retryTimeout, excluded: requested, forceBypass: true },
-  ];
-}
-
-// ── Launch script ───────────────────────────────────────────────
-
-function createLaunchScriptText(opts) {
-  const parts = [
-    "codex",
-    "exec",
-    "--dangerously-bypass-approvals-and-sandbox",
-    "--skip-git-repo-check",
-  ];
-  // Select the effort profile via `-c` config overrides instead of
-  // `--profile <name>` (see buildExecCommand): codex 0.134+ rejects `--profile
-  // X` whenever config.toml still contains an inline [profiles.X] table.
-  if (opts.profile) {
-    for (const override of codexProfileConfigOverrides(opts.profile)) {
-      parts.push("-c", shellQuote(override));
-    }
-  }
-  parts.push('$(cat "$PROMPT_FILE")');
-  return [
-    "#!/usr/bin/env bash",
-    "set -euo pipefail",
-    `cd ${shellQuote(normalizePathForShell(opts.workdir))}`,
-    `PROMPT_FILE=${shellQuote(normalizePathForShell(opts.promptFile))}`,
-    `TFX_CODEX_TIMEOUT_MS=${shellQuote(String(opts.timeout ?? ""))}`,
-    parts.join(" "),
-    "",
-  ].join("\n");
-}
-
-export function buildLaunchScript(opts = {}) {
-  const dir = join(tmpdir(), "triflux-codex-launch");
-  mkdirSync(dir, { recursive: true });
-  const path = join(dir, `${String(opts.id || "launch")}.sh`);
-  writeFileSync(path, createLaunchScriptText(opts), "utf8");
-  return path;
-}
-
-// ── Exec args builder ───────────────────────────────────────────
-
-// CTO boundary: this adapter assembles Codex prompts outside
-// scripts/tfx-route.sh. Keep north-star injection in tfx-route.sh until
-// launcher workdir contracts have focused coverage.
-export function buildExecArgs(opts = {}) {
-  const prompt = typeof opts.prompt === "string" ? opts.prompt : "";
-  const command = buildExecCommand(prompt, opts.resultFile || null, {
-    profile: opts.profile,
-    codexHome: opts.codexHome,
-    disallowUltra: opts.disallowUltra,
-    enforceCanonicalProfile: opts.enforceCanonicalProfile,
-    skipGitRepoCheck: true,
-    sandboxBypass: true,
-    cwd: opts.cwd,
-    // stdinPrompt 가 명시되면 buildExecCommand 로 forward.
-    // headless 워커 spawn (backend.mjs) 은 default (stdin on, macOS hook fix).
-    stdinPrompt: opts.stdinPrompt,
-  });
-
-  if (!prompt) return command.replace(/\s+""$/u, "");
-
-  let result;
-  const quotedPrompt = JSON.stringify(prompt);
-  // PowerShell: (Get-Content -Raw '...'), bash: "$(cat '...')"
-  if (
-    (/^\(Get-Content\b[\s\S]*\)$/u.test(prompt) ||
-      /^"\$\(cat\b[\s\S]*\)"$/u.test(prompt)) &&
-    command.endsWith(quotedPrompt)
-  ) {
-    result = `${command.slice(0, -quotedPrompt.length)}${prompt}`;
-  } else {
-    result = command;
-  }
-
-  // stderr 캡처: codex 실패 시에도 원인 추적 가능 (resultFile.err)
-  if (opts.resultFile) {
-    result += ` 2>'${opts.resultFile}.err'`;
-  }
-  return result;
-}
-
-// ── Codex execution ─────────────────────────────────────────────
-
-async function runCodex(prompt, workdir, preflight, attempt) {
-  const dir = join(tmpdir(), "triflux-codex-exec");
-  mkdirSync(dir, { recursive: true });
-  const resultFile = join(
-    dir,
-    `codex-${Date.now()}-${Math.random().toString(36).slice(2)}.txt`,
-  );
-  const command = commandWithOverrides(
-    buildExecCommand(prompt, resultFile, {
-      profile: attempt.profile,
-      skipGitRepoCheck: true,
-      sandboxBypass: attempt.forceBypass,
-    }),
-    prompt,
-    preflight.codexPath,
-    buildOverrides(attempt.requested, attempt.excluded),
-  );
-  return runProcess(command, workdir, attempt.timeout, {
-    resultFile,
-    inferStallMode,
-    cli: "codex",
-  });
-}
-
-// ── Public API ──────────────────────────────────────────────────
-
-export function execute(opts = {}) {
-  return executeWithAttempts({
-    runFn: runCodex,
-    preflightFn: (o) =>
-      runPreflight({
-        mcpServers: o.mcpServers,
-        subcommand: "exec",
-        workdir: o.workdir,
-      }),
-    buildAttemptsFn: buildAttempts,
-    opts,
-  });
-}