@vibesdotdev/plugins 0.0.0-stage → 1.0.0-rc.0

package/dist/cli/plugins.list.cli-command.impl.consumer.js

@@ -0,0 +1,343 @@
+import { getRuntimePath } from '@vibesdotdev/paths';
+import { PLUGIN_RESOLUTIONS_CONTEXT_ID } from '@vibesdotdev/kernel/schemas/package-plugins';
+import { getRuntimePackagePlugins } from '@vibesdotdev/kernel';
+import { readWorkspacePluginSurfaces, workspacePluginRows } from '@vibesdotdev/kernel/bootstrap';
+import { z } from 'zod/v4';
+import { PluginsCLICommand } from "./context.js";
+import { resolveScopes } from "./scopes.js";
+/** The command's inputs, each read on its own: a missing or non-text `--scope` is empty. */
+const ListInputSchema = z.object({
+    scope: z.string().trim().catch('')
+});
+function listedScope(scope, delegatedGlobalRoot) {
+    const listed = { kind: scope.kind, root: scope.root };
+    // Named, so a reader can see WHY a global row's surface is a file
+    // under someone else's root instead of `$VIBES_HOME/package.json`.
+    if (scope.kind === 'global' && delegatedGlobalRoot)
+        listed.delegatesTo = delegatedGlobalRoot;
+    return listed;
+}
+function listedResolution(row) {
+    const listed = {
+        id: row.id,
+        specifier: row.specifier,
+        scope: row.scope,
+        status: row.status,
+        reason: row.reason,
+        root: row.root,
+        realpath: row.realpath,
+        linked: row.linked,
+        importMs: row.importMs
+    };
+    if (row.reason)
+        listed.reason = row.reason;
+    if (row.error)
+        listed.error = row.error;
+    return listed;
+}
+function packageNameOf(specifier) {
+    return specifier.startsWith('@')
+        ? specifier.split('/').slice(0, 2).join('/')
+        : (specifier.split('/')[0] ?? specifier);
+}
+/**
+ * DELEGATION DELEGATES THE LIST, TOO (plan §3) — the root whose own manifest
+ * supplies this process' GLOBAL list, or `null` when `$VIBES_HOME` owns it.
+ *
+ * TWO SCOPES REACH HERE, and they are the same shape: a home delegating through
+ * `vibes.hostWorkspace` (`global→hostWorkspace`), and an app BUNDLE whose CLI
+ * resolved `<dirname(realpath(execPath))>/../vibes-home` as R (`bundle`, plan
+ * §2.2 step 2c, added WU-12). In both, R is not `$VIBES_HOME`, R holds the
+ * packages, and R's manifest holds the list the loader actually composed as the
+ * global batch — so reading `$VIBES_HOME/package.json` reports an empty list
+ * for a process that is running nine umbrellas. For the bundle that is not a
+ * cosmetic gap: the user's `$VIBES_HOME` on a packaged-app machine is normally
+ * empty, so `plugins list --global` would have described a CLI that does not
+ * exist.
+ *
+ * When `$VIBES_HOME/package.json#vibes.hostWorkspace` is set the schema forces
+ * the home's own `vibes.plugins` empty (the workspace it delegates to owns the
+ * list) and the loader composes that root's list AS the global batch
+ * (`composition.consumer.ts`: `scope: host.scope === 'global→hostWorkspace' ?
+ * 'global' : 'workspace'`). Reading only `$VIBES_HOME/package.json` therefore
+ * reported `plugins: []` from a delegating home while `resolutions` listed
+ * every one of them `loaded` — the command whose whole job is to say what is
+ * installed said nothing was.
+ *
+ * R comes from the composition report, never re-derived: that is the root THIS
+ * process delegated to, established once by the host (the shim) and captured by the environment, so there is no
+ * second resolver to drift. `hostScope` is the discriminator because
+ * delegation is only IN EFFECT when the graph actually followed it — from
+ * inside a workspace, R is that workspace and the home's `hostWorkspace` key is
+ * inert for this process.
+ *
+ * Suppressed when a selected workspace scope already sits on R: that mirrors
+ * the loader's own `workspaceRoot !== host.root` guard, and reporting the rows
+ * twice would invent a second selection out of one list.
+ */
+export function resolveDelegatedGlobalRoot(report, scopes) {
+    if (report?.hostScope !== 'global→hostWorkspace' && report?.hostScope !== 'bundle') {
+        return null;
+    }
+    const root = report.hostRoot;
+    if (!root)
+        return null;
+    if (scopes.some((scope) => scope.kind === 'workspace' && scope.root === root))
+        return null;
+    return root;
+}
+/**
+ * `vibes plugins list` — what this host composed, and from which roots.
+ *
+ * Reports BOTH roots because they are different concepts with different
+ * readers and a user debugging composition needs to see them disagree:
+ *
+ * - `hostRoot` (R) is the module-graph root the host declared — the
+ *   outermost bun root that materializes `@vibesdotdev/plugins`. It decides
+ *   which framework copy runs.
+ * - `workspaceRoot` is the identity/state root (`findWorkspaceRoot`) that
+ *   anchors PM socket ids, per-workspace `.vibes` state and config discovery.
+ *
+ * From a linked provider checkout they legitimately differ (`hostRoot` = the
+ * developer root that links the member, `workspaceRoot` = the member's own
+ * repository), and nothing derives one from the other.
+ *
+ * Scoping: `--global` / `--workspace`, or `--scope <kind>` — which is the form
+ * `vibes update` spawns when it verifies a scope through the shipping path.
+ * A scope selection narrows the ROWS only; the two roots and the resolution
+ * table describe the PROCESS, not a scope, and are always reported in full.
+ *
+ * Every row carries the composition `status` for its specifier when this host
+ * actually loaded it (`loaded`, `shadowed`, `missing`, `failed`, …), which is
+ * what makes `plugins list --json --scope global` a real verification instead
+ * of an echo of the manifest: `vibes update` requires every row to be `loaded`.
+ * A row this process did not compose reads `not-composed` rather than being
+ * silently omitted or reported as healthy.
+ *
+ * `plugins` IS THE HUMAN-FACING ANSWER, `resolutions` IS THE PROCESS RECORD.
+ * `plugins` is the addressable selection — one row per specifier some list
+ * declares, which is exactly the set `plugins add|remove` and `vibes update`
+ * act on — and the table printed in non-JSON mode is that same array, column
+ * for column, so the two formats cannot report different counts for one
+ * question. `resolutions` additionally carries the executable's own host floor
+ * (the repair kernel, selected by no list and removable by nobody) and the
+ * per-import realpath/linkage a doctor needs. The difference is stated in the
+ * `composed` line rather than left for a reader to discover as a discrepancy.
+ *
+ * The delegated case is the reason both had to be reconciled: from a home with
+ * `vibes.hostWorkspace`, `plugins` used to read `[]` while `resolutions`
+ * reported ten plugins `loaded` — two fields disagreeing about one fact.
+ */
+export default class PluginsListCLICommand extends PluginsCLICommand {
+    constructor(descriptor, context) {
+        super(descriptor, context);
+    }
+    async execute(args, options) {
+        const flags = { ...args, ...options };
+        const requestedScope = ListInputSchema.parse(flags).scope;
+        if (requestedScope && requestedScope !== 'global' && requestedScope !== 'workspace') {
+            throw new Error(`--scope must be 'global' or 'workspace' (got '${requestedScope}')`);
+        }
+        const scopes = await resolveScopes(this.runtime, requestedScope
+            ? { global: requestedScope === 'global', workspace: requestedScope === 'workspace' }
+            : flags, { fallback: 'both' });
+        // A host that composed no scope lists (an app host) retains no report.
+        const report = this.runtime.hasContext(PLUGIN_RESOLUTIONS_CONTEXT_ID)
+            ? await this.runtime.context(PLUGIN_RESOLUTIONS_CONTEXT_ID)
+            : null;
+        const resolutions = new Map((report?.resolutions ?? []).map((row) => [`${row.scope}:${row.specifier}`, row]));
+        const delegatedGlobalRoot = resolveDelegatedGlobalRoot(report, scopes);
+        const rows = [];
+        const shadowed = [];
+        const surfaces = [];
+        const surfacePaths = new Map();
+        const failures = [];
+        const readers = {
+            plugins: await getRuntimePackagePlugins(this.runtime),
+            paths: await getRuntimePath(this.runtime)
+        };
+        for (const scope of scopes) {
+            const read = await this.readScope(readers, scope, delegatedGlobalRoot);
+            for (const entry of read.entries) {
+                surfacePaths.set(`${scope.kind}:${entry.surface}`, entry.surfacePath);
+                rows.push({
+                    scope: scope.kind,
+                    plugin: entry.specifier,
+                    package: entry.packageName,
+                    version: entry.version ?? 'missing',
+                    surface: entry.surface,
+                    status: resolutions.get(`${scope.kind}:${entry.specifier}`)?.status ?? 'not-composed',
+                    reason: resolutions.get(`${scope.kind}:${entry.specifier}`)?.reason
+                });
+            }
+            for (const entry of read.shadowed) {
+                shadowed.push({
+                    scope: scope.kind,
+                    plugin: entry.specifier,
+                    package: entry.packageName,
+                    surface: entry.surface,
+                    surfacePath: entry.surfacePath,
+                    shadowedBy: entry.shadowedBy
+                });
+            }
+            for (const surface of read.surfaces)
+                surfaces.push({ scope: scope.kind, ...surface });
+            for (const failure of read.failures)
+                failures.push({ scope: scope.kind, ...failure });
+        }
+        if (this.format === 'json') {
+            this.ui.json({
+                hostRoot: report?.hostRoot ?? null,
+                hostScope: report?.hostScope ?? null,
+                hostSource: report?.hostSource ?? null,
+                workspaceRoot: report?.workspaceRoot ?? null,
+                scopes: scopes.map((scope) => listedScope(scope, delegatedGlobalRoot)),
+                plugins: rows,
+                // SEPARATE key, deliberately. `vibes update` verifies a scope by
+                // requiring every `plugins[]` row to read `loaded`; a shadowed entry
+                // is by definition not composed, so folding it into that array would
+                // turn a redundant second declaration into a failed update. It is
+                // still REPORTED — the most specific copy wins (C8) with a shadow line — so a
+                // user can see the entries their config overrides.
+                shadowed,
+                surfaces,
+                configFailures: failures,
+                resolutions: report?.resolutions.map(listedResolution) ?? []
+            });
+            return;
+        }
+        if (report) {
+            this.ui.info(`graph root  ${report.hostRoot} [${report.hostScope}]`);
+            this.ui.info(`workspace   ${report.workspaceRoot ?? '(unbound)'}`);
+        }
+        // Prefixed `scope ` so a workspace SCOPE row is not mistaken for the
+        // `workspace` identity root printed above — they are different concepts
+        // that happen to share a name and often share a value.
+        for (const scope of scopes) {
+            const delegation = scope.kind === 'global' && delegatedGlobalRoot
+                ? ` → delegates to ${delegatedGlobalRoot}`
+                : '';
+            this.ui.info(`scope ${scope.kind.padEnd(9)} ${scope.root}${delegation}`);
+        }
+        for (const surface of surfaces) {
+            const path = surfacePaths.get(`${surface.scope}:${surface.surface}`) ?? surface.path;
+            this.ui.info(`list  ${surface.scope.padEnd(9)} ${surface.surface}${surface.effective ? '' : ' (shadowed)'}  ${path}`);
+        }
+        this.ui.table(rows, {
+            columns: ['scope', 'plugin', 'package', 'version', 'surface', 'status']
+        });
+        // `plugins` IS THE ANSWER; `resolutions` IS THE PROCESS. The table is the
+        // same array as the JSON `plugins` key — never `resolutions` — so the two
+        // formats can never report different counts for the same question. The
+        // remainder is stated rather than left as a silent discrepancy: a
+        // resolution with no listed row is the executable's own host floor (the
+        // repair kernel, which no scope list selects and no user can remove), or a
+        // plane the current `--scope` filter excluded.
+        if (report) {
+            const listed = new Set(rows.map((row) => `${row.scope}:${row.plugin}`));
+            const unlisted = report.resolutions.filter((row) => !listed.has(`${row.scope}:${row.specifier}`));
+            this.ui.info(`composed    ${report.resolutions.length} plugin(s) in this process; ${rows.length} declared by the list(s) above` +
+                (unlisted.length
+                    ? `, ${unlisted.length} not from a listed scope: ${unlisted
+                        .map((row) => `${row.id} (${row.scope})`)
+                        .join(', ')}`
+                    : ''));
+        }
+        for (const entry of shadowed) {
+            this.ui.warn(`${entry.plugin} is declared in ${entry.surfacePath} but ${entry.shadowedBy} owns the ` +
+                `${entry.scope} list, so it is NOT composed. Move it into ${entry.shadowedBy} or ` +
+                `remove the ${entry.surface} list.`);
+        }
+        for (const failure of failures) {
+            this.ui.error(`Failed to load ${failure.path}: ${failure.error}`);
+        }
+    }
+    /**
+     * The list a scope root declares, read through the SAME resolution the
+     * bootstrap loader composes from.
+     *
+     * The workspace half used to call `resolveWorkspaceListTarget`, the WRITER's
+     * target resolver, which reports an empty list for a `vibes.config.ts`
+     * because it refuses to rewrite a module. That made this command blind to
+     * plan §3's PRIMARY workspace surface — the one the docs tell users to use —
+     * so a config with a plugin list printed an empty table. It now reads
+     * Runtime's `readWorkspacePluginSurfaces` (`@vibesdotdev/kernel/bootstrap`,
+     * the owner of workspace composition formats) over the handed runtime's
+     * selected `runtime/loader` — the same reader the workspace composition
+     * reads, in the same precedence: `vibes.config.{ts,js,json}#plugins`
+     * primary, `package.json#vibes.plugins` fallback.
+     *
+     * `delegatedGlobalRoot` is R for a home that delegates through
+     * `vibes.hostWorkspace`: the global scope then has no list of its own and the
+     * delegated root's config surfaces ARE the global list (plan §3). Same reader,
+     * same precedence, different root — not a second resolution.
+     */
+    async readScope(readers, scope, delegatedGlobalRoot) {
+        if (scope.kind === 'global' && delegatedGlobalRoot) {
+            return this.readConfigSurfaces(readers.plugins, delegatedGlobalRoot);
+        }
+        if (scope.kind === 'global') {
+            const surface = 'package.json#vibes.plugins';
+            const surfacePath = readers.paths.join(scope.root, 'package.json');
+            const entries = (await readers.plugins.listGlobalPlugins(scope.root)).map((entry) => ({
+                specifier: entry.specifier,
+                packageName: entry.packageName,
+                version: entry.version,
+                surface,
+                surfacePath
+            }));
+            return {
+                entries,
+                shadowed: [],
+                surfaces: entries.length
+                    ? [{ surface, path: surfacePath, effective: true, plugins: entries.length, loaders: 0 }]
+                    : [],
+                failures: []
+            };
+        }
+        return this.readConfigSurfaces(readers.plugins, scope.root);
+    }
+    /**
+     * `<root>/vibes.config.{ts,js,json}#plugins`, else
+     * `<root>/package.json#vibes.plugins` — one root, read once, shadowing
+     * reported. Both the workspace scope and a delegating global scope resolve
+     * their list this way; the only difference is which root they point at.
+     */
+    async readConfigSurfaces(plugins, root) {
+        const loader = await this.runtime
+            .query('runtime/loader')
+            .enabled()
+            .resolve();
+        const listing = await readWorkspacePluginSurfaces(root, { loader });
+        const versioned = (row) => {
+            const packageName = packageNameOf(row.specifier);
+            return {
+                specifier: row.specifier,
+                packageName,
+                version: plugins.readDirectInstalledPackageManifest(root, packageName)?.version ?? null,
+                surface: row.surface,
+                surfacePath: row.surfacePath
+            };
+        };
+        const all = workspacePluginRows(listing);
+        const effectiveSurface = listing.effective?.surface ?? null;
+        return {
+            entries: all.filter((row) => row.effective).map(versioned),
+            shadowed: all
+                .filter((row) => !row.effective)
+                .map((row) => ({ ...versioned(row), shadowedBy: effectiveSurface ?? '(none)' })),
+            surfaces: listing.surfaces.map((surface) => ({
+                surface: surface.surface,
+                path: surface.path,
+                effective: surface.effective,
+                plugins: surface.plugins.length,
+                loaders: surface.loaders
+            })),
+            failures: listing.failures.map((failure) => ({
+                path: failure.path,
+                error: failure.error instanceof Error ? failure.error.message : String(failure.error)
+            }))
+        };
+    }
+}
+//# sourceMappingURL=plugins.list.cli-command.impl.consumer.js.map

