zelari-code 1.3.0 → 1.5.0

package/dist/cli/utils/paths.js

@@ -1,4 +1,5 @@
 import { homedir } from 'node:os';
+import path from 'node:path';
 /**
  * shortenCwd — compact a directory path for one-line UI surfaces
  * (StatusBar, banner).
@@ -17,4 +18,50 @@ export function shortenCwd(p, maxLen = 40, home = homedir()) {
         return out;
     return `…${out.slice(-(maxLen - 1))}`;
 }
+/**
+ * relativePosix — relativize a path against a root and normalize to `/`.
+ *
+ * Why: `path.relative()` on win32 joins segments with backslashes. Every
+ * agent-facing surface (LSP tool results, diagnostic output) wants forward
+ * slashes — they match `file://` URIs, JSON, markdown, and every other path
+ * already shown to the model. Before this helper, two near-identical private
+ * functions (`relPath` in lsp/tools.ts, `relative` in diagnostics/engine.ts)
+ * called `path.relative` with zero normalization, producing `src\a.ts` on
+ * Windows where the rest of the output stream uses `src/a.ts`.
+ *
+ * Semantics:
+ *   - Returns the relative path when `to` is inside `from`.
+ *   - Returns `to` unchanged when it escapes the root (`..` traversal) or the
+ *     relativization fails, so absolute paths outside the project are shown
+ *     as-is rather than as a misleading `..\..\elsewhere`.
+ *   - Output always uses `/` regardless of platform separator.
+ *
+ * Not for: filesystem I/O (platform-native separators matter there) or URI
+ * construction (see lsp/protocol.ts `pathToUri`, which also percent-encodes).
+ *
+ * @param from  Anchor directory (typically the project root).
+ * @param to    Target file or directory (absolute, or already relative).
+ * @returns POSIX-style relative path, or `to` if it can't be relativized.
+ */
+export function relativePosix(from, to) {
+    try {
+        // Use the platform-specific path module explicitly rather than the
+        // default export. The default is bound to process.platform AT MODULE
+        // LOAD TIME — mutating process.platform later (e.g. in a test that
+        // simulates win32 on a Linux runner) does NOT rebind it, so
+        // path.relative would use posix semantics and fail on Windows paths.
+        // path.win32 / path.posix are stable platform-specific namespaces that
+        // work regardless of the host platform.
+        const p = process.platform === 'win32' ? path.win32 : path.posix;
+        const rel = p.relative(from, to);
+        if (!rel || rel.startsWith('..'))
+            return to;
+        // Normalize any platform separator to forward slashes. On win32 path.relative
+        // joins with '\\'; on POSIX it's already '/'. Either way, split on both.
+        return rel.split(/[\\/]/).join('/');
+    }
+    catch {
+        return to;
+    }
+}
 //# sourceMappingURL=paths.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/cli/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,MAAM,GAAG,EAAE,EAAE,OAAe,OAAO,EAAE;IACzE,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IACE,IAAI;QACJ,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,EAC3E,CAAC;QACD,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/cli/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,MAAM,GAAG,EAAE,EAAE,OAAe,OAAO,EAAE;IACzE,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IACE,IAAI;QACJ,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,EAC3E,CAAC;QACD,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,EAAU;IACpD,IAAI,CAAC;QACH,mEAAmE;QACnE,qEAAqE;QACrE,mEAAmE;QACnE,4DAA4D;QAC5D,qEAAqE;QACrE,uEAAuE;QACvE,wCAAwC;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACjE,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5C,8EAA8E;QAC9E,yEAAyE;QACzE,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

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.3.0",
+  "version": "1.5.0",
   "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",
@@ -16,6 +16,8 @@
     "bin",
     "dist",
     "scripts/postinstall.mjs",
+    "scripts/repair-path.mjs",
+    "scripts/*.ps1",
     "LICENSE",
     "README.md",
     "package.json"
@@ -45,7 +47,7 @@
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
-    "@zelari/core": "1.3.0",
+    "@zelari/core": "1.5.0",
     "@types/node": "^25.3.0",
     "@types/react": "^19.0.10",
     "esbuild": "^0.25.0",

package/scripts/diagnose-path.ps1

@@ -0,0 +1,22 @@
+$prefix = (npm config get prefix).Trim()
+Write-Host "npm prefix: $prefix"
+Write-Host ""
+Write-Host "=== Session PATH (npm-related) ==="
+$env:Path -split ';' | Where-Object { $_ -and ($_ -match 'npm' -or $_ -eq $prefix) }
+Write-Host ""
+Write-Host "=== User PATH (npm-related) ==="
+$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+$userPath -split ';' | Where-Object { $_ -and ($_ -match 'npm' -or $_ -eq $prefix) }
+Write-Host ""
+Write-Host "=== Machine PATH (npm-related) ==="
+$machinePath = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+$machinePath -split ';' | Where-Object { $_ -and ($_ -match 'npm' -or $_ -eq $prefix) }
+Write-Host ""
+Write-Host "=== Shims in prefix ==="
+Get-ChildItem "$prefix\zelari-code*" -ErrorAction SilentlyContinue | Select-Object Name, FullName
+Write-Host ""
+Write-Host "=== where.exe zelari-code ==="
+where.exe zelari-code 2>&1
+Write-Host ""
+Write-Host "=== Direct run ==="
+& "$prefix\zelari-code.cmd" --version

