@codiac.io/codiac-cli 1.2.168 → 1.2.169

package/lib/cli-common/command-base.d.ts

@@ -1,72 +1,72 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import "reflect-metadata";
-import { Container } from 'inversify';
-import { Command, Config } from '@oclif/core';
-import * as fs from 'fs';
-import { exec as nodeExec } from 'child_process';
-import { IBetterLogger } from '@codiac.io/codiac-common/IBetterLogger';
-import { IUserInputProvider, IOutputStyler } from "@codiac.io/codiac-ops-common";
-import { CliGlobalConfigRepo, CliConfig } from '../ops';
-export declare interface IGlobalFlags {
-    as?: string | undefined;
-    remember?: boolean;
-    rememberAs?: string | undefined;
-    unremember?: string | undefined;
-    withoutdefaults?: boolean;
-}
-export declare abstract class commandBase extends Command {
-    protected static dependencyTargetingFlags: {
-        only: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        includeDeps: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    };
-    protected static dependencyTargetingArgs: {
-        name: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
-    };
-    /** Flags that can be available to multiple commands.
-     *  Support them in a command by extending the flags object with this property using a spread operator.
-     * eg:  static flags = { ...commandBase.globalFlags, myflag: flags.boolean(yadayada) }
-     */
-    static globalFlags: {
-        as: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        remember: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        rememberAs: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        unremember: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        withoutdefaults: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    };
-    /** (optional: defaults to false) Declares whether this command must be called from within a folder (or subfolder) of an initialized codiac project (ie: requires that a codiac.json file exists in the path of the current folder). */
-    protected requiresProjectScope: boolean | undefined;
-    protected static isBootstrapped: boolean;
-    /** Initializes ioc (mutates it) with typical cli/codiac project entities. */
-    protected static bootstrap(ioc: Container, oclifConfig: Config, requiresProjectScope: boolean): void;
-    /**
-     * You must call the following command in the body of your bootstrap method implementation...
-     * ```
-     * commandBase.bootstrap(this.ioc, this.config, this.requiresProjectScope);
-     * ```
-     */
-    protected abstract bootstrap(): void;
-    protected get ioc(): Container;
-    private __ioc;
-    protected get logger(): IBetterLogger;
-    private __logger;
-    protected get _cfgRepo(): CliGlobalConfigRepo;
-    private __cfgRepo;
-    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
-    get _cliCfg(): CliConfig;
-    private __cliCfg;
-    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
-    protected get _ui(): IUserInputProvider;
-    protected __ui: IUserInputProvider | undefined;
-    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
-    protected get _styler(): IOutputStyler;
-    protected __styler: IOutputStyler | undefined;
-    protected execAsync: typeof nodeExec.__promisify__;
-    protected copyAsync: typeof fs.copyFile.__promisify__;
-    abstract run(): Promise<void>;
-    /** Call this from the catch block of your command handler.
-     * Writes the error message appropriately to the console,
-     * minding stderr and stdout as required. */
-    protected handleError(err: any): void;
-}
+/// <reference types="node" />
+/// <reference types="node" />
+import "reflect-metadata";
+import { Container } from 'inversify';
+import { Command, Config } from '@oclif/core';
+import * as fs from 'fs';
+import { exec as nodeExec } from 'child_process';
+import { IBetterLogger } from '@codiac.io/codiac-common/IBetterLogger';
+import { IUserInputProvider, IOutputStyler } from "@codiac.io/codiac-ops-common";
+import { CliGlobalConfigRepo, CliConfig } from '../ops';
+export declare interface IGlobalFlags {
+    as?: string | undefined;
+    remember?: boolean;
+    rememberAs?: string | undefined;
+    unremember?: string | undefined;
+    withoutdefaults?: boolean;
+}
+export declare abstract class commandBase extends Command {
+    protected static dependencyTargetingFlags: {
+        only: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        includeDeps: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    protected static dependencyTargetingArgs: {
+        name: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    /** Flags that can be available to multiple commands.
+     *  Support them in a command by extending the flags object with this property using a spread operator.
+     * eg:  static flags = { ...commandBase.globalFlags, myflag: flags.boolean(yadayada) }
+     */
+    static globalFlags: {
+        as: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remember: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        rememberAs: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        unremember: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        withoutdefaults: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    /** (optional: defaults to false) Declares whether this command must be called from within a folder (or subfolder) of an initialized codiac project (ie: requires that a codiac.json file exists in the path of the current folder). */
+    protected requiresProjectScope: boolean | undefined;
+    protected static isBootstrapped: boolean;
+    /** Initializes ioc (mutates it) with typical cli/codiac project entities. */
+    protected static bootstrap(ioc: Container, oclifConfig: Config, requiresProjectScope: boolean): void;
+    /**
+     * You must call the following command in the body of your bootstrap method implementation...
+     * ```
+     * commandBase.bootstrap(this.ioc, this.config, this.requiresProjectScope);
+     * ```
+     */
+    protected abstract bootstrap(): void;
+    protected get ioc(): Container;
+    private __ioc;
+    protected get logger(): IBetterLogger;
+    private __logger;
+    protected get _cfgRepo(): CliGlobalConfigRepo;
+    private __cfgRepo;
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    get _cliCfg(): CliConfig;
+    private __cliCfg;
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    protected get _ui(): IUserInputProvider;
+    protected __ui: IUserInputProvider | undefined;
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    protected get _styler(): IOutputStyler;
+    protected __styler: IOutputStyler | undefined;
+    protected execAsync: typeof nodeExec.__promisify__;
+    protected copyAsync: typeof fs.copyFile.__promisify__;
+    abstract run(): Promise<void>;
+    /** Call this from the catch block of your command handler.
+     * Writes the error message appropriately to the console,
+     * minding stderr and stdout as required. */
+    protected handleError(err: any): void;
+}

package/lib/cli-common/command-base.js

@@ -1,182 +1,182 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.commandBase = void 0;
-require("reflect-metadata");
-const inversify_1 = require("inversify");
-const core_1 = require("@oclif/core");
-const nodeUtil = require("util");
-const fs = require("fs");
-const child_process_1 = require("child_process");
-const guid_typescript_1 = require("guid-typescript");
-const codiac_common_1 = require("@codiac.io/codiac-common");
-const IBetterLogger_1 = require("@codiac.io/codiac-common/IBetterLogger");
-const better_logger_1 = require("@codiac.io/codiac-common/better-logger");
-const cli_tools_1 = require("@codiac.io/cli-tools");
-const codiac_relay_contracts_1 = require("@codiac.io/codiac-relay-contracts");
-const codiac_ops_common_1 = require("@codiac.io/codiac-ops-common");
-const codiac_ops_common_2 = require("@codiac.io/codiac-ops-common");
-const ops_1 = require("../ops");
-const built_in_cli_user_input_1 = require("./built-in-cli-user-input");
-class commandBase extends core_1.Command {
-    constructor() {
-        super(...arguments);
-        this.execAsync = nodeUtil.promisify(child_process_1.exec); // antiquated nastiness
-        this.copyAsync = nodeUtil.promisify(fs.copyFile); // antiquated nastiness
-    }
-    /** Initializes ioc (mutates it) with typical cli/codiac project entities. */
-    static bootstrap(ioc, oclifConfig, requiresProjectScope) {
-        ioc.bind(ops_1.CliEnviro).toDynamicValue(() => new ops_1.CliEnviro(oclifConfig.configDir, oclifConfig.version)).inSingletonScope();
-        ioc.bind(ops_1.CliGlobalConfigRepo).toSelf(); // (() => new CliContextRepo(this.config.configDir, this._projectRoot));
-        ioc.bind(ops_1.CliConfig).toDynamicValue(ctxt => {
-            let cfgRepo = ctxt.container.get(ops_1.CliGlobalConfigRepo);
-            return cfgRepo.read_sync() || new ops_1.CliConfig();
-        }); // .inSingletonScope();
-        // PROJECT SCOPE (all nullables)
-        ioc.bind(ops_1.ProjectEnviro).toDynamicValue(() => {
-            let projRoot = codiac_ops_common_1.CliPathWalker.getProjectRoot(undefined, requiresProjectScope);
-            return (projRoot === "") ? undefined : new ops_1.ProjectEnviro(projRoot);
-        }).inSingletonScope();
-        ioc.bind(ops_1.ProjectContextRepo).toDynamicValue(ctx => {
-            let projEnv = ctx.container.get(ops_1.ProjectEnviro);
-            return projEnv ? new ops_1.ProjectContextRepo(projEnv) : undefined;
-        }); // toSelf();  // (() => new CliContextRepo(this.config.configDir, this._projectRoot));
-        ioc.bind(codiac_relay_contracts_1.ProjectConfig).toDynamicValue(ctxt => {
-            let cfgRepo = ctxt.container.get(ops_1.ProjectContextRepo);
-            return cfgRepo === null || cfgRepo === void 0 ? void 0 : cfgRepo.readProjectConfig();
-        }); // .inSingletonScope();
-        ioc.bind(codiac_relay_contracts_1.ProjectUserConfig).toDynamicValue(ctxt => {
-            let cfgRepo = ctxt.container.get(ops_1.ProjectContextRepo);
-            return cfgRepo === null || cfgRepo === void 0 ? void 0 : cfgRepo.readProjectUserConfig();
-        }); // .inSingletonScope();
-        ioc.bind(ops_1.OperationMeta).toDynamicValue(ctxt => {
-            return {
-                correlationId: guid_typescript_1.Guid.create().toString()
-            };
-        }).inSingletonScope(); // <-- singleton for CLI ONLY!!!
-        ioc.bind(codiac_ops_common_1.INTERFACES_OPS.IUserInputProvider).to(built_in_cli_user_input_1.BuiltInCliUserInput);
-        ioc.bind(codiac_ops_common_1.INTERFACES_OPS.IOutputStyler).to(cli_tools_1.TtyOutputStyler);
-        ioc.bind(IBetterLogger_1.LoggerSettings).toDynamicValue(ctxt => {
-            // INITIALIZE LOGGER
-            let settings = new IBetterLogger_1.LoggerSettings([IBetterLogger_1.LogLevel.notice, IBetterLogger_1.LogLevel.warn, IBetterLogger_1.LogLevel.error, IBetterLogger_1.LogLevel.fatal]);
-            const cliCfg = ctxt.container.get(ops_1.CliConfig);
-            if (cliCfg.verbosity) {
-                switch (cliCfg.verbosity) {
-                    case ops_1.Verbosity.detail:
-                        settings.LogLevelsToShow.push(IBetterLogger_1.LogLevel.detail);
-                        break;
-                    case ops_1.Verbosity.debug:
-                        settings.LogLevelsToShow.push(IBetterLogger_1.LogLevel.detail);
-                        settings.LogLevelsToShow.push(IBetterLogger_1.LogLevel.debug);
-                        settings.LogLevelsToShow.push(IBetterLogger_1.LogLevel.trace);
-                        break;
-                }
-            }
-            return settings;
-        }).inSingletonScope();
-        // ioc.bind<LoggerSettings>(LoggerSettings).toConstantValue(settings);
-        if (ioc.isBound(codiac_common_1.INTERFACES.IBetterLogger) !== true) {
-            ioc.bind(codiac_common_1.INTERFACES.IBetterLogger).to(better_logger_1.BetterConsoleLogger);
-        }
-        codiac_ops_common_2.OpsCommon.bootstrap(ioc);
-        this.isBootstrapped = true;
-    }
-    // ------------------------------------
-    // Lazy-loaded properties 
-    // 
-    // (this is an interim step for now, 
-    // while commands are refactored 
-    // to use ioc as needed instead of commandBase properties)
-    // ------------------------------------
-    get ioc() {
-        if (this.__ioc === undefined) {
-            this.__ioc = new inversify_1.Container();
-        }
-        return this.__ioc;
-    }
-    ;
-    // ------------------------------------
-    // IOC WRAPPER PROPERTIES
-    // ------------------------------------
-    get logger() {
-        if (this.__logger === undefined) {
-            this.__logger = this.ioc.get(codiac_common_1.INTERFACES.IBetterLogger);
-        }
-        return this.__logger;
-    }
-    ;
-    get _cfgRepo() {
-        if (this.__cfgRepo === undefined) {
-            this.__cfgRepo = this.ioc.get(ops_1.CliGlobalConfigRepo);
-        }
-        return this.__cfgRepo;
-    }
-    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
-    get _cliCfg() {
-        if (this.__cliCfg === undefined) {
-            this.__cliCfg = this.ioc.get(ops_1.CliConfig);
-        }
-        return this.__cliCfg;
-    }
-    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
-    get _ui() {
-        if (this.__ui === undefined) {
-            this.__ui = this.ioc.get(codiac_ops_common_1.INTERFACES_OPS.IUserInputProvider);
-        }
-        return this.__ui;
-    }
-    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
-    get _styler() {
-        if (this.__styler === undefined) {
-            this.__styler = this.ioc.get(codiac_ops_common_1.INTERFACES_OPS.IOutputStyler);
-        }
-        return this.__styler;
-    }
-    // async run(): Promise<void> {
-    //   return new Promise<void>(async (resolve,reject) => {
-    //     try {
-    //       // My shit here....
-    //       resolve();
-    //     } catch (err) {
-    //       reject(err);
-    //     }
-    //   });
-    // }
-    /** Call this from the catch block of your command handler.
-     * Writes the error message appropriately to the console,
-     * minding stderr and stdout as required. */
-    handleError(err) {
-        if (err.stdout || err.stderr) {
-            if (err.stdout)
-                this.logger.error(`Operation failed! ${err.message || ""} stdout...`, err.stdout);
-            if (err.stderr)
-                this.logger.error(`Operation failed! ${err.message || ""} stderr...`, err.stderr);
-        }
-        else {
-            this.logger.debug(err.stack);
-            this.logger.error(`Operation failed! ${err.message || ""}`);
-        }
-        // need to output stderr for pipelines
-        (err && err.message) ? process.stderr.write(err.message) : process.stderr.write("Error, see logs for details");
-    }
-}
-exports.commandBase = commandBase;
-commandBase.dependencyTargetingFlags = {
-    only: core_1.Flags.boolean({ char: 'o', required: false, description: 'Applies the command only the sourced dependencies selected from a prompt. Quits if no dependencies are currently sourced.' }),
-    includeDeps: core_1.Flags.boolean({ char: 'i', required: false, description: 'Also performs the operation on any currently source dependencies.' })
-};
-commandBase.dependencyTargetingArgs = {
-    name: core_1.Args.string({ require: false, description: 'The official unique name of a currently sourced dependency.  Applies the command to ONLY this sourced dependency.' })
-};
-/** Flags that can be available to multiple commands.
- *  Support them in a command by extending the flags object with this property using a spread operator.
- * eg:  static flags = { ...commandBase.globalFlags, myflag: flags.boolean(yadayada) }
- */
-commandBase.globalFlags = {
-    as: core_1.Flags.string({ description: 'Fires this command with an argument list that was previously remembered using the --rememberAs flag.' }),
-    remember: core_1.Flags.boolean({ description: 'Saves the arguments, so they are invoked as defaults whenever this command gets called.' }),
-    rememberAs: core_1.Flags.string({ description: 'Saves the given argument list so that it can be called by name.' }),
-    unremember: core_1.Flags.string({ description: 'Administrative only: DOES NOT fire the actual command.  Simply clears the arguments that were previously stored under the given name (use "--unRemember default" to clear default argument list memorized with the --remember flag).' }),
-    withoutdefaults: core_1.Flags.boolean({ description: "Prevents any relevant saved defaults from being invoked for this call." }),
-    verbose: core_1.Flags.boolean({ char: 'v', description: 'Renders additional logging levels (detail, trace, and debug) to the console output.' })
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandBase = void 0;
+require("reflect-metadata");
+const inversify_1 = require("inversify");
+const core_1 = require("@oclif/core");
+const nodeUtil = require("util");
+const fs = require("fs");
+const child_process_1 = require("child_process");
+const guid_typescript_1 = require("guid-typescript");
+const codiac_common_1 = require("@codiac.io/codiac-common");
+const IBetterLogger_1 = require("@codiac.io/codiac-common/IBetterLogger");
+const better_logger_1 = require("@codiac.io/codiac-common/better-logger");
+const cli_tools_1 = require("@codiac.io/cli-tools");
+const codiac_relay_contracts_1 = require("@codiac.io/codiac-relay-contracts");
+const codiac_ops_common_1 = require("@codiac.io/codiac-ops-common");
+const codiac_ops_common_2 = require("@codiac.io/codiac-ops-common");
+const ops_1 = require("../ops");
+const built_in_cli_user_input_1 = require("./built-in-cli-user-input");
+class commandBase extends core_1.Command {
+    constructor() {
+        super(...arguments);
+        this.execAsync = nodeUtil.promisify(child_process_1.exec); // antiquated nastiness
+        this.copyAsync = nodeUtil.promisify(fs.copyFile); // antiquated nastiness
+    }
+    /** Initializes ioc (mutates it) with typical cli/codiac project entities. */
+    static bootstrap(ioc, oclifConfig, requiresProjectScope) {
+        ioc.bind(ops_1.CliEnviro).toDynamicValue(() => new ops_1.CliEnviro(oclifConfig.configDir, oclifConfig.version)).inSingletonScope();
+        ioc.bind(ops_1.CliGlobalConfigRepo).toSelf(); // (() => new CliContextRepo(this.config.configDir, this._projectRoot));
+        ioc.bind(ops_1.CliConfig).toDynamicValue(ctxt => {
+            let cfgRepo = ctxt.container.get(ops_1.CliGlobalConfigRepo);
+            return cfgRepo.read_sync() || new ops_1.CliConfig();
+        }); // .inSingletonScope();
+        // PROJECT SCOPE (all nullables)
+        ioc.bind(ops_1.ProjectEnviro).toDynamicValue(() => {
+            let projRoot = codiac_ops_common_1.CliPathWalker.getProjectRoot(undefined, requiresProjectScope);
+            return (projRoot === "") ? undefined : new ops_1.ProjectEnviro(projRoot);
+        }).inSingletonScope();
+        ioc.bind(ops_1.ProjectContextRepo).toDynamicValue(ctx => {
+            let projEnv = ctx.container.get(ops_1.ProjectEnviro);
+            return projEnv ? new ops_1.ProjectContextRepo(projEnv) : undefined;
+        }); // toSelf();  // (() => new CliContextRepo(this.config.configDir, this._projectRoot));
+        ioc.bind(codiac_relay_contracts_1.ProjectConfig).toDynamicValue(ctxt => {
+            let cfgRepo = ctxt.container.get(ops_1.ProjectContextRepo);
+            return cfgRepo === null || cfgRepo === void 0 ? void 0 : cfgRepo.readProjectConfig();
+        }); // .inSingletonScope();
+        ioc.bind(codiac_relay_contracts_1.ProjectUserConfig).toDynamicValue(ctxt => {
+            let cfgRepo = ctxt.container.get(ops_1.ProjectContextRepo);
+            return cfgRepo === null || cfgRepo === void 0 ? void 0 : cfgRepo.readProjectUserConfig();
+        }); // .inSingletonScope();
+        ioc.bind(ops_1.OperationMeta).toDynamicValue(ctxt => {
+            return {
+                correlationId: guid_typescript_1.Guid.create().toString()
+            };
+        }).inSingletonScope(); // <-- singleton for CLI ONLY!!!
+        ioc.bind(codiac_ops_common_1.INTERFACES_OPS.IUserInputProvider).to(built_in_cli_user_input_1.BuiltInCliUserInput);
+        ioc.bind(codiac_ops_common_1.INTERFACES_OPS.IOutputStyler).to(cli_tools_1.TtyOutputStyler);
+        ioc.bind(IBetterLogger_1.LoggerSettings).toDynamicValue(ctxt => {
+            // INITIALIZE LOGGER
+            let settings = new IBetterLogger_1.LoggerSettings([IBetterLogger_1.LogLevel.notice, IBetterLogger_1.LogLevel.warn, IBetterLogger_1.LogLevel.error, IBetterLogger_1.LogLevel.fatal]);
+            const cliCfg = ctxt.container.get(ops_1.CliConfig);
+            if (cliCfg.verbosity) {
+                switch (cliCfg.verbosity) {
+                    case ops_1.Verbosity.detail:
+                        settings.LogLevelsToShow.push(IBetterLogger_1.LogLevel.detail);
+                        break;
+                    case ops_1.Verbosity.debug:
+                        settings.LogLevelsToShow.push(IBetterLogger_1.LogLevel.detail);
+                        settings.LogLevelsToShow.push(IBetterLogger_1.LogLevel.debug);
+                        settings.LogLevelsToShow.push(IBetterLogger_1.LogLevel.trace);
+                        break;
+                }
+            }
+            return settings;
+        }).inSingletonScope();
+        // ioc.bind<LoggerSettings>(LoggerSettings).toConstantValue(settings);
+        if (ioc.isBound(codiac_common_1.INTERFACES.IBetterLogger) !== true) {
+            ioc.bind(codiac_common_1.INTERFACES.IBetterLogger).to(better_logger_1.BetterConsoleLogger);
+        }
+        codiac_ops_common_2.OpsCommon.bootstrap(ioc);
+        this.isBootstrapped = true;
+    }
+    // ------------------------------------
+    // Lazy-loaded properties 
+    // 
+    // (this is an interim step for now, 
+    // while commands are refactored 
+    // to use ioc as needed instead of commandBase properties)
+    // ------------------------------------
+    get ioc() {
+        if (this.__ioc === undefined) {
+            this.__ioc = new inversify_1.Container();
+        }
+        return this.__ioc;
+    }
+    ;
+    // ------------------------------------
+    // IOC WRAPPER PROPERTIES
+    // ------------------------------------
+    get logger() {
+        if (this.__logger === undefined) {
+            this.__logger = this.ioc.get(codiac_common_1.INTERFACES.IBetterLogger);
+        }
+        return this.__logger;
+    }
+    ;
+    get _cfgRepo() {
+        if (this.__cfgRepo === undefined) {
+            this.__cfgRepo = this.ioc.get(ops_1.CliGlobalConfigRepo);
+        }
+        return this.__cfgRepo;
+    }
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    get _cliCfg() {
+        if (this.__cliCfg === undefined) {
+            this.__cliCfg = this.ioc.get(ops_1.CliConfig);
+        }
+        return this.__cliCfg;
+    }
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    get _ui() {
+        if (this.__ui === undefined) {
+            this.__ui = this.ioc.get(codiac_ops_common_1.INTERFACES_OPS.IUserInputProvider);
+        }
+        return this.__ui;
+    }
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    get _styler() {
+        if (this.__styler === undefined) {
+            this.__styler = this.ioc.get(codiac_ops_common_1.INTERFACES_OPS.IOutputStyler);
+        }
+        return this.__styler;
+    }
+    // async run(): Promise<void> {
+    //   return new Promise<void>(async (resolve,reject) => {
+    //     try {
+    //       // My shit here....
+    //       resolve();
+    //     } catch (err) {
+    //       reject(err);
+    //     }
+    //   });
+    // }
+    /** Call this from the catch block of your command handler.
+     * Writes the error message appropriately to the console,
+     * minding stderr and stdout as required. */
+    handleError(err) {
+        if (err.stdout || err.stderr) {
+            if (err.stdout)
+                this.logger.error(`Operation failed! ${err.message || ""} stdout...`, err.stdout);
+            if (err.stderr)
+                this.logger.error(`Operation failed! ${err.message || ""} stderr...`, err.stderr);
+        }
+        else {
+            this.logger.debug(err.stack);
+            this.logger.error(`Operation failed! ${err.message || ""}`);
+        }
+        // need to output stderr for pipelines
+        (err && err.message) ? process.stderr.write(err.message) : process.stderr.write("Error, see logs for details");
+    }
+}
+exports.commandBase = commandBase;
+commandBase.dependencyTargetingFlags = {
+    only: core_1.Flags.boolean({ char: 'o', required: false, description: 'Applies the command only the sourced dependencies selected from a prompt. Quits if no dependencies are currently sourced.' }),
+    includeDeps: core_1.Flags.boolean({ char: 'i', required: false, description: 'Also performs the operation on any currently source dependencies.' })
+};
+commandBase.dependencyTargetingArgs = {
+    name: core_1.Args.string({ require: false, description: 'The official unique name of a currently sourced dependency.  Applies the command to ONLY this sourced dependency.' })
+};
+/** Flags that can be available to multiple commands.
+ *  Support them in a command by extending the flags object with this property using a spread operator.
+ * eg:  static flags = { ...commandBase.globalFlags, myflag: flags.boolean(yadayada) }
+ */
+commandBase.globalFlags = {
+    as: core_1.Flags.string({ description: 'Fires this command with an argument list that was previously remembered using the --rememberAs flag.' }),
+    remember: core_1.Flags.boolean({ description: 'Saves the arguments, so they are invoked as defaults whenever this command gets called.' }),
+    rememberAs: core_1.Flags.string({ description: 'Saves the given argument list so that it can be called by name.' }),
+    unremember: core_1.Flags.string({ description: 'Administrative only: DOES NOT fire the actual command.  Simply clears the arguments that were previously stored under the given name (use "--unRemember default" to clear default argument list memorized with the --remember flag).' }),
+    withoutdefaults: core_1.Flags.boolean({ description: "Prevents any relevant saved defaults from being invoked for this call." }),
+    verbose: core_1.Flags.boolean({ char: 'v', description: 'Renders additional logging levels (detail, trace, and debug) to the console output.' })
+};
 //# sourceMappingURL=command-base.js.map

package/lib/cli-common/entities/index.d.ts

@@ -1 +1 @@
-export * from "./prompt-choice";
+export * from "./prompt-choice";

package/lib/cli-common/entities/index.js

@@ -1,5 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./prompt-choice"), exports);
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./prompt-choice"), exports);
 //# sourceMappingURL=index.js.map

package/lib/cli-common/entities/prompt-choice.d.ts

@@ -1,7 +1,7 @@
-/** Input object for the available options in a CLI select list.
- * The `name` is what renders in the list,
- * and the `value` is what actually gets returned from the selection.  */
-export type PromptChoice = {
-    value: string;
-    name: string;
-};
+/** Input object for the available options in a CLI select list.
+ * The `name` is what renders in the list,
+ * and the `value` is what actually gets returned from the selection.  */
+export type PromptChoice = {
+    value: string;
+    name: string;
+};

package/lib/cli-common/entities/prompt-choice.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=prompt-choice.js.map