feat(openapi): auto-generate spec from Drizzle schema with CI drift check

.github/workflows/ci.yml

@@ -28,6 +28,17 @@ jobs:
       - run: npm install
       - run: npm test
 
+  openapi:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm install
+      - run: npm run openapi:check
+
   build:
     runs-on: ubuntu-latest
     needs: [lint, test]

package.json

@@ -19,6 +19,8 @@
     "sync:pricing-nodes": "tsx scripts/sync-pricing-nodes.ts",
     "sync:substations": "tsx scripts/sync-substations.ts",
     "generate:changelog": "npx tsx scripts/generate-changelog.ts",
+    "openapi": "tsx scripts/generate-openapi.ts",
+    "openapi:check": "tsx scripts/generate-openapi.ts --check",
     "sync:all": "npx tsx scripts/sync-all.ts",
     "seed": "tsx scripts/seed-database.ts",
     "test:api": "tsx scripts/test-api-endpoints.ts"