Test clean S/R as production rank overlay

scripts/run_sr_v2_matrix.py

@@ -100,6 +100,11 @@ def _args() -> argparse.Namespace:
         help="Run current production and the frozen candidate over the full snapshot.",
     )
     _add_common(full)
+    overlay = commands.add_parser(
+        "overlay",
+        help="Test the frozen 5% clean-structure rank overlay on production breadth.",
+    )
+    _add_common(overlay)
     validate = commands.add_parser(
         "validate",
         help="Run production control and one locked arm from 2024-07-01.",
@@ -210,6 +215,16 @@ def _full(args: argparse.Namespace) -> None:
     print("Full-period production comparison complete.")
 
 
+def _overlay(args: argparse.Namespace) -> None:
+    _run_arm(
+        "production_structural_overlay",
+        args.snapshot,
+        args.workers,
+        output=ROOT / "reports" / "backtest-sr-overlay-full.json",
+    )
+    print("Full-period structural ranking overlay complete.")
+
+
 def main() -> None:
     args = _args()
     if args.command == "train":
@@ -225,6 +240,8 @@ def main() -> None:
         _train(args, arms, "backtest-sr-range-residual-train")
     elif args.command == "full":
         _full(args)
+    elif args.command == "overlay":
+        _overlay(args)
     else:
         _validate(args)