larksuite-cli/shortcuts/task/task_complete.go

// Copyright (c) 2026 Lark Technologies Pte. Ltd.
// SPDX-License-Identifier: MIT

package task

import (
	"context"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"time"

	"github.com/larksuite/cli/shortcuts/common"
)

// CompleteTask marks a task as complete and skips the PATCH call if already completed.
var CompleteTask = common.Shortcut{
	Service:     "task",
	Command:     "+complete",
	Description: "mark a task as complete",
	Risk:        "write",
	Scopes:      []string{"task:task:write"},
	AuthTypes:   []string{"user", "bot"},
	HasFormat:   true,

	Flags: []common.Flag{
		{Name: "task-id", Desc: "task GUID or task applink URL", Required: true},
	},

	Validate: func(ctx context.Context, runtime *common.RuntimeContext) error {
		_, err := parseTaskGUID(runtime.Str("task-id"))
		return err
	},

	DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
		body := buildCompleteBody()
		taskGUID, err := parseTaskGUID(runtime.Str("task-id"))
		if err != nil {
			return common.NewDryRunAPI().Set("error", err.Error())
		}
		taskID := url.PathEscape(taskGUID)
		return common.NewDryRunAPI().
			GET("/open-apis/task/v2/tasks/" + taskID).
			Desc("get current task status").
			Params(map[string]interface{}{"user_id_type": "open_id"}).
			PATCH("/open-apis/task/v2/tasks/" + taskID).
			Desc("complete task if not completed").
			Params(map[string]interface{}{"user_id_type": "open_id"}).
			Body(body)
	},

	Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
		taskGUID, err := parseTaskGUID(runtime.Str("task-id"))
		if err != nil {
			return err
		}
		taskID := url.PathEscape(taskGUID)

		params := map[string]interface{}{"user_id_type": "open_id"}

		var data map[string]interface{}

		// 1. Get current task status
		getData, err := callTaskAPITyped(runtime, http.MethodGet, "/open-apis/task/v2/tasks/"+taskID, params, nil)
		if err != nil {
			return err
		}

		taskData, _ := getData["task"].(map[string]interface{})
		completedAtStr, _ := taskData["completed_at"].(string)
		alreadyCompleted := completedAtStr != "" && completedAtStr != "0"

		// 2. If already completed, directly return success
		if alreadyCompleted {
			data = getData
		} else {
			// 3. Complete the task
			body := buildCompleteBody()
			data, err = callTaskAPITyped(runtime, http.MethodPatch, "/open-apis/task/v2/tasks/"+taskID, params, body)
			if err != nil {
				return err
			}
		}

		task, _ := data["task"].(map[string]interface{})
		guid, _ := task["guid"].(string)
		urlVal, _ := task["url"].(string)
		urlVal = truncateTaskURL(urlVal)
		completedAt, _ := task["completed_at"].(string)
		status := "todo"
		if completedAt != "" && completedAt != "0" {
			status = "done"
		}

		// Standardized write output: return resource identifiers
		outData := map[string]interface{}{
			"guid":              guid,
			"url":               urlVal,
			"status":            status,
			"completed_at":      completedAt,
			"already_completed": alreadyCompleted,
		}

		runtime.OutFormat(outData, nil, func(w io.Writer) {
			summary, _ := task["summary"].(string)
			fmt.Fprintf(w, "✅ Task completed successfully!\n")
			if guid != "" {
				fmt.Fprintf(w, "Task ID: %s\n", guid)
			}
			if summary != "" {
				fmt.Fprintf(w, "Summary: %s\n", summary)
			}
			if urlVal != "" {
				fmt.Fprintf(w, "Task URL: %s\n", urlVal)
			}
		})
		return nil
	},
}

func buildCompleteBody() map[string]interface{} {
	completedAt := fmt.Sprintf("%d", time.Now().Unix()*1000)
	return map[string]interface{}{
		"task": map[string]interface{}{
			"completed_at": completedAt,
		},
		"update_fields": []string{"completed_at"},
	}
}