Localize strategy plugin route reasons (#26)

Author: Pigbibi

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quant-strategy-plugins"
-version = "0.1.6"
+version = "0.1.7"
 description = "Open sidecar strategy plugins that emit QuantPlatformKit-compatible signal artifacts."
 readme = "README.md"
 requires-python = ">=3.11"

src/quant_strategy_plugins/strategy_plugin_runner.py

@@ -318,12 +318,16 @@ class PluginNotificationTargetPolicy:
         "en-US": "New-high/new-low spread watch",
         "zh-CN": "新高新低差观察",
     },
+    "no_action": {"en-US": "No action", "zh-CN": "无动作"},
+    "opportunity_watch": {"en-US": "Opportunity watch", "zh-CN": "机会观察"},
     "pentagon_pizza_watch": {"en-US": "Pentagon pizza index watch", "zh-CN": "五角大楼比萨指数观察"},
     "panic_reversal": {"en-US": "Panic reversal context", "zh-CN": "恐慌反转上下文"},
     "panic_reversal_watch": {"en-US": "Panic reversal watch", "zh-CN": "恐慌反转观察"},
     "put_call_stress_watch": {"en-US": "Put/call stress watch", "zh-CN": "Put/call 压力观察"},
     "price_crisis_guard_active": {"en-US": "Price crisis guard active", "zh-CN": "价格危机保护激活"},
     "price_rebound_confirmation": {"en-US": "Price rebound confirmation", "zh-CN": "价格反弹确认"},
+    "risk_off": {"en-US": "Risk off", "zh-CN": "风险关闭"},
+    "risk_reduced": {"en-US": "Risk reduced", "zh-CN": "风险降低"},
     "safe_haven_demand_watch": {"en-US": "Safe-haven demand watch", "zh-CN": "避险需求观察"},
     "skew_high_watch": {"en-US": "SKEW high watch", "zh-CN": "SKEW 偏高观察"},
     "taco_rebound": {"en-US": "TACO rebound context", "zh-CN": "TACO 反弹上下文"},
@@ -341,6 +345,7 @@ class PluginNotificationTargetPolicy:
         "en-US": "Yield-curve inversion watch",
         "zh-CN": "收益率曲线倒挂观察",
     },
+    "watch": {"en-US": "Watch state", "zh-CN": "观察状态"},
 }
 
 OPPORTUNITY_REVIEW_STATUS_LABELS: dict[str, dict[str, str]] = {

tests/test_strategy_plugin_runner.py

@@ -422,6 +422,29 @@ def test_strategy_plugin_runner_runs_unified_market_regime_control_for_tqqq(tmp_
     assert "macro:vix_crisis_level" not in zh_log
 
 
+def test_strategy_plugin_runner_localizes_watch_route_reason_fallback() -> None:
+    payload = _apply_plugin_contract(
+        {
+            "as_of": "2026-06-16",
+            "canonical_route": "watch",
+            "suggested_action": "watch_only",
+            "notification": {"should_notify": True},
+        },
+        strategy=SOXL_STRATEGY_NAME,
+        plugin=PLUGIN_MARKET_REGIME_CONTROL,
+        mode="shadow",
+    )
+
+    assert payload["notification"]["localized_reason_labels"]["zh-CN"] == ["观察状态"]
+    assert payload["notification"]["localized_reason_labels"]["en-US"] == ["Watch state"]
+    zh_notification = payload["notification"]["localized_messages"]["zh-CN"]
+    zh_log = payload["log_record"]["localized_messages"]["zh-CN"]
+    assert "原因：观察状态" in zh_notification
+    assert "原因=观察状态" in zh_log
+    assert "watch" not in zh_notification
+    assert "watch" not in zh_log
+
+
 def test_strategy_plugin_runner_can_enable_panic_reversal_inside_market_regime_control(tmp_path) -> None:
     prices_path = tmp_path / "market_regime_panic_prices.csv"
     output_dir = tmp_path / STRATEGY_NAME / "plugins" / PLUGIN_MARKET_REGIME_CONTROL