Move cf-openapi into CCNG

.github/workflows/openapi_breaking_changes.yml

@@ -0,0 +1,62 @@
+name: OpenAPI Breaking Changes
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'docs/openapi/**'
+      - '.github/workflows/openapi_breaking_changes.yml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  detect-breaking-changes:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout PR
+        uses: actions/checkout@v4
+        with:
+          path: pr
+          persist-credentials: false
+
+      - name: Checkout Base Branch
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.base_ref }}
+          path: base
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'yarn'
+          cache-dependency-path: |
+            pr/docs/openapi/yarn.lock
+            base/docs/openapi/yarn.lock
+
+      - name: Build PR Spec
+        working-directory: pr/docs/openapi
+        run: |
+          yarn install --frozen-lockfile --ignore-scripts
+          yarn build
+
+      - name: Build Base Spec
+        working-directory: base/docs/openapi
+        run: |
+          yarn install --frozen-lockfile --ignore-scripts
+          yarn build
+
+      - name: Check for Breaking Changes
+        uses: oasdiff/oasdiff-action/breaking@v0.0.37
+        with:
+          base: 'base/docs/openapi/dist/latest/openapi.yaml'
+          revision: 'pr/docs/openapi/dist/latest/openapi.yaml'
+          fail-on: 'ERR'

.github/workflows/openapi_deploy.yml

@@ -0,0 +1,55 @@
+name: Deploy CF API V3 OpenAPI Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/openapi/**'
+      - '.github/workflows/openapi_deploy.yml'
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    name: Build and publish to gh-pages
+    runs-on: ubuntu-latest
+    container:
+      image: node:24-alpine
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v4
+        with:
+          path: main
+
+      - name: Setup
+        working-directory: main/docs/openapi
+        run: |
+          apk add python3 make g++ git tar
+          yarn install
+
+      - name: Build
+        working-directory: main/docs/openapi
+        run: yarn build
+
+      - name: Checkout gh-pages
+        uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+          path: gh-pages
+
+      - name: Sync built docs into gh-pages/openapi
+        run: |
+          rm -rf gh-pages/openapi
+          mkdir -p gh-pages/openapi
+          cp -r main/docs/openapi/dist/. gh-pages/openapi/
+
+      - name: Commit and push
+        working-directory: gh-pages
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add openapi
+          git diff --cached --quiet && echo "No changes to publish" || \
+            (git commit -m "Update openapi docs from ${GITHUB_SHA}" && git push)

.github/workflows/openapi_test.yml

@@ -0,0 +1,38 @@
+name: OpenAPI Docs Test
+
+on:
+  workflow_dispatch:
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'docs/openapi/**'
+      - '.github/workflows/openapi_test.yml'
+
+concurrency:
+  group: '${{ github.workflow }}-${{ github.head_ref || github.run_id }}'
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    container:
+      image: node:24-alpine
+    defaults:
+      run:
+        working-directory: docs/openapi
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup
+        run: |
+          apk add python3 make g++
+          yarn install
+      - name: Stats
+        run: yarn redocly stats --format markdown >> $GITHUB_STEP_SUMMARY
+      - name: Lint
+        run: |
+          yarn redocly lint --max-problems 9999 --format markdown >> $GITHUB_STEP_SUMMARY || true
+          yarn redocly lint --max-problems 9999 --format github-actions
+      - name: Build
+        run: yarn build

docs/openapi/.gitignore

@@ -0,0 +1,47 @@
+# From capi-openapi-spec
+capi/*.json
+capi/*.yml
+.DS_Store
+openapitools.json
+clients/
+sdk/
+node_modules/
+
+# Test SDK integration generated files
+test/sdk-integration/python/capi_client/
+test/sdk-integration/python/docs/
+test/sdk-integration/python/test/
+test/sdk-integration/python/.openapi-generator/
+test/sdk-integration/python/*.egg-info/
+test/sdk-integration/python/build/
+test/sdk-integration/python/dist/
+test/sdk-integration/python/.tox/
+test/sdk-integration/python/.pytest_cache/
+test/sdk-integration/python/__pycache__/
+test/sdk-integration/python/.coverage
+test/sdk-integration/python/htmlcov/
+test/sdk-integration/python/README.md
+test/sdk-integration/python/setup.py
+test/sdk-integration/python/setup.cfg
+test/sdk-integration/python/pyproject.toml
+test/sdk-integration/python/requirements.txt
+test/sdk-integration/python/test-requirements.txt
+test/sdk-integration/python/tox.ini
+test/sdk-integration/python/git_push.sh
+test/sdk-integration/python/.github/
+test/sdk-integration/python/.gitlab-ci.yml
+test/sdk-integration/python/.travis.yml
+
+# Test SDK integration Go generated files (if any beyond the test files)
+test/sdk-integration/go/vendor/
+test/sdk-integration/go/pkg/
+test/sdk-integration/go/bin/
+
+# From cf-api-openapi-poc
+.idea
+*.iml
+dist
+node_modules
+out
+tmp
+.tmp

docs/openapi/.redocly.lint-ignore.yaml

@@ -0,0 +1,5 @@
+# This file instructs Redocly's linter to ignore the rules contained for specific parts of your API.
+# See https://redocly.com/docs/cli/ for more information.
+apis/cf/latest/paths/Packages.yaml:
+  operation-2xx-response:
+    - '#/~1v3~1packages~1{guid}~1download/get/responses'