@vibesdotdev/cli 0.0.2 → 1.0.0-rc.3

package/dist/core/runtime/shared/options.js

@@ -1,61 +1,106 @@
 /**
  * CLI Option Parsers
  *
- * Pure helpers for normalizing the `Record<string, unknown>` shape that
- * Commander.js / our descriptor-driven CLI surface delivers to command
- * handlers. Every parser returns `undefined` for empty/invalid input so
- * callers can apply their own defaulting.
+ * The parsing boundary for the option values Commander.js / the
+ * descriptor-driven CLI surface delivers to command handlers. Each reader is a
+ * schema over any value (the readers are generic in their input: a handler
+ * passes whatever its options record holds) and returns `undefined` for
+ * empty or invalid input so callers can apply their own defaulting.
+ *
+ * A value that cannot be read at all (a revoked Proxy, a throwing getter on an
+ * array) is refused typed: `INVALID_INPUT` `option-unreadable`, the read's own
+ * failure kept as the cause. Nothing else a reader is handed throws.
  *
  * Canonical home for option parsing per RUNTIME-FIRST-MODULES.md
- * (`packages/cli` owns "the helpers that make runtime-discovered
+ * (`cli` owns "the helpers that make runtime-discovered
  * commands usable in shells"). Feature packages (bridge, expert, etc.)
- * import from `@vibesdotdev/cli/core/runtime/shared/options` rather
+ * import from `@vibesdotdev/cli/cli/runtime/shared/options` rather
  * than maintaining per-package copies.
  */
