@nocobase/cli 2.1.0-alpha.23 → 2.1.0-alpha.25

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,86 @@
+/**
+ * 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, setVerboseMode } 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,
+        }),
+        verbose: Flags.boolean({
+            description: 'Show detailed update output',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SelfUpdate);
+        setVerboseMode(flags.verbose);
+        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,
+            verbose: flags.verbose,
+        });
+        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(flags.verbose
+                ? `NocoBase CLI is already up to date at ${result.status.currentVersion}.`
+                : `NocoBase CLI is up to date: ${result.status.currentVersion}.`);
+            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}.`);
+    }
+}

package/dist/commands/skills/check.js

@@ -0,0 +1,69 @@
+/**
+ * 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 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 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',
+                globalRoot: status.globalRoot,
+                workspaceRoot: status.workspaceRoot,
+                installed: status.installed,
+                managedByNb: status.managedByNb,
+                sourcePackage: status.sourcePackage,
+                npmPackageName: status.npmPackageName,
+                installedSkillNames: status.installedSkillNames,
+                installedVersion: status.installedVersion,
+                latestVersion: status.latestVersion,
+                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'], [
+            ['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 version', status.installedVersion ?? '(unknown)'],
+            ['Latest version', status.latestVersion ?? '(unknown)'],
+            ['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 globally.');
+            return;
+        }
+        if (status.updateAvailable) {
+            printInfo('Run `nb skills update` to refresh the global NocoBase AI coding skills.');
+        }
+        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 global NocoBase AI coding skills';
+    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,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 { confirmAction, setVerboseMode } 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';
+    static description = 'Install the NocoBase AI coding skills globally. 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,
+        }),
+        verbose: Flags.boolean({
+            description: 'Show detailed install output',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SkillsInstall);
+        setVerboseMode(flags.verbose);
+        if (!flags.yes) {
+            const confirmed = await confirmAction('Install the NocoBase AI coding skills globally?', { defaultValue: true });
+            if (!confirmed) {
+                this.log('Skipped skills install.');
+                return;
+            }
+        }
+        const result = await installNocoBaseSkills({
+            verbose: flags.verbose,
+        });
+        if (flags.json) {
+            this.log(JSON.stringify({
+                ok: true,
+                kind: 'skills',
+                action: result.action,
+                globalRoot: result.status.globalRoot,
+                workspaceRoot: result.status.workspaceRoot,
+                installedSkillNames: result.status.installedSkillNames,
+                installedVersion: result.status.installedVersion,
+                installedRef: result.status.installedRef,
+            }, null, 2));
+            return;
+        }
+        if (result.action === 'noop') {
+            this.log(flags.verbose
+                ? 'NocoBase AI coding skills are already installed globally. Run `nb skills update` to refresh them.'
+                : 'NocoBase AI coding skills are already installed globally.');
+            return;
+        }
+        this.log(flags.verbose
+            ? 'Installed the NocoBase AI coding skills globally.'
+            : 'Installed NocoBase AI coding skills globally.');
+    }
+}

package/dist/commands/skills/update.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 { confirmAction, setVerboseMode } 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';
+    static description = 'Refresh the globally installed NocoBase AI coding skills. 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,
+        }),
+        verbose: Flags.boolean({
+            description: 'Show detailed update output',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SkillsUpdate);
+        setVerboseMode(flags.verbose);
+        if (!flags.yes) {
+            const confirmed = await confirmAction('Update the globally installed NocoBase AI coding skills?', { defaultValue: true });
+            if (!confirmed) {
+                this.log('Skipped skills update.');
+                return;
+            }
+        }
+        const result = await updateNocoBaseSkills({
+            verbose: flags.verbose,
+        });
+        if (flags.json) {
+            this.log(JSON.stringify({
+                ok: true,
+                kind: 'skills',
+                action: result.action,
+                globalRoot: result.status.globalRoot,
+                workspaceRoot: result.status.workspaceRoot,
+                installedSkillNames: result.status.installedSkillNames,
+                installedVersion: result.status.installedVersion,
+                installedRef: result.status.installedRef,
+            }, null, 2));
+            return;
+        }
+        if (result.action === 'noop') {
+            this.log(flags.verbose
+                ? 'NocoBase AI coding skills are already up to date globally.'
+                : '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.');
+    }
+}

package/dist/commands/start.js

@@ -111,13 +111,20 @@ export default class Start extends Command {
         if (!runtime) {
             this.error(formatMissingManagedAppEnvMessage(requestedEnv));
         }
-        if (runtime.kind === 'remote') {
+        if (runtime.kind === 'http') {
             this.error([
                 `Can't start "${runtime.envName}" from this machine.`,
                 'This env only has an API connection, so there is no saved local app or Docker runtime to launch here.',
                 'Connect it to a local checkout or reinstall it with npm, git, or Docker if you want CLI-managed start and stop.',
             ].join('\n'));
         }
+        if (runtime.kind === 'ssh') {
+            this.error([
+                `Can't start "${runtime.envName}" yet.`,
+                'SSH env support is reserved but not implemented yet.',
+                'Use a local or Docker env if you need CLI-managed start and stop right now.',
+            ].join('\n'));
+        }
         if (runtime.kind === 'docker') {
             const unsupportedFlags = [
                 flags.quickstart ? '--quickstart' : undefined,

package/dist/commands/stop.js

@@ -50,13 +50,20 @@ export default class Stop extends Command {
         if (!runtime) {
             this.error(formatMissingManagedAppEnvMessage(requestedEnv));
         }
-        if (runtime.kind === 'remote') {
+        if (runtime.kind === 'http') {
             this.error([
                 `Can't stop "${runtime.envName}" from this machine.`,
                 'This env only has an API connection, so there is no saved local app or Docker runtime to stop here.',
                 'If the app is running on a server, stop it there or reconnect this env to a local runtime first.',
             ].join('\n'));
         }
+        if (runtime.kind === 'ssh') {
+            this.error([
+                `Can't stop "${runtime.envName}" yet.`,
+                'SSH env support is reserved but not implemented yet.',
+                'Use a local or Docker env if you need CLI-managed stop right now.',
+            ].join('\n'));
+        }
         if (runtime.kind === 'docker') {
             startTask(`Stopping NocoBase for "${runtime.envName}"...`);
             try {