@nocobase/cli 2.1.0-alpha.40 → 2.1.0-alpha.46

package/dist/lib/skills-manager.js

@@ -17,6 +17,72 @@ import { commandOutput, commandOutputViaFile, run } from './run-npm.js';
 export const NOCOBASE_SKILLS_SOURCE = 'nocobase/skills';
 export const NOCOBASE_SKILLS_PACKAGE_NAME = '@nocobase/skills';
 const NOCOBASE_SKILLS_NAME_PREFIX = 'nocobase-';
+const SKILLS_LIST_TIMEOUT_MS = 5000;
+const SKILLS_NPM_VIEW_TIMEOUT_MS = 3000;
+const SKILLS_PACK_TIMEOUT_MS = 30000;
+const SKILLS_ADD_TIMEOUT_MS = 20000;
+const NPM_REGISTRY_UNAVAILABLE_PATTERNS = [
+    'enotfound',
+    'eai_again',
+    'etimedout',
+    'esockettimedout',
+    'econnreset',
+    'econnrefused',
+    'ehostunreach',
+    'enetunreach',
+    'socket hang up',
+    'getaddrinfo',
+    'fetch failed',
+    'network request to',
+    'self_signed_cert',
+    'depth_zero_self_signed_cert',
+    'unable_to_verify_leaf_signature',
+    'cert_has_expired',
+    'timed out after',
+];
+function collectErrorMessages(error) {
+    const messages = [];
+    const queue = [error];
+    const seen = new Set();
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (current === undefined || current === null || seen.has(current)) {
+            continue;
+        }
+        seen.add(current);
+        if (current instanceof Error) {
+            if (current.message) {
+                messages.push(current.message);
+            }
+            const cause = current.cause;
+            if (cause !== undefined) {
+                queue.push(cause);
+            }
+            continue;
+        }
+        if (typeof current === 'string') {
+            messages.push(current);
+            continue;
+        }
+        if (typeof current === 'object') {
+            if ('message' in current && typeof current.message === 'string') {
+                messages.push(current.message);
+            }
+            if ('cause' in current) {
+                queue.push(current.cause);
+            }
+            continue;
+        }
+        messages.push(String(current));
+    }
+    return messages;
+}
+export function isNpmRegistryUnavailable(error) {
+    return collectErrorMessages(error).some((message) => {
+        const normalized = message.toLowerCase();
+        return NPM_REGISTRY_UNAVAILABLE_PATTERNS.some((pattern) => normalized.includes(pattern));
+    });
+}
 function normalizePath(value) {
     return path.resolve(value);
 }
@@ -61,6 +127,12 @@ async function readManagedSkillsState(workspaceRoot) {
         return undefined;
     }
 }
+export async function readInstalledManagedSkillsVersion(options = {}) {
+    const globalRoot = resolveSkillsRoot(options);
+    const state = await readManagedSkillsState(globalRoot);
+    const installedVersion = String(state?.installedVersion ?? state?.installedRef ?? '').trim();
+    return installedVersion || undefined;
+}
 async function writeManagedSkillsState(workspaceRoot, state) {
     const filePath = getManagedSkillsStateFile(workspaceRoot);
     await fsp.mkdir(path.dirname(filePath), { recursive: true });
@@ -72,6 +144,7 @@ export async function listGlobalSkills(options = {}) {
     const output = await (options.commandOutputFn ?? commandOutputViaFile)('npx', ['-y', 'skills', 'list', '-g', '--json'], {
         cwd: globalRoot,
         errorName: 'skills list',
+        timeoutMs: SKILLS_LIST_TIMEOUT_MS,
     });
     const parsed = JSON.parse(output);
     return Array.isArray(parsed) ? parsed : [];
@@ -95,6 +168,7 @@ async function readPublishedSkillsVersion(options = {}) {
         const output = await (options.commandOutputFn ?? commandOutput)('npm', ['view', NOCOBASE_SKILLS_PACKAGE_NAME, 'version', '--json'], {
             cwd: globalRoot,
             errorName: 'npm view',
+            timeoutMs: SKILLS_NPM_VIEW_TIMEOUT_MS,
         });
         const parsed = JSON.parse(output);
         const version = String(parsed ?? '').trim();
@@ -187,6 +261,7 @@ async function prepareLocalSkillsPackage(globalRoot, options = {}, targetVersion
             cwd: packRoot,
             stdio: options.verbose ? 'inherit' : 'ignore',
             errorName: 'npm pack',
+            timeoutMs: SKILLS_PACK_TIMEOUT_MS,
         });
         const tarballPath = await resolvePackedSkillsTarball(packRoot);
         await extractPackedSkillsTarball(tarballPath, cacheRoot, targetVersion);
@@ -276,6 +351,7 @@ async function reinstallManagedSkills(globalRoot, options = {}, targetVersion) {
             cwd: globalRoot,
             stdio: options.verbose ? 'inherit' : 'ignore',
             errorName: 'skills add',
+            timeoutMs: SKILLS_ADD_TIMEOUT_MS,
         });
     }
     finally {
@@ -314,10 +390,10 @@ export async function updateNocoBaseSkills(options = {}) {
             status,
         };
     }
