@codiac.io/codiac-cli 1.2.217 → 1.2.221

package/dist/commands/config/add.js

@@ -12,159 +12,120 @@ const command_base_enterprise_1 = require("../../command-base-enterprise");
 const CodiacConstants = require("../../codiac-constants");
 const path = require("path");
 const render = require("../../uilogic/render-methods");
+const config_ui_utils_1 = require("../../uilogic/config-ui-utils");
 // const { selectFiles, COMPLETED, CANCELLED } = require('select-files-cli');  // gd js wo ts...
 // const { selectFiles, COMPLETED, CANCELLED } = require('../../uilogic/file-selector');  // gd js wo ts...
 /** The value provided as input that indicates
  * a user's desire to be prompted with a list from which choose the value(s),
  * instead of entering them manually or taking a default. */
 exports.PROMPT_ME_DESIGNATOR = "?";
+/** Reads the given stream directly without assigning listeners to its events. */
+function read(stream) {
+    var _a, stream_1, stream_1_1;
+    var _b, e_1, _c, _d;
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        try {
+            const chunks = [];
+            try {
+                for (_a = true, stream_1 = tslib_1.__asyncValues(stream); stream_1_1 = yield stream_1.next(), _b = stream_1_1.done, !_b;) {
+                    _d = stream_1_1.value;
+                    _a = false;
+                    try {
+                        const chunk = _d;
+                        chunks.push(chunk);
+                    }
+                    finally {
+                        _a = true;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_a && !_b && (_c = stream_1.return)) yield _c.call(stream_1);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            const out = Buffer.concat(chunks).toString('utf8');
+            return out;
+        }
+        catch (err) {
+            throw err;
+        }
+    });
+}
+var InteractionModes;
+(function (InteractionModes) {
+    InteractionModes["echo"] = "echo";
+    InteractionModes["toscript"] = "toscript";
+    InteractionModes["silent"] = "silent";
+})(InteractionModes || (InteractionModes = {}));
 class ConfigAdd extends command_base_enterprise_1.CommandBaseEnterprise {
+    constructor() {
+        super(...arguments);
+        /** CLI Command-line string to rerun this execution as a non-TTY script. */
+        this.cmd = ["cod", "config", "add", "--silent"];
+    }
+    // --------------------------------------------------------------------
+    // Lazy-loaded properties
+    get configUtils() {
+        if (this._configUtils_backer === undefined) {
+            this._configUtils_backer = this.ioc.get(config_ui_utils_1.ConfigUiUtils);
+        }
+        return this._configUtils_backer;
+    }
+    // --------------------------------------------------------------------
+    bootstrap() {
+        super.bootstrap();
+        this.ioc.bind(config_ui_utils_1.ConfigUiUtils).toSelf();
+    }
     run() {
         var _a;
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             try {
                 this.bootstrap();
-                const { args, flags } = yield this.parse(ConfigAdd);
+                yield this.readStdin();
                 (_a = this._relayContainer) === null || _a === void 0 ? void 0 : _a.ready$.subscribe((ready) => tslib_1.__awaiter(this, void 0, void 0, function* () {
-                    var _b, _c, _d;
-                    let partialConfigDef = {};
-                    let partialSetting = {};
-                    this._userCntx = yield this.establishTenantContext(this._userCntx);
-                    let enterprise = (yield this.establishEnterpriseContext()).enterprise;
-                    partialConfigDef.enterprise = enterprise.code;
-                    partialSetting.enterprise = enterprise.code;
-                    let rootMap = yield this.getRootMap(enterprise.code);
-                    let confirmed = false;
-                    do {
-                        // 1.  Select Asset
-                        partialConfigDef.asset = yield this.promptForAsset(enterprise.assets);
-                        // 2. Set Target File
-                        let selectedFile = (yield this.promptForTargetFile(partialConfigDef.enterprise, partialConfigDef.asset));
-                        partialConfigDef.targetFile = selectedFile.targetFile;
-                        partialConfigDef.settings = selectedFile.settings;
-                        // 3. Setting
-                        partialSetting.setting = yield this.promptForSetting((_b = partialConfigDef.settings) !== null && _b !== void 0 ? _b : [], (_c = args.setting) !== null && _c !== void 0 ? _c : flags.setting);
-                        let existingValues = (_d = partialConfigDef.settings) === null || _d === void 0 ? void 0 : _d.filter(s => s.setting === partialSetting.setting);
-                        // 4. Scope
-                        let selectedScope = yield this.promptForScope(partialConfigDef.enterprise, rootMap, existingValues);
-                        partialSetting.scope = selectedScope.scope;
-                        partialSetting.target = selectedScope.target;
-                        // 5. Value
-                        partialSetting.value = yield this.promptForValue({ setting: partialSetting.setting, scope: partialSetting.scope, target: partialSetting.target, enterprise: partialSetting.enterprise }, existingValues, rootMap);
-                        // 6. Confirm or loop back around to enterprise
-                        confirmed = yield this._ui.promptConfirm("confirm", "Apply? ");
-                    } while (!confirmed);
-                    let candidate = Object.assign({ setting: partialSetting.setting, value: partialSetting.value, targetFile: partialConfigDef.targetFile, asset: partialConfigDef.asset, enterprise: partialConfigDef.enterprise, scope: partialSetting.scope, target: partialSetting.target, description: partialSetting.description }, this.createAuditable());
-                    yield this.upsertSetting(candidate);
-                    /*
-                      MarkStartHere("NEW WORKFLOW...");
-              
-                      1. Prompt for Asset
-                        default = this._projUserCfg?.enterprise?.assetBindings?[0] ?? this._userCntx.currentEnterprise?.asset;
-                        let aCntx = await this.establishAssetContext(enterprise, true);
-                    
-                      2. Target File
-                        (select from existing or AddNEw option)
-                        if (addNew)
-                          freehand prompt with "?" as default (enter "?" to browse)
-                        enter rel path from container root (app root?)
-                       
-                      3. Setting
-                        select from existing
-                        if file selected, merge and dim
-                        (tree with "+newChild" at top of each branch)  (How do you prevent selection of branch vs leaf?)
-              
-                      4. Scope ("Where will it apply?")
-                        cabinet tree view with un-hydrated scopes dimmed, hydrated showing values
-                      
-                      5. Value
-                        (render pedigree)
-                        default = flags.value ?? selectedFile.value ?? existing.value
-              
-                      6. Confirm or loop back around to enterprise
-                    */
-                    // let cab = await this.establishCabinet(flags.cabinet, true);
-                    // let configName = flags.file || CodiacConstants.DEFAULT_APP_SETTINGS_FILENAME;
-                    // if (configName == PROMPT_ME_DESIGNATOR) {
-                    //   let confirmed = false;
-                    //   while (!confirmed) {
-                    //     // Step 1) select the distribution folder (aka: the build output folder)
-                    //     let folderOptions: FolderSelectionOptions = {
-                    //       root: this._projectRoot,
-                    //       startingPath: process.cwd(),
-                    //     };
-                    //     let distFolder = await this._ui.promptSelectFolder("distFolder", "Select the distribution folder (aka: the build output folder)...", folderOptions);
-                    //     // Step 2) select the config file within it.
-                    //     let options: FileSelectionOptions = {
-                    //       root: distFolder,
-                    //       startingPath: distFolder,
-                    //       extensions: ["json", "config", "yaml", "ini", "properties"],
-                    //       asRelative: true
-                    //     };
-                    //     configName = await this._ui.promptSelectFile("targetFile", "Select the target file...", options);
-                    //     confirmed = await this._ui.promptConfirm("targetFileCOnfirmation", `Target file: ${configName}`, true);
-                    //   }
-                    //   // this._ui.userMessage("Select the target file...")
-                    //   // let relativeTo = process.cwd();
-                    //   // let exts = ["json", "config", "yaml", "ini", "properties"];
-                    //   // let ptn = `\\.(${exts.join("|")})$`;
-                    //   // let rx = new RegExp(ptn, "i");
-                    //   // let options: any = { 
-                    //   //   multi: true, 
-                    //   //   clearConsole: false,
-                    //   //   root: this._projectRoot
-                    //   //   // fileFilter: (filename: string) => { return /\.(json|yaml|config|properties|ini)$/i.test(filename) }  });
-                    //   // }
-                    //   // options.fileFilter = (fileName: string) => rx.test(fileName);          
-                    //   // let fileResult = await selectFiles(options);
-                    //   // console.dir(fileResult);
-                    //   // if (fileResult.status == COMPLETED && fileResult.selectedFiles && fileResult.selectedFiles.length > 0) {
-                    //   //   let selected = fileResult.selectedFiles[0];
-                    //   //   let relPathName = path.relative(relativeTo, selected);
-                    //   //   this._ui.userMessage(`Selected file: ${relPathName}`);
-                    //   // }
-                    // }
-                    // // 1 Get the list of available built in system settings 
-                    // // stub:
-                    // this._appConfig = this._ops.loadConfig();
-                    // let avails = await this.getAvailableSettings();
-                    // // Prompt for setting if reqd
-                    // let setting: string = args.setting || flags.setting;
-                    // if (!setting) {
-                    //   let result = await inquirer.prompt({ type: 'list', name: 'setting', message: 'Setting to add:', choices: avails });
-                    //   setting = result.setting;
-                    // }
-                    // // this.log(result.setting);
-                    // // PROMPT FOR VALUE (if reqd)
-                    // let val: string;
-                    // if (flags.value) {
-                    //   val = flags.value;
-                    // } else {
-                    //   // TODO: this current value needs to support the scoped value set
-                    //   let currentValue = (this._appConfig) ? this._appConfig[setting] : undefined;
-                    //   let response = await inquirer.prompt({ type: 'input', name: 'settingValue', message: `Value for ${setting}: `, default: currentValue });
-                    //   val = response.settingValue;
-                    // }
-                    // if (flags.enterprise || flags.environment || flags.cabinet) {
-                    //   // WRITE SCOPED TO THE API
-                    //   let level: ScopeLevel = ScopeLevel.enterprise;
-                    //   let scopeName: string = "";
-                    //   if (flags.enterprise) {
-                    //     level = ScopeLevel.enterprise;
-                    //     scopeName = flags.enterprise;
-                    //   } else if (flags.environment) {
-                    //     level = ScopeLevel.environment;
-                    //     scopeName = flags.environment;
-                    //   } else if (flags.cabinet) {
-                    //     level = ScopeLevel.cabinet;
-                    //     scopeName = flags.cabinet;
-                    //   }
-                    //   this.writeSetting_Api(partialConfigDef.enterprise, partialConfigDef.asset, configName, setting, level, scopeName, val);
-                    // } else {
-                    //   // WRITE UNSCOPED TO LOCAL
-                    //   this.writeSetting_local(setting, val);
-                    // }
-                    // this.log(`Applied ${configName} setting "${setting}" = "${val}"`);
+                    try {
+                        // 0. SET DEFAULTS
+                        this._userCntx = yield this.establishTenantContext(this._userCntx);
+                        let enterprise = (yield this.establishEnterpriseContext()).enterprise;
+                        // 1. CAPTURE ARGS
+                        let [partial, interactionMode] = yield this.captureArgs(enterprise.code);
+                        // 2. ACQUIRE INPUT
+                        let rootMap = yield this.getRootMap(enterprise.code);
+                        let candidate;
+                        if (interactionMode == InteractionModes.silent) {
+                            candidate = this.buildCandidate_silently(partial, rootMap);
+                        }
+                        else {
+                            candidate = yield this.buildCandidate_interactively(partial, rootMap);
+                        }
+                        // In case we're hanging waiting for piped-in data that doesnt exist... 
+                        if (!process.stdin.destroyed)
+                            process.stdin.destroy();
+                        if (candidate == undefined) {
+                            this.logger.notice(`Operation cancelled. No work was done.`);
+                            this._ui.userMessage(`Operation cancelled. No work was done.`);
+                            this.exit(0);
+                        }
+                        else {
+                            // 3. RENDER COMMAND STRING
+                            if (interactionMode != undefined && [InteractionModes.echo, InteractionModes.toscript].includes(interactionMode)) {
+                                this.cmd = this.buildCommandString(candidate, this.cmd);
+                                this._ui.userMessage(this.cmd.join(" "));
+                            }
+                            if (interactionMode != InteractionModes.toscript) {
+                                // 4. EXECUTE THE MAIN TASK
+                                yield this.executeTask(candidate);
+                            }
+                        }
+                        return;
+                    }
+                    catch (err) {
+                        this.handleError(err);
+                        // dont rethrow - err handling in the observable isnt yet user-friendly.
+                    }
                 }));
             }
             catch (err) {
@@ -173,11 +134,149 @@ class ConfigAdd extends command_base_enterprise_1.CommandBaseEnterprise {
             }
         });
     }
