Release v0.3.0-alpha.22: drivers report layout consistency

Alpha.20 polished build_executive_report (narrow gutters at A/M,
content in B-L) but I missed applying the same change to
build_drivers_report. Live screenshot review caught the asymmetry —
exec sheet had the polished gutter pattern, drivers sheet still had
labels and tornado flush against column A.

Fix: DriversReportBuilder now uses the same B-shifted layout —
title band B:L, KEY FINDINGS at B4, tornado chart shifted right
~16pt to align with column B, driver-ranking table moved from G:J
to H:K (post mid-gutter), HOW TO READ and RECOMMENDED ACTIONS
narrative sections shifted to B with merges extended to L.

399 tests pass. 6 drivers-report tests updated.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: vosesoft

CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to ModelRisk MCP. Follows [Keep a Changelog](https://keepach
 
 ## [Unreleased]
 
+## [0.3.0-alpha.22] — 2026-05-22
+
+Layout consistency fix: alpha.20 polished `build_executive_report`'s layout (narrow gutters at A/M, content in B–L) but I missed applying the same change to `build_drivers_report`. Live screenshot review caught the asymmetry — exec sheet had the polished gutter pattern, drivers sheet still had labels and tornado flush against column A.
+
+### Fixed
+
+- **DriversReportBuilder now uses the same B-shifted layout as ExecutiveReportBuilder.** Title band B:L (was A:J), KEY FINDINGS at B4 (was A4), bullets in B (was A), tornado chart shifted right by ~16pt to align with column B, driver-ranking table moved from G:J to H:K (sits after the mid-gutter at column G), HOW TO READ THIS CHART and RECOMMENDED ACTIONS narrative sections shifted to B with merge ranges expanded to L. Recommendations rows put labels in B and values in C (was A/B); the value cell merges B-merged-to-L. Now both reports look like siblings.
+
+### Tests
+
+399 unit tests pass. 6 drivers-report tests updated to assert against the new column positions (B-shifted findings, H-K driver table, C-shifted recommendations).
+
 ## [0.3.0-alpha.21] — 2026-05-22
 
 Hotfix for a regression introduced by alpha.16's `_ModelRiskReports` helper sheet: the second run of `build_executive_report` (and `build_drivers_report`) failed with `Move method of Worksheet class failed` on real Excel.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "modelrisk-mcp"
-version = "0.3.0a21"
+version = "0.3.0a22"
 description = "Open MCP server bridging Anthropic Claude (and any MCP-compatible client) with the ModelRisk Excel add-in."
 readme = "README.md"
 requires-python = ">=3.11"

server.json

@@ -3,12 +3,12 @@
   "name": "io.github.vosesoftware/modelrisk-mcp",
   "title": "ModelRisk",
   "description": "Read, build, fit, and run Monte Carlo risk models in Excel through Vose Software's ModelRisk.",
-  "version": "0.3.0a21",
+  "version": "0.3.0a22",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "modelrisk-mcp",
-      "version": "0.3.0a21",
+      "version": "0.3.0a22",
       "transport": {
         "type": "stdio"
       }

src/modelrisk_mcp/__init__.py

@@ -1 +1 @@
-__version__ = "0.3.0a21"
+__version__ = "0.3.0a22"

src/modelrisk_mcp/bridge/reports.py

@@ -986,10 +986,17 @@ def build(
 
     @staticmethod
     def _set_column_widths(sheet: Any) -> None:
+        """alpha.22 layout: narrow gutters at A and M, content in B-L.
+        Driver table lives at H-K (was G-J). Match the executive
+        report's gutter pattern so the two reports feel like siblings."""
         widths = {
-            "A": 24, "B": 14, "C": 14, "D": 14, "E": 14,
-            "F": 4,
-            "G": 20, "H": 12, "I": 12, "J": 12,
+            "A": 2,   # left gutter
+            "B": 24,  # findings + recommendation labels
+            "C": 14, "D": 14, "E": 14, "F": 14,
+            "G": 4,   # mid gutter
+            "H": 22,  # driver-table Input column
+            "I": 14, "J": 14, "K": 14, "L": 14,
+            "M": 2,   # right gutter
         }
         for col, w in widths.items():
             try:
@@ -999,42 +1006,43 @@ def _set_column_widths(sheet: Any) -> None:
 
     @staticmethod
     def _write_title_band(sheet: Any, title: str, subtitle: str) -> None:
-        sheet.range("A1").value = title
-        sheet.range("A2").value = subtitle
+        sheet.range("B1").value = title
+        sheet.range("B2").value = subtitle
         try:
-            sheet.range("A1:J1").merge()
-            sheet.range("A2:J2").merge()
-            band = sheet.range("A1:J2")
+            # Band spans B:L; A and M stay as narrow gutters.
+            sheet.range("B1:L1").merge()
+            sheet.range("B2:L2").merge()
+            band = sheet.range("B1:L2")
             band.api.Interior.Color = _COLOR_TITLE_BG
             band.api.Font.Color = _COLOR_TITLE_FG
-            sheet.range("A1").api.Font.Size = 18
-            sheet.range("A1").api.Font.Bold = True
-            sheet.range("A2").api.Font.Size = 11
-            sheet.range("A1").api.HorizontalAlignment = -4108
-            sheet.range("A2").api.HorizontalAlignment = -4108
-            sheet.range("A1").row_height = 28
-            sheet.range("A2").row_height = 18
+            sheet.range("B1").api.Font.Size = 18
+            sheet.range("B1").api.Font.Bold = True
+            sheet.range("B2").api.Font.Size = 11
+            sheet.range("B1").api.HorizontalAlignment = -4108
+            sheet.range("B2").api.HorizontalAlignment = -4108
+            sheet.range("B1").row_height = 28
+            sheet.range("B2").row_height = 18
         except Exception:
             pass
 
     @staticmethod
     def _write_findings(sheet: Any, findings: list[str]) -> None:
-        sheet.range(f"A{DriversReportBuilder.FINDINGS_HEADER_ROW}").value = (
+        sheet.range(f"B{DriversReportBuilder.FINDINGS_HEADER_ROW}").value = (
             "KEY FINDINGS"
         )
         try:
             r = DriversReportBuilder.FINDINGS_HEADER_ROW
-            sheet.range(f"A{r}:J{r}").api.Font.Bold = True
-            sheet.range(f"A{r}").api.Font.Size = 12
-            sheet.range(f"A{r}").api.Font.Color = _rgb(100, 100, 100)
+            sheet.range(f"B{r}:L{r}").api.Font.Bold = True
+            sheet.range(f"B{r}").api.Font.Size = 12
+            sheet.range(f"B{r}").api.Font.Color = _rgb(100, 100, 100)
         except Exception:
             pass
         for i, finding in enumerate(findings, start=DriversReportBuilder.FINDINGS_FIRST_ROW):
-            sheet.range(f"A{i}").value = f"•  {finding}"
+            sheet.range(f"B{i}").value = f"•  {finding}"
             try:
-                sheet.range(f"A{i}:J{i}").merge()
-                sheet.range(f"A{i}").api.WrapText = True
-                sheet.range(f"A{i}").row_height = 28
+                sheet.range(f"B{i}:L{i}").merge()
+                sheet.range(f"B{i}").api.WrapText = True
+                sheet.range(f"B{i}").row_height = 28
             except Exception:
                 pass
 
@@ -1070,51 +1078,54 @@ def _write_tornado_chart(
                 helper_anchor_col=anchor,
                 driver_count=len(entries),
                 title=f"What moves {output_name}",
-                left=10, top=210, width=420, height=320,
+                # Shifted right ~16pt post-alpha.22 to align with the
+                # column-B content start (A is now the gutter).
+                left=26, top=210, width=440, height=320,
             )
         except Exception:
             pass
 
     @staticmethod
     def _write_driver_table(sheet: Any, entries: list[Any]) -> None:
-        # Header
+        # alpha.22 layout: table moves from G:J to H:K so it lives
+        # past the mid-gutter at column G.
         header_row = DriversReportBuilder.TABLE_HEADER_ROW
         headers = ["Input", "Correlation (r)", "|r|", "Variance share"]
         for i, label in enumerate(headers):
-            col = chr(ord("G") + i)
+            col = chr(ord("H") + i)
             sheet.range(f"{col}{header_row}").value = label
         try:
-            sheet.range(f"G{header_row}:J{header_row}").api.Font.Bold = True
+            sheet.range(f"H{header_row}:K{header_row}").api.Font.Bold = True
             sheet.range(
-                f"G{header_row}:J{header_row}"
+                f"H{header_row}:K{header_row}"
             ).api.Interior.Color = _COLOR_BAND_LIGHT
         except Exception:
             pass
 
         for idx, e in enumerate(entries, start=DriversReportBuilder.TABLE_DATA_ROW):
-            sheet.range(f"G{idx}").value = e.input_name
-            sheet.range(f"H{idx}").value = e.correlation
-            sheet.range(f"I{idx}").value = abs(e.correlation)
-            sheet.range(f"J{idx}").value = _variance_share(e.correlation)
+            sheet.range(f"H{idx}").value = e.input_name
+            sheet.range(f"I{idx}").value = e.correlation
+            sheet.range(f"J{idx}").value = abs(e.correlation)
+            sheet.range(f"K{idx}").value = _variance_share(e.correlation)
             try:
-                sheet.range(f"H{idx}").api.NumberFormat = "0.000"
                 sheet.range(f"I{idx}").api.NumberFormat = "0.000"
-                sheet.range(f"J{idx}").api.NumberFormat = "0.0%"
+                sheet.range(f"J{idx}").api.NumberFormat = "0.000"
+                sheet.range(f"K{idx}").api.NumberFormat = "0.0%"
                 # Color the |r| cell by strength tier.
                 col_strength = _driver_strength_color(abs(e.correlation))
-                sheet.range(f"I{idx}").api.Font.Color = col_strength
-                sheet.range(f"I{idx}").api.Font.Bold = True
+                sheet.range(f"J{idx}").api.Font.Color = col_strength
+                sheet.range(f"J{idx}").api.Font.Bold = True
             except Exception:
                 pass
 
     @staticmethod
     def _write_chart_explanation(sheet: Any) -> None:
         row = DriversReportBuilder.EXPLAIN_HEADER_ROW
-        sheet.range(f"A{row}").value = "HOW TO READ THIS CHART"
+        sheet.range(f"B{row}").value = "HOW TO READ THIS CHART"
         try:
-            sheet.range(f"A{row}").api.Font.Bold = True
-            sheet.range(f"A{row}").api.Font.Size = 12
-            sheet.range(f"A{row}").api.Font.Color = _rgb(100, 100, 100)
+            sheet.range(f"B{row}").api.Font.Bold = True
+            sheet.range(f"B{row}").api.Font.Size = 12
+            sheet.range(f"B{row}").api.Font.Color = _rgb(100, 100, 100)
         except Exception:
             pass
         paragraphs = [
@@ -1138,12 +1149,12 @@ def _write_chart_explanation(sheet: Any) -> None:
             ),
         ]
         for i, paragraph in enumerate(paragraphs, start=row + 1):
-            sheet.range(f"A{i}").value = paragraph
+            sheet.range(f"B{i}").value = paragraph
             try:
-                sheet.range(f"A{i}:J{i}").merge()
-                sheet.range(f"A{i}").api.WrapText = True
-                sheet.range(f"A{i}").row_height = 32
-                sheet.range(f"A{i}").api.VerticalAlignment = -4160  # xlTop
+                sheet.range(f"B{i}:L{i}").merge()
+                sheet.range(f"B{i}").api.WrapText = True
+                sheet.range(f"B{i}").row_height = 32
+                sheet.range(f"B{i}").api.VerticalAlignment = -4160  # xlTop
             except Exception:
                 pass
 
@@ -1152,11 +1163,11 @@ def _write_recommendations(
         sheet: Any, recommendations: dict[str, list[str]],
     ) -> None:
         row = DriversReportBuilder.RECOMMEND_HEADER_ROW
-        sheet.range(f"A{row}").value = "RECOMMENDED ACTIONS"
+        sheet.range(f"B{row}").value = "RECOMMENDED ACTIONS"
         try:
-            sheet.range(f"A{row}").api.Font.Bold = True
-            sheet.range(f"A{row}").api.Font.Size = 12
-            sheet.range(f"A{row}").api.Font.Color = _rgb(100, 100, 100)
+            sheet.range(f"B{row}").api.Font.Bold = True
+            sheet.range(f"B{row}").api.Font.Size = 12
+            sheet.range(f"B{row}").api.Font.Color = _rgb(100, 100, 100)
         except Exception:
             pass
         tier_rows = [
@@ -1165,16 +1176,16 @@ def _write_recommendations(
             ("Can be deprioritised:", "deprioritise", _COLOR_DRIVER_WEAK),
         ]
         for i, (label, key, color) in enumerate(tier_rows, start=row + 1):
-            sheet.range(f"A{i}").value = label
+            sheet.range(f"B{i}").value = label
             inputs = recommendations.get(key, [])
             value = ", ".join(inputs) if inputs else "(none)"
-            sheet.range(f"B{i}").value = value
+            sheet.range(f"C{i}").value = value
             try:
-                sheet.range(f"A{i}").api.Font.Bold = True
-                sheet.range(f"B{i}").api.Font.Color = color
                 sheet.range(f"B{i}").api.Font.Bold = True
-                sheet.range(f"B{i}:J{i}").merge()
-                sheet.range(f"B{i}").api.WrapText = True
+                sheet.range(f"C{i}").api.Font.Color = color
+                sheet.range(f"C{i}").api.Font.Bold = True
+                sheet.range(f"C{i}:L{i}").merge()
+                sheet.range(f"C{i}").api.WrapText = True
             except Exception:
                 pass
 

tests/unit/test_reports.py

@@ -690,9 +690,11 @@ def test_builds_sheet_with_title_and_findings(self) -> None:
         )
         assert isinstance(result, DriversReportResult)
         sheet = book.sheets["Drivers"]
-        assert "Profit" in sheet.cells["A1"]
-        assert "5,000 iterations" in sheet.cells["A2"]
-        assert sheet.cells["A4"] == "KEY FINDINGS"
+        # alpha.22 layout: drivers report shifted to B-column gutter
+        # pattern (matches the executive report).
+        assert "Profit" in sheet.cells["B1"]
+        assert "5,000 iterations" in sheet.cells["B2"]
+        assert sheet.cells["B4"] == "KEY FINDINGS"
         assert result.drivers_analyzed == 3
         assert result.top_driver == "WidgetCost"
         assert result.top_correlation == -0.72
@@ -713,7 +715,7 @@ def test_findings_name_top_driver_with_direction(self) -> None:
         sheet = book.sheets["Drivers"]
         # First finding should mention the driver name + that it
         # LOWERS the output (negative correlation).
-        first_finding_text = sheet.cells.get("A5", "") or ""
+        first_finding_text = sheet.cells.get("B5", "") or ""
         assert "WidgetCost" in first_finding_text
         assert "lowers" in first_finding_text
         assert "Profit" in first_finding_text
@@ -733,7 +735,7 @@ def test_findings_mention_top_n_variance_share(self) -> None:
             iterations=1000,
         )
         sheet = book.sheets["Drivers"]
-        coverage_finding = sheet.cells.get("A6", "") or ""
+        coverage_finding = sheet.cells.get("B6", "") or ""
         assert "top 3" in coverage_finding.lower() or "top-3" in coverage_finding.lower() or "top " in coverage_finding.lower()
 
     def test_driver_table_populated(self) -> None:
@@ -750,16 +752,16 @@ def test_driver_table_populated(self) -> None:
             iterations=1000,
         )
         sheet = book.sheets["Drivers"]
