SD-1667 Add Spectral ruleset validation

[jkosternl]

• Example on booking, to validate if it works

[HenrikHL]

@jkosternl are you still working on this?

[jkosternl]

@jkosternl are you still working on this?

Yes, hence no reviewers 😉

[qodo-code-review]

CI Feedback 🧐

A test triggered by this PR failed. Here is an AI-generated analysis of the failure:

Action: Run Spectral validation

Failed stage: Run stoplightio/spectral-action@latest [❌]

Failure summary: The Spectral linting step failed because it could not load the referenced ruleset. While the action was configured with spectral_ruleset: .stoplight/styleguide.json, Spectral attempted to load /github/workspace/.stoplight/.spectral.js and errored: - "Could not load /github/workspace/.stoplight/.spectral.js ruleset" - "Issue loading ruleset" This indicates a misconfiguration or missing ruleset file in .stoplight (e.g., expecting .spectral.js but only styleguide.json exists, or an invalid/incorrect path). Ensure the ruleset path matches an existing, valid Spectral ruleset file.

Relevant error logs: 1: ##[group]Runner Image Provisioner 2: Hosted Compute Agent ... 167: #9 DONE 18.7s 168: #13 [dependencies 2/5] COPY package.json yarn.lock ./ 169: #13 DONE 0.0s 170: #14 [builder 3/7] RUN yarn 171: #14 0.476 yarn install v1.22.22 172: #14 0.597 [1/5] Validating package.json... 173: #14 0.601 [2/5] Resolving packages... 174: #14 0.878 [3/5] Fetching packages... 175: #14 ... 176: #15 [nodeprune 2/2] RUN go install github.com/tj/node-prune@latest 177: #15 0.506 go: downloading github.com/tj/node-prune v1.2.0 178: #15 1.624 go: downloading github.com/apex/log v1.1.1 179: #15 1.625 go: downloading github.com/dustin/go-humanize v1.0.0 180: #15 1.680 go: downloading github.com/mattn/go-colorable v0.1.2 181: #15 1.680 go: downloading github.com/fatih/color v1.7.0 182: #15 1.682 go: downloading github.com/pkg/errors v0.8.1 183: #15 1.710 go: downloading github.com/mattn/go-isatty v0.0.8 ... 324: HEAD is now at a19ddc7 Merge ce3475b2c2e304be86fa6612fb3f8b9b8584d82e into 8e6aed40305011223d728116e1de1bd32eaaa434 325: ##[endgroup] 326: [command]/usr/bin/git log -1 --format=%H 327: a19ddc7c969091927ae73159635e8b8115efd302 328: ##[group]Run stoplightio/spectral-action@latest 329: with: 330: file_glob: bkg/v1/bkg.yaml 331: spectral_ruleset: .stoplight/styleguide.json 332: repo_token: *** 333: event_name: pull_request 334: ##[endgroup] 335: ##[command]/usr/bin/docker run --name a4e52be218041318e4ebd8c1040228b9f975a_d51aba --label 7a4e52 --workdir /github/workspace --rm -e "INPUT_FILE_GLOB" -e "INPUT_SPECTRAL_RULESET" -e "INPUT_REPO_TOKEN" -e "INPUT_EVENT_NAME" -e "HOME" -e "GITHUB_JOB" -e "GITHUB_REF" -e "GITHUB_SHA" -e "GITHUB_REPOSITORY" -e "GITHUB_REPOSITORY_OWNER" -e "GITHUB_REPOSITORY_OWNER_ID" -e "GITHUB_RUN_ID" -e "GITHUB_RUN_NUMBER" -e "GITHUB_RETENTION_DAYS" -e "GITHUB_RUN_ATTEMPT" -e "GITHUB_ACTOR_ID" -e "GITHUB_ACTOR" -e "GITHUB_WORKFLOW" -e "GITHUB_HEAD_REF" -e "GITHUB_BASE_REF" -e "GITHUB_EVENT_NAME" -e "GITHUB_SERVER_URL" -e "GITHUB_API_URL" -e "GITHUB_GRAPHQL_URL" -e "GITHUB_REF_NAME" -e "GITHUB_REF_PROTECTED" -e "GITHUB_REF_TYPE" -e "GITHUB_WORKFLOW_REF" -e "GITHUB_WORKFLOW_SHA" -e "GITHUB_REPOSITORY_ID" -e "GITHUB_TRIGGERING_ACTOR" -e "GITHUB_WORKSPACE" -e "GITHUB_ACTION" -e "GITHUB_EVENT_PATH" -e "GITHUB_ACTION_REPOSITORY" -e "GITHUB_ACTION_REF" -e "GITHUB_PATH" -e "GITHUB_ENV" -e "GITHUB_STEP_SUMMARY" -e "GITHUB_STATE" -e "GITHUB_OUTPUT" -e "RUNNER_OS" -e "RUNNER_ARCH" -e "RUNNER_NAME" -e "RUNNER_ENVIRONMENT" -e "RUNNER_TOOL_CACHE" -e "RUNNER_TEMP" -e "RUNNER_WORKSPACE" -e "ACTIONS_RUNTIME_URL" -e "ACTIONS_RUNTIME_TOKEN" -e "ACTIONS_CACHE_URL" -e "ACTIONS_RESULTS_URL" -e GITHUB_ACTIONS=true -e CI=true -v "/var/run/docker.sock":"/var/run/docker.sock" -v "/home/runner/work/_temp/_github_home":"/github/home" -v "/home/runner/work/_temp/_github_workflow":"/github/workflow" -v "/home/runner/work/_temp/_runner_file_commands":"/github/file_commands" -v "/home/runner/work/DCSA-OpenAPI/DCSA-OpenAPI":"/github/workspace" 7a4e52:be218041318e4ebd8c1040228b9f975a 336: Using glob 'bkg/v1/bkg.yaml' under '/github/workspace', found file to lint 337: Running @stoplight/spectral-core v1.20.0 338: Loading ruleset '/github/workspace/.stoplight/styleguide.json'... 339: ##[error]Could not load /github/workspace/.stoplight/.spectral.js ruleset 340: ##[error]Issue loading ruleset 341: Post job cleanup.