@synopackageland/cli 0.13.1 → 0.15.0

package/skills/reference/portal.md

@@ -35,3 +35,34 @@ Never: write `AppPortal.json`, `@appconf/<package>` or `/usr/syno/etc/www/app.d`
 Uninstall: the root executor's purge deletes the rules of `SYNO.SDS.<package>.Instance` through the Application Privileges API and, once DSM has removed the alias files, reloads nginx (`synosystemctl reload nginx`), so the alias stops at once. Failures are only logged to the system log entry `synopkgland-executor`; then an administrator saves an alias in Control Panel > Login Portal > Applications (which reloads nginx) or restarts the NAS, and removes the rules in Control Panel > Application Privileges. The uninstall wizard and the `status`/`inspect` cleanup list say this in that order: automatic first, manual only as the fallback.
 
 Executor mode uninstall: the purge reads the retained policy and unregisters the entry. If the executor is not running or was never approved, uninstall does not remove the entry; the wizard and cleanup list say so and give the root commands (`rm -f /usr/syno/etc/www/app.d/<package>.json /usr/syno/etc/www/app.d/<package>.mustache /usr/syno/etc/packages/<package>/AppPortal.json`, `synow3tool --disable-nginx-confd/--unreg-nginx-confd` for `dsm www alias .alias`, `--disable-nginx-sites/--unreg-nginx-sites` for `server .server` on `<c>.syno-app-portal.<package>.conf`, then `nginx -t && synow3tool --nginx=reload`).
+
+## 開啟方式
+
+原生 App 在 `dsm-package.yaml` 設定 `ui.launch: dsm-window | new-page`。
+SDK 原生內建預設為 `dsm-window`；使用 `@synopackageland/ui` 維持視窗，
+其他原生前端必須明確寫 `ui.launch: new-page`。
+Scaffold 明確寫入此選擇，plain／binary 使用 `new-page`，Vue UI SDK 使用
+預設的 `dsm-window`（省略 `ui.launch`）。原生 manifest 省略 `ui.launch` 時解析為 `dsm-window`，CLI 不猜測前端依賴。
+
+`new-page` 產生 DSM `type: "standalone"` launcher，主選單及套件中心皆在 DSM
+本身的 origin 開啟全頁。`ctx.fullPage`、`ctx.appIcon`、SynoToken／session、
+`ctx.launchParams`／`onLaunch`、`entry` 權限沿用共用 wrapper；全頁的標題、
+favicon 與手機 viewport 由 wrapper 設定。不需要 `pureEnv` 或 `allowAltPort`。
+
+Application Portal 是獨立 opt-in：不想要別名就省略 `portal`，不生成
+`defaultAlias`、Portal 面板／capability 或 Web Station alias；沒有 Portal
+不是 inspect／info／doctor 問題。明確啟用 `portal` 時才將其 alias 作為 `defaultAlias`。
+
+Docker／web service App 設定 `integration.web.launch`，內建預設是 `new-page`；
+省略開啟方式時直接開新分頁，不宣告 Application Portal。SDK 原生 App
+省略時使用 `dsm-window`；非 UI SDK 原生 App 必須明確寫 `ui.launch: new-page`。
+Web service 主選單使用
+`type: "url"` 與明確的 `url` 指向既有 DSM gateway。明確 `access: public` 才保留 Web Station
+alias；這是服務入口，不是 SDK Application Portal。DSM 會將 standalone URL 改寫成 launchApp 頁面，
+需要 AppInstance／AppWindow JS class；schema 1 web service 沒有該 class，因此使用 url。需要 DSM 視窗時明寫 `dsm-window`。
+
+Schema 2 的 `dsm-package.yaml` + `identity_gateway` + `compose` 同樣視為
+web service：省略 `ui.launch` 時預設 `new-page`，使用 standalone launcher，
+不帶 Application Portal。兩條 Compose 路線共用 `contract/app-launch.ts`
+解析開啟方式與選擇 launcher 型別；明確的 `ui.launch` 可覆寫預設。
+只有沒有 web service 的 SDK 原生 App 省略時才預設 `dsm-window`。

package/skills/reference/ui-vue.md

@@ -94,3 +94,34 @@ with the same PasswordConfirm form and no extra dialog. Mismatch must be explici
 Restrict the existing NasPicker to `selection.root`; do not grant via cached paths.
 The default facade includes typed `destination(key)` and `exportExample({key,job_id})`;
 use original operation references and display Saved only for protected receipts.
