@loopress/cli 0.21.0 → 0.23.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.21.0 linux-x64 node-v24.18.0
+@loopress/cli/0.23.0 linux-x64 node-v24.20.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -54,6 +54,10 @@ report.
 * [`lps api publish [PATH]`](#lps-api-publish-path)
 * [`lps api pull [PATH]`](#lps-api-pull-path)
 * [`lps api push [PATH]`](#lps-api-push-path)
+* [`lps app list`](#lps-app-list)
+* [`lps app pull [PATH]`](#lps-app-pull-path)
+* [`lps app push [NAME]`](#lps-app-push-name)
+* [`lps app remove NAME`](#lps-app-remove-name)
 * [`lps composer init`](#lps-composer-init)
 * [`lps composer pull`](#lps-composer-pull)
 * [`lps composer push`](#lps-composer-push)
@@ -70,8 +74,10 @@ report.
 * [`lps page pull [PATH]`](#lps-page-pull-path)
 * [`lps page push [PATH]`](#lps-page-push-path)
 * [`lps plugin add SLUG`](#lps-plugin-add-slug)
+* [`lps plugin audit`](#lps-plugin-audit)
 * [`lps plugin pull`](#lps-plugin-pull)
 * [`lps plugin push`](#lps-plugin-push)
+* [`lps plugin status`](#lps-plugin-status)
 * [`lps project config`](#lps-project-config)
 * [`lps project list`](#lps-project-list)
 * [`lps project pull`](#lps-project-pull)
@@ -79,6 +85,9 @@ report.
 * [`lps project remove`](#lps-project-remove)
 * [`lps project rotate`](#lps-project-rotate)
 * [`lps project switch`](#lps-project-switch)
+* [`lps promote FROM TO`](#lps-promote-from-to)
+* [`lps pull`](#lps-pull)
+* [`lps push`](#lps-push)
 * [`lps seo list`](#lps-seo-list)
 * [`lps seo pull [PATH]`](#lps-seo-pull-path)
 * [`lps seo push [PATH]`](#lps-seo-push-path)
@@ -89,6 +98,11 @@ report.
 * [`lps status`](#lps-status)
 * [`lps telemetry disable`](#lps-telemetry-disable)
 * [`lps telemetry enable`](#lps-telemetry-enable)
+* [`lps theme add SLUG`](#lps-theme-add-slug)
+* [`lps theme pull`](#lps-theme-pull)
+* [`lps theme push`](#lps-theme-push)
+* [`lps theme status`](#lps-theme-status)
+* [`lps validate`](#lps-validate)
 
 ## `lps acf list`
 
@@ -96,13 +110,15 @@ List ACF field groups, post types, taxonomies, and options pages from WordPress
 
 ```
 USAGE
-  $ lps acf list [--env <value>] [-j] [--type field-groups|post-types|taxonomies|options-pages...]
+  $ lps acf list [--json] [--env <value>] [--type field-groups|post-types|taxonomies|options-pages...]
 
 FLAGS
-  -j, --json              Output in JSON format
-      --env=<value>       Target environment by name, overriding the globally active one (lps project switch)
-      --type=<option>...  Limit to specific ACF object types
-                          <options: field-groups|post-types|taxonomies|options-pages>
+  --env=<value>       Target environment by name, overriding the globally active one (lps project switch)
+  --type=<option>...  Limit to specific ACF object types
+                      <options: field-groups|post-types|taxonomies|options-pages>
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
   List ACF field groups, post types, taxonomies, and options pages from WordPress
@@ -113,7 +129,7 @@ EXAMPLES
   $ lps acf list --type field-groups
 ```
 
-_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/acf/list.ts)_
+_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/acf/list.ts)_
 
 ## `lps acf pull [PATH]`
 
@@ -142,7 +158,7 @@ EXAMPLES
   $ lps acf pull --type field-groups
 ```
 
-_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/acf/pull.ts)_
+_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/acf/pull.ts)_
 
 ## `lps acf push [PATH]`
 
@@ -171,7 +187,7 @@ EXAMPLES
   $ lps acf push --type field-groups
 ```
 
-_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/acf/push.ts)_
+_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/acf/push.ts)_
 
 ## `lps api list`
 
@@ -194,7 +210,7 @@ EXAMPLES
   $ lps api list
 ```
 
-_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/api/list.ts)_
+_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/api/list.ts)_
 
 ## `lps api publish [PATH]`
 
@@ -217,7 +233,7 @@ EXAMPLES
   $ lps api publish --path ./api
 ```
 
-_See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/api/publish.ts)_
+_See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/api/publish.ts)_
 
 ## `lps api pull [PATH]`
 
@@ -247,7 +263,7 @@ EXAMPLES
   $ lps api pull --path ./api
 ```
 
-_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/api/pull.ts)_
+_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/api/pull.ts)_
 
 ## `lps api push [PATH]`
 
@@ -277,7 +293,118 @@ EXAMPLES
   $ lps api push --path ./api
 ```
 
-_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/api/push.ts)_
+_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/api/push.ts)_
+
+## `lps app list`
+
+List single-page apps deployed to WordPress
+
+```
+USAGE
+  $ lps app list [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List single-page apps deployed to WordPress
+
+EXAMPLES
+  $ lps app list
+```
+
+_See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/app/list.ts)_
+
+## `lps app pull [PATH]`
+
+Pull single-page app bundles from WordPress into local files
+
+```
+USAGE
+  $ lps app pull [PATH] [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  [PATH]  Path to apps directory (overrides project config)
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Pull single-page app bundles from WordPress into local files
+
+EXAMPLES
+  $ lps app pull
+```
+
+_See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/app/pull.ts)_
+
+## `lps app push [NAME]`
+
+Push built single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a built dist/ folder. Only files whose content changed are uploaded.
+
+```
+USAGE
+  $ lps app push [NAME] [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  [NAME]  Push only this app (defaults to every app in the directory)
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Push built single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json
+  and a built dist/ folder. Only files whose content changed are uploaded.
+
+EXAMPLES
+  $ lps app push
+
+  $ lps app push search
+```
+
+_See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/app/push.ts)_
+
+## `lps app remove NAME`
+
+Remove a single-page app from WordPress: deletes its bundle from wp-content/loopress/apps/ and unregisters the shortcode. Local files are left untouched.
+
+```
+USAGE
+  $ lps app remove NAME [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  NAME  App to remove from WordPress
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Remove a single-page app from WordPress: deletes its bundle from wp-content/loopress/apps/ and unregisters the
+  shortcode. Local files are left untouched.
+
+EXAMPLES
+  $ lps app remove search
+```
+
+_See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/app/remove.ts)_
 
 ## `lps composer init`
 
@@ -300,7 +427,7 @@ EXAMPLES
   $ lps composer init --dry-run
 ```
 
-_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/composer/init.ts)_
+_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/composer/init.ts)_
 
 ## `lps composer pull`
 
@@ -326,26 +453,27 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
-Push composer.json and composer.lock to WordPress and run composer install
+Push composer.json (and composer.lock, if present) to WordPress and run Composer
 
 ```
 USAGE
-  $ lps composer push [--json] [--env <value>] [-d] [-y]
+  $ lps composer push [--json] [--env <value>] [-d] [-y] [--force]
 
 FLAGS
   -d, --dry-run      Show what would change without making changes
   -y, --yes          Answer yes to confirmation prompts
       --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+      --force        Allow downgrades and take over plugins/themes installed outside Loopress
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Push composer.json and composer.lock to WordPress and run composer install
+  Push composer.json (and composer.lock, if present) to WordPress and run Composer
 
 EXAMPLES
   $ lps composer push
@@ -353,7 +481,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/composer/push.ts)_
 
 ## `lps dev`
 
@@ -379,7 +507,7 @@ EXAMPLES
   $ lps dev --skip=plugins
 ```
 
-_See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/dev.ts)_
+_See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/dev.ts)_
 
 ## `lps doctor`
 
@@ -401,7 +529,7 @@ EXAMPLES
   $ lps doctor --env production
 ```
 
-_See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/doctor.ts)_
+_See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/doctor.ts)_
 
 ## `lps form list`
 
@@ -409,11 +537,13 @@ List forms from WordPress
 
 ```
 USAGE
-  $ lps form list [--env <value>] [-j]
+  $ lps form list [--json] [--env <value>]
 
 FLAGS
-  -j, --json         Output in JSON format
-      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
   List forms from WordPress
@@ -422,7 +552,7 @@ EXAMPLES
   $ lps form list
 ```
 
-_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/form/list.ts)_
+_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/form/list.ts)_
 
 ## `lps form pull [PATH]`
 
@@ -447,7 +577,7 @@ EXAMPLES
   $ lps form pull
 ```
 
-_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/form/pull.ts)_
+_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/form/pull.ts)_
 
 ## `lps form push [PATH]`
 
@@ -473,7 +603,7 @@ EXAMPLES
   $ lps form push
 ```
 
-_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/form/push.ts)_
+_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/form/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -493,7 +623,7 @@ DESCRIPTION
   Display help for lps.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.56/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/7.0.0/src/commands/help.ts)_
 
 ## `lps init`
 
@@ -510,7 +640,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -527,7 +657,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -544,7 +674,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/logout.ts)_
 
 ## `lps page list`
 
@@ -567,7 +697,7 @@ EXAMPLES
   $ lps page list
 ```
 
-_See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/page/list.ts)_
+_See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/page/list.ts)_
 
 ## `lps page pull [PATH]`
 
@@ -595,7 +725,7 @@ EXAMPLES
   $ lps page pull
 ```
 
-_See code: [src/commands/page/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/page/pull.ts)_
+_See code: [src/commands/page/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/page/pull.ts)_
 
 ## `lps page push [PATH]`
 
@@ -623,7 +753,7 @@ EXAMPLES
   $ lps page push
 ```
 
-_See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/page/push.ts)_
+_See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/page/push.ts)_
 
 ## `lps plugin add SLUG`
 
@@ -631,14 +761,15 @@ Add a WordPress.org plugin to loopress.json
 
 ```
 USAGE
-  $ lps plugin add SLUG [--env <value>] [-d]
+  $ lps plugin add SLUG [--env <value>] [-d] [--version <value>]
 
 ARGUMENTS
   SLUG  Plugin slug on WordPress.org
 
 FLAGS
-  -d, --dry-run      Show what would change without making changes
-      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+  -d, --dry-run          Show what would change without making changes
+      --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+      --version=<value>  Exact version to pin (default: "latest", tracked on every push)
 
 DESCRIPTION
   Add a WordPress.org plugin to loopress.json
@@ -646,14 +777,39 @@ DESCRIPTION
 EXAMPLES
   $ lps plugin add woocommerce
 
+  $ lps plugin add woocommerce --version 9.4.2
+
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/plugin/add.ts)_
+
+## `lps plugin audit`
+
+Check the plugins in loopress.json for known vulnerabilities and health issues
+
+```
+USAGE
+  $ lps plugin audit [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Check the plugins in loopress.json for known vulnerabilities and health issues
+
+EXAMPLES
+  $ lps plugin audit
+```
+
+_See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/plugin/audit.ts)_
 
 ## `lps plugin pull`
 
-Pull installed plugins from WordPress into loopress.json
+Pull installed plugins from WordPress into loopress.json, pinned to their live versions
 
 ```
 USAGE
@@ -667,7 +823,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Pull installed plugins from WordPress into loopress.json
+  Pull installed plugins from WordPress into loopress.json, pinned to their live versions
 
 EXAMPLES
   $ lps plugin pull
@@ -675,34 +831,61 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
-Push plugins to WordPress to match loopress.json
+Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist
 
 ```
 USAGE
-  $ lps plugin push [--json] [--env <value>] [-d] [-y]
+  $ lps plugin push [--json] [--env <value>] [-d] [-y] [--force] [--prune]
 
 FLAGS
   -d, --dry-run      Show what would change without making changes
   -y, --yes          Answer yes to confirmation prompts
       --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+      --force        Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)
+      --prune        Deactivate plugins that are active on the site but absent from loopress.json
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Push plugins to WordPress to match loopress.json
+  Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist
 
 EXAMPLES
   $ lps plugin push
 
   $ lps plugin push --dry-run
+
+  $ lps plugin push --force --prune
+```
+
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/plugin/push.ts)_
+
+## `lps plugin status`
+
+Compare the plugins on WordPress against loopress.json and report drift
+
+```
+USAGE
+  $ lps plugin status [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Compare the plugins on WordPress against loopress.json and report drift
+
+EXAMPLES
+  $ lps plugin status
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/plugin/status.ts)_
 
 ## `lps project config`
 
@@ -720,7 +903,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -728,7 +911,10 @@ List configured WordPress projects
 
 ```
 USAGE
-  $ lps project list
+  $ lps project list [--json]
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
   List configured WordPress projects
@@ -737,7 +923,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/project/list.ts)_
 
 ## `lps project pull`
 
@@ -754,7 +940,7 @@ EXAMPLES
   $ lps project pull
 ```
 
-_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/project/pull.ts)_
+_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/project/pull.ts)_
 
 ## `lps project push`
 
@@ -774,7 +960,7 @@ EXAMPLES
   $ lps project push
 ```
 
-_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/project/push.ts)_
+_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/project/push.ts)_
 
 ## `lps project remove`
 
@@ -791,7 +977,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/project/remove.ts)_
 
 ## `lps project rotate`
 
@@ -813,7 +999,7 @@ EXAMPLES
   $ lps project rotate --env staging
 ```
 
-_See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/project/rotate.ts)_
+_See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/project/rotate.ts)_
 
 ## `lps project switch`
 
@@ -830,7 +1016,87 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/project/switch.ts)_
+
+## `lps promote FROM TO`
+
+Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked files are overwritten with <from> in the process.
+
+```
+USAGE
+  $ lps promote FROM TO [-d] [-y]
+
+ARGUMENTS
+  FROM  Environment to copy the configuration from
+  TO    Environment to copy the configuration to
+
+FLAGS
+  -d, --dry-run  Show what would change without making changes
+  -y, --yes      Answer yes to confirmation prompts
+
+DESCRIPTION
+  Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked
+  files are overwritten with <from> in the process.
+
+EXAMPLES
+  $ lps promote staging production
+
+  $ lps promote production staging --dry-run
+```
+
+_See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/promote.ts)_
+
+## `lps pull`
+
+Pull all content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, from WordPress
+
+```
+USAGE
+  $ lps pull [--env <value>] [-d] [-y]
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+DESCRIPTION
+  Pull all content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, from WordPress
+
+EXAMPLES
+  $ lps pull
+
+  $ lps pull --env staging
+
+  $ lps pull --dry-run
+```
+
+_See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/pull.ts)_
+
+## `lps push`
+
+Push all local content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, to WordPress
+
+```
+USAGE
+  $ lps push [--env <value>] [-d] [-y]
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+DESCRIPTION
+  Push all local content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, to WordPress
+
+EXAMPLES
+  $ lps push
+
+  $ lps push --env staging
+
+  $ lps push --dry-run
+```
+
+_See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/push.ts)_
 
 ## `lps seo list`
 
@@ -838,12 +1104,14 @@ List posts with SEO meta, and redirects if supported by the active SEO plugin, o
 
 ```
 USAGE
-  $ lps seo list [--env <value>] [-j] [--post-type <value>...]
+  $ lps seo list [--json] [--env <value>] [--post-type <value>...]
 
 FLAGS
-  -j, --json                  Output in JSON format
-      --env=<value>           Target environment by name, overriding the globally active one (lps project switch)
-      --post-type=<value>...  Limit to specific post types
+  --env=<value>           Target environment by name, overriding the globally active one (lps project switch)
+  --post-type=<value>...  Limit to specific post types
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
   List posts with SEO meta, and redirects if supported by the active SEO plugin, on WordPress
@@ -854,7 +1122,7 @@ EXAMPLES
   $ lps seo list --post-type post
 ```
 
-_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/seo/list.ts)_
+_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/seo/list.ts)_
 
 ## `lps seo pull [PATH]`
 
@@ -882,7 +1150,7 @@ EXAMPLES
   $ lps seo pull --post-type post --post-type page
 ```
 
-_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/seo/pull.ts)_
+_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/seo/pull.ts)_
 
 ## `lps seo push [PATH]`
 
@@ -908,7 +1176,7 @@ EXAMPLES
   $ lps seo push
 ```
 
-_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/seo/push.ts)_
+_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/seo/push.ts)_
 
 ## `lps snippet list`
 
@@ -931,7 +1199,7 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet publish [PATH]`
 
@@ -954,7 +1222,7 @@ EXAMPLES
   $ lps snippet publish --path ./snippets
 ```
 
-_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/snippet/publish.ts)_
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -984,7 +1252,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -1015,7 +1283,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -1040,7 +1308,7 @@ EXAMPLES
   $ lps status --env staging
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/status.ts)_
 
 ## `lps telemetry disable`
 
