Split OpenAPI.json into digest-able and editable YML files. Including OpenAPI lint and build workflow

.github/workflows/openapi-validation.yml

@@ -0,0 +1,49 @@
+name: OpenAPI validation
+
+on:
+  pull_request:
+    paths:
+      - 'docs/openapi/**'
+      - 'docs/openapi.json'
+      - 'tools/openapi_*.py'
+      - 'tests/test_openapi_bundle.py'
+      - '.github/workflows/openapi-validation.yml'
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/openapi/**'
+      - 'docs/openapi.json'
+      - 'tools/openapi_*.py'
+      - 'tests/test_openapi_bundle.py'
+      - '.github/workflows/openapi-validation.yml'
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install Python dependencies
+        run: python -m pip install --upgrade pip && python -m pip install --quiet -r requirements-dev.txt
+
+      - name: Bundle OpenAPI (validation enabled)
+        run: python -m tools.openapi_bundle docs/openapi/index.yaml docs/openapi.json
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Lint OpenAPI specification
+        run: npx -y mintlify openapi-check docs/openapi.json
+
+      - name: Run OpenAPI regression test
+        run: python -m unittest tests.test_openapi_bundle

.gitignore

@@ -1 +1,77 @@
+# macOS
 .DS_Store
+
+# Node.js / Bun
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Bun specific
+# Note: we DO track bun.lockb for reproducible builds
+# If you want to ignore it, uncomment the line below:
+# bun.lockb
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+*.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# IDEs and Editors
+.vscode/settings.json
+.idea/
+*.swp
+*.swo
+*~
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.sublime-workspace
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+
+# Generated files (do NOT ignore docs/openapi.json - it's committed)
+# docs/openapi.json is intentionally tracked
+
+# Watchman
+.watchman-cookie-*
+
+# Vercel
+.vercel/
+
+# Claude Code configuration
+.claude/

.tool-versions

@@ -0,0 +1,3 @@
+bun 1.1.29
+nodejs 20.17.0
+python 3.11.9

.watchmanconfig

@@ -0,0 +1,12 @@
+{
+  "ignore_dirs": [
+    ".git",
+    "node_modules",
+    "__pycache__",
+    ".pytest_cache",
+    "terminal49_mcp.egg-info",
+    "dist",
+    "build"
+  ],
+  "settle": 100
+}