-        # Header
-        assert sheet.cells["G11"] == "Input"
-        assert sheet.cells["H11"] == "Correlation (r)"
-        assert sheet.cells["I11"] == "|r|"
-        assert sheet.cells["J11"] == "Variance share"
+        # Header — alpha.22 shifted driver table from G:J to H:K.
+        assert sheet.cells["H11"] == "Input"
+        assert sheet.cells["I11"] == "Correlation (r)"
+        assert sheet.cells["J11"] == "|r|"
+        assert sheet.cells["K11"] == "Variance share"
         # Data row 1 (strongest)
-        assert sheet.cells["G12"] == "A"
-        assert sheet.cells["H12"] == -0.7
-        assert abs(sheet.cells["I12"] - 0.7) < 1e-9
-        assert abs(sheet.cells["J12"] - 0.49) < 1e-9  # r² = 0.49
+        assert sheet.cells["H12"] == "A"
+        assert sheet.cells["I12"] == -0.7
+        assert abs(sheet.cells["J12"] - 0.7) < 1e-9
+        assert abs(sheet.cells["K12"] - 0.49) < 1e-9  # r² = 0.49
 
     def test_recommendations_tier_by_correlation_strength(self) -> None:
         book = _FakeBook()
@@ -784,10 +786,12 @@ def test_recommendations_tier_by_correlation_strength(self) -> None:
         focus_row = DriversReportBuilder.RECOMMEND_HEADER_ROW + 1
         monitor_row = focus_row + 1
         deprioritise_row = focus_row + 2
