Add live operation automation parity

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: mamoreau-devolutions

cli-arguments.md

@@ -23,6 +23,14 @@
 | `--automation show-app` | Asks the running UniGetUI instance to show and focus its main window when a UI session exists | 2026.1+ |
 | `--automation navigate-app --page {discover\|updates\|installed\|bundles\|settings\|managers\|own-log\|manager-log\|operation-history\|help\|release-notes\|about} [--manager name] [--help-attachment path]` | Navigates the running UI session to a top-level destination, with optional manager-specific or help-page context where supported | 2026.1+ |
 | `--automation quit-app` | Gracefully shuts down the current UniGetUI session, including the headless automation daemon | 2026.1+ |
+| `--automation list-operations` | Lists tracked live and completed operations, including queue state, current status line, retry modes, and package identity where available | 2026.1+ |
+| `--automation get-operation --operation-id id` | Returns the full tracked payload for one operation, including current state, queue actions, retry modes, and captured output lines | 2026.1+ |
+| `--automation get-operation-output --operation-id id [--tail n]` | Returns captured live output for one operation, optionally limited to the last _n_ lines | 2026.1+ |
+| `--automation wait-operation --operation-id id [--timeout seconds] [--delay seconds]` | Polls the local automation service until the specified operation finishes and returns the final tracked payload | 2026.1+ |
+| `--automation cancel-operation --operation-id id` | Cancels a queued or running operation through the same operation pipeline used by the UI | 2026.1+ |
+| `--automation retry-operation --operation-id id [--mode {retry\|retry-as-admin\|retry-interactive\|retry-no-hash-check}]` | Re-runs a finished operation using one of the retry modes supported by the UI for that operation | 2026.1+ |
+| `--automation reorder-operation --operation-id id --action {run-now\|run-next\|run-last}` | Reorders a queued operation in the shared operation queue | 2026.1+ |
+| `--automation forget-operation --operation-id id` | Removes a finished operation from the tracked live-operation list without altering persisted history | 2026.1+ |
 | `--automation get-version` | Reads the local automation service build number through the background API | 2026.1+ |
 | `--automation get-updates` | Reads the currently available updates through the local automation service and returns structured JSON | 2026.1+ |
 | `--automation list-managers` | Lists package managers, readiness, executable metadata, and automation-relevant capability flags | 2026.1+ |
@@ -71,9 +79,9 @@
 | `--automation search-packages --manager name --query text [--max-results n]` | Searches packages through the automation service and returns structured JSON | 2026.1+ |
 | `--automation package-details --manager name --package-id id` | Fetches the package-details payload currently exposed through the automation layer | 2026.1+ |
 | `--automation package-versions --manager name --package-id id` | Lists installable versions for a package when the manager supports custom versions | 2026.1+ |
-| `--automation install-package --manager name --package-id id [--version v] [--scope scope] [--pre-release] [--elevated true\|false] [--interactive true\|false] [--skip-hash true\|false] [--architecture value] [--location path]` | Installs a package through the automation service and waits for completion, honoring the same core install options exposed by the UI | 2026.1+ |
-| `--automation download-package --manager name --package-id id --output path` | Downloads a package installer or artifact to the specified file or directory and returns the resolved saved path | 2026.1+ |
-| `--automation reinstall-package --manager name --package-id id [--version v] [--scope scope] [--pre-release] [--elevated true\|false] [--interactive true\|false] [--skip-hash true\|false] [--architecture value] [--location path]` | Re-runs package installation for an installed package using the requested install options | 2026.1+ |
+| `--automation install-package --manager name --package-id id [--version v] [--scope scope] [--pre-release] [--elevated true\|false] [--interactive true\|false] [--skip-hash true\|false] [--architecture value] [--location path] [--wait true\|false \| --detach]` | Installs a package through the automation service; async mode returns immediately with an operation id so agents can inspect, wait, cancel, or forget the operation separately | 2026.1+ |
+| `--automation download-package --manager name --package-id id --output path [--wait true\|false \| --detach]` | Downloads a package installer or artifact to the specified file or directory; async mode returns the tracked download operation id immediately | 2026.1+ |
+| `--automation reinstall-package --manager name --package-id id [--version v] [--scope scope] [--pre-release] [--elevated true\|false] [--interactive true\|false] [--skip-hash true\|false] [--architecture value] [--location path] [--wait true\|false \| --detach]` | Re-runs package installation for an installed package using the requested install options, optionally as a detached tracked operation | 2026.1+ |
 | `--automation open-window` | Legacy alias for `--automation show-app` | 2026.1+ |
 | `--automation open-updates` | Legacy alias for `--automation navigate-app --page updates` | 2026.1+ |
 | `--automation show-package --package-id id --package-source source` | Opens the package details flow for the specified package | 2026.1+ |
@@ -82,9 +90,9 @@
 | `--automation unignore-package --manager name --package-id id [--version v]` | Removes an ignored-update rule for a package and refreshes the updates view | 2026.1+ |
 | `--automation update-all` | Queues updates for all packages currently shown as upgradable | 2026.1+ |
 | `--automation update-manager --manager name` | Queues updates for all packages handled by the specified manager | 2026.1+ |
-| `--automation update-package --manager name --package-id id [--version v] [--scope scope] [--pre-release] [--elevated true\|false] [--interactive true\|false] [--skip-hash true\|false] [--architecture value] [--location path]` | Updates a specific package through the automation service and waits for completion | 2026.1+ |
-| `--automation uninstall-package --manager name --package-id id [--scope scope] [--remove-data true\|false] [--elevated true\|false] [--interactive true\|false]` | Uninstalls a package through the automation service and waits for completion | 2026.1+ |
-| `--automation uninstall-then-reinstall-package --manager name --package-id id [--version v] [--scope scope] [--pre-release] [--remove-data true\|false] [--elevated true\|false] [--interactive true\|false] [--skip-hash true\|false] [--architecture value] [--location path]` | Uninstalls an installed package and then immediately reinstalls it through the shared operation pipeline | 2026.1+ |
+| `--automation update-package --manager name --package-id id [--version v] [--scope scope] [--pre-release] [--elevated true\|false] [--interactive true\|false] [--skip-hash true\|false] [--architecture value] [--location path] [--wait true\|false \| --detach]` | Updates a specific package through the automation service, either synchronously or as a tracked background operation | 2026.1+ |
+| `--automation uninstall-package --manager name --package-id id [--scope scope] [--remove-data true\|false] [--elevated true\|false] [--interactive true\|false] [--wait true\|false \| --detach]` | Uninstalls a package through the automation service, either synchronously or as a tracked background operation | 2026.1+ |
+| `--automation uninstall-then-reinstall-package --manager name --package-id id [--version v] [--scope scope] [--pre-release] [--remove-data true\|false] [--elevated true\|false] [--interactive true\|false] [--skip-hash true\|false] [--architecture value] [--location path] [--wait true\|false \| --detach]` | Uninstalls an installed package and then immediately reinstalls it through the shared operation pipeline, with the same async tracking support as other package actions | 2026.1+ |
 | `--background-api-transport {tcp\|named-pipe}` | Selects which local HTTP transport UniGetUI uses for the background API when the app starts | 2026.1+ |
 | `--background-api-port port` | Overrides the localhost TCP port used by the background API when `--background-api-transport tcp` is active | 2026.1+ |
 | `--background-api-pipe-name name` | Overrides the Windows named pipe name used by the background API when `--background-api-transport named-pipe` is active | 2026.1+ |
@@ -102,7 +110,7 @@
 
 - `dotnet src\UniGetUI.Avalonia\bin\Release\net10.0\UniGetUI.Avalonia.dll --headless` starts the local automation daemon without opening any window or requiring a graphical desktop session.
 - `dotnet src\UniGetUI.Cli\bin\Release\net10.0\UniGetUI.Cli.dll <command>` is the cross-platform CLI wrapper for the automation service. It automatically prepends `--automation`, so `UniGetUI.Cli status` and `UniGetUI.Cli search-packages --manager ".NET Tool" --query dotnetsay` work directly.
-- Current agent-oriented command coverage includes app/session lifecycle inspection and shutdown, manager/source inspection plus manager enablement, notification suppression, manager-maintenance and executable-path control, settings and secure-settings inspection/mutation, desktop-shortcut state management, app/history/manager log inspection, local backup creation and GitHub cloud-backup/auth flows, current bundle inspection/import/export/add/remove/install flows, package search/details/version listing, ignored-update management, and package install/update/uninstall flows.
+- Current agent-oriented command coverage includes app/session lifecycle inspection and shutdown, live operation inspection/control (`list/get/output/wait/cancel/retry/reorder/forget`), manager/source inspection plus manager enablement, notification suppression, manager-maintenance and executable-path control, settings and secure-settings inspection/mutation, desktop-shortcut state management, app/history/manager log inspection, local backup creation and GitHub cloud-backup/auth flows, current bundle inspection/import/export/add/remove/install flows, package search/details/version listing, ignored-update management, and package install/update/uninstall/download/reinstall flows with optional detached execution.
 
 <br><br>
 # `unigetui://` deep link

src/UniGetUI.Avalonia/App.axaml.cs

@@ -4,6 +4,9 @@
 using Avalonia.Markup.Xaml.Styling;
 using Avalonia.Platform;
 using Avalonia.Styling;
+#if AVALONIA_DIAGNOSTICS_ENABLED
+using Avalonia.Diagnostics;
+#endif
 using UniGetUI.Avalonia.Infrastructure;
 using UniGetUI.Avalonia.Views;
 using UniGetUI.PackageEngine;

src/UniGetUI.Avalonia/Infrastructure/AvaloniaOperationRegistry.cs

@@ -8,6 +8,7 @@
 using UniGetUI.Core.Logging;
 using UniGetUI.Core.SettingsEngine;
 using UniGetUI.Core.Tools;
+using UniGetUI.Interface;
 using UniGetUI.PackageEngine.Classes.Packages.Classes;
 using UniGetUI.PackageEngine.Enums;
 using UniGetUI.PackageOperations;
