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

package/dist/commands/license/plugins/shared.js

@@ -11,8 +11,14 @@ import { access, mkdir, rm } from 'node:fs/promises';
 import { Readable } from 'node:stream';
 import { createGunzip } from 'node:zlib';
 import * as tar from 'tar';
-import { removeStoragePluginSymlink, resolvePluginStoragePath, } from '../../../lib/plugin-storage.js';
-import { parseLicenseKey, readSavedLicenseKey, resolveLicensePkgUrl, } from '../shared.js';
+import { removeStoragePluginSymlink, resolvePluginStoragePath } from '../../../lib/plugin-storage.js';
+import { parseLicenseKey, readSavedLicenseKey, resolveLicensePkgUrl } from '../shared.js';
+export class MissingSavedLicenseKeyError extends Error {
+    constructor(envName) {
+        super(`No saved license key was found for env "${envName}". Run \`nb license activate\` first.`);
+        this.name = 'MissingSavedLicenseKeyError';
+    }
+}
 async function resolvePkgBaseUrl(pkgUrl) {
     return await resolveLicensePkgUrl(pkgUrl);
 }
@@ -54,7 +60,7 @@ async function loginPkg(baseURL, keyData) {
 export async function loadSavedLicenseKeyData(runtime) {
     const licenseKey = await readSavedLicenseKey(runtime);
     if (!licenseKey) {
-        throw new Error(`No saved license key was found for env "${runtime.envName}". Run \`nb license activate\` first.`);
+        throw new MissingSavedLicenseKeyError(runtime.envName);
     }
     return parseLicenseKey(licenseKey);
 }

package/dist/commands/license/plugins/sync.js

@@ -10,10 +10,10 @@ import { Command, Flags } from '@oclif/core';
 import pc from 'picocolors';
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
-import { DEFAULT_DOCKER_REGISTRY, DEFAULT_DOCKER_VERSION, resolveDockerImageRef, } from "../../../lib/docker-image.js";
+import { DEFAULT_DOCKER_REGISTRY, DEFAULT_DOCKER_VERSION, resolveDockerImageRef } from "../../../lib/docker-image.js";
 import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../../lib/env-guard.js';
-import { createLicenseEnvFlag, licenseJsonFlag, licensePkgUrlFlag, licenseYesFlag, requireLicenseRuntime, } from '../shared.js';
-import { syncLicensedPlugins } from './shared.js';
+import { createLicenseEnvFlag, licenseJsonFlag, licensePkgUrlFlag, licenseYesFlag, readSavedLicenseKey, requireLicenseRuntime, } from '../shared.js';
+import { MissingSavedLicenseKeyError, syncLicensedPlugins } from './shared.js';
 import { resolvePluginStoragePath } from '../../../lib/plugin-storage.js';
 import { commandOutput } from '../../../lib/run-npm.js';
 import { announceTargetEnv, startTask, stopTask, succeedTask, updateTask } from '../../../lib/ui.js';
@@ -93,12 +93,7 @@ async function resolveDockerAppVersion(runtime) {
         defaultRegistry: DEFAULT_DOCKER_REGISTRY,
         defaultVersion: DEFAULT_DOCKER_VERSION,
     });
-    const args = [
-        'run',
-        '--rm',
-        '--network',
-        runtime.workspaceName,
-    ];
+    const args = ['run', '--rm', '--network', runtime.workspaceName];
     const dockerPlatform = normalizeDockerPlatform(config.dockerPlatform);
     if (dockerPlatform) {
         args.push('--platform', dockerPlatform);
@@ -130,6 +125,16 @@ async function resolveManagedAppVersion(runtime) {
     }
     throw new Error(`Env "${runtime.envName}" does not support automatic app version detection.`);
 }
