@vibesdotdev/cli 0.0.1

package/dist/patterns/tool-wrapper.js

@@ -0,0 +1,130 @@
+/**
+ * Tool Wrapper Pattern Implementation
+ *
+ * Wraps a tools/tool as a CLI command.
+ */
+export class ToolWrapperPatternImpl {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async register(descriptor, parent, context) {
+        const { target, toolWrapper, name, group } = descriptor;
+        // Get tool descriptor for metadata
+        const toolDesc = this.runtime
+            .query(target.kind)
+            .withId(target.id)
+            .firstDescriptor();
+        const description = descriptor.description ?? toolDesc?.description ?? `Run ${name}`;
+        const cmd = parent.command(name).description(description);
+        // Add arguments
+        if (toolWrapper?.arguments) {
+            for (const arg of toolWrapper.arguments) {
+                const variadic = arg.variadic ? '...' : '';
+                const spec = arg.required ? `<${arg.name}${variadic}>` : `[${arg.name}${variadic}]`;
+                cmd.argument(spec, arg.description ?? arg.name);
+            }
+        }
+        // Add options
+        if (toolWrapper?.options) {
+            for (const opt of toolWrapper.options) {
+                // Note: In Commander.js, choices must be added as part of addOption(), not chained
+                if (opt.choices && opt.choices.length > 0) {
+                    const { Option } = await import('commander');
+                    const option = new Option(opt.flags, opt.description ?? opt.toolParam);
+                    if (opt.default !== undefined)
+                        option.default(opt.default);
+                    option.choices(opt.choices);
+                    cmd.addOption(option);
+                }
+                else {
+                    cmd.option(opt.flags, opt.description ?? opt.toolParam, opt.default);
+                }
+            }
+        }
+        // Add output format option (avoid clashing with global --format)
+        const outputCfg = toolWrapper?.output ?? { format: 'raw' };
+        cmd.option('--output-format <format>', 'Output format', outputCfg.format);
+        cmd.action(async (...args) => {
+            const opts = args.pop();
+            const posArgs = args;
+            // Build tool input
+            const input = {};
+            if (toolWrapper?.arguments) {
+                toolWrapper.arguments.forEach((arg, i) => {
+                    if (i < posArgs.length) {
+                        input[arg.toolParam] = posArgs[i];
+                    }
+                });
+            }
+            if (toolWrapper?.options) {
+                for (const opt of toolWrapper.options) {
+                    const optName = this.extractOptionName(opt.flags);
+                    if (opts[optName] !== undefined) {
+                        input[opt.toolParam] = opts[optName];
+                    }
+                }
+            }
+            // Execute tool
+            const tool = await this.runtime.resolve(target.kind, target.id);
+            const logger = await this.runtime.resolve('logging/logger', 'cli');
+            const toolCallCtx = {
+                callId: `cli:${target.id}:${Date.now()}`,
+                logger: logger.child(target.id)
+            };
+            const result = await tool.execute(input, this.runtime, toolCallCtx);
+            this.output(result, String(opts.outputFormat ?? outputCfg.format), context, outputCfg.extractField);
+        });
+    }
+    extractOptionName(flags) {
+        const long = flags.match(/--(\w[\w-]*)/);
+        if (long)
+            return long[1].replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        const short = flags.match(/-(\w)/);
+        if (short)
+            return short[1];
+        throw new Error(`Cannot extract option name from: ${flags}`);
+    }
+    output(data, format, ctx, extractField) {
+        let output = data;
+        if (extractField && typeof data === 'object' && data !== null) {
+            output = data[extractField] ?? data;
+        }
+        if (!ctx.ui) {
+            if (format === 'raw' && typeof output === 'string') {
+                process.stdout.write(`${output}\n`);
+            }
+            else {
+                process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
+            }
+            return;
+        }
+        switch (format) {
+            case 'raw':
+                if (typeof output === 'string') {
+                    process.stdout.write(`${output}\n`);
+                }
+                else {
+                    ctx.ui.json(output);
+                }
+                break;
+            case 'json':
+                ctx.ui.json(output);
+                break;
+            case 'yaml':
+                ctx.ui.yaml(output);
+                break;
+            case 'table':
+                if (Array.isArray(output)) {
+                    ctx.ui.table(output);
+                }
+                else {
+                    ctx.ui.yaml(output);
+                }
+                break;
+            default:
+                ctx.ui.json(output);
+        }
+    }
+}
+//# sourceMappingURL=tool-wrapper.js.map

