effect 4.0.0-beta.2 → 4.0.0-beta.21

package/dist/unstable/cli/GlobalFlag.js

@@ -0,0 +1,118 @@
+/**
+ * @since 4.0.0
+ */
+import * as Console from "../../Console.js";
+import * as Effect from "../../Effect.js";
+import * as Option from "../../Option.js";
+import * as ServiceMap from "../../ServiceMap.js";
+import * as CliOutput from "./CliOutput.js";
+import * as Flag from "./Flag.js";
+/* ========================================================================== */
+/* Constructors                                                               */
+/* ========================================================================== */
+/**
+ * Creates an Action flag that performs a side effect and exits.
+ *
+ * @since 4.0.0
+ * @category constructors
+ */
+export const action = options => ({
+  _tag: "Action",
+  flag: options.flag,
+  run: options.run
+});
+/**
+ * Creates a Setting flag that configures the command handler's environment.
+ *
+ * @since 4.0.0
+ * @category constructors
+ */
+export const setting = id => options => {
+  settingIdCounter += 1;
+  const ref = ServiceMap.Service(`effect/unstable/cli/GlobalFlag/${id}/${settingIdCounter}`);
+  return Object.assign(ref, {
+    _tag: "Setting",
+    id,
+    flag: options.flag
+  });
+};
+let settingIdCounter = 0;
+/* ========================================================================== */
+/* Built-in Flag References                                                   */
+/* ========================================================================== */
+import * as CommandDescriptor from "./internal/completions/CommandDescriptor.js";
+import * as CompletionsInternal from "./internal/completions/Completions.js";
+import * as HelpInternal from "./internal/help.js";
+/**
+ * The `--help` / `-h` global flag.
+ * Shows help documentation for the command.
+ *
+ * @since 4.0.0
+ * @category references
+ */
+export const Help = /*#__PURE__*/action({
+  flag: /*#__PURE__*/Flag.boolean("help").pipe(/*#__PURE__*/Flag.withAlias("h"), /*#__PURE__*/Flag.withDescription("Show help information")),
+  run: (_, {
+    command,
+    commandPath
+  }) => Effect.gen(function* () {
+    const formatter = yield* CliOutput.Formatter;
+    const helpDoc = yield* HelpInternal.getHelpForCommandPath(command, commandPath, BuiltIns);
+    yield* Console.log(formatter.formatHelpDoc(helpDoc));
+  })
+});
+/**
+ * The `--version` global flag.
+ * Shows version information for the command.
+ *
+ * @since 4.0.0
+ * @category references
+ */
+export const Version = /*#__PURE__*/action({
+  flag: /*#__PURE__*/Flag.boolean("version").pipe(/*#__PURE__*/Flag.withDescription("Show version information")),
+  run: (_, {
+    command,
+    version
+  }) => Effect.gen(function* () {
+    const formatter = yield* CliOutput.Formatter;
+    yield* Console.log(formatter.formatVersion(command.name, version));
+  })
+});
+/**
+ * The `--completions` global flag.
+ * Prints shell completion script for the given shell.
+ *
+ * @since 4.0.0
+ * @category references
+ */
+export const Completions = /*#__PURE__*/action({
+  flag: /*#__PURE__*/Flag.choice("completions", ["bash", "zsh", "fish", "sh"]).pipe(Flag.optional, /*#__PURE__*/Flag.map(v => Option.map(v, s => s === "sh" ? "bash" : s)), /*#__PURE__*/Flag.withDescription("Print shell completion script")),
+  run: (shell, {
+    command
+  }) => Effect.gen(function* () {
+    if (Option.isNone(shell)) return;
+    const descriptor = CommandDescriptor.fromCommand(command);
+    yield* Console.log(CompletionsInternal.generate(command.name, shell.value, descriptor));
+  })
+});
+/**
+ * The `--log-level` global flag.
+ * Sets the minimum log level for the command.
+ *
+ * @since 4.0.0
+ * @category references
+ */
+export const LogLevel = /*#__PURE__*/setting("log-level")({
+  flag: /*#__PURE__*/Flag.choiceWithValue("log-level", [["all", "All"], ["trace", "Trace"], ["debug", "Debug"], ["info", "Info"], ["warn", "Warn"], ["warning", "Warn"], ["error", "Error"], ["fatal", "Fatal"], ["none", "None"]]).pipe(Flag.optional, /*#__PURE__*/Flag.withDescription("Sets the minimum log level"))
+});
+/* ========================================================================== */
+/* References                                                                 */
+/* ========================================================================== */
+/**
+ * Built-in global flags in default precedence order.
+ *
+ * @since 4.0.0
+ * @category references
+ */
+export const BuiltIns = [Help, Version, Completions, LogLevel];
+//# sourceMappingURL=GlobalFlag.js.map

