@loopress/cli 0.27.0 → 0.28.0

package/oclif.manifest.json

@@ -11,14 +11,14 @@
       ],
       "flags": {
         "only": {
-          "description": "Only watch these resource types (comma-separated): snippets, pages, api, hooks, plugins",
+          "description": "Only watch these resource types (comma-separated): snippets, templates, parts, pages, api, hooks, plugins",
           "name": "only",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "skip": {
-          "description": "Skip these resource types (comma-separated): snippets, pages, api, hooks, plugins",
+          "description": "Skip these resource types (comma-separated): snippets, templates, parts, pages, api, hooks, plugins",
           "name": "skip",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -43,7 +43,7 @@
     "diff": {
       "aliases": [],
       "args": {},
-      "description": "Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers snippets, forms, ACF, API routes, Hooks, pages, SEO, Options, Menus, Theme styles, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.",
+      "description": "Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, SEO, Options, Menus, Theme styles, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.",
       "examples": [
         "$ lps diff",
         "$ lps diff --env staging",
@@ -84,6 +84,8 @@
             "acf",
             "api",
             "hook",
+            "template",
+            "part",
             "page",
             "seo",
             "menu",
@@ -104,6 +106,8 @@
             "acf",
             "api",
             "hook",
+            "template",
+            "part",
             "page",
             "seo",
             "menu",
@@ -291,7 +295,7 @@
           "required": true
         }
       },
-      "description": "Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked files are overwritten with <from> in the process.",
+      "description": "Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked files are overwritten with <from> in the process. With --dry-run, <from> is pulled into a throwaway copy of the project instead, and the push is only previewed.",
       "examples": [
         "$ lps promote staging production",
         "$ lps promote production staging --dry-run"
@@ -407,7 +411,7 @@
     "push": {
       "aliases": [],
       "args": {},
-      "description": "Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, pages, SEO, menus, options, and snippets, to WordPress",
+      "description": "Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, templates, pages, SEO, menus, options, and snippets, to WordPress",
       "examples": [
         "$ lps push",
         "$ lps push --env staging",
@@ -1415,38 +1419,37 @@
         "rollback.js"
       ]
     },
-    "composer:init": {
+    "app:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a composer.json wired to WPackagist for installing WordPress.org plugins and themes",
+      "description": "List single-page apps deployed to WordPress",
       "examples": [
-        "$ lps composer init",
-        "$ lps composer init --dry-run"
+        "$ lps app list"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "composer:init",
+      "id": "app:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1467,17 +1470,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "composer",
-        "init.js"
+        "app",
+        "list.js"
       ]
     },
-    "composer:pull": {
+    "app:pull": {
       "aliases": [],
-      "args": {},
-      "description": "Pull composer.json and composer.lock from WordPress",
+      "args": {
+        "path": {
+          "description": "Path to apps directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Pull single-page app bundles from WordPress into local files",
       "examples": [
-        "$ lps composer pull",
-        "$ lps composer pull --dry-run"
+        "$ lps app pull"
       ],
       "flags": {
         "json": {
@@ -1500,11 +1507,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": "composer:pull",
+      "id": "app:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1530,17 +1544,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "composer",
+        "app",
         "pull.js"
       ]
     },
-    "composer:push": {
+    "app:push": {
       "aliases": [],
-      "args": {},
-      "description": "Push composer.json to WordPress and run Composer to resolve and install dependencies",
+      "args": {
+        "name": {
+          "description": "Push only this app (defaults to every app in the directory)",
+          "name": "name"
+        }
+      },
+      "description": "Build and push single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a dist/ folder. When the app has a package.json with a `build` script, it runs first (use --no-build to skip it). Only files whose content changed are uploaded.",
       "examples": [
-        "$ lps composer push",
-        "$ lps composer push --dry-run"
+        "$ lps app push",
+        "$ lps app push search",
+        "$ lps app push --no-build"
       ],
       "flags": {
         "json": {
@@ -1557,6 +1577,12 @@
           "multiple": false,
           "type": "option"
         },
+        "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",
@@ -1570,17 +1596,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "force": {
-          "description": "Allow downgrades and take over plugins/themes installed outside Loopress",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "composer:push",
+      "id": "app:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1590,16 +1610,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "composer",
+        "app",
         "push.js"
       ]
     },
-    "app:list": {
+    "app:remove": {
       "aliases": [],
-      "args": {},
-      "description": "List single-page apps deployed to WordPress",
+      "args": {
+        "name": {
+          "description": "App to remove from WordPress",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Remove a single-page app from WordPress: deletes its bundle from wp-content/loopress/apps/ and unregisters the shortcode. Local files are left untouched.",
       "examples": [
-        "$ lps app list"
+        "$ lps app remove search"
       ],
       "flags": {
         "json": {
@@ -1615,11 +1641,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"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:list",
+      "id": "app:remove",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1646,29 +1686,18 @@
         "dist",
         "commands",
         "app",
-        "list.js"
+        "remove.js"
       ]
     },
-    "app:pull": {
+    "composer:init": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to apps directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull single-page app bundles from WordPress into local files",
+      "args": {},
+      "description": "Create a composer.json wired to WPackagist for installing WordPress.org plugins and themes",
       "examples": [
-        "$ lps app pull"
+        "$ lps composer init",
+        "$ lps composer init --dry-run"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -1682,23 +1711,16 @@
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:pull",
+      "id": "composer:init",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1719,22 +1741,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "app",
-        "pull.js"
+        "composer",
+        "init.js"
       ]
     },
-    "app:push": {
+    "composer:pull": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "Push only this app (defaults to every app in the directory)",
-          "name": "name"
-        }
-      },
-      "description": "Push built single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a built dist/ folder. Only files whose content changed are uploaded.",
+      "args": {},
+      "description": "Pull composer.json and composer.lock from WordPress",
       "examples": [
-        "$ lps app push",
-        "$ lps app push search"
+        "$ lps composer pull",
+        "$ lps composer pull --dry-run"
       ],
       "flags": {
         "json": {
@@ -1757,43 +1774,47 @@
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:push",
+      "id": "composer:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "app",
-        "push.js"
+        "composer",
+        "pull.js"
       ]
     },
-    "app:remove": {
+    "composer:push": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "App to remove from WordPress",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Remove a single-page app from WordPress: deletes its bundle from wp-content/loopress/apps/ and unregisters the shortcode. Local files are left untouched.",
+      "args": {},
+      "description": "Push composer.json to WordPress and run Composer to resolve and install dependencies",
       "examples": [
-        "$ lps app remove search"
+        "$ lps composer push",
+        "$ lps composer push --dry-run"
       ],
       "flags": {
         "json": {
@@ -1823,38 +1844,28 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "description": "Allow downgrades and take over plugins/themes installed outside Loopress",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:remove",
+      "id": "composer:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "dryRunFlag": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "yesFlag": {
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "app",
-        "remove.js"
+        "composer",
+        "push.js"
       ]
     },
     "form:diff": {
@@ -2203,19 +2214,19 @@
         "rollback.js"
       ]
     },
-    "hook:diff": {
+    "menu:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to menus 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 nav menus and the active theme menu locations between your local 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 menu diff",
+        "$ lps menu diff --env staging",
+        "$ lps menu diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -2242,7 +2253,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:diff",
+      "id": "menu:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2276,16 +2287,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "menu",
         "diff.js"
       ]
     },
-    "hook:list": {
+    "menu:list": {
       "aliases": [],
       "args": {},
-      "description": "List hook files (actions, filters, cron) from WordPress",
+      "description": "List nav menus and the active theme menu locations on WordPress",
       "examples": [
-        "$ lps hook list"
+        "$ lps menu list"
       ],
       "flags": {
         "json": {
@@ -2305,7 +2316,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:list",
+      "id": "menu:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2331,31 +2342,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "menu",
         "list.js"
       ]
     },
-    "hook:pull": {
+    "menu:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to menus directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull hook files (actions, filters, cron) from WordPress",
+      "description": "Pull nav menus and the active theme menu locations from WordPress",
       "examples": [
-        "$ lps hook pull",
-        "$ lps hook pull --path ./hooks"
+        "$ lps menu pull"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -2380,12 +2383,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:pull",
+      "id": "menu:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -2406,32 +2409,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "menu",
         "pull.js"
       ]
     },
-    "hook:push": {
+    "menu:push": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to menus directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Push hook files (actions, filters, cron) to WordPress",
+      "description": "Push local nav menus and the active theme menu locations to WordPress. Each menu's post_type/taxonomy items are resolved by slug on the target environment, never by a raw id; an item whose target does not exist there fails the whole menu rather than guessing.",
       "examples": [
-        "$ lps hook push",
-        "$ lps hook push --path ./hooks",
-        "$ lps hook push --prune"
+        "$ lps menu push"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -2452,120 +2446,37 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "prune": {
-          "description": "Delete server-side hook files not present locally after pushing",
-          "name": "prune",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:push",
+      "id": "menu:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "menu",
         "push.js"
       ]
     },
-    "hook:rm": {
-      "aliases": [],
-      "args": {
-        "filename": {
-          "description": "The hook file to remove, its slug without the .php extension (e.g. \"hello\" or \"invoice-pdf/[order_id]\")",
-          "name": "filename",
-          "required": true
-        }
-      },
-      "description": "Remove a hook file (action, filter, cron) from WordPress",
-      "examples": [
-        "$ lps hook rm hello",
-        "$ lps hook rm hello --yes"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "env": {
-          "description": "Target environment by name, overriding the globally active one (lps project switch)",
-          "name": "env",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "hook:rm",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "dryRunFlag": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "yesFlag": {
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "hook",
-        "rm.js"
-      ]
-    },
-    "hook:rollback": {
+    "menu:rollback": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to hooks directory (overrides project config)",
+          "description": "Path to menus directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore hook files to a snapshot taken automatically before an earlier `lps hook push`",
+      "description": "Restore nav menus and menu locations to a snapshot taken automatically before an earlier `lps menu push`",
       "examples": [
-        "$ lps hook rollback",
-        "$ lps hook rollback --list",
-        "$ lps hook rollback --to 1732000000000",
-        "$ lps hook rollback --dry-run"
+        "$ lps menu rollback",
+        "$ lps menu rollback --list",
+        "$ lps menu rollback --to 1732000000000",
+        "$ lps menu rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -2612,7 +2523,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hook:rollback",
+      "id": "menu:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2638,23 +2549,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "hook",
+        "menu",
         "rollback.js"
       ]
     },
-    "menu:diff": {
+    "hook:diff": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to menus directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Show what differs in nav menus and the active theme menu locations between your local files and a WordPress environment, or between two environments",
+      "description": "Show what differs in hook files between your local files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps menu diff",
-        "$ lps menu diff --env staging",
-        "$ lps menu diff --env staging --against production"
+        "$ lps hook diff",
+        "$ lps hook diff --env staging",
+        "$ lps hook diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -2681,7 +2592,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:diff",
+      "id": "hook:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2715,16 +2626,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "hook",
         "diff.js"
       ]
     },
-    "menu:list": {
+    "hook:list": {
       "aliases": [],
       "args": {},
-      "description": "List nav menus and the active theme menu locations on WordPress",
+      "description": "List hook files (actions, filters, cron) from WordPress",
       "examples": [
-        "$ lps menu list"
+        "$ lps hook list"
       ],
       "flags": {
         "json": {
@@ -2744,7 +2655,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:list",
+      "id": "hook:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2770,23 +2681,31 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "hook",
         "list.js"
       ]
     },
-    "menu:pull": {
+    "hook:pull": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to menus directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Pull nav menus and the active theme menu locations from WordPress",
+      "description": "Pull hook files (actions, filters, cron) from WordPress",
       "examples": [
-        "$ lps menu pull"
+        "$ lps hook pull",
+        "$ lps hook pull --path ./hooks"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -2811,49 +2730,124 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:pull",
+      "id": "hook:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "yesFlag": {
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "hook",
+        "pull.js"
+      ]
+    },
+    "hook:push": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to hooks directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Push hook files (actions, filters, cron) to WordPress",
+      "examples": [
+        "$ lps hook push",
+        "$ lps hook push --path ./hooks",
+        "$ lps hook push --prune"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "env": {
+          "description": "Target environment by name, overriding the globally active one (lps project switch)",
+          "name": "env",
+          "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"
+        },
+        "prune": {
+          "description": "Delete server-side hook files not present locally after pushing",
+          "name": "prune",
           "allowNo": false,
           "type": "boolean"
         }
       },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hook:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "menu",
-        "pull.js"
+        "hook",
+        "push.js"
       ]
     },
-    "menu:push": {
+    "hook:rm": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to menus directory (overrides project config)",
-          "name": "path"
+        "filename": {
+          "description": "The hook file to remove, its slug without the .php extension (e.g. \"hello\" or \"invoice-pdf/[order_id]\")",
+          "name": "filename",
+          "required": true
         }
       },
-      "description": "Push local nav menus and the active theme menu locations to WordPress. Each menu's post_type/taxonomy items are resolved by slug on the target environment, never by a raw id; an item whose target does not exist there fails the whole menu rather than guessing.",
+      "description": "Remove a hook file (action, filter, cron) from WordPress",
       "examples": [
-        "$ lps menu push"
+        "$ lps hook rm hello",
+        "$ lps hook rm hello --yes"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -2878,33 +2872,50 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:push",
+      "id": "hook:rm",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "menu",
-        "push.js"
+        "hook",
+        "rm.js"
       ]
     },
-    "menu:rollback": {
+    "hook:rollback": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to menus directory (overrides project config)",
+          "description": "Path to hooks directory (overrides project config)",
           "name": "path"
         }
       },
-      "description": "Restore nav menus and menu locations to a snapshot taken automatically before an earlier `lps menu push`",
+      "description": "Restore hook files to a snapshot taken automatically before an earlier `lps hook push`",
       "examples": [
-        "$ lps menu rollback",
-        "$ lps menu rollback --list",
-        "$ lps menu rollback --to 1732000000000",
-        "$ lps menu rollback --dry-run"
+        "$ lps hook rollback",
+        "$ lps hook rollback --list",
+        "$ lps hook rollback --to 1732000000000",
+        "$ lps hook rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -2951,7 +2962,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "menu:rollback",
+      "id": "hook:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -2977,7 +2988,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "menu",
+        "hook",
         "rollback.js"
       ]
     },
@@ -3897,7 +3908,7 @@
     "plugin:push": {
       "aliases": [],
       "args": {},
-      "description": "Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist",
+      "description": "Install plugins on WordPress to match loopress.json (or composer.json), via Composer + WPackagist",
       "examples": [
         "$ lps plugin push",
         "$ lps plugin push --dry-run",
@@ -3932,6 +3943,12 @@
           "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",
@@ -3939,7 +3956,7 @@
           "type": "boolean"
         },
         "prune": {
-          "description": "Deactivate plugins that are active on the site but absent from loopress.json",
+          "description": "Deactivate plugins that are active on the site but absent from loopress.json (or composer.json)",
           "name": "prune",
           "allowNo": false,
           "type": "boolean"
@@ -5021,6 +5038,187 @@
         "enable.js"
       ]
     },
+    "template:diff": {
+      "aliases": [],
+      "args": {},
+      "description": "Show what differs in block templates and parts between your local files and a WordPress environment, or between two environments. Templates and parts edited in the Site Editor show up too.",
+      "examples": [
+        "$ lps template diff",
+        "$ lps template diff --env staging",
+        "$ lps template 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, overriding the globally active one (lps project switch)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "against": {
+          "description": "Compare the primary environment against this second environment instead of against local files",
+          "name": "against",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "template: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"
+        }
+      },
+      "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",
+        "template",
+        "diff.js"
+      ]
+    },
+    "template:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor",
+      "examples": [
+        "$ lps template list"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "env": {
+          "description": "Target environment by name, overriding the globally active one (lps project switch)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "template:list",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "template",
+        "list.js"
+      ]
+    },
+    "template:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it. It is never activated for you.",
+      "examples": [
+        "$ lps template push",
+        "$ lps template push --dry-run"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "env": {
+          "description": "Target environment by name, overriding the globally active one (lps project switch)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "template:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "template",
+        "push.js"
+      ]
+    },
     "theme:add": {
       "aliases": [],
       "args": {
@@ -5274,7 +5472,7 @@
         "status.js"
       ]
     },
-    "theme-styles:diff": {
+    "theme:style:diff": {
       "aliases": [],
       "args": {
         "path": {
@@ -5284,9 +5482,9 @@
       },
       "description": "Show what differs in the active block theme's Global Styles (Site Editor > Styles) between your local file and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps theme-styles diff",
-        "$ lps theme-styles diff --env staging",
-        "$ lps theme-styles diff --env staging --against production"
+        "$ lps theme style diff",
+        "$ lps theme style diff --env staging",
+        "$ lps theme style diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -5313,7 +5511,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme-styles:diff",
+      "id": "theme:style:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5347,11 +5545,12 @@
       "relativePath": [
         "dist",
         "commands",
-        "theme-styles",
+        "theme",
+        "style",
         "diff.js"
       ]
     },
-    "theme-styles:pull": {
+    "theme:style:pull": {
       "aliases": [],
       "args": {
         "path": {
@@ -5361,7 +5560,7 @@
       },
       "description": "Pull the active block theme's Global Styles customizations (Site Editor > Styles) from WordPress into a local file",
       "examples": [
-        "$ lps theme-styles pull"
+        "$ lps theme style pull"
       ],
       "flags": {
         "env": {
@@ -5381,7 +5580,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme-styles:pull",
+      "id": "theme:style:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5407,11 +5606,12 @@
       "relativePath": [
         "dist",
         "commands",
-        "theme-styles",
+        "theme",
+        "style",
         "pull.js"
       ]
     },
-    "theme-styles:push": {
+    "theme:style:push": {
       "aliases": [],
       "args": {
         "path": {
@@ -5421,7 +5621,7 @@
       },
       "description": "Push the local Global Styles file to the active block theme's Site Editor > Styles on WordPress",
       "examples": [
-        "$ lps theme-styles push"
+        "$ lps theme style push"
       ],
       "flags": {
         "env": {
@@ -5441,7 +5641,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme-styles:push",
+      "id": "theme:style:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5450,11 +5650,12 @@
       "relativePath": [
         "dist",
         "commands",
-        "theme-styles",
+        "theme",
+        "style",
         "push.js"
       ]
     },
-    "theme-styles:rollback": {
+    "theme:style:rollback": {
       "aliases": [],
       "args": {
         "path": {
@@ -5462,12 +5663,12 @@
           "name": "path"
         }
       },
-      "description": "Restore the active theme’s Global Styles to a snapshot taken automatically before an earlier `lps theme-styles push`",
+      "description": "Restore the active theme's Global Styles to a snapshot taken automatically before an earlier `lps theme style push`",
       "examples": [
-        "$ lps theme-styles rollback",
-        "$ lps theme-styles rollback --list",
-        "$ lps theme-styles rollback --to 1732000000000",
-        "$ lps theme-styles rollback --dry-run"
+        "$ lps theme style rollback",
+        "$ lps theme style rollback --list",
+        "$ lps theme style rollback --to 1732000000000",
+        "$ lps theme style rollback --dry-run"
       ],
       "flags": {
         "json": {
@@ -5514,7 +5715,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "theme-styles:rollback",
+      "id": "theme:style:rollback",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -5540,10 +5741,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "theme-styles",
+        "theme",
+        "style",
         "rollback.js"
       ]
     }
   },
-  "version": "0.27.0"
+  "version": "0.28.0"
 }