Fix CI image mismatch and remove stale docs

[jasonmadigan]

Summary

• Fix CI image mismatch on version bump PRs: build-image now also tags as latest, CI kustomize overlay references latest, conformance workflow no longer re-deploys via mcp-system overlay
• Remove stale x-mcp-api-key header references (never implemented, documented in error)
• Fix dead file path in AGENTS.md (pkg/controller -> internal/controller)

[coderabbitai]

Warning

Rate limit exceeded

@jasonmadigan has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 41 minutes and 59 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 41 minutes and 59 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 94f137be-445a-41b1-8f4b-5cb18160479c

📥 Commits

Reviewing files that changed from the base of the PR and between 9133505 and 460ef27.

📒 Files selected for processing (8)

• .github/workflows/conformance.yaml
• AGENTS.md
• CLAUDE.md
• Makefile
• config/mcp-gateway/overlays/ci/kustomization.yaml
• config/samples/remote-github/authpolicy.yaml
• docs/guides/external-mcp-server.md
• docs/guides/vault-token-exchange.md

📝 Walkthrough

Walkthrough

This PR bumps version references from 0.5.1/0.0.0 to 0.6.0 across deployment manifests, OLM artifacts, documentation, build scripts, and CI workflows, pinning container image tags to v0.6.0 instead of latest.

Changes

Cohort / File(s)	Summary
CI & Build System .github/workflows/conformance.yaml, Makefile	Replaced make deploy-controller with direct kubectl apply -k invocation in CI setup; added Kind image loading/tagging for mcp-gateway:latest and IMAGE_TAG_BASE:latest aliases.
OLM Bundle & Manifests bundle/manifests/mcp-gateway.clusterserviceversion.yaml, config/manifests/bases/mcp-gateway.clusterserviceversion.yaml, config/deploy/olm/catalogsource.yaml	Bumped CSV version from 0.0.0 to 0.6.0; updated controller/gateway image tags from latest to v0.6.0; changed CatalogSource image ref from main to v0.6.0.
Deployment Manifests config/mcp-gateway/components/controller/deployment-controller.yaml, config/mcp-system/deployment-broker.yaml, config/mcp-system/deployment-controller.yaml, config/mcp-gateway/overlays/ci/kustomization.yaml	Pinned controller/broker images to v0.6.0; added CI Kustomize overlay with image overrides forcing latest tags and env var patching for RELATED_IMAGE_ROUTER_BROKER.
Installation & Setup Scripts charts/sample_local_helm_setup.sh, config/openshift/deploy_openshift.sh, scripts/quick-start.sh, docs/guides/...	Updated default VERSION/MCP_GATEWAY_VERSION from 0.5.1 to 0.6.0 (or 0.6.0-rc2 → 0.6.0 in OLM docs), affecting derived git refs and Helm install behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• Reference latest released version on main always #674: Shares overlapping versioning updates in scripts and documentation (sample_local_helm_setup.sh, quick-start/docs guides).
• OLM bundle generation and deployment #637: Directly related through OLM bundle manifest modifications (CSV and CatalogSource updates).
• Quick start guide #691: Overlaps in quick-start script and documentation updates.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Title check	⚠️ Warning	The title mentions fixing CI image mismatch and removing stale docs, but the PR is primarily a version bump to 0.6.0 affecting numerous configuration files, manifests, and documentation. The title only addresses a subset of changes.	Revise the title to reflect the main change: 'Bump version to 0.6.0' or 'Update to version 0.6.0 and fix CI image mismatch'.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@bundle/manifests/mcp-gateway.clusterserviceversion.yaml`:
- Around line 8-15: The bundle manifests are outdated (bundle output doesn't
match generated artifacts); run the project bundling step and commit the
regenerated files: run `make bundle` to regenerate the bundle (which will update
fields such as containerImage, name/version and CRDs in the bundle manifests),
review the changed files under bundle/manifests (e.g.,
mcp-gateway.clusterserviceversion.yaml) to ensure the containerImage and
name/version entries are correct, then add and commit those updated bundle files
to the branch so CI validation passes.

In `@config/deploy/olm/catalogsource.yaml`:
- Line 7: The catalog image is pinned to v0.6.0; on main we should track the
moving target. Update the catalog image reference (the YAML key `image` value
`ghcr.io/kuadrant/mcp-controller-catalog:v0.6.0`) to use the `:latest` tag
instead of the semver tag so the OLM catalog on main follows current main
builds.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: c280fc0c-a962-44b4-96f2-79cf6fb62e07

📥 Commits

Reviewing files that changed from the base of the PR and between 2773beb and 9133505.

📒 Files selected for processing (16)

• .github/workflows/conformance.yaml
• Makefile
• bundle/manifests/mcp-gateway.clusterserviceversion.yaml
• charts/sample_local_helm_setup.sh
• config/deploy/olm/catalogsource.yaml
• config/manifests/bases/mcp-gateway.clusterserviceversion.yaml
• config/mcp-gateway/components/controller/deployment-controller.yaml
• config/mcp-gateway/overlays/ci/kustomization.yaml
• config/mcp-system/deployment-broker.yaml
• config/mcp-system/deployment-controller.yaml
• config/openshift/deploy_openshift.sh
• docs/guides/how-to-install-and-configure.md
• docs/guides/isolated-gateway-deployment.md
• docs/guides/olm-install.md
• docs/guides/quick-start.md
• scripts/quick-start.sh

[jasonmadigan]

CC: @maleck13 removed those dead header refs.