+function buildNoLicenseSkipPayload(runtime, dryRun) {
+    return {
+        ok: true,
+        env: runtime.envName,
+        kind: runtime.kind,
+        dryRun,
+        status: 'skipped',
+        skipReason: 'no-license-key',
+    };
+}
 export default class LicensePluginsSync extends Command {
     static summary = 'Synchronize commercial plugins for the selected env';
     static description = 'Synchronize the commercial plugins allowed by the current saved license key.';
@@ -150,6 +155,10 @@ export default class LicensePluginsSync extends Command {
         version: Flags.string({
             description: 'Registry version or dist-tag to synchronize. Defaults to the current workspace version.',
         }),
+        'skip-if-no-license': Flags.boolean({
+            description: 'Skip without error when this env does not have a saved license key',
+            default: false,
+        }),
         verbose: Flags.boolean({
             description: 'Show detailed per-plugin sync logs',
             default: false,
@@ -174,7 +183,17 @@ export default class LicensePluginsSync extends Command {
         if (!flags.json) {
             announceTargetEnv(runtime.envName);
         }
-        const version = trimValue(flags.version) || await resolveManagedAppVersion(runtime);
+        if (flags['skip-if-no-license']) {
+            const savedLicenseKey = await readSavedLicenseKey(runtime);
+            if (!savedLicenseKey) {
+                const payload = buildNoLicenseSkipPayload(runtime, Boolean(flags['dry-run']));
+                if (flags.json) {
+                    this.log(JSON.stringify(payload, null, 2));
+                }
+                return;
+            }
+        }
+        const version = trimValue(flags.version) || (await resolveManagedAppVersion(runtime));
         const registryVersion = normalizePluginRegistryVersion(version);
         const shouldStreamLogs = !flags.json && Boolean(flags.verbose);
         const pluginStoragePath = resolvePluginStoragePath(runtime.env.storagePath);
@@ -210,20 +229,32 @@ export default class LicensePluginsSync extends Command {
         }
         let result;
         try {
-            result = await syncLicensedPlugins(runtime, {
-                pkgUrl: flags['pkg-url'],
-                version: registryVersion,
-                dryRun: Boolean(flags['dry-run']),
-                onProgress: shouldStreamLogs
-                    ? async (detail) => {
-                        this.log(`${formatActionLabel(detail.action)} ${pc.bold(detail.packageName)}`);
-                        this.log(pc.dim(`  output: ${detail.outputDir}`));
-                        if (detail.warning) {
-                            this.log(pc.yellow(`  warning: ${detail.warning}`));
+            try {
+                result = await syncLicensedPlugins(runtime, {
+                    pkgUrl: flags['pkg-url'],
+                    version: registryVersion,
+                    dryRun: Boolean(flags['dry-run']),
+                    onProgress: shouldStreamLogs
+                        ? async (detail) => {
+                            this.log(`${formatActionLabel(detail.action)} ${pc.bold(detail.packageName)}`);
+                            this.log(pc.dim(`  output: ${detail.outputDir}`));
+                            if (detail.warning) {
+                                this.log(pc.yellow(`  warning: ${detail.warning}`));
+                            }
                         }
+                        : undefined,
+                });
+            }
+            catch (error) {
+                if (flags['skip-if-no-license'] && error instanceof MissingSavedLicenseKeyError) {
+                    const payload = buildNoLicenseSkipPayload(runtime, Boolean(flags['dry-run']));
+                    if (flags.json) {
+                        this.log(JSON.stringify(payload, null, 2));
                     }
-                    : undefined,
-            });
+                    return;
+                }
+                throw error;
+            }
         }
         finally {
             if (loadingTimer) {
@@ -250,9 +281,7 @@ export default class LicensePluginsSync extends Command {
             return;
         }
         if (loadingStarted) {
-            succeedTask(flags['dry-run']
-                ? 'Commercial plugin sync preview is ready.'
-                : 'Commercial plugin sync completed.');
+            succeedTask(flags['dry-run'] ? 'Commercial plugin sync preview is ready.' : 'Commercial plugin sync completed.');
         }
         if (!flags.verbose) {
             const changes = [];

package/dist/commands/self/update.js

@@ -8,14 +8,29 @@
  */
 import { Command, Flags } from '@oclif/core';
 import { confirm } from "../../lib/inquirer.js";
+import { updateNocoBaseSkills } from '../../lib/skills-manager.js';
 import { setVerboseMode } from '../../lib/ui.js';
 import { formatSelfUpdateUnavailableMessage, formatUnsupportedSelfUpdateMessage, inspectSelfStatus, updateSelf, } from '../../lib/self-manager.js';
+function formatSkillsUpdateMessage(result, verbose) {
+    if (result.action === 'noop') {
+        if (result.reason === 'not-installed') {
+            return verbose
+                ? 'NocoBase AI coding skills are not installed globally. Run `nb skills install` first.'
+                : 'Skipped skills update because NocoBase AI coding skills are not installed.';
+        }
+        return verbose
+            ? 'NocoBase AI coding skills are already up to date globally.'
+            : 'NocoBase AI coding skills are up to date.';
+    }
+    return verbose ? 'Updated the global NocoBase AI coding skills.' : 'Updated NocoBase AI coding skills globally.';
+}
 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 examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --yes',
+        '<%= config.bin %> <%= command.id %> --skills',
         '<%= config.bin %> <%= command.id %> --channel alpha --json',
     ];
     static flags = {
@@ -33,6 +48,10 @@ export default class SelfUpdate extends Command {
             description: 'Output the result as JSON',
             default: false,
         }),
+        skills: Flags.boolean({
+            description: 'Also update the globally installed NocoBase AI coding skills',
+            default: false,
+        }),
         verbose: Flags.boolean({
             description: 'Show detailed update output',
             default: false,
@@ -50,11 +69,14 @@ export default class SelfUpdate extends Command {
         if (!status.latestVersion && status.registryError) {
             this.error(formatSelfUpdateUnavailableMessage(status));
         }
+        let shouldUpdateSkills = flags.skills;
         if (!flags.yes && status.updateAvailable) {
             let confirmed = false;
             try {
                 confirmed = await confirm({
-                    message: `Update ${status.packageName} from ${status.currentVersion} to ${status.latestVersion}?`,
+                    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,
                 });
             }
@@ -69,6 +91,24 @@ export default class SelfUpdate extends Command {
             channel: flags.channel,
             verbose: flags.verbose,
         });
+        if (flags.skills && !flags.yes && !status.updateAvailable) {
+            let confirmed = false;
+            try {
+                confirmed = await confirm({
+                    message: 'Update the globally installed NocoBase AI coding skills?',
+                    default: true,
+                });
+            }
+            catch {
+                return;
+            }
+            shouldUpdateSkills = confirmed;
+        }
+        const skillsResult = shouldUpdateSkills
+            ? await updateNocoBaseSkills({
+                verbose: flags.verbose,
+            })
+            : undefined;
         if (flags.json) {
             this.log(JSON.stringify({
                 ok: true,
@@ -79,6 +119,17 @@ export default class SelfUpdate extends Command {
                 channel: result.status.channel,
                 fromVersion: result.status.currentVersion,
                 toVersion: result.targetVersion,
+                skills: skillsResult
+                    ? {
+                        action: skillsResult.action,
+                        reason: skillsResult.action === 'noop' ? skillsResult.reason : undefined,
+                        globalRoot: skillsResult.status.globalRoot,
+                        workspaceRoot: skillsResult.status.workspaceRoot,
+                        installedSkillNames: skillsResult.status.installedSkillNames,
+                        installedVersion: skillsResult.status.installedVersion,
+                        installedRef: skillsResult.status.installedRef,
+                    }
+                    : undefined,
             }, null, 2));
             return;
         }
@@ -86,10 +137,16 @@ export default class SelfUpdate extends Command {
             this.log(flags.verbose
                 ? `NocoBase CLI is already up to date at ${result.status.currentVersion}.`
                 : `NocoBase CLI is up to date: ${result.status.currentVersion}.`);
+            if (skillsResult) {
+                this.log(formatSkillsUpdateMessage(skillsResult, flags.verbose));
+            }
             return;
         }
         this.log(flags.verbose
             ? `Updated NocoBase CLI from ${result.status.currentVersion} using ${result.packageSpec}${result.targetVersion ? ` (latest ${result.status.channel} resolves to ${result.targetVersion})` : ''}.`
             : `Updated NocoBase CLI: ${result.status.currentVersion} -> ${result.targetVersion}.`);
+        if (skillsResult) {
+            this.log(formatSkillsUpdateMessage(skillsResult, flags.verbose));
+        }
     }
 }

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/commands/source/download.js

@@ -70,6 +70,9 @@ function downloadSourceLabel(source) {
             return source;
     }
 }
+function downloadActionLabel(flags) {
+    return flags.replace ? 'Source refresh' : 'Download';
+}
 function normalizeDockerPlatform(value) {
     const text = String(value ?? '').trim();
     if (text === 'linux/amd64' || text === 'linux/arm64') {
@@ -228,7 +231,7 @@ export default class SourceDownload extends Command {
         'npm-registry': Flags.string({
             description: 'npm registry for npm/git downloads and dependency installation.',
         }),
-        'build': Flags.boolean({
+        build: Flags.boolean({
             allowNo: true,
             description: 'Build npm/git source after dependencies are installed.',
             default: true,
@@ -347,7 +350,8 @@ export default class SourceDownload extends Command {
             message: downloadText('prompts.outputDir.message'),
             placeholder: downloadText('prompts.outputDir.placeholder'),
             initialValue: (values) => {
-                const version = resolveVersionFromResults(values, DEFAULT_DOWNLOAD_VERSION) || DEFAULT_DOWNLOAD_VERSION;
+                const version = resolveVersionFromResults(values, DEFAULT_DOWNLOAD_VERSION) ||
+                    DEFAULT_DOWNLOAD_VERSION;
                 return defaultOutputDirForVersion(version);
             },
             required: true,
@@ -467,8 +471,7 @@ export default class SourceDownload extends Command {
         initialValues.dockerPlatform = normalizeDockerPlatform(flags['docker-platform']);
         initialValues.dockerSave = flags['docker-save'];
         if (flags['npm-registry'] !== undefined) {
-            initialValues.npmRegistry =
-                typeof flags['npm-registry'] === 'string' ? flags['npm-registry'] : '';
+            initialValues.npmRegistry = typeof flags['npm-registry'] === 'string' ? flags['npm-registry'] : '';
         }
         for (const key of Object.keys(preset)) {
             if (Object.prototype.hasOwnProperty.call(initialValues, key)) {
@@ -536,7 +539,7 @@ export default class SourceDownload extends Command {
         return preset;
     }
     resolveEffectiveBuild(source, results, flags) {
-        if (source === 'npm' && !Boolean(results.devDependencies)) {
+        if (source === 'npm' && !results.devDependencies) {
             return false;
         }
         if (source === 'npm' || source === 'git') {
@@ -554,34 +557,29 @@ export default class SourceDownload extends Command {
             ? String(results.outputDir).trim() || undefined
             : flags['output-dir']?.trim() || undefined;
         const replace = results.replace !== undefined ? Boolean(results.replace) : flags.replace;
-        const gitUrl = results.gitUrl !== undefined
-            ? String(results.gitUrl).trim() || undefined
-            : flags['git-url']?.trim() || undefined;
+        const gitUrl = results.gitUrl !== undefined ? String(results.gitUrl).trim() || undefined : flags['git-url']?.trim() || undefined;
         const dockerRegistry = source === 'docker'
-            ? (results.dockerRegistry !== undefined
+            ? results.dockerRegistry !== undefined
                 ? String(results.dockerRegistry).trim() || undefined
-                : flags['docker-registry']?.trim() || defaultDockerRegistryForLang(flags.locale ?? process.env.NB_LOCALE))
+                : flags['docker-registry']?.trim() || defaultDockerRegistryForLang(flags.locale ?? process.env.NB_LOCALE)
             : undefined;
         const dockerPlatform = source === 'docker'
-            ? normalizeDockerPlatform(results.dockerPlatform !== undefined
-                ? results.dockerPlatform
-                : flags['docker-platform'])
+            ? normalizeDockerPlatform(results.dockerPlatform !== undefined ? results.dockerPlatform : flags['docker-platform'])
             : undefined;
         const dockerSave = source === 'docker'
             ? results.dockerSave !== undefined
                 ? Boolean(results.dockerSave)
                 : flags['docker-save']
             : false;
-        const npmRegistryRaw = results.npmRegistry !== undefined
-            ? String(results.npmRegistry)
-            : flags['npm-registry'] ?? '';
+        const npmRegistryRaw = results.npmRegistry !== undefined ? String(results.npmRegistry) : flags['npm-registry'] ?? '';
         const npmRegistry = npmRegistryRaw.trim() || undefined;
+        const npmDevDependencies = devDependencies ?? false;
         return {
             source,
             version,
             replace,
-            ...(source === 'npm' ? { 'dev-dependencies': devDependencies } : {}),
-            'build': effectiveBuild,
+            ...(source === 'npm' ? { 'dev-dependencies': npmDevDependencies } : {}),
+            build: effectiveBuild,
             'build-dts': normalizeBuildDts(source, effectiveBuild, buildDtsWant),
             'output-dir': outputDir,
             'git-url': gitUrl,
@@ -772,7 +770,9 @@ export default class SourceDownload extends Command {
         await fsp.mkdir(parentDir, { recursive: true });
         const registryEnv = this.npmRegistryEnv(flags);
         this.finishPreparationTask();
-        this.log(`Creating NocoBase app "${appName}" from npm`);
+        this.log(flags.replace
+            ? `Refreshing NocoBase source in ${projectRoot} from npm`
+            : `Creating NocoBase app "${appName}" from npm`);
         await this.runExternalCommand('npx', npxArgs, {
             ...this.runOptionsWithCwd(parentDir, registryEnv),
             errorName: 'npx create-nocobase-app',
@@ -795,7 +795,7 @@ export default class SourceDownload extends Command {
                 ...(this.isVerbose() ? ['--verbose'] : []),
             ]);
         }
-        this.log(`NocoBase app is ready at ${projectRoot}`);
+        this.log(`${flags.replace ? 'NocoBase source' : 'NocoBase app'} is ready at ${projectRoot}`);
         return projectRoot;
     }
     async downloadFromGit(flags) {
@@ -808,9 +808,13 @@ export default class SourceDownload extends Command {
         gitArgs.push('--branch', branch);
         gitArgs.push('--depth', '1', repoUrl, outputDir);
         this.finishPreparationTask();
-        this.log(branch === versionSpec
-            ? `Cloning NocoBase from ${repoUrl} (${branch})`
-            : `Cloning NocoBase from ${repoUrl} (${branch}, resolved from ${versionSpec})`);
+        this.log(flags.replace
+            ? branch === versionSpec
+                ? `Refreshing NocoBase source from ${repoUrl} (${branch})`
+                : `Refreshing NocoBase source from ${repoUrl} (${branch}, resolved from ${versionSpec})`
+            : branch === versionSpec
+                ? `Cloning NocoBase from ${repoUrl} (${branch})`
+                : `Cloning NocoBase from ${repoUrl} (${branch}, resolved from ${versionSpec})`);
         await this.runExternalCommand('git', gitArgs, {
             errorName: 'git clone',
             loadingMessage: 'Cloning the repository',
@@ -830,7 +834,7 @@ export default class SourceDownload extends Command {
                 ...(this.isVerbose() ? ['--verbose'] : []),
             ]);
         }
-        this.log(`NocoBase app is ready at ${projectRoot}`);
+        this.log(`${flags.replace ? 'NocoBase source' : 'NocoBase app'} is ready at ${projectRoot}`);
         return projectRoot;
     }
     async download() {
@@ -869,7 +873,7 @@ export default class SourceDownload extends Command {
     async run() {
         try {
             const result = await this.download();
-            this.logProgress(`Download completed via ${downloadSourceLabel(result.resolved.source)}.`);
+            this.logProgress(`${downloadActionLabel(result.resolved)} completed via ${downloadSourceLabel(result.resolved.source)}.`);
             return result;
         }
         catch (error) {

package/dist/generated/command-registry.js

@@ -50,13 +50,14 @@ function readEnvName(argv) {
     }
     return undefined;
 }
-function createRuntimeCommand(operation) {
+function createRuntimeCommand(operation, runtimeVersion) {
     return class RuntimeCommand extends GeneratedApiCommand {
         static summary = operation.summary;
         static description = operation.description;
         static examples = operation.examples;
         static flags = createGeneratedFlags(operation);
         static operation = operation;
+        static runtimeVersion = runtimeVersion;
     };
 }
 function createRuntimeIndexCommand(commandId, metadata) {
@@ -122,7 +123,7 @@ const runtime = loadRuntimeSync(env?.runtime?.version);
 for (const operation of runtime?.commands ?? []) {
     const commandSegments = operation.commandId.split(' ');
     const commandKey = commandSegments.join(':');
-    registry[`api:${commandKey}`] = createRuntimeCommand(operation);
+    registry[`api:${commandKey}`] = createRuntimeCommand(operation, runtime?.version);
     for (const [topicCommandId, metadata] of getRuntimeTopicEntries(operation)) {
         const topicKey = `api:${topicCommandId.split(' ').join(':')}`;
         if (!registry[topicKey]) {

package/dist/lib/api-client.js

@@ -23,6 +23,8 @@ import { resolveServerRequestTarget } from './env-auth.js';
 import { fetchWithPreservedAuthRedirect } from './http-request.js';
 const CLI_REQUEST_SOURCE_HEADER = 'x-request-source';
 const CLI_REQUEST_SOURCE_VALUE = 'cli';
+const CLI_VERSION_HEADER = 'x-nb-cli-version';
+const SKILLS_VERSION_HEADER = 'x-nb-skills-version';
 function stripUtf8Bom(text) {
     return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
 }
@@ -209,6 +211,10 @@ export async function executeApiRequest(options) {
     const { baseUrl, token } = await resolveServerRequestTarget(options);
     const headers = new Headers();
     headers.set(CLI_REQUEST_SOURCE_HEADER, CLI_REQUEST_SOURCE_VALUE);
+    headers.set(CLI_VERSION_HEADER, options.cliVersion);
+    if (options.skillsVersion) {
+        headers.set(SKILLS_VERSION_HEADER, options.skillsVersion);
+    }
     if (token) {
         headers.set('authorization', `Bearer ${token}`);
     }