-    promptForAsset(assets) {
+    captureArgs(currentEnterprise) {
+        var _a, _b, _c, _d, _e, _f, _g;
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // TODO: Move this into the base class
+            const { args, flags } = yield this.parse(ConfigAdd);
+            // TODO: Consider making this parse a separate abstract base method
+            // stdin
+            let inputDoc;
+            if (this.pipedInput) {
+                inputDoc = this.configUtils.parseInputString(this.pipedInput.trim());
+                this._ui.userMessage(`Found ${inputDoc.length} record(s) to add in the stdin pipeline.`);
+            }
+            let partial = { enterprise: currentEnterprise };
+            partial.asset = flags.asset;
+            if (flags.type) {
+                partial.configType = Object.values(config_ui_utils_1.SpecialConfigTypes).find(x => x.toString() == flags.type);
+                if (partial.configType == undefined)
+                    delete partial.configType;
+            }
+            else if (flags.file) {
+                partial.targetFile = flags.file;
+            }
+            partial.scope =
+                (_b = (_a = (flags['enterprise-scope'] ? codiac_relay_contracts_1.ScopeLevel.enterprise : undefined)) !== null && _a !== void 0 ? _a : (flags.enviro ? codiac_relay_contracts_1.ScopeLevel.environment : undefined)) !== null && _b !== void 0 ? _b : (flags.cabinet ? codiac_relay_contracts_1.ScopeLevel.cabinet : undefined);
+            partial.target =
+                (_d = (_c = (flags['enterprise-scope'] ? partial.enterprise : undefined)) !== null && _c !== void 0 ? _c : flags.enviro) !== null && _d !== void 0 ? _d : flags.cabinet;
+            if (flags.setting) {
+                partial.settings = [{ setting: flags.setting, value: flags.value }];
+            }
+            if (inputDoc != undefined) {
+                partial.settings = ((_e = partial.settings) !== null && _e !== void 0 ? _e : []).concat(inputDoc);
+            }
+            // partial.description = flags.description;
+            // TODO: move this into the base class
+            const interactionMode = (this.pipedInput) ? InteractionModes.silent : (_g = (_f = undefined !== null && undefined !== void 0 ? undefined : (flags.echo ? InteractionModes.echo : undefined)) !== null && _f !== void 0 ? _f : (flags["to-script"] ? InteractionModes.toscript : undefined)) !== null && _g !== void 0 ? _g : (flags.silent ? InteractionModes.silent : undefined);
+            return [partial, interactionMode];
+        });
+    }
+    parseTable(input, separator = ",") {
+        let output = [];
+        let lines = input
+            .split("\n")
+            .map(x => x.trim());
+        lines.shift();
+        lines.forEach(x => {
+            let parts = x.split(",").map(x => x.trim());
+            output.push({ setting: parts[0], value: parts[1] });
+        });
+        return output;
+    }
+    buildCandidate_silently(partial, rootMap) {
+        var _a;
+        try {
+            // VALIDATE / SET DEFAULTS
+            if (partial.asset == undefined || _.isEmpty(partial.asset))
+                throw new Error(`Invalid input: missing asset name.`);
+            if (partial.enterprise == undefined || _.isEmpty(partial.enterprise)) {
+                // Derive the one OR throw if it's indeterminate
+                let assetParents = rootMap.enterprises.filter(e => e.assets.find(a => a.name == partial.asset));
+                if (assetParents.length == 1) {
+                    partial.enterprise = assetParents[0].name;
+                }
+                else if (assetParents.length > 1) {
+                    throw new Error(`Invalid input: missing enterprise.`);
+                }
+            }
+            if (partial.targetFile == undefined && partial.configType == undefined)
+                throw new Error("Invalid input: Must specify the file or type.");
+            // Validate scope/target
+            if (partial.scope == undefined || _.isEmpty(partial.scope)) {
+                throw new Error(`Invalid input: scope required.  Please set --enterprise-scope, --enviro, or --cabinet.`);
+            }
+            else if (!(Object.keys(codiac_relay_contracts_1.ScopeLevel)).includes(partial.scope)) {
+                throw new Error(`Invalid input: invalid scope level. Please set --enterprise-scope, --enviro, or --cabinet.`);
+            }
+            if (partial.scope == codiac_relay_contracts_1.ScopeLevel.enterprise) {
+                // This code should never get reached.  Its just here for completeness.
+                if ((partial.target != undefined || _.isEmpty(partial.target)) && (partial.target != partial.enterprise))
+                    throw new Error(`Invalid input: scope target for enterprise scope should match the enterprise.`);
+            }
+            else if (partial.target == undefined || _.isEmpty(partial.target)) {
+                throw new Error(`Invalid input: missing scope target. Please set --enterprise-scope, --enviro, or --cabinet.`);
+            }
+            else if ((0, config_ui_utils_1.findScopeTarget)(rootMap, partial.scope, partial.target) == undefined) {
+                throw new Error(`Invalid input: the given ${partial.scope} was not found.`);
+            }
+            if (partial.settings == undefined || partial.settings.length == 0)
+                throw new Error(`Invalid input: missing setting name/value.`);
+            // if (partial.setting == undefined || _.isEmpty(partial.setting)) throw new Error(`Invalid input: missing setting name.`)
+            if (partial.settings[0].value == undefined || _.isEmpty(partial.settings[0].value))
+                throw new Error(`Invalid input: missing setting value.`);
+            let output = Object.assign({ enterprise: partial.enterprise, asset: partial.asset, scope: (_a = partial.scope) !== null && _a !== void 0 ? _a : codiac_relay_contracts_1.ScopeLevel.enterprise, target: partial.target, targetFile: (partial.targetFile) ? partial.targetFile : `[${partial.configType}]`, settings: partial.settings, 
+                // setting: partial.setting,
+                // value: partial.value,
+                description: partial.description }, this.createAuditable());
+            return output;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    buildCandidate_interactively(partial, rootMap) {
+        var _a;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            let output;
             try {
-                let choices = assets.map(a => { return { name: a.name, value: a.name }; });
-                let output = (yield this._ui.promptSelect("asset", "Asset: ", choices));
+                let partialConfigDef = {};
+                partialConfigDef.enterprise = partial.enterprise;
+                let enterprise = rootMap.enterprises.find(e => e.name == partial.enterprise);
+                if (enterprise == undefined)
+                    throw new Error("Invalid enterprise"); // <--- here just for TS - shd never get hit (if it hit, itd be guaranteed to confuse the user).
+                let confirmed = false;
+                do {
+                    // 1.  Select Asset
+                    let assetChanged;
+                    [partialConfigDef.asset, assetChanged] = yield this.configUtils.promptForAsset(enterprise.assets, partial.asset);
+                    // 2. Set Target File
+                    let selectedFile = (yield this.promptForTargetFile(partial.enterprise, partialConfigDef.asset));
+                    partialConfigDef.targetFile = selectedFile.targetFile;
+                    partialConfigDef.settings = selectedFile.settings;
+                    // 3. Setting
+                    let settingName;
+                    let value;
+                    let instances;
+                    if (partial.settings != undefined && partial.settings.length > 0) {
+                        settingName = partial.settings[0].setting;
+                        value = partial.settings[0].value;
+                    }
+                    [settingName, instances] = yield this.configUtils.promptForOneSetting((_a = partialConfigDef.settings) !== null && _a !== void 0 ? _a : [], "write", settingName);
+                    // 4. Scope
+                    let selectedScope = yield this.promptForScope(partialConfigDef.enterprise, rootMap, instances);
+                    partial.scope = selectedScope.scope;
+                    partial.target = selectedScope.target;
+                    // 5. Value
+                    value = yield this.promptForValue({ setting: settingName, value: value, scope: partial.scope, target: partial.target, enterprise: partial.enterprise }, instances, rootMap);
+                    partial.settings = [{ setting: settingName, value: value }];
+                    // 6. Confirm or loop back around to enterprise
+                    confirmed = yield this._ui.promptConfirm("confirm", "Apply? ");
+                } while (!confirmed);
+                output = Object.assign({ 
+                    // setting: partial.setting,
+                    // value: partial.value,
+                    settings: partial.settings, targetFile: partialConfigDef.targetFile, asset: partialConfigDef.asset, enterprise: partialConfigDef.enterprise, scope: partial.scope, target: partial.target, description: partial.description }, this.createAuditable());
                 return output;
             }
             catch (err) {
@@ -185,6 +284,50 @@ class ConfigAdd extends command_base_enterprise_1.CommandBaseEnterprise {
             }
         });
     }
+    buildCommandString(ultimate, cmd) {
+        cmd.push("--enterprise", ultimate.enterprise);
+        cmd.push("-a", ultimate.asset);
+        if (ultimate.configType) {
+            cmd.push("-t", ultimate.configType);
+        }
+        else {
+            cmd.push("-f", ultimate.targetFile); // assertion is ok bc we forced one or the other just above ^.
+        }
+        if (ultimate.scope) {
+            if (ultimate.scope == codiac_relay_contracts_1.ScopeLevel.enterprise) {
+                cmd.push("--enterprise-scope");
+            }
+            else if (ultimate.target) {
+                if (ultimate.scope == codiac_relay_contracts_1.ScopeLevel.environment)
+                    cmd.push("-e", ultimate.target);
+                if (ultimate.scope == codiac_relay_contracts_1.ScopeLevel.cabinet)
+                    cmd.push("-c", ultimate.target);
+            }
+        }
+        // NOTE:  We can't provide for multiple settings in the cli.
+        // Unless: 
+        // a) we allow multple --setting args and use the --setting "key=value" syntax 
+        // OR b) we send them back a command string that pipes the settings in
+        if (ultimate.settings && ultimate.settings.length > 0) {
+            // for (let setting of ultimate.settings) {
+            let setting = ultimate.settings[0];
+            if (ultimate.settings[0].setting)
+                cmd.push("--setting", setting.setting);
+            if (ultimate.settings[0].value)
+                cmd.push("--value", setting.value);
+            // }
+        }
+        return cmd;
+    }
+    // private async promptForAsset(assets: AtLeast<Asset, "name">[]): Promise<string> {
+    //   try {
+    //     let choices = assets.map(a => { return { name: a.name, value: a.name }; })
+    //     let output = (await this._ui.promptSelect("asset", "Asset: ", choices))!;
+    //     return output;
+    //   } catch (err) {
+    //     throw err;
+    //   }
+    // }
     promptForValue(setting, existingValues, rootMap) {
         var _a;
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -341,52 +484,6 @@ class ConfigAdd extends command_base_enterprise_1.CommandBaseEnterprise {
         }
         return output;
     }
-    /**
-     *
-     * Use this inquirer plugin for navigating the object structure:
-     *    https://github.com/insightfuls/inquirer-tree-prompt
-     *
-     * See if this file tree selector could be fashioned to do the same:
-     *    https://github.com/anc95/inquirer-file-tree-selection
-     *
-     * @param existing
-     * @param defaultSetting
-     */
-    promptForSetting(existing, defaultSetting) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                let setting;
-                // TODO: render a tree of settings (cant select the branches, just the leaf nodes)
-                if (existing.length > 0) {
-                    // let choices = existing.map(s => { return { name: s.setting, value: s.setting }; });
-                    let choices = _.uniq(existing.map(s => s.setting));
-                    choices.push(CodiacConstants.CliConstants.CHOICE_VALUE_FOR_NEW);
-                    setting = (yield this._ui.promptSelect("settingSelect", "Setting: ", choices));
-                }
-                if (setting === CodiacConstants.CliConstants.CHOICE_VALUE_FOR_NEW || setting === undefined) {
-                    setting = (yield this._ui.prompt("settingFreehand", "Setting (use '.' for hierarchy): "));
-                }
-                if (existing.find(s => s.setting === setting)) {
-                    // matched an existing setting afterall
-                }
-                // ----------------------------------------------------------------------------------------------
-                // // Try to implement un-selectable options...
-                // let settings = ["bill", "sam", "tom", "harry"];
-                // let choices: any[] = settings.map(s => { return { name: s, value: s }; });
-                // // choices.push({ name: "some branch", value: new inquirer.Separator("--I am a branch") });
-                // choices.push(new inquirer.Separator("--I am a branch"));
-                // choices.push({ name: "sally", value: "sally" });
-                // choices.push({ name: "Sue", value: "Sue" });
-                // choices.push({ name: "Suzy", value: "Suzy" });
-                // let nada = await this._ui.promptSelect("test", "try this", choices);
-                // ----------------------------------------------------------------------------------------------
-                return setting;
-            }
-            catch (err) {
-                throw err;
-            }
-        });
-    }
     /** Copy of this method is in config:view */
     promptForTargetFile(enterprise, asset) {
         var _a, _b;
@@ -460,14 +557,28 @@ class ConfigAdd extends command_base_enterprise_1.CommandBaseEnterprise {
             }
         });
     }
