@travetto/cli 8.0.0-alpha.27 → 8.0.0-alpha.29

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
@@ -28,10 +28,11 @@ Commands:
   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.
-  eslint                Run ESLint for the workspace or changed files.
-  eslint:register       Generate the workspace ESLint configuration entry file.
   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.
@@ -59,7 +60,7 @@ Commands:
 
 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`
@@ -89,7 +90,7 @@ Options:
 ```
 
 ## 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`
@@ -107,7 +108,6 @@ import { CliCommand } from '@travetto/cli';
 
 @CliCommand()
 export class BasicCommand {
-
   loud?: boolean;
 
   main() {
@@ -127,7 +127,7 @@ Options:
   --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
@@ -138,14 +138,14 @@ HELLO
 
 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
@@ -154,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');
   }
@@ -207,7 +206,6 @@ import { Max, Min } from '@travetto/schema';
 
 @CliCommand()
 export class BasicCommand {
-
   reverse?: boolean;
 
   main(@Min(1) @Max(10) volumes: number[]) {
@@ -256,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
@@ -268,7 +266,6 @@ import { Max, Min } from '@travetto/schema';
  */
 @CliCommand()
 export class CustomCommand {
-
   /**
    * The message to send back to the user
    * @alias -m
@@ -323,7 +320,6 @@ import { Max, Min } from '@travetto/schema';
  */
 @CliCommand()
 export class CustomCommand {
-
   /**
    * The message to send back to the user
    * @alias env.MESSAGE
@@ -372,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
@@ -401,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#L20) 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
@@ -412,7 +408,6 @@ import { CliCommand } from '@travetto/cli';
  */
 @CliCommand({ runTarget: true })
 export class RunCommand {
-
   main(name: string) {
     console.log(name);
   }
@@ -444,11 +439,11 @@ 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';
 
@@ -464,7 +459,6 @@ import type { WebHttpServer } from '../src/types.ts';
  */
 @CliCommand()
 export class WebHttpCommand implements CliCommandShape {
-
   /** Port to run on */
   port?: number;
 
@@ -511,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.
@@ -558,7 +552,7 @@ 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, { throwIfNoEntry: false }))) {
     return { message: `input: ${cmd.input} does not exist`, path: 'input', source: 'flag', kind: 'invalid' };
@@ -567,7 +561,7 @@ A simple example of the validation can be found in the `doc` command:
 ```
 
 ## 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: Help for service**
 ```bash

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

@@ -2,5 +2,6 @@
 // @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.27",
+  "version": "8.0.0-alpha.29",
   "type": "module",
   "description": "CLI infrastructure for Travetto framework",
   "keywords": [
@@ -29,8 +29,8 @@
     "directory": "module/cli"
   },
   "dependencies": {
-    "@travetto/schema": "^8.0.0-alpha.21",
-    "@travetto/terminal": "^8.0.0-alpha.19"
+    "@travetto/schema": "^8.0.0-alpha.23",
+    "@travetto/terminal": "^8.0.0-alpha.21"
   },
   "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,16 +1,15 @@
 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));
@@ -74,4 +73,4 @@ export class ExecutionManager {
       await ShutdownManager.shutdown();
     }
   }
-}
+}

package/src/help.ts

@@ -1,29 +1,29 @@
 import util from 'node:util';
 
-import { castKey, CodecUtil, getClass, JSONUtil, Runtime } from '@travetto/runtime';
+import { CodecUtil, castKey, getClass, JSONUtil, Runtime } from '@travetto/runtime';
 import { SchemaRegistryIndex, ValidationResultError } from '@travetto/schema';
 
 import { cliTpl } from './color.ts';
-import { HELP_FLAG, type CliCommandShape } from './types.ts';
 import { CliCommandRegistryIndex, UNKNOWN_COMMAND } from './registry/registry-index.ts';
 import { CliSchemaExportUtil } from './schema-export.ts';
+import { type CliCommandShape, HELP_FLAG } from './types.ts';
 
 const validationSourceMap: Record<string, string> = { arg: 'Argument', flag: 'Flag' };
 
 const ifDefined = <T>(value: T | null | '' | undefined): T | undefined =>
