market_outlook: add hourly advisory brief

app_config.py

@@ -86,7 +86,8 @@ _VALID_LOG_LEVELS = ("DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL")
 _SCANNABLE_TFS = ("M5", "M15", "H1", "H4")
 
 _KNOWN_TOP = {"telegram", "data_providers", "scanning", "pairs", "log_level",
-              "oanda", "deepseek", "agent_panel", "signal_log"}
+               "oanda", "deepseek", "agent_panel", "market_outlook",
+               "signal_log"}
 _KNOWN_OANDA = {
     "account_id", "api_token", "base_url", "lot_size",
     "quality_gate", "max_hold_bars",
@@ -99,11 +100,19 @@ _KNOWN_AGENT_PANEL = {
     "max_panels_per_day", "reuse_ttl_seconds",
     "candles_enabled", "candle_bars_primary", "candle_bars_confirm",
 }
+_KNOWN_MARKET_OUTLOOK = {"enabled", "telegram", "max_per_day", "candles_bars"}
 _KNOWN_SIGNAL_LOG = {"enabled", "path"}
 _KNOWN_TELEGRAM = {"token", "chat_id", "channel_id", "alert_min_quality"}
 _KNOWN_SCANNING = {"pairs", "timeframes"}
 _KNOWN_PAIR_KEYS = {"blocked_hours_utc"}
 
+_MARKET_OUTLOOK_DEFAULTS = {
+    "enabled": False,
+    "telegram": False,
+    "max_per_day": 12,
+    "candles_bars": 20,
+}
+
 
 class AppConfigError(Exception):
     """config.json is present but invalid — fail fast at boot."""
@@ -125,6 +134,8 @@ class AppConfig:
     oanda_settings: Dict[str, Any] = field(default_factory=dict)
     deepseek_settings: Dict[str, Any] = field(default_factory=dict)
     agent_panel_settings: Dict[str, Any] = field(default_factory=dict)
+    market_outlook_settings: Dict[str, Any] = field(
+        default_factory=lambda: dict(_MARKET_OUTLOOK_DEFAULTS))
     signal_log_settings: Dict[str, Any] = field(default_factory=dict)
     log_level: str = "INFO"
 
@@ -321,6 +332,20 @@ def load_app_config(path: str = CONFIG_PATH) -> AppConfig:
                     "between 1 and 100")
     app.agent_panel_settings = dict(panel)
 
+    outlook = raw.get("market_outlook", {})
+    _check_keys(outlook, _KNOWN_MARKET_OUTLOOK, '"market_outlook"')
+    for flag in ("enabled", "telegram"):
+        if flag in outlook and not isinstance(outlook[flag], bool):
+            raise AppConfigError(
+                f"config.json: market_outlook.{flag} must be true or false")
+    for key in ("max_per_day", "candles_bars"):
+        if key in outlook:
+            value = outlook[key]
+            if isinstance(value, bool) or not isinstance(value, int) or value < 1:
+                raise AppConfigError(
+                    f"config.json: market_outlook.{key} must be a positive integer")
+    app.market_outlook_settings.update(outlook)
+
     slog = raw.get("signal_log", {})
     _check_keys(slog, _KNOWN_SIGNAL_LOG, '"signal_log"')
     if "enabled" in slog and not isinstance(slog["enabled"], bool):
@@ -431,6 +456,17 @@ def deepseek_api_key(app: Optional[AppConfig] = None) -> str:
         app.deepseek_settings.get("api_key", ""))
 
 
+# ── AI market-outlook resolution helper ──────────────────────────────
+
+def market_outlook_enabled(app: Optional[AppConfig] = None) -> bool:
+    """Whether the advisory outlook feature is enabled (env wins)."""
+    env = os.environ.get("MARKET_OUTLOOK_ENABLED")
+    if env:
+        return env.strip().lower() in ("1", "true", "yes", "on")
+    app = app or get_app_config()
+    return bool(app.market_outlook_settings.get("enabled", False))
+
+
 # ── Signal-log resolution helpers (env → config.json → default) ──────
 
 def signal_log_enabled(app: Optional[AppConfig] = None) -> bool: