feat(api): expose provider connection health (#1636)

* feat(api): expose provider connection health

* fix(api): harden provider health review paths

* fix(api): refine provider health responses

* test(api): align provider health docs key scope

* fix(api): clarify provider connection status

* fix(api): batch provider connection sync status

* fix(api): polish provider connection status review feedback

* fix(api): correct provider connection summaries

app/controllers/api/v1/provider_connections_controller.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+class Api::V1::ProviderConnectionsController < Api::V1::BaseController
+  before_action :ensure_read_scope
+
+  def index
+    @provider_connections = ProviderConnectionStatus.for_family(Current.family)
+    render :index
+  rescue StandardError => e
+    Rails.logger.error "ProviderConnectionsController#index error: #{e.message}"
+    e.backtrace&.each { |line| Rails.logger.error line }
+
+    render_json({
+      error: "internal_server_error",
+      message: "An unexpected error occurred"
+    }, status: :internal_server_error)
+  end
+
+  private
+
+    def ensure_read_scope
+      authorize_scope!(:read)
+    end
+end