chore(deps): bump idfkit to 0.11.1

.github/workflows/bump-idfkit.yml

@@ -0,0 +1,60 @@
+name: Bump idfkit
+on:
+  workflow_dispatch:
+    inputs:
+      idfkit_version:
+        required: true
+        type: string
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+jobs:
+  bump:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - name: Bump idfkit
+        run: |
+          uv add "idfkit==${{ inputs.idfkit_version }}"
+          uv lock
+      - name: Run tests
+        id: tests
+        continue-on-error: true
+        run: |
+          uv run pytest 2>&1 | tee test-output.txt
+      - name: Ask Claude to repair test failures
+        if: steps.tests.outcome == 'failure'
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            idfkit was bumped to ${{ inputs.idfkit_version }}, and the test suite failed.
+            Task:
+            - Read test-output.txt.
+            - Diagnose the compatibility issue caused by the idfkit upgrade.
+            - Make the minimal code changes required.
+            - Do not refactor unrelated code.
+            - Preserve public APIs unless the idfkit upgrade requires a change.
+            - Rerun: uv run pytest
+            - Leave a concise summary of root cause, changed files, and final test result.
+      - name: Rerun tests after Claude repair
+        if: steps.tests.outcome == 'failure'
+        run: uv run pytest
+      - name: Open PR
+        uses: peter-evans/create-pull-request@v6
+        with:
+          branch: bot/bump-idfkit-${{ inputs.idfkit_version }}
+          title: "Bump idfkit to ${{ inputs.idfkit_version }}"
+          commit-message: "Bump idfkit to ${{ inputs.idfkit_version }}"
+          body: |
+            Automated idfkit dependency bump.
+            - Version: `${{ inputs.idfkit_version }}`
+            - Initial test result: `${{ steps.tests.outcome }}`
+            - Test command: `uv run pytest`
+
+            If tests initially failed, Claude attempted a minimal compatibility repair.

CLAUDE.md

@@ -163,3 +163,18 @@ cd build/v25.2 && uv run zensical build --clean
 - New EnergyPlus versions require adding entries to `TARGET_VERSIONS` and updating `LATEST_VERSION` in `scripts/config.py`. If the new version has a new doc set, add it to `DOC_SET_INFO`.
 - The `build/` and `dist/` directories are gitignored. `build/sources/` holds cloned EnergyPlus repos; `build/vXX.X/` holds per-version Zensical projects; `dist/` holds the final deployed site.
 - The Zensical site configuration template is in `zensical.toml` (root). Per-version configs are generated dynamically by `scripts/convert.py`.
+
+## Automated idfkit bumps
+
+When invoked by `.github/workflows/bump-idfkit.yml` on test failure after an idfkit version bump:
+
+- Make the smallest possible compatibility change.
+- Do not perform unrelated refactors.
+- Do not change formatting broadly.
+- Run `uv run pytest` before finishing.
+- Preserve public APIs unless the idfkit upgrade requires otherwise.
+- Summarize:
+  - root cause
+  - files changed
+  - tests run
+  - remaining risks

pyproject.toml

@@ -8,7 +8,7 @@ requires-python = ">=3.10,<4.0"
 dependencies = [
     "tomli_w>=1.0",
     "tomli>=2.0; python_version < '3.11'",
-    "idfkit==0.11.0",
+    "idfkit==0.11.1",
 ]
 
 [project.urls]