fix: Update CI to DuckDB v1.4.4 and use explicit extension version

- Update all CI artifact references from v1.4.3 to v1.4.4
- Add MSSQL_EXTENSION_VERSION in CMakeLists.txt for explicit version control
- mssql_version() now returns semantic version (e.g. "0.1.10") instead of git hash
- Document versioning workflow in CLAUDE.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: VGSML

.github/workflows/ci.yml

@@ -82,19 +82,19 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Fetch DuckDB v1.4.3
+      - name: Fetch DuckDB v1.4.4
         id: duckdb
         run: |
           chmod +x scripts/ci/fetch_duckdb.sh
-          DUCKDB_COMMIT=$(scripts/ci/fetch_duckdb.sh 1.4.3)
+          DUCKDB_COMMIT=$(scripts/ci/fetch_duckdb.sh 1.4.4)
           echo "commit=$DUCKDB_COMMIT" >> $GITHUB_OUTPUT
 
       - name: Log build metadata
         run: |
           echo "============================================"
           echo "Build Metadata"
           echo "============================================"
-          echo "DuckDB Version: v1.4.3"
+          echo "DuckDB Version: v1.4.4"
           echo "DuckDB Commit: ${{ steps.duckdb.outputs.commit }}"
           echo "Platform: ${{ matrix.platform.id }}"
           echo "Runner: ${{ matrix.platform.runner }}"
@@ -167,14 +167,14 @@ jobs:
       - name: Upload Extension Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: mssql-extension-v1.4.3-${{ matrix.platform.id }}
+          name: mssql-extension-v1.4.4-${{ matrix.platform.id }}
           path: build/release/extension/mssql/mssql.duckdb_extension
           if-no-files-found: error
 
       - name: Upload DuckDB CLI Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: duckdb-cli-v1.4.3-${{ matrix.platform.id }}
+          name: duckdb-cli-v1.4.4-${{ matrix.platform.id }}
           path: build/release/duckdb
           if-no-files-found: error
 
@@ -207,13 +207,13 @@ jobs:
       - name: Download extension artifact
         uses: actions/download-artifact@v4
         with:
-          name: mssql-extension-v1.4.3-${{ matrix.platform.id }}
+          name: mssql-extension-v1.4.4-${{ matrix.platform.id }}
           path: extension
 
       - name: Download DuckDB CLI artifact
         uses: actions/download-artifact@v4
         with:
-          name: duckdb-cli-v1.4.3-${{ matrix.platform.id }}
+          name: duckdb-cli-v1.4.4-${{ matrix.platform.id }}
           path: cli
 
       - name: Setup executables
@@ -264,13 +264,13 @@ jobs:
       - name: Download extension artifact
         uses: actions/download-artifact@v4
         with:
-          name: mssql-extension-v1.4.3-linux_amd64
+          name: mssql-extension-v1.4.4-linux_amd64
           path: extension
 
       - name: Download DuckDB CLI artifact
         uses: actions/download-artifact@v4
         with:
-          name: duckdb-cli-v1.4.3-linux_amd64
+          name: duckdb-cli-v1.4.4-linux_amd64
           path: cli
 
       - name: Setup executables
@@ -301,12 +301,12 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Fetch DuckDB v1.4.3
+      - name: Fetch DuckDB v1.4.4
         id: duckdb
         shell: bash
         run: |
           chmod +x scripts/ci/fetch_duckdb.sh
-          DUCKDB_COMMIT=$(scripts/ci/fetch_duckdb.sh 1.4.3)
+          DUCKDB_COMMIT=$(scripts/ci/fetch_duckdb.sh 1.4.4)
           echo "commit=$DUCKDB_COMMIT" >> $GITHUB_OUTPUT
 
       - name: Log build metadata
@@ -315,7 +315,7 @@ jobs:
           echo "============================================"
           echo "Build Metadata"
           echo "============================================"
-          echo "DuckDB Version: v1.4.3"
+          echo "DuckDB Version: v1.4.4"
           echo "DuckDB Commit: ${{ steps.duckdb.outputs.commit }}"
           echo "Platform: windows_amd64 (MSVC)"
           echo "vcpkg Triplet: x64-windows-static-release"
@@ -361,14 +361,14 @@ jobs:
       - name: Upload Extension Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: mssql-extension-v1.4.3-windows_amd64_msvc
+          name: mssql-extension-v1.4.4-windows_amd64_msvc
           path: build/release/extension/mssql/mssql.duckdb_extension
           if-no-files-found: error
 
       - name: Upload DuckDB CLI Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: duckdb-cli-v1.4.3-windows_amd64_msvc
+          name: duckdb-cli-v1.4.4-windows_amd64_msvc
           path: build/release/duckdb.exe
           if-no-files-found: error
 
@@ -388,12 +388,12 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Fetch DuckDB v1.4.3
+      - name: Fetch DuckDB v1.4.4
         id: duckdb
         shell: bash
         run: |
           chmod +x scripts/ci/fetch_duckdb.sh
-          DUCKDB_COMMIT=$(scripts/ci/fetch_duckdb.sh 1.4.3)
+          DUCKDB_COMMIT=$(scripts/ci/fetch_duckdb.sh 1.4.4)
           echo "commit=$DUCKDB_COMMIT" >> $GITHUB_OUTPUT
 
       - name: Log build metadata