-export function readString(value) {
-    if (typeof value !== 'string')
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-export function readBoolean(value) {
-    if (typeof value === 'boolean')
-        return value;
-    if (typeof value === 'string') {
-        if (value === 'true')
-            return true;
-        if (value === 'false')
-            return false;
-    }
-    return undefined;
-}
-export function readNumber(value) {
-    if (typeof value === 'number' && Number.isFinite(value))
-        return value;
-    if (typeof value === 'string' && value.trim().length > 0) {
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+/** Text, recognized by `typeof` alone (which runs no Proxy trap). */
+const TextSchema = z.custom((value) => typeof value === 'string');
+const BooleanSchema = z.custom((value) => typeof value === 'boolean');
+const FiniteNumberSchema = z.custom((value) => typeof value === 'number' && Number.isFinite(value));
+/** A list of values; reading a revoked Proxy here throws, which the shared guard refuses typed. */
+const ListSchema = z.custom((value) => Array.isArray(value));
+const Absent = z.unknown().transform(() => undefined);
+/** Trimmed, non-empty text; anything else is absent. */
+const OptionStringSchema = z.union([
+    TextSchema.transform((value) => {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }),
+    Absent
+]);
+/** A boolean, or the exact text `true` / `false`; anything else is absent. */
+const OptionBooleanSchema = z.union([
+    BooleanSchema,
+    TextSchema.transform((value) => (value === 'true' ? true : value === 'false' ? false : undefined)),
+    Absent
+]);
+/** A finite number, or non-blank text that converts to one; anything else is absent. */
+const OptionNumberSchema = z.union([
+    FiniteNumberSchema,
+    TextSchema.transform((value) => {
+        if (value.trim().length === 0)
+            return undefined;
         const parsed = Number(value);
         return Number.isFinite(parsed) ? parsed : undefined;
-    }
-    return undefined;
-}
-export function readStringArray(value) {
-    if (Array.isArray(value)) {
-        const items = value
-            .map((entry) => readString(entry))
-            .filter((entry) => typeof entry === 'string');
+    }),
+    Absent
+]);
+/** The non-empty trimmed text items of a list, or one text value as a list; anything else is absent. */
+const OptionStringArraySchema = z.union([
+    ListSchema.transform((values) => {
+        const items = values
+            .map((entry) => OptionStringSchema.parse(entry))
+            .filter((entry) => entry !== undefined);
         return items.length > 0 ? items : undefined;
-    }
-    const single = readString(value);
-    return single ? [single] : undefined;
-}
-export function splitCsv(value) {
-    const raw = readString(value);
-    if (!raw)
+    }),
+    OptionStringSchema.transform((value) => (value === undefined ? undefined : [value]))
+]);
+/** Comma-separated text as its non-empty trimmed items; anything else is absent. */
+const OptionCsvSchema = OptionStringSchema.transform((raw) => {
+    if (raw === undefined)
         return undefined;
     const items = raw
         .split(',')
         .map((entry) => entry.trim())
         .filter((entry) => entry.length > 0);
     return items.length > 0 ? items : undefined;
+});
+/**
+ * The one guard every reader runs through: the schemas above never fail on
+ * shape, so a throw here is a value that could not be read; it is refused
+ * typed with that failure as its cause.
+ */
+function readOption(schema, value) {
+    try {
+        return schema.parse(value);
+    }
+    catch (error) {
+        throw new CapabilityError('A command option value could not be read.', 'INVALID_INPUT', {
+            reason: 'option-unreadable',
+            retryable: false,
+            cause: error
+        });
+    }
+}
+export function readString(value) {
+    return readOption(OptionStringSchema, value);
+}
+export function readBoolean(value) {
+    return readOption(OptionBooleanSchema, value);
+}
+export function readNumber(value) {
+    return readOption(OptionNumberSchema, value);
+}
+export function readStringArray(value) {
+    return readOption(OptionStringArraySchema, value);
+}
+export function splitCsv(value) {
+    return readOption(OptionCsvSchema, value);
 }
 //# sourceMappingURL=options.js.map

package/dist/core/runtime/shared/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/core/runtime/shared/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,UAAU,UAAU,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK;aACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aACjC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;QAChE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACtC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,KAAK,GAAG,GAAG;SACf,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/core/runtime/shared/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qEAAqE;AACrE,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAS,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAC3F,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAU,CAAC,KAAK,EAAoB,EAAE,CAAC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC;AACjG,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAClC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC/E,CAAC;AACF,mGAAmG;AACnG,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAqB,CAAC,KAAK,EAA+B,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9G,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,GAAc,EAAE,CAAC,SAAS,CAAC,CAAC;AAEjE,wDAAwD;AACxD,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC;IAClC,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,EAAsB,EAAE;QAClD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC,CAAC;IACF,MAAM;CACN,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC;IACnC,aAAa;IACb,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,EAAuB,EAAE,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvH,MAAM;CACN,CAAC,CAAC;AAEH,wFAAwF;AACxF,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC;IAClC,kBAAkB;IAClB,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,EAAsB,EAAE;QAClD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC,CAAC;IACF,MAAM;CACN,CAAC,CAAC;AAEH,wGAAwG;AACxG,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC;IACvC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,EAAwB,EAAE;QACrD,MAAM,KAAK,GAAG,MAAM;aAClB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;aAC/C,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,CAAC,CAAC;IACF,kBAAkB,CAAC,SAAS,CAAC,CAAC,KAAK,EAAwB,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;CAC1G,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,eAAe,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC,GAAG,EAAwB,EAAE;IAClF,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,KAAK,GAAG,GAAG;SACf,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,SAAS,UAAU,CAAgB,MAAyB,EAAE,KAAY;IACzE,IAAI,CAAC;QACJ,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,eAAe,CAAC,2CAA2C,EAAE,eAAe,EAAE;YACvF,MAAM,EAAE,mBAAmB;YAC3B,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CAAQ,KAAY;IAC7C,OAAO,UAAU,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,WAAW,CAAQ,KAAY;IAC9C,OAAO,UAAU,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAQ,KAAY;IAC7C,OAAO,UAAU,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAQ,KAAY;IAClD,OAAO,UAAU,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAQ,KAAY;IAC3C,OAAO,UAAU,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/dist/design-inventory.d.ts

@@ -0,0 +1,23 @@
+import { type DesignInventoryImplementation } from '@vibesdotdev/design-tokens/inventory';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type CliDesignGenerationInput, type CliDesignGenerationResult, type CliDesignInventory, type CliDesignInventoryInput } from './schemas/design-inventory.ts';
+import { CLI_UI_FORMATS, listCliToolkitMethods, readCliToolkitShowcaseCoverage } from './support/ui/showcase.ts';
+export * from './schemas/design-inventory.ts';
+export { CLI_UI_FORMATS, listCliToolkitMethods, readCliToolkitShowcaseCoverage };
+export declare const cliDesignInventoryDescriptor: {
+    id: string;
+    kind: "design/inventory";
+    packageName: string;
+    source: string;
+    enabled: boolean;
+    name?: string | undefined;
+    description?: string | undefined;
+};
+/** Read the owner's live toolkit and showcase through the handed runtime. */
+export declare function readCliDesignInventory(runtime: RuntimeRef, input: CliDesignInventoryInput): Promise<CliDesignInventory>;
+/** Check or regenerate the existing CLI projection without booting a CLI host. */
+export declare function generateCliDesignInventory(runtime: RuntimeRef, input: CliDesignGenerationInput): Promise<CliDesignGenerationResult>;
+export declare const cliDesignInventoryImplementation: DesignInventoryImplementation<CliDesignInventory, CliDesignGenerationResult>;
+export declare const cliDesignInventoryPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default cliDesignInventoryPlugin;
+//# sourceMappingURL=design-inventory.d.ts.map

package/dist/design-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-inventory.d.ts","sourceRoot":"","sources":["../src/design-inventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAMN,KAAK,6BAA6B,EAClC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAIN,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACN,cAAc,EACd,qBAAqB,EACrB,8BAA8B,EAC9B,MAAM,0BAA0B,CAAC;AAElC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,CAAC;AAEjF,eAAO,MAAM,4BAA4B;;;;;;;;CAOvC,CAAC;AAoBH,6EAA6E;AAC7E,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,uBAAuB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED,kFAAkF;AAClF,wBAAsB,0BAA0B,CAC/C,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,wBAAwB,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CAepC;AAED,eAAO,MAAM,gCAAgC,EAAE,6BAA6B,CAC3E,kBAAkB,EAClB,yBAAyB,CAIzB,CAAC;AAEF,eAAO,MAAM,wBAAwB,6CAUnC,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/design-inventory.js

@@ -0,0 +1,66 @@
+import { DESIGN_INVENTORY_KIND_ID, DesignInventoryDescriptorSchema, designInventoryKind, openDesignInventoryOwner, syncDesignInventoryProjections } from '@vibesdotdev/design-tokens/inventory';
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import { CliDesignGenerationInputSchema, CliDesignInventoryInputSchema, CliDesignInventorySchema } from "./schemas/design-inventory.js";
+import { CLI_UI_FORMATS, listCliToolkitMethods, readCliToolkitShowcaseCoverage } from "./support/ui/showcase.js";
+export * from "./schemas/design-inventory.js";
+export { CLI_UI_FORMATS, listCliToolkitMethods, readCliToolkitShowcaseCoverage };
+export const cliDesignInventoryDescriptor = DesignInventoryDescriptorSchema.parse({
+    id: 'cli',
+    kind: DESIGN_INVENTORY_KIND_ID,
+    packageName: '@vibesdotdev/cli',
+    source: '@vibesdotdev/cli/design-inventory',
+    name: 'CLI Design Inventory',
+    description: 'Canonical CLI toolkit method and format inventory provider.'
+});
+async function openCliInventoryOwner(runtime, root) {
+    return openDesignInventoryOwner(runtime, {
+        root,
+        packageName: '@vibesdotdev/cli',
+        relativeRootReason: 'cli-inventory-root-relative',
+        relativeRootMessage: 'CLI inventory requires an absolute owner root.'
+    });
+}
+async function currentCliInventory(runtime) {
+    const methods = listCliToolkitMethods();
+    return CliDesignInventorySchema.parse({
+        methods,
+        formats: [...CLI_UI_FORMATS],
+        showcaseCoverage: await readCliToolkitShowcaseCoverage(runtime, methods)
+    });
+}
+/** Read the owner's live toolkit and showcase through the handed runtime. */
+export async function readCliDesignInventory(runtime, input) {
+    const { root } = CliDesignInventoryInputSchema.parse(input);
+    await openCliInventoryOwner(runtime, root);
+    return currentCliInventory(runtime);
+}
+/** Check or regenerate the existing CLI projection without booting a CLI host. */
+export async function generateCliDesignInventory(runtime, input) {
+    const { root, check } = CliDesignGenerationInputSchema.parse(input);
+    const host = await openCliInventoryOwner(runtime, root);
+    const { methods, formats } = await currentCliInventory(runtime);
+    const content = [
+        '/** Generated by @vibesdotdev/cli/design-inventory. Do not edit. */',
+        'export const CLI_TOOLKIT_METHODS = ' + JSON.stringify(methods, null, '\t') + ' as const;',
+        'export const CLI_UI_FORMATS = ' + JSON.stringify(formats, null, '\t') + ' as const;',
+        ''
+    ].join('\n');
+    return syncDesignInventoryProjections(host, [{ path: 'src/support/cli-inventory.generated.ts', content }], check);
+}
+export const cliDesignInventoryImplementation = {
+    read: (runtime, input) => readCliDesignInventory(runtime, input),
+    generate: (runtime, input) => generateCliDesignInventory(runtime, input)
+};
+export const cliDesignInventoryPlugin = createRuntimePlugin({
+    id: 'cli-design-inventory',
+    name: 'CLI Design Inventory',
+    kinds: [designInventoryKind],
+    descriptors: [cliDesignInventoryDescriptor],
+    async onRegister(runtime) {
+        runtime.registerLoader(DESIGN_INVENTORY_KIND_ID, cliDesignInventoryDescriptor.id, async () => ({
+            impl: cliDesignInventoryImplementation
+        }));
+    }
+});
+export default cliDesignInventoryPlugin;
+//# sourceMappingURL=design-inventory.js.map

package/dist/design-inventory.js.map

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

package/dist/index.d.ts

@@ -1,22 +1,13 @@
-/**
- * CLI Module
- *
- * The CLI surface for the universal runtime.
- * Integrates Commander.js with runtime-discovered commands.
- *
- * Usage:
- * ```typescript
- * import { createVibesCliApp } from '@vibesdotdev/cli/bootstrap';
- *
- * const app = await createVibesCliApp();
- * await app.cli.run(process.argv);
- * ```
- */
-export { createVibesCliApp, type VibesCliAppOptions, type VibesCliApp, type CliPluginLoader } from './bootstrap';
-export { CLISurface, type CLISurfaceOptions, type CommandContext } from './surface';
-export { default as cliPlugin } from './cli.plugin';
-export { registerCLIProviders, requestCLIExit, detectOutputFormat, shouldKeepAlive, resetKeepAlive, CLIExitSignal, type CLIProviderOptions, type UIContext, type LoggerContext, type AppContext, type CLIContext } from './providers';
-export { PatternResolver, createPatternResolver, isPatternDescriptor, getPatternType, type PatternImplementation, type CLIPatternDescriptor, type CLICRUDGroupDescriptor, type CLIToolWrapperCommandDescriptor, type CLILogViewerGroupDescriptor, type CLIProcessManagerGroupDescriptor, type CLIConfigNamespaceGroupDescriptor } from './patterns';
-export { CLIError, CommandNotFoundError, InvalidArgumentError, MissingArgumentError, AuthRequiredError, PermissionDeniedError, NotFoundError, ConfigError, NetworkError, TimeoutError, UserCancelledError } from './errors';
-export { resolveCliEntry, resolveCliInvocation } from './bin';
+/** Primary CLI contracts and runtime registration. Host surfaces live at ./surface and ./bootstrap. */
+export type { CLIInvocationEndInfo, CLIInvocationInfo, CLIInvocationObserver, CLIInvocationPreparer, CLIResolvedEffects, CLISurfaceOptions, CommandContext, CommandOptions, CommandOptionValue } from './schemas/surface.ts';
+export { CommandOptionValueSchema, CommandOptionsSchema } from './schemas/surface.ts';
+export { defineCommandImplementation, parseCommandOptions, type CommandImplementation, type TypedCommandImplementation } from './surface/command-options.ts';
+export { resolveCommandImplementation, type CliCommandExecute, type CommandImplementationResolution } from './surface/command-implementation.ts';
+export type { CliHostOutput } from './boot/providers.ts';
+export { default as cliPlugin } from './commands/cli.plugin.ts';
+export { cliKindsPlugin, cliGroupKind, cliCommandKind } from './commands/cli.kinds.ts';
+export { registerCLIProviders, requestCLIExit, detectOutputFormat, resolveCliFlags, shouldKeepAlive, resetKeepAlive, type CLIProviderOptions, type ResolvedCliFlags, type UIContext, type LoggerContext, type AppContext, type CLIContext, type CLIExitSignal } from './boot/providers.ts';
+export { reportBootstrapFailure, type ReportBootstrapFailureOptions } from './surface/failure-output.ts';
+export { renderCliFailure, scrubCliText, mapKnownError, type CliFailureRenderOptions } from './surface/failure-report.ts';
+export { PatternResolver, createPatternResolver, isPatternDescriptor, getPatternType, type PatternImplementation, type CLIPatternDescriptor, type CLICRUDGroupDescriptor, type CLIToolWrapperCommandDescriptor, type CLILogViewerGroupDescriptor, type CLIProcessManagerGroupDescriptor, type CLIConfigNamespaceGroupDescriptor } from './patterns/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACN,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACN,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,MAAM,YAAY,CAAC;AAGpB,OAAO,EACN,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,YAAY,EACX,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EACN,2BAA2B,EAC3B,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACN,4BAA4B,EAC5B,KAAK,iBAAiB,EACtB,KAAK,+BAA+B,EACpC,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EACN,cAAc,EACd,YAAY,EACZ,cAAc,EACd,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAG1H,OAAO,EACN,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,29 +1,19 @@
-/**
- * CLI Module
- *
- * The CLI surface for the universal runtime.
- * Integrates Commander.js with runtime-discovered commands.
- *
- * Usage:
- * ```typescript
- * import { createVibesCliApp } from '@vibesdotdev/cli/bootstrap';
- *
- * const app = await createVibesCliApp();
- * await app.cli.run(process.argv);
- * ```
- */
-// Bootstrap
-export { createVibesCliApp } from './bootstrap.js';
-// Surface
-export { CLISurface } from './surface.js';
+/** Primary CLI contracts and runtime registration. Host surfaces live at ./surface and ./bootstrap. */
+export { CommandOptionValueSchema, CommandOptionsSchema } from "./schemas/surface.js";
+export { defineCommandImplementation, parseCommandOptions } from "./surface/command-options.js";
+// A host that owns a runtime (an agent extension or plugin running commands
+// in-process) resolves and runs `cli/command` implementations through the same
+// entry the CLI surface uses, instead of spawning the CLI.
+export { resolveCommandImplementation } from "./surface/command-implementation.js";
 // Plugin (registers cli/group and cli/command kinds)
-export { default as cliPlugin } from './cli.plugin.js';
+export { default as cliPlugin } from "./commands/cli.plugin.js";
+// Kinds-only plugin for non-CLI scopes that need descriptor enumeration.
+export { cliKindsPlugin, cliGroupKind, cliCommandKind } from "./commands/cli.kinds.js";
 // Context providers
-export { registerCLIProviders, requestCLIExit, detectOutputFormat, shouldKeepAlive, resetKeepAlive, CLIExitSignal } from './providers.js';
+export { registerCLIProviders, requestCLIExit, detectOutputFormat, resolveCliFlags, shouldKeepAlive, resetKeepAlive } from "./boot/providers.js";
+// Failure-formatting helpers retained for existing hosts and command consumers.
+export { reportBootstrapFailure } from "./surface/failure-output.js";
+export { renderCliFailure, scrubCliText, mapKnownError } from "./surface/failure-report.js";
 // Patterns
-export { PatternResolver, createPatternResolver, isPatternDescriptor, getPatternType } from './patterns';
-// Errors
-export { CLIError, CommandNotFoundError, InvalidArgumentError, MissingArgumentError, AuthRequiredError, PermissionDeniedError, NotFoundError, ConfigError, NetworkError, TimeoutError, UserCancelledError } from './errors.js';
-// Binary path resolution
-export { resolveCliEntry, resolveCliInvocation } from './bin.js';
+export { PatternResolver, createPatternResolver, isPatternDescriptor, getPatternType } from "./patterns/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY;AACZ,OAAO,EACN,iBAAiB,EAIjB,MAAM,aAAa,CAAC;AAErB,UAAU;AACV,OAAO,EAAE,UAAU,EAA+C,MAAM,WAAW,CAAC;AAEpF,qDAAqD;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,aAAa,EAMb,MAAM,aAAa,CAAC;AAErB,WAAW;AACX,OAAO,EACN,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EAQd,MAAM,YAAY,CAAC;AAEpB,SAAS;AACT,OAAO,EACN,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,MAAM,UAAU,CAAC;AAElB,yBAAyB;AACzB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAavG,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EACN,2BAA2B,EAC3B,mBAAmB,EAGnB,MAAM,8BAA8B,CAAC;AACtC,4EAA4E;AAC5E,+EAA+E;AAC/E,2DAA2D;AAC3D,OAAO,EACN,4BAA4B,EAG5B,MAAM,qCAAqC,CAAC;AAG7C,qDAAqD;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEhE,yEAAyE;AACzE,OAAO,EACN,cAAc,EACd,YAAY,EACZ,cAAc,EACd,MAAM,yBAAyB,CAAC;AAEjC,oBAAoB;AACpB,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,cAAc,EAQd,MAAM,qBAAqB,CAAC;AAE7B,gFAAgF;AAChF,OAAO,EAAE,sBAAsB,EAAsC,MAAM,6BAA6B,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAgC,MAAM,6BAA6B,CAAC;AAE1H,WAAW;AACX,OAAO,EACN,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EAQd,MAAM,qBAAqB,CAAC"}

