mirror of
https://github.com/larksuite/cli.git
synced 2026-07-06 16:18:05 +08:00
20761fa56a
* feat(task): add task shortcuts with skill docs and tests * docs(task): document task event payload shape * refactor(task): remove unused buildUserIDs helper * fix(task): handle api error codes in set-ancestor * docs(task): clarify get-related-tasks page-token unit * feat(task): support bot identity for subscribe-event * docs(task): clarify bot subscribe-event scope * docs(task): clarify related-task pagination semantics * docs(task): add BOE selftest report (boe_task_tasklist_oapi_support) * docs(task): prefer related-task shortcuts over search for scoped queries * docs(task): clarify tasklist search routing * docs(task): route keywordless tasklist queries to list API * docs(task): refine search routing heuristics * feat(event): include task user-access updates in catch-all subscribe * docs(task): remove auth status --json guidance
85 lines
2.5 KiB
Go
85 lines
2.5 KiB
Go
// Copyright (c) 2026 Lark Technologies Pte. Ltd.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package task
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"io"
|
|
"net/http"
|
|
"net/url"
|
|
|
|
larkcore "github.com/larksuite/oapi-sdk-go/v3/core"
|
|
|
|
"github.com/larksuite/cli/shortcuts/common"
|
|
)
|
|
|
|
var SetAncestorTask = common.Shortcut{
|
|
Service: "task",
|
|
Command: "+set-ancestor",
|
|
Description: "set or clear a task ancestor",
|
|
Risk: "write",
|
|
Scopes: []string{"task:task:write"},
|
|
AuthTypes: []string{"user", "bot"},
|
|
HasFormat: true,
|
|
Flags: []common.Flag{
|
|
{Name: "task-id", Desc: "task guid to update", Required: true},
|
|
{Name: "ancestor-id", Desc: "ancestor task guid; omit to make it independent"},
|
|
},
|
|
DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
|
|
taskID := url.PathEscape(runtime.Str("task-id"))
|
|
return common.NewDryRunAPI().
|
|
POST("/open-apis/task/v2/tasks/" + taskID + "/set_ancestor_task").
|
|
Params(map[string]interface{}{"user_id_type": "open_id"}).
|
|
Body(buildSetAncestorBody(runtime.Str("ancestor-id")))
|
|
},
|
|
Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
|
|
taskID := runtime.Str("task-id")
|
|
queryParams := make(larkcore.QueryParams)
|
|
queryParams.Set("user_id_type", "open_id")
|
|
|
|
apiResp, err := runtime.DoAPI(&larkcore.ApiReq{
|
|
HttpMethod: http.MethodPost,
|
|
ApiPath: "/open-apis/task/v2/tasks/" + url.PathEscape(taskID) + "/set_ancestor_task",
|
|
QueryParams: queryParams,
|
|
Body: buildSetAncestorBody(runtime.Str("ancestor-id")),
|
|
})
|
|
var result map[string]interface{}
|
|
if err == nil {
|
|
if parseErr := json.Unmarshal(apiResp.RawBody, &result); parseErr != nil {
|
|
return WrapTaskError(ErrCodeTaskInternalError, fmt.Sprintf("failed to parse response: %v", parseErr), "set ancestor task")
|
|
}
|
|
}
|
|
if _, err = HandleTaskApiResult(result, err, "set ancestor task"); err != nil {
|
|
return err
|
|
}
|
|
|
|
outData := map[string]interface{}{
|
|
"ok": true,
|
|
"data": map[string]interface{}{
|
|
"guid": taskID,
|
|
},
|
|
}
|
|
runtime.OutFormat(outData, nil, func(w io.Writer) {
|
|
fmt.Fprintf(w, "✅ Task ancestor updated successfully!\nTask ID: %s\n", taskID)
|
|
if ancestorID := runtime.Str("ancestor-id"); ancestorID != "" {
|
|
fmt.Fprintf(w, "Ancestor ID: %s\n", ancestorID)
|
|
} else {
|
|
fmt.Fprintln(w, "Ancestor cleared: task is now independent")
|
|
}
|
|
})
|
|
return nil
|
|
},
|
|
}
|
|
|
|
func buildSetAncestorBody(ancestorID string) map[string]interface{} {
|
|
if ancestorID == "" {
|
|
return map[string]interface{}{}
|
|
}
|
|
return map[string]interface{}{
|
|
"ancestor_guid": ancestorID,
|
|
}
|
|
}
|