chore: repo cleanup + hosted MCP sign-in documentation

.github/pull_request_template.md

@@ -24,4 +24,4 @@
 <!-- For API changes, paste actual response examples -->
 
 ---
-**Fixes #** <!-- Link to issue if applicable --> 
+**Fixes #** <!-- Link to issue if applicable -->

.github/workflows/validate-openapi.yml

@@ -25,7 +25,7 @@ jobs:
     - name: 🔧 Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: '18'
+        node-version: '22'
 
     - name: 📦 Install repo dependencies
       run: npm install
@@ -79,7 +79,7 @@ jobs:
     - name: 🔧 Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: '18'
+        node-version: '22'
 
     - name: 📦 Install Spectral
       run: npm install
@@ -98,16 +98,18 @@ jobs:
     - name: 🔧 Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: '18'
+        node-version: '22'
 
     - name: ✅ Check for OpenAPI 3.1 examples format
       run: |
-        # Check that we're using 'examples' (OpenAPI 3.1) not 'example' (OpenAPI 3.0)
-        if grep -r '"example":\|example:' leadmagic-openapi-3.1.yaml leadmagic-openapi-3.1.json; then
+        # Detect the deprecated singular 'example:' / '"example":' fields from OpenAPI 3.0
+        # without matching the valid 3.1 'examples:' / '"examples":' form.
+        if grep -nE '(^|[^s])"example"[[:space:]]*:|(^|[^s])example[[:space:]]*:' \
+            leadmagic-openapi-3.1.yaml leadmagic-openapi-3.1.json; then
           echo "❌ Found deprecated 'example' fields. Use 'examples' for OpenAPI 3.1"
           exit 1
         else
-          echo "✅ All examples use OpenAPI 3.1 format"
+          echo "✅ All examples use OpenAPI 3.1 'examples' format"
         fi
 
     - name: 📊 Count examples

.gitignore

@@ -1,113 +1,62 @@
 # Environment variables
 .env
 .env.local
-.env.production
+.env.test
 .env.staging
+.env.production
 
-# API Keys (security)
+# API keys and secrets
 *.key
 api-keys.txt
 secrets.txt
 
 # Node.js
 node_modules/
+jspm_packages/
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 .npm
 .node_repl_history
+.yarn-integrity
+*.tgz
 
 # Logs
-logs
+logs/
 *.log
-log/
 
 # Runtime data
-pids
+pids/
 *.pid
 *.seed
 *.pid.lock
 
-# Coverage directory used by tools like istanbul
+# Test coverage
 coverage/
 *.lcov
-
-# nyc test coverage
 .nyc_output
 
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# TypeScript v1 declaration files
-typings/
-
-# TypeScript cache
+# TypeScript
 *.tsbuildinfo
+typings/
 
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Microbundle cache
+# Build / cache output
+build/
+dist/
+.cache/
+.parcel-cache/
+.next/
+.nuxt/
 .rpt2_cache/
 .rts2_cache_cjs/
 .rts2_cache_es/
 .rts2_cache_umd/
 
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variables file
-.env
-.env.test
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
-
-# Next.js build output
-.next
-
-# Nuxt.js build / generate output
-.nuxt
-dist
-
-# Gatsby files
-.cache/
-public
-
-# Storybook build outputs
-.out
-.storybook-out
-
-# Temporary folders
-tmp/
-temp/
-
-# Editor files
+# Editor / IDE
 .vscode/
 .idea/
+*.sublime-project
+*.sublime-workspace
 *.swp
 *.swo
 *~
@@ -121,39 +70,24 @@ temp/
 ehthumbs.db
 Thumbs.db
 
-# Generated client code (when testing)
+# Generated clients and codegen output
 *-client/
 generated/
+swagger-codegen/
+openapi-generator/
 
-# Backup files
+# Backup / archive files
 *.backup
 *.bak
 *.orig
-
-# Test results
-test-results/
-results/
-reports/
-
-# Documentation build output
-docs/build/
-
-# Swagger/OpenAPI generated files
-swagger-codegen/
-openapi-generator/
-
-# IDE specific files
-*.sublime-project
-*.sublime-workspace
-.project
-.settings/
-
-# Archive files
 *.zip
 *.tar
 *.tar.gz
 *.rar
 
-# Temporary API test files
+# Test artifacts and local reports
+test-results/
+results/
+reports/
 test-output.json
 api-responses.json