@codiac.io/codiac-cli 1.2.157 → 1.2.165

package/lib/commands/config/add.js

@@ -1,558 +1,560 @@
-"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 = [{ name: 'setting', 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 { 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' })
+};
 //# sourceMappingURL=add.js.map