nexus-agent-installer 0.1.3 → 0.1.5

package/README.md

@@ -14,6 +14,11 @@ nexus-agent start    # 서버 시작 → http://localhost:4821
 nexus-agent update   # 최신 버전 업데이트
 ```
 
-이 패키지는 다운로더 역할만 하므로, 이후 업데이트는 npm이 아닌 `nexus-agent update`로 하면 됩니다.
+대화형 터미널에서 `nexus-agent start`를 실행하면 새 버전이 있을 때 업데이트 여부를
+묻고, 동의하면 설치 후 같은 옵션으로 서버를 다시 시작합니다. 확인을 생략하려면
+`nexus-agent start --no-update-check` 또는 `NEXUS_NO_UPDATE_CHECK=1`을 사용합니다.
+
+이 패키지는 다운로더 역할만 하므로 이후 업데이트를 위해 npm 패키지를 다시
+설치할 필요는 없습니다. 시작 시 질문 또는 `nexus-agent update`를 사용하면 됩니다.
 
 지원 플랫폼은 macOS (Apple Silicon/Intel), Linux (x86_64), Windows (x64)이며 Node.js 18 이상이 필요합니다.

package/install.js

@@ -42,7 +42,10 @@ const STOP_TOOL_PROCESSES_PS = [
   "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 }",
+  "foreach ($processId in $processIds) {",
+  "    Wait-Process -Id $processId -Timeout 30 -ErrorAction SilentlyContinue",
+  '    if (Get-Process -Id $processId -ErrorAction SilentlyContinue) { throw "Nexus process stop timed out: $processId" }',
+  "}",
   '$processIds -join ","',
 ].join("\n");
 
@@ -53,7 +56,8 @@ function fail(msg) {
 function whlSuffix() {
   const { platform, arch } = process;
   if (platform === "darwin") {
-    return arch === "arm64" ? "macosx_11_0_arm64.whl" : "macosx_10_12_x86_64.whl";
+    if (arch !== "arm64") fail(`macOS는 Apple Silicon(arm64)만 지원합니다 (현재: ${arch}).`);
+    return "macosx_11_0_arm64.whl";
   }
   if (platform === "linux") {
     if (arch !== "x64") fail(`Linux는 x86_64만 지원합니다 (현재: ${arch}).`);
@@ -189,6 +193,12 @@ function stopNexusToolProcesses() {
         },
       },
     );
+    if (result.status !== 0) {
+      const detail = result.error?.code || (result.signal
+        ? `signal ${result.signal}`
+        : `exit code ${result.status ?? "unknown"}`);
+      fail(`Nexus Agent 프로세스를 확인·종료하지 못해 설치를 중단합니다 (${detail}).`);
+    }
     const stopped = String(result.stdout || "").trim();
     if (stopped) {
       console.log(`실행 중인 Nexus Agent 프로세스를 종료했습니다: ${stopped}`);
@@ -207,6 +217,12 @@ function verifyRuntime() {
   }
   const result = run(paths.python, ["-I", "-m", INTEGRITY_MODULE]);
   if (result.status !== 0) fail("Nexus Agent 설치 무결성 검증에 실패했습니다.");
+  if (!paths.launcher || !fs.existsSync(paths.launcher)) {
+    fail(`설치된 실행 파일을 찾을 수 없습니다: ${paths.launcher}`);
+  }
+  const launched = run(paths.launcher, ["--version"]);
+  if (launched.status !== 0) fail("Nexus Agent 실행 검증에 실패했습니다.");
+  return paths;
 }
 
 function removeDamagedTool() {
@@ -245,7 +261,8 @@ function installUv() {
 async function main() {
   const suffix = whlSuffix();
 
-  if (!hasUv()) installUv();
+  const installedUv = !hasUv();
+  if (installedUv) installUv();
   // ensureSafeWindowsUv가 uv tool uninstall을 부를 수 있으므로 그 전에 잠금을 푼다.
   stopNexusToolProcesses();
   ensureSafeWindowsUv();
@@ -275,6 +292,7 @@ async function main() {
   const whlPath = path.join(tmpDir, asset.name);
   const depDir = path.join(tmpDir, "deps");
   let installationCompleted = false;
+  let installedPaths;
   try {
     fs.writeFileSync(whlPath, Buffer.from(await dl.arrayBuffer()));
     fs.mkdirSync(depDir);
@@ -309,7 +327,7 @@ async function main() {
       fail(`uv tool install이 실패했습니다 (${detail}).`);
     }
     installationCompleted = true;
-    verifyRuntime();
+    installedPaths = verifyRuntime();
   } catch (error) {
     if (installationCompleted) removeDamagedTool();
     reportSecuritySoftwareDiagnostics();
@@ -320,6 +338,21 @@ async function main() {
 
   console.log("");
   console.log("✓ Nexus Agent 설치 완료");
+  const launcherDirectory = path.dirname(installedPaths.launcher);
+  const normalizedDirectory = IS_WIN ? launcherDirectory.toLowerCase() : launcherDirectory;
+  const onPath = String(process.env.PATH || process.env.Path || "").split(path.delimiter).some((entry) => {
+    const directory = path.resolve(entry.replace(/^"|"$/g, ""));
+    return (IS_WIN ? directory.toLowerCase() : directory) === normalizedDirectory;
+  });
+  if (installedUv) {
+    console.log("  uv를 새로 설치했습니다. 새 터미널에서 nexus-agent 명령을 실행하세요.");
+  }
+  if (!onPath) {
+    console.log("  명령 경로를 등록하려면 uv tool update-shell 실행 후 새 터미널을 여세요.");
+  }
+  if (installedUv || !onPath) {
+    console.log(`  검증된 실행 파일: ${installedPaths.launcher}`);
+  }
   console.log("  다음 단계:");
   console.log("    nexus-agent init    # ~/.nexus-agent/ 초기 설정 생성");
   console.log("    nexus-agent start   # 서버 시작 (http://localhost:4821)");

package/package.json

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