package/dist/patterns/tool-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-wrapper.js","sourceRoot":"","sources":["../../src/patterns/tool-wrapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,MAAM,OAAO,sBAAsB;IACd;IAApB,YAAoB,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAE7C,KAAK,CAAC,QAAQ,CACb,UAA2C,EAC3C,MAAe,EACf,OAAuB;QAEvB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;QAExD,mCAAmC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO;aAC3B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;aAClB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;aACjB,eAAe,EAAgC,CAAC;QAElD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,QAAQ,EAAE,WAAW,IAAI,OAAO,IAAI,EAAE,CAAC;QAErF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAE1D,gBAAgB;QAChB,IAAI,WAAW,EAAE,SAAS,EAAE,CAAC;YAC5B,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC;gBACpF,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YACjD,CAAC;QACF,CAAC;QAED,cAAc;QACd,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YAC1B,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACvC,mFAAmF;gBACnF,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;oBAC7C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;oBACvE,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;wBAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC3D,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC5B,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACP,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAiB,CAAC,CAAC;gBAChF,CAAC;YACF,CAAC;QACF,CAAC;QAED,iEAAiE;QACjE,MAAM,SAAS,GAAG,WAAW,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,KAAc,EAAE,CAAC;QACpE,GAAG,CAAC,MAAM,CAAC,0BAA0B,EAAE,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAE1E,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAA6B,CAAC;YACnD,MAAM,OAAO,GAAG,IAAiB,CAAC;YAElC,mBAAmB;YACnB,MAAM,KAAK,GAA4B,EAAE,CAAC;YAE1C,IAAI,WAAW,EAAE,SAAS,EAAE,CAAC;gBAC5B,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAA2C,EAAE,CAAS,EAAE,EAAE;oBACxF,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;wBACxB,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBACnC,CAAC;gBACF,CAAC,CAAC,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;gBAC1B,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;oBACvC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBAClD,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;wBACjC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;oBACtC,CAAC;gBACF,CAAC;YACF,CAAC;YAED,eAAe;YACf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAqB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAuB,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACzF,MAAM,WAAW,GAAoB;gBACpC,MAAM,EAAE,OAAO,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;gBACxC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;aAC/B,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAEpE,IAAI,CAAC,MAAM,CACV,MAAM,EACN,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,MAAM,CAAC,EAC7C,OAAO,EACP,SAAS,CAAC,YAAY,CACtB,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAEO,iBAAiB,CAAC,KAAa;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAEO,MAAM,CAAC,IAAa,EAAE,MAAc,EAAE,GAAmB,EAAE,YAAqB;QACvF,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,YAAY,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/D,MAAM,GAAI,IAAgC,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,MAAM,KAAK,KAAK,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO;QACR,CAAC;QAED,QAAQ,MAAM,EAAE,CAAC;YAChB,KAAK,KAAK;gBACT,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;gBACrC,CAAC;qBAAM,CAAC;oBACP,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,CAAC;gBACD,MAAM;YACP,KAAK,MAAM;gBACV,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACpB,MAAM;YACP,KAAK,MAAM;gBACV,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACpB,MAAM;YACP,KAAK,OAAO;gBACX,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3B,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtB,CAAC;qBAAM,CAAC;oBACP,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,CAAC;gBACD,MAAM;YACP;gBACC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;CACD"}

package/dist/providers.d.ts