package/dist/cli/plugins.list.cli-command.impl.consumer.js.map

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

package/dist/cli/plugins.remove.cli-command.descriptor.d.ts

@@ -0,0 +1,31 @@
+declare const _default: {
+    readonly id: "plugins.remove";
+    readonly kind: "cli/command";
+    readonly name: "remove";
+    readonly description: "Disable a package plugin in a scope and remove its package when unused";
+    readonly group: "plugins";
+    readonly surfaces: ["cli"];
+    readonly hardware: ["consumer"];
+    readonly requiredContext: ["cli/ui", "cli/output-format"];
+    readonly effects: {
+        readonly homeWrite: "required";
+    };
+    readonly arguments: [{
+        readonly name: "plugin";
+        readonly description: "Enabled plugin export or package name";
+        readonly required: true;
+        readonly variadic: false;
+    }];
+    readonly options: [{
+        readonly flags: "--keep-package";
+        readonly description: "Disable the plugin without uninstalling its package";
+    }, {
+        readonly flags: "--global";
+        readonly description: "Act on the global scope ($VIBES_HOME) — the default";
+    }, {
+        readonly flags: "--workspace";
+        readonly description: "Act on the current workspace scope";
+    }];
+};
+export default _default;
+//# sourceMappingURL=plugins.remove.cli-command.descriptor.d.ts.map

