docsgates

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

type BridgeConfig struct {
	// Store enqueues fix tasks and owns the watermark row. Required.
	Store queue.Store
	// Runner assesses a repo. nil selects the binary runner (Bin).
	Runner Runner
	// Bin is the docs-gates binary (PATH name or absolute) for the
	// default runner.
	Bin string
	// Timeout bounds one repo run; 0 selects the default.
	Timeout time.Duration
	// Repos are the assessed pool repos.
	Repos []Repo
	// Priority mints fix tasks; 0 selects the default (machine band).
	Priority int
	// MaxAttempts bounds minted fix tasks; 0 selects the default.
	MaxAttempts int
	// Log receives mint/skip lines. nil logs nothing.
	Log *slog.Logger
}

type Gate struct {
	Name    string `json:"name"`
	Verdict string `json:"verdict"`
	Skipped bool   `json:"skipped"`
}

type Repo struct {
	// Name is the project key (dedup identity, AgentPayload.Repo resolved
	// against the pool's projects dir).
	Name string
	// Dir is the working directory the binary runs in. Empty means the
	// name resolves against the executor's ProjectsDir as-is.
	Dir string
}

type RunResult struct {
	Pass  bool   `json:"pass"`
	Gates []Gate `json:"gates"`
}

type Runner func(ctx context.Context, repo Repo) (RunResult, error)

type Stats struct {
	// Repos is the number of repos assessed.
	Repos int
	// Failed counts gates that FAILed (the mint candidates).
	Failed int
	// Minted counts fresh fix tasks enqueued.
	Minted int
	// Known counts mints whose task already existed (dedup hit).
	Known int
	// Skipped counts SKIPped gates (not assessed this run — never minted).
	Skipped int
}