@swell/cli 2.2.1 → 2.3.1

package/dist/app-command.js

@@ -17,7 +17,7 @@ export class AppCommand extends SwellCommand {
     // needs to be in a ES2021 format: https://github.com/oclif/oclif/issues/1100
     static baseFlags = {
         'app-path': Flags.string({
-            description: 'path to your app directory',
+            description: 'Path to your app directory',
         }),
     };
     // the local path to the app directory

package/dist/commands/api/delete.js

@@ -16,7 +16,10 @@ export default class ApiDelete extends SwellApiCommand {
             default: false,
         }),
     };
-    static examples = ['swell api delete /products/abc123'];
+    static examples = [
+        'swell api delete /products/abc123',
+        'swell api delete /functions/my-app/clear-cache',
+    ];
     get method() {
         return HttpMethod.DELETE;
     }

package/dist/commands/api/get.js

@@ -21,6 +21,7 @@ export default class ApiGet extends SwellApiCommand {
         'swell api get /products',
         'swell api get "/products?limit=10&category=shoes"',
         'swell api get /products/abc123',
+        'swell api get /functions/my-app/get-inventory',
     ];
     get method() {
         return HttpMethod.GET;

package/dist/commands/api/index.js

@@ -2,12 +2,15 @@ import { Command } from '@oclif/core';
 export default class Api extends Command {
     static summary = 'Send requests directly to the Swell Backend API.';
     static description = `Run Swell API requests directly from the command line.
-  Supports GET, POST, PUT, and DELETE methods with optional test/live environments.`;
+  Supports GET, POST, PUT, and DELETE methods with optional test/live environments.
+  Call app functions via /functions/<app_id>/<function_name> paths.`;
     static examples = [
         'swell api get /products',
         'swell api post /products --body \'{"name":"New product"}\'',
         'swell api put /products/abc123 --body ./update.json',
         'swell api delete /products/abc123',
+        'swell api get /functions/my-app/get-inventory',
+        'swell api post /functions/my-app/create-order --body \'{"items":["sku-1"]}\'',
     ];
     async run() {
         this.log('Use "swell api get|post|put|delete" to interact with the Swell API.');

package/dist/commands/api/post.js

@@ -23,6 +23,7 @@ export default class ApiPost extends SwellApiCommand {
     static examples = [
         'swell api post /products --body \'{"name": "Product", "price": 100}\'',
         'swell api post /products --body ./product.json',
+        'swell api post /functions/my-app/create-order --body \'{"items":["sku-1"]}\'',
     ];
     get method() {
         return HttpMethod.POST;

package/dist/commands/api/put.js

@@ -23,6 +23,7 @@ export default class ApiPut extends SwellApiCommand {
     static examples = [
         'swell api put /products/{id} --body \'{"id": "abc123", "name": "Updated"}\'',
         'swell api put /products/abc123 --body ./product.json',
+        'swell api put /functions/my-app/update-stock --body \'{"sku":"abc","qty":10}\'',
     ];
     get method() {
         return HttpMethod.PUT;

package/dist/commands/app/frontend/dev.js

@@ -83,7 +83,7 @@ export default class AppFrontendDev extends PushAppCommand {
                     }
                     // 3. READY DETECTION: Detect server ready, show our message
                     if (!serverReadyDetected &&
-                        (/✓ ready in \d+/.test(string) || /✓ starting/.test(string))) {
+                        (/✓ ready in \d+/i.test(string) || /✓ starting/i.test(string))) {
                         serverReadyDetected = true;
                         this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
                         const sessionId = localConfig.getSessionId(currentStore);

package/dist/commands/app/init.d.ts

@@ -1,12 +1,13 @@
+import { HelpMeta } from '../../help/types.js';
 import CreateApp from '../create/app.js';
 export default class InitApp extends CreateApp {
-    static description: string;
-    static examples: {
-        command: string;
-        description: string;
-    }[];
-    static flags: {
-        yes: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    protected commandExample: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
     };
+    static description: string;
+    static examples: string[];
+    static helpMeta: HelpMeta;
+    static flags: any;
     run(): Promise<void>;
 }

package/dist/commands/app/init.js

@@ -1,32 +1,50 @@
-import { Flags } from '@oclif/core';
+import { Args } from '@oclif/core';
 import path from 'node:path';
-import CreateApp from '../create/app.js';
+import CreateApp, { appHelpMetaBase } from '../create/app.js';
 export default class InitApp extends CreateApp {
+    // Override command example for error messages
+    commandExample = 'swell app init';
+    static args = {
+        id: Args.string({
+            default: '',
+            description: 'App identifier (defaults to current directory name)',
+        }),
+    };
     static description = 'Initialize app swell.json in the current directory.';
     static examples = [
-        {
-            command: 'swell app init',
-            description: 'Initialize app following command prompts.',
-        },
-        {
-            command: 'swell app init -y',
-            description: 'Initialize app and accept all default values.',
-        },
+        '$ swell app init',
+        '$ swell app init my-app',
+        '$ swell app init -t admin -y',
+        '$ swell app init my-app -t admin -y',
+        '$ swell app init my-app -t admin --frontend astro -y',
+        '$ swell app init my_theme -t theme --storefront-app proxima -y',
     ];
+    static helpMeta = {
+        ...appHelpMetaBase,
+        usageDirect: '[id] -t <type> [...] -y',
+    };
+    // Inherit all flags from CreateApp (includes -p, -t, -n, -v, -d)
+    // baseFlags from CreateAppCommand (-y, --frontend, etc.) are merged automatically by oclif
     static flags = {
-        yes: Flags.boolean({
-            char: 'y',
-            description: `accept all default values`,
-        }),
+        ...CreateApp.flags,
     };
     async run() {
-        const { flags } = await this.parse(InitApp);
-        const { yes: confirmYes } = flags;
-        const id = process.cwd().split(path.sep).pop() || 'Swell App';
+        const { args, flags } = await this.parse(InitApp);
+        const { id: argId } = args;
+        const { yes: confirmYes, type, name, version, description, frontend, } = flags;
+        // Use provided id argument, or fall back to current directory name
+        const id = argId || process.cwd().split(path.sep).pop() || 'Swell App';
         await this.createSwellConfig({
             allowOverwrite: false,
             inputId: id,
-            inputType: this.appType,
+            inputType: type || this.appType,
+            inputName: name,
+            inputVersion: version,
+            inputDescription: description,
+            inputFrontend: frontend,
+            inputStorefrontApp: flags['storefront-app'],
+            inputIntegrationType: flags['integration-type'],
+            inputIntegrationId: flags['integration-id'],
             inputYes: confirmYes,
             nestedPath: false,
         });

package/dist/commands/app/pull.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as path from 'node:path';
-import { ConfigPaths } from '../../lib/apps/index.js';
+import { AllConfigPaths } from '../../lib/apps/index.js';
 import style from '../../lib/style.js';
 import { PushAppCommand } from '../../push-app-command.js';
 export default class AppPull extends PushAppCommand {
@@ -17,7 +17,7 @@ type from an app in your store's test environment to your local machine.
 If APPID is not specified, you will be prompted with a list of apps to choose from.
 
 App file directories:
-${Object.values(ConfigPaths)
+${Object.values(AllConfigPaths)
         .map((dir) => style.path(`${dir}/`))
         .join('\n')}\n${style.path(`frontend/`)}`;
     static examples = [

package/dist/commands/app/push.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as path from 'node:path';
-import { ConfigPaths, filePathExists, isPathDirectory, } from '../../lib/apps/index.js';
+import { AllConfigPaths, filePathExists, isPathDirectory, } from '../../lib/apps/index.js';
 import style from '../../lib/style.js';
 import { PushAppCommand } from '../../push-app-command.js';
 export default class AppPush extends PushAppCommand {
@@ -22,7 +22,7 @@ If the app does not exist, it will be created and its global ID saved to a .swel
 - If a directory is specified, only files in that directory will be pushed.
 
 App file directories:
-${Object.values(ConfigPaths)
+${Object.values(AllConfigPaths)
         .map((dir) => style.path(`${dir}/`))
         .join('\n')}`;
     static examples = [

package/dist/commands/app/version.d.ts

@@ -7,6 +7,7 @@ export default class AppVersion extends PushAppCommand {
     static examples: string[];
     static flags: {
         amend: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'force-create-files': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         message: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         'no-git-tag': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         yes: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;

package/dist/commands/app/version.js

@@ -55,6 +55,9 @@ behavior by using the --no-git-tag option.`;
         amend: Flags.boolean({
             description: 'amend the description an existing version',
         }),
+        'force-create-files': Flags.boolean({
+            description: 'do not use files from previous versions',
+        }),
         message: Flags.string({
             char: 'm',
             description: 'description of the changes in this version for internal use',
@@ -73,7 +76,7 @@ behavior by using the --no-git-tag option.`;
     static summary = 'Increment the version of your Swell app.';
     async run() {
         const { args, flags } = await this.parse(AppVersion);
-        const { amend, 'no-git-tag': noGitTag, yes } = flags;
+        const { amend, 'no-git-tag': noGitTag, yes, 'force-create-files': forceCreateFiles = false, } = flags;
         let { message } = flags;
         let { nextVersion } = args;
         if (!(await this.ensureAppExists(undefined, false))) {
@@ -137,7 +140,7 @@ behavior by using the --no-git-tag option.`;
         const spinner = ora();
         spinner.start('Creating version');
         try {
-            await this.createRemoteVersion(nextVersion, message, spinner);
+            await this.createRemoteVersion(nextVersion, message, spinner, forceCreateFiles);
             await this.gitCommit(message);
             if (!noGitTag)
                 await this.gitTag(nextVersion);
@@ -148,17 +151,24 @@ behavior by using the --no-git-tag option.`;
         }
         spinner.succeed(`${style.appConfigValue(this.app.name)} version ${nextVersion} created.`);
     }
-    async createRemoteVersion(nextVersion, message, spinner) {
+    async createRemoteVersion(nextVersion, message, spinner, forceCreateFiles = false) {
+        const body = {
+            description: message,
+            version: nextVersion,
+        };
+        if (forceCreateFiles) {
+            body.$force_create_files = true;
+        }
         // update the version on the remote
         const versionResponse = await this.api.post({ adminPath: `/apps/${this.app.id}/versions` }, {
-            body: { description: message, version: nextVersion },
+            body,
             onAsyncGetPath: (response) => ({
                 adminPath: `/apps/${this.app.id}/versions/${response.id}`,
             }),
             spinner,
         });
         if (!versionResponse || !versionResponse.version) {
-            spinner.fail('Something went wrong.');
+            throw new Error('Something went wrong. Server could not create version.');
         }
         // update the local app config file since remote was successful
         this.swellConfig.set('version', nextVersion);

package/dist/commands/create/app.d.ts

@@ -1,13 +1,17 @@
 import { CreateAppCommand } from '../../create-app-command.js';
+import { HelpMeta } from '../../help/types.js';
+/**
+ * Shared helpMeta for app creation commands (create app, app init).
+ * Defines the APP TYPES section and type-specific flags.
+ */
+export declare const appHelpMetaBase: Omit<HelpMeta, 'usageDirect'>;
 export default class CreateApp extends CreateAppCommand {
     static args: {
         id: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
     };
     static description: string;
-    static examples: {
-        command: string;
-        description: string;
-    }[];
+    static examples: string[];
+    static helpMeta: HelpMeta;
     static flags: any;
     appType: string;
     createSwellConfig({ allowOverwrite, inputId, inputStorefrontApp, inputType, inputName, inputVersion, inputDescription, inputFrontend, inputIntegrationType, inputIntegrationId, inputYes, nestedPath, }: {

package/dist/commands/create/app.js

@@ -6,75 +6,89 @@ import { CreateAppCommand } from '../../create-app-command.js';
 import { newConfig, swellConfigFileExists } from '../../lib/app-config.js';
 import { toAppId, toAppName } from '../../lib/create/index.js';
 import style from '../../lib/style.js';
+/**
+ * Shared helpMeta for app creation commands (create app, app init).
+ * Defines the APP TYPES section and type-specific flags.
+ */
+export const appHelpMetaBase = {
+    typeSection: {
+        title: 'APP TYPES',
+        types: [
+            {
+                name: 'admin',
+                description: 'Dashboard extension',
+                optional: ['--frontend'],
+            },
+            {
+                name: 'storefront',
+                description: 'Hosted storefront',
+                optional: ['--frontend'],
+            },
+            {
+                name: 'theme',
+                description: 'Theme for existing storefront',
+                requires: ['--storefront-app'],
+            },
+            {
+                name: 'integration',
+                description: 'Third-party service',
+                requires: [
+                    '--integration-type',
+                    '--integration-id (for payment | shipping | tax)',
+                ],
+            },
+        ],
+    },
+    typeFlags: [
+        'frontend',
+        'storefront-app',
+        'integration-type',
+        'integration-id',
+    ],
+};
 export default class CreateApp extends CreateAppCommand {
     static args = {
         id: Args.string({
             default: '',
-            description: `id of the app to create (required in -y)`,
+            description: 'App identifier (e.g., my-app)',
         }),
     };
     static description = 'Create an app.';
     static examples = [
-        {
-            command: 'swell create app',
-            description: 'Interactive: follow prompts to create an app.',
-        },
-        {
-            command: 'swell create app my_app -t admin -y',
-            description: 'Non-interactive: minimal with defaults.',
-        },
-        {
-            command: 'swell create app my_app --type admin --name "My App" --version 1.0.1 --description "" -y',
-            description: 'Non-interactive: explicit name, version, description.',
-        },
-        {
-            command: 'swell create app my_app --type admin --frontend astro -y',
-            description: 'Non-interactive: initialize an Astro frontend.',
-        },
-        {
-            command: 'swell create app my_theme --type theme --storefront-app proxima -y',
-            description: 'Non-interactive: theme targeting a specific storefront app.',
-        },
-        {
-            command: 'swell create app my_payment --type integration --integration-type payment --integration-id card -y',
-            description: 'Non-interactive: payment integration for credit cards.',
-        },
-        {
-            command: 'swell create app my_shipping --type integration --integration-type shipping --integration-id fedex -y',
-            description: 'Non-interactive: shipping integration for FedEx.',
-        },
-        {
-            command: 'swell create app -p yarn',
-            description: 'Package manager: use Yarn instead of npm.',
-        },
-        {
-            command: 'swell create app -p none',
-            description: 'Package manager: skip installing default dependencies.',
-        },
+        '$ swell create app',
+        '$ swell create app my_app -t admin -y',
+        '$ swell create app my_app -t admin --frontend astro -y',
+        '$ swell create app my_theme -t theme --storefront-app proxima -y',
+        '$ swell create app my_payment -t integration --integration-type payment --integration-id card -y',
+        '$ swell create app my_shipping -t integration --integration-type shipping --integration-id fedex -y',
     ];
+    static helpMeta = {
+        ...appHelpMetaBase,
+        usageDirect: '<id> -t <type> [...] -y',
+    };
     static flags = {
         pkg: Flags.string({
             char: 'p',
             default: 'npm',
-            description: `use npm or yarn to install default dependencies, or none to disable`,
+            description: 'Package manager: npm | yarn | none',
             options: ['npm', 'yarn', 'none'],
         }),
         type: Flags.string({
             char: 't',
-            description: `create a specific app type (required in -y)`,
+            description: 'App type: admin | storefront | theme | integration',
             options: ['admin', 'integration', 'storefront', 'theme'],
         }),
         name: Flags.string({
             char: 'n',
-            description: `application name (default: capitalized ID)`,
+            description: 'Display name (default: capitalized ID)',
         }),
         version: Flags.string({
             char: 'v',
-            description: `application version (default: 1.0.0)`,
+            description: 'Version (default: 1.0.0)',
         }),
         description: Flags.string({
             char: 'd',
-            description: `application description`,
+            description: 'Description',
         }),
     };
     appType = '';
@@ -87,12 +101,12 @@ export default class CreateApp extends CreateAppCommand {
         // check missed parameters
         if (confirmYes) {
             if (!appId) {
-                this.error('Missing application id for non-interactive mode\n\nYou need to provide an app id value for non-interactive mode\n\nExample: swell create app reviews --type admin -y', {
+                this.error(`Missing application id for non-interactive mode\n\nYou need to provide an app id value for non-interactive mode\n\nExample: ${this.commandExample} reviews --type admin -y`, {
                     exit: 1,
                 });
             }
             if (!inputType) {
-                this.error('Missing required flag for non-interactive mode: --type\n\nValid types: admin, integration, storefront, theme\n\nExample: swell create app reviews --type admin -y', {
+                this.error(`Missing required flag for non-interactive mode: --type\n\nValid types: admin, integration, storefront, theme\n\nExample: ${this.commandExample} reviews --type admin -y`, {
                     exit: 1,
                 });
             }
@@ -145,7 +159,7 @@ export default class CreateApp extends CreateAppCommand {
         let extensions;
         if (type === 'integration') {
             if (confirmYes && !inputIntegrationType) {
-                this.error('Missing required flag for non-interactive mode for integration app: --integration-type\n\nValid types: generic, payment, shipping, tax\n\nExample: swell create app reviews --type integration --integration-type generic -y', {
+                this.error(`Missing required flag for non-interactive mode for integration app: --integration-type\n\nValid types: generic, payment, shipping, tax\n\nExample: ${this.commandExample} reviews --type integration --integration-type generic -y`, {
                     exit: 1,
                 });
             }
@@ -174,7 +188,7 @@ export default class CreateApp extends CreateAppCommand {
                         const validValues = integrationType === 'payment'
                             ? "use 'card' for credit card integration or unique custom ID for other payment integrations"
                             : 'unique custom ID';
-                        this.error(`Missing required flag for non-interactive mode for ${integrationType} integration: --integration-id\n\nValid values: ${validValues}\n\nExample: swell create app my_app --type integration --integration-type ${integrationType} --integration-id ${integrationType === 'payment' ? 'card' : 'myid'} -y`, {
+                        this.error(`Missing required flag for non-interactive mode for ${integrationType} integration: --integration-id\n\nValid values: ${validValues}\n\nExample: ${this.commandExample} my_app --type integration --integration-type ${integrationType} --integration-id ${integrationType === 'payment' ? 'card' : 'myid'} -y`, {
                             exit: 1,
                         });
                     }
@@ -210,7 +224,7 @@ export default class CreateApp extends CreateAppCommand {
                     }
                     // Unified validation
                     if (integrationId.length < 3) {
-                        this.error(`--integration-id must contain at least 3 characters\n\nValid value is a custom ID containing at least 3 characters\n\nExample: swell create app my_app --type integration --integration-type ${integrationType} --integration-id ${integrationType === 'payment' ? 'card' : 'myid'} -y`, {
+                        this.error(`--integration-id must contain at least 3 characters\n\nValid value is a custom ID containing at least 3 characters\n\nExample: ${this.commandExample} my_app --type integration --integration-type ${integrationType} --integration-id ${integrationType === 'payment' ? 'card' : 'myid'} -y`, {
                             exit: 1,
                         });
                     }
@@ -224,7 +238,7 @@ export default class CreateApp extends CreateAppCommand {
                     break;
                 }
                 default: {
-                    this.error('Incorrect value for --integration-type\n\nValid types: generic, payment, shipping, tax\n\nExample: swell create app reviews --type integration --integration-type generic -y', {
+                    this.error(`Incorrect value for --integration-type\n\nValid types: generic, payment, shipping, tax\n\nExample: ${this.commandExample} reviews --type integration --integration-type generic -y`, {
                         exit: 1,
                     });
                 }
@@ -244,7 +258,7 @@ export default class CreateApp extends CreateAppCommand {
                 }
                 else {
                     if (confirmYes) {
-                        this.error('There are several installed storefront apps to choose from\n\nYou should select a specific storefront app in the non-interactive mode using --storefront-app appid\n\nExample: swell create app reviews --type theme --storefront-app proxima -y', {
+                        this.error(`There are several installed storefront apps to choose from\n\nYou should select a specific storefront app in the non-interactive mode using --storefront-app appid\n\nExample: ${this.commandExample} reviews --type theme --storefront-app proxima -y`, {
                             exit: 1,
                         });
                     }
@@ -299,8 +313,11 @@ export default class CreateApp extends CreateAppCommand {
                 }),
             ...(extensions && { extensions }),
         };
-        const appPath = path.join(process.cwd(), inputId || appId);
-        if (swellConfigFileExists(appPath)) {
+        const appPath = nestedPath
+            ? path.join(process.cwd(), inputId || appId)
+            : process.cwd();
+        const swellConfigPath = path.join(appPath, 'swell.json');
+        if (swellConfigFileExists(swellConfigPath)) {
             if (allowOverwrite) {
                 if (!confirmYes) {
                     const continueCreateApp = await confirm({

package/dist/commands/create/content.d.ts

@@ -1,20 +1,19 @@
 import { CreateCollectionCommand } from '../../create-collection-command.js';
+import { HelpMeta } from '../../help/types.js';
 import { ConfigType } from '../../lib/apps/index.js';
 export default class CreateContent extends CreateCollectionCommand {
     static args: {
         collection: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
     };
     static description: string;
-    static examples: {
-        command: string;
-        description: string;
-    }[];
+    static examples: string[];
+    static helpMeta: HelpMeta;
     static flags: {
+        label: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         description: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         fields: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        label: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        overwrite: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         views: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        overwrite: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         yes: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
     };
     static summary: string;

package/dist/commands/create/content.js

@@ -9,65 +9,49 @@ export default class CreateContent extends CreateCollectionCommand {
     static args = {
         collection: Args.string({
             default: '',
-            description: 'collection ID to create or apply to, e.g., products (required with -y)',
+            description: 'Collection ID to create or extend (e.g., products)',
         }),
     };
-    static description = `Interactive mode: choose to create a new collection or extend an existing standard collection. The CLI will propose a list of standard collections you can extend.
-
-Non-interactive (-y): provide COLLECTION explicitly. To discover standard collections first, run: swell models.`;
+    static description = 'Interactive mode lets you choose to create a new collection or extend a standard one.\nTo discover standard collections: swell inspect models';
     static examples = [
-        {
-            command: 'swell create content',
-            description: 'Create content model interactively.',
-        },
-        {
-            command: 'swell create content products -y',
-            description: 'Apply configuration to a standard collection (non-interactive)',
-        },
-        {
-            command: 'swell create content visitors -v list,edit,new -f name:short_text,verified:boolean -l "Visitors" -d "" -y',
-            description: 'Create custom collection with explicit fields and views (non-interactive)',
-        },
-        {
-            command: 'swell create content visitors --overwrite -y',
-            description: 'Non-interactive: force overwrite existing config file',
-        },
-        {
-            command: 'swell create content visitors -f name:short_text,description:long_text,verified:boolean,visitor_count:integer,photo:image,orders:collection',
-            description: 'Specify fields with types delimited by commas (interactive mode)',
-        },
+        '$ swell create content',
+        '$ swell create content products -y',
+        '$ swell create content visitors -v list,edit,new -f name:short_text,verified:boolean -y',
     ];
+    static helpMeta = {
+        usageDirect: '<collection> [...] -y',
+    };
     static flags = {
+        label: Flags.string({
+            char: 'l',
+            default: '',
+            description: 'Display label (default: capitalized collection)',
+        }),
         description: Flags.string({
             char: 'd',
             default: '',
-            description: 'content model description',
+            description: 'Description',
         }),
         fields: Flags.string({
             char: 'f',
             default: '',
-            description: 'comma-separated id:type pairs (e.g., name:short_text, verified:boolean)',
+            description: 'Fields as id:type pairs (e.g., name:short_text,verified:boolean)',
         }),
-        label: Flags.string({
-            char: 'l',
+        views: Flags.string({
+            char: 'v',
             default: '',
-            description: 'display label for the content model (defaults to capitalized collection name)',
+            description: 'Views to enable: list | edit | new',
         }),
         overwrite: Flags.boolean({
             default: false,
-            description: 'overwrite existing content model configuration file (use with -y to force overwrite)',
-        }),
-        views: Flags.string({
-            char: 'v',
-            default: '',
-            description: 'comma-separated views - valid: list, edit, new',
+            description: 'Overwrite existing file',
         }),
         yes: Flags.boolean({
             char: 'y',
-            description: 'accept all default values; non-interactive, never prompts; errors if required values are missing',
+            description: 'Skip prompts, require all arguments',
         }),
     };
-    static summary = 'Initialize a content UI model config file with properties in the content folder.';
+    static summary = 'Create a content UI model configuration in the content folder.';
     createType = ConfigType.CONTENT;
     async run() {
         const { args, flags } = await this.parse(CreateContent);