Skip to content

Replace Spectral with Redocly for spec validation#2045

Merged
DerManoMann merged 5 commits into
zircote:masterfrom
DerManoMann:spec-validation
Jul 7, 2026
Merged

Replace Spectral with Redocly for spec validation#2045
DerManoMann merged 5 commits into
zircote:masterfrom
DerManoMann:spec-validation

Conversation

@DerManoMann

@DerManoMann DerManoMann commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Replace Spectral with Redocly CLI for OpenAPI spec validation (minimal ruleset with targeted overrides)
  • Add baseline ignore file for existing violations (309 issues)
  • Add spec-validation CI workflow
  • Document composer redocly in CONTRIBUTING.md

Test plan

  • Verify composer redocly runs cleanly locally
  • Confirm CI workflow passes on this branch

🤖 Generated with Claude Code

DerManoMann and others added 5 commits July 7, 2026 15:44
Drop Spectral in favour of Redocly CLI with a minimal ruleset focused
on structural correctness (unresolved refs, invalid component names).
Consolidate composer scripts into a single `composer redocly` command
that validates all generated specs with a baseline ignore file.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Examples intentionally omit servers — the rule is noise.
Reduces ignored violations from 309 to 186.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@DerManoMann DerManoMann merged commit 1afb8fb into zircote:master Jul 7, 2026
18 checks passed
@DerManoMann DerManoMann deleted the spec-validation branch July 7, 2026 04:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant