sync

type ApplyOptions struct {
	// ContinueOnError keeps applying remaining changes after a handler fails,
	// then returns an aggregated error at the end. When false (the default),
	// the first handler error aborts the run.
	ContinueOnError bool
}

type Handler interface {
	Apply(ctx context.Context, c *gh.Client, ch util.Change) error
}

type HandlerFunc func(ctx context.Context, c *gh.Client, ch util.Change) error

type HandlerRegistry struct {
	// contains filtered or unexported fields
}

type ImportOptions struct {
	// Only restricts the repository scan to names matching these path.Match
	// globs. Empty scans every repository in the organization.
	Only []string
}

type ImportResult struct {
	// Org holds organization rulesets the configuration does not declare.
	Org []ImportedRuleset
	// Repos maps a repository name to the rulesets on it that the
	// configuration does not declare, sorted by repository name.
	Repos map[string][]ImportedRuleset
	// Unmanaged lists repositories that hold adoptable rulesets but appear in
	// no team file. There is nowhere in the configuration to write their
	// rulesets until the repository itself is adopted into a team.
	Unmanaged []string
	// Skipped lists rulesets that exist but could not be represented as
	// configuration, with the reason.
	Skipped []SkippedRuleset
	// AlreadyDeclared counts rulesets skipped because the configuration
	// already declares a ruleset of that name at that scope.
	AlreadyDeclared int
	// Scanned counts the repositories inspected.
	Scanned int
}

type ImportedRuleset struct {
	// Repo is the repository the ruleset belongs to, or "" for an
	// organization-level one.
	Repo string
	// Spec is the ruleset as configuration, ready to be written to YAML.
	Spec config.RulesetConfig
}

type ImportedTeam struct {
	Config config.TeamConfig
	// Parent is the slug of the team this one is nested under, if any. It is
	// written into Config.Parents once the whole scan is in, because a parent
	// is only expressible when the file that defines it is also being written
	// — an import that adopts a child whose parent is already declared, or is
	// not being imported, has nowhere to point.
	Parent string
	// ParentUnwritable is set when Parent names a team this import will not
	// produce a file for, so the nesting is reported instead of recorded.
	ParentUnwritable bool
}

type SkippedRuleset struct {
	Repo   string // "" for an organization ruleset
	Name   string
	Reason string
}

type SkippedTeam struct {
	Slug   string
	Reason string
}

type State struct {
	Org          string
	ManagedRepos map[string]bool

	// Cached API results to avoid duplicate calls
	ActualTeams []*github.Team
	ActualRepos []*github.Repository

	// Current state from GitHub
	CurrentTeams       int
	CurrentTeamMembers int
	CurrentRepos       int
	CurrentRepoPerms   int
	CurrentCustomRoles int
	CurrentRulesets    int
	CurrentOwners      int

	// Desired state from config
	DesiredTeams       int
	DesiredTeamMembers int
	DesiredRepos       int
	DesiredRepoPerms   int
	DesiredCustomRoles int
	DesiredRulesets    int
	DesiredOwners      int

	// RepoWarnings are advisories raised while planning repository settings.
	RepoWarnings []string
	// contains filtered or unexported fields
}

type TeamImportResult struct {
	// Teams holds teams the configuration does not declare, sorted by slug.
	Teams []ImportedTeam
	// Skipped lists teams that exist but could not be represented.
	Skipped []SkippedTeam
	// AlreadyDeclared counts teams skipped because a team file declares them.
	AlreadyDeclared int
	// Ungranted lists repositories in the organization that no team — declared
	// or imported — grants access to. They have no home in the configuration.
	Ungranted []string
	// WouldDelete is the subset of Ungranted the next sync would actually
	// delete: not named by repos.yaml, and not already archived. Both of those
	// are spared by planRepoCleanups, so naming them here would be a threat
	// gomgr does not carry out.
	WouldDelete []string
	// DeletionRisk is true when WouldDelete is non-empty and the configuration
	// would act on it — delete_unmanaged_repos set, and archive_unmanaged_repos
	// not, since archiving wins over deleting.
	DeletionRisk bool
}