🐛 Nuke unit-tests target fails with AggregateException and dotnet exit code 2 while direct unit tests pass

[candoumbe]

Environment

• Consumer repository: agenda
• Pipelines package: Candoumbe.Pipelines 2.0.0
• .NET SDK: 10.0.201
• OS: Linux (dev container)
• Test runner context: Microsoft.Testing.Platform enabled in global.json and tests.props

What I expected

Running the unit-tests target should provide a deterministic unit-test signal:

• fail only when unit tests fail, or
• fail with a clear, isolated reason directly tied to test orchestration.

What happened

Running:
./build.sh unit-tests

fails in Nuke summary with:

• UnitTests failed
• AggregateException
• Process dotnet exited with code 2
• downstream test-related targets not run

At the same time:

• running ./build.sh unit-tests --skip Format can succeed
• direct unit test execution succeeds (validated examples):
  • Agenda.API.UnitTests: 44/44 passed
  • Agenda.Objects.UnitTests: 21/21 passed

Additionally, the same unit-tests invocation traverses non-unit-test concerns (Format, BuildFrontend), which can introduce unrelated blockers (package vulnerability audit messages, frontend budget warnings), making diagnosis difficult.

Repro steps

1. Use a consumer project with:
   • Candoumbe.Pipelines 2.0.0
   • .NET SDK 10.0.201
   • Microsoft.Testing.Platform enabled
2. Run:
   ./build.sh unit-tests
3. Observe Nuke summary failure on UnitTests with AggregateException and dotnet exit code 2.
4. Compare with:
   ./build.sh unit-tests --skip Format
5. Compare with direct test runs:
   dotnet test tests/Agenda.API.UnitTests/Agenda.API.UnitTests.csproj
dotnet test tests/Agenda.Objects.UnitTests/Agenda.Objects.UnitTests.csproj

Short log snippet

Target UnitTests has thrown an exception
AggregateException: One or more errors occurred.
Process dotnet exited with code 2.
Nuke summary: UnitTests failed; downstream targets not run.

Impact

• Hard to distinguish true unit test failures from orchestration/precondition failures.
• Slower CI and local triage.
• Reduced confidence in the unit-tests target as a test-only quality gate.

Suspected root cause

Possible orchestration coupling in the unit-tests flow:

• non-unit-test stages are part of the same execution path
• when one of those stages or command wiring fails, the top-level signal appears as a generic UnitTests AggregateException, obscuring root cause.

Proposed improvements

1. Provide a strict unit-tests mode that excludes unrelated concerns (format/frontend/audit) by default.
2. Improve error reporting to clearly attribute failure to the exact sub-step and command.
3. Distinguish in summary:
   • test assertion failures
   • prerequisite/pipeline failures
   • process invocation failures
4. Document recommended behavior with .NET 10 and Microsoft.Testing.Platform enabled.

Optional workaround

• Use:
  ./build.sh unit-tests --skip Format
• Validate unit test health independently with direct dotnet test commands while diagnosing orchestration issues.

Could you please confirm whether this behavior is expected in Candoumbe.Pipelines 2.0.0, and what target strategy you recommend for a strict, deterministic unit-test gate?

[github-actions]

🔄 Ralph — Auto-Triage

Assigned to: Fenster
Reason: Matched backend/API role keywords
Source: role-keyword

Ralph auto-triaged this issue using routing rules.
To reassign, swap the squad:* label.

[github-actions]

🔄 Ralph — Auto-Triage

Assigned to: Fenster
Reason: Matched backend/API role keywords
Source: role-keyword

Ralph auto-triaged this issue using routing rules.
To reassign, swap the squad:* label.

[github-actions]

🔄 Ralph — Auto-Triage

Assigned to: Fenster
Reason: Matched backend/API role keywords
Source: role-keyword

Ralph auto-triaged this issue using routing rules.
To reassign, swap the squad:* label.

[github-actions]

🏗️ Squad Triage — Keaton (Lead)

Issue: #247 — Nuke unit-tests target fails with AggregateException and dotnet exit code 2 while direct unit tests pass
Assigned to: @copilot (Coding Agent)
Reason: 🟢 Good fit for @copilot — matches capability profile

Team roster:

• Keaton (Lead) → label: squad:keaton
• Fenster (Backend Dev) → label: squad:fenster
• Hockney (Tester) → label: squad:hockney
• McManus (DevOps/Release) → label: squad:mcmanus
• Verbal (Docs/Developer Experience) → label: squad:verbal
• Kobayashi (Security/Compliance) → label: squad:kobayashi
• Ralph (Work Monitor) → label: squad:ralph
• @copilot (Coding Agent) → label: squad:copilot

To reassign, remove the current squad:* label and add the correct one.

[candoumbe]

The issue is in the IUnitTest component which default implementation calls SetProjectFile(xxxx) to define the unit test project file.
In cases where Microsoft.Testing.Platform is enabled, the expected way to do it is via --project option instead.