@synopackageland/cli 0.9.6 → 0.10.0

package/dist/spk/check-payload.js

@@ -56,26 +56,26 @@ async function scanPayload(payloadPath, wanted, findings) {
         entries = 0;
     }
     if (entries === 0) {
-        findings.add("SPK_PAYLOAD_UNREADABLE", "package.tgz 不是可讀的 tar、tar.gz 封存，或是空的。", "package.tgz");
+        findings.add("SPK_PAYLOAD_UNREADABLE", "package.tgz is not a readable tar or tar.gz archive, or is empty.", "package.tgz");
         return undefined;
     }
     return files;
 }
 function checkEntryPath(path, type, linkpath, findings) {
     if (path.startsWith("/") || posix.normalize(path).split("/")[0] === "..") {
-        findings.add("SPK_PAYLOAD_PATH_UNSAFE", `${path} 會解開到套件目錄之外。`, at(path));
+        findings.add("SPK_PAYLOAD_PATH_UNSAFE", `${path} extracts outside the package directory.`, at(path));
         return;
     }
     if (type === "SymbolicLink" && linkpath) {
         if (linkpath.startsWith("/")) {
-            findings.add("SPK_PAYLOAD_LINK_ABSOLUTE", `${path} 是指向 ${linkpath} 的絕對路徑 symlink；目標由 NAS 決定，不在套件內。`, at(path));
+            findings.add("SPK_PAYLOAD_LINK_ABSOLUTE", `${path} is a symlink to the absolute path ${linkpath}; the target is determined by the NAS, not inside the package.`, at(path));
         }
         else if (posix.normalize(posix.join(posix.dirname(path), linkpath)).split("/")[0] === "..") {
-            findings.add("SPK_PAYLOAD_LINK_ESCAPE", `${path} 的 symlink 目標 ${linkpath} 跳出套件目錄。`, at(path));
+            findings.add("SPK_PAYLOAD_LINK_ESCAPE", `The symlink target ${linkpath} of ${path} escapes the package directory.`, at(path));
         }
     }
     if (type === "Link" && linkpath && (linkpath.startsWith("/") || posix.normalize(linkpath).split("/")[0] === "..")) {
-        findings.add("SPK_PAYLOAD_LINK_ESCAPE", `${path} 的 hard link 目標 ${linkpath} 不在套件內。`, at(path));
+        findings.add("SPK_PAYLOAD_LINK_ESCAPE", `The hard link target ${linkpath} of ${path} is not inside the package.`, at(path));
     }
 }
 /** Sections the package defines itself in its `texts/<lang>/strings` files. */
@@ -101,7 +101,7 @@ function checkUiConfig(file, sections, findings) {
     }
     catch { /* reported below */ }
     if (typeof config !== "object" || config === null || Array.isArray(config)) {
-        findings.add("SPK_UI_CONFIG_INVALID", `${file.path} 不是 JSON 物件。`, at(file.path));
+        findings.add("SPK_UI_CONFIG_INVALID", `${file.path} is not a JSON object.`, at(file.path));
         return;
     }
     for (const group of Object.values(config)) {
@@ -116,7 +116,7 @@ function checkUiConfig(file, sections, findings) {
                 if (!ref)
                     continue;
                 const own = ref[1] === "synopkgland" || sections.has(ref[1]);
-                findings.add(own ? "SPK_UI_TEXTS_MISSING" : "SPK_UI_TEXTS_UNDECLARED", `${file.path} 的 ${id}.${field}「${value}」是字串參照，但這個 entry 沒有宣告 "texts"；${own ? "DSM 會直接顯示這個 key" : "除非是 DSM 內建的 section，否則 DSM 會直接顯示這個 key"}。`, at(file.path));
+                findings.add(own ? "SPK_UI_TEXTS_MISSING" : "SPK_UI_TEXTS_UNDECLARED", `${file.path} has ${id}.${field} "${value}" as a string reference, but the entry does not declare "texts"; ${own ? "DSM shows this key directly" : "unless it is a DSM built-in section, DSM shows this key directly"}.`, at(file.path));
             }
         }
     }
