@chikhamx/voidx 1.0.0 → 1.0.1

package/bin/postinstall.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+"use strict";
+
+// Lightweight environment check that runs after npm install.
+// Detects Python 3.11+ and prints a hint if missing. Never blocks installation.
+
+const { spawnSync } = require("child_process");
+
+function main() {
+  const probe = detectPython();
+  if (probe.ok) {
+    console.error(`\n✅ voidx: Python ${probe.versionText} found at "${probe.path}"\n`);
+    return;
+  }
+
+  console.error("\n⚠️  voidx requires Python 3.11+, but no compatible Python was found.\n");
+  console.error(hint());
+  console.error(`\nOnce Python 3.11+ is installed, voidx will bootstrap the rest on first run.\n`);
+}
+
+function detectPython() {
+  const candidates = [
+    "python3", "python",
+    "python3.13", "python3.12", "python3.11",
+  ];
+  if (process.platform === "win32") {
+    candidates.push("py");
+  }
+
+  for (const cmd of candidates) {
+    const args = process.platform === "win32" && cmd === "py" ? ["-3.11"] : [];
+    const result = spawnSync(cmd, [...args, "-c", "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}')"], {
+      encoding: "utf8",
+      windowsHide: true,
+    });
+    if (result.error || result.status !== 0) continue;
+    const versionText = (result.stdout || "").trim();
+    const match = /^(\d+)\.(\d+)\.\d+/.exec(versionText);
+    if (!match) continue;
+    const major = Number.parseInt(match[1], 10);
+    const minor = Number.parseInt(match[2], 10);
+    if (major > 3 || (major === 3 && minor >= 11)) {
+      return { ok: true, versionText, path: cmd };
+    }
+  }
+  return { ok: false };
+}
+
+function hint() {
+  if (process.platform === "darwin") {
+    return "  Install:  brew install python@3.12";
+  }
+  if (process.platform === "linux") {
+    return "  Install via your package manager, e.g.:\n" +
+           "    sudo apt install python3.12    (Debian/Ubuntu)\n" +
+           "    sudo dnf install python3.12    (Fedora)";
+  }
+  if (process.platform === "win32") {
+    return "  Install:  https://python.org/downloads";
+  }
+  return "  Install Python 3.11+ from https://python.org/downloads";
+}
+
+main();

package/bin/voidx.js

