@vibesdotdev/cli 0.0.2 → 1.0.0-rc.2

package/dist/commands/cli.kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.kinds.d.ts","sourceRoot":"","sources":["../../src/commands/cli.kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAGN,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAA+B,KAAK,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAW/G,qBAAa,6BAA6B;aACb,UAAU,EAAE,uBAAuB;gBAAnC,UAAU,EAAE,uBAAuB;CAC/D;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAMC,iBAAiB;iCAFpB,uBAAuB;;;0BAWvB,iBAAiB,EAAE,SAAS,YAAY;;CAyBO,CAAC;AAavE,qBAAa,+BAA+B;IAC3C,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;gBAEnC,UAAU,EAAE,iBAAiB;IAOnC,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrG;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAIK,qBAAqB,KAAG,OAAO;0BAIxC,iBAAiB,EAAE,SAAS,YAAY;;CA0BD,CAAC;AAE/D;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,6CAKzB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/commands/cli.kinds.js

@@ -0,0 +1,138 @@
+/**
+ * CLI kinds - pure metadata registration, decoupled from the CLI surface impl.
+ *
+ * `cli/group` and `cli/command` are metadata kinds (zod schema + a fail-loud
+ * default implementation). Nothing here imports a command impl, Commander, or
+ * any Node/Bun API - so this module is safe to register in ANY runtime scope
+ * (cloud, browser, worker) purely to make CLI descriptors enumerable
+ * cross-scope (`runtime.query('cli/command').descriptors()`), without importing
+ * a single command implementation.
+ *
+ * The full CLI surface (`cli.plugin`) re-uses these kind records and adds the
+ * command descriptors + lazy impl loaders. A non-CLI scope that only wants to
+ * LIST commands registers `cliKindsPlugin` instead - see
+ * `@vibesdotdev/tools/cli/descriptors/plugin`.
+ */
+import { cliPatternKind } from "../patterns/pattern.kinds.js";
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import { CLIGroupDescriptorSchema, CLICommandDescriptorSchema } from "../schemas/descriptors.js";
+import { CommandImplementationSchema } from "../schemas/command-implementation.js";
+/**
+ * CLI Group kind - metadata only, no implementation needed
+ */
+function isCLIGroupAssetDescriptor(descriptor) {
+    return descriptor.kind === 'cli/group' && typeof descriptor.id === 'string';
+}
+export class DefaultCLIGroupImplementation {
+    descriptor;
+    constructor(descriptor) {
+        this.descriptor = descriptor;
+    }
+}
+export const cliGroupKind = {
+    id: 'cli/group',
+    descriptorSchema: CLIGroupDescriptorSchema,
+    defaultImplementation: class {
+        descriptor;
+        constructor(descriptor) {
+            if (!isCLIGroupAssetDescriptor(descriptor)) {
+                throw new Error(`Invalid cli/group descriptor '${descriptor.id ?? 'unknown'}'`);
+            }
+            this.descriptor = descriptor;
+        }
+    },
+    // Resolution: prefer explicit scope matches
+    resolve: (candidates, scope) => {
+        const descriptors = candidates.filter(isCLIGroupAssetDescriptor);
+        if (descriptors.length === 0)
+            return undefined;
+        if (descriptors.length === 1)
+            return descriptors[0];
+        // Filter by surface
+        let matches = descriptors.filter((d) => {
+            if (!d.surfaces || d.surfaces.length === 0)
+                return true;
+            return d.surfaces.some((surface) => surface === scope.surface);
+        });
+        if (matches.length === 0)
+            return undefined;
+        // Filter by hardware
+        matches = matches.filter((d) => {
+            if (!d.hardware || d.hardware.length === 0)
+                return true;
+            return d.hardware.includes(scope.hardware);
+        });
+        // Sort by order, return first
+        matches.sort((a, b) => (a.order ?? 999) - (b.order ?? 999));
+        return matches[0];
+    },
+    contexts: []
+};
+/**
+ * CLI Command kind - requires implementation with execute()
+ */
+function isCLICommandAssetDescriptor(descriptor) {
+    return (descriptor.kind === 'cli/command' && typeof descriptor.id === 'string' && 'group' in descriptor);
+}
+export class DefaultCLICommandImplementation {
+    descriptor;
+    constructor(descriptor) {
+        if (!isCLICommandAssetDescriptor(descriptor)) {
+            throw new Error(`Invalid cli/command descriptor '${descriptor.id ?? 'unknown'}'`);
+        }
+        this.descriptor = descriptor;
+    }
+    async execute(_args, _opts, _context) {
+        throw new Error(`No implementation for command: ${this.descriptor.id}`);
+    }
+}
+export const cliCommandKind = {
+    id: 'cli/command',
+    descriptorSchema: CLICommandDescriptorSchema,
+    defaultImplementation: DefaultCLICommandImplementation,
+    validateImplementation: (impl) => CommandImplementationSchema.safeParse(impl).success,
+    // Resolution: prefer explicit scope matches
+    resolve: (candidates, scope) => {
+        const descriptors = candidates.filter(isCLICommandAssetDescriptor);
+        if (descriptors.length === 0)
+            return undefined;
+        if (descriptors.length === 1)
+            return descriptors[0];
+        // Filter by surface
+        let matches = descriptors.filter((d) => {
+            if (!d.surfaces || d.surfaces.length === 0)
+                return true;
+            return d.surfaces.some((surface) => surface === scope.surface);
+        });
+        if (matches.length === 0)
+            return undefined;
+        // Filter by hardware
+        matches = matches.filter((d) => {
+            if (!d.hardware || d.hardware.length === 0)
+                return true;
+            return d.hardware.includes(scope.hardware);
+        });
+        // Sort by order, return first
+        matches.sort((a, b) => (a.order ?? 999) - (b.order ?? 999));
+        return matches[0];
+    },
+    // Commands receive runtime context
+    contexts: ['runtime']
+};
+/**
+ * Kinds-only plugin. Registers `cli/group`, `cli/command` and `cli/pattern` with NO command
+ * descriptors and NO impl loaders - so a non-CLI scope can register CLI
+ * descriptors (via a separate descriptor plugin) and enumerate them without
+ * pulling the CLI surface or any command implementation into its bundle.
+ *
+ * The CLI surface (`cli.plugin`) declares these kinds directly; do NOT compose
+ * both in the same runtime or `registerKind` will see a duplicate.
+ */
+export const cliKindsPlugin = createRuntimePlugin({
+    id: 'cli-kinds',
+    name: 'CLI Kinds',
+    description: 'CLI group, command and pattern kinds (metadata only, no loaders)',
+    kinds: [cliGroupKind, cliCommandKind, cliPatternKind]
+});
+export default cliKindsPlugin;
+//# sourceMappingURL=cli.kinds.js.map

