Support the Dolt 2.2.x release family

Author: TonisOrmisson

.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
         uses: actions/checkout@v7
         with: &specification-checkout
           repository: OpenStatSpec/specification
-          ref: e94ae8349d2b0dffe0c65e820b4b22b8c074b7b5
+          ref: d287c2cde9ade71f04e27dd012caec876901aed5
           path: openstatspec-specification
       - name: Checkout required SPSS engine
         uses: actions/checkout@v7
@@ -143,10 +143,20 @@ jobs:
     steps: *sql-test-steps
 
   dolt-integration:
-    name: Dolt 2.2.2 integration
+    name: Dolt ${{ matrix.dolt }} integration
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - dolt: "2.2.2"
+            image: dolthub/dolt:2.2.2@sha256:ae85afdd95317f0a982cab87fa3092a5a2e6689bc5de822ad7ae4f65b86d39a1
+          - dolt: "2.2.3"
+            image: dolthub/dolt:2.2.3@sha256:1a651e738a2e7275b9c69fec8c5f42c6e23954314405c412f4dc9287ee7c0080
     env:
       OPENSTATSPEC_DOLT_URL: mysql+pymysql://openstatspec:openstatspec@127.0.0.1:13308/openstatspec
+      OPENSTATSPEC_EXPECTED_DOLT_VERSION: ${{ matrix.dolt }}
+      OPENSTATSPEC_DOLT_IMAGE: ${{ matrix.image }}
     steps:
       - uses: actions/checkout@v7
       - name: Checkout OpenStatSpec specification fixtures
@@ -158,29 +168,29 @@ jobs:
       - uses: actions/setup-python@v7
         with:
           python-version: "3.12"
-      - name: Initialize Dolt 2.2.2
+      - name: Initialize Dolt ${{ matrix.dolt }}
         run: |
           mkdir -p "$RUNNER_TEMP/openstatspec-dolt"
           docker run --rm \
             --volume "$RUNNER_TEMP/openstatspec-dolt:/var/lib/dolt" \
             --workdir /var/lib/dolt \
-            dolthub/dolt:2.2.2 init \
+            "$OPENSTATSPEC_DOLT_IMAGE" init \
             --name "OpenStatSpec CI" --email "ci@openstatspec.org"
           docker run --rm \
             --volume "$RUNNER_TEMP/openstatspec-dolt:/var/lib/dolt" \
             --workdir /var/lib/dolt \
-            dolthub/dolt:2.2.2 sql \
+            "$OPENSTATSPEC_DOLT_IMAGE" sql \
             -q "CREATE DATABASE openstatspec"
           docker run --rm \
             --volume "$RUNNER_TEMP/openstatspec-dolt:/var/lib/dolt" \
             --workdir /var/lib/dolt \
-            dolthub/dolt:2.2.2 sql \
+            "$OPENSTATSPEC_DOLT_IMAGE" sql \
             -q "CREATE USER 'openstatspec'@'%' IDENTIFIED BY 'openstatspec'; GRANT ALL PRIVILEGES ON openstatspec.* TO 'openstatspec'@'%'"
           docker run --detach --name openstatspec-dolt \
             --publish 127.0.0.1:13308:3306 \
             --volume "$RUNNER_TEMP/openstatspec-dolt:/var/lib/dolt" \
             --workdir /var/lib/dolt \
-            dolthub/dolt:2.2.2 sql-server -H 0.0.0.0 -l warning
+            "$OPENSTATSPEC_DOLT_IMAGE" sql-server -H 0.0.0.0 -l warning
       - run: python -m pip install --upgrade pip
       - run: python -m pip install ./openstatspec-pyspssio
       - run: python -m pip install -e ".[dev,sql]"

.github/workflows/release.yml

@@ -47,7 +47,7 @@ jobs:
         uses: actions/checkout@v7
         with:
           repository: OpenStatSpec/specification
-          ref: e94ae8349d2b0dffe0c65e820b4b22b8c074b7b5
+          ref: d287c2cde9ade71f04e27dd012caec876901aed5
           path: openstatspec-specification
       - name: Checkout required SPSS engine
         uses: actions/checkout@v7

CHANGELOG.md

@@ -10,16 +10,17 @@ All notable changes to this reference implementation are documented here.
   CI evidence: PostgreSQL 17.x/18.x at 17.10/18.4, MySQL 8.4.x/9.7.x at
   8.4.11/9.7.2, and MariaDB 11.4.x/11.8.x/12.3.x at
   11.4.12/11.8.8/12.3.2. Each service job verifies the live normalized version.
-- Dolt remains independently pinned and service-tested at exact version 2.2.2.
+- Dolt remains an independent core profile, now claiming canonical stable
+  versions `>=2.2.2,<2.3.0` and running its complete service suite at exact
+  versions 2.2.2 and 2.2.3 from immutable container-image pins.
   SQLite retains its core `>=3.24.0,<4.0.0` and optional workflow
   `>=3.35.0,<4.0.0` tiers. MSSQL remains unsupported and roadmap-only.
 
 ### Specification basis
 
-- CI, release validation, and machine-readable capabilities use untagged
-  OpenStatSpec specification `main` commit
-  `e94ae8349d2b0dffe0c65e820b4b22b8c074b7b5`; the specification release value
-  is null until that commit is tagged.
+- CI, release validation, and machine-readable capabilities use OpenStatSpec
+  specification release `v0.1.0` at exact commit
+  `d287c2cde9ade71f04e27dd012caec876901aed5`.
 
 ## 0.2.0 — 2026-07-30
 

README.md

@@ -69,23 +69,25 @@ in operation metadata. There is no fallback reader or writer. It supports unencr
 SAV/ZSAV export for the semantics exposed by that engine. SQLite is the local
 reference path.
 PostgreSQL, MySQL, MariaDB, and Dolt are each covered by separate service-backed CI
-conformance checks. Dolt support is an independent core profile pinned to 2.2.2;
-other Dolt versions and unknown MySQL-wire products fail closed.
+conformance checks. Dolt support is an independent core profile for the
+canonical stable range `>=2.2.2,<2.3.0`; earlier patches, other families,
+noncanonical versions, and unknown MySQL-wire products fail closed.
 
 The supported family claims are broader than the deliberately exact CI
 evidence points: PostgreSQL 17.x/18.x is exercised at 17.10/18.4, MySQL
 8.4.x/9.7.x at 8.4.11/9.7.2, and MariaDB 11.4.x/11.8.x/12.3.x at
 11.4.12/11.8.8/12.3.2. Each service job checks the normalized live server
 version against its exact matrix entry before that run can count as evidence.
-Dolt remains a separate exact-version policy: its only claimed and CI-tested
-version is 2.2.2.
+Dolt claims the conservative 2.2.x range `>=2.2.2,<2.3.0`; its full service
+suite is exercised independently at exact versions 2.2.2 and 2.2.3 using
+immutable container-image digests.
 
 Use these explicit SQLAlchemy URLs:
 
 - SQLite: `sqlite:///dataset.sqlite`
 - PostgreSQL: `postgresql+psycopg://user:password@host/database`
 - MySQL/MariaDB: `mysql+pymysql://user:password@host/database`
-- Dolt 2.2.2: `mysql+pymysql://user:password@host/database` (detected by server identity)
+- Dolt `>=2.2.2,<2.3.0`: `mysql+pymysql://user:password@host/database` (detected by server identity)
 
 The Dolt core profile supports strict wide-table import, validation, and export;
 the separate Transformation Workflow is unsupported.

docs/release-readiness.md

@@ -20,12 +20,12 @@ database contract.
 | PostgreSQL | `postgresql+psycopg://…` | 17.x and 18.x | 17.10 and 18.4 |
 | MySQL | `mysql+pymysql://…` | 8.4.x and 9.7.x | 8.4.11 and 9.7.2 |
 | MariaDB | `mysql+pymysql://…` | 11.4.x, 11.8.x, and 12.3.x | 11.4.12, 11.8.8, and 12.3.2 |
-| Dolt | `mysql+pymysql://…` | Exact 2.2.2 | Exact 2.2.2 |
+| Dolt | `mysql+pymysql://…` | 2.2.x with `>=2.2.2,<2.3.0` | 2.2.2 and 2.2.3 |
 
 Separate service matrices test the shared MySQL/MariaDB profile contract while
 retaining distinct active-server identities and version claims. Dolt is an
