zigrix 0.1.0-alpha.10 → 0.1.0-alpha.11

package/dist/onboard.js

@@ -382,6 +382,121 @@ export function ensureZigrixInPath(opts) {
         : `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 PATH check and stabilization ────────────────────────────────────
+export function checkOpenClawInPath(opts) {
+    const dirs = opts?._overrideStablePaths ?? STABLE_SHELL_PATHS;
+    for (const dir of dirs) {
+        try {
+            if (!fs.existsSync(dir))
+                continue;
+            const entries = fs.readdirSync(dir);
+            if (entries.includes('openclaw')) {
+                return true;
+            }
+        }
+        catch {
+            // skip unreadable dirs
+        }
+    }
+    return false;
+}
+/**
+ * Ensure openclaw is reachable from PATH.
+ * Same strategy as ensureZigrixInPath():
+ *   1. /usr/local/bin — stable path, accessible from non-login shells
+ *   2. ~/.local/bin   — user-local fallback
+ *
+ * @param opts._overrideSystemBinDir - Override system bin dir selection (for testing)
+ * @param opts._overrideStablePaths  - Override stable paths list (for testing)
+ */
+export function ensureOpenClawInPath(opts) {
+    if (checkOpenClawInPath({ _overrideStablePaths: opts?._overrideStablePaths })) {
+        return { alreadyInPath: true, symlinkCreated: false, symlinkPath: null, warning: null };
+    }
+    const binPath = resolveOpenClawBin();
+    if (!binPath) {
+        return {
+            alreadyInPath: false,
+            symlinkCreated: false,
+            symlinkPath: null,
+            warning: 'Could not locate openclaw binary. Ensure openclaw 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, 'openclaw');
+        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(binPath, symlinkPath);
+            fs.chmodSync(symlinkPath, 0o755);
+            return { alreadyInPath: false, symlinkCreated: true, symlinkPath, warning: null };
+        }
+        catch (e) {
+            if (e.code === 'EACCES') {
+                return {
+                    alreadyInPath: false,
+                    symlinkCreated: false,
+                    symlinkPath: null,
+                    warning: `Cannot write to ${systemBinDir} (permission denied). Run:\n  sudo ln -sfn ${binPath} ${symlinkPath}`,
+                };
+            }
+            // Fall through to user bin dir
+        }
+    }
+    // ── Strategy 2: user-local bin dir ────────────────────────────────────────
+    const userBinDir = findUserBinDir();
+    try {
+        fs.mkdirSync(userBinDir, { recursive: true });
+    }
+    catch {
+        return {
+            alreadyInPath: false,
+            symlinkCreated: false,
+            symlinkPath: null,
+            warning: `Could not create ${userBinDir}. Create it manually and add to PATH.`,
+        };
+    }
+    const symlinkPath = path.join(userBinDir, 'openclaw');
+    try {
+        // Remove existing if present (stale symlink)
+        if (fs.existsSync(symlinkPath) || fs.lstatSync(symlinkPath).isSymbolicLink()) {
+            fs.unlinkSync(symlinkPath);
+        }
+    }
+    catch {
+        // doesn't exist, fine
+    }
+    try {
+        fs.symlinkSync(binPath, symlinkPath);
+        fs.chmodSync(symlinkPath, 0o755);
+    }
+    catch (e) {
+        return {
+            alreadyInPath: false,
+            symlinkCreated: false,
+            symlinkPath: null,
+            warning: `Failed to create symlink at ${symlinkPath}: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+    // 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));
+    const warning = inPath
+        ? null
+        : `Created openclaw 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 ──────────────────────────────────────────────
 /**
  * Find the skills/ directory bundled with this zigrix package.
@@ -719,7 +834,22 @@ export async function runOnboard(options) {
             log(`✅ OpenClaw config persisted (home: ${openclawHome}, bin: ${openclawBinPath ?? 'not found'})`);
         }
     }
-    // 7. Register OpenClaw skills (symlink skill packs)
+    // 7. Stabilize PATH — ensure openclaw is reachable from non-login shells
+    let openclawPathResult = { alreadyInPath: false, symlinkCreated: false, symlinkPath: null, warning: null };
+    if (openclawBinPath) {
+        openclawPathResult = ensureOpenClawInPath();
+        if (openclawPathResult.symlinkCreated) {
+            log(`✅ openclaw symlinked to ${openclawPathResult.symlinkPath}`);
+        }
+        else if (openclawPathResult.alreadyInPath) {
+            log('✅ openclaw already in PATH');
+        }
+        if (openclawPathResult.warning) {
+            warnings.push(openclawPathResult.warning);
+            log(`⚠️  ${openclawPathResult.warning}`);
+        }
+    }
+    // 8. Register OpenClaw skills (symlink skill packs)
     let skillsRegistered = [];
     let skillsSkipped = [];
     let skillsFailed = [];
@@ -763,9 +893,11 @@ export async function runOnboard(options) {
         skillsSkipped,
         skillsFailed,
         pathStabilized: pathResult,
+        openclawPathStabilized: openclawPathResult,
         warnings,
         checks: {
             zigrixInPath: pathResult.alreadyInPath || pathResult.symlinkCreated,
+            openclawInPath: openclawPathResult.alreadyInPath || openclawPathResult.symlinkCreated,
             openclawSkillsDir: openclawSkillsDirExists,
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zigrix",
-  "version": "0.1.0-alpha.10",
+  "version": "0.1.0-alpha.11",
   "type": "module",
   "description": "Multi-project parallel task orchestration CLI for agent-assisted development",
   "license": "Apache-2.0",
@@ -23,7 +23,7 @@
     "prebuild": "npm run clean",
     "prepack": "npm run build && npm run build:dashboard",
     "publish:check": "npm run build && npm run build:dashboard && npm run test && npm run smoke && bash scripts/release-smoke.sh && npm pack --dry-run",
-    "smoke": "node dist/index.js --version && node dist/index.js config validate --json",
+    "smoke": "node dist/index.js --version",
     "pretest": "npm run build",
     "test": "vitest run",
     "typecheck": "tsc -p tsconfig.json --noEmit"

package/rules/defaults/pro-zig.md

@@ -41,7 +41,7 @@
 15. execution unit 완료 시 `orch_complete_worker.py`에 같은 `--unit-id`를 넘겨 `unit_done` + evidence(unitId 포함)를 남긴다.
 16. finalize 전 `executionUnits[].status`가 전부 `DONE`인지 확인해야 하며, 미완료 unit이 있으면 완료 보고 금지.
 17. 중단 복구 판단은 session 문맥이 아니라 `meta.json.executionUnits[]`를 우선한다.
-18. **Git Workflow Policy 준수 (2026-03-17):** 프로젝트 작업 시 `/Users/janos/.openclaw/public-knowledge/policies/git-workflow.md`를 반드시 따른다. GitHub 원격 저장소가 연결된 프로젝트는 기본 브랜치에서 직접 작업/commit/push 하지 않고, 신규 브랜치에서 작업 후 commit + PR까지를 기본 완료선으로 삼는다.
+18. **Git Workflow Policy 준수 (2026-03-17):** 프로젝트 작업 시 `/Users/janos/.openclaw/public-knowledge/policies/git-workflow.md`를 반드시 따른다. GitHub 원격 저장소가 연결된 프로젝트는 기본 브랜치(main, master)에서 직접 작업/commit/push 하지 않고, 신규 브랜치에서 작업 후 commit + PR까지를 기본 완료선으로 삼는다.
 19. **상태 불변성 하드가드 (2026-03-17):** `/Users/janos/.openclaw/public-knowledge/policies/task-status-policy.md`를 따른다. task가 `REPORTED`가 된 이후에는 어떤 후속 completion/event가 와도 상태를 `DONE_PENDING_REPORT`/`IN_PROGRESS`/`BLOCKED`로 되돌리지 않는다. `REPORTED`는 terminal state이며, 후행 이벤트는 NO-OP(로그만) 처리한다.
 20. **Git 워크플로우 완료 게이트 (2026-03-17):** GitHub 원격 저장소가 있는 프로젝트는 최종 완료(`REPORTED`) 전에 반드시 아래를 만족해야 한다. 하나라도 불충족이면 완료 보고 금지.
     - 작업 브랜치가 `main/master`가 아닐 것

package/rules/defaults/worker-common.md

@@ -13,7 +13,7 @@
 6. **모든 문제는 근본적인 해결을 원칙으로 한다. 임시방편(workaround) 금지.**
 7. **오케스트레이션 필수 (이후락 고정, 2026-03-04):** 오케스트레이션에 등록(`orchestration/tasks/<taskId>.md` 존재)되지 않은 작업은 수행 거부. taskId가 있더라도 오케스트레이션 미등록이면 pro-zig에 확인 요청.
 8. **스크립트 체인 정합 (2026-03-11):** 구 worker lifecycle 스크립트(`dev_worker_dispatch.py`, `dev_worker_start.py`, `dev_worker_done.py`)는 제거됐다. 워커 lifecycle 기록(`worker_dispatched`/`worker_done`/`worker_skipped`)은 pro-zig가 `orch_prepare_worker.py → orch_register_worker.py → orch_complete_worker.py` 체인으로 처리한다.
-9. **Git Workflow Policy 준수 (2026-03-17):** 프로젝트 작업 시 `/Users/janos/.openclaw/public-knowledge/policies/git-workflow.md`를 반드시 따른다. 기본 브랜치 직접 작업/commit/push 금지, GitHub 원격이 있으면 브랜치 작업 후 PR 제출이 기본이다.
+9. **Git Workflow Policy 준수 (2026-03-17):** 프로젝트 작업 시 `/Users/janos/.openclaw/public-knowledge/policies/git-workflow.md`를 반드시 따른다. 기본 브랜치(main, master) 직접 작업/commit/push 금지, GitHub 원격이 있으면 브랜치 작업 후 PR 제출이 기본이다.
 10. **완료 상태 불변성 (2026-03-17):** `/Users/janos/.openclaw/public-knowledge/policies/task-status-policy.md`를 따른다. `REPORTED` task에 대한 후행 completion/event는 상태 전이를 만들지 않는다. 워커는 중복 완료 알림이 와도 추가 상태 변경 시도를 하지 않고 NO-OP로 처리한다.
 
 ## 3) Project Path Policy (고정)