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

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

@@ -0,0 +1,31 @@
+import type { CommandExecutionStartInfo } from '@vibesdotdev/cli/schemas/surface';
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/cli/schemas/types';
+import { PluginsCLICommand, type PluginsCLIContext } from './context.ts';
+/**
+ * `vibes plugins link <glob>` — Drew's requirement 2, implemented with the one
+ * mechanism bun actually has for path linking.
+ *
+ * A glob is written to `package.json#workspaces` and `bun install` does the
+ * rest. No custom link command, no hand-made symlink, no `file:` redirect
+ * (which copies) and no `link:` (which is a name in a global registry, not a
+ * path) — AGENTS.md forbids all three and P6 measured why: bun-native
+ * `workspaces` is the only path-glob link mechanism that exists.
+ *
+ * Two refusals, both loud, both before anything is written:
+ *
+ * - **A glob whose static parent is missing** cannot link anything, and a
+ *   manifest carrying one makes every later `bun install` in that scope a
+ *   guessing game.
+ * - **A glob whose members are already owned by another bun root.** This is
+ *   the single-owner rule (plan §4). Co-ownership of a member farm is the only
+ *   measured route to two `@vibesdotdev/kernel` copies in one process, and it
+ *   surfaces later as a fatal `PluginGraphMismatch` at plugin-load time — a far
+ *   worse moment than now. The refusal names the owning root and the remedy
+ *   (`vibes plugins host --global <owner>`).
+ */
+export default class PluginsLinkCLICommand extends PluginsCLICommand {
+    constructor(descriptor: CLICommandAssetDescriptor, context: PluginsCLIContext);
+    execute(args: CommandExecutionStartInfo['args'], options: CommandExecutionStartInfo['options']): Promise<void>;
+    private report;
+}
+//# sourceMappingURL=plugins.link.cli-command.impl.consumer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.link.cli-command.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/cli/plugins.link.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;AAKhF,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,iBAAiB;gBACvD,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;IA8DpH,OAAO,CAAC,MAAM;CAkBd"}

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

@@ -0,0 +1,104 @@
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem/client/resolve-adapter';
+import { getRuntimePath } from '@vibesdotdev/paths';
+import { getRuntimePackagePlugins, requireRuntimeCwd } 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";
+import { seedGlobalScope, workspaceGlobParent } from "./seed.js";
+/** The command's inputs, each read on its own: a missing or non-text glob is empty, a missing flag is off. */
+const LinkInputSchema = z.object({
+    glob: z.string().trim().catch(''),
+    dryRun: z.boolean().catch(false)
+});
+/**
+ * `vibes plugins link <glob>` — Drew's requirement 2, implemented with the one
+ * mechanism bun actually has for path linking.
+ *
+ * A glob is written to `package.json#workspaces` and `bun install` does the
+ * rest. No custom link command, no hand-made symlink, no `file:` redirect
+ * (which copies) and no `link:` (which is a name in a global registry, not a
+ * path) — AGENTS.md forbids all three and P6 measured why: bun-native
+ * `workspaces` is the only path-glob link mechanism that exists.
+ *
+ * Two refusals, both loud, both before anything is written:
+ *
+ * - **A glob whose static parent is missing** cannot link anything, and a
+ *   manifest carrying one makes every later `bun install` in that scope a
+ *   guessing game.
+ * - **A glob whose members are already owned by another bun root.** This is
+ *   the single-owner rule (plan §4). Co-ownership of a member farm is the only
+ *   measured route to two `@vibesdotdev/kernel` copies in one process, and it
+ *   surfaces later as a fatal `PluginGraphMismatch` at plugin-load time — a far
+ *   worse moment than now. The refusal names the owning root and the remedy
+ *   (`vibes plugins host --global <owner>`).
+ */
+export default class PluginsLinkCLICommand extends PluginsCLICommand {
+    constructor(descriptor, context) {
+        super(descriptor, context);
+    }
+    async execute(args, options) {
+        const flags = { ...args, ...options };
+        const input = LinkInputSchema.parse({ ...flags, glob: args.glob });
+        const raw = input.glob;
+        if (!raw)
+            throw new Error('plugins link requires a path glob');
+        const scope = await resolveSingleScope(this.runtime, flags, { fallback: 'global' });
+        const paths = await getRuntimePath(this.runtime);
+        // Global link globs are absolute by contract ($VIBES_HOME has no tree of
+        // its own); workspace globs stay in-tree and relative, which is what bun
+        // and every existing root manifest already use.
+        const glob = scope.kind === 'global'
+            ? paths.isAbsolute(raw)
+                ? raw
+                : paths.resolve(requireRuntimeCwd(this.runtime), raw)
+            : paths.isAbsolute(raw)
+                ? paths.relative(scope.root, raw)
+                : raw;
+        if (scope.kind === 'workspace' && (glob.startsWith('..') || paths.isAbsolute(glob))) {
+            throw new Error(`'${raw}' is outside ${scope.root}. A workspace link glob must stay in-tree; ` +
+                'use --global for a provider path elsewhere on the machine.');
+        }
+        const parent = workspaceGlobParent(paths, glob, scope.root);
+        const filesystem = await resolveFileSystemAdapter(this.runtime, { binding: false });
+        if (!(await filesystem.exists(parent))) {
+            throw new Error(`workspaces glob '${glob}' has no static parent on disk (${parent}). ` +
+                'Create the directory or fix the glob before linking it.');
+        }
+        const plugins = await getRuntimePackagePlugins(this.runtime);
+        const ownership = plugins.describeGlobOwnership(scope.root, glob);
+        if (ownership.owner)
+            throw new Error(plugins.formatGlobOwnershipRefusal(ownership));
+        const members = [...ownership.members.keys()].sort();
+        if (input.dryRun) {
+            this.report(plugins, {
+                scope: scope.kind,
+                root: scope.root,
+                glob,
+                members,
+                linked: false,
+                dryRun: true
+            });
+            return;
+        }
+        if (scope.kind === 'global')
+            await seedGlobalScope(this.runtime, { home: scope.root });
+        const added = await plugins.addWorkspaceGlob(scope.root, glob, () => ({
+            name: scope.kind === 'global' ? 'vibes-global' : 'vibes-workspace',
+            private: true,
+            vibes: { plugins: [] }
+        }));
+        await runBunOrThrow({ runtime: this.runtime, action: 'install', cwd: scope.root });
+        this.report(plugins, { scope: scope.kind, root: scope.root, glob, members, linked: added });
+    }
+    report(plugins, payload) {
+        if (this.format === 'json') {
+            this.ui.json({ ...payload, globs: plugins.readWorkspaceGlobs(payload.root) });
+            return;
+        }
+        const verb = payload.dryRun ? 'Would link' : payload.linked ? 'Linked' : 'Already linked';
+        this.ui.success(`${verb} ${payload.glob} into the ${payload.scope} scope (${payload.root}) — ` +
+            `${payload.members.length} member(s): ${payload.members.join(', ') || 'none yet'}`);
+    }
+}
+//# sourceMappingURL=plugins.link.cli-command.impl.consumer.js.map

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

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

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

