feat: Add configurable annotation filtering to list_resources

[JAORMX]

Summary

Implements Phase 1 of the action plan for Issue #89: Metadata Output Getting Truncated. Adds configurable annotation filtering to the list_resources tool to prevent truncation issues with large annotations, particularly GPU node annotations.

Changes

New Parameters for list_resources

• include_annotations (boolean): Whether to include annotations in output (default: true)
• exclude_annotation_keys (array): List of annotation keys to exclude with wildcard support (e.g., nvidia.com/*)
• include_annotation_keys (array): List of annotation keys to include exclusively
• label_selector: Added missing parameter to tool schema

Implementation Details

• filterAnnotations(): Core filtering function with include/exclude logic
• matchesPattern(): Wildcard pattern matching for flexible annotation filtering
• Backward Compatible: Default behavior excludes kubectl.kubernetes.io/last-applied-configuration
• Include Precedence: When include_annotation_keys is specified, it takes precedence over exclude logic

Testing

• Comprehensive unit tests covering all filtering scenarios
• Integration tests with real Kubernetes cluster
• All existing tests continue to pass
• Build verification successful

Usage Examples

Exclude GPU annotations to prevent truncation:

{
  "resource_type": "clustered",
  "group": "", "version": "v1", "resource": "nodes",
  "exclude_annotation_keys": ["nvidia.com/*", "kubectl.kubernetes.io/last-applied-configuration"]
}

Include only specific annotations:

{
  "resource_type": "namespaced",
  "group": "", "version": "v1", "resource": "pods", "namespace": "default",
  "include_annotation_keys": ["app", "version"]
}

Disable annotations completely:

{
  "resource_type": "namespaced",
  "group": "", "version": "v1", "resource": "pods", "namespace": "default",
  "include_annotations": false
}

Benefits

• ✅ Solves GPU Annotation Truncation: Users can exclude large NVIDIA annotations
• ✅ Flexible Control: Complete user control over annotation inclusion/exclusion
• ✅ Performance Optimization: Smaller responses when annotations are filtered
• ✅ Backward Compatible: No breaking changes, existing integrations work unchanged
• ✅ Wildcard Support: Easy filtering of entire annotation namespaces

Documentation

• Updated README.md with comprehensive documentation
• Added detailed examples for all filtering scenarios
• Documented annotation filtering rules and behavior

Fixes #89