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 Provisioner2: Hosted Compute Agent ... 167: #9 DONE 18.7s168: #13 [dependencies 2/5] COPY package.json yarn.lock ./169: #13 DONE 0.0s170: #14 [builder 3/7] RUN yarn171: #14 0.476 yarn install v1.22.22172: #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@latest177: #15 0.506 go: downloading github.com/tj/node-prune v1.2.0178: #15 1.624 go: downloading github.com/apex/log v1.1.1179: #15 1.625 go: downloading github.com/dustin/go-humanize v1.0.0180: #15 1.680 go: downloading github.com/mattn/go-colorable v0.1.2181: #15 1.680 go: downloading github.com/fatih/color v1.7.0182: #15 1.682 go: downloading github.com/pkg/errors v0.8.1183: #15 1.710 go: downloading github.com/mattn/go-isatty v0.0.8 ... 324: HEAD is now at a19ddc7 Merge ce3475b2c2e304be86fa6612fb3f8b9b8584d82e into 8e6aed40305011223d728116e1de1bd32eaaa434325: ##[endgroup]326: [command]/usr/bin/git log -1 --format=%H327: a19ddc7c969091927ae73159635e8b8115efd302328: ##[group]Run stoplightio/spectral-action@latest329: with:330: file_glob: bkg/v1/bkg.yaml331: spectral_ruleset: .stoplight/styleguide.json332: repo_token: ***333: event_name: pull_request334: ##[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 lint337: Running @stoplight/spectral-core v1.20.0338: Loading ruleset '/github/workspace/.stoplight/styleguide.json'...339: ##[error]Could not load /github/workspace/.stoplight/.spectral.js ruleset340: ##[error]Issue loading ruleset341: Post job cleanup.