feat(ibm-operation-responses): introduce new validation rule

padamstx commented 11 months ago

PR summary

This commit introduces the 'ibm-operation-responses' rule which verifies that each operation has a "responses" field. This rule is used only for openapi 3.1.x documents because this check is included in the Spectral oas3-schema rule for openapi 3.0.x documents.

Edit: I was able to take a shortcut with this rule because it truly only needs to check the existence of the "responses" field for each operation. The 'ibm-response-status-codes' rule will verify that the "responses" field contains at least one successful response code.

PR Checklist

General checklist

Please make sure that your PR fulfills the following requirements:

[x] The commit message follows the Angular Commit Message Guidelines.
[x] Tests for the changes have been added (for bug fixes / features)
[x] Docs have been added / updated (for bug fixes / features)
[ ] Dependencies have been updated as needed
[ ] .secrets.baseline updated as needed?

Checklist for adding a new validation rule:

[ ] Added new validation rule definition (packages/ruleset/src/rules/*.js, index.js)
[ ] If necessary, added new validation rule implementation (packages/ruleset/src/functions/*.js, updated index.js)
[ ] Added new rule to default configuration (packages/ruleset/src/ibm-oas.js)
[ ] Added tests for new rule (packages/ruleset/test/*.test.js)
[ ] Added docs for new rule (docs/ibm-cloud-rules.md)