feat: rich HTML test reports

.github/actions/execute-pipeline/action.yml

@@ -38,4 +38,6 @@ runs:
         DOTNET_ENVIRONMENT: ${{ inputs.environment }}
         NuGet__ApiKey: ${{ inputs.nuget-apikey }}
         NuGet__ShouldPublish: ${{ inputs.publish-packages }}
-        NET_VERSION: ${{ inputs.netversion }}
+        NET_VERSION: ${{ inputs.netversion }}
+        ACTIONS_RUNTIME_TOKEN: ${{ env.ACTIONS_RUNTIME_TOKEN }}
+        ACTIONS_RESULTS_URL: ${{ env.ACTIONS_RESULTS_URL }}

.github/workflows/dotnet.yml

@@ -122,6 +122,13 @@ jobs:
       - name: Publish AOT
         run: dotnet publish TUnit.TestProject/TUnit.TestProject.csproj -c Release --use-current-runtime -p:Aot=true -o TESTPROJECT_AOT --framework net10.0
 
+      - name: Expose GitHub Actions Runtime
+        uses: actions/github-script@v7
+        with:
+          script: |
+            core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env['ACTIONS_RUNTIME_TOKEN']);
+            core.exportVariable('ACTIONS_RESULTS_URL', process.env['ACTIONS_RESULTS_URL']);
+
       - name: Run Pipeline
         uses: ./.github/actions/execute-pipeline
         with:

TUnit.Core/Interfaces/ITestOutput.cs

@@ -24,6 +24,7 @@ public interface ITestOutput
     /// Gets the collection of timing measurements recorded during test execution.
     /// Useful for performance profiling and identifying bottlenecks.
     /// </summary>
+    [Obsolete("Use OpenTelemetry activity spans instead. Hook timings are now automatically recorded as OTel child spans of the test activity.")]
     IReadOnlyCollection<Timing> Timings { get; }
 
     /// <summary>
@@ -37,6 +38,7 @@ public interface ITestOutput
     /// Thread-safe for concurrent calls.
     /// </summary>
     /// <param name="timing">The timing information to record</param>
+    [Obsolete("Use OpenTelemetry activity spans instead. Hook timings are now automatically recorded as OTel child spans of the test activity.")]
     void RecordTiming(Timing timing);
 
     /// <summary>

TUnit.Core/TestContext.Output.cs

