WIP Feat: aigw policies#5672
Merged
Merged
Conversation
✅ Deploy Preview for kongdeveloper ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR introduces the initial AI Gateway 2.0 “policies” documentation implementation by generating policy reference pages from existing plugin metadata, adding cross-major-version handling (canonical/SEO/sitemap/banner behavior), and reorganizing AI Gateway v1 how-tos and MCP content under versioned URLs with major_version metadata.
Changes:
- Add AI Gateway policies generator + supporting layouts/data drops for policy reference pages sourced from plugin metadata.
- Introduce
major_versionfrontmatter support and apply it across canonical/SEO/sitemap/title/listing behavior (including cross-major banners). - Add an RSpec test harness for Jekyll/Liquid plugins and update docs/permalinks/links for AI Gateway v1 content and MCP series.
Reviewed changes
Copilot reviewed 142 out of 143 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| vite.config.ts | Adjusts Vite dev proxy routing for API calls (now under /vite-dev/api). |
| tools/frontmatter-validator/index.js | Excludes AI Gateway policy override stubs from frontmatter validation. |
| tools/aigw-policy-scopes/package.json | Adds a small tool package for fetching AI Gateway policy scopes. |
| tools/aigw-policy-scopes/package-lock.json | Lockfile for the new aigw-policy-scopes tool package. |
| spec/support/liquid_context.rb | Adds helpers for rendering Liquid with a realistic Jekyll context in tests. |
| spec/support/jekyll_site.rb | Builds a fixture Jekyll site for plugin/unit testing. |
| spec/spec_helper.rb | Sets up RSpec + loads Jekyll plugins for test execution. |
| spec/fixtures/source/_config/releases/ai-gateway/v1.yml | Fixture release-map data used for canonical/major-version tests. |
| spec/fixtures/app/gateway/reference-page.md | Fixture reference page for release/canonical behavior tests. |
| spec/fixtures/app/gateway/install.md | Fixture versioned page for release/canonical behavior tests. |
| spec/fixtures/app/ai-gateway/v1/reference-page.md | Fixture AI Gateway v1 page for major-version behavior tests. |
| spec/fixtures/app/ai-gateway/reference-page.md | Fixture “latest” AI Gateway page for canonical/major-version tests. |
| spec/fixtures/app/_data/tools/deck.yml | Fixture tool release data for release resolution tests. |
| spec/fixtures/app/_data/products/gateway.yml | Fixture product release data for release resolution tests. |
| spec/fixtures/app/_data/products/event-gateway.yml | Fixture product release data for release resolution tests. |
| spec/fixtures/app/_data/products/ai-gateway.yml | Fixture AI Gateway release metadata used in major-version tests. |
| spec/fixtures/app/_config/releases/ai-gateway/v1.yml | Fixture release map for canonical URL mapping tests. |
| spec/fixtures/.gitignore | Ignores fixture build outputs. |
| spec/app/_plugins/tags/raise_spec.rb | Adds unit tests for the {% raise %} Liquid tag. |
| spec/app/_plugins/services/major_release_calculator_spec.rb | Adds tests for major-version detection logic. |
| spec/app/_plugins/generators/data/title/how_to_spec.rb | Adds tests for how-to title generation behavior. |
| spec/app/_plugins/generators/ai_gateway_policy/pages/base_spec.rb | Adds tests for AI Gateway policy page base behavior (breadcrumbs/icon). |
| Makefile | Adds a make test target for running RSpec. |
| jekyll.yml | Adds AI Gateway entities collection defaults and AI Gateway policy metadata config. |
| jekyll-dev.yml | Adds a skip flag for AI Gateway policy generation in dev. |
| Gemfile | Adds rspec + capybara under the :test group. |
| app/operator/dataplanes/reference/autoscale-gateway_v1.md | Removes an operator reference page (likely deprecated/moved). |
| app/event-gateway/policies/index.html | Refactors policy index search input into an include. |
| app/ai-gateway/resource-sizing-guidelines-ai.md | Updates AI Gateway sizing doc metadata (min_version change). |
| app/ai-gateway/ai-providers/xai.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/vertex.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/openai.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/ollama.md | Removes shared provider how-to include and adjusts formatting. |
| app/ai-gateway/ai-providers/mistral.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/llama.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/huggingface.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/gemini.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/deepseek.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/databricks.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/dashscope.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/cohere.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/cerebras.md | Removes shared provider how-to include. |
| app/ai-gateway/ai-providers/bedrock.md | Removes shared provider how-to include and cleans trailing markup. |
| app/ai-gateway/ai-providers/azure.md | Removes shared provider how-to include and cleans trailing markup. |
| app/ai-gateway/ai-providers/anthropic.md | Removes shared provider how-to include and cleans trailing markup. |
| app/_plugins/tags/reference_list.rb | Filters reference lists by major_version. |
| app/_plugins/tags/new_in.rb | Improves {% new_in %} validation for empty params. |
| app/_plugins/tags/how_to_list.rb | Filters how-to lists by major_version. |
| app/_plugins/services/release_map.rb | Adds service to load release-map YAML files. |
| app/_plugins/services/major_release_calculator.rb | Adds service to detect “previous major” pages. |
| app/_plugins/lib/site_accessor.rb | Adds redirect matching helper (redirect_exists?). |
| app/_plugins/lib/major_version_resolver.rb | Adds resolver for major-version URL segment templates. |
| app/_plugins/generators/sitemap/generator.rb | Skips pages with major_version from sitemap output. |
| app/_plugins/generators/release_info/tool.rb | Threads major-version context through tool release resolution. |
| app/_plugins/generators/release_info/releasable.rb | Adjusts “latest release” selection when major-version filtering is active. |
| app/_plugins/generators/release_info/product.rb | Filters product releases by resolved major version. |
| app/_plugins/generators/release_info/builder.rb | Resolves major version via MajorResolver and passes into release-info objects. |
| app/_plugins/generators/references/canonical_policy/previous_major.rb | New canonical policy to mark previous-major pages as non-canonical. |
| app/_plugins/generators/references/canonical_policy/default.rb | Default canonical policy behavior. |
| app/_plugins/generators/references/canonical_policy/below_min_release.rb | Canonical policy for pages below min release (unpublish). |
| app/_plugins/generators/references/canonical_policy/above_max_release.rb | Canonical policy for pages above max release (unpublish + canonical_url). |
| app/_plugins/generators/references/canonical_policy.rb | Policy selection dispatcher for canonical behavior. |
| app/_plugins/generators/references/auto_generated/generator.rb | Marks source reference docs as unpublished after generating pages. |
| app/_plugins/generators/policies/pages/base.rb | Adds has_overview? to policy page data. |
| app/_plugins/generators/policies/generator.rb | Minor generator refactor (return reference page from helper). |
| app/_plugins/generators/plugins_ai_gateway_policies.rb | Adds AI Gateway policies generator wired after plugin generation. |
| app/_plugins/generators/mesh.rb | Removes the Mesh generator (likely replaced elsewhere). |
| app/_plugins/generators/markdown_pages_generator.rb | Improves stripping of callout attribute lists (adds .ai, supports extra classes). |
| app/_plugins/generators/indices.rb | Excludes unpublished pages from index generation. |
| app/_plugins/generators/data/title/reference.rb | Guards against nil release when rendering reference titles. |
| app/_plugins/generators/data/title/base.rb | Treats AI Gateway policies pages as “Policy” for title generation. |
| app/_plugins/generators/data/seo.rb | Sets canonical flags + noindex for previous-major pages. |
| app/_plugins/generators/ai_gateway_policy/policy.rb | Defines AI Gateway policy model backed by plugin schema + override metadata. |
| app/_plugins/generators/ai_gateway_policy/pages/reference.rb | Adds AI Gateway policy reference page implementation + layout. |
| app/_plugins/generators/ai_gateway_policy/pages/overview.rb | Adds AI Gateway policy overview page class placeholder. |
| app/_plugins/generators/ai_gateway_policy/pages/base.rb | AI Gateway policy pages base URL/breadcrumb/icon/schema wiring. |
| app/_plugins/generators/ai_gateway_policy/generator.rb | Implements AI Gateway policy generation (reference only for now). |
| app/_plugins/drops/prereqs/product_entities_prereqs.rb | Adds version-aware prereq include resolution for entity prereqs. |
| app/_plugins/drops/prereqs/entity_examples_data.rb | Adds version-aware entity example lookup and clearer errors. |
| app/_plugins/drops/plugins/aigw_policy_schema.rb | Adds a schema Drop wrapper for AI Gateway policy schemas. |
| app/_plugins/drops/entity_schema.rb | Changes entity schema source selection to use schema.api pathing. |
| app/_plugins/drops/entity_example/presenters/ui.rb | Uses a different UI template for AI Gateway entity examples. |
| app/_layouts/reference.html | Replaces inline banner logic with an include-based banner. |
| app/_layouts/plugins/with_aside.html | Replaces inline plugin banners with a single include. |
| app/_layouts/llm.md | Adds banner output to LLM layout rendering. |
| app/_layouts/ai_gateway_policies/reference.html | New layout to render AI Gateway policy schema UI. |
| app/_landing_pages/ai-gateway/a2a.yaml | Removes embedded how-to list section from A2A landing page. |
| app/_kong_plugins/ai-proxy/examples/claude-code-bedrock.yaml | Fixes {% new_in %} usage by providing an explicit version. |
| app/_kong_plugins/ai-mcp-proxy/index.md | Updates MCP links to versioned AI Gateway v1 MCP paths. |
| app/_kong_plugins/ai-mcp-proxy/examples/conversion-listener-cookie.yaml | Fixes {% new_in %} usage by providing an explicit version. |
| app/_kong_plugins/ai-mcp-oauth2/index.md | Updates MCP link to versioned AI Gateway v1 MCP path. |
| app/_includes/prereqs/products/ai-gateway.md | Adds AI Gateway prereq include (currently placeholder content). |
| app/_includes/policies/index/search_input.html | New shared include for policy/plugin index search input UI. |
| app/_includes/policies/index/plugin_cards.html | New shared include for policy/plugin category card rendering. |
| app/_includes/plugins/banners.md | New shared include for plugin banners (third-party/premium/tier). |
| app/_includes/md/ai-gateway/v2/ai-vector-db.md | Adds AI Gateway v2 content include describing vector DB concepts. |
| app/_includes/llm/banners.md | Adds banner output to LLM exports (cross-major + autogenerated). |
| app/_includes/layouts/policies/nav_header.html | Hides “Overview” tab when has_overview? is false. |
| app/_includes/layouts/main.html | Adds cross-major banner to main layout when major_version is set. |
| app/_includes/landing_pages/grid.md | Adds cross-major banner under H1 on landing pages when versioned. |
| app/_includes/header.html | Adds “AI Gateway Policies” section to the header menu. |
| app/_includes/components/entity_example/format/deck.md | Makes Consumer name rendering more robust (name vs username). |
| app/_includes/cleanup/products/ai-gateway.md | Adds AI Gateway cleanup include for quickstart teardown. |
| app/_includes/cards/plugin.html | Links plugin cards to overview URL when available. |
| app/_includes/banners/cross_major_banner.md | Adds cross-major banner markdown content. |
| app/_includes/banners/cross_major_banner.html | Adds cross-major banner HTML wrapper include. |
| app/_includes/banners/auto_generated_reference.md | Adds reusable banner for older autogenerated references. |
| app/_how-tos/insomnia/use-git-cli.md | Updates Insomnia min_version format (drops “beta-” prefix). |
| app/_how-tos/insomnia/link-konnect-to-insomnia.md | Normalizes Insomnia min_version to 13.0. |
| app/_how-tos/ai-gateway/v1/visualize-ai-gateway-metrics-with-kibana.md | Moves to versioned permalink + adds major_version + updates related links. |
| app/_how-tos/ai-gateway/v1/use-vertex-sdk-for-streaming.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-vertex-sdk-chat.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-semantic-load-balancing.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-semantic-load-balancing-with-dynamic-vault-authentication.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-langchain-with-ai-proxy.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-gemini-sdk-chat.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-gemini-3-thinking-config.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-gemini-3-image-config.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-gemini-3-google-search.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-custom-function-for-ai-rate-limiting.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-cohere-rerank-api.md | Moves to versioned permalink + adds major_version + updates breadcrumbs. |
| app/_how-tos/ai-gateway/v1/use-codex-with-ai-gateway.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-claude-code-with-ai-gateway-vertex.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-claude-code-with-ai-gateway-openai.md | Moves to versioned permalink + adds major_version + updates provider links. |
| app/_how-tos/ai-gateway/v1/use-claude-code-with-ai-gateway-gemini.md | Moves to versioned permalink + adds major_version + updates provider links. |
| app/_how-tos/ai-gateway/v1/use-claude-code-with-ai-gateway-dashscope.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-claude-code-with-ai-gateway-bedrock.md | Moves to versioned permalink + adds major_version + updates provider links. |
| app/_how-tos/ai-gateway/v1/use-claude-code-with-ai-gateway-azure.md | Moves to versioned permalink + adds major_version + updates provider links. |
| app/_how-tos/ai-gateway/v1/use-claude-code-with-ai-gateway-anthropic.md | Moves to versioned permalink + adds major_version + updates provider links. |
| app/_how-tos/ai-gateway/v1/use-bedrock-rerank-api.md | Moves to versioned permalink + adds major_version + updates breadcrumbs. |
| app/_how-tos/ai-gateway/v1/use-bedrock-function-calling.md | Moves to versioned permalink + adds major_version (permalink path adjusted). |
| app/_how-tos/ai-gateway/v1/use-bedrock-function-calling-with-streaming.md | Moves to versioned permalink + adds major_version (and keeps cross-links). |
| app/_how-tos/ai-gateway/v1/use-azure-ai-content-safety.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-ai-semantic-response-guard-plugin.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-ai-semantic-prompt-guard-plugin.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-ai-rag-injector-plugin.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-ai-rag-injector-acls.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-ai-prompt-template-plugin.md | Moves to versioned permalink + adds major_version + updates self-link anchors. |
| app/_how-tos/ai-gateway/v1/use-ai-prompt-guard-plugin.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-ai-gcp-model-armor-plugin.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-ai-custom-guardrail-with-mistral-ai.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-ai-aws-guardrails-plugin.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/use-agno-with-ai-proxy.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/transform-a-response-with-ai.md | Moves to versioned permalink + adds major_version + fixes TL;DR link. |
| app/_how-tos/ai-gateway/v1/transform-a-client-request-with-ai.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/strip-model-from-open-ai-sdk-requests.md.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/store-a-mistral-api-key-as-a-secret-in-konnect-config-store.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-jaeger-with-gen-ai-otel.md | Moves to versioned permalink + adds major_version + updates cross-link. |
| app/_how-tos/ai-gateway/v1/set-up-jaeger-with-gen-ai-otel-for-tool-calls.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-vertex-ai.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-openai.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-ollama.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-ollama-qwen.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-huggingface.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-gemini.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-deepseek.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-databricks.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-dashscope.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-cohere.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-cerebras.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-aws-bedrock.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-with-anthropic.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-for-image-generation-with-grok.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-vertex-ai.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-openai.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-ollama.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-ollama-qwen.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-huggingface.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-gemini.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-deepseek.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-databricks.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-dashscope.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-cohere.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-cerebras.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-aws-bedrock.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/set-up-ai-proxy-advanced-with-anthropic.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/send-asynchronous-llm-requests.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/secure-a2a-with-oidc.md | Moves to versioned permalink + adds major_version + updates cross-links. |
| app/_how-tos/ai-gateway/v1/secure-a2a-traffic.md | Moves to versioned permalink + adds major_version + updates cross-links. |
| app/_how-tos/ai-gateway/v1/route-requests-by-model-alias.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/route-azure-sdk-to-specific-deployments.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/rotate-secrets-in-google-cloud-secret.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/rate-limit-a2a-traffic.md | Moves to versioned permalink + adds major_version + updates cross-links. |
| app/_how-tos/ai-gateway/v1/proxy-a2a-agents.md | Moves to versioned permalink + adds major_version + updates cross-links. |
| app/_how-tos/ai-gateway/v1/protect-sensitive-information-with-ai.md | Moves to versioned permalink + adds major_version + updates cross-link. |
| app/_how-tos/ai-gateway/v1/protect-sensitive-information-output-with-ai.md | Moves to versioned permalink + adds major_version + updates self-link. |
| app/_how-tos/ai-gateway/v1/mcp/use-access-controls-for-mcp-tools.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/mcp/secure-mcp-traffic.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/mcp/observe-traffic-for-mcp-tools.md | Moves to versioned permalink + adds major_version + updates MCP links. |
| app/_how-tos/ai-gateway/v1/mcp/observe-mcp-traffic.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/mcp/observe-mcp-traffic-with-acls.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/mcp/observe-autogenerated-mcp-tools-for-weather-api.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/mcp/map-weather-api-to-mcp-tools.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/mcp/map-API-to-mcp-tools.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/mcp/govern-mcp-traffic.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/mcp/aggregate-mcp-tools.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/limit-a2a-body-size.md | Moves to versioned permalink + adds major_version + updates cross-links. |
| app/_how-tos/ai-gateway/v1/forward-openai-sdk-model-to-ai-proxy-advanced.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/filter-knowledge-based-queries-with-rag-injector.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/compress-llm-prompts.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/azure-batches.md | Moves to versioned permalink + adds major_version. |
| app/_how-tos/ai-gateway/v1/authenticate-openai-sdk-clients-with-key-auth.md | Moves to versioned permalink + adds major_version. |
| app/_data/series.yml | Updates MCP series URL to versioned v1 MCP path. |
| app/_data/schemas/frontmatter/base.json | Adds major_version schema + tightens min_version format. |
| app/_data/products/ai-gateway.yml | Adds AI Gateway release metadata + previous-major URL segment template. |
| app/_data/konnect_oas_data.json | Adds AI Gateway OAS product entry metadata. |
| app/_assets/javascripts/apps/EntitySchema.vue | Updates how OAS specs are fetched in the schema renderer. |
| app/_api/konnect/ai-gateway/_index.md | Adds Konnect product ID mapping for AI Gateway OAS data. |
| app/_ai_gateway_policies/*/index.md | Adds AI Gateway policy override stubs (frontmatter used to override plugin-derived metadata). |
| api-specs/konnect/ai-gateway/v2/openapi.yaml | Adds a new Konnect AI Gateway API spec scaffold. |
| .rspec | Adds default RSpec options for running the test suite. |
| .github/styles/base/Dictionary.txt | Adds Vale dictionary entry for “AIGateway”. |
Files not reviewed (1)
- tools/aigw-policy-scopes/package-lock.json: Generated file
with default metadata
configuration and inherit all the metadata from them. Metadata and content can be overriden by editing the index.md under app/_ai_gateway_policies/. Redirect aigew policies overview pages to /reference/ for now until we have bandwith to write those.
the plugin to generate the aigw policy page
aigw policies, they inherit most of the frontmatter from plugin files
It needs to run after the plugins_generator and before the references generator. Jekyll relies on file names to execut the generator when the priority is the same so the only way to keep the order is by modifying the file name. TODO: use an explicit generator chain with one generator orchestrating the rest.
that both the html and md templates can render it
not have support for those yet
want to render the dropdown for now - we'll support only one version -
includes ai-gateway and the content_type is 'plugin'
replace plugin with aigw_policy cards Comment out the how-to, we haven't migrated it yet
- metadata - links to policies instead of plugins
- remove aigw v1 how-to link - replace plugin links with policies
fabianrbz
force-pushed
the
feat/aigw-policies
branch
from
9697ed3 to
18ad273
Compare
AIGWPolicySchema now resolves its schema file directly from app/_schemas/ai-gateway/policies/ via a FILE_INDEX constant, removing the dependency on api_plugin.data['schema']. Plugin Schema uses a lazy Hash.new FILE_INDEX that builds a per-version lowercase-keyed index on first access, replacing the eager all-versions glob and fixing the Linux case-sensitivity bug (ACL.json vs Acl.json). Removes the now-dead plugin_schemas_path config key from jekyll.yml.
fabianrbz
added
the
ci:manual-approve:link-validation
Guaris
approved these changes
Jun 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Basic implementation for aigw 2.0 policies
app/_ai_gateway_policies/*/index.mdconfigpart.Scopessection to the infobox with links to the aigw entities the policy can be scoped to based on file generated by a tool that hits an endpoint that returns this informationTODO:
Preview Links
https://deploy-preview-5672--kongdeveloper.netlify.app/ai-gateway/policies/
Checklist
descriptionentry in frontmatter.