@codiac.io/codiac-cli 1.2.219 → 1.2.222

package/dist/commands/config/add.js

@@ -1,560 +1,685 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROMPT_ME_DESIGNATOR = void 0;
-const tslib_1 = require("tslib");
-//import * as path from 'path';
-const core_1 = require("@oclif/core");
-const _ = require("lodash");
-const codiac_relay_contracts_1 = require("@codiac.io/codiac-relay-contracts");
-// import { Asset, ConfigDef, ConfigDefCriteria, ConfigDefTypesEnum, RootMap, ScopedSetting, ScopedSettingCriteria } from '@codiac.io/codiac-domain';
-const contracts_1 = require("../../apis/codiac-api/contracts");
-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 { 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 = "?";
-class ConfigAdd extends command_base_enterprise_1.CommandBaseEnterprise {
-    run() {
-        var _a;
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                this.bootstrap();
-                const { args, flags } = yield this.parse(ConfigAdd);
-                (_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}"`);
-                }));
-            }
-            catch (err) {
-                this.handleError(err);
-                throw err;
-            }
-        });
-    }
-    promptForAsset(assets) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                let choices = assets.map(a => { return { name: a.name, value: a.name }; });
-                let output = (yield 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* () {
-            // let existingValues = partialConfigDef.settings?.filter(s => s.setting === setting.setting);
-            let pedigree = this.buildPedigreeFor(setting, existingValues, rootMap);
-            let renderPedigree = (pedigree) => {
-                if (pedigree === null || pedigree === void 0 ? void 0 : pedigree.parent)
-                    renderPedigree(pedigree.parent);
-                if (pedigree.value !== undefined) {
-                    this._ui.userMessage(`[in ${pedigree.scope}: ${pedigree.target}] = ${(pedigree.value === "") ? "\"\"" : pedigree.value}`);
-                }
-            };
-            if (setting.description)
-                this._ui.userMessage(setting.description);
-            if (pedigree)
-                renderPedigree(pedigree);
-            let existing = existingValues === null || existingValues === void 0 ? void 0 : existingValues.find(s => s.scope === setting.scope && s.target === setting.target);
-            let output = yield this._ui.prompt("value", `Value in ${setting.scope} ${setting.target}: `, false, (_a = setting.value) !== null && _a !== void 0 ? _a : existing === null || existing === void 0 ? void 0 : existing.value);
-            return output;
-        });
-    }
-    /** Returns the recursive parent path of values for the given setting
-     *  up through the enterprise scope.
-     *  Returns undefined if the given setting is already scoped to enterprise.
-     *
-     * @param existingValues This MUST be filtered for this current setting (existing.setting == setting.setting).
-     * */
-    buildPedigreeFor(setting, existingValues, rootMap) {
-        try {
-            let pedigree;
-            if (setting.scope !== codiac_relay_contracts_1.ScopeLevel.enterprise) {
-                let ent = rootMap.enterprises.find(e => e.name === setting.enterprise);
-                if (ent == undefined) {
-                    throw new Error(`No enterprise found named [${setting.enterprise}]`);
-                }
-                let entSetting = existingValues === null || existingValues === void 0 ? void 0 : existingValues.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.enterprise && s.target === ent.name);
-                let entPedigree = { scope: codiac_relay_contracts_1.ScopeLevel.enterprise, target: setting.enterprise };
-                if (entSetting === null || entSetting === void 0 ? void 0 : entSetting.value) {
-                    entPedigree.value = entSetting.value;
-                }
-                if (setting.scope === codiac_relay_contracts_1.ScopeLevel.cabinet) {
-                    let env = ent === null || ent === void 0 ? void 0 : ent.environments.find(e => e.cabinets.find(c => c.name === setting.target));
-                    if (!env) {
-                        throw new Error(`No environment found containing the cabinet [${setting.target}]`);
-                    }
-                    pedigree = { scope: codiac_relay_contracts_1.ScopeLevel.environment, target: env.name, parent: entPedigree };
-                    let envSetting = existingValues === null || existingValues === void 0 ? void 0 : existingValues.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.environment && s.target === (env === null || env === void 0 ? void 0 : env.name));
-                    if (envSetting) {
-                        pedigree.value = envSetting.value;
-                    }
-                }
-                else if (setting.scope === codiac_relay_contracts_1.ScopeLevel.environment) {
-                    pedigree = entPedigree;
-                }
-            }
-            return pedigree;
-        }
-        catch (err) {
-            throw err;
-        }
-    }
-    promptForScope(enterprise, rootMap, existings) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                let output;
-                // render cab tree with all lines selectable
-                let cabTree = this.buildCabinetTree(rootMap, existings);
-                let choices = this.buildSelectChoicesFrom(cabTree);
-                let delimited = (yield this._ui.promptSelect("scope", "Apply to: ", choices, undefined, false));
-                let parts = delimited.split("|");
-                output = { scope: parts[0], target: parts[1] };
-                return output;
-            }
-            catch (err) {
-                throw (err);
-            }
-        });
-    }
-    buildSelectChoicesFrom(tree) {
-        try {
-            let choices = [];
-            // the value is no good here - need scope and target both available
-            render.renderStringTree(tree, (txt, item) => choices.push({ name: txt, value: item.value }));
-            // // This is one way to do it
-            // for (let item of tree) {
-            // 
-            //   let thisChoice: PromptChoice = { name: item.text, value: item.text };
-            //   choices.push(thisChoice);
-            // 
-            //   if (item.children && item.children.length > 0) {
-            //     let children = this.buildSelectChoicesFrom(item.children);
-            //     choices.push(...children);
-            //   }
-            // }
-            return choices;
-        }
-        catch (err) {
-            throw err;
-        }
-    }
-    /** sets each value to "scope|target".
-     *
-     * This is MOSTLY a COPY-PASTE from the CabinetList command!!!  This view is prob gonna be pretty common - consider promoting it to a shared utility. */
-    buildCabinetTree(rootMap, existings) {
-        var _a, _b, _c, _d;
-        let tree = [];
-        for (let ent of rootMap.enterprises) {
-            let entBranch = { text: `${ent.name} enterprise:`, value: `${codiac_relay_contracts_1.ScopeLevel.enterprise}|${ent.name}` };
-            let entSetting = existings === null || existings === void 0 ? void 0 : existings.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.enterprise && s.target === ent.name);
-            if (entSetting !== undefined) {
-                let valueSuffix = this.ellipsis(35, (_a = entSetting.value) !== null && _a !== void 0 ? _a : "[set to undefined]");
-                valueSuffix = `(${valueSuffix})`;
-                entBranch.text = entBranch.text.concat(" ", this._styler.dim(valueSuffix));
-            }
-            for (let env of _.sortBy(ent.environments, e => e.sequence, e => e.name)) {
-                let envBranch = { text: `${env.name}`, value: `${codiac_relay_contracts_1.ScopeLevel.environment}|${env.name}` };
-                let envSetting = existings === null || existings === void 0 ? void 0 : existings.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.environment && s.target === env.name);
-                if (envSetting !== undefined) {
-                    let valueSuffix = this.ellipsis(35, (_b = envSetting.value) !== null && _b !== void 0 ? _b : "[set to undefined]");
-                    valueSuffix = `(${valueSuffix})`;
-                    envBranch.text = envBranch.text.concat(" ", this._styler.dim(valueSuffix));
-                }
-                for (let cab of env.cabinets) {
-                    // let cwg = rootMap.clusters.find(c => c.name === cab.cluster);
-                    // let clusterDesc = cwg ? ` (${cab.cluster}, ${cwg.provider} ${cwg.locationName})` : "";
-                    let cabBranch = {
-                        text: `${cab.name}`,
-                        value: `${codiac_relay_contracts_1.ScopeLevel.cabinet}|${cab.name}`
-                    };
-                    let cabSetting = existings === null || existings === void 0 ? void 0 : existings.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.cabinet && s.target === cab.name);
-                    if (cabSetting !== undefined) {
-                        let valueSuffix = this.ellipsis(35, (_c = cabSetting.value) !== null && _c !== void 0 ? _c : "[set to undefined]");
-                        valueSuffix = `(${valueSuffix})`;
-                        cabBranch.text = cabBranch.text.concat(" ", this._styler.dim(valueSuffix));
-                    }
-                    if (envBranch.children === undefined)
-                        envBranch.children = [];
-                    (_d = envBranch.children) === null || _d === void 0 ? void 0 : _d.push(cabBranch);
-                }
-                if (entBranch.children === undefined)
-                    entBranch.children = [];
-                entBranch.children.push(envBranch);
-            }
-            tree.push(entBranch);
-        }
-        return tree;
-    }
-    /** Truncates the string to the given length with an ellipses as suffix */
-    ellipsis(maxLength, value) {
-        let output = value;
-        if (output.length > maxLength) {
-            let ellipsis = "..."; // Rather use the ellipsis character but String.fromCharCode(133) is returning a problematic character.
-            output = output.slice(0, maxLength - 1 - ellipsis.length).concat(ellipsis);
-        }
-        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;
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                let crit = {
-                    asset: asset,
-                    enterprise: enterprise,
-                    type: contracts_1.ConfigDefTypesEnum.file
-                };
-                let cfgResult = yield this._codiacApi.Call.getConfigDefs(crit, { projection: { pathsExcluded: [], pathsIncluded: ["settings", "targetFile", "format"] } });
-                if (cfgResult.error)
-                    throw cfgResult.error;
-                let configs = (_a = cfgResult.output) !== null && _a !== void 0 ? _a : [];
-                let choices = configs.map(c => { return { name: c.targetFile, value: c.targetFile }; });
-                choices.push({ name: CodiacConstants.CliConstants.CHOICE_VALUE_FOR_NEW, value: CodiacConstants.CliConstants.CHOICE_VALUE_FOR_NEW });
-                let output; // Pick<ConfigDef, "targetFile" | "settings">; 
-                let settingsInLocalFile;
-                let selected = (yield this._ui.promptSelect("fileExisting", "File: ", choices));
-                if (selected === CodiacConstants.CliConstants.CHOICE_VALUE_FOR_NEW) {
-                    selected = (yield this._ui.prompt("filefreehand", "Path from image root: ('?' to browse): "));
-                    if (selected === "?") {
-                        let localPath = (yield this._ui.promptSelectFile("filebrowse", "Select file: ", { asRelative: true }));
-                        settingsInLocalFile = yield this.extractSettingsFromFile(localPath);
-                        let filename = path.basename(localPath);
-                        let pathInImage = path.dirname(localPath);
-                        this._ui.userMessage(`Target file: ${this._styler.hilite(filename)}`);
-                        pathInImage = (yield this._ui.prompt("pathinimage", "Path from image root: ", true, pathInImage));
-                        selected = path.posix.join(pathInImage, filename);
-                    }
-                    else {
-                        // the user free-handed the targetFile field
-                        // this._ui.userMessage(`Target file: ${this._styler.hilite(selected)}`);
-                    }
-                }
-                output = {
-                    targetFile: selected,
-                    settings: (_b = configs.find(c => c.targetFile === selected)) === null || _b === void 0 ? void 0 : _b.settings, // in case it matches a config we pulled down 
-                };
-                return output;
-            }
-            catch (err) {
-                throw err;
-            }
-        });
-    }
-    extractSettingsFromFile(relativeFilePath) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                let output = [];
-                // gotta determmine the file format and parse it.  
-                // This logic prob needs to come from the domain or from the relay.
-                /** let format = getDefaultDataFormat(localPath);
-                 *  let extracted: Object | undefined;
-                 *  do {
-                 *    try {
-                 *      format = format ?? (await this.promptForFormat());
-                 *      extracted = tryDeserialize(file, format);
-                 *    } catch(err) {
-                 *      this._ui.UserMessage(`Error parsing as ${format}: ${err.message ?? ""}`);
-                 *      format = undefined;
-                 *    }
-                 *  } while (!extracted);
-                 *
-                 *  output = this.convertToStringParents(extracted);
-                 */
-                return output;
-            }
-            catch (err) {
-                throw err;
-            }
-        });
-    }
-    writeSetting_Api(enterprise, assetName, configName, setting, scopeLevel, scopeName, val) {
-        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;
-            }
-        });
-    }
-    upsertSetting(settingObj) {
-        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,
-                        targetFile: settingObj.targetFile,
-                        scope: settingObj.scope,
-                        target: settingObj.target,
-                        setting: settingObj.setting
-                    };
-                    // TODO:  Replace this with an upsert based on:  enterprise, asset, configName, scopeLevel, scopeName, and setting
-                    let check = yield this._codiacApi.ScopedSetting.tryReadMany(crit);
-                    let resultSetting;
-                    if (check.success && check.output && check.output.length > 0) {
-                        settingObj.id = check.output[0].id;
-                        resultSetting = yield this._codiacApi.ScopedSetting.tryUpdate(settingObj);
-                    }
-                    else {
-                        resultSetting = yield this._codiacApi.ScopedSetting.tryCreate(settingObj);
-                    }
-                    if (resultSetting.success) {
-                        this.logger.notice(`Successfully saved setting [${settingObj.setting}] for ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
-                        this._ui.userMessage(`Successfully saved setting [${settingObj.setting}] for ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
-                    }
-                    else if (resultSetting.error) {
-                        this.logger.error(`Error saving setting [${settingObj.setting}]: ${resultSetting.message || ""}; ${resultSetting.error.message || resultSetting.error.stack}; For ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
-                        this._ui.userMessage(`Error saving setting [${settingObj.setting}]: ${resultSetting.message || ""}; ${resultSetting.error.message || resultSetting.error.stack}; For ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
-                    }
-                    else {
-                        this.logger.warn(`Failed without error to save setting [${settingObj.setting}]: ${resultSetting.message || ""}; For ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
-                        this._ui.userMessage(`Failed without error to save setting [${settingObj.setting}]: ${resultSetting.message || ""}; For ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
-                    }
-                    resolve();
-                }
-                catch (err) {
-                    reject(err);
-                }
-            }));
-        });
-    }
-    writeSetting_local(setting, value) {
-        // Write the available setting
-        if (!this._appConfig) {
-            this._appConfig = {};
-        }
-        _.set(this._appConfig, setting, value);
-        // this._appConfig[setting] = val.settingValue;
-        this._ops.writeConfig(this._appConfig);
-    }
-    /** Retrieves the list of app config settings that are not yet explicitly declared in the app config file itself */
-    getAvailableSettings() {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let avails = this._ops.loadConfigKeys(this.config.root);
-            let unset = avails;
-            // Remove any settings already explicitly called from the app-config.
-            if (this._appConfig) {
-                let keys = _.keys(this._appConfig);
-                unset = _.pull(avails, ...keys);
-            }
-            return unset;
-        });
-    }
-}
-exports.default = ConfigAdd;
-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.' })
-};
-ConfigAdd.args = {
-    setting: core_1.Args.string({ description: 'The key for the config setting to add' })
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMPT_ME_DESIGNATOR = void 0;
+const tslib_1 = require("tslib");
+//import * as path from 'path';
+const core_1 = require("@oclif/core");
+const _ = require("lodash");
+const codiac_relay_contracts_1 = require("@codiac.io/codiac-relay-contracts");
+// import { Asset, ConfigDef, ConfigDefCriteria, ConfigDefTypesEnum, RootMap, ScopedSetting, ScopedSettingCriteria } from '@codiac.io/codiac-domain';
+const contracts_1 = require("../../apis/codiac-api/contracts");
+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();
+                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* () {
+                    try {
+                        // 0. SET DEFAULTS
+                        this._userCntx = yield this.establishTenantContext(this._userCntx);
+                        let enterprise = (yield this.establishEnterpriseContext()).enterprise;
+                        // 1. CAPTURE ARGS
+                        let [partial, interactionMode, takeDefaults] = 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, takeDefaults);
+                        }
+                        // 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) {
+                this.handleError(err);
+                throw err;
+            }
+        });
+    }
+    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);
+            const takeDefaults = flags['take-defaults'];
+            return [partial, interactionMode, takeDefaults];
+        });
+    }
+    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, takeDefaults = false) {
+        var _a;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            let output;
+            try {
+                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 = (await this.promptForTargetFile(partial.enterprise, partialConfigDef.asset))!;
+                    // partialConfigDef.targetFile = selectedFile.targetFile;
+                    // partialConfigDef.settings = selectedFile.settings;
+                    let typeFileChanged;
+                    // let existingSettings: ScopedSetting[] | undefined;
+                    [partial.configType, partialConfigDef.targetFile, partialConfigDef.settings, typeFileChanged] = yield this.configUtils.promptForTypeAndFile(partial.enterprise, partialConfigDef.asset, partial.configType, partial.targetFile, undefined, true, takeDefaults); // TakeDefaults will never apply bc we're allowing addNew (are these always mutally exclusive?)
+                    // 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 targetChanged = false;
+                    [partial.scope, partial.target, targetChanged] = yield this.configUtils.validateAndPromptForScope(rootMap, partialConfigDef.enterprise, partial.scope, partial.target, instances, false);
+                    partial.scope = partial.scope; // assertion operator is ok here bc we disabled AllowEverywhere in the method above
+                    partial.target = partial.target; // assertion operator is ok here bc we disabled AllowEverywhere in the method above
+                    // 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, configType: partial.configType, asset: partialConfigDef.asset, enterprise: partialConfigDef.enterprise, scope: partial.scope, target: partial.target, description: partial.description }, this.createAuditable());
+                return output;
+            }
+            catch (err) {
+                throw err;
+            }
+        });
+    }
+    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* () {
+            // let existingValues = partialConfigDef.settings?.filter(s => s.setting === setting.setting);
+            let pedigree = this.buildPedigreeFor(setting, existingValues, rootMap);
+            let renderPedigree = (pedigree) => {
+                if (pedigree === null || pedigree === void 0 ? void 0 : pedigree.parent)
+                    renderPedigree(pedigree.parent);
+                if (pedigree.value !== undefined) {
+                    this._ui.userMessage(`[in ${pedigree.scope}: ${pedigree.target}] = ${(pedigree.value === "") ? "\"\"" : pedigree.value}`);
+                }
+            };
+            if (setting.description)
+                this._ui.userMessage(setting.description);
+            if (pedigree)
+                renderPedigree(pedigree);
+            let existing = existingValues === null || existingValues === void 0 ? void 0 : existingValues.find(s => s.scope === setting.scope && s.target === setting.target);
+            let output = yield this._ui.prompt("value", `Value in ${setting.scope} ${setting.target}: `, false, (_a = setting.value) !== null && _a !== void 0 ? _a : existing === null || existing === void 0 ? void 0 : existing.value);
+            return output;
+        });
+    }
+    /** Returns the recursive parent path of values for the given setting
+     *  up through the enterprise scope.
+     *  Returns undefined if the given setting is already scoped to enterprise.
+     *
+     * @param existingValues This MUST be filtered for this current setting (existing.setting == setting.setting).
+     * */
+    buildPedigreeFor(setting, existingValues, rootMap) {
+        try {
+            let pedigree;
+            if (setting.scope !== codiac_relay_contracts_1.ScopeLevel.enterprise) {
+                let ent = rootMap.enterprises.find(e => e.name === setting.enterprise);
+                if (ent == undefined) {
+                    throw new Error(`No enterprise found named [${setting.enterprise}]`);
+                }
+                let entSetting = existingValues === null || existingValues === void 0 ? void 0 : existingValues.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.enterprise && s.target === ent.name);
+                let entPedigree = { scope: codiac_relay_contracts_1.ScopeLevel.enterprise, target: setting.enterprise };
+                if (entSetting === null || entSetting === void 0 ? void 0 : entSetting.value) {
+                    entPedigree.value = entSetting.value;
+                }
+                if (setting.scope === codiac_relay_contracts_1.ScopeLevel.cabinet) {
+                    let env = ent === null || ent === void 0 ? void 0 : ent.environments.find(e => e.cabinets.find(c => c.name === setting.target));
+                    if (!env) {
+                        throw new Error(`No environment found containing the cabinet [${setting.target}]`);
+                    }
+                    pedigree = { scope: codiac_relay_contracts_1.ScopeLevel.environment, target: env.name, parent: entPedigree };
+                    let envSetting = existingValues === null || existingValues === void 0 ? void 0 : existingValues.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.environment && s.target === (env === null || env === void 0 ? void 0 : env.name));
+                    if (envSetting) {
+                        pedigree.value = envSetting.value;
+                    }
+                }
+                else if (setting.scope === codiac_relay_contracts_1.ScopeLevel.environment) {
+                    pedigree = entPedigree;
+                }
+            }
+            return pedigree;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    promptForScope(enterprise, rootMap, existings) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                let output;
+                // render cab tree with all lines selectable
+                let cabTree = this.buildCabinetTree(rootMap, existings);
+                let choices = this.buildSelectChoicesFrom(cabTree);
+                let delimited = (yield this._ui.promptSelect("scope", "Apply to: ", choices, undefined, false));
+                let parts = delimited.split("|");
+                output = { scope: parts[0], target: parts[1] };
+                return output;
+            }
+            catch (err) {
+                throw (err);
+            }
+        });
+    }
+    buildSelectChoicesFrom(tree) {
+        try {
+            let choices = [];
+            // the value is no good here - need scope and target both available
+            render.renderStringTree(tree, (txt, item) => choices.push({ name: txt, value: item.value }));
+            // // This is one way to do it
+            // for (let item of tree) {
+            // 
+            //   let thisChoice: PromptChoice = { name: item.text, value: item.text };
+            //   choices.push(thisChoice);
+            // 
+            //   if (item.children && item.children.length > 0) {
+            //     let children = this.buildSelectChoicesFrom(item.children);
+            //     choices.push(...children);
+            //   }
+            // }
+            return choices;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    /** sets each value to "scope|target".
+     *
+     * This is MOSTLY a COPY-PASTE from the CabinetList command!!!  This view is prob gonna be pretty common - consider promoting it to a shared utility. */
+    buildCabinetTree(rootMap, existings) {
+        var _a, _b, _c, _d;
+        let tree = [];
+        for (let ent of rootMap.enterprises) {
+            let entBranch = { text: `${ent.name} enterprise:`, value: `${codiac_relay_contracts_1.ScopeLevel.enterprise}|${ent.name}` };
+            let entSetting = existings === null || existings === void 0 ? void 0 : existings.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.enterprise && s.target === ent.name);
+            if (entSetting !== undefined) {
+                let valueSuffix = this.ellipsis(35, (_a = entSetting.value) !== null && _a !== void 0 ? _a : "[set to undefined]");
+                valueSuffix = `(${valueSuffix})`;
+                entBranch.text = entBranch.text.concat(" ", this._styler.dim(valueSuffix));
+            }
+            for (let env of _.sortBy(ent.environments, e => e.sequence, e => e.name)) {
+                let envBranch = { text: `${env.name}`, value: `${codiac_relay_contracts_1.ScopeLevel.environment}|${env.name}` };
+                let envSetting = existings === null || existings === void 0 ? void 0 : existings.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.environment && s.target === env.name);
+                if (envSetting !== undefined) {
+                    let valueSuffix = this.ellipsis(35, (_b = envSetting.value) !== null && _b !== void 0 ? _b : "[set to undefined]");
+                    valueSuffix = `(${valueSuffix})`;
+                    envBranch.text = envBranch.text.concat(" ", this._styler.dim(valueSuffix));
+                }
+                for (let cab of env.cabinets) {
+                    // let cwg = rootMap.clusters.find(c => c.name === cab.cluster);
+                    // let clusterDesc = cwg ? ` (${cab.cluster}, ${cwg.provider} ${cwg.locationName})` : "";
+                    let cabBranch = {
+                        text: `${cab.name}`,
+                        value: `${codiac_relay_contracts_1.ScopeLevel.cabinet}|${cab.name}`
+                    };
+                    let cabSetting = existings === null || existings === void 0 ? void 0 : existings.find(s => s.scope === codiac_relay_contracts_1.ScopeLevel.cabinet && s.target === cab.name);
+                    if (cabSetting !== undefined) {
+                        let valueSuffix = this.ellipsis(35, (_c = cabSetting.value) !== null && _c !== void 0 ? _c : "[set to undefined]");
+                        valueSuffix = `(${valueSuffix})`;
+                        cabBranch.text = cabBranch.text.concat(" ", this._styler.dim(valueSuffix));
+                    }
+                    if (envBranch.children === undefined)
+                        envBranch.children = [];
+                    (_d = envBranch.children) === null || _d === void 0 ? void 0 : _d.push(cabBranch);
+                }
+                if (entBranch.children === undefined)
+                    entBranch.children = [];
+                entBranch.children.push(envBranch);
+            }
+            tree.push(entBranch);
+        }
+        return tree;
+    }
+    /** Truncates the string to the given length with an ellipses as suffix */
+    ellipsis(maxLength, value) {
+        let output = value;
+        if (output.length > maxLength) {
+            let ellipsis = "..."; // Rather use the ellipsis character but String.fromCharCode(133) is returning a problematic character.
+            output = output.slice(0, maxLength - 1 - ellipsis.length).concat(ellipsis);
+        }
+        return output;
+    }
+    /** Copy of this method is in config:view */
+    promptForTargetFile(enterprise, asset) {
+        var _a, _b;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                let crit = {
+                    asset: asset,
+                    enterprise: enterprise,
+                    type: contracts_1.ConfigDefTypesEnum.file
+                };
+                let cfgResult = yield this._codiacApi.Call.getConfigDefs(crit, { projection: { pathsExcluded: [], pathsIncluded: ["settings", "targetFile", "format"] } });
+                if (cfgResult.error)
+                    throw cfgResult.error;
+                let configs = (_a = cfgResult.output) !== null && _a !== void 0 ? _a : [];
+                let choices = configs.map(c => { return { name: c.targetFile, value: c.targetFile }; });
+                choices.push({ name: CodiacConstants.CliConstants.CHOICE_VALUE_FOR_NEW, value: CodiacConstants.CliConstants.CHOICE_VALUE_FOR_NEW });
+                let output; // Pick<ConfigDef, "targetFile" | "settings">; 
+                let settingsInLocalFile;
+                let selected = (yield this._ui.promptSelect("fileExisting", "File: ", choices));
+                if (selected === CodiacConstants.CliConstants.CHOICE_VALUE_FOR_NEW) {
+                    selected = (yield this._ui.prompt("filefreehand", "Path from image root: ('?' to browse): "));
+                    if (selected === "?") {
+                        let localPath = (yield this._ui.promptSelectFile("filebrowse", "Select file: ", { asRelative: true }));
+                        settingsInLocalFile = yield this.extractSettingsFromFile(localPath);
+                        let filename = path.basename(localPath);
+                        let pathInImage = path.dirname(localPath);
+                        this._ui.userMessage(`Target file: ${this._styler.hilite(filename)}`);
+                        pathInImage = (yield this._ui.prompt("pathinimage", "Path from image root: ", true, pathInImage));
+                        selected = path.posix.join(pathInImage, filename);
+                    }
+                    else {
+                        // the user free-handed the targetFile field
+                        // this._ui.userMessage(`Target file: ${this._styler.hilite(selected)}`);
+                    }
+                }
+                output = {
+                    targetFile: selected,
+                    settings: (_b = configs.find(c => c.targetFile === selected)) === null || _b === void 0 ? void 0 : _b.settings, // in case it matches a config we pulled down 
+                };
+                return output;
+            }
+            catch (err) {
+                throw err;
+            }
+        });
+    }
+    extractSettingsFromFile(relativeFilePath) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                let output = [];
+                // gotta determmine the file format and parse it.  
+                // This logic prob needs to come from the domain or from the relay.
+                /** let format = getDefaultDataFormat(localPath);
+                 *  let extracted: Object | undefined;
+                 *  do {
+                 *    try {
+                 *      format = format ?? (await this.promptForFormat());
+                 *      extracted = tryDeserialize(file, format);
+                 *    } catch(err) {
+                 *      this._ui.UserMessage(`Error parsing as ${format}: ${err.message ?? ""}`);
+                 *      format = undefined;
+                 *    }
+                 *  } while (!extracted);
+                 *
+                 *  output = this.convertToStringParents(extracted);
+                 */
+                return output;
+            }
+            catch (err) {
+                throw err;
+            }
+        });
+    }
+    // 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* () {
+            // TODO: Do this in a single batch call
+            for (let setting of candidate.settings) {
+                if (this.configUtils.isSourced(setting.value)) {
+                    this.configUtils.deserializeSourcedValue(setting);
+                }
+                let ultimate = Object.assign(Object.assign({}, _.omit(candidate, "settings")), setting);
+                if (ultimate.configType) {
+                    ultimate.targetFile = `[${ultimate.configType}]`;
+                    delete ultimate.configType;
+                }
+                yield this.upsertSetting(ultimate); // casting here bc TS isnt recognizing that we've defined the targetFile property.
+            }
+        });
+    }
+    upsertSetting(settingObj) {
+        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 {
+                    let crit = {
+                        enterprise: settingObj.enterprise,
+                        asset: settingObj.asset,
+                        targetFile: settingObj.targetFile,
+                        scope: settingObj.scope,
+                        target: settingObj.target,
+                        setting: settingObj.setting
+                    };
+                    // TODO:  Replace this with an upsert based on:  enterprise, asset, configName, scopeLevel, scopeName, and setting
+                    let check = yield this._codiacApi.ScopedSetting.tryReadMany(crit);
+                    let resultSetting;
+                    if (check.success && check.output && check.output.length > 0) {
+                        settingObj.id = check.output[0].id;
+                        resultSetting = yield this._codiacApi.ScopedSetting.tryUpdate(settingObj);
+                    }
+                    else {
+                        resultSetting = yield this._codiacApi.ScopedSetting.tryCreate(settingObj);
+                    }
+                    if (resultSetting.success) {
+                        this.logger.notice(`Successfully saved setting [${settingObj.setting}] for ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
+                        this._ui.userMessage(`Successfully saved setting [${settingObj.setting}] for ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
+                    }
+                    else if (resultSetting.error) {
+                        this.logger.error(`Error saving setting [${settingObj.setting}]: ${resultSetting.message || ""}; ${resultSetting.error.message || resultSetting.error.stack}; For ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
+                        this._ui.userMessage(`Error saving setting [${settingObj.setting}]: ${resultSetting.message || ""}; ${resultSetting.error.message || resultSetting.error.stack}; For ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
+                    }
+                    else {
+                        this.logger.warn(`Failed without error to save setting [${settingObj.setting}]: ${resultSetting.message || ""}; For ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
+                        this._ui.userMessage(`Failed without error to save setting [${settingObj.setting}]: ${resultSetting.message || ""}; For ${settingObj.scope} [${settingObj.target}] in ${settingObj.enterprise}/${settingObj.asset} config [${settingObj.targetFile}]`);
+                    }
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    writeSetting_local(setting, value) {
+        // Write the available setting
+        if (!this._appConfig) {
+            this._appConfig = {};
+        }
+        _.set(this._appConfig, setting, value);
+        // this._appConfig[setting] = val.settingValue;
+        this._ops.writeConfig(this._appConfig);
+    }
+    /** Retrieves the list of app config settings that are not yet explicitly declared in the app config file itself */
+    getAvailableSettings() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            let avails = this._ops.loadConfigKeys(this.config.root);
+            let unset = avails;
+            // Remove any settings already explicitly called from the app-config.
+            if (this._appConfig) {
+                let keys = _.keys(this._appConfig);
+                unset = _.pull(avails, ...keys);
+            }
+            return unset;
+        });
+    }
+}
+exports.default = ConfigAdd;
+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' }),
+    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": core_1.Flags.boolean({ exclusive: ["silent"], description: "Setting this to true prevents prompting for confirmation on parameters that were passed in or were automatically set to default values (Irrelevant in --silent mode).  This behavior does NOT apply to scenarios that the command needs to override invalid user input; such cases will always prompt for confirmation.  eg: when no argument was provided for file or type, and only one exists, the system will render the autoselected file unless this flag is set." })
+};
+ConfigAdd.args = {
+// setting: Args.string({ description: 'The key for the config setting to add' })
+};
 //# sourceMappingURL=add.js.map