rdev/internal/handlers/sdlc_tasks.go
jordan 425ef0f806 feat: add SDLC orchestration - library, CLI, and API integration
Implements deterministic feature lifecycle management for agent-driven
development. Agents use the CLI in pods; operators control via REST API.

Library (internal/sdlc/):
- Feature lifecycle with 10 phases (draft → released)
- Classifier engine with priority-ordered rules
- Artifact tracking with approval workflow
- Task management within features
- YAML-based state persistence

CLI (cmd/sdlc/):
- init, state, next, feature, artifact, task, query commands
- --json flag for machine-readable output
- Runs inside project pods

API (21 endpoints under /projects/{id}/sdlc/):
- State: GET /state, GET /next
- Features: CRUD + transition/block/unblock
- Artifacts: approve/reject per type
- Tasks: add/start/complete/block
- Queries: blocked/ready/needs-approval

Architecture:
- Port: SDLCExecutor interface (internal/port/)
- Adapter: kubectl exec into pods (internal/adapter/kubernetes/)
- Service: pod resolution + logging (internal/service/)
- Handlers: 5 files under 500-line limit (internal/handlers/)

Also includes template upgrades (chassis framework, UI components,
OpenAPI helpers, backend/frontend guides) and component improvements.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 09:57:05 -07:00

135 lines
3.4 KiB
Go

package handlers
import (
"context"
"net/http"
"github.com/go-chi/chi/v5"
"github.com/orchard9/rdev/internal/sdlc"
"github.com/orchard9/rdev/internal/validate"
"github.com/orchard9/rdev/pkg/api"
)
// AddTaskRequest is the request body for POST /projects/{id}/sdlc/features/{slug}/tasks.
type AddTaskRequest struct {
Title string `json:"title"`
}
// ListTasks returns all tasks for a feature.
// GET /projects/{id}/sdlc/features/{slug}/tasks
func (h *SDLCHandler) ListTasks(w http.ResponseWriter, r *http.Request) {
projectID := chi.URLParam(r, "id")
slug := chi.URLParam(r, "slug")
ctx, cancel := context.WithTimeout(r.Context(), TimeoutStandard)
defer cancel()
tasks, err := h.sdlcService.ListTasks(ctx, projectID, slug)
if err != nil {
writeSDLCError(w, r, err)
return
}
if tasks == nil {
tasks = []sdlc.Task{}
}
api.WriteSuccess(w, r, tasks)
}
// AddTask adds a new task to a feature.
// POST /projects/{id}/sdlc/features/{slug}/tasks
func (h *SDLCHandler) AddTask(w http.ResponseWriter, r *http.Request) {
projectID := chi.URLParam(r, "id")
slug := chi.URLParam(r, "slug")
var req AddTaskRequest
if err := api.DecodeJSON(r, &req); err != nil {
api.WriteBadRequest(w, r, "invalid request body")
return
}
v := validate.New()
v.Required(req.Title, "title")
if err := v.Error(); err != nil {
api.WriteBadRequest(w, r, err.Error())
return
}
ctx, cancel := context.WithTimeout(r.Context(), TimeoutHeavyWrite)
defer cancel()
task, err := h.sdlcService.AddTask(ctx, projectID, slug, req.Title)
if err != nil {
writeSDLCError(w, r, err)
return
}
api.WriteCreated(w, r, task)
}
// StartTask marks a task as in-progress.
// POST /projects/{id}/sdlc/features/{slug}/tasks/{taskId}/start
func (h *SDLCHandler) StartTask(w http.ResponseWriter, r *http.Request) {
projectID := chi.URLParam(r, "id")
slug := chi.URLParam(r, "slug")
taskID := chi.URLParam(r, "taskId")
ctx, cancel := context.WithTimeout(r.Context(), TimeoutHeavyWrite)
defer cancel()
if err := h.sdlcService.StartTask(ctx, projectID, slug, taskID); err != nil {
writeSDLCError(w, r, err)
return
}
api.WriteSuccess(w, r, map[string]any{
"feature": slug,
"task_id": taskID,
"status": "in_progress",
})
}
// CompleteTask marks a task as complete.
// POST /projects/{id}/sdlc/features/{slug}/tasks/{taskId}/complete
func (h *SDLCHandler) CompleteTask(w http.ResponseWriter, r *http.Request) {
projectID := chi.URLParam(r, "id")
slug := chi.URLParam(r, "slug")
taskID := chi.URLParam(r, "taskId")
ctx, cancel := context.WithTimeout(r.Context(), TimeoutHeavyWrite)
defer cancel()
if err := h.sdlcService.CompleteTask(ctx, projectID, slug, taskID); err != nil {
writeSDLCError(w, r, err)
return
}
api.WriteSuccess(w, r, map[string]any{
"feature": slug,
"task_id": taskID,
"status": "complete",
})
}
// BlockTask marks a task as blocked.
// POST /projects/{id}/sdlc/features/{slug}/tasks/{taskId}/block
func (h *SDLCHandler) BlockTask(w http.ResponseWriter, r *http.Request) {
projectID := chi.URLParam(r, "id")
slug := chi.URLParam(r, "slug")
taskID := chi.URLParam(r, "taskId")
ctx, cancel := context.WithTimeout(r.Context(), TimeoutHeavyWrite)
defer cancel()
if err := h.sdlcService.BlockTask(ctx, projectID, slug, taskID); err != nil {
writeSDLCError(w, r, err)
return
}
api.WriteSuccess(w, r, map[string]any{
"feature": slug,
"task_id": taskID,
"status": "blocked",
})
}