feat(api): add chat read tools for summary/retrospective/metrics (#82)

[thomasluizon]

@
Adds three read-only IAiTool implementations to the in-app chat agent, each a thin wrapper over an existing MediatR query:

• get_daily_summary -> GetDailySummaryQuery (date range defaults to user-today via IUserDateService)
• get_retrospective -> GetRetrospectiveQuery (period -> date-range, mirroring HabitsController.GetRetrospective)
• get_habit_metrics -> GetHabitMetricsQuery (validates habit_id as a GUID at the boundary)

All three are IsReadOnly => true. PayGate / failure Results surface as ToolResult(false, Error: ...) (mirroring GetGamificationOverviewTool) rather than being swallowed — get_daily_summary for non-Pro / ai_summary off, get_retrospective for non-YearlyPro / ai_retrospective off.

Registered in DI (ServiceCollectionExtensions.cs) and mapped onto the existing HabitMetricsRead / DailySummaryRead / RetrospectiveRead catalog capabilities via their chatTools arrays (no new capabilities; risk_class: Low, confirmation: None unchanged).

Tests

• New unit tests per tool (success, PayGate/failure propagation, arg derivation) under tests/Orbit.Application.Tests/Chat/Tools/.
• Updated ChatToolMetadataTests.cs (names/descriptions/schemas).
• EveryChatTool_IsMappedToTheCatalog (Infrastructure.Tests) auto-discovers the new tools and stays green.
• dotnet build clean; Application.Tests (1689) + Infrastructure.Tests (917) all pass.

Refs thomasluizon/orbit-ui-mobile#82

Stacked on #175 (#79) — shares the chat catalog/DI files (ServiceCollectionExtensions.cs + AgentCatalogService.cs). Base is issue-79; review/merge #175 first.

🤖 Generated with Claude Code
@

[claude]

Three clean read-only IAiTool wrappers over existing MediatR queries. User scoping is enforced at the query layer (GetHabitMetricsQuery filters by both HabitId and UserId in the DB predicate; the other two pass UserId through to their handlers). All three use IUserDateService.GetUserTodayAsync for date defaulting, in full compliance with the timezone hard-rule. PayGate/failure Results surface correctly as ToolResult(false, Error: ...) rather than being swallowed, matching the existing GamificationOverview pattern. DI registration and catalog wiring are minimal and correct. Unit test coverage is solid — success, PayGate propagation, and argument-derivation cases are all present for each tool.

[claude]

Three clean read-only IAiTool wrappers over existing MediatR queries. All three use IUserDateService.GetUserTodayAsync for date defaulting (timezone hard-rule satisfied), pass userId through to their queries (user scoping enforced at the query layer), and surface PayGate/failure Results as ToolResult(false, Error: ...) rather than swallowing them — consistent with the GamificationOverview pattern. GUID boundary validation in GetHabitMetricsTool is correct. Catalog wiring maps onto the existing DailySummaryRead/RetrospectiveRead/HabitMetricsRead capabilities with no new capabilities added. Unit test coverage is solid across success, PayGate propagation, and argument-derivation cases for all three tools.