@loopress/cli 0.22.0 → 0.24.0

package/oclif.manifest.json

@@ -6,19 +6,19 @@
       "description": "Watch project files and push changes to the local WordPress instance as they happen. Always targets the \"local\" environment, run `lps snippet push` etc. directly for any other environment.",
       "examples": [
         "$ lps dev",
-        "$ lps dev --only=snippets,pages",
+        "$ lps dev --only=snippets,api",
         "$ lps dev --skip=plugins"
       ],
       "flags": {
         "only": {
-          "description": "Only watch these resource types (comma-separated): snippets, pages, api, plugins",
+          "description": "Only watch these resource types (comma-separated): snippets, api, plugins",
           "name": "only",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "skip": {
-          "description": "Skip these resource types (comma-separated): snippets, pages, api, plugins",
+          "description": "Skip these resource types (comma-separated): snippets, api, plugins",
           "name": "skip",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -40,6 +40,113 @@
         "dev.js"
       ]
     },
+    "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, SEO, 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",
+        "$ lps diff --env staging --against production",
+        "$ lps diff --only snippet --only acf",
+        "$ lps diff --skip composer"
+      ],
+      "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"
+        },
+        "only": {
+          "description": "Only compare these resources",
+          "name": "only",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "snippet",
+            "form",
+            "acf",
+            "api",
+            "hook",
+            "seo",
+            "option",
+            "composer"
+          ],
+          "type": "option"
+        },
+        "skip": {
+          "description": "Compare every resource except these",
+          "name": "skip",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "snippet",
+            "form",
+            "acf",
+            "api",
+            "hook",
+            "seo",
+            "option",
+            "composer"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "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",
+        "diff.js"
+      ]
+    },
     "doctor": {
       "aliases": [],
       "args": {},
@@ -210,7 +317,7 @@
     "pull": {
       "aliases": [],
       "args": {},
-      "description": "Pull all content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, from WordPress",
+      "description": "Pull all content, plugins, composer dependencies, ACF, API routes, hooks, forms, SEO, options, and snippets, from WordPress",
       "examples": [
         "$ lps pull",
         "$ lps pull --env staging",
@@ -273,7 +380,7 @@
     "push": {
       "aliases": [],
       "args": {},
-      "description": "Push all local content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, to WordPress",
+      "description": "Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, SEO, options, and snippets, to WordPress",
       "examples": [
         "$ lps push",
         "$ lps push --env staging",
@@ -424,6 +531,83 @@
         "validate.js"
       ]
     },
+    "acf:diff": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to ACF directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Show what differs in ACF field groups, post types, taxonomies, and options pages between your local files and a WordPress environment, or between two environments",
+      "examples": [
+        "$ lps acf diff",
+        "$ lps acf diff --env staging",
+        "$ lps acf 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": "acf: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",
+        "acf",
+        "diff.js"
+      ]
+    },
     "acf:list": {
       "aliases": [],
       "args": {},
@@ -638,6 +822,83 @@
         "push.js"
       ]
     },
+    "api:diff": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to api directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Show what differs in custom API route files between your local files and a WordPress environment, or between two environments",
+      "examples": [
+        "$ lps api diff",
+        "$ lps api diff --env staging",
+        "$ lps api 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": "api: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",
+        "api",
+        "diff.js"
+      ]
+    },
     "api:list": {
       "aliases": [],
       "args": {},
@@ -857,38 +1118,37 @@
         "push.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",
@@ -909,17 +1169,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": {
@@ -942,11 +1206,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",
@@ -972,17 +1243,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "composer",
+        "app",
         "pull.js"
       ]
     },
