docs: unify cli help examples

src/cli/help-format.ts

@@ -0,0 +1,21 @@
+import { theme } from "../terminal/theme.js";
+
+export type HelpExample = [command: string, description: string];
+
+export function formatHelpExample(command: string, description: string): string {
+  return `  ${theme.command(command)}\n    ${theme.muted(description)}`;
+}
+
+export function formatHelpExampleLine(command: string, description: string): string {
+  if (!description) return `  ${theme.command(command)}`;
+  return `  ${theme.command(command)} ${theme.muted(`# ${description}`)}`;
+}
+
+export function formatHelpExamples(examples: HelpExample[], inline = false): string {
+  const formatter = inline ? formatHelpExampleLine : formatHelpExample;
+  return examples.map(([command, description]) => formatter(command, description)).join("\n");
+}
+
+export function formatHelpExampleGroup(label: string, examples: HelpExample[], inline = false) {
+  return `${theme.muted(label)}\n${formatHelpExamples(examples, inline)}`;
+}