zelari-code 1.4.1 → 1.5.0

package/dist/cli/main.js

@@ -8,6 +8,7 @@ import { render } from "ink";
 // @ts-ignore
 import { App } from "./app.js";
 import { SplashGate } from "./components/SplashScreen.js";
+import { PluginGate } from "./components/PluginGate.js";
 import { getMetricsLogger } from "./metrics.js";
 import { getProviderConfigPath } from "./providerConfig.js";
 import { parseWizardFlags, shouldRunWizard } from "./wizard/firstRun.js";
@@ -164,10 +165,45 @@ function pickRootComponent() {
         // v1.0.3: install-health diagnostic. Runs BEFORE the bundle is loaded
         // and before any provider / config work, so it works on a broken
         // install (missing bundle, missing shim, wrong PATH, etc.).
+        // v1.5.0: async — the optional-plugins check delegates to
+        // detectMissingPlugins (dynamic import + async detection).
         // eslint-disable-next-line @typescript-eslint/no-require-imports
         const { runDoctor } = require("./utils/doctor.js");
-        const healthy = runDoctor();
-        process.exit(healthy ? 0 : 1);
+        void runDoctor().then((healthy) => process.exit(healthy ? 0 : 1));
+        return { kind: "done" };
+    }
+    if (argv.includes("--fix-path") || argv.includes("fix-path")) {
+        // v1.4.2: runtime PATH repair. Companion to the install-time auto-fix
+        // in scripts/postinstall.mjs. Handles the "PATH lost AFTER install"
+        // case that postinstall can't reach retroactively. Windows-only at the
+        // effect level; POSIX prints an advisory and exits 1.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { repairWindowsUserPath } = require("./utils/fixPath.js");
+        const result = repairWindowsUserPath();
+        const green = "\x1b[32m";
+        const red = "\x1b[31m";
+        const dim = "\x1b[2m";
+        const reset = "\x1b[0m";
+        if (result.ok) {
+            if (result.alreadyOk) {
+                // eslint-disable-next-line no-console
+                console.log(`${green}✔${reset} npm prefix already on user PATH: ${result.prefix}`);
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.log(`${green}✔${reset} added npm prefix to user PATH: ${result.prefix}`);
+                // eslint-disable-next-line no-console
+                console.log(`${dim}open a NEW terminal for the change to take effect, then run: zelari-code --version${reset}`);
+            }
+            process.exit(0);
+        }
+        // eslint-disable-next-line no-console
+        console.error(`${red}✗${reset} ${result.error}`);
+        if (result.prefix) {
+            // eslint-disable-next-line no-console
+            console.error(`${dim}prefix: ${result.prefix}${reset}`);
+        }
+        process.exit(1);
     }
     if (argv.includes("--help") || argv.includes("-h")) {
         // eslint-disable-next-line no-console
@@ -180,6 +216,8 @@ function pickRootComponent() {
             "  --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" +
@@ -194,6 +232,7 @@ function pickRootComponent() {
             "Environment:\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);
     }
@@ -224,9 +263,16 @@ function pickRootComponent() {
     // v0.7.8: one-shot startup splash (ASCII emblem, ~2s or any-key skip),
     // then the App mounts. Skipped automatically for non-TTY stdout, small
     // terminals, or ZELARI_NO_SPLASH=1 — see components/SplashScreen.tsx.
+    // v1.5.0: PluginGate wraps App inside SplashGate — after the splash, it
+    // detects missing optional plugins (Playwright, eslint, ruff, LSP servers)
+    // and offers to install them before the App mounts. Skips on non-TTY,
+    // ZELARI_NO_PLUGIN_PROMPT=1, or when nothing is missing.
     return {
         kind: "app",
-        element: React.createElement(SplashGate, { version: VERSION }, React.createElement(App)),
+        element: React.createElement(SplashGate, { version: VERSION }, React.createElement(PluginGate, {
+            cwd: process.cwd(),
+            children: React.createElement(App),
+        })),
     };
 }
 /**

package/dist/cli/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,aAAa;AACb,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAW,iBAAiB,EAAE,CAAC;AAEnD;;;;;;;;;GASG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG;QAAE,OAAO;IACtD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO;IACnD,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG;QAAE,OAAO,CAAC,yCAAyC;IAEvF,MAAM,EAAE,eAAe,EAAE;IACvB,iEAAiE;IACjE,OAAO,CAAC,yBAAyB,CAA6C,CAAC;IACjF,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;QAC7D,IAAI,EAAE,WAAW;KAClB,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU,CAC1C,CAAC;QACF,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CACX,UAAU;YACR,kEAAkE;YAClE,kEAAkE;YAClE,uEAAuE,CAC1E,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,sCAAsC;QACtC,OAAO,CAAC,KAAK,CACX,kEAAkE;YAChE,uEAAuE;YACvE,kEAAkE,CACrE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB;IAClC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG;QAAE,OAAO;IAC7C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,sCAAsC;YACtC,OAAO,CAAC,KAAK,CACX,qBAAqB,IAAI,CAAC,aAAa,yBAAyB,IAAI,CAAC,cAAc,KAAK;gBACtF,wDAAwD,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;QACxD,oDAAoD;IACtD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,wEAAwE;IACxE,mEAAmE;IACnE,uEAAuE;IACvE,qEAAqE;IACrE,oEAAoE;IACpE,oDAAoD;IACpD,IAAI,CAAC;QACH,MAAM,gBAAgB,EAAE,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;IACD,IAAI,CAAC;QACH,2EAA2E;QAC3E,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAChE,eAAe,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,iBAAiB;IAKxB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,sEAAsE;QACtE,iEAAiE;QACjE,4DAA4D;QAC5D,iEAAiE;QACjE,MAAM,EAAE,SAAS,EAAE,GACjB,OAAO,CAAC,mBAAmB,CAAuC,CAAC;QACrE,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,sCAAsC;QACtC,OAAO,CAAC,GAAG,CACT,8CAA8C;YAC5C,IAAI;YACJ,gCAAgC;YAChC,IAAI;YACJ,YAAY;YACZ,gDAAgD;YAChD,kDAAkD;YAClD,4EAA4E;YAC5E,2DAA2D;YAC3D,+DAA+D;YAC/D,6DAA6D;YAC7D,mDAAmD;YACnD,4EAA4E;YAC5E,oEAAoE;YACpE,mEAAmE;YACnE,yDAAyD;YACzD,4DAA4D;YAC5D,8DAA8D;YAC9D,qEAAqE;YACrE,IAAI;YACJ,gBAAgB;YAChB,qDAAqD;YACrD,+DAA+D;YAC/D,uEAAuE,CAC1E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,oEAAoE;IACpE,+DAA+D;IAC/D,kEAAkE;IAClE,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,aAAa,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACtC,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,4BAA4B,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC/B,UAAU,EAAE,qBAAqB,EAAE;QACnC,kBAAkB,EAAE,KAAK,CAAC,WAAW;QACrC,eAAe,EAAE,KAAK,CAAC,QAAQ;QAC/B,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;KAC1C,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;IACrE,CAAC;IACD,uEAAuE;IACvE,uEAAuE;IACvE,sEAAsE;IACtE,OAAO;QACL,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK,CAAC,aAAa,CAC1B,UAAU,EACV,EAAE,OAAO,EAAE,OAAO,EAAE,EACpB,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CACzB;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5E,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,sCAAsC;YACtC,OAAO,CAAC,KAAK,CACX,wBAAwB,OAAO,CAAC,MAAM,CAAC,MAAM,uBAAuB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChG,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAChC,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,SAAS,IAAI;IACX,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,uCAAuC;IAE3E,6EAA6E;IAC7E,gFAAgF;IAChF,4EAA4E;IAC5E,yEAAyE;IACzE,YAAY,EAAE,CAAC;IAEf,cAAc,EAAE,CAAC;IAEjB,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,KAAK,WAAW,CAAC,MAAM,CAAC,YAAa,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACnD,KAAK,gBAAgB,EAAE;iBACpB,KAAK,EAAE;iBACP,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAQ,CAAC,CAAC;IAE3D,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,EAAE,CAAC;QACV,KAAK,QAAQ,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,OAAO,EAAE,CAAC;QACV,KAAK,QAAQ,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,KAAK,qBAAqB,EAAE,CAAC;IAE7B,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACxB,KAAK,QAAQ,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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"}

package/dist/cli/plugins/installer.js

@@ -0,0 +1,103 @@
+/**
+ * plugins/installer — spawn `npm install` for a plugin, buffered.
+ *
+ * Mirrors updater.ts:performUpdate (the self-update install path) with two
+ * differences:
+ *   1. The install scope is per-plugin: `-D` (project-local) for linters +
+ *      Playwright (that's how diagnostics/engine.ts + browser/driver.ts
+ *      resolve them via node_modules/.bin / dynamic import), `-g` (global)
+ *      for LSP servers (cross-project dev tools).
+ *   2. No `@latest` pinning — plugins don't self-update, so we install
+ *      whatever npm resolves as current.
+ *
+ * Everything else is identical and reuses the updater's hard-won platform
+ * handling: buildCmdLine + shell:true on win32 for the `.cmd` shim, and the
+ * broken-shim fallback to the npm bundled next to Node (rescues
+ * Volta/nvm-windows/fnm where the global npm shim is broken).
+ *
+ * Output is BUFFERED (stdout+stderr concatenated), surfaced as a single
+ * string after exit — same UX as /update. This keeps the install gate simple
+ * (no streaming-log component needed) and matches the house style.
+ *
+ * Contract: never throws. Errors → { ok: false, error }.
+ *
+ * @see src/cli/updater.ts — performUpdate / runNpm, the template this mirrors
+ * @see src/cli/utils/cmdline.ts — buildCmdLine (win32 DEP0190-safe quoting)
+ */
+import { spawn } from 'node:child_process';
+import { buildCmdLine } from '../utils/cmdline.js';
+import { resolveBundledNpmCli, looksLikeBrokenShim, } from '../updater.js';
+/**
+ * Install a plugin via npm. Respects PluginSpec.installScope (-D vs -g).
+ *
+ * @param spec     The plugin to install.
+ * @param cwd      Working directory (matters for -D installs; ignored by -g
+ *                 except as the spawn cwd).
+ * @param executor Injected spawn (tests). Defaults to node:child_process.spawn.
+ */
+export async function installPlugin(spec, cwd, executor = spawn) {
+    const scopeFlag = spec.installScope === 'global' ? '-g' : '-D';
+    const args = ['install', scopeFlag, spec.npmPackage];
+    // Attempt 1: PATH-resolved npm (shell on win32 for the .cmd shim).
+    const primary = await runNpm(executor, args, cwd, 'shim');
+    if (primary.ok)
+        return primary;
+    // Attempt 2: if attempt 1 died like a broken bin shim (Volta/nvm/fnm),
+    // retry via the npm bundled with Node. No shell, no .cmd in the way.
+    const npmCli = resolveBundledNpmCli();
+    if (npmCli && looksLikeBrokenShim(primary.exitCode, primary.output)) {
+        const fallback = await runNpm(executor, args, cwd, 'bundled', npmCli);
+        return {
+            ...fallback,
+            output: `[plugins] npm shim failed (${primary.error ?? 'exit ' + primary.exitCode}); ` +
+                `retried via bundled npm (${npmCli}).\n${fallback.output}`,
+        };
+    }
+    return primary;
+}
+/**
+ * Spawn one npm invocation and collect its buffered result.
+ *
+ * `mode: 'shim'` runs the PATH-resolved `npm` (shell on Windows for `.cmd`).
+ * `mode: 'bundled'` runs `node <npmCliPath> ...` directly, bypassing shims.
+ *
+ * Direct copy of updater.ts:runNpm with cwd threaded through. Keeping the two
+ * in lockstep means platform fixes (DEP0190, broken-shim detection) apply to
+ * both — diverging would let one rot while the other gets fixed.
+ */
+function runNpm(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 ? undefined : `npm exited with code ${code}`,
+            });
+        });
+    });
+}
+//# sourceMappingURL=installer.js.map

