Apply CI standard: optimize workflows

Author: coenttb

.github/workflows/ci.yml

@@ -1,87 +1,91 @@
 name: CI
+
 on:
   push:
-    branches: [main]
+    branches:
+      - main
   pull_request:
-    branches: [main]
+    branches:
+      - main
   workflow_dispatch:
 
 concurrency:
   group: ci-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
-  macos-swift59:
-    name: macOS (Swift 5.9)
+  # Primary development workflow: Latest Swift on macOS with debug build
+  macos-latest:
+    name: macOS (Swift 6.2, debug)
     runs-on: macos-26
-    strategy:
-      matrix:
-        xcode: ['26.0']
-        config: ['debug', 'release']
     steps:
       - uses: actions/checkout@v5
-      - name: Select Xcode ${{ matrix.xcode }}
-        run: sudo xcode-select -s /Applications/Xcode_${{ matrix.xcode }}.app
+
+      - name: Select Xcode 26.0
+        run: sudo xcode-select -s /Applications/Xcode_26.0.app
+
       - name: Print Swift version
         run: swift --version
+
       - name: Cache Swift packages
         uses: actions/cache@v4
         with:
           path: .build
-          key: ${{ runner.os }}-spm-${{ hashFiles('Package.resolved') }}
-          restore-keys: ${{ runner.os }}-spm-
-      - name: Build
-        run: swift build -c ${{ matrix.config }}
-      - name: Run tests
-        run: swift test -c ${{ matrix.config }}
+          key: ${{ runner.os }}-spm-${{ hashFiles('Package.swift') }}
+          restore-keys: |
+            ${{ runner.os }}-spm-
 
-  macos-swift62:
-    name: macOS (Swift 6.2)
-    runs-on: macos-26
-    strategy:
-      matrix:
-        xcode: ['26.0']
-        config: ['debug', 'release']
+      # Note: swift test builds automatically, no separate build step needed
+      - name: Test
+        run: swift test -c debug
+
+      - name: Validate Package.swift
+        run: swift package dump-package
+
+      - name: Run README verification tests
+        run: swift test --filter ReadmeVerificationTests
+
+      - name: Check for API breaking changes
+        run: |
+          swift package diagnose-api-breaking-changes \
+            --breakage-allowlist-path .swift-api-breakage-allowlist || true
+        continue-on-error: true
+
+  # Production validation: Latest Swift on Linux with release build
+  linux-latest:
+    name: Ubuntu (Swift 6.2, release)
+    runs-on: ubuntu-latest
+    container: swift:6.2
     steps:
       - uses: actions/checkout@v5
-      - name: Select Xcode ${{ matrix.xcode }}
-        run: sudo xcode-select -s /Applications/Xcode_${{ matrix.xcode }}.app
-      - name: Print Swift version
-        run: swift --version
+
       - name: Cache Swift packages
         uses: actions/cache@v4
         with:
           path: .build
-          key: ${{ runner.os }}-spm-${{ hashFiles('Package.resolved') }}
+          key: ${{ runner.os }}-spm-${{ hashFiles('Package.swift') }}
           restore-keys: ${{ runner.os }}-spm-
-      - name: Build
-        run: swift build -c ${{ matrix.config }}
-      - name: Run tests
-        run: swift test -c ${{ matrix.config }}
 
-  linux-swift62:
-    name: Ubuntu (Swift 6.2)
+      # Note: swift test builds automatically in release mode
+      - name: Test (release)
+        run: swift test -c release
+
+  # Compatibility check: Minimum supported Swift version (6.0)
+  # Note: Swift Testing framework requires Swift 6.0+
+  linux-compat:
+    name: Ubuntu (Swift 6.0, compatibility)
     runs-on: ubuntu-latest
-    container: swift:6.2
+    container: swift:6.0
     steps:
       - uses: actions/checkout@v5
+
       - name: Cache Swift packages
         uses: actions/cache@v4
         with:
           path: .build
-          key: ${{ runner.os }}-spm-${{ hashFiles('Package.resolved') }}
-          restore-keys: ${{ runner.os }}-spm-
-      - name: Build
-        run: swift build
-      - name: Run tests
-        run: swift test
+          key: ${{ runner.os }}-swift60-spm-${{ hashFiles('Package.swift') }}
+          restore-keys: ${{ runner.os }}-swift60-spm-
 
-  readme-validation:
-    name: README Code Examples
-    runs-on: macos-26
-    steps:
-      - uses: actions/checkout@v5
-      - name: Select Xcode
-        run: sudo xcode-select -s /Applications/Xcode_26.0.app
-      - name: Run README verification tests
-        run: swift test --filter ReadmeVerificationTests
+      # Note: swift test builds automatically
+      - name: Test (Swift 6.0)
+        run: swift test -c release

.github/workflows/swift-format.yml

@@ -18,16 +18,21 @@ jobs:
       contents: write
     steps:
       - uses: actions/checkout@v5
+        with:
+          ref: ${{ github.head_ref || github.ref_name }}
+
+      - name: Configure git safe directory
+        run: git config --global --add safe.directory /__w/swift-html-css-pointfree/swift-html-css-pointfree
 
-      - name: Cache swift-format
-        id: cache-swift-format
-        uses: actions/cache@v4
+      - name: Restore swift-format cache
+        id: cache-swift-format-restore
+        uses: actions/cache/restore@v4
         with:
           path: /usr/local/bin/swift-format
-          key: ${{ runner.os }}-swift-format-${{ hashFiles('.github/workflows/swift-format.yml') }}
+          key: ${{ runner.os }}-swift-format-main-v1
 
       - name: Install swift-format
-        if: steps.cache-swift-format.outputs.cache-hit != 'true'
+        if: steps.cache-swift-format-restore.outputs.cache-hit != 'true'
         run: |
           git clone --depth 1 --branch main https://github.com/apple/swift-format.git
           cd swift-format
@@ -37,9 +42,16 @@ jobs:
           rm -rf swift-format
 
       - name: Format
-        run: swift-format format --ignore-unparsable-files --recursive --in-place Sources Tests
+        run: swift-format format --recursive --in-place --ignore-unparsable-files Sources Tests
 
       - uses: stefanzweifel/git-auto-commit-action@v7
         with:
           commit_message: Run swift-format
           branch: 'main'
+
+      - name: Save swift-format cache
+        uses: actions/cache/save@v4
+        if: steps.cache-swift-format-restore.outputs.cache-hit != 'true'
+        with:
+          path: /usr/local/bin/swift-format
+          key: ${{ runner.os }}-swift-format-main-v1