Refactor documentation to replace the Validation Harness with a separate E2E Test Suite, updating references throughout various documents. Adjust the autodev state to reflect the transition from the Decompose phase to the Implement phase, and revise the architecture documentation to clarify system boundaries and component relationships. Enhance risk mitigation documentation to specify affected components and update the component overview diagram accordingly.

2026-06-22 17:21:13 +00:00 · 2026-05-03 11:50:39 +03:00
parent 5bf2dbd85f
commit dd9afe2797
31 changed files with 1479 additions and 396 deletions
@@ -18,12 +18,11 @@ project-root/
 │   ├── camera_ingest_calibration/
 │   ├── basalt_vio_adapter/
 │   ├── safety_anchor_wrapper/
-│   ├── satellite_retrieval/
+│   ├── satellite_service/
 │   ├── anchor_verification/
-│   ├── cache_tile_lifecycle/
+│   ├── tile_manager/
 │   ├── mavlink_gcs_integration/
 │   ├── fdr_observability/
-│   ├── validation_harness/
 │   ├── shared/
 │   │   ├── contracts/
 │   │   ├── geo_geometry/
@@ -43,7 +42,8 @@ project-root/
 │   ├── integration/
 │   ├── blackbox/
 │   ├── fixtures/
-│   └── sitl/
+│   ├── sitl/
+│   └── e2e/
 ├── e2e/
 │   ├── replay/
 │   └── reports/
@@ -85,28 +85,27 @@ The scaffold separates runtime source, migrations, tests, deployment assets, con
 | DTO Name | Used By Components | Fields Summary |
 |----------|--------------------|----------------|
 | `FramePacket` | Camera ingest, BASALT VIO, Satellite Service, anchor verification, Tile Manager, FDR | Frame ID, timestamp, image reference, camera calibration ID, occlusion status, quality metrics |
-| `TelemetrySample` | MAVLink/GCS, BASALT VIO, safety wrapper, FDR, validation harness | Timestamp, IMU, attitude, airspeed, altitude, GPS health |
-| `VioStatePacket` | BASALT VIO, safety wrapper, FDR, validation harness | Timestamp, relative pose, velocity, bias, tracking quality, covariance hint |
-| `PositionEstimate` | Safety wrapper, MAVLink/GCS, Tile Manager, FDR, validation harness | WGS84 coordinates, covariance semi-major axis, source label, fix type, horizontal accuracy, anchor age |
+| `TelemetrySample` | MAVLink/GCS, BASALT VIO, safety wrapper, FDR, e2e tests | Timestamp, IMU, attitude, airspeed, altitude, GPS health |
+| `VioStatePacket` | BASALT VIO, safety wrapper, FDR, e2e tests | Timestamp, relative pose, velocity, bias, tracking quality, covariance hint |
+| `PositionEstimate` | Safety wrapper, MAVLink/GCS, Tile Manager, FDR, e2e tests | WGS84 coordinates, covariance semi-major axis, source label, fix type, horizontal accuracy, anchor age |
 | `VprCandidate` | Satellite Service, anchor verification, FDR | Chunk ID, tile ID, score, footprint, freshness status |
 | `AnchorDecision` | Anchor verification, safety wrapper, FDR | Candidate ID, acceptance result, estimated pose, inliers, MRE, rejection reason |
 | `CacheTileRecord` | Tile Manager, Satellite Service, anchor verification, FDR | Tile ID, type, CRS, meters per pixel, capture date, signature/hash status, trust level |
-| `FdrEvent` | All runtime components, validation harness | Event type, timestamp, component, severity, payload reference, mission/run ID |
-| `ScenarioReport` | Validation harness, CI/CD, release evidence | Scenario ID, result, metrics, artifacts, failure reason |
+| `FdrEvent` | All runtime components, e2e tests | Event type, timestamp, component, severity, payload reference, mission/run ID |
+| `ScenarioReport` | Separate e2e test suite, CI/CD, release evidence | Scenario ID, result, metrics, artifacts, failure reason |

 ### Component Interfaces

 | Component | Interface | Methods | Exposed To |
 |-----------|-----------|---------|------------|
 | Camera ingest/calibration | `FrameProvider` | `next_frame`, `detect_occlusion`, `classify_quality` | BASALT VIO, Satellite Service, anchor verification, Tile Manager |
-| BASALT VIO adapter | `VioAdapter` | `initialize`, `process`, `health` | Safety wrapper, validation harness |
-| Safety/anchor wrapper | `LocalizationStateMachine` | `update_vio`, `consider_anchor`, `degrade`, `propagate_imu_only`, `tile_write_eligibility` | MAVLink/GCS, Tile Manager, FDR, validation harness |
+| BASALT VIO adapter | `VioAdapter` | `initialize`, `process`, `health` | Safety wrapper, e2e tests |
+| Safety/anchor wrapper | `LocalizationStateMachine` | `update_vio`, `consider_anchor`, `degrade`, `propagate_imu_only`, `tile_write_eligibility` | MAVLink/GCS, Tile Manager, FDR, e2e tests |
 | Satellite Service | `SatelliteService` | `import_mission_cache`, `load_index`, `retrieve`, `upload_generated_tiles` | Safety wrapper, anchor verification, Tile Manager |
 | Anchor verification | `AnchorVerifier` | `verify`, `benchmark_matcher` | Safety wrapper, FDR |
 | Tile Manager | `TileManager` | `validate_cache`, `get_tile_window`, `orthorectify_frame`, `write_generated_tile`, `package_sync` | Satellite Service, anchor verification, post-flight sync |
 | MAVLink/GCS integration | `MavlinkGateway` | `subscribe_telemetry`, `emit_gps_input`, `emit_status` | BASALT VIO, safety wrapper, QGC, FDR |
-| FDR/observability | `FlightRecorder` | `append_event`, `rollover`, `export` | All runtime components, validation harness |
-| Validation harness | `ScenarioRunner` | `validate_fixture`, `run_scenario` | CI/CD, release evidence review |
+| FDR/observability | `FlightRecorder` | `append_event`, `rollover`, `export` | All runtime components, e2e tests |

 ## CI/CD Pipeline

@@ -182,7 +181,6 @@ tests/
 │   ├── tile_manager/
 │   ├── mavlink_gcs_integration/
 │   ├── fdr_observability/
-│   └── validation_harness/
 ├── integration/
 │   ├── contracts/
 │   ├── cache_postgis/
@@ -200,10 +198,14 @@ tests/
 │   ├── satellite_cache/
 │   ├── telemetry/
 │   └── public_dataset_slices/
-└── sitl/
-    ├── plane_gps_input/
-    ├── spoofing_promotion/
-    └── failsafe/
+├── sitl/
+│   ├── plane_gps_input/
+│   ├── spoofing_promotion/
+│   └── failsafe/
+└── e2e/
+    ├── replay/
+    ├── reports/
+    └── release_evidence/
 ```

 ### Test Configuration Notes