@nocobase/cli 2.1.0-beta.42 → 2.1.0-beta.42-test.2

package/dist/commands/source/dev.js

@@ -16,20 +16,20 @@ function formatUnsupportedRuntimeMessage(kind, envName) {
         return [
             `Can't run dev mode for "${envName}".`,
             'This env is managed by Docker, but `nb source dev` requires a local npm or Git source directory.',
-            `Use \`nb app logs --env ${envName}\` to inspect the Docker app, or create a source-based env with \`nb init --env ${envName} --source git\`.`,
+            `Use \`nb app logs --env ${envName}\` to inspect the Docker app, or create a source-based env with \`nb init --ui --env ${envName} --source git\`.`,
         ].join('\n');
     }
     if (kind === 'ssh') {
         return [
             `Can't run dev mode for "${envName}" yet.`,
             'SSH env support is reserved but not implemented yet.',
-            `Create a source-based env with \`nb init --env ${envName} --source git\` if you want local development mode right now.`,
+            `Create a source-based env with \`nb init --ui --env ${envName} --source git\` if you want local development mode right now.`,
         ].join('\n');
     }
     return [
         `Can't run dev mode for "${envName}".`,
         'This env only has an API connection, but `nb source dev` requires a local npm or Git source directory.',
-        `Create a source-based env with \`nb init --env ${envName} --source git\` if you want local development mode.`,
+        `Create a source-based env with \`nb init --ui --env ${envName} --source git\` if you want local development mode.`,
     ].join('\n');
 }
 function appUrlForPort(port) {
@@ -129,8 +129,8 @@ export default class SourceDev extends Command {
             this.error(formatUnsupportedRuntimeMessage(runtime.kind, runtime.envName));
         }
         announceTargetEnv(runtime.envName);
-        const devPort = flags.port
-            || (runtime.env.appPort !== undefined && runtime.env.appPort !== null
+        const devPort = flags.port ||
+            (runtime.env.appPort !== undefined && runtime.env.appPort !== null
                 ? String(runtime.env.appPort).trim()
                 : undefined);
         const appUrl = appUrlForPort(devPort);

package/dist/lib/app-health.js

@@ -6,6 +6,7 @@
  * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
+import { startDockerLogFollower } from './docker-log-stream.js';
 import { printInfo } from './ui.js';
 const APP_HEALTH_CHECK_INTERVAL_MS = 2_000;
 const APP_HEALTH_CHECK_TIMEOUT_MS = 600_000;
@@ -99,34 +100,40 @@ export async function waitForAppReady(params) {
     let lastMessage = 'No response yet';
     let nextProgressLogAt = startedAt + progressLogIntervalMs;
     printInfo(`Waiting for NocoBase to become ready for "${params.envName}"...`);
-    while (Date.now() - startedAt < timeoutMs) {
-        const result = await requestAppHealthCheck({
-            healthCheckUrl,
-            fetchImpl: params.fetchImpl,
-            requestTimeoutMs: params.requestTimeoutMs,
-        });
-        if (result.ok) {
-            return;
-        }
-        lastMessage = result.message;
-        const now = Date.now();
-        if (now >= nextProgressLogAt) {
-            const elapsedSeconds = Math.max(1, Math.floor((now - startedAt) / 1000));
-            printInfo(`Still waiting for "${params.envName}"... (${elapsedSeconds}s elapsed)`);
-            while (nextProgressLogAt <= now) {
-                nextProgressLogAt += progressLogIntervalMs;
+    const dockerLogFollower = params.verbose && params.containerName ? startDockerLogFollower(params.containerName) : undefined;
+    try {
+        while (Date.now() - startedAt < timeoutMs) {
+            const result = await requestAppHealthCheck({
+                healthCheckUrl,
+                fetchImpl: params.fetchImpl,
+                requestTimeoutMs: params.requestTimeoutMs,
+            });
+            if (result.ok) {
+                return;
             }
+            lastMessage = result.message;
+            const now = Date.now();
+            if (now >= nextProgressLogAt) {
+                const elapsedSeconds = Math.max(1, Math.floor((now - startedAt) / 1000));
+                printInfo(`Still waiting for "${params.envName}"... (${elapsedSeconds}s elapsed)`);
+                while (nextProgressLogAt <= now) {
+                    nextProgressLogAt += progressLogIntervalMs;
+                }
+            }
+            const remainingMs = timeoutMs - (Date.now() - startedAt);
+            if (remainingMs <= 0) {
+                break;
+            }
+            await sleep(Math.min(intervalMs, remainingMs));
         }
-        const remainingMs = timeoutMs - (Date.now() - startedAt);
-        if (remainingMs <= 0) {
-            break;
-        }
-        await sleep(Math.min(intervalMs, remainingMs));
+        const hints = [
+            params.logHint,
+            params.containerName ? `docker logs ${params.containerName}` : undefined,
+        ].filter(Boolean);
+        const hintText = hints.length > 0 ? ` ${hints.join(' ')}` : '';
+        throw new AppHealthCheckError(`NocoBase did not become ready in time for "${params.envName}". Expected \`${healthCheckUrl}\` to respond with \`ok\`, but the last status was: ${lastMessage}.${hintText}`);
+    }
+    finally {
+        await dockerLogFollower?.stop();
     }
-    const hints = [
-        params.logHint,
-        params.containerName ? `docker logs ${params.containerName}` : undefined,
-    ].filter(Boolean);
-    const hintText = hints.length > 0 ? ` ${hints.join(' ')}` : '';
-    throw new AppHealthCheckError(`NocoBase did not become ready in time for "${params.envName}". Expected \`${healthCheckUrl}\` to respond with \`ok\`, but the last status was: ${lastMessage}.${hintText}`);
 }

package/dist/lib/app-managed-resources.js

@@ -82,7 +82,7 @@ function formatSavedDockerSettingsIncomplete(envName, missing) {
     return [
         `Can't start NocoBase for "${envName}" yet.`,
         `The saved Docker settings for this env are incomplete. Missing: ${missing.join(', ')}.`,
-        'Re-run `nb init` or `nb env add` to refresh this env config, then try again.',
+        `Re-run \`nb init --ui --env ${envName}\` to refresh this env config, then try again.`,
     ].join('\n');
 }
 function formatDockerAppRecreateFailure(envName, message) {

package/dist/lib/app-runtime.js

@@ -110,10 +110,10 @@ export function formatMissingManagedAppEnvMessage(envName) {
     if (requested) {
         return [
             `Env "${requested}" is not configured in this workspace.`,
-            `If you want to create a new NocoBase AI environment, run \`nb init --env ${requested}\` first.`,
+            `If you want to create a new NocoBase AI environment, run \`nb init --ui --env ${requested}\` first.`,
         ].join('\n');
     }
-    return 'No NocoBase env is configured yet. Run `nb init` to create one first.';
+    return 'No NocoBase env is configured yet. Run `nb init --ui` to create one first.';
 }
 export async function runLocalNocoBaseCommand(runtime, args, options) {
     const envVars = await buildRuntimeEnvVars(runtime);

package/dist/lib/auth-store.js

@@ -32,6 +32,13 @@ function normalizeOptionalCliLocale(value) {
     }
     return normalizeCliLocale(normalized);
 }
+function normalizeOptionalCliUpdatePolicy(value) {
+    const normalized = normalizeOptionalString(value);
+    if (normalized === 'prompt' || normalized === 'auto' || normalized === 'off') {
+        return normalized;
+    }
+    return undefined;
+}
 export function readEnvApiBaseUrl(config) {
     if (!config) {
         return undefined;
@@ -79,10 +86,12 @@ function normalizeEnvConfigEntry(entry) {
 function normalizeAuthConfig(config) {
     const settings = config.settings ?? {};
     const locale = normalizeOptionalCliLocale(settings.locale);
+    const updatePolicy = normalizeOptionalCliUpdatePolicy(settings.update?.policy);
     return {
         name: config.name || config.dockerResourcePrefix,
         settings: {
             ...(locale ? { locale } : {}),
+            ...(updatePolicy ? { update: { policy: updatePolicy } } : {}),
             ...(settings.license?.pkgUrl ? { license: { pkgUrl: normalizeOptionalString(settings.license.pkgUrl) } } : {}),
             ...(settings.docker?.network || settings.docker?.containerPrefix
                 ? {

package/dist/lib/backup.js

@@ -62,14 +62,14 @@ export async function resolveBackupTargetEnv(requestedEnv) {
     const { envs } = await listEnvs({ scope });
     const configuredEnvNames = Object.keys(envs);
     if (!configuredEnvNames.length) {
-        throw new Error('No env is configured. Run `nb env add <name> --api-base-url <url>` first.');
+        throw new Error('No env is configured. Run `nb init --ui` first.');
     }
     if (requestedEnv?.trim()) {
-        throw new Error(`Env "${envName}" is not configured. Run \`nb env add ${envName} --api-base-url <url>\` first.`);
+        throw new Error(`Env "${envName}" is not configured. Run \`nb init --ui --env ${envName}\` first.`);
     }
     throw new Error([
         `Current env "${envName}" is not configured.`,
-        'Switch to an existing env with `nb env use <name>`, or add one with `nb env add <name> --api-base-url <url>`.',
+        `Switch to an existing env with \`nb env use <name>\`, or run \`nb init --ui --env ${envName}\` to create or connect it.`,
     ].join('\n'));
 }
 export async function ensureBackupRuntimeCommands(params) {

package/dist/lib/bootstrap.js

@@ -254,25 +254,31 @@ export function formatSwaggerSchemaError(response, context) {
         })
             .join('\n');
         const envLabel = context.envName ? ` for env "${context.envName}"` : '';
+        const tokenHint = context.envName
+            ? `Update the API key with \`nb env update ${context.envName} --token <api-key>\`, log in with \`nb env auth ${context.envName}\`, or rerun the command with \`--access-token <api-key>\`.`
+            : 'Update the API key with `nb env update <name> --token <api-key>`, log in with `nb env auth <name>`, or rerun the command with `--access-token <api-key>`.';
         const commandHint = context.commandToken
-            ? `If \`${context.commandToken}\` is a runtime command, refresh the runtime after updating the token with \`nb env update\`. If it is a typo, run \`nb --help\` to inspect available commands.`
-            : 'Run `nb --help` to inspect built-in commands, then refresh runtime commands with `nb env update` after updating the token.';
+            ? `If \`${context.commandToken}\` is a runtime command, retry it after updating the token. If it is a typo, run \`nb --help\` to inspect available commands.`
+            : 'Run `nb --help` to inspect built-in commands, then retry the original command after updating the token.';
         return [
             `Authentication failed while loading the command runtime from \`swagger:get\`${envLabel}.`,
             `Base URL: ${context.baseUrl}`,
             details,
-            'Update the API key with `nb env add <name> --api-base-url <url> --auth-type token --access-token <api-key>`, log in with `nb env auth <name>`, or rerun the command with `--access-token <api-key>`.',
+            tokenHint,
             commandHint,
         ].join('\n');
     }
     if (isNetworkFetchFailure(response)) {
         const rawMessage = response.data?.error?.message || 'fetch failed';
+        const updateConnectionHint = context.envName
+            ? `If you recently changed the server address, update env "${context.envName}" with \`nb env update ${context.envName} --api-base-url <url>\` and retry the original command.`
+            : 'If you recently changed the server address, update the saved env connection with `nb env update <name> --api-base-url <url>` and retry the original command.';
         return [
             'Failed to reach the NocoBase server while loading the command runtime from `swagger:get`.',
             `Base URL: ${context.baseUrl}`,
             `Network error: ${rawMessage}`,
             'Check that the NocoBase app is running, the base URL is correct, and the server is reachable from this machine.',
-            'If you recently changed the server address, update it with `nb env add <name> --api-base-url <url>` and retry `nb env update`.',
+            updateConnectionHint,
             'Use `nb env list` to inspect the current env configuration.',
         ].join('\n');
     }
@@ -282,7 +288,7 @@ export function formatMissingRuntimeEnvError(commandToken) {
     if (!commandToken) {
         return [
             'No env is configured for runtime commands.',
-            'Run `nb env add <name> --api-base-url <url>` first.',
+            'Run `nb init --ui` first.',
             'If you configure multiple environments later, switch with `nb env use <name>`.',
         ].join('\n');
     }
@@ -290,7 +296,7 @@ export function formatMissingRuntimeEnvError(commandToken) {
         `Unable to resolve runtime command \`${commandToken}\`.`,
         'No env is configured, so the CLI cannot load runtime commands from `swagger:get`.',
         'If this is a built-in command or a typo, run `nb --help` to inspect available commands.',
-        'If this should be an application runtime command, run `nb env add <name> --api-base-url <url>` and then `nb env update`.',
+        'If this should be an application runtime command, run `nb init --ui` to create or connect a NocoBase app first.',
     ].join('\n');
 }
 export async function ensureRuntimeFromArgv(argv, options) {
@@ -366,8 +372,8 @@ export async function updateEnvRuntime(options) {
         throw new Error([
             env
                 ? `Env "${envName}" is missing a base URL.`
-                : `Env "${envName}" is not configured. Run \`nb env add ${envName}\` first.`,
-            env ? 'Update it with `nb env add <name> --api-base-url <url>` first.' : '',
+                : `Env "${envName}" is not configured. Run \`nb init --ui --env ${envName}\` first.`,
+            env ? `Update env "${envName}" with \`nb env update ${envName} --api-base-url <url>\` first.` : '',
         ]
             .filter(Boolean)
             .join('\n'));

package/dist/lib/cli-config.js

@@ -15,8 +15,11 @@ export const DEFAULT_DOCKER_CONTAINER_PREFIX = 'nb';
 export const DEFAULT_DOCKER_BIN = 'docker';
 export const DEFAULT_GIT_BIN = 'git';
 export const DEFAULT_YARN_BIN = 'yarn';
+export const CLI_UPDATE_POLICY_OPTIONS = ['prompt', 'auto', 'off'];
+export const DEFAULT_UPDATE_POLICY = 'prompt';
 export const SUPPORTED_CLI_CONFIG_KEYS = [
     'locale',
+    'update.policy',
     'license.pkg-url',
     'docker.network',
     'docker.container-prefix',
@@ -42,9 +45,17 @@ export function assertSupportedCliConfigKey(value) {
     }
     return value;
 }
+export function normalizeCliUpdatePolicy(value) {
+    const normalized = trimValue(value);
+    if (!normalized) {
+        return undefined;
+    }
+    return CLI_UPDATE_POLICY_OPTIONS.includes(normalized) ? normalized : undefined;
+}
 function cloneSettings(config) {
     return {
         ...(config.settings?.locale ? { locale: trimValue(config.settings.locale) } : {}),
+        update: config.settings?.update ? { ...config.settings.update } : undefined,
         license: config.settings?.license ? { ...config.settings.license } : undefined,
         docker: config.settings?.docker ? { ...config.settings.docker } : undefined,
         bin: config.settings?.bin ? { ...config.settings.bin } : undefined,
@@ -54,6 +65,10 @@ function pruneSettings(config) {
     if (config.settings && !trimValue(config.settings.locale)) {
         delete config.settings.locale;
     }
+    const update = config.settings?.update;
+    if (update && !normalizeCliUpdatePolicy(update.policy)) {
+        delete config.settings?.update;
+    }
     const license = config.settings?.license;
     if (license && !trimValue(license.pkgUrl)) {
         delete config.settings?.license;
@@ -68,6 +83,7 @@ function pruneSettings(config) {
     }
     if (config.settings &&
         !config.settings.locale &&
+        !config.settings.update &&
         !config.settings.license &&
         !config.settings.docker &&
         !config.settings.bin) {
@@ -78,6 +94,8 @@ export function getExplicitCliConfigValue(config, key) {
     switch (key) {
         case 'locale':
             return trimValue(config.settings?.locale);
+        case 'update.policy':
+            return normalizeCliUpdatePolicy(config.settings?.update?.policy);
         case 'license.pkg-url':
             return trimValue(config.settings?.license?.pkgUrl);
         case 'docker.network':
@@ -100,6 +118,8 @@ export function getEffectiveCliConfigValue(config, key) {
     switch (key) {
         case 'locale':
             return resolveCliLocale(undefined, { configuredLocale: trimValue(config.settings?.locale) });
+        case 'update.policy':
+            return explicit ?? DEFAULT_UPDATE_POLICY;
         case 'license.pkg-url':
             return DEFAULT_LICENSE_PKG_URL;
         case 'docker.network':
@@ -129,6 +149,13 @@ export function normalizeCliConfigValue(key, value) {
         }
         return locale;
     }
+    if (key === 'update.policy') {
+        const policy = normalizeCliUpdatePolicy(normalized);
+        if (!policy) {
+            throw new Error(`Config key "${key}" must be one of: ${CLI_UPDATE_POLICY_OPTIONS.join(', ')}`);
+        }
+        return policy;
+    }
     return normalized;
 }
 export async function loadCliConfig(options = {}) {
@@ -158,6 +185,12 @@ export async function setCliConfigValue(key, value, options = {}) {
         case 'locale':
             config.settings.locale = normalized;
             break;
+        case 'update.policy':
+            config.settings.update = {
+                ...(config.settings.update ?? {}),
+                policy: normalized,
+            };
+            break;
         case 'license.pkg-url':
             config.settings.license = {
                 ...(config.settings.license ?? {}),
@@ -211,6 +244,11 @@ export async function deleteCliConfigValue(key, options = {}) {
         case 'locale':
             delete config.settings.locale;
             break;
+        case 'update.policy':
+            if (config.settings.update) {
+                delete config.settings.update.policy;
+            }
+            break;
         case 'license.pkg-url':
             if (config.settings.license) {
                 delete config.settings.license.pkgUrl;

package/dist/lib/cli-entry-error.js

@@ -0,0 +1,44 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+export function getCommandPathTokens(argv) {
+    const tokens = [];
+    for (const token of argv) {
+        if (!token) {
+            continue;
+        }
+        if (token.startsWith('-')) {
+            break;
+        }
+        tokens.push(token);
+    }
+    return tokens;
+}
+export function formatCliEntryError(error, argv) {
+    const message = error instanceof Error ? error.message : String(error);
+    const missingCommandMatch = message.match(/^Command (.+) not found\.$/);
+    if (!missingCommandMatch) {
+        return message;
+    }
+    const commandPathTokens = getCommandPathTokens(argv);
+    const attemptedCommand = commandPathTokens.join(' ') || missingCommandMatch[1];
+    const isApiCommand = commandPathTokens[0] === 'api';
+    if (isApiCommand) {
+        const helpCommandTokens = commandPathTokens.length > 2 ? commandPathTokens.slice(0, -1) : ['api'];
+        const helpCommand = `nb ${helpCommandTokens.join(' ')} --help`;
+        return [
+            `Unknown command: \`${attemptedCommand}\`.`,
+            `If this is a built-in command or a typo, run \`${helpCommand}\` to inspect the commands available under that API group.`,
+        ].join('\n');
+    }
+    return [
+        `Unknown command: \`${attemptedCommand}\`.`,
+        'If this is a built-in command or a typo, run `nb --help` to inspect available commands.',
+        `If \`${attemptedCommand}\` should be a runtime command from your NocoBase app, check whether the connected app exposes it, then retry the command.`,
+    ].join('\n');
+}

package/dist/lib/docker-log-stream.js

@@ -0,0 +1,45 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { spawn } from 'node:child_process';
+const DEFAULT_DOCKER_LOG_TAIL = 50;
+export function startDockerLogFollower(containerName, options) {
+    const tail = Math.max(0, options?.tail ?? DEFAULT_DOCKER_LOG_TAIL);
+    const child = spawn('docker', ['logs', '--tail', String(tail), '--follow', containerName], {
+        stdio: 'inherit',
+    });
+    let settled = false;
+    let resolveClosed;
+    const closed = new Promise((resolve) => {
+        resolveClosed = resolve;
+    });
+    const settle = () => {
+        if (!settled) {
+            settled = true;
+            resolveClosed();
+        }
+    };
+    child.once('error', settle);
+    child.once('close', settle);
+    return {
+        stop: async () => {
+            if (settled) {
+                return;
+            }
+            try {
+                if (!child.kill()) {
+                    settle();
+                }
+            }
+            catch {
+                settle();
+            }
+            await closed;
+        },
+    };
+}

package/dist/lib/env-auth.js

@@ -629,19 +629,19 @@ async function createLoopbackServer(state) {
         });
         let resolveWaiter;
         let rejectWaiter;
-        const waitForCode = () => new Promise((resolveCode, rejectCode) => {
+        const waitForCode = () => new Promise((resolve, reject) => {
             resolveWaiter = (code) => {
                 void close();
-                resolveCode(code);
+                resolve(code);
             };
             rejectWaiter = (error) => {
                 void close();
-                rejectCode(error);
+                reject(error);
             };
         });
         const close = async () => {
-            await new Promise((resolveClose) => {
-                server.close(() => resolveClose());
+            await new Promise((resolve) => {
+                server.close(() => resolve());
             });
         };
         server.on('error', (error) => {
@@ -772,7 +772,7 @@ export async function resolveAccessToken(options) {
     }
     const baseUrl = options.baseUrl ?? env.baseUrl;
     if (!baseUrl) {
-        throw new Error(`Env "${envName}" is missing a base URL. Run \`nb env add ${envName} --api-base-url <url>\`.`);
+        throw new Error(`Env "${envName}" is missing a base URL. Update it with \`nb env update ${envName} --api-base-url <url>\` first.`);
     }
     printVerbose(`Refreshing OAuth session for env "${envName}"`);
     return refreshOauthAccessToken({
@@ -793,7 +793,12 @@ export async function resolveServerRequestTarget(options) {
         scope: options.scope,
     });
     if (!baseUrl) {
-        throw new Error('Missing base URL. Use --api-base-url or configure one with `nb env add`.');
+        throw new Error([
+            env ? `Env "${envName}" is missing a base URL.` : `Env "${envName}" is not configured.`,
+            env
+                ? `Use --api-base-url or update env "${envName}" with \`nb env update ${envName} --api-base-url <url>\`.`
+                : `Use --api-base-url or run \`nb init --ui --env ${envName}\` first.`,
+        ].join('\n'));
     }
     return { baseUrl, token };
 }
@@ -807,8 +812,8 @@ export async function authenticateEnvWithBasic(options) {
                 ? `Environment "${envName}" does not have an API base URL yet.`
                 : `Environment "${envName}" has not been set up yet.`,
             env
-                ? `Run \`nb env add ${envName} --api-base-url <url>\` to finish setting it up.`
-                : `Run \`nb env add ${envName}\` first.`,
+                ? `Run \`nb env update ${envName} --api-base-url <url>\` to finish setting it up.`
+                : `Run \`nb init --ui --env ${envName}\` first.`,
         ]
             .filter(Boolean)
             .join('\n'));
@@ -864,8 +869,8 @@ export async function authenticateEnvWithOauth(options) {
                 ? `Environment "${envName}" does not have an API base URL yet.`
                 : `Environment "${envName}" has not been set up yet.`,
             env
-                ? `Run \`nb env add ${envName} --api-base-url <url>\` to finish setting it up.`
-                : `Run \`nb env add ${envName}\` first.`,
+                ? `Run \`nb env update ${envName} --api-base-url <url>\` to finish setting it up.`
+                : `Run \`nb init --ui --env ${envName}\` first.`,
         ]
             .filter(Boolean)
             .join('\n'));
@@ -912,10 +917,13 @@ export async function authenticateEnvWithOauth(options) {
         const code = await new Promise((resolve, reject) => {
             const timeout = setTimeout(() => reject(new Error(`OAuth sign-in timed out after 5 minutes. Run \`nb env auth ${envName}\` to try again.`)), OAUTH_LOGIN_TIMEOUT_MS);
             timeout.unref?.();
-            callback.waitForCode().then((value) => {
+            callback
+                .waitForCode()
+                .then((value) => {
                 clearTimeout(timeout);
                 resolve(value);
-            }, (error) => {
+            })
+                .catch((error) => {
                 clearTimeout(timeout);
                 reject(error);
             });

package/dist/lib/source-publish.js

@@ -292,6 +292,9 @@ export async function publishSourceSnapshot(params) {
     if (publishError) {
         throw publishError;
     }
+    if (!result) {
+        throw new Error('Source snapshot publishing finished without a result.');
+    }
     return result;
 }
 export function buildSuggestedInitCommand(result) {
@@ -299,7 +302,7 @@ export function buildSuggestedInitCommand(result) {
     const normalizedRegistry = result.npmRegistry || `http://${host}:${port || DEFAULT_SOURCE_REGISTRY_PORT}`;
     const suggestedEnv = ['snapshot', sanitizeEnvSegment(result.gitSha)].filter(Boolean).join('');
     return [
-        `nb init --env ${suggestedEnv} --yes --source npm`,
+        `nb init --ui --env ${suggestedEnv} --yes --source npm`,
         `--version ${result.version}`,
         `--npm-registry=${normalizedRegistry}`,
     ].join(' ');