mirror of
https://github.com/larksuite/cli.git
synced 2026-09-14 18:42:53 +08:00
木杉
5919e861cc
* feat: accept frontend app-type in apps +create * feat: accept frontend app-type filter in apps +list * docs: clarify frontend app-type handling in apps +init * docs: note FRONTEND in queryAppType comment * docs: add frontend app-type guidance to lark-apps skill * docs: add frontend app-type to lark-apps command references SKILL.md's routing table already covered frontend, but the per-command reference docs still enumerated only html/full_stack. Update create/list/get enum values, add a frontend local-dev section, and note frontend in the release-create entry so agents document the third app type consistently. * docs: address CodeRabbit feedback on frontend app-type refs - create.md: state the app-type enum is matched exactly (lowercase), drop the incorrect claim that the CLI normalizes case - local-dev.md: scope database debugging to full_stack (frontend/html have no DB) and add the +release-get finished-status poll to the frontend flow * docs: align app-type enum in apps E2E coverage and test comments The E2E coverage table and two test comments still described the --app-type enum as html/full_stack after frontend was added. Update them to html/frontend/full_stack for consistency; assertions are unaffected (they match on substrings, not the full enum set). * docs(lark-apps): cloud-dev honors routed app_type instead of hardcoding full_stack The main SKILL.md router declares app_type and dev-method orthogonal and routes no-database interactive tools to frontend, but cloud-dev/create references still hardcoded `+create --app-type full_stack` for cloud generation. This forced a frontend-routed request into a full_stack app (unrecoverable since apps have no +delete). Align with the 2026-07-24 design decision: cloud generation also splits by database need — full_stack when persistence is required, frontend by default when unstated. Verified on BOE that a frontend app runs the full cloud session+chat pipeline to completed.
82 lines
2.8 KiB
Go
82 lines
2.8 KiB
Go
// Copyright (c) 2026 Lark Technologies Pte. Ltd.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package apps
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"io"
|
|
"strings"
|
|
|
|
"github.com/larksuite/cli/internal/envvars"
|
|
"github.com/larksuite/cli/shortcuts/common"
|
|
)
|
|
|
|
const createHint = "verify --app-type is html, frontend or full_stack and --name is non-empty; if this is a permission error, confirm your account can create apps"
|
|
|
|
// AppsCreate creates a new app.
|
|
var AppsCreate = common.Shortcut{
|
|
Service: appsService,
|
|
Command: "+create",
|
|
Description: "Create a new app",
|
|
Risk: "write",
|
|
Tips: []string{
|
|
`Example: lark-cli apps +create --name "审批系统" --app-type full_stack`,
|
|
`Example: lark-cli apps +create --name "工具页" --app-type frontend --description "纯前端工具"`,
|
|
`Example: lark-cli apps +create --name "活动页" --app-type html --description "活动报名"`,
|
|
},
|
|
Scopes: []string{"spark:app:write"},
|
|
AuthTypes: []string{"user"},
|
|
HasFormat: true,
|
|
Flags: []common.Flag{
|
|
{Name: "name", Desc: "app display name", Required: true},
|
|
{Name: "app-type", Desc: "app type", Required: true, Enum: []string{"html", "frontend", "full_stack"}},
|
|
{Name: "description", Desc: "app description"},
|
|
{Name: "icon-url", Desc: "app icon URL (server uses default if omitted)"},
|
|
},
|
|
Validate: func(ctx context.Context, rctx *common.RuntimeContext) error {
|
|
if strings.TrimSpace(rctx.Str("name")) == "" {
|
|
return appsValidationParamError("--name", "--name is required")
|
|
}
|
|
return nil
|
|
},
|
|
DryRun: func(ctx context.Context, rctx *common.RuntimeContext) *common.DryRunAPI {
|
|
return common.NewDryRunAPI().
|
|
POST(apiBasePath + "/apps").
|
|
Desc("Create an app").
|
|
Body(buildAppsCreateBody(rctx))
|
|
},
|
|
Execute: func(ctx context.Context, rctx *common.RuntimeContext) error {
|
|
data, err := rctx.CallAPITyped("POST", apiBasePath+"/apps", nil, buildAppsCreateBody(rctx))
|
|
if err != nil {
|
|
return withAppsHint(err, createHint)
|
|
}
|
|
rctx.OutFormat(data, nil, func(w io.Writer) {
|
|
fmt.Fprintf(w, "created: %s\n", common.GetString(data, "app", "app_id"))
|
|
})
|
|
return nil
|
|
},
|
|
}
|
|
|
|
func buildAppsCreateBody(rctx *common.RuntimeContext) map[string]interface{} {
|
|
// --app-type is constrained to the lowercase enum (html / frontend / full_stack) by the
|
|
// flag's Enum, so send it through verbatim. Legacy uppercase compatibility is
|
|
// a server concern and is intentionally not surfaced by the CLI.
|
|
agent := envvars.AgentName()
|
|
body := map[string]interface{}{
|
|
"name": strings.TrimSpace(rctx.Str("name")),
|
|
"app_type": rctx.Str("app-type"),
|
|
}
|
|
if desc := strings.TrimSpace(rctx.Str("description")); desc != "" {
|
|
body["description"] = desc
|
|
}
|
|
if icon := strings.TrimSpace(rctx.Str("icon-url")); icon != "" {
|
|
body["icon_url"] = icon
|
|
}
|
|
if agent != "" {
|
|
body["source_agent"] = agent
|
|
}
|
|
return body
|
|
}
|