package/dist/unstable/cli/GlobalFlag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalFlag.js","names":["Console","Effect","Option","ServiceMap","CliOutput","Flag","action","options","_tag","flag","run","setting","id","settingIdCounter","ref","Service","Object","assign","CommandDescriptor","CompletionsInternal","HelpInternal","Help","boolean","pipe","withAlias","withDescription","_","command","commandPath","gen","formatter","Formatter","helpDoc","getHelpForCommandPath","BuiltIns","log","formatHelpDoc","Version","version","formatVersion","name","Completions","choice","optional","map","v","s","shell","isNone","descriptor","fromCommand","generate","value","LogLevel","choiceWithValue"],"sources":["../../../src/unstable/cli/GlobalFlag.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/cli/HelpDoc.d.ts

@@ -1,6 +1,8 @@
 /**
  * @since 4.0.0
  */
+import type { NonEmptyReadonlyArray } from "../../Array.ts";
+import type * as ServiceMap from "../../ServiceMap.ts";
 /**
  * Structured representation of help documentation for a command.
  * This data structure is independent of formatting, allowing for
@@ -8,11 +10,13 @@
  *
  * @example
  * ```ts
+ * import { ServiceMap } from "effect"
  * import type * as HelpDoc from "effect/unstable/cli/HelpDoc"
  *
  * const deployCommandHelp: HelpDoc.HelpDoc = {
  *   description: "Deploy your application to the cloud",
  *   usage: "myapp deploy [options] <target>",
+ *   annotations: ServiceMap.empty(),
  *   flags: [
  *     {
  *       name: "verbose",
@@ -58,6 +62,14 @@ export interface HelpDoc {
      * List of available flags/options for this command
      */
     readonly flags: ReadonlyArray<FlagDoc>;
+    /**
+     * Global flags available to all commands (e.g., --help, --version).
+     */
+    readonly globalFlags?: ReadonlyArray<FlagDoc>;
+    /**
+     * Custom command annotations.
+     */
+    readonly annotations: ServiceMap.ServiceMap<never>;
     /**
      * List of positional arguments for this command
      */