package/dist/cli/plugins.remove.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.remove.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/plugins.remove.cli-command.descriptor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAuBG"}

package/dist/cli/plugins.remove.cli-command.descriptor.js

@@ -0,0 +1,26 @@
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    id: 'plugins.remove',
+    kind: 'cli/command',
+    name: 'remove',
+    description: 'Disable a package plugin in a scope and remove its package when unused',
+    group: 'plugins',
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    requiredContext: ['cli/ui', 'cli/output-format'],
+    effects: { homeWrite: 'required' },
+    arguments: [
+        {
+            name: 'plugin',
+            description: 'Enabled plugin export or package name',
+            required: true,
+            variadic: false
+        }
+    ],
+    options: [
+        { flags: '--keep-package', description: 'Disable the plugin without uninstalling its package' },
+        { flags: '--global', description: 'Act on the global scope ($VIBES_HOME) — the default' },
+        { flags: '--workspace', description: 'Act on the current workspace scope' }
+    ]
+});
+//# sourceMappingURL=plugins.remove.cli-command.descriptor.js.map

package/dist/cli/plugins.remove.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.remove.cli-command.descriptor.js","sourceRoot":"","sources":["../../src/cli/plugins.remove.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,wEAAwE;IACrF,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,eAAe,EAAE,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IAChD,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;IAClC,SAAS,EAAE;QACV;YACC,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,uCAAuC;YACpD,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,KAAK;SACf;KACD;IACD,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,qDAAqD,EAAE;QAC/F,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,qDAAqD,EAAE;QACzF,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,oCAAoC,EAAE;KAC3E;CACD,CAAC,CAAC"}

