@vibesdotdev/cli 0.0.2 → 1.0.0-rc.3

package/dist/support/ui/schemas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/support/ui/schemas/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/support/ui/schemas/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/support/ui/schemas/types.ts"],"names":[],"mappings":""}

package/dist/support/ui/schemas/ui-toolkit.d.ts

@@ -0,0 +1,45 @@
+/** UI toolkit contracts: construction options, progress reporting, and the output channel. */
+import type CLIFormatClient from '../format.client.ts';
+import type { RuntimeTerminalFacts } from '@vibesdotdev/kernel';
+import type { TerminalPromptTransport } from '../../terminal-input.ts';
+/** Construction options; `terminal` is the runtime's captured terminal facts (the CLI passes `runtime.localEnvironment.terminal`). */
+export interface VibesUIToolkitOptions {
+    /** Activated runtime format client; omit only when callers use prompt and log methods. */
+    formats?: CLIFormatClient;
+    mode?: 'rich' | 'plain';
+    compact?: boolean;
+    autoExit?: boolean;
+    /**
+     * The handed runtime's captured terminal facts. When supplied they alone
+     * decide interactivity, and a fact the host did not observe reads as "not a
+     * terminal". Omitted (a toolkit built outside a command context), the
+     * no terminal is assumed and prompts return non-interactive defaults. If captured facts say\n\t * interactive, a runtime-selected `cli/terminal-input` transport is required;\n\t * absence refuses `UNAVAILABLE / cli-terminal-input-unavailable`.
+     */
+    terminal?: () => RuntimeTerminalFacts | undefined;
+    /**
+     * Runtime-resolved interactive input. When a host registered a
+     * `cli/terminal-input` context, the CLI resolves it through the handed
+     * runtime. An interactive prompt refuses when no transport was registered.
+     */
+    terminalInput?: TerminalPromptTransport;
+    /** Where the toolkit writes: the CLI hands the executable host's output, else the runtime's `runtime/stdio`. */
+    output: UIToolkitOutput;
+}
+/** What `progress()` answers: line-oriented updates. */
+export interface CLIProgressReporter {
+    update: (nextMessage?: string) => void;
+    complete: (nextMessage?: string) => void;
+    fail: (nextMessage?: string) => void;
+}
+/** Where the toolkit writes: a channel and the text. */
+export interface UIToolkitOutput {
+    readonly write: (channel: 'stdout' | 'stderr', text: string) => void;
+}
+/** The prompt surface's inputs: the terminal facts source and where prompts write. */
+export interface PromptIO {
+    terminal: (() => RuntimeTerminalFacts | undefined) | undefined;
+    output: UIToolkitOutput;
+    /** Runtime-resolved input; an interactive prompt refuses when it is absent. */
+    terminalInput?: TerminalPromptTransport;
+}
+//# sourceMappingURL=ui-toolkit.d.ts.map

package/dist/support/ui/schemas/ui-toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-toolkit.d.ts","sourceRoot":"","sources":["../../../../src/support/ui/schemas/ui-toolkit.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,KAAK,eAAe,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,sIAAsI;AACtI,MAAM,WAAW,qBAAqB;IACrC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;IAClD;;;;OAIG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,gHAAgH;IAChH,MAAM,EAAE,eAAe,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrE;AAED,sFAAsF;AACtF,MAAM,WAAW,QAAQ;IACxB,QAAQ,EAAE,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC/D,MAAM,EAAE,eAAe,CAAC;IACxB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,uBAAuB,CAAC;CACxC"}

package/dist/support/ui/schemas/ui-toolkit.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ui-toolkit.js.map

package/dist/support/ui/schemas/ui-toolkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-toolkit.js","sourceRoot":"","sources":["../../../../src/support/ui/schemas/ui-toolkit.ts"],"names":[],"mappings":""}

package/dist/support/ui/showcase.d.ts

