zelari-code 1.0.1 → 1.0.3

package/dist/cli/main.bundled.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 import { createRequire as __crq } from 'node:module'; const require = __crq(import.meta.url);
 var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -9,6 +11,15 @@ var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/cli/grokOAuth.ts
 var grokOAuth_exports = {};
@@ -1522,10 +1533,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path24) {
-  if (!path24)
+function getElementAtPath(obj, path25) {
+  if (!path25)
     return obj;
-  return path24.reduce((acc, key) => acc?.[key], obj);
+  return path25.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -1853,11 +1864,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path24, issues) {
+function prefixIssues(path25, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path24);
+    iss.path.unshift(path25);
     return iss;
   });
 }
@@ -2075,16 +2086,16 @@ function flattenError(error51, mapper = (issue2) => issue2.message) {
 }
 function formatError(error51, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error52, path24 = []) => {
+  const processError = (error52, path25 = []) => {
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path24, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path25, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path24, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path25, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path24, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path25, ...issue2.path]);
       } else {
-        const fullpath = [...path24, ...issue2.path];
+        const fullpath = [...path25, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -2111,17 +2122,17 @@ function formatError(error51, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error51, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error52, path24 = []) => {
+  const processError = (error52, path25 = []) => {
     var _a3, _b;
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path24, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path25, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path24, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path25, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path24, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path25, ...issue2.path]);
       } else {
-        const fullpath = [...path24, ...issue2.path];
+        const fullpath = [...path25, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -2153,8 +2164,8 @@ function treeifyError(error51, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path24 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path24) {
+  const path25 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path25) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -15657,13 +15668,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path24 = ref.slice(1).split("/").filter(Boolean);
-  if (path24.length === 0) {
+  const path25 = ref.slice(1).split("/").filter(Boolean);
+  if (path25.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path24[0] === defsKey) {
-    const key = path24[1];
+  if (path25[0] === defsKey) {
+    const key = path25[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -17693,11 +17704,11 @@ var init_tools = __esm({
           if (!ctx.addDocument)
             return "Knowledge vault tool not available.";
           const title = args["title"] || "New Document";
-          const path24 = args["path"] || `notes/${title.toLowerCase().replace(/[^a-z0-9]+/g, "-")}`;
+          const path25 = args["path"] || `notes/${title.toLowerCase().replace(/[^a-z0-9]+/g, "-")}`;
           const content = args["content"] || "";
           const tags = args["tags"] || [];
           ctx.addDocument({
-            path: path24,
+            path: path25,
             title,
             content,
             format: "markdown",
@@ -17706,7 +17717,7 @@ var init_tools = __esm({
             workspaceId: ctx.workspaceId
           });
           ctx.addActivity("vault", "created document", title);
-          return `Document "${title}" created at "${path24}".`;
+          return `Document "${title}" created at "${path25}".`;
         }
       }
     ];
@@ -20212,11 +20223,11 @@ var init_synthesisAudit = __esm({
 import { existsSync as existsSync8, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "node:fs";
 import { join as join2 } from "node:path";
 function loadNfrSpec(zelariRoot) {
-  const path24 = join2(zelariRoot, "nfr-spec.json");
-  if (!existsSync8(path24))
+  const path25 = join2(zelariRoot, "nfr-spec.json");
+  if (!existsSync8(path25))
     return null;
   try {
-    const raw = JSON.parse(readFileSync6(path24, "utf8"));
+    const raw = JSON.parse(readFileSync6(path25, "utf8"));
     if (raw.version !== 1 || !Array.isArray(raw.targets))
       return null;
     return raw;
@@ -22405,9 +22416,9 @@ var init_types2 = __esm({
 import { readFileSync as readFileSync11 } from "node:fs";
 import { join as join8 } from "node:path";
 function readLessonsDeduped(zelariRoot) {
-  const path24 = join8(zelariRoot, LESSONS_FILE);
+  const path25 = join8(zelariRoot, LESSONS_FILE);
   try {
-    const raw = readFileSync11(path24, "utf8");
+    const raw = readFileSync11(path25, "utf8");
     const byId = /* @__PURE__ */ new Map();
     for (const line of raw.split(/\r?\n/)) {
       if (!line.trim())
@@ -22508,8 +22519,8 @@ function keywordsFrom(check2, signature) {
   return [.../* @__PURE__ */ new Set([...fromId, ...words])].slice(0, 12);
 }
 function writeLesson(zelariRoot, lesson) {
-  const path24 = join9(zelariRoot, LESSONS_FILE);
-  appendFileSync2(path24, `${JSON.stringify(lesson)}
+  const path25 = join9(zelariRoot, LESSONS_FILE);
+  appendFileSync2(path25, `${JSON.stringify(lesson)}
 `, "utf8");
 }
 function findSimilar(lessons, signature) {
@@ -23649,28 +23660,28 @@ var init_storage = __esm({
     VALID_SCALARS = /^(true|false|null|~)$/i;
     Storage = class {
       /** Read a Markdown file with frontmatter. Throws if not found. */
-      read(path24) {
-        if (!existsSync13(path24)) {
-          throw new Error(`File not found: ${path24}`);
+      read(path25) {
+        if (!existsSync13(path25)) {
+          throw new Error(`File not found: ${path25}`);
         }
-        const md = readFileSync13(path24, "utf8");
+        const md = readFileSync13(path25, "utf8");
         return parseFrontmatter(md);
       }
       /** Read a Markdown file; returns null if not found. */
-      readIfExists(path24) {
-        if (!existsSync13(path24)) return null;
-        return this.read(path24);
+      readIfExists(path25) {
+        if (!existsSync13(path25)) return null;
+        return this.read(path25);
       }
       /**
        * Write a Markdown file atomically (tmp + rename). Creates parent dirs.
        * The meta object is serialized as YAML frontmatter; body as Markdown.
        */
-      write(path24, meta3, body) {
-        mkdirSync7(dirname(path24), { recursive: true });
-        const tmp = path24 + ".tmp-" + process.pid;
+      write(path25, meta3, body) {
+        mkdirSync7(dirname(path25), { recursive: true });
+        const tmp = path25 + ".tmp-" + process.pid;
         const md = serializeFrontmatter(meta3, body);
         writeFileSync11(tmp, md, "utf8");
-        renameSync2(tmp, path24);
+        renameSync2(tmp, path25);
       }
       /** List all .md files in a directory (non-recursive). */
       listMarkdown(dir) {
@@ -23748,8 +23759,8 @@ function readPlan(ctx) {
     } catch {
     }
   }
-  const path24 = workspaceFile(ctx.rootDir, "plan");
-  const doc = ctx.storage.readIfExists(path24);
+  const path25 = workspaceFile(ctx.rootDir, "plan");
+  const doc = ctx.storage.readIfExists(path25);
   if (!doc) return { phases: [], tasks: [], milestones: [] };
   const meta3 = doc.meta;
   return {
@@ -23914,7 +23925,7 @@ function addMilestoneRecord(ctx, summary, input) {
     dueDate: input.dueDate,
     targetVersion: version2
   });
-  const path24 = join14(ctx.rootDir, "milestones", `${id}.md`);
+  const path25 = join14(ctx.rootDir, "milestones", `${id}.md`);
   const meta3 = {
     kind: "milestone",
     id,
@@ -23931,7 +23942,7 @@ function addMilestoneRecord(ctx, summary, input) {
     `Target version: ${version2}`,
     ""
   ].join("\n");
-  ctx.storage.write(path24, meta3, body);
+  ctx.storage.write(path25, meta3, body);
   return { id, created: true };
 }
 function readPlanSummary(ctx) {
@@ -24135,7 +24146,7 @@ function addIdeaStub(ctx) {
         const tags = args["tags"] ?? [];
         const category = args["category"] ?? "General";
         const id = `${nextAdrId(ctx)}-${slugify3(title)}`;
-        const path24 = workspaceArtifact(ctx.rootDir, "decisions", id);
+        const path25 = workspaceArtifact(ctx.rootDir, "decisions", id);
         const meta3 = {
           kind: "adr",
           status: "proposed",
@@ -24161,7 +24172,7 @@ function addIdeaStub(ctx) {
           ...consequences.map((c) => `- ${c}`),
           ""
         ].join("\n");
-        ctx.storage.write(path24, meta3, body);
+        ctx.storage.write(path25, meta3, body);
         return `ADR ${id} created: "${title}". Status: proposed. Promote to accepted via /update ADR or manual edit.`;
       });
     }
@@ -24243,14 +24254,14 @@ function createDocumentStub(ctx) {
           ctx.storage.write(risksPath, riskMeta, content);
           return `Document "${title}" created at risks.md (workspace root).`;
         }
-        const path24 = workspaceArtifact(ctx.rootDir, "docs", slug);
+        const path25 = workspaceArtifact(ctx.rootDir, "docs", slug);
         const meta3 = {
           kind: "doc",
           id: slug,
           date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
           tags
         };
-        ctx.storage.write(path24, meta3, content);
+        ctx.storage.write(path25, meta3, content);
         return `Document "${title}" created at docs/${slug}.md.`;
       });
     }
@@ -24469,13 +24480,133 @@ var init_cmdline = __esm({
   }
 });
 
-// src/cli/mcp/mcpClient.ts
+// src/cli/updater.ts
+var updater_exports = {};
+__export(updater_exports, {
+  REGISTRY_URL: () => REGISTRY_URL,
+  checkForUpdate: () => checkForUpdate,
+  compareSemver: () => compareSemver,
+  fetchLatestVersion: () => fetchLatestVersion,
+  getCurrentVersion: () => getCurrentVersion,
+  performUpdate: () => performUpdate
+});
+import { createRequire } from "node:module";
 import { spawn as spawn2 } from "node:child_process";
+import path15 from "node:path";
+import { fileURLToPath } from "node:url";
+function getCurrentVersion() {
+  try {
+    const pkgPath = path15.resolve(__dirname2, "..", "..", "package.json");
+    const pkg = require2(pkgPath);
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+function compareSemver(a, b) {
+  const parse3 = (v) => {
+    const m = v.match(/^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/);
+    if (!m) return [0, 0, 0, null];
+    return [Number(m[1]), Number(m[2]), Number(m[3]), m[4] ?? null];
+  };
+  const [a1, a2, a3, aPre] = parse3(a);
+  const [b1, b2, b3, bPre] = parse3(b);
+  if (a1 !== b1) return a1 < b1 ? -1 : 1;
+  if (a2 !== b2) return a2 < b2 ? -1 : 1;
+  if (a3 !== b3) return a3 < b3 ? -1 : 1;
+  if (aPre === bPre) return 0;
+  if (aPre === null) return 1;
+  if (bPre === null) return -1;
+  return aPre < bPre ? -1 : 1;
+}
+async function fetchLatestVersion(fetcher = fetch, registryUrl = REGISTRY_URL, timeoutMs = 5e3) {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const response = await fetcher(registryUrl, { signal: controller.signal });
+    clearTimeout(timer);
+    if (!response.ok) {
+      return { error: `Registry responded ${response.status}` };
+    }
+    const data = await response.json();
+    if (!data.version || typeof data.version !== "string") {
+      return { error: "Registry response missing version field" };
+    }
+    return { version: data.version };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { error: message };
+  }
+}
+async function checkForUpdate(fetcher = fetch, registryUrl) {
+  const currentVersion = getCurrentVersion();
+  const latest = await fetchLatestVersion(fetcher, registryUrl);
+  if ("error" in latest) {
+    return {
+      currentVersion,
+      latestVersion: currentVersion,
+      updateAvailable: false,
+      error: latest.error
+    };
+  }
+  const cmp = compareSemver(currentVersion, latest.version);
+  return {
+    currentVersion,
+    latestVersion: latest.version,
+    updateAvailable: cmp < 0
+  };
+}
+async function performUpdate(packageName = "zelari-code", executor = spawn2) {
+  return new Promise((resolve) => {
+    const args = ["install", "-g", `${packageName}@latest`];
+    let stdout = "";
+    let stderr = "";
+    const stdio = ["ignore", "pipe", "pipe"];
+    const child = process.platform === "win32" ? executor(buildCmdLine("npm", args), { stdio, shell: true }) : executor("npm", args, { stdio });
+    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,
+        error: ok ? void 0 : `npm exited with code ${code}`,
+        exitCode: code
+      });
+    });
+  });
+}
+var require2, __dirname2, REGISTRY_URL;
+var init_updater = __esm({
+  "src/cli/updater.ts"() {
+    "use strict";
+    init_cmdline();
+    require2 = createRequire(import.meta.url);
+    __dirname2 = path15.dirname(fileURLToPath(import.meta.url));
+    REGISTRY_URL = "https://registry.npmjs.org/zelari-code/latest";
+  }
+});
+
+// src/cli/mcp/mcpClient.ts
+import { spawn as spawn3 } from "node:child_process";
 var DEFAULT_REQUEST_TIMEOUT_MS, INIT_TIMEOUT_MS, MCP_PROTOCOL_VERSION, McpClient;
 var init_mcpClient = __esm({
   "src/cli/mcp/mcpClient.ts"() {
     "use strict";
     init_cmdline();
+    init_updater();
     DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
     INIT_TIMEOUT_MS = 15e3;
     MCP_PROTOCOL_VERSION = "2025-03-26";
@@ -24497,17 +24628,26 @@ var init_mcpClient = __esm({
           env: { ...process.env, ...this.config.env ?? {} },
           windowsHide: true
         };
-        const child = process.platform === "win32" ? spawn2(buildCmdLine(this.config.command, this.config.args ?? []), {
+        const child = process.platform === "win32" ? spawn3(buildCmdLine(this.config.command, this.config.args ?? []), {
           ...spawnOpts,
           shell: true
-        }) : spawn2(this.config.command, this.config.args ?? [], spawnOpts);
+        }) : spawn3(this.config.command, this.config.args ?? [], spawnOpts);
         this.child = child;
         child.stdout.setEncoding("utf8");
         child.stdout.on("data", (chunk) => this.onStdout(chunk));
-        child.on("error", (err) => this.failAll(new Error(`[mcp:${this.serverName}] spawn failed: ${err.message}`)));
+        child.on(
+          "error",
+          (err) => this.failAll(
+            new Error(`[mcp:${this.serverName}] spawn failed: ${err.message}`)
+          )
+        );
         child.on("exit", (code) => {
           if (!this.closed) {
-            this.failAll(new Error(`[mcp:${this.serverName}] server exited (code ${code ?? "null"})`));
+            this.failAll(
+              new Error(
+                `[mcp:${this.serverName}] server exited (code ${code ?? "null"})`
+              )
+            );
           }
         });
         await this.request(
@@ -24515,7 +24655,7 @@ var init_mcpClient = __esm({
           {
             protocolVersion: MCP_PROTOCOL_VERSION,
             capabilities: {},
-            clientInfo: { name: "zelari-code", version: "0.7.9" }
+            clientInfo: { name: "zelari-code", version: getCurrentVersion() }
           },
           INIT_TIMEOUT_MS
         );
@@ -24524,7 +24664,9 @@ var init_mcpClient = __esm({
       /** Discover the server's tools. */
       async listTools() {
         const res = await this.request("tools/list", {});
-        return (res.tools ?? []).filter((t) => !!t.name).map((t) => ({
+        return (res.tools ?? []).filter(
+          (t) => !!t.name
+        ).map((t) => ({
           name: t.name,
           description: t.description ?? "",
           inputSchema: t.inputSchema ?? { type: "object", properties: {} }
@@ -24535,9 +24677,16 @@ var init_mcpClient = __esm({
        * items are summarized by type. Throws when the server flags isError.
        */
       async callTool(name, args, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
-        const res = await this.request("tools/call", { name, arguments: args }, timeoutMs);
-        const text = (res.content ?? []).map((c) => c.type === "text" && typeof c.text === "string" ? c.text : `[${c.type ?? "unknown"} content]`).join("\n");
-        if (res.isError) throw new Error(text || `tool "${name}" reported an error`);
+        const res = await this.request(
+          "tools/call",
+          { name, arguments: args },
+          timeoutMs
+        );
+        const text = (res.content ?? []).map(
+          (c) => c.type === "text" && typeof c.text === "string" ? c.text : `[${c.type ?? "unknown"} content]`
+        ).join("\n");
+        if (res.isError)
+          throw new Error(text || `tool "${name}" reported an error`);
         return text;
       }
       /** Terminate the server process and reject all in-flight requests. */
@@ -24550,13 +24699,18 @@ var init_mcpClient = __esm({
       // ── JSON-RPC plumbing ────────────────────────────────────────────────
       request(method, params, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
         const child = this.child;
-        if (!child) return Promise.reject(new Error(`[mcp:${this.serverName}] not started`));
+        if (!child)
+          return Promise.reject(new Error(`[mcp:${this.serverName}] not started`));
         const id = this.nextId++;
         const payload = JSON.stringify({ jsonrpc: "2.0", id, method, params });
         return new Promise((resolve, reject) => {
           const timer = setTimeout(() => {
             this.pending.delete(id);
-            reject(new Error(`[mcp:${this.serverName}] ${method} timed out after ${timeoutMs}ms`));
+            reject(
+              new Error(
+                `[mcp:${this.serverName}] ${method} timed out after ${timeoutMs}ms`
+              )
+            );
           }, timeoutMs);
           this.pending.set(id, { resolve, reject, timer });
           child.stdin.write(payload + "\n", (err) => {
@@ -24569,7 +24723,9 @@ var init_mcpClient = __esm({
         });
       }
       notify(method, params) {
-        this.child?.stdin.write(JSON.stringify({ jsonrpc: "2.0", method, params }) + "\n");
+        this.child?.stdin.write(
+          JSON.stringify({ jsonrpc: "2.0", method, params }) + "\n"
+        );
       }
       onStdout(chunk) {
         this.stdoutBuffer += chunk;
@@ -24590,7 +24746,11 @@ var init_mcpClient = __esm({
           this.pending.delete(msg.id);
           clearTimeout(pending.timer);
           if (msg.error) {
-            pending.reject(new Error(`[mcp:${this.serverName}] ${msg.error.message ?? "JSON-RPC error"} (code ${msg.error.code ?? "?"})`));
+            pending.reject(
+              new Error(
+                `[mcp:${this.serverName}] ${msg.error.message ?? "JSON-RPC error"} (code ${msg.error.code ?? "?"})`
+              )
+            );
           } else {
             pending.resolve(msg.result);
           }
@@ -24868,10 +25028,10 @@ import { createHash as createHash2 } from "node:crypto";
 import { join as join17 } from "node:path";
 import { readFile } from "node:fs/promises";
 async function readPackageJson2(projectRoot) {
-  const path24 = join17(projectRoot, "package.json");
-  if (!existsSync17(path24)) return null;
+  const path25 = join17(projectRoot, "package.json");
+  if (!existsSync17(path25)) return null;
   try {
-    return JSON.parse(await readFile(path24, "utf8"));
+    return JSON.parse(await readFile(path25, "utf8"));
   } catch {
     return null;
   }
@@ -24953,9 +25113,9 @@ async function genBuild(ctx) {
   ].join("\n");
 }
 async function genOpenQuestions(ctx) {
-  const path24 = join17(ctx.rootDir, "risks.md");
-  if (!existsSync17(path24)) return "_No open questions._";
-  const content = readFileSync17(path24, "utf8");
+  const path25 = join17(ctx.rootDir, "risks.md");
+  if (!existsSync17(path25)) return "_No open questions._";
+  const content = readFileSync17(path25, "utf8");
   const lines = content.split("\n");
   const questions = [];
   let currentTitle = "";
@@ -25200,7 +25360,7 @@ var init_completeDesign = __esm({
 });
 
 // src/cli/workspace/projectSmoke.ts
-import { spawn as spawn3 } from "node:child_process";
+import { spawn as spawn4 } from "node:child_process";
 import { existsSync as existsSync18, readFileSync as readFileSync18 } from "node:fs";
 import { join as join18 } from "node:path";
 function pickSmokeScript(scripts) {
@@ -25231,7 +25391,7 @@ async function runProjectSmoke(projectRoot, timeoutMs = DEFAULT_TIMEOUT_MS) {
   }
   return await new Promise((resolveRun) => {
     const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm";
-    const child = spawn3(npmCmd, ["run", script], {
+    const child = spawn4(npmCmd, ["run", script], {
       cwd: projectRoot,
       stdio: ["ignore", "pipe", "pipe"],
       env: process.env,
@@ -25303,7 +25463,7 @@ __export(postCouncilHook_exports, {
   runImplementationVerificationHook: () => runImplementationVerificationHook,
   runPostCouncilHook: () => runPostCouncilHook
 });
-import { spawn as spawn4 } from "node:child_process";
+import { spawn as spawn5 } from "node:child_process";
 import { existsSync as existsSync19, readFileSync as readFileSync19 } from "node:fs";
 import { join as join19 } from "node:path";
 async function runCompleteDesignPostProcessor(ctx, options) {
@@ -25352,7 +25512,7 @@ async function runCompleteDesignPostProcessor(ctx, options) {
     }
   }
   return await new Promise((resolveRun) => {
-    const child = spawn4(process.execPath, [scriptPath], {
+    const child = spawn5(process.execPath, [scriptPath], {
       cwd: ctx.projectRoot,
       stdio: ["ignore", "pipe", "pipe"],
       env: process.env
@@ -25518,8 +25678,8 @@ async function runPostCouncilHook(ctx, options) {
           sources: scope.sources
         } : void 0
       });
-      const path24 = writeCouncilCompletion(ctx.rootDir, completion);
-      completionHook = { ran: true, path: path24, completion };
+      const path25 = writeCouncilCompletion(ctx.rootDir, completion);
+      completionHook = { ran: true, path: path25, completion };
     } catch (err) {
       completionHook = {
         ran: true,
@@ -25588,7 +25748,7 @@ import {
   writeFileSync as writeFileSync14,
   mkdirSync as mkdirSync9
 } from "node:fs";
-import path15 from "node:path";
+import path16 from "node:path";
 import os7 from "node:os";
 var FeedbackStore;
 var init_councilFeedback = __esm({
@@ -25599,7 +25759,7 @@ var init_councilFeedback = __esm({
       now;
       entries = [];
       constructor(options = {}) {
-        this.file = options.file ?? (process.env.ANATHEMA_COUNCIL_FEEDBACK_FILE ?? path15.join(os7.homedir(), ".tmp", "zelari-code", "council-feedback.json"));
+        this.file = options.file ?? (process.env.ANATHEMA_COUNCIL_FEEDBACK_FILE ?? path16.join(os7.homedir(), ".tmp", "zelari-code", "council-feedback.json"));
         this.now = options.now ?? Date.now;
         this.load();
       }
@@ -25705,7 +25865,7 @@ var init_councilFeedback = __esm({
         }
       }
       save() {
-        mkdirSync9(path15.dirname(this.file), { recursive: true });
+        mkdirSync9(path16.dirname(this.file), { recursive: true });
         writeFileSync14(
           this.file,
           JSON.stringify({ entries: this.entries }, null, 2),
@@ -25740,7 +25900,7 @@ __export(fileBackend_exports, {
 });
 import { randomUUID as randomUUID2 } from "node:crypto";
 import { promises as fs13 } from "node:fs";
-import * as path16 from "node:path";
+import * as path17 from "node:path";
 function tokenize(text) {
   return text.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((t) => t.length >= 3);
 }
@@ -25778,8 +25938,8 @@ var init_fileBackend = __esm({
       logPath = "";
       memoryDir = "";
       async init(projectRoot) {
-        this.memoryDir = path16.join(projectRoot, ".zelari", "memory");
-        this.logPath = path16.join(this.memoryDir, "log.jsonl");
+        this.memoryDir = path17.join(projectRoot, ".zelari", "memory");
+        this.logPath = path17.join(this.memoryDir, "log.jsonl");
         await fs13.mkdir(this.memoryDir, { recursive: true });
       }
       async add(content, metadata = {}, graph) {
@@ -25860,7 +26020,7 @@ __export(zelariMission_exports, {
 });
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { promises as fs14 } from "node:fs";
-import * as path17 from "node:path";
+import * as path18 from "node:path";
 function resolveMaxIterations(env = process.env) {
   const raw = env.ZELARI_MISSION_MAX_ITER;
   const n = raw ? Number.parseInt(raw, 10) : DEFAULT_MAX_ITER;
@@ -25876,10 +26036,10 @@ function isMissionAutoStart(env = process.env) {
   return env.ZELARI_MISSION_AUTO === "1";
 }
 async function writeMissionState(projectRoot, state2) {
-  const dir = path17.join(projectRoot, ".zelari");
+  const dir = path18.join(projectRoot, ".zelari");
   await fs14.mkdir(dir, { recursive: true });
   await fs14.writeFile(
-    path17.join(dir, "mission-state.json"),
+    path18.join(dir, "mission-state.json"),
     JSON.stringify(state2, null, 2) + "\n",
     "utf8"
   );
@@ -26007,122 +26167,249 @@ var init_zelariMission = __esm({
   }
 });
 
-// src/cli/updater.ts
-var updater_exports = {};
-__export(updater_exports, {
-  REGISTRY_URL: () => REGISTRY_URL,
-  checkForUpdate: () => checkForUpdate,
-  compareSemver: () => compareSemver,
-  fetchLatestVersion: () => fetchLatestVersion,
-  getCurrentVersion: () => getCurrentVersion,
-  performUpdate: () => performUpdate
+// src/cli/utils/doctor.ts
+var doctor_exports = {};
+__export(doctor_exports, {
+  runDoctor: () => runDoctor
 });
-import { createRequire } from "node:module";
-import { spawn as spawn5 } from "node:child_process";
-import path19 from "node:path";
-import { fileURLToPath } from "node:url";
-function getCurrentVersion() {
+import { execSync } from "node:child_process";
+import { existsSync as existsSync26, readFileSync as readFileSync23, readlinkSync, statSync as statSync6 } from "node:fs";
+import { createRequire as createRequire2 } from "node:module";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+import path24 from "node:path";
+function findPackageRoot(start) {
+  let dir = start;
+  for (let i = 0; i < 6; i += 1) {
+    const candidate = path24.join(dir, "package.json");
+    if (existsSync26(candidate)) {
+      try {
+        const pkg = JSON.parse(readFileSync23(candidate, "utf8"));
+        if (pkg.name === "zelari-code") return dir;
+      } catch {
+      }
+    }
+    const parent = path24.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return path24.resolve(__dirname3, "..", "..", "..");
+}
+function tryExec(cmd) {
   try {
-    const pkgPath = path19.resolve(__dirname2, "..", "..", "package.json");
-    const pkg = require2(pkgPath);
-    return pkg.version;
+    return execSync(cmd, {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
   } catch {
-    return "0.0.0";
+    return "";
   }
 }
-function compareSemver(a, b) {
-  const parse3 = (v) => {
-    const m = v.match(/^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/);
-    if (!m) return [0, 0, 0, null];
-    return [Number(m[1]), Number(m[2]), Number(m[3]), m[4] ?? null];
-  };
-  const [a1, a2, a3, aPre] = parse3(a);
-  const [b1, b2, b3, bPre] = parse3(b);
-  if (a1 !== b1) return a1 < b1 ? -1 : 1;
-  if (a2 !== b2) return a2 < b2 ? -1 : 1;
-  if (a3 !== b3) return a3 < b3 ? -1 : 1;
-  if (aPre === bPre) return 0;
-  if (aPre === null) return 1;
-  if (bPre === null) return -1;
-  return aPre < bPre ? -1 : 1;
+function readPackageJson3() {
+  try {
+    const pkgPath = path24.join(packageRoot, "package.json");
+    return JSON.parse(readFileSync23(pkgPath, "utf8"));
+  } catch {
+    return null;
+  }
 }
-async function fetchLatestVersion(fetcher = fetch, registryUrl = REGISTRY_URL, timeoutMs = 5e3) {
+function getGlobalPrefix() {
+  return (process.env.npm_config_prefix || process.env.NPM_CONFIG_PREFIX || "").trim() || tryExec("npm prefix -g");
+}
+function checkShim(pkgName) {
+  const prefix = getGlobalPrefix();
+  if (!prefix) {
+    return WARN("npm global prefix not detectable (run inside an npm context)");
+  }
+  const isWin = process.platform === "win32";
+  const shimName = isWin ? "zelari-code.cmd" : "zelari-code";
+  const shimPath = path24.join(prefix, shimName);
+  if (!existsSync26(shimPath)) {
+    return FAIL(
+      `shim not found at ${shimPath}
+         fix:  npm install -g ${pkgName}@latest --force`
+    );
+  }
   try {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    const response = await fetcher(registryUrl, { signal: controller.signal });
-    clearTimeout(timer);
-    if (!response.ok) {
-      return { error: `Registry responded ${response.status}` };
+    const st = statSync6(shimPath);
+    if (isWin) {
+      const content = readFileSync23(shimPath, "utf8");
+      if (content.includes(`${pkgName}\\bin\\`) || content.includes(`${pkgName}/bin/`)) {
+        return OK(`shim OK at ${shimPath} (${st.size} bytes)`);
+      }
+      return FAIL(
+        `shim at ${shimPath} does not reference ${pkgName}/bin/
+         fix:  npm install -g ${pkgName}@latest --force`
+      );
     }
-    const data = await response.json();
-    if (!data.version || typeof data.version !== "string") {
-      return { error: "Registry response missing version field" };
+    let target;
+    try {
+      target = readlinkSync(shimPath);
+    } catch {
+      return FAIL(
+        `shim at ${shimPath} is not a symlink (POSIX global installs should be symlinks)
+         fix:  npm install -g ${pkgName}@latest --force`
+      );
     }
-    return { version: data.version };
+    const resolved = path24.resolve(path24.dirname(shimPath), target);
+    const expected = path24.join(
+      prefix,
+      "node_modules",
+      pkgName,
+      "bin",
+      "zelari-code.js"
+    );
+    if (resolved === expected) {
+      return OK(`shim OK at ${shimPath} \u2192 ${resolved}`);
+    }
+    return FAIL(
+      `shim at ${shimPath} points to ${resolved}
+         expected ${expected}
+         fix:  npm install -g ${pkgName}@latest --force`
+    );
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return { error: message };
+    return FAIL(
+      `could not inspect shim: ${err instanceof Error ? err.message : String(err)}`
+    );
   }
 }
-async function checkForUpdate(fetcher = fetch, registryUrl) {
-  const currentVersion = getCurrentVersion();
-  const latest = await fetchLatestVersion(fetcher, registryUrl);
-  if ("error" in latest) {
-    return {
-      currentVersion,
-      latestVersion: currentVersion,
-      updateAvailable: false,
-      error: latest.error
-    };
+function checkNode(pkg) {
+  const raw = tryExec("node --version");
+  if (!raw) {
+    return FAIL("`node` not found on PATH");
   }
-  const cmp = compareSemver(currentVersion, latest.version);
-  return {
-    currentVersion,
-    latestVersion: latest.version,
-    updateAvailable: cmp < 0
-  };
+  const m = raw.match(/^v?(\d+)\.(\d+)\.(\d+)/);
+  if (!m) {
+    return WARN(`could not parse node version: ${raw}`);
+  }
+  const major = Number(m[1]);
+  if (major < 20) {
+    return FAIL(
+      `node ${raw} is older than the required engines.node (>= 20.0.0)`
+    );
+  }
+  return OK(`node ${raw}`);
 }
-async function performUpdate(packageName = "zelari-code", executor = spawn5) {
-  return new Promise((resolve) => {
-    const args = ["install", "-g", `${packageName}@latest`];
-    let stdout = "";
-    let stderr = "";
-    const stdio = ["ignore", "pipe", "pipe"];
-    const child = process.platform === "win32" ? executor(buildCmdLine("npm", args), { stdio, shell: true }) : executor("npm", args, { stdio });
-    child.stdout?.on("data", (chunk) => {
-      stdout += chunk.toString();
-    });
-    child.stderr?.on("data", (chunk) => {
-      stderr += chunk.toString();
+function checkBundle() {
+  const bundle = path24.join(packageRoot, "dist", "cli", "main.bundled.js");
+  if (!existsSync26(bundle)) {
+    return FAIL(
+      `dist/cli/main.bundled.js missing at ${bundle}
+         fix:  npm run build:cli   (then reinstall or run via tsx)`
+    );
+  }
+  try {
+    const st = statSync6(bundle);
+    return OK(`bundle OK (${(st.size / 1024 / 1024).toFixed(2)} MB)`);
+  } catch (err) {
+    return FAIL(
+      `could not stat bundle: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+function checkRuntimeDeps() {
+  const required2 = ["react", "react-dom", "ink", "ink-text-input", "zod"];
+  const missing = [];
+  for (const dep of required2) {
+    try {
+      const localReq = createRequire2(path24.join(packageRoot, "package.json"));
+      localReq.resolve(dep);
+    } catch {
+      missing.push(dep);
+    }
+  }
+  if (missing.length === 0) {
+    return OK(
+      "runtime deps resolvable (react, react-dom, ink, ink-text-input, zod)"
+    );
+  }
+  return FAIL(
+    `missing runtime deps: ${missing.join(", ")}
+         fix:  npm install -g ${"<pkg>"} --force    (then reopen the terminal)`
+  );
+}
+function checkPath() {
+  const prefix = getGlobalPrefix();
+  if (!prefix) return WARN("npm global prefix not detectable");
+  const pathSep = process.platform === "win32" ? ";" : ":";
+  const pathDirs = (process.env.PATH || "").split(pathSep);
+  if (pathDirs.includes(prefix)) {
+    return OK(`PATH includes npm prefix (${prefix})`);
+  }
+  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"`
+  );
+}
+function runDoctor() {
+  const pkg = readPackageJson3();
+  const pkgName = pkg?.name ?? "zelari-code";
+  const checks = [
+    { 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() }
+  ];
+  console.log(`zelari-code doctor (v${pkg?.version ?? "unknown"})`);
+  console.log("platform:", process.platform, process.arch);
+  console.log("node:    ", process.version);
+  console.log("prefix:  ", getGlobalPrefix() || "(unknown)");
+  console.log("root:    ", packageRoot);
+  console.log("");
+  let criticalFails = 0;
+  let warns = 0;
+  for (const c of checks) {
+    let result;
+    try {
+      result = c.run();
+    } catch (err) {
+      result = FAIL(
+        `unexpected error: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+    const tag = result.ok ? "OK  " : result.severity === "critical" ? "FAIL" : "WARN";
+    const color = result.ok ? "\x1B[32m" : result.severity === "critical" ? "\x1B[31m" : "\x1B[33m";
+    const reset = "\x1B[0m";
+    console.log(
+      `  ${color}${tag}${reset}  ${c.name.padEnd(14)}${result.message.replace(/\n/g, "\n              ")}`
+    );
+    if (!result.ok) {
+      if (result.severity === "critical") criticalFails += 1;
+      else warns += 1;
+    }
+  }
+  console.log("");
+  if (criticalFails === 0 && warns === 0) {
+    console.log("\x1B[32m\u2714 all checks passed\x1B[0m");
+    return true;
+  }
+  console.log(`\u2717 ${criticalFails} critical failure(s), ${warns} warning(s)`);
+  return criticalFails === 0;
+}
+var require3, __dirname3, packageRoot, OK, FAIL, WARN;
+var init_doctor = __esm({
+  "src/cli/utils/doctor.ts"() {
+    "use strict";
+    require3 = createRequire2(import.meta.url);
+    __dirname3 = path24.dirname(fileURLToPath2(import.meta.url));
+    packageRoot = findPackageRoot(__dirname3);
+    OK = (message) => ({
+      ok: true,
+      message,
+      severity: "critical"
     });
-    child.on("error", (err) => {
-      resolve({
-        ok: false,
-        output: stdout + stderr,
-        error: err.message,
-        exitCode: null
-      });
+    FAIL = (message, severity = "critical") => ({
+      ok: false,
+      message,
+      severity
     });
-    child.on("close", (code) => {
-      const ok = code === 0;
-      resolve({
-        ok,
-        output: stdout + stderr,
-        error: ok ? void 0 : `npm exited with code ${code}`,
-        exitCode: code
-      });
+    WARN = (message) => ({
+      ok: false,
+      message,
+      severity: "warn"
     });
-  });
-}
-var require2, __dirname2, REGISTRY_URL;
-var init_updater = __esm({
-  "src/cli/updater.ts"() {
-    "use strict";
-    init_cmdline();
-    require2 = createRequire(import.meta.url);
-    __dirname2 = path19.dirname(fileURLToPath(import.meta.url));
-    REGISTRY_URL = "https://registry.npmjs.org/zelari-code/latest";
   }
 });
 
@@ -31448,7 +31735,7 @@ ${formatSkillList(availableSkills)}`
 // src/cli/gitOps.ts
 import { execFile as execFile2 } from "node:child_process";
 import { promisify } from "node:util";
-import path18 from "node:path";
+import path19 from "node:path";
 var execFileAsync = promisify(execFile2);
 async function git(cwd, args) {
   try {
@@ -31494,7 +31781,7 @@ async function undoWorkingChanges(opts = {}) {
   };
 }
 function defaultProjectRoot() {
-  return path18.resolve(__dirname, "..", "..", "..");
+  return path19.resolve(__dirname, "..", "..", "..");
 }
 
 // src/cli/slashHandlers/git.ts
@@ -31599,14 +31886,23 @@ async function handleUpdateCheck(ctx) {
        Run \`/update --yes\` to install. You'll need to restart manually after.`
       );
     } else {
-      appendSystem(ctx.setMessages, `[update] up to date (${info.currentVersion})`);
+      appendSystem(
+        ctx.setMessages,
+        `[update] up to date (${info.currentVersion})`
+      );
     }
   } catch (err) {
-    appendSystem(ctx.setMessages, `[update error] ${err instanceof Error ? err.message : String(err)}`);
+    appendSystem(
+      ctx.setMessages,
+      `[update error] ${err instanceof Error ? err.message : String(err)}`
+    );
   }
 }
 async function handleUpdatePerform(ctx) {
-  appendSystem(ctx.setMessages, "[update] running `npm install -g zelari-code@latest`...");
+  appendSystem(
+    ctx.setMessages,
+    "[update] running `npm install -g zelari-code@latest`..."
+  );
   try {
     const { performUpdate: performUpdate2 } = await Promise.resolve().then(() => (init_updater(), updater_exports));
     const res = await performUpdate2();
@@ -31619,18 +31915,48 @@ Please restart zelari-code manually to use the new version.
 (exit with /exit or Ctrl+C, then run \`zelari-code\` again)`
       );
     } else {
+      const output = res.output?.trim() || "(empty)";
+      const hint = buildUpdateFailureHint(
+        res.error ?? "",
+        output,
+        res.exitCode
+      );
       appendSystem(
         ctx.setMessages,
         `[update] \u274C failed: ${res.error ?? "unknown error"}
+exit code: ${res.exitCode ?? "n/a"}
 
 npm output:
-${res.output || "(empty)"}`
+${output}
+
+` + hint
       );
     }
   } catch (err) {
-    appendSystem(ctx.setMessages, `[update error] ${err instanceof Error ? err.message : String(err)}`);
+    appendSystem(
+      ctx.setMessages,
+      `[update error] ${err instanceof Error ? err.message : String(err)}`
+    );
   }
 }
+function buildUpdateFailureHint(error51, output, exitCode) {
+  const haystack = `${error51}
+${output}`.toLowerCase();
+  const isWin = process.platform === "win32";
+  if (haystack.includes("eresolve") || haystack.includes("epeerinvalid") || haystack.includes("peer dep")) {
+    return "\u{1F4A1} hint: peer-dependency conflict. Try:\n         npm install -g zelari-code@latest --legacy-peer-deps\n   or:  npm install -g zelari-code@latest --force";
+  }
+  if (haystack.includes("eacces") || haystack.includes("eperm")) {
+    return "\u{1F4A1} hint: permission denied. On macOS/Linux, avoid sudo with npm:\n         https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally\n   On Windows, re-run the terminal as Administrator.";
+  }
+  if (haystack.includes("enoent") && haystack.includes("npm")) {
+    return '\u{1F4A1} hint: `npm` was not found on PATH for the spawned shell.\n   Re-open the terminal so it picks up your current PATH, or set:\n         export PATH="$(npm prefix -g)/bin:$PATH"   (POSIX)\n         $env:Path = "$(npm prefix -g);$env:Path"   (PowerShell)';
+  }
+  if (haystack.includes("zelari-code") && (haystack.includes("not found") || haystack.includes("eexist") || haystack.includes("ebusy") || haystack.includes("shim") || exitCode === 0)) {
+    return "\u{1F4A1} hint: the install may have completed but the global bin shim\n   is missing or stale (common on Windows + npm 10/11 after major\n   upgrades). To repair:\n         npm install -g zelari-code@latest --force\n   Then re-open the terminal. If `zelari-code` is still not found,\n   run the doctor: `zelari-code doctor`";
+  }
+  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/promoteMember.ts
 import { promises as fs15 } from "node:fs";
@@ -33827,7 +34153,8 @@ function loadSkillMdSkills(projectRoot = process.cwd(), options = {}) {
 
 // src/cli/main.ts
 init_skills2();
-var VERSION = "1.0.0";
+init_updater();
+var VERSION = getCurrentVersion();
 async function backgroundUpdateCheck() {
   if (process.env.ANATHEMA_DEV === "1") return;
   await new Promise((resolve) => setTimeout(resolve, 3e3));
@@ -33860,9 +34187,14 @@ function pickRootComponent() {
     console.log(`zelari-code v${VERSION}`);
     process.exit(0);
   }
+  if (argv.includes("--doctor") || argv.includes("doctor")) {
+    const { runDoctor: runDoctor2 } = (init_doctor(), __toCommonJS(doctor_exports));
+    const healthy = runDoctor2();
+    process.exit(healthy ? 0 : 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  --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  --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"
     );
     process.exit(0);
   }
@@ -33887,7 +34219,11 @@ function pickRootComponent() {
   }
   return {
     kind: "app",
-    element: React13.createElement(SplashGate, { version: VERSION }, React13.createElement(App))
+    element: React13.createElement(
+      SplashGate,
+      { version: VERSION },
+      React13.createElement(App)
+    )
   };
 }
 function loadUserSkills() {
@@ -33895,7 +34231,9 @@ function loadUserSkills() {
     const existing = new Set(listCodingSkills().map((s) => s.id));
     const summary = loadSkillMdSkills(process.cwd(), { existingIds: existing });
     if (summary.loaded.length > 0) {
-      console.error(`[zelari-code] loaded ${summary.loaded.length} SKILL.md skill(s): ${summary.loaded.join(", ")}`);
+      console.error(
+        `[zelari-code] loaded ${summary.loaded.length} SKILL.md skill(s): ${summary.loaded.join(", ")}`
+      );
     }
     for (const s of summary.skipped) {
       console.error(`[zelari-code] skipped SKILL.md at ${s.path}: ${s.reason}`);