@@ -0,0 +1,105 @@
+/**
+ * CLI Context Providers
+ *
+ * Registers CLI-specific context providers with the universal runtime.
+ * These contexts are available to CLI commands and patterns.
+ */
+import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
+/**
+ * UI Context - output formatting and display
+ */
+export interface UIContext {
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    log(message: string): void;
+    table(data: unknown[], options?: {
+        columns?: string[];
+    } | string | string[]): void;
+    json(data: unknown): void;
+    yaml(data: unknown): void;
+    keyValue(data: Record<string, unknown>): void;
+    progress(message?: string): {
+        update: (nextMessage?: string) => void;
+        complete: (nextMessage?: string) => void;
+        fail: (nextMessage?: string) => void;
+    };
+    setFormat(format: 'json' | 'yaml' | 'table' | 'markdown'): void;
+    /**
+     * Render a value in a caller-selected format. Higher-level convenience over
+     * `json` / `yaml` / `table` used by command implementations that defer their
+     * output format to an `--output` flag.
+     */
+    render(data: unknown, options?: {
+        format?: 'json' | 'yaml' | 'table' | 'markdown' | 'text';
+    }): void | Promise<void>;
+}
+/**
+ * Logger Context - structured logging
+ */
+export interface LoggerContext {
+    info(message: string, meta?: unknown): void;
+    warn(message: string, meta?: unknown): void;
+    error(message: string, meta?: unknown): void;
+    debug(message: string, meta?: unknown): void;
+}
+/**
+ * App Context - lifecycle control
+ */
+export interface AppContext {
+    keepAlive(): void;
+    shouldKeepAlive(): boolean;
+    exit(code?: number): void;
+}
+export interface ConfigContext {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown): Promise<void>;
+    getNamespace(namespace: string): Promise<Record<string, unknown>>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Signal used to abort command execution without forcing process termination.
+ * CLISurface catches this and lets the process unwind naturally.
+ */
+export declare class CLIExitSignal extends Error {
+    readonly code: number;
+    constructor(code: number);
+}
+export declare function requestCLIExit(code?: number): never;
+/**
+ * CLI Invocation Context - how the CLI was invoked
+ */
+export interface CLIContext {
+    command: string[];
+    bin: string;
+    script?: string;
+    cwd: string;
+    args: string[];
+}
+/**
+ * Options for CLI provider registration
+ */
+export interface CLIProviderOptions {
+    verbose?: boolean;
+    format?: 'json' | 'yaml' | 'table' | 'markdown';
+}
+/**
+ * Register CLI context providers with the runtime
+ *
+ * Call this before initializing CLISurface.
+ */
+export declare function registerCLIProviders(runtime: VibesRuntime, options?: CLIProviderOptions): void;
+/**
+ * Detect output format from CLI arguments
+ */
+export declare function detectOutputFormat(): 'json' | 'yaml' | 'table' | 'markdown';
+/**
+ * Check if process should keep alive (for long-running commands)
+ */
+export declare function shouldKeepAlive(): boolean;
+/**
+ * Reset keep alive flag (for testing)
+ */
+export declare function resetKeepAlive(): void;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAMrE;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACnF,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG;QAC3B,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QACvC,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QACzC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;KACrC,CAAC;IACF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;IAChE;;;;OAIG;IACH,MAAM,CACL,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAA;KAAE,GACpE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,SAAS,IAAI,IAAI,CAAC;IAClB,eAAe,IAAI,OAAO,CAAC;IAC3B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;aACX,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIxC;AAED,wBAAgB,cAAc,CAAC,IAAI,SAAI,GAAG,KAAK,CAG9C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;CAChD;AAYD;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,kBAAuB,GAC9B,IAAI,CAoFN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAkB3E;AAwCD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/providers.js

