refactor: update webapp commands - simplify generate and dev

- Changed webapp generate: -t flag now for template (was target)
- Removed target platform options from generate command
- Updated webapp dev: simplified flags, default port to 5173
- Removed host/root-dir/no-open flags from dev command
- Removed webapp deploy and retrieve commands for now
- Updated all tests, schemas, and documentation
- All tests passing

Author: lesya7

COMMANDS.md

@@ -2,60 +2,21 @@
 
 <!-- commands -->
 
-- [`sf webapp deploy`](#sf-webapp-deploy)
 - [`sf webapp dev`](#sf-webapp-dev)
 - [`sf webapp generate`](#sf-webapp-generate)
-- [`sf webapp retrieve`](#sf-webapp-retrieve)
-
-## `sf webapp deploy`
-
-Deploy the web app, its assets and associated metadata
-
-```
-USAGE
-  $ sf webapp deploy -n <value> [--json] [--flags-dir <value>] [-o build|validate]
-
-FLAGS
-  -n, --name=<value>      (required) Name of your web app
-  -o, --options=<option>  [default: build] Deployment options (build or validate)
-                          <options: build|validate>
-
-GLOBAL FLAGS
-  --flags-dir=<value>  Import flag values from a directory.
-  --json               Format output as json.
-
-DESCRIPTION
-  Deploy the web app, its assets and associated metadata
-
-  This command deploys your web app, its assets, and associated metadata to your Salesforce org. Use the build option
-  to build and deploy, or the validate option to check deployment without making changes.
-
-EXAMPLES
-  Deploy a web app:
-
-    $ sf webapp deploy --name myWebApp
-
-  Deploy a web app with specific options:
-
-    $ sf webapp deploy --name myWebApp --options build
-```
 
 ## `sf webapp dev`
 
 Preview a web app locally without needing to deploy
 
 ```
 USAGE
-  $ sf webapp dev -n <value> [--json] [--flags-dir <value>] [-t <value>] [-r <value>] [-p <value>]
-    [--host <value>] [--no-open]
+  $ sf webapp dev -n <value> [--json] [--flags-dir <value>] [-t <value>] [-p <value>]
 
 FLAGS
-  -n, --name=<value>      (required) Identifies the Web Application
-  -p, --port=<value>      [default: 8080] Port for the dev server
-  -r, --root-dir=<value>  Optional override for the local project root of the given Web Application
-  -t, --target=<value>    Selects which Web Application target to use for the preview (e.g., Lightning App, Site)
-      --host=<value>      [default: localhost] Host to bind to
-      --no-open           Do not automatically open the browser
+  -n, --name=<value>    (required) Identifies the Web Application
+  -p, --port=<value>    [default: 5173] Port for the dev server
+  -t, --target=<value>  Selects which Web Application target to use for the preview (e.g., Lightning App, Site)
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -76,34 +37,23 @@ EXAMPLES
 
     $ sf webapp dev --name myWebApp --target "LightningApp"
 
-  Start the development server on a custom port and host:
-
-    $ sf webapp dev --name myWebApp --port 8080 --host 0.0.0.0
-
-  Start the development server with custom root directory:
-
-    $ sf webapp dev --name myWebApp --root-dir ./webapps/myWebApp
-
-  Start the development server without opening the browser:
+  Start the development server on a custom port:
 
-    $ sf webapp dev --name myWebApp --no-open
+    $ sf webapp dev --name myWebApp --port 8080
 ```
 
 ## `sf webapp generate`
 
-Create a web app and associated metadata
+Create a web app and associated metadata.
 
 ```
 USAGE
-  $ sf webapp generate -n <value> -l <value> [--json] [--flags-dir <value>] [-t Site|Embed|Lightning]
-    [-r <value>] [-w]
+  $ sf webapp generate -n <value> -l <value> [--json] [--flags-dir <value>] [-t <value>] [-w]
 
 FLAGS
   -l, --label=<value>     (required) Human readable name of your web app
   -n, --name=<value>      (required) Name of your web app
-  -r, --template=<value>  [default: empty] Template to use for web app generation (pulls from central solution)
-  -t, --target=<option>   [default: empty] Target platform for the web app (Site, Embed, or Lightning)
-                          <options: Site|Embed|Lightning>
+  -t, --template=<value>  [default: empty] Template to use for web app generation (pulls from central solution)
   -w, --wizard            Run in interactive wizard mode
 
 GLOBAL FLAGS
@@ -121,54 +71,13 @@ EXAMPLES
 
     $ sf webapp generate --name "myWebApp" --label "My first Web App"
 
-  Create a web app with a specific target:
+  Create a web app with a specific template:
 
-    $ sf webapp generate --name "myWebApp" --label "My Web App" --target Site
+    $ sf webapp generate --name "myWebApp" --label "My Web App" --template "React app starter"
 
   Create a web app using the wizard:
 
     $ sf webapp generate --name "myWebApp" --label "My Web App" --wizard
 ```
 
-## `sf webapp retrieve`
-
-Retrieve the web app, its assets and associated metadata
-
-```
-USAGE
-  $ sf webapp retrieve -n <value> [--json] [--flags-dir <value>] [--no-overwrite] [-i <value>]
-
-FLAGS
-  -i, --ignore=<value>  File pattern to ignore during retrieval (e.g., "dist/**")
-  -n, --name=<value>    (required) Name of your web app to retrieve
-      --no-overwrite    Prevent overwriting existing local files
-
-GLOBAL FLAGS
-  --flags-dir=<value>  Import flag values from a directory.
-  --json               Format output as json.
-
-DESCRIPTION
-  Retrieve the web app, its assets and associated metadata
-
-  This command retrieves your web app, its assets, and associated metadata from your Salesforce org to your local
-  environment. Useful for syncing remote changes or setting up a local development environment.
-
-EXAMPLES
-  Retrieve a web app:
-
-    $ sf webapp retrieve --name myWebApp
-
-  Retrieve a web app with overwrite protection:
-
-    $ sf webapp retrieve --name myWebApp --no-overwrite
-
-  Retrieve a web app while ignoring specific files:
-
-    $ sf webapp retrieve --name myWebApp --ignore "dist/**"
-
-  Retrieve with both options:
-
-    $ sf webapp retrieve --name "myWebApp" --no-overwrite --ignore "dist/**"
-```
-
 <!-- commandsstop -->

command-snapshot.json

@@ -1,34 +1,18 @@
 [
-  {
-    "alias": [],
-    "command": "webapp:deploy",
-    "flagAliases": [],
-    "flagChars": ["n", "o"],
-    "flags": ["flags-dir", "json", "name", "options"],
-    "plugin": "@salesforce/plugin-webapp"
-  },
   {
     "alias": [],
     "command": "webapp:dev",
     "flagAliases": [],
-    "flagChars": ["n", "p", "r", "t"],
-    "flags": ["flags-dir", "host", "json", "name", "no-open", "port", "root-dir", "target"],
+    "flagChars": ["n", "p", "t"],
+    "flags": ["flags-dir", "json", "name", "port", "target"],
     "plugin": "@salesforce/plugin-webapp"
   },
   {
     "alias": [],
     "command": "webapp:generate",
     "flagAliases": [],
-    "flagChars": ["l", "n", "r", "t", "w"],
-    "flags": ["flags-dir", "json", "label", "name", "target", "template", "wizard"],
-    "plugin": "@salesforce/plugin-webapp"
-  },
-  {
-    "alias": [],
-    "command": "webapp:retrieve",
-    "flagAliases": [],
-    "flagChars": ["i", "n"],
-    "flags": ["flags-dir", "ignore", "json", "name", "no-overwrite"],
+    "flagChars": ["l", "n", "t", "w"],
+    "flags": ["flags-dir", "json", "label", "name", "template", "wizard"],
     "plugin": "@salesforce/plugin-webapp"
   }
 ]

messages/webapp.deploy.md

@@ -14,22 +14,10 @@ Identifies the Web Application
 
 Selects which Web Application target to use for the preview (e.g., Lightning App, Site)
 
-# flags.root-dir.summary
-
-Optional override for the local project root of the given Web Application
-
 # flags.port.summary
 
 Port for the dev server
 
-# flags.host.summary
-
-Host to bind to
-
-# flags.no-open.summary
-
-Do not automatically open the browser
-
 # examples
 
 - Start the development server:
@@ -40,14 +28,6 @@ Do not automatically open the browser
 
   <%= config.bin %> <%= command.id %> --name myWebApp --target "LightningApp"
 
-- Start the development server on a custom port and host:
-
-  <%= config.bin %> <%= command.id %> --name myWebApp --port 8080 --host 0.0.0.0
-
-- Start the development server with custom root directory:
-
-  <%= config.bin %> <%= command.id %> --name myWebApp --root-dir ./webapps/myWebApp
-
-- Start the development server without opening the browser:
+- Start the development server on a custom port:
 
-  <%= config.bin %> <%= command.id %> --name myWebApp --no-open
+  <%= config.bin %> <%= command.id %> --name myWebApp --port 8080

messages/webapp.dev.md

@@ -14,10 +14,6 @@ Name of your web app
 
 Human readable name of your web app
 
-# flags.target.summary
-
-Target platform for the web app (Site, Embed, or Lightning)
-
 # flags.template.summary
 
 Template to use for web app generation (pulls from central solution)
@@ -32,9 +28,9 @@ Run in interactive wizard mode
 
   <%= config.bin %> <%= command.id %> --name "myWebApp" --label "My first Web App"
 
-- Create a web app with a specific target:
+- Create a web app with a specific template:
 
-  <%= config.bin %> <%= command.id %> --name "myWebApp" --label "My Web App" --target Site
+  <%= config.bin %> <%= command.id %> --name "myWebApp" --label "My Web App" --template "React app starter"
 
 - Create a web app using the wizard:
 

messages/webapp.generate.md

@@ -11,23 +11,11 @@
         "target": {
           "type": "string"
         },
-        "rootDir": {
+        "url": {
           "type": "string"
-        },
-        "port": {
-          "type": "number"
-        },
-        "host": {
-          "type": "string"
-        },
-        "noOpen": {
-          "type": "boolean"
-        },
-        "success": {
-          "type": "boolean"
         }
       },
-      "required": ["name", "port", "host", "noOpen", "success"],
+      "required": ["name", "url"],
       "additionalProperties": false
     }
   }

messages/webapp.retrieve.md

@@ -11,17 +11,14 @@
         "label": {
           "type": "string"
         },
-        "target": {
-          "type": "string"
-        },
         "template": {
           "type": "string"
         },
         "wizard": {
           "type": "boolean"
         }
       },
-      "required": ["name", "label", "target", "template", "wizard"],
+      "required": ["name", "label", "template", "wizard"],
       "additionalProperties": false
     }
   }