Fix type-checking rules to accept allOf, anyOf, and oneOf

[Gérald Barré (geraldbarre-workleap)]

Jira issue link: FENG-2021

Summary

• The Spectral type-checking rules (schema-object-must-have-a-type, items-must-have-a-type, schemas-properties-must-have-a-type, path-schema-properties-must-have-a-type) only accepted type or $ref as valid schema definitions
• Schemas using OpenAPI composition keywords (allOf, anyOf, oneOf) were incorrectly flagged as errors — for example, schemas using allOf for inheritance or oneOf for polymorphism (discriminator patterns)
• Added allOf, anyOf, and oneOf as accepted alternatives in all four type-checking rules

Test plan

• Ran spectral lint against a test spec containing allOf (inheritance) and oneOf (discriminator) patterns — no false positives
• Verify existing specs in downstream repos still pass linting

[Copilot]

Pull request overview

Updates the repository’s Spectral ruleset so OpenAPI schemas using composition keywords aren’t incorrectly flagged by the “must-have-a-type” lint rules.

Changes:

• Extend all four type-checking rules to treat allOf, anyOf, and oneOf as valid schema definitions (in addition to type and $ref).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.