@nocobase/cli 2.1.0-alpha.45 → 2.1.0-alpha.47

package/dist/commands/app/destroy.js

@@ -8,11 +8,14 @@
  */
 import { Command, Flags } from '@oclif/core';
 import { removeEnv } from '../../lib/auth-store.js';
-import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, runLocalNocoBaseCommand, } from '../../lib/app-runtime.js';
+import { formatMissingManagedAppEnvMessage, managedAppLifecycleEnvVars, resolveManagedAppRuntime, runLocalNocoBaseCommand, } from '../../lib/app-runtime.js';
 import { hasExplicitEnvSelection } from '../../lib/env-guard.js';
+import { resolveEnvProxyEntryDir, resolveLegacyNginxEnvProxyAppOutputPath } from "../../lib/env-proxy.js";
+import { resolveConfiguredStoragePath } from '../../lib/env-paths.js';
 import { input } from "../../lib/inquirer.js";
 import { announceTargetEnv, failTask, isInteractiveTerminal, printInfo, startTask, succeedTask } from '../../lib/ui.js';
-import { builtinDbContainerName, managedDockerNetworkName, removeDockerContainerIfExists, removeDockerNetworkIfUnused, removePathIfExists, resolveConfiguredPath, resolveManagedLocalAppPath, shouldRemoveManagedLocalAppFiles, } from './shared.js';
+import path from 'node:path';
+import { builtinDbContainerName, managedDockerNetworkName, removeDockerContainerIfExists, removeDockerNetworkIfUnused, removePathIfExists, resolveManagedLocalAppPath, shouldRemoveManagedLocalAppFiles, } from './shared.js';
 function formatDestroyFailure(envName, message) {
     return [
         `Couldn't destroy env "${envName}".`,
@@ -50,9 +53,7 @@ function buildDestroyPrompt(runtime, options) {
         if (options.removesManagedLocalAppFiles) {
             lines.push('CLI-managed local app files will also be removed.');
         }
-        else if (runtime.kind === 'local') {
-            lines.push('Custom local app source files will be kept.');
-        }
+        lines.push('Env-specific proxy entry files generated by `nb env proxy` will also be removed when present.');
         if (options.removesStorageData) {
             lines.push('Storage data will be removed.');
         }
@@ -91,8 +92,8 @@ async function confirmDestroy(runtime, options) {
     }
 }
 export default class AppDestroy extends Command {
-    static hidden = false;
-    static description = 'Destroy the selected env by removing managed runtime resources, storage data, and the saved CLI env config.';
+    static hidden = true;
+    static description = 'Deprecated compatibility alias for `nb env remove <name> --purge`.';
     static examples = [
         '<%= config.bin %> <%= command.id %> --env app1',
         '<%= config.bin %> <%= command.id %> --env app1 --force',
@@ -124,7 +125,7 @@ export default class AppDestroy extends Command {
             Boolean(resolveManagedLocalAppPath(runtime)) &&
             shouldRemoveManagedLocalAppFiles(runtime);
         const removesStorageData = (runtime.kind === 'local' || runtime.kind === 'docker') &&
-            Boolean(resolveConfiguredPath(runtime.env.config.storagePath));
+            Boolean(resolveConfiguredStoragePath(runtime.env.config));
         let confirmed = false;
         try {
             confirmed = await confirmDestroy(runtime, {
@@ -154,6 +155,7 @@ export default class AppDestroy extends Command {
             else if (runtime.kind === 'local') {
                 startTask(`Stopping local NocoBase app for "${runtime.envName}"...`);
                 await runLocalNocoBaseCommand(runtime, ['pm2', 'kill'], {
+                    env: managedAppLifecycleEnvVars(),
                     stdio: flags.verbose ? 'inherit' : 'ignore',
                 });
                 succeedTask(`Local NocoBase app stopped for "${runtime.envName}".`);
@@ -193,14 +195,21 @@ export default class AppDestroy extends Command {
                         await removePathIfExists(localAppPath, `managed app files for "${runtime.envName}"`);
                         succeedTask(`Managed local app files removed for "${runtime.envName}".`);
                     }
-                    else if (localAppPath) {
-                        printInfo(`Keeping custom local app files for "${runtime.envName}" at "${localAppPath}".`);
-                    }
                     else {
                         printInfo(`No saved local app path found for "${runtime.envName}".`);
                     }
                 }
-                const configuredStoragePath = resolveConfiguredPath(runtime.env.config.storagePath);
+                const proxyEntryDirs = [
+                    resolveEnvProxyEntryDir(runtime.envName, { provider: 'nginx' }),
+                    resolveEnvProxyEntryDir(runtime.envName, { provider: 'caddy' }),
+                    path.dirname(resolveLegacyNginxEnvProxyAppOutputPath(runtime.envName)),
+                ];
+                startTask(`Removing env proxy entry files for "${runtime.envName}"...`);
+                for (const proxyEntryDir of proxyEntryDirs) {
+                    await removePathIfExists(proxyEntryDir, `proxy entry files for "${runtime.envName}"`);
+                }
+                succeedTask(`Env proxy entry files removed for "${runtime.envName}".`);
+                const configuredStoragePath = resolveConfiguredStoragePath(runtime.env.config);
                 if (configuredStoragePath) {
                     startTask(`Removing storage data for "${runtime.envName}"...`);
                     await removePathIfExists(configuredStoragePath, `storage data for "${runtime.envName}"`);

package/dist/commands/app/down.js

@@ -10,7 +10,7 @@ import { Command, Flags } from '@oclif/core';
 import { printWarning } from '../../lib/ui.js';
 export default class AppDown extends Command {
     static hidden = true;
-    static description = 'Deprecated compatibility alias for `nb app stop --with-db` and `nb app destroy`.';
+    static description = 'Deprecated compatibility alias for `nb app stop --with-db` and `nb env remove <name> --purge`.';
     static examples = [
         '<%= config.bin %> <%= command.id %> --env app1',
         '<%= config.bin %> <%= command.id %> --env app1 --all --force',
@@ -51,7 +51,7 @@ export default class AppDown extends Command {
             argv.push('--verbose');
         }
         if (flags.all) {
-            printWarning('`nb app down --all` is deprecated. Use `nb app destroy` instead.');
+            printWarning('`nb app down --all` is deprecated. Use `nb env remove <name> --purge` instead.');
             if (flags.force || flags.yes) {
                 argv.push('--force');
             }

package/dist/commands/app/logs.js

@@ -8,7 +8,7 @@
  */
 import { Command, Flags } from '@oclif/core';
 import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
-import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, runLocalNocoBaseCommand, } from '../../lib/app-runtime.js';
+import { formatMissingManagedAppEnvMessage, managedAppLifecycleEnvVars, resolveManagedAppRuntime, runLocalNocoBaseCommand, } from '../../lib/app-runtime.js';
 import { run } from '../../lib/run-npm.js';
 import { printInfo } from '../../lib/ui.js';
 function formatLogsFailure(envName, message) {
@@ -103,6 +103,7 @@ export default class AppLogs extends Command {
                 localArgs.push('--nostream');
             }
             await runLocalNocoBaseCommand(runtime, localArgs, {
+                env: managedAppLifecycleEnvVars(),
                 stdio: 'inherit',
             });
         }

package/dist/commands/app/restart.js

@@ -11,6 +11,7 @@ import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-
 import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, stopDockerContainer, } from '../../lib/app-runtime.js';
 import { formatAppUrl, resolveManagedAppApiBaseUrl, waitForAppReady } from '../../lib/app-health.js';
 import { recreateSavedDockerApp } from '../../lib/app-managed-resources.js';
+import { resolveAppUrlFromApiBaseUrl } from '../env/shared.js';
 import { run } from '../../lib/run-npm.js';
 import { announceTargetEnv, failTask, startTask, succeedTask } from '../../lib/ui.js';
 function argvHasToken(argv, tokens) {
@@ -21,6 +22,31 @@ function pushFlag(argv, flag, value) {
         argv.push(flag, String(value));
     }
 }
+function buildLicenseSyncArgv(envName, options) {
+    const argv = ['--env', envName, '--skip-if-no-license'];
+    if (options.yes || options.explicitEnvSelection) {
+        argv.push('--yes');
+    }
+    if (options.verbose) {
+        argv.push('--verbose');
+    }
+    return argv;
+}
+async function runWithSuppressedTargetEnvLog(task) {
+    const previousTargetEnv = process.env.NB_SKIP_TARGET_ENV_LOG;
+    process.env.NB_SKIP_TARGET_ENV_LOG = '1';
+    try {
+        return await task();
+    }
+    finally {
+        if (previousTargetEnv === undefined) {
+            delete process.env.NB_SKIP_TARGET_ENV_LOG;
+        }
+        else {
+            process.env.NB_SKIP_TARGET_ENV_LOG = previousTargetEnv;
+        }
+    }
+}
 function formatDockerRestartFailure(envName, message) {
     return [
         `Couldn't restart NocoBase for "${envName}".`,
@@ -29,18 +55,21 @@ function formatDockerRestartFailure(envName, message) {
         `Details: ${message}`,
     ].join('\n');
 }
+function resolveDisplayAppUrl(apiBaseUrl, port, appPublicPath) {
+    const resolvedFromApiBaseUrl = resolveAppUrlFromApiBaseUrl(apiBaseUrl);
+    if (resolvedFromApiBaseUrl) {
+        return resolvedFromApiBaseUrl;
+    }
+    return formatAppUrl(port, appPublicPath);
+}
 export default class AppRestart extends Command {
     static hidden = false;
-    static description = 'Restart NocoBase for the selected env. Local npm/git installs stop and start the app again, and Docker installs recreate the saved app container so saved env changes can take effect.';
+    static description = 'Restart NocoBase for the selected env. When applicable, the CLI synchronizes licensed commercial plugins first, then restarts the local app or recreates the saved Docker container.';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --env local',
-        '<%= config.bin %> <%= command.id %> --env local --quickstart',
-        '<%= config.bin %> <%= command.id %> --env local --port 12000',
         '<%= config.bin %> <%= command.id %> --env local --daemon',
         '<%= config.bin %> <%= command.id %> --env local --no-daemon',
-        '<%= config.bin %> <%= command.id %> --env local --instances 2',
-        '<%= config.bin %> <%= command.id %> --env local --launch-mode pm2',
         '<%= config.bin %> <%= command.id %> --env local --verbose',
         '<%= config.bin %> <%= command.id %> --env local-docker',
     ];
@@ -54,8 +83,20 @@ export default class AppRestart extends Command {
             description: 'Confirm using --env when it targets a different env than the current env',
             default: false,
         }),
-        quickstart: Flags.boolean({ description: 'Quickstart the application after stopping it', required: false }),
-        port: Flags.string({ description: 'Port (overrides appPort from env config when set)', char: 'p', required: false }),
+        quickstart: Flags.boolean({
+            hidden: true,
+            description: 'Quickstart the application after stopping it',
+            required: false,
+            default: true,
+            allowNo: true,
+        }),
+        'sync-licensed-plugins': Flags.boolean({
+            hidden: true,
+            description: 'Synchronize licensed commercial plugins before restarting the application',
+            required: false,
+            default: true,
+            allowNo: true,
+        }),
         daemon: Flags.boolean({
             description: 'Run the application as a daemon after stopping it (default: true; use --no-daemon to stay in the foreground)',
             char: 'd',
@@ -63,8 +104,6 @@ export default class AppRestart extends Command {
             default: true,
             allowNo: true,
         }),
-        instances: Flags.integer({ description: 'Number of instances to run after stopping it', char: 'i', required: false }),
-        'launch-mode': Flags.string({ description: 'Launch Mode', required: false, options: ['pm2', 'node'] }),
         verbose: Flags.boolean({
             description: 'Show raw shutdown/startup output from the underlying local or Docker command',
             default: false,
@@ -72,8 +111,10 @@ export default class AppRestart extends Command {
     };
     async run() {
         const { flags } = await this.parse(AppRestart);
+        const quickstart = flags.quickstart ?? true;
         const requestedEnv = flags.env?.trim() || undefined;
         const explicitEnvSelection = Boolean(requestedEnv && hasExplicitEnvSelection(this.argv));
+        const shouldSyncLicensedPlugins = flags['sync-licensed-plugins'] ?? true;
         if (explicitEnvSelection) {
             const confirmed = await ensureCrossEnvConfirmed({
                 command: this,
@@ -85,12 +126,41 @@ export default class AppRestart extends Command {
             }
         }
         const runtime = await resolveManagedAppRuntime(requestedEnv);
+        const runCommand = this.config.runCommand.bind(this.config);
         const commandStdio = flags.verbose ? 'inherit' : 'ignore';
         if (!runtime) {
             this.error(formatMissingManagedAppEnvMessage(requestedEnv));
         }
+        if (runtime.kind === 'http') {
+            this.error([
+                `Can't restart "${runtime.envName}" from this machine.`,
+                'This env only has an API connection, so there is no saved local app or Docker runtime to restart here.',
+                'Connect it to a local checkout or reinstall it with npm, git, or Docker if you want CLI-managed restart.',
+            ].join('\n'));
+        }
+        if (runtime.kind === 'ssh') {
+            this.error([
+                `Can't restart "${runtime.envName}" yet.`,
+                'SSH env support is reserved but not implemented yet.',
+                'Use a local or Docker env if you need CLI-managed restart right now.',
+            ].join('\n'));
+        }
+        announceTargetEnv(runtime.envName);
+        if (shouldSyncLicensedPlugins) {
+            try {
+                await runWithSuppressedTargetEnvLog(async () => {
+                    await runCommand('license:plugins:sync', buildLicenseSyncArgv(runtime.envName, {
+                        explicitEnvSelection,
+                        yes: flags.yes,
+                        verbose: flags.verbose,
+                    }));
+                });
+            }
+            catch (error) {
+                this.error(error instanceof Error ? error.message : String(error));
+            }
+        }
         if (runtime.kind === 'docker') {
-            announceTargetEnv(runtime.envName);
             startTask(`Stopping NocoBase for "${runtime.envName}" before restart...`);
             try {
                 const state = await stopDockerContainer(runtime.containerName, {
@@ -121,14 +191,14 @@ export default class AppRestart extends Command {
                 failTask(`Failed to recreate NocoBase for "${runtime.envName}".`);
                 this.error(formatDockerRestartFailure(runtime.envName, message));
             }
-            const appUrl = formatAppUrl(runtime.env.appPort === undefined || runtime.env.appPort === null
-                ? undefined
-                : String(runtime.env.appPort));
+            const apiBaseUrl = resolveManagedAppApiBaseUrl(runtime);
+            const appUrl = resolveDisplayAppUrl(apiBaseUrl, runtime.env.appPort === undefined || runtime.env.appPort === null ? undefined : String(runtime.env.appPort), runtime.env.config?.appPublicPath);
             await waitForAppReady({
                 envName: runtime.envName,
-                apiBaseUrl: resolveManagedAppApiBaseUrl(runtime),
+                apiBaseUrl,
                 containerName: runtime.containerName,
                 logHint: `You can inspect startup logs with \`nb app logs --env ${runtime.envName}\`.`,
+                ...(flags.verbose ? { verbose: true } : {}),
             });
             succeedTask(`NocoBase is running for "${runtime.envName}"${appUrl ? ` at ${appUrl}` : ''}.`);
             return;
@@ -142,17 +212,19 @@ export default class AppRestart extends Command {
         if (flags.verbose) {
             stopArgv.push('--verbose');
         }
-        await this.config.runCommand('app:stop', stopArgv);
+        await runWithSuppressedTargetEnvLog(async () => {
+            await runCommand('app:stop', stopArgv);
+        });
         const startArgv = [...stopArgv];
-        if (flags.quickstart) {
+        if (quickstart) {
             startArgv.push('--quickstart');
         }
-        pushFlag(startArgv, '--port', flags.port);
+        startArgv.push('--no-sync-licensed-plugins');
         if (daemonFlagWasProvided) {
             startArgv.push(flags.daemon === false ? '--no-daemon' : '--daemon');
         }
-        pushFlag(startArgv, '--instances', flags.instances);
-        pushFlag(startArgv, '--launch-mode', flags['launch-mode']);
-        await this.config.runCommand('app:start', startArgv);
+        await runWithSuppressedTargetEnvLog(async () => {
+            await runCommand('app:start', startArgv);
+        });
     }
 }

package/dist/commands/app/shared.js

@@ -11,6 +11,7 @@ import os from 'node:os';
 import path from 'node:path';
 import { buildDockerDbContainerName } from '../../lib/app-runtime.js';
 import { resolveConfiguredEnvPath } from '../../lib/cli-home.js';
+import { resolveConfiguredAppPath } from '../../lib/env-paths.js';
 import { commandOutput, run } from '../../lib/run-npm.js';
 export function resolveConfiguredPath(value) {
     return resolveConfiguredEnvPath(value);
@@ -115,8 +116,8 @@ export function managedDockerNetworkName(runtime) {
     return runtime.dockerNetworkName?.trim() || runtime.workspaceName?.trim() || undefined;
 }
 export function resolveManagedLocalAppPath(runtime) {
-    return resolveConfiguredPath(runtime.env.config.appRootPath) || runtime.projectRoot;
+    return resolveConfiguredAppPath(runtime.env.config) || runtime.projectRoot || resolveConfiguredPath(runtime.env.config.appRootPath);
 }
 export function shouldRemoveManagedLocalAppFiles(runtime) {
-    return runtime.source === 'npm' || runtime.source === 'git';
+    return runtime.source === 'npm' || runtime.source === 'git' || runtime.source === 'local';
 }

package/dist/commands/app/start.js

@@ -7,18 +7,46 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Command, Flags } from '@oclif/core';
+import { buildDefaultCdnBaseUrl, readDistClientActiveVersion } from '../../lib/app-public-path.js';
 import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
-import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, runLocalNocoBaseCommand, } from '../../lib/app-runtime.js';
+import { formatMissingManagedAppEnvMessage, managedAppLifecycleEnvVars, resolveManagedAppRuntime, runLocalNocoBaseCommand, } from '../../lib/app-runtime.js';
 import { AppHealthCheckError, formatAppUrl, isAppReady, resolveManagedAppApiBaseUrl, waitForAppReady, } from '../../lib/app-health.js';
 import { ensureBuiltinDbReady, ensureLocalPostinstall, ensureSavedLocalSource, recreateSavedDockerApp, } from '../../lib/app-managed-resources.js';
+import { resolveAppUrlFromApiBaseUrl } from '../env/shared.js';
+import { readManagedRuntimeEnvValues } from '../../lib/managed-env-file.js';
 import { run } from '../../lib/run-npm.js';
-import { announceTargetEnv, failTask, printInfo, startTask, succeedTask } from '../../lib/ui.js';
+import { announceTargetEnv, failTask, printInfo, printWarning, startTask, succeedTask } from '../../lib/ui.js';
 function shouldPrintStartSuccess() {
     return process.env.NB_SKIP_APP_START_SUCCESS_LOG !== '1';
 }
 function argvHasToken(argv, tokens) {
     return tokens.some((token) => argv.includes(token));
 }
+function buildLicenseSyncArgv(envName, options) {
+    const argv = ['--env', envName, '--skip-if-no-license'];
+    if (options.yes || options.explicitEnvSelection) {
+        argv.push('--yes');
+    }
+    if (options.verbose) {
+        argv.push('--verbose');
+    }
+    return argv;
+}
+async function runWithSuppressedTargetEnvLog(task) {
+    const previousTargetEnv = process.env.NB_SKIP_TARGET_ENV_LOG;
+    process.env.NB_SKIP_TARGET_ENV_LOG = '1';
+    try {
+        return await task();
+    }
+    finally {
+        if (previousTargetEnv === undefined) {
+            delete process.env.NB_SKIP_TARGET_ENV_LOG;
+        }
+        else {
+            process.env.NB_SKIP_TARGET_ENV_LOG = previousTargetEnv;
+        }
+    }
+}
 function formatDockerStartFailure(envName, message) {
     return [
         `Couldn't start NocoBase for "${envName}".`,
@@ -53,18 +81,49 @@ function formatLocalReadyFailure(envName, message, options) {
         `Details: ${message}`,
     ].join('\n');
 }
+function formatLocalClientExtractWarning(envName, message) {
+    return [
+        `Client assets were not extracted for "${envName}".`,
+        'NocoBase will keep starting, but versioned client files for CDN or external distribution may be stale or missing.',
+        `Details: ${message}`,
+    ].join('\n');
+}
+function resolveDisplayAppUrl(apiBaseUrl, port, appPublicPath) {
+    const resolvedFromApiBaseUrl = resolveAppUrlFromApiBaseUrl(apiBaseUrl);
+    if (resolvedFromApiBaseUrl) {
+        return resolvedFromApiBaseUrl;
+    }
+    return formatAppUrl(port, appPublicPath);
+}
+async function resolveDefaultLocalCdnBaseUrl(runtime) {
+    let envValues = {};
+    if (runtime.env.config && typeof runtime.env.config === 'object') {
+        ({ envValues } = await readManagedRuntimeEnvValues(runtime));
+    }
+    const explicitProcessCdnBaseUrl = String(process.env.CDN_BASE_URL ?? '').trim();
+    const explicitSavedCdnBaseUrl = String(runtime.env.envVars.CDN_BASE_URL ?? '').trim();
+    const explicitEnvFileCdnBaseUrl = String(envValues.CDN_BASE_URL ?? '').trim();
+    if (explicitProcessCdnBaseUrl || explicitSavedCdnBaseUrl || explicitEnvFileCdnBaseUrl) {
+        return undefined;
+    }
+    const storagePath = String(runtime.env.storagePath ?? runtime.env.config?.storagePath ?? '').trim();
+    if (!storagePath) {
+        return undefined;
+    }
+    const activeVersion = await readDistClientActiveVersion(storagePath);
+    if (!activeVersion) {
+        return undefined;
+    }
+    return buildDefaultCdnBaseUrl(runtime.env.config?.appPublicPath || envValues.APP_PUBLIC_PATH, activeVersion);
+}
 export default class AppStart extends Command {
     static hidden = false;
-    static description = 'Start NocoBase for the selected env. Local npm/git installs run the app command, and Docker installs recreate the saved app container.';
+    static description = 'Start NocoBase for the selected env. When applicable, the CLI synchronizes licensed commercial plugins first, then prepares and starts the app or recreates the saved Docker container.';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --env local',
-        '<%= config.bin %> <%= command.id %> --env local --quickstart',
-        '<%= config.bin %> <%= command.id %> --env local --port 12000',
         '<%= config.bin %> <%= command.id %> --env local --daemon',
         '<%= config.bin %> <%= command.id %> --env local --no-daemon',
-        '<%= config.bin %> <%= command.id %> --env local --instances 2',
-        '<%= config.bin %> <%= command.id %> --env local --launch-mode pm2',
         '<%= config.bin %> <%= command.id %> --env local --verbose',
         '<%= config.bin %> <%= command.id %> --env local-docker',
     ];
@@ -78,11 +137,19 @@ export default class AppStart extends Command {
             description: 'Confirm using --env when it targets a different env than the current env',
             default: false,
         }),
-        quickstart: Flags.boolean({ description: 'Quickstart the application', required: false }),
-        port: Flags.string({
-            description: 'Port (overrides appPort from env config when set)',
-            char: 'p',
+        quickstart: Flags.boolean({
+            hidden: true,
+            description: 'Quickstart the application',
             required: false,
+            default: true,
+            allowNo: true,
+        }),
+        'sync-licensed-plugins': Flags.boolean({
+            hidden: true,
+            description: 'Synchronize licensed commercial plugins before starting the application',
+            required: false,
+            default: true,
+            allowNo: true,
         }),
         daemon: Flags.boolean({
             description: 'Run the application as a daemon (default: true; use --no-daemon to stay in the foreground)',
@@ -91,8 +158,6 @@ export default class AppStart extends Command {
             default: true,
             allowNo: true,
         }),
-        instances: Flags.integer({ description: 'Number of instances to run', char: 'i', required: false }),
-        'launch-mode': Flags.string({ description: 'Launch Mode', required: false, options: ['pm2', 'node'] }),
         verbose: Flags.boolean({
             description: 'Show raw startup output from the underlying local or Docker command',
             default: false,
@@ -100,8 +165,11 @@ export default class AppStart extends Command {
     };
     async run() {
         const { flags } = await this.parse(AppStart);
+        const quickstart = flags.quickstart ?? true;
         const requestedEnv = flags.env?.trim() || undefined;
-        if (requestedEnv && hasExplicitEnvSelection(this.argv)) {
+        const explicitEnvSelection = Boolean(requestedEnv && hasExplicitEnvSelection(this.argv));
+        const shouldSyncLicensedPlugins = flags['sync-licensed-plugins'] ?? true;
+        if (explicitEnvSelection) {
             const confirmed = await ensureCrossEnvConfirmed({
                 command: this,
                 requestedEnv,
@@ -113,6 +181,7 @@ export default class AppStart extends Command {
         }
         const daemonFlagWasProvided = argvHasToken(this.argv, ['--daemon', '--no-daemon']);
         const runtime = await resolveManagedAppRuntime(requestedEnv);
+        const runCommand = this.config.runCommand.bind(this.config);
         const commandStdio = flags.verbose ? 'inherit' : 'ignore';
         if (!runtime) {
             this.error(formatMissingManagedAppEnvMessage(requestedEnv));
@@ -133,12 +202,7 @@ export default class AppStart extends Command {
         }
         announceTargetEnv(runtime.envName);
         if (runtime.kind === 'docker') {
-            const unsupportedFlags = [
-                flags.port ? '--port' : undefined,
-                daemonFlagWasProvided ? (flags.daemon ? '--daemon' : '--no-daemon') : undefined,
-                flags.instances !== undefined ? '--instances' : undefined,
-                flags['launch-mode'] ? '--launch-mode' : undefined,
-            ].filter(Boolean);
+            const unsupportedFlags = [daemonFlagWasProvided ? (flags.daemon ? '--daemon' : '--no-daemon') : undefined].filter(Boolean);
             if (unsupportedFlags.length > 0) {
                 this.error([
                     `Can't apply ${unsupportedFlags.join(', ')} to "${runtime.envName}".`,
@@ -146,14 +210,28 @@ export default class AppStart extends Command {
                     `Run \`nb app start --env ${runtime.envName}\` to recreate the saved container, or recreate the env if you need different runtime settings.`,
                 ].join('\n'));
             }
+            if (shouldSyncLicensedPlugins) {
+                try {
+                    await runWithSuppressedTargetEnvLog(async () => {
+                        await runCommand('license:plugins:sync', buildLicenseSyncArgv(runtime.envName, {
+                            explicitEnvSelection,
+                            yes: flags.yes,
+                            verbose: flags.verbose,
+                        }));
+                    });
+                }
+                catch (error) {
+                    this.error(error instanceof Error ? error.message : String(error));
+                }
+            }
             await ensureBuiltinDbReady(runtime, {
                 verbose: flags.verbose,
                 onStartTask: startTask,
                 onSucceedTask: succeedTask,
                 onFailTask: failTask,
             });
-            const appUrl = formatAppUrl(runtime.env.appPort === undefined || runtime.env.appPort === null ? undefined : String(runtime.env.appPort));
             const apiBaseUrl = resolveManagedAppApiBaseUrl(runtime);
+            const appUrl = resolveDisplayAppUrl(apiBaseUrl, runtime.env.appPort === undefined || runtime.env.appPort === null ? undefined : String(runtime.env.appPort), runtime.env.config?.appPublicPath);
             startTask(`Recreating the Docker app container for "${runtime.envName}"...`);
             try {
                 await run('docker', ['rm', '-f', runtime.containerName], {
@@ -175,6 +253,7 @@ export default class AppStart extends Command {
                 apiBaseUrl,
                 containerName: runtime.containerName,
                 logHint: `You can inspect startup logs with \`nb app logs --env ${runtime.envName}\`.`,
+                ...(flags.verbose ? { verbose: true } : {}),
             });
             if (shouldPrintStartSuccess()) {
                 succeedTask(`NocoBase is running for "${runtime.envName}"${appUrl ? ` at ${appUrl}` : ''}.`);
@@ -188,7 +267,6 @@ export default class AppStart extends Command {
             onFailTask: failTask,
         });
         if (runtime.source === 'npm' || runtime.source === 'git') {
-            const runCommand = this.config.runCommand.bind(this.config);
             const downloadableRuntime = runtime;
             await ensureSavedLocalSource(downloadableRuntime, runCommand, {
                 verbose: flags.verbose,
@@ -198,13 +276,10 @@ export default class AppStart extends Command {
             });
         }
         const npmArgs = ['start'];
-        if (flags.quickstart) {
+        if (quickstart) {
             npmArgs.push('--quickstart');
         }
-        if (flags.port) {
-            npmArgs.push('--port', flags.port);
-        }
-        else if (runtime.env.appPort !== undefined &&
+        if (runtime.env.appPort !== undefined &&
             runtime.env.appPort !== null &&
             String(runtime.env.appPort).trim() !== '') {
             npmArgs.push('--port', String(runtime.env.appPort));
@@ -212,20 +287,14 @@ export default class AppStart extends Command {
         if (flags.daemon !== false) {
             npmArgs.push('--daemon');
         }
-        if (flags.instances !== undefined) {
-            npmArgs.push('--instances', flags.instances.toString());
-        }
-        if (flags['launch-mode']) {
-            npmArgs.push('--launch-mode', flags['launch-mode']);
-        }
-        const effectivePort = flags.port ||
-            (runtime.env.appPort !== undefined && runtime.env.appPort !== null
-                ? String(runtime.env.appPort).trim()
-                : undefined);
-        const appUrl = formatAppUrl(effectivePort);
+        const effectivePort = runtime.env.appPort !== undefined && runtime.env.appPort !== null
+            ? String(runtime.env.appPort).trim()
+            : undefined;
         const apiBaseUrl = resolveManagedAppApiBaseUrl(runtime, {
             portOverride: effectivePort,
         });
+        const appUrl = resolveDisplayAppUrl(apiBaseUrl, effectivePort, runtime.env.config?.appPublicPath);
+        let defaultCdnBaseUrl;
         if (await isAppReady(apiBaseUrl, { requestTimeoutMs: 1_500 })) {
             if (flags.daemon === false) {
                 printInfo(`NocoBase is already running for "${runtime.envName}"${appUrl ? ` at ${appUrl}` : ''}. Use \`nb app stop --env ${runtime.envName}\` before starting it again in the foreground.`);
@@ -237,8 +306,23 @@ export default class AppStart extends Command {
             }
             return;
         }
+        if (shouldSyncLicensedPlugins) {
+            try {
+                await runWithSuppressedTargetEnvLog(async () => {
+                    await runCommand('license:plugins:sync', buildLicenseSyncArgv(runtime.envName, {
+                        explicitEnvSelection,
+                        yes: flags.yes,
+                        verbose: flags.verbose,
+                    }));
+                });
+            }
+            catch (error) {
+                this.error(error instanceof Error ? error.message : String(error));
+            }
+        }
         try {
             await ensureLocalPostinstall(runtime, {
+                env: managedAppLifecycleEnvVars(),
                 verbose: flags.verbose,
                 onStartTask: startTask,
                 onSucceedTask: succeedTask,
@@ -248,6 +332,20 @@ export default class AppStart extends Command {
         catch (error) {
             this.error(error instanceof Error ? error.message : String(error));
         }
+        try {
+            startTask(`Extracting client assets for "${runtime.envName}"...`);
+            await runLocalNocoBaseCommand(runtime, ['client:extract'], {
+                env: managedAppLifecycleEnvVars(),
+                stdio: commandStdio,
+            });
+            succeedTask(`Client assets are ready for "${runtime.envName}".`);
+            defaultCdnBaseUrl = await resolveDefaultLocalCdnBaseUrl(runtime);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            failTask(`Failed to extract client assets for "${runtime.envName}".`);
+            printWarning(formatLocalClientExtractWarning(runtime.envName, message));
+        }
         if (flags.daemon === false) {
             printInfo(`Starting NocoBase for "${runtime.envName}" in the foreground${appUrl ? ` at ${appUrl}` : ''}. Press Ctrl+C to stop.`);
         }
@@ -255,7 +353,14 @@ export default class AppStart extends Command {
             startTask(`Starting NocoBase for "${runtime.envName}" in the background...`);
         }
         try {
+            const startEnv = defaultCdnBaseUrl
+                ? {
+                    ...managedAppLifecycleEnvVars(),
+                    CDN_BASE_URL: defaultCdnBaseUrl,
+                }
+                : managedAppLifecycleEnvVars();
             await runLocalNocoBaseCommand(runtime, npmArgs, {
+                env: startEnv,
                 stdio: commandStdio,
             });
             if (flags.daemon !== false) {