@camunda8/cli 2.7.0 → 2.8.0-alpha.10

package/dist/open-helpers.js

@@ -0,0 +1,88 @@
+/**
+ * Pure helpers extracted from `src/commands/open.ts` so tests can import
+ * them without violating the test→commands import boundary (#291). The
+ * `openAppCommand` / `feedbackCommand` handlers in `src/commands/open.ts`
+ * re-import these.
+ */
+import { spawn } from "node:child_process";
+import { platform } from "node:os";
+import { requireOneOf, requirePositional } from "./command-validation.js";
+import { getLogger } from "./logger.js";
+export const OPEN_APPS = [
+    "operate",
+    "tasklist",
+    "modeler",
+    "optimize",
+];
+export function isAppName(value) {
+    // biome-ignore lint/plugin: safe widening — readonly tuple to readonly string[] for .includes() compatibility
+    return OPEN_APPS.includes(value);
+}
+/** Pattern that matches a self-managed REST API version suffix, e.g. `/v2` */
+const VERSION_SUFFIX_RE = /\/v\d+\/?$/;
+/**
+ * Derive the URL of a Camunda web application from the cluster base URL.
+ *
+ * Only supported for self-managed clusters where the base URL is the REST API
+ * endpoint (e.g. `http://localhost:8080/v2`). Returns `null` when the URL
+ * does not look like a self-managed gateway (no `/v<n>` suffix).
+ */
+export function deriveAppUrl(baseUrl, app) {
+    if (!VERSION_SUFFIX_RE.test(baseUrl)) {
+        return null;
+    }
+    const base = baseUrl.replace(VERSION_SUFFIX_RE, "").replace(/\/$/, "");
+    return `${base}/${app}`;
+}
+/**
+ * Determine the platform-appropriate command and arguments to open a URL.
+ *
+ * WSL is detected explicitly because it reports `linux`, but should use the
+ * Windows opener via interop rather than relying on `xdg-open`.
+ *
+ * Accepts optional overrides for testing.
+ */
+export function getBrowserCommand(url, plat = platform(), env = process.env) {
+    const isWsl = plat === "linux" && Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP);
+    if (plat === "darwin") {
+        return { command: "open", args: [url] };
+    }
+    if (plat === "win32" || isWsl) {
+        return { command: "cmd.exe", args: ["/c", "start", "", url] };
+    }
+    // Linux
+    return { command: "xdg-open", args: [url] };
+}
+/**
+ * Open a URL in the default system browser.
+ * Works on macOS, Linux, native Windows, and WSL.
+ */
+export function openUrl(url) {
+    const logger = getLogger();
+    const { command, args } = getBrowserCommand(url);
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    child.on("error", (error) => {
+        if (error.code === "ENOENT") {
+            logger.error(`Could not open the browser automatically because '${command}' is not available on PATH.`);
+            logger.info(`Open this URL manually: ${url}`);
+            return;
+        }
+        logger.error(`Could not open the browser automatically: ${error.message}`);
+        logger.info(`Open this URL manually: ${url}`);
+    });
+    child.unref();
+}
+const OPEN_USAGE = "Usage: c8 open <app> [--profile <name>]";
+/**
+ * Validate raw CLI positional + options for the open command.
+ * Returns a fully validated and type-narrowed input object.
+ * Exits with code 1 on invalid input.
+ */
+export function validateOpenAppOptions(app, options) {
+    return {
+        app: requireOneOf(requirePositional(app, "Application", OPEN_USAGE), OPEN_APPS, "application", OPEN_USAGE),
+        profile: options.profile,
+        dryRun: options.dryRun,
+    };
+}
+//# sourceMappingURL=open-helpers.js.map

package/dist/open-helpers.js.map

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

package/dist/plugin-loader.d.ts

@@ -1,8 +1,55 @@
 /**
  * Plugin loader for dynamic command loading
  */
