synfull 0.1.0 → 0.1.1

package/README.md

@@ -4,7 +4,7 @@ Synfull is a local-first host monitoring dashboard for Windows and Linux, provid
 
 ## Install from npm
 
-Requirements: Node.js 18+, Python 3.10+, and npm. The CLI creates its own Python virtual environment and installs the backend dependencies when needed. Linux requires Python build prerequisites when a dependency has no wheel for the host platform.
+Requirements: Node.js 18+, Python 3.10+, and npm. The CLI creates its own Python virtual environment and installs the backend dependencies when needed. On Ubuntu/Debian, install `python3-venv` (or the matching `python3.X-venv` package) if venv creation reports that pip is missing. Linux may also require build prerequisites when a dependency has no wheel for the host platform.
 
 ```sh
 npm install -g synfull

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synfull",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local-first cross-platform host monitoring dashboard",
   "license": "MIT",
   "type": "commonjs",

package/scripts/synfull.cjs

@@ -61,6 +61,25 @@ function ensureRuntime() {
     const python = pythonCommand()
     run(python.command, [...python.prefix, '-m', 'venv', path.join(APP_DIR, '.venv')])
   }
+  const pipAvailable = spawnSync(RUNTIME, ['-m', 'pip', '--version'], { stdio: 'ignore', windowsHide: true }).status === 0
+  if (!pipAvailable) {
+    const python = pythonCommand()
+    const repair = spawnSync(python.command, [...python.prefix, '-m', 'venv', '--upgrade-deps', '--upgrade', path.join(APP_DIR, '.venv')], {
+      encoding: 'utf8', windowsHide: true,
+    })
+    if (repair.status !== 0) {
+      const detail = (repair.stderr || repair.stdout || '').trim()
+      if (detail) console.error(detail)
+      const platformFix = WINDOWS
+        ? 'Repair or reinstall Python with its pip/venv components, then rerun `synfull setup`.'
+        : 'On Ubuntu/Debian install venv support (`sudo apt install python3-venv`, or the matching `python3.X-venv` package), remove the incomplete venv at ~/.local/share/synfull/app/.venv, then rerun `synfull setup`.'
+      throw new Error(`The Python virtual environment is missing pip. ${platformFix}`)
+    }
+  }
+  const pipReady = spawnSync(RUNTIME, ['-m', 'pip', '--version'], { stdio: 'ignore', windowsHide: true }).status === 0
+  if (!pipReady) {
+    throw new Error('The Python virtual environment still has no pip. Install the Python venv support package and recreate the runtime, then rerun `synfull setup`.')
+  }
   const requirementsPath = path.join(APP_DIR, 'backend', 'requirements-runtime.txt')
   const requirementsHash = crypto.createHash('sha256').update(fs.readFileSync(requirementsPath)).digest('hex')
   const installedHashPath = path.join(APP_DIR, '.runtime-requirements-hash')