@@ -32,6 +33,7 @@ public static class AvaloniaOperationRegistry
     /// </summary>
     public static void Add(AbstractOperation op)
     {
+        AutomationOperationApi.Track(op);
         var vm = new OperationViewModel(op);
 
         Dispatcher.UIThread.Post(() =>
@@ -88,6 +90,10 @@ public static void Remove(OperationViewModel vm)
             Operations.Remove(vm.Operation);
         });
         while (AbstractOperation.OperationQueue.Remove(vm.Operation)) ;
+        if (vm.Operation.Status is not (OperationStatus.InQueue or OperationStatus.Running))
+        {
+            AutomationOperationApi.ForgetTracking(vm.Operation.Metadata.Identifier);
+        }
     }
 
     private static async Task RemoveAfterDelayAsync(AbstractOperation op, int milliseconds)
@@ -98,6 +104,10 @@ private static async Task RemoveAfterDelayAsync(AbstractOperation op, int millis
             var vm = OperationViewModels.FirstOrDefault(v => v.Operation == op);
             if (vm is not null) OperationViewModels.Remove(vm);
             Operations.Remove(op);
+            if (op.Status is not (OperationStatus.InQueue or OperationStatus.Running))
+            {
+                AutomationOperationApi.ForgetTracking(op.Metadata.Identifier);
+            }
         });
     }
 

src/UniGetUI.Interface.BackgroundApi/AutomationCliCommandRunner.cs

@@ -55,6 +55,105 @@ TextWriter error
                     await client.NavigateAppAsync(BuildAppNavigateRequest(args))
                 ),
                 "quit-app" => await WriteJsonAsync(output, await client.QuitAppAsync()),
+                "list-operations" => await WriteJsonAsync(
+                    output,
+                    new
+                    {
+                        status = "success",
+                        operations = await client.ListOperationsAsync(),
+                    }
+                ),
+                "get-operation" => await WriteJsonAsync(
+                    output,
+                    new
+                    {
+                        status = "success",
+                        operation = await client.GetOperationAsync(
+                            GetRequiredArgument(
+                                args,
+                                "--operation-id",
+                                "The get-operation automation command requires --operation-id."
+                            )
+                        ),
+                    }
+                ),
+                "get-operation-output" => await WriteJsonAsync(
+                    output,
+                    new
+                    {
+                        status = "success",
+                        output = await client.GetOperationOutputAsync(
+                            GetRequiredArgument(
+                                args,
+                                "--operation-id",
+                                "The get-operation-output automation command requires --operation-id."
+                            ),
+                            GetOptionalIntArgument(args, "--tail")
+                        ),
+                    }
+                ),
+                "wait-operation" => await WriteJsonAsync(
+                    output,
+                    new
+                    {
+                        status = "success",
+                        operation = await client.WaitForOperationAsync(
+                            GetRequiredArgument(
+                                args,
+                                "--operation-id",
+                                "The wait-operation automation command requires --operation-id."
+                            ),
+                            GetOptionalIntArgument(args, "--timeout") ?? 300,
+                            ((GetOptionalIntArgument(args, "--delay") ?? 1) * 1000)
+                        ),
+                    }
+                ),
+                "cancel-operation" => await WriteJsonAsync(
+                    output,
+                    await client.CancelOperationAsync(
+                        GetRequiredArgument(
+                            args,
+                            "--operation-id",
+                            "The cancel-operation automation command requires --operation-id."
+                        )
+                    )
+                ),
+                "retry-operation" => await WriteJsonAsync(
+                    output,
+                    await client.RetryOperationAsync(
+                        GetRequiredArgument(
+                            args,
+                            "--operation-id",
+                            "The retry-operation automation command requires --operation-id."
+                        ),
+                        GetOptionalArgument(args, "--mode")
+                    )
+                ),
+                "reorder-operation" => await WriteJsonAsync(
+                    output,
+                    await client.ReorderOperationAsync(
+                        GetRequiredArgument(
+                            args,
+                            "--operation-id",
+                            "The reorder-operation automation command requires --operation-id."
+                        ),
+                        GetRequiredArgument(
+                            args,
+                            "--action",
+                            "The reorder-operation automation command requires --action."
+                        )
+                    )
+                ),
+                "forget-operation" => await WriteJsonAsync(
+                    output,
+                    await client.ForgetOperationAsync(
+                        GetRequiredArgument(
+                            args,
+                            "--operation-id",
+                            "The forget-operation automation command requires --operation-id."
+                        )
+                    )
+                ),
                 "list-managers" => await WriteJsonAsync(
                     output,
                     new
@@ -523,6 +622,9 @@ private static AutomationPackageActionRequest BuildPackageActionRequest(IReadOnl
             Interactive = GetOptionalBoolArgument(args, "--interactive"),
             SkipHash = GetOptionalBoolArgument(args, "--skip-hash"),
             RemoveData = GetOptionalBoolArgument(args, "--remove-data"),
+            WaitForCompletion = args.Contains("--detach")
+                ? false
+                : GetOptionalBoolArgument(args, "--wait"),
             Architecture = GetOptionalArgument(args, "--architecture"),
             InstallLocation = GetOptionalArgument(args, "--location"),
             OutputPath = GetOptionalArgument(args, "--output"),