@spec list(
  ArchAstro.Client.t(),
  ArchAstro.Types.Operations.GetApiV1SolutionCategories.Params.t()
) ::
  {:ok, ArchAstro.Types.SolutionCategoryListResponse.t()}
  | {:error, ArchAstro.Error.reason()}

List solution categories

Returns a paginated list of solution category definitions visible to the authenticated caller. Use filters to narrow results by key, parent key, lookup key, or virtual path prefix.

Results are scoped to categories accessible under the caller's viewer context. Pass app to restrict the listing to categories associated with a specific app scope. Omit owners to return categories from all ownership scopes ("system" and "org") that the caller can see.

Pagination is page-based. Use page and page_size to navigate large result sets. The response includes total_entries, total_pages, has_next, and has_prev to support pagination controls. total_entries reflects the count after key deduplication.

Paginated list of solution category summaries matching the applied filters.