@@ -65,7 +77,27 @@ export interface HelpDoc {
     /**
      * Optional list of subcommands if this is a parent command
      */
-    readonly subcommands?: ReadonlyArray<SubcommandDoc>;
+    readonly subcommands?: ReadonlyArray<SubcommandGroupDoc>;
+    /**
+     * Optional concrete usage examples for the command
+     */
+    readonly examples?: ReadonlyArray<ExampleDoc>;
+}
+/**
+ * Documentation for a command usage example
+ *
+ * @since 4.0.0
+ * @category models
+ */
+export interface ExampleDoc {
+    /**
+     * Command line invocation example
+     */
+    readonly command: string;
+    /**
+     * Optional explanation for the example
+     */
+    readonly description?: string | undefined;
 }
 /**
  * Documentation for a single command-line flag/option
@@ -121,15 +153,20 @@ export interface FlagDoc {
  *
  * @example
  * ```ts
+ * import { ServiceMap } from "effect"
  * import type { HelpDoc } from "effect/unstable/cli"
  *
  * const deploySubcommand: HelpDoc.SubcommandDoc = {
  *   name: "deploy",
+ *   alias: "d",
+ *   shortDescription: "Deploy app",
  *   description: "Deploy the application to the cloud"
  * }
  *
  * const buildSubcommand: HelpDoc.SubcommandDoc = {
  *   name: "build",
+ *   alias: undefined,
+ *   shortDescription: undefined,
  *   description: "Build the application for production"
  * }
  *
@@ -137,8 +174,12 @@ export interface FlagDoc {
  * const mainCommandHelp: HelpDoc.HelpDoc = {
  *   description: "Cloud deployment tool",
  *   usage: "myapp <command> [options]",
+ *   annotations: ServiceMap.empty(),
  *   flags: [],
- *   subcommands: [deploySubcommand, buildSubcommand]
+ *   subcommands: [{
+ *     group: undefined,
+ *     commands: [deploySubcommand, buildSubcommand]
+ *   }]
  * }
  * ```
  *
@@ -150,16 +191,42 @@ export interface SubcommandDoc {
      * Name of the subcommand
      */
     readonly name: string;
+    /**
+     * Optional short alias for invoking the subcommand.
+     */
+    readonly alias: string | undefined;
+    /**
+     * Optional short description of what the subcommand does.
+     */
+    readonly shortDescription: string | undefined;
     /**
      * Brief description of what the subcommand does
      */
     readonly description: string;
 }
+/**
+ * Documentation for a grouped subcommand listing
+ *
+ * @since 4.0.0
+ * @category models
+ */
+export interface SubcommandGroupDoc {
+    /**
+     * Group name used in help output.
+     * Undefined means the default ungrouped section.
+     */
+    readonly group: string | undefined;
+    /**
+     * Subcommands in this group.
+     */
+    readonly commands: NonEmptyReadonlyArray<SubcommandDoc>;
+}
 /**
  * Documentation for a positional argument
  *
  * @example
  * ```ts
+ * import { ServiceMap } from "effect"
  * import type { HelpDoc } from "effect/unstable/cli"
  *
  * const sourceArg: HelpDoc.ArgDoc = {
@@ -182,6 +249,7 @@ export interface SubcommandDoc {
  * const copyCommandHelp: HelpDoc.HelpDoc = {
  *   description: "Copy files from source to destination",
  *   usage: "copy <source> [files...]",
+ *   annotations: ServiceMap.empty(),
  *   flags: [],
  *   args: [sourceArg, filesArg]
  * }

package/dist/unstable/cli/HelpDoc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HelpDoc.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/HelpDoc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAEtC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAErC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;CACpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B"}
+{"version":3,"file":"HelpDoc.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/HelpDoc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,KAAK,KAAK,UAAU,MAAM,qBAAqB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAElD;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAErC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IAExD;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAA;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B"}

package/dist/unstable/cli/index.d.ts

@@ -21,6 +21,10 @@ export * as Command from "./Command.ts";
  * @since 4.0.0
  */
 export * as Flag from "./Flag.ts";
+/**
+ * @since 4.0.0
+ */
+export * as GlobalFlag from "./GlobalFlag.ts";
 /**
  * @since 4.0.0
  */

package/dist/unstable/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAgBvC;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAgBvC;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}

package/dist/unstable/cli/index.js

@@ -22,6 +22,10 @@ export * as Command from "./Command.js";
  * @since 4.0.0
  */
 export * as Flag from "./Flag.js";
+/**
+ * @since 4.0.0
+ */
+export * as GlobalFlag from "./GlobalFlag.js";
 /**
  * @since 4.0.0
  */

