🚀 v4.0.4 - Enhanced installation with pipx support

- Added automatic detection of PEP 668 environments
- Implemented pipx as preferred installation method for Linux/macOS
- Added fallback to pip --user for externally managed environments
- Improved error messages with clear installation alternatives
- Added --break-system-packages as last resort option
- Updated NPM wrapper to handle all installation scenarios
- Enhanced update mechanism to detect and use correct tool

bin/checkEnv.js

@@ -28,9 +28,33 @@ function detectPip() {
   return null;
 }
 
+function detectPipx() {
+  if (checkCommand("pipx")) return "pipx";
+  return null;
+}
+
 function isSuperClaudeInstalled(pipCmd) {
   const result = run(pipCmd, ["show", "SuperClaude"]);
   return result.status === 0;
 }
 
-module.exports = { run, detectPython, detectPip, isSuperClaudeInstalled };
+function isSuperClaudeInstalledPipx() {
+  const result = run("pipx", ["list"]);
+  if (result.status === 0 && result.stdout) {
+    return result.stdout.toString().includes("SuperClaude");
+  }
+  return false;
+}
+
+function checkPythonEnvironment() {
+  // Check if we're in an externally managed environment (PEP 668)
+  const result = run("python3", ["-c", "import sysconfig; print(sysconfig.get_path('stdlib'))"]);
+  if (result.status === 0 && result.stdout) {
+    const stdlibPath = result.stdout.toString().trim();
+    const checkPep668 = run("test", ["-f", `${stdlibPath}/EXTERNALLY-MANAGED`]);
+    return checkPep668.status === 0;
+  }
+  return false;
+}
+
+module.exports = { run, detectPython, detectPip, detectPipx, isSuperClaudeInstalled, isSuperClaudeInstalledPipx, checkPythonEnvironment };