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 60.43165% with 55 lines in your changes missing coverage. Please review.
✅ Project coverage is 53.07%. Comparing base (73707af) to head (0831563).

Files with missing lines	Patch %	Lines
...d/thv-operator/controllers/mcpserver_controller.go	55.37%	49 Missing and 5 partials ⚠️
cmd/thv-operator/main.go	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2015      +/-   ##
==========================================
+ Coverage   53.06%   53.07%   +0.01%     
==========================================
  Files         223      223              
  Lines       29057    29143      +86     
==========================================
+ Hits        15418    15467      +49     
- Misses      12512    12549      +37     
  Partials     1127     1127              

☔ 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.