package/dist/unstable/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Argument","CliError","CliOutput","Command","Flag","HelpDoc","Param","Primitive","Prompt"],"sources":["../../../src/unstable/cli/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAKA,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C;;;AAGA,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;AAGA,OAAO,KAAKC,IAAI,MAAM,WAAW;AAEjC;;;AAGA,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;;;;;;;;;;AAYA,OAAO,KAAKC,KAAK,MAAM,YAAY;AAEnC;;;;;;;;;;;;;AAaA,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C;;;AAGA,OAAO,KAAKC,MAAM,MAAM,aAAa","ignoreList":[]}
+{"version":3,"file":"index.js","names":["Argument","CliError","CliOutput","Command","Flag","GlobalFlag","HelpDoc","Param","Primitive","Prompt"],"sources":["../../../src/unstable/cli/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAKA,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C;;;AAGA,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;AAGA,OAAO,KAAKC,IAAI,MAAM,WAAW;AAEjC;;;AAGA,OAAO,KAAKC,UAAU,MAAM,iBAAiB;AAE7C;;;AAGA,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;;;;;;;;;;AAYA,OAAO,KAAKC,KAAK,MAAM,YAAY;AAEnC;;;;;;;;;;;;;AAaA,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C;;;AAGA,OAAO,KAAKC,MAAM,MAAM,aAAa","ignoreList":[]}

package/dist/unstable/cli/internal/command.d.ts

@@ -5,19 +5,27 @@
  * Internal implementation details for CLI commands.
  * Public API is in ../Command.ts
  */
+import * as Arr from "../../../Array.ts";
 import * as Effect from "../../../Effect.ts";
 import * as ServiceMap from "../../../ServiceMap.ts";
 import * as CliError from "../CliError.ts";
+import type * as GlobalFlag from "../GlobalFlag.ts";
 import type { HelpDoc } from "../HelpDoc.ts";
 import { type ConfigInternal } from "./config.ts";
 import type { Command, CommandContext, Environment, ParsedTokens } from "../Command.ts";
+interface SubcommandGroup {
+    readonly group: string | undefined;
+    readonly commands: Arr.NonEmptyReadonlyArray<Command<any, unknown, unknown, unknown>>;
+}
 /**
  * Internal implementation interface with all the machinery.
  * Use toImpl() to access from internal code.
  */
 export interface CommandInternal<Name extends string, Input, E, R> extends Command<Name, Input, E, R> {
     readonly config: ConfigInternal;
-    readonly service: ServiceMap.Service<CommandContext<Name>, Input>;
+    readonly service: ServiceMap.Key<CommandContext<Name>, Input>;
+    readonly annotations: ServiceMap.ServiceMap<never>;
+    readonly globalFlags: ReadonlyArray<GlobalFlag.GlobalFlag<any>>;
     readonly parse: (input: ParsedTokens) => Effect.Effect<Input, CliError.CliError, Environment>;
     readonly handle: (input: Input, commandPath: ReadonlyArray<string>) => Effect.Effect<void, E | CliError.CliError, R | Environment>;
     readonly buildHelpDoc: (commandPath: ReadonlyArray<string>) => HelpDoc;
@@ -39,9 +47,14 @@ export declare const Proto: {
 export declare const makeCommand: <const Name extends string, Input, E, R>(options: {
     readonly name: Name;
     readonly config: ConfigInternal;
-    readonly service?: ServiceMap.Service<CommandContext<Name>, Input> | undefined;
+    readonly service?: ServiceMap.Key<CommandContext<Name>, Input> | undefined;
+    readonly annotations?: ServiceMap.ServiceMap<never> | undefined;
+    readonly globalFlags?: ReadonlyArray<GlobalFlag.GlobalFlag<any>> | undefined;
     readonly description?: string | undefined;
-    readonly subcommands?: ReadonlyArray<Command<any, unknown, unknown, unknown>> | undefined;
+    readonly shortDescription?: string | undefined;
+    readonly alias?: string | undefined;
+    readonly examples?: ReadonlyArray<Command.Example> | undefined;
+    readonly subcommands?: ReadonlyArray<SubcommandGroup> | undefined;
     readonly parse?: ((input: ParsedTokens) => Effect.Effect<Input, CliError.CliError, Environment>) | undefined;
     readonly handle?: ((input: Input, commandPath: ReadonlyArray<string>) => Effect.Effect<void, E, R | Environment>) | undefined;
 }) => Command<Name, Input, E, R>;
@@ -49,9 +62,5 @@ export declare const makeCommand: <const Name extends string, Input, E, R>(optio
  * Checks for duplicate flag names between parent and child commands.
  */
 export declare const checkForDuplicateFlags: <Name extends string, Input>(parent: Command<Name, Input, unknown, unknown>, subcommands: ReadonlyArray<Command<any, unknown, unknown, unknown>>) => void;
-/**
- * Helper function to get help documentation for a specific command path.
- * Navigates through the command hierarchy to find the right command.
- */
-export declare const getHelpForCommandPath: <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>, commandPath: ReadonlyArray<string>) => HelpDoc;
+export {};
 //# sourceMappingURL=command.d.ts.map

package/dist/unstable/cli/internal/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli/internal/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli/internal/command.ts"],"names":[],"mappings":"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"}

package/dist/unstable/cli/internal/command.js

@@ -5,6 +5,7 @@
  * Internal implementation details for CLI commands.
  * Public API is in ../Command.ts
  */
+import * as Arr from "../../../Array.js";
 import * as Effect from "../../../Effect.js";
 import { YieldableProto } from "../../../internal/core.js";
 import { pipeArguments } from "../../../Pipeable.js";
@@ -47,6 +48,9 @@ export const Proto = {
 export const makeCommand = options => {
   const service = options.service ?? ServiceMap.Service(`${TypeId}/${options.name}`);
   const config = options.config;
+  const annotations = options.annotations ?? ServiceMap.empty();
+  const globalFlags = options.globalFlags ?? [];
+  const subcommands = options.subcommands ?? [];
   const handle = (input, commandPath) => Predicate.isNotUndefined(options.handle) ? options.handle(input, commandPath) : Effect.fail(new CliError.ShowHelp({
     commandPath
   }));
@@ -75,8 +79,7 @@ export const makeCommand = options => {
       }
     }
     let usage = commandPath.length > 0 ? commandPath.join(" ") : options.name;
-    const subcommands = options.subcommands ?? [];
-    if (subcommands.length > 0) {
+    if (subcommands.some(group => group.commands.length > 0)) {
       usage += " <subcommand>";
     }
     usage += " [flags]";
@@ -97,26 +100,42 @@ export const makeCommand = options => {
         });
       }
     }
-    const subcommandDocs = subcommands.map(sub => ({
-      name: sub.name,
-      description: sub.description ?? ""
-    }));
+    const subcommandDocs = [];
+    for (const group of subcommands) {
+      subcommandDocs.push({
+        group: group.group,
+        commands: Arr.map(group.commands, subcommand => ({
+          name: subcommand.name,
+          alias: subcommand.alias,
+          shortDescription: subcommand.shortDescription,
+          description: subcommand.description ?? ""
+        }))
+      });
+    }
+    const examples = options.examples ?? [];
     return {
       description: options.description ?? "",
       usage,
       flags,
+      annotations,
       ...(args.length > 0 && {
         args
       }),
       ...(subcommandDocs.length > 0 && {
         subcommands: subcommandDocs
+      }),
+      ...(examples.length > 0 && {
+        examples
       })
     };
   };
   return Object.assign(Object.create(Proto), {
     [TypeId]: TypeId,
     name: options.name,
-    subcommands: options.subcommands ?? [],
+    examples: options.examples ?? [],
+    annotations,
+    globalFlags,
+    subcommands,
     config,
     service,
     parse,
@@ -124,6 +143,12 @@ export const makeCommand = options => {
     buildHelpDoc,
     ...(Predicate.isNotUndefined(options.description) ? {
       description: options.description
+    } : {}),
+    ...(Predicate.isNotUndefined(options.shortDescription) ? {
+      shortDescription: options.shortDescription
+    } : {}),
+    ...(Predicate.isNotUndefined(options.alias) ? {
+      alias: options.alias
     } : {})
   });
 };
@@ -178,20 +203,4 @@ export const checkForDuplicateFlags = (parent, subcommands) => {
     }
   }
 };
