githubobserver

type CommandResponse struct {
	Stdout   []byte
	Stderr   []byte
	ExitCode int
	Err      error
}

type GetRequest struct {
	Dir         string
	Repository  string
	Target      string
	Head        string
	Endpoint    string
	Query       map[string]string
	Accept      string
	FreshWindow time.Duration
	Progress    progress.Reporter
}

type Observer struct {
	StateDir    string
	Now         func() time.Time
	Sleep       func(context.Context, time.Duration) error
	RandomIntn  func(int64) int64
	Run         func(context.Context, string, ...string) commandResult
	MaxAttempts int
	BaseBackoff time.Duration
	MaxBackoff  time.Duration
	// MinAPIAttemptTimeout floors the per-attempt exec timeout for `gh api`
	// and `gh pr view` commands. Defaults to defaultMinAPIAttemptTimeout (30s)
	// when unset; never applied when the caller's own context already carries
	// an explicit deadline, which remains authoritative.
	MinAPIAttemptTimeout time.Duration
	// MaxRetryElapsed caps the total wall-clock time spent retrying a single
	// GitHub read across all attempts. Defaults to defaultMaxRetryElapsed
	// (45s) when unset.
	MaxRetryElapsed time.Duration
}

type Reader struct {
	Get     func(ctx context.Context, request GetRequest) (Response, error)
	Read    func(ctx context.Context, dir string, args ...string) ([]byte, error)
	Execute func(ctx context.Context, dir string, args ...string) CommandResponse
}

type Response struct {
	Body        []byte
	StatusCode  int
	Headers     map[string]string
	Cached      bool
	ObservedAt  time.Time
	CacheKey    string
	RequestHash string
}

type RetryTelemetry struct {
	Count      int
	LastReason string
}