From e2c32de01839ea41586c534ec0fca054110217c3 Mon Sep 17 00:00:00 2001
From: Renaud Cepre <32103211+renaudcepre@users.noreply.github.com>
Date: Sat, 29 Aug 2026 01:21:36 +0200
Subject: [PATCH 1/2] ci(lint): keep Markdown out of ruff format

CI runs `uvx ruff` unpinned. ruff 0.16 started formatting Python code
blocks inside Markdown by default, inserting PEP 8 blank lines into
every doc snippet, so the format check now fails on 21 untouched .md
files for any new PR (main last passed on 0.15.x).

Doc snippets are hand-formatted on purpose: exclude "*.md" from the
formatter. Verified clean with ruff 0.16.5 and 0.15.12.

Claude-Session: https://claude.ai/code/session_017qxfAtbxBhFTZoaBAJKA3J
---
 pyproject.toml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/pyproject.toml b/pyproject.toml
index 2c0328b..95722f6 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -56,6 +56,11 @@ output-format = "concise"
 line-length = 88
 extend-exclude = []
 
+[tool.ruff.format]
+# ruff >= 0.16 formats Python code blocks inside Markdown by default and
+# inserts PEP 8 blank lines in every doc snippet. Docs stay hand-formatted.
+exclude = ["*.md"]
+
 [tool.ruff.lint]
 select = [
     "F", # Pyflakes

From b3d9ff09b2ca5d2518b22296c27fe4e917cd2dc7 Mon Sep 17 00:00:00 2001
From: Renaud Cepre <32103211+renaudcepre@users.noreply.github.com>
Date: Sat, 29 Aug 2026 01:23:53 +0200
Subject: [PATCH 2/2] ci(lint): pin ruff in CI to the version used locally

ruff 0.16 also enables RUF036 and PLR0917, which the Lint step now
reports on 41 untouched sites. Adopting a new ruff belongs in its own
PR, so CI runs the same ruff as the dev machines (0.15.12).

Claude-Session: https://claude.ai/code/session_017qxfAtbxBhFTZoaBAJKA3J
---
 .github/workflows/ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 449fb31..ef403f3 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -27,10 +27,10 @@ jobs:
           python-version: "3.12"
 
       - name: Check format
-        run: uvx ruff format --check .
+        run: uvx ruff@0.15.12 format --check .
 
       - name: Lint
-        run: uvx ruff check .
+        run: uvx ruff@0.15.12 check .
 
   types:
     runs-on: ubuntu-latest