@swell/cli 2.1.0 → 2.2.1

package/oclif.manifest.json

@@ -238,6 +238,83 @@
         "logs.js"
       ]
     },
+    "schema": {
+      "aliases": [],
+      "args": {
+        "type": {
+          "description": "Schema type (e.g. model, content, setting, notification, webhook)",
+          "name": "type",
+          "required": false
+        },
+        "file": {
+          "description": "Path to JSON file to validate (or use \"-\" for stdin)",
+          "name": "file",
+          "required": false
+        }
+      },
+      "examples": [
+        {
+          "description": "List available schema types",
+          "command": "<%= config.bin %> <%= command.id %>"
+        },
+        {
+          "description": "Output JSON Schema",
+          "command": "<%= config.bin %> <%= command.id %> content --format=json-schema"
+        },
+        {
+          "description": "Output bundled JSON Schema (all $refs resolved)",
+          "command": "<%= config.bin %> <%= command.id %> content --format=json-schema-bundle"
+        },
+        {
+          "description": "Output TypeScript declarations",
+          "command": "<%= config.bin %> <%= command.id %> content --format=dts"
+        },
+        {
+          "description": "Validate a file",
+          "command": "<%= config.bin %> <%= command.id %> content myfile.json"
+        },
+        {
+          "description": "Validate from stdin",
+          "command": "cat myfile.json | <%= config.bin %> <%= command.id %> content -"
+        }
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format: json-schema (with $ref pointers), json-schema-bundle (all $refs resolved), or dts (TypeScript declarations)",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json-schema",
+            "json-schema-bundle",
+            "dts"
+          ],
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip informational output and print schema directly (equivalent to --format=json-schema).",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "schema",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "View or validate Swell config JSON Schemas.",
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "schema.js"
+      ]
+    },
     "switch": {
       "aliases": [],
       "args": {
@@ -291,6 +368,200 @@
         "whoami.js"
       ]
     },
+    "api:delete": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "API endpoint path (must start with /)",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Remove existing resources from the Swell Backend API.",
+      "examples": [
+        "swell api delete /products/abc123"
+      ],
+      "flags": {
+        "live": {
+          "description": "Use live environment instead of test",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "api:delete",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Send a DELETE request to the Swell API.",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "api",
+        "delete.js"
+      ]
+    },
+    "api:get": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "API endpoint path (must start with /)",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Retrieve data from the Swell Backend API.\n  The command performs a GET request to the specified endpoint path.",
+      "examples": [
+        "swell api get /products",
+        "swell api get \"/products?limit=10&category=shoes\"",
+        "swell api get /products/abc123"
+      ],
+      "flags": {
+        "live": {
+          "description": "Use live environment instead of test",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "api:get",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Send a GET request to the Swell API.",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "api",
+        "get.js"
+      ]
+    },
+    "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.",
+      "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"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "api",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Send requests directly to the Swell Backend API.",
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "api",
+        "index.js"
+      ]
+    },
+    "api:post": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "API endpoint path (must start with /)",
+          "name": "path",
+          "required": true
+        }
+      },
+      "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"
+      ],
+      "flags": {
+        "body": {
+          "description": "Request body (inline JSON or file path)",
+          "name": "body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "live": {
+          "description": "Use live environment instead of test",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "api:post",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Send a POST request to the Swell API.",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "api",
+        "post.js"
+      ]
+    },
+    "api:put": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "API endpoint path (must start with /)",
+          "name": "path",
+          "required": true
+        }
+      },
+      "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"
+      ],
+      "flags": {
+        "body": {
+          "description": "Request body (inline JSON or file path)",
+          "name": "body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "live": {
+          "description": "Use live environment instead of test",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "api:put",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Send a PUT request to the Swell API.",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "api",
+        "put.js"
+      ]
+    },
     "app:_uninstall": {
       "aliases": [],
       "args": {},
@@ -466,7 +737,7 @@
       "args": {
         "id": {
           "default": "",
-          "description": "id of the app to create",
+          "description": "id of the app to create (required in -y)",
           "name": "id"
         }
       },
@@ -483,7 +754,7 @@
       ],
       "flags": {
         "frontend": {
-          "description": "create a starter framework for a hosted frontend",
+          "description": "create a starter framework for a hosted frontend (default in -y: none)",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -492,7 +763,8 @@
             "angular",
             "hono",
             "nuxt",
-            "nextjs"
+            "nextjs",
+            "none"
           ],
           "type": "option"
         },
