chore: harden ci and maximize typing for 4.0

Author: woxxy

.github/workflows/buddy-integration.yml

@@ -13,6 +13,7 @@ jobs:
       packages: read
     env:
       SEARCH_BUILD: MANTICORE
+      MANTICORE_IMAGE: manticoresearch/manticore@sha256:24835e1b590a31da0f45809b032865b1caab0a1b58f4ed14da9128a338f2d365
 
     steps:
       - name: Checkout
@@ -28,24 +29,33 @@ jobs:
 
       - name: Start Manticore with Buddy extras
         run: |
-          docker pull manticoresearch/manticore:latest
+          docker pull "$MANTICORE_IMAGE"
           docker run -d --name searchd \
             -e EXTRA=1 \
             -p 9307:9306 \
             -p 9312:9312 \
-            manticoresearch/manticore:latest
+            "$MANTICORE_IMAGE"
 
       - name: Wait for searchd
         run: |
           n=0
           while [ "$n" -lt 60 ]; do
-            if (echo > /dev/tcp/127.0.0.1/9307) >/dev/null 2>&1; then
+            if php -r '
+              try {
+                $pdo = new PDO("mysql:host=127.0.0.1;port=9307", "", "");
+                $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
+                $pdo->query("SHOW TABLES");
+                exit(0);
+              } catch (Throwable $exception) {
+                exit(1);
+              }
+            ' >/dev/null 2>&1; then
               exit 0
             fi
             n=$((n + 1))
             sleep 1
           done
-          echo "searchd did not become ready on 127.0.0.1:9307"
+          echo "searchd did not become SQL-ready on 127.0.0.1:9307"
           docker logs searchd || true
           exit 1
 

.github/workflows/ci.yml

@@ -32,6 +32,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Setup PHP
         if: env.COVERAGE_LANE != 'true'
@@ -101,13 +103,22 @@ jobs:
         run: |
           n=0
           while [ "$n" -lt 60 ]; do
-            if (echo > /dev/tcp/127.0.0.1/9307) >/dev/null 2>&1; then
+            if php -r '
+              try {
+                $pdo = new PDO("mysql:host=127.0.0.1;port=9307", "", "");
+                $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
+                $pdo->query("SHOW TABLES");
+                exit(0);
+              } catch (Throwable $exception) {
+                exit(1);
+              }
+            ' >/dev/null 2>&1; then
               exit 0
             fi
             n=$((n + 1))
             sleep 1
           done
-          echo "searchd did not become ready on 127.0.0.1:9307"
+          echo "searchd did not become SQL-ready on 127.0.0.1:9307"
           docker logs searchd || true
           exit 1
 
@@ -147,36 +158,25 @@ jobs:
 
           if [ "${{ github.event_name }}" = "pull_request" ]; then
             BASE_SHA="${{ github.event.pull_request.base.sha }}"
-            BASE_REF="${{ github.event.pull_request.base.ref }}"
             BASE_LABEL="PR base (${BASE_SHA})"
-            git fetch --no-tags --depth=1 origin "${BASE_REF}" || true
-
-            if ! git cat-file -e "${BASE_SHA}^{commit}" 2>/dev/null; then
-              if git cat-file -e "origin/${BASE_REF}^{commit}" 2>/dev/null; then
-                BASE_SHA="origin/${BASE_REF}"
-                BASE_LABEL="PR base ref (${BASE_SHA})"
-              else
-                BASE_SHA="$(git rev-parse HEAD~1)"
-                BASE_LABEL="fallback (HEAD~1)"
-              fi
-            fi
           else
             BASE_SHA="${{ github.event.before }}"
+            BASE_LABEL="push before (${BASE_SHA})"
+          fi
+
+          if [ -z "${BASE_SHA}" ] \
+            || [ "${BASE_SHA}" = "0000000000000000000000000000000000000000" ] \
+            || ! git cat-file -e "${BASE_SHA}^{commit}" 2>/dev/null; then
             DEFAULT_BRANCH="${{ github.event.repository.default_branch }}"