-/**
- * Helper function to get help documentation for a specific command path.
- * Navigates through the command hierarchy to find the right command.
- */
-export const getHelpForCommandPath = (command, commandPath) => {
-  let currentCommand = command;
-  // Navigate through the command path to find the target command
-  for (let i = 1; i < commandPath.length; i++) {
-    const subcommandName = commandPath[i];
-    const subcommand = currentCommand.subcommands.find(sub => sub.name === subcommandName);
-    if (subcommand) {
-      currentCommand = subcommand;
-    }
-  }
-  return toImpl(currentCommand).buildHelpDoc(commandPath);
-};
 //# sourceMappingURL=command.js.map

package/dist/unstable/cli/internal/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","names":["Effect","YieldableProto","pipeArguments","Predicate","ServiceMap","CliError","Param","Primitive","reconstructTree","TypeId","toImpl","self","Proto","pipe","arguments","asEffect","service","makeCommand","options","Service","name","config","handle","input","commandPath","isNotUndefined","fail","ShowHelp","parse","fnUntraced","parsedArgs","flags","values","parseParams","orderedParams","tree","buildHelpDoc","args","arg","singles","extractSingleParams","metadata","getParamMetadata","single","push","type","typeName","getTypeName","primitiveType","description","required","isOptional","variadic","isVariadic","usage","length","join","subcommands","argName","option","formattedAliases","aliases","map","alias","_tag","subcommandDocs","sub","Object","assign","create","params","results","currentArguments","remainingArguments","parsed","checkForDuplicateFlags","parent","parentImpl","parentOptionNames","Set","extractNames","add","subcommand","subImpl","has","DuplicateOption","parentCommand","childCommand","getHelpForCommandPath","command","currentCommand","i","subcommandName","find"],"sources":["../../../../src/unstable/cli/internal/command.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"command.js","names":["Arr","Effect","YieldableProto","pipeArguments","Predicate","ServiceMap","CliError","Param","Primitive","reconstructTree","TypeId","toImpl","self","Proto","pipe","arguments","asEffect","service","makeCommand","options","Service","name","config","annotations","empty","globalFlags","subcommands","handle","input","commandPath","isNotUndefined","fail","ShowHelp","parse","fnUntraced","parsedArgs","flags","values","parseParams","orderedParams","tree","buildHelpDoc","args","arg","singles","extractSingleParams","metadata","getParamMetadata","single","push","type","typeName","getTypeName","primitiveType","description","required","isOptional","variadic","isVariadic","usage","length","join","some","group","commands","argName","option","formattedAliases","aliases","map","alias","_tag","subcommandDocs","subcommand","shortDescription","examples","Object","assign","create","params","results","currentArguments","remainingArguments","parsed","checkForDuplicateFlags","parent","parentImpl","parentOptionNames","Set","extractNames","add","subImpl","has","DuplicateOption","parentCommand","childCommand"],"sources":["../../../../src/unstable/cli/internal/command.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/cli/internal/completions/CommandDescriptor.js

@@ -119,10 +119,15 @@ export const fromCommand = cmd => {
       });
     }
   }
