acdream/tests/AcDream.Headless.Tests/HeadlessStaticStateAuditTests.cs

using AcDream.Core.Physics;
using AcDream.Headless.Configuration;
using AcDream.Headless.Diagnostics;
using AcDream.Headless.Hosting;

namespace AcDream.Headless.Tests;

/// <summary>
/// #365 Step 1: the audit's refusal rationale is multi-root attribution
/// ambiguity, which does not hold for a process that owns exactly one
/// session. These tests mutate <see cref="PhysicsDiagnostics"/> process-
/// global probe flags, so they run in their own non-parallel collection —
/// see <see cref="HeadlessStaticStateAuditCollection"/>. Consolidated-
/// review round (2026-08-10), NIT (a): the single-session log line now
/// routes through the injected <see cref="HeadlessDiagnosticWriter"/>
/// instead of <see cref="Console.Out"/>, so these tests capture its
/// backing <see cref="TextWriter"/> directly rather than swapping the
/// process-global console.
/// </summary>
[CollectionDefinition(
    HeadlessStaticStateAuditCollection.Name,
    DisableParallelization = true)]
public sealed class HeadlessStaticStateAuditCollection
{
    public const string Name = "Headless static-state audit";
}

[Collection(HeadlessStaticStateAuditCollection.Name)]
public sealed class HeadlessStaticStateAuditTests : IDisposable
{
    public HeadlessStaticStateAuditTests() => PhysicsDiagnostics.ResetForTest();

    public void Dispose() => PhysicsDiagnostics.ResetForTest();

    [Fact]
    public void SingleSessionWithProbeEnabledIsAllowedAndLoggedLoudly()
    {
        PhysicsDiagnostics.ProbeParkEnabled = true;
        using var captured = new StringWriter();
        var diagnostics = new HeadlessDiagnosticWriter(captured);

        HeadlessStaticStateAudit.ValidateProcessIsolation(
            sessionCount: 1, diagnostics);

        Assert.Contains(
            nameof(PhysicsDiagnostics.ProbeParkEnabled),
            captured.ToString(),
            StringComparison.Ordinal);
    }

    [Fact]
    public void SingleSessionWithNoProbesEnabledIsSilent()
    {
        using var captured = new StringWriter();
        var diagnostics = new HeadlessDiagnosticWriter(captured);

        HeadlessStaticStateAudit.ValidateProcessIsolation(
            sessionCount: 1, diagnostics);

        Assert.Equal(string.Empty, captured.ToString());
    }

    [Fact]
    public void MultiSessionWithProbeEnabledStillThrowsNamingTheProbe()
    {
        PhysicsDiagnostics.ProbeParkEnabled = true;
        var diagnostics = new HeadlessDiagnosticWriter(TextWriter.Null);

        HeadlessConfigurationException exception = Assert.Throws<
            HeadlessConfigurationException>(
                () => HeadlessStaticStateAudit.ValidateProcessIsolation(
                    sessionCount: 2, diagnostics));

        Assert.Contains(
            nameof(PhysicsDiagnostics.ProbeParkEnabled),
            exception.Message,
            StringComparison.Ordinal);
    }

    [Fact]
    public void MultiSessionWithNoProbesEnabledIsAllowed()
    {
        var diagnostics = new HeadlessDiagnosticWriter(TextWriter.Null);

        Exception? exception = Record.Exception(
            () => HeadlessStaticStateAudit.ValidateProcessIsolation(
                sessionCount: 3, diagnostics));

        Assert.Null(exception);
    }
}