@loopress/cli 0.34.0 → 0.35.0

package/oclif.manifest.json

@@ -1246,36 +1246,6 @@
         "list.js"
       ]
     },
-    "api:publish": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to api directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "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 ./api"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "api:publish",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "api",
-        "publish.js"
-      ]
-    },
     "api:pull": {
       "aliases": [],
       "args": {
@@ -1645,97 +1615,12 @@
         "rollback.js"
       ]
     },
-    "block:diff": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to blocks directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Show what differs in dynamic blocks between your local blocks/ folders and a WordPress environment, or between two environments",
-      "examples": [
-        "$ lps block diff",
-        "$ lps block diff --env staging",
-        "$ lps block diff --env staging --against production"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "env": {
-          "description": "Target environment by name (default: \"local\", or the project's only environment)",
-          "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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "block: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",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "honorsExclude": true,
-      "skipUnsupportedFlag": {
-        "skip-unsupported": {
-          "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "yesFlag": {
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "allowNo": false,
-          "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",
-        "block",
-        "diff.js"
-      ]
-    },
-    "block:list": {
+    "app:list": {
       "aliases": [],
       "args": {},
-      "description": "List the dynamic blocks Loopress registers on WordPress (loopress/<slug>), with their load and render errors",
+      "description": "List single-page apps deployed to WordPress",
       "examples": [
-        "$ lps block list"
+        "$ lps app list"
       ],
       "flags": {
         "json": {
@@ -1755,7 +1640,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "block:list",
+      "id": "app:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1789,21 +1674,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "block",
+        "app",
         "list.js"
       ]
     },
-    "block:pull": {
+    "app:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to blocks directory (overrides project config)",
+          "description": "Path to apps directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull the dynamic blocks Loopress registers on WordPress into blocks/<slug>/ folders",
+      "description": "Pull single-page app bundles from WordPress into local files",
       "examples": [
-        "$ lps block pull"
+        "$ lps app pull"
       ],
       "flags": {
         "json": {
@@ -1837,7 +1722,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "block:pull",
+      "id": "app:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1871,22 +1756,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "block",
+        "app",
         "pull.js"
       ]
     },
-    "block:push": {
+    "app:push": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to blocks directory (overrides project config)",
-          "name": "path"
+        "name": {
+          "description": "Push only this app (defaults to every app in the directory)",
+          "name": "name"
         }
       },
-      "description": "Push local dynamic blocks (blocks/<slug>/ holding block.json, render.php, and optionally style.css and view.js) to WordPress, registered as loopress/<slug> and placed with <!-- wp:loopress/<slug> /-->. Each block is replaced as a whole. Create or update only, never deletes a block (use `lps block rm`).",
+      "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 block push",
-        "$ lps block push --dry-run"
+        "$ lps app push",
+        "$ lps app push search",
+        "$ lps app push --no-build"
       ],
       "flags": {
         "json": {
@@ -1915,6 +1801,12 @@
           "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",
@@ -1932,7 +1824,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "block:push",
+      "id": "app:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1966,25 +1858,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "block",
+        "app",
         "push.js"
       ]
     },
-    "block:rm": {
+    "app:rm": {
       "aliases": [
-        "block:remove"
+        "app:remove"
       ],
       "args": {
-        "slug": {
-          "description": "The block to remove, its blocks/ folder name (e.g. \"hero\")",
-          "name": "slug",
+        "name": {
+          "description": "App to remove from WordPress",
+          "name": "name",
           "required": true
         }
       },
-      "description": "Remove a dynamic block from WordPress. A <!-- wp:loopress/<slug> /--> left in a page or template renders nothing until it is pushed again. Local files are left untouched.",
+      "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 block rm hero",
-        "$ lps block rm hero --yes"
+        "$ lps app rm search"
       ],
       "flags": {
         "json": {
@@ -2018,7 +1909,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "block:rm",
+      "id": "app:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2052,11 +1943,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "block",
+        "app",
         "rm.js"
       ]
     },
-    "block:rollback": {
+    "block:diff": {
       "aliases": [],
       "args": {
         "path": {
@@ -2064,12 +1955,11 @@
           "name": "path"
         }
       },
-      "description": "Restore dynamic blocks to a snapshot taken automatically before an earlier `lps block push`",
+      "description": "Show what differs in dynamic blocks between your local blocks/ folders and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps block rollback",
-        "$ lps block rollback --list",
-        "$ lps block rollback --to 1732000000000",
-        "$ lps block rollback --dry-run"
+        "$ lps block diff",
+        "$ lps block diff --env staging",
+        "$ lps block diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -2086,29 +1976,9 @@
           "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"
-        },
-        "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",
+        "against": {
+          "description": "Compare the primary environment against this second environment instead of against local files",
+          "name": "against",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2116,7 +1986,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "block:rollback",
+      "id": "block:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2130,7 +2000,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": false,
+      "honorsExclude": true,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -2146,20 +2016,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",
         "block",
-        "rollback.js"
+        "diff.js"
       ]
     },
-    "app:list": {
+    "block:list": {
       "aliases": [],
       "args": {},
-      "description": "List single-page apps deployed to WordPress",
+      "description": "List the dynamic blocks Loopress registers on WordPress (loopress/<slug>), with their load and render errors",
       "examples": [
-        "$ lps app list"
+        "$ lps block list"
       ],
       "flags": {
         "json": {
@@ -2179,7 +2057,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:list",
+      "id": "block:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2213,21 +2091,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "app",
+        "block",
         "list.js"
       ]
     },
-    "app:pull": {
+    "block:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to apps directory (overrides project config)",
+          "description": "Path to blocks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull single-page app bundles from WordPress into local files",
+      "description": "Pull the dynamic blocks Loopress registers on WordPress into blocks/<slug>/ folders",
       "examples": [
-        "$ lps app pull"
+        "$ lps block pull"
       ],
       "flags": {
         "json": {
@@ -2261,7 +2139,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:pull",
+      "id": "block:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2295,23 +2173,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "app",
+        "block",
         "pull.js"
       ]
     },
-    "app:push": {
+    "block:push": {
       "aliases": [],
       "args": {
-        "name": {
-          "description": "Push only this app (defaults to every app in the directory)",
-          "name": "name"
+        "path": {
+          "description": "Path to blocks directory (overrides project config)",
+          "name": "path"
         }
       },
-      "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.",
+      "description": "Push local dynamic blocks (blocks/<slug>/ holding block.json, render.php, and optionally style.css and view.js) to WordPress, registered as loopress/<slug> and placed with <!-- wp:loopress/<slug> /-->. Each block is replaced as a whole. Create or update only, never deletes a block (use `lps block rm`).",
       "examples": [
-        "$ lps app push",
-        "$ lps app push search",
-        "$ lps app push --no-build"
+        "$ lps block push",
+        "$ lps block push --dry-run"
       ],
       "flags": {
         "json": {
@@ -2340,12 +2217,6 @@
           "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",
@@ -2363,7 +2234,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:push",
+      "id": "block:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2397,24 +2268,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "app",
+        "block",
         "push.js"
       ]
     },
-    "app:rm": {
+    "block:rm": {
       "aliases": [
-        "app:remove"
+        "block:remove"
       ],
       "args": {
-        "name": {
-          "description": "App to remove from WordPress",
-          "name": "name",
+        "slug": {
+          "description": "The block to remove, its blocks/ folder name (e.g. \"hero\")",
+          "name": "slug",
           "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.",
+      "description": "Remove a dynamic block from WordPress. A <!-- wp:loopress/<slug> /--> left in a page or template renders nothing until it is pushed again. Local files are left untouched.",
       "examples": [
-        "$ lps app rm search"
+        "$ lps block rm hero",
+        "$ lps block rm hero --yes"
       ],
       "flags": {
         "json": {
@@ -2448,7 +2320,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:rm",
+      "id": "block:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2482,10 +2354,108 @@
       "relativePath": [
         "dist",
         "commands",
-        "app",
+        "block",
         "rm.js"
       ]
     },
+    "block:rollback": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to blocks directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Restore dynamic blocks to a snapshot taken automatically before an earlier `lps block push`",
+      "examples": [
+        "$ lps block rollback",
+        "$ lps block rollback --list",
+        "$ lps block rollback --to 1732000000000",
+        "$ lps block rollback --dry-run"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "env": {
+          "description": "Target environment by name (default: \"local\", or the project's only environment)",
+          "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"
+        },
+        "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": "block: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",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "honorsExclude": false,
+      "skipUnsupportedFlag": {
+        "skip-unsupported": {
+          "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "block",
+        "rollback.js"
+      ]
+    },
     "composer:init": {
       "aliases": [],
       "args": {},
@@ -3738,19 +3708,19 @@
         "rollback.js"
       ]
     },
-    "meta:diff": {
+    "hook:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to meta directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Show what differs in post meta keys between your local meta/ 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 meta diff",
-        "$ lps meta diff --env staging",
-        "$ lps meta diff --env staging --against production"
+        "$ lps hook diff",
+        "$ lps hook diff --env staging",
+        "$ lps hook diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -3777,7 +3747,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "meta:diff",
+      "id": "hook:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -3819,16 +3789,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "meta",
+        "hook",
         "diff.js"
       ]
     },
-    "meta:list": {
+    "hook:list": {
       "aliases": [],
       "args": {},
-      "description": "List the meta keys registered for each post type on WordPress (with register_post_meta()), and whether Loopress declares them. Only Loopress ones are pulled and pushed.",
+      "description": "List hook files (actions, filters, cron) currently on WordPress",
       "examples": [
-        "$ lps meta list"
+        "$ lps hook list"
       ],
       "flags": {
         "json": {
@@ -3848,7 +3818,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "meta:list",
+      "id": "hook:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -3882,21 +3852,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "meta",
+        "hook",
         "list.js"
       ]
     },
-    "meta:pull": {
+    "hook:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to the meta directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull the post meta keys Loopress manages on WordPress into meta/<post-type>.json files, never their values. Keys registered by a theme or another plugin are never pulled, see `lps meta list`.",
+      "description": "Pull hook files (actions, filters, cron) from WordPress into local files",
       "examples": [
-        "$ lps meta pull"
+        "$ lps hook pull",
+        "$ lps hook pull ./hooks"
       ],
       "flags": {
         "json": {
@@ -3930,7 +3901,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "meta:pull",
+      "id": "hook:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -3964,21 +3935,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "meta",
+        "hook",
         "pull.js"
       ]
     },
-    "meta:push": {
+    "hook:push": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to the meta directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Push local post meta keys (meta/<post-type>.json, each key mapped to its register_post_meta() arguments) to WordPress. Create or update only, never deletes (use `lps meta rm`), never touches meta values.",
+      "description": "Push local hook files (actions, filters, cron) to WordPress",
       "examples": [
-        "$ lps meta push"
+        "$ lps hook push",
+        "$ lps hook push ./hooks",
+        "$ lps hook push --prune"
       ],
       "flags": {
         "json": {
@@ -4020,11 +3993,17 @@
           "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": "meta:push",
+      "id": "hook:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4058,25 +4037,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "meta",
+        "hook",
         "push.js"
       ]
     },
-    "meta:rm": {
+    "hook:rm": {
       "aliases": [
-        "meta:remove"
+        "hook:remove"
       ],
       "args": {
-        "slug": {
-          "description": "The post meta slug, its meta/ file name without .json",
-          "name": "slug",
+        "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": "Stop registering the Loopress meta keys of one post type (its meta/<post-type>.json file) on WordPress. Their values are kept in the database.",
+      "description": "Remove one hook file (action, filter, cron) from WordPress",
       "examples": [
-        "$ lps meta rm <slug>",
-        "$ lps meta remove <slug> --yes"
+        "$ lps hook rm hello",
+        "$ lps hook remove hello --yes"
       ],
       "flags": {
         "json": {
@@ -4110,7 +4089,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "meta:rm",
+      "id": "hook:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4144,24 +4123,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "meta",
+        "hook",
         "rm.js"
       ]
     },
-    "meta:rollback": {
+    "hook:rollback": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to meta directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore post meta keys to a snapshot taken automatically before an earlier `lps meta push`",
+      "description": "Restore hook files to a snapshot taken automatically before an earlier `lps hook push`",
       "examples": [
-        "$ lps meta rollback",
-        "$ lps meta rollback --list",
-        "$ lps meta rollback --to 1732000000000",
-        "$ lps meta rollback --dry-run"
+        "$ lps hook rollback",
+        "$ lps hook rollback --list",
+        "$ lps hook rollback --to 1732000000000",
+        "$ lps hook rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -4208,7 +4187,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "meta:rollback",
+      "id": "hook:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4242,23 +4221,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "meta",
+        "hook",
         "rollback.js"
       ]
     },
-    "hook:diff": {
+    "meta:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to meta directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Show what differs in hook files between your local files and a WordPress environment, or between two environments",
+      "description": "Show what differs in post meta keys between your local meta/ files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps hook diff",
-        "$ lps hook diff --env staging",
-        "$ lps hook diff --env staging --against production"
+        "$ lps meta diff",
+        "$ lps meta diff --env staging",
+        "$ lps meta diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -4285,7 +4264,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:diff",
+      "id": "meta:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4327,16 +4306,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "meta",
         "diff.js"
       ]
     },
-    "hook:list": {
+    "meta:list": {
       "aliases": [],
       "args": {},
-      "description": "List hook files (actions, filters, cron) currently on WordPress",
+      "description": "List the meta keys registered for each post type on WordPress (with register_post_meta()), and whether Loopress declares them. Only Loopress ones are pulled and pushed.",
       "examples": [
-        "$ lps hook list"
+        "$ lps meta list"
       ],
       "flags": {
         "json": {
@@ -4356,7 +4335,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:list",
+      "id": "meta:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4390,22 +4369,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "meta",
         "list.js"
       ]
     },
-    "hook:pull": {
+    "meta:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to the meta directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull hook files (actions, filters, cron) from WordPress into local files",
+      "description": "Pull the post meta keys Loopress manages on WordPress into meta/<post-type>.json files, never their values. Keys registered by a theme or another plugin are never pulled, see `lps meta list`.",
       "examples": [
-        "$ lps hook pull",
-        "$ lps hook pull ./hooks"
+        "$ lps meta pull"
       ],
       "flags": {
         "json": {
@@ -4439,7 +4417,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:pull",
+      "id": "meta:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4473,23 +4451,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "meta",
         "pull.js"
       ]
     },
-    "hook:push": {
+    "meta:push": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to the meta directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Push local hook files (actions, filters, cron) to WordPress",
+      "description": "Push local post meta keys (meta/<post-type>.json, each key mapped to its register_post_meta() arguments) to WordPress. Create or update only, never deletes (use `lps meta rm`), never touches meta values.",
       "examples": [
-        "$ lps hook push",
-        "$ lps hook push ./hooks",
-        "$ lps hook push --prune"
+        "$ lps meta push"
       ],
       "flags": {
         "json": {
@@ -4531,17 +4507,11 @@
           "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": "meta:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4575,25 +4545,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "meta",
         "push.js"
       ]
     },
-    "hook:rm": {
+    "meta:rm": {
       "aliases": [
-        "hook:remove"
+        "meta:remove"
       ],
       "args": {
-        "filename": {
-          "description": "The hook file to remove, its slug without the .php extension (e.g. \"hello\" or \"invoice-pdf/[order_id]\")",
-          "name": "filename",
+        "slug": {
+          "description": "The post meta slug, its meta/ file name without .json",
+          "name": "slug",
           "required": true
         }
       },
-      "description": "Remove one hook file (action, filter, cron) from WordPress",
+      "description": "Stop registering the Loopress meta keys of one post type (its meta/<post-type>.json file) on WordPress. Their values are kept in the database.",
       "examples": [
-        "$ lps hook rm hello",
-        "$ lps hook remove hello --yes"
+        "$ lps meta rm <slug>",
+        "$ lps meta remove <slug> --yes"
       ],
       "flags": {
         "json": {
@@ -4627,7 +4597,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:rm",
+      "id": "meta:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4661,24 +4631,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "meta",
         "rm.js"
       ]
     },
-    "hook:rollback": {
+    "meta:rollback": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to meta directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore hook files to a snapshot taken automatically before an earlier `lps hook push`",
+      "description": "Restore post meta keys to a snapshot taken automatically before an earlier `lps meta push`",
       "examples": [
-        "$ lps hook rollback",
-        "$ lps hook rollback --list",
-        "$ lps hook rollback --to 1732000000000",
-        "$ lps hook rollback --dry-run"
+        "$ lps meta rollback",
+        "$ lps meta rollback --list",
+        "$ lps meta rollback --to 1732000000000",
+        "$ lps meta rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -4725,7 +4695,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:rollback",
+      "id": "meta:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -4759,7 +4729,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "meta",
         "rollback.js"
       ]
     },
@@ -5008,103 +4978,19 @@
         "push.js"
       ]
     },
-    "option:add": {
-      "aliases": [],
-      "args": {
-        "name": {
-          "description": "Option name to start tracking (see `lps option list`)",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Fetch a WordPress option by name and start tracking it locally. Run `lps option list` first to find the name: this copies a raw value across environments, verify it does not embed post/user IDs before pushing it elsewhere.",
-      "examples": [
-        "$ lps option add wpseo_titles",
-        "$ lps option add siteurl"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "env": {
-          "description": "Target environment by name (default: \"local\", or the project's only environment)",
-          "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"
-        },
-        "path": {
-          "description": "Path to options directory (overrides project config)",
-          "name": "path",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "option:add",
-      "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"
-        }
-      },
-      "honorsExclude": false,
-      "skipUnsupportedFlag": {
-        "skip-unsupported": {
-          "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "yesFlag": {
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "option",
-        "add.js"
-      ]
-    },
-    "option:diff": {
+    "pattern:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to options directory (overrides project config)",
+          "description": "Path to patterns directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Show what differs, for locally tracked options, between your local files and a WordPress environment, or between two environments",
+      "description": "Show what differs in block patterns between your local patterns/ files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps option diff",
-        "$ lps option diff --env staging",
-        "$ lps option diff --env staging --against production"
+        "$ lps pattern diff",
+        "$ lps pattern diff --env staging",
+        "$ lps pattern diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -5131,7 +5017,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "option:diff",
+      "id": "pattern:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5173,17 +5059,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "option",
+        "pattern",
         "diff.js"
       ]
     },
-    "option:list": {
+    "pattern:list": {
       "aliases": [],
       "args": {},
-      "description": "List WordPress option names currently on the site (names and autoload only, never values). CORE flags a WordPress-native default (certain); SOURCE? is a best-effort guessed plugin slug, found by name or by scanning active plugins' own PHP source (uncertain unless confirmed, occasionally wrong or blank, never trust it over CORE); PLUGIN is that slug's own declared display name, a label only, no confidence of its own. Use this to find the name of the option you want, then `lps option add <name>` to track it.",
+      "description": "List the block patterns registered on WordPress by Loopress, the theme and plugins (not WordPress core). Only Loopress ones are pulled and pushed.",
       "examples": [
-        "$ lps option list",
-        "$ lps option list --no-core"
+        "$ lps pattern list"
       ],
       "flags": {
         "json": {
@@ -5199,17 +5084,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "no-core": {
-          "description": "Exclude WordPress-native default options and the CORE column from the output, including --json",
-          "name": "no-core",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "option:list",
+      "id": "pattern:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5243,21 +5122,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "option",
+        "pattern",
         "list.js"
       ]
     },
-    "option:pull": {
+    "pattern:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to options directory (overrides project config)",
+          "description": "Path to the patterns directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Refresh locally tracked options from WordPress. Options not yet tracked are never pulled, run `lps option add <name>` for those first.",
+      "description": "Pull the block patterns Loopress manages on WordPress into patterns/<slug>.html files. Patterns registered by the theme or a plugin are never pulled, see `lps pattern list`.",
       "examples": [
-        "$ lps option pull"
+        "$ lps pattern pull"
       ],
       "flags": {
         "json": {
@@ -5291,7 +5170,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "option:pull",
+      "id": "pattern:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5325,21 +5204,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "option",
+        "pattern",
         "pull.js"
       ]
     },
-    "option:push": {
+    "pattern:push": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to options directory (overrides project config)",
+          "description": "Path to the patterns directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Push locally tracked, non-readonly options to WordPress (upsert only, never deletes an untracked option). Options marked \"readonly\": true in their local file are skipped, edit the file to override.",
+      "description": "Push local block patterns (patterns/<slug>.html, block markup under a title/categories header) to WordPress, registered as loopress/<slug> and referenced with <!-- wp:pattern {\"slug\":\"loopress/<slug>\"} /-->. Create or update only, never deletes a pattern (use `lps pattern rm`).",
       "examples": [
-        "$ lps option push"
+        "$ lps pattern push"
       ],
       "flags": {
         "json": {
@@ -5385,7 +5264,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "option:push",
+      "id": "pattern:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5419,25 +5298,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "option",
+        "pattern",
         "push.js"
       ]
     },
-    "option:rm": {
+    "pattern:rm": {
       "aliases": [
-        "option:remove"
+        "pattern:remove"
       ],
       "args": {
-        "name": {
-          "description": "Option name to stop tracking",
-          "name": "name",
+        "slug": {
+          "description": "The pattern slug, its patterns/ file name without .html",
+          "name": "slug",
           "required": true
         }
       },
-      "description": "Stop tracking an option locally and delete it from WordPress. Local untracking always happens (git-reversible); pass --local-only to skip the WordPress delete and only stop tracking.",
+      "description": "Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing until it is pushed again, copies already inserted in posts stay.",
       "examples": [
-        "$ lps option rm wpseo_titles",
-        "$ lps option rm wpseo_titles --local-only"
+        "$ lps pattern rm <slug>",
+        "$ lps pattern remove <slug> --yes"
       ],
       "flags": {
         "json": {
@@ -5467,24 +5346,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "local-only": {
-          "description": "Untrack locally without deleting the option on WordPress",
-          "name": "local-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "path": {
-          "description": "Path to options directory (overrides project config)",
-          "name": "path",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "option:rm",
+      "id": "pattern:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5518,24 +5384,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "option",
+        "pattern",
         "rm.js"
       ]
     },
-    "option:rollback": {
+    "pattern:rollback": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to options directory (overrides project config)",
+          "description": "Path to patterns directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore tracked options to a snapshot taken automatically before an earlier `lps option push`",
+      "description": "Restore block patterns to a snapshot taken automatically before an earlier `lps pattern push`",
       "examples": [
-        "$ lps option rollback",
-        "$ lps option rollback --list",
-        "$ lps option rollback --to 1732000000000",
-        "$ lps option rollback --dry-run"
+        "$ lps pattern rollback",
+        "$ lps pattern rollback --list",
+        "$ lps pattern rollback --to 1732000000000",
+        "$ lps pattern rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -5582,7 +5448,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "option:rollback",
+      "id": "pattern:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5616,23 +5482,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "option",
+        "pattern",
         "rollback.js"
       ]
     },
-    "pattern:diff": {
+    "plugin:add": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to patterns directory (overrides project config)",
-          "name": "path"
+        "slug": {
+          "description": "Plugin slug on WordPress.org",
+          "name": "slug",
+          "required": true
         }
       },
-      "description": "Show what differs in block patterns between your local patterns/ files and a WordPress environment, or between two environments",
+      "description": "Add a WordPress.org plugin to loopress.json",
       "examples": [
-        "$ lps pattern diff",
-        "$ lps pattern diff --env staging",
-        "$ lps pattern diff --env staging --against production"
+        "$ lps plugin add woocommerce",
+        "$ lps plugin add woocommerce --version 9.4.2",
+        "$ lps plugin add contact-form-7 --dry-run"
       ],
       "flags": {
         "json": {
@@ -5649,9 +5516,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\", tracked on every push)",
+          "name": "version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -5659,7 +5533,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pattern:diff",
+      "id": "plugin:add",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5673,7 +5547,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": true,
+      "honorsExclude": false,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -5689,28 +5563,84 @@
           "type": "boolean"
         }
       },
-      "againstFlag": {
-        "against": {
-          "description": "Compare the primary environment against this second environment instead of against local files",
-          "input": [],
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "add.js"
+      ]
+    },
+    "plugin:audit": {
+      "aliases": [],
+      "args": {},
+      "description": "Check the plugins in loopress.json for known vulnerabilities (wpvulnerability.net) and health issues",
+      "examples": [
+        "$ lps plugin audit"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "env": {
+          "description": "Target environment by name (default: \"local\", or the project's only environment)",
+          "name": "env",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:audit",
+      "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"
+        }
+      },
+      "honorsExclude": false,
+      "skipUnsupportedFlag": {
+        "skip-unsupported": {
+          "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "pattern",
-        "diff.js"
+        "plugin",
+        "audit.js"
       ]
     },
-    "pattern:list": {
+    "plugin:outdated": {
       "aliases": [],
       "args": {},
-      "description": "List the block patterns registered on WordPress by Loopress, the theme and plugins (not WordPress core). Only Loopress ones are pulled and pushed.",
+      "description": "Compare the plugins in loopress.json to the latest WordPress.org versions (exits 1 when one is behind or cannot be checked)",
       "examples": [
-        "$ lps pattern list"
+        "$ lps plugin outdated",
+        "$ lps plugin outdated --json"
       ],
       "flags": {
         "json": {
@@ -5730,7 +5660,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pattern:list",
+      "id": "plugin:outdated",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5764,21 +5694,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "pattern",
-        "list.js"
+        "plugin",
+        "outdated.js"
       ]
     },
-    "pattern:pull": {
+    "plugin:pull": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the patterns directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull the block patterns Loopress manages on WordPress into patterns/<slug>.html files. Patterns registered by the theme or a plugin are never pulled, see `lps pattern list`.",
+      "args": {},
+      "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 pattern pull"
+        "$ lps plugin pull",
+        "$ lps plugin pull --env production --plugin query-monitor"
       ],
       "flags": {
         "json": {
@@ -5808,11 +5734,18 @@
           "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,
       "hiddenAliases": [],
-      "id": "pattern:pull",
+      "id": "plugin:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5846,21 +5779,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "pattern",
+        "plugin",
         "pull.js"
       ]
     },
-    "pattern:push": {
+    "plugin:push": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the patterns directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Push local block patterns (patterns/<slug>.html, block markup under a title/categories header) to WordPress, registered as loopress/<slug> and referenced with <!-- wp:pattern {\"slug\":\"loopress/<slug>\"} /-->. Create or update only, never deletes a pattern (use `lps pattern rm`).",
+      "args": {},
+      "description": "Install WordPress.org plugins on WordPress to match loopress.json (active state included) or composer.json, via Composer + WPackagist",
       "examples": [
-        "$ lps pattern push"
+        "$ lps plugin push",
+        "$ lps plugin push --dry-run",
+        "$ lps plugin push --force --prune"
       ],
       "flags": {
         "json": {
@@ -5902,11 +5832,29 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "activate": {
+          "description": "composer.json projects only: activate every plugin it declares. Without it, plugins keep their current state and new ones stay inactive",
+          "name": "activate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "prune": {
+          "description": "Deactivate plugins that are active on the site but absent from loopress.json (or composer.json)",
+          "name": "prune",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pattern:push",
+      "id": "plugin:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5940,25 +5888,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "pattern",
+        "plugin",
         "push.js"
       ]
     },
-    "pattern:rm": {
-      "aliases": [
-        "pattern:remove"
-      ],
-      "args": {
-        "slug": {
-          "description": "The pattern slug, its patterns/ file name without .html",
-          "name": "slug",
-          "required": true
-        }
-      },
-      "description": "Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing until it is pushed again, copies already inserted in posts stay.",
+    "plugin:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Compare the plugins on WordPress against loopress.json and report drift (missing, wrong version, inactive, untracked)",
       "examples": [
-        "$ lps pattern rm <slug>",
-        "$ lps pattern remove <slug> --yes"
+        "$ lps plugin status"
       ],
       "flags": {
         "json": {
@@ -5974,25 +5913,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": "pattern:rm",
+      "id": "plugin:status",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6026,24 +5951,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "pattern",
-        "rm.js"
+        "plugin",
+        "status.js"
       ]
     },
-    "pattern:rollback": {
+    "plugin:update": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to patterns directory (overrides project config)",
-          "name": "path"
+        "slug": {
+          "description": "Plugin slug(s) in loopress.json to update (default: all of them)",
+          "name": "slug"
         }
       },
-      "description": "Restore block patterns to a snapshot taken automatically before an earlier `lps pattern push`",
+      "description": "Rewrite plugin versions in loopress.json to the latest WordPress.org releases (loopress.json only, run `lps plugin push` to apply)",
       "examples": [
-        "$ lps pattern rollback",
-        "$ lps pattern rollback --list",
-        "$ lps pattern rollback --to 1732000000000",
-        "$ lps pattern rollback --dry-run"
+        "$ lps plugin update",
+        "$ lps plugin update woocommerce akismet",
+        "$ lps plugin update --minor",
+        "$ lps plugin update --patch --json"
       ],
       "flags": {
         "json": {
@@ -6067,34 +5992,32 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "name": "yes",
+        "minor": {
+          "description": "Stay on the current major version (minor and patch releases only)",
+          "exclusive": [
+            "patch"
+          ],
+          "name": "minor",
           "allowNo": false,
           "type": "boolean"
         },
-        "list": {
-          "description": "List available snapshots instead of rolling back",
-          "name": "list",
+        "patch": {
+          "description": "Stay on the current minor version (patch releases only)",
+          "exclusive": [
+            "minor"
+          ],
+          "name": "patch",
           "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": "pattern:rollback",
+      "id": "plugin:update",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
@@ -6124,24 +6047,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "pattern",
-        "rollback.js"
+        "plugin",
+        "update.js"
       ]
     },
-    "plugin:add": {
+    "option:add": {
       "aliases": [],
       "args": {
-        "slug": {
-          "description": "Plugin slug on WordPress.org",
-          "name": "slug",
-          "required": true
-        }
+        "name": {
+          "description": "Option name to start tracking (see `lps option list`)",
+          "name": "name",
+          "required": true
+        }
       },
-      "description": "Add a WordPress.org plugin to loopress.json",
+      "description": "Fetch a WordPress option by name and start tracking it locally. Run `lps option list` first to find the name: this copies a raw value across environments, verify it does not embed post/user IDs before pushing it elsewhere.",
       "examples": [
-        "$ lps plugin add woocommerce",
-        "$ lps plugin add woocommerce --version 9.4.2",
-        "$ lps plugin add contact-form-7 --dry-run"
+        "$ lps option add wpseo_titles",
+        "$ lps option add siteurl"
       ],
       "flags": {
         "json": {
@@ -6165,9 +6087,9 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "version": {
-          "description": "Exact version to pin (default: \"latest\", tracked on every push)",
-          "name": "version",
+        "path": {
+          "description": "Path to options directory (overrides project config)",
+          "name": "path",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -6175,7 +6097,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:add",
+      "id": "option:add",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6209,16 +6131,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
+        "option",
         "add.js"
       ]
     },
-    "plugin:audit": {
+    "option:diff": {
       "aliases": [],
-      "args": {},
-      "description": "Check the plugins in loopress.json for known vulnerabilities (wpvulnerability.net) and health issues",
+      "args": {
+        "path": {
+          "description": "Path to options directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Show what differs, for locally tracked options, between your local files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps plugin audit"
+        "$ lps option diff",
+        "$ lps option diff --env staging",
+        "$ lps option diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -6234,11 +6163,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": "plugin:audit",
+      "id": "option:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6252,7 +6188,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": false,
+      "honorsExclude": true,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -6268,21 +6204,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",
-        "plugin",
-        "audit.js"
+        "option",
+        "diff.js"
       ]
     },
-    "plugin:pull": {
+    "option:list": {
       "aliases": [],
       "args": {},
-      "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.",
+      "description": "List WordPress option names currently on the site (names and autoload only, never values). CORE flags a WordPress-native default (certain); SOURCE? is a best-effort guessed plugin slug, found by name or by scanning active plugins' own PHP source (uncertain unless confirmed, occasionally wrong or blank, never trust it over CORE); PLUGIN is that slug's own declared display name, a label only, no confidence of its own. Use this to find the name of the option you want, then `lps option add <name>` to track it.",
       "examples": [
-        "$ lps plugin pull",
-        "$ lps plugin pull --env production --plugin query-monitor"
+        "$ lps option list",
+        "$ lps option list --no-core"
       ],
       "flags": {
         "json": {
@@ -6299,31 +6243,16 @@
           "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",
+        "no-core": {
+          "description": "Exclude WordPress-native default options and the CORE column from the output, including --json",
+          "name": "no-core",
           "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,
       "hiddenAliases": [],
-      "id": "plugin:pull",
+      "id": "option:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6357,18 +6286,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
-        "pull.js"
+        "option",
+        "list.js"
       ]
     },
-    "plugin:push": {
+    "option:pull": {
       "aliases": [],
-      "args": {},
-      "description": "Install WordPress.org plugins on WordPress to match loopress.json (active state included) or composer.json, via Composer + WPackagist",
+      "args": {
+        "path": {
+          "description": "Path to options directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Refresh locally tracked options from WordPress. Options not yet tracked are never pulled, run `lps option add <name>` for those first.",
       "examples": [
-        "$ lps plugin push",
-        "$ lps plugin push --dry-run",
-        "$ lps plugin push --force --prune"
+        "$ lps option pull"
       ],
       "flags": {
         "json": {
@@ -6385,18 +6317,6 @@
           "multiple": false,
           "type": "option"
         },
-        "overwrite": {
-          "description": "Push even over changes made on the site outside Loopress since your last push. Pages: also take over a same-slug page Loopress did not create",
-          "name": "overwrite",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "production-confirmed": {
-          "hidden": true,
-          "name": "production-confirmed",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -6410,29 +6330,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "activate": {
-          "description": "composer.json projects only: activate every plugin it declares. Without it, plugins keep their current state and new ones stay inactive",
-          "name": "activate",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "description": "Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "prune": {
-          "description": "Deactivate plugins that are active on the site but absent from loopress.json (or composer.json)",
-          "name": "prune",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:push",
+      "id": "option:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6446,7 +6348,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": true,
+      "honorsExclude": false,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -6466,16 +6368,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
-        "push.js"
+        "option",
+        "pull.js"
       ]
     },
-    "plugin:status": {
+    "option:push": {
       "aliases": [],
-      "args": {},
-      "description": "Compare the plugins on WordPress against loopress.json and report drift (missing, wrong version, inactive, untracked)",
+      "args": {
+        "path": {
+          "description": "Path to options directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Push locally tracked, non-readonly options to WordPress (upsert only, never deletes an untracked option). Options marked \"readonly\": true in their local file are skipped, edit the file to override.",
       "examples": [
-        "$ lps plugin status"
+        "$ lps option push"
       ],
       "flags": {
         "json": {
@@ -6491,11 +6398,37 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "overwrite": {
+          "description": "Push even over changes made on the site outside Loopress since your last push. Pages: also take over a same-slug page Loopress did not create",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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,
       "hiddenAliases": [],
-      "id": "plugin:status",
+      "id": "option:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6509,7 +6442,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": false,
+      "honorsExclude": true,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -6529,23 +6462,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
-        "status.js"
+        "option",
+        "push.js"
       ]
     },
-    "role:diff": {
-      "aliases": [],
+    "option:rm": {
+      "aliases": [
+        "option:remove"
+      ],
       "args": {
-        "path": {
-          "description": "Path to roles directory (overrides project config)",
-          "name": "path"
+        "name": {
+          "description": "Option name to stop tracking",
+          "name": "name",
+          "required": true
         }
       },
-      "description": "Show what differs in roles between your local roles/ files and a WordPress environment, or between two environments",
+      "description": "Stop tracking an option locally and delete it from WordPress. Local untracking always happens (git-reversible); pass --local-only to skip the WordPress delete and only stop tracking.",
       "examples": [
-        "$ lps role diff",
-        "$ lps role diff --env staging",
-        "$ lps role diff --env staging --against production"
+        "$ lps option rm wpseo_titles",
+        "$ lps option rm wpseo_titles --local-only"
       ],
       "flags": {
         "json": {
@@ -6562,9 +6497,29 @@
           "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"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "local-only": {
+          "description": "Untrack locally without deleting the option on WordPress",
+          "name": "local-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "path": {
+          "description": "Path to options directory (overrides project config)",
+          "name": "path",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -6572,7 +6527,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "role:diff",
+      "id": "option:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6586,7 +6541,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": true,
+      "honorsExclude": false,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -6602,28 +6557,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",
-        "role",
-        "diff.js"
-      ]
+        "option",
+        "rm.js"
+      ]
     },
-    "role:list": {
+    "option:rollback": {
       "aliases": [],
-      "args": {},
-      "description": "List the user roles on WordPress, where each comes from (Loopress, WordPress, a plugin) and how many users have it. Only Loopress ones are pulled and pushed.",
+      "args": {
+        "path": {
+          "description": "Path to options directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Restore tracked options to a snapshot taken automatically before an earlier `lps option push`",
       "examples": [
-        "$ lps role list"
+        "$ lps option rollback",
+        "$ lps option rollback --list",
+        "$ lps option rollback --to 1732000000000",
+        "$ lps option rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -6639,11 +6594,38 @@
           "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"
+        },
+        "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": "role:list",
+      "id": "option:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6677,21 +6659,40 @@
       "relativePath": [
         "dist",
         "commands",
-        "role",
-        "list.js"
+        "option",
+        "rollback.js"
       ]
     },
-    "role:pull": {
+    "project:config": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the roles directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull the roles Loopress manages on WordPress into roles/<slug>.json files. Built-in roles and roles created by a plugin are never pulled, see `lps role list`.",
+      "args": {},
+      "description": "Add or update a WordPress project environment. By default, authorizes via WordPress in your browser; manual username/Application Password entry is available as a fallback.",
       "examples": [
-        "$ lps role pull"
+        "$ lps project config"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:config",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "config.js"
+      ]
+    },
+    "project:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List configured WordPress projects",
+      "examples": [
+        "$ lps project list"
       ],
       "flags": {
         "json": {
@@ -6700,21 +6701,56 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "env": {
-          "description": "Target environment by name (default: \"local\", or the project's only environment)",
-          "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": "project:list",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "list.js"
+      ]
+    },
+    "project:pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Pull projects and environments from your Loopress account that are not configured locally yet",
+      "examples": [
+        "$ lps project pull"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:pull",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "pull.js"
+      ]
+    },
+    "project:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Push locally configured projects, environments and credentials to your Loopress account",
+      "examples": [
+        "$ lps project push"
+      ],
+      "flags": {
         "yes": {
           "char": "y",
           "description": "Answer yes to confirmation prompts",
@@ -6725,12 +6761,71 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "role:pull",
+      "id": "project:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "push.js"
+      ]
+    },
+    "project:rm": {
+      "aliases": [
+        "project:remove"
+      ],
+      "args": {},
+      "description": "Remove one or more WordPress projects or environments",
+      "examples": [
+        "$ lps project rm"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:rm",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "rm.js"
+      ]
+    },
+    "project:rotate": {
+      "aliases": [],
+      "args": {},
+      "description": "Rotate the WordPress application password for the current (or --env) environment",
+      "examples": [
+        "$ lps project rotate",
+        "$ lps project rotate --env staging"
+      ],
+      "flags": {
+        "env": {
+          "description": "Target environment by name (default: \"local\", or the project's only environment)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:rotate",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -6759,21 +6854,47 @@
       "relativePath": [
         "dist",
         "commands",
-        "role",
-        "pull.js"
+        "project",
+        "rotate.js"
       ]
     },
-    "role:push": {
+    "project:switch": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch the active project (pass --env to target a non-local environment)",
+      "examples": [
+        "$ lps project switch"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:switch",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "switch.js"
+      ]
+    },
+    "menu:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to the roles directory (overrides project config)",
+          "description": "Path to menus directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Push local roles (roles/<slug>.json, a \"name\" and its \"capabilities\") to WordPress. Create or update only, never deletes a role (use `lps role rm`), never changes which users have it.",
+      "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 role push"
+        "$ lps menu diff",
+        "$ lps menu diff --env staging",
+        "$ lps menu diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -6790,36 +6911,88 @@
           "multiple": false,
           "type": "option"
         },
-        "overwrite": {
-          "description": "Push even over changes made on the site outside Loopress since your last push. Pages: also take over a same-slug page Loopress did not create",
-          "name": "overwrite",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "production-confirmed": {
-          "hidden": true,
-          "name": "production-confirmed",
-          "allowNo": false,
-          "type": "boolean"
-        },
+        "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": "menu: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"
-        },
+        }
+      },
+      "honorsExclude": true,
+      "skipUnsupportedFlag": {
+        "skip-unsupported": {
+          "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
         "yes": {
           "char": "y",
           "description": "Answer yes to confirmation prompts",
-          "name": "yes",
           "allowNo": false,
           "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",
+        "menu",
+        "diff.js"
+      ]
+    },
+    "menu:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List nav menus and the active theme menu locations on WordPress",
+      "examples": [
+        "$ lps menu list"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "env": {
+          "description": "Target environment by name (default: \"local\", or the project's only environment)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "role:push",
+      "id": "menu:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6833,7 +7006,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": true,
+      "honorsExclude": false,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -6853,25 +7026,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "role",
-        "push.js"
+        "menu",
+        "list.js"
       ]
     },
-    "role:rm": {
-      "aliases": [
-        "role:remove"
-      ],
+    "menu:pull": {
+      "aliases": [],
       "args": {
-        "slug": {
-          "description": "The role slug, its roles/ file name without .json",
-          "name": "slug",
-          "required": true
+        "path": {
+          "description": "Path to menus directory (overrides project config)",
+          "name": "path"
         }
       },
-      "description": "Stop registering a Loopress role on WordPress. Its users keep it in their profile, with no capability until the role is pushed again.",
+      "description": "Pull nav menus and the active theme menu locations from WordPress",
       "examples": [
-        "$ lps role rm <slug>",
-        "$ lps role remove <slug> --yes"
+        "$ lps menu pull"
       ],
       "flags": {
         "json": {
@@ -6905,7 +7074,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "role:rm",
+      "id": "menu:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -6939,24 +7108,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "role",
-        "rm.js"
+        "menu",
+        "pull.js"
       ]
     },
-    "role:rollback": {
+    "menu:push": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to roles directory (overrides project config)",
+          "description": "Path to menus directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore roles to a snapshot taken automatically before an earlier `lps role push`",
+      "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 role rollback",
-        "$ lps role rollback --list",
-        "$ lps role rollback --to 1732000000000",
-        "$ lps role rollback --dry-run"
+        "$ lps menu push"
       ],
       "flags": {
         "json": {
@@ -6973,6 +7139,18 @@
           "multiple": false,
           "type": "option"
         },
+        "overwrite": {
+          "description": "Push even over changes made on the site outside Loopress since your last push. Pages: also take over a same-slug page Loopress did not create",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -6986,24 +7164,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": "role:rollback",
+      "id": "menu:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7017,7 +7182,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": false,
+      "honorsExclude": true,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -7037,40 +7202,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "role",
-        "rollback.js"
-      ]
-    },
-    "project:config": {
-      "aliases": [],
-      "args": {},
-      "description": "Add or update a WordPress project environment. By default, authorizes via WordPress in your browser; manual username/Application Password entry is available as a fallback.",
-      "examples": [
-        "$ lps project config"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:config",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "config.js"
+        "menu",
+        "push.js"
       ]
     },
-    "project:list": {
+    "menu:rollback": {
       "aliases": [],
-      "args": {},
-      "description": "List configured WordPress projects",
+      "args": {
+        "path": {
+          "description": "Path to menus directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Restore nav menus and menu locations to a snapshot taken automatically before an earlier `lps menu push`",
       "examples": [
-        "$ lps project list"
+        "$ lps menu rollback",
+        "$ lps menu rollback --list",
+        "$ lps menu rollback --to 1732000000000",
+        "$ lps menu rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -7079,118 +7228,37 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:list",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "list.js"
-      ]
-    },
-    "project:pull": {
-      "aliases": [],
-      "args": {},
-      "description": "Pull projects and environments from your Loopress account that are not configured locally yet",
-      "examples": [
-        "$ lps project pull"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:pull",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "pull.js"
-      ]
-    },
-    "project:push": {
-      "aliases": [],
-      "args": {},
-      "description": "Push locally configured projects, environments and credentials to your Loopress account",
-      "examples": [
-        "$ lps project push"
-      ],
-      "flags": {
+        },
+        "env": {
+          "description": "Target environment by name (default: \"local\", or the project's only environment)",
+          "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"
+        },
         "yes": {
           "char": "y",
           "description": "Answer yes to confirmation prompts",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:push",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "push.js"
-      ]
-    },
-    "project:rm": {
-      "aliases": [
-        "project:remove"
-      ],
-      "args": {},
-      "description": "Remove one or more WordPress projects or environments",
-      "examples": [
-        "$ lps project rm"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:rm",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "rm.js"
-      ]
-    },
-    "project:rotate": {
-      "aliases": [],
-      "args": {},
-      "description": "Rotate the WordPress application password for the current (or --env) environment",
-      "examples": [
-        "$ lps project rotate",
-        "$ lps project rotate --env staging"
-      ],
-      "flags": {
-        "env": {
-          "description": "Target environment by name (default: \"local\", or the project's only environment)",
-          "name": "env",
+        },
+        "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"
@@ -7198,12 +7266,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:rotate",
+      "id": "menu:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -7226,53 +7294,29 @@
           "description": "Answer yes to confirmation prompts",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "rotate.js"
-      ]
-    },
-    "project:switch": {
-      "aliases": [],
-      "args": {},
-      "description": "Switch the active project (pass --env to target a non-local environment)",
-      "examples": [
-        "$ lps project switch"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:switch",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "project",
-        "switch.js"
+        "menu",
+        "rollback.js"
       ]
     },
-    "taxonomy:diff": {
+    "role:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to taxonomies directory (overrides project config)",
+          "description": "Path to roles directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Show what differs in taxonomies between your local taxonomies/ files and a WordPress environment, or between two environments",
+      "description": "Show what differs in roles between your local roles/ files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps taxonomy diff",
-        "$ lps taxonomy diff --env staging",
-        "$ lps taxonomy diff --env staging --against production"
+        "$ lps role diff",
+        "$ lps role diff --env staging",
+        "$ lps role diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -7299,7 +7343,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "taxonomy:diff",
+      "id": "role:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7341,16 +7385,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "taxonomy",
+        "role",
         "diff.js"
       ]
     },
-    "taxonomy:list": {
+    "role:list": {
       "aliases": [],
       "args": {},
-      "description": "List the taxonomies registered on WordPress, where each comes from (Loopress, WordPress, ACF, CPT UI, a theme or plugin) and the post types it attaches to. Only Loopress ones are pulled and pushed.",
+      "description": "List the user roles on WordPress, where each comes from (Loopress, WordPress, a plugin) and how many users have it. Only Loopress ones are pulled and pushed.",
       "examples": [
-        "$ lps taxonomy list"
+        "$ lps role list"
       ],
       "flags": {
         "json": {
@@ -7370,7 +7414,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "taxonomy:list",
+      "id": "role:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7404,21 +7448,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "taxonomy",
+        "role",
         "list.js"
       ]
     },
-    "taxonomy:pull": {
+    "role:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to the taxonomies directory (overrides project config)",
+          "description": "Path to the roles directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull the taxonomies Loopress manages on WordPress into taxonomies/<slug>.json files, never their terms. Taxonomies registered by a theme or another plugin are never pulled, see `lps taxonomy list`.",
+      "description": "Pull the roles Loopress manages on WordPress into roles/<slug>.json files. Built-in roles and roles created by a plugin are never pulled, see `lps role list`.",
       "examples": [
-        "$ lps taxonomy pull"
+        "$ lps role pull"
       ],
       "flags": {
         "json": {
@@ -7452,7 +7496,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "taxonomy:pull",
+      "id": "role:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7486,21 +7530,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "taxonomy",
+        "role",
         "pull.js"
       ]
     },
-    "taxonomy:push": {
+    "role:push": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to the taxonomies directory (overrides project config)",
+          "description": "Path to the roles directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Push local taxonomies (taxonomies/<slug>.json, register_taxonomy() arguments plus \"object_type\") to WordPress. Create or update only, never deletes a taxonomy (use `lps taxonomy rm`), never touches its terms.",
+      "description": "Push local roles (roles/<slug>.json, a \"name\" and its \"capabilities\") to WordPress. Create or update only, never deletes a role (use `lps role rm`), never changes which users have it.",
       "examples": [
-        "$ lps taxonomy push"
+        "$ lps role push"
       ],
       "flags": {
         "json": {
@@ -7546,7 +7590,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "taxonomy:push",
+      "id": "role:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7580,25 +7624,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "taxonomy",
+        "role",
         "push.js"
       ]
     },
-    "taxonomy:rm": {
+    "role:rm": {
       "aliases": [
-        "taxonomy:remove"
+        "role:remove"
       ],
       "args": {
         "slug": {
-          "description": "The taxonomy slug, its taxonomies/ file name without .json",
+          "description": "The role slug, its roles/ file name without .json",
           "name": "slug",
           "required": true
         }
       },
-      "description": "Stop registering a Loopress taxonomy on WordPress. Its terms are kept in the database, hidden until the taxonomy is pushed again.",
+      "description": "Stop registering a Loopress role on WordPress. Its users keep it in their profile, with no capability until the role is pushed again.",
       "examples": [
-        "$ lps taxonomy rm <slug>",
-        "$ lps taxonomy remove <slug> --yes"
+        "$ lps role rm <slug>",
+        "$ lps role remove <slug> --yes"
       ],
       "flags": {
         "json": {
@@ -7632,7 +7676,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "taxonomy:rm",
+      "id": "role:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7666,24 +7710,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "taxonomy",
+        "role",
         "rm.js"
       ]
     },
-    "taxonomy:rollback": {
+    "role:rollback": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to taxonomies directory (overrides project config)",
+          "description": "Path to roles directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore taxonomies to a snapshot taken automatically before an earlier `lps taxonomy push`",
+      "description": "Restore roles to a snapshot taken automatically before an earlier `lps role push`",
       "examples": [
-        "$ lps taxonomy rollback",
-        "$ lps taxonomy rollback --list",
-        "$ lps taxonomy rollback --to 1732000000000",
-        "$ lps taxonomy rollback --dry-run"
+        "$ lps role rollback",
+        "$ lps role rollback --list",
+        "$ lps role rollback --to 1732000000000",
+        "$ lps role rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -7730,7 +7774,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "taxonomy:rollback",
+      "id": "role:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7764,71 +7808,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "taxonomy",
+        "role",
         "rollback.js"
       ]
     },
-    "telemetry:disable": {
-      "aliases": [],
-      "args": {},
-      "description": "Disable error reporting to Sentry",
-      "examples": [
-        "$ lps telemetry disable"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "telemetry:disable",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "telemetry",
-        "disable.js"
-      ]
-    },
-    "telemetry:enable": {
-      "aliases": [],
-      "args": {},
-      "description": "Enable error reporting to Sentry",
-      "examples": [
-        "$ lps telemetry enable"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "telemetry:enable",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "telemetry",
-        "enable.js"
-      ]
-    },
-    "theme:activate": {
+    "snippet:diff": {
       "aliases": [],
       "args": {
-        "stylesheet": {
-          "description": "Theme to activate (default: the Loopress child theme, <parent>-loopress)",
-          "name": "stylesheet"
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
         }
       },
-      "description": "Activate a theme on WordPress, the Loopress child theme by default. A child theme without settings of its own starts from a copy of its parent's theme mods and Global Styles. Set \"activateChildTheme\": true in loopress.json to have `lps theme template push` keep the child active.",
+      "description": "Show what differs in snippets between your local files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps theme activate",
-        "$ lps theme activate twentytwentyfive --env staging",
-        "$ lps theme activate --dry-run"
+        "$ lps snippet diff",
+        "$ lps snippet diff --env staging",
+        "$ lps snippet diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -7845,24 +7841,17 @@
           "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"
+        "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": "theme:activate",
+      "id": "snippet:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7876,7 +7865,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": false,
+      "honorsExclude": true,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -7892,27 +7881,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",
-        "theme",
-        "activate.js"
+        "snippet",
+        "diff.js"
       ]
     },
-    "theme:add": {
+    "snippet:list": {
       "aliases": [],
-      "args": {
-        "slug": {
-          "description": "Theme slug on WordPress.org",
-          "name": "slug",
-          "required": true
-        }
-      },
-      "description": "Add a WordPress.org theme to loopress.json",
+      "args": {},
+      "description": "List snippets currently on WordPress",
       "examples": [
-        "$ lps theme add generatepress",
-        "$ lps theme add generatepress --version 3.4.0"
+        "$ lps snippet list"
       ],
       "flags": {
         "json": {
@@ -7928,25 +7918,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"
-        },
-        "version": {
-          "description": "Exact version to pin (default: \"latest\")",
-          "name": "version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme:add",
+      "id": "snippet:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -7980,18 +7956,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "theme",
-        "add.js"
+        "snippet",
+        "list.js"
       ]
     },
-    "theme:pull": {
+    "snippet:pull": {
       "aliases": [],
-      "args": {},
-      "description": "Pull everything theme related from WordPress: theme versions into loopress.json, then Global Styles into a local file",
+      "args": {
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Pull snippets from WordPress into local files",
       "examples": [
-        "$ lps theme pull",
-        "$ lps theme pull --env staging",
-        "$ lps theme pull --dry-run"
+        "$ lps snippet pull",
+        "$ lps snippet pull ./snippets"
       ],
       "flags": {
         "json": {
@@ -8014,11 +7994,18 @@
           "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": "theme:pull",
+      "id": "snippet:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8052,18 +8039,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "theme",
+        "snippet",
         "pull.js"
       ]
     },
-    "theme:push": {
-      "aliases": [],
-      "args": {},
-      "description": "Push everything theme related to WordPress: theme versions from loopress.json, then block templates and parts, then Global Styles. Switches the active theme only to the Loopress child, when loopress.json sets \"activateChildTheme\": true.",
+    "snippet:push": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Push local snippet files to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.",
       "examples": [
-        "$ lps theme push",
-        "$ lps theme push --env staging",
-        "$ lps theme push --dry-run"
+        "$ lps snippet push",
+        "$ lps snippet push ./snippets"
       ],
       "flags": {
         "json": {
@@ -8080,6 +8071,18 @@
           "multiple": false,
           "type": "option"
         },
+        "overwrite": {
+          "description": "Push even over changes made on the site outside Loopress since your last push. Pages: also take over a same-slug page Loopress did not create",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -8093,17 +8096,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "force": {
-          "description": "Passed to `lps theme version push`",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme:push",
+      "id": "snippet:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8117,7 +8114,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": false,
+      "honorsExclude": true,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -8137,16 +8134,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "theme",
+        "snippet",
         "push.js"
       ]
     },
-    "theme:status": {
+    "snippet:rollback": {
       "aliases": [],
-      "args": {},
-      "description": "Compare the themes on WordPress against loopress.json and report version drift",
+      "args": {
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Restore snippets to a snapshot taken automatically before an earlier `lps snippet push`",
       "examples": [
-        "$ lps theme status"
+        "$ lps snippet rollback",
+        "$ lps snippet rollback --list",
+        "$ lps snippet rollback --to 1732000000000",
+        "$ lps snippet rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -8162,11 +8167,38 @@
           "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"
+        },
+        "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": "theme:status",
+      "id": "snippet:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8200,23 +8232,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "theme",
-        "status.js"
+        "snippet",
+        "rollback.js"
       ]
     },
-    "snippet:diff": {
+    "taxonomy:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to snippets directory (overrides project config)",
+          "description": "Path to taxonomies directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Show what differs in snippets between your local files and a WordPress environment, or between two environments",
+      "description": "Show what differs in taxonomies between your local taxonomies/ files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps snippet diff",
-        "$ lps snippet diff --env staging",
-        "$ lps snippet diff --env staging --against production"
+        "$ lps taxonomy diff",
+        "$ lps taxonomy diff --env staging",
+        "$ lps taxonomy diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -8243,7 +8275,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:diff",
+      "id": "taxonomy:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8285,16 +8317,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
+        "taxonomy",
         "diff.js"
       ]
     },
-    "snippet:list": {
+    "taxonomy:list": {
       "aliases": [],
       "args": {},
-      "description": "List snippets currently on WordPress",
+      "description": "List the taxonomies registered on WordPress, where each comes from (Loopress, WordPress, ACF, CPT UI, a theme or plugin) and the post types it attaches to. Only Loopress ones are pulled and pushed.",
       "examples": [
-        "$ lps snippet list"
+        "$ lps taxonomy list"
       ],
       "flags": {
         "json": {
@@ -8314,7 +8346,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:list",
+      "id": "taxonomy:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8348,52 +8380,103 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
+        "taxonomy",
         "list.js"
       ]
     },
-    "snippet:publish": {
+    "taxonomy:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to snippets directory (overrides project config)",
+          "description": "Path to the taxonomies directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.",
+      "description": "Pull the taxonomies Loopress manages on WordPress into taxonomies/<slug>.json files, never their terms. Taxonomies registered by a theme or another plugin are never pulled, see `lps taxonomy list`.",
       "examples": [
-        "$ lps snippet publish",
-        "$ lps snippet publish ./snippets"
+        "$ lps taxonomy pull"
       ],
-      "flags": {},
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "env": {
+          "description": "Target environment by name (default: \"local\", or the project's only environment)",
+          "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"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:publish",
+      "id": "taxonomy:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "honorsExclude": false,
+      "skipUnsupportedFlag": {
+        "skip-unsupported": {
+          "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
-        "publish.js"
+        "taxonomy",
+        "pull.js"
       ]
     },
-    "snippet:pull": {
+    "taxonomy:push": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to snippets directory (overrides project config)",
+          "description": "Path to the taxonomies directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull snippets from WordPress into local files",
+      "description": "Push local taxonomies (taxonomies/<slug>.json, register_taxonomy() arguments plus \"object_type\") to WordPress. Create or update only, never deletes a taxonomy (use `lps taxonomy rm`), never touches its terms.",
       "examples": [
-        "$ lps snippet pull",
-        "$ lps snippet pull ./snippets"
+        "$ lps taxonomy push"
       ],
       "flags": {
         "json": {
@@ -8410,6 +8493,18 @@
           "multiple": false,
           "type": "option"
         },
+        "overwrite": {
+          "description": "Push even over changes made on the site outside Loopress since your last push. Pages: also take over a same-slug page Loopress did not create",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "production-confirmed": {
+          "hidden": true,
+          "name": "production-confirmed",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -8427,7 +8522,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:pull",
+      "id": "taxonomy:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8441,7 +8536,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": false,
+      "honorsExclude": true,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -8461,22 +8556,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
-        "pull.js"
+        "taxonomy",
+        "push.js"
       ]
     },
-    "snippet:push": {
-      "aliases": [],
+    "taxonomy:rm": {
+      "aliases": [
+        "taxonomy:remove"
+      ],
       "args": {
-        "path": {
-          "description": "Path to snippets directory (overrides project config)",
-          "name": "path"
+        "slug": {
+          "description": "The taxonomy slug, its taxonomies/ file name without .json",
+          "name": "slug",
+          "required": true
         }
       },
-      "description": "Push local snippet files to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.",
+      "description": "Stop registering a Loopress taxonomy on WordPress. Its terms are kept in the database, hidden until the taxonomy is pushed again.",
       "examples": [
-        "$ lps snippet push",
-        "$ lps snippet push ./snippets"
+        "$ lps taxonomy rm <slug>",
+        "$ lps taxonomy remove <slug> --yes"
       ],
       "flags": {
         "json": {
@@ -8493,18 +8591,6 @@
           "multiple": false,
           "type": "option"
         },
-        "overwrite": {
-          "description": "Push even over changes made on the site outside Loopress since your last push. Pages: also take over a same-slug page Loopress did not create",
-          "name": "overwrite",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "production-confirmed": {
-          "hidden": true,
-          "name": "production-confirmed",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -8522,7 +8608,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:push",
+      "id": "taxonomy:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8536,7 +8622,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": true,
+      "honorsExclude": false,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -8556,24 +8642,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
-        "push.js"
+        "taxonomy",
+        "rm.js"
       ]
     },
-    "snippet:rollback": {
+    "taxonomy:rollback": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to snippets directory (overrides project config)",
+          "description": "Path to taxonomies directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore snippets to a snapshot taken automatically before an earlier `lps snippet push`",
+      "description": "Restore taxonomies to a snapshot taken automatically before an earlier `lps taxonomy push`",
       "examples": [
-        "$ lps snippet rollback",
-        "$ lps snippet rollback --list",
-        "$ lps snippet rollback --to 1732000000000",
-        "$ lps snippet rollback --dry-run"
+        "$ lps taxonomy rollback",
+        "$ lps taxonomy rollback --list",
+        "$ lps taxonomy rollback --to 1732000000000",
+        "$ lps taxonomy rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -8620,7 +8706,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:rollback",
+      "id": "taxonomy:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8654,23 +8740,71 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
+        "taxonomy",
         "rollback.js"
       ]
     },
-    "menu:diff": {
+    "telemetry:disable": {
+      "aliases": [],
+      "args": {},
+      "description": "Disable error reporting to Sentry",
+      "examples": [
+        "$ lps telemetry disable"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "telemetry:disable",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "telemetry",
+        "disable.js"
+      ]
+    },
+    "telemetry:enable": {
+      "aliases": [],
+      "args": {},
+      "description": "Enable error reporting to Sentry",
+      "examples": [
+        "$ lps telemetry enable"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "telemetry:enable",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "telemetry",
+        "enable.js"
+      ]
+    },
+    "theme:activate": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to menus directory (overrides project config)",
-          "name": "path"
+        "stylesheet": {
+          "description": "Theme to activate (default: the Loopress child theme, <parent>-loopress)",
+          "name": "stylesheet"
         }
       },
-      "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": "Activate a theme on WordPress, the Loopress child theme by default. A child theme without settings of its own starts from a copy of its parent's theme mods and Global Styles. Set \"activateChildTheme\": true in loopress.json to have `lps theme template push` keep the child active.",
       "examples": [
-        "$ lps menu diff",
-        "$ lps menu diff --env staging",
-        "$ lps menu diff --env staging --against production"
+        "$ lps theme activate",
+        "$ lps theme activate twentytwentyfive --env staging",
+        "$ lps theme activate --dry-run"
       ],
       "flags": {
         "json": {
@@ -8687,17 +8821,24 @@
           "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"
+        "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": "menu:diff",
+      "id": "theme:activate",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8711,7 +8852,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": true,
+      "honorsExclude": false,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -8727,28 +8868,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",
-        "menu",
-        "diff.js"
+        "theme",
+        "activate.js"
       ]
     },
-    "menu:list": {
+    "theme:add": {
       "aliases": [],
-      "args": {},
-      "description": "List nav menus and the active theme menu locations on WordPress",
+      "args": {
+        "slug": {
+          "description": "Theme slug on WordPress.org",
+          "name": "slug",
+          "required": true
+        }
+      },
+      "description": "Add a WordPress.org theme to loopress.json",
       "examples": [
-        "$ lps menu list"
+        "$ lps theme add generatepress",
+        "$ lps theme add generatepress --version 3.4.0"
       ],
       "flags": {
         "json": {
@@ -8764,11 +8904,25 @@
           "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"
+        },
+        "version": {
+          "description": "Exact version to pin (default: \"latest\")",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:list",
+      "id": "theme:add",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8802,21 +8956,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
-        "list.js"
+        "theme",
+        "add.js"
       ]
     },
-    "menu:pull": {
+    "theme:pull": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to menus directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull nav menus and the active theme menu locations from WordPress",
+      "args": {},
+      "description": "Pull everything theme related from WordPress: theme versions into loopress.json, then Global Styles into a local file",
       "examples": [
-        "$ lps menu pull"
+        "$ lps theme pull",
+        "$ lps theme pull --env staging",
+        "$ lps theme pull --dry-run"
       ],
       "flags": {
         "json": {
@@ -8839,18 +8990,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": "menu:pull",
+      "id": "theme:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8884,21 +9028,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "theme",
         "pull.js"
       ]
     },
-    "menu:push": {
+    "theme:push": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to menus 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.",
+      "args": {},
+      "description": "Push everything theme related to WordPress: theme versions from loopress.json, then block templates and parts, then Global Styles. Switches the active theme only to the Loopress child, when loopress.json sets \"activateChildTheme\": true.",
       "examples": [
-        "$ lps menu push"
+        "$ lps theme push",
+        "$ lps theme push --env staging",
+        "$ lps theme push --dry-run"
       ],
       "flags": {
         "json": {
@@ -8915,18 +9056,6 @@
           "multiple": false,
           "type": "option"
         },
-        "overwrite": {
-          "description": "Push even over changes made on the site outside Loopress since your last push. Pages: also take over a same-slug page Loopress did not create",
-          "name": "overwrite",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "production-confirmed": {
-          "hidden": true,
-          "name": "production-confirmed",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
@@ -8940,11 +9069,17 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "description": "Passed to `lps theme version push`",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:push",
+      "id": "theme:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -8958,7 +9093,7 @@
           "type": "boolean"
         }
       },
-      "honorsExclude": true,
+      "honorsExclude": false,
       "skipUnsupportedFlag": {
         "skip-unsupported": {
           "description": "Skip the resources the project uses but this site can't hold (a missing plugin, a Full feature on Light) instead of failing, and warn about each",
@@ -8978,24 +9113,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "theme",
         "push.js"
       ]
     },
-    "menu:rollback": {
+    "theme:status": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to menus directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Restore nav menus and menu locations to a snapshot taken automatically before an earlier `lps menu push`",
+      "args": {},
+      "description": "Compare the themes on WordPress against loopress.json and report version drift",
       "examples": [
-        "$ lps menu rollback",
-        "$ lps menu rollback --list",
-        "$ lps menu rollback --to 1732000000000",
-        "$ lps menu rollback --dry-run"
+        "$ lps theme status"
       ],
       "flags": {
         "json": {
@@ -9011,38 +9138,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"
-        },
-        "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": "theme:status",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -9076,8 +9176,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
-        "rollback.js"
+        "theme",
+        "status.js"
       ]
     },
     "theme:style:diff": {
@@ -9841,5 +9941,5 @@
       ]
     }
   },
-  "version": "0.34.0"
+  "version": "0.35.0"
 }