feat(apps): add +init-template and +deploy shortcuts

shortcuts/apps/apps_deploy_zip.go

@@ -0,0 +1,65 @@
+// Copyright (c) 2026 Lark Technologies Pte. Ltd.
+// SPDX-License-Identifier: MIT
+
+package apps
+
+import (
+	"archive/zip"
+	"bytes"
+	"io"
+
+	"github.com/larksuite/cli/extension/fileio"
+)
+
+// appDevZipball is an in-memory zip payload ready for TOS upload.
+type appDevZipball struct {
+	Body      []byte
+	Size      int64
+	FileCount int
+}
+
+// appDevPackEntry is one file of the normalized upload payload. ZipPath is
+// the fixed protocol layout inside the zip (output/... for same-origin
+// artifacts, output_resource/... for CDN artifacts) regardless of the
+// project's directory names. Data comes from AbsPath, or from Content for
+// CLI-generated files (a buildless routes.json).
+type appDevPackEntry struct {
+	ZipPath string
+	AbsPath string
+	Content []byte
+	Size    int64
+}
+
+// buildAppDevZip packs the normalized entries into an in-memory zip: entry
+// names are the fixed output/... and output_resource/... layout the hosting
+// pipeline expects.
+func buildAppDevZip(fio fileio.FileIO, entries []appDevPackEntry) (*appDevZipball, error) {
+	var buf bytes.Buffer
+	zw := zip.NewWriter(&buf)
+	for _, e := range entries {
+		w, err := zw.Create(e.ZipPath)
+		if err != nil {
+			return nil, appsFileIOError(err, "zip create %s failed: %v", e.ZipPath, err)
+		}
+		if e.AbsPath == "" {
+			if _, err := w.Write(e.Content); err != nil {
+				return nil, appsFileIOError(err, "zip write %s failed: %v", e.ZipPath, err)
+			}
+			continue
+		}
+		f, err := fio.Open(e.AbsPath)
+		if err != nil {
+			return nil, appsInputPathEntryError(e.AbsPath, err)
+		}
+		_, err = io.Copy(w, f)
+		f.Close()
+		if err != nil {
+			return nil, appsFileIOError(err, "zip write %s failed: %v", e.ZipPath, err)
+		}
+	}
+	if err := zw.Close(); err != nil {
+		return nil, appsFileIOError(err, "zip finalize failed: %v", err)
+	}
+	size := int64(buf.Len())
+	return &appDevZipball{Body: buf.Bytes(), Size: size, FileCount: len(entries)}, nil
+}

shortcuts/apps/apps_deploy_zip_test.go

@@ -0,0 +1,33 @@
+// Copyright (c) 2026 Lark Technologies Pte. Ltd.
+// SPDX-License-Identifier: MIT
+
+package apps
+
+import (
+	"archive/zip"
+	"bytes"
+	"testing"
+)
+
+// zipEntryNames opens an in-memory zip and returns its entry names.
+func zipEntryNames(t *testing.T, body []byte) []string {
+	t.Helper()
+	zr, err := zip.NewReader(bytes.NewReader(body), int64(len(body)))
+	if err != nil {
+		t.Fatalf("open zip: %v", err)
+	}
+	names := make([]string, 0, len(zr.File))
+	for _, f := range zr.File {
+		names = append(names, f.Name)
+	}
+	return names
+}
+
+func TestBuildAppDevZip_MissingSourceFile(t *testing.T) {
+	_, err := buildAppDevZip(permissiveFIO{}, []appDevPackEntry{
+		{ZipPath: "output/gone.html", AbsPath: "/nonexistent/gone.html", Size: 1},
+	})
+	if err == nil {
+		t.Fatal("an entry whose source file vanished must fail the pack")
+	}
+}

shortcuts/apps/apps_html_publish.go

@@ -331,22 +331,10 @@ func runHTMLPublishTOS(ctx context.Context, rctx *common.RuntimeContext, spec ap
 	if err != nil {
 		return nil, err
 	}
-	kvs, _ := preData["kvs"].([]interface{})
-	if len(kvs) == 0 {
+	kvm := parsePreReleaseKVs(preData)
+	if len(kvm) == 0 {
 		return nil, appsSubprocessEnvelopeError("pre_release returned no kvs")
 	}
-	kvm := make(map[string]string, len(kvs))
-	for _, item := range kvs {
-		kv, _ := item.(map[string]interface{})
-		if kv == nil {
-			continue
-		}
-		k, _ := kv["key"].(string)
-		v, _ := kv["value"].(string)
-		if k != "" {
-			kvm[k] = v
-		}
-	}
 	uploadURL := kvm["upload_url"]
 	tosPath := kvm["tos_path"]
 	if uploadURL == "" || tosPath == "" {