zelari-code 1.17.1 → 1.18.1

package/dist/cli/main.bundled.js

@@ -18415,6 +18415,7 @@ Earlier members' outputs are shared context. Build on them; do not re-derive or
 - Pass complete, valid arguments. Required parameters must be present.
 - Prefer tools over asking the user to paste file contents.
 - After durable changes, briefly name what you created or modified.
+- **Act, don't narrate**: if you will edit/fix files, call the tools in this turn. Do not restate the same diagnosis or "I will fix\u2026" plan on a loop without tool calls.
 - Text-only tool blocks (\`---TOOLS---\` JSON) are a legacy fallback \u2014 use them only if the runtime has no native tool channel.`
     };
     CODING_PRACTICES_MODULE = {
@@ -18429,7 +18430,9 @@ Earlier members' outputs are shared context. Build on them; do not re-derive or
 - **Don't invent**: no fake APIs, deps, or config keys \u2014 discover from the tree or package manifests.
 - **Verify**: after non-trivial edits, run the project's tests/typecheck/build when available; fix failures you introduced.
 - **Use project scripts**: prefer package.json / Makefile / existing tooling over ad-hoc commands.
-- **Finish**: list the paths you wrote/edited and how to verify. If you wrote nothing, say so honestly \u2014 do not invent a done report.`
+- **Finish**: list the paths you wrote/edited and how to verify. If you wrote nothing, say so honestly \u2014 do not invent a done report.
+- **No spam**: never repeat the same paragraph or status line. One diagnosis, then tools (or one short final answer).
+- **Browser smoke honesty**: with \`browser_check\`, prefer \`waitForSelector\` / \`waitForText\` / \`evaluate\` on DOM (or explicit test hooks). Do not claim a logic fix is verified from \u201Cno console errors after N seconds\u201D alone (\`smokeStrength: weak\`). ES modules keep symbols off \`window\` \u2014 do not loop on exposing globals; assert visible UI or inject \`evaluate\` on \`document\`.`
     };
     CLARIFICATION_PROTOCOL_MODULE = {
       type: "custom",
@@ -19124,6 +19127,159 @@ var init_events = __esm({
   }
 });
 