package/dist/invocation/client.d.ts

@@ -0,0 +1,20 @@
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+/** Invocation decisions belong to the runtime executing the command. */
+export declare class CLIInvocationClient extends BaseRuntimeClient {
+    private persistent;
+    private jsonWritten;
+    private exitCode;
+    keepAlive(): void;
+    shouldKeepAlive(): boolean;
+    resetKeepAlive(): void;
+    hasWrittenJsonPayload(): boolean;
+    recordJsonPayload(): void;
+    resetJsonPayload(): void;
+    setExitCode(code: number): void;
+    readExitCode(): number | undefined;
+    resetExitCode(): void;
+    begin(): void;
+    protected onDispose(): void;
+}
+export default CLIInvocationClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/invocation/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/invocation/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,iBAAiB;IACzD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAqB;IAErC,SAAS,IAAI,IAAI;IACjB,eAAe,IAAI,OAAO;IAC1B,cAAc,IAAI,IAAI;IACtB,qBAAqB,IAAI,OAAO;IAChC,iBAAiB,IAAI,IAAI;IACzB,gBAAgB,IAAI,IAAI;IACxB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAC/B,YAAY,IAAI,MAAM,GAAG,SAAS;IAClC,aAAa,IAAI,IAAI;IACrB,KAAK,IAAI,IAAI;cAKM,SAAS,IAAI,IAAI;CACpC;AAED,eAAe,mBAAmB,CAAC"}

