[Environments] Adding configuration flow

tools/Environments/DevHome.Environments/Helpers/DataExtractor.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 
+using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
 using DevHome.Common.Environments.Models;
@@ -98,7 +99,7 @@ public static async Task<List<PinOperationData>> FillDotButtonPinOperationsAsync
     /// Returns the list of operations to be added to the launch button.
     /// </summary>
     // <param name="computeSystem">Compute system used to fill OperationsViewModel's callback function.</param>
-    public static List<OperationsViewModel> FillLaunchButtonOperations(ComputeSystemCache computeSystem)
+    public static List<OperationsViewModel> FillLaunchButtonOperations(ComputeSystemProvider provider, ComputeSystemCache computeSystem, Action<ComputeSystemReviewItem>? configurationCallback)
     {
         var operations = new List<OperationsViewModel>();
         var supportedOperations = computeSystem.SupportedOperations.Value;
@@ -151,6 +152,12 @@ public static List<OperationsViewModel> FillLaunchButtonOperations(ComputeSystem
                 _stringResource.GetLocalized("Operations_Terminate"), "\uEE95", computeSystem.TerminateAsync, ComputeSystemOperations.Terminate));
         }
 
+        if (supportedOperations.HasFlag(ComputeSystemOperations.ApplyConfiguration) && configurationCallback is not null)
+        {
+            operations.Add(new OperationsViewModel(
+                _stringResource.GetLocalized("Operations_ApplyConfiguration"), "\uE835", configurationCallback, provider, computeSystem));
+        }
+
         return operations;
     }
 }

tools/Environments/DevHome.Environments/Strings/en-us/Resources.resw

@@ -358,5 +358,8 @@
   <data name="MoreOptionsButton.[using:Microsoft.UI.Xaml.Automation]AutomationProperties.Name" xml:space="preserve">
     <value>More options</value>
     <comment>Name of the button that brings up the "More options" menu</comment>
+  <data name="Operations_ApplyConfiguration" xml:space="preserve">
+    <value>Setup</value>
+    <comment>Value to be shown in the button option to start the configuration flow</comment>
   </data>
 </root>

tools/Environments/DevHome.Environments/ViewModels/ComputeSystemViewModel.cs

@@ -58,6 +58,8 @@ public partial class ComputeSystemViewModel : ComputeSystemCardBase, IRecipient<
 
     private bool _disposedValue;
 
+    private Action<ComputeSystemReviewItem>? _configurationAction;
+
     /// <summary>
     /// Initializes a new instance of the <see cref="ComputeSystemViewModel"/> class.
     /// This class requires a 3-step initialization:
@@ -73,6 +75,7 @@ public ComputeSystemViewModel(
         IComputeSystem system,
         ComputeSystemProvider provider,
         Func<ComputeSystemCardBase, bool> removalAction,
+        Action<ComputeSystemReviewItem>? configurationAction,
         string packageFullName,
         Window window)
     {
@@ -83,6 +86,7 @@ public ComputeSystemViewModel(
         ComputeSystem = new(system);
         PackageFullName = packageFullName;
         _removalAction = removalAction;
+        _configurationAction = configurationAction;
         _stringResource = new StringResource("DevHome.Environments.pri", "DevHome.Environments/Resources");
     }
 
@@ -133,7 +137,7 @@ private async Task InitializeOperationDataAsync()
             ShouldShowDotOperations = false;
             ShouldShowSplitButton = false;
 
-            RegisterForAllOperationMessages(DataExtractor.FillDotButtonOperations(ComputeSystem, _mainWindow), DataExtractor.FillLaunchButtonOperations(ComputeSystem));
+            RegisterForAllOperationMessages(DataExtractor.FillDotButtonOperations(ComputeSystem, _mainWindow), DataExtractor.FillLaunchButtonOperations(_provider, ComputeSystem, _configurationAction));
 
             _ = Task.Run(async () =>
             {

tools/Environments/DevHome.Environments/ViewModels/CreateComputeSystemOperationViewModel.cs

@@ -160,6 +160,7 @@ private async void AddComputeSystemToUI(CreateComputeSystemResult result)
             result.ComputeSystem,
             Operation.ProviderDetails.ComputeSystemProvider,
             _removalAction,
+            null,
             Operation.ProviderDetails.ExtensionWrapper.PackageFullName,
             _mainWindow);
 

tools/Environments/DevHome.Environments/ViewModels/LandingPageViewModel.cs

@@ -152,6 +152,18 @@ public void CallToActionInvokeButton()
         _navigationService.NavigateTo(KnownPageKeys.SetupFlow, "startCreationFlow;EnvironmentsLandingPage");
     }
 
+    public void ConfigureComputeSystem(ComputeSystemReviewItem item)
+    {
+        _log.Information("User clicked on the setup button. Navigating to the Setup an Environment page in Setup flow");
+        object[] parameters = { "StartConfigurationFlow", "EnvironmentsLandingPage", item };
+
+        // Run on the UI thread
+        _mainWindow.DispatcherQueue.EnqueueAsync(() =>
+        {
+            _navigationService.NavigateTo(KnownPageKeys.SetupFlow, parameters);
+        });
+    }
+
     // Updates the last sync time on the UI thread after set delay
     private async Task UpdateLastSyncTimeUI(string time, TimeSpan delay, CancellationToken token)
     {
@@ -337,6 +349,7 @@ private async Task AddAllComputeSystemsFromAProvider(ComputeSystemsLoadedData da
                 computeSystem,
                 provider,
                 RemoveComputeSystemCard,
+                ConfigureComputeSystem,
                 packageFullName,
                 _mainWindow);
 

tools/Environments/DevHome.Environments/ViewModels/OperationsViewModel.cs

@@ -5,6 +5,7 @@
 using System.Threading.Tasks;
 using CommunityToolkit.Mvvm.Input;
 using CommunityToolkit.Mvvm.Messaging;
+using DevHome.Common.Environments.Models;
 using DevHome.Common.Services;
 using DevHome.Environments.Models;
 using Microsoft.UI.Xaml;
@@ -37,6 +38,10 @@ public partial class OperationsViewModel : IEquatable<OperationsViewModel>
 
     private readonly string _additionalContext = string.Empty;
 
+    private readonly Window? _mainWindow;
+
+    private readonly StringResource _stringResource = new("DevHome.Environments.pri", "DevHome.Environments/Resources");
+
     public string Name { get; }
 
     public ComputeSystemOperations ComputeSystemOperation { get; }
@@ -47,9 +52,9 @@ public partial class OperationsViewModel : IEquatable<OperationsViewModel>
 
     private Action? DevHomeAction { get; }
 
-    private readonly Window? _mainWindow;
+    private Action<ComputeSystemReviewItem>? DevHomeActionWithReviewItem { get; }
 
-    private readonly StringResource _stringResource = new("DevHome.Environments.pri", "DevHome.Environments/Resources");
+    private ComputeSystemReviewItem? _item;
 
     public OperationsViewModel(
         string name,
@@ -89,14 +94,36 @@ public OperationsViewModel(string name, string icon, Action command)
         DevHomeAction = command;
     }
 
+    public OperationsViewModel(
+        string name,
+        string icon,
+        Action<ComputeSystemReviewItem>? command,
+        ComputeSystemProvider provider,
+        ComputeSystemCache cache)
+    {
+        _operationKind = OperationKind.DevHomeAction;
+        Name = name;
+        IconGlyph = icon;
+        DevHomeActionWithReviewItem = command;
+        _item = new(cache, provider);
+    }
+
     private void RunAction()
     {
         // To Do: Need to disable the card UI while the operation is in progress and handle failures.
         Task.Run(async () =>
         {
             if (_operationKind == OperationKind.DevHomeAction)
             {
-                DevHomeAction!();
+                if (DevHomeAction != null)
+                {
+                    DevHomeAction();
+                }
+                else if (DevHomeActionWithReviewItem != null && _item != null)
+                {
+                    DevHomeActionWithReviewItem(_item);
+                }
+
                 return;
             }
 

tools/SetupFlow/DevHome.SetupFlow/Models/ConfigureTargetTask.cs

@@ -9,6 +9,7 @@
 using System.Threading;
 using System.Threading.Tasks;
 using CommunityToolkit.WinUI;
+using DevHome.Common.Environments.Models;
 using DevHome.Common.Environments.Services;
 using DevHome.Common.Extensions;
 using DevHome.Common.Services;
@@ -382,6 +383,11 @@ public void RemoveAdaptiveCardPanelFromLoadingUI()
         });
     }
 
+    public void SetTargetComputeSystem(ComputeSystemReviewItem item)
+    {
+         _computeSystemManager.ComputeSystemSetupItem = item;
+    }
+
     public IAsyncOperation<TaskFinishedState> Execute()
     {
         return Task.Run(async () =>

tools/SetupFlow/DevHome.SetupFlow/TaskGroups/SetupTargetTaskGroup.cs

@@ -13,6 +13,7 @@ namespace DevHome.SetupFlow.TaskGroups;
 public class SetupTargetTaskGroup : ISetupTaskGroup
 {
     private readonly SetupTargetViewModel _setupTargetViewModel;
+
     private readonly SetupTargetReviewViewModel _setupTargetReviewViewModel;
 
     private readonly ConfigureTargetTask _setupTargetTaskGroup;

tools/SetupFlow/DevHome.SetupFlow/ViewModels/MainPageViewModel.cs

@@ -7,6 +7,7 @@
 using System.Threading.Tasks;
 using CommunityToolkit.Mvvm.ComponentModel;
 using CommunityToolkit.Mvvm.Input;
+using DevHome.Common.Environments.Models;
 using DevHome.Common.Extensions;
 using DevHome.Common.Models;
 using DevHome.Common.Services;
@@ -226,6 +227,25 @@ private void StartSetupForTargetEnvironment(string flowTitle)
             _host.GetService<AppManagementTaskGroup>());
     }
 
+    /// <summary>
+    /// Starts the setup target flow from the environments page.
+    /// </summary>
+    public void StartSetupForTargetEnvironmentWithTelemetry(string flowTitle, string navigationAction, string originPage, ComputeSystemReviewItem item)
+    {
+        var setupTask = _host.GetService<SetupTargetTaskGroup>();
+
+        _log.Information("Starting setup for target environment from the Environments page");
+        StartSetupFlowForTaskGroups(
+            flowTitle,
+            "SetupTargetEnvironment",
+            setupTask,
+            _host.GetService<RepoConfigTaskGroup>(),
+            _host.GetService<AppManagementTaskGroup>());
+
+        setupTask.ConfigureTask.SetTargetComputeSystem(item);
+        Orchestrator.GoToNextPage().GetAwaiter().GetResult();
+    }
+
     /// <summary>
     /// Starts a setup flow that only includes repo config.
     /// </summary>

tools/SetupFlow/DevHome.SetupFlow/ViewModels/SetupFlowViewModel.cs

@@ -7,6 +7,7 @@
 using System.Threading.Tasks;
 using CommunityToolkit.Mvvm.ComponentModel;
 using CommunityToolkit.Mvvm.Input;
+using DevHome.Common.Environments.Models;
 using DevHome.Common.Extensions;
 using DevHome.Common.Services;
 using DevHome.Common.TelemetryEvents.SetupFlow;
@@ -29,6 +30,8 @@ public partial class SetupFlowViewModel : ObservableObject
 
     private readonly string _creationFlowNavigationParameter = "StartCreationFlow";
 
+    private readonly string _configurationFlowNavigationParameter = "StartConfigurationFlow";
+
     public SetupFlowOrchestrator Orchestrator { get; }
 
     public event EventHandler EndSetupFlow = (s, e) => { };
@@ -123,30 +126,52 @@ public async Task StartFileActivationFlowAsync(StorageFile file)
         await _mainPageViewModel.StartConfigurationFileAsync(file);
     }
 
-    public void StartCreationFlowAsync(string originPage)
+    public void StartCreationFlow(string originPage)
     {
         Orchestrator.FlowPages = [_mainPageViewModel];
 
         // This method is only called when the user clicks a button that redirects them to 'Create Environment' flow in the setup flow.
         _mainPageViewModel.StartCreateEnvironmentWithTelemetry(string.Empty, _creationFlowNavigationParameter, originPage);
     }
 
+    public void StartSetupFlow(string originPage, ComputeSystemReviewItem item)
+    {
+        Orchestrator.FlowPages = [_mainPageViewModel];
+
+        // This method is only called when the user clicks a button that redirects them to 'Setup' flow in the Environments page.
+        _mainPageViewModel.StartSetupForTargetEnvironmentWithTelemetry(string.Empty, _configurationFlowNavigationParameter, originPage, item);
+    }
+
     public void OnNavigatedTo(NavigationEventArgs args)
     {
         // The setup flow isn't setup to support using the navigation service to navigate to specific
         // pages. Instead we need to navigate to the main page and then start the creation flow template manually.
-        var parameter = args.Parameter?.ToString();
-
-        if ((!string.IsNullOrEmpty(parameter)) &&
-            parameter.Contains(_creationFlowNavigationParameter, StringComparison.OrdinalIgnoreCase) &&
-            Orchestrator.CurrentSetupFlowKind != SetupFlowKind.CreateEnvironment)
+        if (args.Parameter is object[] parameters && parameters.Length == 3)
         {
-            // We expect that when navigating from anywhere in Dev Home to the create environment page
-            // that the arg.Parameter variable be semicolon delimited string with the first value being 'StartCreationFlow'
-            // and the second value being the page name that redirection came from for telemetry purposes.
-            var parameters = parameter.Split(';');
-            Cancel();
-            StartCreationFlowAsync(originPage: parameters[1]);
+            if (parameters[0] is string parameter && parameter.Equals(_configurationFlowNavigationParameter, StringComparison.OrdinalIgnoreCase))
+            {
+                // We expect that when navigating from anywhere in Dev Home to the create environment page
+                // that the arg.Parameter variable be an object array with the the first value being 'StartCreationFlow',
+                // the second value being the page name that redirection came from for telemetry purposes, and
+                // the third value being the ComputeSystemReviewItem to setup.
+                Cancel();
+                StartSetupFlow(originPage: parameters[1] as string, item: parameters[2] as ComputeSystemReviewItem);
+            }
+        }
+        else
+        {
+            var parameter = args.Parameter?.ToString();
+            if (!string.IsNullOrEmpty(parameter) && Orchestrator.CurrentSetupFlowKind != SetupFlowKind.CreateEnvironment)
+            {
+                if (parameter.Contains(_creationFlowNavigationParameter, StringComparison.OrdinalIgnoreCase))
+                {
+                    // We expect that when navigating from anywhere in Dev Home to the create environment page
+                    // that the arg.Parameter variable be semicolon delimited string with the first value being 'StartCreationFlow'
+                    // and the second value being the page name that redirection came from for telemetry purposes.
+                    Cancel();
+                    StartCreationFlow(originPage: parameter.Split(';')[1]);
+                }
+            }
         }
     }