package/scripts/dump-path.ps1

@@ -0,0 +1,13 @@
+$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+Write-Host "User PATH length: $($userPath.Length)"
+Write-Host "Contains Z:\npm-global: $($userPath -like '*Z:\npm-global*')"
+Write-Host ""
+Write-Host "=== All User PATH entries ==="
+$i = 0
+$userPath -split ';' | ForEach-Object {
+  if ($_) { Write-Host ("{0,3}: [{1}]" -f $i++, $_) }
+}
+Write-Host ""
+Write-Host "=== Fresh merged PATH simulation ==="
+$merged = [Environment]::GetEnvironmentVariable('Path', 'Machine') + ';' + $userPath
+$merged -split ';' | Where-Object { $_ -match 'npm' -or $_ -eq 'Z:\npm-global' }

package/scripts/fix-path.ps1

@@ -0,0 +1,26 @@
+# Ensures npm global prefix is on the user PATH and reloads PATH in this session.
+$prefix = (npm config get prefix).Trim()
+$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+
+if ($userPath -notlike "*$prefix*") {
+  $updated = if ($userPath) { "$userPath;$prefix" } else { $prefix }
+  [Environment]::SetEnvironmentVariable('Path', $updated, 'User')
+  Write-Host "PATH aggiornato (registry): aggiunto $prefix"
+} else {
+  Write-Host "PATH registry gia contiene: $prefix"
+}
+
+# Reload full PATH from registry into this session (fixes stale terminals).
+$machinePath = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+$freshUserPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+$env:Path = "$machinePath;$freshUserPath"
+
+Write-Host ""
+Write-Host "Verifica:"
+where.exe zelari-code 2>$null
+if ($LASTEXITCODE -ne 0) {
+  Write-Error "zelari-code non trovato. Esegui: npm link (dalla root del repo)"
+  exit 1
+}
+
+zelari-code --version

package/scripts/path-length.ps1

@@ -0,0 +1,15 @@
+$machine = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+$user = [Environment]::GetEnvironmentVariable('Path', 'User')
+$merged = "$machine;$user"
+Write-Host "Machine PATH length: $($machine.Length)"
+Write-Host "User PATH length: $($user.Length)"
+Write-Host "Merged PATH length: $($merged.Length)"
+Write-Host "Session PATH length: $($env:Path.Length)"
+Write-Host ""
+Write-Host "Session has Z:\npm-global: $($env:Path -like '*Z:\npm-global*')"
+Write-Host ""
+# Count entries in session vs expected
+$sessionEntries = ($env:Path -split ';' | Where-Object { $_ }).Count
+$mergedEntries = ($merged -split ';' | Where-Object { $_ }).Count
+Write-Host "Session entries: $sessionEntries"
+Write-Host "Merged entries: $mergedEntries"

package/scripts/postinstall.mjs

@@ -41,6 +41,13 @@ import {
 import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 
+// Re-exported so existing imports (`import { repairWindowsPath } from
+// './postinstall.mjs'`) keep working. The implementation lives in
+// repair-path.mjs, which has no install-time side effects and is safe to
+// import in unit tests.
+import { repairWindowsPath } from './repair-path.mjs';
+export { repairWindowsPath };
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkgRoot = path.resolve(__dirname, '..');
 
@@ -163,6 +170,29 @@ function repairWindowsShim(prefix, pkgName) {
   return cmdWritten;
 }
 
+
+/**
+ * Thin wrapper around repairWindowsPath for the postinstall flow.
+ *
+ * Logs one of three outcomes (auto-fixed / already-ok / failed-but-continue)
+ * so the user understands what happened. Always non-fatal: a PATH write
+ * failure still leaves the install in a working state (the shim exists);
+ * the user can repair manually via `zelari-code --fix-path` later.
+ *
+ * @param {string} prefix  npm global prefix
+ */
+function ensureWindowsPath(prefix) {
+  if (process.platform !== 'win32') return;
+  const repaired = repairWindowsPath(prefix);
+  if (repaired) {
+    note(`added ${prefix} to the user PATH`);
+    note('open a NEW terminal for the change to take effect, then run `zelari-code --version`.');
+  }
+  // already-present or failed: silent on already-present (expected, common),
+  // and silent on failure because the warning block below covers the
+  // "command not found" symptom if it later bites the user.
+}
+
 const warn = (msg) => {
   // eslint-disable-next-line no-console
   console.warn(`[zelari-code postinstall] ${msg}`);
@@ -173,6 +203,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 +297,13 @@ 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}`);
+        ensureWindowsPath(prefix);
         note('open a NEW terminal and run `zelari-code --version` to confirm.');
+        checkGitAvailable();
         process.exit(0);
       }
     }
@@ -279,6 +354,8 @@ try {
 
   if (shimOk) {
     note(`shim OK: ${shimPath}`);
+    ensureWindowsPath(prefix);
+    checkGitAvailable();
     process.exit(0);
   }