feat(combo): integrate US Combo strategies into LongBridge platform (#249)

- Add quant-us-combo-strategies dependency
- Merge combo catalog with US + HK catalogs
- Add combo domain and inputs
- Route combo profiles to combo runtime adapter

Co-authored-by: Claude <noreply@anthropic.com>

Author: Pigbibi

requirements.txt

@@ -12,3 +12,5 @@ google-cloud-storage
 
 google-auth
 longport
+
+quant-us-combo-strategies @ git+https://github.com/QuantStrategyLab/QuantUsComboStrategies.git@c9e290c21289645851c74a4466f2534864b7cec6

strategy_registry.py

@@ -16,6 +16,14 @@
 from hk_equity_strategies.runtime_adapters import (
     describe_platform_runtime_requirements as describe_hk_platform_runtime_requirements,
 )
+from quant_us_combo_strategies import (
+    get_platform_runtime_adapter as get_combo_runtime_adapter,
+    get_runtime_enabled_profiles as get_combo_runtime_enabled_profiles,
+    get_strategy_catalog as get_combo_strategy_catalog,
+)
+from quant_us_combo_strategies.runtime_adapters import (
+    describe_platform_runtime_requirements as describe_combo_platform_runtime_requirements,
+)
 
 from quant_platform_kit.common.strategies import (
     PlatformCapabilityMatrix,
@@ -35,11 +43,12 @@
 
 LONGBRIDGE_PLATFORM = "longbridge"
 HK_EQUITY_DOMAIN = "hk_equity"
+COMBOS_DOMAIN = "quant_combo"
 TECH_COMMUNICATION_PULLBACK_PROFILE = "tech_communication_pullback_enhancement"
 HK_DIVIDEND_GOLD_DEFENSIVE_ROTATION_PROFILE = "hk_dividend_gold_defensive_rotation"
 
 PLATFORM_SUPPORTED_DOMAINS: dict[str, frozenset[str]] = {
-    LONGBRIDGE_PLATFORM: frozenset({US_EQUITY_DOMAIN, HK_EQUITY_DOMAIN}),
+    LONGBRIDGE_PLATFORM: frozenset({US_EQUITY_DOMAIN, HK_EQUITY_DOMAIN, COMBOS_DOMAIN}),
 }
 
 
@@ -78,23 +87,31 @@ def _canonical_profile(profile: str | None) -> str:
     return STRATEGY_CATALOG.profile_aliases.get(normalized, normalized)
 
 
+COMBO_STRATEGY_PROFILES = frozenset(get_combo_strategy_catalog().definitions)
+
+
 def get_platform_runtime_adapter(profile: str | None, *, platform_id: str):
     canonical_profile = _canonical_profile(profile)
     if canonical_profile in HK_STRATEGY_PROFILES:
         return get_hk_platform_runtime_adapter(canonical_profile, platform_id=platform_id)
+    if canonical_profile in COMBO_STRATEGY_PROFILES:
+        return get_combo_runtime_adapter(canonical_profile, platform_id=platform_id)
     return get_us_platform_runtime_adapter(canonical_profile, platform_id=platform_id)
 
 
 def describe_platform_runtime_requirements(profile: str | None, *, platform_id: str) -> dict[str, object]:
     canonical_profile = _canonical_profile(profile)
     if canonical_profile in HK_STRATEGY_PROFILES:
         return describe_hk_platform_runtime_requirements(canonical_profile, platform_id=platform_id)
+    if canonical_profile in COMBO_STRATEGY_PROFILES:
+        return describe_combo_platform_runtime_requirements(canonical_profile, platform_id=platform_id)
     return describe_us_platform_runtime_requirements(canonical_profile, platform_id=platform_id)
 
 
 US_STRATEGY_CATALOG = get_us_strategy_catalog()
 HK_STRATEGY_CATALOG = get_hk_strategy_catalog()
-STRATEGY_CATALOG = _merge_strategy_catalogs(US_STRATEGY_CATALOG, HK_STRATEGY_CATALOG)
+COMBO_STRATEGY_CATALOG = get_combo_strategy_catalog()
+STRATEGY_CATALOG = _merge_strategy_catalogs(US_STRATEGY_CATALOG, HK_STRATEGY_CATALOG, COMBO_STRATEGY_CATALOG)
 US_STRATEGY_PROFILES = frozenset(US_STRATEGY_CATALOG.definitions)
 HK_STRATEGY_PROFILES = frozenset(HK_STRATEGY_CATALOG.definitions)
 LONGBRIDGE_EXCLUDED_LIVE_PROFILES = frozenset(
@@ -104,7 +121,7 @@ def describe_platform_runtime_requirements(profile: str | None, *, platform_id:
     }
 )
 LONGBRIDGE_ROLLOUT_ALLOWLIST = (
-    get_us_runtime_enabled_profiles() | get_hk_runtime_enabled_profiles()
+    get_us_runtime_enabled_profiles() | get_hk_runtime_enabled_profiles() | get_combo_runtime_enabled_profiles()
 ) - LONGBRIDGE_EXCLUDED_LIVE_PROFILES
 PLATFORM_CAPABILITY_MATRIX = PlatformCapabilityMatrix(
     platform_id=LONGBRIDGE_PLATFORM,
@@ -120,6 +137,9 @@ def describe_platform_runtime_requirements(profile: str | None, *, platform_id:
             "indicators",
             "account_state",
             "snapshot",
+            "russell_snapshot",
+            "current_holdings",
+            "market_data",
         }
     ),
     # LongPort API enforces quantity ≥ 1 (regex ``^([1-9]\d*(\.\d+)?)$``).