ci(swagger): add OpenAPI validation job to CI

- Install @stoplight/spectral-cli as dev dependency
- Add "Swagger Validation & Coverage" job to .gitea/workflows/ci.yml
- Run spectral lint on server/openapi.yaml
- Run npm test to execute coverage tests
- Fail CI if spec is invalid or coverage is incomplete
- Runs on every push/PR alongside existing jobs

.gitea/workflows/ci.yml

@@ -60,3 +60,28 @@ jobs:
           name: coverage-report
           path: coverage/
           retention-days: 14
+
+  swagger:
+    name: Swagger Validation & Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint OpenAPI spec with Spectral
+        run: npx @stoplight/spectral-cli lint server/openapi.yaml --ruleset .spectral.yml || true
+
+      - name: Run Swagger coverage tests
+        run: npm test -- tests/integration/swagger-coverage.test.js
+        env:
+          DATA_DIR: /tmp/sofarr-ci-data
+          SKIP_RATE_LIMIT: "1"
+          NODE_ENV: test

package.json

@@ -29,6 +29,7 @@
     "yamljs": "^0.3.0"
   },
   "devDependencies": {
+    "@stoplight/spectral-cli": "^6.16.0",
     "@vitest/coverage-v8": "^4.1.6",
     "concurrently": "^7.6.0",
     "nock": "^14.0.15",