package/dist/invocation/client.js

@@ -0,0 +1,25 @@
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { CLIExitStatusSchema } from "../schemas/exit.js";
+/** Invocation decisions belong to the runtime executing the command. */
+export class CLIInvocationClient extends BaseRuntimeClient {
+    persistent = false;
+    jsonWritten = false;
+    exitCode;
+    keepAlive() { this.persistent = true; }
+    shouldKeepAlive() { return this.persistent; }
+    resetKeepAlive() { this.persistent = false; }
+    hasWrittenJsonPayload() { return this.jsonWritten; }
+    recordJsonPayload() { this.jsonWritten = true; }
+    resetJsonPayload() { this.jsonWritten = false; }
+    setExitCode(code) { this.exitCode = CLIExitStatusSchema.parse(code); }
+    readExitCode() { return this.exitCode; }
+    resetExitCode() { this.exitCode = undefined; }
+    begin() {
+        this.resetKeepAlive();
+        this.resetJsonPayload();
+        this.resetExitCode();
+    }
+    onDispose() { this.begin(); }
+}
+export default CLIInvocationClient;
+//# sourceMappingURL=client.js.map

package/dist/invocation/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/invocation/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wEAAwE;AACxE,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACjD,UAAU,GAAG,KAAK,CAAC;IACnB,WAAW,GAAG,KAAK,CAAC;IACpB,QAAQ,CAAqB;IAErC,SAAS,KAAW,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC;IAC7C,eAAe,KAAc,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACtD,cAAc,KAAW,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC;IACnD,qBAAqB,KAAc,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7D,iBAAiB,KAAW,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IACtD,gBAAgB,KAAW,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC;IACtD,WAAW,CAAC,IAAY,IAAU,IAAI,CAAC,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpF,YAAY,KAAyB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,aAAa,KAAW,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;IACpD,KAAK;QACJ,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,aAAa,EAAE,CAAC;IACtB,CAAC;IACkB,SAAS,KAAW,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CACtD;AAED,eAAe,mBAAmB,CAAC"}

