Skip to content

Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)

Check progress reconstruction against recorded checkpoints in CI

Cinna Davis4aeba65a180f
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 36aeb07..8912688 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -43,6 +43,46 @@ jobs:
run: python -m pytest -q tests/test_real_prepared_geometry_compatibility.py::test_pinned_legacy_geometry_and_data_source_preserve_real_tracks
- name: Check country profiles against the actual BKG land boundary
run: python scripts/check_country_profiles.py --online --cache-root "$RUNNER_TEMP/dopplergeist-geography"
+ - name: Check progress reporting against recorded empty-tile checkpoints
+ run: |
+ python - <<'PY'
+ import hashlib
+ import json
+ from pathlib import Path
+ import subprocess
+ import sys
+ import tempfile
+ from dopplergeist.tiled_search import _tile_coordinates, grid_tiles
+
+ source = Path("tests/data/real-empty-tile-workload.json")
+ original = hashlib.sha256(source.read_bytes()).hexdigest()
+ recorded = json.loads(source.read_text())
+ query = recorded["query"]
+ budget = query["budget"]
+ with tempfile.TemporaryDirectory() as temporary:
+ root = Path(temporary)
+ command = [sys.executable, "scripts/report_checkpoint_progress.py", str(source),
+ "--json", str(root / "progress.json"), "--cache", str(root / "cache.json")]
+ subprocess.run(command, check=True)
+ first = json.loads((root / "progress.json").read_text())
+ expected = sum(len(_tile_coordinates(tuple(tile["cells"]), budget["spacing_m"],
+ query["bounds"], query["crs"])) for tile in recorded["tiles"])
+ coverage = first["coverage"]
+ assert first["receipt_funnel"]["receipt_count"] == len(recorded["tiles"]) == 256
+ assert coverage["receipt_recorded"]["unique_receiver_points"] == expected > 0
+ assert coverage["requested_root_tiles"] == sum(1 for _ in grid_tiles(
+ query["bounds"], budget["spacing_m"], budget["tile_cells"], query["crs"]))
+ assert coverage["canonical_stage_agreed"] is None
+ metrics = {row["metric"]: row for row in first["receipt_funnel"]["metrics"]}
+ assert metrics["grid_points"]["known_sum"] == metrics["tracks"]["known_sum"] == 0
+ assert metrics["cpa_rows"]["known_sum"] is None
+ subprocess.run(command, check=True)
+ refreshed = json.loads((root / "progress.json").read_text())
+ assert refreshed["read_budget"].get("bytes_read", 0) == 0
+ assert refreshed["coverage"] == coverage
+ assert hashlib.sha256(source.read_bytes()).hexdigest() == original
+ print(f"Recorded checkpoint progress passed: 256 receipts, {expected} receiver points; cached refresh reads no input JSON.")
+ PY
- name: CLI smoke check
run: dopplergeist --help
- name: Check installed native validator and packaged browser assets
diff --git a/docs/CHECKPOINT_PROGRESS.md b/docs/CHECKPOINT_PROGRESS.md
index 3c3986b..1036e65 100644
--- a/docs/CHECKPOINT_PROGRESS.md
+++ b/docs/CHECKPOINT_PROGRESS.md
@@ -128,7 +128,9 @@ python scripts/report_checkpoint_progress.py \
```
The script verifies each recorded payload hash. The recorded point and track
-counters are zero, while reconstructed receiver coverage is nonzero. CPA and
+counters are zero. The installed check reconstructs 53,210 receiver points in
+these 256 tiles, exactly matching the current production grid. The requested
+grid has 19,278 root tiles; this fixture is a partial set of receipts. CPA and
trial counters are absent and stay unknown. The portable fixture has no canonical
ledger, so canonical agreement remains unknown. Repeating the command exercises
the incremental cache without generating recordings, tracks, or fixture data.