@vibesdotdev/cli 0.0.2 → 1.0.0-rc.2

package/dist/surface/commander-action.d.ts

@@ -0,0 +1,25 @@
+/**
+ * What Commander hands an action: `(...positionals, options, command)`, read
+ * once at that boundary. The options are the merged scopes of the selected
+ * command (source priority first, the deeper command on ties), never
+ * Commander's ancestor-wins `optsWithGlobals()`.
+ */
+import { Command } from 'commander';
+import { type CommandExecutionStartInfo, type CommandOptionValue, type CommandOptions } from '../schemas/surface.ts';
+/** A command's positional arguments by argument name: the surface's own execution contract. */
+export type CommandArguments = CommandExecutionStartInfo['args'];
+export interface CommanderActionCall {
+    /** The positional values, in declaration order, each parsed. */
+    readonly positionals: readonly (CommandOptionValue | undefined)[];
+    /** The selected command's merged option scopes (a fresh object the caller may normalize). */
+    readonly options: CommandOptions;
+    /** The command Commander dispatched, when it passed one (it always does). */
+    readonly command: Command | undefined;
+}
+/**
+ * Read Commander's action call. A positional or option value outside the
+ * command option contract refuses `INVALID_INPUT` `command-options-invalid`
+ * before the implementation runs.
+ */
+export declare function readCommanderAction(actionArgs: readonly unknown[]): CommanderActionCall;
+//# sourceMappingURL=commander-action.d.ts.map

package/dist/surface/commander-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-action.d.ts","sourceRoot":"","sources":["../../src/surface/commander-action.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAA4B,KAAK,yBAAyB,EAAE,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI/I,+FAA+F;AAC/F,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAQjE,MAAM,WAAW,mBAAmB;IACnC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,kBAAkB,GAAG,SAAS,CAAC,EAAE,CAAC;IAClE,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,GAAG,mBAAmB,CAcvF"}

package/dist/surface/commander-action.js

@@ -0,0 +1,38 @@
+/**
+ * What Commander hands an action: `(...positionals, options, command)`, read
+ * once at that boundary. The options are the merged scopes of the selected
+ * command (source priority first, the deeper command on ties), never
+ * Commander's ancestor-wins `optsWithGlobals()`.
+ */
+import { Command } from 'commander';
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { CommandOptionValueSchema } from "../schemas/surface.js";
+import { parseCommandOptionBag } from "./command-options.js";
+import { resolveScopedCommandOptions } from "./inherited-options.js";
+/** Commander's per-command option bag: a record keyed by option name (parsed by the command option contract). */
+const OptionBagSchema = z.looseObject({});
+/** The positional values Commander passes: text, a variadic text list, or absent. */
+const PositionalsSchema = z.array(CommandOptionValueSchema.optional());
+/**
+ * Read Commander's action call. A positional or option value outside the
+ * command option contract refuses `INVALID_INPUT` `command-options-invalid`
+ * before the implementation runs.
+ */
+export function readCommanderAction(actionArgs) {
+    const raw = [...actionArgs];
+    const last = raw.pop();
+    const bag = raw.pop();
+    const positionals = PositionalsSchema.safeParse(raw);
+    if (!positionals.success) {
+        throw new CapabilityError('A positional argument is not text.', 'INVALID_INPUT', {
+            reason: 'command-options-invalid', retryable: false, details: { positions: positionals.error.issues.map((issue) => String(issue.path[0] ?? "")) }
+        });
+    }
+    const command = last instanceof Command ? last : undefined;
+    if (command)
+        return { positionals: positionals.data, options: resolveScopedCommandOptions(command), command };
+    const bagged = OptionBagSchema.safeParse(bag);
+    return { positionals: positionals.data, options: bagged.success ? parseCommandOptionBag(bagged.data) : {}, command };
+}
+//# sourceMappingURL=commander-action.js.map

package/dist/surface/commander-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-action.js","sourceRoot":"","sources":["../../src/surface/commander-action.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAgF,MAAM,uBAAuB,CAAC;AAC/I,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAKrE,iHAAiH;AACjH,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAE1C,qFAAqF;AACrF,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,QAAQ,EAAE,CAAC,CAAC;AAWvE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA8B;IACjE,MAAM,GAAG,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CAAC,oCAAoC,EAAE,eAAe,EAAE;YAChF,MAAM,EAAE,yBAAyB,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE;SACjJ,CAAC,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,YAAY,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,IAAI,OAAO;QAAE,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,2BAA2B,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9G,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;AACtH,CAAC"}

