feature: Add annotation metadata support to TypeShape module

[xerial]

Summary

• Add AnnotationInfo class for runtime representation of annotation metadata in the TypeShape (formerly Surface) module
• Implement a rich type-safe API for creating and querying annotation parameters
• Support various annotation patterns including simple values, named parameters, arrays, and nested annotations

Details

This PR introduces comprehensive annotation metadata support to the ai-core TypeShape module, enabling runtime introspection of annotations without direct reflection.

Key Components:

• AnnotationInfo: Core class representing annotation metadata with builder methods for common patterns
• AnnotationValue: Sealed trait hierarchy for type-safe annotation parameter values
• Comprehensive test coverage: Tests for all annotation patterns and edge cases

API Examples:

// Simple annotation
val desc = AnnotationInfo.simple("description", "User model")

// Multi-parameter annotation  
val option = AnnotationInfo.withKeyValues("option",
  "name" -> "user-id",
  "required" -> true
)

// Type-safe parameter access
option.getParameterAs[String]("name") // Some("user-id")

Test plan

• Unit tests for all AnnotationInfo creation methods
• Tests for parameter access and type conversions
• Edge cases like empty parameters and null handling
• toString formatting verification
• Serialization compatibility

🤖 Generated with Claude Code

[gemini-code-assist]

Warning

Gemini encountered an error creating the summary. You can try again by commenting /gemini summary.