package/dist/cli/plugins/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../../src/cli/plugins/installer.ts"],"names":[],"mappings":"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"}

package/dist/cli/plugins/prefs.js

@@ -0,0 +1,96 @@
+/**
+ * plugins/prefs — persistence of plugin-installation preferences.
+ *
+ * Stores the "don't ask me again about plugin X" dismissal so the boot gate
+ * doesn't nag users who've already decided. Modeled on providerConfig.ts:
+ *   - JSON file in ~/.tmp/zelari-code/ alongside provider.json / keys.json
+ *   - existsSync + JSON.parse + validate, graceful fallback to defaults on
+ *     corrupt/missing file (a broken prefs file must never block boot)
+ *   - read-modify-write mutators, mode 0o600 (owner-only) on write
+ *
+ * Shape:
+ *   { version: 1, dontAskAgain: { "<pluginId>": true } }
+ *
+ * `version` is reserved for forward migration — bumping it lets a future
+ * release rewrite the schema without a silent data loss.
+ *
+ * Env override: ZELARI_PLUGINS_PREFS_FILE (tests + CI isolate the file).
+ *
+ * @see src/cli/providerConfig.ts — the canonical read-modify-write template
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const DEFAULTS = {
+    version: 1,
+    dontAskAgain: {},
+};
+/** Path to the prefs file. Env-overridable for tests. */
+export function getPluginPrefsPath() {
+    return process.env.ZELARI_PLUGINS_PREFS_FILE
+        ?? path.join(os.homedir(), '.tmp', 'zelari-code', 'plugins.json');
+}
+/** Read prefs, falling back to defaults on missing/corrupt file. Never throws. */
+export function getPluginPrefs() {
+    const file = getPluginPrefsPath();
+    try {
+        if (!existsSync(file))
+            return { ...DEFAULTS, dontAskAgain: {} };
+        const raw = readFileSync(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed &&
+            typeof parsed === 'object' &&
+            parsed.dontAskAgain &&
+            typeof parsed.dontAskAgain === 'object') {
+            // Sanitize: keep only boolean-true entries with a non-empty id; drop junk.
+            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 {
+        // Corrupt JSON or unreadable — fall through to defaults.
+    }
+    return { ...DEFAULTS, dontAskAgain: {} };
+}
+function writePluginPrefs(prefs) {
+    const file = getPluginPrefsPath();
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, JSON.stringify(prefs, null, 2), {
+        encoding: 'utf-8',
+        mode: 0o600,
+    });
+}
+/**
+ * Mark a plugin as "don't ask again" (user picked 'Don't ask again' in the
+ * boot prompt, or `ZELARI_NO_PLUGIN_PROMPT` style dismissal). Idempotent.
+ */
+export function markDontAskAgain(pluginId) {
+    try {
+        const prefs = getPluginPrefs();
+        prefs.dontAskAgain[pluginId] = true;
+        writePluginPrefs(prefs);
+    }
+    catch {
+        // A failed write (read-only home, full disk) must never block boot.
+    }
+}
+/** Clear the "don't ask again" flag for a plugin (so /plugins can re-offer). */
+export function clearDontAskAgain(pluginId) {
+    try {
+        const prefs = getPluginPrefs();
+        delete prefs.dontAskAgain[pluginId];
+        writePluginPrefs(prefs);
+    }
+    catch {
+        // Same fail-safe contract.
+    }
+}
+/** Has the user muted this plugin at the boot prompt? */
+export function isMuted(pluginId) {
+    return getPluginPrefs().dontAskAgain[pluginId] === true;
+}
+//# sourceMappingURL=prefs.js.map

package/dist/cli/plugins/prefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefs.js","sourceRoot":"","sources":["../../../src/cli/plugins/prefs.ts"],"names":[],"mappings":"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"}

package/dist/cli/plugins/registry.js

@@ -0,0 +1,209 @@
+/**
+ * plugins/registry — catalog of optional tool plugins zelari-code can offer
+ * to install when missing.
+ *
+ * A "plugin" here is an OPTIONAL dependency of an edge feature: Playwright
+ * powers `browser_check`, typescript-language-server / pyright power the LSP
+ * navigation tools, eslint / ruff power the post-edit diagnostics loop. None
+ * are required to boot — every one of these features degrades silently when
+ * its binary is absent (see browser/driver.ts, lsp/manager.ts,
+ * diagnostics/engine.ts). The plugin manager is a DISCOVERY layer on top: it
+ * detects absence and offers to install, without changing how the tools
+ * register or degrade.
+ *
+ * The binary names are NOT redeclared here — they're sourced from the
+ * existing registries the features already use, so a single source of truth
+ * is preserved:
+ *   - DEFAULT_PROVIDERS (diagnostics/engine.ts) → eslint, ruff
+ *   - LSP_SERVERS (lsp/servers.ts)              → typescript-language-server,
+ *                                                 pyright-langserver
+ *   - defaultPlaywrightLoader (browser/driver)  → playwright
+ *
+ * Detection mirrors how each feature actually resolves its binary:
+ *   - project-local linters (eslint/ruff) → resolveBin() walk of node_modules/.bin
+ *   - LSP servers                          → PATH probe via `<bin> --version`
+ *     (they're global dev tools, conventionally installed once)
+ *   - Playwright                           → the same dynamic-import loader the
+ *     browser_check tool uses, so "installed" means "importable + has chromium"
+ *
+ * Contract: detect() is async, never throws, returns Promise<boolean>. The
+ * caller (PluginGate / doctor / /plugins) treats false as "missing, offer to
+ * install" and true as "present, leave alone."
+ *
+ * @see scripts/postinstall.mjs — required install-time deps (this file is
+ *      the OPTIONAL complement: tools we recommend but don't mandate)
+ */
+import { spawnSync } from 'node:child_process';
+import { resolveBin } from '../diagnostics/engine.js';
+import { defaultPlaywrightLoader } from '../browser/driver.js';
+import { DEFAULT_PROVIDERS } from '../diagnostics/engine.js';
+import { LSP_SERVERS } from '../lsp/servers.js';
+import { isMuted } from './prefs.js';
+// ---------------------------------------------------------------------------
+// Detection primitives — wrap the existing resolution mechanisms.
+// ---------------------------------------------------------------------------
+/**
+ * Detect a project-local binary (eslint, ruff). resolveBin walks up to 6
+ * parent dirs looking for `node_modules/.bin/<bin>`; on miss it returns the
+ * bare name, which we treat as "not found locally". This matches how
+ * diagnostics/engine.ts actually resolves the linter at call time.
+ */
+function detectLocalBin(bin) {
+    return (cwd) => {
+        try {
+            const resolved = resolveBin(bin, cwd);
+            // resolveBin returns the bare name when nothing is found.
+            return Promise.resolve(resolved !== bin);
+        }
+        catch {
+            return Promise.resolve(false);
+        }
+    };
+}
+/**
+ * Detect a globally-installed binary (LSP servers). Spawn `<bin> --version`
+ * synchronously through the default shell; a non-zero / errored spawn means
+ * "not on PATH". This is the pattern prereqChecks.ts uses for node/git/bash,
+ * adapted for a generic binary. Synchronous because detection runs at boot
+ * gate / doctor time where blocking briefly is acceptable.
+ */
+function detectGlobalBin(bin) {
+    return () => {
+        try {
+            // On win32 a bare binary name needs shell:true so .cmd shims resolve;
+            // on POSIX a direct spawn is fine.
+            const res = spawnSync(bin, ['--version'], {
+                stdio: ['ignore', 'pipe', 'ignore'],
+                shell: process.platform === 'win32',
+                timeout: 4000,
+            });
+            return Promise.resolve(res.status === 0 || (res.stdout != null && res.stdout.toString().trim().length > 0 && res.error === undefined));
+        }
+        catch {
+            return Promise.resolve(false);
+        }
+    };
+}
+/** Detect Playwright via the exact loader browser_check uses. */
+async function detectPlaywright() {
+    try {
+        const mod = await defaultPlaywrightLoader();
+        return mod !== null;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Plugin catalog.
+//
+// IDs are stable forever (persisted to plugins.json). Derived from the feature
+// registries so the binary names stay in lockstep — if diagnostics/engine.ts
+// renames `eslint` to something else, this catalog follows automatically.
+// ---------------------------------------------------------------------------
+/** The canonical plugin list. Order = display order in prompts + doctor. */
+export const 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.',
+    },
+];
+// ---------------------------------------------------------------------------
+// Small adapters so the catalog above derives binary names from the existing
+// registries rather than hardcoding them (single source of truth).
+// ---------------------------------------------------------------------------
+/** Look up a diagnostic provider's binary name by provider name. */
+function binForProvider(name) {
+    const p = DEFAULT_PROVIDERS.find((x) => x.name === name);
+    if (!p)
+        throw new Error(`plugin registry: unknown diagnostic provider '${name}'`);
+    return p.bin;
+}
+/** Look up an LSP server's binary name by language. */
+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;
+}
+// ---------------------------------------------------------------------------
+// Aggregating detector — what the gate / doctor / /plugins call.
+// ---------------------------------------------------------------------------
+/**
+ * Detect all plugins that are MISSING, in display order, after applying the
+ * two filters that suppress noise:
+ *   1. featureGate — if ZELARI_BROWSER=0 etc., the feature is off, so don't
+ *      prompt to install the tool it needs.
+ *   2. dontAskAgain — if the user dismissed this plugin before, respect it.
+ *      (The `/plugins` command passes `includeMuted: true` to re-surface them.)
+ *
+ * Never throws. A detect() that rejects is treated as "missing".
+ */
+export async function detectMissingPlugins(cwd, opts = {}) {
+    const missing = [];
+    for (const spec of PLUGINS) {
+        // Filter 1: kill-switch. If the feature is disabled, don't offer its tool.
+        if (process.env[spec.featureGate] === '0')
+            continue;
+        // Filter 2: user-muted (unless explicitly re-surfaced via /plugins).
+        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;
+}
+/** Look up a plugin by id (for `/plugins install <id>`). */
+export function findPlugin(id) {
+    return PLUGINS.find((p) => p.id === id);
+}
+//# sourceMappingURL=registry.js.map

package/dist/cli/plugins/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/cli/plugins/registry.ts"],"names":[],"mappings":"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"}

package/dist/cli/slashCommands.js

@@ -73,7 +73,7 @@ export function handleSlashCommand(text, availableSkills) {
                 kind: 'help',
                 message: `Available commands:\n  /login <provider> — authenticate with provider (grok, minimax, glm, custom)\n  /model — pick the active model from a list (auto-discovers, v0.7.10)\n  /model <name> — switch the active model directly\n  /model show — print the current model\n  /models — list discovered models for the active provider (v3-U)\n  /models refresh (or /discover) — re-discover models for the active provider\n  /provider — pick the active provider from a list (v0.7.10)\n  /provider <name> — switch the active provider directly\n  /provider custom <baseUrl> — point the active provider at a self-hosted endpoint (Ollama, LM Studio, vLLM, ...)\n  /provider custom clear — clear the custom endpoint override\n  /skill <name> [input] — invoke a skill (autocomplete with /skill <TAB>)\n  /skill-stats [name] — show invocation stats (success rate, avg duration, total tokens)\n  /council <input> — invoke the multi-agent council on input\n  /zelari <input> — run an autonomous mission (multi-run council until the MVP slice is complete)\n  /council-feedback <memberId> <1-5> [note] — rate a council member for future ranking (Task I.2)
   /promote-member <memberId> — promote a council member to a standalone skill (v3-K)
-  /update [--yes|-y] — check for zelari-code updates; --yes performs the update (v3-N)\n  /steer <text> — enqueue a follow-up prompt on the active run (Task 18.2)\n  /steer --interrupt <text> — cancel current run + enqueue <text> for next dispatch (Task C.3.2)\n  /compact — compact the session transcript\n  /clear — clear the visible transcript (session is preserved)\n  /sessions — list past sessions\n  /resume <id> — load a past session\n  /branch <name> — snapshot the current session into a new branch\n  /branches — list branches\n  /checkout <name> — switch the active branch\n  /new — start a fresh session\n  /diff [--staged] — show uncommitted changes (or staged with --staged)\n  /undo [--yes] — revert working-tree changes (destructive! requires --yes)\n  /checkpoint [label] — snapshot the working tree as a restore point\n  /rollback [id|latest] — restore the working tree to a checkpoint (no arg: list)\n  /index [status] — build the semantic code index for semantic_search\n  /mode [agent|council|zelari] — switch dispatch mode (same as shift+tab; no arg cycles)\n  /help — show this help\n  /exit — exit the CLI\n\n${formatSkillList(availableSkills)}`,
+  /update [--yes|-y] — check for zelari-code updates; --yes performs the update (v3-N)\n  /plugins — list optional tool plugins (Playwright, eslint, ruff, LSP servers)\n  /plugins install <id> — install a plugin now (e.g. /plugins install eslint)\n  /steer <text> — enqueue a follow-up prompt on the active run (Task 18.2)\n  /steer --interrupt <text> — cancel current run + enqueue <text> for next dispatch (Task C.3.2)\n  /compact — compact the session transcript\n  /clear — clear the visible transcript (session is preserved)\n  /sessions — list past sessions\n  /resume <id> — load a past session\n  /branch <name> — snapshot the current session into a new branch\n  /branches — list branches\n  /checkout <name> — switch the active branch\n  /new — start a fresh session\n  /diff [--staged] — show uncommitted changes (or staged with --staged)\n  /undo [--yes] — revert working-tree changes (destructive! requires --yes)\n  /checkpoint [label] — snapshot the working tree as a restore point\n  /rollback [id|latest] — restore the working tree to a checkpoint (no arg: list)\n  /index [status] — build the semantic code index for semantic_search\n  /mode [agent|council|zelari] — switch dispatch mode (same as shift+tab; no arg cycles)\n  /help — show this help\n  /exit — exit the CLI\n\n${formatSkillList(availableSkills)}`,
             };
         case 'exit':
             return { handled: true, kind: 'exit', message: 'Goodbye.' };
@@ -432,6 +432,23 @@ export function handleSlashCommand(text, availableSkills) {
                 updateForce: force,
             };
         }
+        case 'plugins': {
+            // Usage:
+            //   /plugins                → list all optional plugins (status + install hints)
+            //   /plugins install <id>   → install a specific plugin now
+            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 — list optional tool plugins (Playwright, eslint, ruff, LSP servers)\n' +
+                    '       /plugins install <id> — install a plugin now (e.g. /plugins install eslint)',
+            };
+        }
         case 'undo': {
             const confirmed = args.includes('--yes') || args.includes('-y');
             if (confirmed) {