@qpfai/pf-gate-cli 1.0.0 → 1.0.2

package/artifacts/python-wheel.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-02-16T18:51:30.931Z",
+  "generatedAt": "2026-02-16T19:11:19.187Z",
   "pythonPackage": "persons-field",
   "pythonPackageVersion": "1.0.0",
   "wheel": "persons_field-1.0.0-py3-none-any.whl",
-  "sha256": "f16ad52f913ea806e8d40a4f49c3a92f50f2708ecce67e7ceaf37b492ed0d793"
+  "sha256": "30ef4c0fdd6ada01a9edcdffbacf3a6a3d7c0e676ab1e13670362594caa84b7f"
 }

package/lib/main.mjs

@@ -1,9 +1,11 @@
 import { spawnSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import fs from "node:fs";
+import https from "node:https";
 import os from "node:os";
 import path from "node:path";
 import process from "node:process";
+import readline from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -12,6 +14,7 @@ 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";
 
 function isWindows() {
   return process.platform === "win32";
@@ -83,6 +86,139 @@ function runCapture(command, args) {
   };
 }
 
+function parseVersionTriplet(version) {
+  const text = String(version || "").trim();
+  const [core] = text.split("-");
+  const pieces = core.split(".");
+  const numbers = [];
+  for (let index = 0; index < 3; index += 1) {
+    const value = Number.parseInt(pieces[index] || "0", 10);
+    numbers.push(Number.isFinite(value) ? value : 0);
+  }
+  return numbers;
+}
+
+export function compareVersions(left, right) {
+  const lhs = parseVersionTriplet(left);
+  const rhs = parseVersionTriplet(right);
+  for (let index = 0; index < 3; index += 1) {
+    if (lhs[index] > rhs[index]) {
+      return 1;
+    }
+    if (lhs[index] < rhs[index]) {
+      return -1;
+    }
+  }
+  return 0;
+}
+
+function fetchJson(url, timeoutMs = 2500) {
+  return new Promise((resolve) => {
+    const request = https.get(
+      url,
+      {
+        headers: {
+          "User-Agent": "pf-gate-cli",
+          Accept: "application/json",
+        },
+      },
+      (response) => {
+        let body = "";
+        response.on("data", (chunk) => {
+          body += String(chunk);
+        });
+        response.on("end", () => {
+          if ((response.statusCode || 500) >= 400) {
+            resolve(null);
+            return;
+          }
+          try {
+            resolve(JSON.parse(body));
+          } catch (_error) {
+            resolve(null);
+          }
+        });
+      }
+    );
+    request.setTimeout(timeoutMs, () => {
+      request.destroy(new Error("timeout"));
+      resolve(null);
+    });
+    request.on("error", () => resolve(null));
+  });
+}
+
+async function fetchLatestVersion(packageName) {
+  const encoded = encodeURIComponent(packageName);
+  const url = `${NPM_REGISTRY}/-/package/${encoded}/dist-tags`;
+  const payload = await fetchJson(url);
+  if (!payload || typeof payload !== "object") {
+    return null;
+  }
+  const latest = String(payload.latest || "").trim();
+  if (!latest) {
+    return null;
+  }
+  return latest;
+}
+
+function canPrompt() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+
+async function promptYesNo(question, defaultYes = true) {
+  if (!canPrompt()) {
+    return false;
+  }
+  const prompt = defaultYes ? `${question} [Y/n] ` : `${question} [y/N] `;
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  try {
+    const answer = (await rl.question(prompt)).trim().toLowerCase();
+    if (!answer) {
+      return defaultYes;
+    }
+    return answer === "y" || answer === "yes";
+  } finally {
+    rl.close();
+  }
+}
+
+async function maybeOfferCliUpdate(metadata) {
+  if (String(process.env.PF_GATE_DISABLE_UPDATE_CHECK || "").trim() === "1") {
+    return false;
+  }
+  const latestVersion = await fetchLatestVersion(metadata.name);
+  if (!latestVersion) {
+    return false;
+  }
+  if (compareVersions(latestVersion, metadata.version) <= 0) {
+    return false;
+  }
+  console.log(
+    `Update available: ${metadata.name} ${metadata.version} -> ${latestVersion}`
+  );
+  const wantsUpdate = await promptYesNo("Install update now?", true);
+  if (!wantsUpdate) {
+    console.log(`Continue with ${metadata.version}.`);
+    return false;
+  }
+  console.log(`Updating ${metadata.name}...`);
+  const result = spawnSync(
+    "npm",
+    ["i", "-g", `${metadata.name}@latest`, "--registry", NPM_REGISTRY],
+    { stdio: "inherit" }
+  );
+  if (result.error || (result.status ?? 1) !== 0) {
+    console.log("Update failed. Continuing with current version.");
+    return false;
+  }
+  console.log("Update installed. Restart PF Gate to use the new version.");
+  return true;
+}
+
 function resolvePython() {
   const envPython = (process.env.PF_GATE_PYTHON || "").trim();
   const candidates = envPython ? [envPython, ...PYTHON_CANDIDATES] : PYTHON_CANDIDATES;
@@ -213,6 +349,7 @@ function installRuntime(runtimeRoot, source, cliVersion) {
       ...runtimePipArgs(runtimeRoot),
       "install",
       "--upgrade",
+      "--force-reinstall",
       source.wheelPath,
     ]);
   } else {
@@ -261,6 +398,10 @@ export async function runCli(args) {
     console.log(`args: ${JSON.stringify(args)}`);
     return;
   }
+  const updated = await maybeOfferCliUpdate(metadata);
+  if (updated) {
+    process.exit(0);
+  }
   const runtimeRoot = ensureRuntimeInstalled(metadata.version);
   const pythonPath = runtimePythonPath(runtimeRoot);
   const resolvedArgs = args.length === 0 ? ["Gate"] : args;

package/package.json

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