feat: add github_copilot_organization_settings data source

Exposes read-only Copilot billing settings for the provider org via
GET /orgs/{org}/copilot/billing: seat_management_setting,
public_code_suggestions, and the full seat_breakdown block.

The GitHub API has no write endpoint for these settings so a resource
is not possible — a data source is the correct primitive here.
Acceptance test verified against a real Copilot-enabled org.

Author: Nitin Jain

examples/data-sources/github_copilot_organization_settings/data-source.tf

@@ -0,0 +1,9 @@
+data "github_copilot_organization_settings" "example" {}
+
+output "seat_management" {
+  value = data.github_copilot_organization_settings.example.seat_management_setting
+}
+
+output "total_seats" {
+  value = data.github_copilot_organization_settings.example.seat_breakdown[0].total
+}

github/data_source_github_copilot_organization_settings.go

@@ -0,0 +1,106 @@
+package github
+
+import (
+	"context"
+	"errors"
+	"net/http"
+
+	"github.com/google/go-github/v88/github"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+func dataSourceGithubCopilotOrganizationSettings() *schema.Resource {
+	return &schema.Resource{
+		ReadContext: dataSourceGithubCopilotOrganizationSettingsRead,
+
+		Schema: map[string]*schema.Schema{
+			"seat_management_setting": {
+				Type:        schema.TypeString,
+				Computed:    true,
+				Description: "How Copilot seats are assigned: assign_selected, all_members, or unconfigured.",
+			},
+			"public_code_suggestions": {
+				Type:        schema.TypeString,
+				Computed:    true,
+				Description: "Whether Copilot can suggest code matching public repositories: allow or block.",
+			},
+			"seat_breakdown": {
+				Type:        schema.TypeList,
+				Computed:    true,
+				Description: "Breakdown of Copilot seat usage.",
+				Elem: &schema.Resource{
+					Schema: map[string]*schema.Schema{
+						"total": {
+							Type:        schema.TypeInt,
+							Computed:    true,
+							Description: "Total number of Copilot seats.",
+						},
+						"added_this_cycle": {
+							Type:        schema.TypeInt,
+							Computed:    true,
+							Description: "Seats added in the current billing cycle.",
+						},
+						"pending_invitation": {
+							Type:        schema.TypeInt,
+							Computed:    true,
+							Description: "Seats pending invitation acceptance.",
+						},
+						"pending_cancellation": {
+							Type:        schema.TypeInt,
+							Computed:    true,
+							Description: "Seats pending cancellation.",
+						},
+						"active_this_cycle": {
+							Type:        schema.TypeInt,
+							Computed:    true,
+							Description: "Seats active in the current billing cycle.",
+						},
+						"inactive_this_cycle": {
+							Type:        schema.TypeInt,
+							Computed:    true,
+							Description: "Seats inactive in the current billing cycle.",
+						},
+					},
+				},
+			},
+		},
+	}
+}
+
+func dataSourceGithubCopilotOrganizationSettingsRead(ctx context.Context, d *schema.ResourceData, m any) diag.Diagnostics {
+	meta := m.(*Owner)
+	client := meta.v3client
+	org := meta.name
+
+	billing, _, err := client.Copilot.GetCopilotBilling(ctx, org)
+	if err != nil {
+		if ghErr, ok := errors.AsType[*github.ErrorResponse](err); ok && ghErr.Response.StatusCode == http.StatusNotFound {
+			return diag.Errorf("Copilot is not enabled for organization %q", org)
+		}
+		return diag.FromErr(err)
+	}
+
+	d.SetId(org)
+
+	if err := d.Set("seat_management_setting", billing.GetSeatManagementSetting()); err != nil {
+		return diag.FromErr(err)
+	}
+	if err := d.Set("public_code_suggestions", billing.GetPublicCodeSuggestions()); err != nil {
+		return diag.FromErr(err)
+	}
+	if breakdown := billing.GetSeatBreakdown(); breakdown != nil {
+		if err := d.Set("seat_breakdown", []any{map[string]any{
+			"total":                breakdown.GetTotal(),
+			"added_this_cycle":     breakdown.GetAddedThisCycle(),
+			"pending_invitation":   breakdown.GetPendingInvitation(),
+			"pending_cancellation": breakdown.GetPendingCancellation(),
+			"active_this_cycle":    breakdown.GetActiveThisCycle(),
+			"inactive_this_cycle":  breakdown.GetInactiveThisCycle(),
+		}}); err != nil {
+			return diag.FromErr(err)
+		}
+	}
+
+	return nil
+}

github/data_source_github_copilot_organization_settings_test.go

@@ -0,0 +1,25 @@
+package github
+
+import (
+	"testing"
+
+	"github.com/hashicorp/terraform-plugin-testing/helper/resource"
+)
+
+func TestAccDataSourceGithubCopilotOrganizationSettings(t *testing.T) {
+	t.Run("reads Copilot organization settings", func(t *testing.T) {
+		resource.Test(t, resource.TestCase{
+			PreCheck:          func() { skipUnlessHasOrgs(t) },
+			ProviderFactories: providerFactories,
+			Steps: []resource.TestStep{
+				{
+					Config: `data "github_copilot_organization_settings" "test" {}`,
+					Check: resource.ComposeTestCheckFunc(
+						resource.TestCheckResourceAttrSet("data.github_copilot_organization_settings.test", "seat_management_setting"),
+						resource.TestCheckResourceAttrSet("data.github_copilot_organization_settings.test", "public_code_suggestions"),
+					),
+				},
+			},
+		})
+	})
+}

github/provider.go

@@ -246,6 +246,7 @@ func NewProvider() func() *schema.Provider {
 				"github_codespaces_secrets":                                             dataSourceGithubCodespacesSecrets(),
 				"github_codespaces_user_public_key":                                     dataSourceGithubCodespacesUserPublicKey(),
 				"github_codespaces_user_secrets":                                        dataSourceGithubCodespacesUserSecrets(),
+				"github_copilot_organization_settings":                                  dataSourceGithubCopilotOrganizationSettings(),
 				"github_dependabot_organization_public_key":                             dataSourceGithubDependabotOrganizationPublicKey(),
 				"github_dependabot_organization_secrets":                                dataSourceGithubDependabotOrganizationSecrets(),
 				"github_dependabot_public_key":                                          dataSourceGithubDependabotPublicKey(),

templates/data-sources/copilot_organization_settings.md.tmpl

@@ -0,0 +1,33 @@
+---
+page_title: "{{.Name}} ({{.Type}}) - {{.RenderedProviderName}}"
+description: |-
+  Reads the GitHub Copilot settings for an organization.
+---
+
+# {{.Name}} ({{.Type}})
+
+Use this data source to read the GitHub Copilot settings and seat breakdown for an organization.
+
+~> **Note** This data source requires the organization to have a Copilot Business or Enterprise subscription.
+
+## Example Usage
+
+{{ tffile "examples/data-sources/github_copilot_organization_settings/data-source.tf" }}
+
+## Argument Reference
+
+No arguments are required. The data source reads settings for the provider's configured organization.
+
+## Attributes Reference
+
+The following attributes are exported:
+
+- `seat_management_setting` - How Copilot seats are assigned: `assign_selected`, `all_members`, or `unconfigured`.
+- `public_code_suggestions` - Whether Copilot can suggest code matching public repositories: `allow` or `block`.
+- `seat_breakdown` - Breakdown of Copilot seat usage. Contains:
+  - `total` - Total number of Copilot seats.
+  - `added_this_cycle` - Seats added in the current billing cycle.
+  - `pending_invitation` - Seats pending invitation acceptance.
+  - `pending_cancellation` - Seats pending cancellation.
+  - `active_this_cycle` - Seats active in the current billing cycle.
+  - `inactive_this_cycle` - Seats inactive in the current billing cycle.