@vibesdotdev/cli 0.0.2 → 1.0.0-rc.3

package/dist/surface/register-groups.d.ts

@@ -1,8 +1,8 @@
 import type { Command } from 'commander';
-import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
-import type { PatternResolver } from '../patterns';
-import type { CLIGroupAssetDescriptor } from '../schemas/descriptors';
-import type { CLISurfaceOptions, CommandContext } from '../schemas/surface';
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import type { PatternResolver } from '../patterns/index.ts';
+import type { CLIGroupAssetDescriptor } from '../schemas/descriptors.ts';
+import type { CLISurfaceOptions, CommandContext } from '../schemas/surface.ts';
 export declare function registerGroups(params: {
     runtime: VibesRuntime;
     program: Command;

package/dist/surface/register-groups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-groups.d.ts","sourceRoot":"","sources":["../../src/surface/register-groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAM5E,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACvD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,IAAI,CAAC,CAahB"}
+{"version":3,"file":"register-groups.d.ts","sourceRoot":"","sources":["../../src/surface/register-groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,uBAAuB,EAA0B,MAAM,2BAA2B,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAW/E,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACvD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB"}

package/dist/surface/register-groups.js

@@ -1,17 +1,28 @@
-import { isPatternDescriptor } from '../patterns/schemas.js';
-import { getLogger } from '../logging.js';
-import { getCLIDiscovery } from './discovery-cache.js';
-const logger = getLogger('surface').child('register-groups');
+import { isPatternDescriptor } from "../patterns/schemas.js";
+import { attachTuiAction } from "./interactive-gate.js";
+import { emitGroupHelpFallback } from "./group-fallback.js";
+import { resolveCommandImplementation } from "./command-implementation.js";
+import { getCLIDiscovery } from "./discovery-cache.js";
+async function groupLogger(runtime) {
+    const { getLogger } = await import("../support/logging/logging.js");
+    return getLogger(runtime, 'surface').child('register-groups');
+}
 export async function registerGroups(params) {
     const { runtime, options } = params;
     const { verbose } = options;
     const discovery = getCLIDiscovery(runtime, options);
     const groups = discovery.groups;
+    // Help lists subcommands alphabetically at every level, not in
+    // registration (descriptor `order`) sequence — `vibes --help` had 57
+    // entries in plugin-load order. Commander copies the help configuration
+    // into each child when `.command()` creates it, so this has to precede
+    // the first group registration; groups are the first subcommands created.
+    params.program.configureHelp({ ...params.program.configureHelp(), sortSubcommands: true });
     if (verbose) {
-        logger.debug(`Discovered ${groups.length} groups`);
+        (await groupLogger(runtime)).debug(`Discovered ${groups.length} groups`);
     }
     for (const group of discovery.sortedGroups) {
-        await registerGroup(params, group);
+        await registerGroup({ ...params, runtime }, group);
     }
 }
 async function registerGroup(params, descriptor) {
@@ -24,13 +35,16 @@ async function registerGroup(params, descriptor) {
             if (params.options.strictGroupParents === true)
                 throw new Error(message);
             if (verbose)
-                logger.warn(message);
+                (await groupLogger(params.runtime)).warn(message);
         }
         else {
             parent = parentGroup;
         }
     }
     const groupCmd = parent.command(descriptor.name).description(descriptor.description);
+    if (descriptor.helpEpilog) {
+        groupCmd.addHelpText('after', `\n${descriptor.helpEpilog}`);
+    }
     if (descriptor.aliases) {
         for (const alias of descriptor.aliases) {
             groupCmd.alias(alias);
@@ -39,13 +53,61 @@ async function registerGroup(params, descriptor) {
     params.groups.set(descriptor.id, groupCmd);
     params.groupDescriptors.set(descriptor.id, descriptor);
     if (verbose) {
-        logger.debug(`Group: ${descriptor.id}`);
+        (await groupLogger(params.runtime)).debug(`Group: ${descriptor.id}`);
     }
     if (params.patternResolver && isPatternDescriptor(descriptor)) {
         const ctx = await params.buildContext();
         await params.patternResolver.resolve(descriptor, groupCmd, ctx);
         if (verbose) {
-            logger.debug(`Pattern '${descriptor.pattern}' applied to: ${descriptor.id}`);
+            (await groupLogger(params.runtime)).debug(`Pattern '${descriptor.pattern}' applied to: ${descriptor.id}`);
+        }
+    }
+    // Groups with an `interactive` config launch the TUI when invoked
+    // with no subcommand (Commander fires the parent action when no
+    // subcommand matches), while still letting subcommands run
+    // non-interactively. `--non-interactive` opts out of the TUI even on
+    // a TTY and shows the group's help instead — useful for CI and
+    // scheduled routines. Under pipe (no TTY) the same fallback applies,
+    // gated by `attachTuiAction`.
+    if (descriptor.interactive) {
+        groupCmd.option('--non-interactive', 'Skip the default TUI and print help (for routines and CI)');
+        const int = descriptor.interactive;
+        const fb = int.fallback ?? 'help';
+        // Every fallback receives the group's parsed options (format/json,
+        // color, non-interactive) — the same ones a direct subcommand
+        // invocation gets — so `vibes doctor --json` reaches `doctor.run`
+        // with --json intact and the help path can pick JSON vs stderr.
+        let groupTuiFallback;
+        if (fb === 'help') {
+            groupTuiFallback = ({ options }) => emitGroupHelpFallback(params.runtime, groupCmd, options);
+        }
+        else if (fb === 'error') {
+            groupTuiFallback = () => {
+                throw new Error(`[CLI] Group '${descriptor.id}' requires an interactive terminal.`);
+            };
+        }
+        else if (fb.command) {
+            const targetCommandId = fb.command;
+            groupTuiFallback = async ({ options }) => {
+                const impl = await resolveCommandImplementation(params.runtime, targetCommandId);
+                if (impl.kind === 'absent') {
+                    await emitGroupHelpFallback(params.runtime, groupCmd, options);
+                    return;
+                }
+                // Outside the resolve guard on purpose: a failure here is the
+                // delegated command's own outcome (doctor run throws to set its
+                // exit code after printing the report) and must surface exactly
+                // as a direct invocation would — never be swallowed into help.
+                const commandContext = await params.buildContext();
+                await impl.execute({}, options, commandContext);
+            };
+        }
+        else {
+            groupTuiFallback = ({ options }) => emitGroupHelpFallback(params.runtime, groupCmd, options);
+        }
+        await attachTuiAction(groupCmd, () => params.runtime, { kind: 'cli/group', interactive: int }, {}, groupTuiFallback);
+        if (verbose) {
+            (await groupLogger(params.runtime)).debug(`Group (tui/app: ${int.appId}): ${descriptor.id}`);
         }
     }
 }

package/dist/surface/register-groups.js.map

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

package/dist/surface/schemas/CLISurface.d.ts

@@ -0,0 +1,31 @@
+/** CLISurface failure-envelope and bootstrap-report contracts. */
+import type { CapabilityErrorEnvelope } from '@vibesdotdev/kernel';
+import type { CliFailureRenderOptions } from '../failure-report.ts';
+import type { CliHostOutput } from '../../boot/schemas/providers.ts';
+/** The `--json` failure envelope for a throw that is not a CapabilityError (same shape as `toEnvelope()`). */
+export interface JsonFailureEnvelope {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+}
+/** A failure envelope the surface writes: a CapabilityError's own, or the generic one. */
+export type CliFailureEnvelope = JsonFailureEnvelope | CapabilityErrorEnvelope;
+/** Options for `reportBootstrapFailure`. */
+export interface ReportBootstrapFailureOptions {
+    /**
+     * The executable host's env snapshot. No runtime exists yet, so the host
+     * hands it over; every value under a credential key is scrubbed from the
+     * report. Omitted: the report is redacted by key only.
+     */
+    readonly env?: CliFailureRenderOptions['env'];
+    /**
+     * The executable host's process output (no runtime exists yet): the report
+     * is written through it and its flush joins every tracked write before the
+     * host exits.
+     */
+    readonly output: CliHostOutput;
+}
+//# sourceMappingURL=CLISurface.d.ts.map

package/dist/surface/schemas/CLISurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLISurface.d.ts","sourceRoot":"","sources":["../../../src/surface/schemas/CLISurface.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,8GAA8G;AAC9G,MAAM,WAAW,mBAAmB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7D;AAED,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC;AAE/E,4CAA4C;AAC5C,MAAM,WAAW,6BAA6B;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAC/B"}

package/dist/surface/schemas/CLISurface.js

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

package/dist/surface/schemas/CLISurface.js.map

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

package/dist/surface/schemas/command-implementation.d.ts

@@ -0,0 +1,20 @@
+/** Command-implementation resolution contracts for hosts that own a runtime. */
+import type { CliCommandExecute, CommandOutputBoundary } from '../../schemas/command-implementation.ts';
+export type { CliCommandExecute, CommandOutputBoundary } from '../../schemas/command-implementation.ts';
+import type { RuntimePlugin } from '@vibesdotdev/kernel';
+export type CommandImplementationResolution = {
+    readonly kind: 'implemented';
+    readonly execute: CliCommandExecute;
+    readonly outputBoundary?: CommandOutputBoundary;
+    /** Fresh declarative command registration for a replacement runtime. */
+    readonly transportEntry?: RuntimePlugin;
+    /**
+     * What a transport host must compose, beside the CLI floor, for this
+     * command to run there (the implementation's declared needs).
+     */
+    readonly transportPlugins: readonly RuntimePlugin[];
+} | {
+    readonly kind: 'absent';
+    readonly reason: 'invalid' | 'default-stub';
+};
+//# sourceMappingURL=command-implementation.d.ts.map

package/dist/surface/schemas/command-implementation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-implementation.d.ts","sourceRoot":"","sources":["../../../src/surface/schemas/command-implementation.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACxG,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACxG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,+BAA+B,GACxC;IACA,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,aAAa,EAAE,CAAC;CACnD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAAA;CAAE,CAAC"}

package/dist/surface/schemas/command-implementation.js

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

package/dist/surface/schemas/command-implementation.js.map

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

package/dist/surface/schemas/interactive-gate.d.ts

@@ -0,0 +1,29 @@
+/** Interactive-gate contracts: the TUI action descriptor, the fallback, and the gate's input facts. */
+import type { CLICommandAssetDescriptor, CLIInteractiveDescriptor, CLIInteractiveLaunchWhen } from '../../schemas/descriptors.ts';
+import type { CommandOptions } from '../../schemas/surface.ts';
+import type { CommandArguments } from '../commander-action.ts';
+export interface TuiActionDescriptor {
+    kind?: 'cli/group' | 'cli/command';
+    interactive?: CLIInteractiveDescriptor;
+    arguments?: CLICommandAssetDescriptor['arguments'];
+}
+/**
+ * Fallback invoked when the CLI gate decides not to launch the TUI
+ * (no TTY, `--non-interactive`, or `launchWhen` doesn't match). For
+ * commands this typically resolves and runs the `cli/command` impl; for
+ * groups it prints help. The fallback receives the same parsed args
+ * and options the TUI would have gotten.
+ */
+export type TuiFallback = (params: {
+    args: CommandArguments;
+    options: CommandOptions;
+}) => Promise<void> | void;
+export interface InteractiveGateInput {
+    launchWhen: CLIInteractiveLaunchWhen;
+    hasPositionalArgs: boolean;
+    stdoutIsTTY: boolean;
+    stdinIsTTY: boolean;
+    nonInteractiveFlag: boolean;
+    forceTtyEnv: boolean;
+}
+//# sourceMappingURL=interactive-gate.d.ts.map

package/dist/surface/schemas/interactive-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-gate.d.ts","sourceRoot":"","sources":["../../../src/surface/schemas/interactive-gate.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,OAAO,KAAK,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAClI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;IACnC,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,SAAS,CAAC,EAAE,yBAAyB,CAAC,WAAW,CAAC,CAAC;CACnD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;CACxB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE3B,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,wBAAwB,CAAC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACrB"}

package/dist/surface/schemas/interactive-gate.js

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

package/dist/surface/schemas/interactive-gate.js.map

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