refactor: single predict.py entrypoint (production + CLI), archive experiments

docs/scripts.md

@@ -1,17 +1,17 @@
 # Scripts reference
 
-## Entry points (pipelines)
-- `predict.py` — **production** Jetson pipeline: combined sack+truck model + repo `src/`
-  modules, shapely zones, visual-similarity/Re-ID debounce, SQLite, live-frame publish,
-  embedded HTTP status. Run by `karung-counter.service`.
-- `predict_new.py` — duo-model state machine (`WAITING_FOR_TRUCK → COUNTING_SACKS →
-  TRUCK_LEAVING`), hardcoded zones + `zones.json` override, perspective filtering, HUD.
-  Standalone experiment path.
-- `src/main.py` — clean v3 pipeline (`python -m src.main --source VID --env .env`).
-- `rpo_iki/predict_rpo_iki.py` — runner for the alternate `rpo_iki/count.py` geometric
-  engine (approach-depth + burst/cooldown dedup, blind-truck overlay).
-- `simple_predict.py` — minimal CPU demo: `best.pt`, stride 3, `imgsz=320`, OpenCV window.
-- `ini.py` — tiny import/smoke check.
+## Entry points
+- `predict.py` — **single entrypoint: production service (zero flags) + dev CLI.**
+  Combined sack+truck model + repo `src/` modules, shapely zones,
+  visual-similarity/Re-ID debounce, SQLite, live-frame publish. Run by
+  `karung-counter.service`. Flags: `--source/--env/--model/--output-dir/
+  --output-json/--sack-conf/--truck-conf/--box-conf(placeholder)/
+  --batch-timeout/--max-frames/--no-dashboard/--no-db` (see `predict.py --help`).
+- `src/main.py` — deprecated shim: prints a pointer to `predict.py`, still runs the
+  old v3 loop for backward compat.
+- `archive/` — retired: `predict_new.py` (duo-model state machine),
+  `rpo_iki/` (alternate geometric engine + `predict_rpo_iki.py`), `simple_predict.py`
+  (minimal CPU demo), `ini.py`, check/merge/test scripts. Not imported anywhere.
 
 ## Calibration & data tools
 - `get_coordinates.py` / `get_calib_frame.py` — zone calibration (`calib_frame.jpg`,