@@ -49,6 +49,9 @@ function selectPython(env) {
   const candidates = [
     { command: "python3", args: [], label: "python3" },
     { command: "python", args: [], label: "python" },
+    { command: "python3.13", args: [], label: "python3.13" },
+    { command: "python3.12", args: [], label: "python3.12" },
+    { command: "python3.11", args: [], label: "python3.11" },
   ];
   if (process.platform === "win32") {
     candidates.push({ command: "py", args: ["-3.11"], label: "py -3.11" });
@@ -66,14 +69,33 @@ function selectPython(env) {
     oldVersions.push(`${probe.versionText} at ${candidate.label}`);
   }
 
+  const hint = pythonHint();
   if (oldVersions.length > 0) {
-    throw new Error(`voidx requires Python 3.11+. Found ${oldVersions.join(", ")}.`);
+    throw new Error(
+      `voidx requires Python 3.11+. Found ${oldVersions.join(", ")}.\n${hint}`
+    );
   }
   throw new Error(
-    "voidx npm launcher requires Python 3.11+. Install Python or set VOIDX_PYTHON."
+    `voidx npm launcher requires Python 3.11+. ${hint}`
   );
 }
 
+function pythonHint() {
+  if (process.platform === "darwin") {
+    return "Install Python 3.11+ via: brew install python@3.12\n" +
+      "Or point to an existing install: VOIDX_PYTHON=/path/to/python3 voidx";
+  }
+  if (process.platform === "linux") {
+    return "Install Python 3.11+ via your package manager (apt/dnf).\n" +
+      "Or point to an existing install: VOIDX_PYTHON=/path/to/python3 voidx";
+  }
+  if (process.platform === "win32") {
+    return "Install Python 3.11+ from https://python.org/downloads\n" +
+      "Or: VOIDX_PYTHON=C:\\Python312\\python.exe voidx";
+  }
+  return "Install Python 3.11+ or set VOIDX_PYTHON.";
+}
+
 function probePython(candidate) {
   const code = [
     "import sys",
@@ -128,39 +150,63 @@ function ensureVenv(python, venvDir, env) {
 
   fs.mkdirSync(path.dirname(venvDir), { recursive: true });
   const venvPython = resolveVenvPython(venvDir);
-  if (!fs.existsSync(venvPython)) {
-    debug(env, `Creating npm-managed Python environment at ${venvDir}`);
-    runChecked(
+
+  const isFresh = !fs.existsSync(venvPython);
+  if (isFresh) {
+    console.error(
+      "\n⚙️  Setting up voidx environment (this only happens once)...\n"
+    );
+    const venvResult = spawnSync(
       python.command,
       [...python.args, "-m", "venv", venvDir],
-      "Failed to create the npm-managed Python environment.",
-      env
+      { encoding: "utf8", stdio: "inherit", windowsHide: true }
     );
+    if (venvResult.error) {
+      throw new Error(
+        `Failed to create the Python virtual environment: ${venvResult.error.message}`
+      );
+    }
+    if (venvResult.status !== 0) {
+      throw new Error(
+        "Failed to create the Python virtual environment. See errors above."
+      );
+    }
   }
 
-  debug(env, `Installing ${packageSpec} into ${venvDir}`);
-  runChecked(
-    venvPython,
-    ["-m", "pip", "install", "--upgrade", packageSpec],
-    `Failed to install ${packageSpec} into the npm-managed Python environment.`,
-    env
-  );
-  fs.writeFileSync(markerPath, marker);
-}
-
-function runChecked(command, args, errorMessage, env) {
-  const result = spawnSync(command, args, {
-    encoding: "utf8",
-    stdio: env.VOIDX_NPM_DEBUG === "1" ? "inherit" : "pipe",
-    windowsHide: true,
-  });
-  if (result.error) {
-    throw new Error(`${errorMessage} ${result.error.message}`);
-  }
-  if (result.status !== 0) {
-    const stderr = result.stderr ? result.stderr.trim() : "";
-    throw new Error(stderr ? `${errorMessage} ${stderr}` : errorMessage);
+  if (!fs.existsSync(executable) || readFile(markerPath) !== marker) {
+    console.error(
+      `\n📦 Downloading ${packageSpec} and dependencies… ` +
+        "(1–2 minutes on first run)\n"
+    );
+    const pipEnv = Object.assign({}, env, {
+      PIP_NO_INPUT: "1",
+      PIP_DISABLE_PIP_VERSION_CHECK: "1",
+      PYTHON_KEYRING_BACKEND: "keyring.backends.null.Keyring",
+    });
+    const result = spawnSync(
+      venvPython,
+      [
+        "-m",
+        "pip",
+        "install",
+        "--upgrade",
+        "--progress-bar",
+        "on",
+        packageSpec,
+      ],
+      { encoding: "utf8", stdio: "inherit", windowsHide: true, env: pipEnv }
+    );
+    if (result.error) {
+      throw new Error(
+        `Failed to install ${packageSpec}: ${result.error.message}`
+      );
+    }
+    if (result.status !== 0) {
+      throw new Error(`Failed to install ${packageSpec}. See errors above.`);
+    }
   }
+
+  fs.writeFileSync(markerPath, marker);
 }
 
 function resolveVenvDir(env) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chikhamx/voidx",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "npm launcher for voidx, a terminal AI coding agent.",
   "bin": {
     "voidx": "bin/voidx.js"
@@ -18,6 +18,7 @@
     "cli"
   ],
   "scripts": {
-    "check": "node --check bin/voidx.js"
+    "postinstall": "node bin/postinstall.js",
+    "check": "node --check bin/voidx.js && node --check bin/postinstall.js"
   }
 }