fix(cli): show subcommands and subcommand groups in build summary

This code is a bit messy now and will need to be refactored...

.changeset/few-bottles-learn.md

@@ -0,0 +1,5 @@
+---
+'@roboplay/robo.js': patch
+---
+
+fix(cli): show subcommands and subcommand groups in build summary

packages/robo/src/cli/utils/build-summary.ts

@@ -3,7 +3,7 @@ import path from 'node:path'
 import chalk from 'chalk'
 import { logger } from '../../core/logger.js'
 import { performance } from 'node:perf_hooks'
-import { Manifest } from '../../types/index.js'
+import { CommandEntry, Manifest } from '../../types/index.js'
 import { packageJson } from './utils.js'
 
 export async function getProjectSize(directory: string): Promise<number> {
@@ -34,29 +34,60 @@ export async function getProjectSize(directory: string): Promise<number> {
 
 export function printBuildSummary(manifest: Manifest, totalSize: number, startTime: number, plugin: boolean) {
 	const maxLength = Math.min(Math.max(...Object.keys(manifest.commands).map((cmd) => cmd.length), 15), 30)
-	logger.log(chalk.bold(`\nType        Name${' '.repeat(maxLength - 2)}Description`))
-	logger.log(`─`.repeat(maxLength + 30))
+	const maxTypeNameLength = Math.max(
+		...['Command', 'Subcommand', 'Subcommand Group', 'Event'].map((type) => type.length)
+	)
+
+	const headerType = 'Type'
+	const headerName = 'Name'
+	const headerDescription = 'Description'
+
+	// +4 to account for autoSymbol spacing, +1 for a space between type and name
+	const headerTypeSpacing = ' '.repeat(maxTypeNameLength - headerType.length + 4)
+	const headerNameSpacing = ' '.repeat(maxLength - headerName.length + 1)
+
+	logger.log(chalk.bold(`\n${headerType}${headerTypeSpacing}${headerName}${headerNameSpacing}${headerDescription}`))
+	logger.log(`─`.repeat(maxLength + maxTypeNameLength + headerDescription.length + 5))
 
 	let autoGeneratedExists = false
-	for (const [command, commandData] of Object.entries(manifest.commands)) {
-		const autoSymbol = commandData.__auto ? '  Δ ' : '    '
-		if (commandData.__auto) {
-			autoGeneratedExists = true
+
+	function logCommands(commands: Record<string, CommandEntry>, prefix = '', depth = 0) {
+		for (const [command, commandData] of Object.entries(commands)) {
+			if (commandData.subcommands) {
+				logCommands(commandData.subcommands, prefix ? `${prefix} ${command}` : command, depth + 1)
+				continue
+			}
+
+			const autoSymbol = commandData.__auto ? '  Δ ' : '    '
+			if (commandData.__auto) {
+				autoGeneratedExists = true
+			}
+			const fullPath = prefix ? `${prefix} ${command}` : command
+			let type = 'Command'
+			if (depth === 1) type = 'Subcommand'
+			if (depth >= 2) type = 'Subcommand Group'
+
+			const typeSpacing = ' '.repeat(maxTypeNameLength - type.length + 1)
+
+			logger.log(
+				chalk.bold.blue(type + typeSpacing + autoSymbol) +
+					`${chalk.bold(('/' + fullPath).padEnd(maxLength + 1))} ${commandData.description ?? ''}`
+			)
 		}
-		logger.log(
-			chalk.bold.blue('Command ' + autoSymbol) +
-				`${chalk.bold(('/' + command).padEnd(maxLength + 1))} ${commandData.description ?? ''}`
-		)
 	}
+	logCommands(manifest.commands)
 
 	for (const event of Object.keys(manifest.events)) {
 		const eventData = manifest.events[event]
-		const isAuto = eventData.every(e => e.__auto)
+		const isAuto = eventData.every((e) => e.__auto)
 		const autoSymbol = isAuto ? '  Δ ' : '    '
 		if (isAuto) {
 			autoGeneratedExists = true
 		}
-		logger.log(chalk.bold.magenta('Event   ' + autoSymbol) + `${chalk.bold(event).padEnd(maxLength + 1)}`)
+
+		const type = 'Event'
+		const typeSpacing = ' '.repeat(maxTypeNameLength - type.length + 1)
+		logger.log(chalk.bold.magenta(type + typeSpacing + autoSymbol) + `${chalk.bold(event).padEnd(maxLength + 1)}`)
 	}
 
 	// Format sizing information