@swell/cli 2.2.1 → 2.3.1

package/oclif.manifest.json

@@ -242,12 +242,12 @@
       "aliases": [],
       "args": {
         "type": {
-          "description": "Schema type (e.g. model, content, setting, notification, webhook)",
+          "description": "Schema type (e.g. model, content, setting, notification, webhook, function)",
           "name": "type",
           "required": false
         },
         "file": {
-          "description": "Path to JSON file to validate (or use \"-\" for stdin)",
+          "description": "Path to file to validate (or use \"-\" for stdin)",
           "name": "file",
           "required": false
         }
@@ -270,12 +270,16 @@
           "command": "<%= config.bin %> <%= command.id %> content --format=dts"
         },
         {
-          "description": "Validate a file",
+          "description": "Validate a JSON config file",
           "command": "<%= config.bin %> <%= command.id %> content myfile.json"
         },
         {
           "description": "Validate from stdin",
           "command": "cat myfile.json | <%= config.bin %> <%= command.id %> content -"
+        },
+        {
+          "description": "Validate a function file",
+          "command": "<%= config.bin %> <%= command.id %> function myfunction.ts"
         }
       ],
       "flags": {
@@ -306,7 +310,7 @@
       "pluginName": "@swell/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "View or validate Swell config JSON Schemas.",
+      "summary": "View or validate Swell config schemas.",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
@@ -379,7 +383,8 @@
       },
       "description": "Remove existing resources from the Swell Backend API.",
       "examples": [
-        "swell api delete /products/abc123"
+        "swell api delete /products/abc123",
+        "swell api delete /functions/my-app/clear-cache"
       ],
       "flags": {
         "live": {
@@ -418,7 +423,8 @@
       "examples": [
         "swell api get /products",
         "swell api get \"/products?limit=10&category=shoes\"",
-        "swell api get /products/abc123"
+        "swell api get /products/abc123",
+        "swell api get /functions/my-app/get-inventory"
       ],
       "flags": {
         "live": {
@@ -447,12 +453,14 @@
     "api": {
       "aliases": [],
       "args": {},
-      "description": "Run Swell API requests directly from the command line.\n  Supports GET, POST, PUT, and DELETE methods with optional test/live environments.",
+      "description": "Run Swell API requests directly from the command line.\n  Supports GET, POST, PUT, and DELETE methods with optional test/live environments.\n  Call app functions via /functions/<app_id>/<function_name> paths.",
       "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 delete /products/abc123",
+        "swell api get /functions/my-app/get-inventory",
+        "swell api post /functions/my-app/create-order --body '{\"items\":[\"sku-1\"]}'"
       ],
       "flags": {},
       "hasDynamicHelp": false,
@@ -484,7 +492,8 @@
       "description": "Create new resources in the Swell Backend API.\n  You can provide a JSON body directly or specify a file path containing JSON data.",
       "examples": [
         "swell api post /products --body '{\"name\": \"Product\", \"price\": 100}'",
-        "swell api post /products --body ./product.json"
+        "swell api post /products --body ./product.json",
+        "swell api post /functions/my-app/create-order --body '{\"items\":[\"sku-1\"]}'"
       ],
       "flags": {
         "body": {
@@ -529,7 +538,8 @@
       "description": "Update existing resources in the Swell Backend API.\n  You can provide a JSON body directly or specify a file path containing JSON data.",
       "examples": [
         "swell api put /products/{id} --body '{\"id\": \"abc123\", \"name\": \"Updated\"}'",
-        "swell api put /products/abc123 --body ./product.json"
+        "swell api put /products/abc123 --body ./product.json",
+        "swell api put /functions/my-app/update-stock --body '{\"sku\":\"abc\",\"qty\":10}'"
       ],
       "flags": {
         "body": {
@@ -571,7 +581,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -625,7 +635,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -707,7 +717,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -737,24 +747,22 @@
       "args": {
         "id": {
           "default": "",
-          "description": "id of the app to create (required in -y)",
+          "description": "App identifier (defaults to current directory name)",
           "name": "id"
         }
       },
       "description": "Initialize app swell.json in the current directory.",
       "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"
       ],
       "flags": {
         "frontend": {
-          "description": "create a starter framework for a hosted frontend (default in -y: none)",
+          "description": "Framework: astro | angular | hono | nuxt | nextjs | none",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -769,14 +777,14 @@
           "type": "option"
         },
         "storefront-app": {
-          "description": "id of an installed storefront app to create a theme for, if applicable",
+          "description": "Target storefront app ID",
           "name": "storefront-app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "integration-type": {
-          "description": "integration type for integration app, if applicable",
+          "description": "Integration: generic | payment | shipping | tax",
           "name": "integration-type",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -789,7 +797,7 @@
           "type": "option"
         },
         "integration-id": {
-          "description": "unique identifier for the integration service (required for payment/shipping/tax; use 'card' for credit cards)",
+          "description": "Service ID (e.g., card, fedex)",
           "name": "integration-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -797,10 +805,62 @@
         },
         "yes": {
           "char": "y",
-          "description": "accept all default values",
+          "description": "Skip prompts, require all arguments",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "pkg": {
+          "char": "p",
+          "description": "Package manager: npm | yarn | none",
+          "name": "pkg",
+          "default": "npm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "npm",
+            "yarn",
+            "none"
+          ],
+          "type": "option"
+        },
+        "type": {
+          "char": "t",
+          "description": "App type: admin | storefront | theme | integration",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "admin",
+            "integration",
+            "storefront",
+            "theme"
+          ],
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Display name (default: capitalized ID)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "char": "v",
+          "description": "Version (default: 1.0.0)",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -811,6 +871,49 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
+      "helpMeta": {
+        "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"
+        ],
+        "usageDirect": "[id] -t <type> [...] -y"
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -830,7 +933,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -905,7 +1008,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -953,7 +1056,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1009,7 +1112,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1092,7 +1195,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1104,6 +1207,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "force-create-files": {
+          "description": "do not use files from previous versions",
+          "name": "force-create-files",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "message": {
           "char": "m",
           "description": "description of the changes in this version for internal use",
@@ -1156,7 +1265,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1194,52 +1303,22 @@
       "args": {
         "id": {
           "default": "",
-          "description": "id of the app to create (required in -y)",
+          "description": "App identifier (e.g., my-app)",
           "name": "id"
         }
       },
       "description": "Create an app.",
       "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"
       ],
       "flags": {
         "frontend": {
-          "description": "create a starter framework for a hosted frontend (default in -y: none)",
+          "description": "Framework: astro | angular | hono | nuxt | nextjs | none",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1254,14 +1333,14 @@
           "type": "option"
         },
         "storefront-app": {
-          "description": "id of an installed storefront app to create a theme for, if applicable",
+          "description": "Target storefront app ID",
           "name": "storefront-app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "integration-type": {
-          "description": "integration type for integration app, if applicable",
+          "description": "Integration: generic | payment | shipping | tax",
           "name": "integration-type",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1274,7 +1353,7 @@
           "type": "option"
         },
         "integration-id": {
-          "description": "unique identifier for the integration service (required for payment/shipping/tax; use 'card' for credit cards)",
+          "description": "Service ID (e.g., card, fedex)",
           "name": "integration-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1282,14 +1361,14 @@
         },
         "yes": {
           "char": "y",
-          "description": "accept all default values; non-interactive, never prompts; errors if required values are missing",
+          "description": "Skip prompts, require all arguments",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
         },
         "pkg": {
           "char": "p",
-          "description": "use npm or yarn to install default dependencies, or none to disable",
+          "description": "Package manager: npm | yarn | none",
           "name": "pkg",
           "default": "npm",
           "hasDynamicHelp": false,
@@ -1303,7 +1382,7 @@
         },
         "type": {
           "char": "t",
-          "description": "create a specific app type (required in -y)",
+          "description": "App type: admin | storefront | theme | integration",
           "name": "type",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1317,7 +1396,7 @@
         },
         "name": {
           "char": "n",
-          "description": "application name (default: capitalized ID)",
+          "description": "Display name (default: capitalized ID)",
           "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1325,7 +1404,7 @@
         },
         "version": {
           "char": "v",
-          "description": "application version (default: 1.0.0)",
+          "description": "Version (default: 1.0.0)",
           "name": "version",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1333,7 +1412,7 @@
         },
         "description": {
           "char": "d",
-          "description": "application description",
+          "description": "Description",
           "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1348,6 +1427,49 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
+      "helpMeta": {
+        "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"
+        ],
+        "usageDirect": "<id> -t <type> [...] -y"
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1361,32 +1483,15 @@
       "args": {
         "collection": {
           "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)",
           "name": "collection"
         }
       },
-      "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.\n\nNon-interactive (-y): provide COLLECTION explicitly. To discover standard collections first, run: swell models.",
+      "description": "Interactive mode lets you choose to create a new collection or extend a standard one.\nTo discover standard collections: swell inspect models",
       "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"
       ],
       "flags": {
         "app-path": {
@@ -1396,9 +1501,18 @@
           "multiple": false,
           "type": "option"
         },
+        "label": {
+          "char": "l",
+          "description": "Display label (default: capitalized collection)",
+          "name": "label",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "description": {
           "char": "d",
-          "description": "content model description",
+          "description": "Description",
           "name": "description",
           "default": "",
           "hasDynamicHelp": false,
@@ -1407,40 +1521,31 @@
         },
         "fields": {
           "char": "f",
-          "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)",
           "name": "fields",
           "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "char": "l",
-          "description": "display label for the content model (defaults to capitalized collection name)",
-          "name": "label",
+        "views": {
+          "char": "v",
+          "description": "Views to enable: list | edit | new",
+          "name": "views",
           "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "overwrite": {
-          "description": "overwrite existing content model configuration file (use with -y to force overwrite)",
+          "description": "Overwrite existing file",
           "name": "overwrite",
           "allowNo": false,
           "type": "boolean"
         },
-        "views": {
-          "char": "v",
-          "description": "comma-separated views - valid: list, edit, new",
-          "name": "views",
-          "default": "",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "yes": {
           "char": "y",
-          "description": "accept all default values; non-interactive, never prompts; errors if required values are missing",
+          "description": "Skip prompts, require all arguments",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -1452,7 +1557,10 @@
       "pluginAlias": "@swell/cli",
       "pluginName": "@swell/cli",
       "pluginType": "core",
-      "summary": "Initialize a content UI model config file with properties in the content folder.",
+      "summary": "Create a content UI model configuration in the content folder.",
+      "helpMeta": {
+        "usageDirect": "<collection> [...] -y"
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1477,7 +1585,7 @@
       ],
       "flags": {
         "frontend": {
-          "description": "create a starter framework for a hosted frontend (default in -y: none)",
+          "description": "Framework: astro | angular | hono | nuxt | nextjs | none",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1492,14 +1600,14 @@
           "type": "option"
         },
         "storefront-app": {
-          "description": "id of an installed storefront app to create a theme for, if applicable",
+          "description": "Target storefront app ID",
           "name": "storefront-app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "integration-type": {
-          "description": "integration type for integration app, if applicable",
+          "description": "Integration: generic | payment | shipping | tax",
           "name": "integration-type",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1512,7 +1620,7 @@
           "type": "option"
         },
         "integration-id": {
-          "description": "unique identifier for the integration service (required for payment/shipping/tax; use 'card' for credit cards)",
+          "description": "Service ID (e.g., card, fedex)",
           "name": "integration-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1520,7 +1628,7 @@
         },
         "yes": {
           "char": "y",
-          "description": "accept all default values; non-interactive, never prompts; errors if required values are missing",
+          "description": "Skip prompts, require all arguments",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -1559,12 +1667,14 @@
     "create:function": {
       "aliases": [],
       "args": {
-        "functionName": {
-          "description": "function name, used in an http route if applicable",
-          "name": "functionName"
+        "name": {
+          "default": "",
+          "description": "Filename with extension (e.g., my-func.ts)",
+          "name": "name"
         },
         "trigger": {
-          "description": "function trigger type",
+          "default": "",
+          "description": "cron | model | route",
           "name": "trigger",
           "options": [
             "cron",
@@ -1573,28 +1683,15 @@
           ]
         }
       },
-      "description": "This command assists in generating functions scripts. CLI will prompt for values when flags are not present.",
       "examples": [
-        {
-          "command": "swell create function",
-          "description": "Create function script interactively."
-        },
-        {
-          "command": "swell create function orders-subscriptions-created.ts model --events order.created,subscription.created",
-          "description": "Specify model event trigger of the function."
-        },
-        {
-          "command": "swell create function get-frontend-data.ts route --route public",
-          "description": "Specify public API access."
-        },
-        {
-          "command": "swell create function process-metrics.ts cron --schedule \"0 0 * * *\"",
-          "description": "Specify schedule of the cron function."
-        }
+        "$ swell create function",
+        "$ swell create function order-handler.ts model -e order.created,order.updated -y",
+        "$ swell create function cleanup.ts cron -s \"0 0 * * *\" -y",
+        "$ swell create function api-endpoint.ts route -r public -y"
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1602,7 +1699,7 @@
         },
         "description": {
           "char": "d",
-          "description": "function description",
+          "description": "Description",
           "name": "description",
           "default": "",
           "hasDynamicHelp": false,
@@ -1611,7 +1708,7 @@
         },
         "events": {
           "char": "e",
-          "description": "list of data model events used with model trigger, delimited by commas",
+          "description": "Model events (e.g., order.created,order.updated)",
           "name": "events",
           "default": "",
           "hasDynamicHelp": false,
@@ -1619,16 +1716,16 @@
           "type": "option"
         },
         "overwrite": {
-          "description": "overwrite existing function file",
+          "description": "Overwrite existing file",
           "name": "overwrite",
           "allowNo": false,
           "type": "boolean"
         },
         "route": {
           "char": "r",
-          "description": "access type used with route trigger",
+          "description": "Access: public | private",
           "name": "route",
-          "default": "public",
+          "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -1639,12 +1736,19 @@
         },
         "schedule": {
           "char": "s",
-          "description": "crontab value used with cron trigger",
+          "description": "Cron expression (e.g., \"0 0 * * *\")",
           "name": "schedule",
           "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip prompts, require all arguments",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1654,7 +1758,35 @@
       "pluginName": "@swell/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Initialize a functions script in JavaScript or TypeScript.",
+      "summary": "Create a serverless function in JavaScript or TypeScript.",
+      "helpMeta": {
+        "usageDirect": "<name> <trigger> [...] -y",
+        "variantSection": {
+          "title": "TRIGGER OPTIONS",
+          "variants": [
+            {
+              "name": "model",
+              "flag": "-e, --events=<value>",
+              "description": "Model events (e.g., order.created,order.updated)"
+            },
+            {
+              "name": "cron",
+              "flag": "-s, --schedule=<value>",
+              "description": "Cron expression (e.g., \"0 0 * * *\")"
+            },
+            {
+              "name": "route",
+              "flag": "-r, --route=<option>",
+              "description": "Access: public (default) | private"
+            }
+          ]
+        },
+        "variantFlags": [
+          "events",
+          "schedule",
+          "route"
+        ]
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1692,28 +1824,15 @@
       "args": {
         "collection": {
           "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)",
           "name": "collection"
         }
       },
-      "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.\n\nNon-interactive (-y): provide COLLECTION explicitly. To discover standard collections first, run: swell inspect models.",
+      "description": "Interactive mode lets you choose to create a new collection or extend a standard one.\nTo discover standard collections: swell inspect models",
       "examples": [
-        {
-          "command": "swell create model",
-          "description": "Create data model configuration interactively"
-        },
-        {
-          "command": "swell create model products -y",
-          "description": "Apply configuration to a standard collection (non-interactive)"
-        },
-        {
-          "command": "swell create model visitors -e created,updated -f title:string,photo:image -l \"Visitors\" -d \"\" -y",
-          "description": "Create custom collection with explicit fields (non-interactive)"
-        },
-        {
-          "command": "swell inspect models",
-          "description": "List standard collections available for extending"
-        }
+        "$ swell create model",
+        "$ swell create model products -y",
+        "$ swell create model visitors -f title:string,photo:string -l \"Visitors\" -y"
       ],
       "flags": {
         "app-path": {
@@ -1723,51 +1842,51 @@
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "char": "d",
-          "description": "data model description",
-          "name": "description",
+        "label": {
+          "char": "l",
+          "description": "Display label (default: capitalized collection)",
+          "name": "label",
           "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "events": {
-          "char": "e",
-          "description": "comma-separated events - valid: created, updated, deleted",
-          "name": "events",
-          "default": "created,updated,deleted",
+        "description": {
+          "char": "d",
+          "description": "Description",
+          "name": "description",
+          "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "fields": {
           "char": "f",
-          "description": "comma-separated id:type pairs (e.g., title:string, price:currency). Types: collection, currency, image, int, link, string",
+          "description": "Fields as id:type pairs (e.g., title:string,price:currency)",
           "name": "fields",
           "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "char": "l",
-          "description": "display label for the model (defaults to capitalized collection name)",
-          "name": "label",
-          "default": "",
+        "events": {
+          "char": "e",
+          "description": "Events to track (default: created,updated,deleted)",
+          "name": "events",
+          "default": "created,updated,deleted",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "overwrite": {
-          "description": "overwrite existing data model configuration file (use with -y to force overwrite)",
+          "description": "Overwrite existing file",
           "name": "overwrite",
           "allowNo": false,
           "type": "boolean"
         },
         "yes": {
           "char": "y",
-          "description": "accept all default values; non-interactive, never prompts; errors if required values are missing",
+          "description": "Skip prompts, require all arguments",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -1780,6 +1899,9 @@
       "pluginName": "@swell/cli",
       "pluginType": "core",
       "summary": "Create or extend a data model configuration in the models folder.",
+      "helpMeta": {
+        "usageDirect": "<collection> [...] -y"
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1791,49 +1913,30 @@
     "create:notification": {
       "aliases": [],
       "args": {
-        "model": {
-          "description": "data model to trigger the notification by",
-          "name": "model"
-        },
         "name": {
-          "description": "internal name for the notification",
+          "default": "",
+          "description": "Notification name (e.g., order-paid)",
           "name": "name"
         }
       },
-      "description": "This command assists in generating notifications configuration files. This CLI command will prompt for values when flags are not present.",
+      "description": "Create notification files and configuration in the notifications folder.",
       "examples": [
-        {
-          "command": "swell create notification",
-          "description": "Create notification configuration interactively."
-        },
-        {
-          "command": "swell create notification subscriptions confirmed --event subscription.created --once --s \"Your subscription has been confirmed\" -d \"Send a confirmation email when subscription is created\"",
-          "description": "Specify the model, name, event, subject, and description."
-        },
-        {
-          "command": "swell create notification orders paid --event paid\"",
-          "description": "Specify the event to trigger the notification."
-        }
+        "$ swell create notification",
+        "$ swell create notification order-paid -m orders -y",
+        "$ swell create notification order-paid -m orders -e created -s \"Order Paid\" --admin --once -y"
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "admin": {
-          "char": "a",
-          "description": "indicate when the notification is sent to store admins only",
-          "name": "admin",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "description": {
-          "char": "d",
-          "description": "notification description",
-          "name": "description",
+        "model": {
+          "char": "m",
+          "description": "Triggering model (required with -y)",
+          "name": "model",
           "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1841,50 +1944,159 @@
         },
         "event": {
           "char": "e",
-          "description": "data model event to trigger the notification event, i.e. created",
+          "description": "Triggering event (default: created)",
           "name": "event",
           "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "subject": {
+          "char": "s",
+          "description": "Email subject",
+          "name": "subject",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Description",
+          "name": "description",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "admin": {
+          "char": "a",
+          "description": "Send to store admins only",
+          "name": "admin",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "once": {
           "char": "o",
-          "description": "indicate the notification should be sent only once when conditions are met, instead of repeating",
+          "description": "Send only once when conditions met",
           "name": "once",
           "allowNo": false,
           "type": "boolean"
         },
         "overwrite": {
-          "description": "overwrite existing notification configuration file",
+          "description": "Overwrite existing file",
           "name": "overwrite",
           "allowNo": false,
           "type": "boolean"
         },
-        "subject": {
-          "char": "s",
-          "description": "notification email subject",
-          "name": "subject",
+        "yes": {
+          "char": "y",
+          "description": "Skip prompts, require all arguments",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "create:notification",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Create notification files and configuration in the notifications folder.",
+      "helpMeta": {
+        "usageDirect": "<name> -m <model> [...] -y"
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "create",
+        "notification.js"
+      ]
+    },
+    "create:setting": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "default": "",
+          "description": "Setting name (e.g., api-config)",
+          "name": "name"
+        }
+      },
+      "description": "Create a setting configuration in the settings folder.",
+      "examples": [
+        "$ swell create setting",
+        "$ swell create setting api-config -y",
+        "$ swell create setting api-config -f api_key:short_text,enabled:boolean -l \"API Config\" -y"
+      ],
+      "flags": {
+        "app-path": {
+          "description": "Path to your app directory",
+          "name": "app-path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "label": {
+          "char": "l",
+          "description": "Display label (default: titleized name)",
+          "name": "label",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Description",
+          "name": "description",
           "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "fields": {
+          "char": "f",
+          "description": "Fields as id:type pairs (e.g., api_key:short_text,enabled:boolean)",
+          "name": "fields",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "overwrite": {
+          "description": "Overwrite existing file",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip prompts, require all arguments",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "create:notification",
+      "id": "create:setting",
       "pluginAlias": "@swell/cli",
       "pluginName": "@swell/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Initialize notification files and configuration with properties in the notifications folder.",
+      "summary": "Create a setting configuration in the settings folder.",
+      "helpMeta": {
+        "usageDirect": "<name> [...] -y"
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "create",
-        "notification.js"
+        "setting.js"
       ]
     },
     "create:tests": {
@@ -1892,32 +2104,26 @@
       "args": {},
       "description": "Initialize a vitest + Cloudflare Workers test setup that reuses swell-cli authentication.",
       "examples": [
-        {
-          "command": "swell create tests",
-          "description": "Create a basic test setup using TypeScript."
-        },
-        {
-          "command": "swell create tests --overwrite",
-          "description": "Regenerate test files, overwriting existing ones."
-        }
+        "$ swell create tests",
+        "$ swell create tests --overwrite"
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "overwrite": {
-          "description": "overwrite existing test files if they already exist",
+          "description": "Overwrite existing test files",
           "name": "overwrite",
           "allowNo": false,
           "type": "boolean"
         },
         "yes": {
           "char": "y",
-          "description": "accept defaults, skip prompts (no prompts currently, included for consistency)",
+          "description": "Skip prompts, require all arguments",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -1930,8 +2136,11 @@
       "pluginName": "@swell/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create test scaffolding for your Swell app.",
+      "summary": "Create tests scaffolding for your Swell app.",
       "enableJsonFlag": false,
+      "helpMeta": {
+        "usageDirect": "[-y]"
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1940,6 +2149,95 @@
         "tests.js"
       ]
     },
+    "create:webhook": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "default": "",
+          "description": "Webhook name (e.g., order-sync)",
+          "name": "name"
+        }
+      },
+      "description": "Create a webhook configuration in the webhooks folder.",
+      "examples": [
+        "$ swell create webhook",
+        "$ swell create webhook order-sync -u https://example.com/hook -e order.created -y",
+        "$ swell create webhook payment-handler -u https://api.example.com/payments -e payment.succeeded,payment.failed --enabled -y"
+      ],
+      "flags": {
+        "app-path": {
+          "description": "Path to your app directory",
+          "name": "app-path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "char": "u",
+          "description": "Endpoint URL (required with -y)",
+          "name": "url",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "events": {
+          "char": "e",
+          "description": "Events to listen for (e.g., order.created,payment.succeeded)",
+          "name": "events",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Description",
+          "name": "description",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "enabled": {
+          "description": "Enable webhook (default: false)",
+          "name": "enabled",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "overwrite": {
+          "description": "Overwrite existing file",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip prompts, require all arguments",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "create:webhook",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Create a webhook configuration in the webhooks folder.",
+      "helpMeta": {
+        "usageDirect": "<name> -u <url> -e <events> [...] -y"
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "create",
+        "webhook.js"
+      ]
+    },
     "inspect:content": {
       "aliases": [],
       "args": {
@@ -2075,7 +2373,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2148,24 +2446,21 @@
       "args": {
         "id": {
           "default": "",
-          "description": "id of the app to create (required in -y)",
+          "description": "Theme identifier (defaults to current directory name)",
           "name": "id"
         }
       },
       "description": "Initialize theme swell.json in the current directory.",
       "examples": [
-        {
-          "command": "swell theme init",
-          "description": "Initialize theme following command prompts."
-        },
-        {
-          "command": "swell theme init -y",
-          "description": "Initialize theme and accept all default values."
-        }
+        "$ swell theme init",
+        "$ swell theme init my-theme",
+        "$ swell theme init -y",
+        "$ swell theme init my-theme -y",
+        "$ swell theme init my-theme --storefront-app proxima -y"
       ],
       "flags": {
         "frontend": {
-          "description": "create a starter framework for a hosted frontend (default in -y: none)",
+          "description": "Framework: astro | angular | hono | nuxt | nextjs | none",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2180,14 +2475,14 @@
           "type": "option"
         },
         "storefront-app": {
-          "description": "id of an installed storefront app to create a theme for, if applicable",
+          "description": "Target storefront app ID",
           "name": "storefront-app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "integration-type": {
-          "description": "integration type for integration app, if applicable",
+          "description": "Integration: generic | payment | shipping | tax",
           "name": "integration-type",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2200,7 +2495,7 @@
           "type": "option"
         },
         "integration-id": {
-          "description": "unique identifier for the integration service (required for payment/shipping/tax; use 'card' for credit cards)",
+          "description": "Service ID (e.g., card, fedex)",
           "name": "integration-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2208,10 +2503,62 @@
         },
         "yes": {
           "char": "y",
-          "description": "accept all default values",
+          "description": "Skip prompts, require all arguments",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "pkg": {
+          "char": "p",
+          "description": "Package manager: npm | yarn | none",
+          "name": "pkg",
+          "default": "npm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "npm",
+            "yarn",
+            "none"
+          ],
+          "type": "option"
+        },
+        "type": {
+          "char": "t",
+          "description": "App type: admin | storefront | theme | integration",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "admin",
+            "integration",
+            "storefront",
+            "theme"
+          ],
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Display name (default: capitalized ID)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "char": "v",
+          "description": "Version (default: 1.0.0)",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -2222,6 +2569,9 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
+      "helpMeta": {
+        "usageDirect": "[id] --storefront-app <app> [...] -y"
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -2391,7 +2741,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2449,7 +2799,7 @@
       ],
       "flags": {
         "app-path": {
-          "description": "path to your app directory",
+          "description": "Path to your app directory",
           "name": "app-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2525,5 +2875,5 @@
       ]
     }
   },
-  "version": "2.2.1"
+  "version": "2.3.1"
 }