@nocobase/cli 2.1.0-alpha.22 → 2.1.0-alpha.24

package/dist/commands/install.js

@@ -15,7 +15,7 @@ import { mkdir } from 'node:fs/promises';
 import path from 'node:path';
 import { exit } from 'node:process';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
-import { applyCliLocale, localeText, translateCli, } from "../lib/cli-locale.js";
+import { applyCliLocale, localeText, resolveCliLocale, translateCli, } from "../lib/cli-locale.js";
 import { findAvailableTcpPort, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
 import { formatMissingManagedAppEnvMessage } from '../lib/app-runtime.js';
 import { run, runNocoBaseCommand } from '../lib/run-npm.js';
@@ -40,6 +40,12 @@ const DEFAULT_INSTALL_BUILTIN_DB_IMAGES = {
     mariadb: 'mariadb:11',
     kingbase: 'registry.cn-shanghai.aliyuncs.com/nocobase/kingbase:v009r001c001b0030_single_x86',
 };
+const DEFAULT_INSTALL_BUILTIN_DB_IMAGES_ZH_CN = {
+    postgres: 'registry.cn-shanghai.aliyuncs.com/nocobase/postgres:16',
+    mysql: 'registry.cn-shanghai.aliyuncs.com/nocobase/mysql:8',
+    mariadb: 'registry.cn-shanghai.aliyuncs.com/nocobase/mariadb:11',
+    kingbase: 'registry.cn-shanghai.aliyuncs.com/nocobase/kingbase:v009r001c001b0030_single_x86',
+};
 const DEFAULT_INSTALL_DB_DATABASE = 'nocobase';
 const DEFAULT_INSTALL_DB_USER = 'nocobase';
 const DEFAULT_INSTALL_DB_PASSWORD = 'nocobase';
@@ -141,9 +147,12 @@ export function defaultDbPortForDialect(value) {
 }
 function defaultBuiltinDbImageForDialect(value) {
     const dialect = String(value ?? 'postgres').trim();
+    const defaults = resolveCliLocale(process.env.NB_LOCALE) === 'zh-CN'
+        ? DEFAULT_INSTALL_BUILTIN_DB_IMAGES_ZH_CN
+        : DEFAULT_INSTALL_BUILTIN_DB_IMAGES;
     return supportsBuiltinDbDialect(dialect)
-        ? DEFAULT_INSTALL_BUILTIN_DB_IMAGES[dialect]
-        : DEFAULT_INSTALL_BUILTIN_DB_IMAGES.postgres;
+        ? defaults[dialect]
+        : defaults.postgres;
 }
 function defaultDbDatabaseForDialect(value) {
     return String(value ?? '').trim() === 'kingbase'
@@ -254,6 +263,10 @@ export default class Install extends Command {
             description: 'Resume a previous unfinished setup for this env using the saved workspace env config',
             default: false,
         }),
+        verbose: Flags.boolean({
+            description: 'Show detailed command output',
+            default: false,
+        }),
         env: Flags.string({
             char: 'e',
             description: 'App/env name to create or update. Defaults app paths to ./<envName>/source/ and ./<envName>/storage/.',
@@ -804,15 +817,15 @@ export default class Install extends Command {
         };
     }
     /**
-     * When install runs {@link Download.prompts} after app prompts, align language and
-     * output directory defaults with the app settings collected earlier in the flow.
+     * When install runs {@link Download.prompts} after app prompts, align the download
+     * output directory with app settings, while Docker registry defaults follow the CLI locale.
      */
     static buildDownloadPromptOptionsForInstall(appResults, envName) {
         const appRoot = String(appResults.appRootPath ?? '').trim() || defaultInstallAppRootPath(envName);
         const lang = String(appResults.lang ?? DEFAULT_INSTALL_LANG).trim() || DEFAULT_INSTALL_LANG;
         const initialValues = {
             lang,
-            dockerRegistry: defaultDockerRegistryForLang(lang),
+            dockerRegistry: defaultDockerRegistryForLang(process.env.NB_LOCALE),
             outputDir: appRoot,
         };
         const values = {
@@ -970,7 +983,7 @@ export default class Install extends Command {
                 ? dbHostInput
                 : containerName);
         if (dbDialect === 'postgres') {
-            const image = String(params.builtinDbImage ?? '').trim() || DEFAULT_INSTALL_BUILTIN_DB_IMAGES.postgres;
+            const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(params.storagePath, 'db', 'postgres');
             const args = [
                 'run',
@@ -1014,7 +1027,7 @@ export default class Install extends Command {
             };
         }
         if (dbDialect === 'mysql') {
-            const image = String(params.builtinDbImage ?? '').trim() || DEFAULT_INSTALL_BUILTIN_DB_IMAGES.mysql;
+            const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(params.storagePath, 'db', 'mysql');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
@@ -1060,7 +1073,7 @@ export default class Install extends Command {
             };
         }
         if (dbDialect === 'mariadb') {
-            const image = String(params.builtinDbImage ?? '').trim() || DEFAULT_INSTALL_BUILTIN_DB_IMAGES.mariadb;
+            const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(params.storagePath, 'db', 'mariadb');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
@@ -1106,7 +1119,7 @@ export default class Install extends Command {
             };
         }
         if (dbDialect === 'kingbase') {
-            const image = String(params.builtinDbImage ?? '').trim() || DEFAULT_INSTALL_BUILTIN_DB_IMAGES.kingbase;
+            const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(params.storagePath, 'db', 'kingbase');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
@@ -1194,6 +1207,7 @@ export default class Install extends Command {
     async removeDockerContainer(name) {
         await run('docker', ['rm', '-f', name], {
             errorName: 'docker rm',
+            stdio: 'ignore',
         });
     }
     async removeDockerContainerIfForced(params) {
@@ -1225,7 +1239,7 @@ export default class Install extends Command {
         }
         return env;
     }
-    async ensureBuiltinDbContainer(plan) {
+    async ensureBuiltinDbContainer(plan, options) {
         const exists = await this.dockerContainerExists(plan.containerName);
         if (exists) {
             p.log.info(`Built-in ${plan.dbDialect} container already exists: ${plan.containerName}`);
@@ -1234,6 +1248,7 @@ export default class Install extends Command {
         await mkdir(plan.dataDir, { recursive: true });
         await run('docker', plan.args, {
             errorName: 'docker run',
+            stdio: options?.stdio ?? 'ignore',
         });
     }
     async startBuiltinDb(params) {
@@ -1265,13 +1280,15 @@ export default class Install extends Command {
                 throw new Error(`Built-in ${plan.dbDialect} needs host port ${plan.dbPort}, but ${portError}`);
             }
         }
-        await this.ensureBuiltinDbContainer(plan);
+        await this.ensureBuiltinDbContainer(plan, {
+            stdio: params.commandStdio ?? 'ignore',
+        });
         p.log.info(`Built-in ${plan.dbDialect} database is ready at ${plan.dbHost}:${plan.dbPort}`);
         return plan;
     }
     static buildDockerAppPlan(params) {
         const dockerRegistry = String(downloadResultsValue(params.downloadResults, 'dockerRegistry') ?? '').trim()
-            || defaultDockerRegistryForLang(params.appResults.lang);
+            || defaultDockerRegistryForLang(process.env.NB_LOCALE);
         const version = String(downloadResultsValue(params.downloadResults, 'version') ?? '').trim() || 'latest';
         const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
         const storagePath = path.resolve(String(params.appResults.storagePath ?? '').trim()
@@ -1319,7 +1336,7 @@ export default class Install extends Command {
             args,
         };
     }
-    async ensureDockerAppContainer(plan) {
+    async ensureDockerAppContainer(plan, options) {
         const exists = await this.dockerContainerExists(plan.containerName);
         if (exists) {
             p.log.info(`App container already exists: ${plan.containerName}`);
@@ -1328,6 +1345,7 @@ export default class Install extends Command {
         await mkdir(plan.storagePath, { recursive: true });
         await run('docker', plan.args, {
             errorName: 'docker run',
+            stdio: options?.stdio ?? 'ignore',
         });
         return 'created';
     }
@@ -1350,7 +1368,9 @@ export default class Install extends Command {
             displayName: 'app container',
             force: params.force,
         });
-        const containerState = await this.ensureDockerAppContainer(plan);
+        const containerState = await this.ensureDockerAppContainer(plan, {
+            stdio: params.commandStdio ?? 'ignore',
+        });
         if (containerState === 'existing') {
             const env = await this.inspectDockerContainerEnv(plan.containerName);
             plan.appKey = env.APP_KEY || plan.appKey;
@@ -1365,8 +1385,11 @@ export default class Install extends Command {
             argv.push(flag, text);
         }
     }
-    static buildDownloadArgvFromResults(results) {
+    static buildDownloadArgvFromResults(results, options) {
         const argv = ['-y', '--no-intro'];
+        if (options?.verbose) {
+            argv.push('--verbose');
+        }
         Install.pushDownloadArgIfValue(argv, '--source', results.source);
         Install.pushDownloadArgIfValue(argv, '--version', results.version);
         Install.pushDownloadArgIfValue(argv, '--output-dir', results.outputDir);
@@ -1401,10 +1424,24 @@ export default class Install extends Command {
             || defaultInstallAppRootPath(params.envName);
         return path.resolve(process.cwd(), outputDir);
     }
+    commandStdio(verbose) {
+        return verbose ? 'inherit' : 'ignore';
+    }
+    async downloadManagedSource(params) {
+        const argv = Install.buildDownloadArgvFromResults(params.downloadResults, {
+            verbose: params.verbose,
+        });
+        const source = String(params.downloadResults.source ?? '').trim();
+        p.log.step(source === 'docker'
+            ? 'Downloading Docker image'
+            : 'Downloading local NocoBase app files');
+        return await this.config.runCommand('download', argv);
+    }
     async downloadLocalApp(params) {
-        const argv = Install.buildDownloadArgvFromResults(params.downloadResults);
-        p.log.step('Downloading local NocoBase app files');
-        const result = await this.config.runCommand('download', argv);
+        const result = await this.downloadManagedSource({
+            downloadResults: params.downloadResults,
+            verbose: params.verbose,
+        });
         const projectRoot = Install.resolveLocalProjectRoot({
             envName: params.envName,
             appResults: params.appResults,
@@ -1458,6 +1495,7 @@ export default class Install extends Command {
             await runNocoBaseCommand(['pm2', 'kill'], {
                 cwd: params.projectRoot,
                 env,
+                stdio: params.commandStdio ?? 'ignore',
             });
         }
         catch (error) {
@@ -1468,6 +1506,7 @@ export default class Install extends Command {
         await runNocoBaseCommand(args, {
             cwd: params.projectRoot,
             env,
+            stdio: params.commandStdio ?? 'ignore',
         });
         p.log.info(`Local app is starting at http://127.0.0.1:${env.APP_PORT}`);
         return {
@@ -1743,6 +1782,7 @@ export default class Install extends Command {
         const parsed = {
             ...flags,
         };
+        const commandStdio = this.commandStdio(parsed.verbose);
         if (!parsed['no-intro']) {
             p.intro('Set Up NocoBase');
         }
@@ -1769,6 +1809,7 @@ export default class Install extends Command {
                 downloadResults,
                 dbResults,
                 force: parsed.force,
+                commandStdio,
             });
             dbResults.dbHost = builtinDbPlan.dbHost;
             dbResults.dbPort = builtinDbPlan.dbPort;
@@ -1781,6 +1822,10 @@ export default class Install extends Command {
         let localAppPlan;
         if (Boolean(appResults.fetchSource)) {
             if (source === 'docker') {
+                await this.downloadManagedSource({
+                    downloadResults,
+                    verbose: parsed.verbose,
+                });
                 dockerAppPlan = await this.installDockerApp({
                     envName,
                     workspaceName,
@@ -1790,6 +1835,7 @@ export default class Install extends Command {
                     rootResults,
                     builtinDbPlan,
                     force: parsed.force,
+                    commandStdio,
                 });
                 appResults.appKey = dockerAppPlan.appKey;
                 appResults.timeZone = dockerAppPlan.timeZone;
@@ -1799,6 +1845,7 @@ export default class Install extends Command {
                     envName,
                     appResults,
                     downloadResults,
+                    verbose: parsed.verbose,
                 });
                 localAppPlan = await this.startLocalApp({
                     envName,
@@ -1807,6 +1854,7 @@ export default class Install extends Command {
                     appResults,
                     dbResults,
                     rootResults,
+                    commandStdio,
                 });
                 appResults.appKey = localAppPlan.appKey;
                 appResults.timeZone = localAppPlan.timeZone;

package/dist/commands/self/check.js

@@ -0,0 +1,71 @@
+/**
+ * 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 { Command, Flags } from '@oclif/core';
+import { getRecommendedSelfUpdateCommand, inspectSelfStatus, } from '../../lib/self-manager.js';
+import { printInfo, renderTable } from '../../lib/ui.js';
+export default class SelfCheck extends Command {
+    static summary = 'Check the installed NocoBase CLI version and self-update support';
+    static description = 'Inspect the current NocoBase CLI install, resolve the latest version for the selected channel, and report whether automatic self-update is supported.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --channel beta',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        channel: Flags.string({
+            description: 'Release channel to compare against. Defaults to the current CLI channel.',
+            options: ['auto', 'latest', 'beta', 'alpha'],
+            default: 'auto',
+        }),
+        json: Flags.boolean({
+            description: 'Output the result as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SelfCheck);
+        const status = await inspectSelfStatus({
+            channel: flags.channel,
+        });
+        if (flags.json) {
+            this.log(JSON.stringify({
+                ok: true,
+                kind: 'self',
+                packageName: status.packageName,
+                currentVersion: status.currentVersion,
+                latestVersion: status.latestVersion,
+                channel: status.channel,
+                updateAvailable: status.updateAvailable,
+                installMethod: status.installMethod,
+                updatable: status.updatable,
+                updateBlockedReason: status.updateBlockedReason,
+                recommendedCommand: getRecommendedSelfUpdateCommand(status),
+                registryError: status.registryError,
+            }, null, 2));
+            return;
+        }
+        this.log(renderTable(['Field', 'Value'], [
+            ['Current version', status.currentVersion || 'unknown'],
+            ['Latest version', status.latestVersion || 'unknown'],
+            ['Channel', status.channel],
+            ['Install method', status.installMethod],
+            ['Auto-update', status.updatable ? 'supported' : 'not supported'],
+            ['Update available', status.updateAvailable ? 'yes' : 'no'],
+        ]));
+        if (status.updateAvailable && status.updatable) {
+            printInfo('Run `nb self update` to update the CLI.');
+        }
+        else if (status.updateAvailable && status.updateBlockedReason) {
+            printInfo(status.updateBlockedReason);
+        }
+        if (status.registryError) {
+            printInfo(`Version check warning: ${status.registryError}`);
+        }
+    }
+}

package/dist/commands/self/index.js

@@ -0,0 +1,20 @@
+/**
+ * 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 { Command, loadHelpClass } from '@oclif/core';
+export default class Self extends Command {
+    static summary = 'Inspect or update the NocoBase CLI itself';
+    async run() {
+        await this.parse(Self);
+        const Help = await loadHelpClass(this.config);
+        await new Help(this.config, this.config.pjson.oclif.helpOptions ?? this.config.pjson.helpOptions).showHelp([
+            this.id ?? 'self',
+            ...this.argv,
+        ]);
+    }
+}

package/dist/commands/self/update.js

@@ -0,0 +1,76 @@
+/**
+ * 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 { Command, Flags } from '@oclif/core';
+import { confirmAction } from '../../lib/ui.js';
+import { formatSelfUpdateUnavailableMessage, formatUnsupportedSelfUpdateMessage, inspectSelfStatus, updateSelf, } from '../../lib/self-manager.js';
+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 %> --channel alpha --json',
+    ];
+    static flags = {
+        channel: Flags.string({
+            description: 'Release channel to update to. Defaults to the current CLI channel.',
+            options: ['auto', 'latest', 'beta', 'alpha'],
+            default: 'auto',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Skip the update confirmation prompt',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output the result as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SelfUpdate);
+        const status = await inspectSelfStatus({
+            channel: flags.channel,
+        });
+        if (!status.updatable) {
+            this.error(formatUnsupportedSelfUpdateMessage(status));
+        }
+        if (!status.latestVersion && status.registryError) {
+            this.error(formatSelfUpdateUnavailableMessage(status));
+        }
+        if (!flags.yes && status.updateAvailable) {
+            const confirmed = await confirmAction(`Update ${status.packageName} from ${status.currentVersion} to ${status.latestVersion}?`, { defaultValue: false });
+            if (!confirmed) {
+                this.log('Skipped CLI update.');
+                return;
+            }
+        }
+        const result = await updateSelf({
+            channel: flags.channel,
+        });
+        if (flags.json) {
+            this.log(JSON.stringify({
+                ok: true,
+                kind: 'self',
+                action: result.action,
+                packageName: result.status.packageName,
+                packageSpec: result.packageSpec,
+                channel: result.status.channel,
+                fromVersion: result.status.currentVersion,
+                toVersion: result.targetVersion,
+            }, null, 2));
+            return;
+        }
+        if (result.action === 'noop') {
+            this.log(`NocoBase CLI is already up to date at ${result.status.currentVersion}.`);
+            return;
+        }
+        this.log(`Updated NocoBase CLI from ${result.status.currentVersion} using ${result.packageSpec}${result.targetVersion ? ` (latest ${result.status.channel} resolves to ${result.targetVersion})` : ''}.`);
+    }
+}

package/dist/commands/skills/check.js

@@ -0,0 +1,63 @@
+/**
+ * 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 { Command, Flags } from '@oclif/core';
+import { inspectSkillsStatus } from '../../lib/skills-manager.js';
+import { printInfo, renderTable } from '../../lib/ui.js';
+export default class SkillsCheck extends Command {
+    static summary = 'Check the NocoBase AI coding skills installed for this workspace';
+    static description = 'Inspect the current workspace for 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 flags = {
+        json: Flags.boolean({
+            description: 'Output the result as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SkillsCheck);
+        const status = await inspectSkillsStatus();
+        if (flags.json) {
+            this.log(JSON.stringify({
+                ok: true,
+                kind: 'skills',
+                workspaceRoot: status.workspaceRoot,
+                installed: status.installed,
+                managedByNb: status.managedByNb,
+                sourcePackage: status.sourcePackage,
+                installedSkillNames: status.installedSkillNames,
+                installedRef: status.installedRef,
+                latestRef: status.latestRef,
+                updateAvailable: status.updateAvailable,
+                recommendedCommand: status.installed ? 'nb skills update --yes' : 'nb skills install --yes',
+                registryError: status.registryError,
+            }, null, 2));
+            return;
+        }
+        this.log(renderTable(['Field', 'Value'], [
+            ['Workspace', status.workspaceRoot],
+            ['Installed', status.installed ? 'yes' : 'no'],
+            ['Managed by nb', status.managedByNb ? 'yes' : 'no'],
+            ['Installed skills', status.installedSkillNames.length ? status.installedSkillNames.join(', ') : '(none)'],
+            ['Update available', status.updateAvailable === null ? 'unknown' : status.updateAvailable ? 'yes' : 'no'],
+        ]));
+        if (!status.installed) {
+            printInfo('Run `nb skills install` to install the NocoBase AI coding skills for this workspace.');
+            return;
+        }
+        if (status.updateAvailable) {
+            printInfo('Run `nb skills update` to refresh the NocoBase AI coding skills for this workspace.');
+        }
+        if (status.registryError) {
+            printInfo(`Update check warning: ${status.registryError}`);
+        }
+    }
+}

package/dist/commands/skills/index.js

@@ -0,0 +1,20 @@
+/**
+ * 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 { Command, loadHelpClass } from '@oclif/core';
+export default class Skills extends Command {
+    static summary = 'Inspect or synchronize NocoBase AI coding skills for this workspace';
+    async run() {
+        await this.parse(Skills);
+        const Help = await loadHelpClass(this.config);
+        await new Help(this.config, this.config.pjson.oclif.helpOptions ?? this.config.pjson.helpOptions).showHelp([
+            this.id ?? 'skills',
+            ...this.argv,
+        ]);
+    }
+}

package/dist/commands/skills/install.js

@@ -0,0 +1,58 @@
+/**
+ * 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 { Command, Flags } from '@oclif/core';
+import { confirmAction } 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 for this workspace';
+    static description = 'Install the NocoBase AI coding skills for the current workspace. If they are already installed, this command does not update them.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --yes',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Skip the install confirmation prompt',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output the result as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SkillsInstall);
+        if (!flags.yes) {
+            const confirmed = await confirmAction('Install the NocoBase AI coding skills for this workspace?', { defaultValue: true });
+            if (!confirmed) {
+                this.log('Skipped skills install.');
+                return;
+            }
+        }
+        const result = await installNocoBaseSkills();
+        if (flags.json) {
+            this.log(JSON.stringify({
+                ok: true,
+                kind: 'skills',
+                action: result.action,
+                workspaceRoot: result.status.workspaceRoot,
+                installedSkillNames: result.status.installedSkillNames,
+                installedRef: result.status.installedRef,
+            }, null, 2));
+            return;
+        }
+        if (result.action === 'noop') {
+            this.log('NocoBase AI coding skills are already installed for this workspace. Run `nb skills update` to refresh them.');
+            return;
+        }
+        this.log('Installed the NocoBase AI coding skills for this workspace.');
+    }
+}

package/dist/commands/skills/update.js

@@ -0,0 +1,58 @@
+/**
+ * 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 { Command, Flags } from '@oclif/core';
+import { confirmAction } from '../../lib/ui.js';
+import { updateNocoBaseSkills } from '../../lib/skills-manager.js';
+export default class SkillsUpdate extends Command {
+    static summary = 'Update the NocoBase AI coding skills for this workspace';
+    static description = 'Refresh the NocoBase AI coding skills for the current workspace. This command only updates an existing nocobase/skills install.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --yes',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Skip the update confirmation prompt',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output the result as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SkillsUpdate);
+        if (!flags.yes) {
+            const confirmed = await confirmAction('Update the NocoBase AI coding skills for this workspace?', { defaultValue: true });
+            if (!confirmed) {
+                this.log('Skipped skills update.');
+                return;
+            }
+        }
+        const result = await updateNocoBaseSkills();
+        if (flags.json) {
+            this.log(JSON.stringify({
+                ok: true,
+                kind: 'skills',
+                action: result.action,
+                workspaceRoot: result.status.workspaceRoot,
+                installedSkillNames: result.status.installedSkillNames,
+                installedRef: result.status.installedRef,
+            }, null, 2));
+            return;
+        }
+        if (result.action === 'noop') {
+            this.log('NocoBase AI coding skills are already up to date for this workspace.');
+            return;
+        }
+        this.log('Updated the NocoBase AI coding skills for this workspace.');
+    }
+}