@@ -402,7 +402,7 @@ jobs:
           echo "============================================"
           echo "Build Metadata"
           echo "============================================"
-          echo "DuckDB Version: v1.4.3"
+          echo "DuckDB Version: v1.4.4"
           echo "DuckDB Commit: ${{ steps.duckdb.outputs.commit }}"
           echo "Platform: windows_amd64 (MinGW)"
           echo "vcpkg Triplet: x64-mingw-static"
@@ -459,14 +459,14 @@ jobs:
       - name: Upload Extension Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: mssql-extension-v1.4.3-windows_amd64_mingw
+          name: mssql-extension-v1.4.4-windows_amd64_mingw
           path: build/release/extension/mssql/mssql.duckdb_extension
           if-no-files-found: error
 
       - name: Upload DuckDB CLI Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: duckdb-cli-v1.4.3-windows_amd64_mingw
+          name: duckdb-cli-v1.4.4-windows_amd64_mingw
           path: build/release/duckdb.exe
           if-no-files-found: error
 
@@ -494,13 +494,13 @@ jobs:
       - name: Download extension artifact
         uses: actions/download-artifact@v4
         with:
-          name: mssql-extension-v1.4.3-${{ matrix.config.artifact_suffix }}
+          name: mssql-extension-v1.4.4-${{ matrix.config.artifact_suffix }}
           path: extension
 
       - name: Download DuckDB CLI artifact
         uses: actions/download-artifact@v4
         with:
-          name: duckdb-cli-v1.4.3-${{ matrix.config.artifact_suffix }}
+          name: duckdb-cli-v1.4.4-${{ matrix.config.artifact_suffix }}
           path: cli
 
       - name: Run load-only smoke test

CLAUDE.md

@@ -41,6 +41,12 @@ docs/                   # Architecture documentation (see docs/architecture.md)
 docker/                 # SQL Server container and Linux CI build
 ```
 
+## Versioning
+
+- The extension version is defined in `CMakeLists.txt` as `MSSQL_EXTENSION_VERSION` (e.g., `set(MSSQL_EXTENSION_VERSION "0.1.10")`)
+- This is passed to C++ code via the `MSSQL_VERSION` compile definition and returned by `mssql_version()`
+- **When releasing a new version**: update `MSSQL_EXTENSION_VERSION` in `CMakeLists.txt` and `version` in `vcpkg.json`
+
 ## Commands
 
 ```bash

CMakeLists.txt

@@ -5,6 +5,9 @@ set(TARGET_NAME mssql)
 set(EXTENSION_NAME ${TARGET_NAME}_extension)
 set(LOADABLE_EXTENSION_NAME ${TARGET_NAME}_loadable_extension)
 
+# Extension version - update this when creating a new release tag
+set(MSSQL_EXTENSION_VERSION "0.1.10")
+
 # Project configuration
 project(${TARGET_NAME})
 
@@ -149,26 +152,26 @@ build_loadable_extension(${TARGET_NAME} " " ${EXTENSION_SOURCES})
 # =============================================================================
 # Static Extension Configuration
 # =============================================================================
-# Note: EXT_VERSION_MSSQL is automatically defined by DuckDB's build system
-# via duckdb_extension_generate_version() - do not define it again here.
 target_include_directories(${EXTENSION_NAME} PRIVATE
     ${CMAKE_CURRENT_SOURCE_DIR}/src/include/tds/tls
     ${OPENSSL_INCLUDE_DIR}
 )
 target_link_libraries(${EXTENSION_NAME} OpenSSL::SSL OpenSSL::Crypto)
+# Extension version (overrides DuckDB's git-hash-based EXT_VERSION_MSSQL)
+target_compile_definitions(${EXTENSION_NAME} PRIVATE MSSQL_VERSION="${MSSQL_EXTENSION_VERSION}")
 
 message(STATUS "Static extension configured with full TLS support (OpenSSL)")
 
 # =============================================================================
 # Loadable Extension Configuration
 # =============================================================================
-# Note: EXT_VERSION_MSSQL is automatically defined by DuckDB's build system
-# via duckdb_extension_generate_version() - do not define it again here.
 target_include_directories(${LOADABLE_EXTENSION_NAME} PRIVATE
     ${CMAKE_CURRENT_SOURCE_DIR}/src/include/tds/tls
     ${OPENSSL_INCLUDE_DIR}
 )
 target_link_libraries(${LOADABLE_EXTENSION_NAME} OpenSSL::SSL OpenSSL::Crypto)
+# Extension version (overrides DuckDB's git-hash-based EXT_VERSION_MSSQL)
+target_compile_definitions(${LOADABLE_EXTENSION_NAME} PRIVATE MSSQL_VERSION="${MSSQL_EXTENSION_VERSION}")
 
 # Symbol export control - hide all symbols except extension entry point
 if(APPLE)

src/mssql_extension.cpp

@@ -14,8 +14,8 @@ namespace duckdb {
 
 // Extension version string
 static const char *GetMssqlExtensionVersion() {
-#ifdef EXT_VERSION_MSSQL
-	return EXT_VERSION_MSSQL;
+#ifdef MSSQL_VERSION
+	return MSSQL_VERSION;
 #else
 	return "unknown";
 #endif