@triflux/remote 10.50.2 → 10.52.0

package/scripts/lib/handoff.mjs

@@ -1,187 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import { basename, resolve } from "node:path";
-import { findAllClaudeMdPaths } from "./claudemd-scanner.mjs";
-
-function runCommand(command, cwd, executor = execSync) {
-  try {
-    const output = executor(command, {
-      cwd,
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      windowsHide: true,
-    });
-    return String(output || "").trimEnd();
-  } catch {
-    return "";
-  }
-}
-
-function parseStatusLines(statusText) {
-  const lines = String(statusText || "")
-    .split(/\r?\n/u)
-    .filter(Boolean);
-  const changedFiles = [];
-  const status = [];
-
-  for (const line of lines) {
-    const normalized = line.trimEnd();
-    if (!normalized) continue;
-
-    const rawStatus = normalized.slice(0, 2).trim() || "??";
-    const rawPath = normalized.slice(3).trim();
-    const filePath = rawPath.includes(" -> ")
-      ? rawPath.split(" -> ").at(-1)?.trim()
-      : rawPath;
-    if (!filePath) continue;
-
-    changedFiles.push(filePath);
-    status.push({ path: filePath, status: rawStatus });
-  }
-
-  return {
-    changedFiles: Array.from(new Set(changedFiles)),
-    status,
-  };
-}
-
-function normalizeDecisionLine(line) {
-  return String(line || "")
-    .trim()
-    .replace(/^[-*]\s+/u, "")
-    .trim();
-}
-
-function parseDecisionFile(decisionFile) {
-  if (!decisionFile) return [];
-  const absolute = resolve(decisionFile);
-  if (!existsSync(absolute)) return [];
-
-  const raw = readFileSync(absolute, "utf8");
-  return raw
-    .split(/\r?\n/u)
-    .map(normalizeDecisionLine)
-    .filter((line) => line.length > 0);
-}
-
-function normalizeDecisions(decisions, decisionFile) {
-  const merged = [
-    ...(Array.isArray(decisions) ? decisions : []),
-    ...parseDecisionFile(decisionFile),
-  ]
-    .map(normalizeDecisionLine)
-    .filter(Boolean);
-
-  return Array.from(new Set(merged));
-}
-
-function formatAheadBehind(value) {
-  if (!value) return null;
-  const [behindRaw, aheadRaw] = value.split(/\s+/u);
-  const behind = Number.parseInt(behindRaw, 10);
-  const ahead = Number.parseInt(aheadRaw, 10);
-  if (!Number.isFinite(behind) || !Number.isFinite(ahead)) return null;
-  return { ahead, behind };
-}
-
-export function collectHandoffContext(options = {}) {
-  const cwd = resolve(options.cwd || process.cwd());
-  const executor =
-    typeof options.commandRunner === "function"
-      ? options.commandRunner
-      : execSync;
-  const target = options.target === "local" ? "local" : "remote";
-  const decisions = normalizeDecisions(options.decisions, options.decisionFile);
-  const generatedAt = options.generatedAt || new Date().toISOString();
-  const claudeMdPaths = Array.isArray(options.claudeMdPaths)
-    ? options.claudeMdPaths
-    : findAllClaudeMdPaths({
-        cwd,
-        homeDir: options.homeDir,
-      });
-
-  const gitRoot = runCommand("git rev-parse --show-toplevel", cwd, executor);
-  const branch =
-    runCommand("git rev-parse --abbrev-ref HEAD", cwd, executor) || null;
-  const shortStatus = runCommand("git status --short", cwd, executor);
-  const diffStat = runCommand("git diff --stat --no-color", cwd, executor);
-  const upstreamRaw = runCommand(
-    "git rev-list --left-right --count @{upstream}...HEAD",
-    cwd,
-    executor,
-  );
-  const parsedStatus = parseStatusLines(shortStatus);
-
-  return {
-    generatedAt,
-    target,
-    cwd,
-    gitRoot: gitRoot || null,
-    repository: gitRoot ? basename(gitRoot) : basename(cwd),
-    branch,
-    upstream: formatAheadBehind(upstreamRaw),
-    changedFiles: parsedStatus.changedFiles,
-    fileStatus: parsedStatus.status,
-    diffStat,
-    decisions,
-    claudeMdPaths,
-  };
-}
-
-export function buildHandoffPrompt(context) {
-  const safeContext = context || collectHandoffContext();
-  const branch = safeContext.branch || "unknown";
-  const upstream = safeContext.upstream
-    ? `ahead ${safeContext.upstream.ahead}, behind ${safeContext.upstream.behind}`
-    : "unknown";
-  const changedFiles =
-    safeContext.changedFiles.length > 0
-      ? safeContext.changedFiles.map((file) => `- ${file}`).join("\n")
-      : "- 변경 파일 없음";
-  const decisions =
-    safeContext.decisions.length > 0
-      ? safeContext.decisions.map((decision) => `- ${decision}`).join("\n")
-      : "- 명시된 결정사항 없음";
-  const claudeMdList =
-    Array.isArray(safeContext.claudeMdPaths) &&
-    safeContext.claudeMdPaths.length > 0
-      ? safeContext.claudeMdPaths.map((path) => `- ${path}`).join("\n")
-      : "- 자동 탐지된 CLAUDE.md 없음";
-  const diffStat = safeContext.diffStat || "(diff stat 없음)";
-
-  return [
-    "## TFX Remote Handoff",
-    `- generated_at: ${safeContext.generatedAt}`,
-    `- target: ${safeContext.target}`,
-    `- repository: ${safeContext.repository}`,
-    `- branch: ${branch} (${upstream})`,
-    `- cwd: ${safeContext.cwd}`,
-    "",
-    "### 변경 파일",
-    changedFiles,
-    "",
-    "### 변경 요약 (git diff --stat)",
-    "```",
-    diffStat,
-    "```",
-    "",
-    "### 결정사항",
-    decisions,
-    "",
-    "### CLAUDE.md 참조",
-    claudeMdList,
-    "",
-    "### 다음 세션 지시",
-    "- 위 변경사항을 먼저 검토하고 누락된 테스트를 확인하세요.",
-    "- 필요 시 CLAUDE.md 지침을 재확인한 뒤 작업을 이어가세요.",
-    "- 작업 완료 후 변경 파일과 검증 결과를 요약하세요.",
-  ].join("\n");
-}
-
-export function serializeHandoff(options = {}) {
-  const context = collectHandoffContext(options);
-  return {
-    ...context,
-    prompt: buildHandoffPrompt(context),
-  };
-}

