PHASE 13.41.DF FIX2 — close all 5 panel-flagged P2/P3 items + FBY.23 lock

Items closed (per Sonet50 panel summary 2026-05-23):
  §2.1 (5/5 P2): FORWARDED_NAMES duplicate line-pairs — 4 tuples
                 had share_x/y/across_figures inserted twice by FIX1
                 regex-replace. Removed; verified 6 single entries.
                 Functional impact: zero (Python tuple in is idempotent).
  §2.2 (3/5 P2): 3D + auto_title=True was silent no-op (Sonnet54).
                 Design: 3-case per-figure suptitle:
                   user title=    → '{title} ({figid_col} = {v})'
                   auto_title=True → '{expr}  [faceted by R × C × F = v]'
                   default        → '{figid_col} = {v}' (v1.6 baseline)
                 Locked by FBY.23.
  §2.3 (4/5 P2): normalize+share_x silent consume — expanded _consumed
                 inline doc comment from 7 to 18 lines documenting
                 BEHAVIOR + WORKAROUND + FIX2 BACKL                 BEHAVIOR + (adv                 BEHAVIOR + WORKAROUND + FIX2 BACKL                 BEHAVIOR + (advget_supti                 BEHAVIOR + WORKAROUND + FIX2 BACKL     with fallback for older versions). Used in FBY.22 + FBY.23.
  §2  §2  §2  §2  §2  §2  §2  §2  §2  §2  §2  §2 ch_inner_per_cell
                 removed (per-cell auto_title is ALWAYS False â                 removed (per-cell auto_title is ALWAYS Fal Docstring updated.

Tests: 945 → 946 (+1 §9 invariance: FBY.23).

Author: miranov25

UTILS/dfextensions/dfdraw/docs/CAPABILITY_MATRIX.md

@@ -1,6 +1,6 @@
 # Capability Matrix — dfdraw
 
-**Generated:** 2026-05-23 10:28 UTC
+**Generated:** 2026-05-23 13:18 UTC
 **Phase:** 13.15.DF
 **Generator:** `scripts/generate_capability_matrix.py`
 **Sources:** `tests/feature_taxonomy.py` + `tests/test_layer_classification.py`
@@ -14,8 +14,8 @@
 | 🧨 Broken | 0 | 0% |
 | 📋 Planned | 1 | 1% |
 | **Total features** | **107** | |
-| **Total proof tests** | **500** | |
-| **Invariance tests** | **271** | |
+| **Total proof tests** | **501** | |
+| **Invariance tests** | **272** | |
 
 **Status key:**
 - ✅ Verified — has at least one invariance test (A ≡ B check)
@@ -170,7 +170,7 @@
 | | **HIST** | | |
 | ✅ | **HIST.cumulative** — hist() cumulative=True/-1/False — ROOT TH1::Draw('cumulative') equivalent. Three values: True (ascending CDF/ECDF), False (default, byte-identical backward compat), -1 (descending/survival, ROOT convention). matplotlib native cumulative= forwarded explicitly at 4 internal call sites (Phase 13.39 §2.2 lesson applied recursively: DFDraw.hist → draw_hist → _draw_hist_grouped → ax.hist; ALSO through _dispatch_faceted_render for facet_by composition). Composes with: norm='probability' (→ ECDF 0-1), group_by overlaid (per-group ECDFs), group_by stacked (CP2-1 regression lock for 3rd call site), facet_by (per-facet cumulative), histtype='step' (HEP-standard step ECDF). Correctness guard (M5): hist_errors+cumulative → NotImplementedError (Poisson per-bin errors are independent; cumulative counts are correlated). Vector dispatch [x,y] propagates cumulative correctly (Phase 13.16.DF FIX1 bug class lock) — Phase 13.40.DF | 10 | 0 |
 | | **FACET** | | |
-| ✅ | **FACET.list_grid** — facet_by accepts Union[str, List[str]] for 1D/2D/3D faceting. Convention LOCKED matching numpy/pandas (n_rows, n_cols, ...) shape: facet_by[0]=ROW (vertical within figure), facet_by[1]=COLUMN (horizontal within figure), facet_by[2]=FIGID (separate figures, one per value). facet_by[3+] raises NotImplementedError. 3D returns (List[Figure], List[axes_2d], List[stats_dict]) — DEVIATES from standard (fig, ax, stats) contract; documented prominently in inline help. New params: share_x/share_y ∈ {'all','row','col','none'} (within-figure axis sharing), share_across_figures: bool (3D global range lock). Per-plot-kind lock for share_across_figures (CP1-2): scatter locks x AND y; hist/profile locks x only (y auto-scales per figure to handle sparse-figID variance). New helpers: _normalize_facet_args, _to_mpl_share (symmetric {'all':True,'row':'row','col':'col','none':False} — v1.2 CP0-1 fix for Hard Constraint #3), _validate_share_axis_value, _resolve_facet_values (discrete or pd.cut/qcut Interval), _filter_facet_value (CP1-3 discrete vs binned), _compute_global_ranges. dfdraw is FIRST major plotting library with unified API where Nth faceting dimension generates separate figures (seaborn/ggplot2/plotly/altair all require manual loops). _validate_facet_by_binning guard for list input (v1.3 P1-A). Per-plot-kind dispatch: hist uses range= (matplotlib convention); profile uses range= which DFDraw.profile remaps to draw_profile's x_range= internally; scatter uses ax.set_xlim/set_ylim post-draw (no native range params); hist also locks ax.set_xlim post-draw (range= only locks bins, not axis xlim). Empty cell handling: '(no data)' diagnostic + stats={'n':0,'empty':True} — Phase 13.41.DF | 22 | 0 |
+| ✅ | **FACET.list_grid** — facet_by accepts Union[str, List[str]] for 1D/2D/3D faceting. Convention LOCKED matching numpy/pandas (n_rows, n_cols, ...) shape: facet_by[0]=ROW (vertical within figure), facet_by[1]=COLUMN (horizontal within figure), facet_by[2]=FIGID (separate figures, one per value). facet_by[3+] raises NotImplementedError. 3D returns (List[Figure], List[axes_2d], List[stats_dict]) — DEVIATES from standard (fig, ax, stats) contract; documented prominently in inline help. New params: share_x/share_y ∈ {'all','row','col','none'} (within-figure axis sharing), share_across_figures: bool (3D global range lock). Per-plot-kind lock for share_across_figures (CP1-2): scatter locks x AND y; hist/profile locks x only (y auto-scales per figure to handle sparse-figID variance). New helpers: _normalize_facet_args, _to_mpl_share (symmetric {'all':True,'row':'row','col':'col','none':False} — v1.2 CP0-1 fix for Hard Constraint #3), _validate_share_axis_value, _resolve_facet_values (discrete or pd.cut/qcut Interval), _filter_facet_value (CP1-3 discrete vs binned), _compute_global_ranges. dfdraw is FIRST major plotting library with unified API where Nth faceting dimension generates separate figures (seaborn/ggplot2/plotly/altair all require manual loops). _validate_facet_by_binning guard for list input (v1.3 P1-A). Per-plot-kind dispatch: hist uses range= (matplotlib convention); profile uses range= which DFDraw.profile remaps to draw_profile's x_range= internally; scatter uses ax.set_xlim/set_ylim post-draw (no native range params); hist also locks ax.set_xlim post-draw (range= only locks bins, not axis xlim). Empty cell handling: '(no data)' diagnostic + stats={'n':0,'empty':True} — Phase 13.41.DF | 23 | 0 |
 
 ---
 

UTILS/dfextensions/dfdraw/drawer.py

@@ -821,8 +821,6 @@ def _auto_label(self, y_expr, x_expr=None):
         'facet_by_bins', 'facet_by_quantiles',  # Phase 13.32.DF Sub-fix 3 (AD-79)
         # Phase 13.41.DF v1.6 + FIX1: N-D faceting axis-sharing controls
         'share_x', 'share_y', 'share_across_figures',
-        # Phase 13.41.DF v1.6 + FIX1: N-D faceting axis-sharing controls
-        'share_x', 'share_y', 'share_across_figures',
         # Phase 13.27.DF Commit 2 (Phase D): selection/weights vectors + per-curve label management
         'selection_vector', 'weights_vector',
         'selection_labels', 'weights_labels',
@@ -854,8 +852,6 @@ def _auto_label(self, y_expr, x_expr=None):
         'facet_by_bins', 'facet_by_quantiles',  # Phase 13.32.DF Sub-fix 3 (AD-79)
         # Phase 13.41.DF v1.6 + FIX1: N-D faceting axis-sharing controls
         'share_x', 'share_y', 'share_across_figures',
-        # Phase 13.41.DF v1.6 + FIX1: N-D faceting axis-sharing controls
-        'share_x', 'share_y', 'share_across_figures',
         # Phase 13.27.DF Commit 2 (Phase D): selection/weights vectors + per-curve label management
         'selection_vector', 'weights_vector',
         'selection_labels', 'weights_labels',
@@ -899,8 +895,6 @@ def _auto_label(self, y_expr, x_expr=None):
         'facet_by_bins', 'facet_by_quantiles',  # Phase 13.32.DF Sub-fix 3 (AD-79)
         # Phase 13.41.DF v1.6 + FIX1: N-D faceting axis-sharing controls
         'share_x', 'share_y', 'share_across_figures',
-        # Phase 13.41.DF v1.6 + FIX1: N-D faceting axis-sharing controls
-        'share_x', 'share_y', 'share_across_figures',
         'xerr', 'yerr',  # Phase 13.38.DF: scatter error bars (column name or df.eval())
         'time_format',  # Phase 13.39.DF: time-axis formatting (pre-conversion)
         # Phase 13.27.DF Commit 2 (Phase D): selection/weights vectors + per-curve label management
@@ -937,8 +931,6 @@ def _auto_label(self, y_expr, x_expr=None):
         'facet_by_bins', 'facet_by_quantiles',  # Phase 13.32.DF Sub-fix 3 (AD-79)
         # Phase 13.41.DF v1.6 + FIX1: N-D faceting axis-sharing controls
         'share_x', 'share_y', 'share_across_figures',
-        # Phase 13.41.DF v1.6 + FIX1: N-D faceting axis-sharing controls
-        'share_x', 'share_y', 'share_across_figures',
         # Phase 13.27.DF Commit 2 (Phase D): selection/weights vectors + per-curve label management
         'selection_vector', 'weights_vector',
         'selection_labels', 'weights_labels',
@@ -3347,7 +3339,7 @@ def _dispatch_faceted_render(
 
     def _dispatch_inner_per_cell(self, sub_df, x_expr, y_expr, plot_kind,
                                   ax_ij, _lock_x_range, _lock_y_range,
-                                  _user_auto_title=False, **plot_kwargs):
+                                  **plot_kwargs):
         """Per-plot-kind inner dispatch within a 2D facet cell.
         
         Phase 13.41.DF v1.4 CP1-1 — corrected per-function range params:
@@ -3359,8 +3351,10 @@ def _dispatch_inner_per_cell(self, sub_df, x_expr, y_expr, plot_kind,
         _lock_x_range/_lock_y_range: internal cross-figure ranges; user-supplied
         range (hist) / x_range (profile) come via plot_kwargs and take precedence.
         
-        _user_auto_title: Phase 13.41 FIX1 (Sonnet54 P2) — user's auto_title
-        choice; respected for hist/profile (scatter has no auto_title param).
+        Per-cell `auto_title` is ALWAYS False — cell titles are reserved for facet
+        labels (row_col=val, col_col=val). User's auto_title=True is honored at
+        the figure level (suptitle) in _dispatch_2d_facet (Phase 13.41 FIX1 +
+        FIX2 item 5: dead `_user_auto_title` param removed from this signature).
         """
         # Build the y:x or just x expression for the inner call
         if isinstance(y_expr, str) and y_expr:
@@ -3489,7 +3483,6 @@ def _dispatch_2d_facet(self, df, x_expr, y_expr, facet_list, bins_list,
                 stats_ij = self._dispatch_inner_per_cell(
                     sub_df, x_expr, y_expr, plot_kind, ax_ij,
                     _lock_x_range, _lock_y_range,
-                    _user_auto_title=_user_auto_title,
                     **inner_kwargs)
                 stats_grid[(row_v, col_v)] = stats_ij
 
@@ -3547,18 +3540,39 @@ def _dispatch_3d_facet(self, df, x_expr, y_expr, facet_list, bins_list,
             sub_df = _filter_facet_value(df, figid_col, figid_v,
                                           bins_list[2], quantiles_list[2])
 
+            # Phase 13.41 FIX2 item 2 (Sonnet54 P2): in 3D mode, the 2D dispatch's
+            # auto_title suptitle would be overwritten by the figID label below.
+            # Don't forward _user_auto_title to 2D — handle the combined suptitle
+            # here so auto_title=True isn't a silent no-op in 3D.
             fig, axes, stats = self._dispatch_2d_facet(
                 sub_df, x_expr, y_expr, facet_list[:2], bins_list[:2],
                 quantiles_list[:2], plot_kind,
                 share_x=share_x, share_y=share_y,
                 _lock_x_range=global_x_range, _lock_y_range=global_y_range,
-                _user_auto_title=_user_auto_title,
+                _user_auto_title=False,    # 3D handles auto_title at fig-level (see below)
                 title=None, group_by=group_by, top_k=top_k,
                 quantiles=quantiles, quantile_mode=quantile_mode,
                 **plot_kwargs)
 
-            # Set per-figure title (figID value)
-            fig.suptitle(f"{figid_col} = {figid_v}", fontsize=12)
+            # Set per-figure title — 3 cases per Phase 13.41 FIX2 item 2 design:
+            #   1. user title=    → "{user_title} ({figid_col} = {figid_v})"
+            #   2. auto_title=True → "{expr} [faceted by {r}×{c}×{f} = {figid_v}]"
+            #   3. default         → "{figid_col} = {figid_v}"  (Phase 13.41 v1.6)
+            if title:
+                fig.suptitle(f"{title} ({figid_col} = {figid_v})", fontsize=12)
+            elif _user_auto_title:
+                if isinstance(y_expr, str) and y_expr and x_expr:
+                    _auto_expr = f"{y_expr} vs {x_expr}"
+                elif isinstance(y_expr, str) and y_expr:
+                    _auto_expr = y_expr
+                else:
+                    _auto_expr = x_expr or 'data'
+                fig.suptitle(
+                    f"{_auto_expr}  [faceted by {facet_list[0]} × {facet_list[1]} "
+                    f"× {facet_list[2]} = {figid_v}]",
+                    fontsize=11)
+            else:
+                fig.suptitle(f"{figid_col} = {figid_v}", fontsize=12)
 
             figures.append(fig)
             all_axes.append(axes)
@@ -4838,13 +4852,24 @@ def profile(
                     'selection_labels', 'weights_labels',
                     'selection_categorical', 'weights_categorical',
                     'delta_facet',
-                    # Phase 13.41.DF FIX1.1: filter N-D axis-sharing controls
-                    # from _passthrough sent to legacy normalize dispatchers
-                    # (_render / _grouped / _faceted use their own GridSpec
-                    # layout and don't accept share_x/y/across_figures). The
-                    # K×2 normalize+facet grid pre-dates Phase 13.41's N-D
-                    # faceting; future phase may add N-D support to normalize
-                    # dispatcher. Until then, params silently ignored.
+                    # ────────────────────────────────────────────────────────
+                    # Phase 13.41.DF FIX1.1 + FIX2 item 3 (Sonnet51/52/54 P2):
+                    # When normalize= AND facet_by= are BOTH set, routing goes
+                    # to the legacy K×2 normalize+facet dispatcher (predates
+                    # Phase 13.41 N-D faceting). That dispatcher uses its own
+                    # GridSpec layout and does NOT honor share_x/share_y/
+                    # share_across_figures. We filter these out of _passthrough
+                    # so they don't reach _dispatch_normalize_faceted_render
+                    # via **passthrough (which would silently swallow them
+                    # anyway — but explicit filtering documents intent and
+                    # avoids surprise in future maintenance).
+                    #
+                    # BEHAVIOR: d.profile(normalize=..., facet_by=['a','b'],
+                    # share_x='row')  →  K×2 grid, share_x SILENTLY IGNORED.
+                    # WORKAROUND: use normalize= or facet_by=List[str], not both.
+                    # FIX2 BACKLOG: add N-D faceting support to normalize
+                    # dispatcher (or raise NotImplementedError with hint).
+                    # ────────────────────────────────────────────────────────
                     'share_x', 'share_y', 'share_across_figures',
                 }
                 _passthrough = {k: v for k, v in vector_kwargs.items()

UTILS/dfextensions/dfdraw/tests/feature_taxonomy.py

@@ -1359,6 +1359,8 @@
             "test_phase_13_41_df_2d_faceting.py::TestFacetByListGrid::test_FBY_20_share_y_row_symmetry",
             "test_phase_13_41_df_2d_faceting.py::TestFacetByListGrid::test_FBY_21_share_x_invalid_raises",
             "test_phase_13_41_df_2d_faceting.py::TestFacetByListGrid::test_FBY_22_auto_title_suptitle_lock",
+            # Phase 13.41.DF FIX2 (1 additional regression lock)
+            "test_phase_13_41_df_2d_faceting.py::TestFacetByListGrid::test_FBY_23_3d_auto_title_combined_suptitle",
         ],
     },
 ]

UTILS/dfextensions/dfdraw/tests/test_layer_classification.py

@@ -348,6 +348,8 @@
     "test_phase_13_41_df_2d_faceting.py::TestFacetByListGrid::test_FBY_20_share_y_row_symmetry": "invariance",
     "test_phase_13_41_df_2d_faceting.py::TestFacetByListGrid::test_FBY_21_share_x_invalid_raises": "invariance",
     "test_phase_13_41_df_2d_faceting.py::TestFacetByListGrid::test_FBY_22_auto_title_suptitle_lock": "invariance",
+    # Phase 13.41.DF FIX2 (1 additional regression lock)
+    "test_phase_13_41_df_2d_faceting.py::TestFacetByListGrid::test_FBY_23_3d_auto_title_combined_suptitle": "invariance",
 
     # Everything else defaults to "smoke"
 }