Add bidirectional RF handoff coordination

docs/handoff/RX_RESULT_TEMPLATE.md

@@ -1,23 +1,55 @@
-TASK_ID =
-TASK_STATUS =
-SOURCE_HEAD =
-STARTED_AT =
-FINISHED_AT =
+# RX result schema
 
-SUMMARY =
+The publisher creates both docs/handoff/results/RX_RESULT.json and docs/handoff/results/RX_RESULT.md on the existing rx-node branch. JSON is authoritative. Markdown is generated from the same validated object.
 
-CHECKS =
+## READY JSON
 
-HARDWARE_ACTIONS =
+    {
+      "schema_version": 1,
+      "task_id": "RF001A_OTA_CAPTURE_002",
+      "state": "RX_READY_FOR_TX",
+      "rx_ready_for_tx": true,
+      "process_alive": true,
+      "file_growing": true,
+      "capture_pid": 1234,
+      "published_at": "2026-09-21T12:00:02+00:00",
+      "capture_started_at": "2026-09-21T12:00:00+00:00",
+      "expected_capture_end": "2026-09-21T12:02:00+00:00",
+      "capture_path": "C:\\Users\\Professional\\Documents\\SDR_Rover_Captures\\<run>\\rf001a_ota_capture.cs8",
+      "common_clock_verified": true,
+      "source_head": "<40-character lowercase Git HEAD>",
+      "rf_tx": 0,
+      "exit_code": null,
+      "file_size": null,
+      "duration_seconds": null,
+      "overruns": null,
+      "usb_errors": null,
+      "file_errors": null,
+      "sha256": null,
+      "clkin_after": "NOT_RUN",
+      "rf_tx_observed": "UNKNOWN"
+    }
 
-RF_TX =
-YES / NO
+## COMPLETE JSON
 
-FILES_CREATED =
+The final object keeps the same identity, timing, path and PID. It changes these fields:
 
-ERRORS =
+    state = CAPTURE_COMPLETE
+    rx_ready_for_tx = false
+    process_alive = false
+    file_growing = false
+    published_at = <final publication UTC time>
+    exit_code = <integer>
+    file_size = <integer bytes>
+    duration_seconds = <number>
+    overruns = <non-negative integer or null>
+    usb_errors = <non-negative integer or null>
+    file_errors = <non-negative integer or null>
+    sha256 = <lowercase 64-character SHA256>
+    clkin_after = DETECTED or NOT_DETECTED
+    rf_tx_observed = EXPECTED_EXTERNAL_TX or UNKNOWN
+    rf_tx = 0
 
-NEXT_ACTION =
+Use null when the capture tool did not report an error counter. Do not infer zero.
 
-The result publisher must also create `RX_RESULT.json` with the same fields.
-Raw IQ, video and waveform files must stay outside Git.
+Raw IQ, video, waveform files and large logs must stay outside Git.