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.
2. Validate parameters and parameter options using references/parameters.md.
3. Validate entity types, display representations, and queries using references/entities.md.
4. Check the AppShortcutsProvider registration and discoverability UI using references/shortcuts-and-siri.md.
5. Validate OpenIntent navigation and snippet view return types using references/open-and-snippet-intents.md.
6. Check dependency injection and the data-controller pattern using references/dependencies.md.
7. Validate Spotlight indexing via IndexedEntity, IndexedEntityQuery, and attribute sets using references/spotlight.md.
8. Check @AssistantEntity / @AssistantIntent schema adoption using references/assistant-schemas.md.
9. Validate the Siri / Apple Intelligence integration (finding content, custom responses, donations, confirmation, ownership) using references/siri-intelligence.md.
10. Check on-screen awareness and content transfer (view annotations, IntentValueRepresentation, system-integration annotations) using references/onscreen-awareness.md.
11. For intents that run past 30 seconds, handle cancellation, or target a specific process, use references/long-running-and-execution.md.
12. If writing or reviewing tests for intents, use references/testing-intents.md (covers the new AppIntentsTesting framework).
13. Catch common mistakes using references/anti-patterns.md.

If doing partial work, load only the relevant reference files.