feat: retention funnel chart tab with treatment line depth (Task C.1)

dash_app/callbacks/chart.py

@@ -267,6 +267,31 @@ def _render_duration(app_state, title):
     return create_duration_figure(data, title, show_directory=show_directory)
 
 
+def _render_funnel(app_state, title):
+    """Build the retention funnel figure from current filter state."""
+    from dash_app.data.queries import get_retention_funnel
+    from visualization.plotly_generator import create_retention_funnel_figure
+
+    filter_id = (app_state or {}).get("date_filter_id", "all_6mo")
+    chart_type = (app_state or {}).get("chart_type", "directory")
+
+    selected_dirs = (app_state or {}).get("selected_directorates") or []
+    selected_trusts = (app_state or {}).get("selected_trusts") or []
+    directory = selected_dirs[0] if len(selected_dirs) == 1 else None
+    trust = selected_trusts[0] if len(selected_trusts) == 1 else None
+
+    try:
+        data = get_retention_funnel(filter_id, chart_type, directory, trust)
+    except Exception:
+        log.exception("Failed to load retention funnel data")
+        return _empty_figure("Failed to load retention funnel data.")
+
+    if not data:
+        return _empty_figure("No retention data available.\nTry adjusting your filters.")
+
+    return create_retention_funnel_figure(data, title)
+
+
 def register_chart_callbacks(app):
     """Register tab switching, pathway data loading, and chart rendering callbacks."""
 
@@ -407,6 +432,9 @@ def register_chart_callbacks(app):
         elif active_tab == "duration":
             fig = _render_duration(app_state, title)
 
+        elif active_tab == "funnel":
+            fig = _render_funnel(app_state, title)
+
         else:
             # Placeholder for charts not yet implemented
             tab_label = dict(TAB_DEFINITIONS).get(active_tab, active_tab)