feat(image): add OpenAPI CLI tooling

Add redocly, spectral, portman, newman, and oasdiff to the runner image
for OpenAPI lint, bundle, contract testing, and diff workflows.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: miragecentury

CHANGELOG.md

@@ -1,3 +1,7 @@
+### Features
+
+* **image:** add OpenAPI CLI tooling (redocly, spectral, portman, newman, oasdiff)
+
 ## [1.6.0](https://github.com/DeerHide/python-github-runner/compare/v1.5.1...v1.6.0) (2026-06-17)
 
 ### Features

Containerfile

@@ -134,6 +134,36 @@ RUN curl -sSL -o /tmp/bun.zip \
     && ln -sf /usr/local/bin/bun /usr/local/bin/bunx \
     && rm -rf /tmp/bun.zip /tmp/bun-linux-x64-baseline
 
+# Install Redocly CLI (OpenAPI linter and bundler)
+# OpenAPI tool versions kept aligned with customer_backend/scripts/openapi-tools.env
+ARG REDOCLY_CLI_VERSION=2.39.0
+# hadolint ignore=DL3013
+RUN npm install -g "@redocly/cli@${REDOCLY_CLI_VERSION}"
+
+# Install Spectral CLI (OpenAPI/AsyncAPI linter)
+ARG SPECTRAL_CLI_VERSION=6.16.1
+# hadolint ignore=DL3013
+RUN npm install -g "@stoplight/spectral-cli@${SPECTRAL_CLI_VERSION}"
+
+# Install Portman (OpenAPI to Postman contract tests)
+ARG PORTMAN_VERSION=1.35.0
+# hadolint ignore=DL3013
+RUN npm install -g "@apideck/portman@${PORTMAN_VERSION}"
+
+# Install Newman (Postman collection runner)
+ARG NEWMAN_VERSION=6.2.2
+# hadolint ignore=DL3013
+RUN npm install -g "newman@${NEWMAN_VERSION}"
+
+# Install oasdiff (OpenAPI diff and breaking-change detection)
+ARG OASDIFF_VERSION=1.23.0
+RUN curl -sSL -o /tmp/oasdiff.tgz \
+      "https://github.com/Tufin/oasdiff/releases/download/v${OASDIFF_VERSION}/oasdiff_${OASDIFF_VERSION}_linux_amd64.tar.gz" \
+    && tar -xzf /tmp/oasdiff.tgz -C /tmp oasdiff \
+    && mv /tmp/oasdiff /usr/local/bin/oasdiff \
+    && chmod +x /usr/local/bin/oasdiff \
+    && rm -f /tmp/oasdiff.tgz
+
 # Install pre-commit
 # hadolint ignore=DL3013
 RUN pip3 install --no-cache-dir pre-commit

manifest.yaml

@@ -16,6 +16,11 @@ build:
     - YQ_VERSION=4.53.2
     - NODE_VERSION=24.16.0
     - BUN_VERSION=1.3.14
+    - REDOCLY_CLI_VERSION=2.39.0
+    - SPECTRAL_CLI_VERSION=6.16.1
+    - PORTMAN_VERSION=1.35.0
+    - NEWMAN_VERSION=6.2.2
+    - OASDIFF_VERSION=1.23.0
   labels:
     - org.opencontainers.image.source=https://github.com/deerhide/python-github-runner
     - org.opencontainers.image.description="Python GitHub Runner"