satellite-provider/_docs/03_implementation/batch_01_cycle4_report.md

Batch Report

Batch: 1 (cycle 4) Tasks: AZ-500_dotnet10_migration Date: 2026-05-12

Task Results

Task	Status	Files Modified	Tests	AC Coverage	Issues
AZ-500_dotnet10_migration	Done	18 source/config + 2 doc + 1 leftover	271/271 unit + full integration suite PASS	8/8 ACs covered	2 Medium (deferred, scope-protected) + 1 Low scope-doc

Files Modified (21 total)

Build / project files (12):

• global.json
• SatelliteProvider.Api/SatelliteProvider.Api.csproj
• SatelliteProvider.Common/SatelliteProvider.Common.csproj
• SatelliteProvider.DataAccess/SatelliteProvider.DataAccess.csproj
• SatelliteProvider.IntegrationTests/SatelliteProvider.IntegrationTests.csproj
• SatelliteProvider.Services.RegionProcessing/SatelliteProvider.Services.RegionProcessing.csproj
• SatelliteProvider.Services.RouteManagement/SatelliteProvider.Services.RouteManagement.csproj
• SatelliteProvider.Services.TileDownloader/SatelliteProvider.Services.TileDownloader.csproj
• SatelliteProvider.TestSupport/SatelliteProvider.TestSupport.csproj
• SatelliteProvider.Tests/SatelliteProvider.Tests.csproj
• SatelliteProvider.Api/Dockerfile
• SatelliteProvider.IntegrationTests/Dockerfile

Source code (2):

• SatelliteProvider.Api/Program.cs — Microsoft.OpenApi 2.x refactor (namespace + OpenApiSecuritySchemeReference + JsonSchemaType + IOpenApiSchema properties)
• SatelliteProvider.Api/Swagger/ParameterDescriptionFilter.cs — namespace update

Scripts / CI (3):

• scripts/run-tests.sh — 3× mcr.microsoft.com/dotnet/sdk:8.0 → :10.0
• scripts/run-performance-tests.sh — bin/Release/net8.0/ → bin/Release/net10.0/ (necessary for AC-5)
• .woodpecker/01-test.yml — mcr.microsoft.com/dotnet/sdk:8.0 → :10.0

Documentation (2):

• _docs/02_document/architecture.md — Tech Stack table + Architecture Vision prose updated to .NET 10
• AGENTS.md — Tech Stack section + Key packages list updated; Serilog.AspNetCore 8.0.3 fallback documented

Process (2):

• _docs/_autodev_state.md — phase tracking
• _docs/_process_leftovers/2026-05-12_perf-cycle3-harness-execution.md — replay #2 result added (bootstrap clean; PT-08 grep-pipefail bug surfaced as new follow-up)

Per-Task Notes

AZ-500: .NET 8 → .NET 10 migration

Implementation order (single batch, sequential):

1. Inventory current state: 9 csproj files on net8.0; global.json sdk.version=8.0.0; 4 Docker base image refs; 19 Microsoft.AspNetCore.* / Microsoft.Extensions.* package refs.
2. Bump global.json SDK pin to 10.0.0 / latestMinor.
3. Bump every <TargetFramework> from net8.0 to net10.0.
4. Bump all Microsoft.AspNetCore.* (8.0.25) and Microsoft.Extensions.* (9.0.10) packages to 10.0.7 (highest 10.0 patch on NuGet at run time).
5. Initial attempt with Serilog.AspNetCore 10.0.0 failed dotnet restore with NU1605 (transitive dep Serilog.Sinks.File >= 7.0.0 conflicts with the project's pinned 6.0.0). Per Risk #4 mitigation + "no unrelated package bumps" constraint, reverted Serilog.AspNetCore to 8.0.3 and documented in AGENTS.md.
6. Bump Docker base images in 2 Dockerfiles (aspnet:10.0, sdk:10.0, runtime:10.0).
7. Bump CI/script images: scripts/run-tests.sh (3 refs) + .woodpecker/01-test.yml (1 ref).
8. Initial Microsoft.AspNetCore.OpenApi 10.0.7 upgrade pulled Microsoft.OpenApi 2.x which removed the Microsoft.OpenApi.Models namespace. Compilation failed (CS0234, CS0246, CS7069) in Program.cs and ParameterDescriptionFilter.cs. User chose: bump Swashbuckle to 10.1.7 (which targets Microsoft.OpenApi 2.4.1) + refactor source to the 2.x API surface (OpenApiSecuritySchemeReference, JsonSchemaType, IOpenApiSchema dictionary properties, using Microsoft.OpenApi;).
9. After build clean, found one remaining compile error: OpenApiSecurityRequirement collection initializer expected List<string> and Swashbuckle's AddSecurityRequirement expected Func<OpenApiDocument, OpenApiSecurityRequirement>. Fixed by wrapping in lambda + new List<string>().
10. ./scripts/run-tests.sh --full → exit 0 (271/271 unit + full integration suite green).
11. docker compose up -d --build → API healthy on :18980 (anonymous request → 401, swagger → 200).
12. Found scripts/run-performance-tests.sh:49 had a hardcoded bin/Release/net8.0/ path that would fail post-migration; bumped to net10.0/.
13. AC-5 perf-bootstrap smoke (PERF_REPEAT_COUNT=2 PERF_UAV_BATCH_SIZE=2): build succeeded (no exit 3 — bootstrap clean), JWT mint OK, PT-01..PT-07 PASS. PT-08 crashed at rejected=$(grep -o ... | wc -l | tr -d ' ') because grep -o exits 1 on zero matches and set -o pipefail propagates. Pre-existing script bug, surfaced now because cycle 3 never reached PT-08. Documented in the perf-leftover file as a new follow-up; AC-5's bootstrap-only gate is satisfied.
14. AC-8 docs verified via grep over architecture.md and AGENTS.md — both reflect .NET 10 / ASP.NET Core 10.

Unresolved questions: none.

Blockers: none.

AC Test Coverage

All 8 ACs covered (full trace in reviews/batch_01_cycle4_review.md → "AC Verification Trace"). Verification mix matches the task spec's Blackbox Tests table: AC-1/2/3/4/8 by grep, AC-6 by ./scripts/run-tests.sh --full, AC-7 by docker compose build, AC-5 by manual smoke run.

Code Review Verdict

PASS_WITH_WARNINGS — see _docs/03_implementation/reviews/batch_01_cycle4_review.md.

Findings (all deferred per "scope discipline"; see review report Findings section + Recommended Follow-Up PBIs):

1. F1 Medium — WithOpenApi(...) deprecation (ASPDEPR002) at 8 callsites in Program.cs. Migration intentionally preserved API surface per Risk #2.
2. F2 Medium — CS8604 nullable warning in ParameterDescriptionFilter.cs:25 from Microsoft.OpenApi 2.x stricter annotations.
3. F3 Low — scripts/run-performance-tests.sh:49 path fix was implicit in AC-5 but not in Scope/Included. Necessary, accepted.

Auto-Fix Attempts

0 (no FAIL findings; PASS_WITH_WARNINGS proceeds without auto-fix).

Stuck Agents

None.

Next Batch

All AZ-500 work complete. Next: implement-skill Step 13 (archive task to _docs/02_tasks/done/) → Step 15 (Product Implementation Completeness Gate) → Step 16 (full test run is already green; record handoff to test-run skill in autodev Step 11) → autodev Step 11 (Run Tests) → Step 12 (Test-Spec Sync) → ...