zigrix 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/doctor.js

@@ -19,6 +19,24 @@ export function gatherDoctor(loaded, paths) {
     const ruleFiles = fs.existsSync(rulesDir)
         ? fs.readdirSync(rulesDir).filter((f) => f.endsWith('.md')).sort()
         : [];
+    // Non-login shell PATH reachability check
+    const nonLoginShellPaths = ['/usr/local/bin', '/usr/bin', '/bin', '/usr/sbin', '/sbin'];
+    const zigrixInNonLoginPath = nonLoginShellPaths.some((dir) => {
+        try {
+            return fs.existsSync(path.join(dir, 'zigrix'));
+        }
+        catch {
+            return false;
+        }
+    });
+    const zigrixNonLoginLocation = nonLoginShellPaths.find((dir) => {
+        try {
+            return fs.existsSync(path.join(dir, 'zigrix'));
+        }
+        catch {
+            return false;
+        }
+    }) ?? null;
     const payload = {
         node: {
             executable: process.execPath,
@@ -61,6 +79,11 @@ export function gatherDoctor(loaded, paths) {
             skillsDir: openclawSkillsDir,
             skillsDirExists: fs.existsSync(openclawSkillsDir),
         },
+        pathReach: {
+            nonLoginShellPaths,
+            zigrixInNonLoginPath,
+            zigrixNonLoginLocation,
+        },
     };
     if (!payload.node.ok)
         warnings.push('Node.js 22+ is required.');
@@ -74,6 +97,10 @@ export function gatherDoctor(loaded, paths) {
         warnings.push('~/.openclaw not found. OpenClaw integration remains optional.');
     if (payload.rules.count === 0)
         warnings.push('No rule files found in rules directory. Seed from orchestration/rules/.');
+    if (!payload.pathReach.zigrixInNonLoginPath) {
+        warnings.push('zigrix is not reachable from non-login shell PATH (checked: /usr/local/bin, /usr/bin). ' +
+            'Run `zigrix onboard` or manually: sudo ln -sfn $(which zigrix) /usr/local/bin/zigrix');
+    }
     return {
         ...payload,
         summary: {
@@ -90,6 +117,7 @@ export function renderDoctorText(payload) {
         `- Config: ${payload.paths.configPath ?? 'missing'}`,
         `- Rules dir: ${payload.rules.dir} (${payload.rules.count} files)`,
         `- OpenClaw home: ${payload.openclaw.home} (${payload.openclaw.exists ? 'present' : 'missing'})`,
+        `- Non-login PATH reach: ${payload.pathReach.zigrixInNonLoginPath ? `yes (${payload.pathReach.zigrixNonLoginLocation})` : 'no'}`,
         `- Ready: ${payload.summary.ready ? 'yes' : 'no'}`,
     ];
     for (const warning of payload.summary.warnings) {

package/dist/onboard.d.ts

@@ -75,6 +75,12 @@ export declare function checkZigrixInPath(): boolean;
  * Works whether installed via npm link, npm install -g, or local checkout.
  */
 export declare function resolveZigrixBin(): string | null;
+/**
+ * Resolve a system-level bin directory that is writable and accessible
+ * from non-login shells (e.g., /usr/local/bin).
+ * Returns the first writable candidate, or null if none are writable.
+ */
+export declare function findSystemBinDir(): string | null;
 /**
  * Preferred user-local bin directory for symlink placement.
  * Returns the first writable directory from a priority list,
@@ -83,9 +89,15 @@ export declare function resolveZigrixBin(): string | null;
 export declare function findUserBinDir(): string;
 /**
  * Ensure zigrix is reachable from PATH.
- * If not found, creates a wrapper script in ~/.local/bin/.
+ * Priority:
+ *   1. /usr/local/bin — stable path, accessible from non-login shells (OpenClaw agents, exec)
+ *   2. ~/.local/bin   — user-local fallback; may not be in PATH, shows warning if so
+ *
+ * @param opts._overrideSystemBinDir - Override system bin dir selection (for testing)
  */
-export declare function ensureZigrixInPath(): PathStabilizeResult;
+export declare function ensureZigrixInPath(opts?: {
+    _overrideSystemBinDir?: string | null;
+}): PathStabilizeResult;
 /**
  * Find the skills/ directory bundled with this zigrix package.
  */

package/dist/onboard.js

@@ -161,6 +161,26 @@ export function resolveZigrixBin() {
     }
     return null;
 }
+/**
+ * Resolve a system-level bin directory that is writable and accessible
+ * from non-login shells (e.g., /usr/local/bin).
+ * Returns the first writable candidate, or null if none are writable.
+ */
+export function findSystemBinDir() {
+    const candidates = ['/usr/local/bin', '/usr/bin'];
+    for (const dir of candidates) {
+        try {
+            if (fs.existsSync(dir)) {
+                fs.accessSync(dir, fs.constants.W_OK);
+                return dir;
+            }
+        }
+        catch {
+            // not writable or inaccessible
+        }
+    }
+    return null;
+}
 /**
  * Preferred user-local bin directory for symlink placement.
  * Returns the first writable directory from a priority list,
@@ -190,9 +210,13 @@ export function findUserBinDir() {
 }
 /**
  * Ensure zigrix is reachable from PATH.
- * If not found, creates a wrapper script in ~/.local/bin/.
+ * Priority:
+ *   1. /usr/local/bin — stable path, accessible from non-login shells (OpenClaw agents, exec)
+ *   2. ~/.local/bin   — user-local fallback; may not be in PATH, shows warning if so
+ *
+ * @param opts._overrideSystemBinDir - Override system bin dir selection (for testing)
  */
-export function ensureZigrixInPath() {
+export function ensureZigrixInPath(opts) {
     if (checkZigrixInPath()) {
         return { alreadyInPath: true, symlinkCreated: false, symlinkPath: null, warning: null };
     }
@@ -205,6 +229,31 @@ export function ensureZigrixInPath() {
             warning: 'Could not locate zigrix entry point. Ensure zigrix is installed via npm.',
         };
     }
+    // ── Strategy 1: system bin dir (accessible from non-login shells) ──────────
+    const systemBinDir = opts !== undefined && '_overrideSystemBinDir' in opts
+        ? opts._overrideSystemBinDir
+        : findSystemBinDir();
+    if (systemBinDir) {
+        const symlinkPath = path.join(systemBinDir, 'zigrix');
+        try {
+            // Remove stale entry if present
+            try {
+                if (fs.existsSync(symlinkPath) || fs.lstatSync(symlinkPath).isSymbolicLink()) {
+                    fs.unlinkSync(symlinkPath);
+                }
+            }
+            catch {
+                // doesn't exist — fine
+            }
+            fs.symlinkSync(binEntry, symlinkPath);
+            fs.chmodSync(symlinkPath, 0o755);
+            return { alreadyInPath: false, symlinkCreated: true, symlinkPath, warning: null };
+        }
+        catch {
+            // Fall through to user bin dir
+        }
+    }
+    // ── Strategy 2: user-local bin dir ────────────────────────────────────────
     const userBinDir = findUserBinDir();
     try {
         fs.mkdirSync(userBinDir, { recursive: true });
@@ -218,8 +267,6 @@ export function ensureZigrixInPath() {
         };
     }
     const symlinkPath = path.join(userBinDir, 'zigrix');
-    // Create a wrapper script that invokes node with the correct entry
-    const wrapper = `#!/usr/bin/env node\nimport('${binEntry.replace(/\\/g, '/')}');\n`;
     try {
         // Remove existing if present (stale symlink or old wrapper)
         if (fs.existsSync(symlinkPath) || fs.lstatSync(symlinkPath).isSymbolicLink()) {
@@ -230,7 +277,6 @@ export function ensureZigrixInPath() {
         // doesn't exist, fine
     }
     try {
-        // Prefer symlink to the actual CLI bin (simpler, no wrapper needed)
         fs.symlinkSync(binEntry, symlinkPath);
         fs.chmodSync(symlinkPath, 0o755);
     }
@@ -251,10 +297,9 @@ export function ensureZigrixInPath() {
     // Check if userBinDir is actually in PATH
     const pathEnv = process.env.PATH ?? '';
     const inPath = pathEnv.split(path.delimiter).some((d) => path.resolve(d) === path.resolve(userBinDir));
-    let warning = null;
-    if (!inPath) {
-        warning = `Created zigrix at ${symlinkPath}, but ${userBinDir} is not in your PATH. Add it:\n  export PATH="${userBinDir}:$PATH"`;
-    }
+    const warning = inPath
+        ? null
+        : `Created zigrix at ${symlinkPath}, but ${userBinDir} is not in your PATH. Add it:\n  export PATH="${userBinDir}:$PATH"`;
     return { alreadyInPath: false, symlinkCreated: true, symlinkPath, warning };
 }
 // ─── OpenClaw skill registration ──────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zigrix",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.2",
   "type": "module",
   "description": "Multi-project parallel task orchestration CLI for agent-assisted development",
   "license": "Apache-2.0",