add speccy openapi linting

.github/workflows/build.yml

@@ -13,8 +13,12 @@ jobs:
         java-version: '11.0.7'
         java-package: jdk
         architecture: x64
+
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '14'
 
-    - uses: actions/checkout@v1
+    - uses: actions/checkout@v2
 
     - name: Build app
       run: ./mvnw --batch-mode clean install jacoco:report jacoco:report-aggregate
@@ -30,6 +34,13 @@ jobs:
         ../mvnw --batch-mode org.openapitools:openapi-generator-maven-plugin:4.3.0:generate \
                 -Dopenapi.generator.maven.plugin.inputSpec=META-INF/quarkus-generated-openapi-doc.YAML
 
+    - name: Parse openapi doc
+      run: |
+        npm i -g speccy
+        # default values cannot be strings even though ours are
+        sed -E 's/"([0-9]+)"/\1/g' adoptopenjdk-api-v3-frontend/META-INF/quarkus-generated-openapi-doc.YAML > openapi.yml
+        speccy lint openapi.yml
+
     - name: Zip Javascript client
       run: zip -r javascript-client.zip adoptopenjdk-api-v3-frontend/target/generated-sources/openapi
 

speccy.yaml

@@ -0,0 +1,14 @@
+# Output a lot of information about what is happening (wont work if you have quiet on) 
+# Default stdout = 1 
+verbose: 2
+# Rules specific to the lint command 
+lint:
+  # rules files to load 
+  rules:
+  - strict
+  # rules to skip 
+  skip:
+  - info-contact
+  - operation-operationId
+  - short-summary
+  - tag-description