@@ -1057,7 +1325,7 @@ EXAMPLES
   $ lps telemetry disable
 ```
 
-_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/telemetry/disable.ts)_
+_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/telemetry/disable.ts)_
 
 ## `lps telemetry enable`
 
@@ -1074,5 +1342,127 @@ EXAMPLES
   $ lps telemetry enable
 ```
 
-_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.21.0/src/commands/telemetry/enable.ts)_
+_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/telemetry/enable.ts)_
+
+## `lps theme add SLUG`
+
+Add a WordPress.org theme to loopress.json
+
+```
+USAGE
+  $ lps theme add SLUG [--env <value>] [-d] [--version <value>]
+
+ARGUMENTS
+  SLUG  Theme slug on WordPress.org
+
+FLAGS
+  -d, --dry-run          Show what would change without making changes
+      --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+      --version=<value>  Exact version to pin (default: "latest")
+
+DESCRIPTION
+  Add a WordPress.org theme to loopress.json
+
+EXAMPLES
+  $ lps theme add generatepress
+
+  $ lps theme add generatepress --version 3.4.0
+```
+
+_See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/theme/add.ts)_
+
+## `lps theme pull`
+
+Pull installed themes from WordPress into loopress.json, pinned to their live versions
+
+```
+USAGE
+  $ lps theme pull [--json] [--env <value>] [-d]
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Pull installed themes from WordPress into loopress.json, pinned to their live versions
+
+EXAMPLES
+  $ lps theme pull
+```
+
+_See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/theme/pull.ts)_
+
+## `lps theme push`
+
+Install themes on WordPress to match loopress.json (versions only, never switches the active theme)
+
+```
+USAGE
+  $ lps theme push [--json] [--env <value>] [-d] [-y] [--force]
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+      --force        Allow downgrades and take over themes installed outside Loopress
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Install themes on WordPress to match loopress.json (versions only, never switches the active theme)
+
+EXAMPLES
+  $ lps theme push
+
+  $ lps theme push --force
+```
+
+_See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/theme/push.ts)_
+
+## `lps theme status`
+
+Compare the themes on WordPress against loopress.json and report version drift
+
+```
+USAGE
+  $ lps theme status [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Compare the themes on WordPress against loopress.json and report version drift
+
+EXAMPLES
+  $ lps theme status
+```
+
+_See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/theme/status.ts)_
+
+## `lps validate`
+
+Check local tracked files are well formed and push-ready, without contacting WordPress
+
+```
+USAGE
+  $ lps validate [--json]
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Check local tracked files are well formed and push-ready, without contacting WordPress
+
+EXAMPLES
+  $ lps validate
+```
+
+_See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/v0.23.0/src/commands/validate.ts)_
 <!-- commandsstop -->