-        assert "StrongDriver" in sheet.cells[f"B{focus_row}"]
-        assert "StrongDriver2" in sheet.cells[f"B{focus_row}"]
-        assert "ModerateDriver" in sheet.cells[f"B{monitor_row}"]
-        assert "WeakDriver" in sheet.cells[f"B{deprioritise_row}"]
+        # alpha.22: recommendations values shifted from B → C
+        # (label in B, value in C).
+        assert "StrongDriver" in sheet.cells[f"C{focus_row}"]
+        assert "StrongDriver2" in sheet.cells[f"C{focus_row}"]
+        assert "ModerateDriver" in sheet.cells[f"C{monitor_row}"]
+        assert "WeakDriver" in sheet.cells[f"C{deprioritise_row}"]
 
     def test_empty_sensitivity_doesnt_crash(self) -> None:
         book = _FakeBook()
@@ -804,7 +808,7 @@ def test_empty_sensitivity_doesnt_crash(self) -> None:
         assert result.top_driver is None
         # A finding still gets written, explaining the empty result.
         sheet = book.sheets["Drivers"]
-        first_finding = sheet.cells.get("A5", "")
+        first_finding = sheet.cells.get("B5", "")
         assert "No drivers" in first_finding
 
     def test_concentration_label(self) -> None:

tests/unit/test_server_boot.py

@@ -5,7 +5,7 @@
 
 
 def test_version_is_set() -> None:
-    assert __version__ == "0.3.0a21"
+    assert __version__ == "0.3.0a22"
 
 
 def test_server_name() -> None: