Reduce MCPServer CRD size by using runtime.RawExtension for PodTemplateSpec

[JAORMX]

Summary

This PR addresses issue #2013 by significantly reducing the MCPServer CRD size from ~9500 lines to 651 lines (93% reduction).

Problem

The MCPServer CRD was too large (~9500 lines) to apply without server-side apply due to the embedded PodTemplateSpec taking up ~8500 lines. This was causing deployment issues as reported in #2013.

Solution

Changed the PodTemplateSpec field from a strongly-typed `corev1.PodTemplateSpec` to `runtime.RawExtension`, which stores the raw JSON without schema validation at the CRD level.

Key Benefits

• ✅ 93% CRD size reduction (from ~9500 to 651 lines)
• ✅ Full backwards compatibility - users can still use the same YAML structure
• ✅ Runtime validation - validation now happens at runtime in the operator
• ✅ Proper error handling - via Kubernetes events and status conditions

Changes Made

• Modified MCPServer type to use `runtime.RawExtension` for PodTemplateSpec
• Updated PodTemplateSpecBuilder to unmarshal and validate at runtime
• Added event recording and status conditions for validation errors
• Added comprehensive tests for invalid PodTemplateSpec scenarios
• Fixed race conditions in parallel tests

Testing

Added comprehensive test coverage including:

• Invalid PodTemplateSpec validation tests
• Integration tests for error scenarios
• Race condition fixes in parallel test execution

Breaking Changes

None - this change maintains full backwards compatibility.

Fixes #2013

[codecov]

Codecov Report

❌ Patch coverage is 61.41732% with 49 lines in your changes missing coverage. Please review.
✅ Project coverage is 48.22%. Comparing base (90993f6) to head (8fc6086).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
...d/thv-operator/controllers/mcpserver_controller.go	55.96%	41 Missing and 7 partials ⚠️
...thv-operator/api/v1alpha1/zz_generated.deepcopy.go	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2015      +/-   ##
==========================================
+ Coverage   48.17%   48.22%   +0.04%     
==========================================
  Files         233      233              
  Lines       29229    29309      +80     
==========================================
+ Hits        14082    14133      +51     
- Misses      14111    14140      +29     
  Partials     1036     1036              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[jhrozek]

aah, I approved based on reading the code :-)

But in general the approach of not reconciling again if the podTemplateSpec is bad seems good to me.