feat: Unify parameter annotations with new @Param

[arcaputo3]

Summary

• Introduces a new unified @Param annotation that works across Tools, Resources, and Prompts
• Deprecates the specific @ToolParam, @ResourceParam, and @PromptParam annotations
• Maintains full backwards compatibility for existing code

Changes

• ✨ Add new @Param annotation with all necessary fields (description, example, required, schema)
• 📦 Update macro processors to check for @Param first, then fall back to legacy annotations
• 📝 Migrate all examples and documentation to use the new annotation
• ⚠️ Mark old annotations as deprecated with clear migration message

Backwards Compatibility

This change is fully backwards compatible:

• Existing code using @ToolParam, @ResourceParam, or @PromptParam will continue to work
• The macros intelligently check for the new @Param first, then fall back to legacy annotations
• Deprecation warnings guide users to migrate at their convenience
• Planned removal in version 0.3.0

Test Plan

• All 139 existing tests pass
• Examples compile and run correctly with new annotations
• Legacy annotations still work as expected

🤖 Generated with Claude Code