@@ -503,6 +775,26 @@
           "multiple": false,
           "type": "option"
         },
+        "integration-type": {
+          "description": "integration type for integration app, if applicable",
+          "name": "integration-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "generic",
+            "payment",
+            "shipping",
+            "tax"
+          ],
+          "type": "option"
+        },
+        "integration-id": {
+          "description": "unique identifier for the integration service (required for payment/shipping/tax; use 'card' for credit cards)",
+          "name": "integration-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
           "description": "accept all default values",
@@ -902,7 +1194,7 @@
       "args": {
         "id": {
           "default": "",
-          "description": "id of the app to create",
+          "description": "id of the app to create (required in -y)",
           "name": "id"
         }
       },
@@ -910,24 +1202,44 @@
       "examples": [
         {
           "command": "swell create app",
-          "description": "Create app following command prompts."
+          "description": "Interactive: follow prompts to create an app."
         },
         {
-          "command": "swell create app my_app -y",
-          "description": "Create app and accept all default values."
+          "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": "Create app with yarn package manager instead of npm by default."
+          "description": "Package manager: use Yarn instead of npm."
         },
         {
           "command": "swell create app -p none",
-          "description": "Create app without installing TypeScript bindings, etc."
+          "description": "Package manager: skip installing default dependencies."
         }
       ],
       "flags": {
         "frontend": {
-          "description": "create a starter framework for a hosted frontend",
+          "description": "create a starter framework for a hosted frontend (default in -y: none)",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -936,7 +1248,8 @@
             "angular",
             "hono",
             "nuxt",
-            "nextjs"
+            "nextjs",
+            "none"
           ],
           "type": "option"
         },
@@ -947,9 +1260,29 @@
           "multiple": false,
           "type": "option"
         },
+        "integration-type": {
+          "description": "integration type for integration app, if applicable",
+          "name": "integration-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "generic",
+            "payment",
+            "shipping",
+            "tax"
+          ],
+          "type": "option"
+        },
+        "integration-id": {
+          "description": "unique identifier for the integration service (required for payment/shipping/tax; use 'card' for credit cards)",
+          "name": "integration-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
-          "description": "accept all default values",
+          "description": "accept all default values; non-interactive, never prompts; errors if required values are missing",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -970,7 +1303,7 @@
         },
         "type": {
           "char": "t",
-          "description": "create a specific app type",
+          "description": "create a specific app type (required in -y)",
           "name": "type",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -981,6 +1314,30 @@
             "theme"
           ],
           "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "application name (default: capitalized ID)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "char": "v",
+          "description": "application version (default: 1.0.0)",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "application description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -1004,27 +1361,31 @@
       "args": {
         "collection": {
           "default": "",
-          "description": "collection to create or apply to, i.e. products",
+          "description": "collection ID to create or apply to, e.g., products (required with -y)",
           "name": "collection"
         }
       },
-      "description": "This command assists in generating UI model configuration files. CLI will prompt for values when flags are not present.",
+      "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.",
       "examples": [
         {
           "command": "swell create content",
           "description": "Create content model interactively."
         },
         {
-          "command": "swell create content visitors -v list,edit,new",
-          "description": "Specify views delimited by semicolons."
+          "command": "swell create content products -y",
+          "description": "Apply configuration to a standard collection (non-interactive)"
         },
         {
-          "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 semicolons"
+          "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 -o -f verified:short_text -v list,edit,new -d \"Visitor Views\"",
-          "description": "Specify fields, views, and description."
+          "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)"
         }
       ],
       "flags": {
@@ -1046,7 +1407,7 @@
         },
         "fields": {
           "char": "f",
-          "description": "list of content model fields delimited by commas",
+          "description": "comma-separated id:type pairs (e.g., name:short_text, verified:boolean)",
           "name": "fields",
           "default": "",
           "hasDynamicHelp": false,
@@ -1055,7 +1416,7 @@
         },
         "label": {
           "char": "l",
-          "description": "content model label",
+          "description": "display label for the content model (defaults to capitalized collection name)",
           "name": "label",
           "default": "",
           "hasDynamicHelp": false,
@@ -1063,19 +1424,26 @@
           "type": "option"
         },
         "overwrite": {
-          "description": "overwrite existing content model configuration file",
+          "description": "overwrite existing content model configuration file (use with -y to force overwrite)",
           "name": "overwrite",
           "allowNo": false,
           "type": "boolean"
         },
         "views": {
           "char": "v",
-          "description": "list of content model views delimited by commas, i.e. list,edit,new",
+          "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",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1109,7 +1477,7 @@
       ],
       "flags": {
         "frontend": {
-          "description": "create a starter framework for a hosted frontend",
+          "description": "create a starter framework for a hosted frontend (default in -y: none)",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1118,7 +1486,8 @@
             "angular",
             "hono",
             "nuxt",
-            "nextjs"
+            "nextjs",
+            "none"
           ],
           "type": "option"
         },
