nexus-agent-installer 0.1.1 → 0.1.3

package/install.js

@@ -8,10 +8,46 @@ const path = require("node:path");
 
 const REPO = "EJCHO-salary/nexus-agent-releases";
 const IS_WIN = process.platform === "win32";
+const MIN_SAFE_UV_VERSION = [0, 10, 10];
+const INTEGRITY_MODULE = "nexus_agent.install_integrity";
+
+// 실행 중인 프로세스가 tool 환경 파일을 잠그면 uv가 기존 패키지를 지우다 실패해
+// 디렉토리가 반쯤 남는다(dotenv 네임스페이스만 남고 load_dotenv 소실 등).
+// 대상은 PID가 아니라 실행 파일 경로로 식별한다 — 런처는 tool 환경 밖에 있어
+// 하위 경로 매칭에 걸리지 않으므로 별도로 비교한다.
+// PowerShell 5.1은 BOM 없는 스크립트를 ANSI로 읽으므로 본문은 순수 ASCII로 두고,
+// 사용자에게 보여줄 한국어 메시지는 종료된 PID를 받아 Node가 출력한다.
+const STOP_TOOL_PROCESSES_PS = [
+  '$ErrorActionPreference = "Stop"',
+  "$toolEnvironment = $env:NEXUS_TOOL_ENVIRONMENT",
+  "$launcher = $env:NEXUS_TOOL_LAUNCHER",
+  "if (-not $toolEnvironment) { exit 0 }",
+  "$separator = [System.IO.Path]::DirectorySeparatorChar",
+  "$toolPrefix = [System.IO.Path]::GetFullPath($toolEnvironment).TrimEnd($separator) + $separator",
+  '$launcherFull = ""',
+  "if ($launcher) { $launcherFull = [System.IO.Path]::GetFullPath($launcher) }",
+  "$processes = @(",
+  "    Get-CimInstance -ClassName Win32_Process -ErrorAction SilentlyContinue |",
+  "        Where-Object {",
+  "            if (-not $_.ExecutablePath) { return $false }",
+  "            if ($_.ProcessId -eq $PID) { return $false }",
+  "            try {",
+  "                $executable = [System.IO.Path]::GetFullPath([string]$_.ExecutablePath)",
+  "                if ($executable.StartsWith($toolPrefix, [System.StringComparison]::OrdinalIgnoreCase)) { return $true }",
+  "                return $launcherFull -and $executable.Equals($launcherFull, [System.StringComparison]::OrdinalIgnoreCase)",
+  "            }",
+  "            catch { return $false }",
+  "        }",
+  ")",
+  "if ($processes.Count -eq 0) { exit 0 }",
+  "$processIds = @($processes | ForEach-Object { [int]$_.ProcessId })",
+  "foreach ($processId in $processIds) { Stop-Process -Id $processId -Force -ErrorAction SilentlyContinue }",
+  "foreach ($processId in $processIds) { Wait-Process -Id $processId -ErrorAction SilentlyContinue }",
+  '$processIds -join ","',
+].join("\n");
 
 function fail(msg) {
-  console.error(`오류: ${msg}`);
-  process.exit(1);
+  throw new Error(msg);
 }
 
 function whlSuffix() {
@@ -30,12 +66,170 @@ function whlSuffix() {
   fail(`지원하지 않는 플랫폼입니다: ${platform}`);
 }
 
+// shell을 쓰지 않는다 — Windows에서 shell을 켜면 인자가 그대로 이어붙어
+// `C:\Users\John Doe\...` 같은 공백 포함 경로가 쪼개진다. uv/tar/powershell은
+// 모두 실제 exe라 PATH 검색만으로 실행된다.
 function run(cmd, args, opts = {}) {
-  return spawnSync(cmd, args, { stdio: "inherit", shell: IS_WIN, ...opts });
+  return spawnSync(cmd, args, { stdio: "inherit", ...opts });
+}
+
+function capture(cmd, args, opts = {}) {
+  return spawnSync(cmd, args, {
+    encoding: "utf8",
+    windowsHide: true,
+    ...opts,
+  });
+}
+
+function parseUvVersion(text) {
+  const match = String(text || "").match(/\b(\d+)\.(\d+)\.(\d+)\b/);
+  return match ? match.slice(1).map(Number) : null;
+}
+
+function compareVersions(left, right) {
+  for (let index = 0; index < 3; index += 1) {
+    if (left[index] !== right[index]) return left[index] - right[index];
+  }
+  return 0;
+}
+
+function windowsRepairPlan(versionOutput) {
+  const version = parseUvVersion(versionOutput);
+  return version && compareVersions(version, MIN_SAFE_UV_VERSION) >= 0
+    ? []
+    : ["self-update", "uninstall-if-still-unsafe"];
+}
+
+function currentUvVersionOutput() {
+  const result = capture("uv", ["--version"]);
+  return result.status === 0 ? result.stdout || result.stderr : "";
+}
+
+function ensureSafeWindowsUv() {
+  if (!IS_WIN || windowsRepairPlan(currentUvVersionOutput()).length === 0) return;
+
+  console.log("uv 0.10.10 이상으로 업데이트를 시도합니다...");
+  const updated = run("uv", ["self", "update"]);
+  if (updated.status !== 0) {
+    console.warn("uv 자동 업데이트를 사용할 수 없어 안전한 재설치로 전환합니다.");
+  }
+
+  if (windowsRepairPlan(currentUvVersionOutput()).length !== 0) {
+    console.log("구버전 uv 도구 환경을 제거한 뒤 다시 설치합니다...");
+    const removed = run("uv", ["tool", "uninstall", "nexus-agent-platform"]);
+    if (removed.status !== 0) {
+      console.warn("기존 도구 환경 제거가 완료되지 않았습니다. 강제 재설치를 계속합니다.");
+    }
+  }
+}
+
+function buildUvInstallArgs(depDir, isWindows = IS_WIN) {
+  const args = [
+    "tool",
+    "install",
+    "--force",
+    "--reinstall",
+    "--refresh",
+  ];
+  if (isWindows) args.push("--no-progress");
+  return [
+    ...args,
+    "--python",
+    "3.13",
+    "--no-build",
+    "--find-links",
+    depDir,
+  ];
+}
+
+function buildUvInstallEnv(isWindows = IS_WIN, env = process.env) {
+  if (!isWindows) return env;
+  return {
+    ...env,
+    UV_CONCURRENT_INSTALLS: env.UV_CONCURRENT_INSTALLS || "1",
+  };
+}
+
+function toolEnvironmentPaths() {
+  const toolDirResult = capture("uv", ["tool", "dir"]);
+  if (toolDirResult.status !== 0) return null;
+  const toolRoot = String(toolDirResult.stdout || "").trim();
+  if (!toolRoot) return null;
+  const binResult = capture("uv", ["tool", "dir", "--bin"]);
+  const binRoot = binResult.status === 0 ? String(binResult.stdout || "").trim() : "";
+  const environment = path.join(toolRoot, "nexus-agent-platform");
+  return {
+    environment,
+    python: IS_WIN
+      ? path.join(environment, "Scripts", "python.exe")
+      : path.join(environment, "bin", "python"),
+    launcher: binRoot
+      ? path.join(binRoot, IS_WIN ? "nexus-agent.exe" : "nexus-agent")
+      : "",
+  };
+}
+
+function stopNexusToolProcesses() {
+  if (!IS_WIN) return "";
+  const paths = toolEnvironmentPaths();
+  if (!paths) return "";
+
+  const scriptDir = fs.mkdtempSync(path.join(os.tmpdir(), "nexus-agent-stop-"));
+  try {
+    const scriptPath = path.join(scriptDir, "stop-nexus-processes.ps1");
+    fs.writeFileSync(scriptPath, STOP_TOOL_PROCESSES_PS, "ascii");
+    const result = capture(
+      "powershell",
+      ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", scriptPath],
+      {
+        env: {
+          ...process.env,
+          NEXUS_TOOL_ENVIRONMENT: paths.environment,
+          NEXUS_TOOL_LAUNCHER: paths.launcher,
+        },
+      },
+    );
+    const stopped = String(result.stdout || "").trim();
+    if (stopped) {
+      console.log(`실행 중인 Nexus Agent 프로세스를 종료했습니다: ${stopped}`);
+    }
+    return stopped;
+  } finally {
+    fs.rmSync(scriptDir, { recursive: true, force: true });
+  }
+}
+
+function verifyRuntime() {
+  const paths = toolEnvironmentPaths();
+  if (!paths) fail("uv tool 경로를 확인하지 못했습니다.");
+  if (!fs.existsSync(paths.python)) {
+    fail(`설치된 Python을 찾을 수 없습니다: ${paths.python}`);
+  }
+  const result = run(paths.python, ["-I", "-m", INTEGRITY_MODULE]);
+  if (result.status !== 0) fail("Nexus Agent 설치 무결성 검증에 실패했습니다.");
+}
+
+function removeDamagedTool() {
+  console.warn("설치 검증 실패 — 손상된 환경을 제거합니다.");
+  const removed = run("uv", ["tool", "uninstall", "nexus-agent-platform"]);
+  if (removed.status !== 0) {
+    console.warn("손상된 도구 환경을 자동으로 제거하지 못했습니다.");
+  }
+}
+
+function reportSecuritySoftwareDiagnostics() {
+  if (!IS_WIN) return;
+  const uvPath = capture("where.exe", ["uv"]);
+  const toolDir = capture("uv", ["tool", "dir"]);
+  const cacheDir = capture("uv", ["cache", "dir"]);
+  console.warn("설치 프로세스가 예고 없이 종료됐다면 보안 프로그램/EDR 검역 로그를 확인하세요:");
+  if (uvPath.status === 0) console.warn(`  uv: ${uvPath.stdout.trim()}`);
+  if (toolDir.status === 0) console.warn(`  tool: ${toolDir.stdout.trim()}`);
+  if (cacheDir.status === 0) console.warn(`  cache: ${cacheDir.stdout.trim()}`);
 }
 
 function hasUv() {
-  return spawnSync("uv", ["--version"], { stdio: "ignore", shell: IS_WIN }).status === 0;
+  return spawnSync("uv", ["--version"], { stdio: "ignore" }).status === 0;
 }
 
 function installUv() {
@@ -52,6 +246,9 @@ async function main() {
   const suffix = whlSuffix();
 
   if (!hasUv()) installUv();
+  // ensureSafeWindowsUv가 uv tool uninstall을 부를 수 있으므로 그 전에 잠금을 푼다.
+  stopNexusToolProcesses();
+  ensureSafeWindowsUv();
 
   console.log("최신 릴리스 확인 중...");
   const headers = { "User-Agent": "nexus-agent-installer", Accept: "application/vnd.github+json" };
@@ -77,6 +274,7 @@ async function main() {
   const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "nexus-agent-install-"));
   const whlPath = path.join(tmpDir, asset.name);
   const depDir = path.join(tmpDir, "deps");
+  let installationCompleted = false;
   try {
     fs.writeFileSync(whlPath, Buffer.from(await dl.arrayBuffer()));
     fs.mkdirSync(depDir);
@@ -90,19 +288,32 @@ async function main() {
       if (untar.status !== 0) fail("의존성 번들 압축 해제에 실패했습니다.");
     }
 
-    const uvArgs = ["tool", "install", "--force", "--python", "3.13", "--no-build", "--find-links", depDir];
+    // 다운로드하는 동안 사용자가 다시 실행했을 수 있으므로 설치 직전에 한 번 더 정리한다.
+    stopNexusToolProcesses();
+
+    const uvArgs = buildUvInstallArgs(depDir);
+    const uvOptions = { env: buildUvInstallEnv() };
     const constraints = path.join(depDir, "constraints.txt");
     let result;
     if (fs.existsSync(constraints)) {
-      result = run("uv", [...uvArgs, "--constraints", constraints, whlPath]);
-      if (result.status !== 0) {
+      result = run("uv", [...uvArgs, "--constraints", constraints, whlPath], uvOptions);
+      if (result.status !== 0 && !IS_WIN) {
         console.log("고정 버전 설치에 실패해 버전 고정 없이 다시 시도합니다...");
-        result = run("uv", [...uvArgs, whlPath]);
+        result = run("uv", [...uvArgs, whlPath], uvOptions);
       }
     } else {
-      result = run("uv", [...uvArgs, whlPath]);
+      result = run("uv", [...uvArgs, whlPath], uvOptions);
     }
-    if (result.status !== 0) fail("uv tool install이 실패했습니다.");
+    if (result.status !== 0) {
+      const detail = result.signal ? `signal ${result.signal}` : `exit code ${result.status ?? "unknown"}`;
+      fail(`uv tool install이 실패했습니다 (${detail}).`);
+    }
+    installationCompleted = true;
+    verifyRuntime();
+  } catch (error) {
+    if (installationCompleted) removeDamagedTool();
+    reportSecuritySoftwareDiagnostics();
+    throw error;
   } finally {
     fs.rmSync(tmpDir, { recursive: true, force: true });
   }
@@ -115,4 +326,19 @@ async function main() {
   console.log("    nexus-agent update  # 이후 최신 버전 업데이트");
 }
 
-main().catch((e) => fail(e.message));
+if (process.env.NEXUS_INSTALLER_LIBRARY_MODE === "1") {
+  module.exports = {
+    INTEGRITY_MODULE,
+    STOP_TOOL_PROCESSES_PS,
+    buildUvInstallArgs,
+    buildUvInstallEnv,
+    parseUvVersion,
+    stopNexusToolProcesses,
+    windowsRepairPlan,
+  };
+} else {
+  main().catch((error) => {
+    console.error(`오류: ${error.message}`);
+    process.exitCode = 1;
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-agent-installer",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Installer for Nexus Agent — downloads the platform wheel from GitHub Releases and installs it via uv",
   "scripts": {
     "postinstall": "node install.js"