@nocobase/cli 2.2.0-alpha.1 → 2.2.0-alpha.2

package/dist/commands/init.js

@@ -15,7 +15,7 @@ import { stdin as stdinStream, stdout as stdoutStream } from 'node:process';
 import { getEnv, upsertEnv } from "../lib/auth-store.js";
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
 import { applyCliLocale, localeText, translateCli } from "../lib/cli-locale.js";
-import { resolveDefaultConfigScope } from '../lib/cli-home.js';
+import { resolveConfiguredEnvPath, resolveDefaultConfigScope, resolveEnvRelativePath } from '../lib/cli-home.js';
 import { resolveDefaultApiHost, resolveDefaultUiHost } from '../lib/cli-config.js';
 import { areConfiguredPathsEquivalent, deriveConfiguredSourcePath, deriveConfiguredStoragePath, inferConfiguredAppPathFromLegacyConfig, } from '../lib/env-paths.js';
 import { formatMissingManagedAppEnvMessage } from '../lib/app-runtime.js';
@@ -23,7 +23,9 @@ import { runPromptCatalogWebUI } from "../lib/prompt-web-ui.js";
 import { validateApiBaseUrl, validateEnvKey } from "../lib/prompt-validators.js";
 import { installNocoBaseSkills, isNpmRegistryUnavailable } from '../lib/skills-manager.js';
 import { omitKeys, pickKeys } from "../lib/object-utils.js";
+import { ENV_CONFIG_SCHEMA_VERSION } from '../lib/env-config.js';
 import { printInfo, printStage, printVerbose, printWarning } from '../lib/ui.js';
+import { persistHookScript } from '../lib/hook-script.js';
 import Download from "./download.js";
 import EnvAdd from "./env/add.js";
 import Install, { defaultDbPortForDialect } from "./install.js";