@@ -0,0 +1,164 @@
+/**
+ * CLI Context Providers
+ *
+ * Registers CLI-specific context providers with the universal runtime.
+ * These contexts are available to CLI commands and patterns.
+ */
+import { VibesUIToolkit } from './support/ui-toolkit';
+import { getLogger } from './logging';
+const providerLogger = getLogger('providers');
+/**
+ * Signal used to abort command execution without forcing process termination.
+ * CLISurface catches this and lets the process unwind naturally.
+ */
+export class CLIExitSignal extends Error {
+    code;
+    constructor(code) {
+        super(`CLI requested exit with code ${code}`);
+        this.code = code;
+        this.name = 'CLIExitSignal';
+    }
+}
+export function requestCLIExit(code = 0) {
+    process.exitCode = code;
+    throw new CLIExitSignal(code);
+}
+// Shared state for keepAlive across the process
+let keepAliveFlag = false;
+function makeContextLoader(id, factory) {
+    return async () => ({
+        meta: { id, kind: 'context', priority: 0 },
+        impl: { provide: factory }
+    });
+}
+/**
+ * Register CLI context providers with the runtime
+ *
+ * Call this before initializing CLISurface.
+ */
+export function registerCLIProviders(runtime, options = {}) {
+    const format = options.format ?? detectOutputFormat();
+    // Debug: Check if context kind exists
+    if (!runtime.hasKind('context')) {
+        throw new Error('Context kind not registered - cannot register CLI providers');
+    }
+    const ctx = runtime.assets('context');
+    // UI Context
+    ctx.registerLoader('cli/ui', makeContextLoader('cli/ui', () => {
+        const ui = new VibesUIToolkit({
+            mode: 'rich',
+            compact: false,
+            autoExit: false
+        });
+        ui.setFormat(format);
+        return ui;
+    }), {
+        constraint: { surfaces: ['cli'] },
+        priority: 0
+    });
+    // Logger Context
+    ctx.registerLoader('cli/logger', makeContextLoader('cli/logger', () => ({
+        info: (msg, meta) => {
+            if (options.verbose)
+                providerLogger.info(msg, { meta });
+        },
+        warn: (msg, meta) => providerLogger.warn(msg, { meta }),
+        error: (msg, meta) => providerLogger.error(msg, { meta }),
+        debug: (msg, meta) => {
+            if (options.verbose)
+                providerLogger.debug(msg, { meta });
+        }
+    })), {
+        constraint: { surfaces: ['cli'] },
+        priority: 0
+    });
+    // App Context
+    ctx.registerLoader('cli/app', makeContextLoader('cli/app', () => ({
+        keepAlive: () => {
+            keepAliveFlag = true;
+        },
+        shouldKeepAlive: () => keepAliveFlag,
+        exit: (code = 0) => requestCLIExit(code)
+    })), {
+        constraint: { surfaces: ['cli'] },
+        priority: 0
+    });
+    // CLI Invocation Context
+    ctx.registerLoader('cli/invocation', makeContextLoader('cli/invocation', () => detectCLIInvocation()), {
+        constraint: { surfaces: ['cli'] },
+        priority: 0
+    });
+    // Output Format Context
+    ctx.registerLoader('cli/output-format', makeContextLoader('cli/output-format', () => format), {
+        constraint: { surfaces: ['cli'] },
+        priority: 0
+    });
+}
+/**
+ * Detect output format from CLI arguments
+ */
+export function detectOutputFormat() {
+    const inline = process.argv.find((arg) => arg.startsWith('--format='));
+    if (inline) {
+        const fmt = inline.slice('--format='.length).toLowerCase();
+        if (fmt === 'json' || fmt === 'yaml' || fmt === 'table' || fmt === 'markdown') {
+            return fmt;
+        }
+    }
+    const idx = process.argv.findIndex((arg) => arg === '--format');
+    if (idx >= 0 && idx + 1 < process.argv.length) {
+        const fmt = String(process.argv[idx + 1]).toLowerCase();
+        if (fmt === 'json' || fmt === 'yaml' || fmt === 'table' || fmt === 'markdown') {
+            return fmt;
+        }
+    }
+    return 'table';
+}
+/**
+ * Detect how the CLI was invoked
+ */
+function detectCLIInvocation() {
+    const argv = process.argv;
+    const cwd = process.cwd();
+    const interpreter = argv[0] ?? '';
+    const isInterpreted = interpreter.includes('bun') || interpreter.includes('node');
+    let command = [];
+    let bin = interpreter;
+    let script;
+    let args = [];
+    if (isInterpreted) {
+        let scriptIndex = 1;
+        while (scriptIndex < argv.length && argv[scriptIndex].startsWith('-')) {
+            scriptIndex++;
+        }
+        if (scriptIndex < argv.length) {
+            script = argv[scriptIndex];
+            command = [interpreter, ...argv.slice(1, scriptIndex + 1)];
+            args = argv.slice(scriptIndex + 1);
+        }
+        else {
+            command = [interpreter];
+            args = argv.slice(1);
+        }
+        bin = command.join(' ');
+    }
+    else {
+        command = [interpreter];
+        args = argv.slice(1);
+        bin = interpreter;
+    }
+    return { command, bin, script, cwd, args };
+}
+/**
+ * Check if process should keep alive (for long-running commands)
+ */
+export function shouldKeepAlive() {
+    return keepAliveFlag;
+}
+/**
+ * Reset keep alive flag (for testing)
+ */
+export function resetKeepAlive() {
+    keepAliveFlag = false;
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/schemas/descriptors.d.ts

@@ -0,0 +1,130 @@
+/**
+ * CLI Descriptor Schemas
+ *
+ * Kind-specific descriptor schemas for cli/group and cli/command.
+ * These are owned by the CLI module and registered with the runtime via cli.plugin.ts.
+ */
+import * as z from 'zod/v4';
+/**
+ * Log buffer behavior — controls how CLI output is buffered during command execution.
+ */
+export declare const CLILogBufferBehaviorSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    sinks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fallbackToStdout: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * CLI Group descriptor config — groups organize commands into subcommand trees.
+ */
+export declare const CLIGroupDescriptorConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    parent: z.ZodOptional<z.ZodString>;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    surfaces: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        cli: "cli";
+        web: "web";
+        worker: "worker";
+        bridge: "bridge";
+    }>>>;
+    internal: z.ZodOptional<z.ZodBoolean>;
+    order: z.ZodOptional<z.ZodNumber>;
+    logBuffer: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        sinks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fallbackToStdout: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CLIGroupDescriptorSchema: z.ZodObject<{
+    [x: string]: any;
+}, z.core.$strip>;
+/**
+ * CLI argument definition
+ */
+export declare const CLIArgumentSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    variadic: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * CLI option definition
+ */
+export declare const CLIOptionSchema: z.ZodObject<{
+    flags: z.ZodString;
+    description: z.ZodString;
+    default: z.ZodOptional<z.ZodUnknown>;
+    choices: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+    }>>;
+}, z.core.$strip>;
+/**
+ * CLI command example
+ */
+export declare const CLICommandExampleSchema: z.ZodObject<{
+    command: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+/**
+ * CLI Command descriptor config — individual executable commands.
+ */
+export declare const CLICommandDescriptorConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    group: z.ZodString;
+    arguments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        variadic: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        flags: z.ZodString;
+        description: z.ZodString;
+        default: z.ZodOptional<z.ZodUnknown>;
+        choices: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+        }>>;
+    }, z.core.$strip>>>;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    surfaces: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        cli: "cli";
+        web: "web";
+        worker: "worker";
+        bridge: "bridge";
+    }>>>;
+    internal: z.ZodOptional<z.ZodBoolean>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    tuiAppId: z.ZodOptional<z.ZodString>;
+    logBuffer: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        sinks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fallbackToStdout: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CLICommandDescriptorSchema: z.ZodObject<{
+    [x: string]: any;
+}, z.core.$strip>;
+export type { CLICommandArgument, CLICommandAssetDescriptor, CLICommandExample, CLICommandOption, CLIGroupAssetDescriptor, CLILogBufferBehavior } from './types';
+/**
+ * Declaration merging for type-safe runtime asset resolution.
+ */
+declare module '@vibesdotdev/runtime/schemas/asset' {
+    interface RuntimeAssetSchemaRegistry {
+        'cli/group': CLIGroupAssetDescriptor;
+        'cli/command': CLICommandAssetDescriptor;
+    }
+}
+//# sourceMappingURL=descriptors.d.ts.map

