Files
gps-denied-onboard/e2e/_unit_tests/fixtures/test_cold_boot_fixture.py
T
Oleksandr Bezdieniezhnykh 6599d828d2 [AZ-407] [AZ-444] [AZ-445] Batch 68: fixtures, Tier-2 harness, NFR reporter
Three blackbox-harness tasks landed together — all depend only on
AZ-406 and unblock the FT-* / NFT-* scenario tasks scheduled for
batches 69+.

AZ-407 — Static fixture builders (3pt):
  * tile-cache-builder/{builder.py, Dockerfile, build.sh} produces a
    deterministic tile-cache-fixture Docker volume from
    _docs/00_problem/input_data/. Reproducibility primitives: sorted
    iteration, frozen PIL JPEG settings, FAISS HNSW32 built single-
    threaded with seeded stub descriptors.
  * age-injector/{age_injector.py, inject.sh} clones the volume and
    shifts capture_date by N×30.44 days; tile JPEG bytes preserved
    bit-identical. Emits synth-age-7mo + synth-age-13mo volumes.
  * cold-boot/cold_boot_fixture.json: frozen FC pose snapshot at
    Derkachi sector centre, schema v1.
  * secrets/mavlink-test-passkey.txt: 64-hex with required
    `# TEST ONLY` header line per AC-5. Passkey-equality test now
    compares the secret line after stripping the header.
  * security/cve-2025-53644.jpg: synthetic 158-byte malformed JPEG
    (truncated SOS marker). OpenCV 4.11.x rejects gracefully with
    imdecode → None. AZ-439 will sharpen for ASan instrumentation.
  * Top-level Makefile with `make fixtures` / `make fixtures-*` /
    `make e2e-tier1*` / `make unit-tests` targets.

AZ-444 — Tier-2 Jetson harness wrapper (5pt):
  * run-tier2.sh rewritten as orchestrator. Detects local
    (aarch64 + TIER2_HOST=localhost) vs remote (ssh into TIER2_HOST).
    New flags: -k/--selector, --build-kind production|asan,
    --reflash (gated behind TIER2_REFLASH_ACK=1 two-key gate),
    --dry-run.
  * tier2-on-jetson.sh (new) — on-device delegate. Verifies
    gps-denied-onboard{,-asan}.service health; restarts with 5s
    tolerance; spawns tegrastats + jtop parallel samplers; tails
    ASan unit's journal in asan mode; drives docker compose with
    TIER=tier2-jetson; forwards SELECTOR to pytest -k.
  * docker/run-tier1.sh (new) — selector-parity sibling.
  * AC-1 (selector parity) and AC-6 (reflash gating) unit-tested via
    --dry-run output assertions. AC-2/AC-3/AC-4/AC-5 are hardware-
    loop ACs verified by the Tier-2 runtime smoke (no Jetson in the
    unit-test layer).

AZ-445 — CSV reporter + evidence bundler refinements (2pt):
  * reporting/nfr_recorder.py (new) — pytest plugin. Provides the
    `nfr_recorder` fixture with record_metric(name, value, ac_id)
    and partial(ac_id, reason). At session end emits:
      - per-nfr/<scenario_id>.json (AC-1)
      - traceability-status.json with every AC ID parsed from
        traceability-matrix.md, classified Covered/PARTIAL/NOT
        COVERED with source scenario IDs (AC-2)
      - regression-baseline.json with all numeric metrics (AC-3)
  * csv_reporter.py extended — `_outcome_to_result` consults the
    aggregator; rows flip PASS → PARTIAL when an AC was marked
    PARTIAL by nfr_recorder (AC-4). Graceful fallback when
    aggregator isn't registered (unit-test contexts).
  * conftest.py registers nfr_recorder in pytest_plugins.
  * New --traceability-matrix CLI flag seeds the NOT COVERED rows.

