@qpfai/pf-gate-cli 1.0.14 → 1.0.16

package/artifacts/python-wheel.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-02-16T22:28:02.794Z",
+  "generatedAt": "2026-02-16T22:39:32.770Z",
   "pythonPackage": "persons-field",
   "pythonPackageVersion": "1.0.0",
   "wheel": "persons_field-1.0.0-py3-none-any.whl",
-  "sha256": "322c007a43e3ce7b6f42339637da32e039f3f06e7b1385175e8ab1a2cf6eac78"
+  "sha256": "10cbc5c716202bace88f1b20f3a671030cca7c3bbc45b470ba5f52e64e188833"
 }

package/lib/main.mjs

@@ -16,6 +16,8 @@ const INSTALL_STATE_NAME = "install-state.json";
 const PYTHON_CANDIDATES = ["python3.13", "python3", "python"];
 const DEFAULT_NPM_REGISTRY = "https://registry.npmjs.org";
 const UPDATE_CHECK_TIMEOUT_MS = 6000;
+const UPDATE_INSTALL_MAX_RETRIES = 10;
+const UPDATE_INSTALL_RETRY_MS = 3000;
 const SPHERE_FRAMES = ["🌐", "🌍", "🌎", "🌏"];
 
 function isWindows() {
@@ -117,6 +119,10 @@ function runCapture(command, args) {
   };
 }
 
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 function startSphereSpinner(message) {
   if (!process.stdout.isTTY) {
     return (_doneMessage) => {};
@@ -327,11 +333,14 @@ function canPrompt() {
   return Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
 
-async function promptYesNo(question, defaultYes = true) {
+async function promptYesNo(question, defaultYes = true, promptSuffix = null) {
   if (!canPrompt()) {
     return false;
   }
-  const prompt = defaultYes ? `${question} [Y/n] ` : `${question} [y/N] `;
+  let prompt = defaultYes ? `${question} [Y/n] ` : `${question} [y/N] `;
+  if (typeof promptSuffix === "string" && promptSuffix.trim()) {
+    prompt = `${question} ${promptSuffix.trim()} `;
+  }
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
@@ -347,6 +356,17 @@ async function promptYesNo(question, defaultYes = true) {
   }
 }
 
+async function promptCliUpdate(metadata, latestVersion) {
+  if (!canPrompt()) {
+    return false;
+  }
+  console.clear();
+  console.log(
+    `Update available: ${metadata.name} ${metadata.version} -> ${latestVersion}`
+  );
+  return promptYesNo("Install update now?", false, "[Y/N]");
+}
+
 function npmGlobalBinDir() {
   const prefix = runCapture("npm", ["prefix", "-g"]);
   if (!prefix.ok) {
@@ -386,8 +406,26 @@ function maybeHealBinCollision(output) {
   return removed;
 }
 
-async function installLatestCliPackage(packageName, registry) {
-  const args = ["i", "-g", `${packageName}@latest`, "--registry", registry];
+function isEtargetPublishRace(output) {
+  const text = String(output || "").toLowerCase();
+  return text.includes("code etarget") || text.includes("notarget no matching version");
+}
+
+async function npmVersionExists(packageName, version, registry) {
+  const result = await spawnCapture(
+    "npm",
+    ["view", `${packageName}@${version}`, "version", "--json", "--registry", registry],
+    { encoding: "utf-8" }
+  );
+  if (result.error || (result.status ?? 1) !== 0) {
+    return false;
+  }
+  const parsed = parseNpmViewVersion(String(result.stdout || "").trim());
+  return parsed === String(version || "").trim();
+}
+
+async function installLatestCliPackage(packageName, targetVersion, registry) {
+  const args = ["i", "-g", `${packageName}@${targetVersion}`, "--registry", registry];
   const runOnce = async () => {
     const stop = startSphereSpinner("Installing PF Gate update...");
     const result = await spawnCapture("npm", args, { encoding: "utf-8" });
@@ -399,22 +437,55 @@ async function installLatestCliPackage(packageName, registry) {
     return result;
   };
 
-  let result = await runOnce();
-  if (!result.error && (result.status ?? 1) === 0) {
-    return true;
-  }
+  let attempts = 0;
+  let healedCollision = false;
+  let result = null;
+
+  while (attempts < UPDATE_INSTALL_MAX_RETRIES) {
+    attempts += 1;
+    const versionReady = await npmVersionExists(packageName, targetVersion, registry);
+    if (!versionReady) {
+      if (attempts < UPDATE_INSTALL_MAX_RETRIES) {
+        const delayMs = UPDATE_INSTALL_RETRY_MS * attempts;
+        const seconds = Math.ceil(delayMs / 1000);
+        const stopWait = startSphereSpinner(
+          `Waiting for ${packageName}@${targetVersion} to be available (${seconds}s)...`
+        );
+        await sleep(delayMs);
+        stopWait("✓ Retrying update install...");
+        continue;
+      }
+      break;
+    }
 
-  const combined = `${String(result.stdout || "")}\n${String(result.stderr || "")}`;
-  if (maybeHealBinCollision(combined)) {
     result = await runOnce();
     if (!result.error && (result.status ?? 1) === 0) {
       return true;
     }
+
+    const combined = `${String(result.stdout || "")}\n${String(result.stderr || "")}`;
+    if (!healedCollision && maybeHealBinCollision(combined)) {
+      healedCollision = true;
+      continue;
+    }
+
+    if (attempts < UPDATE_INSTALL_MAX_RETRIES && isEtargetPublishRace(combined)) {
+      const delayMs = UPDATE_INSTALL_RETRY_MS * attempts;
+      const seconds = Math.ceil(delayMs / 1000);
+      const stopWait = startSphereSpinner(
+        `Waiting for npm registry propagation (${seconds}s)...`
+      );
+      await sleep(delayMs);
+      stopWait("✓ Retrying update install...");
+      continue;
+    }
+    break;
   }
-  if (result.stdout) {
+
+  if (result && result.stdout) {
     process.stdout.write(String(result.stdout));
   }
-  if (result.stderr) {
+  if (result && result.stderr) {
     process.stderr.write(String(result.stderr));
   }
   return false;
@@ -438,16 +509,13 @@ async function maybeOfferCliUpdate(metadata) {
     debugUpdate(`up-to-date (latest=${latestVersion})`);
     return false;
   }
-  console.log(
-    `Update available: ${metadata.name} ${metadata.version} -> ${latestVersion}`
-  );
-  const wantsUpdate = await promptYesNo("Install update now?", true);
+  const wantsUpdate = await promptCliUpdate(metadata, latestVersion);
   if (!wantsUpdate) {
     console.log(`Continue with ${metadata.version}.`);
     return false;
   }
   console.log(`Updating ${metadata.name}...`);
-  const installed = await installLatestCliPackage(metadata.name, registry);
+  const installed = await installLatestCliPackage(metadata.name, latestVersion, registry);
   if (!installed) {
     console.log("Update failed. Continuing with current version.");
     return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qpfai/pf-gate-cli",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "PF Gate terminal launcher with first-run runtime bootstrap.",
   "license": "Apache-2.0",
   "type": "module",