// Package service provides business logic services. package service import ( "context" "fmt" "log/slog" "github.com/orchard9/rdev/internal/port" "github.com/orchard9/rdev/internal/webhook" ) // WorkService orchestrates work queue operations. // It coordinates task enqueueing, completion, and webhook notifications. type WorkService struct { queue port.WorkQueue webhookDispatcher *webhook.Dispatcher logger *slog.Logger } // WorkServiceConfig configures the work service. type WorkServiceConfig struct { Logger *slog.Logger } // NewWorkService creates a new work service. func NewWorkService(queue port.WorkQueue, cfg WorkServiceConfig) *WorkService { logger := cfg.Logger if logger == nil { logger = slog.Default() } return &WorkService{ queue: queue, logger: logger, } } // WithWebhookDispatcher adds a webhook dispatcher for task completion notifications. func (s *WorkService) WithWebhookDispatcher(dispatcher *webhook.Dispatcher) *WorkService { s.webhookDispatcher = dispatcher return s } // EnqueueTask adds a new task to the work queue. func (s *WorkService) EnqueueTask(ctx context.Context, req EnqueueTaskRequest) (*EnqueueTaskResult, error) { // Validate required fields if req.ProjectID == "" { return nil, fmt.Errorf("project_id is required") } if req.Type == "" { return nil, fmt.Errorf("task_type is required") } // Set defaults maxRetries := req.MaxRetries if maxRetries == 0 { maxRetries = 3 } task := &port.WorkTask{ ProjectID: req.ProjectID, Type: req.Type, Spec: req.Spec, Priority: req.Priority, CallbackURL: req.CallbackURL, MaxRetries: maxRetries, } taskID, err := s.queue.Enqueue(ctx, task) if err != nil { return nil, fmt.Errorf("enqueue task: %w", err) } s.logger.Info("task enqueued", "task_id", taskID, "project", req.ProjectID, "type", req.Type, "priority", req.Priority, ) return &EnqueueTaskResult{ TaskID: taskID, StatusURL: fmt.Sprintf("/work/%s/status", taskID), }, nil } // DequeueTask claims the next available task for a worker. func (s *WorkService) DequeueTask(ctx context.Context, workerID string) (*port.WorkTask, error) { if workerID == "" { return nil, fmt.Errorf("worker_id is required") } task, err := s.queue.Dequeue(ctx, workerID) if err != nil { return nil, fmt.Errorf("dequeue task: %w", err) } if task != nil { s.logger.Info("task claimed by worker", "task_id", task.ID, "worker_id", workerID, "project", task.ProjectID, "type", task.Type, ) } return task, nil } // CompleteTask marks a task as successfully completed. func (s *WorkService) CompleteTask(ctx context.Context, taskID string, result *port.WorkResult) error { // Get task for callback URL before completing task, err := s.queue.GetTask(ctx, taskID) if err != nil { return fmt.Errorf("get task: %w", err) } if err := s.queue.Complete(ctx, taskID, result); err != nil { return fmt.Errorf("complete task: %w", err) } s.logger.Info("task completed", "task_id", taskID, "project", task.ProjectID, "type", task.Type, ) // Send webhook notification if callback URL is set if task.CallbackURL != "" { s.notifyCallback(task, "completed", result, "") } return nil } // FailTask marks a task as failed. func (s *WorkService) FailTask(ctx context.Context, taskID string, errMsg string) error { // Get task for callback URL before failing task, err := s.queue.GetTask(ctx, taskID) if err != nil { return fmt.Errorf("get task: %w", err) } if err := s.queue.Fail(ctx, taskID, errMsg); err != nil { return fmt.Errorf("fail task: %w", err) } // Check if it was requeued or permanently failed updatedTask, _ := s.queue.GetTask(ctx, taskID) if updatedTask != nil && updatedTask.Status == port.WorkTaskStatusFailed { s.logger.Warn("task failed permanently", "task_id", taskID, "project", task.ProjectID, "type", task.Type, "error", errMsg, "retry_count", task.RetryCount, ) // Send webhook notification for permanent failure if task.CallbackURL != "" { s.notifyCallback(task, "failed", nil, errMsg) } } else { s.logger.Warn("task failed, will retry", "task_id", taskID, "project", task.ProjectID, "type", task.Type, "error", errMsg, "retry_count", task.RetryCount+1, ) } return nil } // CancelTask cancels a pending task. func (s *WorkService) CancelTask(ctx context.Context, taskID string) error { task, err := s.queue.GetTask(ctx, taskID) if err != nil { return fmt.Errorf("get task: %w", err) } if err := s.queue.Cancel(ctx, taskID); err != nil { return err } s.logger.Info("task cancelled", "task_id", taskID, "project", task.ProjectID, "type", task.Type, ) // Send webhook notification if task.CallbackURL != "" { s.notifyCallback(task, "cancelled", nil, "Task cancelled by user") } return nil } // GetTask retrieves a task by ID. func (s *WorkService) GetTask(ctx context.Context, taskID string) (*port.WorkTask, error) { return s.queue.GetTask(ctx, taskID) } // ListByProject returns tasks for a project with pagination. func (s *WorkService) ListByProject(ctx context.Context, projectID string, status *port.WorkTaskStatus, opts port.WorkListOptions) (*port.WorkListResult, error) { return s.queue.ListByProject(ctx, projectID, status, opts) } // GetStats returns queue statistics. func (s *WorkService) GetStats(ctx context.Context) (*port.WorkQueueStats, error) { return s.queue.GetStats(ctx) } // notifyCallback sends a webhook notification for task status changes. func (s *WorkService) notifyCallback(task *port.WorkTask, status string, result *port.WorkResult, errMsg string) { if s.webhookDispatcher == nil || task.CallbackURL == "" { return } payload := map[string]any{ "task_id": task.ID, "project_id": task.ProjectID, "task_type": string(task.Type), "status": status, } if result != nil { payload["result"] = result } if errMsg != "" { payload["error"] = errMsg } // Dispatch webhook asynchronously go func() { if err := s.webhookDispatcher.DispatchToURL(task.CallbackURL, "work."+status, payload); err != nil { s.logger.Error("failed to send callback", "task_id", task.ID, "callback_url", task.CallbackURL, "error", err, ) } }() } // EnqueueTaskRequest contains parameters for enqueueing a task. type EnqueueTaskRequest struct { // ProjectID is the project this task belongs to. ProjectID string `json:"project_id"` // Type is the task type (build, test, deploy, custom). Type port.WorkTaskType `json:"task_type"` // Spec contains task-specific parameters. Spec map[string]any `json:"task_spec"` // Priority determines execution order (higher = more urgent). Priority int `json:"priority,omitempty"` // CallbackURL is the webhook URL for completion notification. CallbackURL string `json:"callback_url,omitempty"` // MaxRetries is the maximum allowed retry attempts (default: 3). MaxRetries int `json:"max_retries,omitempty"` } // EnqueueTaskResult contains the result of enqueueing a task. type EnqueueTaskResult struct { // TaskID is the unique task identifier. TaskID string `json:"task_id"` // StatusURL is the URL to check task status. StatusURL string `json:"status_url"` }