mirror of
https://github.com/larksuite/cli.git
synced 2026-07-09 10:29:48 +08:00
e9f2da086f
Add 8 new shortcut commands under `lark-cli apps`: Plugin package management (aligned with fullstack-cli): - +plugin-install: download tgz, extract to node_modules, update package.json - +plugin-uninstall: remove from node_modules and package.json actionPlugins - +plugin-list: list declared plugins with installation status Plugin instance CRUD (aligned with feida-ai): - +plugin-instance-create: validate + write capability JSON with formValue validation - +plugin-instance-update: merge mutable fields, re-validate formValue - +plugin-instance-delete: idempotent file removal - +plugin-instance-get: read capability JSON - +plugin-instance-list: scan capabilities directory Shared infrastructure (plugin_common.go): - 4-level capabilities dir resolution (flag → env → .env.local MIAODA_APP_TYPE → detection) - formValue validation ported from feida-ai (5 rules: forbidden Handlebars, paramsSchema type constraints, input ref existence, unconsumed params, array double-wrap auto-fix) - tgz extraction with path traversal protection - package.json actionPlugins management - Install version check with mismatch warnings
92 lines
2.7 KiB
Go
92 lines
2.7 KiB
Go
// Copyright (c) 2026 Lark Technologies Pte. Ltd.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package apps
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"io"
|
|
"strings"
|
|
|
|
"github.com/larksuite/cli/shortcuts/common"
|
|
)
|
|
|
|
// AppsPluginInstanceGet reads a single plugin instance (capability JSON) by id.
|
|
var AppsPluginInstanceGet = common.Shortcut{
|
|
Service: appsService,
|
|
Command: "+plugin-instance-get",
|
|
Description: "Get a plugin instance by id",
|
|
Risk: "read",
|
|
Flags: []common.Flag{
|
|
{Name: "id", Desc: "instance id (filename without .json in capabilities/)", Required: true},
|
|
{Name: "project-path", Desc: "project root path (defaults to current directory)"},
|
|
{Name: "capabilities-dir", Desc: "explicit capabilities directory (relative to project or absolute)"},
|
|
},
|
|
DryRun: func(ctx context.Context, rctx *common.RuntimeContext) *common.DryRunAPI {
|
|
id := strings.TrimSpace(rctx.Str("id"))
|
|
return common.NewDryRunAPI().
|
|
Desc("Get plugin instance (read capability JSON)").
|
|
Set("action", "get").
|
|
Set("id", id).
|
|
Set("source", fmt.Sprintf("<capabilities_dir>/%s.json", id))
|
|
},
|
|
Validate: func(ctx context.Context, rctx *common.RuntimeContext) error {
|
|
id := strings.TrimSpace(rctx.Str("id"))
|
|
if id == "" {
|
|
return appsValidationParamError("--id", "--id is required")
|
|
}
|
|
projectPath, err := pluginResolveProjectPath(rctx.Str("project-path"))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return pluginCheckProjectDir(projectPath)
|
|
},
|
|
Execute: func(ctx context.Context, rctx *common.RuntimeContext) error {
|
|
id := strings.TrimSpace(rctx.Str("id"))
|
|
projectPath, err := pluginResolveProjectPath(rctx.Str("project-path"))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
capDir, err := pluginResolveCapDir(projectPath, rctx.Str("capabilities-dir"))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
cap, err := pluginGetCapability(capDir, id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
rctx.OutFormat(cap, nil, func(w io.Writer) {
|
|
pluginPrintInstance(w, cap)
|
|
})
|
|
return nil
|
|
},
|
|
}
|
|
|
|
func pluginPrintInstance(w io.Writer, cap map[string]interface{}) {
|
|
fmt.Fprintf(w, "ID: %v\n", cap["id"])
|
|
fmt.Fprintf(w, "Plugin: %v\n", cap["pluginKey"])
|
|
fmt.Fprintf(w, "Version: %v\n", cap["pluginVersion"])
|
|
fmt.Fprintf(w, "Name: %v\n", cap["name"])
|
|
|
|
if ts := common.FormatTime(cap["createdAt"]); ts != "" {
|
|
fmt.Fprintf(w, "Created: %s\n", ts)
|
|
}
|
|
if ts := common.FormatTime(cap["updatedAt"]); ts != "" {
|
|
fmt.Fprintf(w, "Updated: %s\n", ts)
|
|
}
|
|
|
|
if ps, ok := cap["paramsSchema"]; ok && ps != nil {
|
|
b, _ := json.MarshalIndent(ps, " ", " ")
|
|
fmt.Fprintf(w, "ParamsSchema: %s\n", b)
|
|
}
|
|
if fv, ok := cap["formValue"]; ok && fv != nil {
|
|
b, _ := json.MarshalIndent(fv, " ", " ")
|
|
fmt.Fprintf(w, "FormValue: %s\n", b)
|
|
}
|
|
}
|