@@ -0,0 +1,26 @@
+declare const _default: {
+    readonly id: "plugins.list";
+    readonly kind: "cli/command";
+    readonly name: "list";
+    readonly description: "List enabled package plugin exports, their versions and their composition status";
+    readonly group: "plugins";
+    readonly surfaces: ["cli"];
+    readonly hardware: ["consumer"];
+    readonly requiredContext: ["cli/ui", "cli/output-format"];
+    readonly effects: {
+        readonly homeWrite: "none";
+    };
+    readonly options: [{
+        readonly flags: "--global";
+        readonly description: "List the global scope ($VIBES_HOME) only";
+    }, {
+        readonly flags: "--workspace";
+        readonly description: "List the current workspace scope only";
+    }, {
+        readonly flags: "--scope <kind>";
+        readonly description: "Scope to list: global | workspace";
+        readonly choices: ["global", "workspace"];
+    }];
+};
+export default _default;
+//# sourceMappingURL=plugins.list.cli-command.descriptor.d.ts.map

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

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

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

@@ -0,0 +1,22 @@
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    id: 'plugins.list',
+    kind: 'cli/command',
+    name: 'list',
+    description: 'List enabled package plugin exports, their versions and their composition status',
+    group: 'plugins',
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    requiredContext: ['cli/ui', 'cli/output-format'],
+    effects: { homeWrite: 'none' },
+    options: [
+        { flags: '--global', description: 'List the global scope ($VIBES_HOME) only' },
+        { flags: '--workspace', description: 'List the current workspace scope only' },
+        {
+            flags: '--scope <kind>',
+            description: 'Scope to list: global | workspace',
+            choices: ['global', 'workspace']
+        }
+    ]
+});
+//# sourceMappingURL=plugins.list.cli-command.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.list.cli-command.descriptor.js","sourceRoot":"","sources":["../../src/cli/plugins.list.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,kFAAkF;IAC/F,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,MAAM,EAAE;IAC9B,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,0CAA0C,EAAE;QAC9E,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,uCAAuC,EAAE;QAC9E;YACC,KAAK,EAAE,gBAAgB;YACvB,WAAW,EAAE,mCAAmC;YAChD,OAAO,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;SAChC;KACD;CACD,CAAC,CAAC"}

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

@@ -0,0 +1,116 @@
+import type { CommandExecutionStartInfo } from '@vibesdotdev/cli/schemas/surface';
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/cli/schemas/types';
+import type { PluginCompositionReport } from '@vibesdotdev/kernel/schemas/package-plugins';
+import { PluginsCLICommand, type PluginsCLIContext } from './context.ts';
+import type { SelectedScope } from './schemas/scopes.ts';
+/**
+ * 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 declare function resolveDelegatedGlobalRoot(report: Pick<PluginCompositionReport, 'hostRoot' | 'hostScope'> | null, scopes: ReadonlyArray<Pick<SelectedScope, 'kind' | 'root'>>): string | null;
+/**
+ * `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: CLICommandAssetDescriptor, context: PluginsCLIContext);
+    execute(args: CommandExecutionStartInfo['args'], options: CommandExecutionStartInfo['options']): Promise<void>;
+    /**
+     * 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.
+     */
+    private readScope;
+    /**
+     * `<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.
+     */
+    private readConfigSurfaces;
+}
+//# sourceMappingURL=plugins.list.cli-command.impl.consumer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.list.cli-command.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/cli/plugins.list.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;AAGhF,OAAO,KAAK,EAAE,uBAAuB,EAAoB,MAAM,6CAA6C,CAAC;AAS7G,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmF1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,GAAG,WAAW,CAAC,GAAG,IAAI,EACtE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GACzD,MAAM,GAAG,IAAI,CAQf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,iBAAiB;gBACvD,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;IAiKpH;;;;;;;;;;;;;;;;;;;OAmBG;YACW,SAAS;IA8BvB;;;;;OAKG;YACW,kBAAkB;CAoChC"}