zelari-code 1.2.0 → 1.4.1

package/dist/cli/utils/prereqChecks.js

@@ -0,0 +1,362 @@
+/**
+ * prereqChecks.ts — prerequisite detection that mirrors the agent's shell.
+ *
+ * Why this exists separately from `doctor.ts`:
+ *   The legacy `checkNode()` in doctor.ts probes `node --version` from the
+ *   zelari-code main process. On Windows that main process is a native Node
+ *   binary whose PATH always contains node (otherwise zelari-code wouldn't
+ *   be running). But the AGENT — the thing that actually runs `npm`,
+ *   `tsc`, build scripts — launches commands through the resolved shell
+ *   (Git Bash on Windows, see `resolveShell()` in shellResolver.ts), which
+ *   inherits a DIFFERENT PATH. A user can have node visible to the main
+ *   process yet invisible to the agent's bash (e.g. Node installed for
+ *   "current user" only, while Git Bash inherits the system PATH). The
+ *   legacy doctor check passes in that case and never warns — until the
+ *   agent tries `npm run build` and gets `node: not found`, mid-task.
+ *
+ *   These checks probe THROUGH the same shell the agent will use, so they
+ *   detect the real mismatch before it bites. They power:
+ *     - the boot-time preflight (src/cli/main.ts `runPreflight`),
+ *     - the `--doctor` "agent shell" rows (src/cli/utils/doctor.ts),
+ *     - the post-update prerequisite warnings (slashHandlers/updater.ts).
+ *
+ * Design contract (inherited from doctor.ts):
+ *   - NEVER throws. Every check catches its own errors and returns a
+ *     FAIL/WARN result. A broken prereq check must never crash the CLI.
+ *   - Sync API: doctor's `run()` loop is sync and we keep that shape.
+ *   - No dependency on @zelari/core: the bash-resolution chain is
+ *     replicated here (see `resolveAgentShellSync` below) so this module
+ *     works even when the core bundle is broken — which is exactly when a
+ *     user needs `--doctor` to diagnose the breakage.
+ *
+ * @see packages/core/src/core/tools/builtin/shellResolver.ts — the canonical
+ *      resolver; keep `resolveAgentShellSync` in sync with its detection chain.
+ * @see src/cli/utils/doctor.ts — the opt-in `zelari-code doctor` command.
+ */
+import { execSync, spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+/** Minimum Node major version (mirrors `engines.node` ">=20.0.0" in package.json). */
+const MIN_NODE_MAJOR = 20;
+/** Standard Git for Windows bash locations (mirrors shellResolver.STANDARD_BASH_PATHS). */
+const STANDARD_BASH_PATHS = [
+    "C:\\Program Files\\Git\\bin\\bash.exe",
+    "C:\\Program Files\\Git\\usr\\bin\\bash.exe",
+    "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
+    "C:\\Program Files (x86)\\Git\\usr\\bin\\bash.exe",
+];
+/**
+ * Resolve the shell the agent will use — SYNC version of `resolveShell()`.
+ *
+ * Replicated (not imported) so this module has no runtime dependency on
+ * @zelari/core. The detection order MUST stay in lockstep with
+ * `packages/core/src/core/tools/builtin/shellResolver.ts:resolveBashWindows`:
+ *   1. ZELARI_SHELL env var (explicit override)
+ *   2. SHELL env var (set by Git Bash / MSYS2 sessions)
+ *   3. Standard Git for Windows install paths (existsSync probe)
+ *   4. `where bash` (PATH lookup)
+ *   5. Fallback: cmd.exe on win32, /bin/sh on POSIX
+ */
+function resolveAgentShellSync() {
+    // POSIX: Node's `shell: true` already uses /bin/sh — bash-compatible enough.
+    if (process.platform !== "win32") {
+        return { bashPath: null, isBash: true, via: "/bin/sh" };
+    }
+    // 1. Explicit override.
+    const envShell = process.env.ZELARI_SHELL;
+    if (envShell && envShell.trim().length > 0 && existsSyncSafe(envShell)) {
+        return { bashPath: envShell, isBash: true, via: `bash (${envShell})` };
+    }
+    // 2. SHELL env var (Git Bash / MSYS2 sessions).
+    const sessionShell = process.env.SHELL;
+    if (sessionShell &&
+        sessionShell.trim().length > 0 &&
+        existsSyncSafe(sessionShell)) {
+        return {
+            bashPath: sessionShell,
+            isBash: true,
+            via: `bash (${sessionShell})`,
+        };
+    }
+    // 3. Standard install paths.
+    for (const p of STANDARD_BASH_PATHS) {
+        if (existsSyncSafe(p)) {
+            return { bashPath: p, isBash: true, via: `bash (${p})` };
+        }
+    }
+    // 4. `where bash` — PATH lookup. `where` ships with Windows as a real .exe.
+    try {
+        const result = spawnSync("where", ["bash"], {
+            encoding: "utf8",
+            windowsHide: true,
+        });
+        if (result.status === 0 && result.stdout) {
+            const first = result.stdout
+                .split(/\r?\n/)
+                .find((l) => l.trim().length > 0);
+            if (first && existsSyncSafe(first)) {
+                const trimmed = first.trim();
+                return { bashPath: trimmed, isBash: true, via: `bash (${trimmed})` };
+            }
+        }
+    }
+    catch {
+        // `where` unavailable or failed — fall through to cmd.exe.
+    }
+    // 5. Fallback: cmd.exe. POSIX commands (ls, which, $VAR) may fail here.
+    return { bashPath: null, isBash: false, via: "cmd.exe" };
+}
+/** existsSync that swallows edge-case errors (invalid chars on win32, etc.). */
+function existsSyncSafe(p) {
+    try {
+        return existsSync(p);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Probe `<tool> --version` through the agent's resolved shell.
+ *
+ * Returns the raw stdout (trimmed) and parsed semver, or empty strings when
+ * the tool isn't reachable. Never throws.
+ */
+function probeTool(tool) {
+    const shell = resolveAgentShellSync();
+    let stdout = "";
+    if (shell.bashPath) {
+        // Real bash (win32 Git Bash or explicit ZELARI_SHELL): spawn directly
+        // with `-c` so we get the EXACT environment the agent's `bash` tool
+        // gets — this is what catches the "node visible to main, invisible to
+        // bash" mismatch.
+        try {
+            const r = spawnSync(shell.bashPath, ["-c", `${tool} --version`], {
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "ignore"],
+                windowsHide: true,
+            });
+            if (r.status === 0)
+                stdout = (r.stdout || "").trim();
+            // status !== 0 means the tool isn't on bash's PATH (or errored) — leave stdout empty.
+        }
+        catch {
+            // spawn failure (e.g. bashPath stale) — fall through to empty.
+        }
+    }
+    else if (process.platform === "win32") {
+        // cmd.exe fallback (no Git Bash found). execSync with shell:true → cmd.exe.
+        try {
+            stdout = execSync(`${tool} --version`, {
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "ignore"],
+            }).trim();
+        }
+        catch {
+            // not on cmd's PATH either
+        }
+    }
+    else {
+        // POSIX non-bash (shouldn't happen — resolveAgentShellSync returns isBash:true on POSIX).
+        try {
+            stdout = execSync(`${tool} --version`, {
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "ignore"],
+            }).trim();
+        }
+        catch {
+            // ignore
+        }
+    }
+    const m = stdout.match(/(\d+)\.(\d+)\.(\d+)/);
+    return {
+        found: stdout.length > 0,
+        version: m ? `${m[1]}.${m[2]}.${m[3]}` : "",
+        raw: stdout,
+    };
+}
+/**
+ * Actionable fix hint when node isn't visible to the agent shell.
+ * OS-specific because the root cause differs (system vs user PATH on Windows;
+ * nvm symlink on macOS/Linux; missing install entirely).
+ */
+function nodeMissingHint() {
+    const shell = resolveAgentShellSync();
+    if (process.platform === "win32") {
+        return (`node is not reachable from the agent's shell (${shell.via}).\n` +
+            `         This usually means Node was installed for "current user" only,\n` +
+            `         while Git Bash inherits the SYSTEM Path. Fix (pick one):\n` +
+            `           - Reinstall Node (https://nodejs.org) and choose\n` +
+            `             "Add to PATH for all users", OR\n` +
+            `           - Add C:\\Program Files\\nodejs\\ to the SYSTEM Path\n` +
+            `             (System Properties → Environment Variables → Path), OR\n` +
+            `           - Set ZELARI_SHELL to a bash that already sees node.`);
+    }
+    return (`node is not on the agent's shell PATH.\n` +
+        `         Install Node >= ${MIN_NODE_MAJOR} (https://nodejs.org) or, if you use\n` +
+        `         nvm, run \`nvm use <version>\` and reopen this terminal.`);
+}
+/** Check `node` is reachable from the agent shell and meets the minimum version. */
+export function checkAgentNode() {
+    const probe = probeTool("node");
+    if (!probe.found) {
+        return {
+            ok: false,
+            severity: "critical",
+            tool: "node",
+            message: nodeMissingHint(),
+        };
+    }
+    const major = Number(probe.version.split(".")[0]);
+    if (!probe.version || Number.isNaN(major)) {
+        // node IS on PATH but version string looks weird — degrade to warn, don't hard-fail.
+        return {
+            ok: false,
+            severity: "warn",
+            tool: "node",
+            message: `could not parse node version from "${probe.raw}" (node is reachable, but version check skipped)`,
+        };
+    }
+    if (major < MIN_NODE_MAJOR) {
+        return {
+            ok: false,
+            severity: "critical",
+            tool: "node",
+            message: `node ${probe.version} is older than the required >= ${MIN_NODE_MAJOR}.0.0 (from engines.node). Upgrade: https://nodejs.org`,
+        };
+    }
+    return {
+        ok: true,
+        severity: "critical",
+        tool: "node",
+        message: `node ${probe.version} (agent shell)`,
+    };
+}
+/** Check `git` is reachable from the agent shell. Soft prereq (warn, not block). */
+export function checkAgentGit() {
+    const probe = probeTool("git");
+    if (!probe.found) {
+        const hint = process.platform === "win32"
+            ? `Install Git for Windows: https://git-scm.com/download/win`
+            : `Install git (e.g. \`brew install git\` on macOS, \`apt install git\` on Debian)`;
+        return {
+            ok: false,
+            severity: "warn",
+            tool: "git",
+            message: `git not found on the agent's shell PATH — /diff, /undo and the git sidebar will be disabled. ${hint}`,
+        };
+    }
+    return {
+        ok: true,
+        severity: "warn",
+        tool: "git",
+        message: `git ${probe.version} (agent shell)`,
+    };
+}
+/**
+ * Check that a real bash is available on Windows. When the resolver falls
+ * back to cmd.exe, POSIX commands (`ls`, `which`, `$VAR`, `&&`) will fail
+ * inside the agent's `bash` tool — confusing and hard to debug. Warn only.
+ */
+export function checkAgentBash() {
+    if (process.platform !== "win32") {
+        return {
+            ok: true,
+            severity: "warn",
+            tool: "bash",
+            message: "POSIX shell always available on this platform",
+        };
+    }
+    const shell = resolveAgentShellSync();
+    if (shell.isBash) {
+        return {
+            ok: true,
+            severity: "warn",
+            tool: "bash",
+            message: `real bash available (${shell.via})`,
+        };
+    }
+    return {
+        ok: false,
+        severity: "warn",
+        tool: "bash",
+        message: `no Git Bash found — the agent's \`bash\` tool falls back to cmd.exe,\n` +
+            `         where POSIX commands (ls, which, $VAR, &&) may fail. Install Git\n` +
+            `         for Windows (https://git-scm.com/download/win) or set ZELARI_SHELL\n` +
+            `         to your bash binary.`,
+    };
+}
+/**
+ * Probe `node --version` from the zelari-code main process (NOT the agent
+ * shell). Kept for differential diagnostics: if this passes but
+ * `checkAgentNode` fails, the problem is a PATH mismatch between the main
+ * process and the agent's bash — not a missing Node install.
+ */
+export function checkMainNode() {
+    try {
+        const raw = execSync("node --version", {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        const m = raw.match(/(\d+)\.(\d+)\.(\d+)/);
+        const version = m ? `${m[1]}.${m[2]}.${m[3]}` : "";
+        const major = Number(version.split(".")[0]);
+        if (version && !Number.isNaN(major) && major >= MIN_NODE_MAJOR) {
+            return {
+                ok: true,
+                severity: "critical",
+                tool: "node",
+                message: `node ${version} (main process)`,
+            };
+        }
+        return {
+            ok: false,
+            severity: "warn",
+            tool: "node",
+            message: `node present in main process but version unparseable or < ${MIN_NODE_MAJOR}: "${raw}"`,
+        };
+    }
+    catch {
+        return {
+            ok: false,
+            severity: "critical",
+            tool: "node",
+            message: "node not found on the main process PATH (zelari-code itself runs on node — this is unexpected)",
+        };
+    }
+}
+/**
+ * Run all prerequisite checks and aggregate. Never throws.
+ *
+ * @param opts.mode 'preflight' = boot-time gate (node critical, git/bash warn);
+ *                  'full' = same checks, used by `--doctor` for the full report.
+ *                  Currently identical; the flag is reserved for future
+ *                  heavier checks that shouldn't run on every boot.
+ */
+export function runPrereqChecks(opts = { mode: "preflight" }) {
+    const checks = [
+        () => checkAgentNode(),
+        () => checkAgentGit(),
+        () => checkAgentBash(),
+    ];
+    const results = [];
+    for (const run of checks) {
+        try {
+            results.push(run());
+        }
+        catch (err) {
+            // Defensive: a check throwing is itself a failure, never a crash.
+            results.push({
+                ok: false,
+                severity: "warn",
+                tool: "node",
+                message: `prereq check crashed: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    }
+    const hasCriticalFail = results.some((r) => !r.ok && r.severity === "critical");
+    const warnings = results.filter((r) => !r.ok && r.severity === "warn");
+    // Reference opts.mode so it stays meaningful even while behaviour is identical
+    // across modes today (reserved for future full-only checks).
+    void opts.mode;
+    return { results, hasCriticalFail, warnings };
+}
+//# sourceMappingURL=prereqChecks.js.map

package/dist/cli/utils/prereqChecks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prereqChecks.js","sourceRoot":"","sources":["../../../src/cli/utils/prereqChecks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zelari-code",
-  "version": "1.2.0",
+  "version": "1.4.1",
   "description": "Zelari Code — AI Council coding agent CLI. Multi-agent orchestration (Caronte, Nettuno, Gerione, Plutone, Minosse, Lucifero) with slash commands, provider-agnostic LLM streaming, and self-update.",
   "author": "N-THEM Studio",
   "license": "SEE LICENSE IN LICENSE",
@@ -40,17 +40,17 @@
     "ink": "^6.8.0",
     "ink-text-input": "^6.0.0",
     "react": "^19.2.7",
+    "typescript": "~5.7.2",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
-    "@zelari/core": "1.2.0",
+    "@zelari/core": "1.4.1",
     "@types/node": "^25.3.0",
     "@types/react": "^19.0.10",
     "esbuild": "^0.25.0",
     "jsdom": "^29.1.1",
     "react-dom": "^19.2.7",
-    "typescript": "~5.7.2",
     "vitest": "^4.1.9"
   },
   "keywords": [

package/scripts/postinstall.mjs

@@ -173,6 +173,49 @@ const note = (msg) => {
   console.warn(`[zelari-code postinstall] ${msg}`);
 };
 
+/**
+ * Best-effort git availability check (v1.4.0).
+ *
+ * git is not a hard prerequisite (zelari-code boots without it), but /diff,
+ * /undo and the live git sidebar all silently degrade to no-op when git is
+ * missing — which is confusing. Surface it once at install/update time so
+ * the user knows what they're missing and how to fix it. Node is NOT checked
+ * here: by definition npm (which requires node) just ran this script.
+ *
+ * Non-blocking, fail-safe: any error is swallowed. Mirrors the contract of
+ * the rest of this file (never throw, never fail the install).
+ */
+function checkGitAvailable() {
+  try {
+    let out = '';
+    try {
+      out = execSync('git --version', {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+      }).trim();
+    } catch {
+      // git not on PATH — fall through to the warning below.
+    }
+    if (!out) {
+      const hint =
+        process.platform === 'win32'
+          ? 'Install Git for Windows: https://git-scm.com/download/win'
+          : process.platform === 'darwin'
+            ? 'Install git: `brew install git` (or Xcode command-line tools)'
+            : 'Install git: `apt install git` (or your distro equivalent)';
+      warn('--------------------------------------------------------------');
+      warn(' git not found on PATH (optional but recommended).');
+      warn('--------------------------------------------------------------');
+      warn('  Without git, /diff, /undo and the git sidebar are disabled.');
+      warn(`  ${hint}`);
+      warn('  Run `zelari-code --doctor` after install to re-check.');
+      warn('--------------------------------------------------------------');
+    }
+  } catch {
+    // Even the check itself must never break the install.
+  }
+}
+
 try {
   // 0. Only run for global installs. Local installs (`npm install zelari-code`)
   //    create a `node_modules/.bin/zelari-code` symlink that npm handles
@@ -224,11 +267,12 @@ try {
     // Auto-repair the most common Windows failure: the package unpacked but
     // npm never created the bin shim. We only write shims that are MISSING,
     // and only under our own bin name → no risk of shadowing another tool.
-    if (isWin) {
+      if (isWin) {
       const repaired = repairWindowsShim(prefix, pkgName);
       if (repaired && existsSync(shimPath)) {
         note(`shim was missing — auto-created ${shimPath}`);
         note('open a NEW terminal and run `zelari-code --version` to confirm.');
+        checkGitAvailable();
         process.exit(0);
       }
     }
@@ -279,6 +323,7 @@ try {
 
   if (shimOk) {
     note(`shim OK: ${shimPath}`);
+    checkGitAvailable();
     process.exit(0);
   }