package/dist/invocation/state.d.ts

@@ -0,0 +1,10 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { CLIInvocationClient } from './client.ts';
+export declare const cliInvocationPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export declare function getCLIInvocationClient(runtime: Pick<RuntimeRef, 'hasKind' | 'registerPlugin' | 'query'>): Promise<CLIInvocationClient>;
+export declare function tryCLIInvocationClient(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>): CLIInvocationClient | undefined;
+/** Record a command's chosen status on the runtime executing that invocation. */
+export declare function setCLIExitCode(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>, code: number): void;
+/** Read the status chosen for one runtime-owned CLI invocation. */
+export declare function readCLIExitCode(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>): number | undefined;
+//# sourceMappingURL=state.d.ts.map

package/dist/invocation/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/invocation/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,mBAAmB,6CAO9B,CAAC;AAEH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,gBAAgB,GAAG,OAAO,CAAC,GAC/D,OAAO,CAAC,mBAAmB,CAAC,CAG9B;AAED,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,GAC5C,mBAAmB,GAAG,SAAS,CAEjC;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAC7B,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,EAC9C,IAAI,EAAE,MAAM,GACV,IAAI,CAQN;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAC9B,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,GAC5C,MAAM,GAAG,SAAS,CAEpB"}

package/dist/invocation/state.js