-            if [ -z "${BASE_SHA}" ] \
-              || [ "${BASE_SHA}" = "0000000000000000000000000000000000000000" ] \
-              || ! git cat-file -e "${BASE_SHA}^{commit}" 2>/dev/null; then
-              git fetch --no-tags --depth=2 origin "${DEFAULT_BRANCH}" || true
-              if git cat-file -e "origin/${DEFAULT_BRANCH}~1^{commit}" 2>/dev/null; then
-                BASE_SHA="origin/${DEFAULT_BRANCH}~1"
-                BASE_LABEL="fallback (${BASE_SHA})"
-              else
-                BASE_SHA="$(git rev-parse HEAD~1)"
-                BASE_LABEL="fallback (HEAD~1)"
-              fi
+            if git show-ref --verify --quiet "refs/remotes/origin/${DEFAULT_BRANCH}"; then
+              BASE_SHA="$(git merge-base "origin/${DEFAULT_BRANCH}" HEAD)"
+              BASE_LABEL="merge-base (origin/${DEFAULT_BRANCH})"
+            elif git cat-file -e "HEAD~1^{commit}" 2>/dev/null; then
+              BASE_SHA="$(git rev-parse HEAD~1)"
+              BASE_LABEL="fallback (HEAD~1)"
             else
-              BASE_LABEL="push before (${BASE_SHA})"
-              git fetch --no-tags --depth=1 origin "${BASE_SHA}" || true
+              BASE_SHA="$(git rev-parse HEAD)"
+              BASE_LABEL="fallback (HEAD)"
             fi
           fi
 

.github/workflows/docs.yml

@@ -8,8 +8,6 @@ on:
       - README.md
       - .github/workflows/docs.yml
   push:
-    branches:
-      - master
     paths:
       - docs/**
       - README.md

.github/workflows/publish-search-images.yml

@@ -11,6 +11,7 @@ on:
       - tests/sphinx.conf
       - tests/manticore.conf
       - tests/test_udf.c
+      - tests/s3_test_udf.c
       - tests/ms_test_udf.c
 
 permissions:

CHANGELOG.md

@@ -1,7 +1,6 @@
 #### 4.0.0
 * Dropped support for PHP 8.1 and lower (minimum PHP is now 8.2)
 * Updated CI PHP matrix to 8.2 and 8.3
-* Restored runtime-level driver normalization for PDO/MySQLi scalar fetch values
 * Normalized MySQLi driver exception handling for modern PHP `mysqli_sql_exception` behavior
 * Hardened runtime validation for `SphinxQL`, `Facet`, `Helper`, and `Percolate` input contracts (fail-fast exceptions for invalid query-shape input)
 * Standardized driver exception message prefixes for better diagnostics (`[mysqli][...]`, `[pdo][...]`)
@@ -16,10 +15,14 @@
 * Added and stabilized Sphinx 3 compatibility coverage while preserving Sphinx 2 and Manticore test behavior
 * Added support for optional connection credentials (`username`/`password`) in both PDO and MySQLi drivers (closes #208)
 * Added optional-index `update($index = null)` flow for fluent `->update()->into($index)` usage (closes #184)
+* Added explicit `update()->compile()/execute()` guard when no target index is set via `into($index)` (prevents invalid `UPDATE` SQL emission)
+* Restored `showTables($index = null)` compatibility (`SHOW TABLES` for null/empty, `SHOW TABLES LIKE ...` for non-empty) and removed hardcoded `rt` assumptions from runtime capability probes
+* Aligned Buddy capability flags so `callQSuggest()`/`callAutocomplete()` are gated by detected Buddy availability
 * Added MVA insert/update array example in README (closes #178)
 * Corrected escaping docs to reference connection-level helpers and clarified `quoteIdentifier()` availability (closes #203)
 * Added a root `LICENSE` file (closes #171)
 * Migrated CI to GitHub Actions-only validation with strict composer metadata checks
+* Hardened GitHub Actions reliability with SQL-readiness checks, full-history checkout for changed-line artifacts, and digest-pinned Buddy integration runtime image
 * Updated documentation and added a dedicated `MIGRATING-4.0.md` guide
 
 #### 3.0.2

MIGRATING-4.0.md

@@ -25,6 +25,7 @@ The following now throw on invalid input:
 - `groupNBy()` non-positive values
 - `where()` / `having()` invalid filter value shape for `IN`/`NOT IN`/`BETWEEN`
 - `into()`, `columns()`, `values()`, `value()`, `set()` invalid/empty input
+- `update()->compile()` / `update()->execute()` without `into($index)`
 - `setQueuePrev()` non-`SphinxQL` argument
 
 ### Facet strict validation
@@ -38,7 +39,8 @@ The following now throw on invalid input:
 
 Helper methods now validate required identifiers and argument shapes:
 
-- `showTables()`, `describe()`, `showIndexStatus()`, `flushRtIndex()`,
+- `showTables()` accepts `null`/empty for unfiltered `SHOW TABLES`, and validates non-string filters
+- `describe()`, `showIndexStatus()`, `flushRtIndex()`,
   `truncateRtIndex()`, `optimizeIndex()`, `flushRamchunk()`, etc.
 - `setVariable()` validates variable names and array values
 - `callSnippets()` and `callKeywords()` validate required arguments

README.md

@@ -277,8 +277,12 @@ Will return an array with an `INT` as first member, the number of rows deleted.
     $sq->where('column', 'BETWEEN', array('value1', 'value2'));
 	```
 
-	You can compose grouped boolean filters with:
-	`orWhere()`, `whereOpen()`, `orWhereOpen()`, and `whereClose()`.
+		You can compose grouped boolean filters with:
+		`orWhere()`, `whereOpen()`, `orWhereOpen()`, and `whereClose()`.
+		The same grouped API exists for `HAVING` via `having()`, `orHaving()`,
+		`havingOpen()`, `orHavingOpen()`, and `havingClose()`.
+		Repeated `having()` calls are additive (`AND`) unless you explicitly use
+		`orHaving()` or grouped clauses.
 
 #### MATCH
 
@@ -526,7 +530,7 @@ $result = (new SphinxQL($this->conn))
 * `(new Helper($conn))->showDatabases() => 'SHOW DATABASES'`
 * `(new Helper($conn))->showCharacterSet() => 'SHOW CHARACTER SET'`
 * `(new Helper($conn))->showCollation() => 'SHOW COLLATION'`
-* `(new Helper($conn))->showTables($index) => 'SHOW TABLES LIKE <quoted index>'`
+* `(new Helper($conn))->showTables($index = null) => 'SHOW TABLES' (null/empty) or 'SHOW TABLES LIKE <quoted index>'`
 * `(new Helper($conn))->showVariables() => 'SHOW VARIABLES'`
 * `(new Helper($conn))->showCreateTable($table)`
 * `(new Helper($conn))->showTableStatus($table = null) => 'SHOW TABLE STATUS' or 'SHOW TABLE <table> STATUS'`

docs/feature-matrix.yml

@@ -1,5 +1,5 @@
 version: 1
-updated_at: "2026-02-27"
+updated_at: "2026-02-28"
 notes:
   - "supported means covered by runtime tests in at least one CI lane."
   - "conditional means feature depends on engine/runtime capability checks."
@@ -43,7 +43,7 @@ helper:
     sphinx3: supported
     manticore: supported
     notes:
-      - "showTables($index) compiles to SHOW TABLES LIKE <quoted index>; index must be a non-empty string."
+      - "showTables($index = null) compiles to SHOW TABLES when index is null/empty, or SHOW TABLES LIKE <quoted index> for non-empty strings."
   diagnostic_show:
     api: ["showProfile", "showPlan", "showThreads", "showPlugins", "showQueries"]
     sphinx2: conditional

docs/helper.rst

@@ -32,7 +32,7 @@ Available Methods
 - ``showDatabases()``
 - ``showCharacterSet()``
 - ``showCollation()``
-- ``showTables($index)``
+- ``showTables($index = null)``
 - ``showVariables()``
 - ``showCreateTable($table)``
 - ``showTableStatus($table = null)``
@@ -66,7 +66,10 @@ Available Methods
 Filtered SHOW Wrappers
 ----------------------
 
-- ``showTables($index)`` compiles to ``SHOW TABLES LIKE <quoted index>``.
+- ``showTables($index = null)`` compiles to:
+
+  - ``SHOW TABLES`` when ``$index`` is ``null`` or an empty string
+  - ``SHOW TABLES LIKE <quoted index>`` when ``$index`` is a non-empty string
 - ``showTableStatus($table = null)`` compiles to:
 
   - ``SHOW TABLE STATUS`` when ``$table`` is ``null``

docs/query-builder.rst

@@ -73,6 +73,9 @@ The builder supports grouped boolean filters for ``WHERE`` and ``HAVING``:
 - ``orHaving()``
 - ``havingOpen()`` / ``orHavingOpen()`` / ``havingClose()``
 
+Repeated ``having()`` calls are additive and compile as ``AND`` conditions unless
+you explicitly use ``orHaving()`` / grouped clauses.
+
 JOIN and KNN Ordering
 ---------------------
 
@@ -100,7 +103,7 @@ The same capability model is used by ``Helper`` wrappers:
 
 - filtered ``SHOW`` wrappers:
 
-  - ``showTables($index)`` => ``SHOW TABLES LIKE <quoted index>``
+  - ``showTables($index = null)`` => ``SHOW TABLES`` (when ``null`` or empty) or ``SHOW TABLES LIKE <quoted index>``
   - ``showTableStatus($table = null)`` => ``SHOW TABLE STATUS`` or ``SHOW TABLE <table> STATUS``
 
 - suggest-family option contract (``callSuggest()``, ``callQSuggest()``,