@@ -1129,9 +1498,29 @@
           "multiple": false,
           "type": "option"
         },
+        "integration-type": {
+          "description": "integration type for integration app, if applicable",
+          "name": "integration-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "generic",
+            "payment",
+            "shipping",
+            "tax"
+          ],
+          "type": "option"
+        },
+        "integration-id": {
+          "description": "unique identifier for the integration service (required for payment/shipping/tax; use 'card' for credit cards)",
+          "name": "integration-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
-          "description": "accept all default values",
+          "description": "accept all default values; non-interactive, never prompts; errors if required values are missing",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -1303,27 +1692,27 @@
       "args": {
         "collection": {
           "default": "",
-          "description": "collection to create or apply to, i.e. products",
+          "description": "collection ID to create or apply to, e.g., products (required with -y)",
           "name": "collection"
         }
       },
-      "description": "This command assists in generating data model configuration files. CLI will prompt for values when flags are not present.",
+      "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.",
       "examples": [
         {
           "command": "swell create model",
-          "description": "Create data model configuration interactively."
+          "description": "Create data model configuration interactively"
         },
         {
-          "command": "swell create model visitors -e created,updated,deleted.",
-          "description": "Specify events of the data model."
+          "command": "swell create model products -y",
+          "description": "Apply configuration to a standard collection (non-interactive)"
         },
         {
-          "command": "swell create model visitors -f first_name:string,last_name:string,photo:file,visit_count:int,visits:link",
-          "description": "Specify fields of the data model."
+          "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 create model visitors -f first_name:string,last_name:string,photo:file,visit_count:int,visits:link -d \"Visitors Tracking\" -o -e created,updated,deleted",
-          "description": "Scaffold a data model configuration with args and flags."
+          "command": "swell inspect models",
+          "description": "List standard collections available for extending"
         }
       ],
       "flags": {
@@ -1345,7 +1734,7 @@
         },
         "events": {
           "char": "e",
-          "description": "list of data model events delimited by commas",
+          "description": "comma-separated events - valid: created, updated, deleted",
           "name": "events",
           "default": "created,updated,deleted",
           "hasDynamicHelp": false,
@@ -1354,7 +1743,7 @@
         },
         "fields": {
           "char": "f",
-          "description": "list of data model fields delimited by commas",
+          "description": "comma-separated id:type pairs (e.g., title:string, price:currency). Types: collection, currency, image, int, link, string",
           "name": "fields",
           "default": "",
           "hasDynamicHelp": false,
@@ -1363,7 +1752,7 @@
         },
         "label": {
           "char": "l",
-          "description": "data model label, i.e. Products",
+          "description": "display label for the model (defaults to capitalized collection name)",
           "name": "label",
           "default": "",
           "hasDynamicHelp": false,
@@ -1371,10 +1760,17 @@
           "type": "option"
         },
         "overwrite": {
-          "description": "Overwrite existing data model configuration file.",
+          "description": "overwrite existing data model configuration file (use with -y to force overwrite)",
           "name": "overwrite",
           "allowNo": false,
           "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "accept all default values; non-interactive, never prompts; errors if required values are missing",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1383,7 +1779,7 @@
       "pluginAlias": "@swell/cli",
       "pluginName": "@swell/cli",
       "pluginType": "core",
-      "summary": "Initialize a data model config file with properties in the models folder.",
+      "summary": "Create or extend a data model configuration in the models folder.",
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1491,6 +1887,182 @@
         "notification.js"
       ]
     },
