forge

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

type CheckSummary struct {
	Passed int `json:"passed"`
	Total  int `json:"total"`
}

type Forge interface {
	Issues() IssueService
	Labels() LabelService
	PRs() PRService
}

type Issue struct {
	Number    int            `json:"number"`
	Title     string         `json:"title"`
	State     string         `json:"state"` // "open", "closed"
	Body      string         `json:"body"`
	Labels    []Label        `json:"labels"`
	Author    string         `json:"author"`
	CreatedAt time.Time      `json:"created_at"`
	UpdatedAt time.Time      `json:"updated_at"`
	URL       string         `json:"url"`
	Extras    map[string]any `json:"extras,omitempty"`
}

type IssueCloseOptions struct {
	Number int // issue number
}

type IssueCreateOptions struct {
	Title     *string  `json:"title,omitempty"` // required
	Body      *string  `json:"body,omitempty"`
	Labels    []string `json:"labels,omitempty"`
	Assignees []string `json:"assignees,omitempty"`
}

type IssueGetOptions struct {
	Number int // issue number
}

type IssueListOptions struct {
	State     string   // "open", "closed", "all"
	Labels    []string // filter by label names
	Sort      string   // "created", "updated", "comments"
	Direction string   // "asc", "desc"
	Limit     int      // max results per page
	Page      int      // page number (1-indexed)
}

type IssueReopenOptions struct {
	Number int // issue number
}

type IssueService interface {
	List(ctx context.Context, opts IssueListOptions) ([]Issue, *ListMeta, error)
	Get(ctx context.Context, opts IssueGetOptions) (*Issue, error)
	Create(ctx context.Context, opts IssueCreateOptions) (*Issue, error)
	Update(ctx context.Context, opts IssueUpdateOptions) (*Issue, error)
	Close(ctx context.Context, opts IssueCloseOptions) (*Issue, error)
	Reopen(ctx context.Context, opts IssueReopenOptions) (*Issue, error)
}

type IssueUpdateOptions struct {
	Number    int      // issue number
	Title     *string  `json:"title,omitempty"`
	Body      *string  `json:"body,omitempty"`
	State     *string  `json:"state,omitempty"` // "open" or "closed"
	Labels    []string `json:"labels,omitempty"`
	Assignees []string `json:"assignees,omitempty"`
}

type Label struct {
	Name        string         `json:"name"`
	Scope       string         `json:"scope,omitempty"` // empty for unscoped labels
	Color       string         `json:"color"`           // hex color without #
	Description string         `json:"description"`
	Exclusive   bool           `json:"exclusive"` // scoped labels: only one per scope
	Extras      map[string]any `json:"extras,omitempty"`
}

type LabelCreateOptions struct {
	Scope       *string `json:"scope,omitempty"` // scope prefix (nil for unscoped)
	Name        string  `json:"name"`            // label name (required)
	Color       *string `json:"color,omitempty"` // hex color without #
	Description *string `json:"description,omitempty"`
	Exclusive   *bool   `json:"exclusive,omitempty"` // only one label allowed per scope
}

type LabelDeleteOptions struct {
	Scope string // scope prefix (empty for unscoped)
	Name  string // label name
}

type LabelListOptions struct {
	Limit int // max results per page
	Page  int // page number (1-indexed)
}

type LabelService interface {
	List(ctx context.Context, opts LabelListOptions) ([]Label, error)
	Create(ctx context.Context, opts LabelCreateOptions) (*Label, error)
	Update(ctx context.Context, opts LabelUpdateOptions) (*Label, error)
	Delete(ctx context.Context, opts LabelDeleteOptions) error
}

type LabelUpdateOptions struct {
	Scope       string  // current scope
	Name        string  // current name
	NewName     *string `json:"new_name,omitempty"`
	NewScope    *string `json:"new_scope,omitempty"`
	Color       *string `json:"color,omitempty"`
	Description *string `json:"description,omitempty"`
	Exclusive   *bool   `json:"exclusive,omitempty"`
}

type ListMeta struct {
	Total int `json:"total"` // total number of items matching the query
	Count int `json:"count"` // number of items in this response
}

type PR struct {
	Number       int            `json:"number"`
	Title        string         `json:"title"`
	State        string         `json:"state"` // "open", "closed", "merged"
	Body         string         `json:"body"`
	BaseRef      string         `json:"base_ref"`        // target branch
	HeadRef      string         `json:"head_ref"`        // source branch
	Stack        string         `json:"stack,omitempty"` // stack name extracted from title prefix
	DependsOn    []int          `json:"depends_on"`      // PR numbers this depends on
	DependedOnBy []int          `json:"depended_on_by"`  // PR numbers that depend on this
	Reviewers    []ReviewState  `json:"reviewers,omitempty"`
	Checks       *CheckSummary  `json:"checks,omitempty"`
	Author       string         `json:"author"`
	CreatedAt    time.Time      `json:"created_at"`
	UpdatedAt    time.Time      `json:"updated_at"`
	URL          string         `json:"url"`
	Extras       map[string]any `json:"extras,omitempty"`
}

type PRCloseOptions struct {
	Number int // PR number
}

type PRCreateOptions struct {
	Title   *string `json:"title,omitempty"` // required
	Body    *string `json:"body,omitempty"`
	HeadRef *string `json:"head,omitempty"`  // source branch (default: current)
	BaseRef *string `json:"base,omitempty"`  // target branch (default: repo default)
	Stack   *string `json:"stack,omitempty"` // stack name; auto-derived from branch if nil
	Draft   *bool   `json:"draft,omitempty"`
}

type PRGetOptions struct {
	Number int // PR number
}

type PRListOptions struct {
	State     string // "open", "closed", "merged", "all"
	Sort      string // "created", "updated"
	Direction string // "asc", "desc"
	Limit     int    // max results per page
	Page      int    // page number (1-indexed)
}

type PRMergeOptions struct {
	Number int     // PR number
	Method *string `json:"merge_method,omitempty"` // "merge", "squash", "rebase"
	Title  *string `json:"title,omitempty"`
	Body   *string `json:"body,omitempty"`
}

type PRService interface {
	List(ctx context.Context, opts PRListOptions) ([]PR, *ListMeta, error)
	Get(ctx context.Context, opts PRGetOptions) (*PR, error)
	Create(ctx context.Context, opts PRCreateOptions) (*PR, error)
	Update(ctx context.Context, opts PRUpdateOptions) (*PR, error)
	Merge(ctx context.Context, opts PRMergeOptions) (*PR, error)
	Close(ctx context.Context, opts PRCloseOptions) (*PR, error)
}

type PRUpdateOptions struct {
	Number int     // PR number
	Title  *string `json:"title,omitempty"`
}

type ReviewState struct {
	Login string `json:"login"`
	State string `json:"state"` // APPROVED, CHANGES_REQUESTED, COMMENTED, PENDING
}

type StructuredError interface {
	error
	// Message returns the user-facing error message.
	Message() string
	// Help returns an optional corrective action hint, or "".
	Help() string
}