command pub check-resolution-up-to-date (#4655)

Author: sigurdm

lib/src/command/check_resolution_up_to_date.dart

@@ -0,0 +1,44 @@
+// Copyright (c) 2025, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+import 'dart:async';
+
+import '../command.dart';
+import '../command_runner.dart';
+import '../entrypoint.dart';
+import '../log.dart' as log;
+import '../utils.dart';
+
+class CheckResolutionUpToDateCommand extends PubCommand {
+  @override
+  String get name => 'check-resolution-up-to-date';
+
+  @override
+  bool get hidden => true;
+
+  @override
+  String get description => '''
+Do a fast timestamp-based check to see resolution is up-to-date and internally
+consistent.
+
+If timestamps are correctly ordered, exit 0, and do not check the external sources for
+newer versions.
+Otherwise exit non-zero.
+''';
+
+  @override
+  String get argumentsDescription => '';
+
+  CheckResolutionUpToDateCommand();
+
+  @override
+  Future<void> runProtected() async {
+    final result = Entrypoint.isResolutionUpToDate(directory, cache);
+    if (result == null) {
+      fail('Resolution needs updating. Run `$topLevelProgram pub get`');
+    } else {
+      log.message('Resolution is up-to-date');
+    }
+  }
+}

lib/src/command_runner.dart

@@ -13,6 +13,7 @@ import 'command.dart' show PubTopLevel, lineLength;
 import 'command/add.dart';
 import 'command/bump.dart';
 import 'command/cache.dart';
+import 'command/check_resolution_up_to_date.dart';
 import 'command/deps.dart';
 import 'command/downgrade.dart';
 import 'command/get.dart';
@@ -151,6 +152,7 @@ class PubCommandRunner extends CommandRunner<int> implements PubTopLevel {
     addCommand(OutdatedCommand());
     addCommand(RemoveCommand());
     addCommand(RunCommand());
+    addCommand(CheckResolutionUpToDateCommand());
     addCommand(UpgradeCommand());
     addCommand(UnpackCommand());
     addCommand(UploaderCommand());