@qpfai/pf-gate-cli 1.0.7 → 1.0.9

package/README.md

@@ -14,6 +14,7 @@ Open the PF Gate terminal UX:
 
 ```bash
 PF Gate
+pf gate
 ```
 
 Run direct CLI commands:

package/artifacts/python-wheel.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-02-16T21:34:13.939Z",
+  "generatedAt": "2026-02-16T21:44:07.077Z",
   "pythonPackage": "persons-field",
   "pythonPackageVersion": "1.0.0",
   "wheel": "persons_field-1.0.0-py3-none-any.whl",
-  "sha256": "d58d1a73aeed5ff6668afc553f9a4c651c7d999613afe49767a1f0258bd8586c"
+  "sha256": "4907460d6b40f0332da0f60d167343205609c422e6648c605116ffa44d058989"
 }

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) {
@@ -449,8 +525,13 @@ export async function runCli(args) {
   const runtimeRoot = ensureRuntimeInstalled(metadata.version);
   const pythonPath = runtimePythonPath(runtimeRoot);
   const resolvedArgs = args.length === 0 ? ["Gate"] : args;
+  const childEnv = {
+    ...process.env,
+    PF_GATE_CLI_VERSION: metadata.version,
+  };
   const child = spawnSync(pythonPath, runtimeLauncherArgs(resolvedArgs), {
     stdio: "inherit",
+    env: childEnv,
   });
   if (child.error) {
     throw child.error;

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@qpfai/pf-gate-cli",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "PF Gate terminal launcher with first-run runtime bootstrap.",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
     "PF": "bin/pf.mjs",
+    "pf": "bin/pf.mjs",
     "pf-gate": "bin/pf.mjs"
   },
   "files": [