From 948850bc555e7205da6d3734d1cf572e150e2322 Mon Sep 17 00:00:00 2001 From: ebichman-1 Date: Sun, 26 Apr 2026 14:55:39 +0300 Subject: [PATCH] fix(aep): AEP Compliance Gap Analysis & Remediation Plan Harden AEP linter tooling and CI configuration - Pin .spectral.yaml to aep-openapi-linter v0.5.3 release tag instead of mutable main branch for reproducible builds. - Switch Makefile check-aep target from bare spectral to npx @stoplight/spectral-cli to eliminate global install requirement. - Add path filters to check-aep CI workflow so it only triggers on API spec or linter config changes. - No OpenAPI spec changes - all 50+ AEP linter rules already pass. Assisted-by: Claude Opus 4.6 (Anthropic) Signed-off-by: ebichman-1 --- .github/workflows/check-aep.yaml | 3 +++ .spectral.yaml | 2 +- Makefile | 2 +- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/.github/workflows/check-aep.yaml b/.github/workflows/check-aep.yaml index b4704da..32ad92a 100644 --- a/.github/workflows/check-aep.yaml +++ b/.github/workflows/check-aep.yaml @@ -3,6 +3,9 @@ name: Check AEP Compliance on: pull_request: branches: [main] + paths: + - 'api/**' + - '.spectral.yaml' jobs: check-aep: diff --git a/.spectral.yaml b/.spectral.yaml index 7b51d09..3852bcd 100644 --- a/.spectral.yaml +++ b/.spectral.yaml @@ -1,5 +1,5 @@ extends: - - https://raw.githubusercontent.com/aep-dev/aep-openapi-linter/main/spectral.yaml + - https://raw.githubusercontent.com/aep-dev/aep-openapi-linter/refs/tags/v0.5.3/spectral.yaml rules: x-aep-resource-no-boolean: diff --git a/Makefile b/Makefile index 64aea55..fc8dd1d 100644 --- a/Makefile +++ b/Makefile @@ -57,7 +57,7 @@ check-generate-api: generate-api # Check AEP compliance check-aep: - spectral lint --fail-severity=warn ./api/v1alpha1/openapi.yaml + npx --yes @stoplight/spectral-cli lint --fail-severity=warn ./api/v1alpha1/openapi.yaml subsystem-test-up: $(COMPOSE) -f test/subsystem/docker-compose.yaml up -d --build