Enhance launch configurations and tasks for improved debugging experience and terminal management

- Simplified pre-launch task for PowerShell launch
- Updated program path for migration executable
- Changed terminal panel to dedicated for repeated launches
- Added optional pause on exit for better visibility in external terminal
- Improved error logging in VersionOptions

Author: MrHinsh

.vscode/launch.json

@@ -16,16 +16,23 @@
             "name": "Full execute",
             "type": "clr",
             "request": "launch",
-            "preLaunchTask": "build full framework",
-            "program": "${workspaceFolder}/src/MigrationTools.ConsoleFull/bin/Debug/net472/migration.exe",
+            // Use a lightweight build to avoid long pre-launch chains that delay debugger attach
+            "preLaunchTask": "build",
+            // Full .NET Framework exe built for net472 – coreclr debugger can launch it.
+            "program": "${workspaceFolder}/src/MigrationTools.ConsoleFull/bin/Debug/net472/devopsmigration.exe",
             "args": [
                 "execute",
                 "-c",
-                "configuration.json"
+                "configuration-default.json"
             ],
-            "cwd": "${workspaceFolder}/src/MigrationTools.ConsoleFull/bin/Debug/net472/",
+            "cwd": "${workspaceFolder}/src/MigrationTools.ConsoleFull/bin/Debug/net472",
+            // Use external terminal so it opens a new window and stays after exit (pause handled in code when env var set)
             "console": "externalTerminal",
-            "stopAtEntry": false
+            "stopAtEntry": false,
+            "justMyCode": true,
+            "env": {
+                "MIGRATIONTOOLS_PAUSE_ON_EXIT": "1"
+            }
         },
         {
             "name": "Attach to .NET Functions",

.vscode/tasks.json

@@ -39,8 +39,9 @@
                 "isDefault": true
             },
             "presentation": {
+                // Use a single dedicated panel so repeated launches do not create many terminals
                 "reveal": "always",
-                "panel": "new"
+                "panel": "dedicated"
             }
         },
         {
@@ -83,8 +84,9 @@
             "command": "${workspaceFolder}/GenerateDocs.ps1",
             "group": "build",
             "presentation": {
+                // Share panel with prior executions instead of creating a new terminal each time
                 "reveal": "always",
-                "panel": "new"
+                "panel": "dedicated"
             },
             "problemMatcher": "$msCompile"
         },

buildDocs.ps1

@@ -2,11 +2,11 @@ $msBuildExe = 'C:\Program Files (x86)\MSBuild\14.0\Bin\msbuild.exe'
 & nuget restore
 & "$($msBuildExe)" "MigrationTools.sln" /t:Build /m
 
-& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\migration.exe" init --config ".\docs\Reference\Generated\configuration.config"
-& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\migration.exe" init --options Full --config ".\docs\Reference\Generated\configuration-Full.config"
-& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\migration.exe" init --options WorkItemTracking --config ".\docs\Reference\Generated\configuration-WorkItemTracking.config"
-& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\migration.exe" init --options Fullv2 --config ".\docs\Reference\Generated\configuration-Fullv2.config"
-& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\migration.exe" init --options WorkItemTrackingv2 --config ".\docs\Reference\Generated\configuration-WorkItemTrackingv2.config"
+& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\devopsmigration.exe" init --config ".\docs\Reference\Generated\configuration.config"
+& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\devopsmigration.exe" init --options Full --config ".\docs\Reference\Generated\configuration-Full.config"
+& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\devopsmigration.exe" init --options WorkItemTracking --config ".\docs\Reference\Generated\configuration-WorkItemTracking.config"
+& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\devopsmigration.exe" init --options Fullv2 --config ".\docs\Reference\Generated\configuration-Fullv2.config"
+& ".\src\MigrationTools.ConsoleFull\bin\Debug\net472\devopsmigration.exe" init --options WorkItemTrackingv2 --config ".\docs\Reference\Generated\configuration-WorkItemTrackingv2.config"
 
 
 

src/MigrationTools.ConsoleFull/Program.cs

@@ -1,5 +1,6 @@
 using System;
 using System.IO;
+using System.Diagnostics;
 using System.Linq;
 using System.Reflection;
 using System.Threading.Tasks;
@@ -56,6 +57,20 @@ public static async Task Main(string[] args)
                         services.AddMigrationToolServicesForClientTfs_Processors();
                     });
                 await hostBuilder.RunConsoleAsync();
+
+                // Optional pause so an external terminal launched under the debugger stays open.
+                try
+                {
+                    var pauseEnv = Environment.GetEnvironmentVariable("MIGRATIONTOOLS_PAUSE_ON_EXIT");
+                    if (Debugger.IsAttached || (pauseEnv != null && (pauseEnv.Equals("1", StringComparison.OrdinalIgnoreCase) || pauseEnv.Equals("true", StringComparison.OrdinalIgnoreCase))))
+                    {
+                        Console.WriteLine();
+                        Console.WriteLine("Execution complete.");
+                        Console.Write("Press Enter to close this window...");
+                        Console.ReadLine();
+                    }
+                }
+                catch { /* swallow any console IO exceptions (e.g., redirected output) */ }
             }
         }
 

src/MigrationTools/Options/VersionOptions.cs

@@ -240,8 +240,9 @@ private static JSchema LoadConfigurationSchema()
                     // For now, return null to indicate schema couldn't be loaded
                     return null;
                 }
-                catch
+                catch (Exception ex)
                 {
+                    Log.Error(ex.ToString());
                     return null;
                 }
             }