-  (value === null || value === '' || value === undefined) ? undefined : value;
+  value === null || value === '' || value === undefined ? undefined : value;
 
 const MODULE_TO_COMMAND = {
   '@travetto/doc': ['doc'],
   '@travetto/email-compiler': ['email:compile', 'email:test', 'email:editor'],
-  '@travetto/eslint': ['eslint', 'eslint:register', 'lint', 'lint:register'],
+  '@travetto/lint': ['lint', 'lint:register'],
   '@travetto/model': ['model:install', 'model:export'],
   '@travetto/openapi': ['openapi:spec', 'openapi:client'],
   '@travetto/pack': ['pack', 'pack:zip', 'pack:docker'],
   '@travetto/repo': ['repo:publish', 'repo:version', 'repo:exec', 'repo:list'],
   '@travetto/test': ['test', 'test:watch', 'test:direct'],
   '@travetto/web-http': ['web:http'],
-  '@travetto/web-rpc': ['web:rpc-client'],
+  '@travetto/web-rpc': ['web:rpc-client']
 };
 
 const COMMAND_TO_MODULE = Object.fromEntries(Object.entries(MODULE_TO_COMMAND).flatMap(([k, v]) => v.map(sv => [sv, k])));
@@ -32,7 +32,6 @@ const COMMAND_TO_MODULE = Object.fromEntries(Object.entries(MODULE_TO_COMMAND).f
  * Utilities for showing help
  */
 export class HelpUtil {
-
   /** Get usage help for a command */
   static getUsageMessage(command: CliCommandShape): string[] {
     const schema = SchemaRegistryIndex.getConfig(getClass(command));
@@ -40,13 +39,14 @@ export class HelpUtil {
 
     const usage: string[] = [];
 
-    usage.push(
-      cliTpl`${{ title: 'Usage:' }} ${{ param: commandName }} ${{ input: '[options]' }}`
-    );
+    usage.push(cliTpl`${{ title: 'Usage:' }} ${{ param: commandName }} ${{ input: '[options]' }}`);
 
     // Ensure finalized
     for (const field of schema.methods.main?.parameters ?? []) {
-      const type = field.type === String && field.enum && field.enum?.values.length <= 7 ? field.enum?.values?.join('|') : field.type.name.toLowerCase();
+      const type =
+        field.type === String && field.enum && field.enum?.values.length <= 7
+          ? field.enum?.values?.join('|')
+          : field.type.name.toLowerCase();
       const arg = `${field.name}${field.array ? '...' : ''}:${type}`;
       usage.push(cliTpl`${{ input: field.required?.active !== false ? `<${arg}>` : `[${arg}]` }}`);
     }
@@ -76,9 +76,7 @@ export class HelpUtil {
       const defaultValue = ifDefined(command[key]) ?? ifDefined(field.default);
       const aliases = (field.aliases ?? [])
         .filter(flag => flag.startsWith('-'))
-        .filter(flag =>
-          (field.type !== Boolean) || (defaultValue !== true ? !flag.startsWith('--no-') : flag.startsWith('--'))
-        );
+        .filter(flag => field.type !== Boolean || (defaultValue !== true ? !flag.startsWith('--no-') : flag.startsWith('--')));
       let type: string | undefined;
 
       if (field.type === String && field.enum && field.enum.values.length <= 3) {
@@ -87,10 +85,7 @@ export class HelpUtil {
         ({ type } = CliSchemaExportUtil.baseInputType(field));
       }
 
-      const parameter = [
-        cliTpl`${{ param: aliases.join(', ') }}`,
-        ...(type ? [cliTpl`${{ type: `<${type}>` }}`] : []),
-      ];
+      const parameter = [cliTpl`${{ param: aliases.join(', ') }}`, ...(type ? [cliTpl`${{ type: `<${type}>` }}`] : [])];
 
       params.push(parameter.join(' '));
       const parts = [cliTpl`${{ title: field.description }}`];
@@ -104,7 +99,6 @@ export class HelpUtil {
     params.push(cliTpl`${{ param: HELP_FLAG }}`);
     descriptions.push('display help for command');
 
-
     const paramWidths = params.map(item => util.stripVTControlCharacters(item).length);
     const descWidths = descriptions.map(item => util.stripVTControlCharacters(item).length);
 
@@ -113,8 +107,9 @@ export class HelpUtil {
 
     const options: string[] = [
       cliTpl`${{ title: 'Options:' }}`,
-      ...params.map((_, i) =>
-        `  ${params[i]}${' '.repeat((paramWidth - paramWidths[i]))}  ${descriptions[i].padEnd(descWidth)}${' '.repeat((descWidth - descWidths[i]))}`
+      ...params.map(
+        (_, i) =>
+          `  ${params[i]}${' '.repeat(paramWidth - paramWidths[i])}  ${descriptions[i].padEnd(descWidth)}${' '.repeat(descWidth - descWidths[i])}`
       ),
       ''
     ];
@@ -139,9 +134,10 @@ export class HelpUtil {
       for (const example of schema.examples) {
         for (const line of example.split('\n')) {
           examples.push(
-            line.trim().startsWith('>') ?
-              cliTpl`    ${{ input: line.substring(line.indexOf('> ') + 2).trim() }}` :
-              cliTpl`  ${{ subtitle: line.trim() }}`);
+            line.trim().startsWith('>')
+              ? cliTpl`    ${{ input: line.substring(line.indexOf('> ') + 2).trim() }}`
+              : cliTpl`  ${{ subtitle: line.trim() }}`
+          );
         }
       }
       examples.push('');
@@ -171,9 +167,11 @@ ${{ identifier: Runtime.getInstallCommand(module) }}
       ...this.getUsageMessage(command),
       ...this.getDescriptionMessage(command),
       ...this.getOptionsMessage(command),
-      ...await this.getExtendedHelpMessage(command),
+      ...(await this.getExtendedHelpMessage(command)),
       ...this.getExamplesMessage(command)
-    ].map(line => line.trimEnd()).join('\n');
+    ]
+      .map(line => line.trimEnd())
+      .join('\n');
   }
 
   /**
@@ -221,7 +219,7 @@ ${{ identifier: Runtime.getInstallCommand(module) }}
         }
         return cliTpl` * ${{ failure: error.message }}`;
       }),
-      '',
+      ''
     ].join('\n');
   }
 
@@ -240,4 +238,4 @@ ${{ identifier: Runtime.getInstallCommand(module) }}
     }
     console.error!();
   }
-}
+}

package/src/module.ts

@@ -1,15 +1,14 @@
-import { Runtime, RuntimeIndex } from '@travetto/runtime';
 import type { IndexedModule } from '@travetto/manifest';
+import { Runtime, RuntimeIndex } from '@travetto/runtime';
 
 import { CliScmUtil } from './scm.ts';
 
-type ModuleGraphEntry = { children: Set<string>, name: string, active: Set<string>, parents?: string[] };
+type ModuleGraphEntry = { children: Set<string>; name: string; active: Set<string>; parents?: string[] };
 
 /**
  * Simple utilities for understanding modules for CLI use cases
  */
 export class CliModuleUtil {
-
   /**
    * Find modules that changed, and the dependent modules
    * @param fromHash
@@ -34,8 +33,7 @@ export class CliModuleUtil {
       }
     }
 
-    return [...out.values()]
-      .toSorted((a, b) => a.name.localeCompare(b.name));
+    return [...out.values()].toSorted((a, b) => a.name.localeCompare(b.name));
   }
 
   /**
@@ -45,9 +43,10 @@ export class CliModuleUtil {
    * @returns
    */
   static async findModules(mode: 'all' | 'changed' | 'workspace', fromHash?: string, toHash?: string): Promise<IndexedModule[]> {
-    return (mode === 'changed' ?
-      await this.findChangedModulesRecursive(fromHash, toHash, true) :
-      [...RuntimeIndex.getModuleList(mode)].map(name => RuntimeIndex.getModule(name)!)
+    return (
+      mode === 'changed'
+        ? await this.findChangedModulesRecursive(fromHash, toHash, true)
+        : [...RuntimeIndex.getModuleList(mode)].map(name => RuntimeIndex.getModule(name)!)
     ).filter(module => module.sourcePath !== Runtime.workspace.path);
   }
 
@@ -103,7 +102,7 @@ export class CliModuleUtil {
   /**
    * Find changed paths, either files between two git commits, or all folders for changed modules
    */
-  static async findChangedPaths(config: { since?: string, changed?: boolean, logError?: boolean } = {}): Promise<string[]> {
+  static async findChangedPaths(config: { since?: string; changed?: boolean; logError?: boolean } = {}): Promise<string[]> {
     if (config.since) {
       try {
         const files = await CliScmUtil.findChangedFiles(config.since, 'HEAD');
@@ -119,4 +118,4 @@ export class CliModuleUtil {
       return modules.map(module => module.sourcePath);
     }
   }
-}
+}