app-intents

Write and review Swift code that exposes app functionality through the App Intents framework, ensuring correct protocol conformance, safe data flow, and idiomatic discoverability wiring. Review process: 1. Check intent fundamentals (protocol, `perform()`, return types, dialog) using `references/fundamentals.md`. 1. Validate parameters and parameter options using `references/parameters.md`. 1. Validate entity types, display representations, and queries using `references/entities.md`. 1. Check the `AppShortcutsProvider` registration and discoverability UI using `references/shortcuts-and-siri.md`. 1. Validate `OpenIntent` navigation and snippet view return types using `references/open-and-snippet-intents.md`. 1. Check dependency injection and the data-controller pattern using `references/dependencies.md`. 1. Validate Spotlight indexing via `IndexedEntity`, `IndexedEntityQuery`, and attribute sets using `references/spotlight.md`. 1. Check `@AssistantEntity` / `@AssistantIntent` schema adoption using `references/assistant-schemas.md`. 1. Validate the Siri / Apple Intelligence integration (finding content, custom responses, donations, confirmation, ownership) using `references/siri-intelligence.md`. 1. Check on-screen awareness and content transfer (view annotations, `IntentValueRepresentation`, system-integration annotations) using `references/onscreen-awareness.md`. 1. For intents that run past 30 seconds, handle cancellation, or target a specific process, use `references/long-...