-    if (status.managedByNb
-        && status.latestVersion
-        && status.installedVersion
-        && compareVersions(status.latestVersion, status.installedVersion) <= 0) {
+    if (status.managedByNb &&
+        status.latestVersion &&
+        status.installedVersion &&
+        compareVersions(status.latestVersion, status.installedVersion) <= 0) {
         return {
             action: 'noop',
             reason: 'up-to-date',

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(' ');

package/dist/lib/startup-update.js

@@ -10,6 +10,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { confirm } from "./inquirer.js";
+import { DEFAULT_UPDATE_POLICY, getExplicitCliConfigValue, loadCliConfig, } from './cli-config.js';
 import { inspectSelfInstall, inspectSelfStatus, } from './self-manager.js';
 import { inspectSkillsStatus } from './skills-manager.js';
 import { resolveCliHomeDir } from './cli-home.js';
@@ -83,39 +84,53 @@ async function writeCurrentInstallEntry(updater) {
     const state = await readState();
     const installBinPath = getCurrentInstallBinPath();
     const nextEntry = updater(getCurrentInstallEntry(state), state);
+    const entries = {
+        ...(state.entries ?? {}),
+    };
+    if (nextEntry?.policy || nextEntry?.lastCheckedDate) {
+        entries[installBinPath] = nextEntry;
+    }
+    else {
+        delete entries[installBinPath];
+    }
     await writeState({
         ...state,
-        entries: {
-            ...(state.entries ?? {}),
-            [installBinPath]: nextEntry,
-        },
+        entries: Object.keys(entries).length ? entries : undefined,
     });
 }
 async function markChecked(now = new Date()) {
-    await writeCurrentInstallEntry((current, state) => {
+    await writeCurrentInstallEntry((current) => {
         return {
-            policy: current?.policy ?? 'daily',
+            ...current,
             lastCheckedDate: todayStamp(now),
         };
     });
 }
-async function disableStartupUpdateForCurrentInstall() {
-    await writeCurrentInstallEntry((current, state) => {
-        return {
-            policy: 'disabled',
-            lastCheckedDate: current?.lastCheckedDate
-                ?? state.lastCheckedDate,
-        };
-    });
+function resolveLegacyStartupUpdatePolicy(state) {
+    const policy = getCurrentInstallEntry(state)?.policy;
+    if (policy === 'disabled') {
+        return 'off';
+    }
+    if (policy === 'daily') {
+        return 'prompt';
+    }
+    return undefined;
 }
-async function enableDailyStartupUpdateForCurrentInstall() {
-    await writeCurrentInstallEntry((current, state) => {
-        return {
-            policy: 'daily',
-            lastCheckedDate: current?.lastCheckedDate
-                ?? state.lastCheckedDate,
-        };
-    });
+async function resolveStartupUpdatePolicy(state) {
+    const config = await loadCliConfig({ scope: 'global' });
+    const explicit = getExplicitCliConfigValue(config, 'update.policy');
+    return explicit ?? resolveLegacyStartupUpdatePolicy(state) ?? DEFAULT_UPDATE_POLICY;
+}
+export async function clearLegacyStartupUpdatePolicyForCurrentInstall() {
+    const state = await readState();
+    const current = getCurrentInstallEntry(state);
+    if (!current?.policy) {
+        return false;
+    }
+    await writeCurrentInstallEntry(() => ({
+        lastCheckedDate: current.lastCheckedDate,
+    }));
+    return true;
 }
 export async function shouldRunStartupUpdateCheck(argv, now = new Date()) {
     if (process.env[NB_SKIP_STARTUP_UPDATE_ENV] === '1') {
@@ -125,19 +140,14 @@ export async function shouldRunStartupUpdateCheck(argv, now = new Date()) {
         return false;
     }
     const state = await readState();
-    const currentEntry = getCurrentInstallEntry(state);
-    if (currentEntry?.policy === 'disabled') {
+    const policy = await resolveStartupUpdatePolicy(state);
+    if (policy === 'off') {
         return false;
     }
-    if (currentEntry?.policy === 'daily') {
-        return readCurrentInstallLastCheckedDate(state) !== todayStamp(now);
-    }
     const selfInstall = await inspectSelfInstall();
     if (!shouldEnableStartupUpdateForInstallMethod(selfInstall.installMethod)) {
-        await disableStartupUpdateForCurrentInstall();
         return false;
     }
-    await enableDailyStartupUpdateForCurrentInstall();
     return readCurrentInstallLastCheckedDate(state) !== todayStamp(now);
 }
 export function shouldEnableStartupUpdateForInstallMethod(installMethod) {
@@ -189,14 +199,13 @@ function buildPromptMessage(selfStatus, skillsStatus) {
     return lines.join('\n');
 }
 function buildUpdateCommands(selfStatus, skillsStatus) {
-    const commands = [];
     if (selfStatus.updateAvailable && selfStatus.updatable) {
-        commands.push('nb self update --yes');
+        return [skillsStatus.updateAvailable === true ? 'nb self update --yes --skills' : 'nb self update --yes'];
     }
     if (skillsStatus.updateAvailable === true) {
-        commands.push('nb skills update --yes');
+        return ['nb skills update --yes'];
     }
-    return commands;
+    return [];
 }
 function buildNonInteractiveWarning(selfStatus, skillsStatus) {
     const commands = buildUpdateCommands(selfStatus, skillsStatus);
@@ -233,26 +242,36 @@ function buildDeclinedWarning(selfStatus, skillsStatus) {
         'You may run into compatibility issues until you update.',
     ].join(' ');
 }
-async function runStartupUpdates() {
-    await run('nb', ['self', 'update', '--yes'], {
-        stdio: 'inherit',
-        env: {
-            [NB_SKIP_STARTUP_UPDATE_ENV]: '1',
-        },
-        errorName: 'nb self update',
-    });
-    await run('nb', ['skills', 'update', '--yes'], {
-        stdio: 'inherit',
-        env: {
-            [NB_SKIP_STARTUP_UPDATE_ENV]: '1',
-        },
-        errorName: 'nb skills update',
-    });
+async function runStartupUpdates(selfStatus, skillsStatus) {
+    if (selfStatus.updateAvailable && selfStatus.updatable) {
+        const args = ['self', 'update', '--yes'];
+        if (skillsStatus.updateAvailable === true) {
+            args.push('--skills');
+        }
+        await run('nb', args, {
+            stdio: 'inherit',
+            env: {
+                [NB_SKIP_STARTUP_UPDATE_ENV]: '1',
+            },
+            errorName: 'nb self update',
+        });
+        return;
+    }
+    if (skillsStatus.updateAvailable === true) {
+        await run('nb', ['skills', 'update', '--yes'], {
+            stdio: 'inherit',
+            env: {
+                [NB_SKIP_STARTUP_UPDATE_ENV]: '1',
+            },
+            errorName: 'nb skills update',
+        });
+    }
 }
-export async function maybeRunStartupUpdatePrompt(argv) {
+export async function maybeRunStartupUpdate(argv) {
     if (!(await shouldRunStartupUpdateCheck(argv))) {
         return { kind: 'skipped' };
     }
+    const policy = await resolveStartupUpdatePolicy(await readState());
     const selfStatus = await inspectSelfStatus();
     const skillsStatus = await inspectSkillsStatus();
     if (!hasPendingUpdates(selfStatus, skillsStatus)) {
@@ -264,6 +283,11 @@ export async function maybeRunStartupUpdatePrompt(argv) {
         await markChecked();
         return { kind: 'warned' };
     }
+    if (policy === 'auto') {
+        await runStartupUpdates(selfStatus, skillsStatus);
+        await markChecked();
+        return { kind: 'updated' };
+    }
     let answer = false;
     try {
         answer = await confirm({
@@ -279,7 +303,7 @@ export async function maybeRunStartupUpdatePrompt(argv) {
         await markChecked();
         return { kind: 'declined' };
     }
-    await runStartupUpdates();
+    await runStartupUpdates(selfStatus, skillsStatus);
     await markChecked();
     return { kind: 'updated' };
 }

package/dist/lib/ui.js

@@ -54,7 +54,10 @@ export function printInfo(message) {
     console.log(pc.cyan(message));
 }
 export function announceTargetEnv(envName) {
-    printInfo(`Target env: ${envName}`);
+    if (process.env.NB_SKIP_TARGET_ENV_LOG === '1') {
+        return;
+    }
+    printInfo(`Using env "${envName}".`);
 }
 export function printVerbose(message) {
     if (!verboseMode) {

package/dist/locale/en-US.json

@@ -34,6 +34,8 @@
       "back": "Back",
       "next": "Next",
       "submit": "Submit & continue in terminal",
+      "showPassword": "Show password",
+      "hidePassword": "Hide password",
       "checking": "Checking...",
       "sending": "Sending...",
       "successTitle": "Success",
@@ -73,7 +75,8 @@
       "timeout": "Timed out connecting to the database at {{host}}:{{port}} after about {{seconds}} seconds.",
       "authenticationFailed": "Failed to sign in to database \"{{database}}\" with user \"{{user}}\". Check the username and password.",
       "databaseNotFound": "Database \"{{database}}\" does not exist or is not accessible with the current connection settings.",
-      "connectionFailed": "Database connection check failed. Details: {{details}}"
+      "connectionFailed": "Database connection check failed. Details: {{details}}",
+      "lowerCaseTableNamesRequiresUnderscored": "MySQL lower_case_table_names=1 requires DB_UNDERSCORED=true."
     }
   },
   "commands": {
@@ -94,16 +97,28 @@
         },
         "authType": {
           "message": "How would you like to sign in?",
+          "basicLabel": "Basic login (username + password)",
+          "basicHint": "uses your credentials to fetch a token after save",
           "oauthLabel": "OAuth (browser login)",
           "oauthHint": "runs nb env auth after save",
           "tokenLabel": "API token / API key"
         },
+        "username": {
+          "message": "Enter the username for basic login",
+          "placeholder": "admin"
+        },
+        "password": {
+          "message": "Enter the password for basic login"
+        },
         "accessToken": {
           "message": "Enter an API token or API key",
           "placeholder": "Enter your API token / API key"
         }
       }
     },
+    "shared": {
+      "missingCommand": "Couldn't run `{{action}}` because the {{displayName}} executable could not be found. Install {{displayName}} or update `nb config set {{configKey}} <path>` and try again."
+    },
     "download": {
       "failures": {
         "dependencyInstall": {
@@ -206,6 +221,10 @@
       }
     },
     "install": {
+      "messages": {
+        "skipDownloadDockerImageMissing": "Cannot continue with `--skip-download` because Docker image \"{{imageRef}}\" is not available locally. Load or pull the image first, or run the command again without `--skip-download`.",
+        "skipDownloadLocalAppMissing": "Cannot continue with `--skip-download` because \"{{projectRoot}}\" is missing or does not contain a package.json file. Point `--app-root-path` to an existing NocoBase app, or run the command again without `--skip-download`."
+      },
       "validation": {
         "builtinDbUnsupported": "Built-in database does not support \"{{dialect}}\" yet. Choose PostgreSQL, MySQL, or MariaDB, or turn off built-in database."
       },
@@ -229,9 +248,6 @@
           "message": "Where should uploads and local files be stored?",
           "placeholder": "./<env>/storage/"
         },
-        "fetchSource": {
-          "message": "Download NocoBase automatically if the app directory is empty?"
-        },
         "dbDialect": {
           "message": "Which database would you like to use?"
         },
@@ -259,6 +275,17 @@
         "dbPassword": {
           "message": "What is the database password?"
         },
+        "dbSchema": {
+          "message": "What is the database schema? (PostgreSQL only, optional)",
+          "placeholder": "Leave empty to use the default schema"
+        },
+        "dbTablePrefix": {
+          "message": "What table prefix should be used? (optional)",
+          "placeholder": "For example: nb_"
+        },
+        "dbUnderscored": {
+          "message": "Use underscored names for database tables and columns?"
+        },
         "rootUsername": {
           "message": "Choose the initial admin username",
           "placeholder": "nocobase"
@@ -290,7 +317,8 @@
         "uiOpening": "A local setup form will open in your browser. That form needs a person to fill it in. If you are using an AI agent, do not stop this process while the CLI waits for the submission.",
         "uiReady": "Local setup form is ready.",
         "uiReadyHelp": "If your browser does not open automatically, copy the URL below into your browser to continue. Keep this terminal session running while the CLI waits for the submission.",
-        "uiOpenBrowserFallback": "We could not open your browser automatically. Copy the URL above into your browser to continue setup, and keep this terminal session running. If you are using an AI agent, do not stop the current process."
+        "uiOpenBrowserFallback": "We could not open your browser automatically. Copy the URL above into your browser to continue setup, and keep this terminal session running. If you are using an AI agent, do not stop the current process.",
+        "skillsSyncRegistryUnavailable": "Couldn't reach the npm registry to sync NocoBase AI coding skills. Skipping skills install and continuing init. Run `nb skills install` later when registry access is available."
       },
       "prompts": {
         "appName": {
@@ -308,6 +336,9 @@
         "apiBaseUrl": {
           "message": "API base URL",
           "placeholder": "https://demo.example.com/api or https://demo.example.com/api/__app/<subapp>"
+        },
+        "skipDownload": {
+          "message": "Skip downloading NocoBase and reuse existing local app files or Docker images"
         }
       },
       "webUi": {
@@ -339,6 +370,62 @@
           "description": "Set up the first admin."
         }
       }
+    },
+    "env": {
+      "messages": {
+        "noEnvsConfigured": "No envs configured.",
+        "noEnvsConfiguredHelp": "Run `nb init --ui` to create one first."
+      }
     }
+  },
+  "apiCommandCompat": {
+    "refusalTitle": "Refusing to run `nb api {{commandId}}` because the current CLI version is {{cliVersion}} while the target app version is {{appVersion}}.",
+    "refusalTitleMissingVersion": "Refusing to run `nb api {{commandId}}` because the {{versionLabel}} is unavailable.",
+    "refusalTitleGeneric": "Refusing to run `nb api {{commandId}}` because the current version combination is not compatible.",
+    "currentVersionsLine": "Current versions: {{versions}}.",
+    "refusalBodyWithRequirements": "This API command is blocked when used with {{requirements}}.",
+    "refusalBody": "This API command may not be compatible with the current CLI and app version combination.",
+    "channel": {
+      "stable": "stable",
+      "beta": "beta",
+      "alpha": "alpha",
+      "rc": "rc",
+      "unknownPrerelease": "unsupported prerelease"
+    },
+    "requirement": {
+      "cli": "CLI version {{condition}}",
+      "app": "app version {{condition}}",
+      "skills": "NocoBase AI skills version {{condition}}",
+      "appChannel": "{{channelLabel}} app version {{condition}}",
+      "appUnknownPrereleaseBlocked": "{{channelLabel}} app versions are blocked"
+    },
+    "currentVersion": {
+      "cli": "CLI {{version}}",
+      "app": "app {{version}}",
+      "appUnavailable": "app unavailable",
+      "skills": "NocoBase AI skills {{version}}",
+      "skillsUnavailable": "NocoBase AI skills unavailable"
+    },
+    "versionLabel": {
+      "cli": "CLI version",
+      "app": "target app version",
+      "skills": "installed NocoBase AI skills version"
+    },
+    "join": {
+      "two": "{{left}} and {{right}}",
+      "many": "{{head}}, and {{tail}}"
+    },
+    "continueTitle": "To continue:",
+    "continueUpgradeApp": "- upgrade the app to a compatible version",
+    "continueUpgradeAppToVersion": "- upgrade the app to {{suggestedUpgradeTarget}}",
+    "continueUseSupportedAppVersion": "- use a supported app version: {{supportedTargets}}",
+    "continueRefreshAppVersion": "- refresh the target env runtime so the current app version can be detected, then retry",
+    "continueUseCompatibleCli": "- or use a compatible CLI version",
+    "continueUseCompatibleCliVersion": "- or use a CLI version {{suggestedCliTarget}}",
+    "continueUpdateSkillsToVersion": "- install or update the NocoBase AI coding skills to {{suggestedSkillsUpgradeTarget}}. Run `nb skills update --yes` to refresh the managed skills.",
+    "continueUseCompatibleSkillsVersion": "- or use a NocoBase AI skills version {{suggestedSkillsTarget}}",
+    "continueInstallOrUpdateSkillsToVersion": "- run `nb skills install --yes` or `nb skills update --yes`, and make sure the managed skills version is {{suggestedSkillsUpgradeTarget}} before retrying",
+    "continueInstallOrUpdateSkills": "- run `nb skills install --yes` or `nb skills update --yes`, then retry once the managed skills version is available",
+    "supportedAppTarget": "{{channelLabel}} {{target}}"
   }
 }