fix(blastware_file, server): implement logic to skip extra chunks after metadata for accurate file writing

minimateplus/blastware_file.py

@@ -685,11 +685,45 @@ def write_blastware_file(
         body_frames = a5_frames
         term_frame  = None
 
+    # ── Identify first metadata frame and skip "extra chunks" ───────────────
+    # When extra_chunks_after_metadata=1 in read_bulk_waveform_stream(), the
+    # frame list is: [probe, data..., metadata, extra_chunk, terminator].
+    # The extra_chunk is downloaded to prime the TCP terminator response — its
+    # ADC data is NOT part of the Blastware file body.  Skip it.
+    #
+    # Rule: any frame at index strictly between first_metadata_fi and last_fi
+    #       (the final frame) is an extra chunk and must be excluded.
+    #
+    # If no metadata frame exists (e.g. full_waveform download), first_metadata_fi
+    # is None and no frames are skipped — all frames contribute normally.
+    first_metadata_fi: Optional[int] = None
+    for _fi_scan, _frame_scan in enumerate(body_frames):
+        if _fi_scan > 0 and any(m in bytes(_frame_scan.data) for m in _METADATA_FRAME_MARKERS):
+            first_metadata_fi = _fi_scan
+            break
+    last_fi = len(body_frames) - 1
+
+    log.warning(
+        "write_blastware_file: %d body_frames  first_metadata_fi=%s  last_fi=%d",
+        len(body_frames),
+        str(first_metadata_fi) if first_metadata_fi is not None else "None",
+        last_fi,
+    )
+
     all_bytes = bytearray()
 
     for fi, frame in enumerate(body_frames):
-        ftype = classify_frame(frame)
-        print(f"Frame {fi}: type={ftype}, page_key={frame.page_key:04x}, len={len(frame.data)}")
+        # Skip "extra chunk" frames: frames after the first metadata frame but
+        # before the last frame (terminator).  These prime the TCP terminator but
+        # their ADC data must NOT appear in the Blastware file body.
+        if (first_metadata_fi is not None
+                and fi > first_metadata_fi
+                and fi < last_fi):
+            log.warning(
+                "write_blastware_file: fi=%d SKIP (extra chunk after metadata fi=%d last_fi=%d)",
+                fi, first_metadata_fi, last_fi,
+            )
+            continue
 
         if fi == 0:
             # Probe frame: always process regardless of classification.