zelari-code 1.19.0 → 1.20.0

package/dist/cli/main.bundled.js

@@ -16596,12 +16596,20 @@ function isWslBashPath(p3) {
     return true;
   return false;
 }
+function isPowerShellPath(p3) {
+  if (!p3 || typeof p3 !== "string")
+    return false;
+  const lower = p3.toLowerCase().trim();
+  return POWERSHELL_EXES.some((exe) => lower.endsWith(exe));
+}
 function acceptBashPath(p3) {
   if (!p3 || p3.trim().length === 0)
     return null;
   const trimmed = p3.trim();
   if (isWslBashPath(trimmed))
     return null;
+  if (isPowerShellPath(trimmed))
+    return null;
   if (!existsSyncSafe(trimmed))
     return null;
   return trimmed;
@@ -16610,19 +16618,24 @@ function resolveShell(forceReResolve = false) {
   if (memoized && !forceReResolve)
     return memoized;
   if (process.platform !== "win32") {
-    memoized = { shell: true, via: "/bin/sh", isBash: false };
+    memoized = { shell: true, via: "/bin/sh", isBash: false, isPowerShell: false };
     return memoized;
   }
-  const found = resolveBashWindows();
-  if (found) {
-    memoized = { shell: found, via: `bash (${found})`, isBash: true };
+  const bashFound = resolveBashWindows();
+  if (bashFound) {
+    memoized = { shell: bashFound, via: `bash (${bashFound})`, isBash: true, isPowerShell: false };
+    return memoized;
+  }
+  const psFound = resolvePowerShellWindows();
+  if (psFound) {
+    memoized = { shell: psFound, via: `powershell (${psFound})`, isBash: false, isPowerShell: true };
     return memoized;
   }
   if (!warnedFallback) {
     warnedFallback = true;
     console.error("[zelari-code] bash tool: Git Bash not found \u2014 falling back to cmd.exe. POSIX commands (ls, which, $VAR, &&) may fail. Install Git for Windows or set ZELARI_SHELL to your bash binary for proper POSIX support.");
   }
-  memoized = { shell: true, via: "cmd.exe", isBash: false };
+  memoized = { shell: true, via: "cmd.exe", isBash: false, isPowerShell: false };
   return memoized;
 }
 function resolveBashWindows() {
@@ -16650,6 +16663,42 @@ function resolveBashWindows() {
   }
   return null;
 }
+function acceptPowerShellPath(p3) {
+  if (!p3 || p3.trim().length === 0)
+    return null;
+  const trimmed = p3.trim();
+  if (isWslBashPath(trimmed))
+    return null;
+  if (!isPowerShellPath(trimmed))
+    return null;
+  if (!existsSyncSafe(trimmed))
+    return null;
+  return trimmed;
+}
+function resolvePowerShellWindows() {
+  const fromEnv = acceptPowerShellPath(process.env.ZELARI_SHELL);
+  if (fromEnv)
+    return fromEnv;
+  for (const p3 of STANDARD_POWERSHELL_PATHS) {
+    const accepted = acceptPowerShellPath(p3);
+    if (accepted)
+      return accepted;
+  }
+  try {
+    for (const name of POWERSHELL_EXES) {
+      const result = spawnSync("where", [name], { encoding: "utf-8", windowsHide: true });
+      if (result.status === 0 && result.stdout) {
+        for (const line of result.stdout.split(/\r?\n/)) {
+          const accepted = acceptPowerShellPath(line);
+          if (accepted)
+            return accepted;
+        }
+      }
+    }
+  } catch {
+  }
+  return null;
+}
 function existsSyncSafe(p3) {
   try {
     return existsSync4(p3);
@@ -16657,7 +16706,7 @@ function existsSyncSafe(p3) {
     return false;
   }
 }
-var STANDARD_BASH_PATHS, memoized, warnedFallback;
+var STANDARD_BASH_PATHS, POWERSHELL_EXES, STANDARD_POWERSHELL_PATHS, memoized, warnedFallback;
 var init_shellResolver = __esm({
   "packages/core/dist/core/tools/builtin/shellResolver.js"() {
     "use strict";
@@ -16667,6 +16716,13 @@ var init_shellResolver = __esm({
       "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
       "C:\\Program Files (x86)\\Git\\usr\\bin\\bash.exe"
     ];
+    POWERSHELL_EXES = ["pwsh.exe", "powershell.exe"];
+    STANDARD_POWERSHELL_PATHS = [
+      "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
+      "C:\\Program Files\\PowerShell\\7\\powershell.exe",
+      "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
+      "C:\\Windows\\SysWOW64\\WindowsPowerShell\\v1.0\\powershell.exe"
+    ];
     memoized = null;
     warnedFallback = false;
   }
@@ -16731,6 +16787,14 @@ var init_shell = __esm({
               env,
               stdio: ["ignore", "pipe", "pipe"]
             });
+          } else if (resolved.isPowerShell) {
+            child = spawn(resolved.shell, ["-Command", args.command], {
+              cwd,
+              signal: ctx.signal,
+              shell: false,
+              env: baseEnv,
+              stdio: ["ignore", "pipe", "pipe"]
+            });
           } else {
             child = spawn(args.command, {
               shell: resolved.shell,
@@ -19551,7 +19615,7 @@ var init_AgentHarness = __esm({
         this.eventBus = config2.eventBus;
         this.sessionId = config2.sessionId ?? crypto.randomUUID();
         this.maxQueuedIterations = config2.maxQueuedIterations ?? 3;
-        this.maxToolLoopIterations = config2.maxToolLoopIterations ?? 30;
+        this.maxToolLoopIterations = config2.maxToolLoopIterations ?? 60;
         const soft = this.maxToolLoopIterations;
         const hardCfg = config2.maxToolLoopHardCap;
         this.maxToolLoopHardCap = typeof hardCfg === "number" && hardCfg > 0 ? Math.max(soft, hardCfg) : Math.max(soft * 3, soft + 60);
@@ -32759,6 +32823,7 @@ __export(prereqChecks_exports, {
   checkAgentGit: () => checkAgentGit,
   checkAgentNode: () => checkAgentNode,
   checkMainNode: () => checkMainNode,
+  isPowerShellPath: () => isPowerShellPath2,
   isWslBashPath: () => isWslBashPath2,
   runPrereqChecks: () => runPrereqChecks
 });
@@ -32773,33 +32838,72 @@ function isWslBashPath2(p3) {
   if (n.includes("\\windowsapps\\bash.exe")) return true;
   return false;
 }
+function isPowerShellPath2(p3) {
+  if (!p3 || typeof p3 !== "string") return false;
+  const lower = p3.toLowerCase().trim();
+  return POWERSHELL_EXES2.some((exe) => lower.endsWith(exe));
+}
 function acceptBashPath2(p3) {
   if (!p3 || p3.trim().length === 0) return null;
   const trimmed = p3.trim();
   if (isWslBashPath2(trimmed)) return null;
+  if (isPowerShellPath2(trimmed)) return null;
   if (!existsSyncSafe2(trimmed)) return null;
   return trimmed;
 }
+function acceptPowerShellPath2(p3) {
+  if (!p3 || p3.trim().length === 0) return null;
+  const trimmed = p3.trim();
+  if (isWslBashPath2(trimmed)) return null;
+  if (!isPowerShellPath2(trimmed)) return null;
+  if (!existsSyncSafe2(trimmed)) return null;
+  return trimmed;
+}
+function resolvePowerShellWindowsSync() {
+  const fromEnv = acceptPowerShellPath2(process.env.ZELARI_SHELL);
+  if (fromEnv) return fromEnv;
+  for (const p3 of STANDARD_POWERSHELL_PATHS2) {
+    const accepted = acceptPowerShellPath2(p3);
+    if (accepted) return accepted;
+  }
+  try {
+    for (const name of POWERSHELL_EXES2) {
+      const result = spawnSync2("where", [name], {
+        encoding: "utf8",
+        windowsHide: true
+      });
+      if (result.status === 0 && result.stdout) {
+        for (const line of result.stdout.split(/\r?\n/)) {
+          const accepted = acceptPowerShellPath2(line);
+          if (accepted) return accepted;
+        }
+      }
+    }
+  } catch {
+  }
+  return null;
+}
 function resolveAgentShellSync() {
   if (process.platform !== "win32") {
-    return { bashPath: null, isBash: true, via: "/bin/sh" };
+    return { bashPath: null, isBash: true, isPowerShell: false, via: "/bin/sh" };
   }
   const fromEnv = acceptBashPath2(process.env.ZELARI_SHELL);
   if (fromEnv) {
-    return { bashPath: fromEnv, isBash: true, via: `bash (${fromEnv})` };
+    return { bashPath: fromEnv, isBash: true, isPowerShell: false, via: `bash (${fromEnv})` };
   }
   const fromSession = acceptBashPath2(process.env.SHELL);
   if (fromSession) {
     return {
       bashPath: fromSession,
       isBash: true,
+      isPowerShell: false,
       via: `bash (${fromSession})`
     };
   }
   for (const p3 of STANDARD_BASH_PATHS2) {
     const accepted = acceptBashPath2(p3);
     if (accepted) {
-      return { bashPath: accepted, isBash: true, via: `bash (${accepted})` };
+      return { bashPath: accepted, isBash: true, isPowerShell: false, via: `bash (${accepted})` };
     }
   }
   try {
@@ -32814,6 +32918,7 @@ function resolveAgentShellSync() {
           return {
             bashPath: accepted,
             isBash: true,
+            isPowerShell: false,
             via: `bash (${accepted})`
           };
         }
@@ -32821,7 +32926,11 @@ function resolveAgentShellSync() {
     }
   } catch {
   }
-  return { bashPath: null, isBash: false, via: "cmd.exe" };
+  const psFound = resolvePowerShellWindowsSync();
+  if (psFound) {
+    return { bashPath: psFound, isBash: false, isPowerShell: true, via: `powershell (${psFound})` };
+  }
+  return { bashPath: null, isBash: false, isPowerShell: false, via: "cmd.exe" };
 }
 function agentProbeEnv() {
   const env = { ...process.env };
@@ -32853,15 +32962,28 @@ function probeTool(tool) {
   let stdout = "";
   const env = agentProbeEnv();
   if (shell.bashPath) {
-    try {
-      const r = spawnSync2(shell.bashPath, ["-c", `${tool} --version`], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "ignore"],
-        windowsHide: true,
-        env
-      });
-      if (r.status === 0) stdout = (r.stdout || "").trim();
-    } catch {
+    if (shell.isPowerShell) {
+      try {
+        const r = spawnSync2(shell.bashPath, ["-Command", `${tool} --version`], {
+          encoding: "utf8",
+          stdio: ["ignore", "pipe", "ignore"],
+          windowsHide: true,
+          env
+        });
+        if (r.status === 0) stdout = (r.stdout || "").trim();
+      } catch {
+      }
+    } else {
+      try {
+        const r = spawnSync2(shell.bashPath, ["-c", `${tool} --version`], {
+          encoding: "utf8",
+          stdio: ["ignore", "pipe", "ignore"],
+          windowsHide: true,
+          env
+        });
+        if (r.status === 0) stdout = (r.stdout || "").trim();
+      } catch {
+      }
     }
   } else if (process.platform === "win32") {
     try {
@@ -32982,11 +33104,19 @@ function checkAgentBash() {
       message: `real bash available (${shell.via})`
     };
   }
+  if (shell.isPowerShell) {
+    return {
+      ok: true,
+      severity: "warn",
+      tool: "bash",
+      message: `PowerShell available (${shell.via}) \u2014 works as bash replacement`
+    };
+  }
   return {
     ok: false,
     severity: "warn",
     tool: "bash",
-    message: "no Git Bash \u2014 bash tool uses cmd.exe (install Git for Windows or set ZELARI_SHELL). Details: zelari-code --doctor"
+    message: "no Git Bash or PowerShell \u2014 bash tool uses cmd.exe (install Git for Windows, or set ZELARI_SHELL). Details: zelari-code --doctor"
   };
 }
 function checkMainNode() {
@@ -33047,7 +33177,7 @@ function runPrereqChecks(opts = { mode: "preflight" }) {
   void opts.mode;
   return { results, hasCriticalFail, warnings };
 }
-var MIN_NODE_MAJOR, STANDARD_BASH_PATHS2;
+var MIN_NODE_MAJOR, STANDARD_BASH_PATHS2, POWERSHELL_EXES2, STANDARD_POWERSHELL_PATHS2;
 var init_prereqChecks = __esm({
   "src/cli/utils/prereqChecks.ts"() {
     "use strict";
@@ -33058,6 +33188,13 @@ var init_prereqChecks = __esm({
       "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
       "C:\\Program Files (x86)\\Git\\usr\\bin\\bash.exe"
     ];
+    POWERSHELL_EXES2 = ["pwsh.exe", "powershell.exe"];
+    STANDARD_POWERSHELL_PATHS2 = [
+      "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
+      "C:\\Program Files\\PowerShell\\7\\powershell.exe",
+      "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
+      "C:\\Windows\\SysWOW64\\WindowsPowerShell\\v1.0\\powershell.exe"
+    ];
   }
 });
 
@@ -33464,6 +33601,43 @@ function checkPath() {
 ` + (process.platform === "win32" ? winHint : posixHint)
   );
 }
+function checkBudget() {
+  const expected = {
+    ZELARI_MAX_TOOL_LOOP_HARD: "180",
+    ZELARI_MAX_TOOL_LOOP_ITERATIONS: "60",
+    ZELARI_CONTEXT_LIMIT: "400000"
+  };
+  const missing = [];
+  const wrong = [];
+  for (const [name, target] of Object.entries(expected)) {
+    const current = process.env[name];
+    if (current === void 0 || current === "") missing.push(name);
+    else if (current !== target) wrong.push(`${name}=${current} (recommended ${target})`);
+  }
+  if (missing.length === 0 && wrong.length === 0) {
+    return OK(`budget at recommended values (hard=180, soft=60, ctx=400k)`);
+  }
+  const lines = [];
+  if (missing.length > 0) {
+    lines.push(
+      `missing: ${missing.join(", ")} \u2014 agent uses tighter in-code defaults`
+    );
+  }
+  if (wrong.length > 0) {
+    lines.push(`override: ${wrong.join("; ")}`);
+  }
+  const winHint = `         fix:  zelari-code --fix-budget   (sets all three at User scope)
+               then open a NEW terminal for the changes to take effect`;
+  const posixHint = `         fix:  export ZELARI_MAX_TOOL_LOOP_HARD=180
+               export ZELARI_MAX_TOOL_LOOP_ITERATIONS=60
+               export ZELARI_CONTEXT_LIMIT=400000
+               (add to ~/.bashrc or ~/.zshrc to persist)`;
+  return WARN(
+    `${lines.join("\n")}
+         symptom: agent stops mid-task without completing (not rate limit)
+` + (process.platform === "win32" ? winHint : posixHint)
+  );
+}
 function prereqToCheckResult(r) {
   if (r.ok) return OK(r.message);
   return r.severity === "critical" ? FAIL(r.message, "critical") : WARN(r.message);
@@ -33513,6 +33687,10 @@ async function runDoctor() {
     { name: "node (agent shell)", run: () => prereqToCheckResult(checkAgentNode()) },
     { name: "git (agent shell)", run: () => prereqToCheckResult(checkAgentGit()) },
     { name: "bash", run: () => prereqToCheckResult(checkAgentBash()) },
+    // --- tool-budget sanity (v1.20.0) ---
+    // WARNS when the recommended ZELARI_* caps are unset/overridden, so users
+    // learn why the agent stops mid-task without completing. Points to --fix-budget.
+    { name: "budget", run: () => checkBudget() },
     // --- optional tool plugins (v1.5.0) ---
     // Playwright / eslint / ruff / LSP servers. WARN-only (never critical):
     // these power edge features that degrade silently when absent. Surfaced
@@ -33663,6 +33841,85 @@ var init_fixPath = __esm({
   }
 });
 
+// src/cli/utils/fixBudget.ts
+var fixBudget_exports = {};
+__export(fixBudget_exports, {
+  RECOMMENDED_BUDGET: () => RECOMMENDED_BUDGET,
+  repairWindowsBudget: () => repairWindowsBudget
+});
+import { spawnSync as spawnSync4 } from "node:child_process";
+function powershell2(script) {
+  try {
+    const res = spawnSync4(
+      "powershell.exe",
+      ["-NoProfile", "-NonInteractive", "-Command", script],
+      { encoding: "utf8" }
+    );
+    if (res.status === 0) return (res.stdout || "").trim();
+    return "";
+  } catch {
+    return "";
+  }
+}
+function repairWindowsBudget() {
+  if (process.platform !== "win32") {
+    const lines = Object.entries(RECOMMENDED_BUDGET).map(
+      ([k, v]) => `  export ${k}=${v}`
+    );
+    return {
+      ok: false,
+      error: `--fix-budget is Windows-only. On ${process.platform}, add to your shell profile (~/.bashrc or ~/.zshrc):
+${lines.join("\n")}`
+    };
+  }
+  const applied = [];
+  const skipped = [];
+  let writeFailed = false;
+  for (const [name, target] of Object.entries(RECOMMENDED_BUDGET)) {
+    const current = powershell2(
+      `[Environment]::GetEnvironmentVariable('${name}','User')`
+    );
+    if (current === target) {
+      skipped.push(name);
+      continue;
+    }
+    powershell2(
+      `[Environment]::SetEnvironmentVariable('${name}', ${JSON.stringify(target)}, 'User')`
+    );
+    const reread = powershell2(
+      `[Environment]::GetEnvironmentVariable('${name}','User')`
+    );
+    if (reread === target) {
+      applied.push(name);
+    } else {
+      writeFailed = true;
+    }
+  }
+  if (writeFailed) {
+    return {
+      ok: false,
+      error: "PowerShell write did not take effect for at least one variable (permission denied? run as the same user that owns the install)"
+    };
+  }
+  return {
+    ok: true,
+    alreadyOk: applied.length === 0,
+    applied,
+    skipped
+  };
+}
+var RECOMMENDED_BUDGET;
+var init_fixBudget = __esm({
+  "src/cli/utils/fixBudget.ts"() {
+    "use strict";
+    RECOMMENDED_BUDGET = {
+      ZELARI_MAX_TOOL_LOOP_HARD: "180",
+      ZELARI_MAX_TOOL_LOOP_ITERATIONS: "60",
+      ZELARI_CONTEXT_LIMIT: "400000"
+    };
+  }
+});
+
 // src/cli/main.ts
 import React15 from "react";
 import { render } from "ink";
@@ -37544,7 +37801,7 @@ function estimateHistoryTokens(messages) {
 }
 function resolveContextLimit() {
   return envNumber(process.env.ZELARI_CONTEXT_LIMIT, {
-    default: 2e5,
+    default: 4e5,
     min: 4e3,
     max: 2e6
   });
@@ -37553,7 +37810,7 @@ function applyBudgetPolicy(history2, phase2, opts) {
   const contextLimit = resolveContextLimit();
   const warnings = [];
   let historyTurns = phase2 === "plan" ? envNumber(process.env.ZELARI_HISTORY_TURNS, { default: 8, min: 0 }) : envNumber(process.env.ZELARI_HISTORY_TURNS, { default: 6, min: 0 });
-  let maxToolLoopIterations = phase2 === "plan" ? envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, { default: 40, min: 1 }) : envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, { default: 90, min: 1 });
+  let maxToolLoopIterations = phase2 === "plan" ? envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, { default: 60, min: 1 }) : envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, { default: 120, min: 1 });
   let hist = history2;
   let estimated = estimateHistoryTokens(hist);
   const sessionExtra = opts?.sessionTokens ?? 0;
@@ -37773,7 +38030,7 @@ _(${req.context})_` : "") + "\n\u2192 scegli dalla lista (il turno continua dopo
         const toolList = openAiTools.map((t) => `- ${t.function.name}: ${t.function.description}`).join("\n");
         const resolvedShell = resolveShell();
         const isWindows = process.platform === "win32";
-        const shellGuidance = resolvedShell.isBash ? `The bash tool runs commands via Git Bash / MSYS2 (${resolvedShell.shell}). Write POSIX commands: ls, grep, $VAR, &&, /c/Users/... all work.` : isWindows ? `The bash tool runs commands via cmd.exe (Git Bash not found). Write Windows-native commands: use dir (not ls), %VAR% (not $VAR), avoid POSIX-only syntax.` : `The bash tool runs commands via /bin/sh.`;
+        const shellGuidance = resolvedShell.isBash ? `The bash tool runs commands via Git Bash / MSYS2 (${resolvedShell.shell}). Write POSIX commands: ls, grep, $VAR, &&, /c/Users/... all work.` : resolvedShell.isPowerShell ? `The bash tool runs commands via PowerShell (${resolvedShell.shell}). Write PowerShell syntax: ls/cat/pwd aliases work, use \`\${env:VAR}\` (not %VAR%), pipe with |, && works in PS7+.` : isWindows ? `The bash tool runs commands via cmd.exe (Git Bash not found). Write Windows-native commands: use dir (not ls), %VAR% (not $VAR), avoid POSIX-only syntax.` : `The bash tool runs commands via /bin/sh.`;
         const nonInteractiveGuidance = "The shell is NON-INTERACTIVE (stdin closed): commands that prompt for input fail immediately. Always pass non-interactive flags (--yes, -y, --template, --force). If a scaffolder still insists on prompting (e.g. `npm create vite` in a non-empty directory), do NOT retry it \u2014 scaffold into a fresh empty subdirectory and move the files, or write package.json/configs/sources yourself with write_file, then run `npm install`.";
         const planPhaseBlock = workPhase === "plan" ? [
           "# Work Phase: PLAN",
@@ -43141,7 +43398,7 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
       workspaceContext: composed.workspaceContext,
       ...composed.ragContext ? { ragContext: composed.ragContext } : {},
       maxToolLoopIterations: envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, {
-        default: 30,
+        default: 60,
         min: 1
       }),
       ...(() => {
@@ -44036,9 +44293,31 @@ function pickRootComponent() {
     }
     process.exit(1);
   }
+  if (argv.includes("--fix-budget") || argv.includes("fix-budget")) {
+    const { repairWindowsBudget: repairWindowsBudget2 } = (init_fixBudget(), __toCommonJS(fixBudget_exports));
+    const result = repairWindowsBudget2();
+    const green = "\x1B[32m";
+    const red = "\x1B[31m";
+    const dim = "\x1B[2m";
+    const reset = "\x1B[0m";
+    if (result.ok) {
+      if (result.alreadyOk) {
+        console.log(`${green}\u2714${reset} budget variables already at recommended values (${result.skipped.join(", ")})`);
+      } else {
+        console.log(`${green}\u2714${reset} applied budget variables: ${result.applied.join(", ")}`);
+        if (result.skipped.length > 0) {
+          console.log(`${dim}already set: ${result.skipped.join(", ")}${reset}`);
+        }
+        console.log(`${dim}open a NEW terminal for the changes to take effect${reset}`);
+      }
+      process.exit(0);
+    }
+    console.error(`${red}\u2717${reset} ${result.error}`);
+    process.exit(1);
+  }
   if (argv.includes("--help") || argv.includes("-h")) {
     console.log(
-      "zelari-code \u2014 AI Council coding agent CLI.\n\nUsage: zelari-code [options]\n\nOptions:\n  --version, -v       Print version and exit\n  --help, -h          Print this help and exit\n  --doctor            Diagnose install health (shim, bundle, PATH, deps,\n                      node/git/bash in the agent shell)\n  --fix-path          Add the npm global prefix to the user PATH\n                      (Windows only; fixes 'command not found' after install)\n  --skip-checks       Skip the boot-time prerequisite check\n                      (alias for ZELARI_SKIP_PREFLIGHT=1)\n  --no-wizard         Skip the first-run wizard\n  --reset-config      Re-run the wizard (clears provider.json on commit)\n  --headless          Run a single task without mounting the TUI\n    --task <text>       Task prompt (required in headless mode)\n    --output json|plain Output format (default: json)\n    --mode agent|council|zelari  Dispatch mode (default: agent)\n    --council          Alias for --mode council\n    --phase plan|build  Work phase (default: build)\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n  --print-config      Print provider/model config as JSON (no secrets)\n  --plugins-status    JSON status of optional plugins (Playwright, eslint, \u2026)\n  --plugins-install <id>  Install plugin (playwright also fetches Chromium)\n    --cwd <path>       Workspace for -D installs (default: process.cwd())\n  --set-config        Persist provider/model/endpoint\n    --provider <id>    Set active provider\n    --model <id>       Set model for that provider\n    --endpoint <url>   Custom OpenAI-compatible base URL\n    --endpoint-clear   Remove custom endpoint override\n  --set-key           Store an API key (never printed back)\n    --provider <id>    Provider id (required)\n    --key <secret>     API key (required)\n  --discover-models   Refresh model list for a provider\n    --provider <id>    Provider (default: active)\n  --print-mcp         Print MCP server config (user + project)\n    --cwd <path>      Project root for .zelari/mcp.json\n  --set-mcp           Add/update an MCP server entry\n    --name <id>       Server name (required)\n    --command <bin>   Executable (required)\n    --args <json>     JSON array of args (optional)\n    --scope user|project  Default: user\n    --enabled true|false  Default: true\n    --cwd <path>      Required when scope=project\n  --set-mcp-preset    Install a named MCP preset (e.g. cua)\n    --preset cua      Cua Driver desktop computer-use (MCP)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-mcp        Remove an MCP server entry\n    --name <id> --scope user|project [--cwd <path>]\n  --print-ssh-targets Print SSH deploy/monitor targets\n  --set-ssh-target    Upsert target (--json '{...}' or flags)\n  --remove-ssh-target --id <id>\n  --test-ssh-target   --id <id>  (BatchMode ssh true)\n  --print-ssh-pubkey  --path <private-or-.pub>  (display public key)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1    Skip the first-run wizard\n  ZELARI_SKIP_PREFLIGHT=1  Skip the boot prerequisite check\n  ZELARI_NO_PLUGIN_PROMPT=1  Skip the boot plugin-install prompt\n  ANATHEMA_DEV=1        Disable background update check + preflight\n"
+      "zelari-code \u2014 AI Council coding agent CLI.\n\nUsage: zelari-code [options]\n\nOptions:\n  --version, -v       Print version and exit\n  --help, -h          Print this help and exit\n  --doctor            Diagnose install health (shim, bundle, PATH, deps,\n                      node/git/bash in the agent shell)\n  --fix-path          Add the npm global prefix to the user PATH\n                      (Windows only; fixes 'command not found' after install)\n  --fix-budget        Set recommended ZELARI_MAX_TOOL_LOOP_HARD=180,\n                      ZELARI_MAX_TOOL_LOOP_ITERATIONS=60, ZELARI_CONTEXT_LIMIT=400000\n                      at User scope (prevents the agent stopping mid-task)\n  --skip-checks       Skip the boot-time prerequisite check\n                      (alias for ZELARI_SKIP_PREFLIGHT=1)\n  --no-wizard         Skip the first-run wizard\n  --reset-config      Re-run the wizard (clears provider.json on commit)\n  --headless          Run a single task without mounting the TUI\n    --task <text>       Task prompt (required in headless mode)\n    --output json|plain Output format (default: json)\n    --mode agent|council|zelari  Dispatch mode (default: agent)\n    --council          Alias for --mode council\n    --phase plan|build  Work phase (default: build)\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n  --print-config      Print provider/model config as JSON (no secrets)\n  --plugins-status    JSON status of optional plugins (Playwright, eslint, \u2026)\n  --plugins-install <id>  Install plugin (playwright also fetches Chromium)\n    --cwd <path>       Workspace for -D installs (default: process.cwd())\n  --set-config        Persist provider/model/endpoint\n    --provider <id>    Set active provider\n    --model <id>       Set model for that provider\n    --endpoint <url>   Custom OpenAI-compatible base URL\n    --endpoint-clear   Remove custom endpoint override\n  --set-key           Store an API key (never printed back)\n    --provider <id>    Provider id (required)\n    --key <secret>     API key (required)\n  --discover-models   Refresh model list for a provider\n    --provider <id>    Provider (default: active)\n  --print-mcp         Print MCP server config (user + project)\n    --cwd <path>      Project root for .zelari/mcp.json\n  --set-mcp           Add/update an MCP server entry\n    --name <id>       Server name (required)\n    --command <bin>   Executable (required)\n    --args <json>     JSON array of args (optional)\n    --scope user|project  Default: user\n    --enabled true|false  Default: true\n    --cwd <path>      Required when scope=project\n  --set-mcp-preset    Install a named MCP preset (e.g. cua)\n    --preset cua      Cua Driver desktop computer-use (MCP)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-mcp        Remove an MCP server entry\n    --name <id> --scope user|project [--cwd <path>]\n  --print-ssh-targets Print SSH deploy/monitor targets\n  --set-ssh-target    Upsert target (--json '{...}' or flags)\n  --remove-ssh-target --id <id>\n  --test-ssh-target   --id <id>  (BatchMode ssh true)\n  --print-ssh-pubkey  --path <private-or-.pub>  (display public key)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1    Skip the first-run wizard\n  ZELARI_SKIP_PREFLIGHT=1  Skip the boot prerequisite check\n  ZELARI_NO_PLUGIN_PROMPT=1  Skip the boot plugin-install prompt\n  ANATHEMA_DEV=1        Disable background update check + preflight\n"
     );
     process.exit(0);
   }