-independent core profile that fails closed unless the product version is exactly
-2.2.2; the optional Transformation Workflow remains SQLite-only. This does not
+independent core profile that accepts only canonical stable versions in
+`>=2.2.2,<2.3.0`; the optional Transformation Workflow remains SQLite-only. This does not
 claim coverage for every server configuration. The machine-readable capability
 declaration reports both the theoretical profile boundaries and effective
 limits observed from the active connection.
@@ -64,13 +64,13 @@ machine-readable loss report with the export result.
 2. Run `python -m pytest -m "not services"`.
 3. Confirm the GitHub Actions matrix is green for exact PostgreSQL 17.10/18.4,
    MySQL 8.4.11/9.7.2, MariaDB 11.4.12/11.8.8/12.3.2, and exact Dolt
-   2.2.2 service evidence.
+   2.2.2/2.2.3 service evidence from the immutable image pins in CI.
 4. Build with `python -m build` and install the generated wheel in a clean
    environment.
 5. Confirm `openstatspec capabilities` reflects the intended support boundary.
 6. Confirm the release tag matches the package version and that CI, release
-   fixtures, and capabilities use untagged specification `main` commit
-   `e94ae8349d2b0dffe0c65e820b4b22b8c074b7b5` with a null release value.
+   fixtures, and capabilities use OpenStatSpec specification release `v0.1.0`
+   at exact commit `d287c2cde9ade71f04e27dd012caec876901aed5`.
 7. Review this document, the README, and CHANGELOG for accurate scope.
 
 The tag-triggered release workflow repeats the non-service test suite, builds

docs/sav-profile.md

@@ -21,9 +21,11 @@ points are PostgreSQL 17.x/18.x at 17.10/18.4, MySQL 8.4.x/9.7.x at
 11.4.12/11.8.8/12.3.2. CI compares each live normalized server version with
 that exact evidence point.
 
-Dolt is an independent core profile pinned to exact server version 2.2.2 and
-detected over `mysql+pymysql` by active server identity; other Dolt versions
-and unknown MySQL-wire products fail closed. The core Dolt profile does not
+Dolt is an independent core profile for canonical stable versions in
+`>=2.2.2,<2.3.0`, detected over `mysql+pymysql` by active server identity and
+service-tested at exact versions 2.2.2 and 2.2.3. Earlier patches, other
+families, noncanonical versions, and unknown MySQL-wire products fail closed.
+The core Dolt profile does not
 claim support for the separate Transformation Workflow. An import that exceeds
 a target's strict single-table column or row envelope fails before it creates a
 dataset.

src/openstatspec/api.py

