@synopackageland/cli 0.3.10 → 0.4.1

package/dist/host/dsm-client.js

@@ -1,17 +1,11 @@
 import { spawnSync } from "node:child_process";
-import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { IDENTITY_CGI_PATH } from "./broker-paths.js";
-import { packageSourceOrigin } from "../deploy/catalog-publish.js";
 import { listShareNamesWithSynoagentcli, lookupSharePathWithSynoagentcli } from "./share-lookup.js";
 import { createSynoagentcliApiCall, fetchSharePermissions, fetchUserGroups, } from "./share-permission-lookup.js";
 import { fetchPortInfo } from "./port-info-lookup.js";
 import { dsmFetch } from "./dsm-http.js";
 import { fetchDsmPortProfileInventory } from "./dsm-port-profile.js";
-import { installPackageFromCatalog, installPackageFromLocalSpk, uninstallPackageFromDsm, fetchInstalledPackageState, packageStateFromRecord, } from "./catalog-install.js";
+import { installPackageFromLocalSpk, fetchInstalledPackageState, packageStateFromRecord, } from "./catalog-install.js";
 import { resolveHostCredentials } from "./credentials.js";
-const OIDC_COMPAT_PATH = "/api/v1/inner-loop/oidc-compat";
 export function createNasHost(options = {}) {
     const credentials = options.credentials ?? resolveHostCredentials(options.host);
     if (!credentials) {
@@ -61,9 +55,7 @@ export function homesPathFromDsmUserHomeRead(result) {
 }
 function createDsmNasHost(credentials, profileName) {
     const dsmOrigin = credentials.dsmOrigin.replace(/\/$/, "");
-    const brokerBaseUrl = `${dsmOrigin}${IDENTITY_CGI_PATH}`;
     let cookieHeader = credentials.cookieHeader;
-    const projectEnvCache = new Map();
     const ensureLogin = async () => {
         if (cookieHeader) {
             return;
@@ -77,7 +69,10 @@ function createDsmNasHost(credentials, profileName) {
             session: "FileStation",
             format: "cookie",
         });
-        const response = await dsmFetch(`${dsmOrigin}/webapi/entry.cgi?${query.toString()}`);
+        const response = await dsmFetch(`${dsmOrigin}/webapi/entry.cgi`, { method: "POST", headers: { "content-type": "application/x-www-form-urlencoded" }, body: query });
+        const login = await response.json();
+        if (!response.ok || login.success !== true)
+            throw new Error("DSM login failed");
         const setCookie = typeof response.headers.getSetCookie === "function"
             ? response.headers.getSetCookie()
             : response.headers.get("set-cookie")
@@ -87,140 +82,18 @@ function createDsmNasHost(credentials, profileName) {
             .map((line) => line.split(";")[0]?.trim())
             .filter((pair) => Boolean(pair));
         cookieHeader = pairs.join("; ");
-    };
-    const ensureInnerLoopApi = async () => {
-        await ensureLogin();
-        const response = await dsmFetch(`${brokerBaseUrl}/api/v1/inner-loop/diagnostics?package=probe`, { headers: { cookie: cookieHeader ?? "" } });
-        const text = await response.text();
-        if (response.status === 404 || text.trimStart().startsWith("<")) {
-            const error = new Error("Broker inner-loop API 不可用（收到 HTML 404）。請將 SynoPkgLandService 升級到 >=0.1.0-0016。");
-            error.code = "INNER_LOOP_API_MISSING";
-            throw error;
-        }
-        try {
-            JSON.parse(text);
-        }
-        catch {
-            const error = new Error("Broker inner-loop API 回傳非 JSON 內容。");
-            error.code = "INNER_LOOP_API_MISSING";
-            throw error;
-        }
-    };
-    const ensurePackageSourceFeed = (origin) => {
-        const feed = origin.replace(/\/$/, "") + "/";
-        const list = synoagentcli(["dsm", "package-center", "source", "list"], profileName);
-        if (list.status !== 0) {
-            return;
-        }
-        const parsed = JSON.parse(list.stdout);
-        const items = parsed.data?.items ?? [];
-        const normalizedFeed = feed.replace(/\/$/, "");
-        const existing = items.find((item) => item.feed?.replace(/\/$/, "") === normalizedFeed);
-        if (existing) {
-            return;
-        }
-        const stale = items.find((item) => item.name === "package-land-throwaway");
-        const payload = { name: "package-land-throwaway", feed };
-        const staging = mkdtempSync(join(tmpdir(), "syno-package-source-feed-"));
-        const jsonPath = join(staging, "source.json");
-        writeFileSync(jsonPath, JSON.stringify(payload));
-        try {
-            if (stale?.feed) {
-                synoagentcli(["dsm", "package-center", "source", "update", stale.feed, "--json-file", jsonPath], profileName);
-                return;
-            }
-            synoagentcli(["dsm", "package-center", "source", "add", "--json-file", jsonPath], profileName);
-        }
-        finally {
-            rmSync(staging, { recursive: true, force: true });
-        }
+        if (!cookieHeader)
+            throw new Error("DSM login returned no session cookie");
     };
     return {
         dsmOrigin,
-        installationId: "live-nas",
-        async requestAttestation(input) {
-            await ensureInnerLoopApi();
+        async installFromLocalSpk(input) {
             await ensureLogin();
-            const response = await dsmFetch(`${brokerBaseUrl}/api/v1/inner-loop/attest`, {
-                method: "POST",
-                headers: {
-                    cookie: cookieHeader ?? "",
-                    "content-type": "application/json",
-                },
-                body: JSON.stringify(input),
+            await installPackageFromLocalSpk({
+                dsmOrigin, cookieHeader: cookieHeader ?? "",
+                packageId: input.packageId, spkPath: input.spkPath,
+                version: input.version, profileName, extraValues: input.extraValues,
             });
-            const text = await response.text();
-            let body;
-            try {
-                body = JSON.parse(text);
-            }
-            catch {
-                const error = new Error("Broker inner-loop attest 回傳非 JSON 內容。");
-                error.code = "INNER_LOOP_API_MISSING";
-                throw error;
-            }
-            if (!response.ok) {
-                const error = new Error(body.error?.message ?? `Attestation failed (${response.status})`);
-                error.code = body.error?.code;
-                throw error;
-            }
-            const token = typeof body.token === "string" && body.token.length > 0 ? body.token : undefined;
-            return {
-                kind: "local",
-                attestationDigest: body.attestationDigest ?? "",
-                ...(token !== undefined ? { token } : {}),
-            };
-        },
-        async ensurePackageSource(origin) {
-            ensurePackageSourceFeed(origin);
-        },
-        async installFromCatalog(input) {
-            try {
-                ensurePackageSourceFeed(packageSourceOrigin());
-                await ensureLogin();
-                await installPackageFromCatalog({
-                    dsmOrigin,
-                    cookieHeader: cookieHeader ?? "",
-                    packageId: input.packageId,
-                    profileName,
-                    expectedVersion: input.version,
-                    packageSourceOrigin: packageSourceOrigin(),
-                    extraValues: input.extraValues,
-                });
-            }
-            finally {
-                projectEnvCache.delete(input.packageId);
-            }
-        },
-        async installFromLocalSpk(input) {
-            try {
-                await ensureLogin();
-                await installPackageFromLocalSpk({
-                    dsmOrigin,
-                    cookieHeader: cookieHeader ?? "",
-                    packageId: input.packageId,
-                    spkPath: input.spkPath,
-                    version: input.version,
-                    profileName,
-                    extraValues: input.extraValues,
-                });
-            }
-            finally {
-                projectEnvCache.delete(input.packageId);
-            }
-        },
-        async uninstallPackage(packageIdentity) {
-            try {
-                await ensureLogin();
-                await uninstallPackageFromDsm({
-                    dsmOrigin,
-                    cookieHeader: cookieHeader ?? "",
-                    packageId: packageIdentity,
-                });
-            }
-            finally {
-                projectEnvCache.delete(packageIdentity);
-            }
         },
         async getArchFamily() {
             await ensureLogin();
@@ -261,44 +134,6 @@ function createDsmNasHost(credentials, profileName) {
                 return undefined;
             }
         },
-        async getInstalledProjectEnv(packageIdentity) {
-            const cached = projectEnvCache.get(packageIdentity);
-            if (cached) {
-                return cached;
-            }
-            const lookup = (async () => {
-                await ensureLogin();
-                const response = await dsmFetch(`${brokerBaseUrl}/api/v1/inner-loop/project-env/${encodeURIComponent(packageIdentity)}`, { headers: { cookie: cookieHeader ?? "" } });
-                if (response.ok) {
-                    const payload = (await response.json());
-                    if (!payload.env || typeof payload.env !== "object" || Array.isArray(payload.env)) {
-                        return undefined;
-                    }
-                    return Object.fromEntries(Object.entries(payload.env).filter((entry) => typeof entry[1] === "string"));
-                }
-                return undefined;
-            })();
-            projectEnvCache.set(packageIdentity, lookup);
-            return lookup;
-        },
-        async getAttestationInfo(packageIdentity) {
-            await ensureLogin();
-            const response = await dsmFetch(`${brokerBaseUrl}/api/v1/inner-loop/info/${encodeURIComponent(packageIdentity)}`, { headers: { cookie: cookieHeader ?? "" } });
-            const text = await response.text();
-            if (response.status === 404 || text.trimStart().startsWith("<")) {
-                const error = new Error("Broker inner-loop info 不可用（HTML 404）。");
-                error.code = "INNER_LOOP_API_MISSING";
-                throw error;
-            }
-            try {
-                return JSON.parse(text);
-            }
-            catch {
-                const error = new Error("Broker inner-loop info 回傳非 JSON 內容。");
-                error.code = "INNER_LOOP_API_MISSING";
-                throw error;
-            }
-        },
         async getInstalledPackageState(packageIdentity) {
             await ensureLogin();
             const viaDsm = await fetchInstalledPackageState(dsmOrigin, cookieHeader ?? "", packageIdentity);
@@ -355,21 +190,6 @@ function createDsmNasHost(credentials, profileName) {
                 .filter(Boolean)
                 .map((line) => `[status] ${line}`);
         },
-        async getDsmDiagnostics(packageIdentity) {
-            try {
-                await ensureLogin();
-                const pkg = packageIdentity ?? "probe";
-                const response = await dsmFetch(`${brokerBaseUrl}/api/v1/inner-loop/diagnostics?package=${encodeURIComponent(pkg)}`, { headers: { cookie: cookieHeader ?? "" } });
-                if (!response.ok) {
-                    return undefined;
-                }
-                const text = await response.text();
-                return JSON.parse(text);
-            }
-            catch {
-                return undefined;
-            }
-        },
         async getDsmPortProfileInventory() {
             try {
                 await ensureLogin();
@@ -379,86 +199,6 @@ function createDsmNasHost(credentials, profileName) {
                 return undefined;
             }
         },
-        async getOidcCompatSettings() {
-            try {
-                await ensureLogin();
-                const response = await dsmFetch(`${brokerBaseUrl}${OIDC_COMPAT_PATH}`, {
-                    headers: { cookie: cookieHeader ?? "" },
-                });
-                const text = await response.text();
-                if (response.status === 404 || text.trimStart().startsWith("<")) {
-                    return undefined;
-                }
-                if (!response.ok) {
-                    return undefined;
-                }
-                const payload = JSON.parse(text);
-                const settings = payload.settings;
-                if (!settings || typeof settings !== "object" || Array.isArray(settings)) {
-                    return undefined;
-                }
-                const record = settings;
-                const origin = record.origin;
-                if (!origin || typeof origin !== "object" || Array.isArray(origin)) {
-                    return undefined;
-                }
-                const originRecord = origin;
-                if (typeof record.enabled !== "boolean" ||
-                    typeof originRecord.ready !== "boolean" ||
-                    typeof originRecord.kind !== "string" ||
-                    typeof originRecord.setupHint !== "string") {
-                    return undefined;
-                }
-                return {
-                    enabled: record.enabled,
-                    origin: {
-                        ready: originRecord.ready,
-                        kind: originRecord.kind,
-                        hostname: typeof originRecord.hostname === "string" ? originRecord.hostname : undefined,
-                        issuerUrl: typeof originRecord.issuerUrl === "string" ? originRecord.issuerUrl : undefined,
-                        setupHint: originRecord.setupHint,
-                    },
-                };
-            }
-            catch {
-                return undefined;
-            }
-        },
-        async smokeRequireLogin(input) {
-            await ensureLogin();
-            const info = await this.getAttestationInfo(input.packageIdentity);
-            let openUrl = info.openUrl;
-            if (!openUrl) {
-                const pkg = synoagentcli(["dsm", "package-center", "get", input.packageIdentity], profileName);
-                if (pkg.status === 0) {
-                    try {
-                        const parsed = JSON.parse(pkg.stdout);
-                        openUrl = parsed.data?.url?.[0];
-                    }
-                    catch {
-                        // ignore parse errors
-                    }
-                }
-            }
-            if (!openUrl) {
-                return { ok: false };
-            }
-            const origin = new URL(openUrl).origin;
-            const response = await dsmFetch(`${brokerBaseUrl}/api/v1/auth/login`, {
-                method: "POST",
-                headers: {
-                    cookie: cookieHeader ?? input.cookieHeader,
-                    origin,
-                    "content-type": "application/json",
-                },
-                body: JSON.stringify({ packageId: input.packageIdentity }),
-            });
-            if (!response.ok) {
-                return { ok: false };
-            }
-            const body = (await response.json());
-            return { ok: Boolean(body.user?.username), username: body.user?.username };
-        },
     };
 }
 /**

package/dist/host/dsm-port-profile.d.ts

@@ -17,7 +17,6 @@ export interface DsmPortProfileInventory {
     orphaned: DsmPortProfile[];
 }
 /**
- * Parses the Docker .sc filename using the same rules as the Broker's
  * parsePortProfileFilename(). In particular, projectName is everything before
  * the final two dash-separated container segments.
  */

package/dist/host/dsm-port-profile.js

@@ -4,7 +4,6 @@ import { dsmFetch } from "./dsm-http.js";
 /** The precision caveat for the administrator-only fallback. */
 export const DSM_PORT_PROFILE_PRECISION_WARNING = "API 版未讀取 conf/resource；若有 App 自訂 Compose project 名可能誤報";
 /**
- * Parses the Docker .sc filename using the same rules as the Broker's
  * parsePortProfileFilename(). In particular, projectName is everything before
  * the final two dash-separated container segments.
  */
@@ -17,7 +16,6 @@ export function parsePortProfileFilename(filename) {
     if (!containerName) {
         return undefined;
     }
-    // Keep this split aligned with packages/broker/src/diagnostics/dsm-residue.ts:
     // remove the final -<service>-<replica> pair, not an identity-specific guess.
     const lastDash = containerName.lastIndexOf("-");
     if (lastDash <= 0) {

package/dist/host/types.d.ts

@@ -2,77 +2,19 @@ import type { SharePermissionListing } from "../deploy/share-permission-prefligh
 import type { InstalledPackageState } from "./catalog-install.js";
 import type { PortInfoEntry } from "./port-info.js";
 import type { DsmPortProfileInventory } from "./dsm-port-profile.js";
-export type AttestationKind = "local" | "app-package" | "none";
-export type PackageRoute = "package-only" | "broker-installer" | "unknown";
-export type OidcOriginKind = "public-ca" | "quickconnect" | "lan-ip" | "self-signed" | "private-ca" | "http";
-export interface HostOidcOriginEvaluation {
-    ready: boolean;
-    kind: OidcOriginKind;
-    hostname?: string;
-    issuerUrl?: string;
-    setupHint: string;
-}
-export interface HostOidcCompatSettings {
-    enabled: boolean;
-    origin: HostOidcOriginEvaluation;
-}
 export interface DeployIdentity {
     packageId: string;
     displayname: string;
     developmentInstance: boolean;
 }
-export interface AttestationIssueResult {
-    kind: "local";
-    attestationDigest: string;
-    token?: string;
-}
-export interface ResidueItem {
-    kind: "port_profile_sc" | "cm_project_config";
-    path: string;
-    name: string;
-    reason: string;
-}
-export interface DsmResidueInventory {
-    items: ResidueItem[];
-    unreadable: string[];
-}
-export interface HostAttestationInfo {
-    packageIdentity: string;
-    attestationKind: AttestationKind;
-    developmentInstance: boolean;
-    openUrl?: string;
-    readiness?: string;
-    projectName?: string;
-}
-export interface HostInstallRecord {
-    packageId: string;
-    version?: string;
-    source?: "package-center" | "local-spk";
-    extraValues?: Record<string, string>;
-}
 export interface NasHost {
     readonly dsmOrigin: string;
-    readonly installationId: string;
-    requestAttestation(input: {
-        packageIdentity: string;
-        contractDigest: string;
-        bundleDigest: string;
-        capabilities: string[];
-        allowCuratedDowngrade?: boolean;
-    }): Promise<AttestationIssueResult>;
-    installFromCatalog(input: {
-        packageId: string;
-        version?: string;
-        extraValues?: Record<string, string>;
-    }): Promise<void>;
-    installFromLocalSpk?(input: {
+    installFromLocalSpk(input: {
         packageId: string;
         version: string;
         spkPath: string;
         extraValues?: Record<string, string>;
     }): Promise<void>;
-    /** Stop and normally uninstall a formal package while preserving App Data. */
-    uninstallPackage?(packageIdentity: string): Promise<void>;
     /**
      * CPU family of this NAS, for picking a native App's target. Returns
      * undefined when the DSM answer does not map to a family we ship, so the
@@ -94,35 +36,11 @@ export interface NasHost {
     listPortInfo?(): Promise<PortInfoEntry[] | undefined>;
     /** Resolve the NAS-specific user-home root when DSM User Home is enabled. */
     resolveHomesPath?(): Promise<string | undefined>;
-    getInstalledProjectEnv?(packageIdentity: string): Promise<Record<string, string> | undefined>;
-    ensurePackageSource?(origin: string): Promise<void>;
     getInstalledPackageVersion?(packageIdentity: string): Promise<string | undefined>;
     getInstalledPackageState?(packageIdentity: string): Promise<InstalledPackageState | undefined>;
-    getAttestationInfo(packageIdentity: string): Promise<HostAttestationInfo>;
     isPackageInstalled(packageIdentity: string): Promise<boolean>;
     fetchContainerLogs(packageIdentity: string): Promise<string[]>;
-    getDsmDiagnostics?(packageIdentity?: string): Promise<{
-        dsmResidue?: DsmResidueInventory;
-        packageRoute?: PackageRoute;
-        isPackageOnly?: boolean;
-        [key: string]: unknown;
-    } | undefined>;
-    /**
-     * Read DSM PortInfo plus the administrator-visible installed package list.
-     * This path does not require SynoPkgLandService; undefined means the host
-     * could not answer and must be treated as unknown by diagnostics.
-     */
     getDsmPortProfileInventory?(): Promise<DsmPortProfileInventory | undefined>;
-    /** Read the optional administrator OIDC compatibility settings endpoint. */
-    getOidcCompatSettings?(): Promise<HostOidcCompatSettings | undefined>;
-    smokeRequireLogin(input: {
-        packageIdentity: string;
-        cookieHeader: string;
-    }): Promise<{
-        ok: boolean;
-        username?: string;
-    }>;
-    markCurated?(packageIdentity: string): void;
 }
 export interface HostCredentials {
     dsmOrigin: string;

package/dist/index.d.ts

@@ -6,14 +6,5 @@ export { initFromTemplate, isTemplateName } from "./init.js";
 export { runDev } from "./dev.js";
 export { testProject } from "./test-command.js";
 export { buildSpk } from "./build-spk/generator.js";
-export { publishProject, resolveCommunityAppsRoot } from "./publish/publish.js";
-export { communityAppsGitHubRepo, communityAppsGitHubUrl, DEFAULT_GITHUB_OWNER, } from "./publish/github-repo.js";
-export { InMemoryBuildLedger } from "./publish/build-ledger.js";
-export type { BuildLedger } from "./publish/build-ledger.js";
-export { createCuratedAttestationSignerFromEnv, isPublicOciDigest, releaseCurated, runCuratedRelease, runCuratedReleaseCli, digestReleaseBundle, validateCuratedCompose, } from "./publish/curated-release.js";
-export type { CuratedAttestationSignInput, CuratedAttestationSigner, CuratedComposeGateResult, CuratedReleaseSignInput, CuratedReleaseOptions, CuratedReleaseResult, } from "./publish/curated-release.js";
-export { canonicalAppPackageClaims, canonicalCuratedReleaseClaims, digestAppPackageClaims, digestCuratedReleaseClaims, normalizeCapabilities, assertPackageVersionBinding, signCuratedAppPackageAttestationToken, signCuratedReleaseAttestationToken, } from "./attestation/app-package.js";
-export type { AppPackageAttestationClaims, AppPackageSigningKey, CuratedAppPackageAttestationInput, CuratedReleaseAttestationClaims, CuratedReleaseAttestationInput, } from "./attestation/app-package.js";
-export { startMockBroker, FAKE_USER } from "./mock-broker/server.js";
 export { RecordingComposeRunner } from "./compose/runner.js";
 export type { ValidationError, ValidationResult } from "./types.js";

package/dist/index.js

@@ -5,10 +5,4 @@ export { initFromTemplate, isTemplateName } from "./init.js";
 export { runDev } from "./dev.js";
 export { testProject } from "./test-command.js";
 export { buildSpk } from "./build-spk/generator.js";
-export { publishProject, resolveCommunityAppsRoot } from "./publish/publish.js";
-export { communityAppsGitHubRepo, communityAppsGitHubUrl, DEFAULT_GITHUB_OWNER, } from "./publish/github-repo.js";
-export { InMemoryBuildLedger } from "./publish/build-ledger.js";
-export { createCuratedAttestationSignerFromEnv, isPublicOciDigest, releaseCurated, runCuratedRelease, runCuratedReleaseCli, digestReleaseBundle, validateCuratedCompose, } from "./publish/curated-release.js";
-export { canonicalAppPackageClaims, canonicalCuratedReleaseClaims, digestAppPackageClaims, digestCuratedReleaseClaims, normalizeCapabilities, assertPackageVersionBinding, signCuratedAppPackageAttestationToken, signCuratedReleaseAttestationToken, } from "./attestation/app-package.js";
-export { startMockBroker, FAKE_USER } from "./mock-broker/server.js";
 export { RecordingComposeRunner } from "./compose/runner.js";

package/dist/info.d.ts

@@ -8,7 +8,6 @@ export interface ProjectInfoOptions {
 export declare function projectInfo(options: ProjectInfoOptions): Promise<ProjectInfoResult>;
 export interface ProjectInfoResult {
     packageIdentity: string;
-    attestationKind: "local" | "app-package" | "none";
     developmentInstance: boolean;
     openUrl?: string;
     readiness?: string;

package/dist/info.js

@@ -3,27 +3,20 @@ import { appOriginFromContract } from "./host/open-url.js";
 import { resolveDeployIdentity } from "./deploy/identity.js";
 export async function projectInfo(options) {
     const identity = resolveDeployIdentity(options.project, { dev: options.dev });
-    const remote = await options.host.getAttestationInfo(identity.packageId);
+    const remote = await options.host.getInstalledPackageState?.(identity.packageId);
     const installed = await options.host.isPackageInstalled(identity.packageId);
     const contract = loadContract(options.project.contractPath).contract;
     return {
         packageIdentity: identity.packageId,
-        attestationKind: remote.attestationKind,
         developmentInstance: identity.developmentInstance,
-        openUrl: remote.openUrl ?? appOriginFromContract(options.host.dsmOrigin, contract),
-        readiness: remote.readiness ?? (installed ? "UNKNOWN" : "NOT_INSTALLED"),
+        openUrl: appOriginFromContract(options.host.dsmOrigin, contract),
+        readiness: remote?.status ?? (installed ? "UNKNOWN" : "NOT_INSTALLED"),
         installed,
     };
 }
 export function formatProjectInfo(info) {
-    const attestationLabel = info.attestationKind === "app-package"
-        ? "Curated（App Package Attestation）"
-        : info.attestationKind === "local"
-            ? "Local（Local Attestation）"
-            : "無";
     return [
         `Package Identity：${info.packageIdentity}`,
-        `Attestation：${attestationLabel}`,
         `開發用 Instance：${info.developmentInstance ? "是" : "否"}`,
         `已安裝：${info.installed ? "是" : "否"}`,
         info.openUrl ? `Open URL：${info.openUrl}` : "Open URL：（未設定）",

package/dist/init.d.ts

@@ -1,4 +1,18 @@
 import type { TemplateName } from "./types.js";
 export declare function isTemplateName(value: string): value is TemplateName;
 export declare function listTemplates(): TemplateName[];
-export declare function initFromTemplate(template: TemplateName, targetDir: string): void;
+export interface InitOptions {
+    /** Standalone templates: INFO.package (default: from the directory name). */
+    packageId?: string;
+    /** Standalone templates: display name (default: from the directory name). */
+    displayName?: string;
+    /** native-go: "root" adds administrator-approved root operations (default "none"). */
+    privilege?: "none" | "root";
+    ui?: "plain" | "vue";
+    integration?: "go" | "better-auth";
+    /** Pin the helper inventory protocol; protocol 2 still refuses NAS data. */
+    integrationProtocol?: 1 | 2;
+    /** Protocol 2 policy only; unavailable adapters still refuse data. */
+    dataAccess?: "unavailable" | "relaxed";
+}
+export declare function initFromTemplate(template: TemplateName, targetDir: string, options?: InitOptions): void;