package/dist/cli/plugins.remove.cli-command.impl.consumer.d.ts

@@ -0,0 +1,30 @@
+import type { CommandExecutionStartInfo } from '@vibesdotdev/cli/schemas/surface';
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/cli/schemas/types';
+import { type RuntimePackagePlugins } from '@vibesdotdev/kernel';
+import { PluginsCLICommand, type PluginsCLIContext } from './context.ts';
+import type { SelectedScope } from './schemas/scopes.ts';
+/**
+ * `vibes plugins remove <plugin> [--global|--workspace] [--keep-package]`.
+ *
+ * Disable first, undeclare second, and only when nothing else in the scope
+ * still selects the package. Undeclaring is symmetric with `add`, which is what
+ * wrote the dependency; leaving a dangling `workspace:*` behind would make the
+ * next `bun install` keep linking a provider nothing selects.
+ *
+ * What is NEVER touched is the provider CHECKOUT: a linked member lives in a
+ * directory the user owns, so removal drops the declaration and re-installs the
+ * scope, and the reported line says the path is still linked.
+ * `vibes plugins unlink <glob>` is the command that stops linking it.
+ */
+export default class PluginsRemoveCLICommand extends PluginsCLICommand {
+    constructor(descriptor: CLICommandAssetDescriptor, context: PluginsCLIContext);
+    execute(args: CommandExecutionStartInfo['args'], options: CommandExecutionStartInfo['options']): Promise<void>;
+}
+/**
+ * Disable `selection` in `scope`, and say whether the scope still selects the
+ * package it names. Both scopes compare package names (the capability's
+ * `getPackageName`), never specifier prefixes: `@a/bc/plugin` does not keep
+ * `@a/b` selected, so removing `@a/b/plugin` still undeclares `@a/b`.
+ */
+export declare function disableSelection(plugins: RuntimePackagePlugins, scope: SelectedScope, selection: string): ReturnType<RuntimePackagePlugins['disableGlobalPlugin']>;
+//# sourceMappingURL=plugins.remove.cli-command.impl.consumer.d.ts.map