-    "composer:push": {
+    "app:push": {
       "aliases": [],
-      "args": {},
-      "description": "Push composer.json and composer.lock to WordPress and run composer install",
+      "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.",
       "examples": [
-        "$ lps composer push",
-        "$ lps composer push --dry-run"
+        "$ lps app push",
+        "$ lps app push search"
       ],
       "flags": {
         "json": {
@@ -1016,7 +1292,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "composer:push",
+      "id": "app:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1026,16 +1302,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "composer",
+        "app",
         "push.js"
       ]
     },
-    "form:list": {
+    "app:remove": {
       "aliases": [],
-      "args": {},
-      "description": "List forms from WordPress",
-      "examples": [
-        "$ lps form list"
+      "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 remove search"
       ],
       "flags": {
         "json": {
@@ -1045,59 +1327,6 @@
           "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": "form: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",
-        "form",
-        "list.js"
-      ]
-    },
-    "form:pull": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to forms directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull forms from WordPress",
-      "examples": [
-        "$ lps form pull"
-      ],
-      "flags": {
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -1122,12 +1351,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "form:pull",
+      "id": "app:remove",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1148,21 +1377,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "form",
-        "pull.js"
+        "app",
+        "remove.js"
       ]
     },
-    "form:push": {
+    "composer:init": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to forms directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json` convention.",
+      "args": {},
+      "description": "Create a composer.json wired to WPackagist for installing WordPress.org plugins and themes",
       "examples": [
-        "$ lps form push"
+        "$ lps composer init",
+        "$ lps composer init --dry-run"
       ],
       "flags": {
         "env": {
@@ -1178,61 +1403,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": "form:push",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "form",
-        "push.js"
-      ]
-    },
-    "page:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List pages from WordPress",
-      "examples": [
-        "$ lps page 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": "page:list",
+      "id": "composer:init",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1253,21 +1433,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
-        "list.js"
+        "composer",
+        "init.js"
       ]
     },
-    "page:pull": {
+    "composer:pull": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to pages directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull pages from WordPress",
+      "args": {},
+      "description": "Pull composer.json and composer.lock from WordPress",
       "examples": [
-        "$ lps page pull"
+        "$ lps composer pull",
+        "$ lps composer pull --dry-run"
       ],
       "flags": {
         "json": {
@@ -1290,18 +1466,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": "page:pull",
+      "id": "composer:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1327,21 +1496,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
+        "composer",
         "pull.js"
       ]
     },
-    "page:push": {
+    "composer:push": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to pages directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Push pages to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.",
+      "args": {},
+      "description": "Push composer.json (and composer.lock, if present) to WordPress and run Composer",
       "examples": [
-        "$ lps page push"
+        "$ lps composer push",
+        "$ lps composer push --dry-run"
       ],
       "flags": {
         "json": {
@@ -1371,11 +1536,17 @@
           "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": "page:push",
+      "id": "composer:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1385,25 +1556,32 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
+        "composer",
         "push.js"
       ]
     },
-    "plugin:add": {
+    "form:diff": {
       "aliases": [],
       "args": {
-        "slug": {
-          "description": "Plugin slug on WordPress.org",
-          "name": "slug",
-          "required": true
+        "path": {
+          "description": "Path to forms directory (overrides project config)",
+          "name": "path"
         }
       },
-      "description": "Add a WordPress.org plugin to loopress.json",
+      "description": "Show what differs in forms between your local files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps plugin add woocommerce",
-        "$ lps plugin add contact-form-7 --dry-run"
+        "$ lps form diff",
+        "$ lps form diff --env staging",
+        "$ lps form 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",
@@ -1411,22 +1589,22 @@
           "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "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": "plugin:add",
+      "id": "form:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1443,21 +1621,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",
-        "plugin",
-        "add.js"
+        "form",
+        "diff.js"
       ]
     },
-    "plugin:pull": {
+    "form:list": {
       "aliases": [],
       "args": {},
-      "description": "Pull installed plugins from WordPress into loopress.json",
+      "description": "List forms from WordPress",
       "examples": [
-        "$ lps plugin pull",
-        "$ lps plugin pull --dry-run"
+        "$ lps form list"
       ],
       "flags": {
         "json": {
@@ -1473,18 +1658,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:pull",
+      "id": "form:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1510,26 +1688,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
-        "pull.js"
+        "form",
+        "list.js"
       ]
     },
-    "plugin:push": {
+    "form:pull": {
       "aliases": [],
-      "args": {},
-      "description": "Push plugins to WordPress to match loopress.json",
+      "args": {
+        "path": {
+          "description": "Path to forms directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Pull forms from WordPress",
       "examples": [
-        "$ lps plugin push",
-        "$ lps plugin push --dry-run"
+        "$ lps form pull"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "env": {
           "description": "Target environment by name, overriding the globally active one (lps project switch)",
           "name": "env",
@@ -1554,18 +1729,1096 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:push",
+      "id": "form:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
-        "push.js"
+        "form",
+        "pull.js"
+      ]
+    },
+    "form:push": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to forms directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json` convention.",
+      "examples": [
+        "$ lps form push"
+      ],
+      "flags": {
+        "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": "form:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "form",
+        "push.js"
+      ]
+    },
+    "hook:diff": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to hooks 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",
+      "examples": [
+        "$ lps hook diff",
+        "$ lps hook diff --env staging",
+        "$ lps hook 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": "hook:diff",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "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",
+        "hook",
+        "diff.js"
+      ]
+    },
+    "hook:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List hook files (actions, filters, cron) from WordPress",
+      "examples": [
+        "$ lps hook 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": "hook: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",
+        "hook",
+        "list.js"
+      ]
+    },
+    "hook:pull": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to hooks directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Pull hook files (actions, filters, cron) from WordPress",
+      "examples": [
+        "$ 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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hook:pull",
+      "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",
+        "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"
+      ],
+      "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:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "hook",
+        "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, 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"
+        },
+        "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"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "option",
+        "add.js"
+      ]
+    },
+    "option:diff": {
+      "aliases": [],
+      "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 option diff",
+        "$ lps option diff --env staging",
+        "$ lps option 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": "option: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",
+        "option",
+        "diff.js"
+      ]
+    },
+    "option: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.",
+      "examples": [
+        "$ lps option list",
+        "$ lps option list --no-core"
+      ],
+      "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"
+        },
+        "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",
+      "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",
+        "option",
+        "list.js"
+      ]
+    },
+    "option:pull": {
+      "aliases": [],
+      "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 option 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",
+          "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": "option: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",
+        "option",
+        "pull.js"
+      ]
+    },
+    "option:push": {
+      "aliases": [],
+      "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 option 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",
+          "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": "option:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "option",
+        "push.js"
+      ]
+    },
+    "option:remove": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Option name to stop tracking",
+          "name": "name",
+          "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.",
+      "examples": [
+        "$ lps option remove wpseo_titles",
+        "$ lps option remove wpseo_titles --local-only"
+      ],
+      "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"
+        },
+        "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:remove",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "option",
+        "remove.js"
+      ]
+    },
+    "plugin:add": {
+      "aliases": [],
+      "args": {
+        "slug": {
+          "description": "Plugin slug on WordPress.org",
+          "name": "slug",
+          "required": true
+        }
+      },
+      "description": "Add a WordPress.org plugin to loopress.json",
+      "examples": [
+        "$ lps plugin add woocommerce",
+        "$ lps plugin add woocommerce --version 9.4.2",
+        "$ lps plugin add contact-form-7 --dry-run"
+      ],
+      "flags": {
+        "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"
+        },
+        "version": {
+          "description": "Exact version to pin (default: \"latest\", tracked on every push)",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:add",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "add.js"
+      ]
+    },
+    "plugin:audit": {
+      "aliases": [],
+      "args": {},
+      "description": "Check the plugins in loopress.json for known vulnerabilities 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, overriding the globally active one (lps project switch)",
+          "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"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "audit.js"
+      ]
+    },
+    "plugin:pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Pull installed plugins from WordPress into loopress.json, pinned to their live versions",
+      "examples": [
+        "$ lps plugin pull",
+        "$ lps plugin pull --dry-run"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "env": {
+          "description": "Target environment by name, overriding the globally active one (lps project switch)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin: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",
+        "plugin",
+        "pull.js"
+      ]
+    },
+    "plugin:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist",
+      "examples": [
+        "$ lps plugin push",
+        "$ lps plugin push --dry-run",
+        "$ lps plugin push --force --prune"
+      ],
+      "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"
+        },
+        "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",
+          "name": "prune",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "push.js"
+      ]
+    },
+    "plugin:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Compare the plugins on WordPress against loopress.json and report drift",
+      "examples": [
+        "$ lps plugin status"
+      ],
+      "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": "plugin:status",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "status.js"
       ]
     },
     "project:config": {
@@ -1777,6 +3030,83 @@
         "switch.js"
       ]
     },
