pm

type AddCommentRequest struct {
	IssueID string `json:"issue_id" jsonschema:"description=Issue ID to comment on,required"`
	Body    string `json:"body" jsonschema:"description=Comment body text,required"`
}

type AddLabelRequest struct {
	IssueID string `json:"issue_id" jsonschema:"description=Issue ID,required"`
	LabelID string `json:"label_id" jsonschema:"description=Label ID to add (use pm_list_labels to discover),required"`
}

type AssignIssueRequest struct {
	ID       string `json:"id" jsonschema:"description=Issue ID,required"`
	Assignee string `json:"assignee" jsonschema:"description=User to assign to,required"`
}

type Comment struct {
	ID     string `json:"id"`
	Body   string `json:"body"`
	Author string `json:"author,omitempty"`
}

type Config struct {
	Provider string `yaml:"provider,omitempty" toml:"provider,omitempty"` // jira, linear, asana
	APIToken string `yaml:"api_token,omitempty" toml:"api_token,omitempty"`
	BaseURL  string `yaml:"base_url,omitempty" toml:"base_url,omitempty"` // Jira: required; Linear/Asana: optional override
	Email    string `yaml:"email,omitempty" toml:"email,omitempty"`       // Jira only: email for Basic auth
}

type CreateIssueRequest struct {
	Title       string `json:"title" jsonschema:"description=Issue Title,required"`
	Description string `json:"description" jsonschema:"description=Issue Description"`
	Project     string `json:"project" jsonschema:"description=Project Key/ID,required"`
	Type        string `json:"type" jsonschema:"description=Issue Type (Bug Task Story),required"`
}

type GetIssueRequest struct {
	ID string `json:"id" jsonschema:"description=Issue ID (e.g. PROJ-123),required"`
}

type Issue struct {
	ID          string   `json:"id"`
	Title       string   `json:"title"`
	Description string   `json:"description,omitempty"`
	Status      string   `json:"status,omitempty"`
	Assignee    string   `json:"assignee,omitempty"`
	Labels      []string `json:"labels,omitempty"`
}

type IssueFilter struct {
	Status string // optional: filter by status (e.g. "open", "in_progress", "closed")
}

type IssueInput struct {
	Title       string
	Description string
	Project     string
	Type        string
}

type IssueUpdate struct {
	Title       *string // nil = no change
	Description *string
	Status      *string // workflow state name (e.g. "In Progress", "Done")
}

type Label struct {
	ID    string `json:"id"`
	Name  string `json:"name"`
	Color string `json:"color,omitempty"`
}

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

type ListCommentsRequest struct {
	IssueID string `json:"issue_id" jsonschema:"description=Issue ID to list comments for,required"`
}

type ListIssuesRequest struct {
	Status string `json:"status" jsonschema:"description=Optional status filter: open or closed. Defaults to open."`
}

type ListLabelsRequest struct {
	TeamID string `json:"team_id" jsonschema:"description=Team ID to list labels for (use pm_list_teams to discover),required"`
}

type ListTeamsRequest struct{}

type ListUsersRequest struct{}

type SearchIssuesRequest struct {
	Query string `json:"query" jsonschema:"description=Free-text search query,required"`
}

type Service interface {
	// Supported returns the list of operation names this provider implements.
	Supported() []string

	// Validate performs a lightweight health check to verify that the
	// provider's token is valid and the endpoint is reachable.
	Validate(ctx context.Context) error

	GetIssue(ctx context.Context, id string) (*Issue, error)
	ListIssues(ctx context.Context, filter IssueFilter) ([]*Issue, error)
	CreateIssue(ctx context.Context, input IssueInput) (*Issue, error)
	AssignIssue(ctx context.Context, id string, assignee string) error
	UpdateIssue(ctx context.Context, id string, update IssueUpdate) (*Issue, error)
	AddComment(ctx context.Context, issueID string, body string) (*Comment, error)
	ListComments(ctx context.Context, issueID string) ([]*Comment, error)
	SearchIssues(ctx context.Context, query string) ([]*Issue, error)
	ListTeams(ctx context.Context) ([]*Team, error)
	ListLabels(ctx context.Context, teamID string) ([]*Label, error)
	AddLabel(ctx context.Context, issueID string, labelID string) error
	ListUsers(ctx context.Context) ([]*User, error)
}

type Team struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	Key  string `json:"key,omitempty"`
}

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

type UpdateIssueRequest struct {
	ID          string  `json:"id" jsonschema:"description=Issue ID,required"`
	Title       *string `json:"title" jsonschema:"description=New title (omit to keep current)"`
	Description *string `json:"description" jsonschema:"description=New description (omit to keep current)"`
	Status      *string `json:"status" jsonschema:"description=New status/state name e.g. In Progress or Done (omit to keep current)"`
}

type User struct {
	ID    string `json:"id"`
	Name  string `json:"name"`
	Email string `json:"email,omitempty"`
}