Function formatCommandList

cli/src/framework/help.ts:196–201

(commands: Array<{ command: CommandConstructor, path: string[] }>, format: string)

// aligned rows. Keeps `<group> --help -o json` machine-readable like every
// other help surface.
export function formatCommandList(commands: Array<{ command: CommandConstructor, path: string[] }>, format: string): string {
  if (isStructured(format))
    return serialize({ commands: commands.map(({ command, path }) => describeCommand(command, path.join(' '))) }, format)

  return `COMMANDS\n${renderCommandRows(commands)}\n`
}

// Curated onboarding examples for the top-level overview (gh-style): the
// shortest path from zero to a structured app run. Editorial, not an exhaustive