+    "seo:diff": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to SEO directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Show what differs in SEO settings, post meta, and redirects between your local files and a WordPress environment, or between two environments",
+      "examples": [
+        "$ lps seo diff",
+        "$ lps seo diff --env staging",
+        "$ lps seo 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": "seo: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",
+        "seo",
+        "diff.js"
+      ]
+    },
     "seo:list": {
       "aliases": [],
       "args": {},
@@ -1938,31 +3268,108 @@
         "dry-run": {
           "char": "d",
           "description": "Show what would change without making changes",
-          "name": "dry-run",
+          "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": "seo:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "seo",
+        "push.js"
+      ]
+    },
+    "snippet:diff": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Show what differs in snippets between your local 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"
+      ],
+      "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": "snippet: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",
-          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "seo:push",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
+      "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",
-        "seo",
-        "push.js"
+        "snippet",
+        "diff.js"
       ]
     },
     "snippet:list": {
@@ -2231,7 +3638,253 @@
         "telemetry",
         "enable.js"
       ]
+    },
+    "theme:add": {
+      "aliases": [],
+      "args": {
+        "slug": {
+          "description": "Theme slug on WordPress.org",
+          "name": "slug",
+          "required": true
+        }
+      },
+      "description": "Add a WordPress.org theme to loopress.json",
+      "examples": [
+        "$ lps theme add generatepress",
+        "$ lps theme add generatepress --version 3.4.0"
+      ],
+      "flags": {
+        "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"
+        },
+        "version": {
+          "description": "Exact version to pin (default: \"latest\")",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "theme:add",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "theme",
+        "add.js"
+      ]
+    },
+    "theme:pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Pull installed themes from WordPress into loopress.json, pinned to their live versions",
+      "examples": [
+        "$ lps theme 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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "theme:pull",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "theme",
+        "pull.js"
+      ]
+    },
+    "theme:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Install themes on WordPress to match loopress.json (versions only, never switches the active theme)",
+      "examples": [
+        "$ lps theme push",
+        "$ lps theme push --force"
+      ],
+      "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"
+        },
+        "force": {
+          "description": "Allow downgrades and take over themes installed outside Loopress",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "theme:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "theme",
+        "push.js"
+      ]
+    },
+    "theme:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Compare the themes on WordPress against loopress.json and report version drift",
+      "examples": [
+        "$ lps theme status"
+      ],
+      "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": "theme:status",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "yesFlag": {
+        "yes": {
+          "char": "y",
+          "description": "Answer yes to confirmation prompts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "theme",
+        "status.js"
+      ]
     }
   },
-  "version": "0.22.0"
+  "version": "0.24.0"
 }