@rockcarver/frodo-cli 2.0.6-0 → 2.0.6-2

package/dist/app.cjs

@@ -67475,7 +67475,7 @@ var require_basic_auth = __commonJS2({
       var header = getAuthorization(req);
       return parse7(header);
     }
-    function decodeBase643(str2) {
+    function decodeBase644(str2) {
       return Buffer3.from(str2, "base64").toString();
     }
     function getAuthorization(req) {
@@ -67492,7 +67492,7 @@ var require_basic_auth = __commonJS2({
       if (!match2) {
         return void 0;
       }
-      var userPass = USER_PASS_REGEXP.exec(decodeBase643(match2[1]));
+      var userPass = USER_PASS_REGEXP.exec(decodeBase644(match2[1]));
       if (!userPass) {
         return void 0;
       }
@@ -177537,9 +177537,12 @@ var {
   isBase64Encoded: isBase64Encoded2,
   getFilePath: getFilePath12,
   getWorkingDirectory: getWorkingDirectory10,
-  saveToFile: saveToFile3
+  saveToFile: saveToFile3,
+  decodeBase64
 } = frodo.utils;
 var {
+  readScript: readScript2,
+  readScriptByName: readScriptByName2,
   readScripts: readScripts2,
   exportScript: exportScript2,
   exportScriptByName: exportScriptByName2,
@@ -177549,6 +177552,7 @@ var {
   deleteScriptByName: deleteScriptByName3,
   deleteScripts: deleteScripts3
 } = frodo.script;
+var langMap = { JAVASCRIPT: "JavaScript", GROOVY: "Groovy" };
 function getOneLineDescription(scriptObj) {
   const description = `[${scriptObj._id["brightCyan"]}] ${scriptObj.context} - ${scriptObj.name}`;
   return description;
@@ -177560,7 +177564,6 @@ function getTableHeaderMd() {
   return markdown;
 }
 function getTableRowMd(scriptObj) {
-  const langMap = { JAVASCRIPT: "JavaScript", GROOVY: "Groovy" };
   const description = `| ${scriptObj.name} | ${langMap[scriptObj.language]} | ${titleCase7(scriptObj.context.split("_").join(" "))} | \`${scriptObj._id}\` |`;
   return description;
 }
@@ -177594,6 +177597,7 @@ async function listScripts(long = false, usage = false, file = null) {
     return true;
   }
   let fullExport = null;
+  let scriptExport = null;
   const headers2 = long ? ["Name", "UUID", "Language", "Context", "Description"] : ["Name"];
   if (usage) {
     try {
@@ -177602,11 +177606,10 @@ async function listScripts(long = false, usage = false, file = null) {
       printError2(error2);
       return false;
     }
-    delete fullExport.script;
+    scriptExport = separateScriptsFromFullExport(fullExport);
     headers2.push("Used");
   }
   const table = createTable(headers2);
-  const langMap = { JAVASCRIPT: "JS", GROOVY: "Groovy" };
   scripts.forEach((script) => {
     const values3 = long ? [
       wordwrap(script.name, 25, "  "),
@@ -177616,9 +177619,11 @@ async function listScripts(long = false, usage = false, file = null) {
       wordwrap(script.description, 30)
     ] : [wordwrap(script.name, 25, "  ")];
     if (usage) {
-      const isScriptUsed = isIdUsed(fullExport, script._id, false);
+      const locations = getIdLocations(fullExport, script._id, false).concat(
+        getScriptLocations(scriptExport, script.name)
+      );
       values3.push(
-        isScriptUsed.used ? `${"yes"["brightGreen"]} (at ${isScriptUsed.location})` : "no"["brightRed"]
+        locations.length > 0 ? `${"yes"["brightGreen"]} (${locations.length === 1 ? `at` : `${locations.length} uses, including:`} ${locations[0]})` : "no"["brightRed"]
       );
     }
     table.push(values3);
@@ -177627,6 +177632,87 @@ async function listScripts(long = false, usage = false, file = null) {
   debugMessage2(`Cli.ScriptOps.listScripts: end`);
   return true;
 }
+async function describeScript(scriptId, scriptName, file, usage = false, json = false) {
+  const spinnerId = createProgressIndicator2(
+    "indeterminate",
+    0,
+    `Describing script '${scriptId ? scriptId : scriptName}'...`
+  );
+  try {
+    let script;
+    if (scriptId) {
+      script = await readScript2(scriptId);
+    } else {
+      script = await readScriptByName2(scriptName);
+    }
+    if (usage) {
+      try {
+        const fullExport = await getFullExportConfig(file);
+        const scriptExport = separateScriptsFromFullExport(fullExport);
+        script.locations = getIdLocations(fullExport, script._id, false).concat(
+          getScriptLocations(scriptExport, script.name)
+        );
+      } catch (error2) {
+        stopProgressIndicator2(
+          spinnerId,
+          `Error determining usage for script '${scriptId ? scriptId : scriptName}'`,
+          "fail"
+        );
+        printError2(error2);
+        return false;
+      }
+    }
+    stopProgressIndicator2(
+      spinnerId,
+      `Successfully retrieved script '${scriptId ? scriptId : scriptName}'`,
+      "success"
+    );
+    if (json) {
+      printMessage2(script, "data");
+    } else {
+      const table = createKeyValueTable();
+      table.push(["Id"["brightCyan"], script._id]);
+      table.push(["Name"["brightCyan"], script.name]);
+      table.push(["Language"["brightCyan"], langMap[script.language]]);
+      table.push([
+        "Context"["brightCyan"],
+        titleCase7(script.context.split("_").join(" "))
+      ]);
+      table.push(["Description"["brightCyan"], script.description]);
+      table.push([
+        "Default"["brightCyan"],
+        script.default ? "true"["brightGreen"] : "false"["brightRed"]
+      ]);
+      table.push(["Evaluator Version"["brightCyan"], script.evaluatorVersion]);
+      const scriptWrapLength = 80;
+      const wrapRegex = new RegExp(`.{1,${scriptWrapLength + 1}}`, "g");
+      const scriptParts = script.script.match(wrapRegex);
+      table.push(["Script (Base 64)"["brightCyan"], scriptParts[0]]);
+      for (let i2 = 1; i2 < scriptParts.length; i2++) {
+        table.push(["", scriptParts[i2]]);
+      }
+      if (usage) {
+        table.push([
+          `Usage Locations (${script.locations.length} total)`["brightCyan"],
+          script.locations.length > 0 ? script.locations[0] : ""
+        ]);
+        for (let i2 = 1; i2 < script.locations.length; i2++) {
+          table.push(["", script.locations[i2]]);
+        }
+      }
+      printMessage2(table.toString(), "data");
+    }
+    return true;
+  } catch (error2) {
+    stopProgressIndicator2(
+      spinnerId,
+      `Error describing script '${scriptId ? scriptId : scriptName}'`,
+      "fail"
+    );
+    printError2(error2);
+  }
+  return false;
+}
 async function exportScriptToFile(scriptId, file, includeMeta = true, extract = false, options2) {
   debugMessage2(`Cli.ScriptOps.exportScriptToFile: start`);
   try {
@@ -177966,6 +178052,37 @@ async function deleteAllScripts() {
   }
   return false;
 }
+function separateScriptsFromFullExport(fullExport) {
+  const scripts = { realm: {} };
+  for (const [realm2, realmExport] of Object.entries(fullExport.realm)) {
+    if (!scripts.realm[realm2]) {
+      scripts.realm[realm2] = {};
+    }
+    scripts.realm[realm2].script = realmExport.script;
+    delete realmExport.script;
+  }
+  return scripts;
+}
+function getScriptLocations(configuration, scriptName) {
+  const locations = [];
+  const regex2 = new RegExp(`require\\(['|"]${scriptName}['|"]\\)`);
+  for (const [realm2, realmExport] of Object.entries(configuration.realm)) {
+    for (const scriptData of Object.values(realmExport.script)) {
+      let scriptString = scriptData.script;
+      if (Array.isArray(scriptData.script)) {
+        scriptString = scriptData.script.join("\n");
+      } else if (isBase64Encoded2(scriptData.script)) {
+        scriptString = decodeBase64(scriptData.script);
+      }
+      if (regex2.test(scriptString)) {
+        locations.push(
+          `realm.${realm2}.script.${scriptData._id}(name: '${scriptData.name}').script`
+        );
+      }
+    }
+  }
+  return locations;
+}
 
 // src/utils/Config.ts
 var { getFilePath: getFilePath13, readFiles: readFiles4 } = frodo.utils;
@@ -178143,8 +178260,8 @@ async function getConfigFromDirectory(directory, exportConfig) {
     });
   }
 }
-function isIdUsed(configuration, id7, isEsv) {
-  return isIdUsedRecurse(
+function getIdLocations(configuration, id7, isEsv) {
+  return getIdLocationsRecurse(
     configuration,
     isEsv ? (
       // For ESV ids, they contain either letters, numbers, dashes, or underscores. The dashes get replaced with periods (escaped with a \ for the regex)
@@ -178160,24 +178277,24 @@ function isIdUsed(configuration, id7, isEsv) {
     )
   );
 }
-function isIdUsedRecurse(configuration, regex2) {
+function getIdLocationsRecurse(configuration, regex2) {
+  let locations = [];
   const type = typeof configuration;
   if (type === "object" && configuration !== null) {
     for (const [id7, value] of Object.entries(
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       configuration
     )) {
-      const isIdUsed2 = isIdUsedRecurse(value, regex2);
-      if (isIdUsed2.used) {
-        isIdUsed2.location = id7 + (value.name ? `(name: '${value.name}')` : "") + (isIdUsed2.location === "" ? "" : ".") + isIdUsed2.location;
-        return isIdUsed2;
-      }
+      const usedLocations = getIdLocationsRecurse(value, regex2);
+      const updatedLocations = usedLocations.map(
+        (loc) => id7 + (value.name ? `(name: '${value.name}')` : "") + (loc === "" ? "" : ".") + loc
+      );
+      locations = locations.concat(updatedLocations);
     }
+  } else if (type === "string" && regex2.test(configuration)) {
+    locations.push("");
   }
-  return {
-    used: type === "string" && regex2.test(configuration),
-    location: ""
-  };
+  return locations;
 }
 
 // src/ops/ConfigOps.ts
@@ -180019,8 +180136,8 @@ async function listSecrets(long = false, usage = false, file = null) {
     return false;
   }
   if (!long && !usage) {
-    secrets.forEach((variable) => {
-      printMessage2(variable._id, "data");
+    secrets.forEach((secret) => {
+      printMessage2(secret._id, "data");
     });
     return true;
   }
@@ -180041,7 +180158,7 @@ async function listSecrets(long = false, usage = false, file = null) {
       printError2(error2);
       return false;
     }
-    delete fullExport.secrets;
+    delete fullExport.global.secrets;
     headers2.push("Used"["brightCyan"]);
   }
   const table = createTable(headers2);
@@ -180063,9 +180180,9 @@ async function listSecrets(long = false, usage = false, file = null) {
       new Date(secret.lastChangeDate).toUTCString()
     ] : [secret._id];
     if (usage) {
-      const isEsvUsed = isIdUsed(fullExport, secret._id, true);
+      const locations = getIdLocations(fullExport, secret._id, true);
       values3.push(
-        isEsvUsed.used ? `${"yes"["brightGreen"]} (at ${isEsvUsed.location})` : "no"["brightRed"]
+        locations.length > 0 ? `${"yes"["brightGreen"]} (${locations.length === 1 ? `at` : `${locations.length} uses, including:`} ${locations[0]})` : "no"["brightRed"]
       );
     }
     table.push(values3);
@@ -180193,7 +180310,7 @@ async function deleteSecrets() {
   }
   return false;
 }
-async function listSecretVersions(secretId) {
+async function listSecretVersions(secretId, json = false) {
   let spinnerId;
   let versions5 = [];
   try {
@@ -180208,6 +180325,10 @@ async function listSecretVersions(secretId) {
       `Successfully read ${versions5.length} secret versions.`,
       "success"
     );
+    if (json) {
+      printMessage2(versions5, "data");
+      return true;
+    }
     const table = createTable([
       { hAlign: "right", content: "Version"["brightCyan"] },
       "Status"["brightCyan"],
@@ -180235,46 +180356,79 @@ async function listSecretVersions(secretId) {
   }
   return false;
 }
-async function describeSecret(secretId) {
+async function describeSecret(secretId, file, usage = false, json = false) {
   let spinnerId;
-  let secret = null;
   try {
     spinnerId = createProgressIndicator2(
       "indeterminate",
       0,
       `Reading secret ${secretId}...`
     );
-    secret = await readSecret2(secretId);
+    const secret = await readSecret2(secretId);
+    if (usage) {
+      try {
+        const fullExport = await getFullExportConfig(file);
+        delete fullExport.global.secrets;
+        secret.locations = getIdLocations(fullExport, secretId, true);
+      } catch (error2) {
+        stopProgressIndicator2(
+          spinnerId,
+          `Error determining usage for secret with id ${secretId}`,
+          "fail"
+        );
+        printError2(error2);
+        return false;
+      }
+    }
     stopProgressIndicator2(
       spinnerId,
       `Successfully read secret ${secretId}.`,
       "success"
     );
-    const table = createKeyValueTable();
-    table.push(["Name"["brightCyan"], secret._id]);
-    table.push(["Active Version"["brightCyan"], secret.activeVersion]);
-    table.push(["Loaded Version"["brightCyan"], secret.loadedVersion]);
-    table.push([
-      "Status"["brightCyan"],
-      secret.loaded ? "loaded"["brightGreen"] : "unloaded"["brightRed"]
-    ]);
-    table.push(["Description"["brightCyan"], wordwrap(secret.description, 60)]);
-    table.push([
-      "Modified"["brightCyan"],
-      new Date(secret.lastChangeDate).toLocaleString()
-    ]);
-    let lastChangedBy = secret.lastChangedBy;
-    try {
-      lastChangedBy = state.getUseBearerTokenForAmApis() ? secret.lastChangedBy : await resolveUserName3("teammember", secret.lastChangedBy);
-    } catch (error2) {
+    if (json) {
+      printMessage2(secret, "data");
+    } else {
+      const table = createKeyValueTable();
+      table.push(["Name"["brightCyan"], secret._id]);
+      table.push(["Active Version"["brightCyan"], secret.activeVersion]);
+      table.push(["Loaded Version"["brightCyan"], secret.loadedVersion]);
+      table.push([
+        "Status"["brightCyan"],
+        secret.loaded ? "loaded"["brightGreen"] : "unloaded"["brightRed"]
+      ]);
+      table.push([
+        "Description"["brightCyan"],
+        wordwrap(secret.description, 60)
+      ]);
+      table.push([
+        "Modified"["brightCyan"],
+        new Date(secret.lastChangeDate).toLocaleString()
+      ]);
+      let lastChangedBy = secret.lastChangedBy;
+      try {
+        lastChangedBy = state.getUseBearerTokenForAmApis() ? secret.lastChangedBy : await resolveUserName3("teammember", secret.lastChangedBy);
+      } catch (error2) {
+      }
+      table.push(["Modifier"["brightCyan"], lastChangedBy]);
+      table.push(["Modifier UUID"["brightCyan"], secret.lastChangedBy]);
+      table.push(["Encoding"["brightCyan"], secret.encoding]);
+      table.push([
+        "Use In Placeholders"["brightCyan"],
+        secret.useInPlaceholders
+      ]);
+      if (usage) {
+        table.push([
+          `Usage Locations (${secret.locations.length} total)`["brightCyan"],
+          secret.locations.length > 0 ? secret.locations[0] : ""
+        ]);
+        for (let i2 = 1; i2 < secret.locations.length; i2++) {
+          table.push(["", secret.locations[i2]]);
+        }
+      }
+      printMessage2(table.toString(), "data");
     }
-    table.push(["Modifier"["brightCyan"], lastChangedBy]);
-    table.push(["Modifier UUID"["brightCyan"], secret.lastChangedBy]);
-    table.push(["Encoding"["brightCyan"], secret.encoding]);
-    table.push(["Use In Placeholders"["brightCyan"], secret.useInPlaceholders]);
-    printMessage2(table.toString(), "data");
     printMessage2("\nSecret Versions:", "data");
-    await listSecretVersions(secretId);
+    await listSecretVersions(secretId, json);
     return true;
   } catch (error2) {
     stopProgressIndicator2(
@@ -180705,7 +180859,17 @@ function setup89() {
       "-i, --secret-id <secret-id>",
       "Secret id."
     ).makeOptionMandatory()
-  ).action(
+  ).addOption(
+    new Option(
+      "-f, --file [file]",
+      "Optional export file to use to determine usage. Overrides -D, --directory. Only used if -u or --usage is provided as well."
+    )
+  ).addOption(
+    new Option(
+      "-u, --usage",
+      "List all uses of the secret. If a file is provided with -f or --file, it will search for usage in the file. If a directory is provided with -D or --directory, it will search for usage in all .json files in the directory and sub-directories. If no file or directory is provided, it will perform a full export automatically to determine usage."
+    ).default(false, "false")
+  ).addOption(new Option("--json", "Output in JSON format.")).action(
     // implement command logic inside action handler
     async (host2, user2, password3, options2, command2) => {
       command2.handleDefaultArgsAndOpts(
@@ -180715,11 +180879,21 @@ function setup89() {
         options2,
         command2
       );
-      if (await getTokens2(false, true, deploymentTypes25)) {
+      if (options2.secretId && await getTokens2(false, true, deploymentTypes25)) {
         verboseMessage2(`Describing secret ${options2.secretId}...`);
-        const outcome = await describeSecret(options2.secretId);
+        const outcome = await describeSecret(
+          options2.secretId,
+          options2.file,
+          options2.usage,
+          options2.json
+        );
         if (!outcome) process.exitCode = 1;
       } else {
+        printMessage2(
+          "Unrecognized combination of options or no options...",
+          "error"
+        );
+        program3.help();
         process.exitCode = 1;
       }
     }
@@ -181265,7 +181439,7 @@ _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 
 var {
-  decodeBase64,
+  decodeBase64: decodeBase642,
   getFilePath: getFilePath17,
   getTypedFilename: getTypedFilename16,
   getWorkingDirectory: getWorkingDirectory14,
@@ -181327,7 +181501,7 @@ async function listVariables(long = false, usage = false, file = null) {
       printError2(error2);
       return false;
     }
-    delete fullExport.variables;
+    delete fullExport.global.variables;
     headers2.push("Used"["brightCyan"]);
   }
   const table = createTable(headers2);
@@ -181335,7 +181509,7 @@ async function listVariables(long = false, usage = false, file = null) {
     const values3 = long ? [
       variable._id,
       wordwrap(
-        variable.valueBase64 ? decodeBase64(variable.valueBase64) : variable.value,
+        variable.valueBase64 ? decodeBase642(variable.valueBase64) : variable.value,
         40
       ),
       variable.loaded ? "loaded"["brightGreen"] : "unloaded"["brightRed"],
@@ -181344,9 +181518,9 @@ async function listVariables(long = false, usage = false, file = null) {
       new Date(variable.lastChangeDate).toUTCString()
     ] : [variable._id];
     if (usage) {
-      const isEsvUsed = isIdUsed(fullExport, variable._id, true);
+      const locations = getIdLocations(fullExport, variable._id, true);
       values3.push(
-        isEsvUsed.used ? `${"yes"["brightGreen"]} (at ${isEsvUsed.location})` : "no"["brightRed"]
+        locations.length > 0 ? `${"yes"["brightGreen"]} (${locations.length === 1 ? `at` : `${locations.length} uses, including:`} ${locations[0]})` : "no"["brightRed"]
       );
     }
     table.push(values3);
@@ -181481,7 +181655,7 @@ async function deleteVariables() {
   }
   return false;
 }
-async function describeVariable(variableId, json = false) {
+async function describeVariable(variableId, file, usage = false, json = false) {
   const spinnerId = createProgressIndicator2(
     "indeterminate",
     0,
@@ -181489,6 +181663,21 @@ async function describeVariable(variableId, json = false) {
   );
   try {
     const variable = await readVariable2(variableId);
+    if (usage) {
+      try {
+        const fullExport = await getFullExportConfig(file);
+        delete fullExport.global.variables;
+        variable.locations = getIdLocations(fullExport, variableId, true);
+      } catch (error2) {
+        stopProgressIndicator2(
+          spinnerId,
+          `Error determining usage for variable with id ${variableId}`,
+          "fail"
+        );
+        printError2(error2);
+        return false;
+      }
+    }
     stopProgressIndicator2(
       spinnerId,
       `Successfully retrieved variable ${variableId}`,
@@ -181502,7 +181691,7 @@ async function describeVariable(variableId, json = false) {
       table.push([
         "Value"["brightCyan"],
         wordwrap(
-          variable.valueBase64 ? decodeBase64(variable.valueBase64) : variable.value,
+          variable.valueBase64 ? decodeBase642(variable.valueBase64) : variable.value,
           40
         )
       ]);
@@ -181528,6 +181717,15 @@ async function describeVariable(variableId, json = false) {
         table.push(["Modifier"["brightCyan"], modifierName]);
       }
       table.push(["Modifier UUID"["brightCyan"], variable.lastChangedBy]);
+      if (usage) {
+        table.push([
+          `Usage Locations (${variable.locations.length} total)`["brightCyan"],
+          variable.locations.length > 0 ? variable.locations[0] : ""
+        ]);
+        for (let i2 = 1; i2 < variable.locations.length; i2++) {
+          table.push(["", variable.locations[i2]]);
+        }
+      }
       printMessage2(table.toString(), "data");
     }
     return true;
@@ -181856,6 +182054,16 @@ function setup103() {
       "-i, --variable-id <variable-id>",
       "Variable id."
     ).makeOptionMandatory()
+  ).addOption(
+    new Option(
+      "-f, --file [file]",
+      "Optional export file to use to determine usage. Overrides -D, --directory. Only used if -u or --usage is provided as well."
+    )
+  ).addOption(
+    new Option(
+      "-u, --usage",
+      "List all uses of the variable. If a file is provided with -f or --file, it will search for usage in the file. If a directory is provided with -D or --directory, it will search for usage in all .json files in the directory and sub-directories. If no file or directory is provided, it will perform a full export automatically to determine usage."
+    ).default(false, "false")
   ).addOption(new Option("--json", "Output in JSON format.")).action(
     // implement command logic inside action handler
     async (host2, user2, password3, options2, command2) => {
@@ -181866,14 +182074,21 @@ function setup103() {
         options2,
         command2
       );
-      if (await getTokens2(false, true, deploymentTypes37)) {
+      if (options2.variableId && await getTokens2(false, true, deploymentTypes37)) {
         verboseMessage2(`Describing variable ${options2.variableId}...`);
         const outcome = await describeVariable(
           options2.variableId,
+          options2.file,
+          options2.usage,
           options2.json
         );
         if (!outcome) process.exitCode = 1;
       } else {
+        printMessage2(
+          "Unrecognized combination of options or no options...",
+          "error"
+        );
+        program3.help();
         process.exitCode = 1;
       }
     }
@@ -183307,7 +183522,7 @@ function getTableRowMd5(nodeObj, nodeRef) {
 // src/ops/Saml2Ops.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 
-var { decodeBase64: decodeBase642, saveTextToFile: saveTextToFile4, getFilePath: getFilePath20, getWorkingDirectory: getWorkingDirectory17 } = frodo.utils;
+var { decodeBase64: decodeBase643, saveTextToFile: saveTextToFile4, getFilePath: getFilePath20, getWorkingDirectory: getWorkingDirectory17 } = frodo.utils;
 var { getTypedFilename: getTypedFilename19, saveJsonToFile: saveJsonToFile19, getRealmString: getRealmString3 } = frodo.utils;
 var {
   readSaml2ProviderStubs: readSaml2ProviderStubs2,
@@ -183555,7 +183770,7 @@ async function importFirstSaml2ProviderFromFile(file, options2 = { deps: true })
     const data2 = _fs3.default.readFileSync(getFilePath20(file), "utf8");
     const fileData = JSON.parse(data2);
     const entityId64 = Object.keys(fileData.saml.remote)[0] || Object.keys(fileData.saml.hosted)[0];
-    const entityId = decodeBase642(entityId64);
+    const entityId = decodeBase643(entityId64);
     indicatorId = createProgressIndicator2(
       "indeterminate",
       0,
@@ -187490,9 +187705,70 @@ function setup165() {
   return program3;
 }
 
-// src/cli/script/script-export.ts
+// src/cli/script/script-describe.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 function setup166() {
+  const program3 = new FrodoCommand("frodo script describe");
+  program3.description("Describe script.").addOption(
+    new Option(
+      "-i, --script-id <uuid>",
+      "Uuid of the script. If specified, -a and -A are ignored."
+    )
+  ).addOption(
+    new Option(
+      "-n, --script-name <name>",
+      "Name of the script. If specified, -a and -A are ignored."
+    )
+  ).addOption(
+    new Option(
+      "-f, --file [file]",
+      "Optional export file to use to determine usage. Overrides -D, --directory. Only used if -u or --usage is provided as well."
+    )
+  ).addOption(
+    new Option(
+      "-u, --usage",
+      "List all uses of the script. If a file is provided with -f or --file, it will search for usage in the file. If a directory is provided with -D or --directory, it will search for usage in all .json files in the directory and sub-directories. If no file or directory is provided, it will perform a full export automatically to determine usage."
+    ).default(false, "false")
+  ).addOption(new Option("--json", "Output in JSON format.")).action(
+    // implement command logic inside action handler
+    async (host2, realm2, user2, password3, options2, command2) => {
+      command2.handleDefaultArgsAndOpts(
+        host2,
+        realm2,
+        user2,
+        password3,
+        options2,
+        command2
+      );
+      if ((options2.scriptName || options2.scriptId) && await getTokens2()) {
+        verboseMessage2(
+          `Describing script ${options2.scriptName ? options2.scriptName : options2.scriptId}...`
+        );
+        const outcome = await describeScript(
+          options2.scriptId,
+          options2.scriptName,
+          options2.file,
+          options2.usage,
+          options2.json
+        );
+        if (!outcome) process.exitCode = 1;
+      } else {
+        printMessage2(
+          "Unrecognized combination of options or no options...",
+          "error"
+        );
+        program3.help();
+        process.exitCode = 1;
+      }
+    }
+    // end command logic inside action handler
+  );
+  return program3;
+}
+
+// src/cli/script/script-export.ts
+_chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
+function setup167() {
   const program3 = new FrodoCommand("frodo script export");
   program3.description("Export scripts.").addOption(
     new Option(
@@ -187618,7 +187894,7 @@ function setup166() {
 
 // src/cli/script/script-import.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
-function setup167() {
+function setup168() {
   const program3 = new FrodoCommand("frodo script import");
   program3.description("Import scripts.").addOption(new Option("-f, --file <file>", "Name of the file to import.")).addOption(
     new Option(
@@ -187719,7 +187995,7 @@ function setup167() {
 
 // src/cli/script/script-list.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
-function setup168() {
+function setup169() {
   const program3 = new FrodoCommand("frodo script list");
   program3.description("List scripts.").addOption(
     new Option("-l, --long", "Long with all fields besides usage.").default(
@@ -187765,11 +188041,12 @@ function setup168() {
 }
 
 // src/cli/script/script.ts
-function setup169() {
+function setup170() {
   const program3 = new FrodoStubCommand("script").description("Manage scripts.");
-  program3.addCommand(setup168().name("list"));
-  program3.addCommand(setup166().name("export"));
-  program3.addCommand(setup167().name("import"));
+  program3.addCommand(setup169().name("list"));
+  program3.addCommand(setup166().name("describe"));
+  program3.addCommand(setup167().name("export"));
+  program3.addCommand(setup168().name("import"));
   program3.addCommand(setup165().name("delete"));
   return program3;
 }
@@ -188023,7 +188300,7 @@ async function deleteServices(globalConfig = false) {
 }
 
 // src/cli/service/service-delete.ts
-function setup170() {
+function setup171() {
   const program3 = new FrodoCommand("frodo service delete");
   program3.description("Delete AM services.").addOption(new Option("-i, --id <id>", "Id of Service to be deleted.")).addOption(new Option("-a, --all", "Delete all services. Ignored with -i.")).addOption(new Option("-g, --global", "Delete global services.")).action(
     async (host2, realm2, user2, password3, options2, command2) => {
@@ -188053,7 +188330,7 @@ function setup170() {
 
 // src/cli/service/service-export.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
-function setup171() {
+function setup172() {
   const program3 = new FrodoCommand("frodo service export");
   program3.description("Export AM services.").addOption(
     new Option(
@@ -188121,7 +188398,7 @@ function setup171() {
 
 // src/cli/service/service-import.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
-function setup172() {
+function setup173() {
   const program3 = new FrodoCommand("frodo service import");
   program3.description("Import AM services.").addOption(
     new Option(
@@ -188217,7 +188494,7 @@ function setup172() {
 
 // src/cli/service/service-list.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
-function setup173() {
+function setup174() {
   const program3 = new FrodoCommand("frodo service list");
   program3.description("List AM services.").addOption(
     new Option("-l, --long", "Long with all fields.").default(false, "false")
@@ -188242,14 +188519,14 @@ function setup173() {
 }
 
 // src/cli/service/service.ts
-function setup174() {
+function setup175() {
   const program3 = new FrodoStubCommand("service").description(
     "Manage AM services."
   );
-  program3.addCommand(setup173().name("list"));
-  program3.addCommand(setup171().name("export"));
-  program3.addCommand(setup172().name("import"));
-  program3.addCommand(setup170().name("delete"));
+  program3.addCommand(setup174().name("list"));
+  program3.addCommand(setup172().name("export"));
+  program3.addCommand(setup173().name("import"));
+  program3.addCommand(setup171().name("delete"));
   return program3;
 }
 
@@ -188271,7 +188548,7 @@ function searchFunctions(_answers, input = "") {
     );
   });
 }
-function setup175() {
+function setup176() {
   const program = new FrodoCommand("shell");
   program.description("Launch the frodo interactive shell.").addHelpText(
     "after",
@@ -188328,7 +188605,7 @@ _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 // src/cli/theme/theme-delete.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 var deploymentTypes57 = ["cloud", "forgeops"];
-function setup176() {
+function setup177() {
   const program3 = new FrodoCommand("frodo theme delete", [], deploymentTypes57);
   program3.description("Delete themes.").addOption(
     new Option(
@@ -188391,7 +188668,7 @@ function setup176() {
 // src/cli/theme/theme-export.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 var deploymentTypes58 = ["cloud", "forgeops"];
-function setup177() {
+function setup178() {
   const program3 = new FrodoCommand("frodo theme export", [], deploymentTypes58);
   program3.description("Export themes.").addOption(
     new Option(
@@ -188482,7 +188759,7 @@ function setup177() {
 // src/cli/theme/theme-import.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 var deploymentTypes59 = ["cloud", "forgeops"];
-function setup178() {
+function setup179() {
   const program3 = new FrodoCommand("frodo theme import", [], deploymentTypes59);
   program3.description("Import themes.").addOption(
     new Option(
@@ -188570,7 +188847,7 @@ function setup178() {
 // src/cli/theme/theme-list.ts
 _chunkMPPKDFVIcjs.init_cjs_shims.call(void 0, );
 var deploymentTypes60 = ["cloud", "forgeops"];
-function setup179() {
+function setup180() {
   const program3 = new FrodoCommand("frodo theme list", [], deploymentTypes60);
   program3.description("List themes.").addOption(
     new Option("-l, --long", "Long with more fields.").default(false, "false")
@@ -188599,12 +188876,12 @@ function setup179() {
 }
 
 // src/cli/theme/theme.ts
-function setup180() {
+function setup181() {
   const program3 = new FrodoStubCommand("theme").description("Manage themes.");
-  program3.addCommand(setup179().name("list"));
-  program3.addCommand(setup177().name("export"));
-  program3.addCommand(setup178().name("import"));
-  program3.addCommand(setup176().name("delete"));
+  program3.addCommand(setup180().name("list"));
+  program3.addCommand(setup178().name("export"));
+  program3.addCommand(setup179().name("import"));
+  program3.addCommand(setup177().name("delete"));
   return program3;
 }
 
@@ -188682,7 +188959,7 @@ var compareVersions = (v12, v2) => {
 // package.json
 var package_default2 = {
   name: "@rockcarver/frodo-cli",
-  version: "2.0.6-0",
+  version: "2.0.6-2",
   type: "module",
   description: "A command line interface to manage ForgeRock Identity Cloud tenants, ForgeOps deployments, and classic deployments.",
   keywords: [
@@ -189016,10 +189293,10 @@ var { initTokenCache: initTokenCache2 } = frodo.cache;
     program3.addCommand(setup147());
     program3.addCommand(setup152());
     program3.addCommand(setup164());
-    program3.addCommand(setup169());
-    program3.addCommand(setup174());
+    program3.addCommand(setup170());
     program3.addCommand(setup175());
-    program3.addCommand(setup180());
+    program3.addCommand(setup176());
+    program3.addCommand(setup181());
     program3.showHelpAfterError();
     program3.enablePositionalOptions();
     await program3.parseAsync();