SCM-projects contract lock (shared wire types)¶

// WebhookEvent additions (scm.go)
type WebhookEvent struct {
    Kind     string // push|issue|mr|other  (unchanged)
    Repo     string
    Branch   string
    Labels   []string
    Title    string
    Body     string
    IssueRef string
    URL      string
    // NEW:
    AuthorLogin  string // login of the issue/PR/MR author (board identity)
    Action       string // opened|labeled|unlabeled|closed|synchronize|submitted|created|other
    Number       int    // issue/PR/MR number (github) or iid (gitlab)
    IsPR         bool   // true for mr/pull_request events
    HeadSHA      string // PR/MR head commit (for CI lookup)
    HeadBranch   string // PR/MR source branch (for selfImprove push target)
    ChangedLabel string // for labeled/unlabeled: the single label added/removed
}

type IssueReq struct {
    Title  string
    Body   string
    Labels []string
}
type IssueRef struct {
    Ref string // owner/repo#n (github) or group/proj#iid (gitlab)
    URL string // html/web url
}
type PRState struct {
    Author     string
    HeadSHA    string
    HeadBranch string
    Mergeable  bool
    CIStatus   string // "" none | pending | success | failure
}
type Suggestion struct {
    Path string
    Line int
    Body string
}

// SCMWriter is what controller.SCMFor returns; *GitHub and *GitLab satisfy it.
// Embeds the existing 2 write methods plus the new capability sets.
type SCMWriter interface {
    OpenChange(ctx, repoURL, token, sourceBranch, targetBranch, title, body string) (string, error)
    Comment(ctx, token, issueRef, body string) error
    // IssueAuthor:
    CreateIssue(ctx, repoURL, token string, req IssueReq) (IssueRef, error)
    AddLabel(ctx, token, issueRef, label string) error
    RemoveLabel(ctx, token, issueRef, label string) error
    // Reviewer:
    GetPRState(ctx, repoURL, token string, number int) (PRState, error)
    Approve(ctx, repoURL, token string, number int, body string) error
    RequestChanges(ctx, repoURL, token string, number int, body string) error
    Suggest(ctx, repoURL, token string, number int, sugg []Suggestion) error
    Merge(ctx, repoURL, token string, number int, method string) error
    ClosePR(ctx, repoURL, token string, number int, body string) error
    // BoardManager:
    AddBoardItem(ctx, token string, board BoardRef, itemURL string) error
    SetBoardColumn(ctx, token string, board BoardRef, itemURL, column string) error
}

type BoardRef struct {
    Provider            string
    Owner               string
    GitHubProjectNumber int
    GitLabBoardID       int
    StatusField         string // GH single-select field; default "Status"
}

// project_types.go
type BoardSpec struct {
    GitHubProjectNumber int    `json:"githubProjectNumber,omitempty"`
    GitLabBoardID       int    `json:"gitlabBoardId,omitempty"`
    // +kubebuilder:default="Status"
    StatusField         string `json:"statusField,omitempty"`
}
type ScmSpec struct {
    // +kubebuilder:validation:Enum=github;gitlab
    Provider string `json:"provider"`
    Owner    string `json:"owner"`
    BotLogin string `json:"botLogin"`
    // +optional
    Board *BoardSpec `json:"board,omitempty"`
    // +kubebuilder:validation:Enum=afterApproval;autoMergeOnGreenCI
    // +kubebuilder:default="afterApproval"
    MergePolicy string `json:"mergePolicy,omitempty"`
    // +kubebuilder:validation:Enum=labeledOrMentioned;all
    // +kubebuilder:default="labeledOrMentioned"
    PRReactionScope string `json:"prReactionScope,omitempty"`
    // +kubebuilder:default="tatara/awaiting-approval"
    ApprovalLabel string `json:"approvalLabel,omitempty"`
}
// ProjectSpec gains:  Scm *ScmSpec `json:"scm,omitempty"`   (+optional)

// task_types.go
type ProposedIssueSpec struct {
    RepositoryRef string `json:"repositoryRef"`
    Title         string `json:"title"`
    Body          string `json:"body"`
    // +kubebuilder:validation:Enum=bug;improvement
    Kind string `json:"kind"`
}
type Suggestion struct {
    Path string `json:"path"`
    Line int    `json:"line"`
    Body string `json:"body"`
}
type ReviewVerdict struct {
    // +kubebuilder:validation:Enum=approve;request_changes;comment
    Decision    string       `json:"decision"`
    Body        string       `json:"body,omitempty"`
    Suggestions []Suggestion `json:"suggestions,omitempty"`
}
type PROutcome struct {
    // +kubebuilder:validation:Enum=merge;close
    Action string `json:"action"`
    Reason string `json:"reason,omitempty"`
}
// TaskSource gains:
//   AuthorLogin string `json:"authorLogin,omitempty"`
//   IsPR        bool   `json:"isPR,omitempty"`
//   Number      int    `json:"number,omitempty"`
// TaskSpec gains:
//   // +kubebuilder:validation:Enum=implement;review;selfImprove
//   // +kubebuilder:default="implement"
//   Kind             string             `json:"kind,omitempty"`
//   ApprovalRequired bool               `json:"approvalRequired,omitempty"`
//   ProposedIssue    *ProposedIssueSpec `json:"proposedIssue,omitempty"`
// TaskStatus.Phase enum becomes: Pending;AwaitingApproval;Planning;Running;Succeeded;Failed
// TaskStatus gains:
//   DiscoveredIssues []string       `json:"discoveredIssues,omitempty"`
//   ReviewVerdict    *ReviewVerdict `json:"reviewVerdict,omitempty"`
//   PROutcome        *PROutcome     `json:"prOutcome,omitempty"`
// New condition type constant: "ApprovalApproved"