fix: update rules and ref to doc

catalyst-gateway/.spectral.yml

@@ -1,7 +1,7 @@
 # References to the rules 
 # OpenAPI: https://docs.stoplight.io/docs/spectral/4dec24461f3af-open-api-rules#openapi-rules
-# OWASP Top 10: https://apistylebook.stoplight.io/docs/owasp-top-10
-# Documentations: https://github.com/stoplightio/spectral-documentation/blob/main/src/ruleset.ts
+# OWASP Top 10: https://github.com/stoplightio/spectral-owasp-ruleset/blob/v1.4.3/src/ruleset.ts
+# Documentations: https://github.com/stoplightio/spectral-documentation/blob/v1.3.1/src/ruleset.ts
 
 # cspell: words OWASP owasp
 
@@ -10,3 +10,32 @@ extends:
 - 'spectral:oas'
 - 'https://unpkg.com/@stoplight/[email protected]/dist/ruleset.mjs'
 - 'https://unpkg.com/@stoplight/[email protected]/dist/ruleset.mjs'
+
+aliases:
+  PathItem:
+  - $.paths[*]
+  OperationObject:
+  - $.paths[*][get,put,post,delete,options,head,patch,trace]
+  DescribableObjects:
+  - $.info
+  - $.tags[*]
+  - '#OperationObject'
+  - '#OperationObject.responses[*]'
+  - '#PathItem.parameters[?(@ && @.in)]'
+  - '#OperationObject.parameters[?(@ && @.in)]'
+
+overrides:
+- files: ['*']
+  rules:
+    # Override documnent description rule
+    # - No limitations on the characters that can start or end a sentence.
+    # - Length should be >= 20 characters
+    docs-description:
+      given: '#DescribableObjects'
+      then:
+      - field: 'description'
+        function: 'truthy'
+      - field: 'description'
+        function: 'length'
+        functionOptions:
+          min: 20