package main import ( "flag" "fmt" "net/http" "os" ) // runTasksCmd dispatches `agentctl kandev tasks `. The // singular `agentctl kandev task ` group (get/update/create) // remains the back-compat path; this plural group adds the verbs // the office runtime needs without breaking older scripts. func runTasksCmd(args []string) int { if len(args) == 0 { cliError("usage: agentctl kandev tasks [flags]") return 1 } switch args[0] { case subcmdList: return tasksList(args[1:]) case "move": return tasksMove(args[1:]) case "archive": return tasksArchive(args[1:]) case "message": return tasksMessage(args[1:]) case "conversation": return tasksConversation(args[1:]) default: cliError("unknown tasks subcommand: %s", args[0]) return 1 } } // tasksList returns workspace tasks, optionally filtered by status // or assignee. Hits the office dashboard list endpoint so the // returned shape matches what the Tasks page sees. func tasksList(args []string) int { fs := flag.NewFlagSet("tasks list", flag.ContinueOnError) status := fs.String("status", "", "Filter by status (todo, in_progress, done, …)") assignee := fs.String("assignee", "", "Filter by assignee agent ID") project := fs.String("project", "", "Filter by project ID") if err := fs.Parse(args); err != nil { cliError("parse flags: %v", err) return 1 } wsID := os.Getenv("KANDEV_WORKSPACE_ID") path := fmt.Sprintf("/api/v1/office/workspaces/%s/tasks", wsID) return getWithParams(path, "KANDEV_WORKSPACE_ID", wsID, map[string]string{ "status": *status, "assignee": *assignee, "project": *project, }) } // tasksMove transitions a task to a different workflow step. // `--prompt` queues a handoff message that the receiving step will // see as the first user comment. func tasksMove(args []string) int { fs := flag.NewFlagSet("tasks move", flag.ContinueOnError) id := fs.String("id", "", "Task ID (required; defaults to $KANDEV_TASK_ID)") step := fs.String("step", "", "Destination workflow step ID (required)") prompt := fs.String("prompt", "", "Optional handoff prompt queued for the destination step") if err := fs.Parse(args); err != nil { cliError("parse flags: %v", err) return 1 } client, err := newKandevClient() if err != nil { cliError("%v", err) return 1 } taskID := resolveTaskID(*id, client.taskID) if taskID == "" || *step == "" { cliError("--id (or KANDEV_TASK_ID) and --step are required") return 1 } payload := map[string]any{"workflow_step_id": *step} if *prompt != "" { payload["prompt"] = *prompt } body, status, err := client.do(http.MethodPost, fmt.Sprintf("/api/v1/tasks/%s/move", taskID), payload) return handleResponse(body, status, err) } // tasksArchive archives a task. Idempotent: archiving an already- // archived task is a 200/204 no-op. func tasksArchive(args []string) int { fs := flag.NewFlagSet("tasks archive", flag.ContinueOnError) id := fs.String("id", "", "Task ID (required; defaults to $KANDEV_TASK_ID)") if err := fs.Parse(args); err != nil { cliError("parse flags: %v", err) return 1 } client, err := newKandevClient() if err != nil { cliError("%v", err) return 1 } taskID := resolveTaskID(*id, client.taskID) if taskID == "" { cliError("--id (or KANDEV_TASK_ID) required") return 1 } body, status, err := client.do(http.MethodPost, fmt.Sprintf("/api/v1/tasks/%s/archive", taskID), nil) return handleResponse(body, status, err) } // tasksMessage posts a comment to a task as the current agent. // Different from `comment add` (which writes as the user) — this // shape lets the CEO drop a coordinator note on a worker's task // without spawning a new subtask. func tasksMessage(args []string) int { fs := flag.NewFlagSet("tasks message", flag.ContinueOnError) id := fs.String("id", "", "Task ID (required; defaults to $KANDEV_TASK_ID)") prompt := fs.String("prompt", "", "Message body (required)") if err := fs.Parse(args); err != nil { cliError("parse flags: %v", err) return 1 } client, err := newKandevClient() if err != nil { cliError("%v", err) return 1 } taskID := resolveTaskID(*id, client.taskID) if taskID == "" || *prompt == "" { cliError("--id (or KANDEV_TASK_ID) and --prompt are required") return 1 } payload := map[string]any{ "body": *prompt, "author_type": "agent", } body, status, err := client.do(http.MethodPost, fmt.Sprintf("/api/v1/office/tasks/%s/comments", taskID), payload) return handleResponse(body, status, err) } // tasksConversation lists comments on a task. Useful for catching // up after a wake when the prepended-summary slice is empty. func tasksConversation(args []string) int { fs := flag.NewFlagSet("tasks conversation", flag.ContinueOnError) id := fs.String("id", "", "Task ID (required; defaults to $KANDEV_TASK_ID)") if err := fs.Parse(args); err != nil { cliError("parse flags: %v", err) return 1 } client, err := newKandevClient() if err != nil { cliError("%v", err) return 1 } taskID := resolveTaskID(*id, client.taskID) if taskID == "" { cliError("--id (or KANDEV_TASK_ID) required") return 1 } body, status, err := client.do(http.MethodGet, fmt.Sprintf("/api/v1/office/tasks/%s/comments", taskID), nil) return handleResponse(body, status, err) }