+// packages/core/dist/core/textLoopDetect.js
+function normalizeLoopUnit(s) {
+  return s.replace(/<\/?small>/gi, "").replace(/<\/?(?:p|div|span|b|i|em|strong|br)\b[^>]*>/gi, "").replace(/\s+/g, " ").trim();
+}
+function detectChunkSequenceLoop(chunks, kind) {
+  if (chunks.length < MIN_REPEATS)
+    return { looping: false };
+  const maxK = Math.min(12, Math.floor(chunks.length / MIN_REPEATS));
+  for (let k = 1; k <= maxK; k++) {
+    const unitParts = chunks.slice(chunks.length - k);
+    const unitKey = unitParts.join("\n");
+    if (normalizeLoopUnit(unitKey).length < MIN_UNIT)
+      continue;
+    let count = 1;
+    let pos = chunks.length - k;
+    while (pos - k >= 0) {
+      const prev2 = chunks.slice(pos - k, pos);
+      let same = true;
+      for (let i = 0; i < k; i++) {
+        if (prev2[i] !== unitParts[i]) {
+          same = false;
+          break;
+        }
+      }
+      if (!same)
+        break;
+      count++;
+      pos -= k;
+    }
+    if (count >= MIN_REPEATS) {
+      return {
+        looping: true,
+        unit: unitKey,
+        count,
+        kind
+      };
+    }
+  }
+  return { looping: false };
+}
+function detectSuffixPeriod(text) {
+  const compact = text.replace(/\s+/g, " ").trim();
+  if (compact.length < MIN_UNIT * MIN_REPEATS)
+    return { looping: false };
+  const tail = compact.slice(-Math.min(compact.length, MAX_TAIL));
+  const maxP = Math.min(MAX_PERIOD, Math.floor(tail.length / MIN_REPEATS));
+  for (let period = MIN_UNIT; period <= maxP; period++) {
+    const need = period * MIN_REPEATS;
+    if (tail.length < need)
+      continue;
+    const unit = tail.slice(tail.length - period);
+    if (normalizeLoopUnit(unit).length < MIN_UNIT * 0.55)
+      continue;
+    let ok = true;
+    for (let r = 1; r < MIN_REPEATS; r++) {
+      const start = tail.length - period * (r + 1);
+      if (tail.slice(start, start + period) !== unit) {
+        ok = false;
+        break;
+      }
+    }
+    if (!ok)
+      continue;
+    let count = MIN_REPEATS;
+    let end = tail.length - period * MIN_REPEATS;
+    while (end >= period && tail.slice(end - period, end) === unit) {
+      count++;
+      end -= period;
+    }
+    return {
+      looping: true,
+      unit,
+      count,
+      kind: "suffix"
+    };
+  }
+  return { looping: false };
+}
+function detectAssistantTextLoop(text) {
+  if (!text || text.length < MIN_UNIT * MIN_REPEATS) {
+    return { looping: false };
+  }
+  const nl = text.replace(/\r\n/g, "\n");
+  const paragraphs = nl.split(/\n\s*\n+/).map((p3) => normalizeLoopUnit(p3)).filter((p3) => p3.length > 0);
+  const paraHit = detectChunkSequenceLoop(paragraphs, "paragraph");
+  if (paraHit.looping)
+    return paraHit;
+  const lines = nl.split("\n").map((l) => normalizeLoopUnit(l)).filter((l) => l.length > 0);
+  const lineHit = detectChunkSequenceLoop(lines, "line");
+  if (lineHit.looping)
+    return lineHit;
+  return detectSuffixPeriod(nl);
+}
+function collapseLoopedAssistantText(text) {
+  const hit = detectAssistantTextLoop(text);
+  if (!hit.looping)
+    return text;
+  const note = `
+
+[system: stopped repeating the same text \xD7${hit.count}; call tools or finish.]`;
+  if (hit.kind === "paragraph" || hit.kind === "line") {
+    const joinSep = hit.kind === "paragraph" ? "\n\n" : "\n";
+    const unitParts = hit.unit.split("\n").map((p3) => normalizeLoopUnit(p3));
+    const k = unitParts.length;
+    if (k === 0)
+      return text + note;
+    const rawParts = text.replace(/\r\n/g, "\n").split(hit.kind === "paragraph" ? /\n\s*\n+/ : /\n/).filter((p3) => normalizeLoopUnit(p3).length > 0);
+    if (rawParts.length < k * MIN_REPEATS) {
+      return collapseByCharBudget(text, hit.unit, hit.count) + note;
+    }
+    let trailBlocks = 0;
+    let pos = rawParts.length;
+    while (pos >= k) {
+      let same = true;
+      for (let i = 0; i < k; i++) {
+        if (normalizeLoopUnit(rawParts[pos - k + i]) !== unitParts[i]) {
+          same = false;
+          break;
+        }
+      }
+      if (!same)
+        break;
+      trailBlocks++;
+      pos -= k;
+    }
+    if (trailBlocks < MIN_REPEATS) {
+      return collapseByCharBudget(text, hit.unit, hit.count) + note;
+    }
+    const keepBlocks = 2;
+    const keepParts = rawParts.slice(0, rawParts.length - k * (trailBlocks - keepBlocks));
+    return keepParts.join(joinSep).trimEnd() + note;
+  }
+  return collapseByCharBudget(text, hit.unit, hit.count) + note;
+}
+function collapseByCharBudget(text, unit, count) {
+  const unitLen = Math.max(unit.length, MIN_UNIT);
+  if (count < MIN_REPEATS)
+    return text;
+  const drop = unitLen * (count - 2);
+  const cut = Math.max(0, text.length - drop);
+  return text.slice(0, cut).trimEnd();
+}
+var MIN_UNIT, MIN_REPEATS, MAX_TAIL, MAX_PERIOD;
+var init_textLoopDetect = __esm({
+  "packages/core/dist/core/textLoopDetect.js"() {
+    "use strict";
+    MIN_UNIT = 48;
+    MIN_REPEATS = 3;
+    MAX_TAIL = 6e3;
+    MAX_PERIOD = 600;
+  }
+});
+
 // packages/core/dist/core/AgentHarness.js
 function hashToolCall(toolName, args) {
   const canonical = stableStringify(args);
@@ -19362,6 +19518,8 @@ var init_AgentHarness = __esm({
   "packages/core/dist/core/AgentHarness.js"() {
     "use strict";
     init_events();
+    init_textLoopDetect();
+    init_textLoopDetect();
     AgentHarness = class {
       config;
       eventBus;
@@ -19811,6 +19969,7 @@ ${shared2.content}`,
           const turnToolCalls = [];
           const turnToolResults = [];
           const pendingNativeTools = [];
+          let lastLoopCheckLen = 0;
           for await (const delta of stream) {
             if (this.cancelled) {
               const cancelEvent = createBrainEvent("error", this.sessionId, {
@@ -19827,6 +19986,29 @@ ${shared2.content}`,
               const deltaEvent = createBrainEvent("message_delta", this.sessionId, { messageId, delta: delta.delta, ...this.memberFields() });
               this.emit(deltaEvent);
               yield deltaEvent;
+              if (turnText.length >= 48 * 3 && turnText.length - lastLoopCheckLen >= 48) {
+                lastLoopCheckLen = turnText.length;
+                const loopHit = detectAssistantTextLoop(turnText);
+                if (loopHit.looping) {
+                  const loopErr = createBrainEvent("error", this.sessionId, {
+                    severity: "recoverable",
+                    message: `Assistant text loop detected (same block \xD7${loopHit.count}). Stopped generation \u2014 model was repeating instead of calling tools or finishing. Retry or ask it to apply changes with tools.`,
+                    code: "assistant_text_loop"
+                  });
+                  this.emit(loopErr);
+                  yield loopErr;
+                  finishRef.value = "stop";
+                  const sealed = collapseLoopedAssistantText(turnText);
+                  if (sealed.length > 0 || turnReasoning.length > 0) {
+                    this.config.messages.push({
+                      role: "assistant",
+                      content: sealed,
+                      ...turnReasoning.length > 0 ? { reasoningContent: turnReasoning } : {}
+                    });
+                  }
+                  break;
+                }
+              }
             } else if (delta.kind === "thinking") {
               turnReasoning += delta.delta;
               const thinkEvent = createBrainEvent("thinking_delta", this.sessionId, {
@@ -20247,7 +20429,10 @@ var harness_exports = {};
 __export(harness_exports, {
   AgentHarness: () => AgentHarness,
   SessionJsonlWriter: () => SessionJsonlWriter,
+  collapseLoopedAssistantText: () => collapseLoopedAssistantText,
+  detectAssistantTextLoop: () => detectAssistantTextLoop,
   hashToolCall: () => hashToolCall,
+  normalizeLoopUnit: () => normalizeLoopUnit,
   normalizeTextToolArgs: () => normalizeTextToolArgs,
   parseMinimaxStyleToolCalls: () => parseMinimaxStyleToolCalls,
   parseTextToolCalls: () => parseTextToolCalls,
@@ -22439,21 +22624,53 @@ async function loadPlaywright(cwd) {
     return null;
   }
 }
+function serializeEvaluateValue(value) {
+  try {
+    const json2 = JSON.stringify(value, (_k, v) => {
+      if (typeof v === "function") return "[Function]";
+      if (typeof v === "bigint") return v.toString();
+      if (v instanceof Error) return { name: v.name, message: v.message };
+      return v;
+    });
+    if (json2 === void 0) return null;
+    if (json2.length > MAX_EVAL_RESULT) {
+      return {
+        truncated: true,
+        preview: json2.slice(0, MAX_EVAL_RESULT)
+      };
+    }
+    return JSON.parse(json2);
+  } catch (err) {
+    return {
+      error: `non-serializable: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+}
+function wrapEvaluateExpression(expression) {
+  const expr = expression.trim();
+  if (!expr) return "return undefined";
+  if (/\breturn\b/.test(expr) || expr.includes("\n")) {
+    return expr;
+  }
+  return `return (${expr})`;
+}
 async function runBrowserCheck(options, loader) {
   const consoleErrors = [];
   const pageErrors = [];
   const failedRequests = [];
+  const evaluateResults = [];
   const base = { ok: false, consoleErrors, pageErrors, failedRequests };
   const resolve = loader ?? (() => loadPlaywright(options.cwd ?? process.cwd()));
   const pw = await resolve();
   if (!pw) {
     return {
       ...base,
-      error: "browser automation unavailable \u2014 install Playwright (`npm i -D playwright && npx playwright install chromium`) to enable browser_check"
+      error: "browser automation unavailable \u2014 Playwright is not installed in this workspace. Install it with: `zelari-code --plugins-install playwright --cwd .` (or Desktop banner \u201CInstall\u201D, or CLI `/plugins install playwright`, or `npm i -D playwright && npx playwright install chromium`). Then re-run browser_check."
     };
   }
   const timeout = options.timeoutMs ?? 15e3;
   let browser;
+  let textFound;
   try {
     browser = await pw.chromium.launch({ headless: true });
     const page = await browser.newPage();
@@ -22480,6 +22697,63 @@ async function runBrowserCheck(options, loader) {
         case "wait":
           await page.waitForTimeout(action.ms);
           break;
+        case "press": {
+          const key = action.key.trim();
+          if (!key) break;
+          if (page.keyboard && typeof page.keyboard.press === "function") {
+            await page.keyboard.press(key, { timeout });
+          } else {
+            await page.evaluate(
+              wrapEvaluateExpression(
+                `document.dispatchEvent(new KeyboardEvent('keydown',{key:${JSON.stringify(key)},bubbles:true})); true`
+              )
+            );
+          }
+          break;
+        }
+        case "waitForText": {
+          const needle = action.text;
+          const t = action.timeoutMs ?? timeout;
+          try {
+            await page.waitForFunction(
+              `return (document.body && (document.body.innerText || document.body.textContent || '')).includes(arguments[0])`,
+              needle,
+              { timeout: t }
+            );
+            textFound = textFound === false ? false : true;
+          } catch {
+            textFound = false;
+          }
+          break;
+        }
+        case "evaluate": {
+          const raw = action.expression ?? "";
+          if (raw.length > MAX_EVAL_EXPR) {
+            evaluateResults.push({
+              expression: raw.slice(0, 120) + "\u2026",
+              error: `expression too long (max ${MAX_EVAL_EXPR} chars)`
+            });
+            break;
+          }
+          if (!raw.trim()) {
+            evaluateResults.push({ expression: raw, error: "empty expression" });
+            break;
+          }
+          try {
+            const wrapped = wrapEvaluateExpression(raw);
+            const value = await page.evaluate(wrapped);
+            evaluateResults.push({
+              expression: raw.length > 200 ? raw.slice(0, 200) + "\u2026" : raw,
+              value: serializeEvaluateValue(value)
+            });
+          } catch (err) {
+            evaluateResults.push({
+              expression: raw.length > 200 ? raw.slice(0, 200) + "\u2026" : raw,
+              error: err instanceof Error ? err.message : String(err)
+            });
+          }
+          break;
+        }
         default:
           break;
       }
@@ -22493,6 +22767,20 @@ async function runBrowserCheck(options, loader) {
         selectorFound = false;
       }
     }
+    let bodyTextSnippet;
+    if (options.textSample) {
+      try {
+        const text = await page.evaluate(
+          wrapEvaluateExpression(
+            `(document.body?.innerText || document.body?.textContent || '').trim()`
+          )
+        );
+        if (typeof text === "string" && text.length > 0) {
+          bodyTextSnippet = text.length > MAX_BODY_SNIPPET ? text.slice(0, MAX_BODY_SNIPPET) + "\u2026" : text;
+        }
+      } catch {
+      }
+    }
     let screenshotPath;
     if (options.screenshotPath) {
       try {
@@ -22510,6 +22798,9 @@ async function runBrowserCheck(options, loader) {
       url: page.url(),
       ...title !== void 0 ? { title } : {},
       ...selectorFound !== void 0 ? { selectorFound } : {},
+      ...evaluateResults.length > 0 ? { evaluateResults } : {},
+      ...textFound !== void 0 ? { textFound } : {},
+      ...bodyTextSnippet !== void 0 ? { bodyTextSnippet } : {},
       ...screenshotPath ? { screenshotPath } : {}
     };
   } catch (err) {
@@ -22521,9 +22812,13 @@ async function runBrowserCheck(options, loader) {
     }
   }
 }
+var MAX_EVAL_EXPR, MAX_EVAL_RESULT, MAX_BODY_SNIPPET;
 var init_driver = __esm({
   "src/cli/browser/driver.ts"() {
     "use strict";
+    MAX_EVAL_EXPR = 4e3;
+    MAX_EVAL_RESULT = 8e3;
+    MAX_BODY_SNIPPET = 2e3;
   }
 });
 
@@ -22533,15 +22828,16 @@ import os7 from "node:os";
 function createBrowserTool(deps = {}) {
   return {
     name: "browser_check",
-    description: 'Open a URL in a headless browser to VERIFY a web change: optionally run click/fill/goto/wait actions, then report console errors, uncaught page exceptions, failed network requests, the final title/URL, whether an expected selector appeared, and a screenshot path. Use it to confirm UI edits actually render and run \u2014 stronger than "tests pass" for front-end. Requires Playwright (optional dependency).',
+    description: "Open a URL in a headless browser to VERIFY a web change: optionally run click/fill/goto/wait/press/waitForText/evaluate actions, then report console errors, uncaught page exceptions, failed network requests, final title/URL, selector/text presence, evaluate results, and a screenshot path. Prefer DOM assertions (waitForSelector, waitForText, evaluate on document.querySelector) over window.* globals \u2014 ES modules and const keep symbols off window. Absence of console errors after a short wait is WEAK smoke only; assert UI state when claiming a fix is verified. Requires Playwright (optional dependency).",
     permissions: ["network"],
     // A browser launch + navigation can take a while.
     timeoutMs: 6e4,
     inputSchema: external_exports.object({
       url: external_exports.string().min(1).describe("URL to open (e.g. http://localhost:3000)."),
-      actions: external_exports.array(ActionSchema).optional().describe("Optional sequence of interactions before checking."),
+      actions: external_exports.array(ActionSchema).optional().describe("Optional sequence of interactions / probes before checking."),
       waitForSelector: external_exports.string().optional().describe("Assert this CSS selector is present after actions."),
-      screenshot: external_exports.boolean().optional().describe("Save a screenshot (default true).")
+      screenshot: external_exports.boolean().optional().describe("Save a screenshot (default true)."),
+      textSample: external_exports.boolean().optional().describe("Include a short body.innerText snippet (HUD / Game Over text).")
     }),
     execute: async (args, ctx) => {
       const a = args;
@@ -22553,14 +22849,17 @@ function createBrowserTool(deps = {}) {
           cwd: ctx.cwd,
           ...a.actions ? { actions: a.actions } : {},
           ...a.waitForSelector ? { waitForSelector: a.waitForSelector } : {},
-          ...screenshotPath ? { screenshotPath } : {}
+          ...screenshotPath ? { screenshotPath } : {},
+          ...a.textSample ? { textSample: true } : {}
         },
         deps.loader
       );
       if (!result.ok) {
         return typedOk({ ok: false, note: result.error ?? "browser check failed" });
       }
-      const clean = result.consoleErrors.length === 0 && result.pageErrors.length === 0 && result.failedRequests.length === 0 && result.selectorFound !== false;
+      const clean = result.consoleErrors.length === 0 && result.pageErrors.length === 0 && result.failedRequests.length === 0 && result.selectorFound !== false && result.textFound !== false;
+      const hadDomAssertion = result.selectorFound !== void 0 || result.textFound !== void 0 || result.evaluateResults !== void 0 && result.evaluateResults.length > 0 || !!result.bodyTextSnippet;
+      const onlyWeakSmoke = clean && !hadDomAssertion;
       return typedOk({
         ok: true,
         clean,
@@ -22570,7 +22869,14 @@ function createBrowserTool(deps = {}) {
         pageErrors: result.pageErrors,
         failedRequests: result.failedRequests,
         ...result.selectorFound !== void 0 ? { selectorFound: result.selectorFound } : {},
-        ...result.screenshotPath ? { screenshotPath: result.screenshotPath } : {}
+        ...result.evaluateResults ? { evaluateResults: result.evaluateResults } : {},
+        ...result.textFound !== void 0 ? { textFound: result.textFound } : {},
+        ...result.bodyTextSnippet ? { bodyTextSnippet: result.bodyTextSnippet } : {},
+        ...result.screenshotPath ? { screenshotPath: result.screenshotPath } : {},
+        ...onlyWeakSmoke ? {
+          note: "Weak smoke only: no selector/text/evaluate assertions. No console/page errors is necessary but not sufficient to claim a logic fix. Add waitForSelector, waitForText, or evaluate (DOM/read hooks) for stronger evidence.",
+          smokeStrength: "weak"
+        } : { smokeStrength: "asserted" }
       });
     }
   };
@@ -22586,7 +22892,22 @@ var init_tools5 = __esm({
       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() }),
       external_exports.object({ type: external_exports.literal("wait"), ms: external_exports.number().int().positive().max(3e4) }),
-      external_exports.object({ type: external_exports.literal("goto"), url: external_exports.string().min(1) })
+      external_exports.object({ type: external_exports.literal("goto"), url: external_exports.string().min(1) }),
+      external_exports.object({
+        type: external_exports.literal("evaluate"),
+        expression: external_exports.string().min(1).max(4e3).describe(
+          "JS expression or statements run in the page (page.evaluate). Prefer DOM reads (document.querySelector\u2026), not assuming window.game exists. Return JSON-safe values."
+        )
+      }),
+      external_exports.object({
+        type: external_exports.literal("press"),
+        key: external_exports.string().min(1).describe('Playwright key name, e.g. "Space", "KeyW", "ArrowLeft", "Enter".')
+      }),
+      external_exports.object({
+        type: external_exports.literal("waitForText"),
+        text: external_exports.string().min(1).describe("Substring that must appear in document body text."),
+        timeoutMs: external_exports.number().int().positive().max(6e4).optional()
+      })
     ]);
   }
 });
@@ -39277,18 +39598,65 @@ import { spawn as spawn10 } from "node:child_process";
 async function installPlugin(spec, cwd, executor = spawn10) {
   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}).
+  let result = await runNpm2(executor, args, cwd, "shim");
+  if (!result.ok) {
+    const npmCli = resolveBundledNpmCli();
+    if (npmCli && looksLikeBrokenShim(result.exitCode, result.output)) {
+      const fallback = await runNpm2(executor, args, cwd, "bundled", npmCli);
+      result = {
+        ...fallback,
+        output: `[plugins] npm shim failed (${result.error ?? "exit " + result.exitCode}); retried via bundled npm (${npmCli}).
 ${fallback.output}`
+      };
+    }
+  }
+  if (!result.ok) return result;
+  if (spec.id === "playwright") {
+    const browsers = await runPlaywrightInstallChromium(cwd, executor);
+    result = {
+      ...result,
+      ok: browsers.ok ? true : result.ok,
+      // Prefer package success even if browser download fails — surface both.
+      output: (result.output ? result.output + "\n" : "") + (browsers.output ? `[playwright browsers]
+${browsers.output}` : "") + (browsers.ok ? "" : `
+[playwright] Chromium install failed: ${browsers.error ?? "unknown"}. Run: npx playwright install chromium`),
+      error: browsers.ok ? result.error : result.error ?? `playwright package installed but Chromium download failed: ${browsers.error ?? "unknown"}`
     };
+    result = { ...result, ok: true };
   }
-  return primary;
+  return result;
+}
+function runPlaywrightInstallChromium(cwd, executor) {
+  return new Promise((resolve) => {
+    let stdout = "";
+    let stderr = "";
+    const stdio = ["ignore", "pipe", "pipe"];
+    const args = ["playwright", "install", "chromium"];
+    const child = process.platform === "win32" ? executor(buildCmdLine("npx", args), { stdio, shell: true, cwd }) : executor("npx", 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 : `npx playwright install chromium exited ${code}`
+      });
+    });
+  });
 }
 function runNpm2(executor, args, cwd, mode, npmCliPath) {
   return new Promise((resolve) => {
@@ -42750,6 +43118,98 @@ async function runDiscoverModels(providerArg) {
   }
 }
 
+// src/cli/plugins/cliFlags.ts
+init_registry2();
+function getArg(argv, flag) {
+  const i = argv.indexOf(flag);
+  if (i < 0) return void 0;
+  return argv[i + 1];
+}
+function resolveCwd(argv) {
+  return getArg(argv, "--cwd") ?? process.cwd();
+}
+function wantsPluginsStatus(argv) {
+  return argv.includes("--plugins-status");
+}
+function wantsPluginsInstall(argv) {
+  return argv.includes("--plugins-install");
+}
+async function runPluginsStatus(argv) {
+  const cwd = resolveCwd(argv);
+  const plugins = [];
+  for (const spec of PLUGINS) {
+    let present = false;
+    try {
+      present = await spec.detect(cwd);
+    } catch {
+      present = false;
+    }
+    plugins.push({
+      id: spec.id,
+      label: spec.label,
+      present,
+      description: spec.description,
+      postInstallHint: spec.postInstallHint ?? null,
+      npmPackage: spec.npmPackage,
+      installScope: spec.installScope
+    });
+  }
+  process.stdout.write(JSON.stringify({ cwd, plugins }, null, 2) + "\n");
+  return 0;
+}
+async function runPluginsInstall(argv) {
+  const cwd = resolveCwd(argv);
+  const id = getArg(argv, "--plugins-install");
+  if (!id) {
+    process.stderr.write(
+      "[plugins] usage: zelari-code --plugins-install <id> [--cwd <path>]\n"
+    );
+    process.stdout.write(
+      JSON.stringify({
+        ok: false,
+        id: "",
+        message: "missing plugin id"
+      }) + "\n"
+    );
+    return 1;
+  }
+  const spec = findPlugin(id);
+  if (!spec) {
+    const msg = `unknown plugin id: ${id}. Available: ${PLUGINS.map((p3) => p3.id).join(", ")}`;
+    process.stderr.write(`[plugins] ${msg}
+`);
+    process.stdout.write(
+      JSON.stringify({ ok: false, id, message: msg }) + "\n"
+    );
+    return 1;
+  }
+  process.stderr.write(
+    `[plugins] installing ${spec.label} into ${cwd}\u2026
+`
+  );
+  const result = await installPlugin(spec, cwd);
+  const payload = {
+    ok: result.ok,
+    id: spec.id,
+    message: result.ok ? `Installed ${spec.label}` : result.error ?? `Install failed for ${spec.label}`,
+    output: result.output?.slice(-4e3),
+    postInstallHint: spec.postInstallHint ?? null
+  };
+  process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
+  if (!result.ok) {
+    process.stderr.write(`[plugins] \u2717 ${payload.message}
+`);
+    return 1;
+  }
+  process.stderr.write(`[plugins] \u2713 ${payload.message}
+`);
+  if (spec.postInstallHint) {
+    process.stderr.write(`[plugins] \u2192 ${spec.postInstallHint}
+`);
+  }
+  return 0;
+}
+
 // src/cli/skillsMd.ts
 init_skills2();
 import { existsSync as existsSync36, readdirSync as readdirSync5, readFileSync as readFileSync30 } from "node:fs";
@@ -42934,6 +43394,14 @@ function pickRootComponent() {
     console.log(`zelari-code v${VERSION}`);
     process.exit(0);
   }
+  if (wantsPluginsStatus(argv)) {
+    void runPluginsStatus(argv).then((code) => process.exit(code));
+    return { kind: "done" };
+  }
+  if (wantsPluginsInstall(argv)) {
+    void runPluginsInstall(argv).then((code) => process.exit(code));
+    return { kind: "done" };
+  }
   if (argv.includes("--doctor") || argv.includes("doctor")) {
     const { runDoctor: runDoctor2 } = (init_doctor(), __toCommonJS(doctor_exports));
     void runDoctor2().then((healthy) => process.exit(healthy ? 0 : 1));
@@ -42963,7 +43431,7 @@ function pickRootComponent() {
   }
   if (argv.includes("--help") || argv.includes("-h")) {
     console.log(
-      "zelari-code \u2014 AI Council coding agent CLI.\n\nUsage: zelari-code [options]\n\nOptions:\n  --version, -v       Print version and exit\n  --help, -h          Print this help and exit\n  --doctor            Diagnose install health (shim, bundle, PATH, deps,\n                      node/git/bash in the agent shell)\n  --fix-path          Add the npm global prefix to the user PATH\n                      (Windows only; fixes 'command not found' after install)\n  --skip-checks       Skip the boot-time prerequisite check\n                      (alias for ZELARI_SKIP_PREFLIGHT=1)\n  --no-wizard         Skip the first-run wizard\n  --reset-config      Re-run the wizard (clears provider.json on commit)\n  --headless          Run a single task without mounting the TUI\n    --task <text>       Task prompt (required in headless mode)\n    --output json|plain Output format (default: json)\n    --mode agent|council|zelari  Dispatch mode (default: agent)\n    --council          Alias for --mode council\n    --phase plan|build  Work phase (default: build)\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n  --print-config      Print provider/model config as JSON (no secrets)\n  --set-config        Persist provider/model/endpoint\n    --provider <id>    Set active provider\n    --model <id>       Set model for that provider\n    --endpoint <url>   Custom OpenAI-compatible base URL\n    --endpoint-clear   Remove custom endpoint override\n  --set-key           Store an API key (never printed back)\n    --provider <id>    Provider id (required)\n    --key <secret>     API key (required)\n  --discover-models   Refresh model list for a provider\n    --provider <id>    Provider (default: active)\n  --print-mcp         Print MCP server config (user + project)\n    --cwd <path>      Project root for .zelari/mcp.json\n  --set-mcp           Add/update an MCP server entry\n    --name <id>       Server name (required)\n    --command <bin>   Executable (required)\n    --args <json>     JSON array of args (optional)\n    --scope user|project  Default: user\n    --enabled true|false  Default: true\n    --cwd <path>      Required when scope=project\n  --set-mcp-preset    Install a named MCP preset (e.g. cua)\n    --preset cua      Cua Driver desktop computer-use (MCP)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-mcp        Remove an MCP server entry\n    --name <id> --scope user|project [--cwd <path>]\n  --print-ssh-targets Print SSH deploy/monitor targets\n  --set-ssh-target    Upsert target (--json '{...}' or flags)\n  --remove-ssh-target --id <id>\n  --test-ssh-target   --id <id>  (BatchMode ssh true)\n  --print-ssh-pubkey  --path <private-or-.pub>  (display public key)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1    Skip the first-run wizard\n  ZELARI_SKIP_PREFLIGHT=1  Skip the boot prerequisite check\n  ZELARI_NO_PLUGIN_PROMPT=1  Skip the boot plugin-install prompt\n  ANATHEMA_DEV=1        Disable background update check + preflight\n"
+      "zelari-code \u2014 AI Council coding agent CLI.\n\nUsage: zelari-code [options]\n\nOptions:\n  --version, -v       Print version and exit\n  --help, -h          Print this help and exit\n  --doctor            Diagnose install health (shim, bundle, PATH, deps,\n                      node/git/bash in the agent shell)\n  --fix-path          Add the npm global prefix to the user PATH\n                      (Windows only; fixes 'command not found' after install)\n  --skip-checks       Skip the boot-time prerequisite check\n                      (alias for ZELARI_SKIP_PREFLIGHT=1)\n  --no-wizard         Skip the first-run wizard\n  --reset-config      Re-run the wizard (clears provider.json on commit)\n  --headless          Run a single task without mounting the TUI\n    --task <text>       Task prompt (required in headless mode)\n    --output json|plain Output format (default: json)\n    --mode agent|council|zelari  Dispatch mode (default: agent)\n    --council          Alias for --mode council\n    --phase plan|build  Work phase (default: build)\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n  --print-config      Print provider/model config as JSON (no secrets)\n  --plugins-status    JSON status of optional plugins (Playwright, eslint, \u2026)\n  --plugins-install <id>  Install plugin (playwright also fetches Chromium)\n    --cwd <path>       Workspace for -D installs (default: process.cwd())\n  --set-config        Persist provider/model/endpoint\n    --provider <id>    Set active provider\n    --model <id>       Set model for that provider\n    --endpoint <url>   Custom OpenAI-compatible base URL\n    --endpoint-clear   Remove custom endpoint override\n  --set-key           Store an API key (never printed back)\n    --provider <id>    Provider id (required)\n    --key <secret>     API key (required)\n  --discover-models   Refresh model list for a provider\n    --provider <id>    Provider (default: active)\n  --print-mcp         Print MCP server config (user + project)\n    --cwd <path>      Project root for .zelari/mcp.json\n  --set-mcp           Add/update an MCP server entry\n    --name <id>       Server name (required)\n    --command <bin>   Executable (required)\n    --args <json>     JSON array of args (optional)\n    --scope user|project  Default: user\n    --enabled true|false  Default: true\n    --cwd <path>      Required when scope=project\n  --set-mcp-preset    Install a named MCP preset (e.g. cua)\n    --preset cua      Cua Driver desktop computer-use (MCP)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-mcp        Remove an MCP server entry\n    --name <id> --scope user|project [--cwd <path>]\n  --print-ssh-targets Print SSH deploy/monitor targets\n  --set-ssh-target    Upsert target (--json '{...}' or flags)\n  --remove-ssh-target --id <id>\n  --test-ssh-target   --id <id>  (BatchMode ssh true)\n  --print-ssh-pubkey  --path <private-or-.pub>  (display public key)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1    Skip the first-run wizard\n  ZELARI_SKIP_PREFLIGHT=1  Skip the boot prerequisite check\n  ZELARI_NO_PLUGIN_PROMPT=1  Skip the boot plugin-install prompt\n  ANATHEMA_DEV=1        Disable background update check + preflight\n"
     );
     process.exit(0);
   }