feat(cli): Add operations commands

Add commands for working with cloud operations.

Author: dnys1

apps/cli/bin/celest.dart

@@ -1,5 +1,6 @@
 import 'package:celest_cli/celest_cli.dart';
 import 'package:celest_cli/src/commands/auth/auth_command.dart';
+import 'package:celest_cli/src/commands/cloud/operations/operations_command.dart';
 import 'package:celest_cli/src/commands/cloud/organizations/organizations_command.dart';
 import 'package:celest_cli/src/commands/cloud/project_environments/project_environments_command.dart';
 import 'package:celest_cli/src/commands/cloud/projects/projects_command.dart';
@@ -32,7 +33,8 @@ void main(List<String> args) async {
   cli
     ..addCommand(OrganizationsCommand())
     ..addCommand(ProjectsCommand())
-    ..addCommand(ProjectEnvironmentsCommand());
+    ..addCommand(ProjectEnvironmentsCommand())
+    ..addCommand(OperationsCommand());
 
   await cli.run(args);
 }

apps/cli/lib/src/commands/cloud/cloud_command.dart

@@ -484,6 +484,8 @@ abstract base class CloudDeleteCommand<R extends GeneratedMessage>
 
 extension type CloudCommandOptions(ArgResults argResults)
     implements ArgResults {
+  String? get maybeResourceId => rest.elementAtOrNull(0);
+
   String get resourceId {
     final id = rest.elementAtOrNull(0);
     if (id == null) {

apps/cli/lib/src/commands/cloud/operations/get_operation_command.dart

@@ -0,0 +1,22 @@
+import 'package:celest_cli/src/commands/cloud/cloud_command.dart';
+import 'package:celest_cli/src/context.dart' show cloud;
+import 'package:celest_cloud/celest_cloud.dart';
+
+final class GetOperationCommand extends CloudGetCommand<Operation> {
+  @override
+  String get description => 'Gets an operation.';
+
+  @override
+  String get name => 'get';
+
+  @override
+  String get resourceType => 'Operation';
+
+  @override
+  Operation createEmptyResource() => Operation();
+
+  @override
+  Future<Operation?> callService() async {
+    return cloud.operations.get(options.resourceId);
+  }
+}

apps/cli/lib/src/commands/cloud/operations/list_operations_command.dart

@@ -0,0 +1,44 @@
+import 'package:celest_cli/src/commands/cloud/cloud_command.dart';
+import 'package:celest_cli/src/context.dart' show cloud;
+import 'package:celest_cloud/celest_cloud.dart';
+import 'package:celest_cloud_core/celest_cloud_core.dart';
+
+final class ListOperationsCommand extends CloudListCommand<Operation> {
+  @override
+  String get description => 'Lists operations.';
+
+  @override
+  String get name => 'list';
+
+  @override
+  String get resourceType => 'Operation';
+
+  @override
+  String? get parentResourceType => null;
+
+  @override
+  Operation createEmptyResource() => Operation();
+
+  @override
+  Future<CloudListResult<Operation>> callService() async {
+    var filter = options.filter;
+    if (options.maybeResourceId case final resourceId?) {
+      final resourceName = ResourceName.parse(resourceId);
+      final resourceFilter = 'resource_type = "${resourceName.uid.type}" AND '
+          'resource_id = "${resourceName.uid.id}"';
+      if (filter == null || filter.isEmpty) {
+        filter = resourceFilter;
+      } else {
+        filter = '$filter AND $resourceFilter';
+      }
+    }
+    final result = await cloud.operations.list(
+      filter: filter,
+      pageSize: options.pageSize,
+    );
+    return (
+      items: result.operations,
+      nextPageToken: result.hasNextPageToken() ? result.nextPageToken : null,
+    );
+  }
+}

apps/cli/lib/src/commands/cloud/operations/operations_command.dart

@@ -0,0 +1,22 @@
+import 'package:celest_cli/src/commands/celest_command.dart';
+import 'package:celest_cli/src/commands/cloud/operations/get_operation_command.dart';
+import 'package:celest_cli/src/commands/cloud/operations/list_operations_command.dart';
+
+final class OperationsCommand extends CelestCommand {
+  OperationsCommand() {
+    addSubcommand(GetOperationCommand());
+    addSubcommand(ListOperationsCommand());
+  }
+
+  @override
+  String get description => 'Manage Celest Cloud operations.';
+
+  @override
+  String get name => 'operations';
+
+  @override
+  String get category => 'Cloud';
+
+  @override
+  bool get hidden => true;
+}