workflows

type CategorizeFilesInput struct {
	Files []FileChange // List of files to categorize
}

type CategorizedFiles struct {
	CodeFiles   []string // Files that affect plugin behavior
	PluginFiles []string // Files in .claude-plugin/
	OtherFiles  []string // Other files (tests, docs, etc.)
}

type DocumentationValidationInput struct {
	Owner       string   // Repository owner
	Repo        string   // Repository name
	PRNumber    int      // Pull request number
	HeadSHA     string   // Commit SHA
	CodeFiles   []string // List of code files changed
	PluginFiles []string // List of plugin files changed
}

type DocumentationValidationResult struct {
	Valid          bool              `json:"valid"`                    // Whether documentation is valid
	Summary        string            `json:"summary"`                  // Summary of validation
	FilesReviewed  int               `json:"files_reviewed,omitempty"` // Number of files reviewed
	CriticalIssues []ValidationIssue `json:"critical_issues"`          // Critical issues found
	HighIssues     []ValidationIssue `json:"high_issues"`              // High priority issues
	MediumIssues   []ValidationIssue `json:"medium_issues"`            // Medium priority issues
	LowIssues      []ValidationIssue `json:"low_issues"`               // Low priority issues
}

type ErrorSeverity string

type FetchFileContentInput struct {
	Owner       string        // Repository owner
	Repo        string        // Repository name
	Path        string        // File path (restricted to allowed paths)
	Ref         string        // Commit SHA or branch name
	GitHubToken config.Secret // GitHub API token
}

type FetchPRFilesInput struct {
	Owner       string        // Repository owner
	Repo        string        // Repository name
	PRNumber    int           // Pull request number
	GitHubToken config.Secret // GitHub API token
}

type FileChange struct {
	Path      string // File path relative to repository root
	Status    string // "added", "modified", "removed", "renamed"
	Additions int    // Number of lines added
	Deletions int    // Number of lines deleted
}

type GitHubClientConfig struct {
	Token config.Secret // GitHub API token
}

type PluginUpdateValidationConfig struct {
	Owner              string        // GitHub repository owner
	Repo               string        // GitHub repository name
	PRNumber           int           // Pull request number
	BaseBranch         string        // Base branch (usually "main")
	HeadBranch         string        // PR branch
	HeadSHA            string        // PR commit SHA
	GitHubToken        config.Secret // GitHub API token for activities
	UseAgentValidation bool          // Whether to use AI agent for documentation validation
}

type PluginUpdateValidationResult struct {
	CodeFilesChanged   []string                       // Files that affect plugin behavior
	PluginFilesChanged []string                       // Files in .claude-plugin/
	NeedsUpdate        bool                           // Whether plugin needs updating
	SchemaValid        bool                           // Whether schemas are valid JSON
	AgentValidation    *DocumentationValidationResult // Agent validation results (if enabled)
	AgentValidationRan bool                           // Whether agent validation was executed
	CommentPosted      bool                           // Whether we posted a comment
	CommentURL         string                         // URL of posted comment
	Errors             []string                       // Any errors encountered
}

type PostCommentInput struct {
	Owner           string                         // Repository owner
	Repo            string                         // Repository name
	PRNumber        int                            // Pull request number
	CodeFiles       []string                       // List of code files changed
	PluginFiles     []string                       // List of plugin files changed
	GitHubToken     config.Secret                  // GitHub API token
	AgentValidation *DocumentationValidationResult // Optional agent validation results
}

type PostCommentResult struct {
	URL string // URL of the posted or updated comment
}

type PostVersionCommentInput struct {
	Owner         string        // Repository owner
	Repo          string        // Repository name
	PRNumber      int           // Pull request number
	VersionFile   string        // Version from VERSION file
	PluginVersion string        // Version from plugin.json
	GitHubToken   config.Secret // GitHub API token
}

type RetryConfig struct {
	// MaxRetries is the maximum number of retry attempts.
	// Default: 3
	MaxRetries int

	// InitialBackoff is the initial backoff duration.
	// Default: 1 second
	InitialBackoff time.Duration

	// MaxBackoff is the maximum backoff duration.
	// Default: 30 seconds
	MaxBackoff time.Duration

	// BackoffMultiplier is the multiplier for exponential backoff.
	// Default: 2
	BackoffMultiplier float64
}

type SchemaValidationResult struct {
	Valid  bool     // Whether the schema is valid
	Errors []string // Validation errors, if any
}

type ValidateSchemasInput struct {
	Owner       string        // Repository owner
	Repo        string        // Repository name
	HeadSHA     string        // Commit SHA to validate
	FilePath    string        // Path to schema file
	GitHubToken config.Secret // GitHub API token
}

type ValidationIssue struct {
	File     string `json:"file"`                // File path
	Line     int    `json:"line,omitempty"`      // Line number (if applicable)
	Severity string `json:"severity,omitempty"`  // Issue severity
	Issue    string `json:"issue"`               // Description of the issue
	Current  string `json:"current,omitempty"`   // Current value/state
	ShouldBe string `json:"should_be,omitempty"` // Expected value/state
	Fix      string `json:"fix"`                 // How to fix the issue
	Impact   string `json:"impact,omitempty"`    // Impact description
}

type VersionValidationConfig struct {
	Owner       string        // GitHub repository owner
	Repo        string        // GitHub repository name
	PRNumber    int           // Pull request number
	HeadSHA     string        // PR commit SHA
	GitHubToken config.Secret // GitHub API token for activities
}

type VersionValidationResult struct {
	VersionMatches bool     // Whether VERSION file matches plugin.json
	VersionFile    string   // Version from VERSION file
	PluginVersion  string   // Version from plugin.json
	CommentPosted  bool     // Whether we posted a comment
	CommentURL     string   // URL of posted comment
	Errors         []string // Any errors encountered
}

type WorkflowError struct {
	Operation string        // The operation that failed (e.g., "fetch_version_file", "validate_schema")
	Severity  ErrorSeverity // How severe the error is
	Err       error         // The underlying error
	Context   string        // Additional context about the error
}