-  const subcommands = cmd.subcommands.map(fromCommand);
+  const subcommands = [];
+  for (const group of cmd.subcommands) {
+    for (const subcommand of group.commands) {
+      subcommands.push(fromCommand(subcommand));
+    }
+  }
   return {
     name: cmd.name,
-    description: cmd.description,
+    description: cmd.shortDescription ?? cmd.description,
     flags,
     arguments: args,
     subcommands

package/dist/unstable/cli/internal/completions/CommandDescriptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandDescriptor.js","names":["Param","Primitive","toImpl","toFlagType","single","tag","primitiveType","_tag","keys","getChoiceKeys","values","typeName","pathType","toArgumentType","fromCommand","cmd","impl","config","flags","flag","singles","extractSingleParams","kind","push","name","aliases","description","type","args","arg","arguments","metadata","getParamMetadata","required","isOptional","variadic","isVariadic","subcommands","map"],"sources":["../../../../../src/unstable/cli/internal/completions/CommandDescriptor.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"CommandDescriptor.js","names":["Param","Primitive","toImpl","toFlagType","single","tag","primitiveType","_tag","keys","getChoiceKeys","values","typeName","pathType","toArgumentType","fromCommand","cmd","impl","config","flags","flag","singles","extractSingleParams","kind","push","name","aliases","description","type","args","arg","arguments","metadata","getParamMetadata","required","isOptional","variadic","isVariadic","subcommands","group","subcommand","commands","shortDescription"],"sources":["../../../../../src/unstable/cli/internal/completions/CommandDescriptor.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/cli/internal/help.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Help Documentation
+ * ================
+ *
+ * Internal helpers for generating help documentation.
+ * Extracted from command.ts to avoid circular dependencies.
+ */
+import * as Effect from "../../../Effect.ts";
+import type { Command } from "../Command.ts";
+import type * as GlobalFlag from "../GlobalFlag.ts";
+import type { HelpDoc } from "../HelpDoc.ts";
+/**
+ * Returns the resolved command lineage for the provided path.
+ * Includes the root command as the first element.
+ */
+export declare const getCommandsForCommandPath: <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>, commandPath: ReadonlyArray<string>) => ReadonlyArray<Command.Any>;
+/**
+ * Returns active global flags for a command path.
+ * Built-ins are prepended and declarations are collected root -> leaf.
+ */
+export declare const getGlobalFlagsForCommandPath: <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>, commandPath: ReadonlyArray<string>, builtIns: ReadonlyArray<GlobalFlag.GlobalFlag<any>>) => ReadonlyArray<GlobalFlag.GlobalFlag<any>>;
+/**
+ * Returns all global flags declared in a command tree.
+ * Built-ins are prepended and command declarations are deduplicated by identity.
+ */
+export declare const getGlobalFlagsForCommandTree: <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>, builtIns: ReadonlyArray<GlobalFlag.GlobalFlag<any>>) => ReadonlyArray<GlobalFlag.GlobalFlag<any>>;
+/**
+ * Helper function to get help documentation for a specific command path.
+ * Navigates through the command hierarchy to find the right command.
+ * Reads active global flags for the path and includes them in the help doc.
+ */
+export declare const getHelpForCommandPath: <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>, commandPath: ReadonlyArray<string>, builtIns: ReadonlyArray<GlobalFlag.GlobalFlag<any>>) => Effect.Effect<HelpDoc, never, never>;
+//# sourceMappingURL=help.d.ts.map

package/dist/unstable/cli/internal/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli/internal/help.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,UAAU,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,eAAe,CAAA;AAoBrD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,IAAI,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EACxE,SAAS,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EACnC,aAAa,aAAa,CAAC,MAAM,CAAC,KACjC,aAAa,CAAC,OAAO,CAAC,GAAG,CAwB3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,IAAI,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAC3E,SAAS,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EACnC,aAAa,aAAa,CAAC,MAAM,CAAC,EAClC,UAAU,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAClD,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAO1C,CAAA;AAqBD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,IAAI,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAC3E,SAAS,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EACnC,UAAU,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAClD,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAIvC,CAAA;AAEJ;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,IAAI,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EACpE,SAAS,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EACnC,aAAa,aAAa,CAAC,MAAM,CAAC,EAClC,UAAU,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAClD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAwBlC,CAAA"}