-    writeSetting_Api(enterprise, assetName, configName, setting, scopeLevel, scopeName, val) {
+    // async writeSetting_Api(enterprise: string, assetName: string, configName: string, setting: string, scopeLevel: ScopeLevel, scopeName: string, val: any): Promise<void> {
+    //   try {
+    //     let settingObj: ScopedSetting = {
+    //       setting: setting,
+    //       value: val,
+    //       targetFile: configName,
+    //       asset: assetName,
+    //       enterprise: enterprise,
+    //       scope: scopeLevel,
+    //       target: scopeName,
+    //       ...this.createAuditable()
+    //     };
+    //     return this.upsertSetting(settingObj);
+    //   } catch (err) {
+    //     throw err;
+    //   }
+    // }
+    executeTask(candidate) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                let settingObj = Object.assign({ setting: setting, value: val, targetFile: configName, asset: assetName, enterprise: enterprise, scope: scopeLevel, target: scopeName }, this.createAuditable());
-                return this.upsertSetting(settingObj);
-            }
-            catch (err) {
-                throw err;
+            // TODO: Do this in a single batch call
+            for (let setting of candidate.settings) {
+                yield this.upsertSetting(Object.assign(Object.assign({}, candidate), { setting: setting.setting, value: setting.value }));
             }
         });
     }
