triflux 10.0.0 → 10.0.2

package/scripts/pack.mjs

@@ -0,0 +1,295 @@
+#!/usr/bin/env node
+// scripts/pack.mjs — 패키지 조립 스크립트
+// 소스 파일을 packages/*/에 복사하여 npm publish 준비.
+//
+// Usage: node scripts/pack.mjs [core|remote|triflux|all]
+
+import { cpSync, existsSync, mkdirSync, rmSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { join, dirname, relative, normalize } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
+
+// ── 파일 매핑: 패키지별로 어떤 소스 파일이 포함되는지 ──────────
+
+const CORE_FILES = [
+  // hub root — core modules
+  'hub/cli-adapter-base.mjs',
+  'hub/codex-adapter.mjs',
+  'hub/codex-compat.mjs',
+  'hub/codex-preflight.mjs',
+  'hub/gemini-adapter.mjs',
+  'hub/team-bridge.mjs',
+  'hub/paths.mjs',
+  'hub/platform.mjs',
+  'hub/state.mjs',
+  'hub/intent.mjs',
+  'hub/token-mode.mjs',
+  'hub/router.mjs',
+  'hub/hitl.mjs',
+  'hub/assign-callbacks.mjs',
+  'hub/fullcycle.mjs',
+  'hub/bridge.mjs',
+  'hub/reflexion.mjs',
+  'hub/research.mjs',
+  'hub/session-fingerprint.mjs',
+  // Neural Memory (Lake 2 Phase 1)
+  'hub/adaptive.mjs',
+  'hub/adaptive-diagnostic.mjs',
+  'hub/adaptive-inject.mjs',
+  'hub/adaptive-memory.mjs',
+  'hub/memory-doctor.mjs',
+  'hub/account-broker.mjs',
+];
+
+const CORE_DIRS = [
+  'hub/pipeline',
+  'hub/routing',
+  'hub/quality',
+  'hub/delegator',
+  'hub/lib',
+  'hub/middleware',
+  'hub/workers/worker-utils.mjs', // shared utility
+];
+
+const REMOTE_FILES = [
+  'hub/server.mjs',
+  'hub/store.mjs',
+  'hub/store-adapter.mjs',
+  'hub/pipe.mjs',
+  'hub/tools.mjs',
+  'hub/tray.mjs',
+];
+
+const REMOTE_DIRS = [
+  'hub/team',
+  'hub/workers',
+  'hub/public',
+];
+
+const TRIFLUX_DIRS = [
+  'bin',
+  'skills',
+  'hooks',
+  'hud',
+  'scripts',
+  'hub',
+  'mesh',
+  'references',
+];
+
+const TRIFLUX_FILES = [
+  'README.md',
+  'README.ko.md',
+  'LICENSE',
+  'CLAUDE.md',
+];
+
+// ── 복사 유틸 ───────────────────────────────────────────────────
+
+function copyItem(src, dest) {
+  const fullSrc = join(ROOT, src);
+  if (!existsSync(fullSrc)) {
+    console.warn(`  SKIP ${src} (not found)`);
+    return;
+  }
+  const fullDest = join(dest, src);
+  mkdirSync(dirname(fullDest), { recursive: true });
+  cpSync(fullSrc, fullDest, { recursive: true });
+  console.log(`  COPY ${src}`);
+}
+
+function cleanDist(pkgDir) {
+  const dirs = ['hub', 'bin', 'skills', 'scripts', 'hooks', 'hud'];
+  for (const d of dirs) {
+    const target = join(pkgDir, d);
+    if (existsSync(target)) rmSync(target, { recursive: true, force: true });
+  }
+  for (const f of ['README.md', 'README.ko.md', 'LICENSE']) {
+    const target = join(pkgDir, f);
+    if (existsSync(target) && target !== join(ROOT, f)) rmSync(target, { force: true });
+  }
+}
+
+// ── Cross-package import 리라이팅 ────────────────────────────────
+
+function walkMjs(dir) {
+  const files = [];
+  if (!existsSync(dir)) return files;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) files.push(...walkMjs(full));
+    else if (entry.name.endsWith('.mjs')) files.push(full);
+  }
+  return files;
+}
+
+function buildFileSet(baseDir) {
+  const files = new Set();
+  if (!existsSync(baseDir)) return files;
+  for (const f of walkMjs(baseDir)) {
+    files.add(normalize(f));
+  }
+  return files;
+}
+
+/**
+ * remote 패키지 내 .mjs 파일에서 core 모듈을 참조하는 상대 import를
+ * @triflux/core 패키지 경로로 리라이팅한다.
+ */
+function rewriteRemoteImports(remotePkgDir, corePkgDir) {
+  const coreFiles = buildFileSet(corePkgDir);
+  let totalRewrites = 0;
+
+  for (const filePath of walkMjs(remotePkgDir)) {
+    let content = readFileSync(filePath, 'utf8');
+    let changed = false;
+
+    content = content.replace(
+      /(from\s+['"])(\.[^'"]+)(['"])/g,
+      (match, pre, importPath, post) => {
+        const resolved = normalize(join(dirname(filePath), importPath));
+        // import 대상이 remote 패키지 내에 있으면 그대로 유지
+        if (existsSync(resolved)) return match;
+        // core 패키지에 동일 상대경로로 존재하는지 확인
+        const relToRemote = relative(remotePkgDir, resolved).replace(/\\/g, '/');
+        const coreEquiv = normalize(join(corePkgDir, relToRemote));
+        if (coreFiles.has(coreEquiv)) {
+          changed = true;
+          totalRewrites++;
+          return `${pre}@triflux/core/${relToRemote}${post}`;
+        }
+        return match;
+      }
+    );
+
+    if (changed) writeFileSync(filePath, content);
+  }
+
+  return totalRewrites;
+}
+
+// ── Index 생성 ──────────────────────────────────────────────────
+
+const CORE_INDEX = `// @triflux/core — barrel export (auto-generated by pack.mjs)
+// Adapters
+export { buildExecCommand, sleep, gte, FEATURES, CODEX_MCP_TRANSPORT_EXIT_CODE, normalizePathForShell, shellQuote } from './cli-adapter-base.mjs';
+export { execute as executeCodex, buildExecArgs as buildCodexArgs, buildLaunchScript, getCircuitState as getCodexCircuit } from './codex-adapter.mjs';
+export { execute as executeGemini, buildExecArgs as buildGeminiArgs, getCircuitState as getGeminiCircuit } from './gemini-adapter.mjs';
+export { getCodexVersion, runPreflight } from './codex-preflight.mjs';
+
+// Routing & Intent
+export { createRouter } from './router.mjs';
+export { classifyIntent, quickClassify, INTENT_CATEGORIES, refineClassification } from './intent.mjs';
+
+// State & Paths & Platform
+export * from './paths.mjs';
+export { IS_WINDOWS, IS_MAC, IS_LINUX, TEMP_DIR, normalizePath, whichCommand, killProcess, pipePath } from './platform.mjs';
+
+// Core services
+export { createHitlManager } from './hitl.mjs';
+export { createAssignCallbackServer } from './assign-callbacks.mjs';
+export { getHubUrl, getHubPipePath, requestJson, post, connectPipe, parseArgs, parseJsonSafe } from './bridge.mjs';
+
+// Fullcycle & Research
+export { createFullcycleRunId, getFullcycleRunDir, ensureFullcycleRunDir, saveFullcycleArtifact, readFullcycleArtifact, writeFullcycleState, readFullcycleState, shouldStopQaLoop } from './fullcycle.mjs';
+export { generateQueries, normalizeResults, buildReport, saveReport } from './research.mjs';
+
+// Reflexion (adaptive error learning)
+export { normalizeError, lookupSolution, learnFromError, reportOutcome, adaptiveRuleFromError, getActiveAdaptiveRules } from './reflexion.mjs';
+
+// Neural Memory (Lake 1.5)
+export { createAdaptiveEngine } from './adaptive.mjs';
+export { createAdaptiveMemory } from './adaptive-memory.mjs';
+export { createDiagnosticPipeline } from './adaptive-diagnostic.mjs';
+export { createAdaptiveInjector } from './adaptive-inject.mjs';
+export { buildAdaptiveFingerprint, createAdaptiveFingerprintService } from './session-fingerprint.mjs';
+export { broker as accountBroker } from './account-broker.mjs';
+`;
+
+const REMOTE_INDEX = `// @triflux/remote — barrel export (auto-generated by pack.mjs)
+// Server
+export { startHub, getHubInfo, getOrCreateServer } from './server.mjs';
+
+// Store
+export { createStoreAdapter } from './store-adapter.mjs';
+
+// Pipe
+export { createPipeServer, getPipePath } from './pipe.mjs';
+
+// Team
+export { orchestrate, decomposeTask, buildLeadPrompt, buildPrompt } from './team/orchestrator.mjs';
+export { createPsmuxSession, startCapture } from './team/psmux.mjs';
+export { createConductor } from './team/conductor.mjs';
+
+// Swarm
+export { createSwarmLocks } from './team/swarm-locks.mjs';
+export { parseShards, buildFileLeaseMap, buildMcpManifest, computeMergeOrder, planSwarm } from './team/swarm-planner.mjs';
+export { createSwarmHypervisor, SWARM_STATES } from './team/swarm-hypervisor.mjs';
+export { reconcile, buildRedundantIds, shouldRunRedundant } from './team/swarm-reconciler.mjs';
+export { ensureWorktree, prepareIntegrationBranch, rebaseShardOntoIntegration, pruneWorktree } from './team/worktree-lifecycle.mjs';
+`;
+
+function writeIndex(dest, content) {
+  const indexPath = join(dest, 'hub', 'index.mjs');
+  writeFileSync(indexPath, content);
+  console.log('  WRITE hub/index.mjs');
+}
+
+// ── Pack 함수 ───────────────────────────────────────────────────
+
+function packCore() {
+  const dest = join(ROOT, 'packages', 'core');
+  console.log('\n@triflux/core');
+  cleanDist(dest);
+  for (const f of CORE_FILES) copyItem(f, dest);
+  for (const d of CORE_DIRS) copyItem(d, dest);
+  // shared scripts/lib for logger, context
+  copyItem('scripts/lib', dest);
+  copyItem('hooks', dest);
+  copyItem('hud', dest);
+  writeIndex(dest, CORE_INDEX);
+  console.log('  DONE');
+}
+
+function packRemote() {
+  const dest = join(ROOT, 'packages', 'remote');
+  const coreDest = join(ROOT, 'packages', 'core');
+  console.log('\n@triflux/remote');
+  cleanDist(dest);
+  for (const f of REMOTE_FILES) copyItem(f, dest);
+  for (const d of REMOTE_DIRS) copyItem(d, dest);
+  // shared scripts/lib needed by delegator-mcp.mjs (dynamic resolve)
+  copyItem('scripts/lib', dest);
+  writeIndex(dest, REMOTE_INDEX);
+  const rewrites = rewriteRemoteImports(dest, coreDest);
+  console.log(`  REWROTE ${rewrites} cross-package imports → @triflux/core`);
+  console.log('  DONE');
+}
+
+function packTriflux() {
+  const dest = join(ROOT, 'packages', 'triflux');
+  console.log('\ntriflux (meta)');
+  cleanDist(dest);
+  // clean extra dirs that triflux now includes
+  for (const d of ['hooks', 'hud', 'scripts', 'hub', 'mesh', 'references']) {
+    const target = join(dest, d);
+    if (existsSync(target)) rmSync(target, { recursive: true, force: true });
+  }
+  for (const f of TRIFLUX_FILES) copyItem(f, dest);
+  for (const d of TRIFLUX_DIRS) copyItem(d, dest);
+  console.log('  DONE');
+}
+
+// ── Main ────────────────────────────────────────────────────────
+
+const target = process.argv[2] || 'all';
+
+console.log(`pack: assembling packages (target=${target})`);
+console.log(`root: ${ROOT}`);
+
+if (target === 'core' || target === 'all') packCore();
+if (target === 'remote' || target === 'all') packRemote();
+if (target === 'triflux' || target === 'all') packTriflux();
+
+console.log('\nPack complete. Run `npm pack` in each package to create tarballs.');