package/dist/cli/plugins.remove.cli-command.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.remove.cli-command.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/cli/plugins.remove.cli-command.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAA4B,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQzD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,iBAAiB;gBACzD,UAAU,EAAE,yBAAyB,EAAE,OAAO,EAAE,iBAAiB;IAIvE,OAAO,CAAC,IAAI,EAAE,yBAAyB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,yBAAyB,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAmCpH;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GACf,UAAU,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,CAAC,CAS1D"}

package/dist/cli/plugins.remove.cli-command.impl.consumer.js

@@ -0,0 +1,80 @@
+import { getRuntimePackagePlugins } from '@vibesdotdev/kernel';
+import { z } from 'zod/v4';
+import { PluginsCLICommand } from "./context.js";
+import { runBunOrThrow } from "./package-manager.consumer.js";
+import { resolveSingleScope } from "./scopes.js";
+/** The command's inputs, each read on its own: a missing or non-text plugin is empty, a missing flag is off. */
+const RemoveInputSchema = z.object({
+    plugin: z.string().trim().catch(''),
+    keepPackage: z.boolean().catch(false)
+});
+/**
+ * `vibes plugins remove <plugin> [--global|--workspace] [--keep-package]`.
+ *
+ * Disable first, undeclare second, and only when nothing else in the scope
+ * still selects the package. Undeclaring is symmetric with `add`, which is what
+ * wrote the dependency; leaving a dangling `workspace:*` behind would make the
+ * next `bun install` keep linking a provider nothing selects.
+ *
+ * What is NEVER touched is the provider CHECKOUT: a linked member lives in a
+ * directory the user owns, so removal drops the declaration and re-installs the
+ * scope, and the reported line says the path is still linked.
+ * `vibes plugins unlink <glob>` is the command that stops linking it.
+ */
+export default class PluginsRemoveCLICommand extends PluginsCLICommand {
+    constructor(descriptor, context) {
+        super(descriptor, context);
+    }
+    async execute(args, options) {
+        const flags = { ...args, ...options };
+        const input = RemoveInputSchema.parse({ ...flags, plugin: args.plugin });
+        const selection = input.plugin;
+        if (!selection)
+            throw new Error('plugins remove requires a plugin export or package name');
+        const scope = await resolveSingleScope(this.runtime, flags, { fallback: 'global' });
+        const plugins = await getRuntimePackagePlugins(this.runtime);
+        const disabled = await disableSelection(plugins, scope, selection);
+        if (disabled.removed.length === 0) {
+            throw new Error(`${scope.kind} plugin '${selection}' is not enabled`);
+        }
+        const linked = plugins.expandWorkspaceMembers(scope.root).has(disabled.packageName);
+        let uninstalled = false;
+        if (!input.keepPackage && !disabled.packageStillSelected) {
+            await plugins.undeclareGlobalDependency(scope.root, disabled.packageName);
+            await runBunOrThrow({ runtime: this.runtime, action: 'install', cwd: scope.root });
+            uninstalled = true;
+        }
+        if (this.format === 'json') {
+            this.ui.json({
+                scope: scope.kind,
+                root: scope.root,
+                removed: disabled.removed,
+                package: disabled.packageName,
+                uninstalled,
+                linked
+            });
+            return;
+        }
+        this.ui.success(`Disabled ${disabled.removed.join(', ')} in the ${scope.kind} scope (${scope.root})` +
+            (uninstalled ? ` and undeclared ${disabled.packageName}` : '') +
+            (linked ? ` — its provider path is still linked (vibes plugins unlink <glob>)` : ''));
+    }
+}
+/**
+ * Disable `selection` in `scope`, and say whether the scope still selects the
+ * package it names. Both scopes compare package names (the capability's
+ * `getPackageName`), never specifier prefixes: `@a/bc/plugin` does not keep
+ * `@a/b` selected, so removing `@a/b/plugin` still undeclares `@a/b`.
+ */
+export async function disableSelection(plugins, scope, selection) {
+    if (scope.kind === 'global')
+        return plugins.disableGlobalPlugin(scope.root, selection);
+    const result = await plugins.disableWorkspacePlugin(scope.root, selection);
+    const packageName = plugins.getPackageName(selection);
+    return {
+        removed: result.removed,
+        packageName,
+        packageStillSelected: result.plugins.some((specifier) => plugins.getPackageName(specifier) === packageName)
+    };
+}
+//# sourceMappingURL=plugins.remove.cli-command.impl.consumer.js.map