@@ -475,12 +586,6 @@ class ConfigAdd extends command_base_enterprise_1.CommandBaseEnterprise {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
                 try {
-                    // TODO:  Look to enterprise context instead.
-                    // let enterprise = /* this._cfg.enterprise || */ this._projCfg.tenantCode;  
-                    // TODO: Look to asset context instead - and if none, fail and call for "$ cod asset:set"
-                    // let assetName = this._projCfg.name;  // this needs to be taken from an image definition.  (AssetBinding[] needs to be added to each ImageExport)
-                    // NOTE:  We could bind a config to an image name, 
-                    //        and then allow for an Asset scope to set values on it...
                     let crit = {
                         enterprise: settingObj.enterprise,
                         asset: settingObj.asset,
@@ -547,14 +652,21 @@ ConfigAdd.description = 'Adds a key value pair to the app config';
 ConfigAdd.aliases = ['config:set', 'cfg:add'];
 ConfigAdd.flags = {
     help: core_1.Flags.help({ char: 'h' }),
-    setting: core_1.Flags.string({ char: 's', required: false, description: "The config key (in dotpath/JSONPath), relative to the root of the config." }),
-    value: core_1.Flags.string({ char: 'v', required: false, description: "The actual concrete data to be applied as the setting value." }),
-    enterprise: core_1.Flags.string({ char: 'n', exclusive: ["environment", "cabinet"], description: 'The name of the enterprise to which this value is to apply.' }),
-    environment: core_1.Flags.string({ char: 'e', exclusive: ["enterprise", "cabinet"], description: 'The name of the environment to which this value is to apply.' }),
-    cabinet: core_1.Flags.string({ char: 'c', exclusive: ["enterprise", "environment"], description: 'The name of the cabinet to which this value is to apply.' }),
-    file: core_1.Flags.string({ char: 'f', description: 'The path-name to the file to which the settings are written, relative to the root of the Codiac project.' })
+    enterprise: core_1.Flags.string({ char: 'n', description: '(required only when more than one enterprise exists) The name of the enterprise containing the asset.' }),
+    asset: core_1.Flags.string({ char: 'a', description: 'The name of the asset to which the settings belong.' }),
+    file: core_1.Flags.string({ char: 'f', description: 'The path-name to the file to which the settings are written, relative to the root of the Codiac project.' }),
+    type: core_1.Flags.string({ char: 't', exclusive: ["file"], options: Object.keys(config_ui_utils_1.SpecialConfigTypes), description: 'Filters for the settings types that do not land in a config file (such as... env: OS environment variables, footprint: container footprint specs, and helm: helm chart settings).' }),
+    "enterprise-scope": core_1.Flags.boolean({ char: 's', exclusive: ["enviro", "cabinet"], description: 'Filters for settings scoped at the enterprise level.' }),
+    enviro: core_1.Flags.string({ char: 'e', exclusive: ["enterprise-scope", "cabinet"], description: 'The name of the environment to which this value is to apply.' }),
+    cabinet: core_1.Flags.string({ char: 'c', exclusive: ["enterprise-scope", "enviro"], description: 'The name of the cabinet to which this value is to apply.' }),
+    setting: core_1.Flags.string({ required: false, description: "The config key (in dotpath/JSONPath), relative to the root of the config." }),
+    value: core_1.Flags.string({ required: false, description: "The actual concrete data to be applied as the setting value." }),
+    silent: core_1.Flags.boolean({ exclusive: ["echo", "to-script"], description: 'Non-Interactive mode; executes without any user interaction and fails on any missing or invalid arguments.' }),
+    echo: core_1.Flags.boolean({ exclusive: ["to-script", "silent"], description: 'Echo interaction mode; renders the equivalent non-interactive cli command for future use before final execution.' }),
+    "to-script": core_1.Flags.boolean({ exclusive: ["echo", "silent"], description: 'Toscript interaction mode; renders the equivalent non-interactive cli command WITHOUT any execution.' }),
+    // "take-defaults": Flags.boolean({ exclusive: ["silent"], description: "Prevents prompting for confirmation on parameters that were passed in or were set to default values." }),
 };
 ConfigAdd.args = {
-    setting: core_1.Args.string({ description: 'The key for the config setting to add' })
+// setting: Args.string({ description: 'The key for the config setting to add' })
 };
 //# sourceMappingURL=add.js.map