@dereekb/dbx-cli 13.11.1 → 13.11.2

package/firebase-api-manifest/main.js

@@ -136,7 +136,7 @@ function stripJsonComments(text) {
 import { readdirSync, readFileSync as readFileSync3, statSync } from "node:fs";
 import { join as join2 } from "node:path";
 
-// packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/extract-crud.ts
+// packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts
 import { Node as Node2, Project as Project2 } from "ts-morph";
 var SUPPORTED_VERBS = /* @__PURE__ */ new Set(["create", "read", "update", "delete", "query"]);
 function extractCrudEntries(source) {
@@ -147,24 +147,51 @@ function extractCrudEntries(source) {
   const crudConfigType = findTypeAliasByEnding(sourceFile, "ModelCrudFunctionsConfig");
   const groupName = inferGroupName(sourceFile);
   const functionsClassName = findFunctionsClassName(sourceFile);
+  const typeDocsCache = /* @__PURE__ */ new Map();
+  const resolveTypeDocs = (typeName) => {
+    if (!typeName) {
+      return void 0;
+    }
+    if (typeDocsCache.has(typeName)) {
+      return typeDocsCache.get(typeName);
+    }
+    const docs = readTypeDocs(sourceFile, typeName);
+    if (docs) {
+      typeDocsCache.set(typeName, docs);
+    }
+    return docs;
+  };
   if (crudConfigType) {
     const literal = crudConfigType.getTypeNode();
     if (literal && Node2.isTypeLiteral(literal)) {
       for (const member of literal.getMembers()) {
-        if (!Node2.isPropertySignature(member)) continue;
+        if (!Node2.isPropertySignature(member)) {
+          continue;
+        }
         const modelName = member.getName();
         modelKeys.push(modelName);
         const valueNode = member.getTypeNode();
-        if (!valueNode) continue;
-        if (isNullLiteralType(valueNode)) continue;
+        if (!valueNode) {
+          continue;
+        }
+        if (isNullLiteralType(valueNode)) {
+          continue;
+        }
         if (Node2.isTypeLiteral(valueNode)) {
           for (const verbMember of valueNode.getMembers()) {
-            if (!Node2.isPropertySignature(verbMember)) continue;
-            const verb = verbMember.getName();
-            if (!SUPPORTED_VERBS.has(verb)) continue;
+            if (!Node2.isPropertySignature(verbMember)) {
+              continue;
+            }
+            const verbName = verbMember.getName();
+            if (!SUPPORTED_VERBS.has(verbName)) {
+              continue;
+            }
+            const verb = verbName;
             const verbValueNode = verbMember.getTypeNode();
-            if (!verbValueNode) continue;
-            collectVerbEntries({ modelName, verb, valueNode: verbValueNode, entries });
+            if (!verbValueNode) {
+              continue;
+            }
+            collectVerbEntries({ modelName, verb, valueNode: verbValueNode, entries, fallbackDescription: readJsDocSummary(verbMember), resolveTypeDocs });
           }
         }
       }
@@ -175,17 +202,26 @@ function extractCrudEntries(source) {
     const literal = functionTypeMap.getTypeNode();
     if (literal && Node2.isTypeLiteral(literal)) {
       for (const member of literal.getMembers()) {
-        if (!Node2.isPropertySignature(member)) continue;
+        if (!Node2.isPropertySignature(member)) {
+          continue;
+        }
         const key = member.getName();
         const valueNode = member.getTypeNode();
         const tuple = valueNode ? readTupleParamsResult(valueNode) : void 0;
+        const paramsDocs = resolveTypeDocs(tuple?.params);
+        const resultDocs = resolveTypeDocs(tuple?.result);
         entries.push({
           model: key,
           verb: "standalone",
           specifier: void 0,
           paramsTypeName: tuple?.params,
           resultTypeName: tuple?.result,
-          line: member.getStartLineNumber()
+          line: member.getStartLineNumber(),
+          description: readJsDocSummary(member),
+          paramsTypeDescription: paramsDocs?.typeDescription,
+          paramsFields: paramsDocs?.fields,
+          resultTypeDescription: resultDocs?.typeDescription,
+          resultFields: resultDocs?.fields
         });
       }
     }
@@ -194,15 +230,21 @@ function extractCrudEntries(source) {
 }
 function findTypeAliasByEnding(sourceFile, ending) {
   for (const alias of sourceFile.getTypeAliases()) {
-    if (alias.getName().endsWith(ending) && alias.getTypeNode()) return alias;
+    if (alias.getName().endsWith(ending) && alias.getTypeNode()) {
+      return alias;
+    }
   }
   return void 0;
 }
 function findFunctionsClassName(sourceFile) {
   for (const cls of sourceFile.getClasses()) {
-    if (!cls.isAbstract()) continue;
+    if (!cls.isAbstract()) {
+      continue;
+    }
     const name = cls.getName();
-    if (name?.endsWith("Functions")) return name;
+    if (name?.endsWith("Functions")) {
+      return name;
+    }
   }
   return void 0;
 }
@@ -211,14 +253,18 @@ function inferGroupName(sourceFile) {
     const name = alias.getName();
     if (name.endsWith("ModelCrudFunctionsConfig")) {
       const stem = name.slice(0, -"ModelCrudFunctionsConfig".length);
-      if (stem.length > 0) return stem;
+      if (stem.length > 0) {
+        return stem;
+      }
     }
   }
   for (const alias of sourceFile.getTypeAliases()) {
     const name = alias.getName();
     if (name.endsWith("FunctionTypeMap")) {
       const stem = name.slice(0, -"FunctionTypeMap".length);
-      if (stem.length > 0) return stem;
+      if (stem.length > 0) {
+        return stem;
+      }
     }
   }
   return void 0;
@@ -226,50 +272,74 @@ function inferGroupName(sourceFile) {
 function isNullLiteralType(node) {
   if (Node2.isLiteralTypeNode(node)) {
     const literal = node.getLiteral();
-    if (Node2.isNullLiteral(literal)) return true;
+    if (Node2.isNullLiteral(literal)) {
+      return true;
+    }
   }
   return false;
 }
 function collectVerbEntries(input) {
-  const { modelName, verb, valueNode, entries } = input;
+  const { modelName, verb, valueNode, entries, fallbackDescription, resolveTypeDocs } = input;
   if (Node2.isTypeLiteral(valueNode)) {
     for (const specMember of valueNode.getMembers()) {
-      if (!Node2.isPropertySignature(specMember)) continue;
+      if (!Node2.isPropertySignature(specMember)) {
+        continue;
+      }
       const specifier = specMember.getName();
       const leafNode = specMember.getTypeNode();
       const leaf2 = leafNode ? readTupleParamsResult(leafNode) ?? readBareParams(leafNode) : void 0;
+      const paramsDocs2 = resolveTypeDocs(leaf2?.params);
+      const resultDocs2 = resolveTypeDocs(leaf2?.result);
       entries.push({
         model: modelName,
         verb,
         specifier,
         paramsTypeName: leaf2?.params,
         resultTypeName: leaf2?.result,
-        line: specMember.getStartLineNumber()
+        line: specMember.getStartLineNumber(),
+        description: readJsDocSummary(specMember),
+        paramsTypeDescription: paramsDocs2?.typeDescription,
+        paramsFields: paramsDocs2?.fields,
+        resultTypeDescription: resultDocs2?.typeDescription,
+        resultFields: resultDocs2?.fields
       });
     }
     return;
   }
   const leaf = readTupleParamsResult(valueNode) ?? readBareParams(valueNode);
+  const paramsDocs = resolveTypeDocs(leaf?.params);
+  const resultDocs = resolveTypeDocs(leaf?.result);
   entries.push({
     model: modelName,
     verb,
     specifier: void 0,
     paramsTypeName: leaf?.params,
     resultTypeName: leaf?.result,
-    line: valueNode.getStartLineNumber()
+    line: valueNode.getStartLineNumber(),
+    description: fallbackDescription,
+    paramsTypeDescription: paramsDocs?.typeDescription,
+    paramsFields: paramsDocs?.fields,
+    resultTypeDescription: resultDocs?.typeDescription,
+    resultFields: resultDocs?.fields
   });
 }
 function readTupleParamsResult(node) {
-  if (!Node2.isTupleTypeNode(node)) return void 0;
+  if (!Node2.isTupleTypeNode(node)) {
+    return void 0;
+  }
   const elements = node.getElements();
-  if (elements.length === 0) return void 0;
+  if (elements.length === 0) {
+    return void 0;
+  }
   const params = elements[0] ? typeNodeName(elements[0]) : void 0;
   const result = elements[1] ? typeNodeName(elements[1]) : void 0;
   return { params, result };
 }
 function readBareParams(node) {
   const params = typeNodeName(node);
-  if (!params) return void 0;
+  if (!params) {
+    return void 0;
+  }
   return { params, result: void 0 };
 }
 function typeNodeName(node) {
@@ -279,6 +349,40 @@ function typeNodeName(node) {
   const text = node.getText().trim();
   return text.length > 0 ? text : void 0;
 }
+function readTypeDocs(sourceFile, typeName) {
+  const interfaceDecl = sourceFile.getInterface(typeName);
+  if (interfaceDecl) {
+    const typeDescription = readJsDocSummary(interfaceDecl);
+    const fields = [];
+    for (const property of interfaceDecl.getProperties()) {
+      const fieldName = property.getName();
+      const description = readJsDocSummary(property);
+      const typeNode = property.getTypeNode();
+      const typeText = typeNode?.getText().trim() ?? "";
+      const field = description ? { name: fieldName, typeText, description } : { name: fieldName, typeText };
+      fields.push(field);
+    }
+    if (!typeDescription && fields.length === 0) {
+      return void 0;
+    }
+    return { typeDescription, fields: fields.length > 0 ? fields : void 0 };
+  }
+  const typeAlias = sourceFile.getTypeAlias(typeName);
+  if (typeAlias) {
+    const typeDescription = readJsDocSummary(typeAlias);
+    return typeDescription ? { typeDescription } : void 0;
+  }
+  return void 0;
+}
+function readJsDocSummary(node) {
+  const docs = node.getJsDocs();
+  if (docs.length === 0) {
+    return void 0;
+  }
+  const last = docs[docs.length - 1];
+  const description = last.getDescription().trim();
+  return description.length > 0 ? description : void 0;
+}
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/find-api-files.ts
 function findApiFiles(packageRoot) {
@@ -437,10 +541,23 @@ function renderEntry({ entry, validatorName }) {
     validatorName ? `paramsValidator: ${validatorName}` : void 0,
     entry.resultTypeName ? `resultTypeName: ${JSON.stringify(entry.resultTypeName)}` : void 0,
     `groupName: ${JSON.stringify(entry.groupName)}`,
-    `sourceFile: ${JSON.stringify(entry.sourceFile)}`
+    `sourceFile: ${JSON.stringify(entry.sourceFile)}`,
+    entry.description ? `description: ${JSON.stringify(entry.description)}` : void 0,
+    entry.paramsTypeDescription ? `paramsTypeDescription: ${JSON.stringify(entry.paramsTypeDescription)}` : void 0,
+    entry.paramsFields && entry.paramsFields.length > 0 ? `paramsFields: ${renderDocFields(entry.paramsFields)}` : void 0,
+    entry.resultTypeDescription ? `resultTypeDescription: ${JSON.stringify(entry.resultTypeDescription)}` : void 0,
+    entry.resultFields && entry.resultFields.length > 0 ? `resultFields: ${renderDocFields(entry.resultFields)}` : void 0
   ];
   return `  { ${fields.filter((v) => Boolean(v)).join(", ")} }`;
 }
+function renderDocFields(fields) {
+  const items = fields.map((field) => {
+    const parts = [`name: ${JSON.stringify(field.name)}`, `typeText: ${JSON.stringify(field.typeText)}`];
+    if (field.description) parts.push(`description: ${JSON.stringify(field.description)}`);
+    return `{ ${parts.join(", ")} }`;
+  });
+  return `[${items.join(", ")}]`;
+}
 async function formatWithPrettier(source, outputFile) {
   const config = await resolveConfig(outputFile);
   return format(source, { ...config, filepath: outputFile });

package/firebase-api-manifest/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli-firebase-api-manifest",
-  "version": "13.11.1",
+  "version": "13.11.2",
   "private": true,
   "type": "module",
   "devDependencies": {

package/index.cjs.js

@@ -1660,7 +1660,7 @@ function mergeOutputCommandsConfig(existing, updates) {
  * The `model.*` write scopes filtered out by {@link filterReadOnlyModelScopes}.
  *
  * Mirrors the write half of the dbx-components callModel CRUD scope set
- * (`CALL_MODEL_OIDC_SCOPES` in `@dereekb/firebase-server/oidc`) — duplicated here so the
+ * (`CALL_MODEL_OIDC_SCOPES` in `@dereekb/firebase`) — duplicated here so the
  * CLI doesn't take a server-side dependency just to know the names.
  */ var MODEL_WRITE_OIDC_SCOPES = [
     'model.create',
@@ -7093,6 +7093,15 @@ var SKIPPED_VERBS = new Set([
     'standalone'
 ]);
 var ALL_HELP_FLAG = '--all-help';
+var HELP_MODE_FLAG = '--help-mode';
+/**
+ * Default help mode when no override is supplied.
+ */ var DEFAULT_MANIFEST_HELP_MODE = 'both';
+var MANIFEST_HELP_MODES = new Set([
+    'action',
+    'params',
+    'both'
+]);
 /**
  * Default schema format when no override is supplied.
  */ var DEFAULT_MANIFEST_HELP_DATA_FORMAT = 'jsonschema';
@@ -7125,7 +7134,7 @@ var DATA_HELP_FLAG = '--data-help';
  * @returns The yargs `CommandModule[]` ready to be passed to `runCli({ apiCommands })`. Empty
  *   when the manifest has no callable entries.
  */ function buildManifestCommands(manifest, options) {
-    var _ref, _ref1, _ref2, _ref3, _ref4;
+    var _ref, _ref1, _ref2, _ref3, _ref4, _ref5;
     var callable = manifest.filter(function(e) {
         return !SKIPPED_VERBS.has(e.verb);
     });
@@ -7162,15 +7171,17 @@ var DATA_HELP_FLAG = '--data-help';
     }
     var argv = (_ref = options === null || options === void 0 ? void 0 : options.argv) !== null && _ref !== void 0 ? _ref : process.argv;
     var dataHelpFormat = (_ref1 = options === null || options === void 0 ? void 0 : options.dataHelpFormat) !== null && _ref1 !== void 0 ? _ref1 : detectDataHelpFormat(argv);
-    var focusHelp = ((_ref2 = options === null || options === void 0 ? void 0 : options.focusHelpOnDataHelp) !== null && _ref2 !== void 0 ? _ref2 : true) && hasDataHelpFlag(argv) && !hasAllHelpFlag(argv);
-    var hideOnFocus = focusHelp ? (_ref3 = options === null || options === void 0 ? void 0 : options.hiddenWhenFocused) !== null && _ref3 !== void 0 ? _ref3 : STANDARD_GLOBAL_OPTION_NAMES : [];
-    var modelCommandName = (_ref4 = options === null || options === void 0 ? void 0 : options.modelCommandName) !== null && _ref4 !== void 0 ? _ref4 : DEFAULT_MANIFEST_MODEL_COMMAND_NAME;
+    var helpMode = (_ref2 = options === null || options === void 0 ? void 0 : options.helpMode) !== null && _ref2 !== void 0 ? _ref2 : detectHelpMode(argv);
+    var focusHelp = ((_ref3 = options === null || options === void 0 ? void 0 : options.focusHelpOnDataHelp) !== null && _ref3 !== void 0 ? _ref3 : true) && hasDataHelpFlag(argv) && !hasAllHelpFlag(argv);
+    var hideOnFocus = focusHelp ? (_ref4 = options === null || options === void 0 ? void 0 : options.hiddenWhenFocused) !== null && _ref4 !== void 0 ? _ref4 : STANDARD_GLOBAL_OPTION_NAMES : [];
+    var modelCommandName = (_ref5 = options === null || options === void 0 ? void 0 : options.modelCommandName) !== null && _ref5 !== void 0 ? _ref5 : DEFAULT_MANIFEST_MODEL_COMMAND_NAME;
     var sortedModels = _to_consumable_array(byModel.entries()).sort(function(param, param1) {
         var _param = _sliced_to_array(param, 1), a = _param[0], _param1 = _sliced_to_array(param1, 1), b = _param1[0];
         return a.localeCompare(b);
     });
     var context = {
         dataHelpFormat: dataHelpFormat,
+        helpMode: helpMode,
         hideOnFocus: hideOnFocus
     };
     return [
@@ -7263,6 +7274,38 @@ var DATA_HELP_FLAG = '--data-help';
 function parseDataHelpFormat(value) {
     return MANIFEST_HELP_DATA_FORMATS.has(value) ? value : undefined;
 }
+/**
+ * Inspects an argv array for `--help-mode=<mode>` or `--help-mode <mode>` and
+ * returns the requested {@link ManifestHelpMode}. Unrecognized values fall
+ * back to {@link DEFAULT_MANIFEST_HELP_MODE}.
+ *
+ * Implemented as a raw argv scan (rather than going through yargs) because the
+ * value is needed when each command's builder runs — which is before yargs
+ * parses argv.
+ *
+ * @param argv - argv to inspect (defaults to `process.argv`).
+ * @returns The detected mode, or {@link DEFAULT_MANIFEST_HELP_MODE}.
+ */ function detectHelpMode() {
+    var argv = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : process.argv;
+    var result = DEFAULT_MANIFEST_HELP_MODE;
+    for(var i = 0; i < argv.length; i++){
+        var arg = argv[i];
+        if (arg.startsWith("".concat(HELP_MODE_FLAG, "="))) {
+            var _parseHelpMode;
+            result = (_parseHelpMode = parseHelpMode(arg.slice(HELP_MODE_FLAG.length + 1))) !== null && _parseHelpMode !== void 0 ? _parseHelpMode : result;
+            break;
+        }
+        if (arg === HELP_MODE_FLAG && i + 1 < argv.length) {
+            var _parseHelpMode1;
+            result = (_parseHelpMode1 = parseHelpMode(argv[i + 1])) !== null && _parseHelpMode1 !== void 0 ? _parseHelpMode1 : result;
+            break;
+        }
+    }
+    return result;
+}
+function parseHelpMode(value) {
+    return MANIFEST_HELP_MODES.has(value) ? value : undefined;
+}
 function buildModelCommand(model, entries, context) {
     return {
         command: "".concat(model, " <action>"),
@@ -7297,14 +7340,15 @@ function buildModelCommand(model, entries, context) {
     };
 }
 function buildEntryCommand(entry, context) {
-    var _entry_description;
+    var _oneLineDescription;
     var action = entry.specifier && entry.specifier !== '_' ? "".concat(entry.verb, "-").concat(entry.specifier) : entry.verb;
     var specPart = entry.specifier && entry.specifier !== '_' ? ' ' + entry.specifier : '';
-    var describe = (_entry_description = entry.description) !== null && _entry_description !== void 0 ? _entry_description : "".concat(entry.verb).concat(specPart, " on ").concat(entry.model);
-    var epilogue = buildEntryEpilogue(entry, context.dataHelpFormat);
+    var fallbackDescribe = "".concat(entry.verb).concat(specPart, " on ").concat(entry.model);
+    var describeOneLine = (_oneLineDescription = oneLineDescription(entry.description)) !== null && _oneLineDescription !== void 0 ? _oneLineDescription : fallbackDescribe;
+    var epilogue = buildEntryEpilogue(entry, context);
     return {
         command: action,
-        describe: describe,
+        describe: describeOneLine,
         builder: function builder(yargs) {
             var y = yargs.option('data', {
                 type: 'string',
@@ -7353,6 +7397,12 @@ function buildEntryCommand(entry, context) {
         }
     };
 }
+function oneLineDescription(description) {
+    var _description_split_;
+    if (!description) return undefined;
+    var firstLine = (_description_split_ = description.split('\n', 1)[0]) === null || _description_split_ === void 0 ? void 0 : _description_split_.trim();
+    return firstLine && firstLine.length > 0 ? firstLine : undefined;
+}
 function hideGlobalOptions(yargs, names) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
@@ -7376,37 +7426,145 @@ function hideGlobalOptions(yargs, names) {
     }
 }
 /**
- * Builds the help epilogue for a manifest-driven command. Surfaces the params
- * arktype validator (as JSON Schema and/or the arktype expression — see
- * {@link ManifestHelpDataFormat}) along with the params/result type names and
- * the source `.api.ts` path for traceability. Designed to give both humans
- * and LLM agents enough information from `--help` alone to construct a valid
- * `--data` payload.
+ * Builds the help epilogue for a manifest-driven command. Surfaces the action
+ * description JSDoc, the params interface description and per-field
+ * descriptions, the params arktype validator (as JSON Schema and/or arktype
+ * expression — see {@link ManifestHelpDataFormat}), and the source `.api.ts`
+ * path for traceability. Designed to give both humans and LLM agents enough
+ * information from `--help` alone to understand a command and construct a
+ * valid `--data` payload.
  *
  * @param entry - Manifest entry whose metadata becomes the help epilogue.
- * @param dataHelpFormat - Format used for the `Params Schema` section.
+ * @param context - Builder context controlling schema format and which sections
+ *   to render (see {@link ManifestHelpMode}).
  * @returns Multi-section epilogue string, or `undefined` when the entry has no
  *   metadata worth surfacing.
- */ function buildEntryEpilogue(entry, dataHelpFormat) {
-    var _sections;
+ */ function buildEntryEpilogue(entry, context) {
+    var dataHelpFormat = context.dataHelpFormat, helpMode = context.helpMode;
+    var showAction = helpMode === 'action' || helpMode === 'both';
+    var showParams = helpMode === 'params' || helpMode === 'both';
     var sections = [];
-    if (entry.paramsTypeName) {
-        sections.push("Params: ".concat(entry.paramsTypeName));
-    }
-    var schemaSections = renderParamsSchemaSections(entry, dataHelpFormat);
-    (_sections = sections).push.apply(_sections, _to_consumable_array(schemaSections));
-    if (entry.resultTypeName) {
-        sections.push("Result: ".concat(entry.resultTypeName));
+    if (showAction) {
+        var actionSection = buildActionSection(entry);
+        if (actionSection) sections.push(actionSection);
+    }
+    var schemaSections = [];
+    if (showParams) {
+        var _sections;
+        var paramsSection = buildParamsSection(entry);
+        if (paramsSection) sections.push(paramsSection);
+        schemaSections = renderParamsSchemaSections(entry, dataHelpFormat);
+        (_sections = sections).push.apply(_sections, _to_consumable_array(schemaSections));
+        var resultSection = buildResultSection(entry);
+        if (resultSection) {
+            sections.push(resultSection);
+        } else if (entry.resultTypeName) {
+            sections.push("Result: ".concat(entry.resultTypeName));
+        }
     }
     if (entry.sourceFile) {
         sections.push("Source: ".concat(entry.sourceFile));
     }
-    if (schemaSections.length > 0 && dataHelpFormat !== 'both') {
+    if (showParams && schemaSections.length > 0 && dataHelpFormat !== 'both') {
         var other = dataHelpFormat === 'jsonschema' ? 'arktype' : 'jsonschema';
         sections.push("(Pass --data-help=".concat(other, " or --data-help=both to switch the schema format above.)"));
     }
+    if (helpMode === 'both' && (entry.description || entry.paramsTypeDescription || entry.paramsFields && entry.paramsFields.length > 0)) {
+        sections.push("(Pass --help-mode=action or --help-mode=params to focus this help on a single section.)");
+    }
     return sections.length > 0 ? sections.join('\n\n') : undefined;
 }
+function buildActionSection(entry) {
+    if (!entry.description) return undefined;
+    return "About:\n".concat(indentLines(entry.description, '  '));
+}
+function buildParamsSection(entry) {
+    if (!entry.paramsTypeName && !entry.paramsTypeDescription && !(entry.paramsFields && entry.paramsFields.length > 0)) {
+        return undefined;
+    }
+    var lines = [];
+    if (entry.paramsTypeName) {
+        lines.push("Params: ".concat(entry.paramsTypeName));
+    }
+    if (entry.paramsTypeDescription) {
+        lines.push(indentLines(entry.paramsTypeDescription, '  '));
+    }
+    if (entry.paramsFields && entry.paramsFields.length > 0) {
+        lines.push('');
+        lines.push('Fields:');
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = entry.paramsFields[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var field = _step.value;
+                var header = "  - ".concat(field.name, ": ").concat(field.typeText);
+                lines.push(header);
+                if (field.description) {
+                    lines.push(indentLines(field.description, '      '));
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function buildResultSection(entry) {
+    if (!entry.resultTypeDescription && !(entry.resultFields && entry.resultFields.length > 0)) {
+        return undefined;
+    }
+    var lines = [];
+    if (entry.resultTypeName) {
+        lines.push("Result: ".concat(entry.resultTypeName));
+    }
+    if (entry.resultTypeDescription) {
+        lines.push(indentLines(entry.resultTypeDescription, '  '));
+    }
+    if (entry.resultFields && entry.resultFields.length > 0) {
+        lines.push('');
+        lines.push('Fields:');
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = entry.resultFields[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var field = _step.value;
+                var header = "  - ".concat(field.name, ": ").concat(field.typeText);
+                lines.push(header);
+                if (field.description) {
+                    lines.push(indentLines(field.description, '      '));
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function indentLines(text, indent) {
+    return text.split('\n').map(function(line) {
+        return "".concat(indent).concat(line);
+    }).join('\n');
+}
 function renderParamsSchemaSections(entry, dataHelpFormat) {
     var sections = [];
     if (!entry.paramsValidator) {
@@ -8119,6 +8277,7 @@ exports.CliError = CliError;
 exports.DEFAULT_CLI_OIDC_SCOPES = DEFAULT_CLI_OIDC_SCOPES;
 exports.DEFAULT_CLI_SECRET_PATTERNS = DEFAULT_CLI_SECRET_PATTERNS;
 exports.DEFAULT_MANIFEST_HELP_DATA_FORMAT = DEFAULT_MANIFEST_HELP_DATA_FORMAT;
+exports.DEFAULT_MANIFEST_HELP_MODE = DEFAULT_MANIFEST_HELP_MODE;
 exports.DEFAULT_MANIFEST_MODEL_COMMAND_NAME = DEFAULT_MANIFEST_MODEL_COMMAND_NAME;
 exports.DUMP_MERGE_MODES = DUMP_MERGE_MODES;
 exports.DUMP_OUTPUT_MODES = DUMP_OUTPUT_MODES;
@@ -8150,6 +8309,7 @@ exports.createOutputCommand = createOutputCommand;
 exports.createOutputMiddleware = createOutputMiddleware;
 exports.defaultDoctorChecks = defaultDoctorChecks;
 exports.detectDataHelpFormat = detectDataHelpFormat;
+exports.detectHelpMode = detectHelpMode;
 exports.discoverOidcMetadata = discoverOidcMetadata;
 exports.dumpTimestamp = dumpTimestamp;
 exports.exchangeAuthorizationCode = exchangeAuthorizationCode;