feat: use shared grouped aggregate strategy

Author: wtsnz

CHANGELOG.md

@@ -11,6 +11,13 @@ See [Conventional Commits](Https://conventionalcommits.org) for commit guideline
 
 <!-- changelog -->
 
+## Unreleased
+
+### Improvements:
+
+* use the shared `ash_sql` grouped aggregate strategy for aggregate loading, filtering, sorting, calculations, and root query aggregates
+* add grouped aggregate regression coverage for list defaults and root query aggregate kinds
+
 ## [v0.2.17](https://github.com/ash-project/ash_sqlite/compare/v0.2.16...v0.2.17) (2026-04-22)
 
 

documentation/topics/resources/aggregates.md

@@ -49,6 +49,21 @@ representatives = Helpdesk.Support.read!(Helpdesk.Support.Representative)
 Ash.load!(representatives, [:total_tickets, :ticket_subjects])
 ```
 
+## Query Aggregates
+
+AshSqlite supports root query aggregates for `count`, `sum`, `avg`, `min`, `max`,
+`first`, and `exists`.
+
+```elixir
+Helpdesk.Support.Representative
+|> Ash.Query.filter(active == true)
+|> Ash.aggregate!(count: :count)
+```
+
+Relationship query aggregates are not supported by the grouped aggregate query
+path. Define a resource aggregate and load, filter, or sort on that aggregate
+instead.
+
 ## Calculations
 
 Expression calculations can reference aggregates and be pushed down to SQLite.