sqlbuild 0.15.0__tar.gz → 0.16.1__tar.gz

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/.gitignore

@@ -59,3 +59,6 @@ sqlbuild_local.toml
 **/sqlbuild_local.toml
 
 .tmp*
+
+# Claude Code
+.claude/

sqlbuild-0.16.1/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.16.1"
+}

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [0.16.1](https://github.com/chio-labs/sqlbuild/compare/v0.16.0...v0.16.1) (2026-05-17)
+
+
+### Bug Fixes
+
+* emit skill frontmatter before generated marker ([28c7a7c](https://github.com/chio-labs/sqlbuild/commit/28c7a7c8cdd2030552f7dae2eec1381a6e169c40))
+* emit skill frontmatter before generated marker ([fc57032](https://github.com/chio-labs/sqlbuild/commit/fc57032d64eb6add883a00c6ef18633d5a6665e2))
+
+## [0.16.0](https://github.com/chio-labs/sqlbuild/compare/v0.15.0...v0.16.0) (2026-05-17)
+
+
+### Features
+
+* add MotherDuck adapter ([403d536](https://github.com/chio-labs/sqlbuild/commit/403d536c0af1a65ed793d3dc6744fb923c32e1a3))
+* add MotherDuck adapter ([36b70ef](https://github.com/chio-labs/sqlbuild/commit/36b70ef0746954db09a6755e79dd9d1ba585f947))
+* add PostgreSQL adapter ([2b7b1c5](https://github.com/chio-labs/sqlbuild/commit/2b7b1c5822a75eda23ab1610541ce8cdcb998802))
+* complete PostgresAdapter with testcontainer tests and e2e coverage ([428405c](https://github.com/chio-labs/sqlbuild/commit/428405cc0f9a4292b22bcd361df1584ef76bf1f0))
+
+
+### Bug Fixes
+
+* address reviewer feedback on postgres adapter coverage ([e1858bd](https://github.com/chio-labs/sqlbuild/commit/e1858bdcc1220a76861103c5c4acb5e4aaf501e1))
+* make shared waffle fixture warehouse portable ([d8b84fa](https://github.com/chio-labs/sqlbuild/commit/d8b84fa64bf1c51950958c772b6bfc48d7c5c81d))
+* make shared waffle fixture warehouse portable ([1ad677d](https://github.com/chio-labs/sqlbuild/commit/1ad677d47caa1fdb1fc7400e32004f724f285d9e))
+
 ## [0.15.0](https://github.com/chio-labs/sqlbuild/compare/v0.14.0...v0.15.0) (2026-05-17)
 
 

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/CONTRIBUTING.md

@@ -9,7 +9,7 @@ SQLBuild requires Python 3.12 or newer.
 Install dependencies with:
 
 ```bash
-uv sync
+uv sync --python 3.12 --all-extras
 ```
 
 ## Development Workflow

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/Makefile

@@ -45,6 +45,14 @@ test-real-databricks:
 	uv run pytest tests -m "real_warehouse and databricks" -vv
 
 
+test-real-postgres:
+	uv run pytest tests -m "real_warehouse and postgres" -vv
+
+
+test-real-motherduck:
+	uv run pytest tests -m "real_warehouse and motherduck" -vv
+
+
 test-e2e-real-snowflake:
 	uv run pytest tests/e2e -m "real_warehouse and snowflake" -vv
 

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlbuild
-Version: 0.15.0
+Version: 0.16.1
 Summary: Typed, test-first SQL pipelines with local E2E testing
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -16,6 +16,8 @@ Provides-Extra: databricks
 Requires-Dist: databricks-sql-connector[pyarrow]>=4.1.2; extra == 'databricks'
 Provides-Extra: performance
 Requires-Dist: sqlglot[c]>=30.7.0; extra == 'performance'
+Provides-Extra: postgres
+Requires-Dist: psycopg[binary]>=3.2.0; extra == 'postgres'
 Provides-Extra: snowflake
 Requires-Dist: snowflake-connector-python>=3.17.3; extra == 'snowflake'
 Provides-Extra: sqlglot

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sqlbuild"
-version = "0.15.0"
+version = "0.16.1"
 description = "Typed, test-first SQL pipelines with local E2E testing"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -34,6 +34,9 @@ dagster = [
   "dagster>=1.13.0",
   "dagster-webserver>=1.13.0",
 ]
+postgres = [
+  "psycopg[binary]>=3.2.0",
+]
 
 [project.scripts]
 sqb = "sqlbuild.cli.commands.main.entry:main"
@@ -52,6 +55,7 @@ dev = [
   "pytest>=8.4.2",
   "pytest-cov>=7.0.0",
   "ruff>=0.12.0",
+  "testcontainers>=4.8.1",
   "ty>=0.0.1a19",
 ]
 
@@ -73,6 +77,8 @@ markers = [
   "snowflake: tests that require a live Snowflake warehouse",
   "bigquery: tests that require a live BigQuery warehouse",
   "databricks: tests that require a live Databricks warehouse",
+  "postgres: tests that require a live PostgreSQL database",
+  "motherduck: tests that require live MotherDuck credentials",
 ]
 
 [tool.ruff]

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/scripts/generate_docs_skill.py

@@ -14,6 +14,15 @@ from typing import Any
 default_repo_url = "https://github.com/chio-labs/sqlbuild-docs"
 default_clone_dir = Path(tempfile.gettempdir()) / "sqlbuild-docs-skill-source"
 default_output_path = Path("src/sqlbuild/.agents/skills/sqlbuild/SKILL.md")
+generated_marker = "<!-- generated-by: sqlbuild skills update -->"
+skill_description = (
+    "Use when working with SQLBuild syntax, project structure, configuration, testing, "
+    "adapters, CLI behavior, SQLBuild docs, or SQLBuild-related code."
+)
+skill_frontmatter = f"""---
+name: sqlbuild
+description: {skill_description}
+---"""
 
 
 def main(argv: list[str] | None = None) -> int:
@@ -190,6 +199,8 @@ def _shift_markdown_heading(line: str) -> str:
 def _render_skill_header(*, page_paths: list[Path]) -> str:
     page_list = "\n".join(f"- `{path.with_suffix('').as_posix()}`" for path in page_paths)
     return (
+        f"{skill_frontmatter}\n\n"
+        f"{generated_marker}\n\n"
         "# SQLBuild Skill\n\n"
         "This file is generated from the SQLBuild documentation. Use it as the source of truth "
         "for SQLBuild syntax, project structure, configuration, testing, adapters, and CLI "

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/src/sqlbuild/.agents/skills/sqlbuild/SKILL.md

@@ -1,3 +1,10 @@
+---
+name: sqlbuild
+description: Use when working with SQLBuild syntax, project structure, configuration, testing, adapters, CLI behavior, SQLBuild docs, or SQLBuild-related code.
+---
+
+<!-- generated-by: sqlbuild skills update -->
+
 # SQLBuild Skill
 
 This file is generated from the SQLBuild documentation. Use it as the source of truth for SQLBuild syntax, project structure, configuration, testing, adapters, and CLI behavior.
@@ -11,9 +18,11 @@ This file is generated from the SQLBuild documentation. Use it as the source of
 - `concepts/project-configuration`
 - `concepts/adapters`
 - `concepts/adapters/duckdb`
+- `concepts/adapters/motherduck`
 - `concepts/adapters/snowflake`
 - `concepts/adapters/bigquery`
 - `concepts/adapters/databricks`
+- `concepts/adapters/postgres`
 - `concepts/sources`
 - `concepts/seeds`
 - `concepts/models`
@@ -685,7 +694,7 @@ SQLBuild, dbt, and SQLMesh are all SQL pipeline frameworks. They share common gr
 | dbt interop | Run alongside dbt - reads manifest, no migration | N/A | Jinja compatibility layer plus own macro system |
 | **Other** | | | |
 | Reference syntax | `__ref()` - parses as valid SQL | `{{ ref() }}` - Jinja template | `model_name` with dependency tracking |
-| Adapters | DuckDB, Snowflake, BigQuery, Databricks | 30+ (community adapters) | DuckDB, Snowflake, BigQuery, Databricks, Spark, Redshift, Postgres, Trino, MySQL |
+| Adapters | DuckDB, MotherDuck, Snowflake, BigQuery, Databricks, PostgreSQL | 30+ (community adapters) | DuckDB, Snowflake, BigQuery, Databricks, Spark, Redshift, Postgres, Trino, MySQL |
 | State requirements | Stateless by default | manifest.json + target/ | Requires state store (local database or PostgreSQL for production) |
 | Playground | `sqb playground` | Clone example repo | Example project |
 | AI agent skills | `sqb skills update` | No | No |
@@ -1051,10 +1060,11 @@ SQLBuild uses adapters to connect to different database engines.
 | Adapter | Status | Install |
 |---------|--------|---------|
 | [DuckDB](/concepts/adapters/duckdb) | Supported | included by default |
+| [MotherDuck](/concepts/adapters/motherduck) | Supported | included by default (uses DuckDB) |
 | [Snowflake](/concepts/adapters/snowflake) | Supported | `sqlbuild[snowflake]` |
 | [BigQuery](/concepts/adapters/bigquery) | Supported | `sqlbuild[bigquery]` |
 | [Databricks](/concepts/adapters/databricks) | Supported | `sqlbuild[databricks]` |
-| PostgreSQL | Coming soon | |
+| [PostgreSQL](/concepts/adapters/postgres) | Supported | `sqlbuild[postgres]` |
 | ClickHouse | Coming soon | |
 | Microsoft SQL Server | Coming soon | |
 
@@ -1204,6 +1214,75 @@ DuckDB defaults to `staged` promotion: tables are materialized into a staging ta
 table_promotion_mode = "staged"
 ```
 
+## MotherDuck
+
+Source: `concepts/adapters/motherduck.mdx`
+
+MotherDuck adapter configuration for SQLBuild.
+
+MotherDuck uses DuckDB's built-in `md:` connection support. No extra installation needed beyond the core DuckDB dependency.
+
+### Connection config
+
+```toml
+adapter = "motherduck"
+
+[connection]
+database = "my_database"
+token = "your_motherduck_token"
+```
+
+| Field | Description |
+|-------|-------------|
+| `database` | MotherDuck database name. Automatically prefixed with `md:` if not already present. Defaults to `md:` (your default MotherDuck database). |
+| `token` | MotherDuck access token. Can also be set via environment variable. |
+
+### Authentication
+
+MotherDuck requires an access token. Generate one from the MotherDuck UI and pass it via the connection config or an environment variable:
+
+```toml
+[connection]
+database = "my_database"
+token = "${ENV:MOTHERDUCK_TOKEN}"
+```
+
+### Per-environment connections
+
+Use environments to separate production and development databases on MotherDuck:
+
+```toml
+adapter = "motherduck"
+
+[connection]
+token = "${ENV:MOTHERDUCK_TOKEN}"
+
+[environments.prod]
+schema = "prod"
+
+[environments.prod.connection]
+database = "prod_db"
+
+[environments.dev]
+schema = "dev"
+
+[environments.dev.connection]
+database = "dev_db"
+```
+
+### Local development with DuckDB
+
+Use `sqlbuild_local.toml` to override the adapter for local development against a plain DuckDB file:
+
+```toml
+adapter = "duckdb"
+
+[connection]
+database = "local_dev.duckdb"
+```
+
+This lets you develop and test locally with zero MotherDuck compute cost, then deploy to MotherDuck in production. SQLBuild's [scenario replay](/concepts/scenarios) also runs locally in DuckDB regardless of the production adapter.
+
 ## Snowflake
 
 Source: `concepts/adapters/snowflake.mdx`
@@ -1351,6 +1430,67 @@ schema = "my_schema"
 
 On connect, SQLBuild runs `USE CATALOG` and `USE SCHEMA` statements to set the session context.
 
+## PostgreSQL
+
+Source: `concepts/adapters/postgres.mdx`
+
+PostgreSQL adapter configuration for SQLBuild.
+
+PostgreSQL requires the optional `psycopg` dependency:
+
+```bash
+pip install 'sqlbuild[postgres]'
+# or
+uv pip install 'sqlbuild[postgres]'
+```
+
+### Connection config
+
+```toml
+adapter = "postgres"
+
+[connection]
+host = "localhost"
+port = 5432
+user = "my_user"
+password = "my_password"
+dbname = "my_database"
+```
+
+| Field | Description |
+|-------|-------------|
+| `host` | PostgreSQL server hostname (default: `localhost`) |
+| `port` | PostgreSQL server port (default: `5432`) |
+| `user` | Database user |
+| `password` | Database password |
+| `dbname` | Database name |
+
+All fields in `connection` are passed to `psycopg.connect()`. See the [psycopg documentation](https://www.psycopg.org/psycopg3/docs/api/connections.html) for all available options.
+
+### Per-environment connections
+
+```toml
+adapter = "postgres"
+
+[connection]
+host = "localhost"
+user = "my_user"
+password = "${ENV:PG_PASSWORD}"
+
+[environments.prod]
+schema = "prod"
+
+[environments.prod.connection]
+host = "prod-db.example.com"
+dbname = "analytics"
+
+[environments.dev]
+schema = "dev"
+
+[environments.dev.connection]
+dbname = "analytics_dev"
+```
+
 ## Sources
 
 Source: `concepts/sources.mdx`
@@ -1506,7 +1646,7 @@ LEFT JOIN __seed("waffle_types") w ON o.waffle_type_id = w.waffle_type_id
 Seeds are loaded automatically during `sqb build`. You can also load them standalone:
 
 ```bash
-sqb --project-dir examples/waffle_shop seed
+sqb seed
 ```
 
 Seeds are fully replaced on every run. If the CSV changes, the table is recreated with the new data.
@@ -3268,7 +3408,7 @@ If a model is not incremental, `delta_and_final` degrades to `final` automatical
 ### Running audits standalone
 
 ```bash
-sqb --project-dir examples/waffle_shop audit
+sqb audit
 ```
 
 This runs all audits without rebuilding any models.
@@ -3960,9 +4100,9 @@ Selectors let you scope commands to specific subsets of your project. They work
 ### Basic usage
 
 ```bash
-sqb --project-dir examples/waffle_shop build --select daily_revenue
-sqb --project-dir examples/waffle_shop build --select daily_revenue customer_status_snapshot
-sqb --project-dir examples/waffle_shop build --exclude stg_customers
+sqb build --select daily_revenue
+sqb build --select daily_revenue customer_status_snapshot
+sqb build --exclude stg_customers
 ```
 
 `--select` (or `-s` for short) accepts one or more names. Multiple values are unioned. Space-separated names within one `--select` are also unioned. `--exclude` subtracts from the selected set.
@@ -4228,7 +4368,7 @@ Compare schemas and data between environments to validate changes before promoti
 SQLBuild can compare schemas and row-level data between any two environments. This lets you validate that changes in dev produce the expected results before promoting to production.
 
 ```bash
-sqb --project-dir examples/waffle_shop diff prod:dev --full --select customer_status_snapshot
+sqb diff prod:dev --full --select customer_status_snapshot
 ```
 
 ### Comparison modes
@@ -4800,7 +4940,7 @@ Compile returns exit code `1` when any error-severity diagnostic is found, makin
 #### Text output (default)
 
 ```bash
-sqb --project-dir examples/waffle_shop compile
+sqb compile
 ```
 
 ```
@@ -4823,7 +4963,7 @@ Each model shows its name, status (OK or FAIL), and column count. Models with co
 #### JSON output
 
 ```bash
-sqb --project-dir examples/waffle_shop compile --json
+sqb compile --json
 ```
 
 Returns a structured report including:
@@ -5013,7 +5153,7 @@ PASS=66  WARN=0  FAIL=0  SKIP=0  TOTAL=66  (1.09s)
 Use `--defer-to` to resolve unselected model references against another environment. This lets you build a subset of models in dev while referencing production tables for everything else:
 
 ```bash
-sqb --project-dir examples/waffle_shop build --select fact_orders --defer-to prod
+sqb build --select fact_orders --defer-to prod
 ```
 
 No `manifest.json` is required. Deferred references resolve directly against the live environment.
@@ -5094,10 +5234,10 @@ sqb --project-dir <path> test [flags]
 
 ```bash
 # Run all tests
-sqb --project-dir examples/waffle_shop test
+sqb test
 
 # Run tests for a specific model
-sqb --project-dir examples/waffle_shop test --select stg_orders
+sqb test --select stg_orders
 ```
 
 ## audit
@@ -5129,10 +5269,10 @@ sqb --project-dir <path> audit [flags]
 
 ```bash
 # Run all audits
-sqb --project-dir examples/waffle_shop audit
+sqb audit
 
 # Run audits for marts only
-sqb --project-dir examples/waffle_shop audit --select path:marts
+sqb audit --select path:marts
 ```
 
 ## seed
@@ -5162,10 +5302,10 @@ sqb --project-dir <path> seed [flags]
 
 ```bash
 # Load all seeds
-sqb --project-dir examples/waffle_shop seed
+sqb seed
 
 # Load a specific seed
-sqb --project-dir examples/waffle_shop seed --select seed:waffle_types
+sqb seed --select seed:waffle_types
 ```
 
 ## clone
@@ -5201,13 +5341,13 @@ sqb --project-dir <path> clone --from <env> --to <env> [flags]
 
 ```bash
 # Clone all models from prod to dev
-sqb --project-dir examples/waffle_shop clone --from prod --to dev
+sqb clone --from prod --to dev
 
 # Clone only marts to dev
-sqb --project-dir examples/waffle_shop clone --from prod --to dev --select path:marts
+sqb clone --from prod --to dev --select path:marts
 
 # Force physical copies
-sqb --project-dir examples/waffle_shop clone --from prod --to dev --hard-copy
+sqb clone --from prod --to dev --hard-copy
 ```
 
 ### Clone policies
@@ -5248,13 +5388,13 @@ The first argument is a positional environment range in `FROM:TO` format. Exactl
 
 ```bash
 # Full diff of a specific model
-sqb --project-dir examples/waffle_shop diff prod:dev --full --select customer_status_snapshot
+sqb diff prod:dev --full --select customer_status_snapshot
 
 # Schema-only diff of all marts
-sqb --project-dir examples/waffle_shop diff prod:dev --schema-only --select path:marts
+sqb diff prod:dev --schema-only --select path:marts
 
 # Bounded diff of last 14 days
-sqb --project-dir examples/waffle_shop diff prod:dev --bounded 14d --select hourly_order_activity
+sqb diff prod:dev --bounded 14d --select hourly_order_activity
 ```
 
 ### Exit codes
@@ -5305,7 +5445,7 @@ When the target is a plain resource name, lineage shows the model-level dependen
 The default. Shows an indented dependency tree with resource types and file paths:
 
 ```bash
-sqb --project-dir examples/waffle_shop lineage fact_orders --direction both
+sqb lineage fact_orders --direction both
 ```
 
 ```
@@ -5334,7 +5474,7 @@ Cycles and repeated nodes are annotated with "(already shown)" to avoid infinite
 An edge list showing each dependency as a directed pair:
 
 ```bash
-sqb --project-dir examples/waffle_shop lineage fact_orders --format list
+sqb lineage fact_orders --format list
 ```
 
 ```
@@ -5350,7 +5490,7 @@ seed:waffle_types    -> model:fact_orders
 Structured output with nodes, edges, and metadata:
 
 ```bash
-sqb --project-dir examples/waffle_shop lineage fact_orders --format json
+sqb lineage fact_orders --format json
 ```
 
 ```json
@@ -5396,7 +5536,7 @@ Column lineage supports `upstream` and `downstream` directions (not `both`). The
 #### Tree
 
 ```bash
-sqb --project-dir examples/waffle_shop lineage fact_orders.total_cents
+sqb lineage fact_orders.total_cents
 ```
 
 ```
@@ -5702,7 +5842,7 @@ The command runs three groups of checks:
 ### Example
 
 ```bash
-sqb --project-dir examples/waffle_shop debug
+sqb debug
 ```
 
 ```
@@ -5779,13 +5919,13 @@ See [Project Configuration](/concepts/project-configuration) for details on jani
 
 ```bash
 # Interactive mode (prompts for confirmation)
-sqb --project-dir examples/waffle_shop janitor
+sqb janitor
 
 # Auto-approve deletion
-sqb --project-dir examples/waffle_shop janitor --auto-approve
+sqb janitor --auto-approve
 
 # Override retention to 7 days
-sqb --project-dir examples/waffle_shop janitor --retention-days 7
+sqb janitor --retention-days 7
 ```
 
 ### Safety
@@ -5879,16 +6019,16 @@ order_id,customer_id,status
 
 ```bash
 # Quick inspection with default format
-sqb --project-dir examples/waffle_shop query "SELECT * FROM dev.fact_orders"
+sqb query "SELECT * FROM dev.fact_orders"
 
 # Table format with higher limit
-sqb --project-dir examples/waffle_shop query "SELECT * FROM dev.dim_customers" --format table --limit 50
+sqb query "SELECT * FROM dev.dim_customers" --format table --limit 50
 
 # Export to JSON
-sqb --project-dir examples/waffle_shop query "SELECT * FROM dev.daily_revenue" --format json --no-limit
+sqb query "SELECT * FROM dev.daily_revenue" --format json --no-limit
 
 # Run SQL from a file
-sqb --project-dir examples/waffle_shop query --file debug_query.sql
+sqb query --file debug_query.sql
 ```
 
 ## scenario

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/src/sqlbuild/adapter/base/base_adapter.py

@@ -1345,6 +1345,13 @@ class BaseAdapter(StrictAdapter):
             case FrameworkType.TIMESTAMP:
                 return "TIMESTAMP"
 
+    def render_source_expression_cast(
+        self, *, expression: str, target_type: str, alias: str
+    ) -> str:
+        """Render a generic cast projection for source expression type enforcement."""
+
+        return f"CAST({expression} AS {target_type}) AS {alias}"
+
     def render_set_difference_operator(self) -> str:
         """Render the generic SQL set-difference operator."""
 

sqlbuild-0.16.1/src/sqlbuild/adapter/shared/helpers/builtins.py

@@ -0,0 +1,26 @@
+"""Built-in adapter registry."""
+
+from __future__ import annotations
+
+from sqlbuild.adapter.base.base_adapter import BaseAdapter
+from sqlbuild.adapter.shared.types import BuiltinAdapter
+
+
+def builtin_adapter_classes() -> dict[str, type[BaseAdapter]]:
+    """Return built-in adapter classes keyed by adapter name."""
+
+    from sqlbuild.integrations.bigquery.client import BigQueryAdapter
+    from sqlbuild.integrations.databricks.client import DatabricksAdapter
+    from sqlbuild.integrations.duckdb.client import DuckDbAdapter
+    from sqlbuild.integrations.motherduck.client import MotherDuckAdapter
+    from sqlbuild.integrations.postgres.client import PostgresAdapter
+    from sqlbuild.integrations.snowflake.client import SnowflakeAdapter
+
+    return {
+        BuiltinAdapter.DUCKDB.value: DuckDbAdapter,
+        BuiltinAdapter.MOTHERDUCK.value: MotherDuckAdapter,
+        BuiltinAdapter.SNOWFLAKE.value: SnowflakeAdapter,
+        BuiltinAdapter.BIGQUERY.value: BigQueryAdapter,
+        BuiltinAdapter.DATABRICKS.value: DatabricksAdapter,
+        BuiltinAdapter.POSTGRES.value: PostgresAdapter,
+    }

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/src/sqlbuild/adapter/shared/types.py

@@ -12,9 +12,11 @@ type FunctionNullabilityRule = Callable[[tuple[InferredNullability, ...]], Infer
 
 class BuiltinAdapter(StrEnum):
     DUCKDB = "duckdb"
+    MOTHERDUCK = "motherduck"
     SNOWFLAKE = "snowflake"
     BIGQUERY = "bigquery"
     DATABRICKS = "databricks"
+    POSTGRES = "postgres"
 
 
 class CursorKind(StrEnum):
@@ -59,4 +61,5 @@ class TypeDialect(StrEnum):
     BIGQUERY = "bigquery"
     SNOWFLAKE = "snowflake"
     DUCKDB = "duckdb"
+    MOTHERDUCK = "motherduck"
     DATABRICKS = "databricks"

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/src/sqlbuild/adapter/strict/strict_adapter.py

@@ -519,6 +519,13 @@ class StrictAdapter(
         """Render one framework-internal logical type for this adapter."""
         ...
 
+    @abstractmethod
+    def render_source_expression_cast(
+        self, *, expression: str, target_type: str, alias: str
+    ) -> str:
+        """Render a cast projection for source expression type enforcement."""
+        ...
+
     @abstractmethod
     def render_set_difference_operator(self) -> str:
         """Render the set-difference operator keyword for this adapter."""

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/src/sqlbuild/cli/commands/main/helpers/skills/update.py

@@ -161,6 +161,11 @@ def load_packaged_skill_content() -> str:
 def ensure_generated_marker(content: str) -> str:
     if generated_marker in content:
         return content
+    if content.startswith("---\n"):
+        frontmatter_end: int = content.find("\n---\n", 4)
+        if frontmatter_end != -1:
+            insert_at: int = frontmatter_end + len("\n---\n")
+            return f"{content[:insert_at]}\n{generated_marker}\n{content[insert_at:]}"
     return f"{generated_marker}\n{content}"
 
 

{sqlbuild-0.15.0 → sqlbuild-0.16.1}/src/sqlbuild/cli/commands/main/shared/helpers/adapters.py

@@ -6,7 +6,7 @@ from pathlib import Path
 from typing import cast
 
 from sqlbuild.adapter.base.base_adapter import BaseAdapter
-from sqlbuild.adapter.shared.types import BuiltinAdapter
+from sqlbuild.adapter.shared.helpers.builtins import builtin_adapter_classes
 from sqlbuild.adapter.strict.strict_adapter import StrictAdapter
 from sqlbuild.cli.commands.main.shared.exceptions import CliUserError
 from sqlbuild.shared.helpers.adapters import discover_project_adapters
@@ -15,7 +15,7 @@ from sqlbuild.shared.helpers.adapters import discover_project_adapters
 def resolve_adapter(adapter_name: str, *, project_dir: Path | None = None) -> BaseAdapter:
     """Resolve an adapter name from project config to an adapter instance."""
 
-    builtin_adapters: dict[str, type[BaseAdapter]] = _builtin_adapter_classes()
+    builtin_adapters: dict[str, type[BaseAdapter]] = builtin_adapter_classes()
     adapter_class: type[StrictAdapter] | None = None
     if project_dir is not None:
         local_adapters: dict[str, type[StrictAdapter]] = discover_project_adapters(
@@ -36,17 +36,3 @@ def resolve_adapter(adapter_name: str, *, project_dir: Path | None = None) -> Ba
             code="C601",
         )
     return cast(BaseAdapter, adapter_class())
-
-
-def _builtin_adapter_classes() -> dict[str, type[BaseAdapter]]:
-    from sqlbuild.integrations.bigquery.client import BigQueryAdapter
-    from sqlbuild.integrations.databricks.client import DatabricksAdapter
-    from sqlbuild.integrations.duckdb.client import DuckDbAdapter
-    from sqlbuild.integrations.snowflake.client import SnowflakeAdapter
-
-    return {
-        BuiltinAdapter.DUCKDB.value: DuckDbAdapter,
-        BuiltinAdapter.SNOWFLAKE.value: SnowflakeAdapter,
-        BuiltinAdapter.BIGQUERY.value: BigQueryAdapter,
-        BuiltinAdapter.DATABRICKS.value: DatabricksAdapter,
-    }