@@ -10,6 +10,7 @@ namespace TUnit.Core;
 /// </summary>
 public partial class TestContext
 {
+#pragma warning disable CS0618 // Obsolete Timing API — internal backing for interface implementation
     // Internal backing fields and properties
     internal ConcurrentBag<Timing> Timings { get; } = [];
     private readonly ConcurrentBag<Artifact> _artifactsBag = new();
@@ -20,12 +21,15 @@ public partial class TestContext
     TextWriter ITestOutput.StandardOutput => OutputWriter;
     TextWriter ITestOutput.ErrorOutput => ErrorOutputWriter;
     IReadOnlyCollection<Timing> ITestOutput.Timings => Timings;
+#pragma warning restore CS0618
     IReadOnlyCollection<Artifact> ITestOutput.Artifacts => Artifacts;
 
+#pragma warning disable CS0618 // Obsolete Timing API — internal backing for interface implementation
     void ITestOutput.RecordTiming(Timing timing)
     {
         Timings.Add(timing);
     }
+#pragma warning restore CS0618
 
     void ITestOutput.AttachArtifact(Artifact artifact)
     {

TUnit.Core/Timing.cs

@@ -1,5 +1,6 @@
 namespace TUnit.Core;
 
+[Obsolete("Use OpenTelemetry activity spans instead. Hook timings are now automatically recorded as OTel child spans of the test activity.")]
 public record Timing(string StepName, DateTimeOffset Start, DateTimeOffset End)
 {
     public TimeSpan Duration => End - Start;

TUnit.Engine/Configuration/EnvironmentConstants.cs

@@ -5,6 +5,7 @@ internal static class EnvironmentConstants
     // TUnit-specific: Reporters
     public const string DisableGithubReporter = "TUNIT_DISABLE_GITHUB_REPORTER";
     public const string DisableJUnitReporter = "TUNIT_DISABLE_JUNIT_REPORTER";
+    public const string DisableHtmlReporter = "TUNIT_DISABLE_HTML_REPORTER";
     public const string EnableJUnitReporter = "TUNIT_ENABLE_JUNIT_REPORTER";
     public const string GitHubReporterStyle = "TUNIT_GITHUB_REPORTER_STYLE";
 
@@ -28,4 +29,16 @@ internal static class EnvironmentConstants
     public const string GitHubStepSummary = "GITHUB_STEP_SUMMARY";
     public const string GitLabCi = "GITLAB_CI";
     public const string CiServer = "CI_SERVER";
+
+    // GitHub Actions runtime (for artifact upload)
+    public const string ActionsRuntimeToken = "ACTIONS_RUNTIME_TOKEN";
+    public const string ActionsResultsUrl = "ACTIONS_RESULTS_URL";
+    public const string GitHubRepository = "GITHUB_REPOSITORY";
+    public const string GitHubRunId = "GITHUB_RUN_ID";
+
+    // GitHub Actions context (for CI metadata in reports)
+    public const string GitHubSha = "GITHUB_SHA";
+    public const string GitHubRef = "GITHUB_REF";
+    public const string GitHubHeadRef = "GITHUB_HEAD_REF";
+    public const string GitHubEventName = "GITHUB_EVENT_NAME";
 }

TUnit.Engine/Extensions/TestApplicationBuilderExtensions.cs

@@ -24,7 +24,7 @@ public static void AddTUnit(this ITestApplicationBuilder testApplicationBuilder)
         var junitReporter = new JUnitReporter(extension);
         var junitReporterCommandProvider = new JUnitReporterCommandProvider(extension);
 
-        var htmlReporter = new HtmlReporter(extension);
+        var htmlReporter = new Reporters.Html.HtmlReporter(extension);
         var htmlReporterCommandProvider = new HtmlReporterCommandProvider(extension);
 
         testApplicationBuilder.RegisterTestFramework(
@@ -87,16 +87,15 @@ public static void AddTUnit(this ITestApplicationBuilder testApplicationBuilder)
         {
             var commandLineOptions = serviceProvider.GetRequiredService<ICommandLineOptions>();
 
-            // Enable if --report-html flag is set or --report-html-filename is provided
-            if (commandLineOptions.IsOptionSet(HtmlReporterCommandProvider.ReportHtml)
-                || commandLineOptions.TryGetOptionArgumentList(HtmlReporterCommandProvider.ReportHtmlFilename, out _))
+            // Deprecated: --report-html is now a no-op (reporter is always-on)
+            if (commandLineOptions.IsOptionSet(HtmlReporterCommandProvider.ReportHtml))
             {
-                htmlReporter.Enable();
+                Console.WriteLine("Warning: --report-html is deprecated. The HTML report is now generated by default. Use TUNIT_DISABLE_HTML_REPORTER=true to disable.");
             }
 
             if (commandLineOptions.TryGetOptionArgumentList(HtmlReporterCommandProvider.ReportHtmlFilename, out var pathArgs))
             {
-                htmlReporter.SetOutputPath(pathArgs[0]);
+                htmlReporter.SetOutputPath(Helpers.PathValidator.ValidateAndNormalizePath(pathArgs[0], HtmlReporterCommandProvider.ReportHtmlFilename));
             }
 
             return htmlReporter;

TUnit.Engine/Extensions/TestExtensions.cs

@@ -291,6 +291,7 @@ private static bool IsTrxEnabled(TestContext testContext)
         return _cachedIsTrxEnabled.Value;
     }
 
+#pragma warning disable CS0618 // Obsolete Timing API — still needed for TimingProperty reporting
     private static TimingProperty GetTimingProperty(TestContext testContext, DateTimeOffset overallStart)
     {
         if (overallStart == default(DateTimeOffset))
@@ -309,6 +310,7 @@ private static TimingProperty GetTimingProperty(TestContext testContext, DateTim
 
         return new TimingProperty(new TimingInfo(overallStart, end, end - overallStart), stepTimings);
     }
+#pragma warning restore CS0618
 
     private static IEnumerable<TrxMessage> GetTrxMessages(TestContext testContext, string? standardOutput, string? standardError)
     {