toolframe-sql-postgres 0.2.0__tar.gz → 0.2.2__tar.gz

toolframe_sql_postgres-0.2.2/.github/workflows/compatibility.yml

@@ -0,0 +1,85 @@
+name: SDK compatibility
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  schedule:
+    - cron: '17 4 * * *'
+  workflow_dispatch:
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  wheel:
+    name: Build the shared plugin wheel
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: '3.14.7'
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          version: '0.12.8'
+          enable-cache: false
+      - run: uv build --no-sources --wheel --out-dir build/compatibility-wheel
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: compatibility-wheel
+          path: build/compatibility-wheel/*.whl
+          if-no-files-found: error
+          retention-days: 7
+
+  compatibility:
+    name: SDK ${{ matrix.sdk }}
+    needs: wheel
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    strategy:
+      fail-fast: false
+      matrix:
+        sdk: [minimum, latest]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: '3.14.7'
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          version: '0.12.8'
+          enable-cache: false
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: compatibility-wheel
+          path: build/compatibility-wheel
+      - name: Select the unchanged wheel
+        id: wheels
+        shell: bash
+        run: |
+          plugin=(build/compatibility-wheel/toolframe_sql_postgres-*.whl)
+          test "${#plugin[@]}" = 1
+          echo "plugin=${plugin[0]}" >> "$GITHUB_OUTPUT"
+      - name: Verify installed wheel and package tests
+        uses: toolframe/toolframe-sdk/.github/actions/plugin-compatibility@2e2a3d79f35fbdb04249e8351fe9c75fc2164269
+        with:
+          mode: ${{ matrix.sdk }}
+          wheel: ${{ steps.wheels.outputs.plugin }}
+          output: build/compatibility-${{ matrix.sdk }}
+      - name: Retain compatibility evidence
+        if: always()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: compatibility-${{ matrix.sdk }}
+          path: |
+            build/compatibility-${{ matrix.sdk }}/report.json
+            build/compatibility-${{ matrix.sdk }}/pytest.xml
+          if-no-files-found: warn
+          retention-days: 14

{toolframe_sql_postgres-0.2.0 → toolframe_sql_postgres-0.2.2}/.github/workflows/postgres.yml

@@ -31,7 +31,7 @@ jobs:
         with:
           repository: ${{ vars.TOOLFRAME_REPOSITORY_OWNER || github.repository_owner }}/toolframe-sdk
           token: ${{ secrets.TOOLFRAME_READ_TOKEN || github.token }}
-          ref: 2cd153ec36c585a9adb5ad566effc2985d9e222d
+          ref: 539ced4dbdf9e303ec0f0205a35d65287a480b2a
           path: toolframe-sdk
           persist-credentials: false
       - name: Check out toolframe-auth
@@ -39,7 +39,7 @@ jobs:
         with:
           repository: ${{ vars.TOOLFRAME_REPOSITORY_OWNER || github.repository_owner }}/toolframe-auth
           token: ${{ secrets.TOOLFRAME_READ_TOKEN || github.token }}
-          ref: f43c623cafb1483f3387935d7ef2690ca52088c9
+          ref: b7c26f0e0681ef4f707024e21219bbcf4533e8f8
           path: toolframe-auth
           persist-credentials: false
       - name: Check out toolframe-mcp-auth
@@ -47,7 +47,7 @@ jobs:
         with:
           repository: ${{ vars.TOOLFRAME_REPOSITORY_OWNER || github.repository_owner }}/toolframe-mcp-auth
           token: ${{ secrets.TOOLFRAME_READ_TOKEN || github.token }}
-          ref: 37b53ac0b37637c953cf5e40e59b5dcde8ab2c4b
+          ref: 86866e270a71e418466ff1b26f471d88b281709a
           path: toolframe-mcp-auth
           persist-credentials: false
       - name: Check out toolframe-oidc-auth
@@ -55,7 +55,7 @@ jobs:
         with:
           repository: ${{ vars.TOOLFRAME_REPOSITORY_OWNER || github.repository_owner }}/toolframe-oidc-auth
           token: ${{ secrets.TOOLFRAME_READ_TOKEN || github.token }}
-          ref: 5d88289871c7e961216536ddde812510e319a7fe
+          ref: a5c26231283b4b54026c28e2285f4f2b2caa069a
           path: toolframe-oidc-auth
           persist-credentials: false
       - name: Check out toolframe-demo-entry-register
@@ -63,7 +63,7 @@ jobs:
         with:
           repository: ${{ vars.TOOLFRAME_REPOSITORY_OWNER || github.repository_owner }}/toolframe-demo-entry-register
           token: ${{ secrets.TOOLFRAME_READ_TOKEN || github.token }}
-          ref: 638e2163bd1f50f3715e05b418ac9095b4003513
+          ref: f031017529c96a3c29e63565c2ea0149771fab9c
           path: toolframe-demo-entry-register
           persist-credentials: false
       - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97

{toolframe_sql_postgres-0.2.0 → toolframe_sql_postgres-0.2.2}/.github/workflows/publish.yml

@@ -2,19 +2,12 @@ name: Publish Python distribution
 
 on:
   workflow_dispatch:
-    inputs:
-      index:
-        description: Package index; run against the matching vVERSION tag
-        type: choice
-        options: [testpypi, pypi]
-        default: testpypi
-        required: true
 
 permissions:
   contents: read
 
 concurrency:
-  group: publish-${{ inputs.index }}
+  group: publish-pypi
   cancel-in-progress: false
 
 jobs:
@@ -45,12 +38,15 @@ jobs:
     uses: ./.github/workflows/ci.yml
     secrets: inherit
 
+  compatibility:
+    uses: ./.github/workflows/compatibility.yml
+
   publish:
-    needs: [release-tag, validate]
+    needs: [release-tag, validate, compatibility]
     runs-on: ubuntu-24.04
     timeout-minutes: 10
     environment:
-      name: ${{ inputs.index }}
+      name: pypi
     permissions:
       contents: read
       id-token: write
@@ -62,4 +58,4 @@ jobs:
       - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
         with:
           packages-dir: dist/
-          repository-url: ${{ inputs.index == 'testpypi' && 'https://test.pypi.org/legacy/' || 'https://upload.pypi.org/legacy/' }}
+          repository-url: https://upload.pypi.org/legacy/

{toolframe_sql_postgres-0.2.0 → toolframe_sql_postgres-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: toolframe-sql-postgres
-Version: 0.2.0
+Version: 0.2.2
 Summary: Managed PostgreSQL stores for Toolframe plugins
 Project-URL: Homepage, https://github.com/toolframe/toolframe-sql-postgres
 Project-URL: Repository, https://github.com/toolframe/toolframe-sql-postgres
@@ -13,7 +13,7 @@ License-File: NOTICE
 Requires-Python: >=3.14
 Requires-Dist: pglast==8.4
 Requires-Dist: psycopg[binary]<4,>=3.3
-Requires-Dist: toolframe-sdk==0.4.0
+Requires-Dist: toolframe-sdk<1,>=0.4.0
 Description-Content-Type: text/markdown
 
 # Toolframe PostgreSQL storage
@@ -40,7 +40,7 @@ Install the host and provider CLI from PyPI:
 ```sh
 uv venv --python 3.14.7 .venv
 uv pip install --python .venv/bin/python \
-  toolframe-core==0.7.0 toolframe-sql-postgres==0.2.0
+  toolframe-core==0.7.0 toolframe-sql-postgres==0.2.2
 .venv/bin/toolframe-core --home ./app init
 ```
 
@@ -61,7 +61,7 @@ Add the provider to `app/toolframe.toml`:
 
 ```toml
 [plugins.sql-postgres]
-source = "pypi:toolframe-sql-postgres==0.2.0"
+source = "pypi:toolframe-sql-postgres==0.2.2"
 enabled = true
 
 [bindings]
@@ -102,3 +102,6 @@ For release validation and Trusted Publisher setup, see [releasing](docs/releasi
 Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
 
 For development hooks and contribution rules, see [Contributing](CONTRIBUTING.md).
+
+Plugin dependencies allow compatible SDK 0.x updates from the declared minimum.
+See the [SDK compatibility policy](https://github.com/toolframe/toolframe-sdk/blob/main/docs/compatibility.md) for API guarantees and minimum/latest verification.

{toolframe_sql_postgres-0.2.0 → toolframe_sql_postgres-0.2.2}/README.md

@@ -22,7 +22,7 @@ Install the host and provider CLI from PyPI:
 ```sh
 uv venv --python 3.14.7 .venv
 uv pip install --python .venv/bin/python \
-  toolframe-core==0.7.0 toolframe-sql-postgres==0.2.0
+  toolframe-core==0.7.0 toolframe-sql-postgres==0.2.2
 .venv/bin/toolframe-core --home ./app init
 ```
 
@@ -43,7 +43,7 @@ Add the provider to `app/toolframe.toml`:
 
 ```toml
 [plugins.sql-postgres]
-source = "pypi:toolframe-sql-postgres==0.2.0"
+source = "pypi:toolframe-sql-postgres==0.2.2"
 enabled = true
 
 [bindings]
@@ -84,3 +84,6 @@ For release validation and Trusted Publisher setup, see [releasing](docs/releasi
 Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
 
 For development hooks and contribution rules, see [Contributing](CONTRIBUTING.md).
+
+Plugin dependencies allow compatible SDK 0.x updates from the declared minimum.
+See the [SDK compatibility policy](https://github.com/toolframe/toolframe-sdk/blob/main/docs/compatibility.md) for API guarantees and minimum/latest verification.

{toolframe_sql_postgres-0.2.0 → toolframe_sql_postgres-0.2.2}/docs/releasing.md

@@ -19,13 +19,14 @@ metadata and licenses, runs Ruff and package tests against an installed wheel,
 and installs each distribution into a separate fresh consumer environment.
 Optional database/service integrations require their documented fixtures.
 
-Publish `toolframe-sdk==0.4.0` first. The coordinated order and native CLI channels are documented in
+Publish any newly required SDK version before the plugin. Compatible Core or SDK
+updates alone do not require a plugin release. The coordinated order and native CLI channels are documented in
 [Toolframe's release guide](https://github.com/toolframe/toolframe-core/blob/main/docs/releasing.md).
 
 ## Trusted Publishers
 
-Create GitHub environments named `testpypi` and `pypi`. On each corresponding
-package index, configure a normal or pending Trusted Publisher with these values:
+Create a GitHub environment named `pypi`. On PyPI, configure a normal or
+pending Trusted Publisher with these values:
 
 | Field | Value |
 | --- | --- |
@@ -33,7 +34,7 @@ package index, configure a normal or pending Trusted Publisher with these values
 | GitHub owner | `toolframe` |
 | GitHub repository | `toolframe-sql-postgres` |
 | Workflow filename | `publish.yml` |
-| Environment | `testpypi` or `pypi`, matching the index |
+| Environment | `pypi` |
 
 If publishing from another owner, use that actual owner in the publisher binding.
 Follow [PyPI's Trusted Publishing guide](https://docs.pypi.org/trusted-publishers/using-a-publisher/).
@@ -49,7 +50,7 @@ sibling owner where the workflow exposes that variable.
 ## Publish and verify
 
 After the release commit and matching tag are available remotely, manually run
-`publish.yml` at `v0.1.0`, selecting `testpypi` first and then `pypi`.
+`publish.yml` at the matching `v<project.version>` tag to publish to PyPI.
 A branch or mismatched tag is rejected. Downloaded files are the artifacts from
 that run; the publishing job does not rebuild them. Published files cannot be
 replaced under the same version.
@@ -58,11 +59,11 @@ After PyPI publication, verify a clean installation:
 
 ```sh
 uv venv --python 3.14.7 build/consumer
-uv pip install --python build/consumer/bin/python 'toolframe-sql-postgres==0.2.0'
+uv pip install --python build/consumer/bin/python 'toolframe-sql-postgres==0.2.2'
 uv pip check --python build/consumer/bin/python
 ```
 
-TestPyPI does not mirror dependencies. Test the specific artifact against an
-explicit dependency source; a local or TestPyPI check alone does not demonstrate
-that production PyPI resolution works. Keep logs, hashes and exact revisions in
-CI artifacts or ignored local evidence directories.
+Test the specific artifact with dependencies from PyPI. Local artifact checks
+alone do not demonstrate that the published package resolves correctly from
+PyPI. Keep logs, hashes and exact revisions in CI artifacts or ignored local
+evidence directories.

{toolframe_sql_postgres-0.2.0 → toolframe_sql_postgres-0.2.2}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "toolframe-sql-postgres"
-version = "0.2.0"
+version = "0.2.2"
 description = "Managed PostgreSQL stores for Toolframe plugins"
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE", "NOTICE"]
 authors = [{ name = "byfb", email = "62798989+byfb@users.noreply.github.com" }]
 requires-python = ">=3.14"
-dependencies = ["toolframe-sdk==0.4.0", "psycopg[binary]>=3.3,<4", "pglast==8.4"]
+dependencies = ["toolframe-sdk>=0.4.0,<1", "psycopg[binary]>=3.3,<4", "pglast==8.4"]
 
 [project.urls]
 Homepage = "https://github.com/toolframe/toolframe-sql-postgres"
@@ -27,7 +27,7 @@ toolframe-postgres = "toolframe_sql_postgres.cli:main"
 
 [dependency-groups]
 dev = ["pytest>=8,<10", "pytest-asyncio>=1,<2", "ruff>=0.12,<1"]
-compatibility = ["toolframe-auth==0.3.0", "toolframe-mcp-auth==0.3.0", "toolframe-oidc-auth==0.3.0", "toolframe-demo-entry-register==0.4.0"]
+compatibility = ["toolframe-auth==0.3.1", "toolframe-mcp-auth==0.3.1", "toolframe-oidc-auth==0.3.1", "toolframe-demo-entry-register==0.4.1"]
 
 [tool.uv.sources]
 toolframe-sdk = { path = "../toolframe-sdk", editable = true }

{toolframe_sql_postgres-0.2.0 → toolframe_sql_postgres-0.2.2}/uv.lock

@@ -605,7 +605,7 @@ wheels = [
 
 [[package]]
 name = "toolframe-auth"
-version = "0.3.0"
+version = "0.3.1"
 source = { editable = "../toolframe-auth" }
 dependencies = [
     { name = "toolframe-sdk" },
@@ -624,7 +624,7 @@ dev = [
 
 [[package]]
 name = "toolframe-demo-entry-register"
-version = "0.4.0"
+version = "0.4.1"
 source = { editable = "../toolframe-demo-entry-register" }
 dependencies = [
     { name = "toolframe-sdk" },
@@ -647,7 +647,7 @@ dev = [
 
 [[package]]
 name = "toolframe-mcp-auth"
-version = "0.3.0"
+version = "0.3.1"
 source = { editable = "../toolframe-mcp-auth" }
 dependencies = [
     { name = "toolframe-sdk" },
@@ -666,7 +666,7 @@ dev = [
 
 [[package]]
 name = "toolframe-oidc-auth"
-version = "0.3.0"
+version = "0.3.1"
 source = { editable = "../toolframe-oidc-auth" }
 dependencies = [
     { name = "authlib" },
@@ -697,7 +697,7 @@ integration = [{ name = "fastmcp", specifier = ">=4,<5" }]
 
 [[package]]
 name = "toolframe-sdk"
-version = "0.4.0"
+version = "0.4.1"
 source = { editable = "../toolframe-sdk" }
 dependencies = [
     { name = "jsonschema" },
@@ -720,11 +720,12 @@ dev = [
     { name = "pytest", specifier = ">=8,<10" },
     { name = "pytest-asyncio", specifier = ">=1,<2" },
     { name = "ruff", specifier = ">=0.12,<1" },
+    { name = "tomlkit", specifier = ">=0.13,<1" },
 ]
 
 [[package]]
 name = "toolframe-sql-postgres"
-version = "0.2.0"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "pglast" },