semantic-reasoning · justinjoy · Sep 12, 2026 · Sep 12, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -54,10 +54,10 @@ jobs:
         python: ["3.11", "3.12", "3.13", "3.14"]
     env:
       # WIRELOG_VERSION here is the exact wirelog ref CI builds against.
-      # The default is pinned to the wirelog v0.60.0 release commit;
+      # The default is pinned to the wirelog v0.62.0 release commit;
       # override the repository variable to test another ref before
       # updating this fallback.
-      WIRELOG_VERSION: ${{ vars.WIRELOG_VERSION || '300f3e5150095c85331b561f1f42d99c27b4746f' }}
+      WIRELOG_VERSION: ${{ vars.WIRELOG_VERSION || '39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c' }}
       # `runner.temp` is NOT available in job-level `env:` (only in
       # step-level contexts) — using it here caused the whole workflow
       # to fail at startup (#114). `github.workspace` IS resolvable at

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -8,6 +8,15 @@ wirelog floor and a validated wirelog ref (see
 
 ## [Unreleased]
 
+### Changed
+- The current development pin for bundled and validated wirelog builds
+  moves from `v0.60.0` to `v0.62.0` at peeled SHA
+  `39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c`.
+- The minimum compatible runtime wirelog version remains `0.52.0`.
+  wirelog 0.62.0 adds `wirelog_program_get_plan_error` relative to
+  0.60.0, and the library SONAME is unchanged, so no PyreWire code
+  stops supporting `0.52.0`.
+
 ## [1.0.6] - 2026-09-05
 
 ### Changed

diff --git a/docs/support.md b/docs/support.md
@@ -19,8 +19,8 @@ not need to install wirelog separately.
 | macOS | `arm64` | `macos-15` | Apple Silicon only for v1.0; no macOS Intel or universal2 wheel is produced. |
 | Windows | `win_amd64` / `AMD64` | `windows-2025-vs2026` | Built with MSVC and repaired with delvewheel. |
 
-The bundled library is built from wirelog v0.60.0, using peeled SHA
-`300f3e5150095c85331b561f1f42d99c27b4746f`.
+The bundled library is built from wirelog v0.62.0, using peeled SHA
+`39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c`.
 
 ## Source Distributions
 

diff --git a/docs/versioning.md b/docs/versioning.md
@@ -50,6 +50,12 @@ When PyreWire is rebuilt and re-validated against a new wirelog ref:
 PyreWire's own `__version__` is bumped only when there is a PyreWire
 release to publish; it is **not** tied to the wirelog change.
 
+## Current development pin
+
+The current development branch builds and validates against wirelog
+`v0.62.0` at peeled SHA `39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c`.
+The minimum compatible runtime wirelog version remains `0.52.0`.
+
 ## Compatibility table
 
 | PyreWire        | Minimum wirelog | Validated wirelog ref                      | Notes                   |

diff --git a/examples/14_arithmetic_operations.py b/examples/14_arithmetic_operations.py
@@ -19,10 +19,10 @@
 
 Two behaviors are easy to misread and are demonstrated deliberately:
 
-- Arithmetic parses left-associatively. `A + B * C` means `(A + B) * C`,
-  not the conventional multiplication-first grouping, so the
-  `precedence` row derives `22` rather than `14`. Use explicit
-  intermediate relations when conventional grouping is needed.
+- Arithmetic follows conventional multiplicative precedence on wirelog
+  0.61.0 and newer, so `A + B * C` derives `14` for the `precedence`
+  row. Older 0.60.x builds parsed arithmetic left-associatively and
+  derived `22` for that row.
 - The typed float ingress canonicalizes `-0.0` and `+0.0` to the same
   `+0.0` value, so the two `zero_input` facts collapse to one row.
 

diff --git a/pyproject.toml b/pyproject.toml
@@ -74,7 +74,7 @@ test-requires = ["pytest", "pytest-cov"]
 before-build = "python {project}/scripts/bundle_libwirelog.py"
 # Pin the wirelog source ref here too so the environment matches the
 # `WIRELOG_VERSION` used by the test-matrix workflow.
-environment = { WIRELOG_VERSION = "300f3e5150095c85331b561f1f42d99c27b4746f" }
+environment = { WIRELOG_VERSION = "39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c" }
 
 [tool.cibuildwheel.linux]
 manylinux-x86_64-image = "manylinux_2_28"
@@ -83,7 +83,7 @@ before-all = """
   pip install meson && \
   WIRELOG_PREFIX=/wirelog-install bash {project}/scripts/build_wirelog.sh
 """
-environment = { WIRELOG_VERSION = "300f3e5150095c85331b561f1f42d99c27b4746f", WIRELOG_PREFIX = "/wirelog-install", WIRELOG_LIB = "/wirelog-install/lib/libwirelog.so.1", LD_LIBRARY_PATH = "/wirelog-install/lib" }
+environment = { WIRELOG_VERSION = "39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c", WIRELOG_PREFIX = "/wirelog-install", WIRELOG_LIB = "/wirelog-install/lib/libwirelog.so.1", LD_LIBRARY_PATH = "/wirelog-install/lib" }
 # `auditwheel` bundles libwirelog.so.1 into the wheel and patches the
 # RPATH (#31). Without this every wheel would ship as a manylinux
 # wheel that immediately fails at import time on systems without the
@@ -96,15 +96,15 @@ before-all = """
   brew install ninja meson pkg-config && \
   WIRELOG_PREFIX=$HOME/wirelog-install bash {project}/scripts/build_wirelog.sh
 """
-environment = { WIRELOG_VERSION = "300f3e5150095c85331b561f1f42d99c27b4746f", WIRELOG_PREFIX = "$HOME/wirelog-install", WIRELOG_LIB = "$HOME/wirelog-install/lib/libwirelog.1.dylib", DYLD_LIBRARY_PATH = "$HOME/wirelog-install/lib" }
+environment = { WIRELOG_VERSION = "39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c", WIRELOG_PREFIX = "$HOME/wirelog-install", WIRELOG_LIB = "$HOME/wirelog-install/lib/libwirelog.1.dylib", DYLD_LIBRARY_PATH = "$HOME/wirelog-install/lib" }
 # `delocate` is macOS's auditwheel equivalent — copies the dylib into
 # the wheel and rewrites install names so the bundled copy wins.
 repair-wheel-command = "DYLD_LIBRARY_PATH=$HOME/wirelog-install/lib delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel}"
 
 [tool.cibuildwheel.windows]
 archs = ["AMD64"]
 before-all = "powershell {project}\\scripts\\build_wirelog.ps1"
-environment = { WIRELOG_VERSION = "300f3e5150095c85331b561f1f42d99c27b4746f", WIRELOG_PREFIX = "C:/wirelog-install", WIRELOG_LIB = "C:/wirelog-install/bin/wirelog-1.dll" }
+environment = { WIRELOG_VERSION = "39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c", WIRELOG_PREFIX = "C:/wirelog-install", WIRELOG_LIB = "C:/wirelog-install/bin/wirelog-1.dll" }
 # `delvewheel` is the Windows analogue. The bundled DLL ends up in
 # `pyrewire/_lib/` and the loader (#2) finds it ahead of system paths.
 repair-wheel-command = "pip install delvewheel && delvewheel repair -w {dest_dir} --no-mangle-all --add-path C:/wirelog-install/bin {wheel}"

diff --git a/tests/data/wirelog_abi.txt b/tests/data/wirelog_abi.txt
@@ -56,6 +56,7 @@ wirelog_parse_with_error_info
 wirelog_program_free
 wirelog_program_get_facts
 wirelog_program_get_intern
+wirelog_program_get_plan_error
 wirelog_program_get_rule_count
 wirelog_program_get_schema
 wirelog_program_get_stratum

diff --git a/tests/docs/test_support_matrix.py b/tests/docs/test_support_matrix.py
@@ -12,7 +12,7 @@
 
 yaml = pytest.importorskip("yaml")
 
-PINNED_WIRELOG_SHA = "300f3e5150095c85331b561f1f42d99c27b4746f"
+PINNED_WIRELOG_SHA = "39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c"
 SUPPORTED_PYTHONS = ["3.11", "3.12", "3.13", "3.14"]
 SUPPORTED_CP_TAGS = ["cp311", "cp312", "cp313", "cp314"]
 SUPPORTED_RUNNERS = ["ubuntu-24.04", "macos-15", "windows-2025-vs2026"]
@@ -122,7 +122,7 @@ def test_support_wirelog_bundle_contract_matches_config_and_versioning():
     assert cibw["macos"]["environment"]["WIRELOG_VERSION"] == PINNED_WIRELOG_SHA
     assert cibw["windows"]["environment"]["WIRELOG_VERSION"] == PINNED_WIRELOG_SHA
 
-    assert "wirelog v0.60.0" in support
+    assert "wirelog v0.62.0" in support
     assert PINNED_WIRELOG_SHA in support
     assert "peeled SHA" in support
     assert "Wheels bundle" in versioning

diff --git a/tests/docs/test_versioning_contract.py b/tests/docs/test_versioning_contract.py
@@ -11,16 +11,16 @@
 
 yaml = pytest.importorskip("yaml")
 
-# The wirelog ref the current release bundles and validates against.
-PINNED_WIRELOG_SHA = "300f3e5150095c85331b561f1f42d99c27b4746f"
+# The wirelog ref the current development branch bundles and validates against.
+PINNED_WIRELOG_SHA = "39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c"
 # Historical pins kept frozen in the compatibility table, one per release.
 WIRELOG_SHA_100 = "272edf3a24b25676f12c4b843d55510f5048dd2f"
 WIRELOG_SHA_101 = "0c6e0cdaee7db069be5d8d896bb59bdcb15673e9"
 WIRELOG_SHA_102 = WIRELOG_SHA_101
 WIRELOG_SHA_103 = "da82a14a7e1472e33aa6ed753b3bc3dfe28a68ba"
 WIRELOG_SHA_104 = "668f82ad69c2bbfc8e8111839302adf1360f55da"
 WIRELOG_SHA_105 = "9f80877c82564cb92ea45bd6fffc2d681b0e13de"
-WIRELOG_SHA_106 = PINNED_WIRELOG_SHA
+WIRELOG_SHA_106 = "300f3e5150095c85331b561f1f42d99c27b4746f"
 
 
 def _repo_root() -> Path:
@@ -98,6 +98,15 @@ def test_versioning_documents_106_wirelog_pin_and_runtime_floor():
     assert "peeled tag SHA" in notes
 
 
+def test_versioning_documents_current_development_wirelog_pin():
+    text = _read("docs/versioning.md")
+
+    assert "current development branch" in text
+    assert "v0.62.0" in text
+    assert PINNED_WIRELOG_SHA in text
+    assert "minimum compatible runtime wirelog version remains `0.52.0`" in text
+
+
 def test_versioning_explains_sdist_and_wheel_wirelog_behavior():
     text = _read("docs/versioning.md")
 

diff --git a/tests/integration/test_examples.py b/tests/integration/test_examples.py
@@ -122,11 +122,18 @@ def test_arithmetic_operations_example_matches_wirelog_golden_output() -> None:
     mod = _import_example("14_arithmetic_operations")
     out = mod.run()
 
-    assert out["result"] == [
-        ("negative", -12, -22, -85, -3, -2, -24),
-        ("positive", 22, 12, 85, 3, 2, 44),
-        ("precedence", 11, 5, 24, 2, 2, 22),
-    ]
+    if _wirelog_ver() >= (0, 61, 0):
+        assert out["result"] == [
+            ("negative", -12, -22, -85, -3, -2, -7),
+            ("positive", 22, 12, 85, 3, 2, 27),
+            ("precedence", 11, 5, 24, 2, 2, 14),
+        ]
+    else:
+        assert out["result"] == [
+            ("negative", -12, -22, -85, -3, -2, -24),
+            ("positive", 22, 12, 85, 3, 2, 44),
+            ("precedence", 11, 5, 24, 2, 2, 22),
+        ]
     assert out["minimum"] == [(-17,)]
     assert out["maximum"] == [(17,)]
     assert out["average_value"] == [(2.5,)]

diff --git a/tests/test_changelog_format.py b/tests/test_changelog_format.py
@@ -83,9 +83,13 @@ def test_changelog_keep_a_changelog_intro_present():
     assert "Keep a Changelog" in text
 
 
-def test_unreleased_section_is_empty_for_100_release():
+def test_unreleased_section_documents_pending_changes():
     changelog = (_repo_root() / "CHANGELOG.md").read_text(encoding="utf-8")
-    assert _section(changelog, "Unreleased") == "## [Unreleased]"
+    section = _section(changelog, "Unreleased")
+
+    assert "wirelog" in section
+    assert "v0.62.0" in section
+    assert "39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c" in section
 
 
 def test_100_release_notes_include_publishable_contract_facts():

diff --git a/tests/test_ci_workflow.py b/tests/test_ci_workflow.py
@@ -24,7 +24,7 @@ def _workflow() -> dict[str, Any]:
 def test_ci_default_wirelog_version_is_exact_sha():
     env = _workflow()["jobs"]["test"]["env"]
     default = str(env["WIRELOG_VERSION"])
-    assert "300f3e5150095c85331b561f1f42d99c27b4746f" in default
+    assert "39a57cf3c4cdf02f97df0e951fe8ecea7a831e2c" in default
 
 
 def test_ci_matrix_drops_python_310():