Display default values in CLI help text

[Copilot]

CLI help text was missing default values for flags, forcing users to read source code or documentation to understand default behavior.

Changes

Modified packages/jsdoc-cli/lib/help.js to append default values to flag descriptions:

if (flagDetail.defaultDescription) {
  description += ` Default: ${flagDetail.defaultDescription}`;
} else if (flagDetail.default !== undefined) {
  const defaultValue =
    typeof flagDetail.default === 'object' && flagDetail.default !== null
      ? JSON.stringify(flagDetail.default)
      : String(flagDetail.default);
  description += ` Default: ${defaultValue}`;
}

Impact

Help text now displays:

• --access: Default: All except 'private'
• --destination: Default: ./out
• --encoding: Default: utf8

Handles edge cases: falsy values (0, false, ""), null, and complex objects via JSON serialization.

Original prompt

Reference: oracle/oci-cli@b770913

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.