Changeset 0.37.15 (#227)

server/handlers/workflow_assignments.go

@@ -123,6 +123,169 @@ func (h *WorkflowAssignmentHandler) Complete(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"completed": true, "assignment_id": assignmentID})
 }
 
+// ── Lifecycle operations (v0.37.15) ──
+
+// Unclaim returns a claimed assignment to unassigned.
+// POST /api/v1/workflow-assignments/:id/unclaim
+func (h *WorkflowAssignmentHandler) Unclaim(c *gin.Context) {
+	assignmentID := c.Param("id")
+	userID := c.GetString("user_id")
+	role, _ := c.Get("role")
+
+	// Auth: claimer or team admin or global admin
+	a, err := h.stores.Workflows.GetAssignmentByID(c.Request.Context(), assignmentID)
+	if err != nil || a == nil {
+		c.JSON(http.StatusNotFound, gin.H{"error": "assignment not found"})
+		return
+	}
+
+	if role != "admin" && (a.AssignedTo == nil || *a.AssignedTo != userID) {
+		isTA := false
+		if h.stores.Teams != nil {
+			isTA, _ = h.stores.Teams.IsTeamAdmin(c.Request.Context(), a.TeamID, userID)
+		}
+		if !isTA {
+			c.JSON(http.StatusForbidden, gin.H{"error": "only the claimer or a team admin can unclaim"})
+			return
+		}
+	}
+
+	n, err := h.stores.Workflows.UnclaimAssignment(c.Request.Context(), assignmentID)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to unclaim assignment"})
+		return
+	}
+	if n == 0 {
+		c.JSON(http.StatusConflict, gin.H{"error": "assignment not in claimed state"})
+		return
+	}
+
+	// Emit WS event
+	channelID, _ := h.stores.Workflows.GetAssignmentChannelID(c.Request.Context(), assignmentID)
+	if h.hub != nil && channelID != "" {
+		payload, _ := json.Marshal(map[string]any{
+			"assignment_id": assignmentID,
+			"unclaimed_by":  userID,
+			"channel_id":    channelID,
+		})
+		evt := events.Event{
+			Label:   "workflow.unclaimed",
+			Payload: payload,
+			Ts:      time.Now().UnixMilli(),
+		}
+		pids, _ := h.stores.Channels.ListUserParticipantIDs(c.Request.Context(), channelID, "")
+		for _, uid := range pids {
+			h.hub.PublishToUser(uid, evt)
+		}
+	}
+
+	c.JSON(http.StatusOK, gin.H{"unclaimed": true, "assignment_id": assignmentID})
+}
+
+// Reassign changes the assigned_to on a claimed assignment.
+// POST /api/v1/workflow-assignments/:id/reassign
+func (h *WorkflowAssignmentHandler) Reassign(c *gin.Context) {
+	assignmentID := c.Param("id")
+	userID := c.GetString("user_id")
+	role, _ := c.Get("role")
+
+	var body struct {
+		UserID string `json:"user_id"`
+	}
+	if err := c.ShouldBindJSON(&body); err != nil || body.UserID == "" {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "user_id is required"})
+		return
+	}
+
+	// Auth: team admin or global admin
+	a, err := h.stores.Workflows.GetAssignmentByID(c.Request.Context(), assignmentID)
+	if err != nil || a == nil {
+		c.JSON(http.StatusNotFound, gin.H{"error": "assignment not found"})
+		return
+	}
+
+	if role != "admin" {
+		isTA := false
+		if h.stores.Teams != nil {
+			isTA, _ = h.stores.Teams.IsTeamAdmin(c.Request.Context(), a.TeamID, userID)
+		}
+		if !isTA {
+			c.JSON(http.StatusForbidden, gin.H{"error": "team admin access required"})
+			return
+		}
+	}
+
+	n, err := h.stores.Workflows.ReassignAssignment(c.Request.Context(), assignmentID, body.UserID)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to reassign assignment"})
+		return
+	}
+	if n == 0 {
+		c.JSON(http.StatusConflict, gin.H{"error": "assignment not in claimed state"})
+		return
+	}
+
+	// Emit WS event
+	channelID, _ := h.stores.Workflows.GetAssignmentChannelID(c.Request.Context(), assignmentID)
+	if h.hub != nil && channelID != "" {
+		payload, _ := json.Marshal(map[string]any{
+			"assignment_id": assignmentID,
+			"reassigned_by": userID,
+			"new_assignee":  body.UserID,
+			"channel_id":    channelID,
+		})
+		evt := events.Event{
+			Label:   "workflow.reassigned",
+			Payload: payload,
+			Ts:      time.Now().UnixMilli(),
+		}
+		pids, _ := h.stores.Channels.ListUserParticipantIDs(c.Request.Context(), channelID, "")
+		for _, uid := range pids {
+			h.hub.PublishToUser(uid, evt)
+		}
+	}
+
+	c.JSON(http.StatusOK, gin.H{"reassigned": true, "assignment_id": assignmentID, "new_assignee": body.UserID})
+}
+
+// CancelAssignment cancels a single assignment.
+// POST /api/v1/workflow-assignments/:id/cancel
+func (h *WorkflowAssignmentHandler) CancelAssignment(c *gin.Context) {
+	assignmentID := c.Param("id")
+	userID := c.GetString("user_id")
+	role, _ := c.Get("role")
+
+	// Auth: team admin or global admin
+	a, err := h.stores.Workflows.GetAssignmentByID(c.Request.Context(), assignmentID)
+	if err != nil || a == nil {
+		c.JSON(http.StatusNotFound, gin.H{"error": "assignment not found"})
+		return
+	}
+
+	if role != "admin" {
+		isTA := false
+		if h.stores.Teams != nil {
+			isTA, _ = h.stores.Teams.IsTeamAdmin(c.Request.Context(), a.TeamID, userID)
+		}
+		if !isTA {
+			c.JSON(http.StatusForbidden, gin.H{"error": "team admin access required"})
+			return
+		}
+	}
+
+	n, err := h.stores.Workflows.CancelAssignment(c.Request.Context(), assignmentID)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to cancel assignment"})
+		return
+	}
+	if n == 0 {
+		c.JSON(http.StatusConflict, gin.H{"error": "assignment not in cancellable state"})
+		return
+	}
+
+	c.JSON(http.StatusOK, gin.H{"cancelled": true, "assignment_id": assignmentID})
+}
+
 // CommentOnAssignment adds a review comment to an assignment.
 // POST /api/v1/workflow-assignments/:id/comment
 func (h *WorkflowAssignmentHandler) CommentOnAssignment(c *gin.Context) {