feat(validation): check x-correlator documentation

[LarryHu0217]

What type of PR is this?

enhancement/feature

What this PR does / why we need it:

Adds two warning-level Spectral rules that require every regular and callback operation to document the x-correlator request header parameter and every documented response to expose the corresponding response header. The custom function honors path-level parameters and Spectral-resolved local or external references.

Which issue(s) this PR fixes:

Fixes #371

Special notes for reviewers:

The focused regression coverage includes inline definitions, path-level inheritance, local component references, external references, success and error responses, and callbacks.

Test evidence:

• python -m pytest validation/tests tooling_lib/tests -q (1214 passed, 4 skipped)
• node --check linting/config/lint_function/*.js
• npm ci --ignore-scripts using the repository-required npm 11.13.0

Changelog input

release-note
Add warning-level validation for x-correlator request parameter and response header documentation.

Additional documentation

docs

[hdamker]

(double post — see the identical review below)

[hdamker]

Thanks @LarryHu0217 — good implementation of #371. The external $ref resolution and the callback coverage match the proposal, and the regression tests are thorough. One small suggestion inline to keep the ruleset header changelog complete.

[hdamker]

LGTM (EasyCLA status clarified as well)

[Kevsy]

LGTM