From 223bdb8ca8941f7024c6c70ec329c02a625d9e56 Mon Sep 17 00:00:00 2001
From: Arun Sharma <arun@sharma-home.net>
Date: Thu, 1 Oct 2026 10:08:07 -0700
Subject: [PATCH] Update to liblbug 0.21.2, pg_client 0.21.0, Icebug 13.2

- README: require liblbug 0.21.2+, pg_client 0.21.0+; document pinned
  download commands and the Icebug 13.2 pairing
- CI: default PG_CLIENT_VERSION 0.19.0 -> 0.21.0 (pg_client tracks the
  Ladybug minor line; 0.21.0 pairs with liblbug 0.21.x)

Verified: clean build against 0.21.2 headers; scripts/test.sh 33/34
pass (1 expected xfail).
---
 .github/workflows/ci.yml |  8 +++++---
 README.md                | 18 +++++++++++++-----
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6a2c132..7334611 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -9,14 +9,16 @@ on:
   workflow_dispatch:
     inputs:
       pg_client_version:
-        description: 'pg_client extension version fetched from extension.ladybugdb.com (default: 0.19.0)'
+        description: 'pg_client extension version fetched from extension.ladybugdb.com (default: 0.21.0)'
         required: false
-        default: '0.19.0'
+        default: '0.21.0'
 env:
   # Version of the pg_client extension fetched from
   # https://extension.ladybugdb.com/<ver>/linux_amd64/pg_client/...
   # Overridable via the workflow_dispatch `pg_client_version` input.
-  PG_CLIENT_VERSION: ${{ inputs.pg_client_version || '0.19.0' }}
+  # Tracks the Ladybug minor line (0.21.x); patch releases share the
+  # minor-line pg_client build, so 0.21.0 pairs with liblbug 0.21.2.
+  PG_CLIENT_VERSION: ${{ inputs.pg_client_version || '0.21.0' }}
 jobs:
   test:
     # Per-version gate on real PostgreSQL servers via the official PGXN
diff --git a/README.md b/README.md
index 780d95d..a8c82f6 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ We also support a second mode: run Cypher only queries that don't access Postgre
 
 - **PostgreSQL 17+** (tested on 17 and 18)
 - **pg_config** (postgresql-server-dev package)
-- **`liblbug.so` v0.19.0+** (Ladybug engine shared library; see Installation)
+- **`liblbug.so` v0.21.2+** (Ladybug engine shared library; see Installation)
 - **`libpg_client.lbug_extension`** (pg_client extension for ATTACH; see Installation)
 - **OpenSSL** (liblbug requires `libssl`/`libcrypto`)
 
@@ -33,10 +33,10 @@ We also support a second mode: run Cypher only queries that don't access Postgre
 
 ### 1. Download liblbug and pg_client
 
-You need **liblbug v0.19.0 or later** and the **pg_client extension**.
+You need **liblbug v0.21.2 or later** and the **pg_client extension** (v0.21.0+).
 
 ```bash
-# Download liblbug v0.19.0 (shared library)
+# Download liblbug v0.21.2 (shared library)
 # Set LBUG_VERSION or use a nightly build RUN_ID
 export LBUG_PRECOMPILED_RUN_ID=<run_id>
 export LBUG_TARGET_DIR=./lib
@@ -52,8 +52,8 @@ The `lib/` directory should contain:
 ```
 lib/
 ├── liblbug.so -> liblbug.so.0
-├── liblbug.so.0 -> liblbug.so.0.19.0.*
-├── liblbug.so.0.19.0.*
+├── liblbug.so.0 -> liblbug.so.0.21.2
+├── liblbug.so.0.21.2
 └── libpg_client.lbug_extension
 ```
 
@@ -237,7 +237,15 @@ via libpq, making it compatible with all PostgreSQL versions.
 
 ## Updating liblbug
 
+This repo currently targets **liblbug 0.21.2** with **pg_client 0.21.0**
+(pg_client tracks the Ladybug minor line, so 0.21.0 pairs with liblbug
+0.21.x) and **Icebug 13.2** for data-science / Icebug-disk workflows.
+
 ```bash
+# Download a pinned release
+LBUG_VERSION=0.21.2 LBUG_TARGET_DIR=./lib LBUG_LIB_KIND=shared bash scripts/download-liblbug.sh
+curl -fSL "https://extension.ladybugdb.com/v0.21.0/linux_amd64/pg_client/libpg_client.lbug_extension" -o lib/libpg_client.lbug_extension
+
 # Download a specific nightly build
 export LBUG_PRECOMPILED_RUN_ID=<run_id>
 bash scripts/download-liblbug.sh