package/dist/commands/cli.kinds.js.map

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

package/dist/commands/cli.plugin.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI Plugin
+ *
+ * Registers CLI kinds with the universal runtime:
+ * - cli/group: Command groups for organizing commands
+ * - cli/command: Executable CLI commands
+ *
+ * This plugin does NOT create a separate runtime - it extends the universal
+ * runtime with CLI-specific asset kinds that CLISurface uses to build
+ * the Commander.js command tree.
+ */
+export { DefaultCLICommandImplementation } from './cli.kinds.ts';
+/**
+ * CLI Plugin
+ *
+ * Registers cli/group and cli/command kinds (imported from ./cli.kinds) with the
+ * universal runtime, plus the CLI command descriptors and their lazy impl
+ * loaders. CLISurface queries these kinds to build the Commander.js command tree.
+ */
+declare const defaultExport: import("@vibesdotdev/kernel").RuntimePlugin;
+export default defaultExport;
+//# sourceMappingURL=cli.plugin.d.ts.map

package/dist/commands/cli.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.plugin.d.ts","sourceRoot":"","sources":["../../src/commands/cli.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AA8BjE;;;;;;GAMG;AAEH,QAAA,MAAM,aAAa,6CAqFjB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/commands/cli.plugin.js

@@ -0,0 +1,138 @@
+/**
+ * CLI Plugin
+ *
+ * Registers CLI kinds with the universal runtime:
+ * - cli/group: Command groups for organizing commands
+ * - cli/command: Executable CLI commands
+ *
+ * This plugin does NOT create a separate runtime - it extends the universal
+ * runtime with CLI-specific asset kinds that CLISurface uses to build
+ * the Commander.js command tree.
+ */
+import { CapabilityError, createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+// cli/group + cli/command kind records - defined in a pure, impl-free module so
+// non-CLI scopes can register them for cross-scope descriptor enumeration.
+import { cliGroupKind, cliCommandKind } from "./cli.kinds.js";
+// Re-exported for `surface/register-commands.ts`, which detects unregistered
+// commands via `impl instanceof DefaultCLICommandImplementation`.
+export { DefaultCLICommandImplementation } from "./cli.kinds.js";
+import { cliPatternKind } from "../patterns/pattern.kinds.js";
+// CLI command descriptors
+import completionConsumerPlugin from "./completion/completion.consumer.plugin.js";
+import completionCommandDescriptor from "./completion/completion.descriptor.js";
+import { cliOutputFormatPlugin } from "../support/ui/format.plugin.js";
+import { runtimeCodegenCommandDescriptor } from "./runtime/codegen.command.descriptor.js";
+import { runtimeExportCommandDescriptor } from "./runtime/export.descriptor.js";
+import uiContextDescriptor from "../support/ui/context.descriptor.js";
+import cliStartupLogger from "../support/logging/cli-startup.logger.descriptor.js";
+import runtimeGroup from "./runtime/runtime-group.descriptor.js";
+import { runtimeCodegenInputDescriptor } from "../schemas/runtime-codegen.js";
+// Profile descriptors
+import profileGroupDescriptor from "./profile/profile-group.descriptor.js";
+import profileListDescriptor from "./profile/profile.list.descriptor.js";
+import profileCreateDescriptor from "./profile/profile.create.descriptor.js";
+import profileUseDescriptor from "./profile/profile.use.descriptor.js";
+import profileDeleteDescriptor from "./profile/profile.delete.descriptor.js";
+import profileInfoDescriptor from "./profile/profile.info.descriptor.js";
+import profileEnvironmentDescriptor from "./profile/profile.environment.descriptor.js";
+// Docs
+import cliDescriptor from "./docs/cli.docs.descriptor.js";
+import cliCommandsDescriptor from "./docs/cli.commands.docs.descriptor.js";
+import cliGroupsDescriptor from "./docs/cli.groups.docs.descriptor.js";
+import cliOutputDescriptor from "./docs/cli.output.docs.descriptor.js";
+/**
+ * CLI Plugin
+ *
+ * Registers cli/group and cli/command kinds (imported from ./cli.kinds) with the
+ * universal runtime, plus the CLI command descriptors and their lazy impl
+ * loaders. CLISurface queries these kinds to build the Commander.js command tree.
+ */
+// Hoisted const: tsc rewriteRelativeImportExtensions does not rewrite `.ts` specifiers inside `export default <expr>` (TS 6.0.3).
+const defaultExport = createRuntimePlugin({
+    id: 'cli',
+    name: 'CLI Surface',
+    description: 'CLI command system using Commander.js',
+    dependencies: ['context'],
+    kinds: [cliGroupKind, cliCommandKind, cliPatternKind],
+    async onRegister(runtime) {
+        if (!runtime.hasPlugin('cli-shell-completions')) {
+            await runtime.registerPlugin(completionConsumerPlugin);
+        }
+        if (!runtime.hasPlugin('cli-output-formats')) {
+            await runtime.registerPlugin(cliOutputFormatPlugin);
+        }
+        // `workspace/static-loader` is not composed here. The host composes the
+        // generator owner (`@vibesdotdev/workspace/static-loader/plugin`); this
+        // plugin registers no Workspace plugin and imports no Workspace module, so
+        // CLI carries no production edge back to Workspace. `runtime codegen`
+        // resolves the kind at call time and refuses when the host composed none.
+    },
+    descriptors: [
+        runtimeCodegenInputDescriptor,
+        { kind: 'cli/pattern', id: 'crud' },
+        { kind: 'cli/pattern', id: 'tool-wrapper' },
+        { kind: 'cli/pattern', id: 'log-viewer' },
+        { kind: 'cli/pattern', id: 'process-manager' },
+        { kind: 'cli/pattern', id: 'config-namespace' },
+        runtimeCodegenCommandDescriptor,
+        runtimeExportCommandDescriptor,
+        completionCommandDescriptor,
+        uiContextDescriptor,
+        cliStartupLogger,
+        runtimeGroup,
+        profileGroupDescriptor,
+        profileListDescriptor,
+        profileCreateDescriptor,
+        profileUseDescriptor,
+        profileDeleteDescriptor,
+        profileInfoDescriptor,
+        profileEnvironmentDescriptor,
+        cliDescriptor,
+        cliCommandsDescriptor,
+        cliGroupsDescriptor,
+        cliOutputDescriptor
+    ],
+    loaders: [
+        loader('crud', { kind: 'cli/pattern' }, async (runtime) => {
+            if (!runtime)
+                throw new CapabilityError('Pattern loading requires a runtime.', 'INTERNAL', { reason: 'pattern-runtime-unavailable' });
+            const { CRUDPatternImpl } = await import("../patterns/builtins/crud.js");
+            return { default: new CRUDPatternImpl(runtime) };
+        }),
+        loader('tool-wrapper', { kind: 'cli/pattern' }, async (runtime) => {
+            if (!runtime)
+                throw new CapabilityError('Pattern loading requires a runtime.', 'INTERNAL', { reason: 'pattern-runtime-unavailable' });
+            const { ToolWrapperPatternImpl } = await import("../patterns/builtins/tool-wrapper.js");
+            return { default: new ToolWrapperPatternImpl(runtime) };
+        }),
+        loader('log-viewer', { kind: 'cli/pattern' }, async (runtime) => {
+            if (!runtime)
+                throw new CapabilityError('Pattern loading requires a runtime.', 'INTERNAL', { reason: 'pattern-runtime-unavailable' });
+            const { LogViewerPatternImpl } = await import("../patterns/builtins/log-viewer.js");
+            return { default: new LogViewerPatternImpl(runtime) };
+        }),
+        loader('process-manager', { kind: 'cli/pattern' }, async (runtime) => {
+            if (!runtime)
+                throw new CapabilityError('Pattern loading requires a runtime.', 'INTERNAL', { reason: 'pattern-runtime-unavailable' });
+            const { ProcessManagerPatternImpl } = await import("../patterns/builtins/process-manager.js");
+            return { default: new ProcessManagerPatternImpl(runtime) };
+        }),
+        loader('config-namespace', { kind: 'cli/pattern' }, async (runtime) => {
+            if (!runtime)
+                throw new CapabilityError('Pattern loading requires a runtime.', 'INTERNAL', { reason: 'pattern-runtime-unavailable' });
+            const { ConfigNamespacePatternImpl } = await import("../patterns/builtins/config-namespace.js");
+            return { default: new ConfigNamespacePatternImpl(runtime) };
+        }),
+        loader('runtime-codegen', () => import("./runtime/codegen.command.impl.js")),
+        loader('runtime-export', () => import("./runtime/export.command.impl.js")),
+        loader('completion', () => import("./completion/completion.impl.js")),
+        loader('profile.list', () => import("./profile/profile.list.impl.js")),
+        loader('profile.create', () => import("./profile/profile.create.impl.js")),
+        loader('profile.use', () => import("./profile/profile.use.impl.js")),
+        loader('profile.delete', () => import("./profile/profile.delete.impl.js")),
+        loader('profile.info', () => import("./profile/profile.info.impl.js")),
+        loader('profile.environment', () => import("./profile/profile.environment.impl.js"))
+    ]
+});
+export default defaultExport;
+//# sourceMappingURL=cli.plugin.js.map

package/dist/commands/cli.plugin.js.map

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

package/dist/commands/completion/bash.d.ts

@@ -3,6 +3,6 @@
  *
  * Generates a bash completion function from the command tree.
  */
-import type { CommandNode } from './tree';
+import type { CommandNode } from './tree.ts';
 export declare function generateBashCompletion(tree: CommandNode): string;
 //# sourceMappingURL=bash.d.ts.map

package/dist/commands/completion/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/bash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAwB1C,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAqChE"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/bash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA0B7C,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAqChE"}