@@ -246,16 +248,12 @@ function formatBrowserOpenError(error) {
     return String(error);
 }
 export default class Init extends Command {
-    static summary = 'Set up NocoBase so coding agents can connect and work with it';
-    static description = `Set up NocoBase for coding agents in the current workspace.
+    static summary = 'Set up or connect a NocoBase environment in the current workspace';
+    static description = `Set up NocoBase in the current workspace.
 
-\`nb init\` prepares a NocoBase environment that coding agents can use. It supports three setup paths:
+\`nb init\` helps you install a new NocoBase app, take over managing one that already exists on this machine, or connect a remote NocoBase app and save it as a CLI env.
 
-- Install a new NocoBase app, then save it as a CLI env.
-- Take over managing an app that already exists on this machine by reusing its database.
-- Connect a remote NocoBase app and save it as a CLI env.
-
-It can also install NocoBase AI coding skills (\`nocobase/skills\`) so agents get the project-specific workflow guidance.
+You can use the saved environment directly, or let a coding agent access it later. It can also install NocoBase AI coding skills (\`nocobase/skills\`) when you want agent-specific workflow guidance.
 
 If setup was interrupted earlier, use \`--resume\` with an existing env name to continue from the saved workspace config.
 
@@ -475,7 +473,7 @@ Prompt modes:
             default: false,
         }),
         'ui-host': Flags.string({
-            description: 'Host for the local --ui setup server (default: 127.0.0.1)',
+            description: 'Browser-accessible host for the --ui setup page URL (default: 127.0.0.1)',
         }),
         'ui-port': Flags.integer({
             description: 'Port for the local --ui setup server; 0 lets the OS choose an available port',
@@ -1032,6 +1030,14 @@ Prompt modes:
         const skipDownload = results.skipDownload === true;
         const appKey = resolveManagedAppKey(results.appKey ?? existingEnv?.config.appKey);
         const timeZone = resolveManagedTimeZone(results.timeZone ?? existingEnv?.config.timezone);
+        const hookScriptInput = String(flags['hook-script'] ?? '').trim();
+        const hookAppPath = appPath || `./${envName}/`;
+        const hookScript = hookScriptInput
+            ? await persistHookScript({
+                sourcePath: hookScriptInput,
+                appPath: resolveConfiguredEnvPath(hookAppPath) ?? resolveEnvRelativePath(hookAppPath),
+            })
+            : String(results.hookScript ?? '').trim();
         const builtinDb = explicitDbHostFlag(flags)
             ? false
             : results.builtinDb === undefined
@@ -1040,6 +1046,7 @@ Prompt modes:
         results.appKey = appKey;
         results.timeZone = timeZone;
         await upsertEnv(envName, {
+            schemaVersion: ENV_CONFIG_SCHEMA_VERSION,
             ...(source === 'docker'
                 ? { kind: 'docker' }
                 : source || appPath || appRootPath
@@ -1057,6 +1064,7 @@ Prompt modes:
             ...(dockerPlatform ? { dockerPlatform } : {}),
             ...(gitUrl ? { gitUrl } : {}),
             ...(npmRegistry ? { npmRegistry } : {}),
+            ...(hookScript ? { hookScript } : {}),
             ...(appPath ? { appPath } : {}),
             ...(appRootPath && !areConfiguredPathsEquivalent(appRootPath, derivedAppRootPath) ? { appRootPath } : {}),
             ...(storagePath && !areConfiguredPathsEquivalent(storagePath, derivedStoragePath) ? { storagePath } : {}),
@@ -1132,6 +1140,10 @@ Prompt modes:
         if (flags['prepare-only']) {
             argv.push('--prepare-only');
         }
+        const hookScript = String(results.hookScript ?? flags['hook-script'] ?? '').trim();
+        if (hookScript) {
+            argv.push('--hook-script', hookScript);
+        }
         if (flags.verbose) {
             argv.push('--verbose');
         }

package/dist/commands/install.js

@@ -15,7 +15,7 @@ import { appendAppPublicPath } from '../lib/app-public-path.js';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
 import { applyCliLocale, localeText, resolveCliLocale, translateCli } from "../lib/cli-locale.js";
 import { resolveConfiguredEnvPath, resolveDefaultConfigScope, resolveEnvRoot, resolveEnvRelativePath, } from '../lib/cli-home.js';
-import { defaultDockerContainerPrefix, defaultDockerNetworkName } from '../lib/app-runtime.js';
+import { defaultDockerContainerPrefix, defaultDockerNetworkName, managedAppLifecycleEnvVars, } from '../lib/app-runtime.js';
 import { resolveDefaultApiHost, resolveDockerContainerPrefix, resolveDockerNetworkName } from '../lib/cli-config.js';
 import { DEFAULT_DOCKER_VERSION, resolveDockerImageRef } from "../lib/docker-image.js";
 import { findAvailableTcpPort, validateAppPublicPath, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
@@ -29,6 +29,7 @@ import { buildStoredEnvConfig } from '../lib/env-config.js';
 import { resolveDockerEnvFileArg } from "../lib/docker-env-file.js";
 import { startDockerLogFollower } from '../lib/docker-log-stream.js';
 import { buildInitAppEnvVarsFromConfig } from '../lib/managed-init-env.js';
+import { buildHookContext, persistHookScript, resolveHookScriptPath, runHookScriptHook, } from '../lib/hook-script.js';
 import { areConfiguredPathsEquivalent, deriveConfiguredSourcePath, deriveConfiguredStoragePath, inferConfiguredAppPathFromLegacyConfig, } from '../lib/env-paths.js';
 import Download, { defaultDockerRegistryForLang } from './download.js';
 import EnvAdd from "./env/add.js";
@@ -472,7 +473,10 @@ export default class Install extends Command {
             description: 'Skip the download step and reuse an existing local app directory or Docker image',
             default: false,
         }),
-        ...omitKeys(Download.flags, ['yes']),
+        'hook-script': Flags.string({
+            description: 'Hook module copied to <appPath>/.nb/hooks.mjs and run before npm/git dependency installation.',
+        }),
+        ...omitKeys(Download.flags, ['yes', 'hook-script']),
     };
     /** Environment name only: run before {@link Install.prompts} (see `run`). */
     static envPrompts = {
@@ -1095,6 +1099,7 @@ export default class Install extends Command {
         const appPort = Install.toOptionalPromptString(config.appPort);
         const storagePath = Install.toOptionalPromptString(config.storagePath);
         const appPublicPath = Install.toOptionalPromptString(config.appPublicPath);
+        const hookScript = Install.toOptionalPromptString(config.hookScript);
         const apiBaseUrl = Install.toOptionalPromptString(config.apiBaseUrl);
         const downloadVersion = Install.toOptionalPromptString(config.downloadVersion);
         const dockerRegistry = Install.toOptionalPromptString(config.dockerRegistry);
@@ -1125,6 +1130,7 @@ export default class Install extends Command {
             ...(appPort ? { appPort } : {}),
             ...(storagePath ? { storagePath } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(hookScript ? { hookScript } : {}),
         };
         const downloadPreset = {
             ...(source ? { source } : {}),
@@ -1916,6 +1922,12 @@ export default class Install extends Command {
         if (results.buildDts) {
             argv.push('--build-dts');
         }
+        Install.pushDownloadArgIfValue(argv, '--hook-script', results.hookScript);
+        Install.pushDownloadArgIfValue(argv, '--hook-phase', results.hookPhase);
+        Install.pushDownloadArgIfValue(argv, '--hook-command', results.hookCommand);
+        Install.pushDownloadArgIfValue(argv, '--hook-env-name', results.hookEnvName);
+        Install.pushDownloadArgIfValue(argv, '--hook-app-path', results.hookAppPath);
+        Install.pushDownloadArgIfValue(argv, '--hook-storage-path', results.hookStoragePath);
         return argv;
     }
     static resolveLocalProjectRoot(params) {
@@ -1942,6 +1954,40 @@ export default class Install extends Command {
             buildDts: false,
         };
     }
+    static resolveAbsoluteAppPath(envName, appResults) {
+        const configuredAppPath = resolveConfiguredAppPathValue(appResults) ?? defaultInstallAppPath(envName);
+        return resolveConfiguredEnvPath(configuredAppPath) ?? resolveEnvRelativePath(defaultInstallAppPath(envName));
+    }
+    static resolveAbsoluteStoragePath(envName, appResults) {
+        const configuredStoragePath = resolveConfiguredStoragePathValue(appResults, envName);
+        return (resolveConfiguredEnvPath(configuredStoragePath) ?? resolveEnvRelativePath(defaultInstallStoragePath(envName)));
+    }
+    async prepareHookScriptForInstall(params) {
+        const appPath = Install.resolveAbsoluteAppPath(params.envName, params.appResults);
+        const storagePath = Install.resolveAbsoluteStoragePath(params.envName, params.appResults);
+        const inputHookScript = Install.toOptionalPromptString(params.hookScript);
+        if (inputHookScript) {
+            params.appResults.hookScript = await persistHookScript({
+                sourcePath: inputHookScript,
+                appPath,
+            });
+            printInfo(`Saved hook script to ${path.join(appPath, String(params.appResults.hookScript))}.`);
+        }
+        const savedHookScript = Install.toOptionalPromptString(params.appResults.hookScript);
+        const hookScriptPath = resolveHookScriptPath({
+            appPath,
+            hookScript: savedHookScript,
+        });
+        if (!hookScriptPath) {
+            return;
+        }
+        params.downloadResults.hookScript = hookScriptPath;
+        params.downloadResults.hookPhase = 'init';
+        params.downloadResults.hookCommand = 'init';
+        params.downloadResults.hookEnvName = params.envName;
+        params.downloadResults.hookAppPath = appPath;
+        params.downloadResults.hookStoragePath = storagePath;
+    }
     commandStdio(verbose) {
         return verbose ? 'inherit' : 'ignore';
     }
@@ -2011,7 +2057,9 @@ export default class Install extends Command {
         const dbDialect = String(params.dbResults.dbDialect ?? 'postgres').trim() || 'postgres';
         const appKey = Install.resolveManagedAppKey(params.appResults.appKey);
         const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
+        const lifecycleEnvVars = managedAppLifecycleEnvVars();
         const env = {
+            ...lifecycleEnvVars,
             STORAGE_PATH: storagePath,
             APP_PORT: String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT,
             APP_KEY: appKey,
@@ -2216,6 +2264,44 @@ export default class Install extends Command {
         }
         await this.config.runCommand('env:update', [params.envName]);
     }
+    async runInstallHookIfNeeded(params) {
+        const appPath = Install.resolveAbsoluteAppPath(params.envName, params.appResults);
+        const savedHookScript = Install.toOptionalPromptString(params.appResults.hookScript);
+        const hookScriptPath = resolveHookScriptPath({
+            appPath,
+            hookScript: savedHookScript,
+        });
+        if (!hookScriptPath) {
+            return;
+        }
+        const storagePath = Install.resolveAbsoluteStoragePath(params.envName, params.appResults);
+        const sourcePath = params.projectRoot ??
+            resolveConfiguredEnvPath(resolveConfiguredSourcePathValue(params.appResults, params.envName)) ??
+            path.join(appPath, 'source');
+        const context = buildHookContext({
+            phase: 'init',
+            command: 'init',
+            envName: params.envName,
+            source: params.source,
+            version: downloadResultsValue(params.downloadResults, 'version'),
+            appPath,
+            sourcePath,
+            storagePath,
+            hookScript: savedHookScript,
+            envConfig: Install.buildSavedEnvConfig(params, {
+                defaultApiHost: params.defaultApiHost,
+            }),
+        });
+        if (!context) {
+            return;
+        }
+        this.log(`Running hook ${params.hookName}: ${hookScriptPath}`);
+        await runHookScriptHook({
+            hookScriptPath,
+            hookName: params.hookName,
+            context,
+        });
+    }
     static buildSavedEnvConfig(params, options = {}) {
         const appPath = resolveConfiguredAppPathValue(params.appResults);
         const appRootPath = Install.toOptionalPromptString(params.appResults.appRootPath);
@@ -2247,6 +2333,7 @@ export default class Install extends Command {
             devDependencies: downloadResultsValue(params.downloadResults, 'devDependencies'),
             build: downloadResultsValue(params.downloadResults, 'build'),
             buildDts: downloadResultsValue(params.downloadResults, 'buildDts'),
+            hookScript: params.appResults.hookScript,
             ...(appPath ? { appPath } : {}),
             ...(appRootPath && !areConfiguredPathsEquivalent(appRootPath, derivedAppRootPath) ? { appRootPath } : {}),
             appPort,
@@ -2311,6 +2398,9 @@ export default class Install extends Command {
             yesInitialValues: { resume: parsed.resume },
             yes,
         });
+        if (resumePreset?.appPreset?.hookScript !== undefined && appResults.hookScript === undefined) {
+            appResults.hookScript = resumePreset.appPreset.hookScript;
+        }
         const downloadOpts = Install.buildDownloadPromptOptionsForInstall(appResults, envName);
         downloadOpts.values = {
             ...(resumePreset?.downloadPreset ?? {}),
@@ -2440,6 +2530,12 @@ export default class Install extends Command {
             appResults,
         });
         appResults.setupState = 'prepared';
+        await this.prepareHookScriptForInstall({
+            envName,
+            appResults,
+            downloadResults,
+            hookScript: parsed['hook-script'],
+        });
         const source = String(downloadResultsValue(downloadResults, 'source') ?? '').trim();
         const usesDockerResources = Boolean(dbResults.builtinDb) || source === 'docker';
         const dockerNetworkName = usesDockerResources
@@ -2505,6 +2601,17 @@ export default class Install extends Command {
                     printInfo('Application image ready.');
                 }
                 if (!parsed['prepare-only']) {
+                    await this.runInstallHookIfNeeded({
+                        hookName: 'beforeAppInstall',
+                        envName,
+                        source,
+                        appResults,
+                        downloadResults,
+                        dbResults,
+                        rootResults,
+                        envAddResults,
+                        defaultApiHost,
+                    });
                     dockerAppPlan = await this.installDockerApp({
                         envName,
                         dockerNetworkName,
@@ -2523,7 +2630,7 @@ export default class Install extends Command {
             }
             else if (source === 'npm' || source === 'git') {
                 const localSource = source === 'npm' ? 'npm' : 'git';
-                const projectRoot = parsed['skip-download']
+                const projectRoot = parsed['skip-download'] || parsed['prepare-only']
                     ? Install.resolveLocalProjectRoot({
                         envName,
                         appResults,
@@ -2535,10 +2642,22 @@ export default class Install extends Command {
                         downloadResults,
                         verbose: parsed.verbose,
                     });
-                if (!parsed['skip-download']) {
+                if (!parsed['skip-download'] && !parsed['prepare-only']) {
                     printInfo('Application files ready.');
                 }
                 if (!parsed['prepare-only']) {
+                    await this.runInstallHookIfNeeded({
+                        hookName: 'beforeAppInstall',
+                        envName,
+                        source,
+                        appResults,
+                        downloadResults,
+                        dbResults,
+                        rootResults,
+                        envAddResults,
+                        projectRoot,
+                        defaultApiHost,
+                    });
                     localAppPlan = await this.startLocalApp({
                         envName,
                         source: localSource,
@@ -2573,6 +2692,18 @@ export default class Install extends Command {
             });
             printInfo(`NocoBase is ready at ${formatInstallDisplayUrl(displayApiBaseUrl)}`);
             appResults.setupState = 'installed';
+            await this.runInstallHookIfNeeded({
+                hookName: 'afterAppStart',
+                envName,
+                source,
+                appResults,
+                downloadResults,
+                dbResults,
+                rootResults,
+                envAddResults,
+                projectRoot: localAppPlan?.projectRoot,
+                defaultApiHost,
+            });
         }
         if (dockerAppPlan || localAppPlan || builtinDbPlan) {
             await this.saveInstalledEnv({

package/dist/commands/license/activate.js

@@ -143,11 +143,14 @@ export default class LicenseActivate extends Command {
         const validation = await validateLicenseKey(runtime, resolvedKey);
         const ok = !validation.keyStatus && validation.envMatch && validation.domainMatch && validation.licenseStatus === 'active';
         const licenseKeyPath = ok ? await saveLicenseKey(runtime, resolvedKey) : resolveLicenseKeyFile(runtime);
+        const shouldResolveInstanceId = Boolean(interactiveKeyFlowInstanceId || ok || (flags.json && !validation.keyStatus));
         const payload = {
             ok,
             env: runtime.envName,
             kind: runtime.kind,
-            instanceId: interactiveKeyFlowInstanceId ?? (await ensureInstanceId(runtime)),
+            instanceId: shouldResolveInstanceId
+                ? interactiveKeyFlowInstanceId ?? (await ensureInstanceId(runtime))
+                : undefined,
             mode: 'key',
             key: redactLicenseKey(resolvedKey),
             keyFile: keyFile || undefined,

package/dist/commands/license/shared.js

@@ -10,8 +10,8 @@ import { Flags } from '@oclif/core';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { getEnvAsync, getInstanceIdAsync, keyDecrypt } from '@nocobase/license-kit';
-import { checkExternalDbConnection, readExternalDbConnectionConfig, } from "../../lib/db-connection-check.js";
-import { DEFAULT_DOCKER_REGISTRY, DEFAULT_DOCKER_VERSION, resolveDockerImageRef, } from "../../lib/docker-image.js";
+import { checkExternalDbConnection, readExternalDbConnectionConfig } from "../../lib/db-connection-check.js";
+import { DEFAULT_DOCKER_REGISTRY, DEFAULT_DOCKER_VERSION, resolveDockerImageRef } from "../../lib/docker-image.js";
 import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime } from '../../lib/app-runtime.js';
 import { buildRuntimeEnvVars } from '../../lib/runtime-env-vars.js';
 import { resolveLicensePkgUrlFromConfig } from '../../lib/cli-config.js';
@@ -102,12 +102,7 @@ function buildDockerLicenseDbFlagArgs(envVars) {
     ];
 }
 async function runDockerLicenseJsonCommand(runtime, commandArgs) {
-    const args = [
-        'run',
-        '--rm',
-        '--network',
-        runtime.dockerNetworkName || runtime.workspaceName,
-    ];
+    const args = ['run', '--rm', '--network', runtime.dockerNetworkName || runtime.workspaceName];
     const dockerPlatform = normalizeDockerPlatform(runtime.env.config?.dockerPlatform);
     if (dockerPlatform) {
         args.push('--platform', dockerPlatform);
@@ -193,11 +188,11 @@ export async function generateValidatedInstanceIdFromEnvVars(envVars) {
 }
 async function generateInstanceIdForDockerRuntime(runtime) {
     const envVars = await buildRuntimeEnvVars(runtime);
-    const payload = await runDockerLicenseJsonCommand(runtime, [
+    const payload = (await runDockerLicenseJsonCommand(runtime, [
         'license',
         'generate-id',
         ...buildDockerLicenseDbFlagArgs(envVars),
-    ]);
+    ]));
     const instanceId = trimValue(payload.instanceId);
     if (!instanceId) {
         throw new Error('Docker instance ID generation did not return an instance ID.');
@@ -337,7 +332,7 @@ export async function getLicenseStatus(keyData) {
             }),
             signal: controller.signal,
         });
-        const payload = await response.json();
+        const payload = (await response.json());
         return payload?.data?.status === 'active' ? 'active' : 'invalid';
     }
     catch {
@@ -356,6 +351,22 @@ export async function validateLicenseKey(runtime, key) {
     catch {
         keyStatus = 'invalid';
     }
+    if (keyStatus) {
+        const currentDomain = appUrl(runtime);
+        return {
+            current: {
+                env: undefined,
+                domain: currentDomain ? new URL(currentDomain).host : '',
+            },
+            keyData,
+            keyStatus,
+            dbMatch: false,
+            sysMatch: false,
+            envMatch: false,
+            domainMatch: false,
+            licenseStatus: 'invalid',
+        };
+    }
     const currentEnv = await getCurrentLicenseEnv(runtime);
     const currentDomain = appUrl(runtime);
     const dbMatch = isDbMatch(currentEnv, keyData);
@@ -391,7 +402,7 @@ export async function resolveLicenseServiceUrl(value) {
     return (await resolveLicensePkgUrl(value)).replace(/\/+$/, '');
 }
 export async function resolveLicensePkgUrl(value) {
-    const normalized = String(value ?? '').trim() || await resolveLicensePkgUrlFromConfig();
+    const normalized = String(value ?? '').trim() || (await resolveLicensePkgUrlFromConfig());
     return normalized.replace(/\/+$/, '') + '/';
 }
 function shouldRedactOutputKey(key) {
@@ -414,9 +425,7 @@ export function sanitizeLicenseOutput(value) {
     if (value && typeof value === 'object') {
         return Object.fromEntries(Object.entries(value).map(([key, nestedValue]) => [
             key,
-            shouldRedactOutputKey(key)
-                ? redactOutputValue(String(nestedValue ?? ''))
-                : sanitizeLicenseOutput(nestedValue),
+            shouldRedactOutputKey(key) ? redactOutputValue(String(nestedValue ?? '')) : sanitizeLicenseOutput(nestedValue),
         ]));
     }
     return value;

package/dist/commands/self/check.js

@@ -20,7 +20,7 @@ export default class SelfCheck extends Command {
     static flags = {
         channel: Flags.string({
             description: 'Release channel to compare against. Defaults to the current CLI channel.',
-            options: ['auto', 'latest', 'beta', 'alpha'],
+            options: ['auto', 'latest', 'test', 'beta', 'alpha'],
             default: 'auto',
         }),
         json: Flags.boolean({

package/dist/commands/self/update.js

@@ -26,17 +26,17 @@ function formatSkillsUpdateMessage(result, verbose) {
 }
 export default class SelfUpdate extends Command {
     static summary = 'Update the globally installed NocoBase CLI';
-    static description = 'Update the current NocoBase CLI install when it is managed by a standard global npm install.';
+    static description = 'Update the current NocoBase CLI install when it is managed by a standard global npm, pnpm, or yarn install.';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --yes',
         '<%= config.bin %> <%= command.id %> --skills',
-        '<%= config.bin %> <%= command.id %> --channel alpha --json',
+        '<%= config.bin %> <%= command.id %> --channel test --json',
     ];
     static flags = {
         channel: Flags.string({
             description: 'Release channel to update to. Defaults to the current CLI channel.',
-            options: ['auto', 'latest', 'beta', 'alpha'],
+            options: ['auto', 'latest', 'test', 'beta', 'alpha'],
             default: 'auto',
         }),
         yes: Flags.boolean({
@@ -77,7 +77,7 @@ export default class SelfUpdate extends Command {
                     message: flags.skills
                         ? `Update ${status.packageName} from ${status.currentVersion} to ${status.latestVersion} and refresh the globally installed NocoBase AI coding skills?`
                         : `Update ${status.packageName} from ${status.currentVersion} to ${status.latestVersion}?`,
-                    default: false,
+                    default: true,
                 });
             }
             catch {

package/dist/commands/skills/check.js

@@ -12,10 +12,7 @@ import { printInfo, renderTable } from '../../lib/ui.js';
 export default class SkillsCheck extends Command {
     static summary = 'Check the globally installed NocoBase AI coding skills';
     static description = 'Inspect the global NocoBase AI coding skills and report whether they are managed by the CLI and whether an update is available.';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> --json',
-    ];
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --json'];
     static flags = {
         json: Flags.boolean({
             description: 'Output the result as JSON',
@@ -25,6 +22,7 @@ export default class SkillsCheck extends Command {
     async run() {
         const { flags } = await this.parse(SkillsCheck);
         const status = await inspectSkillsStatus();
+        const displaySkillNames = status.packageSkillNames.length ? status.packageSkillNames : status.installedSkillNames;
         if (flags.json) {
             this.log(JSON.stringify({
                 ok: true,
@@ -35,6 +33,7 @@ export default class SkillsCheck extends Command {
                 managedByNb: status.managedByNb,
                 sourcePackage: status.sourcePackage,
                 npmPackageName: status.npmPackageName,
+                packageSkillNames: status.packageSkillNames,
                 installedSkillNames: status.installedSkillNames,
                 installedVersion: status.installedVersion,
                 latestVersion: status.latestVersion,
@@ -50,7 +49,7 @@ export default class SkillsCheck extends Command {
             ['Skills home', status.globalRoot],
             ['Installed', status.installed ? 'yes' : 'no'],
             ['Managed by nb', status.managedByNb ? 'yes' : 'no'],
-            ['Installed skills', status.installedSkillNames.length ? status.installedSkillNames.join(', ') : '(none)'],
+            ['Installed skills', displaySkillNames.length ? displaySkillNames.join(', ') : '(none)'],
             ['Installed version', status.installedVersion ?? '(unknown)'],
             ['Latest version', status.latestVersion ?? '(unknown)'],
             ['Update available', status.updateAvailable === null ? 'unknown' : status.updateAvailable ? 'yes' : 'no'],

package/dist/commands/skills/install.js

@@ -8,7 +8,7 @@
  */
 import { Command, Flags } from '@oclif/core';
 import { confirm } from "../../lib/inquirer.js";
-import { setVerboseMode } from '../../lib/ui.js';
+import { setVerboseMode, startTask, stopTask, updateTask } from '../../lib/ui.js';
 import { installNocoBaseSkills } from '../../lib/skills-manager.js';
 export default class SkillsInstall extends Command {
     static summary = 'Install the NocoBase AI coding skills globally';
@@ -16,6 +16,8 @@ export default class SkillsInstall extends Command {
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --yes',
+        '<%= config.bin %> <%= command.id %> --version 1.0.4',
+        '<%= config.bin %> <%= command.id %> --verbose',
         '<%= config.bin %> <%= command.id %> --json',
     ];
     static flags = {
@@ -32,6 +34,9 @@ export default class SkillsInstall extends Command {
             description: 'Show detailed install output',
             default: false,
         }),
+        version: Flags.string({
+            description: 'Install a specific @nocobase/skills version',
+        }),
     };
     async run() {
         const { flags } = await this.parse(SkillsInstall);
@@ -51,8 +56,20 @@ export default class SkillsInstall extends Command {
                 return;
             }
         }
+        const shouldShowLoading = !flags.json && !flags.verbose;
+        if (shouldShowLoading) {
+            startTask(flags.version
+                ? `Installing NocoBase AI coding skills ${flags.version}...`
+                : 'Installing NocoBase AI coding skills...');
+        }
         const result = await installNocoBaseSkills({
+            targetVersion: flags.version,
             verbose: flags.verbose,
+            onProgress: shouldShowLoading ? updateTask : undefined,
+        }).finally(() => {
+            if (shouldShowLoading) {
+                stopTask();
+            }
         });
         if (flags.json) {
             this.log(JSON.stringify({

package/dist/commands/skills/update.js

@@ -8,7 +8,7 @@
  */
 import { Command, Flags } from '@oclif/core';
 import { confirm } from "../../lib/inquirer.js";
-import { setVerboseMode } from '../../lib/ui.js';
+import { setVerboseMode, startTask, stopTask, updateTask } from '../../lib/ui.js';
 import { updateNocoBaseSkills } from '../../lib/skills-manager.js';
 export default class SkillsUpdate extends Command {
     static summary = 'Update the globally installed NocoBase AI coding skills';
@@ -16,6 +16,8 @@ export default class SkillsUpdate extends Command {
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --yes',
+        '<%= config.bin %> <%= command.id %> --version 1.0.4',
+        '<%= config.bin %> <%= command.id %> --verbose',
         '<%= config.bin %> <%= command.id %> --json',
     ];
     static flags = {
@@ -32,6 +34,9 @@ export default class SkillsUpdate extends Command {
             description: 'Show detailed update output',
             default: false,
         }),
+        version: Flags.string({
+            description: 'Sync to a specific @nocobase/skills version',
+        }),
     };
     async run() {
         const { flags } = await this.parse(SkillsUpdate);
@@ -51,8 +56,20 @@ export default class SkillsUpdate extends Command {
                 return;
             }
         }
+        const shouldShowLoading = !flags.json && !flags.verbose;
+        if (shouldShowLoading) {
+            startTask(flags.version
+                ? `Syncing NocoBase AI coding skills to ${flags.version}...`
+                : 'Updating NocoBase AI coding skills...');
+        }
         const result = await updateNocoBaseSkills({
+            targetVersion: flags.version,
             verbose: flags.verbose,
+            onProgress: shouldShowLoading ? updateTask : undefined,
+        }).finally(() => {
+            if (shouldShowLoading) {
+                stopTask();
+            }
         });
         if (flags.json) {
             this.log(JSON.stringify({
@@ -80,8 +97,6 @@ export default class SkillsUpdate extends Command {
                 : 'NocoBase AI coding skills are up to date.');
             return;
         }
-        this.log(flags.verbose
-            ? 'Updated the global NocoBase AI coding skills.'
-            : 'Updated NocoBase AI coding skills globally.');
+        this.log(flags.verbose ? 'Updated the global NocoBase AI coding skills.' : 'Updated NocoBase AI coding skills globally.');
     }
 }