package/dist/surface/discovery-cache.d.ts

@@ -1,17 +1,5 @@
-import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
-import type { CLICommandAssetDescriptor, CLIGroupAssetDescriptor } from '../schemas/descriptors';
-export interface CLIDiscoveryOptions {
-    includeInternal?: boolean;
-}
-export interface CLIDiscovery {
-    allGroups: CLIGroupAssetDescriptor[];
-    allCommands: CLICommandAssetDescriptor[];
-    groups: CLIGroupAssetDescriptor[];
-    commands: CLICommandAssetDescriptor[];
-    groupsById: Map<string, CLIGroupAssetDescriptor>;
-    sortedGroups: CLIGroupAssetDescriptor[];
-    sortedCommands: CLICommandAssetDescriptor[];
-}
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import type { CLIDiscovery, CLIDiscoveryOptions } from '../schemas/discovery.ts';
+export type { CLIDiscovery, CLIDiscoveryOptions } from '../schemas/discovery.ts';
 export declare function getCLIDiscovery(runtime: VibesRuntime, options?: CLIDiscoveryOptions): CLIDiscovery;
-export declare function clearCLIDiscoveryCache(runtime?: VibesRuntime): void;
 //# sourceMappingURL=discovery-cache.d.ts.map

package/dist/surface/discovery-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery-cache.d.ts","sourceRoot":"","sources":["../../src/surface/discovery-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EACX,yBAAyB,EACzB,uBAAuB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC5B,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,WAAW,EAAE,yBAAyB,EAAE,CAAC;IACzC,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAClC,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACjD,YAAY,EAAE,uBAAuB,EAAE,CAAC;IACxC,cAAc,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AASD,wBAAgB,eAAe,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAwB,GAC/B,YAAY,CAsDd;AAED,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAOnE"}
+{"version":3,"file":"discovery-cache.d.ts","sourceRoot":"","sources":["../../src/surface/discovery-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAMpE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,wBAAgB,eAAe,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAwB,GAC/B,YAAY,CAkCd"}

package/dist/surface/discovery-cache.js

@@ -1,31 +1,17 @@
-const discoveryCache = new WeakMap();
 export function getCLIDiscovery(runtime, options = {}) {
     const includeInternal = options.includeInternal === true;
-    const allGroups = runtime.assets('cli/group').descriptors();
-    const allCommands = runtime.assets('cli/command').descriptors();
+    // The kinds validated each descriptor against its schema at registration,
+    // so the typed accessor reads them as the kinds' own descriptor types.
+    const allGroups = runtime.query('cli/group').descriptors();
+    const allCommands = runtime.query('cli/command').descriptors();
     const scope = runtime.scope;
-    const cacheKey = [
-        scope.surface ?? '',
-        scope.hardware ?? '',
-        scope.purpose ?? '',
-        includeInternal ? 'internal' : 'public'
-    ].join(':');
-    const fingerprint = buildFingerprint(allGroups, allCommands);
-    let runtimeCache = discoveryCache.get(runtime);
-    if (!runtimeCache) {
-        runtimeCache = new Map();
-        discoveryCache.set(runtime, runtimeCache);
-    }
-    const cached = runtimeCache.get(cacheKey);
-    if (cached?.fingerprint === fingerprint)
-        return cached.discovery;
     const groupsById = new Map(allGroups.map((group) => [group.id, group]));
     const groups = allGroups.filter((group) => {
         if (group.enabled === false)
             return false;
         if (group.hardware?.length && !group.hardware.includes(scope.hardware))
             return false;
-        if (group.surfaces?.length && !group.surfaces.includes(scope.surface))
+        if (group.surfaces?.length && !group.surfaces.some((surface) => surface === scope.surface))
             return false;
         if (!includeInternal && group.internal === true)
             return false;
@@ -36,8 +22,7 @@ export function getCLIDiscovery(runtime, options = {}) {
             return false;
         if (command.hardware?.length && !command.hardware.includes(scope.hardware))
             return false;
-        if (command.surfaces?.length &&
-            !command.surfaces.includes(scope.surface))
+        if (command.surfaces?.length && !command.surfaces.some((surface) => surface === scope.surface))
             return false;
         if (!includeInternal && command.internal === true)
             return false;
@@ -54,17 +39,8 @@ export function getCLIDiscovery(runtime, options = {}) {
         sortedGroups: sortGroupsByDepth(groups),
         sortedCommands: [...commands].sort(byOrder)
     };
-    runtimeCache.set(cacheKey, { fingerprint, discovery });
     return discovery;
 }
-export function clearCLIDiscoveryCache(runtime) {
-    if (runtime) {
-        discoveryCache.delete(runtime);
-        return;
-    }
-    // WeakMap cannot be cleared. This helper intentionally supports targeted
-    // invalidation for tests or runtimes that mutate descriptors after bootstrap.
-}
 function sortGroupsByDepth(groups) {
     const groupMap = new Map(groups.map((group) => [group.id, group]));
     const depths = new Map();
@@ -100,7 +76,4 @@ function byOrder(a, b) {
         return orderDiff;
     return a.id.localeCompare(b.id);
 }
-function buildFingerprint(groups, commands) {
-    return JSON.stringify({ groups, commands });
-}
 //# sourceMappingURL=discovery-cache.js.map

package/dist/surface/discovery-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery-cache.js","sourceRoot":"","sources":["../../src/surface/discovery-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"discovery-cache.js","sourceRoot":"","sources":["../../src/surface/discovery-cache.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,eAAe,CAC9B,OAAqB,EACrB,UAA+B,EAAE;IAEjC,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC;IACzD,0EAA0E;IAC1E,uEAAuE;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAA0B,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;IACpF,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAA4B,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QACzC,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACrF,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACzG,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/C,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACzF,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7G,IAAI,CAAC,eAAe,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChE,IAAI,CAAC,eAAe,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACvF,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAiB;QAC/B,SAAS;QACT,WAAW;QACX,MAAM;QACN,QAAQ;QACR,UAAU;QACV,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC;QACvC,cAAc,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;KAC3C,CAAC;IACF,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAiC;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,MAAM,QAAQ,GAAG,CAAC,KAA8B,EAAU,EAAE;QAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAE5C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACxB,OAAO,CAAC,CAAC;QACV,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACxB,OAAO,CAAC,CAAC;QACV,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACd,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE5C,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChC,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACtC,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CACf,CAA4E,EAC5E,CAA4E;IAE5E,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;IACtD,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/surface/exit.d.ts

@@ -0,0 +1,10 @@
+/** Intentional stack termination. This leaf imports only the kernel and schemas. */
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+import { type CLIExitOptions, type CLIExitSignal } from '../schemas/exit.ts';
+export type { CLIExitOptions, CLIExitSignal } from '../schemas/exit.ts';
+/** The `name` an exit request carries; match it through {@link isCLIExitSignal}. */
+export declare const CLI_EXIT_SIGNAL_NAME = "CLIExitSignal";
+/** Recognize exit requests across duplicate module instances. */
+export declare function isCLIExitSignal(caught: CaughtFailure): caught is CLIExitSignal;
+export declare function requestCLIExit(code?: number, options?: CLIExitOptions): never;
+//# sourceMappingURL=exit.d.ts.map

package/dist/surface/exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../src/surface/exit.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAA8B,KAAK,aAAa,EAAgB,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAA4C,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvH,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxE,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAqBpD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,IAAI,aAAa,CAO9E;AAED,wBAAgB,cAAc,CAAC,IAAI,SAAI,EAAE,OAAO,GAAE,cAAmB,GAAG,KAAK,CAE5E"}

package/dist/surface/exit.js

@@ -0,0 +1,33 @@
+/** Intentional stack termination. This leaf imports only the kernel and schemas. */
+import { CapabilityError, settleNow } from '@vibesdotdev/kernel';
+import { CLIExitSignalSchema, CLIExitStatusSchema } from "../schemas/exit.js";
+const CLI_EXIT_SIGNAL_BRAND = Symbol.for('@vibesdotdev/cli/CLIExitSignal');
+/** The `name` an exit request carries; match it through {@link isCLIExitSignal}. */
+export const CLI_EXIT_SIGNAL_NAME = 'CLIExitSignal';
+function createCLIExitSignal(code, cause) {
+    const status = CLIExitStatusSchema.parse(code);
+    const outcome = status === 0
+        ? { ok: true, value: undefined }
+        : {
+            ok: false,
+            cause: new CapabilityError('CLI requested a nonzero exit.', 'INTERNAL', {
+                reason: 'cli-exit-nonzero',
+                retryable: false,
+                cause
+            })
+        };
+    const signal = Object.assign(new Error(`CLI requested exit with code ${status}`, cause === undefined ? undefined : { cause }), { name: CLI_EXIT_SIGNAL_NAME, code: status, outcome, [CLI_EXIT_SIGNAL_BRAND]: true });
+    return CLIExitSignalSchema.parse(signal);
+}
+/** Recognize exit requests across duplicate module instances. */
+export function isCLIExitSignal(caught) {
+    const recognized = settleNow(() => {
+        const parsed = CLIExitSignalSchema.safeParse(caught);
+        return parsed.success && CLI_EXIT_SIGNAL_BRAND in caught && caught[CLI_EXIT_SIGNAL_BRAND] === true;
+    });
+    return recognized.ok && recognized.value;
+}
+export function requestCLIExit(code = 0, options = {}) {
+    throw createCLIExitSignal(code, options.cause);
+}
+//# sourceMappingURL=exit.js.map

package/dist/surface/exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../src/surface/exit.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,SAAS,EAAoC,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAA2C,MAAM,oBAAoB,CAAC;AAGvH,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAE3E,oFAAoF;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAEpD,SAAS,mBAAmB,CAAC,IAAY,EAAE,KAAqB;IAC/D,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAkB,MAAM,KAAK,CAAC;QAC1C,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;QAChC,CAAC,CAAC;YACD,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,IAAI,eAAe,CAAC,+BAA+B,EAAE,UAAU,EAAE;gBACvE,MAAM,EAAE,kBAAkB;gBAC1B,SAAS,EAAE,KAAK;gBAChB,KAAK;aACL,CAAC;SACF,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAC3B,IAAI,KAAK,CAAC,gCAAgC,MAAM,EAAE,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAChG,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,CACpF,CAAC;IACF,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,MAAqB;IACpD,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,OAAO,IAAI,qBAAqB,IAAI,MAAM,IAAI,MAAM,CAAC,qBAAqB,CAAC,KAAK,IAAI,CAAC;IACpG,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,UAA0B,EAAE;IACpE,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/surface/failure-of.d.ts

@@ -0,0 +1,9 @@
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+/**
+ * Run `work`: `null` once it completes, else its failure, parsed at the catch
+ * with Runtime's `CaughtFailureSchema` and returned for the caller to render,
+ * report or carry (the Runtime catch pattern). The caller owns the failure:
+ * every call site handles a non-null result.
+ */
+export declare function failureOf(work: () => void | Promise<void>): Promise<CaughtFailure | null>;
+//# sourceMappingURL=failure-of.d.ts.map

package/dist/surface/failure-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-of.d.ts","sourceRoot":"","sources":["../../src/surface/failure-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAO/F"}

package/dist/surface/failure-of.js

@@ -0,0 +1,17 @@
+import { CaughtFailureSchema } from '@vibesdotdev/kernel';
+/**
+ * Run `work`: `null` once it completes, else its failure, parsed at the catch
+ * with Runtime's `CaughtFailureSchema` and returned for the caller to render,
+ * report or carry (the Runtime catch pattern). The caller owns the failure:
+ * every call site handles a non-null result.
+ */
+export async function failureOf(work) {
+    try {
+        await work();
+        return null;
+    }
+    catch (error) {
+        return CaughtFailureSchema.parse(error);
+    }
+}
+//# sourceMappingURL=failure-of.js.map

package/dist/surface/failure-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-of.js","sourceRoot":"","sources":["../../src/surface/failure-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAgC;IAC/D,IAAI,CAAC;QACJ,MAAM,IAAI,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;AACF,CAAC"}

package/dist/surface/failure-output.d.ts

@@ -0,0 +1,50 @@
+/** Failure output shared by command surfaces and hosts that have not booted. */
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+import type { CliHostOutput } from '../boot/schemas/providers.ts';
+import { type CliFailureRenderOptions } from './failure-report.ts';
+/** Whether captured argv requests a machine-readable failure envelope. */
+export declare function argvWantsJson(argv: readonly string[]): boolean;
+export type { JsonFailureEnvelope, CliFailureEnvelope, ReportBootstrapFailureOptions } from './schemas/CLISurface.ts';
+import type { CliFailureEnvelope, JsonFailureEnvelope, ReportBootstrapFailureOptions } from './schemas/CLISurface.ts';
+/**
+ * Generic failure envelope for throws that are not CapabilityError.
+ * Shape matches CapabilityError.toEnvelope() so scripts can parse one contract.
+ */
+export declare function buildJsonFailureEnvelope(message: string, code?: string): JsonFailureEnvelope;
+/**
+ * Emit a failure envelope on the stream that keeps `--json` parseable.
+ *
+ * stdout carries EXACTLY ONE JSON document under --json. When the command
+ * already wrote its own — `doctor run --json` renders the full report, then
+ * throws UNAVAILABLE so the exit code matches the verdict — a second document
+ * on stdout breaks `JSON.parse(stdout)` for every consumer of the "stable agent
+ * contract" the flag advertises, and it breaks it exactly when there is
+ * something to act on. The envelope is then diagnosis, not output: the failure
+ * is already in the payload and the exit code, so it goes to stderr.
+ */
+/** Where the surface writes its own failure text and envelopes. */
+type SurfaceWriter = Pick<CliHostOutput, 'write'>;
+/**
+ * Write a failure envelope: to stdout when it is the invocation's one JSON
+ * document, to stderr when a document is already there (`documentWritten`:
+ * the surface passes its own runtime's ledger entry; by default, the owed
+ * free form's canonical-runtime entry only). `write` is the writer the envelope
+ * goes through; there is no process-stream default.
+ */
+export declare function writeJsonEnvelope(envelope: CliFailureEnvelope, write: (fd: 1 | 2, text: string) => void, documentWritten: boolean): void;
+/** A JSON envelope with every host credential value scrubbed from its text. */
+export declare function writeScrubbedEnvelope(envelope: CliFailureEnvelope, env: CliFailureRenderOptions['env'], writer: SurfaceWriter, documentWritten: boolean): void;
+export { mapKnownError, renderCliFailure } from './failure-report.ts';
+/**
+ * Report a fatal HOST BOOTSTRAP failure — the `await createVibesCliApp(...)`
+ * host entrypoints perform with no try/catch — with the same renderer and
+ * `--json` envelope contract `run()` applies to command failures. Without
+ * this, a present-but-broken `vibes.config.ts` (unconditionally fatal in
+ * bootstrap) surfaced as a raw unhandled rejection: no envelope, no friendly
+ * mapping, runtime-dependent exit behavior.
+ *
+ * The host parses what its boot threw at its own catch
+ * (`reportBootstrapFailure(CaughtFailureSchema.parse(caught), …)`).
+ */
+export declare function reportBootstrapFailure(failure: CaughtFailure, verbose: boolean, argv: readonly string[], options: ReportBootstrapFailureOptions): Promise<number>;
+//# sourceMappingURL=failure-output.d.ts.map

package/dist/surface/failure-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-output.d.ts","sourceRoot":"","sources":["../../src/surface/failure-output.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAkC,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnG,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAU9D;AAED,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACtH,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAEtH;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAa,GAAG,mBAAmB,CAShG;AAED;;;;;;;;;;GAUG;AACH,mEAAmE;AACnE,KAAK,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AASlD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,EACxC,eAAe,EAAE,OAAO,GACtB,IAAI,CAEN;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,EAAE,uBAAuB,CAAC,KAAK,CAAC,EACnC,MAAM,EAAE,aAAa,EACrB,eAAe,EAAE,OAAO,GACtB,IAAI,CAEN;AAED,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,6BAA6B,GACpC,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/dist/surface/failure-output.js

@@ -0,0 +1,84 @@
+/** Failure output shared by command surfaces and hosts that have not booted. */
+import { isCapabilityError } from '@vibesdotdev/kernel';
+import { renderCliFailure, scrubCliText } from "./failure-report.js";
+/** Whether captured argv requests a machine-readable failure envelope. */
+export function argvWantsJson(argv) {
+    const rest = argv.slice(2);
+    if (rest.includes('--json'))
+        return true;
+    for (const flag of ['--format', '--output']) {
+        const i = rest.indexOf(flag);
+        if (i >= 0 && rest[i + 1] === 'json')
+            return true;
+        // --format=json / --output=json
+        if (rest.some((a) => a === `${flag}=json`))
+            return true;
+    }
+    return false;
+}
+/**
+ * Generic failure envelope for throws that are not CapabilityError.
+ * Shape matches CapabilityError.toEnvelope() so scripts can parse one contract.
+ */
+export function buildJsonFailureEnvelope(message, code = 'INTERNAL') {
+    return {
+        ok: false,
+        error: {
+            code,
+            message,
+            retryable: false
+        }
+    };
+}
+function writeEnvelopeBytes(writer, fd, text) {
+    // Through the host's tracked stream writes, never `fs.writeSync`: the output
+    // plane exists because mixing the two reorders and loses data on Bun 1.4.0,
+    // and a command that emitted tracked stdout before failing must not interleave.
+    writer.write(fd === 2 ? 'stderr' : 'stdout', text);
+}
+/**
+ * Write a failure envelope: to stdout when it is the invocation's one JSON
+ * document, to stderr when a document is already there (`documentWritten`:
+ * the surface passes its own runtime's ledger entry; by default, the owed
+ * free form's canonical-runtime entry only). `write` is the writer the envelope
+ * goes through; there is no process-stream default.
+ */
+export function writeJsonEnvelope(envelope, write, documentWritten) {
+    write(documentWritten ? 2 : 1, `${JSON.stringify(envelope)}\n`);
+}
+/** A JSON envelope with every host credential value scrubbed from its text. */
+export function writeScrubbedEnvelope(envelope, env, writer, documentWritten) {
+    writeJsonEnvelope(envelope, (fd, text) => writeEnvelopeBytes(writer, fd, scrubCliText(text, env)), documentWritten);
+}
+export { mapKnownError, renderCliFailure } from "./failure-report.js";
+/**
+ * Report a fatal HOST BOOTSTRAP failure — the `await createVibesCliApp(...)`
+ * host entrypoints perform with no try/catch — with the same renderer and
+ * `--json` envelope contract `run()` applies to command failures. Without
+ * this, a present-but-broken `vibes.config.ts` (unconditionally fatal in
+ * bootstrap) surfaced as a raw unhandled rejection: no envelope, no friendly
+ * mapping, runtime-dependent exit behavior.
+ *
+ * The host parses what its boot threw at its own catch
+ * (`reportBootstrapFailure(CaughtFailureSchema.parse(caught), …)`).
+ */
+export async function reportBootstrapFailure(failure, verbose, argv, options) {
+    const render = { verbose, env: options.env };
+    const writer = options.output;
+    // A typed boot failure keeps its code, reason and exit code through the
+    // envelope, exactly as a command failure does (`workspace-invalid` is
+    // INVALID_INPUT, rc02-rc03 C2).
+    const typed = failure instanceof Error && isCapabilityError(failure) ? failure : undefined;
+    if (argvWantsJson(argv)) {
+        // No command of this invocation has run, so the envelope is its one
+        // document: a ledger entry here is a previous invocation's.
+        writeScrubbedEnvelope(typed ? typed.toEnvelope() : buildJsonFailureEnvelope(renderCliFailure(failure, render) || 'CLI bootstrap failed.'), options.env, writer, false);
+    }
+    else {
+        writer.write('stderr', `${renderCliFailure(failure, render) || 'CLI bootstrap failed.'}\n`);
+    }
+    const exitCode = typed ? typed.exitCode : 1;
+    await options.output.flush();
+    return exitCode;
+}
+//# sourceMappingURL=failure-output.js.map

package/dist/surface/failure-output.js.map

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

package/dist/surface/failure-report.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The one print form of a CLI failure.
+ *
+ * Every path that prints a failure (a command failure in `CLISurface.run`, the
+ * exit-boundary disposal, a host bootstrap failure, a skipped telemetry emit
+ * under `-v`) renders it here, so they cannot disagree about what is shown:
+ *
+ * - The failure is described once by Logging's redaction walk
+ *   (`LoggedErrorSchema`): total for any thrown value (throwing getters,
+ *   Proxies, cycles), with credential-named keys and `secret()` values in
+ *   details, fields and causes redacted; retained `AggregateError` members and
+ *   causes are described within Logging's depth and breadth bounds.
+ * - Each retained `AggregateError` member, including nested aggregates, is
+ *   listed with its `details.pluginId` and its retained cause chain. By default each member and cause is value-free: its
+ *   `code`/`reason` when typed, else `Untyped failure: <class name>`, never its
+ *   message. `-v` lists each member's stack or message and the full chain.
+ *   "Runtime disposal failed for 1 plugin" therefore names the plugin and why.
+ * - Known typed refusals get friendly text by code and reason
+ *   ({@link mapKnownError}); nothing parses a message.
+ * - The whole text then passes Logging's one-pass credential scrubber with the
+ *   credential values the host env carries (keys Logging's `isSecretKey` calls
+ *   secret), in normal and verbose modes alike.
+ */
+import * as z from 'zod/v4';
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+/** What a failure description is read as: the detached JSON the redaction walk produced. */
+declare const DescriptionSchema: z.ZodObject<{
+    name: z.ZodString;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    reason: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodUnknown>;
+    fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    stack: z.ZodOptional<z.ZodString>;
+    cause: z.ZodOptional<z.ZodUnknown>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+type Description = z.infer<typeof DescriptionSchema>;
+/**
+ * A host env value shorter than this is not scrubbed from failure text: a
+ * credential is long, and replacing every short value (`true`, `1`) under a
+ * credential-named key would rewrite ordinary words.
+ */
+export declare const MIN_SCRUBBED_CREDENTIAL_LENGTH = 8;
+export interface CliFailureRenderOptions {
+    /** `-v`: stacks and cause chains instead of the friendly line. */
+    readonly verbose: boolean;
+    /**
+     * The host env snapshot (a runtime's `getEnvSnapshot()`, or the executable
+     * host's own before a runtime exists). Every value under a credential key is
+     * removed from the printed text.
+     */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+}
+/** The credential values an env carries: values of keys Logging calls secret, long enough to be a credential. */
+export declare function credentialValuesOf(env: Readonly<Record<string, string | undefined>> | undefined): string[];
+/** Remove every credential value `env` carries from `text` (Logging's scrubber; it never throws). */
+export declare function scrubCliText(text: string, env: Readonly<Record<string, string | undefined>> | undefined): string;
+/**
+ * The total, redacted description of a caught failure (a catch site parses
+ * its binding with the runtime's `CaughtFailureSchema`): an `Error` is
+ * described itself, any other thrown value is described as the value it was.
+ */
+export declare function describeCliFailure(failure: CaughtFailure): Description;
+/** Drop frames pointing into the `bun build --compile` virtual filesystem; they are not actionable. */
+export declare function stripBundlePaths(text: string): string;
+/**
+ * Friendly text for the typed refusals a user can act on, chosen by code and
+ * reason only. `null` when no mapping applies (the caller prints the message).
+ */
+export declare function mapKnownError(failure: CaughtFailure): string | null;
+/**
+ * The printable text of a failure (see the module comment). Never throws and
+ * never returns raw thrown text: every line is described, then scrubbed.
+ */
+export declare function renderCliFailure(caught: CaughtFailure, options: CliFailureRenderOptions): string;
+export {};
+//# sourceMappingURL=failure-report.d.ts.map

package/dist/surface/failure-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-report.d.ts","sourceRoot":"","sources":["../../src/surface/failure-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhF,4FAA4F;AAC5F,QAAA,MAAM,iBAAiB;;;;;;;;;;iBAUrB,CAAC;AACH,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAUrD;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,MAAM,WAAW,uBAAuB;IACvC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5D;AAED,iHAAiH;AACjH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAS1G;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,CAIhH;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAItE;AAED,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAEnE;AAuHD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAuBhG"}