Add TECL volatility delever retention profiles for research.

Expose tecl_step_rebound retention profiles and enable XLK-benchmarked
price rebound context for tecl_xlk_trend_income without affecting SOXL defaults.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: Pigbibi

src/quant_strategy_plugins/market_regime_control_plugin.py

@@ -217,6 +217,8 @@ def _build_volatility_delever_context(
         tqqq_softzero_035 = _retention_profile(0.0, "hard_risk")
         soxl_rebound = _retention_profile(0.0, "hard_risk")
         soxl_softzero_rebound = _retention_profile(0.0, "hard_risk")
+        tecl_rebound = _retention_profile(0.0, "hard_risk")
+        tecl_softzero_rebound = _retention_profile(0.0, "hard_risk")
     elif soft_risk:
         tqqq_softzero_025 = _retention_profile(0.0, "soft_risk")
         tqqq_softzero_035 = _retention_profile(0.0, "soft_risk")
@@ -226,18 +228,30 @@ def _build_volatility_delever_context(
             else _retention_profile(0.0, "soft_risk")
         )
         soxl_softzero_rebound = _retention_profile(0.0, "soft_risk")
+        tecl_rebound = (
+            _retention_profile(0.25, "price_rebound_candidate", "soft_risk")
+            if price_rebound_candidate
+            else _retention_profile(0.0, "soft_risk")
+        )
+        tecl_softzero_rebound = _retention_profile(0.0, "soft_risk")
     else:
         tqqq_softzero_025 = _retention_profile(0.25, "non_soft_risk")
         tqqq_softzero_035 = _retention_profile(0.35, "non_soft_risk")
         if price_rebound_confirm:
             soxl_rebound = _retention_profile(0.50, "constructive", "price_rebound_confirm")
             soxl_softzero_rebound = _retention_profile(0.50, "constructive", "price_rebound_confirm")
+            tecl_rebound = _retention_profile(0.50, "constructive", "price_rebound_confirm")
+            tecl_softzero_rebound = _retention_profile(0.50, "constructive", "price_rebound_confirm")
         elif price_rebound_candidate:
             soxl_rebound = _retention_profile(0.25, "price_rebound_candidate")
             soxl_softzero_rebound = _retention_profile(0.25, "price_rebound_candidate")
+            tecl_rebound = _retention_profile(0.25, "price_rebound_candidate")
+            tecl_softzero_rebound = _retention_profile(0.25, "price_rebound_candidate")
         else:
             soxl_rebound = _retention_profile(0.0, "rebound_not_confirmed")
             soxl_softzero_rebound = _retention_profile(0.0, "rebound_not_confirmed")
+            tecl_rebound = _retention_profile(0.0, "rebound_not_confirmed")
+            tecl_softzero_rebound = _retention_profile(0.0, "rebound_not_confirmed")
     context = {
         "schema_version": "volatility_delever_context.v1",
         "source": "deterministic_market_regime_components",
@@ -255,6 +269,8 @@ def _build_volatility_delever_context(
             "tqqq_step_softzero_0.35_0.50": tqqq_softzero_035,
             "soxl_step_rebound_0.25_0.50": soxl_rebound,
             "soxl_step_softzero_rebound_0.25_0.50": soxl_softzero_rebound,
+            "tecl_step_rebound_0.25_0.50": tecl_rebound,
+            "tecl_step_softzero_rebound_0.25_0.50": tecl_softzero_rebound,
         },
     }
     if isinstance(price_rebound_context, Mapping) and price_rebound_context:

src/quant_strategy_plugins/volatility_delever_price_rebound.py

@@ -125,21 +125,23 @@ def build_volatility_delever_price_rebound_context(
     price_history: pd.DataFrame,
     plugin_config: Mapping[str, Any],
 ) -> dict[str, Any]:
-    """Build deterministic SOXL volatility-delever rebound context.
+    """Build deterministic levered volatility-delever rebound context.
 
     The context is intentionally limited to backtestable hard data. It feeds
     retention profiles only; market-regime route authority stays with the
     existing crisis and macro components.
     """
 
     strategy = str(plugin_config.get("strategy") or "").strip().lower()
-    default_enabled = strategy == "soxl_soxx_trend_income"
+    default_enabled = strategy in {"soxl_soxx_trend_income", "tecl_xlk_trend_income"}
     if not _as_bool(plugin_config.get("volatility_delever_price_rebound_enabled"), default=default_enabled):
         return {}
 
     close = normalize_close(price_history)
     as_of = str(plugin_config.get("as_of", "") or "").strip() or None
-    benchmark_symbol = str(plugin_config.get("benchmark_symbol", "SOXX") or "SOXX").strip().upper()
+    benchmark_symbol = str(plugin_config.get("benchmark_symbol") or "").strip().upper()
+    if not benchmark_symbol:
+        benchmark_symbol = "XLK" if strategy == "tecl_xlk_trend_income" else "SOXX"
     if benchmark_symbol not in close.columns:
         _, signal_date = resolve_signal_date(close, as_of)
         return {

tests/test_market_regime_control_plugin.py

@@ -276,3 +276,18 @@ def test_market_regime_control_blocked_component_blocks_taco_opportunity() -> No
     assert payload["suggested_action"] == "blocked"
     assert payload["position_control"]["taco_allowed"] is False
     assert "macro:blocked" in payload["position_control"]["reason_codes"]
+
+
+def test_market_regime_control_exposes_tecl_retention_profiles() -> None:
+    payload = build_market_regime_control_signal(
+        {},
+        volatility_delever_price_rebound_context={
+            "schema_version": "volatility_delever_price_rebound_context.v1",
+            "confirmed": True,
+            "reason_codes": ["price_rebound_confirm"],
+        },
+    )
+
+    profiles = payload["position_control"]["volatility_delever_context"]["retention_profiles"]
+    assert profiles["tecl_step_rebound_0.25_0.50"]["retention_ratio"] == 0.50
+    assert profiles["tecl_step_softzero_rebound_0.25_0.50"]["retention_ratio"] == 0.50

tests/test_volatility_delever_price_rebound.py

@@ -47,6 +47,26 @@ def test_price_rebound_context_defaults_disabled_for_non_soxl_strategy() -> None
     assert context == {}
 
 
+def test_price_rebound_context_defaults_enabled_for_tecl_strategy() -> None:
+    prices = _soxl_rebound_prices()
+    prices = prices.assign(
+        symbol=prices["symbol"].map(lambda value: {"SOXX": "XLK", "SOXL": "TECL"}.get(value, value))
+    )
+    context = build_volatility_delever_price_rebound_context(
+        prices,
+        {
+            "strategy": "tecl_xlk_trend_income",
+            "as_of": pd.Timestamp(prices["as_of"].max()).date().isoformat(),
+            "vix_symbols": ["VIX"],
+            "credit_pairs": ["HYG:IEF"],
+            "financial_symbols": ["XLF"],
+        },
+    )
+
+    assert context.get("enabled") is True
+    assert context.get("benchmark_symbol") == "XLK"
+
+
 def test_price_rebound_context_confirms_soxl_constructive_rebound() -> None:
     prices = _soxl_rebound_prices()
     context = build_volatility_delever_price_rebound_context(