@qpfai/pf-gate-cli 1.0.6 → 1.0.8

package/artifacts/python-wheel.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-02-16T21:24:52.064Z",
+  "generatedAt": "2026-02-16T21:39:31.761Z",
   "pythonPackage": "persons-field",
   "pythonPackageVersion": "1.0.0",
   "wheel": "persons_field-1.0.0-py3-none-any.whl",
-  "sha256": "8c0adc8dfe2a148d6c2269efba64de8591f7eec1ee8f409ea349efef6ae1cfe3"
+  "sha256": "e1c6c3972668c2b095b1fc32bad95c95607b5734794b086b42a6d7d53de5847c"
 }

package/lib/main.mjs

@@ -14,7 +14,8 @@ const PACKAGE_ROOT = path.resolve(__dirname, "..");
 const ARTIFACT_MANIFEST_PATH = path.join(PACKAGE_ROOT, "artifacts", "python-wheel.json");
 const INSTALL_STATE_NAME = "install-state.json";
 const PYTHON_CANDIDATES = ["python3.13", "python3", "python"];
-const NPM_REGISTRY = "https://registry.npmjs.org";
+const DEFAULT_NPM_REGISTRY = "https://registry.npmjs.org";
+const UPDATE_CHECK_TIMEOUT_MS = 6000;
 
 function isWindows() {
   return process.platform === "win32";
@@ -141,7 +142,25 @@ export function compareVersions(left, right) {
   return 0;
 }
 
-function fetchJson(url, timeoutMs = 2500) {
+function configuredNpmRegistry() {
+  const fromEnv = String(process.env.PF_GATE_NPM_REGISTRY || "").trim();
+  if (fromEnv) {
+    return fromEnv.replace(/\/+$/, "");
+  }
+  return DEFAULT_NPM_REGISTRY;
+}
+
+function debugUpdateEnabled() {
+  return String(process.env.PF_GATE_DEBUG_UPDATE_CHECK || "").trim() === "1";
+}
+
+function debugUpdate(message) {
+  if (debugUpdateEnabled()) {
+    console.log(`[PF Gate update-check] ${message}`);
+  }
+}
+
+function fetchJson(url, timeoutMs = UPDATE_CHECK_TIMEOUT_MS) {
   return new Promise((resolve) => {
     const request = https.get(
       url,
@@ -177,10 +196,7 @@ function fetchJson(url, timeoutMs = 2500) {
   });
 }
 
-async function fetchLatestVersion(packageName) {
-  const encoded = encodeURIComponent(packageName);
-  const url = `${NPM_REGISTRY}/-/package/${encoded}/dist-tags`;
-  const payload = await fetchJson(url);
+export function latestFromDistTags(payload) {
   if (!payload || typeof payload !== "object") {
     return null;
   }
@@ -191,6 +207,61 @@ async function fetchLatestVersion(packageName) {
   return latest;
 }
 
+export function parseNpmViewVersion(raw) {
+  const text = String(raw || "").trim();
+  if (!text) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(text);
+    if (typeof parsed === "string" && parsed.trim()) {
+      return parsed.trim();
+    }
+    if (Array.isArray(parsed) && parsed.length > 0) {
+      const first = String(parsed[0] || "").trim();
+      return first || null;
+    }
+  } catch (_error) {
+    // npm can return plain text; fall through.
+  }
+  const firstLine = text.split(/\r?\n/, 1)[0] || "";
+  const candidate = firstLine.replace(/^["']|["']$/g, "").trim();
+  return candidate || null;
+}
+
+function fetchLatestVersionFromNpmCli(packageName, registry) {
+  const probe = runCapture("npm", [
+    "view",
+    `${packageName}@latest`,
+    "version",
+    "--json",
+    "--registry",
+    registry,
+  ]);
+  if (!probe.ok) {
+    return null;
+  }
+  return parseNpmViewVersion(probe.output);
+}
+
+async function fetchLatestVersion(packageName, registry) {
+  const encoded = encodeURIComponent(packageName);
+  const url = `${registry}/-/package/${encoded}/dist-tags`;
+  debugUpdate(`fetch ${url}`);
+  const payload = await fetchJson(url);
+  const latest = latestFromDistTags(payload);
+  if (latest) {
+    debugUpdate(`dist-tags latest=${latest}`);
+    return latest;
+  }
+  debugUpdate("dist-tags unavailable; falling back to npm view");
+  const fallback = fetchLatestVersionFromNpmCli(packageName, registry);
+  if (fallback) {
+    debugUpdate(`npm view latest=${fallback}`);
+  }
+  return fallback;
+}
+
 function canPrompt() {
   return Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
@@ -217,13 +288,18 @@ async function promptYesNo(question, defaultYes = true) {
 
 async function maybeOfferCliUpdate(metadata) {
   if (String(process.env.PF_GATE_DISABLE_UPDATE_CHECK || "").trim() === "1") {
+    debugUpdate("disabled via PF_GATE_DISABLE_UPDATE_CHECK=1");
     return false;
   }
-  const latestVersion = await fetchLatestVersion(metadata.name);
+  const registry = configuredNpmRegistry();
+  debugUpdate(`current=${metadata.version}, package=${metadata.name}, registry=${registry}`);
+  const latestVersion = await fetchLatestVersion(metadata.name, registry);
   if (!latestVersion) {
+    debugUpdate("unable to resolve latest version");
     return false;
   }
   if (compareVersions(latestVersion, metadata.version) <= 0) {
+    debugUpdate(`up-to-date (latest=${latestVersion})`);
     return false;
   }
   console.log(
@@ -237,7 +313,7 @@ async function maybeOfferCliUpdate(metadata) {
   console.log(`Updating ${metadata.name}...`);
   const result = spawnSync(
     "npm",
-    ["i", "-g", `${metadata.name}@latest`, "--registry", NPM_REGISTRY],
+    ["i", "-g", `${metadata.name}@latest`, "--registry", registry],
     { stdio: "inherit" }
   );
   if (result.error || (result.status ?? 1) !== 0) {

package/package.json

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