validate

type CheckResult ¶

type CheckResult struct {
	Name   string
	Status Status
	Detail string
}

CheckResult is one row of a Report.

type EntryResult ¶

type EntryResult struct {
	Entry   mappings.Entry
	Reports []Report
}

EntryResult bundles every report produced for a single mapping entry, so callers can update the lock per-entry: an entry is "validated" only when every report it produced is OK.

func RunForEntries(
	ctx context.Context,
	entries []mappings.Entry,
	lister OrgRepoLister,
	v RepoValidator,
) []EntryResult

func (r EntryResult) OK() bool

type GitHubChecker ¶

type GitHubChecker interface {
	ListHookEvents(ctx context.Context, owner, repo, urlSuffix string) ([]string, error)
}

GitHubChecker exposes the GitHub endpoints the validator needs.

ListHookEvents returns the union of events configured across active webhooks whose target URL matches urlSuffix, or an empty slice when no such hook exists. Implementations should not error when no hook matches — "no hook" is a validation outcome, not a transport failure.

type MappingLookup ¶

type MappingLookup interface {
	Get(ctx context.Context, repository string) (store.RepoMapping, error)
	PathChannels(repository string) []string
}

MappingLookup reads a single repository → channel mapping. The runner iterates entries explicitly (see RunForEntries), so no bulk-list method is needed here. PathChannels returns the extra channels a repo's per-path routing can post to, so the validator can confirm bot membership in each (empty for repos without `paths:`).

type OrgRepoLister ¶

type OrgRepoLister interface {
	ListOrgRepos(ctx context.Context, org string) ([]string, error)
}

OrgRepoLister enumerates a GitHub org's repositories. Used to expand "*" at validate time. May be nil; the runner reports a skip in that case.

type RepoValidator ¶

type RepoValidator interface {
	Validate(ctx context.Context, repository string) Report
}

RepoValidator validates one repository at a time. *Validator satisfies it; the runner depends on this narrow surface so wildcard expansion can be tested without standing up real Slack/GitHub clients.

type Report ¶

type Report struct {
	Repository string
	Checks     []CheckResult
}

Report aggregates the per-check results for a single mapping.

func (r Report) OK() bool

type SlackChecker ¶

type SlackChecker interface {
	AuthTest(ctx context.Context) (userID string, scopes []string, err error)
	ConversationsInfo(ctx context.Context, channel string) (slack.ChannelInfo, error)
}

SlackChecker exposes the Slack endpoints the validator needs.

type Status ¶

type Status int

Status is the outcome of a single check.

const (
	// StatusOK means the check passed.
	StatusOK Status = iota
	// StatusFail means the check found a problem the operator must fix.
	StatusFail
	// StatusSkip means the check could not run (e.g., GitHub token absent).
	StatusSkip
)

func (s Status) String() string

type Validator ¶

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

Validator runs the per-mapping checks. Construct with NewValidator; the GitHubChecker may be nil, in which case webhook coverage is reported as skipped.

func NewValidator(m MappingLookup, s SlackChecker, gh GitHubChecker) *Validator

func (v *Validator) Validate(ctx context.Context, repository string) Report