Build / config:
  * pyproject.toml dev extras: added Pillow>=10.4,<13.0 for the
    tile-cache-builder unit test (broad enough to keep torchvision's
    Pillow 12 pin happy; the production builder runs inside its own
    Docker image with its own pin).
  * Updated test_directory_layout.py to cover 10 new files + replaced
    the byte-equal passkey assertion with the header-stripping
    variant.

Test results:
  * 157 focused tests pass (was 97 in batch 67; +60 new across this
    batch). No regressions.

Module-layout / spec drift:
  * AZ-407 spec text says `tests/fixtures/...`; module-layout
    blackbox_tests entry (commit d7a17a8) authoritatively places the
    harness under `e2e/`. Implementation followed the layout entry.
  * AZ-444 spec mentions `e2e/tier2/run-tier2.sh`; AZ-406 placed it
    at `e2e/jetson/run-tier2.sh`. Kept at `e2e/jetson/` for
    consistency.
  * Cold-boot README ownership: corrected from AZ-419 to AZ-407 per
    AZ-419's own Dependencies field.

Specs archived to _docs/02_tasks/done/. Jira tickets transitioned to
In Testing on commit.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-16 17:18:01 +03:00

85 lines
2.4 KiB
Python

"""Tests for the AZ-407 cold-boot fixture.
AC-4 (SITL loads pose within ±1 m) requires SITL which the unit-test
layer cannot run; that path is covered by AZ-419's FT-P-11 inside the
Docker-bound runner. AZ-407's unit-test obligation is to verify the
JSON shape and bounds.
"""
from __future__ import annotations
import json
from pathlib import Path
import pytest
REPO_ROOT = Path(__file__).resolve().parents[3]
FIXTURE_PATH = REPO_ROOT / "e2e" / "fixtures" / "cold-boot" / "cold_boot_fixture.json"
@pytest.fixture(scope="module")
def cold_boot() -> dict:
return json.loads(FIXTURE_PATH.read_text())
def test_schema_version(cold_boot: dict) -> None:
"""The schema field locks the file shape; AZ-419's loader keys off it."""
# Assert
assert cold_boot["_schema"] == "cold-boot-fixture/v1"
def test_global_position_int_block(cold_boot: dict) -> None:
"""GLOBAL_POSITION_INT fields use canonical MAVLink units."""
# Arrange
gpi = cold_boot["global_position_int"]
# Assert
required = {
"time_boot_ms",
"lat_e7",
"lon_e7",
"alt_mm",
"relative_alt_mm",
"vx_cm_s",
"vy_cm_s",
"vz_cm_s",
"hdg_cdeg",
}
assert required <= set(gpi), f"missing fields: {required - set(gpi)}"
assert -90 * 10**7 <= gpi["lat_e7"] <= 90 * 10**7
assert -180 * 10**7 <= gpi["lon_e7"] <= 180 * 10**7
assert -50_000_000 <= gpi["alt_mm"] <= 50_000_000
def test_attitude_block(cold_boot: dict) -> None:
"""Attitude angles fall inside [-pi, pi]."""
# Arrange
att = cold_boot["attitude"]
import math
# Assert
for field in ("roll_rad", "pitch_rad", "yaw_rad"):
assert -math.pi <= att[field] <= math.pi, f"{field} out of range: {att[field]}"
def test_derkachi_lat_lon_inside_bbox(cold_boot: dict) -> None:
"""The frozen pose must be inside the Derkachi route bbox used by C2."""
# Arrange
lat = cold_boot["global_position_int"]["lat_e7"] / 10**7
lon = cold_boot["global_position_int"]["lon_e7"] / 10**7
# Assert
assert 50.05 <= lat <= 50.10, f"lat {lat} outside Derkachi bbox"
assert 36.10 <= lon <= 36.20, f"lon {lon} outside Derkachi bbox"
def test_provenance_block_present(cold_boot: dict) -> None:
"""AC-7: license + provenance fields documented inside the JSON itself."""
# Assert
assert "_license" in cold_boot
assert "_provenance" in cold_boot
assert "AZ-419" in cold_boot["_authored_for"][1]