@loopress/cli 0.28.0 → 0.29.0

package/oclif.manifest.json

@@ -729,6 +729,13 @@
         "$ lps acf pull --type field-groups"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -771,7 +778,7 @@
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -810,6 +817,13 @@
         "$ lps acf push --type field-groups"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -817,6 +831,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -852,6 +872,23 @@
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1093,7 +1130,7 @@
       "description": "Publish custom API routes to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.",
       "examples": [
         "$ lps api publish",
-        "$ lps api publish --path ./api"
+        "$ lps api publish ./api"
       ],
       "flags": {},
       "hasDynamicHelp": false,
@@ -1216,6 +1253,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -1245,6 +1288,22 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1254,7 +1313,9 @@
       ]
     },
     "api:rm": {
-      "aliases": [],
+      "aliases": [
+        "api:remove"
+      ],
       "args": {
         "filename": {
           "description": "The route file to remove, its slug without the .php extension (e.g. \"hello\" or \"invoice-pdf/[order_id]\")",
@@ -1265,7 +1326,7 @@
       "description": "Remove a custom API route file from WordPress",
       "examples": [
         "$ lps api rm hello",
-        "$ lps api rm hello --yes"
+        "$ lps api remove hello --yes"
       ],
       "flags": {
         "json": {
@@ -1419,37 +1480,38 @@
         "rollback.js"
       ]
     },
-    "app:list": {
+    "composer:init": {
       "aliases": [],
       "args": {},
-      "description": "List single-page apps deployed to WordPress",
+      "description": "Create a composer.json wired to WPackagist for installing WordPress.org plugins and themes",
       "examples": [
-        "$ lps app list"
+        "$ lps composer init",
+        "$ lps composer init --dry-run"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:list",
+      "id": "composer:init",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1470,21 +1532,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "app",
-        "list.js"
+        "composer",
+        "init.js"
       ]
     },
-    "app:pull": {
+    "composer:pull": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to apps directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull single-page app bundles from WordPress into local files",
+      "args": {},
+      "description": "Pull composer.json and composer.lock from WordPress",
       "examples": [
-        "$ lps app pull"
+        "$ lps composer pull",
+        "$ lps composer pull --dry-run"
       ],
       "flags": {
         "json": {
@@ -1507,18 +1565,11 @@
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:pull",
+      "id": "composer:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1544,23 +1595,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "app",
+        "composer",
         "pull.js"
       ]
     },
-    "app:push": {
+    "composer:push": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "Push only this app (defaults to every app in the directory)",
-          "name": "name"
-        }
-      },
-      "description": "Build and push single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a dist/ folder. When the app has a package.json with a `build` script, it runs first (use --no-build to skip it). Only files whose content changed are uploaded.",
+      "args": {},
+      "description": "Push composer.json to WordPress and run Composer to resolve and install dependencies",
       "examples": [
-        "$ lps app push",
-        "$ lps app push search",
-        "$ lps app push --no-build"
+        "$ lps composer push",
+        "$ lps composer push --dry-run"
       ],
       "flags": {
         "json": {
@@ -1577,10 +1622,10 @@
           "multiple": false,
           "type": "option"
         },
-        "build": {
-          "description": "Run the app's package.json build script before pushing",
-          "name": "build",
-          "allowNo": true,
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
           "type": "boolean"
         },
         "dry-run": {
@@ -1596,36 +1641,52 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "description": "Allow downgrades and take over plugins/themes installed outside Loopress",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:push",
+      "id": "composer:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "app",
+        "composer",
         "push.js"
       ]
     },
-    "app:remove": {
+    "app:list": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "App to remove from WordPress",
-          "name": "name",
-          "required": true
-        }
-      },
-      "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.",
+      "args": {},
+      "description": "List single-page apps deployed to WordPress",
       "examples": [
-        "$ lps app remove search"
+        "$ lps app list"
       ],
       "flags": {
         "json": {
@@ -1641,25 +1702,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:remove",
+      "id": "app:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1686,18 +1733,29 @@
         "dist",
         "commands",
         "app",
-        "remove.js"
+        "list.js"
       ]
     },
-    "composer:init": {
+    "app:pull": {
       "aliases": [],
-      "args": {},
-      "description": "Create a composer.json wired to WPackagist for installing WordPress.org plugins and themes",
+      "args": {
+        "path": {
+          "description": "Path to apps directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Pull single-page app bundles from WordPress into local files",
       "examples": [
-        "$ lps composer init",
-        "$ lps composer init --dry-run"
+        "$ lps app pull"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -1711,16 +1769,23 @@
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "composer:init",
+      "id": "app:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1741,17 +1806,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "composer",
-        "init.js"
+        "app",
+        "pull.js"
       ]
     },
-    "composer:pull": {
+    "app:push": {
       "aliases": [],
-      "args": {},
-      "description": "Pull composer.json and composer.lock from WordPress",
+      "args": {
+        "name": {
+          "description": "Push only this app (defaults to every app in the directory)",
+          "name": "name"
+        }
+      },
+      "description": "Build and push single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a dist/ folder. When the app has a package.json with a `build` script, it runs first (use --no-build to skip it). Only files whose content changed are uploaded.",
       "examples": [
-        "$ lps composer pull",
-        "$ lps composer pull --dry-run"
+        "$ lps app push",
+        "$ lps app push search",
+        "$ lps app push --no-build"
       ],
       "flags": {
         "json": {
@@ -1768,17 +1839,36 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "build": {
+          "description": "Run the app's package.json build script before pushing",
+          "name": "build",
+          "allowNo": true,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "composer:pull",
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1804,17 +1894,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "composer",
-        "pull.js"
+        "app",
+        "push.js"
       ]
     },
-    "composer:push": {
+    "app:remove": {
       "aliases": [],
-      "args": {},
-      "description": "Push composer.json to WordPress and run Composer to resolve and install dependencies",
+      "args": {
+        "name": {
+          "description": "App to remove from WordPress",
+          "name": "name",
+          "required": true
+        }
+      },
+      "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 composer push",
-        "$ lps composer push --dry-run"
+        "$ lps app remove search"
       ],
       "flags": {
         "json": {
@@ -1844,28 +1939,38 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "force": {
-          "description": "Allow downgrades and take over plugins/themes installed outside Loopress",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "composer:push",
+      "id": "app:remove",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "composer",
-        "push.js"
+        "app",
+        "remove.js"
       ]
     },
     "form:diff": {
@@ -2013,6 +2118,13 @@
         "$ lps form pull"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -2042,7 +2154,7 @@
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -2081,6 +2193,13 @@
         "$ lps form push --allow-notifications"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -2088,6 +2207,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -2116,6 +2241,23 @@
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -2214,19 +2356,19 @@
         "rollback.js"
       ]
     },
-    "menu:diff": {
+    "hook:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to menus directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Show what differs in nav menus and the active theme menu locations between your local files and a WordPress environment, or between two environments",
+      "description": "Show what differs in hook files between your local files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps menu diff",
-        "$ lps menu diff --env staging",
-        "$ lps menu diff --env staging --against production"
+        "$ lps hook diff",
+        "$ lps hook diff --env staging",
+        "$ lps hook diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -2253,7 +2395,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:diff",
+      "id": "hook:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2287,16 +2429,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "hook",
         "diff.js"
       ]
     },
-    "menu:list": {
+    "hook:list": {
       "aliases": [],
       "args": {},
-      "description": "List nav menus and the active theme menu locations on WordPress",
+      "description": "List hook files (actions, filters, cron) from WordPress",
       "examples": [
-        "$ lps menu list"
+        "$ lps hook list"
       ],
       "flags": {
         "json": {
@@ -2316,7 +2458,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:list",
+      "id": "hook:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2342,23 +2484,31 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "hook",
         "list.js"
       ]
     },
-    "menu:pull": {
+    "hook:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to menus directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull nav menus and the active theme menu locations from WordPress",
+      "description": "Pull hook files (actions, filters, cron) from WordPress",
       "examples": [
-        "$ lps menu pull"
+        "$ lps hook pull",
+        "$ lps hook pull --path ./hooks"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -2383,12 +2533,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:pull",
+      "id": "hook:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -2409,23 +2559,32 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "hook",
         "pull.js"
       ]
     },
-    "menu:push": {
+    "hook:push": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to menus directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Push local nav menus and the active theme menu locations to WordPress. Each menu's post_type/taxonomy items are resolved by slug on the target environment, never by a raw id; an item whose target does not exist there fails the whole menu rather than guessing.",
+      "description": "Push hook files (actions, filters, cron) to WordPress",
       "examples": [
-        "$ lps menu push"
+        "$ lps hook push",
+        "$ lps hook push --path ./hooks",
+        "$ lps hook push --prune"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -2433,6 +2592,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -2446,37 +2611,61 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "prune": {
+          "description": "Delete server-side hook files not present locally after pushing",
+          "name": "prune",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:push",
+      "id": "hook:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "hook",
         "push.js"
       ]
     },
-    "menu:rollback": {
-      "aliases": [],
+    "hook:rm": {
+      "aliases": [
+        "hook:remove"
+      ],
       "args": {
-        "path": {
-          "description": "Path to menus directory (overrides project config)",
-          "name": "path"
+        "filename": {
+          "description": "The hook file to remove, its slug without the .php extension (e.g. \"hello\" or \"invoice-pdf/[order_id]\")",
+          "name": "filename",
+          "required": true
         }
       },
-      "description": "Restore nav menus and menu locations to a snapshot taken automatically before an earlier `lps menu push`",
+      "description": "Remove a hook file (action, filter, cron) from WordPress",
       "examples": [
-        "$ lps menu rollback",
-        "$ lps menu rollback --list",
-        "$ lps menu rollback --to 1732000000000",
-        "$ lps menu rollback --dry-run"
+        "$ lps hook rm hello",
+        "$ lps hook remove hello --yes"
       ],
       "flags": {
         "json": {
@@ -2506,24 +2695,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "list": {
-          "description": "List available snapshots instead of rolling back",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "to": {
-          "description": "Roll back to this snapshot id instead of the most recent one",
-          "name": "to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:rollback",
+      "id": "hook:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2549,11 +2725,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
-        "rollback.js"
+        "hook",
+        "rm.js"
       ]
     },
-    "hook:diff": {
+    "hook:rollback": {
       "aliases": [],
       "args": {
         "path": {
@@ -2561,11 +2737,12 @@
           "name": "path"
         }
       },
-      "description": "Show what differs in hook files between your local files and a WordPress environment, or between two environments",
+      "description": "Restore hook files to a snapshot taken automatically before an earlier `lps hook push`",
       "examples": [
-        "$ lps hook diff",
-        "$ lps hook diff --env staging",
-        "$ lps hook diff --env staging --against production"
+        "$ lps hook rollback",
+        "$ lps hook rollback --list",
+        "$ lps hook rollback --to 1732000000000",
+        "$ lps hook rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -2582,23 +2759,43 @@
           "multiple": false,
           "type": "option"
         },
-        "against": {
-          "description": "Compare the primary environment against this second environment instead of against local files",
-          "name": "against",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "hook:diff",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "list": {
+          "description": "List available snapshots instead of rolling back",
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "to": {
+          "description": "Roll back to this snapshot id instead of the most recent one",
+          "name": "to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hook:rollback",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -2614,28 +2811,27 @@
           "type": "boolean"
         }
       },
-      "againstFlag": {
-        "against": {
-          "description": "Compare the primary environment against this second environment instead of against local files",
-          "input": [],
-          "multiple": false,
-          "type": "option"
-        }
-      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "hook",
-        "diff.js"
+        "rollback.js"
       ]
     },
-    "hook:list": {
+    "menu:diff": {
       "aliases": [],
-      "args": {},
-      "description": "List hook files (actions, filters, cron) from WordPress",
+      "args": {
+        "path": {
+          "description": "Path to menus directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Show what differs in nav menus and the active theme menu locations between your local files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps hook list"
+        "$ lps menu diff",
+        "$ lps menu diff --env staging",
+        "$ lps menu diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -2651,11 +2847,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "against": {
+          "description": "Compare the primary environment against this second environment instead of against local files",
+          "name": "against",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:list",
+      "id": "menu:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2677,26 +2880,28 @@
           "type": "boolean"
         }
       },
+      "againstFlag": {
+        "against": {
+          "description": "Compare the primary environment against this second environment instead of against local files",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "hook",
-        "list.js"
+        "menu",
+        "diff.js"
       ]
     },
-    "hook:pull": {
+    "menu:list": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to hooks directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull hook files (actions, filters, cron) from WordPress",
+      "args": {},
+      "description": "List nav menus and the active theme menu locations on WordPress",
       "examples": [
-        "$ lps hook pull",
-        "$ lps hook pull --path ./hooks"
+        "$ lps menu list"
       ],
       "flags": {
         "json": {
@@ -2712,25 +2917,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:pull",
+      "id": "menu:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2756,23 +2947,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
-        "pull.js"
+        "menu",
+        "list.js"
       ]
     },
-    "hook:push": {
+    "menu:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to menus directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Push hook files (actions, filters, cron) to WordPress",
+      "description": "Pull nav menus and the active theme menu locations from WordPress",
       "examples": [
-        "$ lps hook push",
-        "$ lps hook push --path ./hooks",
-        "$ lps hook push --prune"
+        "$ lps menu pull"
       ],
       "flags": {
         "json": {
@@ -2802,43 +2991,51 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "prune": {
-          "description": "Delete server-side hook files not present locally after pushing",
-          "name": "prune",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:push",
+      "id": "menu:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "hook",
-        "push.js"
+        "menu",
+        "pull.js"
       ]
     },
-    "hook:rm": {
+    "menu:push": {
       "aliases": [],
       "args": {
-        "filename": {
-          "description": "The hook file to remove, its slug without the .php extension (e.g. \"hello\" or \"invoice-pdf/[order_id]\")",
-          "name": "filename",
-          "required": true
+        "path": {
+          "description": "Path to menus directory (overrides project config)",
+          "name": "path"
         }
       },
-      "description": "Remove a hook file (action, filter, cron) from WordPress",
+      "description": "Push local nav menus and the active theme menu locations to WordPress. Each menu's post_type/taxonomy items are resolved by slug on the target environment, never by a raw id; an item whose target does not exist there fails the whole menu rather than guessing.",
       "examples": [
-        "$ lps hook rm hello",
-        "$ lps hook rm hello --yes"
+        "$ lps menu push"
       ],
       "flags": {
         "json": {
@@ -2855,6 +3052,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -2872,7 +3075,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:rm",
+      "id": "menu:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2898,24 +3101,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
-        "rm.js"
+        "menu",
+        "push.js"
       ]
     },
-    "hook:rollback": {
+    "menu:rollback": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to menus directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore hook files to a snapshot taken automatically before an earlier `lps hook push`",
+      "description": "Restore nav menus and menu locations to a snapshot taken automatically before an earlier `lps menu push`",
       "examples": [
-        "$ lps hook rollback",
-        "$ lps hook rollback --list",
-        "$ lps hook rollback --to 1732000000000",
-        "$ lps hook rollback --dry-run"
+        "$ lps menu rollback",
+        "$ lps menu rollback --list",
+        "$ lps menu rollback --to 1732000000000",
+        "$ lps menu rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -2962,7 +3165,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:rollback",
+      "id": "menu:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2988,7 +3191,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "menu",
         "rollback.js"
       ]
     },
@@ -3308,6 +3511,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -3331,6 +3540,22 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -3679,6 +3904,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -3702,6 +3933,22 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -3845,10 +4092,10 @@
     "plugin:pull": {
       "aliases": [],
       "args": {},
-      "description": "Pull installed plugins from WordPress into loopress.json, pinned to their live versions",
+      "description": "Pull installed plugins from WordPress into loopress.json (or composer.json), pinned to their live versions. Plugins already tracked are refreshed; new ones are offered as a list to tick, so plugins that only belong on this environment (cache, security, backups) stay out of the project.",
       "examples": [
         "$ lps plugin pull",
-        "$ lps plugin pull --dry-run"
+        "$ lps plugin pull --env production --plugin query-monitor"
       ],
       "flags": {
         "json": {
@@ -3871,6 +4118,20 @@
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "plugin": {
+          "description": "Start tracking this installed plugin too, without asking (repeatable)",
+          "name": "plugin",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -3929,6 +4190,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -3970,16 +4237,32 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "plugin",
-        "push.js"
-      ]
-    },
-    "plugin:status": {
-      "aliases": [],
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "push.js"
+      ]
+    },
+    "plugin:status": {
+      "aliases": [],
       "args": {},
       "description": "Compare the plugins on WordPress against loopress.json and report drift",
       "examples": [
@@ -4396,6 +4679,13 @@
         "$ lps seo pull --post-type post --post-type page"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -4432,7 +4722,7 @@
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -4471,6 +4761,13 @@
         "$ lps seo push --allow-external-redirects"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -4478,6 +4775,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -4506,6 +4809,23 @@
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -4747,7 +5067,7 @@
       "description": "Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.",
       "examples": [
         "$ lps snippet publish",
-        "$ lps snippet publish --path ./snippets"
+        "$ lps snippet publish ./snippets"
       ],
       "flags": {},
       "hasDynamicHelp": false,
@@ -4777,7 +5097,7 @@
       "description": "Pull snippets from WordPress",
       "examples": [
         "$ lps snippet pull",
-        "$ lps snippet pull --path ./snippets"
+        "$ lps snippet pull ./snippets"
       ],
       "flags": {
         "json": {
@@ -4852,7 +5172,7 @@
       "description": "Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.",
       "examples": [
         "$ lps snippet push",
-        "$ lps snippet push --path ./snippets"
+        "$ lps snippet push ./snippets"
       ],
       "flags": {
         "json": {
@@ -4869,6 +5189,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -4892,6 +5218,22 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -5038,14 +5380,19 @@
         "enable.js"
       ]
     },
-    "template:diff": {
+    "theme:add": {
       "aliases": [],
-      "args": {},
-      "description": "Show what differs in block templates and parts between your local files and a WordPress environment, or between two environments. Templates and parts edited in the Site Editor show up too.",
+      "args": {
+        "slug": {
+          "description": "Theme slug on WordPress.org",
+          "name": "slug",
+          "required": true
+        }
+      },
+      "description": "Add a WordPress.org theme to loopress.json",
       "examples": [
-        "$ lps template diff",
-        "$ lps template diff --env staging",
-        "$ lps template diff --env staging --against production"
+        "$ lps theme add generatepress",
+        "$ lps theme add generatepress --version 3.4.0"
       ],
       "flags": {
         "json": {
@@ -5062,9 +5409,16 @@
           "multiple": false,
           "type": "option"
         },
-        "against": {
-          "description": "Compare the primary environment against this second environment instead of against local files",
-          "name": "against",
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "version": {
+          "description": "Exact version to pin (default: \"latest\")",
+          "name": "version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -5072,7 +5426,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "template:diff",
+      "id": "theme:add",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5094,28 +5448,22 @@
           "type": "boolean"
         }
       },
-      "againstFlag": {
-        "against": {
-          "description": "Compare the primary environment against this second environment instead of against local files",
-          "input": [],
-          "multiple": false,
-          "type": "option"
-        }
-      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "template",
-        "diff.js"
+        "theme",
+        "add.js"
       ]
     },
-    "template:list": {
+    "theme:pull": {
       "aliases": [],
       "args": {},
-      "description": "Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor",
+      "description": "Pull everything theme related from WordPress: theme versions and Global Styles",
       "examples": [
-        "$ lps template list"
+        "$ lps theme pull",
+        "$ lps theme pull --env staging",
+        "$ lps theme pull --dry-run"
       ],
       "flags": {
         "json": {
@@ -5131,11 +5479,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "template:list",
+      "id": "theme:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5161,17 +5516,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "template",
-        "list.js"
+        "theme",
+        "pull.js"
       ]
     },
-    "template:push": {
+    "theme:push": {
       "aliases": [],
       "args": {},
-      "description": "Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it. It is never activated for you.",
+      "description": "Push everything theme related to WordPress: theme versions, templates and parts, then Global Styles",
       "examples": [
-        "$ lps template push",
-        "$ lps template push --dry-run"
+        "$ lps theme push",
+        "$ lps theme push --env staging",
+        "$ lps theme push --dry-run"
       ],
       "flags": {
         "json": {
@@ -5201,37 +5557,52 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "description": "Passed to `lps theme version push`",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "template:push",
+      "id": "theme:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "template",
+        "theme",
         "push.js"
       ]
     },
-    "theme:add": {
+    "theme:status": {
       "aliases": [],
-      "args": {
-        "slug": {
-          "description": "Theme slug on WordPress.org",
-          "name": "slug",
-          "required": true
-        }
-      },
-      "description": "Add a WordPress.org theme to loopress.json",
+      "args": {},
+      "description": "Compare the themes on WordPress against loopress.json and report version drift",
       "examples": [
-        "$ lps theme add generatepress",
-        "$ lps theme add generatepress --version 3.4.0"
+        "$ lps theme status"
       ],
       "flags": {
         "json": {
@@ -5247,17 +5618,67 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "theme:status",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
-          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "theme",
+        "status.js"
+      ]
+    },
+    "theme:template:diff": {
+      "aliases": [],
+      "args": {},
+      "description": "Show what differs in block templates and parts between your local files and a WordPress environment, or between two environments. Templates and parts edited in the Site Editor show up too.",
+      "examples": [
+        "$ lps theme template diff",
+        "$ lps theme template diff --env staging",
+        "$ lps theme template diff --env staging --against production"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
-        "version": {
-          "description": "Exact version to pin (default: \"latest\")",
-          "name": "version",
+        "env": {
+          "description": "Target environment by name, overriding the globally active one (lps project switch)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "against": {
+          "description": "Compare the primary environment against this second environment instead of against local files",
+          "name": "against",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -5265,7 +5686,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme:add",
+      "id": "theme:template:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5287,20 +5708,29 @@
           "type": "boolean"
         }
       },
+      "againstFlag": {
+        "against": {
+          "description": "Compare the primary environment against this second environment instead of against local files",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "theme",
-        "add.js"
+        "template",
+        "diff.js"
       ]
     },
-    "theme:pull": {
+    "theme:template:list": {
       "aliases": [],
       "args": {},
-      "description": "Pull installed themes from WordPress into loopress.json, pinned to their live versions",
+      "description": "Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor",
       "examples": [
-        "$ lps theme pull"
+        "$ lps theme template list"
       ],
       "flags": {
         "json": {
@@ -5316,18 +5746,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme:pull",
+      "id": "theme:template:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5354,16 +5777,17 @@
         "dist",
         "commands",
         "theme",
-        "pull.js"
+        "template",
+        "list.js"
       ]
     },
-    "theme:push": {
+    "theme:template:push": {
       "aliases": [],
       "args": {},
-      "description": "Install themes on WordPress to match loopress.json (versions only, never switches the active theme)",
+      "description": "Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it. It is never activated for you.",
       "examples": [
-        "$ lps theme push",
-        "$ lps theme push --force"
+        "$ lps theme template push",
+        "$ lps theme template push --dry-run"
       ],
       "flags": {
         "json": {
@@ -5380,6 +5804,12 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -5393,36 +5823,111 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "theme:template:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "theme",
+        "template",
+        "push.js"
+      ]
+    },
+    "theme:version:pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Pull installed themes from WordPress into loopress.json, pinned to their live versions",
+      "examples": [
+        "$ lps theme version pull"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "force": {
-          "description": "Allow downgrades and take over themes installed outside Loopress",
-          "name": "force",
+        "env": {
+          "description": "Target environment by name, overriding the globally active one (lps project switch)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme:push",
+      "id": "theme:version:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "theme",
-        "push.js"
+        "version",
+        "pull.js"
       ]
     },
-    "theme:status": {
+    "theme:version:push": {
       "aliases": [],
       "args": {},
-      "description": "Compare the themes on WordPress against loopress.json and report version drift",
+      "description": "Install themes on WordPress to match loopress.json (versions only, never switches the active theme)",
       "examples": [
-        "$ lps theme status"
+        "$ lps theme version push",
+        "$ lps theme version push --force"
       ],
       "flags": {
         "json": {
@@ -5438,11 +5943,37 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Allow downgrades and take over themes installed outside Loopress",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme:status",
+      "id": "theme:version:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5469,7 +6000,8 @@
         "dist",
         "commands",
         "theme",
-        "status.js"
+        "version",
+        "push.js"
       ]
     },
     "theme:style:diff": {
@@ -5563,6 +6095,13 @@
         "$ lps theme style pull"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -5585,7 +6124,7 @@
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -5624,6 +6163,13 @@
         "$ lps theme style push"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -5631,12 +6177,25 @@
           "multiple": false,
           "type": "option"
         },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -5646,6 +6205,23 @@
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -5747,5 +6323,5 @@
       ]
     }
   },
-  "version": "0.28.0"
+  "version": "0.29.0"
 }