chore: Add custom linting

.gitignore

@@ -5,3 +5,4 @@ license
 kong-plugin-mocking
 
 *.out
+.local/*

.spectral.yaml

@@ -0,0 +1,40 @@
+extends:
+  - "spectral:oas"
+rules:
+  # ---------------------------------------------------------------------------
+  # Schema rules
+  # ---------------------------------------------------------------------------
+  info-version-semver:
+    severity: error
+    recommended: true
+    message: Specs should follow semantic versioning. {{value}} is not a valid version.
+    given: $.info.version
+    then:
+      function: pattern
+      functionOptions:
+        match: "^([0-9]+.[0-9]+.[0-9]+)$"
+​
+  # ---------------------------------------------------------------------------
+  # API Rules
+  # ---------------------------------------------------------------------------
+​
+  server-url-must-contain-version:
+    description: Global API version must be present in the path
+    severity: error
+    recommended: true
+    message: "Unversioned server URL detected: {{value}}"
+    given: "$.servers[*].url"
+    then:
+      function: pattern
+      functionOptions:
+        match: "\/v[1-9]+\/"
+​
+  paths-kebab-case:
+    description: Paths should be kebab-case.
+    message: "{{property}} should be kebab-case (lower-case and separated with hyphens)"
+    severity: warn
+    given: $.paths[*]~
+    then:
+      function: pattern
+      functionOptions:
+        match: "^(\/|[a-z0-9-.]+|{[a-zA-Z0-9_]+})+$"