fix: required_code_scanning missing from terraform state (#2701)

* Fix required_code_scanning missing from terraform state

* fix: resolve build errors in respository_rules_utils.go

* adds docs

---------

Co-authored-by: Nick Floyd <nicholas.floyd.info@gmail.com>

Author: stricklerxc

github/respository_rules_utils.go

@@ -658,6 +658,28 @@ func flattenRules(rules []*github.RepositoryRule, org bool) []any {
 			rule["min_entries_to_merge_wait_minutes"] = params.MinEntriesToMergeWaitMinutes
 			rulesMap[v.Type] = []map[string]any{rule}
 
+		case "required_code_scanning":
+			var params github.RequiredCodeScanningRuleParameters
+
+			err := json.Unmarshal(*v.Parameters, &params)
+			if err != nil {
+				log.Printf("[INFO] Unexpected error unmarshalling rule %s with parameters: %v",
+					v.Type, v.Parameters)
+			}
+
+			requiredCodeScanningToolSlice := make([]map[string]any, 0)
+			for _, tool := range params.RequiredCodeScanningTools {
+				requiredCodeScanningToolSlice = append(requiredCodeScanningToolSlice, map[string]any{
+					"alerts_threshold":          tool.AlertsThreshold,
+					"security_alerts_threshold": tool.SecurityAlertsThreshold,
+					"tool":                      tool.Tool,
+				})
+			}
+
+			rule := make(map[string]any)
+			rule["required_code_scanning_tool"] = requiredCodeScanningToolSlice
+			rulesMap[v.Type] = []map[string]any{rule}
+
 		case "file_path_restriction":
 			var params github.RuleFileParameters
 			err := json.Unmarshal(*v.Parameters, &params)

website/docs/r/organization_ruleset.html.markdown

@@ -54,6 +54,14 @@ resource "github_organization_ruleset" "example" {
         ref           = "main"
       }
     }
+
+    required_code_scanning {
+      required_code_scanning_tool {
+        alerts_threshold          = "errors"
+        security_alerts_threshold = "high_or_higher"
+        tool                      = "CodeQL"
+      }
+    }
   }
 }
 

website/docs/r/repository_ruleset.html.markdown

@@ -49,7 +49,13 @@ resource "github_repository_ruleset" "example" {
       required_deployment_environments = ["test"]
     }
 
-
+    required_code_scanning {
+      required_code_scanning_tool {
+        alerts_threshold          = "errors"
+        security_alerts_threshold = "high_or_higher"
+        tool                      = "CodeQL"
+      }
+    }
   }
 }