package/scripts/lib/logger.mjs

@@ -1,122 +0,0 @@
-/**
- * Logify — triflux 구조화 로깅 설정
- *
- * 사용법:
- *   import { logger, createModuleLogger } from './lib/logger.mjs';
- *
- *   // 기본 로거
- *   logger.info({ taskId: 'abc' }, 'task.started');
- *
- *   // 모듈별 로거
- *   const log = createModuleLogger('hub');
- *   log.info({ port: 27888 }, 'server.started');
- *   log.error({ err }, 'server.error');
- *
- * 이벤트 네이밍: {도메인}.{액션} 형식
- *   hub.started, hub.stopped, route.started, route.completed,
- *   worker.spawned, worker.completed, worker.timeout,
- *   mcp.connected, mcp.disconnected, mcp.error,
- *   team.created, team.deleted, task.claimed, task.completed,
- *   pipe.connected, pipe.message, pipe.error,
- *   http.request, http.response, http.error
- *
- * 로그 레벨 가이드:
- *   debug  — 개발/트러블슈팅용 (변수 값, MCP 메시지, 캐시 키)
- *   info   — 정상 흐름 상태 변경 (서버 시작, 워커 완료, 팀 생성)
- *   warn   — 위험 신호 (재시도 발생, 쿼타 임박, 느린 워커)
- *   error  — 작업 실패 (CLI 실행 실패, MCP 연결 끊김)
- *   fatal  — 프로세스 위협 (DB 연결 불가, 포트 충돌)
- */
-import pino from "pino";
-
-const isDev = process.env.NODE_ENV !== "production";
-
-// 로그는 항상 stderr(fd 2)로 보낸다.
-//
-// Claude Code 훅은 stdout 을 훅의 JSON 페이로드로 파싱한다. 로그가 stdout 으로
-// 나가면 페이로드와 한 스트림에 섞여, 훅이 돌려준 hookSpecificOutput 이 JSON 으로
-// 해석되지 않고 그냥 본문 텍스트가 된다. Claude Code 2.1.257 부터는 stdout 이
-// "{" 로 시작하는데 유효한 JSON 이 아니면 훅 오류로 보고하므로, 로그가 먼저 나가느냐
-// 페이로드가 먼저 나가느냐에 따라 훅 전체가 실패로 뒤집힌다.
-//
-// stderr 로 보내면 Claude Code 가 verbose/transcript 에서 그대로 보여주고 stdout 은
-// 페이로드만 남는다. CLI 관례상으로도 구조화 로그는 stderr 가 맞다.
-const LOG_FD = 2;
-
-export const logger = pino(
-  {
-    level: process.env.LOG_LEVEL || (isDev ? "debug" : "info"),
-
-    // 모든 로그에 포함되는 기본 필드
-    base: {
-      service: process.env.SERVICE_NAME || "triflux",
-      env: process.env.NODE_ENV || "development",
-    },
-
-    // 레벨을 대문자로 출력 (AI 파싱 용이)
-    formatters: {
-      level: (label) => ({ level: label.toUpperCase() }),
-    },
-
-    // ISO 8601 타임스탬프
-    timestamp: pino.stdTimeFunctions.isoTime,
-
-    // 민감정보 자동 필터링
-    redact: {
-      paths: [
-        "password",
-        "token",
-        "apiKey",
-        "secret",
-        "authorization",
-        "*.password",
-        "*.token",
-        "*.apiKey",
-        "*.secret",
-        "req.headers.authorization",
-        "req.headers.cookie",
-        "hubToken",
-      ],
-      remove: true,
-    },
-
-    // 개발 환경: 컬러 콘솔 출력 (stderr)
-    transport: isDev
-      ? {
-          target: "pino-pretty",
-          options: {
-            colorize: true,
-            translateTime: "yyyy-mm-dd HH:MM:ss",
-            ignore: "pid,hostname",
-            destination: LOG_FD,
-          },
-        }
-      : undefined,
-  },
-  // 운영 환경(transport 미사용)에서도 stdout 이 아니라 stderr 로 쓴다.
-  isDev ? undefined : pino.destination({ dest: LOG_FD, sync: false }),
-);
-
-/**
- * 모듈별 Child Logger 생성.
- * 모듈 이름이 모든 로그에 자동 포함된다.
- *
- * @param {string} module — 모듈 이름 (hub, route, worker, mcp, team 등)
- * @returns {import('pino').Logger}
- */
-export function createModuleLogger(module) {
-  return logger.child({ module });
-}
-
-// 정상 종료 시 버퍼 flush 보장
-process.on("uncaughtException", (err) => {
-  logger.fatal({ err }, "process.uncaught_exception");
-  logger.flush();
-  process.exit(1);
-});
-
-process.on("unhandledRejection", (reason) => {
-  logger.fatal({ reason: String(reason) }, "process.unhandled_rejection");
-  logger.flush();
-  process.exit(1);
-});