@@ -0,0 +1,18 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { VibesUIToolkit, type UIToolkitOutput } from './toolkit.ts';
+export declare const CLI_UI_FORMATS: readonly ["json", "yaml", "table", "markdown"];
+export declare function listCliToolkitMethods(): string[];
+declare function exerciseCliToolkit(ui: VibesUIToolkit): Promise<{
+    methods: string[];
+    formats: readonly ["json", "yaml", "table", "markdown"];
+}>;
+export declare function showcaseCliToolkit(runtime: RuntimeRef, output?: UIToolkitOutput): Promise<{
+    methods: string[];
+    formats: readonly ["json", "yaml", "table", "markdown"];
+}>;
+export declare function readCliToolkitShowcaseCoverage(runtime: RuntimeRef, methods?: readonly string[], runShowcase?: (ui: VibesUIToolkit) => void | PromiseLike<void | Awaited<ReturnType<typeof exerciseCliToolkit>>>): Promise<{
+    ok: boolean;
+    missing: string[];
+}>;
+export {};
+//# sourceMappingURL=showcase.d.ts.map

package/dist/support/ui/showcase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase.d.ts","sourceRoot":"","sources":["../../../src/support/ui/showcase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpE,eAAO,MAAM,cAAc,gDAAiD,CAAC;AAO7E,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAKhD;AAkBD,iBAAe,kBAAkB,CAAC,EAAE,EAAE,cAAc;;;GAgCnD;AAED,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,UAAU,EACnB,MAAM,GAAE,eAAuC;;;GAG/C;AAED,wBAAsB,8BAA8B,CACnD,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,SAAS,MAAM,EAA4B,EACpD,WAAW,GAAE,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAsB;;;GAqCnI"}

package/dist/support/ui/showcase.js

@@ -0,0 +1,101 @@
+import {} from '@vibesdotdev/kernel';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import { cliOutputFormatPlugin } from "./format.plugin.js";
+import { VibesUIToolkit } from "./toolkit.js";
+export const CLI_UI_FORMATS = ['json', 'yaml', 'table', 'markdown'];
+const discardShowcaseOutput = { write: () => undefined };
+/** Members the class declares `private`: prompt plumbing no host surface calls. */
+const PRIVATE_TOOLKIT_MEMBERS = new Set(['promptIO']);
+export function listCliToolkitMethods() {
+    const names = Object.getOwnPropertyNames(VibesUIToolkit.prototype)
+        .filter((name) => name !== 'constructor' && !PRIVATE_TOOLKIT_MEMBERS.has(name))
+        .concat(['createSync']);
+    return [...new Set(names)].sort();
+}
+async function preparedToolkit(runtime, output) {
+    if (!runtime.hasPlugin('cli-output-formats')) {
+        await runtime.registerPlugin(cliOutputFormatPlugin);
+    }
+    const formats = await getVibesClient('cli-output-formats', runtime);
+    await formats.load();
+    return VibesUIToolkit.createSync({
+        mode: 'plain',
+        autoExit: false,
+        terminal: () => undefined,
+        formats,
+        output
+    });
+}
+async function exerciseCliToolkit(ui) {
+    const methods = listCliToolkitMethods();
+    for (const format of CLI_UI_FORMATS) {
+        ui.setFormat(format);
+        ui.info(`cli ui ${format}`);
+        ui.log(`cli ui log ${format}`);
+        ui.success(`cli ui success ${format}`);
+        ui.warn(`cli ui warn ${format}`);
+        ui.warning(`cli ui warning ${format}`);
+        ui.error(`cli ui error ${format}`);
+        ui.json({ format, ok: true });
+        ui.yaml({ format, ok: true });
+        ui.table([{ format, ok: true }], { columns: ['format', 'ok'] });
+        ui.keyValue({ format, ok: true });
+        ui.render([{ format }], { format });
+        const bar = ui.progress(`cli ui progress ${format}`);
+        bar.update(`cli ui progress update ${format}`);
+        bar.complete(`cli ui progress complete ${format}`);
+        bar.fail(`cli ui progress fail ${format}`);
+    }
+    await ui.prompt('cli ui prompt', { default: 'preview' });
+    await ui.password('cli ui password');
+    await ui.confirm('cli ui confirm', false);
+    await ui.select('cli ui select', [{ label: 'One', value: 'one' }], 'one');
+    await ui.multiselect('cli ui multiselect', [{ label: 'One', value: 'one' }]);
+    await ui.withCommand({ name: 'design-system' }, (toolkit) => {
+        toolkit.info('cli ui withCommand');
+    });
+    await ui.withInteractiveCommand({ name: 'design-system' }, (toolkit) => {
+        toolkit.info('cli ui withInteractiveCommand');
+    });
+    return { methods, formats: CLI_UI_FORMATS };
+}
+export async function showcaseCliToolkit(runtime, output = discardShowcaseOutput) {
+    return exerciseCliToolkit(await preparedToolkit(runtime, output));
+}
+export async function readCliToolkitShowcaseCoverage(runtime, methods = listCliToolkitMethods(), runShowcase = exerciseCliToolkit) {
+    const target = await preparedToolkit(runtime, discardShowcaseOutput);
+    const invoked = new Set(['createSync']);
+    function record(method, call) {
+        invoked.add(method);
+        return call();
+    }
+    // Contextual method types retain generic selection, rendering and handler results.
+    const observed = {
+        setFormat: (format) => record('setFormat', () => target.setFormat(format)),
+        info: (message) => record('info', () => target.info(message)),
+        success: (message) => record('success', () => target.success(message)),
+        warn: (message) => record('warn', () => target.warn(message)),
+        warning: (message) => record('warning', () => target.warning(message)),
+        error: (message) => record('error', () => target.error(message)),
+        log: (message) => record('log', () => target.log(message)),
+        prompt: (message, options) => record('prompt', () => target.prompt(message, options)),
+        password: (message, options) => record('password', () => target.password(message, options)),
+        confirm: (message, defaultValue) => record('confirm', () => target.confirm(message, defaultValue)),
+        select: (message, options, defaultValue) => record('select', () => target.select(message, options, defaultValue)),
+        multiselect: (message, options, required) => record('multiselect', () => target.multiselect(message, options, required)),
+        table: (data, options) => record('table', () => target.table(data, options)),
+        json: (data) => record('json', () => target.json(data)),
+        yaml: (data) => record('yaml', () => target.yaml(data)),
+        keyValue: (data) => record('keyValue', () => target.keyValue(data)),
+        render: (data, options) => record('render', () => target.render(data, options)),
+        progress: (message) => record('progress', () => target.progress(message)),
+        withCommand: (command, handler) => record('withCommand', () => target.withCommand(command, handler)),
+        withInteractiveCommand: (command, handler) => record('withInteractiveCommand', () => target.withInteractiveCommand(command, handler))
+    };
+    const instrumented = await preparedToolkit(runtime, discardShowcaseOutput);
+    Object.assign(instrumented, observed);
+    await runShowcase(instrumented);
+    const missing = methods.filter((method) => !invoked.has(method));
+    return { ok: missing.length === 0, missing };
+}
+//# sourceMappingURL=showcase.js.map

package/dist/support/ui/showcase.js.map

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

package/dist/support/ui/table.d.ts

@@ -0,0 +1,28 @@
+/** Boxed text-table rendering: column projection, cell text, and the box rules. */
+import * as z from 'zod/v4';
+/** `table` options: a column list, a title, or `{ columns, title }` (a title on the object form is honored too). */
+export declare const TableOptionsSchema: z.ZodUnion<readonly [z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<{
+    columns: string[];
+    title: undefined;
+}, string[]>>, z.ZodPipe<z.ZodString, z.ZodTransform<{
+    title: string;
+    columns: undefined;
+}, string>>, z.ZodObject<{
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodPipe<z.ZodUndefined, z.ZodTransform<{
+    columns: undefined;
+    title: undefined;
+}, undefined>>]>;
+/**
+ * A table row reduced to `columns`, read off the row itself (own or inherited
+ * fields alike); a primitive row is shown as itself.
+ */
+export declare function projectColumns<TRow>(row: TRow, columns: readonly string[]): TRow | Record<string, TRow[keyof TRow] | undefined>;
+/**
+ * Render rows as a boxed text table. Object rows contribute their own keys as
+ * columns, in first-seen order; primitive rows are shown in a `Values` column.
+ * Projected rows (`table(rows, columns)`) carry exactly the requested columns.
+ */
+export declare function formatTable<TRow>(rows: readonly TRow[]): string;
+//# sourceMappingURL=table.d.ts.map

package/dist/support/ui/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/support/ui/table.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,oHAAoH;AACpH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;gBAK7B,CAAC;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAI/H;AAqBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE,GAAG,MAAM,CA+B/D"}

package/dist/support/ui/table.js

@@ -0,0 +1,74 @@
+/** Boxed text-table rendering: column projection, cell text, and the box rules. */
+import * as z from 'zod/v4';
+/** `table` options: a column list, a title, or `{ columns, title }` (a title on the object form is honored too). */
+export const TableOptionsSchema = z.union([
+    z.array(z.string()).transform((columns) => ({ columns, title: undefined })),
+    z.string().transform((title) => ({ title, columns: undefined })),
+    z.object({ columns: z.array(z.string()).optional(), title: z.string().optional() }),
+    z.undefined().transform(() => ({ columns: undefined, title: undefined }))
+]);
+/**
+ * A table row reduced to `columns`, read off the row itself (own or inherited
+ * fields alike); a primitive row is shown as itself.
+ */
+export function projectColumns(row, columns) {
+    if (Object(row) !== row)
+        return row;
+    const source = Object(row);
+    return Object.fromEntries(columns.map((column) => [column, column in source ? source[column] : undefined]));
+}
+/** A cell value printed as itself: text, numbers, booleans, bigints and `null`. */
+const ScalarCellSchema = z.union([z.string(), z.number(), z.boolean(), z.bigint(), z.null()]);
+/** The column a primitive row (a number, a string, `null`) is shown in. */
+const VALUES_COLUMN = 'Values';
+/** One cell's text: scalars as themselves, `undefined` empty, anything else as JSON; always one line. */
+function cellText(value) {
+    if (value === undefined)
+        return '';
+    const scalar = ScalarCellSchema.safeParse(value);
+    const text = scalar.success ? String(scalar.data) : (JSON.stringify(value) ?? '');
+    return text.replace(/\r?\n/g, ' ');
+}
+/** Display width in code points (a box column is padded to its widest cell). */
+function textWidth(text) {
+    return Array.from(text).length;
+}
+/**
+ * Render rows as a boxed text table. Object rows contribute their own keys as
+ * columns, in first-seen order; primitive rows are shown in a `Values` column.
+ * Projected rows (`table(rows, columns)`) carry exactly the requested columns.
+ */
+export function formatTable(rows) {
+    const columns = [];
+    let primitives = false;
+    for (const row of rows) {
+        if (Object(row) !== row) {
+            primitives = true;
+            continue;
+        }
+        for (const key of Object.keys(Object(row)))
+            if (!columns.includes(key))
+                columns.push(key);
+    }
+    if (primitives)
+        columns.push(VALUES_COLUMN);
+    if (columns.length === 0)
+        return '(no rows)';
+    const cells = rows.map((row) => {
+        if (Object(row) !== row)
+            return columns.map((column) => (column === VALUES_COLUMN ? cellText(row) : ''));
+        const record = Object(row);
+        return columns.map((column) => (Object.hasOwn(record, column) ? cellText(record[column]) : ''));
+    });
+    const widths = columns.map((column, index) => Math.max(textWidth(column), ...cells.map((line) => textWidth(line[index] ?? ''))));
+    const rule = (left, middle, right) => `${left}${widths.map((width) => '─'.repeat(width + 2)).join(middle)}${right}`;
+    const line = (values) => `│${values.map((value, index) => ` ${value}${' '.repeat((widths[index] ?? 0) - textWidth(value))} `).join('│')}│`;
+    return [
+        rule('┌', '┬', '┐'),
+        line(columns),
+        rule('├', '┼', '┤'),
+        ...cells.map(line),
+        rule('└', '┴', '┘')
+    ].join('\n');
+}
+//# sourceMappingURL=table.js.map

package/dist/support/ui/table.js.map

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

package/dist/support/ui/toolkit.d.ts

@@ -0,0 +1,56 @@
+import { type RenderOptions } from '../../schemas/output-format.ts';
+import type { PromptOptions, ConfirmMessage, SelectionEntry } from '../../schemas/prompts.ts';
+import type { PasswordPromptOptions } from '@vibesdotdev/cli-contracts/context';
+export type { VibesUIToolkitOptions, CLIProgressReporter, UIToolkitOutput } from './schemas/ui-toolkit.ts';
+import type { CLIProgressReporter, VibesUIToolkitOptions } from './schemas/ui-toolkit.ts';
+export declare class VibesUIToolkit {
+    private format;
+    private readonly formats;
+    private readonly terminal;
+    private readonly sink;
+    private readonly terminalInput;
+    constructor(options: VibesUIToolkitOptions);
+    /** The prompt surface's inputs, under its named owner contract. */
+    private promptIO;
+    static createSync(options: VibesUIToolkitOptions): VibesUIToolkit;
+    setFormat(format: string): void;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    warning(message: string): void;
+    error(message: string): void;
+    log(message: string): void;
+    prompt(message: string, options?: PromptOptions): Promise<string | null>;
+    password(message: string, options?: PasswordPromptOptions): Promise<string | null>;
+    confirm(message: ConfirmMessage, defaultValue?: boolean): Promise<boolean>;
+    select<T>(message: string, options: SelectionEntry<T>[], defaultValue?: T): Promise<T | null>;
+    multiselect<T>(message: string, options: SelectionEntry<T>[], required?: boolean): Promise<T[]>;
+    /**
+     * Render rows through the formatter selected for the current format. The
+     * formatter owns table rendering; `table` is optional on its contract, so a
+     * replacement that supplies only render() renders the table data itself, with
+     * the declared options preserved.
+     */
+    table<TRow>(data: TRow[], options?: {
+        columns?: string[];
+        title?: string;
+    } | string | string[]): void;
+    /**
+     * Render a value in a caller-selected format. Convenience over `json`/`yaml`/
+     * `table` for command impls that defer format to an `--output` flag.
+     */
+    render<TData>(data: TData, options?: RenderOptions): void;
+    json<TData>(data: TData): void;
+    yaml<TData>(data: TData): void;
+    keyValue<TValue>(data: Record<string, TValue>): void;
+    progress(message?: string): CLIProgressReporter;
+    withCommand<T>(_command: {
+        name?: string;
+        description?: string;
+    }, handler: (toolkit: VibesUIToolkit) => Promise<T> | T): Promise<T>;
+    withInteractiveCommand<T>(command: {
+        name?: string;
+        description?: string;
+    }, handler: (toolkit: VibesUIToolkit) => Promise<T> | T): Promise<T>;
+}
+//# sourceMappingURL=toolkit.d.ts.map

package/dist/support/ui/toolkit.d.ts.map

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

package/dist/support/ui/toolkit.js

@@ -0,0 +1,130 @@
+/**
+ * `VibesUIToolkit`: terminal formatting (json/yaml/table/markdown) and
+ * interactive prompts, writing through a caller-supplied output channel.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { OutputFormatSchema, RenderOptionsSchema } from "../../schemas/output-format.js";
+import { renderWithFormatter } from "./formats.js";
+import { TableOptionsSchema } from "./table.js";
+import { promptConfirm, promptMultiselect, promptPassword, promptSelect, promptValue } from "./prompts.js";
+/** One line to the toolkit's output channel. */
+function writeLine(output, channel, message) {
+    output.write(channel, `${message}\n`);
+}
+function unavailableFormat() {
+    throw new CapabilityError('Output format is unavailable or has not been activated.', 'NOT_FOUND', {
+        reason: 'cli-output-format-unavailable'
+    });
+}
+export class VibesUIToolkit {
+    format = 'table';
+    formats;
+    terminal;
+    sink;
+    terminalInput;
+    constructor(options) {
+        this.formats = options.formats;
+        this.terminal = options.terminal;
+        this.sink = options.output;
+        this.terminalInput = options.terminalInput;
+    }
+    /** The prompt surface's inputs, under its named owner contract. */
+    promptIO() {
+        return { terminal: this.terminal, output: this.sink, terminalInput: this.terminalInput };
+    }
+    static createSync(options) {
+        return new VibesUIToolkit(options);
+    }
+    setFormat(format) {
+        this.format = OutputFormatSchema.parse(format);
+    }
+    info(message) {
+        writeLine(this.sink, 'stdout', message);
+    }
+    success(message) {
+        writeLine(this.sink, 'stdout', message);
+    }
+    warn(message) {
+        writeLine(this.sink, 'stderr', message);
+    }
+    warning(message) {
+        this.warn(message);
+    }
+    error(message) {
+        writeLine(this.sink, 'stderr', message);
+    }
+    log(message) {
+        writeLine(this.sink, 'stdout', message);
+    }
+    async prompt(message, options = {}) {
+        return promptValue(this.promptIO(), message, options);
+    }
+    async password(message, options = {}) {
+        return promptPassword(this.promptIO(), message, options);
+    }
+    async confirm(message, defaultValue = false) {
+        return promptConfirm(this.promptIO(), message, defaultValue);
+    }
+    async select(message, options, defaultValue) {
+        return promptSelect(this.promptIO(), message, options, defaultValue);
+    }
+    async multiselect(message, options, required = false) {
+        return promptMultiselect(this.promptIO(), message, options, required);
+    }
+    /**
+     * Render rows through the formatter selected for the current format. The
+     * formatter owns table rendering; `table` is optional on its contract, so a
+     * replacement that supplies only render() renders the table data itself, with
+     * the declared options preserved.
+     */
+    table(data, options) {
+        const { title, columns } = TableOptionsSchema.parse(options);
+        const renderOptions = { table: { data, columns, title } };
+        // The selected formatter owns table rendering; `table` is optional on its
+        // contract, so a replacement that supplies only render() renders the table
+        // data itself, with the declared options preserved. A standalone toolkit
+        // requires an activated formatter from the runtime owner.
+        const formatter = this.formats?.formatter(this.format) ?? unavailableFormat();
+        if (formatter.table) {
+            writeLine(this.sink, 'stdout', formatter.table(data, renderOptions));
+            return;
+        }
+        const rendered = renderWithFormatter(data, formatter, renderOptions);
+        writeLine(this.sink, 'stdout', title ? `${title}\n${rendered}` : rendered);
+    }
+    /**
+     * Render a value in a caller-selected format. Convenience over `json`/`yaml`/
+     * `table` for command impls that defer format to an `--output` flag.
+     */
+    render(data, options = {}) {
+        const parsed = RenderOptionsSchema.parse(options);
+        const format = parsed.format ?? this.format;
+        const formatter = this.formats?.formatter(format) ?? unavailableFormat();
+        writeLine(this.sink, 'stdout', renderWithFormatter(data, formatter, { table: parsed.table }));
+    }
+    json(data) {
+        this.render(data, { format: 'json' });
+    }
+    yaml(data) {
+        this.render(data, { format: 'yaml' });
+    }
+    keyValue(data) {
+        this.table(Object.entries(data).map(([key, value]) => ({ key, value })));
+    }
+    progress(message) {
+        if (message)
+            writeLine(this.sink, 'stdout', message);
+        return {
+            update: (nextMessage) => nextMessage && writeLine(this.sink, 'stdout', nextMessage),
+            complete: (nextMessage) => nextMessage && writeLine(this.sink, 'stdout', nextMessage),
+            fail: (nextMessage) => nextMessage && writeLine(this.sink, 'stderr', nextMessage)
+        };
+    }
+    async withCommand(_command, handler) {
+        return await handler(this);
+    }
+    async withInteractiveCommand(command, handler) {
+        return this.withCommand(command, handler);
+    }
+}
+//# sourceMappingURL=toolkit.js.map

package/dist/support/ui/toolkit.js.map

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

package/dist/support/vibesdev/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/support/vibesdev/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/support/vibesdev/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/support/vibesdev/index.js

@@ -0,0 +1,3 @@
+// vibesdev npm alias surface (see bin/)
+export {};
+//# sourceMappingURL=index.js.map

package/dist/support/vibesdev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/support/vibesdev/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,CAAC"}

package/dist/surface/CLISurface.d.ts

@@ -1,16 +1,90 @@
+export { argvWantsJson } from './failure-output.ts';
 import { Command } from 'commander';
-import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
-import type { CLISurfaceOptions } from '../schemas/surface';
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import type { CLIInvocationObserver, CLIInvocationPreparer, CLISurfaceOptions } from '../schemas/surface.ts';
+export { buildJsonFailureEnvelope, writeJsonEnvelope, reportBootstrapFailure } from './failure-output.ts';
+export type { JsonFailureEnvelope, CliFailureEnvelope, ReportBootstrapFailureOptions } from './schemas/CLISurface.ts';
+export { mapKnownError, renderCliFailure } from './failure-report.ts';
 export declare class CLISurface {
     private runtime;
     private program;
     private options;
     private groups;
     private groupDescriptors;
+    private readonly commandRecommendations;
     private patternResolver;
     private initialized;
+    private runtimeWriter;
+    private readonly invocationController;
+    private readonly invocationDescriptors;
+    private readonly invocationPreparers;
+    /** The overlay the dispatched action runs with; set once its preparation completes. */
+    private actionInvocation;
+    /** The host env snapshot failure text is scrubbed against; read before any runtime this surface holds is disposed. */
+    private capturedHostEnv;
+    /** The host output plane this surface installed, and the runtime it was resolved on (its methods refuse once that runtime is disposed). */
+    private outputPlane;
     constructor(runtime: VibesRuntime, program: Command, options?: CLISurfaceOptions);
+    /** The host env snapshot, read once while the held runtime is live. */
+    private hostEnv;
+    /**
+     * The runtime the selected action runs on: the host's CLI runtime, or the
+     * serve host a serve command's transition booted (rc02-rc03 §2.3).
+     */
+    get activeRuntime(): VibesRuntime;
+    setInvocationObserver<Token>(observer: CLIInvocationObserver<Token> | undefined): void;
+    /**
+     * Observer failures this surface could not log because the action's runtime
+     * had no logging to take them: typed `UNAVAILABLE`
+     * `observer-failure-unlogged` diagnostics (value-free observer facts in
+     * `details`, the logging refusal as `cause`). They never change an outcome.
+     */
+    get invocationDiagnostics(): readonly CapabilityError[];
+    setInvocationPreparer(preparer: CLIInvocationPreparer | undefined): void;
+    addInvocationPreparer(preparer: CLIInvocationPreparer): void;
+    prependInvocationPreparer(preparer: CLIInvocationPreparer): void;
     initialize(): Promise<void>;
-    run(argv?: string[]): Promise<void>;
+    run(argv: string[]): Promise<number>;
+    /**
+     * Whether this invocation already put its JSON document on stdout, through
+     * the runtime its command was handed (`context.runtime`: the serve host
+     * after a serve transition), including the canonically bound free form.
+     */
+    private jsonDocumentWritten;
+    /**
+     * Where the surface writes: the executable host's output, else the text
+     * output of the runtime it holds (resolved by `resolveWriter` as a run
+     * starts, and again when a serve transition swaps the runtime).
+     */
+    private get writer();
+    /** Resolve the held runtime's text output as the surface's writer when no host output was handed. */
+    private resolveWriter;
+    /**
+     * Join every tracked write: through the host's own output when it handed
+     * one (usable after any disposal), else through the installed plane while
+     * the runtime it was resolved on is live.
+     */
+    private flushOutput;
+    /**
+     * Answer help or dispatch the selected action. Answers the exit code a help
+     * path chose (`undefined` when the action ran and chose none); throws what
+     * Commander or the action threw.
+     */
+    private dispatch;
+    /**
+     * Close the invocation with the failure's outcome, render the failure once
+     * (a JSON envelope under --json, otherwise the one renderer's text), and
+     * answer the exit code it projects to.
+     */
+    private reportRunFailure;
+    /**
+     * The host's exit-boundary work (disposal of the active runtime). Its
+     * failure is a failure of the invocation: reported once through the one
+     * renderer — an `AggregateError` lists each plugin and its typed reason —
+     * and the exit code becomes non-zero. It never escapes as an unhandled
+     * rejection with only the aggregate's message.
+     */
+    private finishBeforeAutoExit;
 }
 //# sourceMappingURL=CLISurface.d.ts.map