+import type { FlagDef } from "./command-registry.ts";
+type CommandHandler = (args: string[], flags?: Record<string, unknown>) => Promise<void>;
+interface CommandWithFlags {
+    flags: Record<string, FlagDef>;
+    handler: CommandHandler;
+}
+type PluginCommand = CommandHandler | CommandWithFlags;
 interface PluginCommands {
-    [commandName: string]: (args: string[]) => Promise<void>;
+    [commandName: string]: PluginCommand;
+}
+/**
+ * Per-command plugin metadata.
+ *
+ * A plugin command is **either** metadata-driven (declares typed flags via
+ * the `{ flags, handler }` command form) **or** a passthrough command
+ * (`passthrough: true` + `passthroughHint`). Mutually exclusive — see
+ * #251 / #366. Declaring both is rejected at load time.
+ */
+export interface PluginCommandMeta {
+    description?: string;
+    helpDescription?: string;
+    examples?: {
+        command: string;
+        description: string;
+    }[];
+    /** Subcommands for shell completion (e.g. cluster → start, stop, status). */
+    subcommands?: {
+        name: string;
+        description: string;
+    }[];
+    /**
+     * If true, c8ctl strips GLOBAL_FLAGS from argv and forwards everything
+     * else verbatim to the bare-function handler. Help and JSON help
+     * advertise the boundary explicitly.
+     *
+     * MUST NOT appear together with the `{ flags, handler }` command form;
+     * the load-time validator drops any command that declares both.
+     */
+    passthrough?: boolean;
+    /**
+     * Required when `passthrough` is true. Short text rendered in help that
+     * advertises the boundary, e.g. "Forwards args to `kubectl`".
+     */
+    passthroughHint?: string;
+    /**
+     * Optional documentation-only flag list rendered in help under
+     * passthrough commands. NOT parsed by c8ctl.
+     */
+    flagsHint?: string[];
 }
 /**
  * Load all installed plugins from global plugins directory
@@ -15,7 +62,7 @@ export declare function getPluginCommands(): PluginCommands;
 /**
  * Execute a plugin command if it exists
  */
-export declare function executePluginCommand(commandName: string, args: string[]): Promise<boolean>;
+export declare function executePluginCommand(commandName: string, args: string[], flags?: Record<string, unknown>): Promise<boolean>;
 /**
  * Check if a command is provided by a plugin
  */