+    "create:tests": {
+      "aliases": [],
+      "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."
+        }
+      ],
+      "flags": {
+        "app-path": {
+          "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",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "accept defaults, skip prompts (no prompts currently, included for consistency)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "create:tests",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Create test scaffolding for your Swell app.",
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "create",
+        "tests.js"
+      ]
+    },
+    "inspect:content": {
+      "aliases": [],
+      "args": {
+        "content-id": {
+          "description": "Optional content view ID. Example: custom.admin.products, app.myapp.products",
+          "name": "content-id",
+          "required": false
+        }
+      },
+      "description": "\nView content view extensions available in your Swell store.\n\nWithout a content ID, this command lists all available content views.\nWith a content ID, it retrieves the configuration for that specific content view in JSON format.\n",
+      "examples": [
+        "swell inspect content",
+        "swell inspect content custom.admin.products",
+        "swell inspect content app.honest_reviews.reviews",
+        "swell inspect content app.myapp.products --live"
+      ],
+      "flags": {
+        "live": {
+          "description": "Use the live environment instead of test (default: test).",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Accept all prompts automatically (for agent compatibility; no functional effect).",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "inspect:content",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Inspect content view extensions deployed in your store.",
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "inspect",
+        "content.js"
+      ]
+    },
+    "inspect": {
+      "aliases": [],
+      "args": {},
+      "description": "View configuration and data for deployed resources.\n\nInspect models, content views, and other deployed artifacts in your Swell store.",
+      "examples": [
+        "swell inspect models",
+        "swell inspect models /products",
+        "swell inspect models /apps/myapp/orders"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "inspect",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Inspect deployed artifacts in your store.",
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "inspect",
+        "index.js"
+      ]
+    },
+    "inspect:models": {
+      "aliases": [],
+      "args": {
+        "collection-path": {
+          "description": "Optional collection path (must start with '/'). Example: /products, /apps/myapp/orders",
+          "name": "collection-path",
+          "required": false
+        }
+      },
+      "description": "\nView models for collections available in your Swell store.\n\nWithout a collection path, this command lists all available collections grouped by type.\nWith a collection path, it retrieves the model for that specific collection in JSON format.\n",
+      "examples": [
+        "swell inspect models",
+        "swell inspect models /products",
+        "swell inspect models /apps/myapp/orders",
+        "swell inspect models /orders --live"
+      ],
+      "flags": {
+        "live": {
+          "description": "Use the live environment instead of test (default: test).",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Accept all prompts automatically (for agent compatibility; no functional effect).",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "inspect:models",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Inspect models for collections deployed in your store.",
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "inspect",
+        "models.js"
+      ]
+    },
     "theme:dev": {
       "aliases": [],
       "args": {},
@@ -1576,7 +2148,7 @@
       "args": {
         "id": {
           "default": "",
-          "description": "id of the app to create",
+          "description": "id of the app to create (required in -y)",
           "name": "id"
         }
       },
@@ -1593,7 +2165,7 @@
       ],
       "flags": {
         "frontend": {
-          "description": "create a starter framework for a hosted frontend",
+          "description": "create a starter framework for a hosted frontend (default in -y: none)",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1602,7 +2174,8 @@
             "angular",
             "hono",
             "nuxt",
-            "nextjs"
+            "nextjs",
+            "none"
           ],
           "type": "option"
         },
@@ -1613,6 +2186,26 @@
           "multiple": false,
           "type": "option"
         },
+        "integration-type": {
+          "description": "integration type for integration app, if applicable",
+          "name": "integration-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "generic",
+            "payment",
+            "shipping",
+            "tax"
+          ],
+          "type": "option"
+        },
+        "integration-id": {
+          "description": "unique identifier for the integration service (required for payment/shipping/tax; use 'card' for credit cards)",
+          "name": "integration-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
           "description": "accept all default values",
@@ -1932,5 +2525,5 @@
       ]
     }
   },
-  "version": "2.1.0"
+  "version": "2.2.1"
 }