package/dist/cli/plugins.remove.cli-command.impl.consumer.js.map

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

package/dist/cli/plugins.unlink.cli-command.descriptor.d.ts

@@ -0,0 +1,31 @@
+declare const _default: {
+    readonly id: "plugins.unlink";
+    readonly kind: "cli/command";
+    readonly name: "unlink";
+    readonly description: "Remove a provider path glob from a scope";
+    readonly group: "plugins";
+    readonly surfaces: ["cli"];
+    readonly hardware: ["consumer"];
+    readonly requiredContext: ["cli/ui", "cli/output-format"];
+    readonly effects: {
+        readonly homeWrite: "required";
+    };
+    readonly arguments: [{
+        readonly name: "glob";
+        readonly description: "Exact glob to remove";
+        readonly required: true;
+        readonly variadic: false;
+    }];
+    readonly options: [{
+        readonly flags: "--global";
+        readonly description: "Act on the global scope ($VIBES_HOME)";
+    }, {
+        readonly flags: "--workspace";
+        readonly description: "Act on the current workspace scope";
+    }, {
+        readonly flags: "--dry-run";
+        readonly description: "Report what would be removed without writing";
+    }];
+};
+export default _default;
+//# sourceMappingURL=plugins.unlink.cli-command.descriptor.d.ts.map

