@ms-cloudpack/cli 0.57.4 → 0.57.6

package/lib/common/CloudpackCommand.d.ts

@@ -1,17 +1,19 @@
-import { Command, Option, type OutputConfiguration } from 'commander';
+import { Command, Option, type Argument, type OutputConfiguration } from 'commander';
 import type { CommandActionModule } from '../types/CommandAction.js';
 import type { ProgramOptions } from '../types/ProgramOptions.js';
 /**
  * Parameters for creating a command.
  * `TOptions` should be the command-specific options (if any), e.g. `StartOptions`.
  */
-interface CloudpackCommandParams<TOptions extends object> {
+interface CloudpackCommandParams<TOptions extends object, TArguments extends object> {
     /** Command name */
     name: string;
     /** Command description */
     description: string;
     /** Options specific to this command. The record ensures that all options are available in the CLI. */
     options?: Record<keyof TOptions, Option>;
+    /** Arguments specific to this command. */
+    args?: Record<keyof TArguments, Argument>;
     /**
      * Function returning an async import of the command's `src/commands/<name>/execute.ts` module.
      * Importing only on demand makes Cloudpack start up faster since it doesn't have to parse
@@ -35,22 +37,24 @@ interface CloudpackCommandParams<TOptions extends object> {
  * - The top-level "program" command should be created with `new CloudpackCommand()`.
  * - Sub-commands should be created with the `.addSubCommand` method on the parent.
  */
-export declare class CloudpackCommand<TOptions extends object> {
+export declare class CloudpackCommand<TOptions extends object, TArguments extends object> {
     private _command;
     private _programOptions;
     /**
      * This should only be used directly (outside this class) to create the top-level `program` command.
      * To add sub-commands, use `.addSubCommand` instead.
      */
-    constructor(params: CloudpackCommandParams<TOptions> & {
+    constructor(params: CloudpackCommandParams<TOptions, TArguments> & {
         programOptions: ProgramOptions;
         /** This must be undefined for the top-level program command */
         parent?: Command;
     });
     /** Create a child command. */
-    addSubCommand<TChildOptions extends object>(params: CloudpackCommandParams<TChildOptions>): CloudpackCommand<TChildOptions>;
+    addSubCommand<TChildOptions extends object, TChildArguments extends object = never>(params: CloudpackCommandParams<TChildOptions, TChildArguments>): CloudpackCommand<TChildOptions, TChildArguments>;
     /** Run the program (only works on the top-level program command). */
     run(): Promise<void>;
+    /** Add arguments. The generic enforces that argument objects are included for all keys of a type. */
+    private _addArguemnts;
     /** Add options. The generic enforces that option objects are included for all keys of a type. */
     private _addOptions;
     private _addAction;

package/lib/common/CloudpackCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudpackCommand.d.ts","sourceRoot":"","sources":["../../src/common/CloudpackCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAKjE;;;GAGG;AACH,UAAU,sBAAsB,CAAC,QAAQ,SAAS,MAAM;IACtD,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEzC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3D,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB,CAAC,QAAQ,SAAS,MAAM;IACnD,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,eAAe,CAAiB;IAExC;;;OAGG;gBAGD,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,GAAG;QACzC,cAAc,EAAE,cAAc,CAAC;QAC/B,+DAA+D;QAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;IAkCH,8BAA8B;IACvB,aAAa,CAAC,aAAa,SAAS,MAAM,EAC/C,MAAM,EAAE,sBAAsB,CAAC,aAAa,CAAC,GAC5C,gBAAgB,CAAC,aAAa,CAAC;IAQlC,qEAAqE;IACxD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,iGAAiG;IACjG,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;CA0BnB"}
+{"version":3,"file":"CloudpackCommand.d.ts","sourceRoot":"","sources":["../../src/common/CloudpackCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,QAAQ,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAKjE;;;GAGG;AACH,UAAU,sBAAsB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM;IACjF,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEzC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE1C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3D,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM;IAC9E,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,eAAe,CAAiB;IAExC;;;OAGG;gBAGD,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG;QACrD,cAAc,EAAE,cAAc,CAAC;QAC/B,+DAA+D;QAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;IAsCH,8BAA8B;IACvB,aAAa,CAAC,aAAa,SAAS,MAAM,EAAE,eAAe,SAAS,MAAM,GAAG,KAAK,EACvF,MAAM,EAAE,sBAAsB,CAAC,aAAa,EAAE,eAAe,CAAC,GAC7D,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC;IAQnD,qEAAqE;IACxD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,qGAAqG;IACrG,OAAO,CAAC,aAAa;IAMrB,iGAAiG;IACjG,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;CAoCnB"}

package/lib/common/CloudpackCommand.js

@@ -26,6 +26,9 @@ export class CloudpackCommand {
         params.alias && command.alias(params.alias);
         params.outputOptions && command.configureOutput(params.outputOptions);
         params.getExecutor && this._addAction(params.getExecutor);
+        if (params.args) {
+            this._addArguemnts(params.args);
+        }
         if (params.options) {
             // Add the command-specific options first so they show up first in help
             this._addOptions(params.options);
@@ -60,6 +63,12 @@ export class CloudpackCommand {
             this._command.help();
         }
     }
+    /** Add arguments. The generic enforces that argument objects are included for all keys of a type. */
+    _addArguemnts(args) {
+        for (const argument of Object.values(args)) {
+            this._command.addArgument(argument);
+        }
+    }
     /** Add options. The generic enforces that option objects are included for all keys of a type. */
     _addOptions(options) {
         for (const option of Object.values(options)) {
@@ -71,6 +80,9 @@ export class CloudpackCommand {
         // The action function receives parsed options as its first parameter, but we ignore those
         // because they only contain options *specific to this command*, not shared options like `debug`.
         command.action(async () => {
+            // Commander has support for custom parsers that parse arguments.
+            // Use processedArgs instead of args to get the parsed arguments.
+            const processedArgs = command.processedArgs;
             // Get the shared options too, not just the ones for this command.
             // (In `cloudpackCommand`, we added the shared options to each command object so that they show up
             // in help, but commander still seems to respect options only at the first command where they're
@@ -85,7 +97,13 @@ export class CloudpackCommand {
                 // throw instead of exiting politely, since this is a major developer error
                 throw new Error(`No execute function was exported from the command module for ${verb}.`);
             }
-            const commandExecutor = new CommandExecutor({ options, execute, programOptions: this._programOptions, verb });
+            const commandExecutor = new CommandExecutor({
+                args: processedArgs,
+                options,
+                execute,
+                programOptions: this._programOptions,
+                verb,
+            });
             await commandExecutor.execute();
         });
     }

package/lib/common/CloudpackCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"CloudpackCommand.js","sourceRoot":"","sources":["../../src/common/CloudpackCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAA4B,MAAM,WAAW,CAAC;AAItE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAmCvD;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IAI3B;;;OAGG;IACH;IACE,4EAA4E;IAC5E,MAIC;QAED,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;QAE7C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChF,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACtE,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,uEAAuE;YACvE,IAAI,CAAC,WAAW,CAAW,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,+FAA+F;QAC/F,iEAAiE;QACjE,IAAI,CAAC,WAAW,CAAgB;YAC9B,OAAO,EAAE,IAAI,MAAM,CAAC,eAAe,EAAE,kDAAkD,CAAC;YACxF,KAAK,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC;YACxG,KAAK,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YAC1G,KAAK;YACH,yGAAyG;YACzG,IAAI,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC,OAAO,CACnE,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAC5C;YACH,QAAQ,EAAE,IAAI,MAAM,CAAC,8BAA8B,EAAE,+BAA+B,CAAC;SACtF,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IACvB,aAAa,CAClB,MAA6C;QAE7C,OAAO,IAAI,gBAAgB,CAAgB;YACzC,GAAG,MAAM;YACT,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,MAAM,EAAE,IAAI,CAAC,QAAQ;SACtB,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IAC9D,KAAK,CAAC,GAAG;QACd,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,iGAAiG;IACzF,WAAW,CAA6B,OAA0C;QACxF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAgB,CAAC,CAAC,CAAC,yCAAyC;QACtF,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,WAAyE;QAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,0FAA0F;QAC1F,iGAAiG;QACjG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;YACxB,kEAAkE;YAClE,kGAAkG;YAClG,gGAAgG;YAChG,6EAA6E;YAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,EAA4B,CAAC;YAEpE,kGAAkG;YAClG,wBAAwB;YACxB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAEpG,0CAA0C;YAC1C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;YACxC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,2EAA2E;gBAC3E,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,GAAG,CAAC,CAAC;YAC3F,CAAC;YAED,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9G,MAAM,eAAe,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { Command, Option, type OutputConfiguration } from 'commander';\nimport type { CommandActionModule } from '../types/CommandAction.js';\nimport type { ProgramOptions } from '../types/ProgramOptions.js';\nimport type { SharedOptions } from '../types/SharedOptions.js';\nimport { isCIBuild } from '../utilities/isCIBuild.js';\nimport { CommandExecutor } from './CommandExecutor.js';\n\n/**\n * Parameters for creating a command.\n * `TOptions` should be the command-specific options (if any), e.g. `StartOptions`.\n */\ninterface CloudpackCommandParams<TOptions extends object> {\n  /** Command name */\n  name: string;\n\n  /** Command description */\n  description: string;\n\n  /** Options specific to this command. The record ensures that all options are available in the CLI. */\n  options?: Record<keyof TOptions, Option>;\n\n  /**\n   * Function returning an async import of the command's `src/commands/<name>/execute.ts` module.\n   * Importing only on demand makes Cloudpack start up faster since it doesn't have to parse\n   * every command's dependencies (many of which may be unrelated to the command being run).\n   *\n   * This can be undefined for a command that only has sub-commands.\n   */\n  getExecutor?: () => Promise<CommandActionModule<TOptions>>;\n\n  /** Usage message override */\n  usage?: string;\n\n  /** Alternative name for the command */\n  alias?: string;\n\n  /** Output options override (mainly for testing) */\n  outputOptions?: OutputConfiguration;\n}\n\n/**\n * This wraps the `Command` class from [`commander`](https://www.npmjs.com/package/commander) with\n * Cloudpack-specific functionality and simpler APIs.\n *\n * Similar to the pattern from `commander`, this class represents both the program and its sub-commands.\n * - The top-level \"program\" command should be created with `new CloudpackCommand()`.\n * - Sub-commands should be created with the `.addSubCommand` method on the parent.\n */\nexport class CloudpackCommand<TOptions extends object> {\n  private _command: Command;\n  private _programOptions: ProgramOptions;\n\n  /**\n   * This should only be used directly (outside this class) to create the top-level `program` command.\n   * To add sub-commands, use `.addSubCommand` instead.\n   */\n  constructor(\n    // The extra options here shouldn't be exposed to the `createSubCommand` API\n    params: CloudpackCommandParams<TOptions> & {\n      programOptions: ProgramOptions;\n      /** This must be undefined for the top-level program command */\n      parent?: Command;\n    },\n  ) {\n    this._programOptions = params.programOptions;\n\n    const command = params.parent?.command(params.name) || new Command(params.name);\n    this._command = command;\n\n    command.version(params.programOptions.version);\n    command.description(params.description);\n    params.usage && command.usage(params.usage);\n    params.alias && command.alias(params.alias);\n    params.outputOptions && command.configureOutput(params.outputOptions);\n    params.getExecutor && this._addAction(params.getExecutor);\n\n    if (params.options) {\n      // Add the command-specific options first so they show up first in help\n      this._addOptions<TOptions>(params.options);\n    }\n\n    // Add shared options. These must be manually added to the program command and each sub-command\n    // because commander doesn't natively support inheriting options.\n    this._addOptions<SharedOptions>({\n      verbose: new Option('-v, --verbose', 'Show additional details about the running tasks.'),\n      debug: new Option('-d, --debug', 'Show debug information (superset of --verbose).').conflicts('verbose'),\n      quiet: new Option('-q, --quiet', 'Disable non-essential logging.').conflicts('verbose').conflicts('debug'),\n      color:\n        // In the parsed options, this will be a boolean `color` with default value true (except in tests and CI)\n        new Option('-n, --no-color', 'Disable colors in the output.').default(\n          !process.env.JEST_WORKER_ID && !isCIBuild(),\n        ),\n      features: new Option('--features <featureNames...>', 'Enable experimental features.'),\n    });\n  }\n\n  /** Create a child command. */\n  public addSubCommand<TChildOptions extends object>(\n    params: CloudpackCommandParams<TChildOptions>,\n  ): CloudpackCommand<TChildOptions> {\n    return new CloudpackCommand<TChildOptions>({\n      ...params,\n      programOptions: this._programOptions,\n      parent: this._command,\n    });\n  }\n\n  /** Run the program (only works on the top-level program command). */\n  public async run(): Promise<void> {\n    if (this._command.parent) {\n      throw new Error('Only the top-level program command can be run directly.');\n    }\n\n    await this._command.parseAsync(this._programOptions.argv);\n    if (this._command.args.length === 0) {\n      this._command.help();\n    }\n  }\n\n  /** Add options. The generic enforces that option objects are included for all keys of a type. */\n  private _addOptions<TAddOptions extends object>(options: Record<keyof TAddOptions, Option>): void {\n    for (const option of Object.values(options)) {\n      this._command.addOption(option as Option); // not sure why this isn't being inferred\n    }\n  }\n\n  private _addAction(getExecutor: NonNullable<CloudpackCommandParams<TOptions>['getExecutor']>) {\n    const command = this._command;\n    // The action function receives parsed options as its first parameter, but we ignore those\n    // because they only contain options *specific to this command*, not shared options like `debug`.\n    command.action(async () => {\n      // Get the shared options too, not just the ones for this command.\n      // (In `cloudpackCommand`, we added the shared options to each command object so that they show up\n      // in help, but commander still seems to respect options only at the first command where they're\n      // encountered, which for shared options will always be the program command.)\n      const options = command.optsWithGlobals<TOptions & SharedOptions>();\n\n      // Usually `command` will be a sub-command (e.g. \"bundle\"), but it could also be a sub-sub-command\n      // (e.g. \"cache clean\").\n      const verb = command.parent?.parent ? `${command.parent.name()} ${command.name()}` : command.name();\n\n      // Dynamically import the execute function\n      const { execute } = await getExecutor();\n      if (typeof execute !== 'function') {\n        // throw instead of exiting politely, since this is a major developer error\n        throw new Error(`No execute function was exported from the command module for ${verb}.`);\n      }\n\n      const commandExecutor = new CommandExecutor({ options, execute, programOptions: this._programOptions, verb });\n      await commandExecutor.execute();\n    });\n  }\n}\n"]}
+{"version":3,"file":"CloudpackCommand.js","sourceRoot":"","sources":["../../src/common/CloudpackCommand.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command, Option, type Argument, type OutputConfiguration } from 'commander';\nimport type { CommandActionModule } from '../types/CommandAction.js';\nimport type { ProgramOptions } from '../types/ProgramOptions.js';\nimport type { SharedOptions } from '../types/SharedOptions.js';\nimport { isCIBuild } from '../utilities/isCIBuild.js';\nimport { CommandExecutor } from './CommandExecutor.js';\n\n/**\n * Parameters for creating a command.\n * `TOptions` should be the command-specific options (if any), e.g. `StartOptions`.\n */\ninterface CloudpackCommandParams<TOptions extends object, TArguments extends object> {\n  /** Command name */\n  name: string;\n\n  /** Command description */\n  description: string;\n\n  /** Options specific to this command. The record ensures that all options are available in the CLI. */\n  options?: Record<keyof TOptions, Option>;\n\n  /** Arguments specific to this command. */\n  args?: Record<keyof TArguments, Argument>;\n\n  /**\n   * Function returning an async import of the command's `src/commands/<name>/execute.ts` module.\n   * Importing only on demand makes Cloudpack start up faster since it doesn't have to parse\n   * every command's dependencies (many of which may be unrelated to the command being run).\n   *\n   * This can be undefined for a command that only has sub-commands.\n   */\n  getExecutor?: () => Promise<CommandActionModule<TOptions>>;\n\n  /** Usage message override */\n  usage?: string;\n\n  /** Alternative name for the command */\n  alias?: string;\n\n  /** Output options override (mainly for testing) */\n  outputOptions?: OutputConfiguration;\n}\n\n/**\n * This wraps the `Command` class from [`commander`](https://www.npmjs.com/package/commander) with\n * Cloudpack-specific functionality and simpler APIs.\n *\n * Similar to the pattern from `commander`, this class represents both the program and its sub-commands.\n * - The top-level \"program\" command should be created with `new CloudpackCommand()`.\n * - Sub-commands should be created with the `.addSubCommand` method on the parent.\n */\nexport class CloudpackCommand<TOptions extends object, TArguments extends object> {\n  private _command: Command;\n  private _programOptions: ProgramOptions;\n\n  /**\n   * This should only be used directly (outside this class) to create the top-level `program` command.\n   * To add sub-commands, use `.addSubCommand` instead.\n   */\n  constructor(\n    // The extra options here shouldn't be exposed to the `createSubCommand` API\n    params: CloudpackCommandParams<TOptions, TArguments> & {\n      programOptions: ProgramOptions;\n      /** This must be undefined for the top-level program command */\n      parent?: Command;\n    },\n  ) {\n    this._programOptions = params.programOptions;\n\n    const command = params.parent?.command(params.name) || new Command(params.name);\n    this._command = command;\n\n    command.version(params.programOptions.version);\n    command.description(params.description);\n    params.usage && command.usage(params.usage);\n    params.alias && command.alias(params.alias);\n    params.outputOptions && command.configureOutput(params.outputOptions);\n    params.getExecutor && this._addAction(params.getExecutor);\n\n    if (params.args) {\n      this._addArguemnts<TArguments>(params.args);\n    }\n\n    if (params.options) {\n      // Add the command-specific options first so they show up first in help\n      this._addOptions<TOptions>(params.options);\n    }\n\n    // Add shared options. These must be manually added to the program command and each sub-command\n    // because commander doesn't natively support inheriting options.\n    this._addOptions<SharedOptions>({\n      verbose: new Option('-v, --verbose', 'Show additional details about the running tasks.'),\n      debug: new Option('-d, --debug', 'Show debug information (superset of --verbose).').conflicts('verbose'),\n      quiet: new Option('-q, --quiet', 'Disable non-essential logging.').conflicts('verbose').conflicts('debug'),\n      color:\n        // In the parsed options, this will be a boolean `color` with default value true (except in tests and CI)\n        new Option('-n, --no-color', 'Disable colors in the output.').default(\n          !process.env.JEST_WORKER_ID && !isCIBuild(),\n        ),\n      features: new Option('--features <featureNames...>', 'Enable experimental features.'),\n    });\n  }\n\n  /** Create a child command. */\n  public addSubCommand<TChildOptions extends object, TChildArguments extends object = never>(\n    params: CloudpackCommandParams<TChildOptions, TChildArguments>,\n  ): CloudpackCommand<TChildOptions, TChildArguments> {\n    return new CloudpackCommand<TChildOptions, TChildArguments>({\n      ...params,\n      programOptions: this._programOptions,\n      parent: this._command,\n    });\n  }\n\n  /** Run the program (only works on the top-level program command). */\n  public async run(): Promise<void> {\n    if (this._command.parent) {\n      throw new Error('Only the top-level program command can be run directly.');\n    }\n\n    await this._command.parseAsync(this._programOptions.argv);\n    if (this._command.args.length === 0) {\n      this._command.help();\n    }\n  }\n\n  /** Add arguments. The generic enforces that argument objects are included for all keys of a type. */\n  private _addArguemnts<TAddArguments extends object>(args: Record<keyof TAddArguments, Argument>) {\n    for (const argument of Object.values(args)) {\n      this._command.addArgument(argument as Argument);\n    }\n  }\n\n  /** Add options. The generic enforces that option objects are included for all keys of a type. */\n  private _addOptions<TAddOptions extends object>(options: Record<keyof TAddOptions, Option>): void {\n    for (const option of Object.values(options)) {\n      this._command.addOption(option as Option); // not sure why this isn't being inferred\n    }\n  }\n\n  private _addAction(getExecutor: NonNullable<CloudpackCommandParams<TOptions, TArguments>['getExecutor']>) {\n    const command = this._command;\n    // The action function receives parsed options as its first parameter, but we ignore those\n    // because they only contain options *specific to this command*, not shared options like `debug`.\n    command.action(async () => {\n      // Commander has support for custom parsers that parse arguments.\n      // Use processedArgs instead of args to get the parsed arguments.\n      const processedArgs = command.processedArgs;\n\n      // Get the shared options too, not just the ones for this command.\n      // (In `cloudpackCommand`, we added the shared options to each command object so that they show up\n      // in help, but commander still seems to respect options only at the first command where they're\n      // encountered, which for shared options will always be the program command.)\n      const options = command.optsWithGlobals<TOptions & SharedOptions>();\n\n      // Usually `command` will be a sub-command (e.g. \"bundle\"), but it could also be a sub-sub-command\n      // (e.g. \"cache clean\").\n      const verb = command.parent?.parent ? `${command.parent.name()} ${command.name()}` : command.name();\n\n      // Dynamically import the execute function\n      const { execute } = await getExecutor();\n      if (typeof execute !== 'function') {\n        // throw instead of exiting politely, since this is a major developer error\n        throw new Error(`No execute function was exported from the command module for ${verb}.`);\n      }\n\n      const commandExecutor = new CommandExecutor<TOptions & SharedOptions>({\n        args: processedArgs,\n        options,\n        execute,\n        programOptions: this._programOptions,\n        verb,\n      });\n      await commandExecutor.execute();\n    });\n  }\n}\n"]}

package/lib/common/CommandExecutor.d.ts

@@ -13,7 +13,10 @@ export declare class CommandExecutor<TOptions extends SharedOptions> {
     private _autoDisposableList;
     private _abortController;
     private _hasCalledExit;
+    private _args;
     constructor(params: {
+        /** Command-specific arguments */
+        args: string[];
         /** Command-specific and shared options. */
         options: TOptions;
         /** Function to execute the command. */

package/lib/common/CommandExecutor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandExecutor.d.ts","sourceRoot":"","sources":["../../src/common/CommandExecutor.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ/D;;GAEG;AACH,qBAAa,eAAe,CAAC,QAAQ,SAAS,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,EAAE;QAClB,2CAA2C;QAC3C,OAAO,EAAE,QAAQ,CAAC;QAClB,uCAAuC;QACvC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjC,0CAA0C;QAC1C,cAAc,EAAE,cAAc,CAAC;QAC/B,sDAAsD;QACtD,IAAI,EAAE,MAAM,CAAC;KACd;IAUD,uBAAuB;IAEV,OAAO;IAwCpB;;;;;OAKG;YACW,WAAW;YAoGX,cAAc;IAkD5B;;;OAGG;IACH,OAAO,CAAC,KAAK,CA0BX;CACH"}
+{"version":3,"file":"CommandExecutor.d.ts","sourceRoot":"","sources":["../../src/common/CommandExecutor.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ/D;;GAEG;AACH,qBAAa,eAAe,CAAC,QAAQ,SAAS,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAAW;gBAEZ,MAAM,EAAE;QAClB,iCAAiC;QACjC,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,2CAA2C;QAC3C,OAAO,EAAE,QAAQ,CAAC;QAClB,uCAAuC;QACvC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjC,0CAA0C;QAC1C,cAAc,EAAE,cAAc,CAAC;QAC/B,sDAAsD;QACtD,IAAI,EAAE,MAAM,CAAC;KACd;IAWD,uBAAuB;IAEV,OAAO;IAyCpB;;;;;OAKG;YACW,WAAW;YAoGX,cAAc;IAkD5B;;;OAGG;IACH,OAAO,CAAC,KAAK,CA0BX;CACH"}

package/lib/common/CommandExecutor.js

@@ -37,6 +37,7 @@ export class CommandExecutor {
             }
             process.exit(exitCode);
         };
+        this._args = params.args;
         this._options = params.options;
         this._execute = params.execute;
         this._programOptions = params.programOptions;
@@ -66,6 +67,7 @@ export class CommandExecutor {
             // Call the execute function which is the real command logic
             // (ie: real init command logic, real start command logic, etc.)
             await this._execute({
+                args: this._args,
                 options: this._options,
                 cwd: this._programOptions.cwd,
                 reporter: this._reporter,

package/lib/common/CommandExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandExecutor.js","sourceRoot":"","sources":["../../src/common/CommandExecutor.ts"],"names":[],"mappings":"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","sourcesContent":["import { readConfig } from '@ms-cloudpack/config';\nimport type { CloudpackConfig, PackageJson } from '@ms-cloudpack/config-types';\nimport { readJson } from '@ms-cloudpack/json-utilities';\nimport {\n  TaskReporter,\n  bold,\n  debugLoggingConfig,\n  defaultLoggingConfig,\n  noLoggingConfig,\n  red,\n  verboseLoggingConfig,\n  yellow,\n} from '@ms-cloudpack/task-reporter';\nimport { createTelemetryClient, type TelemetryClient } from '@ms-cloudpack/telemetry';\nimport path from 'path';\nimport { registerPerformanceObservers } from '../performance/registerPerformanceObservers.js';\nimport type { CommandAction, InitContext } from '../types/CommandAction.js';\nimport type { ProgramOptions } from '../types/ProgramOptions.js';\nimport type { SharedOptions } from '../types/SharedOptions.js';\nimport { isCIBuild } from '../utilities/isCIBuild.js';\nimport { AutoDisposableList } from './AutoDisposableList.js';\nimport { checkFeatures } from './checkFeatures.js';\nimport { getMergedFeatureFlags } from './getMergedFeatureFlags.js';\nimport { isCodespaces } from '../utilities/isCodespaces.js';\nimport { getVersion } from '@ms-cloudpack/package-utilities';\n\n/**\n * This class manages orchestration and shared state while executing a command.\n */\nexport class CommandExecutor<TOptions extends SharedOptions> {\n  private _options: TOptions;\n  private _execute: CommandAction<TOptions>;\n  private _programOptions: ProgramOptions;\n  private _verb: string;\n  private _reporter: TaskReporter;\n  private _autoDisposableList: AutoDisposableList;\n  private _abortController: AbortController;\n  private _hasCalledExit = false;\n\n  constructor(params: {\n    /** Command-specific and shared options. */\n    options: TOptions;\n    /** Function to execute the command. */\n    execute: CommandAction<TOptions>;\n    /** Shared program-level configuration. */\n    programOptions: ProgramOptions;\n    /** Verb being run, e.g. `bundle` or `cache clean`. */\n    verb: string;\n  }) {\n    this._options = params.options;\n    this._execute = params.execute;\n    this._programOptions = params.programOptions;\n    this._verb = params.verb;\n    this._reporter = new TaskReporter();\n    this._abortController = new AbortController();\n    this._autoDisposableList = new AutoDisposableList();\n  }\n\n  /** Run the command. */\n  // This has to be a separate method because constructors can't be async.\n  public async execute() {\n    try {\n      // Setup cleanup and close things on completion.\n      let sigintCount = 0;\n\n      // Handle SIGINT (Ctrl+C) gracefully.\n      process.on('SIGINT', () => {\n        sigintCount++;\n        if (sigintCount > 1) {\n          console.debug('Forcing exit');\n\n          // We are forcing the process to exit.\n          // No clean-up is needed because user pressed Ctrl+C twice.\n          process.exit(1);\n        }\n\n        // We are trying to exit gracefully.\n        void this._exit();\n      });\n\n      // Call the execute function which is the real command logic\n      // (ie: real init command logic, real start command logic, etc.)\n      await this._execute({\n        options: this._options,\n        cwd: this._programOptions.cwd,\n        reporter: this._reporter,\n        initialize: this._initialize.bind(this),\n        abortSignal: this._abortController.signal,\n        autoDispose: (disposable) => this._autoDisposableList.add(disposable),\n        exit: this._exit,\n      });\n    } catch (error) {\n      // If an error occurs, exit the process with a non-zero exit code.\n      await this._exit({\n        hasErrors: true,\n        message: error instanceof Error ? error.stack || error.message : String(error),\n      });\n    }\n  }\n\n  /**\n   * This is the `initialize` function passed to the command's execute function.\n   * This function uses `this` to references several class members, which is why\n   * the `execute` method must use `.bind(this)`.\n   * (An arrow function isn't possible here due to the overloaded method signature).\n   */\n  private async _initialize(initializeParams: {\n    appPath: string;\n    overrideOptions?: Partial<SharedOptions>;\n  }): Promise<InitContext>;\n  private async _initialize(initializeParams: {\n    appPaths: string[];\n    overrideOptions?: Partial<SharedOptions>;\n  }): Promise<InitContext[]>;\n  private async _initialize(initializeParams: {\n    appPath?: string;\n    appPaths?: string[];\n    overrideOptions?: Partial<SharedOptions>;\n  }): Promise<InitContext | InitContext[]> {\n    const { appPath: singleAppPath } = initializeParams;\n    let { appPaths } = initializeParams;\n\n    if (singleAppPath && appPaths) {\n      throw Error('appPath and appPaths cannot both be specified at the same time');\n    }\n    if (!singleAppPath && !appPaths) {\n      throw Error('one of appPath or appPaths must be specified');\n    }\n\n    if (!appPaths || appPaths.length === 0) {\n      appPaths = singleAppPath ? [singleAppPath] : [];\n    }\n\n    const initContexts = [];\n\n    const actionOptions: SharedOptions = {\n      ...this._options,\n      ...initializeParams.overrideOptions,\n    };\n\n    const helpMessages = new Set<string>();\n\n    const configs = new Map<string, CloudpackConfig>();\n    for (const appPath of appPaths) {\n      const config = await readConfig(appPath);\n      if (config.helpMessage) {\n        helpMessages.add(config.helpMessage);\n      }\n      configs.set(appPath, config);\n    }\n\n    // Set reporter options and print the product info header\n    this._reporter.setOptions({\n      productName: 'Cloudpack',\n      version: this._programOptions.version,\n      description: () => `Running \"${bold(this._programOptions.argv.slice(2).join(' '))}\"`,\n      helpMessage: [...helpMessages.entries()].join('\\n'),\n      plainTextMode: !actionOptions.color,\n      ...(actionOptions.debug\n        ? debugLoggingConfig\n        : actionOptions.verbose\n          ? verboseLoggingConfig\n          : actionOptions.quiet\n            ? noLoggingConfig\n            : defaultLoggingConfig),\n    });\n\n    for (const appPath of appPaths) {\n      const config = configs.get(appPath) as CloudpackConfig;\n      const definition = (await readJson(path.join(appPath, 'package.json'))) as PackageJson;\n\n      const telemetryClient = await this._initTelemetry(definition.name, config);\n      // Dispose the telemetry client when the app is closing\n      this._autoDisposableList.add({\n        dispose: () => telemetryClient.shutdown(),\n      });\n\n      // Merge in any additional features from the command line and remote feature flags.\n      config.features = await getMergedFeatureFlags(config, actionOptions, appPath, definition.name);\n\n      const featureErrors = checkFeatures({ configFeatures: config.features });\n      // If there are any invalid features, exit with an error.\n      if (featureErrors.length) {\n        featureErrors.forEach((error) => console.error(error));\n        process.exit(1);\n      }\n\n      const enabledFeatureNames = Object.entries(config.features)\n        .filter(([, value]) => value)\n        .map(([key]) => key);\n\n      if (enabledFeatureNames.length) {\n        telemetryClient.setSharedSpanAttribute('features', enabledFeatureNames);\n        console.log(`Enabled features: ${enabledFeatureNames.map((f) => yellow(f)).join(', ')}`);\n      }\n\n      initContexts.push({\n        appPath: appPath,\n        telemetryClient,\n        config,\n      });\n    }\n\n    return singleAppPath ? initContexts[0] : initContexts;\n  }\n\n  private async _initTelemetry(appName: string | undefined, config: CloudpackConfig): Promise<TelemetryClient> {\n    const programOptions = this._programOptions;\n    const options = this._options;\n\n    const connectionString = programOptions.disableTelemetry\n      ? undefined\n      : config.telemetry?.connectionString || process.env.CLOUDPACK_TELEMETRY_CONNECTION_STRING;\n\n    const logLevel = options.verbose ? 'VERBOSE' : options.debug ? 'DEBUG' : undefined;\n    if (!options.debug) {\n      this._reporter.ignoreLogMessage('ApplicationInsights:');\n    }\n\n    const telemetryClient = await createTelemetryClient({\n      productVersion: getVersion(import.meta.url),\n      connectionString,\n      logLevel,\n      serviceNamespace: 'cloudpack',\n      serviceName: 'cli',\n      rootSpanName: 'CLI',\n    });\n\n    const isCI = isCIBuild();\n\n    telemetryClient.setSharedSpanAttribute('verb', this._verb);\n    telemetryClient.setSharedSpanAttribute('arguments', programOptions.argv.slice(3).join(' '));\n    telemetryClient.setSharedSpanAttribute('environment', isCI ? 'ci' : isCodespaces() ? 'codespaces' : 'local');\n    telemetryClient.setSharedSpanAttribute('appName', appName || '<unknown>');\n\n    if (isCI) {\n      const ciAttributes = {\n        buildId: process.env.BUILD_BUILDID,\n        definitionId: process.env.SYSTEM_DEFINITIONID,\n        buildReason: process.env.BUILD_REASON,\n        pullRequestId: process.env.SYSTEM_PULLREQUEST_PULLREQUESTID,\n      };\n\n      for (const [key, value] of Object.entries(ciAttributes)) {\n        if (value) {\n          telemetryClient.setSharedSpanAttribute(key, value);\n        }\n      }\n    }\n\n    // Register performance observers to track performance metrics as events of CLI span.\n    registerPerformanceObservers(telemetryClient);\n\n    return telemetryClient;\n  }\n\n  /**\n   * This is the `exit` function passed to the command's execute function.\n   * (It must be an arrow function to ensure the correct `this` context.)\n   */\n  private _exit = async (\n    exitOptions: {\n      hasErrors?: boolean;\n      message?: string;\n      exitCode?: number;\n    } = {},\n  ) => {\n    const { message, hasErrors = this._reporter.hasErrors(), exitCode = hasErrors ? 1 : 0 } = exitOptions;\n\n    if (this._hasCalledExit) {\n      // Skip most of the operations if exit() was called multiple times.\n      console.warn(\"exit() was called multiple times. This call's options:\", exitOptions);\n    } else {\n      this._hasCalledExit = true;\n\n      // Let the execute function know that we are exiting.\n      this._abortController.abort();\n\n      // Dispose all registered disposables.\n      await this._autoDisposableList.dispose();\n\n      // Show the summary message (this will throw if called twice).\n      this._reporter.complete(hasErrors ? red(message) : message);\n    }\n\n    process.exit(exitCode);\n  };\n}\n"]}
+{"version":3,"file":"CommandExecutor.js","sourceRoot":"","sources":["../../src/common/CommandExecutor.ts"],"names":[],"mappings":"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","sourcesContent":["import { readConfig } from '@ms-cloudpack/config';\nimport type { CloudpackConfig, PackageJson } from '@ms-cloudpack/config-types';\nimport { readJson } from '@ms-cloudpack/json-utilities';\nimport {\n  TaskReporter,\n  bold,\n  debugLoggingConfig,\n  defaultLoggingConfig,\n  noLoggingConfig,\n  red,\n  verboseLoggingConfig,\n  yellow,\n} from '@ms-cloudpack/task-reporter';\nimport { createTelemetryClient, type TelemetryClient } from '@ms-cloudpack/telemetry';\nimport path from 'path';\nimport { registerPerformanceObservers } from '../performance/registerPerformanceObservers.js';\nimport type { CommandAction, InitContext } from '../types/CommandAction.js';\nimport type { ProgramOptions } from '../types/ProgramOptions.js';\nimport type { SharedOptions } from '../types/SharedOptions.js';\nimport { isCIBuild } from '../utilities/isCIBuild.js';\nimport { AutoDisposableList } from './AutoDisposableList.js';\nimport { checkFeatures } from './checkFeatures.js';\nimport { getMergedFeatureFlags } from './getMergedFeatureFlags.js';\nimport { isCodespaces } from '../utilities/isCodespaces.js';\nimport { getVersion } from '@ms-cloudpack/package-utilities';\n\n/**\n * This class manages orchestration and shared state while executing a command.\n */\nexport class CommandExecutor<TOptions extends SharedOptions> {\n  private _options: TOptions;\n  private _execute: CommandAction<TOptions>;\n  private _programOptions: ProgramOptions;\n  private _verb: string;\n  private _reporter: TaskReporter;\n  private _autoDisposableList: AutoDisposableList;\n  private _abortController: AbortController;\n  private _hasCalledExit = false;\n  private _args: string[];\n\n  constructor(params: {\n    /** Command-specific arguments */\n    args: string[];\n    /** Command-specific and shared options. */\n    options: TOptions;\n    /** Function to execute the command. */\n    execute: CommandAction<TOptions>;\n    /** Shared program-level configuration. */\n    programOptions: ProgramOptions;\n    /** Verb being run, e.g. `bundle` or `cache clean`. */\n    verb: string;\n  }) {\n    this._args = params.args;\n    this._options = params.options;\n    this._execute = params.execute;\n    this._programOptions = params.programOptions;\n    this._verb = params.verb;\n    this._reporter = new TaskReporter();\n    this._abortController = new AbortController();\n    this._autoDisposableList = new AutoDisposableList();\n  }\n\n  /** Run the command. */\n  // This has to be a separate method because constructors can't be async.\n  public async execute() {\n    try {\n      // Setup cleanup and close things on completion.\n      let sigintCount = 0;\n\n      // Handle SIGINT (Ctrl+C) gracefully.\n      process.on('SIGINT', () => {\n        sigintCount++;\n        if (sigintCount > 1) {\n          console.debug('Forcing exit');\n\n          // We are forcing the process to exit.\n          // No clean-up is needed because user pressed Ctrl+C twice.\n          process.exit(1);\n        }\n\n        // We are trying to exit gracefully.\n        void this._exit();\n      });\n\n      // Call the execute function which is the real command logic\n      // (ie: real init command logic, real start command logic, etc.)\n      await this._execute({\n        args: this._args,\n        options: this._options,\n        cwd: this._programOptions.cwd,\n        reporter: this._reporter,\n        initialize: this._initialize.bind(this),\n        abortSignal: this._abortController.signal,\n        autoDispose: (disposable) => this._autoDisposableList.add(disposable),\n        exit: this._exit,\n      });\n    } catch (error) {\n      // If an error occurs, exit the process with a non-zero exit code.\n      await this._exit({\n        hasErrors: true,\n        message: error instanceof Error ? error.stack || error.message : String(error),\n      });\n    }\n  }\n\n  /**\n   * This is the `initialize` function passed to the command's execute function.\n   * This function uses `this` to references several class members, which is why\n   * the `execute` method must use `.bind(this)`.\n   * (An arrow function isn't possible here due to the overloaded method signature).\n   */\n  private async _initialize(initializeParams: {\n    appPath: string;\n    overrideOptions?: Partial<SharedOptions>;\n  }): Promise<InitContext>;\n  private async _initialize(initializeParams: {\n    appPaths: string[];\n    overrideOptions?: Partial<SharedOptions>;\n  }): Promise<InitContext[]>;\n  private async _initialize(initializeParams: {\n    appPath?: string;\n    appPaths?: string[];\n    overrideOptions?: Partial<SharedOptions>;\n  }): Promise<InitContext | InitContext[]> {\n    const { appPath: singleAppPath } = initializeParams;\n    let { appPaths } = initializeParams;\n\n    if (singleAppPath && appPaths) {\n      throw Error('appPath and appPaths cannot both be specified at the same time');\n    }\n    if (!singleAppPath && !appPaths) {\n      throw Error('one of appPath or appPaths must be specified');\n    }\n\n    if (!appPaths || appPaths.length === 0) {\n      appPaths = singleAppPath ? [singleAppPath] : [];\n    }\n\n    const initContexts = [];\n\n    const actionOptions: SharedOptions = {\n      ...this._options,\n      ...initializeParams.overrideOptions,\n    };\n\n    const helpMessages = new Set<string>();\n\n    const configs = new Map<string, CloudpackConfig>();\n    for (const appPath of appPaths) {\n      const config = await readConfig(appPath);\n      if (config.helpMessage) {\n        helpMessages.add(config.helpMessage);\n      }\n      configs.set(appPath, config);\n    }\n\n    // Set reporter options and print the product info header\n    this._reporter.setOptions({\n      productName: 'Cloudpack',\n      version: this._programOptions.version,\n      description: () => `Running \"${bold(this._programOptions.argv.slice(2).join(' '))}\"`,\n      helpMessage: [...helpMessages.entries()].join('\\n'),\n      plainTextMode: !actionOptions.color,\n      ...(actionOptions.debug\n        ? debugLoggingConfig\n        : actionOptions.verbose\n          ? verboseLoggingConfig\n          : actionOptions.quiet\n            ? noLoggingConfig\n            : defaultLoggingConfig),\n    });\n\n    for (const appPath of appPaths) {\n      const config = configs.get(appPath) as CloudpackConfig;\n      const definition = (await readJson(path.join(appPath, 'package.json'))) as PackageJson;\n\n      const telemetryClient = await this._initTelemetry(definition.name, config);\n      // Dispose the telemetry client when the app is closing\n      this._autoDisposableList.add({\n        dispose: () => telemetryClient.shutdown(),\n      });\n\n      // Merge in any additional features from the command line and remote feature flags.\n      config.features = await getMergedFeatureFlags(config, actionOptions, appPath, definition.name);\n\n      const featureErrors = checkFeatures({ configFeatures: config.features });\n      // If there are any invalid features, exit with an error.\n      if (featureErrors.length) {\n        featureErrors.forEach((error) => console.error(error));\n        process.exit(1);\n      }\n\n      const enabledFeatureNames = Object.entries(config.features)\n        .filter(([, value]) => value)\n        .map(([key]) => key);\n\n      if (enabledFeatureNames.length) {\n        telemetryClient.setSharedSpanAttribute('features', enabledFeatureNames);\n        console.log(`Enabled features: ${enabledFeatureNames.map((f) => yellow(f)).join(', ')}`);\n      }\n\n      initContexts.push({\n        appPath: appPath,\n        telemetryClient,\n        config,\n      });\n    }\n\n    return singleAppPath ? initContexts[0] : initContexts;\n  }\n\n  private async _initTelemetry(appName: string | undefined, config: CloudpackConfig): Promise<TelemetryClient> {\n    const programOptions = this._programOptions;\n    const options = this._options;\n\n    const connectionString = programOptions.disableTelemetry\n      ? undefined\n      : config.telemetry?.connectionString || process.env.CLOUDPACK_TELEMETRY_CONNECTION_STRING;\n\n    const logLevel = options.verbose ? 'VERBOSE' : options.debug ? 'DEBUG' : undefined;\n    if (!options.debug) {\n      this._reporter.ignoreLogMessage('ApplicationInsights:');\n    }\n\n    const telemetryClient = await createTelemetryClient({\n      productVersion: getVersion(import.meta.url),\n      connectionString,\n      logLevel,\n      serviceNamespace: 'cloudpack',\n      serviceName: 'cli',\n      rootSpanName: 'CLI',\n    });\n\n    const isCI = isCIBuild();\n\n    telemetryClient.setSharedSpanAttribute('verb', this._verb);\n    telemetryClient.setSharedSpanAttribute('arguments', programOptions.argv.slice(3).join(' '));\n    telemetryClient.setSharedSpanAttribute('environment', isCI ? 'ci' : isCodespaces() ? 'codespaces' : 'local');\n    telemetryClient.setSharedSpanAttribute('appName', appName || '<unknown>');\n\n    if (isCI) {\n      const ciAttributes = {\n        buildId: process.env.BUILD_BUILDID,\n        definitionId: process.env.SYSTEM_DEFINITIONID,\n        buildReason: process.env.BUILD_REASON,\n        pullRequestId: process.env.SYSTEM_PULLREQUEST_PULLREQUESTID,\n      };\n\n      for (const [key, value] of Object.entries(ciAttributes)) {\n        if (value) {\n          telemetryClient.setSharedSpanAttribute(key, value);\n        }\n      }\n    }\n\n    // Register performance observers to track performance metrics as events of CLI span.\n    registerPerformanceObservers(telemetryClient);\n\n    return telemetryClient;\n  }\n\n  /**\n   * This is the `exit` function passed to the command's execute function.\n   * (It must be an arrow function to ensure the correct `this` context.)\n   */\n  private _exit = async (\n    exitOptions: {\n      hasErrors?: boolean;\n      message?: string;\n      exitCode?: number;\n    } = {},\n  ) => {\n    const { message, hasErrors = this._reporter.hasErrors(), exitCode = hasErrors ? 1 : 0 } = exitOptions;\n\n    if (this._hasCalledExit) {\n      // Skip most of the operations if exit() was called multiple times.\n      console.warn(\"exit() was called multiple times. This call's options:\", exitOptions);\n    } else {\n      this._hasCalledExit = true;\n\n      // Let the execute function know that we are exiting.\n      this._abortController.abort();\n\n      // Dispose all registered disposables.\n      await this._autoDisposableList.dispose();\n\n      // Show the summary message (this will throw if called twice).\n      this._reporter.complete(hasErrors ? red(message) : message);\n    }\n\n    process.exit(exitCode);\n  };\n}\n"]}

package/lib/types/CommandAction.d.ts

@@ -21,6 +21,11 @@ export interface CommandActionParams<TOptions extends object> {
      * The command line options are defined in each command's `src/commands/<name>/index.ts` module.
      */
     options: TOptions;
+    /**
+     * Command-specific arguments. Arguments in commander are positional arguments that are not options.
+     * For example, in `echo somestring`, `somestring` is an argument.
+     */
+    args: string[];
     reporter: TaskReporter;
     abortSignal: AbortSignal;
     /**

package/lib/types/CommandAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandAction.d.ts","sourceRoot":"","sources":["../../src/types/CommandAction.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,MAAM;IAC1D;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,OAAO,EAAE,QAAQ,CAAC;IAElB,QAAQ,EAAE,YAAY,CAAC;IAEvB,WAAW,EAAE,WAAW,CAAC;IAEzB;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;;;;;OAMG;IACH,UAAU,EAAE;QACV,CAAC,iBAAiB,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACzG,CAAC,iBAAiB,EAAE;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAAC,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;KAC/G,CAAC;IAEF;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,GAAG,aAAa,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/G,MAAM,MAAM,mBAAmB,CAAC,QAAQ,IAAI;IAC1C,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC,CAAC"}
+{"version":3,"file":"CommandAction.d.ts","sourceRoot":"","sources":["../../src/types/CommandAction.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,MAAM;IAC1D;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,OAAO,EAAE,QAAQ,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,QAAQ,EAAE,YAAY,CAAC;IAEvB,WAAW,EAAE,WAAW,CAAC;IAEzB;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;;;;;OAMG;IACH,UAAU,EAAE;QACV,CAAC,iBAAiB,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACzG,CAAC,iBAAiB,EAAE;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAAC,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;KAC/G,CAAC;IAEF;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,GAAG,aAAa,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/G,MAAM,MAAM,mBAAmB,CAAC,QAAQ,IAAI;IAC1C,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC,CAAC"}

package/lib/types/CommandAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandAction.js","sourceRoot":"","sources":["../../src/types/CommandAction.ts"],"names":[],"mappings":"","sourcesContent":["import type { TaskReporter } from '@ms-cloudpack/task-reporter';\nimport type { CloudpackConfig } from '@ms-cloudpack/config-types';\nimport type { TelemetryClient } from '@ms-cloudpack/telemetry';\nimport type { AutoDispose } from './AutoDispose.js';\nimport type { SharedOptions } from './SharedOptions.js';\n\nexport type InitContext = {\n  appPath: string;\n  telemetryClient: TelemetryClient;\n  config: CloudpackConfig;\n};\n\nexport interface CommandActionParams<TOptions extends object> {\n  /**\n   * Initial working directory (usually `process.cwd()` except in tests).\n   * Note that this may differ from the `appPath` used by individual commands.\n   */\n  cwd: string;\n\n  /**\n   * Command-specific options, parsed from `process.argv`.\n   * Types are generally defined in each command's `src/commands/<name>/types/<Name>Types.ts` module.\n   * The command line options are defined in each command's `src/commands/<name>/index.ts` module.\n   */\n  options: TOptions;\n\n  reporter: TaskReporter;\n\n  abortSignal: AbortSignal;\n\n  /**\n   * Function that can be called with any `Disposable`s that should be cleaned up automatically\n   * when the program exits. (See `AutoDisposableList.add` for implementation.)\n   */\n  autoDispose: AutoDispose;\n\n  /**\n   * This should be called at or near the beginning of the action to initialize the config,\n   * telemetry, and reporting. (See `createInitializeFunction` for implementation.)\n   * `initialize` can be called with either a single string, `appPath` or an a string[], `appPaths`.\n   * If it is called with a single string, it returns `Promise<InitContext>`\n   * If it is called with a string[], it returns `Promise<InitContext[]>`\n   */\n  initialize: {\n    (initializeOptions: { appPath: string; overrideOptions?: Partial<SharedOptions> }): Promise<InitContext>;\n    (initializeOptions: { appPaths: string[]; overrideOptions?: Partial<SharedOptions> }): Promise<InitContext[]>;\n  };\n\n  /**\n   * This should be called at the end of the action to dispose resources, log completion,\n   * and exit the program. (See `createExitFunction` for implementation.)\n   */\n  exit: (result: { exitCode: number; message?: string }) => Promise<void>;\n}\n\n/**\n * Command action function. This is the type of the `execute` function which should be exported\n * from each command's `src/commands/<name>/execute.ts` module.\n */\nexport type CommandAction<TOptions> = (params: CommandActionParams<TOptions & SharedOptions>) => Promise<void>;\n\nexport type CommandActionModule<TOptions> = {\n  execute: CommandAction<TOptions>;\n};\n"]}
+{"version":3,"file":"CommandAction.js","sourceRoot":"","sources":["../../src/types/CommandAction.ts"],"names":[],"mappings":"","sourcesContent":["import type { TaskReporter } from '@ms-cloudpack/task-reporter';\nimport type { CloudpackConfig } from '@ms-cloudpack/config-types';\nimport type { TelemetryClient } from '@ms-cloudpack/telemetry';\nimport type { AutoDispose } from './AutoDispose.js';\nimport type { SharedOptions } from './SharedOptions.js';\n\nexport type InitContext = {\n  appPath: string;\n  telemetryClient: TelemetryClient;\n  config: CloudpackConfig;\n};\n\nexport interface CommandActionParams<TOptions extends object> {\n  /**\n   * Initial working directory (usually `process.cwd()` except in tests).\n   * Note that this may differ from the `appPath` used by individual commands.\n   */\n  cwd: string;\n\n  /**\n   * Command-specific options, parsed from `process.argv`.\n   * Types are generally defined in each command's `src/commands/<name>/types/<Name>Types.ts` module.\n   * The command line options are defined in each command's `src/commands/<name>/index.ts` module.\n   */\n  options: TOptions;\n\n  /**\n   * Command-specific arguments. Arguments in commander are positional arguments that are not options.\n   * For example, in `echo somestring`, `somestring` is an argument.\n   */\n  args: string[];\n\n  reporter: TaskReporter;\n\n  abortSignal: AbortSignal;\n\n  /**\n   * Function that can be called with any `Disposable`s that should be cleaned up automatically\n   * when the program exits. (See `AutoDisposableList.add` for implementation.)\n   */\n  autoDispose: AutoDispose;\n\n  /**\n   * This should be called at or near the beginning of the action to initialize the config,\n   * telemetry, and reporting. (See `createInitializeFunction` for implementation.)\n   * `initialize` can be called with either a single string, `appPath` or an a string[], `appPaths`.\n   * If it is called with a single string, it returns `Promise<InitContext>`\n   * If it is called with a string[], it returns `Promise<InitContext[]>`\n   */\n  initialize: {\n    (initializeOptions: { appPath: string; overrideOptions?: Partial<SharedOptions> }): Promise<InitContext>;\n    (initializeOptions: { appPaths: string[]; overrideOptions?: Partial<SharedOptions> }): Promise<InitContext[]>;\n  };\n\n  /**\n   * This should be called at the end of the action to dispose resources, log completion,\n   * and exit the program. (See `createExitFunction` for implementation.)\n   */\n  exit: (result: { exitCode: number; message?: string }) => Promise<void>;\n}\n\n/**\n * Command action function. This is the type of the `execute` function which should be exported\n * from each command's `src/commands/<name>/execute.ts` module.\n */\nexport type CommandAction<TOptions> = (params: CommandActionParams<TOptions & SharedOptions>) => Promise<void>;\n\nexport type CommandActionModule<TOptions> = {\n  execute: CommandAction<TOptions>;\n};\n"]}

package/lib/types/CommandInitFunction.d.ts

@@ -4,7 +4,7 @@ import type { CloudpackCommand } from '../common/CloudpackCommand.js';
  * This is the type for the `init` function exported by each `src/commands/<name>/index.ts` module.
  * @param program Command object for the program.
  */
-export type CommandInitFunction = (program: CloudpackCommand<object>) => void;
+export type CommandInitFunction = (program: CloudpackCommand<object, object>) => void;
 /**
  * Type for each `src/commands/<name>/index.ts` module.
  */

package/lib/types/CommandInitFunction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandInitFunction.d.ts","sourceRoot":"","sources":["../../src/types/CommandInitFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC"}
+{"version":3,"file":"CommandInitFunction.d.ts","sourceRoot":"","sources":["../../src/types/CommandInitFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC"}

package/lib/types/CommandInitFunction.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandInitFunction.js","sourceRoot":"","sources":["../../src/types/CommandInitFunction.ts"],"names":[],"mappings":"","sourcesContent":["import type { CloudpackCommand } from '../common/CloudpackCommand.js';\n\n/**\n * Initialize a command object for a sub-command.\n * This is the type for the `init` function exported by each `src/commands/<name>/index.ts` module.\n * @param program Command object for the program.\n */\nexport type CommandInitFunction = (program: CloudpackCommand<object>) => void;\n\n/**\n * Type for each `src/commands/<name>/index.ts` module.\n */\nexport type CommandInitModule = {\n  init: CommandInitFunction;\n};\n"]}
+{"version":3,"file":"CommandInitFunction.js","sourceRoot":"","sources":["../../src/types/CommandInitFunction.ts"],"names":[],"mappings":"","sourcesContent":["import type { CloudpackCommand } from '../common/CloudpackCommand.js';\n\n/**\n * Initialize a command object for a sub-command.\n * This is the type for the `init` function exported by each `src/commands/<name>/index.ts` module.\n * @param program Command object for the program.\n */\nexport type CommandInitFunction = (program: CloudpackCommand<object, object>) => void;\n\n/**\n * Type for each `src/commands/<name>/index.ts` module.\n */\nexport type CommandInitModule = {\n  init: CommandInitFunction;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/cli",
-  "version": "0.57.4",
+  "version": "0.57.6",
   "description": "The Cloudpack command line interface - a tool for managing fast inner and outer looping in web apps.",
   "license": "MIT",
   "type": "module",
@@ -10,19 +10,19 @@
     "cloudpack": "./bin/cloudpack.js"
   },
   "dependencies": {
-    "@ms-cloudpack/api-server": "^0.33.1",
-    "@ms-cloudpack/app-server": "^0.2.9",
-    "@ms-cloudpack/bundle-server": "^0.2.39",
+    "@ms-cloudpack/api-server": "^0.33.3",
+    "@ms-cloudpack/app-server": "^0.2.11",
+    "@ms-cloudpack/bundle-server": "^0.2.41",
     "@ms-cloudpack/config": "^0.17.38",
     "@ms-cloudpack/config-types": "^0.7.0",
     "@ms-cloudpack/feature-flags": "^0.1.1",
     "@ms-cloudpack/json-utilities": "^0.1.4",
-    "@ms-cloudpack/overlay": "^0.16.88",
+    "@ms-cloudpack/overlay": "^0.16.90",
     "@ms-cloudpack/package-utilities": "^7.0.1",
     "@ms-cloudpack/path-string-parsing": "^1.2.1",
     "@ms-cloudpack/path-utilities": "^2.6.1",
-    "@ms-cloudpack/remote-cache": "^0.6.1",
-    "@ms-cloudpack/task-reporter": "^0.11.2",
+    "@ms-cloudpack/remote-cache": "^0.6.2",
+    "@ms-cloudpack/task-reporter": "^0.11.3",
     "@ms-cloudpack/telemetry": "^0.5.1",
     "@yarnpkg/lockfile": "^1.1.0",
     "commander": "^11.1.0",
@@ -35,10 +35,10 @@
     "workspace-tools": "^0.36.4"
   },
   "devDependencies": {
-    "@ms-cloudpack/bundler-types": "*",
-    "@ms-cloudpack/eslint-plugin-internal": "*",
-    "@ms-cloudpack/scripts": "*",
-    "@ms-cloudpack/test-utilities": "*",
+    "@ms-cloudpack/bundler-types": "^0.25.2",
+    "@ms-cloudpack/eslint-plugin-internal": "^0.0.1",
+    "@ms-cloudpack/scripts": "^0.0.1",
+    "@ms-cloudpack/test-utilities": "^0.5.0",
     "@types/cross-spawn": "^6.0.2",
     "@types/didyoumean": "^1.2.2",
     "@types/prompts": "^2.4.4",