Add dbt to runner test suite, other improvements. (#265)

* Add initial dbt test.

* Fix some runner issues, rename some queries to avoi confusion.

* Add stub flag for queries that return something, rather than nothing at all.

* Bump jdbc to avoid security warning.

Author: jghoman

scripts/client-compat/CLAUDE.md

@@ -25,6 +25,7 @@ scripts/client-compat/
 │   ├── tokio-postgres/
 │   ├── node-postgres/
 │   ├── sqlalchemy/
+│   ├── dbt/
 │   └── harlequin/
 └── results/                    # output volume (.gitignored)
 ```
@@ -118,6 +119,7 @@ The shared queries YAML format:
 ```yaml
 - suite: catalog_views
   name: pg_database
+  stub: true            # optional — flags hardcoded dummy return values
   sql: SELECT datname FROM pg_database WHERE datallowconn
 ```
 
@@ -194,8 +196,8 @@ Group related tests under a suite name. Common conventions:
 
 Exported to `results/results_<timestamp>.duckdb` with:
 
-- `queries` table — the shared query catalog from `queries.yaml`
+- `queries` table — the shared query catalog from `queries.yaml` (includes `stub` boolean)
 - `results` table — all test outcomes (client, suite, test_name, status, detail, ts)
-- `coverage` view — LEFT JOIN of queries to results (shows gaps)
+- `coverage` view — LEFT JOIN of queries to results (shows gaps, includes `stub` flag)
 
 Open with `just query-last-run` or `duckdb results/results_*.duckdb`.

scripts/client-compat/README.md

@@ -34,7 +34,7 @@ just query-last-run
 | `just view-last-run` | Print the full results table |
 | `just query-last-run` | Open the latest results database in DuckDB CLI |
 
-Available single-client targets: `psycopg`, `pgx`, `psql`, `jdbc`, `tokio-postgres`, `node-postgres`, `sqlalchemy`.
+Available single-client targets: `psycopg`, `pgx`, `psql`, `jdbc`, `tokio-postgres`, `node-postgres`, `sqlalchemy`, `dbt`.
 
 ## Clients
 
@@ -47,6 +47,7 @@ Available single-client targets: `psycopg`, `pgx`, `psql`, `jdbc`, `tokio-postgr
 | tokio-postgres | Rust 1.84 | tokio-postgres 0.7 | rust:1.84-bookworm |
 | node-postgres | Node.js 22 | pg 8.x | node:22-bookworm-slim |
 | sqlalchemy | Python 3.12 | SQLAlchemy 2.x + psycopg2 | python:3.12-slim |
+| dbt | Python 3.12 | dbt-postgres (psycopg2) | python:3.12-slim |
 
 ## Architecture
 
@@ -91,15 +92,17 @@ Every client runs two categories of tests:
 
 ### Shared Queries (`queries.yaml`)
 
-A YAML catalog of 44 queries across 5 suites that every client executes. A query passes if it executes without error (row counts are reported but not validated).
+A YAML catalog of 58 queries across 5 suites that every client executes. A query passes if it executes without error (row counts are reported but not validated).
+
+Queries may be tagged `stub: true` to indicate the underlying function or view returns a hardcoded dummy value (empty string, NULL, 0, false, or empty result set) rather than meaningful data. This distinguishes "won't crash your client" from "returns useful information" in the results.
 
 | Suite | Count | Purpose |
 |-------|-------|---------|
 | `catalog_views` | 7 | Core pg_catalog views (`pg_database`, `pg_namespace`, `pg_type`, etc.) |
-| `catalog_funcs` | 14 | PostgreSQL functions (`format_type`, `version()`, `current_setting`, etc.) |
+| `catalog_funcs` | 26 | PostgreSQL functions (`format_type`, `version()`, `pg_get_indexdef`, size functions, etc.) |
 | `info_schema` | 4 | `information_schema.tables`, `.columns`, `.schemata` |
 | `catalog_joins` | 5 | Multi-table joins that real tools emit (psql `\dt`, `\dn`, `\l` queries) |
-| `catalog_stubs` | 14 | Stub views that must exist but return empty (`pg_matviews`, `pg_policy`, etc.) |
+| `catalog_stubs` | 16 | Stub views that must exist but return empty (`pg_matviews`, `pg_policy`, etc.) |
 
 ### Client-Specific Suites
 
@@ -114,6 +117,7 @@ Each client tests driver-specific features beyond the shared catalog:
 | tokio-postgres | `connection`, `ddl_dml`, `prepared` |
 | node-postgres | `connection`, `ddl_dml`, `prepared`, `result_metadata` |
 | sqlalchemy | `connection`, `core_ddl_dml`, `orm`, `inspection`, `raw_params` |
+| dbt | `dbt_lifecycle` (`dbt debug`, `dbt run`, `dbt test`, `dbt docs generate`) |
 
 ## Results
 
@@ -139,7 +143,8 @@ results/
 CREATE TABLE queries (
     suite VARCHAR,
     name  VARCHAR,
-    sql   VARCHAR
+    sql   VARCHAR,
+    stub  BOOLEAN DEFAULT false  -- true = hardcoded dummy return value
 );
 
 -- Test outcomes
@@ -154,7 +159,7 @@ CREATE TABLE results (
 
 -- Coverage: LEFT JOIN of queries to results (shows untested queries)
 CREATE VIEW coverage AS
-SELECT q.suite, q.name, q.sql,
+SELECT q.suite, q.name, q.sql, q.stub,
        r.client, r.status, r.detail, r.ts
 FROM queries q
 LEFT JOIN results r ON q.suite = r.suite AND q.name = r.test_name;

scripts/client-compat/clients/dbt/Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.12-slim-bookworm
+
+RUN apt-get update && apt-get install -y --no-install-recommends git && rm -rf /var/lib/apt/lists/*
+RUN pip install --no-cache-dir dbt-postgres pyyaml
+
+COPY entrypoint.sh /entrypoint.sh
+COPY queries.yaml /queries.yaml
+COPY report_client.py /report_client.py
+COPY clients/dbt/test_dbt.py /test_dbt.py
+COPY clients/dbt/project /dbt_project
+
+ENTRYPOINT ["/entrypoint.sh", "python", "/test_dbt.py"]

scripts/client-compat/clients/dbt/project/dbt_project.yml

@@ -0,0 +1,7 @@
+name: duckgres_compat
+version: "1.0.0"
+
+profile: duckgres
+
+model-paths: ["models"]
+test-paths: ["tests"]

scripts/client-compat/clients/dbt/project/models/agg_summary.sql

@@ -0,0 +1,9 @@
+-- A table materialization that aggregates from the view
+{{ config(materialized='table') }}
+
+SELECT
+    count(*) AS total_rows,
+    min(value) AS min_value,
+    max(value) AS max_value,
+    avg(value) AS avg_value
+FROM {{ ref('staging_numbers') }}

scripts/client-compat/clients/dbt/project/models/schema.yml

@@ -0,0 +1,15 @@
+version: 2
+
+models:
+  - name: staging_numbers
+    columns:
+      - name: id
+        tests:
+          - not_null
+          - unique
+
+  - name: agg_summary
+    columns:
+      - name: total_rows
+        tests:
+          - not_null

scripts/client-compat/clients/dbt/project/models/staging_numbers.sql

@@ -0,0 +1,8 @@
+-- A simple view model that generates test data
+{{ config(materialized='view') }}
+
+SELECT
+    i AS id,
+    'item_' || i::VARCHAR AS name,
+    (i * 10.5)::DOUBLE AS value
+FROM generate_series(1, 100) AS t(i)

scripts/client-compat/clients/dbt/project/profiles.yml

@@ -0,0 +1,12 @@
+duckgres:
+  target: dev
+  outputs:
+    dev:
+      type: postgres
+      host: "{{ env_var('PGHOST', 'duckgres') }}"
+      port: "{{ env_var('PGPORT', '5432') | int }}"
+      user: "{{ env_var('PGUSER', 'postgres') }}"
+      pass: "{{ env_var('PGPASSWORD', 'postgres') }}"
+      dbname: postgres
+      schema: public
+      sslmode: require