fix: add missing StructuredQueriesCore symbolic link

Add missing symbolic link directory that was present in upstream but
removed during PostgreSQL fork reorganization.

Changes:
- Create Sources/StructuredQueriesCore/Symbolic Links/ directory
- Add symlink to StructuredQueriesPostgresSupport
- Add README.md explaining the workaround

This ensures StructuredQueriesCore can access shared Support code
(Inflection.swift, Quoting.swift) as declared in Package.swift dependencies.

Note: This does NOT fix the Swift 6.2.1 debug build linker error with
CasePathsMacros. That remains a toolchain issue. Use release builds
(swift build -c release) or Xcode for development.

ci: improve CI configuration for multi-platform Swift 6.x support

Comprehensive CI improvements to ensure compatibility with Swift 6.0-6.2
on both macOS and Linux, matching production Vapor server requirements.

**Linux CI improvements:**
- Add Swift 6.2 to test matrix (alongside 6.0, 6.1)
- Switch to release mode builds (required due to Swift 6.x linker issues)
- Add better caching with Swift version-specific keys
- Add parallel test execution (--parallel flag)
- Add build/test timeouts (20 minutes)
- Improve environment logging (Swift version, uname)

**macOS CI improvements:**
- Test both Swift 6.1 (Xcode 16.2) and 6.2 (Xcode 26.0)
- Use macos-15 for 6.1, macos-26 for 6.2
- Better cache keys with Xcode version
- Add parallel test execution
- Add build/test timeouts
- Improved environment logging (xcodebuild, Swift, macOS versions)

**Why release mode:**
Swift 6.x has a known linker issue in debug mode with CasePathsMacros
and SwiftSyntax prebuilt binaries. Release mode builds work correctly
on all platforms and Swift versions.

**Test coverage:**
- macOS: Swift 6.1 (Xcode 16.2), 6.2 (Xcode 26.0)
- Linux: Swift 6.0, 6.1, 6.2
- Total: 5 platform/version combinations

This ensures the package works on Linux Vapor servers running Swift 6.1.

chore: fix symlink imports

WIP

WIP

Author: coenttb

.github/workflows/ci.yml

@@ -15,56 +15,82 @@ concurrency:
 
 jobs:
   macos:
-    name: macOS
-    runs-on: macos-26
+    name: macOS (Xcode ${{ matrix.xcode }})
+    runs-on: macos-${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        xcode: ['26.0']
-        config: ['release']  # Release mode for speed; debug adds time with minimal value
+        include:
+          - os: '15'
+            xcode: '16.2'
+            swift: '6.1'
+          - os: '26'
+            xcode: '26.0'
+            swift: '6.2'
     steps:
       - uses: actions/checkout@v5
 
       - name: Select Xcode ${{ matrix.xcode }}
-        run: sudo xcode-select -s /Applications/Xcode_${{ matrix.xcode }}.1.app
+        run: sudo xcode-select -s /Applications/Xcode_${{ matrix.xcode }}.app
 
-      - name: Print Swift version
-        run: swift --version
+      - name: Print environment
+        run: |
+          xcodebuild -version
+          swift --version
+          echo "macOS $(sw_vers -productVersion)"
 
       - name: Cache Swift packages
         uses: actions/cache@v4
         with:
           path: .build
-          key: ${{ runner.os }}-spm-${{ hashFiles('Package.resolved') }}
+          key: ${{ runner.os }}-xcode-${{ matrix.xcode }}-spm-${{ hashFiles('Package.resolved') }}
           restore-keys: |
+            ${{ runner.os }}-xcode-${{ matrix.xcode }}-spm-
             ${{ runner.os }}-spm-
 
-      - name: Build
-        run: swift build -c ${{ matrix.config }}
+      - name: Build (Release)
+        run: swift build -c release
+        timeout-minutes: 20
 
-      - name: Run tests
-        run: swift test -c ${{ matrix.config }}
+      - name: Run tests (Release)
+        run: swift test -c release --parallel
+        timeout-minutes: 20
 
   linux:
     name: Linux (Swift ${{ matrix.swift }})
+    runs-on: ubuntu-latest
+    container: swift:${{ matrix.swift }}
     strategy:
       fail-fast: false
       matrix:
         swift:
           - '6.0'
           - '6.1'
-    runs-on: ubuntu-latest
-    container: swift:${{ matrix.swift }}
+          - '6.2'
     steps:
       - uses: actions/checkout@v5
 
-      - name: Print Swift version
-        run: swift --version
+      - name: Print environment
+        run: |
+          swift --version
+          uname -a
+
+      - name: Cache Swift packages
+        uses: actions/cache@v4
+        with:
+          path: .build
+          key: linux-swift-${{ matrix.swift }}-spm-${{ hashFiles('Package.resolved') }}
+          restore-keys: |
+            linux-swift-${{ matrix.swift }}-spm-
+            linux-spm-
 
-      - name: Build
-        run: swift build
+      - name: Build (Release)
+        run: swift build -c release
+        timeout-minutes: 20
 
-      - name: Run tests
-        run: swift test
+      - name: Run tests (Release)
+        run: swift test -c release --parallel
+        timeout-minutes: 20
 
   documentation:
     name: Documentation

Package.swift

@@ -12,7 +12,7 @@ import PackageDescription
 let package = Package(
     name: "swift-structured-queries-postgres",
     platforms: [
-        //        .iOS(.v13),
+        .iOS(.v13),
         .macOS(.v13)
         //        .tvOS(.v13),
         //        .watchOS(.v6)
@@ -135,6 +135,14 @@ let package = Package(
                 .product(name: "InlineSnapshotTesting", package: "swift-snapshot-testing"),
             ]
         ),
+        .testTarget(
+            name: "READMEExamplesTests",
+            dependencies: [
+                "StructuredQueriesPostgres",
+                "StructuredQueriesPostgresTestSupport",
+                .product(name: "InlineSnapshotTesting", package: "swift-snapshot-testing"),
+            ]
+        ),
     ],
     swiftLanguageModes: [.v6]
 )