Add optional parameters to resetProgress() for initialization

- resetProgress() now accepts optional progress and statusMessage parameters
- Allows initializing commands to specific values (e.g., resuming at 50%)
- Without parameters, resets to defaults (0.0, null)
- Updated documentation with examples

Author: escamoteur

CHANGELOG.md

@@ -9,7 +9,9 @@
   - Implementation uses wrapper functions in WithProgress factories to call `reset()` automatically
 
 **New Methods**:
-- `Command.resetProgress()` - Manually reset progress state (useful for clearing 100% progress from UI)
+- `Command.resetProgress({double? progress, String? statusMessage})` - Manually reset/initialize progress state
+  - Without parameters: resets to defaults (0.0, null)
+  - With parameters: initializes to specific values (useful for resuming operations)
 
 **Technical Details**:
 - Added `ProgressHandle.reset()` method to clear all state back to initial values

lib/command_it.dart

@@ -624,19 +624,30 @@ abstract class Command<TParam, TResult> extends CustomValueNotifier<TResult> {
   /// Clears progress (to 0.0), statusMessage (to null), and isCanceled (to false).
   /// This is called automatically at the start of each execution, but can also
   /// be called manually when needed (e.g., to clear 100% progress from UI after
-  /// completion).
+  /// completion, or to initialize a command to a specific progress value).
+  ///
+  /// Optional parameters allow setting specific initial values:
+  /// - [progress]: Initial progress value (0.0-1.0), defaults to 0.0
+  /// - [statusMessage]: Initial status message, defaults to null
   ///
   /// Example:
   /// ```dart
-  /// // After successful completion, reset progress for next run
+  /// // Reset to default (0.0, null)
+  /// command.resetProgress();
+  ///
+  /// // Initialize to 50% with a message
+  /// command.resetProgress(progress: 0.5, statusMessage: 'Resuming...');
+  ///
+  /// // Clear 100% progress after completion
   /// if (command.progress.value == 1.0) {
   ///   await Future.delayed(Duration(seconds: 2));
   ///   command.resetProgress();
   /// }
   /// ```
   ///
   /// For commands without progress (created with regular factories), this is a no-op.
-  void resetProgress() => _handle?.reset();
+  void resetProgress({double? progress, String? statusMessage}) =>
+      _handle?.reset(progress: progress, statusMessage: statusMessage);
 
   /// optional hander that will get called on any exception that happens inside
   /// any Command of the app. Ideal for logging.

lib/progress_handle.dart

@@ -93,15 +93,18 @@ class ProgressHandle {
   ///
   /// Called automatically at the start of each command execution.
   /// Resets:
-  /// - [progress] to 0.0
-  /// - [statusMessage] to null
+  /// - [progress] to 0.0 (or specified value)
+  /// - [statusMessage] to null (or specified value)
   /// - [isCanceled] to false
   ///
+  /// Optional parameters allow initializing to specific values instead
+  /// of defaults, useful for starting commands at a non-zero progress.
+  ///
   /// This ensures each command execution starts with clean state,
   /// especially important for the cancellation flag.
-  void reset() {
-    _progress.value = 0.0;
-    _statusMessage.value = null;
+  void reset({double? progress, String? statusMessage}) {
+    _progress.value = progress ?? 0.0;
+    _statusMessage.value = statusMessage;
     _isCanceled.value = false;
   }