@travetto/cli 8.0.0-alpha.3 → 8.0.0-alpha.30

package/README.md

@@ -13,7 +13,7 @@ npm install @travetto/cli
 yarn add @travetto/cli
 ```
 
-The cli module represents the primary entry point for execution within the framework. One of the main goals for this module is extensibility, as adding new entry points is meant to be trivial. The framework leverages this module for exposing all executable tools and entry points.  To see a high level listing of all supported commands, invoke `trv --help`
+The cli module represents the primary entry point for execution within the framework. One of the main goals for this module is extensibility, as adding new entry points is meant to be trivial. The framework leverages this module for exposing all executable tools and entry points. To see a high level listing of all supported commands, invoke `trv --help`
 
 **Terminal: General Usage**
 ```bash
@@ -22,44 +22,50 @@ $ trv --help
 Usage:  [options] [command]
 
 Commands:
-  doc               Command line support for generating module docs.
-  doc:angular       Generate documentation into the angular webapp under related/travetto.github.io
-  doc:mapping       Generate module mapping for
-  email:compile     CLI Entry point for running the email server
-  email:editor      The email editor compilation service and output serving
-  email:test        CLI Entry point for running the email server
-  eslint            Command line support for eslint
-  eslint:register   Writes the eslint configuration file
-  model:export      Exports model schemas
-  model:install     Installing models
-  openapi:client    CLI for generating the cli client
-  openapi:spec      CLI for outputting the open api spec to a local file
-  pack              Standard pack support
-  pack:docker       Standard docker support for pack
-  pack:lambda       Standard lambda support for pack
-  pack:zip          Standard zip support for pack
-  repo:exec         Repo execution
-  repo:list         Allows for listing of modules
-  repo:publish      Publish all pending modules
-  repo:version      Version all changed dependencies
-  repo:version-sync Enforces all packages to write out their versions and dependencies
-  run:double        Doubles a number
-  scaffold          Command to run scaffolding
-  service           Allows for running services
-  test              Launch test framework and execute tests
-  test:watch        Invoke the test watcher
-  web:http          Run a web server
-  web:rpc-client    Generate the web-rpc client
+  doc                   Generate documentation outputs from a module `DOC.tsx` entry file.
+  doc:angular           Generate documentation into the angular webapp under related/travetto.github.io
+  doc:mapping           Generate module mapping for
+  email:compile         Compile all email templates into generated runtime artifacts.
+  email:editor          Start the email template editor service for interactive preview and testing.
+  email:test            Render and send a template file to a target recipient for quick validation.
+  firestore:indexes     Generate the Firestore composite indexes JSON for all registered models.
+  lint                  Run Biome linter/formatter for the workspace or changed files.
+  lint:register         Generate the workspace Biome configuration entry file.
+  llm:support:execute   Execute llm-support operations with dry-run by default.
+  llm:support:inline    Inline and compile reference snippets for llm-support packaging.
+  llm:support:mcp       Minimal MCP stdio server for llm-support tools.
+  llm:support:plan      Build plan-first execution details for llm-support operations.
+  llm:support:recommend Recommend llm-support bundles, workflows, and operations.
+  llm:support:status    Show llm-support execution coverage status.
+  model:export          Export model definitions for a selected provider and model set.
+  model:install         Install or update model definitions for a selected provider.
+  openapi:client        Generate API clients from an OpenAPI specification using the generator image.
+  openapi:spec          Generate the OpenAPI specification for the selected module.
+  pack                  Build a standard module package artifact.
+  pack:docker           Build container-ready artifacts and optionally publish Docker images.
+  pack:lambda           Build an AWS Lambda-ready zip package using the pack pipeline.
+  pack:zip              Build a deployable zip artifact using the standard pack pipeline.
+  repo:exec             Execute a shell command across workspace modules.
+  repo:list             List workspace modules and their relationships.
+  repo:publish          Publish unpublished workspace modules to the package registry.
+  repo:version          Bump workspace module versions and optionally commit/tag release metadata.
+  repo:version-sync     Synchronize package versions and dependency ranges across the monorepo.
+  run:double            Doubles a number
+  service               Manage development services (start/stop/restart/status) across the workspace.
+  test                  Execute the test framework for targeted files, suites, or methods.
+  test:watch            Start the test watcher for continuous test execution.
+  web:http              Start the configured web HTTP server for a module.
+  web:rpc-client        Generate web-rpc client artifacts from a specified provider or leveraging local config.
 ```
 
 This listing is from the [Travetto](https://travetto.dev) monorepo, and represents the majority of tools that can be invoked from the command line. 
 
-This module also has a tight integration with the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=arcsine.travetto-plugin), allowing the editing experience to benefit from the commands defined. The most commonly used commands will be the ones packaged with the framework, but its also very easy to create new commands.  With the correct configuration, these commands will also be exposed within VSCode.
+This module also has a tight integration with the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=arcsine.travetto-plugin), allowing the editing experience to benefit from the commands defined. The most commonly used commands will be the ones packaged with the framework, but its also very easy to create new commands. With the correct configuration, these commands will also be exposed within VSCode.
 
 At it's heart, a cli command is the contract defined by what flags, and what arguments the command supports. Within the framework this requires three criteria to be met:
    *  The file must be located in the `support/` folder, and have a name that matches `cli.*.ts`
    *  The file must be a class that has a main method
-   *  The class must use the [@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L27) decorator
+   *  The class must use the [@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L20) decorator
 
 **Code: Basic Command**
 ```typescript
