From 64aeee6c3e2d4ecf8843be64d139d6da2b8e6de7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bj=C3=B6rn=20Strausmann?= <bjoern@strausmann.net>
Date: Wed, 19 Aug 2026 10:43:23 +0200
Subject: [PATCH] ci: add OpenAPI drift-gate workflow (follow-up to #1342)
 (#1429)

---
 .github/workflows/openapi.yml | 54 +++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 .github/workflows/openapi.yml

diff --git a/.github/workflows/openapi.yml b/.github/workflows/openapi.yml
new file mode 100644
index 0000000..b9fa9ba
--- /dev/null
+++ b/.github/workflows/openapi.yml
@@ -0,0 +1,54 @@
+name: OpenAPI spec check
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'src/routes/**'
+      - 'src/hooks.server.ts'
+      - 'src/routes/+layout.server.ts'
+      - 'scripts/generate-openapi.ts'
+      - 'scripts/openapi/**'
+      - 'package.json'
+  pull_request:
+    paths:
+      - 'src/routes/**'
+      - 'src/hooks.server.ts'
+      - 'src/routes/+layout.server.ts'
+      - 'scripts/generate-openapi.ts'
+      - 'scripts/openapi/**'
+      - 'package.json'
+
+permissions:
+  contents: read
+
+jobs:
+  openapi-check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      - name: Install dependencies
+        run: npm install --no-audit --no-fund
+
+      # Hard gate: path-param consistency, query/status drift, orphan JSDoc,
+      # and spec validity (@redocly/cli lint) must all pass. Coverage stays a
+      # warning on purpose (see scripts/generate-openapi.ts) — un-annotated
+      # endpoints must not block the pipeline; they remain fully functional
+      # generic stubs.
+      - name: Generate + validate OpenAPI spec
+        run: npm run generate:openapi:check
+
+      - name: Upload generated spec (debug artifact)
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: openapi-spec
+          path: static/openapi.json
+          retention-days: 7