package/scripts/preflight-cache.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+// scripts/preflight-cache.mjs — 세션 시작 시 preflight 점검 캐싱
+
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { checkHub, detectCodexPlan, probeClis } from "./lib/env-probe.mjs";
+
+const __filename = fileURLToPath(import.meta.url);
+const PKG_ROOT = join(dirname(__filename), "..");
+
+const CACHE_DIR = join(homedir(), ".claude", "cache");
+const CACHE_FILE = join(CACHE_DIR, "tfx-preflight.json");
+const CACHE_TTL_MS = 3_600_000; // 1시간 (세션당 1회, SessionStart 훅에서 갱신)
+
+function checkRoute() {
+  const routePath = join(homedir(), ".claude", "scripts", "tfx-route.sh");
+  return { ok: existsSync(routePath), path: routePath };
+}
+
+async function runPreflight() {
+  const cliChecks = await probeClis(["codex", "gemini"]);
+  const result = {
+    timestamp: Date.now(),
+    hub: checkHub({ pkgRoot: PKG_ROOT }),
+    route: checkRoute(),
+    codex: cliChecks.codex || { ok: false },
+    gemini: cliChecks.gemini || { ok: false },
+    codex_plan: detectCodexPlan(),
+    ok: false,
+  };
+  result.ok = result.hub.ok && result.route.ok;
+
+  // CLI 가용성 → available_agents (triage에서 참조)
+  const agents = [];
+  if (result.codex.ok) agents.push("codex");
+  if (result.gemini.ok) agents.push("gemini");
+  agents.push("claude"); // claude는 항상 가용
+  result.available_agents = agents;
+
+  return result;
+}
+
+// 캐시 읽기 (TTL 검증 포함)
+export function readPreflightCache() {
+  try {
+    const data = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
+    if (Date.now() - data.timestamp < CACHE_TTL_MS) return data;
+  } catch {}
+  return null;
+}
+
+// 메인 실행
+if (process.argv[1]?.endsWith("preflight-cache.mjs")) {
+  const result = await runPreflight();
+  mkdirSync(CACHE_DIR, { recursive: true });
+  writeFileSync(CACHE_FILE, JSON.stringify(result, null, 2));
+  // 간결 출력 (hook stdout)
+  const summary = result.ok ? "preflight: ok" : "preflight: FAIL";
+  const details = [];
+  if (!result.hub.ok) details.push("hub:" + result.hub.state);
+  else if (result.hub.restarted) details.push("hub:restarted");
+  if (!result.route.ok) details.push("route:missing");
+  if (result.available_agents.length === 1) details.push("agents:claude-only");
+  console.log(details.length ? `${summary} (${details.join(", ")})` : summary);
+}
+
+export { runPreflight, CACHE_FILE, CACHE_TTL_MS };