@@ -132,16 +132,16 @@ function checkElf(files, arch, findings) {
             continue;
         const machine = file.head[5] === 2 ? file.head.readUInt16BE(18) : file.head.readUInt16LE(18);
         if (noarch) {
-            findings.add("SPK_NOARCH_ELF", `${file.path} 是 ELF 執行檔，但 INFO arch 是 noarch；noarch 套件只能有腳本，否則在其他 CPU 的 NAS 上無法執行。`, at(file.path));
+            findings.add("SPK_NOARCH_ELF", `${file.path} is an ELF executable, but INFO arch is noarch; a noarch package may contain only scripts, otherwise it cannot run on NAS models with another CPU.`, at(file.path));
         }
         else if (checkable && !machines.has(machine)) {
-            findings.add("SPK_ELF_ARCH_MISMATCH", `${file.path} 的 ELF machine 是 ${machine}，與 INFO arch「${arch}」的 CPU 不符。`, at(file.path));
+            findings.add("SPK_ELF_ARCH_MISMATCH", `The ELF machine of ${file.path} is ${machine}, which does not match the CPU of INFO arch "${arch}".`, at(file.path));
         }
     }
 }
 export async function checkPayload(payloadPath, info, findings) {
     if (startsWith(payloadPath, XZ_MAGIC)) {
-        findings.add("SPK_PAYLOAD_XZ", "package.tgz 是 xz 壓縮（Synology toolkit 的格式）；inspect 讀不了 xz，沒有檢查 payload 內容。", "package.tgz");
+        findings.add("SPK_PAYLOAD_XZ", "package.tgz is xz-compressed (the Synology toolkit format); inspect cannot read xz and did not check the payload contents.", "package.tgz");
         return;
     }
     const dirs = uiDirs(info.dsmuidir);

package/dist/spk/rules.d.ts

@@ -13,252 +13,252 @@ export interface SpkRule {
 export declare const SPK_RULES: {
     readonly SPK_NOT_TAR: {
         readonly severity: "error";
-        readonly description: "檔案不是可讀的 tar 封存；SPK 是未壓縮的 tar。";
+        readonly description: "The file is not a readable tar archive; an SPK is an uncompressed tar.";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_ENTRY_UNSAFE: {
         readonly severity: "error";
-        readonly description: "SPK 內的路徑跳出封存根目錄（絕對路徑或 ..），或是連結。";
+        readonly description: "A path inside the SPK escapes the archive root (an absolute path or ..), or is a link.";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_ENTRY_UNKNOWN: {
         readonly severity: "warning";
-        readonly description: "SPK 最上層有指南沒有列出的檔案或目錄（檔名區分大小寫）。";
+        readonly description: "The SPK top level has a file or directory the guide does not list (file names are case-sensitive).";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_INFO_MISSING: {
         readonly severity: "error";
-        readonly description: "缺少 INFO。";
+        readonly description: "INFO is missing.";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_PAYLOAD_MISSING: {
         readonly severity: "error";
-        readonly description: "缺少 package.tgz。";
+        readonly description: "package.tgz is missing.";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_INFO_FIELD_REQUIRED: {
         readonly severity: "error";
-        readonly description: "INFO 缺少必填欄位（package、version、os_min_ver、description、arch、maintainer）。";
+        readonly description: "INFO is missing a required field (package, version, os_min_ver, description, arch, maintainer).";
         readonly source: "DSM 7 Developer Guide: INFO Necessary Fields";
     };
     readonly SPK_INFO_DISPLAYNAME_MISSING: {
         readonly severity: "warning";
-        readonly description: "INFO 沒有 displayname；Package Center 會改顯示 package 值。";
+        readonly description: "INFO has no displayname; Package Center shows the package value instead.";
         readonly source: "DSM 7 Developer Guide: INFO Optional Fields";
     };
     readonly SPK_INFO_LINE_INVALID: {
         readonly severity: "warning";
-        readonly description: "INFO 有一行不是 key=\"value\"（空行與 # 註解除外）。";
+        readonly description: "INFO has a line that is not key=\"value\" (blank lines and # comments excepted).";
         readonly source: "DSM 7 Developer Guide: INFO";
     };
     readonly SPK_INFO_VALUE_UNTERMINATED: {
         readonly severity: "error";
-        readonly description: "INFO 欄位值的引號沒有結束。";
+        readonly description: "An INFO field value has an unterminated quote.";
         readonly source: "DSM 7 Developer Guide: INFO";
     };
     readonly SPK_INFO_FIELD_DUPLICATE: {
         readonly severity: "warning";
-        readonly description: "INFO 同一個欄位設定了兩次。";
+        readonly description: "INFO sets the same field twice.";
         readonly source: "DSM 7 Developer Guide: INFO";
     };
     readonly SPK_INFO_PACKAGE_INVALID: {
         readonly severity: "error";
-        readonly description: "INFO package 含有 : / > < | = 其中之一。";
+        readonly description: "INFO package contains one of : / > < | =.";
         readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (package)";
     };
     readonly SPK_INFO_VERSION_INVALID: {
         readonly severity: "error";
-        readonly description: "INFO version 不是以 .、-、_ 分隔的數字，或某段超過 2147483647。";
+        readonly description: "INFO version is not numbers separated by . - _, or a segment exceeds 2147483647.";
         readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (version)";
     };
     readonly SPK_INFO_VERSION_NO_BUILD: {
         readonly severity: "warning";
-        readonly description: "INFO version 沒有 -<build> 編號（指南格式為 [feature number]-[build number]）。";
+        readonly description: "INFO version has no -<build> number (the guide format is [feature number]-[build number]).";
         readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (version)";
     };
     readonly SPK_INFO_OS_VER_INVALID: {
         readonly severity: "error";
-        readonly description: "INFO os_min_ver 或 os_max_ver 不是 <major>.<minor>-<build>（也接受 <major>.<minor>.<micro>-<build>）。";
+        readonly description: "INFO os_min_ver or os_max_ver is not <major>.<minor>-<build> (<major>.<minor>.<micro>-<build> is also accepted).";
         readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (os_min_ver), Optional Fields (os_max_ver)";
     };
     readonly SPK_INFO_OS_MIN_VER_LOW: {
         readonly severity: "warning";
-        readonly description: "INFO os_min_ver 低於 7.0-40000。";
+        readonly description: "INFO os_min_ver is below 7.0-40000.";
         readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (os_min_ver)";
     };
     readonly SPK_INFO_ARCH_UNKNOWN: {
         readonly severity: "warning";
-        readonly description: "INFO arch 或 exclude_arch 含有 Appendix A 與已知 DSM 7 平台都沒有的值。";
+        readonly description: "INFO arch or exclude_arch has a value that is in neither Appendix A nor the known DSM 7 platforms.";
         readonly source: "DSM 7 Developer Guide: Appendix A Platform and Arch Value Mapping Table";
     };
     readonly SPK_INFO_ARCH_NOARCH_MIXED: {
         readonly severity: "warning";
-        readonly description: "INFO arch 同時有 noarch 與其他值。";
+        readonly description: "INFO arch has noarch together with other values.";
         readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (arch)";
     };
     readonly SPK_INFO_BOOLEAN_INVALID: {
         readonly severity: "error";
-        readonly description: "INFO 的 yes/no 欄位（例如 startable、silent_install）不是 \"yes\" 或 \"no\"。";
+        readonly description: "An INFO yes/no field (for example startable, silent_install) is not \"yes\" or \"no\".";
         readonly source: "DSM 7 Developer Guide: INFO Optional Fields";
     };
     readonly SPK_INFO_LANG_UNKNOWN: {
         readonly severity: "warning";
-        readonly description: "displayname_<lang> 或 description_<lang> 的語言碼不在指南清單（enu、cht、chs、jpn…）。";
+        readonly description: "The language code of displayname_<lang> or description_<lang> is not in the guide list (enu, cht, chs, jpn...).";
         readonly source: "DSM 7 Developer Guide: INFO Optional Fields (description_[language])";
     };
     readonly SPK_INFO_FIELD_UNKNOWN: {
         readonly severity: "warning";
-        readonly description: "INFO 欄位不在指南清單；DSM 不會使用它（拼錯的欄位名稱也會出現在這裡）。";
+        readonly description: "An INFO field is not in the guide list; DSM does not use it (misspelled field names also show up here).";
         readonly source: "DSM 7 Developer Guide: INFO Necessary Fields, Optional Fields";
     };
     readonly SPK_INFO_ADMINPORT_INVALID: {
         readonly severity: "error";
-        readonly description: "INFO adminport 不是 0–65536 的整數。";
+        readonly description: "INFO adminport is not an integer from 0 to 65536.";
         readonly source: "DSM 7 Developer Guide: INFO Optional Fields (adminport)";
     };
     readonly SPK_INFO_CHECKSUM_MISMATCH: {
         readonly severity: "error";
-        readonly description: "INFO checksum 不是 package.tgz 的 MD5。";
+        readonly description: "INFO checksum is not the MD5 of package.tgz.";
         readonly source: "DSM 7 Developer Guide: INFO Optional Fields (checksum)";
     };
     readonly SPK_PAYLOAD_UNREADABLE: {
         readonly severity: "error";
-        readonly description: "package.tgz 不是可讀的 tar 或 tar.gz 封存，或是空的。";
+        readonly description: "package.tgz is not a readable tar or tar.gz archive, or is empty.";
         readonly source: "DSM 7 Developer Guide: Package Structure (package.tgz)";
     };
     readonly SPK_PAYLOAD_XZ: {
         readonly severity: "warning";
-        readonly description: "package.tgz 是 xz 壓縮（Synology toolkit 的格式）；inspect 讀不了 xz，沒有檢查 payload 內容。";
+        readonly description: "package.tgz is xz-compressed (the Synology toolkit format); inspect cannot read xz and did not check the payload contents.";
         readonly source: "DSM 7 Developer Guide: Pack Stage";
     };
     readonly SPK_PAYLOAD_PATH_UNSAFE: {
         readonly severity: "error";
-        readonly description: "package.tgz 的路徑是絕對路徑或含 ..，會解開到套件目錄之外。";
+        readonly description: "A package.tgz path is absolute or contains .., so it extracts outside the package directory.";
         readonly source: "DSM 7 Developer Guide: Package Structure (package.tgz)";
     };
     readonly SPK_PAYLOAD_LINK_ESCAPE: {
         readonly severity: "error";
-        readonly description: "package.tgz 的 symlink 或 hard link 指到套件目錄之外。";
+        readonly description: "A package.tgz symlink or hard link points outside the package directory.";
         readonly source: "DSM 7 Developer Guide: Package Structure (package.tgz)";
     };
     readonly SPK_PAYLOAD_LINK_ABSOLUTE: {
         readonly severity: "warning";
-        readonly description: "package.tgz 的 symlink 指向絕對路徑；目標由 NAS 決定，不在套件內。";
+        readonly description: "A package.tgz symlink points at an absolute path; the target is determined by the NAS, not inside the package.";
         readonly source: "DSM 7 Developer Guide: Package Structure (package.tgz)";
     };
     readonly SPK_UI_CONFIG_INVALID: {
         readonly severity: "error";
-        readonly description: "dsmuidir 底下的 config 不是 JSON 物件。";
+        readonly description: "The config under dsmuidir is not a JSON object.";
         readonly source: "DSM 7 Developer Guide: Integrate DSM, Application Config";
     };
     readonly SPK_UI_TEXTS_MISSING: {
         readonly severity: "error";
-        readonly description: "config 的 title／desc 參照套件自己的字串（例如 synopkgland:app_title），但該 entry 沒有宣告 \"texts\"；DSM 會直接顯示 key。";
-        readonly source: "DSM 7.1.1／7.4 實測（DSM 只為宣告 texts 的 entry 載入 texts/<lang>/strings）";
+        readonly description: "The config title/desc references a package string (for example synopkgland:app_title), but the entry does not declare \"texts\"; DSM shows the key directly.";
+        readonly source: "Measured on DSM 7.1.1/7.4 (DSM loads texts/<lang>/strings only for entries that declare texts)";
     };
     readonly SPK_UI_TEXTS_UNDECLARED: {
         readonly severity: "warning";
-        readonly description: "config 的 title／desc 是 section:key 字串參照，但沒有宣告 \"texts\"；除非是 DSM 內建 section，否則 DSM 會直接顯示 key。";
-        readonly source: "DSM 7.1.1／7.4 實測";
+        readonly description: "The config title/desc is a section:key string reference but does not declare \"texts\"; unless it is a DSM built-in section, DSM shows the key directly.";
+        readonly source: "Measured on DSM 7.1.1/7.4";
     };
     readonly SPK_NOARCH_ELF: {
         readonly severity: "error";
-        readonly description: "INFO arch 是 noarch，但 package.tgz 有 ELF 執行檔。";
-        readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (arch)、Pack Stage";
+        readonly description: "INFO arch is noarch, but package.tgz contains an ELF executable.";
+        readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (arch), Pack Stage";
     };
     readonly SPK_ELF_ARCH_MISMATCH: {
         readonly severity: "error";
-        readonly description: "package.tgz 的 ELF 執行檔與 INFO arch 的 CPU 不符。";
-        readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (arch)、Appendix A";
+        readonly description: "An ELF executable in package.tgz does not match the CPU of INFO arch.";
+        readonly source: "DSM 7 Developer Guide: INFO Necessary Fields (arch), Appendix A";
     };
     readonly SPK_SCRIPT_MISSING: {
         readonly severity: "error";
-        readonly description: "缺少 scripts/start-stop-status；DSM 用它啟動、停止與查詢套件狀態。";
-        readonly source: "DSM 7 Developer Guide: Package Structure、scripts";
+        readonly description: "scripts/start-stop-status is missing; DSM uses it to start, stop and query the package status.";
+        readonly source: "DSM 7 Developer Guide: Package Structure, scripts";
     };
     readonly SPK_SCRIPT_HOOK_MISSING: {
         readonly severity: "warning";
-        readonly description: "缺少 preinst、postinst、preuninst、postuninst、preupgrade 或 postupgrade；指南列為必備，DSM 缺檔時的行為未驗證。";
+        readonly description: "preinst, postinst, preuninst, postuninst, preupgrade or postupgrade is missing; the guide lists them as required, and DSM's behavior without them is unverified.";
         readonly source: "DSM 7 Developer Guide: scripts";
     };
     readonly SPK_SCRIPT_NOT_EXECUTABLE: {
         readonly severity: "error";
-        readonly description: "scripts/ 的生命週期腳本沒有執行權限。";
+        readonly description: "A scripts/ lifecycle script is not executable.";
         readonly source: "DSM 7 Developer Guide: scripts";
     };
     readonly SPK_SCRIPT_NO_INTERPRETER: {
         readonly severity: "warning";
-        readonly description: "生命週期腳本開頭沒有 #!（例如 #!/bin/sh），也不是 ELF。";
+        readonly description: "A lifecycle script starts without #! (for example #!/bin/sh) and is not an ELF.";
         readonly source: "DSM 7 Developer Guide: scripts";
     };
     readonly SPK_PRIVILEGE_MISSING: {
         readonly severity: "error";
-        readonly description: "缺少 conf/privilege；DSM 7 起必須提供。";
-        readonly source: "DSM 7 Developer Guide: conf、Privilege Config";
+        readonly description: "conf/privilege is missing; DSM 7 requires it.";
+        readonly source: "DSM 7 Developer Guide: conf, Privilege Config";
     };
     readonly SPK_PRIVILEGE_INVALID: {
         readonly severity: "error";
-        readonly description: "conf/privilege 不是 JSON 物件、沒有 defaults.run-as，或 run-as 不是 package／root。";
+        readonly description: "conf/privilege is not a JSON object, has no defaults.run-as, or run-as is not package/root.";
         readonly source: "DSM 7 Developer Guide: Privilege Config";
     };
     readonly SPK_PRIVILEGE_ROOT: {
         readonly severity: "warning";
-        readonly description: "conf/privilege 要求以 root 執行（defaults、ctrl-script 或 executable）。";
+        readonly description: "conf/privilege requires running as root (defaults, ctrl-script or executable).";
         readonly source: "DSM 7 Developer Guide: Privilege Config";
     };
     readonly SPK_RESOURCE_INVALID: {
         readonly severity: "error";
-        readonly description: "conf/resource 不是 JSON 物件。";
+        readonly description: "conf/resource is not a JSON object.";
         readonly source: "DSM 7 Developer Guide: Resource Config";
     };
     readonly SPK_RESOURCE_UNKNOWN: {
         readonly severity: "warning";
-        readonly description: "conf/resource 有指南沒有列出的 resource worker id。";
+        readonly description: "conf/resource has a resource worker id the guide does not list.";
         readonly source: "DSM 7 Developer Guide: Available Workers";
     };
     readonly SPK_CONF_UNKNOWN: {
         readonly severity: "warning";
-        readonly description: "conf/ 有 DSM 不讀取的檔案（已知：privilege、resource、PKG_DEPS、PKG_CONX、systemd/）。";
-        readonly source: "DSM 7 Developer Guide: conf、Systemd User Unit";
+        readonly description: "conf/ has a file DSM does not read (known: privilege, resource, PKG_DEPS, PKG_CONX, systemd/).";
+        readonly source: "DSM 7 Developer Guide: conf, Systemd User Unit";
     };
     readonly SPK_ICON_MISSING: {
         readonly severity: "error";
-        readonly description: "缺少 PACKAGE_ICON.PNG 或 PACKAGE_ICON_256.PNG。";
+        readonly description: "PACKAGE_ICON.PNG or PACKAGE_ICON_256.PNG is missing.";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_ICON_INVALID: {
         readonly severity: "error";
-        readonly description: "PACKAGE_ICON.PNG 或 PACKAGE_ICON_256.PNG 不是 PNG。";
+        readonly description: "PACKAGE_ICON.PNG or PACKAGE_ICON_256.PNG is not a PNG.";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_ICON_SIZE: {
         readonly severity: "warning";
-        readonly description: "PACKAGE_ICON.PNG 不是 64×64，或 PACKAGE_ICON_256.PNG 不是 256×256。";
+        readonly description: "PACKAGE_ICON.PNG is not 64x64, or PACKAGE_ICON_256.PNG is not 256x256.";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_LICENSE_TOO_LARGE: {
         readonly severity: "error";
-        readonly description: "LICENSE 大於或等於 1 MB。";
+        readonly description: "LICENSE is 1 MB or larger.";
         readonly source: "DSM 7 Developer Guide: Package Structure";
     };
     readonly SPK_WIZARD_INVALID: {
         readonly severity: "warning";
-        readonly description: "WIZARD_UIFILES 的精靈檔不是 JSON 陣列。";
+        readonly description: "A WIZARD_UIFILES wizard file is not a JSON array.";
         readonly source: "DSM 7 Developer Guide: Package Structure (WIZARD_UIFILES)";
     };
     readonly SPK_WIZARD_SCRIPT_NOT_EXECUTABLE: {
         readonly severity: "warning";
-        readonly description: "WIZARD_UIFILES 的 .sh 精靈產生器沒有執行權限。";
+        readonly description: "A WIZARD_UIFILES .sh wizard generator is not executable.";
         readonly source: "DSM 7 Developer Guide: Package Structure (WIZARD_UIFILES)";
     };
     readonly SPK_WIZARD_UNKNOWN: {
         readonly severity: "warning";
-        readonly description: "WIZARD_UIFILES 的檔名不是 install／upgrade／uninstall_uifile[_<lang>][.sh]。";
+        readonly description: "A WIZARD_UIFILES file name is not install/upgrade/uninstall_uifile[_<lang>][.sh].";
         readonly source: "DSM 7 Developer Guide: Package Structure (WIZARD_UIFILES)";
     };
     readonly SPK_SIGNATURE_INVALID: {
         readonly severity: "warning";
-        readonly description: "syno_signature.asc 不是 ASCII-armored PGP 簽章（指南的套件簽章只適用 DSM 6.x，可省略此檔）。";
+        readonly description: "syno_signature.asc is not an ASCII-armored PGP signature (the guide's package signing applies only to DSM 6.x, so this file may be omitted).";
         readonly source: "DSM 7 Developer Guide: Sign Package (only for DSM6.X)";
     };
 };

package/dist/spk/rules.js

@@ -1,53 +1,53 @@
 const GUIDE = "DSM 7 Developer Guide";
 export const SPK_RULES = {
-    SPK_NOT_TAR: { severity: "error", description: "檔案不是可讀的 tar 封存；SPK 是未壓縮的 tar。", source: `${GUIDE}: Package Structure` },
-    SPK_ENTRY_UNSAFE: { severity: "error", description: "SPK 內的路徑跳出封存根目錄（絕對路徑或 ..），或是連結。", source: `${GUIDE}: Package Structure` },
-    SPK_ENTRY_UNKNOWN: { severity: "warning", description: "SPK 最上層有指南沒有列出的檔案或目錄（檔名區分大小寫）。", source: `${GUIDE}: Package Structure` },
-    SPK_INFO_MISSING: { severity: "error", description: "缺少 INFO。", source: `${GUIDE}: Package Structure` },
-    SPK_PAYLOAD_MISSING: { severity: "error", description: "缺少 package.tgz。", source: `${GUIDE}: Package Structure` },
-    SPK_INFO_FIELD_REQUIRED: { severity: "error", description: "INFO 缺少必填欄位（package、version、os_min_ver、description、arch、maintainer）。", source: `${GUIDE}: INFO Necessary Fields` },
-    SPK_INFO_DISPLAYNAME_MISSING: { severity: "warning", description: "INFO 沒有 displayname；Package Center 會改顯示 package 值。", source: `${GUIDE}: INFO Optional Fields` },
-    SPK_INFO_LINE_INVALID: { severity: "warning", description: "INFO 有一行不是 key=\"value\"（空行與 # 註解除外）。", source: `${GUIDE}: INFO` },
-    SPK_INFO_VALUE_UNTERMINATED: { severity: "error", description: "INFO 欄位值的引號沒有結束。", source: `${GUIDE}: INFO` },
-    SPK_INFO_FIELD_DUPLICATE: { severity: "warning", description: "INFO 同一個欄位設定了兩次。", source: `${GUIDE}: INFO` },
-    SPK_INFO_PACKAGE_INVALID: { severity: "error", description: "INFO package 含有 : / > < | = 其中之一。", source: `${GUIDE}: INFO Necessary Fields (package)` },
-    SPK_INFO_VERSION_INVALID: { severity: "error", description: "INFO version 不是以 .、-、_ 分隔的數字，或某段超過 2147483647。", source: `${GUIDE}: INFO Necessary Fields (version)` },
-    SPK_INFO_VERSION_NO_BUILD: { severity: "warning", description: "INFO version 沒有 -<build> 編號（指南格式為 [feature number]-[build number]）。", source: `${GUIDE}: INFO Necessary Fields (version)` },
-    SPK_INFO_OS_VER_INVALID: { severity: "error", description: "INFO os_min_ver 或 os_max_ver 不是 <major>.<minor>-<build>（也接受 <major>.<minor>.<micro>-<build>）。", source: `${GUIDE}: INFO Necessary Fields (os_min_ver), Optional Fields (os_max_ver)` },
-    SPK_INFO_OS_MIN_VER_LOW: { severity: "warning", description: "INFO os_min_ver 低於 7.0-40000。", source: `${GUIDE}: INFO Necessary Fields (os_min_ver)` },
-    SPK_INFO_ARCH_UNKNOWN: { severity: "warning", description: "INFO arch 或 exclude_arch 含有 Appendix A 與已知 DSM 7 平台都沒有的值。", source: `${GUIDE}: Appendix A Platform and Arch Value Mapping Table` },
-    SPK_INFO_ARCH_NOARCH_MIXED: { severity: "warning", description: "INFO arch 同時有 noarch 與其他值。", source: `${GUIDE}: INFO Necessary Fields (arch)` },
-    SPK_INFO_BOOLEAN_INVALID: { severity: "error", description: "INFO 的 yes/no 欄位（例如 startable、silent_install）不是 \"yes\" 或 \"no\"。", source: `${GUIDE}: INFO Optional Fields` },
-    SPK_INFO_LANG_UNKNOWN: { severity: "warning", description: "displayname_<lang> 或 description_<lang> 的語言碼不在指南清單（enu、cht、chs、jpn…）。", source: `${GUIDE}: INFO Optional Fields (description_[language])` },
-    SPK_INFO_FIELD_UNKNOWN: { severity: "warning", description: "INFO 欄位不在指南清單；DSM 不會使用它（拼錯的欄位名稱也會出現在這裡）。", source: `${GUIDE}: INFO Necessary Fields, Optional Fields` },
-    SPK_INFO_ADMINPORT_INVALID: { severity: "error", description: "INFO adminport 不是 0–65536 的整數。", source: `${GUIDE}: INFO Optional Fields (adminport)` },
-    SPK_INFO_CHECKSUM_MISMATCH: { severity: "error", description: "INFO checksum 不是 package.tgz 的 MD5。", source: `${GUIDE}: INFO Optional Fields (checksum)` },
-    SPK_PAYLOAD_UNREADABLE: { severity: "error", description: "package.tgz 不是可讀的 tar 或 tar.gz 封存，或是空的。", source: `${GUIDE}: Package Structure (package.tgz)` },
-    SPK_PAYLOAD_XZ: { severity: "warning", description: "package.tgz 是 xz 壓縮（Synology toolkit 的格式）；inspect 讀不了 xz，沒有檢查 payload 內容。", source: `${GUIDE}: Pack Stage` },
-    SPK_PAYLOAD_PATH_UNSAFE: { severity: "error", description: "package.tgz 的路徑是絕對路徑或含 ..，會解開到套件目錄之外。", source: `${GUIDE}: Package Structure (package.tgz)` },
-    SPK_PAYLOAD_LINK_ESCAPE: { severity: "error", description: "package.tgz 的 symlink 或 hard link 指到套件目錄之外。", source: `${GUIDE}: Package Structure (package.tgz)` },
-    SPK_PAYLOAD_LINK_ABSOLUTE: { severity: "warning", description: "package.tgz 的 symlink 指向絕對路徑；目標由 NAS 決定，不在套件內。", source: `${GUIDE}: Package Structure (package.tgz)` },
-    SPK_UI_CONFIG_INVALID: { severity: "error", description: "dsmuidir 底下的 config 不是 JSON 物件。", source: `${GUIDE}: Integrate DSM, Application Config` },
-    SPK_UI_TEXTS_MISSING: { severity: "error", description: "config 的 title／desc 參照套件自己的字串（例如 synopkgland:app_title），但該 entry 沒有宣告 \"texts\"；DSM 會直接顯示 key。", source: "DSM 7.1.1／7.4 實測（DSM 只為宣告 texts 的 entry 載入 texts/<lang>/strings）" },
-    SPK_UI_TEXTS_UNDECLARED: { severity: "warning", description: "config 的 title／desc 是 section:key 字串參照，但沒有宣告 \"texts\"；除非是 DSM 內建 section，否則 DSM 會直接顯示 key。", source: "DSM 7.1.1／7.4 實測" },
-    SPK_NOARCH_ELF: { severity: "error", description: "INFO arch 是 noarch，但 package.tgz 有 ELF 執行檔。", source: `${GUIDE}: INFO Necessary Fields (arch)、Pack Stage` },
-    SPK_ELF_ARCH_MISMATCH: { severity: "error", description: "package.tgz 的 ELF 執行檔與 INFO arch 的 CPU 不符。", source: `${GUIDE}: INFO Necessary Fields (arch)、Appendix A` },
-    SPK_SCRIPT_MISSING: { severity: "error", description: "缺少 scripts/start-stop-status；DSM 用它啟動、停止與查詢套件狀態。", source: `${GUIDE}: Package Structure、scripts` },
-    SPK_SCRIPT_HOOK_MISSING: { severity: "warning", description: "缺少 preinst、postinst、preuninst、postuninst、preupgrade 或 postupgrade；指南列為必備，DSM 缺檔時的行為未驗證。", source: `${GUIDE}: scripts` },
-    SPK_SCRIPT_NOT_EXECUTABLE: { severity: "error", description: "scripts/ 的生命週期腳本沒有執行權限。", source: `${GUIDE}: scripts` },
-    SPK_SCRIPT_NO_INTERPRETER: { severity: "warning", description: "生命週期腳本開頭沒有 #!（例如 #!/bin/sh），也不是 ELF。", source: `${GUIDE}: scripts` },
-    SPK_PRIVILEGE_MISSING: { severity: "error", description: "缺少 conf/privilege；DSM 7 起必須提供。", source: `${GUIDE}: conf、Privilege Config` },
-    SPK_PRIVILEGE_INVALID: { severity: "error", description: "conf/privilege 不是 JSON 物件、沒有 defaults.run-as，或 run-as 不是 package／root。", source: `${GUIDE}: Privilege Config` },
-    SPK_PRIVILEGE_ROOT: { severity: "warning", description: "conf/privilege 要求以 root 執行（defaults、ctrl-script 或 executable）。", source: `${GUIDE}: Privilege Config` },
-    SPK_RESOURCE_INVALID: { severity: "error", description: "conf/resource 不是 JSON 物件。", source: `${GUIDE}: Resource Config` },
-    SPK_RESOURCE_UNKNOWN: { severity: "warning", description: "conf/resource 有指南沒有列出的 resource worker id。", source: `${GUIDE}: Available Workers` },
-    SPK_CONF_UNKNOWN: { severity: "warning", description: "conf/ 有 DSM 不讀取的檔案（已知：privilege、resource、PKG_DEPS、PKG_CONX、systemd/）。", source: `${GUIDE}: conf、Systemd User Unit` },
-    SPK_ICON_MISSING: { severity: "error", description: "缺少 PACKAGE_ICON.PNG 或 PACKAGE_ICON_256.PNG。", source: `${GUIDE}: Package Structure` },
-    SPK_ICON_INVALID: { severity: "error", description: "PACKAGE_ICON.PNG 或 PACKAGE_ICON_256.PNG 不是 PNG。", source: `${GUIDE}: Package Structure` },
-    SPK_ICON_SIZE: { severity: "warning", description: "PACKAGE_ICON.PNG 不是 64×64，或 PACKAGE_ICON_256.PNG 不是 256×256。", source: `${GUIDE}: Package Structure` },
-    SPK_LICENSE_TOO_LARGE: { severity: "error", description: "LICENSE 大於或等於 1 MB。", source: `${GUIDE}: Package Structure` },
-    SPK_WIZARD_INVALID: { severity: "warning", description: "WIZARD_UIFILES 的精靈檔不是 JSON 陣列。", source: `${GUIDE}: Package Structure (WIZARD_UIFILES)` },
-    SPK_WIZARD_SCRIPT_NOT_EXECUTABLE: { severity: "warning", description: "WIZARD_UIFILES 的 .sh 精靈產生器沒有執行權限。", source: `${GUIDE}: Package Structure (WIZARD_UIFILES)` },
-    SPK_WIZARD_UNKNOWN: { severity: "warning", description: "WIZARD_UIFILES 的檔名不是 install／upgrade／uninstall_uifile[_<lang>][.sh]。", source: `${GUIDE}: Package Structure (WIZARD_UIFILES)` },
-    SPK_SIGNATURE_INVALID: { severity: "warning", description: "syno_signature.asc 不是 ASCII-armored PGP 簽章（指南的套件簽章只適用 DSM 6.x，可省略此檔）。", source: `${GUIDE}: Sign Package (only for DSM6.X)` },
+    SPK_NOT_TAR: { severity: "error", description: "The file is not a readable tar archive; an SPK is an uncompressed tar.", source: `${GUIDE}: Package Structure` },
+    SPK_ENTRY_UNSAFE: { severity: "error", description: "A path inside the SPK escapes the archive root (an absolute path or ..), or is a link.", source: `${GUIDE}: Package Structure` },
+    SPK_ENTRY_UNKNOWN: { severity: "warning", description: "The SPK top level has a file or directory the guide does not list (file names are case-sensitive).", source: `${GUIDE}: Package Structure` },
+    SPK_INFO_MISSING: { severity: "error", description: "INFO is missing.", source: `${GUIDE}: Package Structure` },
+    SPK_PAYLOAD_MISSING: { severity: "error", description: "package.tgz is missing.", source: `${GUIDE}: Package Structure` },
+    SPK_INFO_FIELD_REQUIRED: { severity: "error", description: "INFO is missing a required field (package, version, os_min_ver, description, arch, maintainer).", source: `${GUIDE}: INFO Necessary Fields` },
+    SPK_INFO_DISPLAYNAME_MISSING: { severity: "warning", description: "INFO has no displayname; Package Center shows the package value instead.", source: `${GUIDE}: INFO Optional Fields` },
+    SPK_INFO_LINE_INVALID: { severity: "warning", description: "INFO has a line that is not key=\"value\" (blank lines and # comments excepted).", source: `${GUIDE}: INFO` },
+    SPK_INFO_VALUE_UNTERMINATED: { severity: "error", description: "An INFO field value has an unterminated quote.", source: `${GUIDE}: INFO` },
+    SPK_INFO_FIELD_DUPLICATE: { severity: "warning", description: "INFO sets the same field twice.", source: `${GUIDE}: INFO` },
+    SPK_INFO_PACKAGE_INVALID: { severity: "error", description: "INFO package contains one of : / > < | =.", source: `${GUIDE}: INFO Necessary Fields (package)` },
+    SPK_INFO_VERSION_INVALID: { severity: "error", description: "INFO version is not numbers separated by . - _, or a segment exceeds 2147483647.", source: `${GUIDE}: INFO Necessary Fields (version)` },
+    SPK_INFO_VERSION_NO_BUILD: { severity: "warning", description: "INFO version has no -<build> number (the guide format is [feature number]-[build number]).", source: `${GUIDE}: INFO Necessary Fields (version)` },
+    SPK_INFO_OS_VER_INVALID: { severity: "error", description: "INFO os_min_ver or os_max_ver is not <major>.<minor>-<build> (<major>.<minor>.<micro>-<build> is also accepted).", source: `${GUIDE}: INFO Necessary Fields (os_min_ver), Optional Fields (os_max_ver)` },
+    SPK_INFO_OS_MIN_VER_LOW: { severity: "warning", description: "INFO os_min_ver is below 7.0-40000.", source: `${GUIDE}: INFO Necessary Fields (os_min_ver)` },
+    SPK_INFO_ARCH_UNKNOWN: { severity: "warning", description: "INFO arch or exclude_arch has a value that is in neither Appendix A nor the known DSM 7 platforms.", source: `${GUIDE}: Appendix A Platform and Arch Value Mapping Table` },
+    SPK_INFO_ARCH_NOARCH_MIXED: { severity: "warning", description: "INFO arch has noarch together with other values.", source: `${GUIDE}: INFO Necessary Fields (arch)` },
+    SPK_INFO_BOOLEAN_INVALID: { severity: "error", description: "An INFO yes/no field (for example startable, silent_install) is not \"yes\" or \"no\".", source: `${GUIDE}: INFO Optional Fields` },
+    SPK_INFO_LANG_UNKNOWN: { severity: "warning", description: "The language code of displayname_<lang> or description_<lang> is not in the guide list (enu, cht, chs, jpn...).", source: `${GUIDE}: INFO Optional Fields (description_[language])` },
+    SPK_INFO_FIELD_UNKNOWN: { severity: "warning", description: "An INFO field is not in the guide list; DSM does not use it (misspelled field names also show up here).", source: `${GUIDE}: INFO Necessary Fields, Optional Fields` },
+    SPK_INFO_ADMINPORT_INVALID: { severity: "error", description: "INFO adminport is not an integer from 0 to 65536.", source: `${GUIDE}: INFO Optional Fields (adminport)` },
+    SPK_INFO_CHECKSUM_MISMATCH: { severity: "error", description: "INFO checksum is not the MD5 of package.tgz.", source: `${GUIDE}: INFO Optional Fields (checksum)` },
+    SPK_PAYLOAD_UNREADABLE: { severity: "error", description: "package.tgz is not a readable tar or tar.gz archive, or is empty.", source: `${GUIDE}: Package Structure (package.tgz)` },
+    SPK_PAYLOAD_XZ: { severity: "warning", description: "package.tgz is xz-compressed (the Synology toolkit format); inspect cannot read xz and did not check the payload contents.", source: `${GUIDE}: Pack Stage` },
+    SPK_PAYLOAD_PATH_UNSAFE: { severity: "error", description: "A package.tgz path is absolute or contains .., so it extracts outside the package directory.", source: `${GUIDE}: Package Structure (package.tgz)` },
+    SPK_PAYLOAD_LINK_ESCAPE: { severity: "error", description: "A package.tgz symlink or hard link points outside the package directory.", source: `${GUIDE}: Package Structure (package.tgz)` },
+    SPK_PAYLOAD_LINK_ABSOLUTE: { severity: "warning", description: "A package.tgz symlink points at an absolute path; the target is determined by the NAS, not inside the package.", source: `${GUIDE}: Package Structure (package.tgz)` },
+    SPK_UI_CONFIG_INVALID: { severity: "error", description: "The config under dsmuidir is not a JSON object.", source: `${GUIDE}: Integrate DSM, Application Config` },
+    SPK_UI_TEXTS_MISSING: { severity: "error", description: "The config title/desc references a package string (for example synopkgland:app_title), but the entry does not declare \"texts\"; DSM shows the key directly.", source: "Measured on DSM 7.1.1/7.4 (DSM loads texts/<lang>/strings only for entries that declare texts)" },
+    SPK_UI_TEXTS_UNDECLARED: { severity: "warning", description: "The config title/desc is a section:key string reference but does not declare \"texts\"; unless it is a DSM built-in section, DSM shows the key directly.", source: "Measured on DSM 7.1.1/7.4" },
+    SPK_NOARCH_ELF: { severity: "error", description: "INFO arch is noarch, but package.tgz contains an ELF executable.", source: `${GUIDE}: INFO Necessary Fields (arch), Pack Stage` },
+    SPK_ELF_ARCH_MISMATCH: { severity: "error", description: "An ELF executable in package.tgz does not match the CPU of INFO arch.", source: `${GUIDE}: INFO Necessary Fields (arch), Appendix A` },
+    SPK_SCRIPT_MISSING: { severity: "error", description: "scripts/start-stop-status is missing; DSM uses it to start, stop and query the package status.", source: `${GUIDE}: Package Structure, scripts` },
+    SPK_SCRIPT_HOOK_MISSING: { severity: "warning", description: "preinst, postinst, preuninst, postuninst, preupgrade or postupgrade is missing; the guide lists them as required, and DSM's behavior without them is unverified.", source: `${GUIDE}: scripts` },
+    SPK_SCRIPT_NOT_EXECUTABLE: { severity: "error", description: "A scripts/ lifecycle script is not executable.", source: `${GUIDE}: scripts` },
+    SPK_SCRIPT_NO_INTERPRETER: { severity: "warning", description: "A lifecycle script starts without #! (for example #!/bin/sh) and is not an ELF.", source: `${GUIDE}: scripts` },
+    SPK_PRIVILEGE_MISSING: { severity: "error", description: "conf/privilege is missing; DSM 7 requires it.", source: `${GUIDE}: conf, Privilege Config` },
+    SPK_PRIVILEGE_INVALID: { severity: "error", description: "conf/privilege is not a JSON object, has no defaults.run-as, or run-as is not package/root.", source: `${GUIDE}: Privilege Config` },
+    SPK_PRIVILEGE_ROOT: { severity: "warning", description: "conf/privilege requires running as root (defaults, ctrl-script or executable).", source: `${GUIDE}: Privilege Config` },
+    SPK_RESOURCE_INVALID: { severity: "error", description: "conf/resource is not a JSON object.", source: `${GUIDE}: Resource Config` },
+    SPK_RESOURCE_UNKNOWN: { severity: "warning", description: "conf/resource has a resource worker id the guide does not list.", source: `${GUIDE}: Available Workers` },
+    SPK_CONF_UNKNOWN: { severity: "warning", description: "conf/ has a file DSM does not read (known: privilege, resource, PKG_DEPS, PKG_CONX, systemd/).", source: `${GUIDE}: conf, Systemd User Unit` },
+    SPK_ICON_MISSING: { severity: "error", description: "PACKAGE_ICON.PNG or PACKAGE_ICON_256.PNG is missing.", source: `${GUIDE}: Package Structure` },
+    SPK_ICON_INVALID: { severity: "error", description: "PACKAGE_ICON.PNG or PACKAGE_ICON_256.PNG is not a PNG.", source: `${GUIDE}: Package Structure` },
+    SPK_ICON_SIZE: { severity: "warning", description: "PACKAGE_ICON.PNG is not 64x64, or PACKAGE_ICON_256.PNG is not 256x256.", source: `${GUIDE}: Package Structure` },
+    SPK_LICENSE_TOO_LARGE: { severity: "error", description: "LICENSE is 1 MB or larger.", source: `${GUIDE}: Package Structure` },
+    SPK_WIZARD_INVALID: { severity: "warning", description: "A WIZARD_UIFILES wizard file is not a JSON array.", source: `${GUIDE}: Package Structure (WIZARD_UIFILES)` },
+    SPK_WIZARD_SCRIPT_NOT_EXECUTABLE: { severity: "warning", description: "A WIZARD_UIFILES .sh wizard generator is not executable.", source: `${GUIDE}: Package Structure (WIZARD_UIFILES)` },
+    SPK_WIZARD_UNKNOWN: { severity: "warning", description: "A WIZARD_UIFILES file name is not install/upgrade/uninstall_uifile[_<lang>][.sh].", source: `${GUIDE}: Package Structure (WIZARD_UIFILES)` },
+    SPK_SIGNATURE_INVALID: { severity: "warning", description: "syno_signature.asc is not an ASCII-armored PGP signature (the guide's package signing applies only to DSM 6.x, so this file may be omitted).", source: `${GUIDE}: Sign Package (only for DSM6.X)` },
 };

package/dist/spk/validate-spk.js

@@ -22,7 +22,7 @@ export async function validateSpk(spkPath) {
             checkOuterEntries(outer.entries, findings);
             info = checkInfo(outer, findings);
             if (!outer.payloadPath)
-                findings.add("SPK_PAYLOAD_MISSING", "缺少 package.tgz。", "package.tgz");
+                findings.add("SPK_PAYLOAD_MISSING", "package.tgz is missing.", "package.tgz");
             else
                 await checkPayload(outer.payloadPath, info, findings);
             checkMetadata({ files: outer.files, modes: new Map(outer.entries.map((entry) => [normalize(entry.path), entry.mode])) }, findings);
@@ -71,7 +71,7 @@ async function readOuter(spkPath, dir, findings) {
         outer.entries.length = 0;
     }
     if (outer.entries.length === 0) {
-        findings.add("SPK_NOT_TAR", "檔案不是可讀的 tar 封存。");
+        findings.add("SPK_NOT_TAR", "The file is not a readable tar archive.");
         return undefined;
     }
     return outer;
@@ -86,19 +86,19 @@ function checkOuterEntries(entries, findings) {
     for (const entry of entries) {
         const path = normalize(entry.path);
         if (!isSafeOuter(entry.path, entry.type)) {
-            findings.add("SPK_ENTRY_UNSAFE", `${entry.path} 跳出 SPK 根目錄或是連結；DSM 只解開一般檔案與目錄。`, entry.path);
+            findings.add("SPK_ENTRY_UNSAFE", `${entry.path} escapes the SPK root or is a link; DSM only extracts regular files and directories.`, entry.path);
             continue;
         }
         const top = path.split("/")[0];
         if (top && !TOP_LEVEL.has(top)) {
-            findings.add("SPK_ENTRY_UNKNOWN", `${top} 不是 SPK 最上層的已知檔案（檔名區分大小寫）。`, top);
+            findings.add("SPK_ENTRY_UNKNOWN", `${top} is not a known SPK top-level file (file names are case-sensitive).`, top);
         }
     }
 }
 function checkInfo(outer, findings) {
     const text = outer.files.get("INFO");
     if (text === undefined) {
-        findings.add("SPK_INFO_MISSING", "缺少 INFO。", "INFO");
+        findings.add("SPK_INFO_MISSING", "INFO is missing.", "INFO");
         return {};
     }
     const fields = parseInfo(text.toString("utf8"), findings);

package/dist/standalone/api-permissions.js

@@ -4,7 +4,7 @@ import { join } from "node:path";
 import { appSdkVersion, sdkSource } from "../runtime/sdk-source.js";
 import { parseDocument } from "yaml";
 /** The App route policy inside each backend kind's directory. */
-export const API_PERMISSIONS_FILE = { go: "internal/api/permissions.json", rust: "permissions.json" };
+export const API_PERMISSIONS_FILE = { go: "internal/api/permissions.json", rust: "permissions.json", python: "permissions.json", node: "permissions.json" };
 /** SDK-owned routes per capability, in the Go module of the SDK version the App requires. */
 const SDK_PERMISSIONS_FILE = "api/sdk-permissions.json";
 export const MAX_PERMISSIONS_BYTES = 65536;

package/dist/standalone/background.d.ts

@@ -16,7 +16,9 @@ export declare function backgroundUnitName(pkg: string): string;
 export declare function readBackground(value: unknown, fail: (error: StandaloneError) => void): Background | undefined;
 /** `conf/resource`: only the official user-unit resource. */
 export declare function renderBackgroundResource(): string;
-export declare function renderBackgroundUnit(pkg: string): string;
+/** The worker's arguments: none for a Go App's own worker, `--worker` for the bridge runtime (spec/bridge/v1). */
+export declare const BRIDGE_WORKER_ARGS: readonly ["--worker"];
+export declare function renderBackgroundUnit(pkg: string, args?: readonly string[]): string;
 /** Shell function that stops the worker in lifecycle hooks; call it as `stop_background_worker`. */
 export declare function renderBackgroundWorkerStop(pkg: string): string;
 /**