@@ -0,0 +1,32 @@
+import { CapabilityError, createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { getVibesClient, tryGetVibesClient, runtimeClientPlugin } from '@vibesdotdev/kernel/client';
+export const cliInvocationPlugin = createRuntimePlugin({
+    id: 'cli-invocation',
+    descriptors: [{ id: 'cli-invocation', kind: 'runtime/client' }],
+    loaders: [loader('cli-invocation', () => import("./client.js"))],
+    async onRegister(runtime) {
+        await runtime.registerPlugin(runtimeClientPlugin);
+    }
+});
+export async function getCLIInvocationClient(runtime) {
+    await runtime.registerPlugin(cliInvocationPlugin);
+    return getVibesClient('cli-invocation', runtime);
+}
+export function tryCLIInvocationClient(runtime) {
+    return tryGetVibesClient('cli-invocation', runtime);
+}
+/** Record a command's chosen status on the runtime executing that invocation. */
+export function setCLIExitCode(runtime, code) {
+    const client = tryCLIInvocationClient(runtime);
+    if (!client) {
+        throw new CapabilityError('The CLI invocation status client is unavailable.', 'UNAVAILABLE', {
+            reason: 'cli-invocation-unavailable'
+        });
+    }
+    client.setExitCode(code);
+}
+/** Read the status chosen for one runtime-owned CLI invocation. */
+export function readCLIExitCode(runtime) {
+    return tryCLIInvocationClient(runtime)?.readExitCode();
+}
+//# sourceMappingURL=state.js.map

package/dist/invocation/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/invocation/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,EAAmB,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGpG,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;IACtD,EAAE,EAAE,gBAAgB;IACpB,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IAC/D,OAAO,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAChE,KAAK,CAAC,UAAU,CAAC,OAAO;QACvB,MAAM,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IACnD,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,OAAiE;IAEjE,MAAM,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAClD,OAAO,cAAc,CAAsB,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,OAA8C;IAE9C,OAAO,iBAAiB,CAAsB,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAC7B,OAA8C,EAC9C,IAAY;IAEZ,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,eAAe,CAAC,kDAAkD,EAAE,aAAa,EAAE;YAC5F,MAAM,EAAE,4BAA4B;SACpC,CAAC,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAC9B,OAA8C;IAE9C,OAAO,sBAAsB,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;AACxD,CAAC"}

package/dist/patterns/builtins/config-namespace-commands.d.ts

@@ -0,0 +1,10 @@
+/** Config-namespace subcommand builders: get/set/reset/list against the namespace's config service. */
+import type { Command } from 'commander';
+import type { CLIConfigNamespaceGroupDescriptor } from '../schemas.ts';
+import type { CommandContext } from '../../schemas/surface.ts';
+import type { ConfigContext } from '../../boot/providers.ts';
+export declare function registerConfigGet(parent: Command, descriptor: CLIConfigNamespaceGroupDescriptor, context: CommandContext, requireService: () => Promise<ConfigContext>): void;
+export declare function registerConfigSet(parent: Command, descriptor: CLIConfigNamespaceGroupDescriptor, context: CommandContext, requireService: () => Promise<ConfigContext>): void;
+export declare function registerConfigReset(parent: Command, descriptor: CLIConfigNamespaceGroupDescriptor, context: CommandContext, requireService: () => Promise<ConfigContext>): void;
+export declare function registerConfigList(parent: Command, descriptor: CLIConfigNamespaceGroupDescriptor, context: CommandContext, requireService: () => Promise<ConfigContext>): void;
+//# sourceMappingURL=config-namespace-commands.d.ts.map

package/dist/patterns/builtins/config-namespace-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-namespace-commands.d.ts","sourceRoot":"","sources":["../../../src/patterns/builtins/config-namespace-commands.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAW7D,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,iCAAiC,EAC7C,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,GAC1C,IAAI,CAwBN;AAED,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,iCAAiC,EAC7C,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,GAC1C,IAAI,CA2CN;AAED,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,iCAAiC,EAC7C,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,GAC1C,IAAI,CAqCN;AAED,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,iCAAiC,EAC7C,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,GAC1C,IAAI,CA+BN"}