package/scripts/lib/stealth-fetch.mjs

@@ -1,176 +0,0 @@
-#!/usr/bin/env node
-// SSRF boundary: stealthFetch only accepts http: and https: URLs. It does not
-// guard private IPs, metadata hosts such as 169.254.x.x, or localhost; callers
-// must treat the URL as already inside their trust boundary.
-
-import { pathToFileURL } from "node:url";
-
-export class CloakBrowserUnavailableError extends Error {}
-
-const DEFAULT_TIMEOUT_MS = 30_000;
-const DEFAULT_WAIT_UNTIL = "load";
-const SUPPORTED_PLATFORMS = new Set([
-  "linux:x64",
-  "linux:arm64",
-  "darwin:x64",
-  "darwin:arm64",
-  "win32:x64",
-]);
-const EXIT_CODES = {
-  not_installed: 3,
-  unsupported_platform: 4,
-  runtime_error: 5,
-  blocked_scheme: 6,
-};
-
-function isSupportedPlatform(platform, arch) {
-  return SUPPORTED_PLATFORMS.has(`${platform}:${arch}`);
-}
-
-function isModuleNotFound(error) {
-  return (
-    error?.code === "ERR_MODULE_NOT_FOUND" || error?.code === "MODULE_NOT_FOUND"
-  );
-}
-
-function htmlToText(html) {
-  return String(html || "")
-    .replace(/<script\b[^>]*>[\s\S]*?<\/script>/giu, " ")
-    .replace(/<style\b[^>]*>[\s\S]*?<\/style>/giu, " ")
-    .replace(/<[^>]+>/gu, " ")
-    .replace(/&nbsp;/giu, " ")
-    .replace(/&amp;/giu, "&")
-    .replace(/&lt;/giu, "<")
-    .replace(/&gt;/giu, ">")
-    .replace(/&quot;/giu, '"')
-    .replace(/&#39;/gu, "'")
-    .replace(/\s+/gu, " ")
-    .trim();
-}
-
-function responseStatus(response) {
-  if (!response) return null;
-  if (typeof response.status === "function") return response.status();
-  return response.status ?? null;
-}
-
-function responseUrl(response, fallbackUrl) {
-  if (!response) return fallbackUrl;
-  if (typeof response.url === "function") return response.url();
-  return response.url ?? fallbackUrl;
-}
-
-function parseAllowedFetchUrl(url) {
-  let parsed;
-  try {
-    parsed = new URL(url);
-  } catch {
-    return { ok: false, scheme: null };
-  }
-  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    return { ok: false, scheme: parsed.protocol };
-  }
-  return { ok: true, href: parsed.href };
-}
-
-async function closeBrowser(browser) {
-  if (!browser || typeof browser.close !== "function") return;
-  try {
-    await browser.close();
-  } catch {
-    // best effort: fetch callers only need the primary result signal
-  }
-}
-
-export async function stealthFetch(url, opts = {}) {
-  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  const waitUntil = opts.waitUntil ?? DEFAULT_WAIT_UNTIL;
-  const loadCloakBrowser = opts._import ?? (() => import("cloakbrowser"));
-  const platform = opts._platform ?? process.platform;
-  const arch = opts._arch ?? process.arch;
-
-  if (!isSupportedPlatform(platform, arch)) {
-    return {
-      ok: false,
-      reason: "unsupported_platform",
-      platform,
-      arch,
-    };
-  }
-
-  const parsedUrl = parseAllowedFetchUrl(url);
-  if (!parsedUrl.ok) {
-    return {
-      ok: false,
-      reason: "blocked_scheme",
-      scheme: parsedUrl.scheme,
-    };
-  }
-
-  let cloakbrowser;
-  try {
-    cloakbrowser = await loadCloakBrowser();
-  } catch (error) {
-    if (isModuleNotFound(error)) return { ok: false, reason: "not_installed" };
-    return { ok: false, reason: "runtime_error", error: String(error) };
-  }
-
-  let browser;
-  try {
-    const launch = cloakbrowser?.launch;
-    if (typeof launch !== "function") {
-      throw new CloakBrowserUnavailableError("cloakbrowser launch unavailable");
-    }
-    browser = await launch();
-    const page = await browser.newPage();
-    const response = await page.goto(parsedUrl.href, {
-      waitUntil,
-      timeout: timeoutMs,
-    });
-    const html = await page.content();
-    return {
-      ok: true,
-      engine: "cloakbrowser",
-      url: parsedUrl.href,
-      finalUrl: responseUrl(response, parsedUrl.href),
-      status: responseStatus(response),
-      html,
-      text: htmlToText(html),
-    };
-  } catch (error) {
-    return { ok: false, reason: "runtime_error", error: String(error) };
-  } finally {
-    await closeBrowser(browser);
-  }
-}
-
-export function exitCodeFor(result) {
-  return EXIT_CODES[result?.reason] ?? 5;
-}
-
-export async function main(argv = process.argv) {
-  const url = argv[2];
-  if (!url) {
-    console.error("usage: stealth-fetch <url>");
-    process.exitCode = 2;
-    return;
-  }
-
-  const result = await stealthFetch(url);
-  if (result.ok) {
-    console.log(JSON.stringify(result));
-    process.exitCode = 0;
-    return;
-  }
-
-  console.error(`[stealth-fetch] 폴백: ${result.reason}`);
-  console.log(JSON.stringify(result));
-  process.exitCode = exitCodeFor(result);
-}
-
-if (
-  process.argv[1] &&
-  import.meta.url === pathToFileURL(process.argv[1]).href
-) {
-  await main();
-}