@loopress/cli 0.23.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": {},
@@ -1299,12 +1560,19 @@
         "push.js"
       ]
     },
-    "form:list": {
+    "form:diff": {
       "aliases": [],
-      "args": {},
-      "description": "List forms from WordPress",
+      "args": {
+        "path": {
+          "description": "Path to forms directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Show what differs in forms between your local files and a WordPress environment, or between two environments",
       "examples": [
-        "$ lps form list"
+        "$ lps form diff",
+        "$ lps form diff --env staging",
+        "$ lps form diff --env staging --against production"
       ],
       "flags": {
         "json": {
@@ -1320,11 +1588,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "against": {
+          "description": "Compare the primary environment against this second environment instead of against local files",
+          "name": "against",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "form:list",
+      "id": "form:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1346,57 +1621,53 @@
           "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",
         "form",
-        "list.js"
+        "diff.js"
       ]
     },
-    "form:pull": {
+    "form:list": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to forms directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull forms from WordPress",
+      "args": {},
+      "description": "List forms from WordPress",
       "examples": [
-        "$ lps form pull"
+        "$ lps form 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"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Answer yes to confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "form:pull",
+      "id": "form:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1418,10 +1689,10 @@
         "dist",
         "commands",
         "form",
-        "pull.js"
+        "list.js"
       ]
     },
-    "form:push": {
+    "form:pull": {
       "aliases": [],
       "args": {
         "path": {
@@ -1429,9 +1700,9 @@
           "name": "path"
         }
       },
-      "description": "Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json` convention.",
+      "description": "Pull forms from WordPress",
       "examples": [
-        "$ lps form push"
+        "$ lps form pull"
       ],
       "flags": {
         "env": {
@@ -1458,33 +1729,47 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "form:push",
+      "id": "form:pull",
       "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",
         "form",
-        "push.js"
+        "pull.js"
       ]
     },
-    "plugin:add": {
+    "form:push": {
       "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": "Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json` convention.",
       "examples": [
-        "$ lps plugin add woocommerce",
-        "$ lps plugin add woocommerce --version 9.4.2",
-        "$ lps plugin add contact-form-7 --dry-run"
+        "$ lps form push"
       ],
       "flags": {
         "env": {
@@ -1501,9 +1786,61 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "version": {
-          "description": "Exact version to pin (default: \"latest\", tracked on every push)",
-          "name": "version",
+        "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"
@@ -1511,12 +1848,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:add",
+      "id": "hook:diff",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "dryRunFlag": {
         "dry-run": {
           "char": "d",
@@ -1533,20 +1870,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"
+        "hook",
+        "diff.js"
       ]
     },
-    "plugin:audit": {
+    "hook:list": {
       "aliases": [],
       "args": {},
-      "description": "Check the plugins in loopress.json for known vulnerabilities and health issues",
+      "description": "List hook files (actions, filters, cron) from WordPress",
       "examples": [
-        "$ lps plugin audit"
+        "$ lps hook list"
       ],
       "flags": {
         "json": {
@@ -1566,7 +1911,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:audit",
+      "id": "hook:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1592,17 +1937,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
-        "audit.js"
+        "hook",
+        "list.js"
       ]
     },
-    "plugin:pull": {
+    "hook:pull": {
       "aliases": [],
-      "args": {},
-      "description": "Pull installed plugins from WordPress into loopress.json, pinned to their live versions",
+      "args": {
+        "path": {
+          "description": "Path to hooks directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Pull hook files (actions, filters, cron) from WordPress",
       "examples": [
-        "$ lps plugin pull",
-        "$ lps plugin pull --dry-run"
+        "$ lps hook pull",
+        "$ lps hook pull --path ./hooks"
       ],
       "flags": {
         "json": {
@@ -1625,11 +1975,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": "plugin:pull",
+      "id": "hook:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1655,18 +2012,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
+        "hook",
         "pull.js"
       ]
     },
-    "plugin:push": {
+    "hook:push": {
       "aliases": [],
-      "args": {},
-      "description": "Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist",
+      "args": {
+        "path": {
+          "description": "Path to hooks directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Push hook files (actions, filters, cron) to WordPress",
       "examples": [
-        "$ lps plugin push",
-        "$ lps plugin push --dry-run",
-        "$ lps plugin push --force --prune"
+        "$ lps hook push",
+        "$ lps hook push --path ./hooks"
       ],
       "flags": {
         "json": {
@@ -1696,42 +2057,536 @@
           "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"
         },
-        "force": {
-          "description": "Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)",
-          "name": "force",
+        "env": {
+          "description": "Target environment by name, overriding the globally active one (lps project switch)",
+          "name": "env",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         },
-        "prune": {
-          "description": "Deactivate plugins that are active on the site but absent from loopress.json",
-          "name": "prune",
+        "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:push",
+      "id": "plugin:add",
       "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"
+        "add.js"
       ]
     },
-    "plugin:status": {
+    "plugin:audit": {
       "aliases": [],
       "args": {},
-      "description": "Compare the plugins on WordPress against loopress.json and report drift",
+      "description": "Check the plugins in loopress.json for known vulnerabilities and health issues",
       "examples": [
-        "$ lps plugin status"
+        "$ lps plugin audit"
       ],
       "flags": {
         "json": {
@@ -1751,7 +2606,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:status",
+      "id": "plugin:audit",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1778,15 +2633,16 @@
         "dist",
         "commands",
         "plugin",
-        "status.js"
+        "audit.js"
       ]
     },
-    "page:list": {
+    "plugin:pull": {
       "aliases": [],
       "args": {},
-      "description": "List pages from WordPress",
+      "description": "Pull installed plugins from WordPress into loopress.json, pinned to their live versions",
       "examples": [
-        "$ lps page list"
+        "$ lps plugin pull",
+        "$ lps plugin pull --dry-run"
       ],
       "flags": {
         "json": {
@@ -1802,11 +2658,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "page:list",
+      "id": "plugin:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -1832,21 +2695,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
-        "list.js"
+        "plugin",
+        "pull.js"
       ]
     },
-    "page:pull": {
+    "plugin:push": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to pages directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull pages from WordPress",
+      "args": {},
+      "description": "Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist",
       "examples": [
-        "$ lps page pull"
+        "$ lps plugin push",
+        "$ lps plugin push --dry-run",
+        "$ lps plugin push --force --prune"
       ],
       "flags": {
         "json": {
@@ -1876,51 +2736,42 @@
           "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": "page:pull",
+      "id": "plugin: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",
-        "page",
-        "pull.js"
+        "plugin",
+        "push.js"
       ]
     },
-    "page:push": {
+    "plugin:status": {
       "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": "Compare the plugins on WordPress against loopress.json and report drift",
       "examples": [
-        "$ lps page push"
+        "$ lps plugin status"
       ],
       "flags": {
         "json": {
@@ -1936,36 +2787,38 @@
           "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",
-          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
-        },
+        }
+      },
+      "yesFlag": {
         "yes": {
           "char": "y",
           "description": "Answer yes to confirmation prompts",
-          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "page:push",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "page",
-        "push.js"
+        "plugin",
+        "status.js"
       ]
     },
     "project:config": {
@@ -2177,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": {},
@@ -2365,6 +3295,83 @@
         "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",
+          "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",
+        "snippet",
+        "diff.js"
+      ]
+    },
     "snippet:list": {
       "aliases": [],
       "args": {},
@@ -2879,5 +3886,5 @@
       ]
     }
   },
-  "version": "0.23.0"
+  "version": "0.24.0"
 }