@@ -37,7 +37,7 @@ def capability_matrix(database_url: str | None = None) -> Mapping[str, Any]:
     """
     declaration = {
         "specification": "OpenStatSpec",
-        "specification_status": "release_candidate",
+        "specification_status": "released",
         "specification_release": SPECIFICATION_RELEASE,
         "specification_commit": SPECIFICATION_COMMIT,
         "profile": "SPSS SAV/ZSAV 1.0",

src/openstatspec/sql/capabilities.py

@@ -15,8 +15,10 @@
 from .profiles import profile_for_url, validate_connection_url
 from ..core import UnsupportedOperationError
 
-SPECIFICATION_COMMIT = "e94ae8349d2b0dffe0c65e820b4b22b8c074b7b5"
-SPECIFICATION_RELEASE: str | None = None
+SPECIFICATION_COMMIT = "d287c2cde9ade71f04e27dd012caec876901aed5"
+SPECIFICATION_RELEASE: str | None = "v0.1.0"
+
+_DOLT_2_2_STABLE_VERSION = re.compile(r"2\.2\.(0|[1-9][0-9]*)")
 
 SERVER_POLICIES = {
     "sqlite": {
@@ -28,8 +30,13 @@
         "ci": ["MySQL 8.4.11", "MySQL 9.7.2"],
     },
     "dolt": {
-        "claimed": ["Dolt 2.2.2"],
-        "ci": ["Dolt 2.2.2"],
+        "claimed": ["Dolt 2.2.x"],
+        "range": {
+            "minimum_inclusive": "2.2.2",
+            "maximum_exclusive": "2.3.0",
+        },
+        "ci": ["Dolt 2.2.2", "Dolt 2.2.3"],
+        "exact_ci": ["2.2.2", "2.2.3"],
     },
     "mariadb": {
         "claimed": ["MariaDB 11.4.x", "MariaDB 11.8.x", "MariaDB 12.3.x"],
@@ -115,9 +122,10 @@ def active_connection(database_url: str) -> dict[str, Any]:
                 raw_product_version = _required_text_probe(
                     connection, "select DOLT_VERSION()", "DOLT_VERSION()",
                 )
-                if raw_product_version.strip() != "2.2.2":
+                if not _dolt_version_supported(raw_product_version):
                     raise UnsupportedOperationError(
-                        "The active Dolt product version must be exactly 2.2.2."
+                        "The active Dolt product version must be a canonical stable "
+                        "release in the supported range >=2.2.2,<2.3.0."
                     )
                 identity_source = "SELECT @@version, @@version_comment, DOLT_VERSION()"
             elif "mariadb" in identity_text:
@@ -153,7 +161,11 @@ def active_connection(database_url: str) -> dict[str, Any]:
         "profile": profile_name,
         "engine": profile_name,
         "product": profile_name,
-        "transport": "mysql" if dialect in {"mysql", "mariadb"} else dialect,
+        "transport": (
+            "mysql_compatible" if profile_name == "dolt"
+            else "mysql" if dialect in {"mysql", "mariadb"}
+            else dialect
+        ),
         "driver": engine.dialect.driver,
         "server_version": _normalized_version(profile_name, raw_product_version),
         "raw_server_version": raw_product_version,
@@ -325,13 +337,18 @@ def _profile(
         "profile": name,
         "engine": name,
         "dialect": "mysql" if name == "dolt" else name,
-        "transport": "mysql" if name == "dolt" else name,
+        "transport": "mysql_compatible" if name == "dolt" else name,
         "specification_commit": SPECIFICATION_COMMIT,
-        "specification_status": "release_candidate",
+        "specification_status": "released",
         "specification_release": SPECIFICATION_RELEASE,
         "driver": "psycopg" if name == "postgresql" else "PyMySQL" if name in {"mysql", "mariadb", "dolt"} else "sqlite3",
         "claimed_server_versions": policy["claimed"],
+        "claimed_version_range": policy.get("range"),
         "ci_tested_server_versions": policy["ci"],
+        **(
+            {"exact_ci_tested_versions": policy["exact_ci"]}
+            if "exact_ci" in policy else {}
+        ),
         "theoretical_limits": theoretical,
         "proposed_adapter_limits": proposed,
         "observed_limits": observed_limits,
@@ -391,7 +408,7 @@ def _profile(
 
 def server_version_supported(profile: str, raw_version: str) -> bool:
     if profile == "dolt":
-        return raw_version.strip() == "2.2.2"
+        return _dolt_version_supported(raw_version)
     version = _version_tuple(raw_version)
     if profile == "sqlite":
         return (3, 24) <= version[:2] < (4, 0)
@@ -404,6 +421,12 @@ def server_version_supported(profile: str, raw_version: str) -> bool:
     return version[:width] in allowed
 
 
+def _dolt_version_supported(raw_version: str) -> bool:
+    """Accept only canonical stable Dolt 2.2 patches at or above 2.2.2."""
+    match = _DOLT_2_2_STABLE_VERSION.fullmatch(raw_version.strip())
+    return match is not None and match.group(1) not in {"0", "1"}
+
+
 def _matched_claim(profile: str, raw_version: str) -> str | None:
     if not server_version_supported(profile, raw_version):
         return None

tests/test_cli.py

@@ -38,9 +38,9 @@ def test_cli_import_inspect_validate_and_export_emit_json(tmp_path, capsys) -> N
 
 def test_capability_matrix_is_public_and_cli_matches_engine_boundary(capsys) -> None:
     matrix = openstatspec.capability_matrix()
-    assert matrix["specification_status"] == "release_candidate"
-    assert matrix["specification_release"] is None
-    assert matrix["specification_commit"] == "e94ae8349d2b0dffe0c65e820b4b22b8c074b7b5"
+    assert matrix["specification_status"] == "released"
+    assert matrix["specification_release"] == "v0.1.0"
+    assert matrix["specification_commit"] == "d287c2cde9ade71f04e27dd012caec876901aed5"
     assert matrix["directions"] == ["import", "export", "semantic_round_trip"]
     assert matrix["active_connection"] is None
     assert matrix["engine"]["package"] == "openstatspec-pyspssio"