package/scripts/preinstall.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// npm install 전 Hub를 안전하게 중지하여 EBUSY 방지
+// better-sqlite3.node 파일이 Hub 프로세스에 의해 잠기면 npm이 덮어쓸 수 없음
+//
+// v6.0.0: taskkill /T /F + Atomics.wait sleep + 파일 잠금 확인
+// (bin/triflux.mjs stopHubForUpdate 패턴과 동일)
+
+import { existsSync, readFileSync, unlinkSync, openSync, closeSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { execFileSync } from "child_process";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = join(__dirname, "..");
+const HUB_PID_FILE = join(homedir(), ".claude", "cache", "tfx-hub", "hub.pid");
+
+function sleepMs(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+function stopHub() {
+  if (!existsSync(HUB_PID_FILE)) return;
+
+  let info;
+  try {
+    info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
+    const pid = Number(info?.pid);
+    if (!Number.isFinite(pid) || pid <= 0) return;
+    process.kill(pid, 0); // 프로세스 존재 확인
+  } catch {
+    // 프로세스 없음 또는 PID 파일 손상 — PID 파일만 정리
+    try { unlinkSync(HUB_PID_FILE); } catch {}
+    return;
+  }
+
+  const pid = Number(info.pid);
+
+  // D4 fix: PID 소유자 검증 — node 프로세스인지 확인 (PID 재사용 보호)
+  if (process.platform === "win32") {
+    try {
+      const taskInfo = execFileSync("tasklist", ["/FI", `PID eq ${pid}`, "/FO", "CSV", "/NH"], {
+        encoding: "utf8", stdio: ["pipe", "pipe", "ignore"], timeout: 5000, windowsHide: true,
+      }).trim();
+      if (!taskInfo.toLowerCase().includes("node")) {
+        console.log(`[triflux preinstall] PID ${pid}은 node 프로세스가 아님 — kill 건너뜀`);
+        try { unlinkSync(HUB_PID_FILE); } catch {}
+        return;
+      }
+    } catch {
+      // tasklist 실패 — 안전하게 진행 (프로세스가 이미 죽었을 수 있음)
+    }
+  }
+
+  // 1단계: 프로세스 종료 — Windows는 taskkill, Unix는 SIGTERM
+  try {
+    if (process.platform === "win32") {
+      execFileSync("taskkill", ["/PID", String(pid), "/T", "/F"], {
+        stdio: ["pipe", "pipe", "ignore"],
+        timeout: 10000,
+        windowsHide: true,
+      });
+    } else {
+      process.kill(pid, "SIGTERM");
+    }
+  } catch {
+    // taskkill 실패 시 SIGKILL fallback
+    try { process.kill(pid, "SIGKILL"); } catch {}
+  }
+
+  // 2단계: 프로세스 종료 대기 (최대 5초, 500ms 간격)
+  for (let i = 0; i < 10; i++) {
+    sleepMs(500);
+    try { process.kill(pid, 0); } catch { break; }
+  }
+
+  // 3단계: better-sqlite3.node 파일 잠금 해제 확인 (최대 3초)
+  const sqliteNode = join(PKG_ROOT, "node_modules", "better-sqlite3", "build", "Release", "better_sqlite3.node");
+  if (existsSync(sqliteNode)) {
+    for (let i = 0; i < 6; i++) {
+      try {
+        const fd = openSync(sqliteNode, "r");
+        closeSync(fd);
+        break; // 열림 = 잠금 해제됨
+      } catch {
+        sleepMs(500);
+      }
+    }
+  }
+
+  // 4단계: PID 파일 정리 (종료 확인 후)
+  try { unlinkSync(HUB_PID_FILE); } catch {}
+  console.log(`[triflux preinstall] Hub 중지 완료 (PID ${pid})`);
+}
+
+stopHub();