Documentation
¶
Overview ¶
markdown.go provides Markdown formatting functions for merge train MCP tool output.
Package mergetrains implements MCP tool handlers for GitLab merge trains.
register.go wires merge train MCP tools to the MCP server.
Index ¶
- func FormatListMarkdown(out ListOutput) string
- func FormatOutputMarkdown(out Output) string
- func RegisterTools(server *mcp.Server, client *gitlabclient.Client)
- type AddInput
- type GetInput
- type ListBranchInput
- type ListOutput
- func AddMergeRequestToMergeTrain(ctx context.Context, client *gitlabclient.Client, input AddInput) (ListOutput, error)
- func ListMergeRequestInMergeTrain(ctx context.Context, client *gitlabclient.Client, input ListBranchInput) (ListOutput, error)
- func ListProjectMergeTrains(ctx context.Context, client *gitlabclient.Client, input ListProjectInput) (ListOutput, error)
- type ListProjectInput
- type MergeRequestOutput
- type Output
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func FormatListMarkdown ¶
func FormatListMarkdown(out ListOutput) string
FormatListMarkdown formats a list of merge train entries.
func FormatOutputMarkdown ¶
FormatOutputMarkdown formats a single merge train entry.
func RegisterTools ¶
func RegisterTools(server *mcp.Server, client *gitlabclient.Client)
RegisterTools registers individual merge train tools.
Types ¶
type AddInput ¶
type AddInput struct {
ProjectID toolutil.StringOrInt `json:"project_id" jsonschema:"Project ID or URL-encoded path,required"`
MergeRequestID int64 `json:"merge_request_iid" jsonschema:"Merge request internal ID,required"`
AutoMerge bool `json:"auto_merge,omitempty" jsonschema:"Enable auto-merge when pipeline succeeds"`
SHA string `json:"sha,omitempty" jsonschema:"Head SHA of the merge request to verify"`
Squash bool `json:"squash,omitempty" jsonschema:"Squash commits when merging"`
}
AddInput defines parameters for adding a merge request to a merge train.
type GetInput ¶
type GetInput struct {
ProjectID toolutil.StringOrInt `json:"project_id" jsonschema:"Project ID or URL-encoded path,required"`
MergeRequestID int64 `json:"merge_request_iid" jsonschema:"Merge request internal ID,required"`
}
GetInput defines parameters for getting a merge request on a merge train.
type ListBranchInput ¶
type ListBranchInput struct {
ProjectID toolutil.StringOrInt `json:"project_id" jsonschema:"Project ID or URL-encoded path,required"`
TargetBranch string `json:"target_branch" jsonschema:"Target branch name,required"`
Scope string `json:"scope,omitempty" jsonschema:"Filter by scope: active, complete"`
Sort string `json:"sort,omitempty" jsonschema:"Sort order: asc or desc"`
toolutil.PaginationInput
}
ListBranchInput defines parameters for listing MRs in a merge train for a specific branch.
type ListOutput ¶
type ListOutput struct {
toolutil.HintableOutput
Trains []Output `json:"trains"`
Pagination toolutil.PaginationOutput `json:"pagination"`
}
ListOutput wraps a list of merge train entries.
func AddMergeRequestToMergeTrain ¶
func AddMergeRequestToMergeTrain(ctx context.Context, client *gitlabclient.Client, input AddInput) (ListOutput, error)
AddMergeRequestToMergeTrain adds a merge request to a merge train.
func ListMergeRequestInMergeTrain ¶
func ListMergeRequestInMergeTrain(ctx context.Context, client *gitlabclient.Client, input ListBranchInput) (ListOutput, error)
ListMergeRequestInMergeTrain lists merge requests in a merge train for a branch.
func ListProjectMergeTrains ¶
func ListProjectMergeTrains(ctx context.Context, client *gitlabclient.Client, input ListProjectInput) (ListOutput, error)
ListProjectMergeTrains lists all merge trains for a project.
type ListProjectInput ¶
type ListProjectInput struct {
ProjectID toolutil.StringOrInt `json:"project_id" jsonschema:"Project ID or URL-encoded path,required"`
Scope string `json:"scope,omitempty" jsonschema:"Filter by scope: active, complete"`
Sort string `json:"sort,omitempty" jsonschema:"Sort order: asc or desc"`
toolutil.PaginationInput
}
ListProjectInput defines parameters for listing project merge trains.
type MergeRequestOutput ¶
type MergeRequestOutput struct {
ID int64 `json:"id"`
IID int64 `json:"iid"`
ProjectID int64 `json:"project_id"`
Title string `json:"title"`
State string `json:"state"`
WebURL string `json:"web_url,omitempty"`
CreatedAt string `json:"created_at,omitempty"`
UpdatedAt string `json:"updated_at,omitempty"`
}
MergeRequestOutput represents the MR embedded in a merge train entry.
type Output ¶
type Output struct {
toolutil.HintableOutput
ID int64 `json:"id"`
MergeRequest MergeRequestOutput `json:"merge_request"`
User string `json:"user,omitempty"`
PipelineID int64 `json:"pipeline_id,omitempty"`
TargetBranch string `json:"target_branch"`
Status string `json:"status"`
Duration int64 `json:"duration"`
CreatedAt string `json:"created_at,omitempty"`
UpdatedAt string `json:"updated_at,omitempty"`
MergedAt string `json:"merged_at,omitempty"`
}
Output represents a merge train entry.
func GetMergeRequestOnMergeTrain ¶
func GetMergeRequestOnMergeTrain(ctx context.Context, client *gitlabclient.Client, input GetInput) (Output, error)
GetMergeRequestOnMergeTrain gets the merge train status for a specific MR.
Source Files