zelari-code 1.3.0 → 1.5.0

package/dist/cli/main.bundled.js

@@ -308,7 +308,7 @@ async function refreshGrokToken(options) {
   return parseTokenResponseBody(obj, accessToken);
 }
 async function openBrowser(url2) {
-  const { spawn: spawn8 } = await import("node:child_process");
+  const { spawn: spawn9 } = await import("node:child_process");
   const cmd = (() => {
     switch (process.platform) {
       case "darwin":
@@ -321,7 +321,7 @@ async function openBrowser(url2) {
   })();
   return new Promise((resolve, reject) => {
     try {
-      const child = spawn8(cmd.bin, cmd.args, {
+      const child = spawn9(cmd.bin, cmd.args, {
         stdio: "ignore",
         detached: true
       });
@@ -1535,10 +1535,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path33) {
-  if (!path33)
+function getElementAtPath(obj, path34) {
+  if (!path34)
     return obj;
-  return path33.reduce((acc, key) => acc?.[key], obj);
+  return path34.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -1866,11 +1866,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path33, issues) {
+function prefixIssues(path34, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path33);
+    iss.path.unshift(path34);
     return iss;
   });
 }
@@ -2088,16 +2088,16 @@ function flattenError(error51, mapper = (issue2) => issue2.message) {
 }
 function formatError(error51, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error52, path33 = []) => {
+  const processError = (error52, path34 = []) => {
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path33, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path34, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path33, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path34, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path33, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path34, ...issue2.path]);
       } else {
-        const fullpath = [...path33, ...issue2.path];
+        const fullpath = [...path34, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -2124,17 +2124,17 @@ function formatError(error51, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error51, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error52, path33 = []) => {
+  const processError = (error52, path34 = []) => {
     var _a3, _b;
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path33, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path34, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path33, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path34, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path33, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path34, ...issue2.path]);
       } else {
-        const fullpath = [...path33, ...issue2.path];
+        const fullpath = [...path34, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -2166,8 +2166,8 @@ function treeifyError(error51, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path33 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path33) {
+  const path34 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path34) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -15670,13 +15670,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path33 = ref.slice(1).split("/").filter(Boolean);
-  if (path33.length === 0) {
+  const path34 = ref.slice(1).split("/").filter(Boolean);
+  if (path34.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path33[0] === defsKey) {
-    const key = path33[1];
+  if (path34[0] === defsKey) {
+    const key = path34[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -16836,7 +16836,7 @@ var init_walk = __esm({
 // packages/core/dist/core/tools/builtin/search.js
 import { promises as fs6 } from "node:fs";
 import path7 from "node:path";
-async function searchFile(absPath, relPath2, regex, contextLines, remainingSlots) {
+async function searchFile(absPath, relPath, regex, contextLines, remainingSlots) {
   let buf;
   try {
     buf = await fs6.readFile(absPath, "utf-8");
@@ -16856,7 +16856,7 @@ async function searchFile(absPath, relPath2, regex, contextLines, remainingSlots
         const endAfter = Math.min(lines.length - 1, i + contextLines);
         matches.push({
           file: absPath,
-          relPath: relPath2,
+          relPath,
           line: i + 1,
           text: lines[i],
           context: {
@@ -17706,11 +17706,11 @@ var init_tools = __esm({
           if (!ctx.addDocument)
             return "Knowledge vault tool not available.";
           const title = args["title"] || "New Document";
-          const path33 = args["path"] || `notes/${title.toLowerCase().replace(/[^a-z0-9]+/g, "-")}`;
+          const path34 = args["path"] || `notes/${title.toLowerCase().replace(/[^a-z0-9]+/g, "-")}`;
           const content = args["content"] || "";
           const tags = args["tags"] || [];
           ctx.addDocument({
-            path: path33,
+            path: path34,
             title,
             content,
             format: "markdown",
@@ -17719,7 +17719,7 @@ var init_tools = __esm({
             workspaceId: ctx.workspaceId
           });
           ctx.addActivity("vault", "created document", title);
-          return `Document "${title}" created at "${path33}".`;
+          return `Document "${title}" created at "${path34}".`;
         }
       }
     ];
@@ -18096,6 +18096,33 @@ var init_skills2 = __esm({
   }
 });
 
+// src/cli/utils/paths.ts
+import { homedir as homedir2 } from "node:os";
+import path10 from "node:path";
+function shortenCwd(p3, maxLen = 40, home = homedir2()) {
+  let out = p3;
+  if (home && (out === home || out.startsWith(`${home}\\`) || out.startsWith(`${home}/`))) {
+    out = `~${out.slice(home.length)}`;
+  }
+  if (out.length <= maxLen) return out;
+  return `\u2026${out.slice(-(maxLen - 1))}`;
+}
+function relativePosix(from, to) {
+  try {
+    const p3 = process.platform === "win32" ? path10.win32 : path10.posix;
+    const rel2 = p3.relative(from, to);
+    if (!rel2 || rel2.startsWith("..")) return to;
+    return rel2.split(/[\\/]/).join("/");
+  } catch {
+    return to;
+  }
+}
+var init_paths = __esm({
+  "src/cli/utils/paths.ts"() {
+    "use strict";
+  }
+});
+
 // packages/core/dist/shared/events.js
 function createBrainEvent(type, sessionId, data) {
   return {
@@ -18802,7 +18829,7 @@ var init_providerStream = __esm({
 
 // packages/core/dist/core/sessionJsonl.js
 import { promises as fs8 } from "node:fs";
-import path10 from "node:path";
+import path11 from "node:path";
 import os3 from "node:os";
 async function readSession(filePath) {
   try {
@@ -18828,7 +18855,7 @@ async function readSession(filePath) {
   }
 }
 function defaultBaseDir() {
-  return path10.join(os3.tmpdir(), "zelari-code", "sessions");
+  return path11.join(os3.tmpdir(), "zelari-code", "sessions");
 }
 var SessionJsonlWriter;
 var init_sessionJsonl = __esm({
@@ -18839,7 +18866,7 @@ var init_sessionJsonl = __esm({
       onError;
       constructor(sessionId, options = {}) {
         const baseDir = options.baseDir ?? defaultBaseDir();
-        this.filePath = path10.join(baseDir, `${sessionId}.jsonl`);
+        this.filePath = path11.join(baseDir, `${sessionId}.jsonl`);
         this.onError = options.onError ?? console.error;
       }
       /** Absolute path to the session JSONL file. */
@@ -18849,7 +18876,7 @@ var init_sessionJsonl = __esm({
       /** Append a BrainEvent as one JSON line. Creates the file + parent dirs if missing. */
       async append(event) {
         try {
-          await fs8.mkdir(path10.dirname(this.filePath), { recursive: true });
+          await fs8.mkdir(path11.dirname(this.filePath), { recursive: true });
           const line = JSON.stringify({
             ts: event.ts,
             sessionId: event.sessionId,
@@ -19221,6 +19248,346 @@ var init_registry = __esm({
   }
 });
 
+// src/cli/diagnostics/engine.ts
+import { spawn as spawn2 } from "node:child_process";
+import { existsSync as existsSync7 } from "node:fs";
+import path16 from "node:path";
+function parseEslintJson(stdout, _file2) {
+  const json2 = safeJson(stdout);
+  if (!Array.isArray(json2)) return [];
+  const out = [];
+  for (const fileResult of json2) {
+    if (!fileResult || typeof fileResult !== "object") continue;
+    const fr = fileResult;
+    const filePath = typeof fr.filePath === "string" ? fr.filePath : _file2;
+    if (!Array.isArray(fr.messages)) continue;
+    for (const m of fr.messages) {
+      if (!m || typeof m !== "object") continue;
+      const msg = m;
+      out.push({
+        file: filePath,
+        line: typeof msg.line === "number" ? msg.line : 0,
+        ...typeof msg.column === "number" ? { column: msg.column } : {},
+        // ESLint severity: 2 = error, 1 = warning.
+        severity: msg.severity === 2 ? "error" : "warning",
+        message: typeof msg.message === "string" ? msg.message : "(no message)",
+        ...typeof msg.ruleId === "string" && msg.ruleId ? { code: msg.ruleId } : {},
+        source: "eslint"
+      });
+    }
+  }
+  return out;
+}
+function parseRuffJson(stdout, _file2) {
+  const json2 = safeJson(stdout);
+  if (!Array.isArray(json2)) return [];
+  const out = [];
+  for (const issue2 of json2) {
+    if (!issue2 || typeof issue2 !== "object") continue;
+    const it = issue2;
+    const code = typeof it.code === "string" ? it.code : void 0;
+    out.push({
+      file: typeof it.filename === "string" ? it.filename : _file2,
+      line: typeof it.location?.row === "number" ? it.location.row : 0,
+      ...typeof it.location?.column === "number" ? { column: it.location.column } : {},
+      // Ruff has no severity field; E999 is a syntax error, everything else
+      // is a lint warning.
+      severity: code === "E999" ? "error" : "warning",
+      message: typeof it.message === "string" ? it.message : "(no message)",
+      ...code ? { code } : {},
+      source: "ruff"
+    });
+  }
+  return out;
+}
+function safeJson(s) {
+  const trimmed = s.trim();
+  if (!trimmed) return null;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return null;
+  }
+}
+function providerForFile(file2, providers = DEFAULT_PROVIDERS) {
+  const ext = path16.extname(file2).toLowerCase();
+  return providers.find((p3) => p3.extensions.includes(ext)) ?? null;
+}
+function resolveBin(bin, cwd) {
+  const suffixes = process.platform === "win32" ? [".cmd", ".exe", ""] : [""];
+  let dir = cwd;
+  for (let i = 0; i < 6; i += 1) {
+    for (const suffix of suffixes) {
+      const candidate = path16.join(dir, "node_modules", ".bin", `${bin}${suffix}`);
+      if (existsSync7(candidate)) return candidate;
+    }
+    const parent = path16.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return bin;
+}
+async function runDiagnosticsForFile(file2, options = {}) {
+  const provider = providerForFile(file2, options.providers);
+  if (!provider) return [];
+  const cwd = options.cwd ?? process.cwd();
+  const timeoutMs = options.timeoutMs ?? 5e3;
+  const runner = options.runner ?? defaultRunner;
+  try {
+    const bin = options.runner ? provider.bin : resolveBin(provider.bin, cwd);
+    const result = await runner(bin, provider.args(file2), { cwd, timeoutMs });
+    return provider.parse(result.stdout, file2);
+  } catch {
+    return [];
+  }
+}
+function formatDiagnostics(diagnostics, opts = {}) {
+  if (diagnostics.length === 0) return "";
+  const maxLines = opts.maxLines ?? 20;
+  const rank = { error: 0, warning: 1, info: 2 };
+  const sorted = [...diagnostics].sort(
+    (a, b) => rank[a.severity] - rank[b.severity] || a.line - b.line
+  );
+  const errors = sorted.filter((d) => d.severity === "error").length;
+  const warnings = sorted.filter((d) => d.severity === "warning").length;
+  const header = `\u26A0 ${diagnostics.length} diagnostic${diagnostics.length === 1 ? "" : "s"} (${errors} error${errors === 1 ? "" : "s"}, ${warnings} warning${warnings === 1 ? "" : "s"}) \u2014 fix before continuing:`;
+  const shown = sorted.slice(0, maxLines).map((d) => {
+    const loc = opts.relativeTo ? relativePosix(opts.relativeTo, d.file) : d.file;
+    const pos = d.column ? `${d.line}:${d.column}` : `${d.line}`;
+    const tag = d.severity === "error" ? "error" : d.severity === "warning" ? "warn" : "info";
+    const code = d.code ? ` [${d.code}]` : "";
+    return `  ${loc}:${pos} ${tag}${code}: ${d.message} (${d.source})`;
+  });
+  const overflow = sorted.length > maxLines ? [`  \u2026 and ${sorted.length - maxLines} more`] : [];
+  return [header, ...shown, ...overflow].join("\n");
+}
+var DEFAULT_PROVIDERS, defaultRunner;
+var init_engine = __esm({
+  "src/cli/diagnostics/engine.ts"() {
+    "use strict";
+    init_paths();
+    DEFAULT_PROVIDERS = [
+      {
+        name: "eslint",
+        bin: "eslint",
+        extensions: [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"],
+        args: (file2) => ["--format", "json", file2],
+        parse: parseEslintJson
+      },
+      {
+        name: "ruff",
+        bin: "ruff",
+        extensions: [".py"],
+        args: (file2) => ["check", "--output-format", "json", file2],
+        parse: parseRuffJson
+      }
+    ];
+    defaultRunner = (cmd, args, opts) => new Promise((resolve) => {
+      let stdout = "";
+      let stderr = "";
+      let settled = false;
+      const done = (r) => {
+        if (settled) return;
+        settled = true;
+        resolve(r);
+      };
+      let child;
+      try {
+        child = process.platform === "win32" ? spawn2(`${cmd} ${args.join(" ")}`, { cwd: opts.cwd, shell: true }) : spawn2(cmd, args, { cwd: opts.cwd });
+      } catch {
+        done({ code: null, stdout: "", stderr: "" });
+        return;
+      }
+      const timer = setTimeout(() => {
+        try {
+          child.kill();
+        } catch {
+        }
+        done({ code: null, stdout, stderr });
+      }, opts.timeoutMs);
+      child.stdout?.on("data", (c) => {
+        stdout += c.toString();
+      });
+      child.stderr?.on("data", (c) => {
+        stderr += c.toString();
+      });
+      child.on("error", () => {
+        clearTimeout(timer);
+        done({ code: null, stdout: "", stderr: "" });
+      });
+      child.on("close", (code) => {
+        clearTimeout(timer);
+        done({ code, stdout, stderr });
+      });
+    });
+  }
+});
+
+// src/cli/lsp/servers.ts
+import path17 from "node:path";
+function languageIdForFile(file2) {
+  const ext = path17.extname(file2).toLowerCase();
+  const map2 = {
+    ".ts": "typescript",
+    ".tsx": "typescriptreact",
+    ".js": "javascript",
+    ".jsx": "javascriptreact",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".py": "python",
+    ".go": "go",
+    ".rs": "rust"
+  };
+  return map2[ext] ?? "plaintext";
+}
+function serverForFile(file2, servers = LSP_SERVERS) {
+  const ext = path17.extname(file2).toLowerCase();
+  return servers.find((s) => s.extensions.includes(ext)) ?? null;
+}
+function resolveServerCommand(file2, cwd, servers = LSP_SERVERS) {
+  const spec = serverForFile(file2, servers);
+  if (!spec) return null;
+  const command = resolveBin(spec.bin, cwd);
+  return {
+    language: spec.language,
+    command,
+    args: spec.args,
+    resolved: command !== spec.bin
+  };
+}
+var LSP_SERVERS;
+var init_servers = __esm({
+  "src/cli/lsp/servers.ts"() {
+    "use strict";
+    init_engine();
+    LSP_SERVERS = [
+      {
+        language: "typescript",
+        bin: "typescript-language-server",
+        args: ["--stdio"],
+        extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]
+      },
+      {
+        language: "python",
+        bin: "pyright-langserver",
+        args: ["--stdio"],
+        extensions: [".py"]
+      },
+      {
+        language: "go",
+        bin: "gopls",
+        args: [],
+        extensions: [".go"]
+      },
+      {
+        language: "rust",
+        bin: "rust-analyzer",
+        args: [],
+        extensions: [".rs"]
+      }
+    ];
+  }
+});
+
+// src/cli/browser/driver.ts
+async function runBrowserCheck(options, loader = defaultPlaywrightLoader) {
+  const consoleErrors = [];
+  const pageErrors = [];
+  const failedRequests = [];
+  const base = { ok: false, consoleErrors, pageErrors, failedRequests };
+  const pw = await loader();
+  if (!pw) {
+    return {
+      ...base,
+      error: "browser automation unavailable \u2014 install Playwright (`npm i -D playwright && npx playwright install chromium`) to enable browser_check"
+    };
+  }
+  const timeout = options.timeoutMs ?? 15e3;
+  let browser;
+  try {
+    browser = await pw.chromium.launch({ headless: true });
+    const page = await browser.newPage();
+    page.on("console", (msg) => {
+      if (msg.type() === "error") consoleErrors.push(msg.text());
+    });
+    page.on("pageerror", (err) => pageErrors.push(err.message));
+    page.on("requestfailed", (req) => {
+      const f = req.failure();
+      failedRequests.push(`${req.url()}${f ? ` (${f.errorText})` : ""}`);
+    });
+    await page.goto(options.url, { waitUntil: "load", timeout });
+    for (const action of options.actions ?? []) {
+      switch (action.type) {
+        case "click":
+          await page.click(action.selector, { timeout });
+          break;
+        case "fill":
+          await page.fill(action.selector, action.value, { timeout });
+          break;
+        case "goto":
+          await page.goto(action.url, { waitUntil: "load", timeout });
+          break;
+        case "wait":
+          await page.waitForTimeout(action.ms);
+          break;
+        default:
+          break;
+      }
+    }
+    let selectorFound;
+    if (options.waitForSelector) {
+      try {
+        await page.waitForSelector(options.waitForSelector, { timeout });
+        selectorFound = true;
+      } catch {
+        selectorFound = false;
+      }
+    }
+    let screenshotPath;
+    if (options.screenshotPath) {
+      try {
+        await page.screenshot({ path: options.screenshotPath });
+        screenshotPath = options.screenshotPath;
+      } catch {
+      }
+    }
+    const title = await page.title().catch(() => void 0);
+    return {
+      ok: true,
+      consoleErrors,
+      pageErrors,
+      failedRequests,
+      url: page.url(),
+      ...title !== void 0 ? { title } : {},
+      ...selectorFound !== void 0 ? { selectorFound } : {},
+      ...screenshotPath ? { screenshotPath } : {}
+    };
+  } catch (err) {
+    return { ...base, error: err instanceof Error ? err.message : String(err) };
+  } finally {
+    try {
+      await browser?.close();
+    } catch {
+    }
+  }
+}
+var defaultPlaywrightLoader;
+var init_driver = __esm({
+  "src/cli/browser/driver.ts"() {
+    "use strict";
+    defaultPlaywrightLoader = async () => {
+      try {
+        const pkg = "playwright";
+        const mod = await import(pkg);
+        if (mod && mod.chromium && typeof mod.chromium.launch === "function") return mod;
+        return null;
+      } catch {
+        return null;
+      }
+    };
+  }
+});
+
 // packages/core/dist/agents/roles.js
 function getAgent(id) {
   return AGENT_ROLES.find((a) => a.id === id);
@@ -20408,11 +20775,11 @@ var init_synthesisAudit = __esm({
 import { existsSync as existsSync10, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "node:fs";
 import { join as join2 } from "node:path";
 function loadNfrSpec(zelariRoot) {
-  const path33 = join2(zelariRoot, "nfr-spec.json");
-  if (!existsSync10(path33))
+  const path34 = join2(zelariRoot, "nfr-spec.json");
+  if (!existsSync10(path34))
     return null;
   try {
-    const raw = JSON.parse(readFileSync8(path33, "utf8"));
+    const raw = JSON.parse(readFileSync8(path34, "utf8"));
     if (raw.version !== 1 || !Array.isArray(raw.targets))
       return null;
     return raw;
@@ -20681,9 +21048,9 @@ function checkDeadHooksInHtml(html) {
   }
   return warnings;
 }
-function runMicroVerificationOnFile(projectRoot, relPath2, zelariRoot) {
-  const abs = join3(projectRoot, relPath2);
-  if (!existsSync11(abs) || !/\.html?$/i.test(relPath2))
+function runMicroVerificationOnFile(projectRoot, relPath, zelariRoot) {
+  const abs = join3(projectRoot, relPath);
+  if (!existsSync11(abs) || !/\.html?$/i.test(relPath))
     return [];
   const spec = (zelariRoot ? loadNfrSpec(zelariRoot) : null) ?? DEFAULT_NFR_SPEC;
   const anim = spec.animation ?? { compositorOnly: true, forbidLayoutProps: true };
@@ -20697,7 +21064,7 @@ function runMicroVerificationOnFile(projectRoot, relPath2, zelariRoot) {
     warnings.push({
       id: "motion.keyframes",
       message: `@keyframes uses non-allowed property "${v.property}"`,
-      file: relPath2,
+      file: relPath,
       line: v.line
     });
   }
@@ -20705,12 +21072,12 @@ function runMicroVerificationOnFile(projectRoot, relPath2, zelariRoot) {
     warnings.push({
       id: "motion.transitions",
       message: `transition uses non-allowed property "${v.property}"`,
-      file: relPath2,
+      file: relPath,
       line: v.line
     });
   }
   for (const w of checkDeadHooksInHtml(html)) {
-    warnings.push({ ...w, file: relPath2 });
+    warnings.push({ ...w, file: relPath });
   }
   return warnings;
 }
@@ -22039,8 +22406,8 @@ async function* runChairmanFixLoop(args) {
       break;
     }
     const rescanned = /* @__PURE__ */ new Map();
-    for (const relPath2 of args.changedFiles) {
-      for (const w of runChairmanMicroGate({ projectRoot: args.projectRoot, relPath: relPath2, zelariRoot })) {
+    for (const relPath of args.changedFiles) {
+      for (const w of runChairmanMicroGate({ projectRoot: args.projectRoot, relPath, zelariRoot })) {
         rescanned.set(`${w.id}|${w.file}|${w.line ?? ""}`, w);
       }
     }
@@ -22601,9 +22968,9 @@ var init_types2 = __esm({
 import { readFileSync as readFileSync13 } from "node:fs";
 import { join as join8 } from "node:path";
 function readLessonsDeduped(zelariRoot) {
-  const path33 = join8(zelariRoot, LESSONS_FILE);
+  const path34 = join8(zelariRoot, LESSONS_FILE);
   try {
-    const raw = readFileSync13(path33, "utf8");
+    const raw = readFileSync13(path34, "utf8");
     const byId = /* @__PURE__ */ new Map();
     for (const line of raw.split(/\r?\n/)) {
       if (!line.trim())
@@ -22704,8 +23071,8 @@ function keywordsFrom(check2, signature) {
   return [.../* @__PURE__ */ new Set([...fromId, ...words])].slice(0, 12);
 }
 function writeLesson(zelariRoot, lesson) {
-  const path33 = join9(zelariRoot, LESSONS_FILE);
-  appendFileSync2(path33, `${JSON.stringify(lesson)}
+  const path34 = join9(zelariRoot, LESSONS_FILE);
+  appendFileSync2(path34, `${JSON.stringify(lesson)}
 `, "utf8");
 }
 function findSimilar(lessons, signature) {
@@ -23301,7 +23668,7 @@ function workspaceArtifact(rootDir, subdir, slug) {
 function projectName(projectRoot = process.cwd()) {
   return basename(realpathSync(projectRoot));
 }
-var init_paths = __esm({
+var init_paths2 = __esm({
   "src/cli/workspace/paths.ts"() {
     "use strict";
   }
@@ -23316,7 +23683,7 @@ __export(workspaceSummary_exports, {
   buildZelariReadHint: () => buildZelariReadHint
 });
 import { existsSync as existsSync14, readFileSync as readFileSync14, readdirSync, statSync as statSync3 } from "node:fs";
-import { join as join12, relative as relative2 } from "node:path";
+import { join as join12, relative } from "node:path";
 function buildWorkspaceSummary(projectRoot = process.cwd(), options = {}) {
   const { maxEntries = 30 } = options;
   const name = safeProjectName(projectRoot);
@@ -23529,7 +23896,7 @@ function listShallow(projectRoot, maxEntries) {
         out.push(`\u2026 (+${top.length - count} more)`);
         break;
       }
-      const rel2 = relative2(projectRoot, join12(projectRoot, entry.name));
+      const rel2 = relative(projectRoot, join12(projectRoot, entry.name));
       if (entry.isDirectory()) {
         let inner = "";
         try {
@@ -23562,7 +23929,7 @@ var init_workspaceSummary = __esm({
   "src/cli/workspace/workspaceSummary.ts"() {
     "use strict";
     init_council();
-    init_paths();
+    init_paths2();
     PLAN_SUMMARY_MAX_TASKS = 15;
     PRIORITY_RANK = {
       critical: 3,
@@ -23845,28 +24212,28 @@ var init_storage = __esm({
     VALID_SCALARS = /^(true|false|null|~)$/i;
     Storage = class {
       /** Read a Markdown file with frontmatter. Throws if not found. */
-      read(path33) {
-        if (!existsSync15(path33)) {
-          throw new Error(`File not found: ${path33}`);
+      read(path34) {
+        if (!existsSync15(path34)) {
+          throw new Error(`File not found: ${path34}`);
         }
-        const md = readFileSync15(path33, "utf8");
+        const md = readFileSync15(path34, "utf8");
         return parseFrontmatter(md);
       }
       /** Read a Markdown file; returns null if not found. */
-      readIfExists(path33) {
-        if (!existsSync15(path33)) return null;
-        return this.read(path33);
+      readIfExists(path34) {
+        if (!existsSync15(path34)) return null;
+        return this.read(path34);
       }
       /**
        * Write a Markdown file atomically (tmp + rename). Creates parent dirs.
        * The meta object is serialized as YAML frontmatter; body as Markdown.
        */
-      write(path33, meta3, body) {
-        mkdirSync7(dirname(path33), { recursive: true });
-        const tmp = path33 + ".tmp-" + process.pid;
+      write(path34, meta3, body) {
+        mkdirSync7(dirname(path34), { recursive: true });
+        const tmp = path34 + ".tmp-" + process.pid;
         const md = serializeFrontmatter(meta3, body);
         writeFileSync11(tmp, md, "utf8");
-        renameSync2(tmp, path33);
+        renameSync2(tmp, path34);
       }
       /** List all .md files in a directory (non-recursive). */
       listMarkdown(dir) {
@@ -23917,7 +24284,7 @@ import {
   mkdirSync as mkdirSync8,
   renameSync as renameSync3
 } from "node:fs";
-import { join as join14, basename as basename2, dirname as dirname2, relative as relative3 } from "node:path";
+import { join as join14, basename as basename2, dirname as dirname2, relative as relative2 } from "node:path";
 function createWorkspaceContext(projectRoot = process.cwd()) {
   const rootDir = resolveWorkspaceRoot(projectRoot);
   return {
@@ -23944,8 +24311,8 @@ function readPlan(ctx) {
     } catch {
     }
   }
-  const path33 = workspaceFile(ctx.rootDir, "plan");
-  const doc = ctx.storage.readIfExists(path33);
+  const path34 = workspaceFile(ctx.rootDir, "plan");
+  const doc = ctx.storage.readIfExists(path34);
   if (!doc) return { phases: [], tasks: [], milestones: [] };
   const meta3 = doc.meta;
   return {
@@ -24110,7 +24477,7 @@ function addMilestoneRecord(ctx, summary, input) {
     dueDate: input.dueDate,
     targetVersion: version2
   });
-  const path33 = join14(ctx.rootDir, "milestones", `${id}.md`);
+  const path34 = join14(ctx.rootDir, "milestones", `${id}.md`);
   const meta3 = {
     kind: "milestone",
     id,
@@ -24127,7 +24494,7 @@ function addMilestoneRecord(ctx, summary, input) {
     `Target version: ${version2}`,
     ""
   ].join("\n");
-  ctx.storage.write(path33, meta3, body);
+  ctx.storage.write(path34, meta3, body);
   return { id, created: true };
 }
 function readPlanSummary(ctx) {
@@ -24331,7 +24698,7 @@ function addIdeaStub(ctx) {
         const tags = args["tags"] ?? [];
         const category = args["category"] ?? "General";
         const id = `${nextAdrId(ctx)}-${slugify3(title)}`;
-        const path33 = workspaceArtifact(ctx.rootDir, "decisions", id);
+        const path34 = workspaceArtifact(ctx.rootDir, "decisions", id);
         const meta3 = {
           kind: "adr",
           status: "proposed",
@@ -24357,7 +24724,7 @@ function addIdeaStub(ctx) {
           ...consequences.map((c) => `- ${c}`),
           ""
         ].join("\n");
-        ctx.storage.write(path33, meta3, body);
+        ctx.storage.write(path34, meta3, body);
         return `ADR ${id} created: "${title}". Status: proposed. Promote to accepted via /update ADR or manual edit.`;
       });
     }
@@ -24439,14 +24806,14 @@ function createDocumentStub(ctx) {
           ctx.storage.write(risksPath, riskMeta, content);
           return `Document "${title}" created at risks.md (workspace root).`;
         }
-        const path33 = workspaceArtifact(ctx.rootDir, "docs", slug);
+        const path34 = workspaceArtifact(ctx.rootDir, "docs", slug);
         const meta3 = {
           kind: "doc",
           id: slug,
           date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
           tags
         };
-        ctx.storage.write(path33, meta3, content);
+        ctx.storage.write(path34, meta3, content);
         return `Document "${title}" created at docs/${slug}.md.`;
       });
     }
@@ -24510,7 +24877,7 @@ function searchDocumentsStub(ctx) {
         const end = Math.min(raw.length, idx + matchLen + 40);
         const snippet = "\u2026" + raw.slice(start, end).replace(/\n/g, " ").trim() + "\u2026";
         results.push({
-          path: relative3(ctx.rootDir, file2) || basename2(file2),
+          path: relative2(ctx.rootDir, file2) || basename2(file2),
           snippet
         });
         if (results.length >= limit) break;
@@ -24594,7 +24961,7 @@ var init_stubs = __esm({
   "src/cli/workspace/stubs.ts"() {
     "use strict";
     init_storage();
-    init_paths();
+    init_paths2();
     init_storage();
     SEARCH_NUDGE_THRESHOLD = 5;
   }
@@ -24673,6 +25040,7 @@ __export(updater_exports, {
   compareSemver: () => compareSemver,
   fetchLatestVersion: () => fetchLatestVersion,
   getCurrentVersion: () => getCurrentVersion,
+  looksLikeBrokenShim: () => looksLikeBrokenShim,
   performUpdate: () => performUpdate,
   resolveBundledNpmCli: () => resolveBundledNpmCli
 });
@@ -25157,7 +25525,7 @@ function hasWorkspacePlan(projectRoot = process.cwd()) {
 var init_planDetect = __esm({
   "src/cli/workspace/planDetect.ts"() {
     "use strict";
-    init_paths();
+    init_paths2();
   }
 });
 
@@ -25250,10 +25618,10 @@ import { createHash as createHash3 } from "node:crypto";
 import { join as join17 } from "node:path";
 import { readFile as readFile2 } from "node:fs/promises";
 async function readPackageJson2(projectRoot) {
-  const path33 = join17(projectRoot, "package.json");
-  if (!existsSync20(path33)) return null;
+  const path34 = join17(projectRoot, "package.json");
+  if (!existsSync20(path34)) return null;
   try {
-    return JSON.parse(await readFile2(path33, "utf8"));
+    return JSON.parse(await readFile2(path34, "utf8"));
   } catch {
     return null;
   }
@@ -25335,9 +25703,9 @@ async function genBuild(ctx) {
   ].join("\n");
 }
 async function genOpenQuestions(ctx) {
-  const path33 = join17(ctx.rootDir, "risks.md");
-  if (!existsSync20(path33)) return "_No open questions._";
-  const content = readFileSync19(path33, "utf8");
+  const path34 = join17(ctx.rootDir, "risks.md");
+  if (!existsSync20(path34)) return "_No open questions._";
+  const content = readFileSync19(path34, "utf8");
   const lines = content.split("\n");
   const questions = [];
   let currentTitle = "";
@@ -25467,7 +25835,7 @@ var AUTO_SECTIONS, MARKER_OPEN, MARKER_CLOSE, GENERATORS;
 var init_agentsMd = __esm({
   "src/cli/workspace/agentsMd.ts"() {
     "use strict";
-    init_paths();
+    init_paths2();
     AUTO_SECTIONS = [
       "tech-stack",
       "decisions",
@@ -25900,8 +26268,8 @@ async function runPostCouncilHook(ctx, options) {
           sources: scope.sources
         } : void 0
       });
-      const path33 = writeCouncilCompletion(ctx.rootDir, completion);
-      completionHook = { ran: true, path: path33, completion };
+      const path34 = writeCouncilCompletion(ctx.rootDir, completion);
+      completionHook = { ran: true, path: path34, completion };
     } catch (err) {
       completionHook = {
         ran: true,
@@ -25954,7 +26322,7 @@ var init_buildLessonsSummary = __esm({
   "src/cli/workspace/buildLessonsSummary.ts"() {
     "use strict";
     init_council();
-    init_paths();
+    init_paths2();
   }
 });
 
@@ -26534,36 +26902,478 @@ var init_zelariMission = __esm({
   }
 });
 
+// src/cli/utils/prereqChecks.ts
+var prereqChecks_exports = {};
+__export(prereqChecks_exports, {
+  checkAgentBash: () => checkAgentBash,
+  checkAgentGit: () => checkAgentGit,
+  checkAgentNode: () => checkAgentNode,
+  checkMainNode: () => checkMainNode,
+  runPrereqChecks: () => runPrereqChecks
+});
+import { execSync, spawnSync as spawnSync2 } from "node:child_process";
+import { existsSync as existsSync25 } from "node:fs";
+function resolveAgentShellSync() {
+  if (process.platform !== "win32") {
+    return { bashPath: null, isBash: true, via: "/bin/sh" };
+  }
+  const envShell = process.env.ZELARI_SHELL;
+  if (envShell && envShell.trim().length > 0 && existsSyncSafe2(envShell)) {
+    return { bashPath: envShell, isBash: true, via: `bash (${envShell})` };
+  }
+  const sessionShell = process.env.SHELL;
+  if (sessionShell && sessionShell.trim().length > 0 && existsSyncSafe2(sessionShell)) {
+    return {
+      bashPath: sessionShell,
+      isBash: true,
+      via: `bash (${sessionShell})`
+    };
+  }
+  for (const p3 of STANDARD_BASH_PATHS2) {
+    if (existsSyncSafe2(p3)) {
+      return { bashPath: p3, isBash: true, via: `bash (${p3})` };
+    }
+  }
+  try {
+    const result = spawnSync2("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 && existsSyncSafe2(first)) {
+        const trimmed = first.trim();
+        return { bashPath: trimmed, isBash: true, via: `bash (${trimmed})` };
+      }
+    }
+  } catch {
+  }
+  return { bashPath: null, isBash: false, via: "cmd.exe" };
+}
+function existsSyncSafe2(p3) {
+  try {
+    return existsSync25(p3);
+  } catch {
+    return false;
+  }
+}
+function probeTool(tool) {
+  const shell = resolveAgentShellSync();
+  let stdout = "";
+  if (shell.bashPath) {
+    try {
+      const r = spawnSync2(shell.bashPath, ["-c", `${tool} --version`], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        windowsHide: true
+      });
+      if (r.status === 0) stdout = (r.stdout || "").trim();
+    } catch {
+    }
+  } else if (process.platform === "win32") {
+    try {
+      stdout = execSync(`${tool} --version`, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+  } else {
+    try {
+      stdout = execSync(`${tool} --version`, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+  }
+  const m = stdout.match(/(\d+)\.(\d+)\.(\d+)/);
+  return {
+    found: stdout.length > 0,
+    version: m ? `${m[1]}.${m[2]}.${m[3]}` : "",
+    raw: stdout
+  };
+}
+function nodeMissingHint() {
+  const shell = resolveAgentShellSync();
+  if (process.platform === "win32") {
+    return `node is not reachable from the agent's shell (${shell.via}).
+         This usually means Node was installed for "current user" only,
+         while Git Bash inherits the SYSTEM Path. Fix (pick one):
+           - Reinstall Node (https://nodejs.org) and choose
+             "Add to PATH for all users", OR
+           - Add C:\\Program Files\\nodejs\\ to the SYSTEM Path
+             (System Properties \u2192 Environment Variables \u2192 Path), OR
+           - Set ZELARI_SHELL to a bash that already sees node.`;
+  }
+  return `node is not on the agent's shell PATH.
+         Install Node >= ${MIN_NODE_MAJOR} (https://nodejs.org) or, if you use
+         nvm, run \`nvm use <version>\` and reopen this terminal.`;
+}
+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)) {
+    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)`
+  };
+}
+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 \u2014 /diff, /undo and the git sidebar will be disabled. ${hint}`
+    };
+  }
+  return {
+    ok: true,
+    severity: "warn",
+    tool: "git",
+    message: `git ${probe.version} (agent shell)`
+  };
+}
+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 \u2014 the agent's \`bash\` tool falls back to cmd.exe,
+         where POSIX commands (ls, which, $VAR, &&) may fail. Install Git
+         for Windows (https://git-scm.com/download/win) or set ZELARI_SHELL
+         to your bash binary.`
+  };
+}
+function checkMainNode() {
+  try {
+    const raw = execSync("node --version", {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    const m = raw.match(/(\d+)\.(\d+)\.(\d+)/);
+    const version2 = m ? `${m[1]}.${m[2]}.${m[3]}` : "";
+    const major = Number(version2.split(".")[0]);
+    if (version2 && !Number.isNaN(major) && major >= MIN_NODE_MAJOR) {
+      return {
+        ok: true,
+        severity: "critical",
+        tool: "node",
+        message: `node ${version2} (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 \u2014 this is unexpected)"
+    };
+  }
+}
+function runPrereqChecks(opts = { mode: "preflight" }) {
+  const checks = [
+    () => checkAgentNode(),
+    () => checkAgentGit(),
+    () => checkAgentBash()
+  ];
+  const results = [];
+  for (const run of checks) {
+    try {
+      results.push(run());
+    } catch (err) {
+      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");
+  void opts.mode;
+  return { results, hasCriticalFail, warnings };
+}
+var MIN_NODE_MAJOR, STANDARD_BASH_PATHS2;
+var init_prereqChecks = __esm({
+  "src/cli/utils/prereqChecks.ts"() {
+    "use strict";
+    MIN_NODE_MAJOR = 20;
+    STANDARD_BASH_PATHS2 = [
+      "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"
+    ];
+  }
+});
+
+// src/cli/plugins/prefs.ts
+import { existsSync as existsSync26, readFileSync as readFileSync23, writeFileSync as writeFileSync15, mkdirSync as mkdirSync10 } from "node:fs";
+import path28 from "node:path";
+import os9 from "node:os";
+function getPluginPrefsPath() {
+  return process.env.ZELARI_PLUGINS_PREFS_FILE ?? path28.join(os9.homedir(), ".tmp", "zelari-code", "plugins.json");
+}
+function getPluginPrefs() {
+  const file2 = getPluginPrefsPath();
+  try {
+    if (!existsSync26(file2)) return { ...DEFAULTS2, dontAskAgain: {} };
+    const raw = readFileSync23(file2, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && parsed.dontAskAgain && typeof parsed.dontAskAgain === "object") {
+      const clean = {};
+      for (const [k, v] of Object.entries(parsed.dontAskAgain)) {
+        if (typeof k === "string" && k.length > 0 && v === true) clean[k] = true;
+      }
+      return { version: 1, dontAskAgain: clean };
+    }
+  } catch {
+  }
+  return { ...DEFAULTS2, dontAskAgain: {} };
+}
+function writePluginPrefs(prefs) {
+  const file2 = getPluginPrefsPath();
+  mkdirSync10(path28.dirname(file2), { recursive: true });
+  writeFileSync15(file2, JSON.stringify(prefs, null, 2), {
+    encoding: "utf-8",
+    mode: 384
+  });
+}
+function markDontAskAgain(pluginId) {
+  try {
+    const prefs = getPluginPrefs();
+    prefs.dontAskAgain[pluginId] = true;
+    writePluginPrefs(prefs);
+  } catch {
+  }
+}
+function isMuted(pluginId) {
+  return getPluginPrefs().dontAskAgain[pluginId] === true;
+}
+var DEFAULTS2;
+var init_prefs = __esm({
+  "src/cli/plugins/prefs.ts"() {
+    "use strict";
+    DEFAULTS2 = {
+      version: 1,
+      dontAskAgain: {}
+    };
+  }
+});
+
+// src/cli/plugins/registry.ts
+var registry_exports = {};
+__export(registry_exports, {
+  PLUGINS: () => PLUGINS,
+  detectMissingPlugins: () => detectMissingPlugins,
+  findPlugin: () => findPlugin
+});
+import { spawnSync as spawnSync3 } from "node:child_process";
+function detectLocalBin(bin) {
+  return (cwd) => {
+    try {
+      const resolved = resolveBin(bin, cwd);
+      return Promise.resolve(resolved !== bin);
+    } catch {
+      return Promise.resolve(false);
+    }
+  };
+}
+function detectGlobalBin(bin) {
+  return () => {
+    try {
+      const res = spawnSync3(bin, ["--version"], {
+        stdio: ["ignore", "pipe", "ignore"],
+        shell: process.platform === "win32",
+        timeout: 4e3
+      });
+      return Promise.resolve(res.status === 0 || res.stdout != null && res.stdout.toString().trim().length > 0 && res.error === void 0);
+    } catch {
+      return Promise.resolve(false);
+    }
+  };
+}
+async function detectPlaywright() {
+  try {
+    const mod = await defaultPlaywrightLoader();
+    return mod !== null;
+  } catch {
+    return false;
+  }
+}
+function binForProvider(name) {
+  const p3 = DEFAULT_PROVIDERS.find((x) => x.name === name);
+  if (!p3) throw new Error(`plugin registry: unknown diagnostic provider '${name}'`);
+  return p3.bin;
+}
+function binForLspLanguage(language) {
+  const s = LSP_SERVERS.find((x) => x.language === language);
+  if (!s) throw new Error(`plugin registry: unknown LSP language '${language}'`);
+  return s.bin;
+}
+async function detectMissingPlugins(cwd, opts = {}) {
+  const missing = [];
+  for (const spec of PLUGINS) {
+    if (process.env[spec.featureGate] === "0") continue;
+    if (!opts.includeMuted && isMuted(spec.id)) continue;
+    let present = false;
+    try {
+      present = await spec.detect(cwd);
+    } catch {
+      present = false;
+    }
+    if (!present) missing.push(spec);
+  }
+  return missing;
+}
+function findPlugin(id) {
+  return PLUGINS.find((p3) => p3.id === id);
+}
+var PLUGINS;
+var init_registry2 = __esm({
+  "src/cli/plugins/registry.ts"() {
+    "use strict";
+    init_engine();
+    init_driver();
+    init_engine();
+    init_servers();
+    init_prefs();
+    PLUGINS = [
+      {
+        id: "eslint",
+        label: "ESLint (diagnostics for JS/TS)",
+        npmPackage: "eslint",
+        installScope: "dev",
+        detect: detectLocalBin(binForProvider("eslint")),
+        featureGate: "ZELARI_DIAGNOSTICS",
+        description: "Enables the post-edit diagnostics loop for .js/.jsx/.ts/.tsx/.mjs/.cjs files."
+      },
+      {
+        id: "ruff",
+        label: "Ruff (diagnostics for Python)",
+        npmPackage: "ruff",
+        installScope: "dev",
+        detect: detectLocalBin(binForProvider("ruff")),
+        featureGate: "ZELARI_DIAGNOSTICS",
+        description: "Enables the post-edit diagnostics loop for .py files."
+      },
+      {
+        id: "playwright",
+        label: "Playwright (browser_check tool)",
+        npmPackage: "playwright",
+        installScope: "dev",
+        detect: () => detectPlaywright(),
+        postInstallHint: "Then fetch the browser binary: `npx playwright install chromium`",
+        featureGate: "ZELARI_BROWSER",
+        description: "Powers the browser_check tool (URL probing, click/fill/wait, screenshots)."
+      },
+      {
+        id: "typescript-language-server",
+        label: "typescript-language-server (LSP for TS/JS)",
+        npmPackage: "typescript-language-server",
+        installScope: "global",
+        detect: detectGlobalBin(binForLspLanguage("typescript")),
+        featureGate: "ZELARI_LSP",
+        description: "Powers go_to_definition / find_references / hover_type / rename_symbol for TS/JS."
+      },
+      {
+        id: "pyright",
+        label: "pyright (LSP for Python)",
+        npmPackage: "pyright",
+        installScope: "global",
+        detect: detectGlobalBin(binForLspLanguage("python")),
+        featureGate: "ZELARI_LSP",
+        description: "Powers go_to_definition / find_references / hover_type / rename_symbol for Python."
+      }
+    ];
+  }
+});
+
 // src/cli/utils/doctor.ts
 var doctor_exports = {};
 __export(doctor_exports, {
   runDoctor: () => runDoctor
 });
-import { execSync } from "node:child_process";
-import { existsSync as existsSync29, readFileSync as readFileSync25, readlinkSync, statSync as statSync6 } from "node:fs";
+import { execSync as execSync2 } from "node:child_process";
+import { existsSync as existsSync31, readFileSync as readFileSync26, readlinkSync, statSync as statSync6 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import path32 from "node:path";
+import path33 from "node:path";
 function findPackageRoot(start) {
   let dir = start;
   for (let i = 0; i < 6; i += 1) {
-    const candidate = path32.join(dir, "package.json");
-    if (existsSync29(candidate)) {
+    const candidate = path33.join(dir, "package.json");
+    if (existsSync31(candidate)) {
       try {
-        const pkg = JSON.parse(readFileSync25(candidate, "utf8"));
+        const pkg = JSON.parse(readFileSync26(candidate, "utf8"));
         if (pkg.name === "zelari-code") return dir;
       } catch {
       }
     }
-    const parent = path32.dirname(dir);
+    const parent = path33.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path32.resolve(__dirname3, "..", "..", "..");
+  return path33.resolve(__dirname3, "..", "..", "..");
 }
 function tryExec(cmd) {
   try {
-    return execSync(cmd, {
+    return execSync2(cmd, {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"]
     }).trim();
@@ -26573,8 +27383,8 @@ function tryExec(cmd) {
 }
 function readPackageJson3() {
   try {
-    const pkgPath = path32.join(packageRoot, "package.json");
-    return JSON.parse(readFileSync25(pkgPath, "utf8"));
+    const pkgPath = path33.join(packageRoot, "package.json");
+    return JSON.parse(readFileSync26(pkgPath, "utf8"));
   } catch {
     return null;
   }
@@ -26589,8 +27399,8 @@ function checkShim(pkgName) {
   }
   const isWin = process.platform === "win32";
   const shimName = isWin ? "zelari-code.cmd" : "zelari-code";
-  const shimPath = path32.join(prefix, shimName);
-  if (!existsSync29(shimPath)) {
+  const shimPath = path33.join(prefix, shimName);
+  if (!existsSync31(shimPath)) {
     return FAIL(
       `shim not found at ${shimPath}
          fix:  npm install -g ${pkgName}@latest --force`
@@ -26599,7 +27409,7 @@ function checkShim(pkgName) {
   try {
     const st = statSync6(shimPath);
     if (isWin) {
-      const content = readFileSync25(shimPath, "utf8");
+      const content = readFileSync26(shimPath, "utf8");
       if (content.includes(`${pkgName}\\bin\\`) || content.includes(`${pkgName}/bin/`)) {
         return OK(`shim OK at ${shimPath} (${st.size} bytes)`);
       }
@@ -26617,8 +27427,8 @@ function checkShim(pkgName) {
          fix:  npm install -g ${pkgName}@latest --force`
       );
     }
-    const resolved = path32.resolve(path32.dirname(shimPath), target);
-    const expected = path32.join(
+    const resolved = path33.resolve(path33.dirname(shimPath), target);
+    const expected = path33.join(
       prefix,
       "node_modules",
       pkgName,
@@ -26657,8 +27467,8 @@ function checkNode(pkg) {
   return OK(`node ${raw}`);
 }
 function checkBundle() {
-  const bundle = path32.join(packageRoot, "dist", "cli", "main.bundled.js");
-  if (!existsSync29(bundle)) {
+  const bundle = path33.join(packageRoot, "dist", "cli", "main.bundled.js");
+  if (!existsSync31(bundle)) {
     return FAIL(
       `dist/cli/main.bundled.js missing at ${bundle}
          fix:  npm run build:cli   (then reinstall or run via tsx)`
@@ -26678,7 +27488,7 @@ function checkRuntimeDeps() {
   const missing = [];
   for (const dep of required2) {
     try {
-      const localReq = createRequire2(path32.join(packageRoot, "package.json"));
+      const localReq = createRequire2(path33.join(packageRoot, "package.json"));
       localReq.resolve(dep);
     } catch {
       missing.push(dep);
@@ -26702,22 +27512,60 @@ function checkPath() {
   if (pathDirs.includes(prefix)) {
     return OK(`PATH includes npm prefix (${prefix})`);
   }
+  const winHint = `         fix:  zelari-code --fix-path   (adds ${prefix} to the user PATH)
+               then open a NEW terminal and run \`zelari-code --version\`
+               if it persists: see scripts/diagnose-path.ps1 in the repo`;
+  const posixHint = `         fix:  export PATH="${prefix}/bin:$PATH"
+               (add it to ~/.bashrc / ~/.zshrc to persist)`;
   return WARN(
     `PATH does not include npm prefix (${prefix})
          symptom: "zelari-code: command not found" after install
-         fix (POSIX):   export PATH="$(npm prefix -g)/bin:$PATH"
-         fix (Windows): $env:Path = "$(npm prefix -g);$env:Path"`
+` + (process.platform === "win32" ? winHint : posixHint)
   );
 }
-function runDoctor() {
+function prereqToCheckResult(r) {
+  if (r.ok) return OK(r.message);
+  return r.severity === "critical" ? FAIL(r.message, "critical") : WARN(r.message);
+}
+async function checkOptionalPlugins() {
+  const { detectMissingPlugins: detectMissingPlugins2 } = await Promise.resolve().then(() => (init_registry2(), registry_exports));
+  let missing;
+  try {
+    missing = await detectMissingPlugins2(packageRoot, { includeMuted: true });
+  } catch {
+    return WARN("could not detect optional plugins");
+  }
+  if (missing.length === 0) return OK("all optional plugins available");
+  const lines = missing.map((p3) => `${p3.id} missing \u2014 /plugins install ${p3.id}`);
+  return WARN(
+    `${missing.length} optional plugin(s) missing (features degrade silently without them):
+` + lines.map((l) => `         ${l}`).join("\n") + "\n         install via: /plugins  (or the boot prompt)"
+  );
+}
+async function runDoctor() {
   const pkg = readPackageJson3();
   const pkgName = pkg?.name ?? "zelari-code";
   const checks = [
+    // --- install-health checks (main-process probes) ---
     { name: "node", run: () => checkNode(pkg) },
     { name: "bin shim", run: () => checkShim(pkgName) },
     { name: "cli bundle", run: () => checkBundle() },
     { name: "runtime deps", run: () => checkRuntimeDeps() },
-    { name: "PATH", run: () => checkPath() }
+    { name: "PATH", run: () => checkPath() },
+    // --- agent-shell checks (v1.4.0) ---
+    // These probe node/git/bash THROUGH the resolved shell the agent uses.
+    // A pass on "node" + a FAIL on "node (agent shell)" is the tell-tale
+    // signature of the PATH-mismatch bug (node visible to the main process,
+    // invisible to Git Bash) that silently breaks council builds.
+    { name: "node (agent shell)", run: () => prereqToCheckResult(checkAgentNode()) },
+    { name: "git (agent shell)", run: () => prereqToCheckResult(checkAgentGit()) },
+    { name: "bash", run: () => prereqToCheckResult(checkAgentBash()) },
+    // --- 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
+    // here so `zelari-code --doctor` tells the user what's missing + how to
+    // install (`/plugins` or the boot PluginGate).
+    { name: "plugins", run: () => checkOptionalPlugins() }
   ];
   console.log(`zelari-code doctor (v${pkg?.version ?? "unknown"})`);
   console.log("platform:", process.platform, process.arch);
@@ -26730,7 +27578,7 @@ function runDoctor() {
   for (const c of checks) {
     let result;
     try {
-      result = c.run();
+      result = await c.run();
     } catch (err) {
       result = FAIL(
         `unexpected error: ${err instanceof Error ? err.message : String(err)}`
@@ -26759,8 +27607,9 @@ var require3, __dirname3, packageRoot, OK, FAIL, WARN;
 var init_doctor = __esm({
   "src/cli/utils/doctor.ts"() {
     "use strict";
+    init_prereqChecks();
     require3 = createRequire2(import.meta.url);
-    __dirname3 = path32.dirname(fileURLToPath2(import.meta.url));
+    __dirname3 = path33.dirname(fileURLToPath2(import.meta.url));
     packageRoot = findPackageRoot(__dirname3);
     OK = (message) => ({
       ok: true,
@@ -26780,8 +27629,87 @@ var init_doctor = __esm({
   }
 });
 
+// src/cli/utils/fixPath.ts
+var fixPath_exports = {};
+__export(fixPath_exports, {
+  repairWindowsUserPath: () => repairWindowsUserPath
+});
+import { spawnSync as spawnSync4 } from "node:child_process";
+function getGlobalPrefix2() {
+  return (process.env.npm_config_prefix || process.env.NPM_CONFIG_PREFIX || "").trim() || (() => {
+    try {
+      return spawnSync4("npm", ["prefix", "-g"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).stdout?.trim() ?? "";
+    } catch {
+      return "";
+    }
+  })();
+}
+function powershell(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 repairWindowsUserPath() {
+  const prefix = getGlobalPrefix2();
+  if (!prefix) {
+    return {
+      ok: false,
+      prefix: "",
+      error: "could not detect the npm global prefix (run inside an npm context, or set npm_config_prefix)"
+    };
+  }
+  if (process.platform !== "win32") {
+    return {
+      ok: false,
+      prefix,
+      error: `--fix-path is Windows-only. On ${process.platform}, add to your shell profile:
+  export PATH="${prefix}/bin:$PATH"`
+    };
+  }
+  const userPath = powershell(
+    "[Environment]::GetEnvironmentVariable('Path','User')"
+  );
+  const norm = (p3) => p3.toLowerCase().replace(/\/+/g, "\\").replace(/\\+$/, "");
+  const entries = userPath.split(";").map((e) => e.trim()).filter(Boolean);
+  if (entries.some((e) => norm(e) === norm(prefix))) {
+    return { ok: true, alreadyOk: true, prefix };
+  }
+  const updated = userPath === "" || userPath.endsWith(";") ? `${userPath}${prefix}` : `${userPath};${prefix}`;
+  const writeRes = powershell(
+    `[Environment]::SetEnvironmentVariable('Path', ${JSON.stringify(updated)}, 'User')`
+  );
+  const reread = powershell(
+    "[Environment]::GetEnvironmentVariable('Path','User')"
+  );
+  const rereadEntries = reread.split(";").map((e) => e.trim()).filter(Boolean);
+  if (rereadEntries.some((e) => norm(e) === norm(prefix))) {
+    return { ok: true, alreadyOk: false, prefix };
+  }
+  return {
+    ok: false,
+    prefix,
+    error: writeRes === null && reread === userPath ? "PowerShell write did not take effect (permission denied? run as the same user that owns the install)" : "PATH write failed for an unknown reason"
+  };
+}
+var init_fixPath = __esm({
+  "src/cli/utils/fixPath.ts"() {
+    "use strict";
+  }
+});
+
 // src/cli/main.ts
-import React13 from "react";
+import React14 from "react";
 import { render } from "ink";
 
 // src/cli/app.tsx
@@ -27714,16 +28642,8 @@ function useExecutionTimer(busy, tickMs = 1e3) {
   return { elapsedMs, lastMs };
 }
 
-// src/cli/utils/paths.ts
-import { homedir as homedir2 } from "node:os";
-function shortenCwd(p3, maxLen = 40, home = homedir2()) {
-  let out = p3;
-  if (home && (out === home || out.startsWith(`${home}\\`) || out.startsWith(`${home}/`))) {
-    out = `~${out.slice(home.length)}`;
-  }
-  if (out.length <= maxLen) return out;
-  return `\u2026${out.slice(-(maxLen - 1))}`;
-}
+// src/cli/app.tsx
+init_paths();
 
 // packages/core/dist/agents/skills/builtin/debugging.js
 init_skills();
@@ -29717,14 +30637,14 @@ import { useState as useState5, useRef as useRef3, useCallback, useEffect as use
 // src/cli/sessionManager.ts
 init_harness();
 import { promises as fs9, existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4, unlinkSync, statSync } from "node:fs";
-import path11 from "node:path";
+import path12 from "node:path";
 import os4 from "node:os";
 import { randomUUID } from "node:crypto";
 function getSessionBaseDir() {
-  return process.env.ANATHEMA_SESSIONS_DIR ?? path11.join(os4.homedir(), ".tmp", "zelari-code", "sessions");
+  return process.env.ANATHEMA_SESSIONS_DIR ?? path12.join(os4.homedir(), ".tmp", "zelari-code", "sessions");
 }
 function getCurrentSessionFile() {
-  return process.env.ANATHEMA_CURRENT_SESSION_FILE ?? path11.join(os4.homedir(), ".tmp", "zelari-code", "current.txt");
+  return process.env.ANATHEMA_CURRENT_SESSION_FILE ?? path12.join(os4.homedir(), ".tmp", "zelari-code", "current.txt");
 }
 async function ensureSessionDir() {
   await fs9.mkdir(getSessionBaseDir(), { recursive: true });
@@ -29741,7 +30661,7 @@ function getCurrentSessionId() {
 }
 function setCurrentSessionId(id) {
   const file2 = getCurrentSessionFile();
-  mkdirSync4(path11.dirname(file2), { recursive: true });
+  mkdirSync4(path12.dirname(file2), { recursive: true });
   writeFileSync4(file2, id, "utf-8");
 }
 function clearCurrentSessionId() {
@@ -29753,7 +30673,7 @@ function clearCurrentSessionId() {
   }
 }
 function getCurrentBranchFile() {
-  return process.env.ANATHEMA_CURRENT_BRANCH_FILE ?? path11.join(path11.dirname(getCurrentSessionFile()), "currentBranch.txt");
+  return process.env.ANATHEMA_CURRENT_BRANCH_FILE ?? path12.join(path12.dirname(getCurrentSessionFile()), "currentBranch.txt");
 }
 function getCurrentBranch() {
   const file2 = getCurrentBranchFile();
@@ -29767,7 +30687,7 @@ function getCurrentBranch() {
 }
 function setCurrentBranch(name) {
   const file2 = getCurrentBranchFile();
-  mkdirSync4(path11.dirname(file2), { recursive: true });
+  mkdirSync4(path12.dirname(file2), { recursive: true });
   writeFileSync4(file2, name, "utf-8");
 }
 function newSessionId() {
@@ -29786,7 +30706,7 @@ async function listSessions() {
   for (const entry of entries) {
     if (!entry.endsWith(".jsonl")) continue;
     const id = entry.replace(/\.jsonl$/, "");
-    const filePath = path11.join(baseDir, entry);
+    const filePath = path12.join(baseDir, entry);
     try {
       const events = await readSession(filePath);
       let firstTs = 0;
@@ -29833,7 +30753,7 @@ ${lines.join("\n")}`
   return { message: `[${kind}] handled` };
 }
 async function loadSessionEvents(id) {
-  const filePath = path11.join(getSessionBaseDir(), `${id}.jsonl`);
+  const filePath = path12.join(getSessionBaseDir(), `${id}.jsonl`);
   return readSession(filePath);
 }
 
@@ -30125,15 +31045,15 @@ import { useState as useState6, useRef as useRef4, useCallback as useCallback2 }
 
 // src/cli/metrics.ts
 import { promises as fs10, existsSync as existsSync6, statSync as statSync2, renameSync, appendFileSync, mkdirSync as mkdirSync5 } from "node:fs";
-import path12 from "node:path";
+import path13 from "node:path";
 import os5 from "node:os";
 var METRICS_ROTATE_BYTES = 10 * 1024 * 1024;
 var MetricsLogger = class {
   file;
   writeQueue = Promise.resolve();
   constructor(file2) {
-    this.file = file2 ?? process.env.ANATHEMA_METRICS_FILE ?? path12.join(os5.homedir(), ".tmp", "zelari-code", "metrics.jsonl");
-    mkdirSync5(path12.dirname(this.file), { recursive: true });
+    this.file = file2 ?? process.env.ANATHEMA_METRICS_FILE ?? path13.join(os5.homedir(), ".tmp", "zelari-code", "metrics.jsonl");
+    mkdirSync5(path13.dirname(this.file), { recursive: true });
   }
   /** Fire-and-forget record append. */
   record(rec) {
@@ -30298,7 +31218,7 @@ init_diff();
 init_web();
 
 // src/cli/safety/sandboxPath.ts
-import path13 from "node:path";
+import path14 from "node:path";
 var SandboxViolationError = class extends Error {
   constructor(message, attemptedPath, resolvedPath) {
     super(message);
@@ -30311,9 +31231,9 @@ function resolveSandboxedPath(userPath, options = {}) {
   if (typeof userPath !== "string" || userPath.length === 0) {
     throw new SandboxViolationError("Empty path", userPath, "");
   }
-  const root = path13.resolve(options.root ?? process.cwd());
-  const resolved = path13.isAbsolute(userPath) ? path13.resolve(userPath) : path13.resolve(root, userPath);
-  const rootWithSep = root.endsWith(path13.sep) ? root : root + path13.sep;
+  const root = path14.resolve(options.root ?? process.cwd());
+  const resolved = path14.isAbsolute(userPath) ? path14.resolve(userPath) : path14.resolve(root, userPath);
+  const rootWithSep = root.endsWith(path14.sep) ? root : root + path14.sep;
   if (resolved !== root && !resolved.startsWith(rootWithSep)) {
     throw new SandboxViolationError(
       `Path escapes sandbox root: ${userPath} \u2192 ${resolved} (root: ${root})`,
@@ -30377,7 +31297,7 @@ function assertShellAllowed(command) {
 
 // src/cli/safety/auditLogger.ts
 import { promises as fs11 } from "node:fs";
-import path14 from "node:path";
+import path15 from "node:path";
 import os6 from "node:os";
 var AuditLogger = class {
   logPath;
@@ -30396,7 +31316,7 @@ var AuditLogger = class {
   async append(entry) {
     const line = JSON.stringify(entry) + "\n";
     this.writeQueue = this.writeQueue.then(async () => {
-      await fs11.mkdir(path14.dirname(this.logPath), { recursive: true });
+      await fs11.mkdir(path15.dirname(this.logPath), { recursive: true });
       await fs11.appendFile(this.logPath, line, "utf-8");
     });
     return this.writeQueue;
@@ -30440,7 +31360,7 @@ var AuditLogger = class {
 function defaultAuditPath() {
   const override = process.env.ANATHEMA_AUDIT_LOG;
   if (override && override.trim().length > 0) return override;
-  return path14.join(os6.tmpdir(), "zelari-code", "audit.jsonl");
+  return path15.join(os6.tmpdir(), "zelari-code", "audit.jsonl");
 }
 function redactArgs(args) {
   const redacted = {};
@@ -30463,181 +31383,8 @@ function safeStringify(value) {
   }
 }
 
-// src/cli/diagnostics/engine.ts
-import { spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync7 } from "node:fs";
-import path15 from "node:path";
-function parseEslintJson(stdout, _file2) {
-  const json2 = safeJson(stdout);
-  if (!Array.isArray(json2)) return [];
-  const out = [];
-  for (const fileResult of json2) {
-    if (!fileResult || typeof fileResult !== "object") continue;
-    const fr = fileResult;
-    const filePath = typeof fr.filePath === "string" ? fr.filePath : _file2;
-    if (!Array.isArray(fr.messages)) continue;
-    for (const m of fr.messages) {
-      if (!m || typeof m !== "object") continue;
-      const msg = m;
-      out.push({
-        file: filePath,
-        line: typeof msg.line === "number" ? msg.line : 0,
-        ...typeof msg.column === "number" ? { column: msg.column } : {},
-        // ESLint severity: 2 = error, 1 = warning.
-        severity: msg.severity === 2 ? "error" : "warning",
-        message: typeof msg.message === "string" ? msg.message : "(no message)",
-        ...typeof msg.ruleId === "string" && msg.ruleId ? { code: msg.ruleId } : {},
-        source: "eslint"
-      });
-    }
-  }
-  return out;
-}
-function parseRuffJson(stdout, _file2) {
-  const json2 = safeJson(stdout);
-  if (!Array.isArray(json2)) return [];
-  const out = [];
-  for (const issue2 of json2) {
-    if (!issue2 || typeof issue2 !== "object") continue;
-    const it = issue2;
-    const code = typeof it.code === "string" ? it.code : void 0;
-    out.push({
-      file: typeof it.filename === "string" ? it.filename : _file2,
-      line: typeof it.location?.row === "number" ? it.location.row : 0,
-      ...typeof it.location?.column === "number" ? { column: it.location.column } : {},
-      // Ruff has no severity field; E999 is a syntax error, everything else
-      // is a lint warning.
-      severity: code === "E999" ? "error" : "warning",
-      message: typeof it.message === "string" ? it.message : "(no message)",
-      ...code ? { code } : {},
-      source: "ruff"
-    });
-  }
-  return out;
-}
-function safeJson(s) {
-  const trimmed = s.trim();
-  if (!trimmed) return null;
-  try {
-    return JSON.parse(trimmed);
-  } catch {
-    return null;
-  }
-}
-var DEFAULT_PROVIDERS = [
-  {
-    name: "eslint",
-    bin: "eslint",
-    extensions: [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"],
-    args: (file2) => ["--format", "json", file2],
-    parse: parseEslintJson
-  },
-  {
-    name: "ruff",
-    bin: "ruff",
-    extensions: [".py"],
-    args: (file2) => ["check", "--output-format", "json", file2],
-    parse: parseRuffJson
-  }
-];
-function providerForFile(file2, providers = DEFAULT_PROVIDERS) {
-  const ext = path15.extname(file2).toLowerCase();
-  return providers.find((p3) => p3.extensions.includes(ext)) ?? null;
-}
-function resolveBin(bin, cwd) {
-  const suffixes = process.platform === "win32" ? [".cmd", ".exe", ""] : [""];
-  let dir = cwd;
-  for (let i = 0; i < 6; i += 1) {
-    for (const suffix of suffixes) {
-      const candidate = path15.join(dir, "node_modules", ".bin", `${bin}${suffix}`);
-      if (existsSync7(candidate)) return candidate;
-    }
-    const parent = path15.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return bin;
-}
-var defaultRunner = (cmd, args, opts) => new Promise((resolve) => {
-  let stdout = "";
-  let stderr = "";
-  let settled = false;
-  const done = (r) => {
-    if (settled) return;
-    settled = true;
-    resolve(r);
-  };
-  let child;
-  try {
-    child = process.platform === "win32" ? spawn2(`${cmd} ${args.join(" ")}`, { cwd: opts.cwd, shell: true }) : spawn2(cmd, args, { cwd: opts.cwd });
-  } catch {
-    done({ code: null, stdout: "", stderr: "" });
-    return;
-  }
-  const timer = setTimeout(() => {
-    try {
-      child.kill();
-    } catch {
-    }
-    done({ code: null, stdout, stderr });
-  }, opts.timeoutMs);
-  child.stdout?.on("data", (c) => {
-    stdout += c.toString();
-  });
-  child.stderr?.on("data", (c) => {
-    stderr += c.toString();
-  });
-  child.on("error", () => {
-    clearTimeout(timer);
-    done({ code: null, stdout: "", stderr: "" });
-  });
-  child.on("close", (code) => {
-    clearTimeout(timer);
-    done({ code, stdout, stderr });
-  });
-});
-async function runDiagnosticsForFile(file2, options = {}) {
-  const provider = providerForFile(file2, options.providers);
-  if (!provider) return [];
-  const cwd = options.cwd ?? process.cwd();
-  const timeoutMs = options.timeoutMs ?? 5e3;
-  const runner = options.runner ?? defaultRunner;
-  try {
-    const bin = options.runner ? provider.bin : resolveBin(provider.bin, cwd);
-    const result = await runner(bin, provider.args(file2), { cwd, timeoutMs });
-    return provider.parse(result.stdout, file2);
-  } catch {
-    return [];
-  }
-}
-function formatDiagnostics(diagnostics, opts = {}) {
-  if (diagnostics.length === 0) return "";
-  const maxLines = opts.maxLines ?? 20;
-  const rank = { error: 0, warning: 1, info: 2 };
-  const sorted = [...diagnostics].sort(
-    (a, b) => rank[a.severity] - rank[b.severity] || a.line - b.line
-  );
-  const errors = sorted.filter((d) => d.severity === "error").length;
-  const warnings = sorted.filter((d) => d.severity === "warning").length;
-  const header = `\u26A0 ${diagnostics.length} diagnostic${diagnostics.length === 1 ? "" : "s"} (${errors} error${errors === 1 ? "" : "s"}, ${warnings} warning${warnings === 1 ? "" : "s"}) \u2014 fix before continuing:`;
-  const shown = sorted.slice(0, maxLines).map((d) => {
-    const loc = opts.relativeTo ? relative(opts.relativeTo, d.file) : d.file;
-    const pos = d.column ? `${d.line}:${d.column}` : `${d.line}`;
-    const tag = d.severity === "error" ? "error" : d.severity === "warning" ? "warn" : "info";
-    const code = d.code ? ` [${d.code}]` : "";
-    return `  ${loc}:${pos} ${tag}${code}: ${d.message} (${d.source})`;
-  });
-  const overflow = sorted.length > maxLines ? [`  \u2026 and ${sorted.length - maxLines} more`] : [];
-  return [header, ...shown, ...overflow].join("\n");
-}
-function relative(from, to) {
-  try {
-    const rel2 = path15.relative(from, to);
-    return rel2 && !rel2.startsWith("..") ? rel2 : to;
-  } catch {
-    return to;
-  }
-}
+// src/cli/toolRegistry.ts
+init_engine();
 
 // src/cli/tools/taskTool.ts
 init_zod();
@@ -30744,7 +31491,6 @@ function createTaskTool(deps) {
 // src/cli/lsp/tools.ts
 init_zod();
 init_toolTypes();
-import path16 from "node:path";
 
 // src/cli/lsp/protocol.ts
 function encodeMessage(message) {
@@ -30797,21 +31543,14 @@ function uriToPath(uri) {
 }
 
 // src/cli/lsp/tools.ts
+init_paths();
 function fmtLocation(loc, relativeTo) {
   const file2 = uriToPath(loc.uri);
-  const rel2 = relativeTo ? relPath(relativeTo, file2) : file2;
+  const rel2 = relativeTo ? relativePosix(relativeTo, file2) : file2;
   const line = (loc.range?.start?.line ?? 0) + 1;
   const col = (loc.range?.start?.character ?? 0) + 1;
   return `${rel2}:${line}:${col}`;
 }
-function relPath(from, to) {
-  try {
-    const r = path16.relative(from, to);
-    return r && !r.startsWith("..") ? r : to;
-  } catch {
-    return to;
-  }
-}
 var PosArgs = external_exports.object({
   path: external_exports.string().min(1).describe("File path (relative to the project root or absolute)."),
   line: external_exports.number().int().positive().describe("1-based line number of the symbol."),
@@ -30888,7 +31627,7 @@ function createLspTools(provider, root = process.cwd()) {
       }
       return typedOk({
         totalEdits: result.totalEdits,
-        files: result.files.map((f) => `${relPath(root, f.file)} (${f.count} edit${f.count === 1 ? "" : "s"})`)
+        files: result.files.map((f) => `${relativePosix(root, f.file)} (${f.count} edit${f.count === 1 ? "" : "s"})`)
       });
     }
   };
@@ -30971,66 +31710,8 @@ var LspClient = class {
   }
 };
 
-// src/cli/lsp/servers.ts
-import path17 from "node:path";
-var LSP_SERVERS = [
-  {
-    language: "typescript",
-    bin: "typescript-language-server",
-    args: ["--stdio"],
-    extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]
-  },
-  {
-    language: "python",
-    bin: "pyright-langserver",
-    args: ["--stdio"],
-    extensions: [".py"]
-  },
-  {
-    language: "go",
-    bin: "gopls",
-    args: [],
-    extensions: [".go"]
-  },
-  {
-    language: "rust",
-    bin: "rust-analyzer",
-    args: [],
-    extensions: [".rs"]
-  }
-];
-function languageIdForFile(file2) {
-  const ext = path17.extname(file2).toLowerCase();
-  const map2 = {
-    ".ts": "typescript",
-    ".tsx": "typescriptreact",
-    ".js": "javascript",
-    ".jsx": "javascriptreact",
-    ".mjs": "javascript",
-    ".cjs": "javascript",
-    ".py": "python",
-    ".go": "go",
-    ".rs": "rust"
-  };
-  return map2[ext] ?? "plaintext";
-}
-function serverForFile(file2, servers = LSP_SERVERS) {
-  const ext = path17.extname(file2).toLowerCase();
-  return servers.find((s) => s.extensions.includes(ext)) ?? null;
-}
-function resolveServerCommand(file2, cwd, servers = LSP_SERVERS) {
-  const spec = serverForFile(file2, servers);
-  if (!spec) return null;
-  const command = resolveBin(spec.bin, cwd);
-  return {
-    language: spec.language,
-    command,
-    args: spec.args,
-    resolved: command !== spec.bin
-  };
-}
-
 // src/cli/lsp/manager.ts
+init_servers();
 function processTransport(child) {
   return {
     send: (data) => {
@@ -31753,103 +32434,9 @@ function createSemanticTool(deps) {
 // src/cli/browser/tools.ts
 init_zod();
 init_toolTypes();
+init_driver();
 import path21 from "node:path";
 import os7 from "node:os";
-
-// src/cli/browser/driver.ts
-var defaultPlaywrightLoader = async () => {
-  try {
-    const pkg = "playwright";
-    const mod = await import(pkg);
-    if (mod && mod.chromium && typeof mod.chromium.launch === "function") return mod;
-    return null;
-  } catch {
-    return null;
-  }
-};
-async function runBrowserCheck(options, loader = defaultPlaywrightLoader) {
-  const consoleErrors = [];
-  const pageErrors = [];
-  const failedRequests = [];
-  const base = { ok: false, consoleErrors, pageErrors, failedRequests };
-  const pw = await loader();
-  if (!pw) {
-    return {
-      ...base,
-      error: "browser automation unavailable \u2014 install Playwright (`npm i -D playwright && npx playwright install chromium`) to enable browser_check"
-    };
-  }
-  const timeout = options.timeoutMs ?? 15e3;
-  let browser;
-  try {
-    browser = await pw.chromium.launch({ headless: true });
-    const page = await browser.newPage();
-    page.on("console", (msg) => {
-      if (msg.type() === "error") consoleErrors.push(msg.text());
-    });
-    page.on("pageerror", (err) => pageErrors.push(err.message));
-    page.on("requestfailed", (req) => {
-      const f = req.failure();
-      failedRequests.push(`${req.url()}${f ? ` (${f.errorText})` : ""}`);
-    });
-    await page.goto(options.url, { waitUntil: "load", timeout });
-    for (const action of options.actions ?? []) {
-      switch (action.type) {
-        case "click":
-          await page.click(action.selector, { timeout });
-          break;
-        case "fill":
-          await page.fill(action.selector, action.value, { timeout });
-          break;
-        case "goto":
-          await page.goto(action.url, { waitUntil: "load", timeout });
-          break;
-        case "wait":
-          await page.waitForTimeout(action.ms);
-          break;
-        default:
-          break;
-      }
-    }
-    let selectorFound;
-    if (options.waitForSelector) {
-      try {
-        await page.waitForSelector(options.waitForSelector, { timeout });
-        selectorFound = true;
-      } catch {
-        selectorFound = false;
-      }
-    }
-    let screenshotPath;
-    if (options.screenshotPath) {
-      try {
-        await page.screenshot({ path: options.screenshotPath });
-        screenshotPath = options.screenshotPath;
-      } catch {
-      }
-    }
-    const title = await page.title().catch(() => void 0);
-    return {
-      ok: true,
-      consoleErrors,
-      pageErrors,
-      failedRequests,
-      url: page.url(),
-      ...title !== void 0 ? { title } : {},
-      ...selectorFound !== void 0 ? { selectorFound } : {},
-      ...screenshotPath ? { screenshotPath } : {}
-    };
-  } catch (err) {
-    return { ...base, error: err instanceof Error ? err.message : String(err) };
-  } finally {
-    try {
-      await browser?.close();
-    } catch {
-    }
-  }
-}
-
-// src/cli/browser/tools.ts
 var ActionSchema = external_exports.discriminatedUnion("type", [
   external_exports.object({ type: external_exports.literal("click"), selector: external_exports.string().min(1) }),
   external_exports.object({ type: external_exports.literal("fill"), selector: external_exports.string().min(1), value: external_exports.string() }),
@@ -33198,6 +33785,8 @@ function handleSlashCommand(text, availableSkills) {
   /council-feedback <memberId> <1-5> [note] \u2014 rate a council member for future ranking (Task I.2)
   /promote-member <memberId> \u2014 promote a council member to a standalone skill (v3-K)
   /update [--yes|-y] \u2014 check for zelari-code updates; --yes performs the update (v3-N)
+  /plugins \u2014 list optional tool plugins (Playwright, eslint, ruff, LSP servers)
+  /plugins install <id> \u2014 install a plugin now (e.g. /plugins install eslint)
   /steer <text> \u2014 enqueue a follow-up prompt on the active run (Task 18.2)
   /steer --interrupt <text> \u2014 cancel current run + enqueue <text> for next dispatch (Task C.3.2)
   /compact \u2014 compact the session transcript
@@ -33540,6 +34129,19 @@ ${formatSkillList(availableSkills)}`
         updateForce: force
       };
     }
+    case "plugins": {
+      if (args.length === 0) {
+        return { handled: true, kind: "plugins_list" };
+      }
+      if (args[0] === "install" && args[1]) {
+        return { handled: true, kind: "plugins_install", pluginId: args[1] };
+      }
+      return {
+        handled: true,
+        kind: "plugins_usage",
+        message: "Usage: /plugins \u2014 list optional tool plugins (Playwright, eslint, ruff, LSP servers)\n       /plugins install <id> \u2014 install a plugin now (e.g. /plugins install eslint)"
+      };
+    }
     case "undo": {
       const confirmed = args.includes("--yes") || args.includes("-y");
       if (confirmed) {
@@ -33931,12 +34533,18 @@ async function handleUpdatePerform(ctx) {
     const { performUpdate: performUpdate2 } = await Promise.resolve().then(() => (init_updater(), updater_exports));
     const res = await performUpdate2();
     if (res.ok) {
+      let prereqBlock = "";
+      try {
+        const { runPrereqChecks: runPrereqChecks2 } = await Promise.resolve().then(() => (init_prereqChecks(), prereqChecks_exports));
+        const { warnings } = runPrereqChecks2({ mode: "preflight" });
+        if (warnings.length > 0) {
+          prereqBlock = "\n\n\u26A0 Prerequisite warnings (the agent may be limited after restart):\n" + warnings.map((w) => `   - ${w.tool}: ${w.message.replace(/\n/g, "\n     ")}`).join("\n") + "\n   Run `zelari-code --doctor` after restart for the full report.";
+        }
+      } catch {
+      }
       appendSystem(
         ctx.setMessages,
-        `[update] \u2705 installed successfully
-
-Please restart zelari-code manually to use the new version.
-(exit with /exit or Ctrl+C, then run \`zelari-code\` again)`
+        "[update] \u2705 installed successfully\n\nPlease restart zelari-code manually to use the new version.\n(exit with /exit or Ctrl+C, then run `zelari-code` again)" + prereqBlock
       );
     } else {
       const output = res.output?.trim() || "(empty)";
@@ -33985,17 +34593,124 @@ ${output}`.toLowerCase();
   return "\u{1F4A1} hint: the install did not succeed. To retry with more detail:\n         npm install -g zelari-code@latest --verbose 2>&1 | tail -40\n   On Windows, also try: `npm install -g zelari-code@latest --force`\n" + (isWin ? "   Run `zelari-code doctor` from a new terminal to diagnose shim / PATH issues.\n" : "");
 }
 
+// src/cli/slashHandlers/plugins.ts
+init_registry2();
+
+// src/cli/plugins/installer.ts
+init_cmdline();
+init_updater();
+import { spawn as spawn8 } from "node:child_process";
+async function installPlugin(spec, cwd, executor = spawn8) {
+  const scopeFlag = spec.installScope === "global" ? "-g" : "-D";
+  const args = ["install", scopeFlag, spec.npmPackage];
+  const primary = await runNpm2(executor, args, cwd, "shim");
+  if (primary.ok) return primary;
+  const npmCli = resolveBundledNpmCli();
+  if (npmCli && looksLikeBrokenShim(primary.exitCode, primary.output)) {
+    const fallback = await runNpm2(executor, args, cwd, "bundled", npmCli);
+    return {
+      ...fallback,
+      output: `[plugins] npm shim failed (${primary.error ?? "exit " + primary.exitCode}); retried via bundled npm (${npmCli}).
+${fallback.output}`
+    };
+  }
+  return primary;
+}
+function runNpm2(executor, args, cwd, mode, npmCliPath) {
+  return new Promise((resolve) => {
+    let stdout = "";
+    let stderr = "";
+    const stdio = ["ignore", "pipe", "pipe"];
+    const child = mode === "bundled" && npmCliPath ? executor(process.execPath, [npmCliPath, ...args], { stdio, cwd }) : process.platform === "win32" ? executor(buildCmdLine("npm", args), { stdio, shell: true, cwd }) : executor("npm", args, { stdio, cwd });
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("error", (err) => {
+      resolve({
+        ok: false,
+        output: stdout + stderr,
+        error: err.message,
+        exitCode: null
+      });
+    });
+    child.on("close", (code) => {
+      const ok = code === 0;
+      resolve({
+        ok,
+        output: stdout + stderr,
+        exitCode: code,
+        error: ok ? void 0 : `npm exited with code ${code}`
+      });
+    });
+  });
+}
+
+// src/cli/slashHandlers/plugins.ts
+async function handlePluginsList(ctx, cwd) {
+  const lines = ["[plugins] optional tool plugins:"];
+  for (const spec of PLUGINS) {
+    let present = false;
+    try {
+      present = await spec.detect(cwd);
+    } catch {
+      present = false;
+    }
+    const mark = present ? "\u2713" : "\u2717";
+    const state2 = present ? "installed" : "missing";
+    const hint = present ? "" : ` \u2014 run \`/plugins install ${spec.id}\``;
+    lines.push(`  ${mark} ${spec.label.padEnd(38)} ${state2}${hint}`);
+  }
+  lines.push("Missing plugins are optional \u2014 features degrade silently without them.");
+  appendSystem(ctx.setMessages, lines.join("\n"));
+}
+async function handlePluginsInstall(ctx, cwd, pluginId) {
+  const spec = findPlugin(pluginId);
+  if (!spec) {
+    appendSystem(
+      ctx.setMessages,
+      `[plugins] unknown plugin id: '${pluginId}'. Available: ${PLUGINS.map((p3) => p3.id).join(", ")}`
+    );
+    return;
+  }
+  const scopeFlag = spec.installScope === "global" ? "-g" : "-D";
+  appendSystem(
+    ctx.setMessages,
+    `[plugins] installing ${spec.label} (\`npm i ${scopeFlag} ${spec.npmPackage}\`)\u2026`
+  );
+  let result;
+  try {
+    result = await installPlugin(spec, cwd);
+  } catch {
+    result = { ok: false, output: "", exitCode: null, error: "unexpected error" };
+  }
+  if (result.ok) {
+    const post = spec.postInstallHint ? `
+  \u2192 ${spec.postInstallHint}` : "";
+    appendSystem(ctx.setMessages, `[plugins] \u2713 installed ${spec.label}${post}`);
+  } else {
+    const tail = result.output ? `
+${result.output.split("\n").slice(-8).join("\n")}` : "";
+    appendSystem(
+      ctx.setMessages,
+      `[plugins] \u2717 install failed for ${spec.label}: ${result.error ?? "unknown error"}${tail}`
+    );
+  }
+}
+
 // src/cli/slashHandlers/promoteMember.ts
 import { promises as fs16 } from "node:fs";
-import path28 from "node:path";
-import os9 from "node:os";
+import path29 from "node:path";
+import os10 from "node:os";
 async function handlePromoteMember(ctx, memberId) {
   try {
     const { promoteMember: promoteMember2 } = await Promise.resolve().then(() => (init_council(), council_exports));
     const { skill, markdown } = promoteMember2(memberId);
-    const skillDir = process.env.ANATHEMA_SKILL_DIR ?? path28.join(os9.homedir(), ".tmp", "zelari-code", "skills");
+    const skillDir = process.env.ANATHEMA_SKILL_DIR ?? path29.join(os10.homedir(), ".tmp", "zelari-code", "skills");
     await fs16.mkdir(skillDir, { recursive: true });
-    const filePath = path28.join(skillDir, `${skill.id}.md`);
+    const filePath = path29.join(skillDir, `${skill.id}.md`);
     await fs16.writeFile(filePath, markdown, "utf8");
     appendSystem(
       ctx.setMessages,
@@ -34012,33 +34727,33 @@ async function handlePromoteMember(ctx, memberId) {
 }
 
 // src/cli/branchManager.ts
-import { promises as fs17, existsSync as existsSync25, readFileSync as readFileSync23, writeFileSync as writeFileSync15, mkdirSync as mkdirSync10, statSync as statSync4, rmSync as rmSync2 } from "node:fs";
-import path29 from "node:path";
-import os10 from "node:os";
+import { promises as fs17, existsSync as existsSync27, readFileSync as readFileSync24, writeFileSync as writeFileSync16, mkdirSync as mkdirSync11, statSync as statSync4, rmSync as rmSync2 } from "node:fs";
+import path30 from "node:path";
+import os11 from "node:os";
 var META_FILENAME = "meta.json";
 var SESSIONS_SUBDIR = "sessions";
 function getBranchesBaseDir() {
-  return process.env.ANATHEMA_BRANCHES_DIR ?? path29.join(os10.homedir(), ".tmp", "zelari-code", "branches");
+  return process.env.ANATHEMA_BRANCHES_DIR ?? path30.join(os11.homedir(), ".tmp", "zelari-code", "branches");
 }
 function getSessionsBaseDir() {
-  return process.env.ANATHEMA_SESSIONS_DIR ?? path29.join(os10.homedir(), ".tmp", "zelari-code", "sessions");
+  return process.env.ANATHEMA_SESSIONS_DIR ?? path30.join(os11.homedir(), ".tmp", "zelari-code", "sessions");
 }
 function branchPathFor(name, baseDir) {
-  return path29.join(baseDir, name);
+  return path30.join(baseDir, name);
 }
 function metaPathFor(name, baseDir) {
-  return path29.join(baseDir, name, META_FILENAME);
+  return path30.join(baseDir, name, META_FILENAME);
 }
 function sessionsPathFor(name, baseDir) {
-  return path29.join(baseDir, name, SESSIONS_SUBDIR);
+  return path30.join(baseDir, name, SESSIONS_SUBDIR);
 }
 function readBranchMeta(name, baseDir) {
   const metaPath = metaPathFor(name, baseDir);
-  if (!existsSync25(metaPath)) {
+  if (!existsSync27(metaPath)) {
     throw new BranchNotFoundError(`Branch "${name}" not found`);
   }
   try {
-    const raw = readFileSync23(metaPath, "utf-8");
+    const raw = readFileSync24(metaPath, "utf-8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object" || typeof parsed.name !== "string" || typeof parsed.createdAt !== "number" || typeof parsed.fromSessionId !== "string") {
       throw new BranchCorruptError(`Branch "${name}" meta.json is malformed`);
@@ -34055,8 +34770,8 @@ function readBranchMeta(name, baseDir) {
 }
 function writeBranchMeta(name, baseDir, meta3) {
   const metaPath = metaPathFor(name, baseDir);
-  mkdirSync10(path29.dirname(metaPath), { recursive: true });
-  writeFileSync15(metaPath, JSON.stringify(meta3, null, 2), "utf-8");
+  mkdirSync11(path30.dirname(metaPath), { recursive: true });
+  writeFileSync16(metaPath, JSON.stringify(meta3, null, 2), "utf-8");
 }
 async function countSessions(name, baseDir) {
   const sessionsPath = sessionsPathFor(name, baseDir);
@@ -34094,7 +34809,7 @@ var SessionNotFoundError = class extends Error {
 };
 function branchExists(name, baseDir = getBranchesBaseDir()) {
   const bp = branchPathFor(name, baseDir);
-  return existsSync25(bp) && existsSync25(metaPathFor(name, baseDir));
+  return existsSync27(bp) && existsSync27(metaPathFor(name, baseDir));
 }
 async function createBranch(name, fromSessionId, baseDir = getBranchesBaseDir(), sessionsBaseDir = getSessionsBaseDir()) {
   if (!name || name.trim().length === 0) {
@@ -34106,14 +34821,14 @@ async function createBranch(name, fromSessionId, baseDir = getBranchesBaseDir(),
   if (branchExists(name, baseDir)) {
     throw new BranchAlreadyExistsError(name);
   }
-  const sourcePath = path29.join(sessionsBaseDir, `${fromSessionId}.jsonl`);
-  if (!existsSync25(sourcePath)) {
+  const sourcePath = path30.join(sessionsBaseDir, `${fromSessionId}.jsonl`);
+  if (!existsSync27(sourcePath)) {
     throw new SessionNotFoundError(`Source session "${fromSessionId}" not found at ${sourcePath}`);
   }
   const branchPath = branchPathFor(name, baseDir);
   const branchSessionsPath = sessionsPathFor(name, baseDir);
-  mkdirSync10(branchSessionsPath, { recursive: true });
-  const destPath = path29.join(branchSessionsPath, `${fromSessionId}.jsonl`);
+  mkdirSync11(branchSessionsPath, { recursive: true });
+  const destPath = path30.join(branchSessionsPath, `${fromSessionId}.jsonl`);
   await fs17.copyFile(sourcePath, destPath);
   const meta3 = {
     name,
@@ -34140,7 +34855,7 @@ async function listBranches(baseDir = getBranchesBaseDir()) {
   const results = [];
   for (const entry of entries) {
     const metaPath = metaPathFor(entry, baseDir);
-    if (!existsSync25(metaPath)) continue;
+    if (!existsSync27(metaPath)) continue;
     try {
       const meta3 = readBranchMeta(entry, baseDir);
       const sessionCount = await countSessions(entry, baseDir);
@@ -34214,14 +34929,14 @@ async function handleBranchCheckout(ctx, branchName) {
 
 // src/cli/slashHandlers/workspace.ts
 import { promises as fs18 } from "node:fs";
-import path30 from "node:path";
+import path31 from "node:path";
 async function handleWorkspaceShow(ctx, what) {
   try {
-    const zelari = path30.join(process.cwd(), ".zelari");
+    const zelari = path31.join(process.cwd(), ".zelari");
     let content;
     switch (what) {
       case "plan": {
-        const planPath = path30.join(zelari, "plan.md");
+        const planPath = path31.join(zelari, "plan.md");
         try {
           content = await fs18.readFile(planPath, "utf-8");
         } catch {
@@ -34230,7 +34945,7 @@ async function handleWorkspaceShow(ctx, what) {
         break;
       }
       case "decisions": {
-        const decisionsDir = path30.join(zelari, "decisions");
+        const decisionsDir = path31.join(zelari, "decisions");
         try {
           const files = (await fs18.readdir(decisionsDir)).filter((f) => f.endsWith(".md")).sort();
           if (files.length === 0) {
@@ -34240,7 +34955,7 @@ async function handleWorkspaceShow(ctx, what) {
 `];
             const { parseFrontmatter: parseFrontmatter2 } = await Promise.resolve().then(() => (init_storage(), storage_exports));
             for (const f of files) {
-              const raw = await fs18.readFile(path30.join(decisionsDir, f), "utf-8");
+              const raw = await fs18.readFile(path31.join(decisionsDir, f), "utf-8");
               const { meta: meta3, body } = parseFrontmatter2(raw);
               const title = meta3.title ?? body.split("\n")[0]?.replace(/^#\s*/, "").trim() ?? f;
               lines.push(`- **${f.replace(/\.md$/, "")}** [${meta3.status ?? "unknown"}] ${title}`);
@@ -34253,7 +34968,7 @@ async function handleWorkspaceShow(ctx, what) {
         break;
       }
       case "risks": {
-        const risksPath = path30.join(zelari, "risks.md");
+        const risksPath = path31.join(zelari, "risks.md");
         try {
           content = await fs18.readFile(risksPath, "utf-8");
         } catch {
@@ -34262,7 +34977,7 @@ async function handleWorkspaceShow(ctx, what) {
         break;
       }
       case "agents": {
-        const agentsPath = path30.join(process.cwd(), "AGENTS.MD");
+        const agentsPath = path31.join(process.cwd(), "AGENTS.MD");
         try {
           content = await fs18.readFile(agentsPath, "utf-8");
         } catch {
@@ -34271,7 +34986,7 @@ async function handleWorkspaceShow(ctx, what) {
         break;
       }
       case "docs": {
-        const docsDir = path30.join(zelari, "docs");
+        const docsDir = path31.join(zelari, "docs");
         try {
           const files = (await fs18.readdir(docsDir)).filter((f) => f.endsWith(".md")).sort();
           content = files.length ? `# Docs (${files.length})
@@ -34313,7 +35028,7 @@ async function handleWorkspaceReset(ctx, force) {
     return;
   }
   try {
-    const target = path30.join(process.cwd(), ".zelari");
+    const target = path31.join(process.cwd(), ".zelari");
     await fs18.rm(target, { recursive: true, force: true });
     appendSystem(ctx.setMessages, "[workspace] .zelari/ removed");
   } catch (err) {
@@ -34672,11 +35387,11 @@ function handleModelsRefresh(ctx) {
 }
 
 // src/cli/slashHandlers/skills.ts
-import path31 from "node:path";
-import os11 from "node:os";
+import path32 from "node:path";
+import os12 from "node:os";
 
 // src/cli/skillHistory.ts
-import { promises as fs19, existsSync as existsSync26, statSync as statSync5, renameSync as renameSync4, appendFileSync as appendFileSync3, mkdirSync as mkdirSync11 } from "node:fs";
+import { promises as fs19, existsSync as existsSync28, statSync as statSync5, renameSync as renameSync4, appendFileSync as appendFileSync3, mkdirSync as mkdirSync12 } from "node:fs";
 var SKILL_HISTORY_ROTATE_BYTES = 10 * 1024 * 1024;
 async function readSkillHistory(file2) {
   let raw = "";
@@ -34774,7 +35489,7 @@ async function applySteerInterrupt(options) {
 
 // src/cli/slashHandlers/skills.ts
 async function handleSkillStats(ctx, skillId) {
-  const historyFile = process.env.ANATHEMA_SKILL_HISTORY_FILE ?? path31.join(os11.homedir(), ".tmp", "zelari-code", "skill-history.jsonl");
+  const historyFile = process.env.ANATHEMA_SKILL_HISTORY_FILE ?? path32.join(os12.homedir(), ".tmp", "zelari-code", "skill-history.jsonl");
   try {
     const records = await readSkillHistory(historyFile);
     const stats = getSkillStats(records, skillId);
@@ -34790,7 +35505,7 @@ async function handleSkillCompare(ctx, ids, fallbackMessage) {
     appendSystem(ctx.setMessages, fallbackMessage ?? "[skill-compare] missing args");
     return;
   }
-  const historyFile = process.env.ANATHEMA_SKILL_HISTORY_FILE ?? path31.join(os11.homedir(), ".tmp", "zelari-code", "skill-history.jsonl");
+  const historyFile = process.env.ANATHEMA_SKILL_HISTORY_FILE ?? path32.join(os12.homedir(), ".tmp", "zelari-code", "skill-history.jsonl");
   try {
     const formatted = await compareSkillsFromFile(ids[0], ids[1], historyFile);
     appendSystem(ctx.setMessages, formatted);
@@ -35053,6 +35768,24 @@ function useSlashDispatch(params) {
       setInput("");
       return;
     }
+    if (result.kind === "plugins_list") {
+      await handlePluginsList({ setMessages }, process.cwd());
+      setInput("");
+      return;
+    }
+    if (result.kind === "plugins_install") {
+      await handlePluginsInstall({ setMessages }, process.cwd(), result.pluginId ?? "");
+      setInput("");
+      return;
+    }
+    if (result.kind === "plugins_usage") {
+      appendSystem(
+        setMessages,
+        result.message ?? "Usage: /plugins | /plugins install <id>"
+      );
+      setInput("");
+      return;
+    }
     if (result.kind === "workspace") {
       appendSystem(
         setMessages,
@@ -35616,13 +36349,131 @@ function SplashGate({
   return /* @__PURE__ */ React10.createElement(React10.Fragment, null, children);
 }
 
+// src/cli/components/PluginGate.tsx
+import React11, { useEffect as useEffect9, useState as useState10, useCallback as useCallback6 } from "react";
+import { Box as Box10, Text as Text11, useStdin as useStdin4 } from "ink";
+init_registry2();
+init_prefs();
+var CHOICE_INSTALL = "__install__";
+var CHOICE_LATER = "__later__";
+var CHOICE_NEVER = "__never__";
+function PluginGate({ cwd, children }) {
+  const { isRawModeSupported } = useStdin4();
+  const [phase, setPhase] = useState10("detecting");
+  const [queue, setQueue] = useState10([]);
+  const [current, setCurrent] = useState10(null);
+  const [result, setResult] = useState10(null);
+  const skipGate = process.env.ZELARI_NO_PLUGIN_PROMPT === "1" || isRawModeSupported !== true;
+  useEffect9(() => {
+    if (skipGate) {
+      setPhase("done");
+      return;
+    }
+    let cancelled = false;
+    void detectMissingPlugins(cwd).then((missing) => {
+      if (cancelled) return;
+      if (missing.length === 0) {
+        setPhase("done");
+        return;
+      }
+      setQueue(missing);
+      setCurrent(missing[0] ?? null);
+      setPhase(missing[0] ? "prompting" : "done");
+    }).catch(() => {
+      if (!cancelled) setPhase("done");
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [cwd, skipGate]);
+  const advance = useCallback6(() => {
+    setQueue((q) => {
+      const rest = q.slice(1);
+      if (rest.length === 0) {
+        setPhase("done");
+        setCurrent(null);
+        return rest;
+      }
+      setCurrent(rest[0] ?? null);
+      setPhase(rest[0] ? "prompting" : "done");
+      setResult(null);
+      return rest;
+    });
+  }, []);
+  const onSelect = useCallback6(
+    (value) => {
+      if (!current) return;
+      if (value === CHOICE_LATER) {
+        advance();
+      } else if (value === CHOICE_NEVER) {
+        markDontAskAgain(current.id);
+        advance();
+      } else if (value === CHOICE_INSTALL) {
+        setPhase("installing");
+        void installPlugin(current, cwd).then((r) => {
+          setResult(r);
+          setPhase("result");
+        }).catch(() => {
+          setResult({ ok: false, output: "", exitCode: null, error: "unexpected error" });
+          setPhase("result");
+        });
+      }
+    },
+    [current, cwd, advance]
+  );
+  if (phase === "done") {
+    return /* @__PURE__ */ React11.createElement(React11.Fragment, null, children);
+  }
+  if (phase === "detecting") {
+    return /* @__PURE__ */ React11.createElement(Box10, { paddingX: 1 }, /* @__PURE__ */ React11.createElement(Text11, { dimColor: true }, "Checking for optional tool plugins\u2026"));
+  }
+  if (!current) {
+    return /* @__PURE__ */ React11.createElement(React11.Fragment, null, children);
+  }
+  if (phase === "installing") {
+    return /* @__PURE__ */ React11.createElement(Box10, { flexDirection: "column", paddingX: 1 }, /* @__PURE__ */ React11.createElement(Text11, { color: "cyan" }, "\u23F3 Installing ", current.label, "\u2026"), /* @__PURE__ */ React11.createElement(Text11, { dimColor: true }, "npm install ", current.installScope === "global" ? "-g" : "-D", " ", current.npmPackage));
+  }
+  if (phase === "result") {
+    const ok = result?.ok === true;
+    return /* @__PURE__ */ React11.createElement(Box10, { flexDirection: "column", paddingX: 1 }, /* @__PURE__ */ React11.createElement(Text11, { color: ok ? "green" : "red" }, ok ? "\u2713" : "\u2717", " ", ok ? "Installed" : "Install failed", ": ", current.label), !ok && result?.error ? /* @__PURE__ */ React11.createElement(Text11, { dimColor: true }, result.error) : null, ok && current.postInstallHint ? /* @__PURE__ */ React11.createElement(Text11, { color: "yellow" }, "  \u2192 ", current.postInstallHint) : null, /* @__PURE__ */ React11.createElement(Text11, { dimColor: true }, "Press any key to continue\u2026"), /* @__PURE__ */ React11.createElement(ContinueKey, { onContinue: advance }));
+  }
+  const items = [
+    {
+      value: CHOICE_INSTALL,
+      label: `Install now`,
+      hint: `npm i ${current.installScope === "global" ? "-g" : "-D"} ${current.npmPackage}`
+    },
+    { value: CHOICE_LATER, label: "Maybe later" },
+    { value: CHOICE_NEVER, label: "Don't ask again" }
+  ];
+  return /* @__PURE__ */ React11.createElement(
+    SelectList,
+    {
+      title: `Optional plugin missing: ${current.label}`,
+      items,
+      onSelect,
+      onCancel: advance,
+      maxVisible: 4
+    }
+  );
+}
+function ContinueKey({ onContinue }) {
+  const { isRawModeSupported } = useStdin4();
+  useEffect9(() => {
+    const t = setTimeout(onContinue, 1500);
+    return () => clearTimeout(t);
+  }, [onContinue]);
+  void isRawModeSupported;
+  return null;
+}
+
 // src/cli/main.ts
 init_providerConfig();
 
 // src/cli/wizard/firstRun.ts
-import { existsSync as existsSync27 } from "node:fs";
+import { existsSync as existsSync29 } from "node:fs";
 function shouldRunWizard(input) {
-  const exists = input.exists ?? existsSync27;
+  const exists = input.exists ?? existsSync29;
   if (input.hasResetConfigFlag) {
     return { shouldRun: true, reason: "--reset-config flag forced wizard" };
   }
@@ -35657,15 +36508,15 @@ function parseWizardFlags(argv) {
 }
 
 // src/cli/wizard/runWizard.tsx
-import React12, { useEffect as useEffect9, useState as useState10 } from "react";
-import { Box as Box11, Text as Text12 } from "ink";
+import React13, { useEffect as useEffect10, useState as useState11 } from "react";
+import { Box as Box12, Text as Text13 } from "ink";
 import { useInput as useInput4 } from "ink";
 init_keyStore();
 init_providerConfig();
 
 // src/cli/wizard/index.tsx
-import React11 from "react";
-import { Box as Box10, Text as Text11 } from "ink";
+import React12 from "react";
+import { Box as Box11, Text as Text12 } from "ink";
 
 // src/cli/wizard/useWizardState.ts
 init_providerConfig();
@@ -35781,16 +36632,16 @@ var API_KEY_OPTIONS = ["env", "keystore", "skip"];
 
 // src/cli/wizard/index.tsx
 function Frame({ children }) {
-  return /* @__PURE__ */ React11.createElement(Box10, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1 }, children);
+  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1 }, children);
 }
 function Step(props) {
-  return /* @__PURE__ */ React11.createElement(Box10, null, /* @__PURE__ */ React11.createElement(Text11, { color: props.active ? "cyan" : "gray", inverse: props.active }, " ", props.index, "/", props.total, " ", props.name, " "));
+  return /* @__PURE__ */ React12.createElement(Box11, null, /* @__PURE__ */ React12.createElement(Text12, { color: props.active ? "cyan" : "gray", inverse: props.active }, " ", props.index, "/", props.total, " ", props.name, " "));
 }
 function renderProviderList(providers, cursor) {
-  return /* @__PURE__ */ React11.createElement(Box10, { flexDirection: "column" }, providers.map((p3, i) => {
+  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, providers.map((p3, i) => {
     const arrow = i === cursor ? "\u279C " : "  ";
     const color = i === cursor ? "cyan" : void 0;
-    return /* @__PURE__ */ React11.createElement(Text11, { key: p3.id, color }, arrow, p3.displayName, " ", /* @__PURE__ */ React11.createElement(Text11, { color: "gray" }, "(", p3.id, ", uses env ", p3.envVar, ")"));
+    return /* @__PURE__ */ React12.createElement(Text12, { key: p3.id, color }, arrow, p3.displayName, " ", /* @__PURE__ */ React12.createElement(Text12, { color: "gray" }, "(", p3.id, ", uses env ", p3.envVar, ")"));
   }));
 }
 function renderApiKeyOptions(cursor) {
@@ -35799,30 +36650,30 @@ function renderApiKeyOptions(cursor) {
     keystore: "Save to local keyStore (encrypted)",
     skip: "Skip for now (chat will fail until key is set)"
   };
-  return /* @__PURE__ */ React11.createElement(Box10, { flexDirection: "column" }, API_KEY_OPTIONS.map((choice, i) => {
+  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, API_KEY_OPTIONS.map((choice, i) => {
     const arrow = i === cursor ? "\u279C " : "  ";
     const color = i === cursor ? "cyan" : void 0;
-    return /* @__PURE__ */ React11.createElement(Text11, { key: choice, color }, arrow, labels[choice]);
+    return /* @__PURE__ */ React12.createElement(Text12, { key: choice, color }, arrow, labels[choice]);
   }));
 }
 function Wizard({ state: state2, providers }) {
   const s = state2.state;
   if (s.committed) {
-    return /* @__PURE__ */ React11.createElement(Frame, null, /* @__PURE__ */ React11.createElement(Text11, { color: "green" }, "\u2713 Setup complete!"), /* @__PURE__ */ React11.createElement(Text11, null, "Provider: ", /* @__PURE__ */ React11.createElement(Text11, { color: "cyan" }, s.providerId), " | ", "Model: ", /* @__PURE__ */ React11.createElement(Text11, { color: "cyan" }, s.model), " | ", "API key: ", /* @__PURE__ */ React11.createElement(Text11, { color: "cyan" }, s.apiKeyChoice ?? "n/a")), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React11.createElement(Text11, { color: "gray" }, "Launching zelari-code\u2026 (press any key)")));
+    return /* @__PURE__ */ React12.createElement(Frame, null, /* @__PURE__ */ React12.createElement(Text12, { color: "green" }, "\u2713 Setup complete!"), /* @__PURE__ */ React12.createElement(Text12, null, "Provider: ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, s.providerId), " | ", "Model: ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, s.model), " | ", "API key: ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, s.apiKeyChoice ?? "n/a")), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1 }, /* @__PURE__ */ React12.createElement(Text12, { color: "gray" }, "Launching zelari-code\u2026 (press any key)")));
   }
-  return /* @__PURE__ */ React11.createElement(Frame, null, /* @__PURE__ */ React11.createElement(Text11, { color: "cyan", bold: true }, "zelari-code v", VERSION, " \u2014 first-time setup"), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1, marginBottom: 1, flexDirection: "row" }, /* @__PURE__ */ React11.createElement(Step, { index: 1, total: 5, name: "welcome", active: s.step === "welcome" }), /* @__PURE__ */ React11.createElement(Step, { index: 2, total: 5, name: "provider", active: s.step === "provider" }), /* @__PURE__ */ React11.createElement(Step, { index: 3, total: 5, name: "model", active: s.step === "model" }), /* @__PURE__ */ React11.createElement(Step, { index: 4, total: 5, name: "apikey", active: s.step === "apikey" }), /* @__PURE__ */ React11.createElement(Step, { index: 5, total: 5, name: "confirm", active: s.step === "confirm" })), s.step === "welcome" && /* @__PURE__ */ React11.createElement(React11.Fragment, null, /* @__PURE__ */ React11.createElement(Text11, null, "Welcome! Let's get you coding in under two minutes."), /* @__PURE__ */ React11.createElement(Text11, { color: "gray" }, "We'll pick a provider, default model, and how to handle your API key."), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React11.createElement(Text11, null, "Press "), /* @__PURE__ */ React11.createElement(Text11, { color: "cyan", inverse: true }, " Enter "), /* @__PURE__ */ React11.createElement(Text11, null, " to continue, or "), /* @__PURE__ */ React11.createElement(Text11, { color: "red", inverse: true }, " Q "), /* @__PURE__ */ React11.createElement(Text11, null, " to quit (re-run with "), /* @__PURE__ */ React11.createElement(Text11, { color: "gray" }, "--no-wizard"), /* @__PURE__ */ React11.createElement(Text11, null, " to skip later)."))), s.step === "provider" && /* @__PURE__ */ React11.createElement(React11.Fragment, null, /* @__PURE__ */ React11.createElement(Text11, null, "Choose your LLM provider:"), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1 }, renderProviderList(providers, s.providerCursor)), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React11.createElement(Text11, { color: "gray" }, "\u2191/\u2193 to move, Enter to confirm"))), s.step === "model" && /* @__PURE__ */ React11.createElement(React11.Fragment, null, /* @__PURE__ */ React11.createElement(Text11, null, "Model for ", /* @__PURE__ */ React11.createElement(Text11, { color: "cyan" }, s.providerId), ":"), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1, borderStyle: "single", borderColor: "cyan", paddingX: 1 }, /* @__PURE__ */ React11.createElement(Text11, null, s.model ?? "(empty)")), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React11.createElement(Text11, null, "Press ", /* @__PURE__ */ React11.createElement(Text11, { color: "cyan", inverse: true }, " Enter "), "to accept, or type a new name. ", /* @__PURE__ */ React11.createElement(Text11, { color: "gray" }, "(default kept on empty input)")))), s.step === "apikey" && /* @__PURE__ */ React11.createElement(React11.Fragment, null, /* @__PURE__ */ React11.createElement(Text11, null, "How should we handle the API key?"), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1 }, renderApiKeyOptions(s.apiKeyCursor)), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React11.createElement(Text11, { color: "gray" }, "\u2191/\u2193 to move, Enter to confirm"))), s.step === "confirm" && /* @__PURE__ */ React11.createElement(React11.Fragment, null, /* @__PURE__ */ React11.createElement(Text11, null, "Confirm your setup:"), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React11.createElement(Text11, null, "Provider: ", /* @__PURE__ */ React11.createElement(Text11, { color: "cyan" }, s.providerId)), /* @__PURE__ */ React11.createElement(Text11, null, "Model:    ", /* @__PURE__ */ React11.createElement(Text11, { color: "cyan" }, s.model)), /* @__PURE__ */ React11.createElement(Text11, null, "API key:  ", /* @__PURE__ */ React11.createElement(Text11, { color: "cyan" }, s.apiKeyChoice ?? "(unset)"))), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React11.createElement(Text11, null, "Press ", /* @__PURE__ */ React11.createElement(Text11, { color: "green", inverse: true }, " Enter "), "to save and launch, or ", /* @__PURE__ */ React11.createElement(Text11, { color: "yellow", inverse: true }, " B "), "to go back."))));
+  return /* @__PURE__ */ React12.createElement(Frame, null, /* @__PURE__ */ React12.createElement(Text12, { color: "cyan", bold: true }, "zelari-code v", VERSION, " \u2014 first-time setup"), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1, marginBottom: 1, flexDirection: "row" }, /* @__PURE__ */ React12.createElement(Step, { index: 1, total: 5, name: "welcome", active: s.step === "welcome" }), /* @__PURE__ */ React12.createElement(Step, { index: 2, total: 5, name: "provider", active: s.step === "provider" }), /* @__PURE__ */ React12.createElement(Step, { index: 3, total: 5, name: "model", active: s.step === "model" }), /* @__PURE__ */ React12.createElement(Step, { index: 4, total: 5, name: "apikey", active: s.step === "apikey" }), /* @__PURE__ */ React12.createElement(Step, { index: 5, total: 5, name: "confirm", active: s.step === "confirm" })), s.step === "welcome" && /* @__PURE__ */ React12.createElement(React12.Fragment, null, /* @__PURE__ */ React12.createElement(Text12, null, "Welcome! Let's get you coding in under two minutes."), /* @__PURE__ */ React12.createElement(Text12, { color: "gray" }, "We'll pick a provider, default model, and how to handle your API key."), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, "Press "), /* @__PURE__ */ React12.createElement(Text12, { color: "cyan", inverse: true }, " Enter "), /* @__PURE__ */ React12.createElement(Text12, null, " to continue, or "), /* @__PURE__ */ React12.createElement(Text12, { color: "red", inverse: true }, " Q "), /* @__PURE__ */ React12.createElement(Text12, null, " to quit (re-run with "), /* @__PURE__ */ React12.createElement(Text12, { color: "gray" }, "--no-wizard"), /* @__PURE__ */ React12.createElement(Text12, null, " to skip later)."))), s.step === "provider" && /* @__PURE__ */ React12.createElement(React12.Fragment, null, /* @__PURE__ */ React12.createElement(Text12, null, "Choose your LLM provider:"), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1 }, renderProviderList(providers, s.providerCursor)), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1 }, /* @__PURE__ */ React12.createElement(Text12, { color: "gray" }, "\u2191/\u2193 to move, Enter to confirm"))), s.step === "model" && /* @__PURE__ */ React12.createElement(React12.Fragment, null, /* @__PURE__ */ React12.createElement(Text12, null, "Model for ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, s.providerId), ":"), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1, borderStyle: "single", borderColor: "cyan", paddingX: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, s.model ?? "(empty)")), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, "Press ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan", inverse: true }, " Enter "), "to accept, or type a new name. ", /* @__PURE__ */ React12.createElement(Text12, { color: "gray" }, "(default kept on empty input)")))), s.step === "apikey" && /* @__PURE__ */ React12.createElement(React12.Fragment, null, /* @__PURE__ */ React12.createElement(Text12, null, "How should we handle the API key?"), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1 }, renderApiKeyOptions(s.apiKeyCursor)), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1 }, /* @__PURE__ */ React12.createElement(Text12, { color: "gray" }, "\u2191/\u2193 to move, Enter to confirm"))), s.step === "confirm" && /* @__PURE__ */ React12.createElement(React12.Fragment, null, /* @__PURE__ */ React12.createElement(Text12, null, "Confirm your setup:"), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, "Provider: ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, s.providerId)), /* @__PURE__ */ React12.createElement(Text12, null, "Model:    ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, s.model)), /* @__PURE__ */ React12.createElement(Text12, null, "API key:  ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, s.apiKeyChoice ?? "(unset)"))), /* @__PURE__ */ React12.createElement(Box11, { marginTop: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, "Press ", /* @__PURE__ */ React12.createElement(Text12, { color: "green", inverse: true }, " Enter "), "to save and launch, or ", /* @__PURE__ */ React12.createElement(Text12, { color: "yellow", inverse: true }, " B "), "to go back."))));
 }
 
 // src/cli/wizard/runWizard.tsx
 function RunWizard(_props) {
-  const [wiz] = useState10(
+  const [wiz] = useState11(
     () => createWizardState({
       providers: PROVIDERS,
       defaultModelFor: (id) => getModelForProvider(id)
     })
   );
-  const [, force] = useState10(0);
-  useEffect9(() => {
+  const [, force] = useState11(0);
+  useEffect10(() => {
     if (typeof wiz.subscribe === "function") {
       const sub = wiz.subscribe(() => force((n) => n + 1));
       return () => sub();
@@ -35886,20 +36737,20 @@ function RunWizard(_props) {
     }
   });
   if (wiz.state.committed) {
-    return /* @__PURE__ */ React12.createElement(PostCommitBridge, null);
+    return /* @__PURE__ */ React13.createElement(PostCommitBridge, null);
   }
-  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React12.createElement(Wizard, { state: wiz, providers: PROVIDERS }));
+  return /* @__PURE__ */ React13.createElement(Box12, { flexDirection: "column", paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React13.createElement(Wizard, { state: wiz, providers: PROVIDERS }));
 }
 function PostCommitBridge() {
-  const [showApp, setShowApp] = useState10(false);
-  useEffect9(() => {
+  const [showApp, setShowApp] = useState11(false);
+  useEffect10(() => {
     const t = setTimeout(() => setShowApp(true), 1200);
     return () => clearTimeout(t);
   }, []);
   if (showApp) {
-    return /* @__PURE__ */ React12.createElement(App, null);
+    return /* @__PURE__ */ React13.createElement(App, null);
   }
-  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React12.createElement(Box11, { borderStyle: "round", borderColor: "green", paddingX: 2, paddingY: 1, flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, { color: "green", bold: true }, "\u2713 Setup complete! Launching zelari-code\u2026"), /* @__PURE__ */ React12.createElement(Text12, { color: "gray" }, "Press Ctrl+C any time to exit.")));
+  return /* @__PURE__ */ React13.createElement(Box12, { flexDirection: "column", paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React13.createElement(Box12, { borderStyle: "round", borderColor: "green", paddingX: 2, paddingY: 1, flexDirection: "column" }, /* @__PURE__ */ React13.createElement(Text13, { color: "green", bold: true }, "\u2713 Setup complete! Launching zelari-code\u2026"), /* @__PURE__ */ React13.createElement(Text13, { color: "gray" }, "Press Ctrl+C any time to exit.")));
 }
 
 // src/cli/headless.ts
@@ -36112,7 +36963,7 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
 
 // src/cli/skillsMd.ts
 init_skills2();
-import { existsSync as existsSync28, readdirSync as readdirSync4, readFileSync as readFileSync24 } from "node:fs";
+import { existsSync as existsSync30, readdirSync as readdirSync4, readFileSync as readFileSync25 } from "node:fs";
 import { join as join23 } from "node:path";
 import { homedir as homedir6 } from "node:os";
 var CODING_CATEGORIES = /* @__PURE__ */ new Set([
@@ -36190,7 +37041,7 @@ function loadSkillMdSkills(projectRoot = process.cwd(), options = {}) {
   const summary = { loaded: [], skipped: [] };
   const seen = new Set(options.existingIds ?? []);
   for (const dir of skillMdSearchDirs(projectRoot)) {
-    if (!existsSync28(dir)) continue;
+    if (!existsSync30(dir)) continue;
     let entries;
     try {
       entries = readdirSync4(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
@@ -36199,9 +37050,9 @@ function loadSkillMdSkills(projectRoot = process.cwd(), options = {}) {
     }
     for (const entry of entries) {
       const skillPath = join23(dir, entry, "SKILL.md");
-      if (!existsSync28(skillPath)) continue;
+      if (!existsSync30(skillPath)) continue;
       try {
-        const parsed = parseSkillMd(readFileSync24(skillPath, "utf8"), skillPath);
+        const parsed = parseSkillMd(readFileSync25(skillPath, "utf8"), skillPath);
         if (!parsed) {
           summary.skipped.push({ path: skillPath, reason: "missing/invalid frontmatter (name, description) or empty body" });
           continue;
@@ -36225,6 +37076,38 @@ function loadSkillMdSkills(projectRoot = process.cwd(), options = {}) {
 init_skills2();
 init_updater();
 var VERSION = getCurrentVersion();
+function runPreflight() {
+  if (process.env.ZELARI_SKIP_PREFLIGHT === "1") return;
+  if (process.argv.includes("--skip-checks")) return;
+  if (process.env.ANATHEMA_DEV === "1") return;
+  const { runPrereqChecks: runPrereqChecks2 } = (
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    (init_prereqChecks(), __toCommonJS(prereqChecks_exports))
+  );
+  const { results, hasCriticalFail, warnings } = runPrereqChecks2({
+    mode: "preflight"
+  });
+  for (const w of warnings) {
+    console.error(`\x1B[33m[zelari-code] \u26A0 ${w.tool}: ${w.message}\x1B[0m`);
+  }
+  if (hasCriticalFail) {
+    const critical = results.find(
+      (r) => !r.ok && r.severity === "critical"
+    );
+    console.error("");
+    console.error(
+      "\x1B[31m==============================================================\n zelari-code cannot start: a critical prerequisite is missing.\n==============================================================\x1B[0m"
+    );
+    if (critical) {
+      console.error(`
+  ${critical.tool}: ${critical.message}`);
+    }
+    console.error(
+      "\n  Run `zelari-code --doctor` for the full diagnostic report.\n  Bypass this check with ZELARI_SKIP_PREFLIGHT=1 (NOT recommended \u2014\n  the agent will still fail when it tries to run npm/build/tsc)."
+    );
+    process.exit(1);
+  }
+}
 async function backgroundUpdateCheck() {
   if (process.env.ANATHEMA_DEV === "1") return;
   await new Promise((resolve) => setTimeout(resolve, 3e3));
@@ -36259,12 +37142,34 @@ function pickRootComponent() {
   }
   if (argv.includes("--doctor") || argv.includes("doctor")) {
     const { runDoctor: runDoctor2 } = (init_doctor(), __toCommonJS(doctor_exports));
-    const healthy = runDoctor2();
-    process.exit(healthy ? 0 : 1);
+    void runDoctor2().then((healthy) => process.exit(healthy ? 0 : 1));
+    return { kind: "done" };
+  }
+  if (argv.includes("--fix-path") || argv.includes("fix-path")) {
+    const { repairWindowsUserPath: repairWindowsUserPath2 } = (init_fixPath(), __toCommonJS(fixPath_exports));
+    const result = repairWindowsUserPath2();
+    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} npm prefix already on user PATH: ${result.prefix}`);
+      } else {
+        console.log(`${green}\u2714${reset} added npm prefix to user PATH: ${result.prefix}`);
+        console.log(`${dim}open a NEW terminal for the change to take effect, then run: zelari-code --version${reset}`);
+      }
+      process.exit(0);
+    }
+    console.error(`${red}\u2717${reset} ${result.error}`);
+    if (result.prefix) {
+      console.error(`${dim}prefix: ${result.prefix}${reset}`);
+    }
+    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  --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    --council          Use the 6-member council pipeline\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1  Skip the first-run wizard\n  ANATHEMA_DEV=1      Disable background update check\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  --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    --council          Use the 6-member council pipeline\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\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);
   }
@@ -36285,14 +37190,17 @@ function pickRootComponent() {
   });
   if (decision.shouldRun) {
     console.error(`[zelari-code] starting wizard: ${decision.reason}`);
-    return { kind: "wizard", element: React13.createElement(RunWizard) };
+    return { kind: "wizard", element: React14.createElement(RunWizard) };
   }
   return {
     kind: "app",
-    element: React13.createElement(
+    element: React14.createElement(
       SplashGate,
       { version: VERSION },
-      React13.createElement(App)
+      React14.createElement(PluginGate, {
+        cwd: process.cwd(),
+        children: React14.createElement(App)
+      })
     )
   };
 }
@@ -36314,6 +37222,7 @@ function loadUserSkills() {
 function main() {
   const picked = pickRootComponent();
   if (picked.kind === "done") return;
+  runPreflight();
   loadUserSkills();
   if (picked.kind === "headless") {
     void runHeadless(picked.headlessOpts).then((code) => {