goad-toolkit 0.2.13__tar.gz → 0.2.14__tar.gz

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/.remember/logs/memory-2026-08-31.log

@@ -342,3 +342,36 @@ RuntimeError: claude exited 1: Failed to authenticate: OAuth session expired and
 18:49:15 [haiku] call exited 1; tokens already spent are unknown — the failure carried no usage block, so this run's reported cost is lower than what it actually cost
 18:49:15 [haiku] ERROR: call-haiku error: claude exited 1: Failed to authenticate: OAuth session expired and could not be refreshed
 18:49:15 [haiku] failure 1/3 on this span — will retry next run
+21:09:54 [hook] session-start: PROJECT_DIR=/Users/rgrouls/code/courses/goad_toolkit PIPELINE_DIR=/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0 REMEMBER_DIR=/Users/rgrouls/code/courses/goad_toolkit/.remember
+21:09:54 [hook] save-session: PROJECT_DIR=/Users/rgrouls/code/courses/goad_toolkit PIPELINE_DIR=/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/Users/rgrouls/code/courses/goad_toolkit/.remember
+21:09:54 [force] bypassing cooldown + min msgs
+21:09:54 [hook] run-consolidation: PROJECT_DIR=/Users/rgrouls/code/courses/goad_toolkit PIPELINE_DIR=/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/Users/rgrouls/code/courses/goad_toolkit/.remember
+21:09:54 [extract] session 309ee39a-6171-47ea-88cf-ee1ad9433f68
+21:09:54 [extract] 204 exchanges (10 human)
+21:09:54 [consolidation] start
+21:09:54 [haiku] calling (branch: main)
+21:09:54 [hook] session-start: PROJECT_DIR=/Users/rgrouls/code/courses/goad_toolkit PIPELINE_DIR=/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0 REMEMBER_DIR=/Users/rgrouls/code/courses/goad_toolkit/.remember
+21:09:54 [hook] run-consolidation: PROJECT_DIR=/Users/rgrouls/code/courses/goad_toolkit PIPELINE_DIR=/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/Users/rgrouls/code/courses/goad_toolkit/.remember
+21:09:54 [consolidation] another consolidation holds the lock, skip
+21:09:56 [haiku] WARNING: this CLI rejected --setting-sources (Failed to authenticate: OAuth session expired and could not be refreshed); retrying WITHOUT hook isolation so saves keep working. The nested call will run with your hooks registered — a hook that blocks it returns its block message as if it were the model's reply (#202).
+21:09:56 [haiku] WARNING: this CLI rejected --setting-sources (Failed to authenticate: OAuth session expired and could not be refreshed); retrying WITHOUT hook isolation so saves keep working. The nested call will run with your hooks registered — a hook that blocks it returns its block message as if it were the model's reply (#202).
+21:09:57 [haiku] call exited 1; tokens already spent are unknown — the failure carried no usage block, so this run's reported cost is lower than what it actually cost
+21:09:57 [haiku] call exited 1; tokens already spent are unknown — the failure carried no usage block, so this run's reported cost is lower than what it actually cost
+21:09:57 [haiku] ERROR: call-haiku error: claude exited 1: Failed to authenticate: OAuth session expired and could not be refreshed
+21:09:57 [haiku] failure 1/3 on this span — will retry next run
+21:09:57 [consolidation] ERROR: pipeline failed — Traceback (most recent call last):
+  File "/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.9/lib/python3.9/runpy.py", line 197, in _run_module_as_main
+    return _run_code(code, main_globals, None,
+  File "/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.9/lib/python3.9/runpy.py", line 87, in _run_code
+    exec(code, run_globals)
+  File "/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0/pipeline/shell.py", line 683, in <module>
+    main()
+  File "/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0/pipeline/shell.py", line 670, in main
+    cmd_consolidate(
+  File "/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0/pipeline/shell.py", line 525, in cmd_consolidate
+    result = consolidate(staging_contents, recent, archive,
+  File "/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0/pipeline/consolidate.py", line 324, in consolidate
+    result = call_haiku(prompt, timeout=180)
+  File "/Users/rgrouls/.claude/plugins/cache/claude-plugins-official/remember/0.20.0/pipeline/haiku.py", line 735, in call_haiku
+    raise RuntimeError(
+RuntimeError: claude exited 1: Failed to authenticate: OAuth session expired and could not be refreshed

goad_toolkit-0.2.14/.remember/tmp/last-save-ts

@@ -0,0 +1 @@
+1788203394

goad_toolkit-0.2.14/.remember/tmp/last-summary-failure

@@ -0,0 +1 @@
+309ee39a-6171-47ea-88cf-ee1ad9433f68:747 1

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.2.14
+
+### Added
+
+- `PlotSettings.subplot_xlabels` / `subplot_ylabels`: per-panel axis labels, the
+  `subplot_titles` idea extended to labels. On the panels they cover they win over the
+  figure-wide `xlabel`/`ylabel`, so a multi-panel figure with panels showing different
+  quantities needs no `ax.set_ylabel` calls.
+- `HorizontalLine`: a layer marking one value on the y-axis — the reference line a residual
+  plot is read against. Defaults to a quiet grey line rather than `VerticalLine`'s crimson
+  marker, because a baseline is context, not a finding.
+- `BarPlot.build` takes `xtick_rotation` for category labels too long to sit flat.
+- `PlotSettings.xtick_rotation`: the same rotation as a figure-wide setting, applied to
+  every axis — for date axes whose labels overlap when flat.
+
+### Changed
+
+- Multi-panel grids from `create_figure` use constrained layout, which spaces panels,
+  labels and the suptitle at draw time — after every layer has landed — so figures no
+  longer need a trailing `fig.tight_layout()`.
+
 ## 0.2.1
 
 ### Breaking

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: goad-toolkit
-Version: 0.2.13
+Version: 0.2.14
 Summary: An extensible toolkit for Goal Oriented Analysis of Data
 Project-URL: Github, https://github.com/raoulg/goad_toolkit
 Author-email: raoul grouls <Raoul.Grouls@han.nl>

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/docs/03-plot-composition.md

@@ -51,6 +51,9 @@ class PlotSettings:
     grid: bool = False
     grid_alpha: Optional[float] = None
     subplot_titles: List[str] = field(default_factory=list)
+    subplot_xlabels: List[str] = field(default_factory=list)
+    subplot_ylabels: List[str] = field(default_factory=list)
+    xtick_rotation: Optional[float] = None
 ```
 
 `xlabel`/`ylabel` left as `None` are not blank — `create_figure` skips setting them at all,
@@ -66,7 +69,11 @@ title.
 
 `subplot_titles` is what makes multi-panel figures work: when a plot creates more than one
 axis, each gets the corresponding entry. `PlotFits` uses this to label each fitted
-distribution with its own test statistics.
+distribution with its own test statistics. `subplot_xlabels` and `subplot_ylabels` are the
+same idea for axis labels — panels showing different quantities get their own labels from
+the settings, not from `ax.set_ylabel` calls after the fact. On the panels they cover, the
+lists win over the figure-wide `xlabel`/`ylabel`. `xtick_rotation` rotates the x tick
+labels on every axis, for the date axes and long category names that overlap when flat.
 
 ## 3.3 `BasePlot`
 
@@ -89,6 +96,8 @@ The contract:
 
 `create_figure(n_plots=...)` handles the layout: one axis for a single plot, otherwise a grid
 wrapping at `settings.max_cols` columns — three by default — with the unused axes hidden.
+The grid uses constrained layout, which spaces panels, labels and the suptitle at draw
+time — after every layer has landed — so a figure never needs a `tight_layout()` call.
 Labels, grid and titles are applied to every visible axis. Set `max_cols=4` for a quartet or
 `max_cols=2` for a square grid; four panels at the default wrap to 3 + 1, which is rarely
 what a set of four wants.
@@ -158,6 +167,7 @@ step 3.
 | `ComparePlot` | two lines with labels | `LinePlot` twice via `plot_on` |
 | `VerticalDate` | a labelled vertical line at a date | a layer, not a plot |
 | `VerticalLine` | the same at a number | a layer, not a plot |
+| `HorizontalLine` | a reference level on the y-axis, usually zero | a layer; the line a residual is read against |
 | `ComparePlotDate` | `ComparePlot` + `VerticalDate` | |
 | `BarPlot` | `sns.barplot`, one bar per category | see [Five families §4.1](04-five-families.md) |
 | `GroupedBarPlot` | bars split by `hue` | two categorical variables at once |

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/docs/08-api-reference.md

@@ -300,6 +300,9 @@ class PlotSettings:
     grid: bool = False
     grid_alpha: Optional[float] = None
     subplot_titles: List[str] = field(default_factory=list)
+    subplot_xlabels: List[str] = field(default_factory=list)  # per-panel, wins over xlabel
+    subplot_ylabels: List[str] = field(default_factory=list)  # per-panel, wins over ylabel
+    xtick_rotation: Optional[float] = None               # rotate x tick labels, every axis
     max_cols: int = 3                                    # columns before wrapping
     highlight: List[str] = field(default_factory=list)   # defaults for HighlightCategory
     base_color: str = "lightgrey"
@@ -332,8 +335,9 @@ class BasePlot(ABC):
 | `ComparePlot` | `data, x, y1, y2, **kwargs` |
 | `VerticalDate` | `date: str, label: str` |
 | `VerticalLine` | `x: float, label=None, color="crimson", linestyle="--", linewidth=2, **kwargs` |
+| `HorizontalLine` | `y: float, label=None, color="grey", linestyle="-", linewidth=1, **kwargs` |
 | `ComparePlotDate` | `data, x, y1, y2, date, datelabel, **kwargs` |
-| `BarPlot` | `data, x, y, order=None, **kwargs` → `sns.barplot` |
+| `BarPlot` | `data, x, y, order=None, xtick_rotation=None, **kwargs` → `sns.barplot` |
 | `GroupedBarPlot` | `data, x, y, hue, order=None, hue_order=None, **kwargs` |
 | `HeatmapPlot` | `data, index=None, columns=None, values=None, aggfunc="mean", cmap="rocket_r", annot=True, fmt=".1f", **kwargs` |
 | `BarbellPlot` | `data, category, start, end, start_label="before", end_label="after", start_color="lightgrey", end_color="crimson", line_color="lightgrey", markersize=80, **kwargs` |

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "goad-toolkit"
-version = "0.2.13"
+version = "0.2.14"
 description = "An extensible toolkit for Goal Oriented Analysis of Data"
 readme = "README.md"
 authors = [

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/src/goad_toolkit/visualizer.py

@@ -30,6 +30,9 @@ class PlotSettings:
     grid: bool = False  # Added grid option
     grid_alpha: Optional[float] = None  # Grid transparency
     subplot_titles: List[str] = field(default_factory=list)  # Titles for subplots
+    subplot_xlabels: List[str] = field(default_factory=list)  # One xlabel per subplot
+    subplot_ylabels: List[str] = field(default_factory=list)  # One ylabel per subplot
+    xtick_rotation: Optional[float] = None  # Rotate x tick labels on every axis
     max_cols: int = 3  # Columns before create_figure wraps to a new row
     highlight: List[str] = field(default_factory=list)  # Categories to pick out
     base_color: str = "lightgrey"  # Everything that is not highlighted
@@ -76,9 +79,15 @@ class BasePlot(ABC):
             # Determine grid layout
             grid_cols = min(self.settings.max_cols, n_plots)
             grid_rows = int(np.ceil(n_plots / grid_cols))
-            # Create subplot grid
+            # Create subplot grid. Constrained layout keeps panels, labels and the
+            # suptitle from colliding, and recomputes at draw time -- after every
+            # layer has landed -- so no tight_layout() call is needed afterwards.
             self.fig, axes = plt.subplots(
-                grid_rows, grid_cols, figsize=self.settings.figsize, squeeze=False
+                grid_rows,
+                grid_cols,
+                figsize=self.settings.figsize,
+                squeeze=False,
+                layout="constrained",
             )
             axes = axes.flatten()
             # Hide unused axes
@@ -92,14 +101,23 @@ class BasePlot(ABC):
             if ax.get_visible():
                 # None means "let the plotting call decide" -- seaborn fills the axis
                 # label in from the column name whenever the label is still empty, so
-                # only an explicit xlabel/ylabel should pre-empt that.
-                if self.settings.xlabel is not None:
-                    ax.set_xlabel(self.settings.xlabel)
-                if self.settings.ylabel is not None:
-                    ax.set_ylabel(self.settings.ylabel)
+                # only an explicit xlabel/ylabel should pre-empt that. The per-subplot
+                # lists win over the figure-wide label on the panels they cover.
+                xlabel = self.settings.xlabel
+                if i < len(self.settings.subplot_xlabels):
+                    xlabel = self.settings.subplot_xlabels[i]
+                if xlabel is not None:
+                    ax.set_xlabel(xlabel)
+                ylabel = self.settings.ylabel
+                if i < len(self.settings.subplot_ylabels):
+                    ylabel = self.settings.subplot_ylabels[i]
+                if ylabel is not None:
+                    ax.set_ylabel(ylabel)
                 # Apply grid if requested
                 if self.settings.grid:
                     ax.grid(True, alpha=self.settings.grid_alpha)
+                if self.settings.xtick_rotation is not None:
+                    ax.tick_params(axis="x", rotation=self.settings.xtick_rotation)
 
                 # Set subplot titles if available
                 if i < len(self.settings.subplot_titles):
@@ -111,7 +129,6 @@ class BasePlot(ABC):
                 self.ax.set_title(self.settings.title)
         else:
             self.fig.suptitle(self.settings.title, fontsize=16)
-            self.fig.tight_layout(rect=(0, 0, 1, 0.96))  # Make room for suptitle
 
         if self.settings.legend_title is not None:
             self.ax.legend(title=self.settings.legend_title)
@@ -176,7 +193,13 @@ class BasePlot(ABC):
 
 
 class LinePlot(BasePlot):
-    """Plot a line plot using seaborn."""
+    """Plot a line plot using seaborn.
+
+    Seaborn drops rows with missing values before drawing, so a gap in the data
+    is connected straight through rather than left open. When absent data must
+    look absent — a reindexed series with `NaN` holes — draw with `ax.plot`,
+    which breaks the line at every `NaN`.
+    """
 
     def build(self, data: pd.DataFrame, **kwargs):
         sns.lineplot(data=data, ax=self.ax, **kwargs)
@@ -266,6 +289,61 @@ class VerticalLine(BasePlot):
         return self.fig, self.ax
 
 
+class HorizontalLine(BasePlot):
+    """Mark one value on the y-axis — a baseline, zero more often than not.
+
+    `VerticalLine` marks a moment; this marks a level. A residual plot without
+    a zero line asks the reader to eyeball where "no effect" sits, so the
+    defaults here are a quiet reference line rather than a crimson marker.
+    """
+
+    def build(
+        self,
+        y: float,
+        label: Optional[str] = None,
+        color: str = "grey",
+        linestyle: str = "-",
+        linewidth: float = 1,
+        **kwargs,
+    ):
+        """
+        Draw a horizontal line at `y`.
+
+        Parameters:
+        -----------
+        y : float
+            Position on the y-axis.
+        label : Optional[str]
+            Legend label. The line is drawn without a legend when this is None.
+        color : str
+            Line colour.
+        linestyle : str
+            Line style.
+        linewidth : float
+            Line width.
+        **kwargs : Additional keyword arguments passed to `ax.axhline`.
+
+        Returns:
+        --------
+        fig, ax : The created figure and axes.
+        """
+        if self.ax is None:
+            raise ValueError("No axes available for plotting")
+
+        self.ax.axhline(
+            y=y,
+            color=color,
+            linestyle=linestyle,
+            linewidth=linewidth,
+            label=label,
+            **kwargs,
+        )
+        if label is not None:
+            self.ax.legend()
+
+        return self.fig, self.ax
+
+
 class HighlightCategory(BasePlot):
     """Grey everything, then colour the categories the plot is actually about.
 
@@ -477,6 +555,7 @@ class BarPlot(BasePlot):
         x: str,
         y: str,
         order: Optional[List[str]] = None,
+        xtick_rotation: Optional[float] = None,
         **kwargs,
     ):
         """
@@ -494,6 +573,8 @@ class BarPlot(BasePlot):
         order : Optional[List[str]]
             Category order. Seaborn's own order (first appearance) is used
             when this is None.
+        xtick_rotation : Optional[float]
+            Rotate the category labels, for names too long to sit flat.
         **kwargs : Additional keyword arguments passed to `sns.barplot`,
             including `estimator`, `errorbar`, `color` and `hue`.
 
@@ -502,6 +583,8 @@ class BarPlot(BasePlot):
         fig, ax : The created figure and axes.
         """
         sns.barplot(data=data, x=x, y=y, order=order, ax=self.ax, **kwargs)
+        if xtick_rotation is not None and self.ax is not None:
+            self.ax.tick_params(axis="x", rotation=xtick_rotation)
         return self.fig, self.ax
 
 

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/tests/test_visualizer.py

@@ -25,6 +25,7 @@ from goad_toolkit.visualizer import (  # noqa: E402
     GroupedBarPlot,
     HeatmapPlot,
     HighlightCategory,
+    HorizontalLine,
     LinePlot,
     NullPlot,
     PlotSettings,
@@ -235,6 +236,21 @@ def test_vertical_line_without_a_label_has_no_legend():
     assert ax.get_legend() is None
 
 
+def test_horizontal_line_draws_at_the_requested_y():
+    fig, ax = HorizontalLine(PlotSettings()).plot(y=0.0, label="baseline")
+
+    assert fig is not None
+    assert ax.lines[0].get_ydata()[0] == pytest.approx(0.0)
+    legend_labels = [t.get_text() for t in ax.get_legend().get_texts()]
+    assert legend_labels == ["baseline"]
+
+
+def test_horizontal_line_without_a_label_has_no_legend():
+    fig, ax = HorizontalLine(PlotSettings()).plot(y=1.0)
+
+    assert ax.get_legend() is None
+
+
 @pytest.fixture
 def null_result() -> NullResult:
     rng = np.random.default_rng(4)
@@ -305,6 +321,36 @@ def test_max_cols_of_two_gives_a_square_grid():
     assert fig.axes[0].get_subplotspec().get_gridspec().get_geometry() == (2, 2)
 
 
+def test_subplot_labels_apply_per_panel():
+    settings = PlotSettings(
+        subplot_xlabels=["author", "messages"],
+        subplot_ylabels=["count", "length"],
+    )
+    host = LinePlot(settings)
+    fig, axes = host.create_figure(n_plots=2)
+
+    assert [ax.get_xlabel() for ax in axes] == ["author", "messages"]
+    assert [ax.get_ylabel() for ax in axes] == ["count", "length"]
+
+
+def test_xtick_rotation_setting_applies_to_every_axis():
+    host = LinePlot(PlotSettings(xtick_rotation=45))
+    fig, axes = host.create_figure(n_plots=2)
+
+    fig.canvas.draw()
+    for ax in axes:
+        assert all(t.get_rotation() == pytest.approx(45) for t in ax.get_xticklabels())
+
+
+def test_subplot_labels_win_over_the_figure_wide_label():
+    settings = PlotSettings(ylabel="shared", subplot_ylabels=["only the first"])
+    host = LinePlot(settings)
+    fig, axes = host.create_figure(n_plots=2)
+
+    assert axes[0].get_ylabel() == "only the first"
+    assert axes[1].get_ylabel() == "shared"
+
+
 def test_annotate_writes_the_text_on_the_axis():
     host = LinePlot(PlotSettings())
     host.create_figure()
@@ -430,6 +476,15 @@ def test_bar_plot_draws_one_bar_per_category(categories):
     ]
 
 
+def test_bar_plot_rotates_its_tick_labels_on_request(categories):
+    fig, ax = BarPlot(PlotSettings()).plot(
+        data=categories, x="species", y="mass", xtick_rotation=45
+    )
+
+    fig.canvas.draw()
+    assert all(t.get_rotation() == pytest.approx(45) for t in ax.get_xticklabels())
+
+
 def test_bar_plot_takes_an_explicit_order(categories):
     order = ["Gentoo", "Adelie", "Chinstrap"]
 

{goad_toolkit-0.2.13 → goad_toolkit-0.2.14}/uv.lock

@@ -383,7 +383,7 @@ wheels = [
 
 [[package]]
 name = "goad-toolkit"
-version = "0.2.13"
+version = "0.2.14"
 source = { editable = "." }
 dependencies = [
     { name = "loguru" },

goad_toolkit-0.2.13/.remember/tmp/last-save-ts

@@ -1 +0,0 @@
-1788194953

goad_toolkit-0.2.13/.remember/tmp/last-summary-failure

@@ -1 +0,0 @@
-309ee39a-6171-47ea-88cf-ee1ad9433f68:745 1

goad_toolkit-0.2.13/.remember/tmp/save-session.pid

@@ -1 +0,0 @@
-20713