@vibesdotdev/cli 0.0.2 → 1.0.0-rc.2

package/dist/commands/runtime/codegen.command.impl.d.ts

@@ -1,4 +1,17 @@
-export declare const runtimeCodegenCommandImpl: import("@vibesdotdev/runtime").RuntimeImplementationWrapper<{
-    execute: (args: Record<string, unknown>, opts: Record<string, unknown>) => Promise<void>;
+import type { CommandContext, CommandOptions } from '../../schemas/surface.ts';
+/**
+ * `runtime codegen`: the request parses through the owning schema, generation
+ * runs against the live runtime, and a failure is the typed refusal `generate`
+ * throws, which the CLI surface reports once (message, recovery, exit code).
+ *
+ * The command returns flat delivery metadata through the `data` boundary.
+ * The CLI renders it once in the inherited table format by default or through
+ * the selected runtime formatter when requested. `--json` uses the selected
+ * JSON formatter; the command writes no separate success line.
+ */
+export declare const runtimeCodegenCommandImpl: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<{
+    outputBoundary: string;
+    execute: (args: CommandOptions, opts: CommandOptions, context: CommandContext) => Promise<import("./codegen.ts").RuntimeCodegenResult>;
 }>;
+export default runtimeCodegenCommandImpl;
 //# sourceMappingURL=codegen.command.impl.d.ts.map

package/dist/commands/runtime/codegen.command.impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.command.impl.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/codegen.command.impl.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,yBAAyB;oBAId,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAkC5E,CAAC"}
+{"version":3,"file":"codegen.command.impl.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/codegen.command.impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/E;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;oBAKd,cAAc,QAAQ,cAAc,WAAW,cAAc;EAKnF,CAAC;AAEH,eAAe,yBAAyB,CAAC"}

package/dist/commands/runtime/codegen.command.impl.js

@@ -1,39 +1,26 @@
-import { createRuntimeImplementation } from '@vibesdotdev/runtime';
+import { createRuntimeImplementation } from '@vibesdotdev/kernel';
 import { generate } from "./codegen.js";
+import { runtimeCodegenRequest } from "../../schemas/runtime-codegen.js";
+/**
+ * `runtime codegen`: the request parses through the owning schema, generation
+ * runs against the live runtime, and a failure is the typed refusal `generate`
+ * throws, which the CLI surface reports once (message, recovery, exit code).
+ *
+ * The command returns flat delivery metadata through the `data` boundary.
+ * The CLI renders it once in the inherited table format by default or through
+ * the selected runtime formatter when requested. `--json` uses the selected
+ * JSON formatter; the command writes no separate success line.
+ */
 export const runtimeCodegenCommandImpl = createRuntimeImplementation({
     id: 'runtime-codegen',
     kind: 'cli/command',
     implementation: {
-        execute: async (args, opts) => {
-            // Create a mock command and context for the registration function. The mock only
-            // needs to satisfy the chained shape that `generate()` invokes; widening through
-            // `unknown` keeps the cast explicit rather than relying on `any`.
-            const mockCommand = {
-                command: () => ({
-                    description: () => ({
-                        option: () => ({
-                            action: (handler) => handler()
-                        })
-                    })
-                })
-            };
-            const mockContext = {
-                ui: {
-                    success: (msg) => process.stdout.write(`✅ ${msg}\n`),
-                    error: (msg) => {
-                        process.stderr.write(`❌ ${msg}\n`);
-                        throw new Error(msg);
-                    }
-                }
-            };
-            try {
-                await generate();
-                mockContext.ui.success('Runtime codegen completed successfully');
-            }
-            catch (error) {
-                mockContext.ui.error(`Runtime codegen failed: ${error instanceof Error ? error.message : String(error)}`);
-            }
+        outputBoundary: 'data',
+        execute: async (args, opts, context) => {
+            const result = await generate(context.runtime, runtimeCodegenRequest(opts, args.destination ?? opts.destination));
+            return result;
         }
     }
 });
+export default runtimeCodegenCommandImpl;
 //# sourceMappingURL=codegen.command.impl.js.map

package/dist/commands/runtime/codegen.command.impl.js.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.command.impl.js","sourceRoot":"","sources":["../../../src/commands/runtime/codegen.command.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;IACpE,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,aAAa;IACnB,cAAc,EAAE;QACf,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,IAA6B,EAAE,EAAE;YAC/E,iFAAiF;YACjF,iFAAiF;YACjF,kEAAkE;YAClE,MAAM,WAAW,GAAG;gBACnB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;oBACf,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;wBACnB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;4BACd,MAAM,EAAE,CAAC,OAA4B,EAAE,EAAE,CAAC,OAAO,EAAE;yBACnD,CAAC;qBACF,CAAC;iBACF,CAAC;aACoB,CAAC;YAExB,MAAM,WAAW,GAAG;gBACnB,EAAE,EAAE;oBACH,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;oBAC5D,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE;wBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;wBACnC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;oBACtB,CAAC;iBACD;aAC4B,CAAC;YAE/B,IAAI,CAAC;gBACJ,MAAM,QAAQ,EAAE,CAAC;gBACjB,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;YAClE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,WAAW,CAAC,EAAE,CAAC,KAAK,CACnB,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnF,CAAC;YACH,CAAC;QACF,CAAC;KACD;CACD,CAAC,CAAC"}
+{"version":3,"file":"codegen.command.impl.js","sourceRoot":"","sources":["../../../src/commands/runtime/codegen.command.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;IACpE,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,aAAa;IACnB,cAAc,EAAE;QACf,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,KAAK,EAAE,IAAoB,EAAE,IAAoB,EAAE,OAAuB,EAAE,EAAE;YACtF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAClH,OAAO,MAAM,CAAC;QACf,CAAC;KACD;CACD,CAAC,CAAC;AAEH,eAAe,yBAAyB,CAAC"}

package/dist/commands/runtime/codegen.d.ts

@@ -1,17 +1,13 @@
-#!/usr/bin/env bun
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import type { CommandOptions } from '../../schemas/surface.ts';
+import { type RuntimeCodegenInput, type RuntimeCodegenResult } from '../../schemas/runtime-codegen.ts';
+export * from '../../schemas/runtime-codegen.ts';
 /**
- * Runtime Codegen Command
- *
- * Thin wrapper around the canonical runtime bundle codegen script.
- * The script in /scripts is the single source of truth.
+ * The host supplies import/composition declarations and its owner's result schema
+ * through cli/runtime-codegen-input, or a direct caller supplies input. The
+ * `workspace/static-loader` generator the kernel resolves from the host's
+ * composition validates and renders executable registration; the selected filesystem
+ * owns destination resolution and writing.
  */
-import type { Command } from 'commander';
-import type { RuntimeContext } from '../../core/runtime/context.ts';
-export interface RuntimeCodegenOptions {
-    scope?: string;
-    hardware?: string;
-    verbose?: boolean;
-}
-export declare function generate(options?: RuntimeCodegenOptions): Promise<void>;
-export declare function registerRuntimeCodegenCommand(parent: Command, context: RuntimeContext): Promise<void>;
+export declare function generate(runtime: VibesRuntime, options?: RuntimeCodegenInput | CommandOptions): Promise<RuntimeCodegenResult>;
 //# sourceMappingURL=codegen.d.ts.map

package/dist/commands/runtime/codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/codegen.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AASpE,MAAM,WAAW,qBAAqB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAgCD,wBAAsB,QAAQ,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAED,wBAAsB,6BAA6B,CAClD,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAsBf"}
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/codegen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAWN,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,MAAM,kCAAkC,CAAC;AAE1C,cAAc,kCAAkC,CAAC;AAmBjD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC7B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAmB,GAAG,cAAmB,GAChD,OAAO,CAAC,oBAAoB,CAAC,CAoF/B"}

package/dist/commands/runtime/codegen.declarations.d.ts

@@ -0,0 +1,6 @@
+/** Pure declarations for hosts producing static CLI loaders. */
+export { cliCommandKind, cliGroupKind } from '../cli.kinds.ts';
+export { runtimeCodegenCommandDescriptor } from './codegen.command.descriptor.ts';
+export { runtimeExportCommandDescriptor } from './export.descriptor.ts';
+export { default as runtimeGroup } from './runtime-group.descriptor.ts';
+//# sourceMappingURL=codegen.declarations.d.ts.map

package/dist/commands/runtime/codegen.declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.declarations.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/codegen.declarations.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/commands/runtime/codegen.declarations.js

@@ -0,0 +1,6 @@
+/** Pure declarations for hosts producing static CLI loaders. */
+export { cliCommandKind, cliGroupKind } from "../cli.kinds.js";
+export { runtimeCodegenCommandDescriptor } from "./codegen.command.descriptor.js";
+export { runtimeExportCommandDescriptor } from "./export.descriptor.js";
+export { default as runtimeGroup } from "./runtime-group.descriptor.js";
+//# sourceMappingURL=codegen.declarations.js.map

package/dist/commands/runtime/codegen.declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.declarations.js","sourceRoot":"","sources":["../../../src/commands/runtime/codegen.declarations.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/commands/runtime/codegen.js

@@ -1,65 +1,92 @@
-#!/usr/bin/env bun
+/** CLI delivery for the host-composed static-loader generator. */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { writeRuntimeExport } from "./export/write.js";
+import { RUNTIME_CODEGEN_DEFAULT_DESTINATION, RUNTIME_CODEGEN_INPUT_CONTEXT, STATIC_LOADER_KIND, RuntimeCodegenDeclarationObjectSchema, RuntimeCodegenDeliveryFieldsSchema, RuntimeCodegenOptionsSchema, runtimeCodegenRequest } from "../../schemas/runtime-codegen.js";
+export * from "../../schemas/runtime-codegen.js";
+function missingStaticLoaderGenerator() {
+    return new CapabilityError(`No generator is composed for ${STATIC_LOADER_KIND}; the host must compose a generator plugin.`, 'UNAVAILABLE', { reason: 'static-loader-generator-unavailable', retryable: false });
+}
 /**
- * Runtime Codegen Command
- *
- * Thin wrapper around the canonical runtime bundle codegen script.
- * The script in /scripts is the single source of truth.
+ * The host supplies import/composition declarations and its owner's result schema
+ * through cli/runtime-codegen-input, or a direct caller supplies input. The
+ * `workspace/static-loader` generator the kernel resolves from the host's
+ * composition validates and renders executable registration; the selected filesystem
+ * owns destination resolution and writing.
  */
-import { join, resolve } from 'node:path';
-import { getLogger } from "../../logging.js";
-const logger = getLogger('runtime-codegen');
-const ROOT_DIR = resolve(join(import.meta.dir, '../../../../../../'));
-const CODEGEN_SCRIPT = join(ROOT_DIR, 'scripts/codegen-runtime-bundle.ts');
-function resolveBunBinary() {
-    const whichBun = typeof Bun.which === 'function' ? Bun.which('bun') : null;
-    if (whichBun)
-        return whichBun;
-    return process.execPath || 'bun';
-}
-async function runRuntimeCodegenScript(options = {}) {
-    const scriptExists = await Bun.file(CODEGEN_SCRIPT).exists();
-    if (!scriptExists) {
-        throw new Error(`Runtime codegen script not found: ${CODEGEN_SCRIPT}`);
+export async function generate(runtime, options = {}) {
+    const request = runtimeCodegenRequest(options);
+    let hostContext;
+    if (runtime.hasContext(RUNTIME_CODEGEN_INPUT_CONTEXT)) {
+        hostContext = await runtime.context(RUNTIME_CODEGEN_INPUT_CONTEXT) ?? undefined;
     }
-    const args = [resolveBunBinary(), CODEGEN_SCRIPT];
-    if (options.scope)
-        args.push(options.scope);
-    if (options.hardware)
-        args.push(options.hardware);
-    const proc = Bun.spawn(args, {
-        cwd: ROOT_DIR,
-        stdout: 'inherit',
-        stderr: 'inherit',
-        stdin: 'inherit',
-        env: process.env
-    });
-    const exitCode = await proc.exited;
-    if (exitCode !== 0) {
-        throw new Error(`Runtime codegen script failed with exit code ${exitCode}`);
+    const input = request.input ?? hostContext?.input ?? undefined;
+    if (input === undefined) {
+        throw new CapabilityError('The host must declare static-loader imports through cli/runtime-codegen-input.', 'UNAVAILABLE', {
+            reason: 'runtime-codegen-input-unavailable',
+            retryable: false
+        });
     }
-}
-export async function generate(options = {}) {
-    await runRuntimeCodegenScript(options);
-}
-export async function registerRuntimeCodegenCommand(parent, context) {
-    parent
-        .command('codegen')
-        .description('Generate static runtime loader for compiled binaries')
-        .option('-v, --verbose', 'Enable verbose logging')
-        .option('--scope <scope>', 'Filter generated bundle by runtime surface scope')
-        .option('--hardware <hardware>', 'Filter generated bundle by runtime hardware')
-        .action(async (options) => {
-        if (options.verbose) {
-            logger.info('Running runtime codegen script...');
-        }
-        try {
-            await generate(options);
-            context.ui.success('Runtime codegen completed successfully');
-        }
-        catch (error) {
-            context.ui.error(`Runtime codegen failed: ${error instanceof Error ? error.message : String(error)}`);
-            process.exit(1);
-        }
+    if (!runtime.hasKind(STATIC_LOADER_KIND)) {
+        throw missingStaticLoaderGenerator();
+    }
+    // The kernel selects among composed generators by descriptor; none composed
+    // is absence. A composed loader that fails keeps its own classification.
+    const generator = await runtime
+        .query(STATIC_LOADER_KIND)
+        .enabled()
+        .first();
+    if (!generator)
+        throw missingStaticLoaderGenerator();
+    if (!hostContext) {
+        throw new CapabilityError('The host must supply the static-loader result schema through cli/runtime-codegen-input.', 'UNAVAILABLE', {
+            reason: 'runtime-codegen-result-schema-unavailable',
+            retryable: false
+        });
+    }
+    const declaration = RuntimeCodegenDeclarationObjectSchema.safeParse(input);
+    let generationInput;
+    if (!declaration.success) {
+        generationInput = input;
+    }
+    else {
+        const mergedDeclaration = { ...declaration.data };
+        if (request.scope !== undefined)
+            mergedDeclaration.scope = request.scope;
+        if (request.hardware !== undefined)
+            mergedDeclaration.hardware = request.hardware;
+        generationInput = mergedDeclaration;
+    }
+    const inputOptions = RuntimeCodegenOptionsSchema
+        .pick({ scope: true, hardware: true })
+        .partial()
+        .safeParse(generationInput);
+    const scope = request.scope ?? (inputOptions.success ? inputOptions.data.scope : undefined);
+    const hardware = request.hardware ?? (inputOptions.success ? inputOptions.data.hardware : undefined);
+    const delivery = RuntimeCodegenDeliveryFieldsSchema.parse({
+        destination: request.destination ?? RUNTIME_CODEGEN_DEFAULT_DESTINATION,
+        scope,
+        hardware
     });
+    // Keep generator failures in their original classification. Only a result the
+    // supplied owner schema refuses becomes runtime-codegen-result-invalid.
+    const rawGenerated = await generator.generate(generationInput);
+    const generated = hostContext.resultSchema.safeParse(rawGenerated);
+    if (!generated.success) {
+        throw new CapabilityError("Runtime codegen produced a result outside its owner's declared contract.", 'INTERNAL', {
+            reason: 'runtime-codegen-result-invalid',
+            retryable: false,
+            cause: generated.error
+        });
+    }
+    const { source, ...ownerMetadata } = generated.data;
+    const result = {
+        ...ownerMetadata,
+        ...delivery
+    };
+    const destination = await writeRuntimeExport(runtime, delivery.destination, source);
+    return {
+        ...result,
+        destination
+    };
 }
 //# sourceMappingURL=codegen.js.map

package/dist/commands/runtime/codegen.js.map

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

package/dist/commands/runtime/export/markdown-document.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The markdown being written, and the two rules that make it correct.
+ *
+ * Markdown is whitespace-significant in exactly the way a generator gets it
+ * wrong: runs of blank lines, and table cells that carry a pipe or a newline. Both
+ * are handled here rather than at each call site, so a section can end its own
+ * lines without knowing what the next section starts with, and no table can be
+ * broken by the text it holds.
+ */
+/** A pipe or a newline would break a markdown table row. */
+/** A structured value a document shows verbatim: what `JSON.stringify` accepts. */
+type JsonValue = Parameters<typeof JSON.stringify>[0];
+export declare function escapeCell(value: string): string;
+/** The document being written. */
+export declare class MarkdownDocument {
+    private readonly parts;
+    line(text: string): this;
+    lines(texts: readonly string[]): this;
+    blank(): this;
+    /** A fenced JSON block, which is how a document shows a structured value verbatim. */
+    json(value: JsonValue): this;
+    text(): string;
+}
+export {};
+//# sourceMappingURL=markdown-document.d.ts.map

package/dist/commands/runtime/export/markdown-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-document.d.ts","sourceRoot":"","sources":["../../../../src/commands/runtime/export/markdown-document.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4DAA4D;AAC5D,mFAAmF;AACnF,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,kCAAkC;AAClC,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAKrC,KAAK,IAAI,IAAI;IAKb,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAK5B,IAAI,IAAI,MAAM;CAGd"}

package/dist/commands/runtime/export/markdown-document.js

@@ -0,0 +1,38 @@
+/**
+ * The markdown being written, and the two rules that make it correct.
+ *
+ * Markdown is whitespace-significant in exactly the way a generator gets it
+ * wrong: runs of blank lines, and table cells that carry a pipe or a newline. Both
+ * are handled here rather than at each call site, so a section can end its own
+ * lines without knowing what the next section starts with, and no table can be
+ * broken by the text it holds.
+ */
+export function escapeCell(value) {
+    return value.replace(/\s+/g, ' ').replace(/\|/g, '\\|').trim();
+}
+/** The document being written. */
+export class MarkdownDocument {
+    parts = [];
+    line(text) {
+        this.parts.push(text);
+        return this;
+    }
+    lines(texts) {
+        for (const text of texts)
+            this.line(text);
+        return this;
+    }
+    blank() {
+        this.parts.push('');
+        return this;
+    }
+    /** A fenced JSON block, which is how a document shows a structured value verbatim. */
+    json(value) {
+        this.parts.push('```json', JSON.stringify(value, null, '\t'), '```', '');
+        return this;
+    }
+    text() {
+        return `${this.parts.join('\n').replace(/\n{3,}/g, '\n\n')}\n`;
+    }
+}
+//# sourceMappingURL=markdown-document.js.map

package/dist/commands/runtime/export/markdown-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-document.js","sourceRoot":"","sources":["../../../../src/commands/runtime/export/markdown-document.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC;AAED,kCAAkC;AAClC,MAAM,OAAO,gBAAgB;IACX,KAAK,GAAa,EAAE,CAAC;IAEtC,IAAI,CAAC,IAAY;QAChB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,KAAwB;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,sFAAsF;IACtF,IAAI,CAAC,KAAgB;QACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC;IAChE,CAAC;CACD"}

package/dist/commands/runtime/export/markdown.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The markdown a reader and an agent share.
+ *
+ * Markdown groups the export's facts the way a reader needs them — the summary
+ * first, then scope, then composition, then the tables — while JSON preserves the
+ * exact shape. Both carry the same facts; neither adds one. So the renderer only
+ * decides order and wording, and every number it prints came from the reader.
+ *
+ * It also says what the document is before it shows what it says. A reader who
+ * assumes these counts are a catalogue will draw the wrong conclusion from a
+ * perfectly correct document.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import type { RuntimeExport, RuntimeExportOptions } from './schemas.ts';
+/** The document. */
+export declare function renderRuntimeExportMarkdown(exported: RuntimeExport, runtime: VibesRuntime, options?: RuntimeExportOptions): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/commands/runtime/export/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../../src/commands/runtime/export/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIpE,OAAO,KAAK,EAAsB,aAAa,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAI5F,oBAAoB;AACpB,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,oBAAyB,GAChC,MAAM,CAUR"}

package/dist/commands/runtime/export/markdown.js

@@ -0,0 +1,141 @@
+/**
+ * The markdown a reader and an agent share.
+ *
+ * Markdown groups the export's facts the way a reader needs them — the summary
+ * first, then scope, then composition, then the tables — while JSON preserves the
+ * exact shape. Both carry the same facts; neither adds one. So the renderer only
+ * decides order and wording, and every number it prints came from the reader.
+ *
+ * It also says what the document is before it shows what it says. A reader who
+ * assumes these counts are a catalogue will draw the wrong conclusion from a
+ * perfectly correct document.
+ */
+import { READING_NOTES } from "./reading-notes.js";
+import { exportDescriptors } from "./read.js";
+import { MarkdownDocument, escapeCell } from "./markdown-document.js";
+const DEFAULT_DESCRIPTORS_PER_KIND = 12;
+/** The document. */
+export function renderRuntimeExportMarkdown(exported, runtime, options = {}) {
+    const document = new MarkdownDocument();
+    header(exported, document);
+    summary(exported, document);
+    scopes(exported, document);
+    composition(exported, document);
+    plugins(exported, document, options);
+    kinds(exported, document, options);
+    descriptors(exported, runtime, document, options);
+    return document.text();
+}
+function header(exported, document) {
+    document.line('# Vibes runtime reference').blank();
+    document
+        .line(`Exported by \`vibes runtime export\` at ${exported.generatedAt} from a live runtime in phase ` +
+        `\`${exported.phase}\`. Every fact below was read from that runtime by querying it; nothing is ` +
+        'inferred from a package manifest or a source tree.')
+        .blank()
+        .lines(READING_NOTES);
+}
+function summary(exported, document) {
+    document.line('## Summary').blank();
+    document.lines(['| Fact | Value |', '| --- | --- |']);
+    document.line(`| Phase | \`${exported.phase}\` |`);
+    document.line(`| Plugins composed | ${exported.pluginCount} |`);
+    document.line(`| Kinds registered | ${exported.kindCount} |`);
+    document.line(`| Descriptors held | ${exported.descriptorCount} |`);
+    document.line(`| Loaders attached | ${exported.loaderCount} |`);
+    document.line(`| Disposed | ${exported.disposed} |`).blank();
+}
+function scopes(exported, document) {
+    document.line('## Declared scope').blank();
+    document.line('What the host declared before composition.').blank();
+    document.json(exported.declaredScope);
+    document.line('## Effective scope').blank();
+    document.line('What resolution sees, after composition bound any tier or qualifier.').blank();
+    document.json(exported.effectiveScope);
+}
+function composition(exported, document) {
+    document.line('## Composition').blank();
+    document.line('Which plane selected which plugin. A plane that selected nothing is `[]`.').blank();
+    document.lines(['| Plane | Plugins |', '| --- | --- |']);
+    for (const [plane, ids] of Object.entries(exported.compositionSelections)) {
+        document.line(`| ${plane} | ${ids.length === 0 ? '_(none)_' : ids.map((id) => `\`${id}\``).join(', ')} |`);
+    }
+    document.blank();
+}
+function plugins(exported, document, options) {
+    if (options.noPlugins === true || options.includePlugins === false)
+        return;
+    if (exported.plugins.length === 0)
+        return;
+    document.line('## Plugins').blank();
+    document.line(`${exported.pluginCount} plugins composed into this runtime.`).blank();
+    for (const id of exported.plugins)
+        document.line(`- \`${id}\``);
+    document.blank();
+}
+function kinds(exported, document, options) {
+    if (options.noKinds === true || options.includeKinds === false)
+        return;
+    document.line('## Kinds').blank();
+    document
+        .line('A kind is a category of asset with its own descriptor schema and resolution rules. ' +
+        '`Default` says the kind can answer for a descriptor with no loader of its own; `Resolver` says ' +
+        'it encodes a selection policy; `Ownership` says whether a second registration of the same id is ' +
+        'permitted or refused.')
+        .blank()
+        .lines(['| Kind | Descriptors | Contexts | Default | Resolver | Ownership | Schema |', '| --- | ---: | --- | :---: | :---: | --- | --- |']);
+    for (const kind of exported.kinds) {
+        const contexts = kind.contexts.length === 0 ? '—' : kind.contexts.map((id) => `\`${id}\``).join(', ');
+        document.line(`| \`${kind.id}\` | ${kind.descriptorCount} | ${contexts} | ${kind.hasDefault ? 'yes' : 'no'} | ` +
+            `${kind.hasResolver ? 'yes' : 'no'} | ${kind.descriptorOwnership} | ${kind.schemaName ? `\`${kind.schemaName}\`` : '—'} |`);
+    }
+    document.blank();
+}
+function descriptors(exported, runtime, document, options) {
+    if (options.noDescriptors === true || options.includeDescriptors === false)
+        return;
+    document.line('## Descriptors').blank();
+    document
+        .line('One row per descriptor this runtime holds. Descriptors are declarative identity — the owner ' +
+        'declares them; the runtime resolves them. Loading an implementation is never required to read ' +
+        'this table.')
+        .blank();
+    if (options.kind !== undefined) {
+        for (const descriptor of exportDescriptors(runtime, options.kind))
+            document.line(descriptorRow(descriptor));
+        return;
+    }
+    for (const kind of exported.kinds) {
+        if (kind.descriptorCount === 0)
+            continue;
+        const listed = exportDescriptors(runtime, kind.id, DEFAULT_DESCRIPTORS_PER_KIND);
+        if (listed.length === 0)
+            continue;
+        descriptorTable(kind.id, listed, document);
+        if (kind.descriptorCount > listed.length) {
+            document
+                .blank()
+                .line(`_Showing ${listed.length} of ${kind.descriptorCount}. Re-run with \`--kind ${kind.id}\` for all of them._`);
+        }
+        document.blank();
+    }
+}
+function descriptorTable(kind, listed, document) {
+    document.line(`### \`${kind}\``).blank();
+    document.lines(['| Id | Name | Hardware | Enabled | Description |', '| --- | --- | --- | :---: | --- |']);
+    for (const descriptor of listed) {
+        const name = descriptor.name ? escapeCell(descriptor.name) : '—';
+        const hardware = descriptor.hardware.length === 0 ? '—' : descriptor.hardware.join(', ');
+        document.line(`| \`${descriptor.id}\` | ${name} | ${hardware} | ${descriptor.enabled ? 'yes' : 'no'} | ` +
+            `${escapeCell(descriptor.description ?? '')} |`);
+    }
+}
+/** One descriptor as the list form, for a reader scanning rather than comparing. */
+function descriptorRow(descriptor) {
+    return (`- \`${descriptor.id}\`` +
+        `${descriptor.name ? ` — ${escapeCell(descriptor.name)}` : ''}` +
+        `${descriptor.hardware.length > 0 ? ` (${descriptor.hardware.join(', ')})` : ''}` +
+        `${descriptor.enabled ? '' : ' _(disabled)_'}` +
+        `${descriptor.description ? `\n  ${escapeCell(descriptor.description)}` : ''}`);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/commands/runtime/export/markdown.js.map

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

package/dist/commands/runtime/export/read.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Reading a booted runtime into the export shape.
+ *
+ * Every fact here comes from a live query. `runtime.kindIds()` is the kernel's own
+ * list, `runtime.pluginIds()` is what composition actually selected, and
+ * descriptors come from the query's synchronous projection, which never loads an
+ * implementation. Nothing is recomputed, inferred from a manifest, or read out of
+ * a source tree: a descriptor is listed because the runtime holds it.
+ *
+ * Scope axes use Runtime's JSON reader normalization: optional undefined fields
+ * are omitted, and declared facts remain intact. Descriptor stacks are reported
+ * by identity — id, depth and dynamic status — rather than by their own values,
+ * which may carry private owner data or a live reference.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import type { ExportedDescriptor, RuntimeExport } from './schemas.ts';
+/**
+ * Read this runtime into the export shape.
+ *
+ * A kind with no descriptors is still listed. An empty catalog is evidence about
+ * this boot, and a document that hid it would read as an absence the reader
+ * cannot tell apart from one the export chose not to report.
+ */
+export declare function exportRuntime(runtime: VibesRuntime, kind?: string): RuntimeExport;
+/** Descriptors for `kind`, read without loading any implementation. */
+export declare function exportDescriptors(runtime: VibesRuntime, kind: string, limit?: number): ExportedDescriptor[];
+//# sourceMappingURL=read.d.ts.map

package/dist/commands/runtime/export/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../src/commands/runtime/export/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE,OAAO,KAAK,EAAE,kBAAkB,EAA+B,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnG;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAsCjF;AAoBD,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,kBAAkB,EAAE,CAiB7G"}