@@ -75,16 +81,16 @@ export class BasicCommand {
 
 **Terminal: Basic Command Help**
 ```bash
-$ trv basic -h
+$ trv basic --help
 
 Usage: basic [options]
 
 Options:
-  -h, --help  display help for command
+  --help  display help for command
 ```
 
 ## Command Naming
-The file name `support/cli.<name>.ts` has a direct mapping to the cli command name.   This hard mapping allows for the framework to be able to know which file to invoke without needing to load all command-related files. 
+The file name `support/cli.<name>.ts` has a direct mapping to the cli command name. This hard mapping allows for the framework to be able to know which file to invoke without needing to load all command-related files. 
 
 Examples of mappings:
    *  `cli.test.ts` maps to `test`
@@ -94,7 +100,7 @@ Examples of mappings:
 The pattern is that underscores(_) translate to colons (:), and the `cli.` prefix, and `.ts` suffix are dropped.
 
 ## Binding Flags
-[@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L27) is a wrapper for [@Schema](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/schema.ts#L19), and so every class that uses the [@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L27) decorator is now a full [@Schema](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/schema.ts#L19) class. The fields of the class represent the flags that are available to the command.
+[@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L20) is a wrapper for [@Schema](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/schema.ts#L19), and so every class that uses the [@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L20) decorator is now a full [@Schema](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/schema.ts#L19) class. The fields of the class represent the flags that are available to the command.
 
 **Code: Basic Command with Flag**
 ```typescript
@@ -102,7 +108,6 @@ import { CliCommand } from '@travetto/cli';
 
 @CliCommand()
 export class BasicCommand {
-
   loud?: boolean;
 
   main() {
@@ -113,16 +118,16 @@ export class BasicCommand {
 
 **Terminal: Basic Command with Flag Help**
 ```bash
-$ trv basic:flag -h
+$ trv basic:flag --help
 
 Usage: basic:flag [options]
 
 Options:
   -l, --loud
-  -h, --help  display help for command
+  --help      display help for command
 ```
 
-As you can see the command now has the support of a basic boolean flag to determine if the response should be loud or not.  The default value here is undefined/false, and so is an opt-in experience.
+As you can see the command now has the support of a basic boolean flag to determine if the response should be loud or not. The default value here is undefined/false, and so is an opt-in experience.
 
 **Terminal: Basic Command with Loud Flag**
 ```bash
@@ -131,16 +136,16 @@ $ trv basic:flag --loud
 HELLO
 ```
 
-The [@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L27) supports the following data types for flags:
+The [@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L20) supports the following data types for flags:
    *  Boolean values
-   *  Number values. The [@Integer](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L172), [@Float](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L179), [@Precision](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L165), [@Min](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L99) and [@Max](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L110) decorators help provide additional validation.
-   *  String values. [@MinLength](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L99), [@MaxLength](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L110), [@Match](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L90) and [@Enum](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L64) provide additional constraints
-   *  Date values. The [@Min](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L99) and [@Max](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L110) decorators help provide additional validation.
+   *  Number values. The [@Integer](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L202), [@Float](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L211), [@Precision](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L193), [@Min](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L119) and [@Max](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L130) decorators help provide additional validation.
+   *  String values. [@MinLength](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L119), [@MaxLength](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L130), [@Match](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L108) and [@Enum](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L78) provide additional constraints
+   *  Date values. The [@Min](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L119) and [@Max](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/input.ts#L130) decorators help provide additional validation.
    *  String lists. Same as String, but allowing multiple values.
    *  Numeric lists. Same as Number, but allowing multiple values.
 
 ## Binding Arguments
-The `main()` method is the entrypoint for the command, represents a series of parameters. Some will be required, some may be optional.  The arguments support all types supported by the flags, and decorators can be provided using the decorators inline on parameters.     Optional arguments in the method, will be optional at run time, and filled with the provided default values.
+The `main()` method is the entrypoint for the command, represents a series of parameters. Some will be required, some may be optional. The arguments support all types supported by the flags, and decorators can be provided using the decorators inline on parameters. Optional arguments in the method, will be optional at run time, and filled with the provided default values.
 
 **Code: Basic Command with Arg**
 ```typescript
@@ -149,7 +154,6 @@ import { Max, Min } from '@travetto/schema';
 
 @CliCommand()
 export class BasicCommand {
-
   main(@Min(1) @Max(10) volume: number = 1) {
     console.log(volume > 7 ? 'HELLO' : 'Hello');
   }
@@ -158,12 +162,12 @@ export class BasicCommand {
 
 **Terminal: Basic Command**
 ```bash
-$ trv basic:arg -h
+$ trv basic:arg --help
 
 Usage: basic:arg [options] [volume:number]
 
 Options:
-  -h, --help  display help for command
+  --help  display help for command
 ```
 
 **Terminal: Basic Command with Invalid Loud Arg**
@@ -176,7 +180,7 @@ Execution failed:
 Usage: basic:arg [options] [volume:number]
 
 Options:
-  -h, --help  display help for command
+  --help  display help for command
 ```
 
 **Terminal: Basic Command with Loud Arg > 7**
@@ -202,7 +206,6 @@ import { Max, Min } from '@travetto/schema';
 
 @CliCommand()
 export class BasicCommand {
-
   reverse?: boolean;
 
   main(@Min(1) @Max(10) volumes: number[]) {
@@ -213,13 +216,13 @@ export class BasicCommand {
 
 **Terminal: Basic Command**
 ```bash
-$ trv basic:arg-list -h
+$ trv basic:arg-list --help
 
 Usage: basic:arg-list [options] <volumes...:number>
 
 Options:
   -r, --reverse
-  -h, --help     display help for command
+  --help         display help for command
 ```
 
 **Terminal: Basic Arg List**
@@ -240,7 +243,7 @@ Usage: basic:arg-list [options] <volumes...:number>
 
 Options:
   -r, --reverse
-  -h, --help     display help for command
+  --help         display help for command
 ```
 
 **Terminal: Basic Arg List with Reverse**
@@ -251,7 +254,7 @@ $ trv basic:arg-list -r 10 5 3 9 8 1
 ```
 
 ## Customization
-By default, all fields are treated as flags and all parameters of `main()` are treated as arguments within the validation process.  Like the standard [@Schema](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/schema.ts#L19) behavior, we can leverage the metadata of the fields/parameters to help provide additional customization/context for the users of the commands.
+By default, all fields are treated as flags and all parameters of `main()` are treated as arguments within the validation process. Like the standard [@Schema](https://github.com/travetto/travetto/tree/main/module/schema/src/decorator/schema.ts#L19) behavior, we can leverage the metadata of the fields/parameters to help provide additional customization/context for the users of the commands.
 
 **Code: Custom Command with Metadata**
 ```typescript
@@ -259,11 +262,10 @@ import { CliCommand } from '@travetto/cli';
 import { Max, Min } from '@travetto/schema';
 
 /**
- * Custom Argument Command
+ * Example command with a custom argument
  */
 @CliCommand()
 export class CustomCommand {
-
   /**
    * The message to send back to the user
    * @alias -m
@@ -279,13 +281,16 @@ export class CustomCommand {
 
 **Terminal: Custom Command Help**
 ```bash
-$ trv custom:arg -h
+$ trv custom:arg --help
 
 Usage: custom:arg [options] [volume:number]
 
+Description:
+  Example command with a custom argument
+
 Options:
   -m, --message <string>  The message to send back to the user (default: "hello")
-  -h, --help              display help for command
+  --help                  display help for command
 ```
 
 **Terminal: Custom Command Help with overridden Text**
@@ -311,11 +316,10 @@ import { CliCommand } from '@travetto/cli';
 import { Max, Min } from '@travetto/schema';
 
 /**
- * Custom Argument Command
+ * Example of a command with a custom environment variable argument
  */
 @CliCommand()
 export class CustomCommand {
-
   /**
    * The message to send back to the user
    * @alias env.MESSAGE
@@ -330,13 +334,16 @@ export class CustomCommand {
 
 **Terminal: Custom Command Help**
 ```bash
-$ trv custom:env-arg -h
+$ trv custom:env-arg --help
 
 Usage: custom:env-arg [options] [volume:number]
 
+Description:
+  Example of a command with a custom environment variable argument
+
 Options:
   -t, --text <string>  The message to send back to the user (default: "hello")
-  -h, --help           display help for command
+  --help               display help for command
 ```
 
 **Terminal: Custom Command Help with default Text**
@@ -361,7 +368,7 @@ CuStOm
 ```
 
 ## Flag File Support
-Sometimes its also convenient, especially with commands that support a variety of flags, to provide easy access to pre-defined sets of flags.  Flag files represent a snapshot of command line arguments and flags, as defined in a file.  When referenced, these inputs are essentially injected into the command line as if the user had typed them manually.
+Sometimes its also convenient, especially with commands that support a variety of flags, to provide easy access to pre-defined sets of flags. Flag files represent a snapshot of command line arguments and flags, as defined in a file. When referenced, these inputs are essentially injected into the command line as if the user had typed them manually.
 
 **Code: Example Flag File**
 ```bash
@@ -390,7 +397,7 @@ npx trv call:db --host localhost --port 3306 --username app --password <custom>
 ```
 
 ## VSCode Integration
-By default, cli commands do not expose themselves to the VSCode extension, as the majority of them are not intended for that sort of operation.  [Web API](https://github.com/travetto/travetto/tree/main/module/web#readme "Declarative support for creating Web Applications") does expose a cli target `web:http` that will show up, to help run/debug a web application.  Any command can mark itself as being a run target, and will be eligible for running from within the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=arcsine.travetto-plugin). This is achieved by setting the `runTarget` field on the [@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L27) decorator.  This means the target will be visible within the editor tooling.
+By default, cli commands do not expose themselves to the VSCode extension, as the majority of them are not intended for that sort of operation. [Web API](https://github.com/travetto/travetto/tree/main/module/web#readme "Declarative support for creating Web Applications") does expose a cli target `web:http` that will show up, to help run/debug a web application. Any command can mark itself as being a run target, and will be eligible for running from within the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=arcsine.travetto-plugin). This is achieved by setting the `runTarget` field on the [@CliCommand](https://github.com/travetto/travetto/tree/main/module/cli/src/registry/decorator.ts#L20) decorator. This means the target will be visible within the editor tooling.
 
 **Code: Simple Run Target**
 ```typescript
@@ -401,7 +408,6 @@ import { CliCommand } from '@travetto/cli';
  */
 @CliCommand({ runTarget: true })
 export class RunCommand {
-
   main(name: string) {
     console.log(name);
   }
@@ -433,20 +439,26 @@ If the goal is to run a more complex application, which may include depending on
 
 **Code: Simple Run Target**
 ```typescript
-import { Runtime, toConcrete } from '@travetto/runtime';
+import { CliCommand, type CliCommandShape, CliDebugIpcFlag, CliModuleFlag, CliProfilesFlag, CliRestartOnChangeFlag } from '@travetto/cli';
 import { DependencyRegistryIndex } from '@travetto/di';
-import { CliCommand, CliDebugIpcFlag, CliModuleFlag, CliProfilesFlag, CliRestartOnChangeFlag, type CliCommandShape } from '@travetto/cli';
-import { NetUtil } from '@travetto/web';
 import { Registry } from '@travetto/registry';
+import { Runtime, toConcrete } from '@travetto/runtime';
+import { NetUtil } from '@travetto/web';
 
 import type { WebHttpServer } from '../src/types.ts';
 
 /**
- * Run a web server
+ * Start the configured web HTTP server for a module.
+ *
+ * Initializes registry and server bindings, supports restart-aware development
+ * flags, and can attempt to clear conflicting port owners in local workflows.
+ *
+ * @example
+ * Starting a web server on port 8000
+ * > trv web:http -m <MODULE> -p 8000
  */
 @CliCommand()
 export class WebHttpCommand implements CliCommandShape {
-
   /** Port to run on */
   port?: number;
 
@@ -460,7 +472,7 @@ export class WebHttpCommand implements CliCommandShape {
   profile: string[];
 
   @CliRestartOnChangeFlag()
-  restartOnChange: boolean = true;
+  restartOnChange: boolean = Runtime.localDevelopment;
 
   @CliDebugIpcFlag()
   debugIpc?: boolean;
@@ -493,7 +505,7 @@ export class WebHttpCommand implements CliCommandShape {
 
 As noted in the example above, `fields` is specified in this execution, with support for `module`, and `env`. These env flag is directly tied to the [Runtime](https://github.com/travetto/travetto/tree/main/module/runtime/src/context.ts#L13) `name` defined in the [Runtime](https://github.com/travetto/travetto/tree/main/module/runtime#readme "Runtime for travetto applications.") module. 
 
-The `module` field is slightly more complex, but is geared towards supporting commands within a monorepo context.  This flag ensures that a module is specified if running from the root of the monorepo, and that the module provided is real, and can run the desired command.  When running from an explicit module folder in the monorepo, the module flag is ignored.
+The `module` field is slightly more complex, but is geared towards supporting commands within a monorepo context. This flag ensures that a module is specified if running from the root of the monorepo, and that the module provided is real, and can run the desired command. When running from an explicit module folder in the monorepo, the module flag is ignored.
 
 ### Custom Validation
 In addition to dependency injection, the command contract also allows for a custom validation function, which will have access to bound command (flags, and args) as well as the unknown arguments. When a command implements this method, any [ValidationError](https://github.com/travetto/travetto/tree/main/module/schema/src/validate/types.ts#L10) errors that are returned will be shared with the user, and fail to invoke the `main` method.
@@ -540,37 +552,43 @@ A simple example of the validation can be found in the `doc` command:
 
 **Code: Simple Validation Example**
 ```typescript
-@Validator(async (cmd) => {
+@Validator(async cmd => {
   const docFile = path.resolve(cmd.input);
-  if (!(await fs.stat(docFile).catch(() => false))) {
+  if (!(await fs.stat(docFile, { throwIfNoEntry: false }))) {
     return { message: `input: ${cmd.input} does not exist`, path: 'input', source: 'flag', kind: 'invalid' };
   }
 })
 ```
 
 ## CLI - service
-The module provides the ability to start/stop/restart services as [docker](https://www.docker.com/community-edition) containers.  This is meant to be used for development purposes, to minimize the effort of getting an application up and running.  Services can be targeted individually or handled as a group.
+The module provides the ability to start/stop/restart services as [docker](https://www.docker.com/community-edition) containers. This is meant to be used for development purposes, to minimize the effort of getting an application up and running. Services can be targeted individually or handled as a group.
 
-**Terminal: Command Service**
+**Terminal: Help for service**
 ```bash
 $ trv service --help
 
 Usage: service [options] <action:restart|start|status|stop> [services...:string]
 
+Description:
+  Manage development services (start/stop/restart/status) across the workspace.
+
+  Services are discovered from registered descriptors and executed with streamed
+  terminal feedback, including optional quiet mode.
+
 Options:
   -q, --quiet   (default: false)
-  -h, --help   display help for command
+  --help       display help for command
 
 Available Services
 --------------------
  * dynamodb@3.3.0
- * elasticsearch@9.2.4
+ * elasticsearch@9.2.8
  * firestore@latest
- * mongodb@8.2
+ * mongodb@8.3
  * mysql@9.6
- * postgresql@18.1
+ * postgresql@18.3
  * redis@8.4
- * s3@4.11.0
+ * s3@4.12.4
 ```
 
 A sample of all services available to the entire framework:
@@ -582,13 +600,13 @@ $ trv service status
 Service          Version    Status
 -------------------------------------------------
 dynamodb           3.3.0    Running 93af422e793a
-elasticsearch      9.2.4    Running ed76ee063d13
+elasticsearch      9.2.8    Running ed76ee063d13
 firestore         latest    Running feec2e5e95b4
-mongodb              8.2    Running 5513eba6734e
+mongodb              8.3    Running 5513eba6734e
 mysql                9.6    Running 307bc66d442a
-postgresql          18.1    Running e78291e71040
+postgresql          18.3    Running e78291e71040
 redis                8.4    Running 77ba279b4e30
-s3                4.11.0    Running fdacfc55b9e3
+s3                4.12.4    Running fdacfc55b9e3
 ```
 
 ### Defining new Services
@@ -598,12 +616,16 @@ The services are defined as plain typescript files within the framework and can
 ```typescript
 import type { ServiceDescriptor } from '@travetto/cli';
 
-const version = process.env.MONGO_VERSION || '8.2';
+const version = process.env.MONGO_VERSION || '8.3';
 
 export const service: ServiceDescriptor = {
   name: 'mongodb',
   version,
   port: 27017,
-  image: `mongo:${version}`
+  image: `mongo:${version}`,
+  env: {
+    // Temp until mongo image fixes orbstack issue
+    GLIBC_TUNABLES: 'glibc.pthread.rseq=1'
+  }
 };
 ```

package/__index__.ts

@@ -1,15 +1,16 @@
-import type { } from './src/trv.d.ts';
-export * from './src/types.ts';
+import type {} from './src/trv.d.ts';
+
+export * from './src/color.ts';
 export * from './src/execute.ts';
-export * from './src/schema.ts';
-export * from './src/schema-export.ts';
-export * from './src/registry/decorator.ts';
-export * from './src/registry/registry-index.ts';
-export * from './src/registry/registry-adapter.ts';
 export * from './src/help.ts';
-export * from './src/color.ts';
 export * from './src/module.ts';
-export * from './src/scm.ts';
 export * from './src/parse.ts';
+export * from './src/registry/decorator.ts';
+export * from './src/registry/registry-adapter.ts';
+export * from './src/registry/registry-index.ts';
+export * from './src/schema.ts';
+export * from './src/schema-export.ts';
+export * from './src/scm.ts';
 export * from './src/service.ts';
+export * from './src/types.ts';
 export * from './src/util.ts';

package/bin/trv.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 // @ts-check
+import '@travetto/runtime/support/patch.js';
 import '@travetto/compiler/bin/hook.js';
+
 const { invoke } = await import('@travetto/compiler/support/invoke.ts');
-await invoke('exec', ['@travetto/cli/support/entry.trv.ts', ...process.argv.slice(2)]);
+await invoke('exec', '@travetto/cli/support/entry.trv.ts', ...process.argv.slice(2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@travetto/cli",
-  "version": "8.0.0-alpha.3",
+  "version": "8.0.0-alpha.30",
   "type": "module",
   "description": "CLI infrastructure for Travetto framework",
   "keywords": [
@@ -29,8 +29,8 @@
     "directory": "module/cli"
   },
   "dependencies": {
-    "@travetto/schema": "^8.0.0-alpha.2",
-    "@travetto/terminal": "^8.0.0-alpha.2"
+    "@travetto/schema": "^8.0.0-alpha.24",
+    "@travetto/terminal": "^8.0.0-alpha.22"
   },
   "travetto": {
     "displayName": "Command Line Interface",

package/src/color.ts

@@ -15,4 +15,4 @@ const input = {
   subsubtitle: ['#a9a9a9'] // Dark gray
 } as const;
 
-export const cliTpl: TermStyledTemplate<keyof typeof input> = StyleUtil.getTemplate(input);
+export const cliTpl: TermStyledTemplate<keyof typeof input> = StyleUtil.getTemplate(input);

package/src/execute.ts

@@ -1,30 +1,41 @@
-import { ConsoleManager, Runtime, ShutdownManager, Util } from '@travetto/runtime';
+import { ConsoleManager, getClass, Runtime, ShutdownManager, Util } from '@travetto/runtime';
 
 import { HelpUtil } from './help.ts';
+import { CliParseUtil } from './parse.ts';
 import { CliCommandRegistryIndex } from './registry/registry-index.ts';
 import { CliCommandSchemaUtil } from './schema.ts';
-import { CliParseUtil } from './parse.ts';
 import type { CliCommandShape } from './types.ts';
 
 /**
  * Execution manager
  */
 export class ExecutionManager {
+  /** Command Execution */
+  static async execute(instance: CliCommandShape, args: unknown[]): Promise<void> {
+    const config = CliCommandRegistryIndex.get(getClass(instance));
 
-  /**
-   * Execute the command line
-   * @param args
-   */
-  static async run(argv: string[]): Promise<void> {
+    for (const item of config.preMain) {
+      await item.handler(instance);
+    }
+
+    // Wait 50ms to allow stdout to flush on shutdown
+    ShutdownManager.signal.addEventListener('abort', () => Util.blockingTimeout(50));
+    ConsoleManager.debug(Runtime.debug);
+    await instance.main(...args);
+  }
+
+  /** Extract configuration and show help as needed */
+  static async getExecutionCommand(argv: string[]): Promise<(() => Promise<void>) | undefined> {
     let command: CliCommandShape | undefined;
 
     const { cmd, args, help } = CliParseUtil.getArgs(argv);
     if (!cmd) {
-      return console.info!(await HelpUtil.renderAllHelp());
+      console.info!(await HelpUtil.renderAllHelp());
+      return;
     }
 
     try {
-      const [{ instance, schema, config }] = await CliCommandRegistryIndex.load([cmd]);
+      const [{ instance, schema }] = await CliCommandRegistryIndex.load([cmd]);
       command = instance;
       const fullArgs = await CliParseUtil.expandArgs(schema, args);
 
@@ -35,24 +46,31 @@ export class ExecutionManager {
       await instance.finalize?.(help);
 
       if (help) {
-        return console.log!(await HelpUtil.renderCommandHelp(instance));
+        console.log!(await HelpUtil.renderCommandHelp(instance));
+        return;
       }
 
       await CliCommandSchemaUtil.validate(command, boundArgs);
 
-      // Wait 50ms to allow stdout to flush on shutdown
-      ShutdownManager.signal.addEventListener('abort', () => Util.blockingTimeout(50));
-
-      for (const preMain of config.preMain ?? []) {
-        await preMain(instance);
-      }
-
-      ConsoleManager.debug(Runtime.debug);
-      await instance.main(...boundArgs);
+      return this.execute.bind(this, instance, boundArgs);
     } catch (error) {
       await HelpUtil.renderError(error, cmd, command);
+    }
+  }
+
+  /**
+   * Execute the command line
+   * @param args
+   */
+  static async run(argv: string[]): Promise<void> {
+    try {
+      const execute = await this.getExecutionCommand(argv);
+      await execute?.();
+    } catch (error) {
+      console.error!(error);
+      process.exitCode ??= 1;
     } finally {
       await ShutdownManager.shutdown();
     }
   }
-}
+}