package/dist/schemas/descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../src/schemas/descriptors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAW5B;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;iBAiBzC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;iBAGpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;iBAM1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyB3C,CAAC;AAEH,eAAO,MAAM,0BAA0B;;iBAGtC,CAAC;AACF,YAAY,EACX,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,OAAO,QAAQ,oCAAoC,CAAC;IACnD,UAAU,0BAA0B;QACnC,WAAW,EAAE,uBAAuB,CAAC;QACrC,aAAa,EAAE,yBAAyB,CAAC;KACzC;CACD"}

package/dist/schemas/descriptors.js

@@ -0,0 +1,96 @@
+/**
+ * CLI Descriptor Schemas
+ *
+ * Kind-specific descriptor schemas for cli/group and cli/command.
+ * These are owned by the CLI module and registered with the runtime via cli.plugin.ts.
+ */
+import * as z from 'zod/v4';
+import { createRuntimeAssetSchema } from '@vibesdotdev/runtime/schemas/asset';
+/**
+ * Log buffer behavior — controls how CLI output is buffered during command execution.
+ */
+export const CLILogBufferBehaviorSchema = z.object({
+    enabled: z.boolean().optional(),
+    sinks: z.array(z.string()).optional(),
+    fallbackToStdout: z.boolean().optional()
+});
+/**
+ * CLI Group descriptor config — groups organize commands into subcommand trees.
+ */
+export const CLIGroupDescriptorConfigSchema = z.object({
+    /** Human-readable name */
+    name: z.string().min(1),
+    /** Description of the group */
+    description: z.string().min(1),
+    /** Parent group ID (for nested groups) */
+    parent: z.string().optional(),
+    /** Command aliases */
+    aliases: z.array(z.string()).optional(),
+    /** Surfaces where this group is available */
+    surfaces: z.array(z.enum(['cli', 'web', 'worker', 'bridge'])).optional(),
+    /** Whether this group is internal-only unless the surface opts into internal commands */
+    internal: z.boolean().optional(),
+    /** Sort order within parent */
+    order: z.number().int().optional(),
+    /** Log buffer behavior for all commands in this group */
+    logBuffer: CLILogBufferBehaviorSchema.optional()
+});
+export const CLIGroupDescriptorSchema = createRuntimeAssetSchema('cli/group', CLIGroupDescriptorConfigSchema);
+/**
+ * CLI argument definition
+ */
+export const CLIArgumentSchema = z.object({
+    name: z.string().min(1),
+    description: z.string(),
+    required: z.boolean().optional(),
+    variadic: z.boolean().optional(),
+    default: z.unknown().optional()
+});
+/**
+ * CLI option definition
+ */
+export const CLIOptionSchema = z.object({
+    flags: z.string().min(1),
+    description: z.string().min(1),
+    default: z.unknown().optional(),
+    choices: z.array(z.string()).optional(),
+    type: z.enum(['string', 'number', 'boolean']).optional()
+});
+/**
+ * CLI command example
+ */
+export const CLICommandExampleSchema = z.object({
+    command: z.string().min(1),
+    description: z.string().min(1)
+});
+/**
+ * CLI Command descriptor config — individual executable commands.
+ */
+export const CLICommandDescriptorConfigSchema = z.object({
+    /** Human-readable name */
+    name: z.string().min(1),
+    /** Description of the command */
+    description: z.string().min(1),
+    /** Group this command belongs to */
+    group: z.string().min(1),
+    /** Positional arguments */
+    arguments: z.array(CLIArgumentSchema).optional(),
+    /** Named options/flags */
+    options: z.array(CLIOptionSchema).optional(),
+    /** Command aliases */
+    aliases: z.array(z.string()).optional(),
+    /** Surfaces where this command is available */
+    surfaces: z.array(z.enum(['cli', 'web', 'worker', 'bridge'])).optional(),
+    /** Whether this command is internal-only unless the surface opts into internal commands */
+    internal: z.boolean().optional(),
+    /** Examples of command usage */
+    examples: z.array(CLICommandExampleSchema).optional(),
+    /** Sort order within group */
+    order: z.number().int().optional(),
+    /** TUI app ID to launch instead of execute() */
+    tuiAppId: z.string().optional(),
+    /** Log buffer behavior for this command */
+    logBuffer: CLILogBufferBehaviorSchema.optional()
+});
+export const CLICommandDescriptorSchema = createRuntimeAssetSchema('cli/command', CLICommandDescriptorConfigSchema);
+//# sourceMappingURL=descriptors.js.map

package/dist/schemas/descriptors.js.map

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