@@ -31,6 +78,7 @@ export interface PluginCommandInfo {
     commandName: string;
     pluginName: string;
     description?: string;
+    helpDescription?: string;
     examples?: {
         command: string;
         description: string;
@@ -40,8 +88,19 @@ export interface PluginCommandInfo {
         name: string;
         description: string;
     }[];
+    /** True when the command opted into the #366 passthrough contract. */
+    passthrough?: boolean;
+    /** Required when passthrough is true — short text that names the boundary. */
+    passthroughHint?: string;
+    /** Optional documentation-only flag list rendered under passthrough help. */
+    flagsHint?: string[];
 }
 export declare function getPluginCommandsInfo(): PluginCommandInfo[];
+/**
+ * True if the named command is a registered passthrough plugin command
+ * (#366). Used by the dispatcher to gate the strip-and-forward path.
+ */
+export declare function isPassthroughPluginCommand(commandName: string): boolean;
 /**
  * Clear all loaded plugins (useful for testing and after uninstall)
  */

package/dist/plugin-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../src/plugin-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,UAAU,cAAc;IACvB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAiHD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2H1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAQlD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,6EAA6E;IAC7E,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD;AAED,wBAAgB,qBAAqB,IAAI,iBAAiB,EAAE,CAgB3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../src/plugin-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAKrD,KAAK,cAAc,GAAG,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,UAAU,gBAAgB;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,cAAc,CAAC;CACxB;AAED,KAAK,aAAa,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEvD,UAAU,cAAc;IACvB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAAC;CACrC;AAUD;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,6EAA6E;IAC7E,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAwQD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CA8J1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAQlD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,6EAA6E;IAC7E,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,qBAAqB,IAAI,iBAAiB,EAAE,CAqB3D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAOvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/plugin-loader.js

@@ -15,6 +15,135 @@ import { ensurePluginsDir } from "./config.js";
 import { getLogger } from "./logger.js";
 import { c8ctl } from "./runtime.js";
 const loadedPlugins = new Map();
+/**
+ * Validate the passthrough/flags mutual-exclusion rule (#366). Removes
+ * offending commands from the registered set so they cannot be invoked,
+ * and emits a `logger.warn` naming the plugin and command so the
+ * misconfiguration is visible at startup.
+ *
+ * The contract: a command MUST NOT declare `passthrough: true` AND use the
+ * `{ flags, handler }` form. Pick one. A passthrough command without a
+ * `passthroughHint` is also rejected (the hint is what makes the boundary
+ * legible to users and agents).
+ *
+ * Mutates `plugin.commands` in place. Safe to call after each plugin is
+ * loaded.
+ */
+function validatePassthroughCommands(plugin) {
+    const logger = getLogger();
+    const meta = plugin.metadata?.commands ?? {};
+    for (const commandName of Object.keys(plugin.commands)) {
+        const commandMeta = meta[commandName];
+        if (commandMeta?.passthrough === undefined)
+            continue;
+        // `passthrough: false` is equivalent to "not opted in" — silently
+        // skip. Any other non-`true` value (e.g. the string "true", a
+        // number) is a contract violation: dispatch and help both gate on
+        // `=== true`, so a truthy non-true value would silently disagree
+        // with them. Reject loudly at load time.
+        if (commandMeta.passthrough === false)
+            continue;
+        if (commandMeta.passthrough !== true) {
+            logger.warn(`Plugin '${plugin.name}' command '${commandName}' has metadata.passthrough set to ` +
+                `${JSON.stringify(commandMeta.passthrough)} but the contract requires the boolean ` +
+                "literal `true` (or `false` / omitted to opt out). Dropping this command (#366).");
+            delete plugin.commands[commandName];
+            continue;
+        }
+        const cmd = plugin.commands[commandName];
+        const hasFlagsForm = typeof cmd !== "function";
+        if (hasFlagsForm) {
+            logger.warn(`Plugin '${plugin.name}' command '${commandName}' declares both passthrough:true AND flags. ` +
+                "Pick one \u2014 a passthrough command must use the bare-function handler form. " +
+                "Dropping this command (#366).");
+            delete plugin.commands[commandName];
+            continue;
+        }
+        if (typeof commandMeta.passthroughHint !== "string" ||
+            commandMeta.passthroughHint.trim() === "") {
+            logger.warn(`Plugin '${plugin.name}' command '${commandName}' declares passthrough:true ` +
+                "but is missing a non-empty passthroughHint. The hint is required so help and " +
+                "agents can advertise the boundary. Dropping this command (#366).");
+            delete plugin.commands[commandName];
+            continue;
+        }
+        // `flagsHint` is documentation-only and consumed by the help
+        // renderer, which assumes `string[]`. Validate the shape here so a
+        // mis-typed value can't reach the renderer. The field is optional;
+        // invalid shapes are stripped (not fatal) so the command itself
+        // continues to work — only the doc affordance is lost.
+        const flagsHint = commandMeta.flagsHint;
+        if (flagsHint !== undefined) {
+            const valid = Array.isArray(flagsHint) &&
+                flagsHint.every((entry) => typeof entry === "string");
+            if (!valid) {
+                logger.warn(`Plugin '${plugin.name}' command '${commandName}' declares metadata.flagsHint ` +
+                    "but it is not a string[]. Ignoring flagsHint (#366).");
+                delete commandMeta.flagsHint;
+            }
+        }
+    }
+}
+/**
+ * Reject duplicate plugin command names at load time. If `plugin` declares
+ * a command name that is already registered by an earlier-loaded plugin,
+ * drop it from `plugin.commands` and emit `logger.warn` naming both
+ * plugins so the conflict is visible at startup.
+ *
+ * **Conflict policy: first registration wins.** This is an explicit
+ * choice (#366) and replaces the previous implicit "last-loaded wins"
+ * behaviour produced by `Object.assign` over `loadedPlugins` in
+ * insertion order. Plugins cannot override one another by registering
+ * the same command name; if you want a different command, give it a
+ * different name. Default plugins always load first, so user-installed
+ * plugins cannot override default commands by name.
+ *
+ * This guarantees that the merged map returned by `getPluginCommands()`
+ * has a single owning plugin per command name, which keeps dispatch and
+ * `isPassthroughPluginCommand()` consistent: the help renderer and the
+ * runtime always agree on which plugin handles a given verb.
+ *
+ * Mutates `plugin.commands` in place. Safe to call after each plugin is
+ * loaded; relies on `loadedPlugins` already containing previously-loaded
+ * plugins.
+ */
+function rejectDuplicateCommandNames(plugin) {
+    const logger = getLogger();
+    for (const commandName of Object.keys(plugin.commands)) {
+        for (const existing of loadedPlugins.values()) {
+            if (Object.hasOwn(existing.commands, commandName)) {
+                logger.warn(`Plugin '${plugin.name}' tried to register command '${commandName}' but it is ` +
+                    `already provided by plugin '${existing.name}'. The first registration wins; ` +
+                    `dropping the duplicate from '${plugin.name}'.`);
+                delete plugin.commands[commandName];
+                break;
+            }
+        }
+    }
+}
+/**
+ * Reject a plugin whose name collides with an already-loaded plugin.
+ * This is a separate concern from the command-name collision policy
+ * tracked under #363: that policy rejects two plugins exporting the
+ * same command name, while this one rejects two plugins sharing the
+ * same `package.json#name`. Both follow first-registration-wins.
+ * Without this guard a user-installed package sharing a name with a
+ * default plugin (or with another already-loaded plugin) would
+ * silently overwrite the prior `loadedPlugins.set()` entry, bypassing
+ * the command-name policy entirely.
+ *
+ * Returns `true` when the caller should skip the load; `false` when
+ * the name is free.
+ */
+function isDuplicatePluginName(pluginName) {
+    const logger = getLogger();
+    if (loadedPlugins.has(pluginName)) {
+        logger.warn(`Plugin name '${pluginName}' is already loaded; refusing to load a second plugin ` +
+            `with the same name. The first registration wins.`);
+        return true;
+    }
+    return false;
+}
 /**
  * Load default plugins bundled with c8ctl
  */
@@ -44,7 +173,12 @@ async function loadDefaultPlugins() {
             logger.debug("No default-plugins directory found");
             return;
         }
-        const pluginDirs = readdirSync(defaultPluginsDir);
+        // Sort to make load order deterministic across filesystems/OSes.
+        // The first-registration-wins duplicate-name policy in
+        // `rejectDuplicateCommandNames` relies on this — without a stable
+        // sort, "who wins" would depend on `readdirSync()` order, which
+        // varies across platforms and filesystems.
+        const pluginDirs = readdirSync(defaultPluginsDir).sort();
         logger.debug(`Found ${pluginDirs.length} default plugin(s)`);
         for (const pluginDir of pluginDirs) {
             const pluginPath = join(defaultPluginsDir, pluginDir);
@@ -64,6 +198,13 @@ async function loadDefaultPlugins() {
                 // Read package.json
                 const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
                 const pluginName = packageJson.name || `default-${pluginDir}`;
+                // Check for duplicate plugin name BEFORE the dynamic import
+                // so a duplicate-name plugin's module code never runs (the
+                // import has top-level side effects we don't want to execute
+                // only to throw the result away).
+                if (isDuplicatePluginName(pluginName)) {
+                    continue;
+                }
                 const pluginFile = existsSync(pluginFileJs)
                     ? pluginFileJs
                     : pluginFileTs;
@@ -72,12 +213,15 @@ async function loadDefaultPlugins() {
                 logger.debug(`Loading default plugin from: ${pluginUrl}`);
                 const plugin = await import(__rewriteRelativeImportExtension(pluginUrl));
                 if (plugin.commands && typeof plugin.commands === "object") {
-                    loadedPlugins.set(pluginName, {
+                    const loaded = {
                         name: pluginName,
-                        commands: plugin.commands,
+                        commands: { ...plugin.commands },
                         metadata: plugin.metadata || {},
-                    });
-                    const commandNames = Object.keys(plugin.commands);
+                    };
+                    validatePassthroughCommands(loaded);
+                    rejectDuplicateCommandNames(loaded);
+                    loadedPlugins.set(pluginName, loaded);
+                    const commandNames = Object.keys(loaded.commands);
                     logger.debug(`Successfully loaded default plugin: ${pluginName} with ${commandNames.length} commands:`, commandNames);
                 }
             }
@@ -108,7 +252,12 @@ export async function loadInstalledPlugins() {
         return;
     }
     try {
-        const entries = readdirSync(nodeModulesPath);
+        // Sort to make load order deterministic across filesystems/OSes.
+        // The first-registration-wins duplicate-name policy in
+        // `rejectDuplicateCommandNames` relies on this — without a stable
+        // sort, "who wins" would depend on `readdirSync()` order, which
+        // varies across platforms and filesystems.
+        const entries = readdirSync(nodeModulesPath).sort();
         logger.debug(`Scanning ${entries.length} entries in node_modules`);
         const packagesToScan = [];
         // Collect regular packages and scoped packages
@@ -117,10 +266,10 @@ export async function loadInstalledPlugins() {
                 continue;
             }
             if (entry.startsWith("@")) {
-                // Scoped package - scan subdirectories
+                // Scoped package - scan subdirectories (sorted for determinism).
                 const scopePath = join(nodeModulesPath, entry);
                 try {
-                    const scopedPackages = readdirSync(scopePath);
+                    const scopedPackages = readdirSync(scopePath).sort();
                     for (const scopedPkg of scopedPackages) {
                         if (!scopedPkg.startsWith(".")) {
                             packagesToScan.push(join(entry, scopedPkg));
@@ -136,6 +285,11 @@ export async function loadInstalledPlugins() {
                 packagesToScan.push(entry);
             }
         }
+        // Final defensive sort: `@scope/pkg` paths interleave with bare
+        // `pkg` paths in the order we appended them, but for
+        // duplicate-name resolution we want a single, stable lexicographic
+        // order over the full set.
+        packagesToScan.sort();
         logger.debug(`Found ${packagesToScan.length} packages to scan:`, packagesToScan);
         for (const packageName of packagesToScan) {
             const packagePath = join(nodeModulesPath, packageName);
@@ -165,18 +319,39 @@ export async function loadInstalledPlugins() {
                 const pluginFile = existsSync(pluginFileJs)
                     ? pluginFileJs
                     : pluginFileTs;
+                // Use the package.json#name (not the filesystem directory
+                // entry) as the canonical plugin name / loadedPlugins key.
+                // Under npm aliases (e.g. `npm i my-alias@npm:real-plugin`),
+                // the install directory is `my-alias` but the package name is
+                // `real-plugin`. Keying by directory would miss real
+                // duplicate-name collisions and surface the wrong name in
+                // duplicate warnings. `packageName` is kept for filesystem /
+                // logging purposes only.
+                const pluginName = typeof packageJson.name === "string" && packageJson.name.length > 0
+                    ? packageJson.name
+                    : packageName;
+                // Check for duplicate plugin name BEFORE the dynamic import
+                // so a duplicate-name plugin's module code never runs (the
+                // import has top-level side effects we don't want to execute
+                // only to throw the result away).
+                if (isDuplicatePluginName(pluginName)) {
+                    continue;
+                }
                 // Use file:// protocol and add timestamp to bust cache
                 const pluginUrl = `file://${pluginFile}?t=${Date.now()}`;
                 logger.debug(`Loading plugin from: ${pluginUrl}`);
                 const plugin = await import(__rewriteRelativeImportExtension(pluginUrl));
                 if (plugin.commands && typeof plugin.commands === "object") {
-                    loadedPlugins.set(packageName, {
-                        name: packageName,
-                        commands: plugin.commands,
+                    const loaded = {
+                        name: pluginName,
+                        commands: { ...plugin.commands },
                         metadata: plugin.metadata || {},
-                    });
-                    const commandNames = Object.keys(plugin.commands);
-                    logger.debug(`Successfully loaded plugin: ${packageName} with ${commandNames.length} commands:`, commandNames);
+                    };
+                    validatePassthroughCommands(loaded);
+                    rejectDuplicateCommandNames(loaded);
+                    loadedPlugins.set(pluginName, loaded);
+                    const commandNames = Object.keys(loaded.commands);
+                    logger.debug(`Successfully loaded plugin: ${pluginName} (dir: ${packageName}) with ${commandNames.length} commands:`, commandNames);
                 }
             }
             catch (error) {
@@ -193,7 +368,7 @@ export async function loadInstalledPlugins() {
  * Get all loaded plugin commands
  */
 export function getPluginCommands() {
-    const allCommands = {};
+    const allCommands = Object.create(null);
     for (const plugin of loadedPlugins.values()) {
         Object.assign(allCommands, plugin.commands);
     }
@@ -202,10 +377,23 @@ export function getPluginCommands() {
 /**
  * Execute a plugin command if it exists
  */
-export async function executePluginCommand(commandName, args) {
+export async function executePluginCommand(commandName, args, flags) {
     const commands = getPluginCommands();
-    if (commands[commandName]) {
-        await commands[commandName](args);
+    const cmd = Object.hasOwn(commands, commandName)
+        ? commands[commandName]
+        : undefined;
+    if (cmd) {
+        if (typeof cmd === "function") {
+            if (flags !== undefined) {
+                await cmd(args, flags);
+            }
+            else {
+                await cmd(args);
+            }
+        }
+        else {
+            await cmd.handler(args, flags);
+        }
         return true;
     }
     return false;
@@ -215,7 +403,7 @@ export async function executePluginCommand(commandName, args) {
  */
 export function isPluginCommand(commandName) {
     const commands = getPluginCommands();
-    return commandName in commands;
+    return Object.hasOwn(commands, commandName);
 }
 /**
  * Get list of all plugin command names
@@ -227,17 +415,36 @@ export function getPluginCommandsInfo() {
     const infos = [];
     for (const plugin of loadedPlugins.values()) {
         for (const commandName of Object.keys(plugin.commands)) {
+            const meta = plugin.metadata?.commands?.[commandName];
             infos.push({
                 commandName,
                 pluginName: plugin.name,
-                description: plugin.metadata?.commands?.[commandName]?.description,
-                examples: plugin.metadata?.commands?.[commandName]?.examples,
-                subcommands: plugin.metadata?.commands?.[commandName]?.subcommands,
+                description: meta?.description,
+                helpDescription: meta?.helpDescription,
+                examples: meta?.examples,
+                subcommands: meta?.subcommands,
+                passthrough: meta?.passthrough === true ? true : undefined,
+                passthroughHint: meta?.passthroughHint,
+                flagsHint: meta?.flagsHint,
             });
         }
     }
     return infos;
 }
+/**
+ * True if the named command is a registered passthrough plugin command
+ * (#366). Used by the dispatcher to gate the strip-and-forward path.
+ */
+export function isPassthroughPluginCommand(commandName) {
+    for (const plugin of loadedPlugins.values()) {
+        if (!Object.hasOwn(plugin.commands, commandName))
+            continue;
+        const meta = plugin.metadata?.commands?.[commandName];
+        if (meta?.passthrough === true)
+            return true;
+    }
+    return false;
+}
 /**
  * Clear all loaded plugins (useful for testing and after uninstall)
  */

package/dist/plugin-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-loader.js","sourceRoot":"","sources":["../src/plugin-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin-loader.js","sourceRoot":"","sources":["../src/plugin-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAmErC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,SAAS,2BAA2B,CAAC,MAAoB;IACxD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC7C,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,WAAW,EAAE,WAAW,KAAK,SAAS;YAAE,SAAS;QAErD,kEAAkE;QAClE,8DAA8D;QAC9D,kEAAkE;QAClE,iEAAiE;QACjE,yCAAyC;QACzC,IAAI,WAAW,CAAC,WAAW,KAAK,KAAK;YAAE,SAAS;QAChD,IAAI,WAAW,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CACV,WAAW,MAAM,CAAC,IAAI,cAAc,WAAW,oCAAoC;gBAClF,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,yCAAyC;gBACnF,iFAAiF,CAClF,CAAC;YACF,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACpC,SAAS;QACV,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,UAAU,CAAC;QAC/C,IAAI,YAAY,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CACV,WAAW,MAAM,CAAC,IAAI,cAAc,WAAW,8CAA8C;gBAC5F,iFAAiF;gBACjF,+BAA+B,CAChC,CAAC;YACF,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACpC,SAAS;QACV,CAAC;QACD,IACC,OAAO,WAAW,CAAC,eAAe,KAAK,QAAQ;YAC/C,WAAW,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,EACxC,CAAC;YACF,MAAM,CAAC,IAAI,CACV,WAAW,MAAM,CAAC,IAAI,cAAc,WAAW,8BAA8B;gBAC5E,+EAA+E;gBAC/E,kEAAkE,CACnE,CAAC;YACF,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACpC,SAAS;QACV,CAAC;QAED,6DAA6D;QAC7D,mEAAmE;QACnE,mEAAmE;QACnE,gEAAgE;QAChE,uDAAuD;QACvD,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QACxC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,KAAK,GACV,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;gBACxB,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;YACvD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CACV,WAAW,MAAM,CAAC,IAAI,cAAc,WAAW,gCAAgC;oBAC9E,sDAAsD,CACvD,CAAC;gBACF,OAAO,WAAW,CAAC,SAAS,CAAC;YAC9B,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAS,2BAA2B,CAAC,MAAoB;IACxD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,CACV,WAAW,MAAM,CAAC,IAAI,gCAAgC,WAAW,cAAc;oBAC9E,+BAA+B,QAAQ,CAAC,IAAI,kCAAkC;oBAC9E,gCAAgC,MAAM,CAAC,IAAI,IAAI,CAChD,CAAC;gBACF,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;gBACpC,MAAM;YACP,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,qBAAqB,CAAC,UAAkB;IAChD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CACV,gBAAgB,UAAU,wDAAwD;YACjF,kDAAkD,CACnD,CAAC;QACF,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAE9C,IAAI,CAAC;QACJ,+CAA+C;QAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAEtC,iCAAiC;QACjC,6DAA6D;QAC7D,+DAA+D;QAC/D,MAAM,aAAa,GAAG;YACrB,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,kBAAkB;YACtD,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,iBAAiB,CAAC,EAAE,mBAAmB;SAC7D,CAAC;QAEF,IAAI,iBAAiB,GAAkB,IAAI,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YAClC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,iBAAiB,GAAG,IAAI,CAAC;gBACzB,MAAM;YACP,CAAC;QACF,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACnD,OAAO;QACR,CAAC;QAED,iEAAiE;QACjE,uDAAuD;QACvD,kEAAkE;QAClE,gEAAgE;QAChE,2CAA2C;QAC3C,MAAM,UAAU,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,SAAS,UAAU,CAAC,MAAM,oBAAoB,CAAC,CAAC;QAE7D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;YACtD,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAEzD,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;gBAChE,SAAS;YACV,CAAC;YAED,IAAI,CAAC;gBACJ,8BAA8B;gBAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;gBACzD,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;gBAEzD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC5D,MAAM,CAAC,KAAK,CAAC,4CAA4C,SAAS,EAAE,CAAC,CAAC;oBACtE,SAAS;gBACV,CAAC;gBAED,oBAAoB;gBACpB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;gBACvE,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,IAAI,WAAW,SAAS,EAAE,CAAC;gBAE9D,4DAA4D;gBAC5D,2DAA2D;gBAC3D,6DAA6D;gBAC7D,kCAAkC;gBAClC,IAAI,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC;oBACvC,SAAS;gBACV,CAAC;gBAED,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC;oBAC1C,CAAC,CAAC,YAAY;oBACd,CAAC,CAAC,YAAY,CAAC;gBAEhB,uDAAuD;gBACvD,MAAM,SAAS,GAAG,UAAU,UAAU,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACzD,MAAM,CAAC,KAAK,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;gBAC1D,MAAM,MAAM,GAAG,MAAM,MAAM,kCAAC,SAAS,EAAC,CAAC;gBAEvC,IAAI,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAC5D,MAAM,MAAM,GAAiB;wBAC5B,IAAI,EAAE,UAAU;wBAChB,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;wBAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;qBAC/B,CAAC;oBACF,2BAA2B,CAAC,MAAM,CAAC,CAAC;oBACpC,2BAA2B,CAAC,MAAM,CAAC,CAAC;oBACpC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;oBACtC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAClD,MAAM,CAAC,KAAK,CACX,uCAAuC,UAAU,SAAS,YAAY,CAAC,MAAM,YAAY,EACzF,YAAY,CACZ,CAAC;gBACH,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,KAAK,CAAC,iCAAiC,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;YACpE,CAAC;QACF,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACzC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,gDAAgD;IAChD,4EAA4E;IAC5E,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC;IAEzB,6BAA6B;IAC7B,MAAM,kBAAkB,EAAE,CAAC;IAE3B,mCAAmC;IACnC,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAEzD,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAChE,OAAO;IACR,CAAC;IAED,IAAI,CAAC;QACJ,iEAAiE;QACjE,uDAAuD;QACvD,kEAAkE;QAClE,gEAAgE;QAChE,2CAA2C;QAC3C,MAAM,OAAO,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,MAAM,0BAA0B,CAAC,CAAC;QAEnE,MAAM,cAAc,GAAa,EAAE,CAAC;QAEpC,+CAA+C;QAC/C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACV,CAAC;YAED,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,iEAAiE;gBACjE,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;gBAC/C,IAAI,CAAC;oBACJ,MAAM,cAAc,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;oBACrD,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;wBACxC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;4BAChC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;wBAC7C,CAAC;oBACF,CAAC;gBACF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,MAAM,CAAC,KAAK,CACX,2CAA2C,KAAK,GAAG,EACnD,KAAK,CACL,CAAC;gBACH,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,kBAAkB;gBAClB,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACF,CAAC;QAED,gEAAgE;QAChE,qDAAqD;QACrD,mEAAmE;QACnE,2BAA2B;QAC3B,cAAc,CAAC,IAAI,EAAE,CAAC;QAEtB,MAAM,CAAC,KAAK,CACX,SAAS,cAAc,CAAC,MAAM,oBAAoB,EAClD,cAAc,CACd,CAAC;QAEF,KAAK,MAAM,WAAW,IAAI,cAAc,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;YACvD,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAE1D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,uBAAuB,WAAW,EAAE,CAAC,CAAC;gBACnD,SAAS;YACV,CAAC;YAED,IAAI,CAAC;gBACJ,iDAAiD;gBACjD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;gBAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;gBAE1D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC5D,MAAM,CAAC,KAAK,CAAC,mCAAmC,WAAW,EAAE,CAAC,CAAC;oBAC/D,SAAS;gBACV,CAAC;gBAED,sCAAsC;gBACtC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;gBAEvE,qDAAqD;gBACrD,MAAM,aAAa,GAClB,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC;oBACvC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;gBAEhD,IAAI,CAAC,aAAa,EAAE,CAAC;oBACpB,MAAM,CAAC,KAAK,CACX,WAAW,WAAW,0DAA0D,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAC7H,CAAC;oBACF,SAAS;gBACV,CAAC;gBAED,MAAM,CAAC,KAAK,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;gBAE7D,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC;oBAC1C,CAAC,CAAC,YAAY;oBACd,CAAC,CAAC,YAAY,CAAC;gBAEhB,0DAA0D;gBAC1D,2DAA2D;gBAC3D,6DAA6D;gBAC7D,8DAA8D;gBAC9D,qDAAqD;gBACrD,0DAA0D;gBAC1D,6DAA6D;gBAC7D,yBAAyB;gBACzB,MAAM,UAAU,GACf,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;oBAClE,CAAC,CAAC,WAAW,CAAC,IAAI;oBAClB,CAAC,CAAC,WAAW,CAAC;gBAEhB,4DAA4D;gBAC5D,2DAA2D;gBAC3D,6DAA6D;gBAC7D,kCAAkC;gBAClC,IAAI,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC;oBACvC,SAAS;gBACV,CAAC;gBAED,uDAAuD;gBACvD,MAAM,SAAS,GAAG,UAAU,UAAU,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACzD,MAAM,CAAC,KAAK,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;gBAClD,MAAM,MAAM,GAAG,MAAM,MAAM,kCAAC,SAAS,EAAC,CAAC;gBAEvC,IAAI,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAC5D,MAAM,MAAM,GAAiB;wBAC5B,IAAI,EAAE,UAAU;wBAChB,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;wBAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;qBAC/B,CAAC;oBACF,2BAA2B,CAAC,MAAM,CAAC,CAAC;oBACpC,2BAA2B,CAAC,MAAM,CAAC,CAAC;oBACpC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;oBACtC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAClD,MAAM,CAAC,KAAK,CACX,+BAA+B,UAAU,UAAU,WAAW,UAAU,YAAY,CAAC,MAAM,YAAY,EACvG,YAAY,CACZ,CAAC;gBACH,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,KAAK,CAAC,yBAAyB,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9D,CAAC;QACF,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,yBAAyB,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAChC,MAAM,WAAW,GAAmB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAExD,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,WAAmB,EACnB,IAAc,EACd,KAA+B;IAE/B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC/C,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvB,CAAC,CAAC,SAAS,CAAC;IAEb,IAAI,GAAG,EAAE,CAAC;QACT,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACP,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;QACF,CAAC;aAAM,CAAC;YACP,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACpC,OAAO,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACzC,CAAC;AAqBD,MAAM,UAAU,qBAAqB;IACpC,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC;gBACV,WAAW;gBACX,UAAU,EAAE,MAAM,CAAC,IAAI;gBACvB,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,eAAe,EAAE,IAAI,EAAE,eAAe;gBACtC,QAAQ,EAAE,IAAI,EAAE,QAAQ;gBACxB,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,WAAW,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAC1D,eAAe,EAAE,IAAI,EAAE,eAAe;gBACtC,SAAS,EAAE,IAAI,EAAE,SAAS;aAC1B,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC7D,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC;YAAE,SAAS;QAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,IAAI,EAAE,WAAW,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IACjC,aAAa,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC"}

package/dist/plugin-version.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pure helpers extracted from `src/commands/plugins.ts` so tests can
+ * import them without violating the test→commands import boundary
+ * (#291). Plugin command handlers in `src/commands/plugins.ts` re-import
+ * these.
+ */
+/**
+ * Get installed plugin version from package.json
+ */
+export declare function getInstalledPluginVersion(nodeModulesPath: string, packageName: string): string | null;
+/**
+ * Extract version from a registry source like package@version
+ */
+export declare function getVersionFromSource(source: string, packageName: string): string | null;
+//# sourceMappingURL=plugin-version.d.ts.map

package/dist/plugin-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-version.d.ts","sourceRoot":"","sources":["../src/plugin-version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAcf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAQf"}

package/dist/plugin-version.js

@@ -0,0 +1,37 @@
+/**
+ * Pure helpers extracted from `src/commands/plugins.ts` so tests can
+ * import them without violating the test→commands import boundary
+ * (#291). Plugin command handlers in `src/commands/plugins.ts` re-import
+ * these.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Get installed plugin version from package.json
+ */
+export function getInstalledPluginVersion(nodeModulesPath, packageName) {
+    const packagePath = join(nodeModulesPath, ...packageName.split("/"));
+    const packageJsonPath = join(packagePath, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        return null;
+    }
+    try {
+        const pkgJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        return typeof pkgJson.version === "string" ? pkgJson.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract version from a registry source like package@version
+ */
+export function getVersionFromSource(source, packageName) {
+    const packagePrefix = `${packageName}@`;
+    if (!source.startsWith(packagePrefix)) {
+        return null;
+    }
+    const version = source.slice(packagePrefix.length).trim();
+    return version.length > 0 ? version : null;
+}
+//# sourceMappingURL=plugin-version.js.map

package/dist/plugin-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-version.js","sourceRoot":"","sources":["../src/plugin-version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACxC,eAAuB,EACvB,WAAmB;IAEnB,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE1D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,OAAO,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CACnC,MAAc,EACd,WAAmB;IAEnB,MAAM,aAAa,GAAG,GAAG,WAAW,GAAG,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC"}