+
+## 開啟方式
+
+原生 App 在 `dsm-package.yaml` 設定 `ui.launch: dsm-window | new-page`。
+SDK 原生內建預設為 `dsm-window`；使用 `@synopackageland/ui` 維持視窗，
+其他原生前端必須明確寫 `ui.launch: new-page`。
+Scaffold 明確寫入此選擇，plain／binary 使用 `new-page`，Vue UI SDK 使用
+預設的 `dsm-window`（省略 `ui.launch`）。原生 manifest 省略 `ui.launch` 時解析為 `dsm-window`，CLI 不猜測前端依賴。
+
+`new-page` 產生 DSM `type: "standalone"` launcher，主選單及套件中心皆在 DSM
+本身的 origin 開啟全頁。`ctx.fullPage`、`ctx.appIcon`、SynoToken／session、
+`ctx.launchParams`／`onLaunch`、`entry` 權限沿用共用 wrapper；全頁的標題、
+favicon 與手機 viewport 由 wrapper 設定。不需要 `pureEnv` 或 `allowAltPort`。
+
+Application Portal 是獨立 opt-in：不想要別名就省略 `portal`，不生成
+`defaultAlias`、Portal 面板／capability 或 Web Station alias；沒有 Portal
+不是 inspect／info／doctor 問題。明確啟用 `portal` 時才將其 alias 作為 `defaultAlias`。
+
+Docker／web service App 設定 `integration.web.launch`，內建預設是 `new-page`；
+省略開啟方式時直接開新分頁，不宣告 Application Portal。SDK 原生 App
+省略時使用 `dsm-window`；非 UI SDK 原生 App 必須明確寫 `ui.launch: new-page`。
+Web service 主選單使用
+`type: "url"` 與明確的 `url` 指向既有 DSM gateway。明確 `access: public` 才保留 Web Station
+alias；這是服務入口，不是 SDK Application Portal。DSM 會將 standalone URL 改寫成 launchApp 頁面，
+需要 AppInstance／AppWindow JS class；schema 1 web service 沒有該 class，因此使用 url。需要 DSM 視窗時明寫 `dsm-window`。
+
+Schema 2 的 `dsm-package.yaml` + `identity_gateway` + `compose` 同樣視為
+web service：省略 `ui.launch` 時預設 `new-page`，使用 standalone launcher，
+不帶 Application Portal。兩條 Compose 路線共用 `contract/app-launch.ts`
+解析開啟方式與選擇 launcher 型別；明確的 `ui.launch` 可覆寫預設。
+只有沒有 web service 的 SDK 原生 App 省略時才預設 `dsm-window`。

package/skills/reference/wrap.md

@@ -1,36 +1,16 @@
-# 封裝（Wrap）
+# 封裝上游 Compose
 
-已有 Compose 或要補齊 App Contract 時使用。權威仍是 schema + `check`。
+只使用 schema-2 `dsm-package.yaml`。先讀 [compose.md](compose.md) 的宣告、支援表及 DSM 阻擋條件，再讀 [identity-gateway.md](identity-gateway.md) 決定 none／header／token／OIDC。不架 SSO Server，也不需要假 backend 或 wrapper container。
 
-## 命令
-
-```bash
-synopkgland check      # 契約、Compose 意圖與 Web entry 提示
+```sh
+synopkgland init -t compose --from ./compose.yaml my-app
+synopkgland check --json
+synopkgland build --arch x86_64
+synopkgland inspect dist/MyApp-x86_64.spk --json
 ```
 
-## 契約允許什麼（v1 schema 1）
-
-必填：`schema`、`package`、`version`、`displayname`、`description`、`maintainer`、`os_min_ver`。
-
-
-
-For DSM-account SSO around OSS, first read [identity-gateway.md](identity-gateway.md).
-It defines the separate schema-2 `compose` + `identity_gateway` host-network policy;
-the legacy Compose route below retains its restrictions.
-
-## Compose 規則（analyzer 會擋）
-
-- 禁止：`privileged`、`network_mode: host`、裝置節點、`cap_add`、掛載 Docker socket。
-- `adminport` 必須對應到某 service 的 published TCP port。
-- `install` 參數須在 `compose.yaml` 以 `${NAME}` 引用。
-
-## 包現成 Compose 的掛載
-
-容器路徑跟映像／upstream 的 container target 走，原樣保留；只把 host source 換成 `${NAME}` 這類 install parameter。原有的 upstream named volume mount 與頂層 `volumes:` 宣告也保留，不要為了套模板改成 `/data`。需要既有 Share 時，管理員在安裝時選這台 NAS 的 Share。
-
-修復方式：看 `check` 輸出的 `[錯誤碼]` 與 `Suggestion:` 行，對照 `diagnose.md`。**不要**為了過驗證而亂改 runtime 語意。
+上游 bytes 不改；CLI 只做工具，SDK reference planner 產生 override 與 worker 單檔。修正錯誤時看 code／原因／建議，不為通過驗證改掉上游語義。共用 launch resolver 解析 ui.launch，預設 new-page；classless gateway 使用 type url。
 
-## 下一步
+容器使用固定套件身分，不繼承登入者 File Station ACL。Shared Folder 需 composeMounts 明確 opt-in，安裝後由 admin 確認；官方 protected ACL／project control 未驗證前只啟動 SDK 設定頁，不 acquire 上游，不用 host root 繞過。每使用者檔案權限需 session／Broker Adapter，本次不做。
 
-- 要身分／檔案整合 → `identity.md`／`files.md`
-- 要上 NAS → `deploy.md`
+交付 inspect 的 upstream／effective hashes、image digests、run-as、mount、egress 與 acceptance blockers。Linux 通過不代表 DSM 已驗收。部署請讀 [deploy.md](deploy.md)，保留資料並由專用 thread 驗 final SPK digest。

package/assets/go/daemon/fixture_linux_test.go

@@ -1,15 +0,0 @@
-//go:build linux
-
-package main
-
-import (
-	"os"
-	"os/exec"
-	"syscall"
-)
-
-func dropFixtureUser(cmd *exec.Cmd) {
-	if os.Geteuid() == 0 {
-		cmd.SysProcAttr = &syscall.SysProcAttr{Credential: &syscall.Credential{Uid: 65534, Gid: 65534, Groups: []uint32{65534}}}
-	}
-}

package/assets/go/daemon/fixture_other_test.go

@@ -1,7 +0,0 @@
-//go:build !linux
-
-package main
-
-import "os/exec"
-
-func dropFixtureUser(cmd *exec.Cmd) {}

package/assets/go/daemon/go.mod

@@ -1,5 +0,0 @@
-module synopkgland-daemon
-
-go 1.24
-
-toolchain go1.26.9