package/dist/commands/completion/bash.impl.consumer.d.ts

@@ -0,0 +1,6 @@
+import { generateBashCompletion } from './bash.ts';
+declare const implementation: {
+    generate: typeof generateBashCompletion;
+};
+export default implementation;
+//# sourceMappingURL=bash.impl.consumer.d.ts.map

package/dist/commands/completion/bash.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/bash.impl.consumer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,QAAA,MAAM,cAAc;;CAEqB,CAAC;AAE1C,eAAe,cAAc,CAAC"}

package/dist/commands/completion/bash.impl.consumer.js

@@ -0,0 +1,6 @@
+import { generateBashCompletion } from "./bash.js";
+const implementation = {
+    generate: generateBashCompletion
+};
+export default implementation;
+//# sourceMappingURL=bash.impl.consumer.js.map

package/dist/commands/completion/bash.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.impl.consumer.js","sourceRoot":"","sources":["../../../src/commands/completion/bash.impl.consumer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,cAAc,GAAG;IACtB,QAAQ,EAAE,sBAAsB;CACQ,CAAC;AAE1C,eAAe,cAAc,CAAC"}

package/dist/commands/completion/bash.js

@@ -8,7 +8,9 @@ function generateCaseBlock(path, node, indent) {
     if (node.children.length === 0)
         return lines;
     const childNames = node.children.flatMap((c) => [c.name, ...c.aliases]).join(' ');
-    lines.push(`${indent}${path})`);
+    // A multi-word case pattern must be quoted or bash parses `vibes account)`
+    // as a syntax error at the space.
+    lines.push(`${indent}"${path}")`);
     lines.push(`${indent}    COMPREPLY=( $(compgen -W "${childNames}" -- "\${cur}") )`);
     lines.push(`${indent}    return 0`);
     lines.push(`${indent}    ;;`);
@@ -44,7 +46,7 @@ ${cases.join('\n')}
 ${tree.children
         .flatMap((g) => g.children.map((c) => {
         const opts = c.options.map((o) => (o.short ? `-${o.short} --${o.long}` : `--${o.long}`)).join(' ');
-        return opts ? `            vibes ${g.name} ${c.name}) opts="${opts}" ;;` : '';
+        return opts ? `            "vibes ${g.name} ${c.name}") opts="${opts}" ;;` : '';
     }))
         .filter(Boolean)
         .join('\n')}

package/dist/commands/completion/bash.js.map

@@ -1 +1 @@
-{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/commands/completion/bash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,SAAS,iBAAiB,CAAC,IAAY,EAAE,IAAiB,EAAE,MAAc;IACzE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,iCAAiC,UAAU,mBAAmB,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,cAAc,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YACzE,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YACrE,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAiB;IACvD,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAE3D,OAAO;;;;;;;;;;EAUN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;EAOhB,IAAI,CAAC,QAAQ;SACb,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACd,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,CAAC,CAAC,CACF;SACA,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC;;;;;;;;CAQX,CAAC;AACF,CAAC"}
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/commands/completion/bash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,SAAS,iBAAiB,CAAC,IAAY,EAAE,IAAiB,EAAE,MAAc;IACzE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClF,2EAA2E;IAC3E,kCAAkC;IAClC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,IAAI,IAAI,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,iCAAiC,UAAU,mBAAmB,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,cAAc,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YACzE,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YACrE,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAiB;IACvD,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAE3D,OAAO;;;;;;;;;;EAUN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;EAOhB,IAAI,CAAC,QAAQ;SACb,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACd,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,CAAC,CAAC,CACF;SACA,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC;;;;;;;;CAQX,CAAC;AACF,CAAC"}

package/dist/commands/completion/completion.consumer.plugin.d.ts

@@ -0,0 +1,3 @@
+declare const defaultExport: import("@vibesdotdev/kernel").RuntimePlugin;
+export default defaultExport;
+//# sourceMappingURL=completion.consumer.plugin.d.ts.map

package/dist/commands/completion/completion.consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.consumer.plugin.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/completion.consumer.plugin.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,aAAa,6CA4BjB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/commands/completion/completion.consumer.plugin.js

@@ -0,0 +1,19 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { CLI_SHELL_COMPLETION_KIND } from "../../schemas/completion.js";
+import { shellCompletionDescriptors } from "./completion.descriptors.js";
+import { shellCompletionKind } from "./completion.kinds.js";
+const defaultExport = createRuntimePlugin({
+    id: 'cli-shell-completions',
+    name: 'CLI Shell Completions',
+    description: 'Consumer-scoped bash, zsh, fish and Fig completion contributions',
+    kinds: [shellCompletionKind],
+    descriptors: shellCompletionDescriptors,
+    loaders: [
+        loader('bash', { kind: CLI_SHELL_COMPLETION_KIND, scope: { hardware: ['consumer'] } }, () => import("./bash.impl.consumer.js")),
+        loader('zsh', { kind: CLI_SHELL_COMPLETION_KIND, scope: { hardware: ['consumer'] } }, () => import("./zsh.impl.consumer.js")),
+        loader('fish', { kind: CLI_SHELL_COMPLETION_KIND, scope: { hardware: ['consumer'] } }, () => import("./fish.impl.consumer.js")),
+        loader('fig', { kind: CLI_SHELL_COMPLETION_KIND, scope: { hardware: ['consumer'] } }, () => import("./fig.impl.consumer.js"))
+    ]
+});
+export default defaultExport;
+//# sourceMappingURL=completion.consumer.plugin.js.map

package/dist/commands/completion/completion.consumer.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.consumer.plugin.js","sourceRoot":"","sources":["../../../src/commands/completion/completion.consumer.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,aAAa,GAAG,mBAAmB,CAAC;IACzC,EAAE,EAAE,uBAAuB;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,kEAAkE;IAC/E,KAAK,EAAE,CAAC,mBAAmB,CAAC;IAC5B,WAAW,EAAE,0BAA0B;IACvC,OAAO,EAAE;QACR,MAAM,CACL,MAAM,EACN,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EACtE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,CACvC;QACD,MAAM,CACL,KAAK,EACL,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EACtE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC,CACtC;QACD,MAAM,CACL,MAAM,EACN,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EACtE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,CACvC;QACD,MAAM,CACL,KAAK,EACL,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EACtE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC,CACtC;KACD;CACD,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/commands/completion/completion.descriptor.d.ts

@@ -2,9 +2,8 @@
  * Shell Completion Generator Command Descriptor
  *
  * Generates shell completions and autosuggestions from runtime descriptors.
- * Supports bash, zsh (with inline autosuggestion widget), fish, and fig specs.
  */
-import type { CLICommandAssetDescriptor } from '../../schemas/descriptors';
+import type { CLICommandAssetDescriptor } from '../../schemas/descriptors.ts';
 declare const descriptor: CLICommandAssetDescriptor;
 export default descriptor;
 //# sourceMappingURL=completion.descriptor.d.ts.map

package/dist/commands/completion/completion.descriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/completion.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,QAAA,MAAM,UAAU,EAAE,yBAoCjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"completion.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/completion.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE9E,QAAA,MAAM,UAAU,EAAE,yBA4CjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/completion/completion.descriptor.js

@@ -2,19 +2,26 @@
  * Shell Completion Generator Command Descriptor
  *
  * Generates shell completions and autosuggestions from runtime descriptors.
- * Supports bash, zsh (with inline autosuggestion widget), fish, and fig specs.
  */
 const descriptor = {
     kind: 'cli/command',
     id: 'completion',
     name: 'completion',
-    description: 'Generate shell completions and autosuggestions',
+    description: 'Generate shell completions for a registered shell',
     group: 'shell-integration',
+    effects: {
+        // Script generation is a pure metadata read. Installation writes the
+        // generated file and may update the selected shell profile.
+        homeWrite: { whenOption: 'install' }
+    },
+    // The shell operand is admitted as optional at the command boundary: a
+    // shell-free invocation is valid for `--json` (the command tree). The
+    // implementation requires a shell only when it generates a script.
     arguments: [
         {
             name: 'shell',
-            description: 'Target shell: bash, zsh, fish, or fig',
-            required: true
+            description: 'Shell id registered by a completion contribution',
+            required: false
         }
     ],
     options: [

package/dist/commands/completion/completion.descriptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"completion.descriptor.js","sourceRoot":"","sources":["../../../src/commands/completion/completion.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,gDAAgD;IAC7D,KAAK,EAAE,mBAAmB;IAE1B,SAAS,EAAE;QACV;YACC,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,uCAAuC;YACpD,QAAQ,EAAE,IAAI;SACd;KACD;IAED,OAAO,EAAE;QACR;YACC,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,2CAA2C;SACxD;QACD;YACC,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,gDAAgD;SAC7D;KACD;IAED,QAAQ,EAAE;QACT,EAAE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,6CAA6C,EAAE;QAC/F,EAAE,OAAO,EAAE,gCAAgC,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACrF,EAAE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,uCAAuC,EAAE;QACzF,EAAE,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,iCAAiC,EAAE;KACtF;IAED,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"completion.descriptor.js","sourceRoot":"","sources":["../../../src/commands/completion/completion.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,mDAAmD;IAChE,KAAK,EAAE,mBAAmB;IAC1B,OAAO,EAAE;QACR,qEAAqE;QACrE,4DAA4D;QAC5D,SAAS,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE;KACpC;IAED,uEAAuE;IACvE,sEAAsE;IACtE,mEAAmE;IACnE,SAAS,EAAE;QACV;YACC,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,kDAAkD;YAC/D,QAAQ,EAAE,KAAK;SACf;KACD;IAED,OAAO,EAAE;QACR;YACC,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,2CAA2C;SACxD;QACD;YACC,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,gDAAgD;SAC7D;KACD;IAED,QAAQ,EAAE;QACT,EAAE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,6CAA6C,EAAE;QAC/F,EAAE,OAAO,EAAE,gCAAgC,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACrF,EAAE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,uCAAuC,EAAE;QACzF,EAAE,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,iCAAiC,EAAE;KACtF;IAED,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/completion/completion.descriptors.d.ts

@@ -0,0 +1,3 @@
+import { type ShellCompletionDescriptor } from '../../schemas/completion.ts';
+export declare const shellCompletionDescriptors: ShellCompletionDescriptor[];
+//# sourceMappingURL=completion.descriptors.d.ts.map

package/dist/commands/completion/completion.descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.descriptors.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/completion.descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,yBAAyB,EAC9B,MAAM,6BAA6B,CAAC;AAMrC,eAAO,MAAM,0BAA0B,EAAE,yBAAyB,EAmDjE,CAAC"}

package/dist/commands/completion/completion.descriptors.js

@@ -0,0 +1,56 @@
+import { CLI_SHELL_COMPLETION_KIND } from "../../schemas/completion.js";
+const installPath = (...segments) => segments;
+const sourceLine = '[[ -f "{{installPath}}" ]] && source "{{installPath}}"';
+export const shellCompletionDescriptors = [
+    {
+        kind: CLI_SHELL_COMPLETION_KIND,
+        id: 'bash',
+        label: 'bash',
+        installPath: installPath('.bash_completion.d', 'vibes'),
+        profile: {
+            candidates: [['.bashrc'], ['.bash_profile']],
+            sourceLine
+        },
+        highlights: [],
+        features: ['Tab completion for all vibes commands']
+    },
+    {
+        kind: CLI_SHELL_COMPLETION_KIND,
+        id: 'zsh',
+        label: 'zsh',
+        installPath: installPath('.zsh', 'completions', '_vibes'),
+        profile: {
+            candidates: [['.zshrc']],
+            sourceLine
+        },
+        highlights: [
+            'zsh-autosuggestions integration (inline ghost-text)',
+            'Custom vibes strategy (suggests from {{commandCount}} known commands)'
+        ],
+        features: ['Tab completion for all vibes commands']
+    },
+    {
+        kind: CLI_SHELL_COMPLETION_KIND,
+        id: 'fish',
+        label: 'fish',
+        installPath: installPath('.config', 'fish', 'completions', 'vibes.fish'),
+        profile: null,
+        automaticLoadNotice: 'Fish loads completions automatically',
+        highlights: [],
+        features: ['Tab completion for all vibes commands']
+    },
+    {
+        kind: CLI_SHELL_COMPLETION_KIND,
+        id: 'fig',
+        label: 'fig',
+        installPath: installPath('.fig', 'autocomplete', 'vibes.ts'),
+        profile: null,
+        automaticLoadNotice: 'Amazon Q / Inshellisense will load spec automatically',
+        highlights: [
+            'Rich dropdown UI in supported terminals',
+            'Dynamic argument generators'
+        ],
+        features: ['Tab completion for all vibes commands']
+    }
+];
+//# sourceMappingURL=completion.descriptors.js.map

package/dist/commands/completion/completion.descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.descriptors.js","sourceRoot":"","sources":["../../../src/commands/completion/completion.descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,yBAAyB,EAEzB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,GAAG,CAAC,GAAG,QAAkB,EAAE,EAAE,CAAC,QAAQ,CAAC;AAExD,MAAM,UAAU,GAAG,wDAAwD,CAAC;AAE5E,MAAM,CAAC,MAAM,0BAA0B,GAAgC;IACtE;QACC,IAAI,EAAE,yBAAyB;QAC/B,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,WAAW,CAAC,oBAAoB,EAAE,OAAO,CAAC;QACvD,OAAO,EAAE;YACR,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;YAC5C,UAAU;SACV;QACD,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,CAAC,uCAAuC,CAAC;KACnD;IACD;QACC,IAAI,EAAE,yBAAyB;QAC/B,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC;QACzD,OAAO,EAAE;YACR,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;YACxB,UAAU;SACV;QACD,UAAU,EAAE;YACX,qDAAqD;YACrD,uEAAuE;SACvE;QACD,QAAQ,EAAE,CAAC,uCAAuC,CAAC;KACnD;IACD;QACC,IAAI,EAAE,yBAAyB;QAC/B,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC;QACxE,OAAO,EAAE,IAAI;QACb,mBAAmB,EAAE,sCAAsC;QAC3D,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,CAAC,uCAAuC,CAAC;KACnD;IACD;QACC,IAAI,EAAE,yBAAyB;QAC/B,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,CAAC;QAC5D,OAAO,EAAE,IAAI;QACb,mBAAmB,EAAE,uDAAuD;QAC5E,UAAU,EAAE;YACX,yCAAyC;YACzC,6BAA6B;SAC7B;QACD,QAAQ,EAAE,CAAC,uCAAuC,CAAC;KACnD;CACD,CAAC"}

package/dist/commands/completion/completion.impl.d.ts

@@ -1,12 +1,13 @@
 /**
  * Shell Completion Generator Implementation
  *
- * Builds the CLI command tree from runtime descriptors and generates
- * shell-specific completion scripts. The zsh output includes an inline
- * autosuggestion widget with history-based ranking.
+ * Builds the CLI command tree from runtime descriptors and resolves a shell
+ * contribution from the open CLI shell-completion kind.
  */
+import type { CommandContext, CommandOptions } from '../../schemas/surface.ts';
 declare const _default: {
-    execute(args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void>;
+    outputBoundary: string;
+    execute(args: CommandOptions, opts: CommandOptions, context: CommandContext): Promise<void>;
 };
 export default _default;
 //# sourceMappingURL=completion.impl.d.ts.map

package/dist/commands/completion/completion.impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion.impl.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/completion.impl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;kBA8FkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD3F,wBA4EE"}
+{"version":3,"file":"completion.impl.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/completion.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;;;kBA2F1D,cAAc,QAAQ,cAAc,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AAFlG,wBAiDE"}