Skip to content

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

Clarify support files are activity, not completed tiles

Cinna Davis8a06a6cf670c
diff --git a/README.md b/README.md
index 77c01df..5d4bb76 100644
--- a/README.md
+++ b/README.md
@@ -92,14 +92,14 @@ does not establish localization accuracy. See [country profiles](docs/COUNTRIES.
The command prints a job ID when queued. In another terminal, run
`.venv/bin/dopplergeist job JOB_ID --jobs jobs --watch` to follow the reported
pipeline/grid estimate and the count and modification age of coarse/fine search
-files. It separately counts fine support records: the search writes one after a
-fine tile's scoring call returns and its retained scores are imported. These
-records show tile-level scoring completion, but are not validated search
-checkpoints and do not mean the full search has finished. A separate search-write
-age includes support JSON and retention database or WAL writes, so activity stays
-visible while a checkpoint payload is pending. The file-based counts and ages do
-not validate payloads or retention evidence; use the terminal job result to tell
-whether the full search succeeded, failed or remained inconclusive.
+files. It separately counts fine support files. These diagnostics are conditional:
+a tile can contribute no file or more than one, and a resumed checkpoint can
+rewrite them. Their count, observed rate and modification age show filesystem
+activity; they do not establish newly scored tiles, valid checkpoints or complete
+hypothesis coverage. A separate search-write age includes support JSON and
+retention database or WAL writes, so activity stays visible while a checkpoint
+payload is pending. Use the terminal job result to tell whether the full search
+succeeded, failed or remained inconclusive.
Stop a running service-managed job with `.venv/bin/dopplergeist cancel JOB_ID`;
pass `--server-url` when the service uses a non-default port.
For a directly managed `analyze` or `resume --jobs` job, request cooperative
diff --git a/tests/test_real_cli_watch.py b/tests/test_real_cli_watch.py
index 87f9fa0..0f1e4ee 100644
--- a/tests/test_real_cli_watch.py
+++ b/tests/test_real_cli_watch.py
@@ -83,5 +83,6 @@ def test_watch_labels_real_search_file_counts_unverified():
result = subprocess.run(command, check=True, capture_output=True, text=True, timeout=15)
assert f'{len(coarse) + len(fine)} search files observed (unverified:' in result.stderr
- assert f'({len(coarse)} coarse, {len(fine)} fine)' in result.stderr
+ assert f'(unverified: {len(coarse)} coarse, {len(fine)} fine)' in result.stderr
+ assert f', {len(diagnostics)} fine support records observed (unverified)' in result.stderr
assert 'fine support checkpoints' not in result.stderr