[dartdev] Organize dart --help commands into categories

This CL organizes the commands in the Dart CLI to categories. It
mirrors the categories used in `flutter --help`: `SDK`, `Project`, and
`Tools`. The available command section will now look as follows in
verbose mode:

```
Available commands:

Project
  build                 Build a Dart application including native assets.
  compile               Compile Dart to various formats.
  create                Create a new Dart project.
  pub                   Work with packages.
  run                   Run a Dart program.
  test                  Run tests for a project.

Source code
  analyze               Analyze Dart code in a directory.
  doc                   Generate API documentation for Dart projects.
  fix                   Apply automated fixes to Dart source code.
  format                Idiomatically format Dart source code.

Tools
  compilation-server    Control resident frontend compilers.
  development-service   Start Dart's development service.
  devtools              Open DevTools (optionally connecting to an existing application).
  info                  Show diagnostic information about the installed tooling.
  language-server       Start Dart's analysis server.
  tooling-daemon        Start Dart's tooling daemon.
```

Bug: #60980
Change-Id: Ic9da297fcdd0f8e85d619632ba8ec30fd2c32666
Cq-Include-Trybots: luci.dart.try:pkg-linux-debug-try,pkg-linux-release-arm64-try,pkg-linux-release-try,pkg-mac-release-arm64-try,pkg-mac-release-try,pkg-win-release-arm64-try,pkg-win-release-try
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/436382
Reviewed-by: Michael Thomsen <[email protected]>
Commit-Queue: Daco Harkes <[email protected]>

Author: dcharkes

pkg/dartdev/lib/dartdev.dart

@@ -116,11 +116,11 @@ class DartdevRunner extends CommandRunner<int> {
     addCommand(DevToolsCommand(verbose: verbose));
     addCommand(DocCommand(verbose: verbose));
     addCommand(FixCommand(verbose: verbose));
-    addCommand(FormatCommand(verbose: verbose));
+    addCommand(FormatCommand(verbose: verbose, category: 'Source code'));
     addCommand(InfoCommand(verbose: verbose));
     addCommand(LanguageServerCommand(verbose: verbose));
     addCommand(DartMCPServerCommand(verbose: verbose));
-    addCommand(pubCommand(isVerbose: () => verbose));
+    addCommand(pubCommand(isVerbose: () => verbose, category: 'Project'));
     addCommand(RunCommand(
       verbose: verbose,
       nativeAssetsExperimentEnabled: nativeAssetsExperimentEnabled,

pkg/dartdev/lib/src/commands/analyze.dart

@@ -99,6 +99,9 @@ class AnalyzeCommand extends DartdevCommand {
       ..addExperimentalFlags();
   }
 
+  @override
+  String get category => 'Source code';
+
   @override
   String get invocation => '${super.invocation} [<directory>]';
 

pkg/dartdev/lib/src/commands/build.dart

@@ -34,6 +34,9 @@ class BuildCommand extends DartdevCommand {
       recordUseEnabled: recordUseEnabled,
     ));
   }
+
+  @override
+  String get category => 'Project';
 }
 
 /// Subcommand for `dart build cli`.

pkg/dartdev/lib/src/commands/compilation_server.dart

@@ -42,6 +42,9 @@ class CompilationServerCommand extends DartdevCommand {
     addSubcommand(CompilationServerStartCommand());
     addSubcommand(CompilationServerShutdownCommand());
   }
+
+  @override
+  String get category => 'Tools';
 }
 
 class CompilationServerStartCommand extends DartdevCommand {

pkg/dartdev/lib/src/commands/compile.dart

@@ -1145,4 +1145,7 @@ class CompileCommand extends DartdevCommand {
     ));
     addSubcommand(CompileWasmCommand(verbose: verbose));
   }
+
+  @override
+  String get category => 'Project';
 }

pkg/dartdev/lib/src/commands/create.dart

@@ -61,6 +61,9 @@ class CreateCommand extends DartdevCommand {
   @override
   String get invocation => '${super.invocation} <directory>';
 
+  @override
+  String get category => 'Project';
+
   @override
   FutureOr<int> run() async {
     final args = argResults!;

pkg/dartdev/lib/src/commands/dart_mcp_server.dart

@@ -39,6 +39,9 @@ EXPERIMENTAL: This tool may change dramatically or disappear at any time.''';
               'experimental feature with no stability guarantees.');
   }
 
+  @override
+  String get category => 'Tools';
+
   @override
   Future<int> run() async {
     final args = argResults!;

pkg/dartdev/lib/src/commands/debug_adapter.dart

@@ -59,6 +59,9 @@ class DebugAdapterCommand extends DartdevCommand {
       );
   }
 
+  @override
+  String get category => 'Tools';
+
   @override
   FutureOr<int> run() async {
     final args = argResults!;

pkg/dartdev/lib/src/commands/development_service.dart

@@ -30,6 +30,9 @@ class DevelopmentServiceCommand extends DartdevCommand {
     );
   }
 
+  @override
+  String get category => 'Tools';
+
   @override
   Future<int> run() async {
     final sdkDir = dirname(sdk.dart);
@@ -47,12 +50,11 @@ class DevelopmentServiceCommand extends DartdevCommand {
       // On ia32 platforms we do not have an AOT snapshot and so we need
       // to run the JIT snapshot.
       useExecProcess = false;
-      script = fullSdk
-          ? sdk.ddsSnapshot
-          : absolute(sdkDir, 'dds.dart.snapshot');
+      script =
+          fullSdk ? sdk.ddsSnapshot : absolute(sdkDir, 'dds.dart.snapshot');
       if (!Sdk.checkArtifactExists(script, logError: false)) {
         log.stderr('Error: launching development server failed : '
-                   'Unable to find snapshot for the development server');
+            'Unable to find snapshot for the development server');
         return 255;
       }
     }

pkg/dartdev/lib/src/commands/devtools.dart

@@ -39,6 +39,9 @@ class DevToolsCommand extends DartdevCommand {
   @override
   String get name => 'devtools';
 
+  @override
+  String get category => 'Tools';
+
   @override
   String get description => DevToolsServer.commandDescription;