Add JSON report for WCX detection

README.md

@@ -47,6 +47,20 @@ scripts/detect_wcx_title.py \
   --ending mp4,avi
 ```
 
+Write a machine-readable report without changing the terminal output:
+
+```bash
+scripts/detect_wcx_title.py \
+  /storage/disk1/X \
+  --batch \
+  --ending mp4 \
+  --json-report reports/wcx-detection.json
+```
+
+The JSON report contains every selected file with its classification, score,
+best timestamp, or error details, followed by the same aggregate summary as
+the terminal output.
+
 Batch output contains one line per file with its classification, score, best
 timestamp, and full file path. A summary after the run reports the number
 processed and the totals for `wcx`, `uncertain`, `not_wcx`, and errors.