Add single-command GTL tuning matrix

scripts/run_backtest_snapshot.py

@@ -11,7 +11,7 @@ import asyncio
 import json
 import os
 import sys
-from datetime import datetime
+from datetime import date, datetime
 from pathlib import Path
 from typing import Any
 
@@ -61,10 +61,16 @@ def _parse_args() -> argparse.Namespace:
             "rewrite_range504_structural_primary2",
             "production_structural_overlay",
             "explicit_target_ladder",
+            "gtl_tuning",
         ),
         default=None,
         help="Research-only S/R detector/gate arm.",
     )
+    parser.add_argument(
+        "--gtl-config",
+        default=None,
+        help="Research-only GTL configuration as a JSON object (requires --sr-variant gtl_tuning).",
+    )
     parser.add_argument(
         "--entry-start",
         default=None,
@@ -80,6 +86,11 @@ def _parse_args() -> argparse.Namespace:
         action="store_true",
         help="Include candidate-level S/R audit rows for paired comparison.",
     )
+    parser.add_argument(
+        "--holdout-split",
+        default=None,
+        help="Add a disjoint train/test portfolio report split at YYYY-MM-DD.",
+    )
     return parser.parse_args()
 
 
@@ -195,12 +206,22 @@ async def _main() -> None:
         os.environ["BACKTEST_ALLOW_SPAWN"] = "1"
     if args.sr_variant:
         os.environ["BACKTEST_SR_VARIANT"] = args.sr_variant
+    if args.gtl_config:
+        if args.sr_variant != "gtl_tuning":
+            raise SystemExit("--gtl-config requires --sr-variant gtl_tuning")
+        os.environ["BACKTEST_GTL_CONFIG"] = args.gtl_config
     if args.entry_start:
         os.environ["BACKTEST_ENTRY_START"] = args.entry_start
     if args.entry_end:
         os.environ["BACKTEST_ENTRY_END"] = args.entry_end
     if args.sr_audit:
         os.environ["BACKTEST_SR_AUDIT"] = "1"
+    if args.holdout_split:
+        try:
+            date.fromisoformat(args.holdout_split)
+        except ValueError as exc:
+            raise SystemExit("--holdout-split must use YYYY-MM-DD") from exc
+        os.environ["BACKTEST_HOLDOUT_SPLIT"] = args.holdout_split
 
     from app.config import settings
     from app.services.backtest_service import run_backtest