build(log): Enable diagnostic log verbosity for troubleshooting

Author: arturcic

build/.run/Build Prepare.run.xml

@@ -6,10 +6,14 @@
     <option name="PASS_PARENT_ENVS" value="1" />
     <envs>
       <env name="DOTNET_ROLL_FORWARD" value="Major" />
+      <env name="ENABLED_DIAGNOSTICS" value="false" />
     </envs>
-    <option name="USE_EXTERNAL_CONSOLE" value="0" />
+    <option name="ENV_FILE_PATHS" value="" />
+    <option name="REDIRECT_INPUT_PATH" value="" />
+    <option name="MIXED_MODE_DEBUG" value="0" />
     <option name="USE_MONO" value="0" />
     <option name="RUNTIME_ARGUMENTS" value="" />
+    <option name="AUTO_ATTACH_CHILDREN" value="0" />
     <option name="PROJECT_PATH" value="$PROJECT_DIR$/build/build.csproj" />
     <option name="PROJECT_EXE_PATH_TRACKING" value="1" />
     <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
@@ -20,4 +24,4 @@
       <option name="Build" />
     </method>
   </configuration>
-</component>
+</component>

build/build/BuildLifetime.cs

@@ -1,6 +1,7 @@
 using Build.Utilities;
 using Common.Lifetime;
 using Common.Utilities;
+using EnvVars = Build.Utilities.EnvVars;
 
 namespace Build;
 

build/build/Utilities/EnvVars.cs

@@ -1,6 +1,6 @@
 namespace Build.Utilities;
 
-public class EnvVars
+public class EnvVars : Common.Utilities.EnvVars
 {
     public const string EnabledUnitTests = "ENABLED_UNIT_TESTS";
 }

build/common/Lifetime/BuildLifetimeBase.cs

@@ -9,6 +9,14 @@ public class BuildLifetimeBase<T> : FrostingLifetime<T> where T : BuildContextBa
     public override void Setup(T context, ISetupContext info)
     {
         var buildSystem = context.BuildSystem();
+        var isDebug = context.IsEnabled(EnvVars.ActionsRunnerDebug, false);
+        var isStepDebug = context.IsEnabled(EnvVars.ActionsStepDebug, false);
+        var isDiagnosticsEnabled = context.IsEnabled(EnvVars.EnabledDiagnostics, false);
+        if (isDebug || isStepDebug || isDiagnosticsEnabled)
+        {
+            context.Log.Verbosity = Verbosity.Diagnostic;
+        }
+
         context.IsLocalBuild = buildSystem.IsLocalBuild;
         context.IsAzurePipelineBuild = buildSystem.IsRunningOnAzurePipelines;
         context.IsGitHubActionsBuild = buildSystem.IsRunningOnGitHubActions;

build/common/Utilities/EnvVars.cs

@@ -0,0 +1,8 @@
+namespace Common.Utilities;
+
+public class EnvVars
+{
+    public const string EnabledDiagnostics = "ENABLED_DIAGNOSTICS";
+    public const string ActionsRunnerDebug = "ACTIONS_RUNNER_DEBUG";
+    public const string ActionsStepDebug = "ACTIONS_STEP_DEBUG";
+}