package/dist/cli/plugins.unlink.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.unlink.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/plugins.unlink.cli-command.descriptor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAkBG"}

package/dist/cli/plugins.unlink.cli-command.descriptor.js

@@ -0,0 +1,21 @@
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    id: 'plugins.unlink',
+    kind: 'cli/command',
+    name: 'unlink',
+    description: 'Remove a provider path glob from a scope',
+    group: 'plugins',
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    requiredContext: ['cli/ui', 'cli/output-format'],
+    effects: { homeWrite: 'required' },
+    arguments: [
+        { name: 'glob', description: 'Exact glob to remove', required: true, variadic: false }
+    ],
+    options: [
+        { flags: '--global', description: 'Act on the global scope ($VIBES_HOME)' },
+        { flags: '--workspace', description: 'Act on the current workspace scope' },
+        { flags: '--dry-run', description: 'Report what would be removed without writing' }
+    ]
+});
+//# sourceMappingURL=plugins.unlink.cli-command.descriptor.js.map

package/dist/cli/plugins.unlink.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.unlink.cli-command.descriptor.js","sourceRoot":"","sources":["../../src/cli/plugins.unlink.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,0CAA0C;IACvD,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,eAAe,EAAE,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IAChD,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;IAClC,SAAS,EAAE;QACV,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;KACtF;IACD,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,uCAAuC,EAAE;QAC3E,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,oCAAoC,EAAE;QAC3E,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,8CAA8C,EAAE;KACnF;CACD,CAAC,CAAC"}