@loopress/cli 0.3.0 → 0.4.0

package/README.md

@@ -1,58 +1,53 @@
-Loopress
-=================
+# Loopress
 
 A new CLI generated with oclif
 
-
 [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
 [![Version](https://img.shields.io/npm/v/mynewcli.svg)](https://npmjs.org/package/mynewcli)
 [![Downloads/week](https://img.shields.io/npm/dw/mynewcli.svg)](https://npmjs.org/package/mynewcli)
 
-
 <!-- toc -->
+* [Loopress](#loopress)
 * [Usage](#usage)
 * [Commands](#commands)
 <!-- tocstop -->
+
 # Usage
+
 <!-- usage -->
 ```sh-session
 $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.3.0 linux-x64 node-v24.16.0
+@loopress/cli/0.4.0 linux-x64 node-v24.16.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
 ...
 ```
 <!-- usagestop -->
+
 # Commands
+
 <!-- commands -->
 * [`lps help [COMMAND]`](#lps-help-command)
 * [`lps login`](#lps-login)
 * [`lps logout`](#lps-logout)
-* [`lps plugins`](#lps-plugins)
-* [`lps plugins add PLUGIN`](#lps-plugins-add-plugin)
-* [`lps plugins:inspect PLUGIN...`](#lps-pluginsinspect-plugin)
-* [`lps plugins install PLUGIN`](#lps-plugins-install-plugin)
-* [`lps plugins link PATH`](#lps-plugins-link-path)
-* [`lps plugins remove [PLUGIN]`](#lps-plugins-remove-plugin)
-* [`lps plugins reset`](#lps-plugins-reset)
-* [`lps plugins uninstall [PLUGIN]`](#lps-plugins-uninstall-plugin)
-* [`lps plugins unlink [PLUGIN]`](#lps-plugins-unlink-plugin)
-* [`lps plugins update`](#lps-plugins-update)
+* [`lps plugin pull`](#lps-plugin-pull)
+* [`lps plugin push`](#lps-plugin-push)
+* [`lps plugin require SLUG [VERSION]`](#lps-plugin-require-slug-version)
 * [`lps project config`](#lps-project-config)
 * [`lps project list`](#lps-project-list)
 * [`lps project remove`](#lps-project-remove)
 * [`lps project remove-env`](#lps-project-remove-env)
 * [`lps project switch`](#lps-project-switch)
 * [`lps project switch-env`](#lps-project-switch-env)
-* [`lps snippets list`](#lps-snippets-list)
-* [`lps snippets pull [PATH]`](#lps-snippets-pull-path)
-* [`lps snippets push [PATH]`](#lps-snippets-push-path)
-* [`lps styles pull`](#lps-styles-pull)
-* [`lps styles push`](#lps-styles-push)
+* [`lps snippet list`](#lps-snippet-list)
+* [`lps snippet pull [PATH]`](#lps-snippet-pull-path)
+* [`lps snippet push [PATH]`](#lps-snippet-push-path)
+* [`lps style pull`](#lps-style-pull)
+* [`lps style push`](#lps-style-push)
 
 ## `lps help [COMMAND]`
 
@@ -89,7 +84,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -106,297 +101,94 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/logout.ts)_
 
-## `lps plugins`
+## `lps plugin pull`
 
-List installed plugins.
+Pull installed plugins from WordPress into loopress.json
 
 ```
 USAGE
-  $ lps plugins [--json] [--core]
+  $ lps plugin pull [--password <value>] [--url <value>] [--user <value>] [-d]
 
 FLAGS
-  --core  Show core plugins.
+  -d, --dry-run  Show what would be written without making changes
 
 GLOBAL FLAGS
-  --json  Format output as json.
+  --password=<value>  WordPress application password (fallback; prefer `lps project config`)
+  --url=<value>       WordPress URL (fallback; prefer `lps project config`)
+  --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  List installed plugins.
+  Pull installed plugins from WordPress into loopress.json
 
 EXAMPLES
-  $ lps plugins
-```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/index.ts)_
-
-## `lps plugins add PLUGIN`
-
-Installs a plugin into lps.
+  $ lps plugins pull
 
+  $ lps plugins pull --dry-run
 ```
-USAGE
-  $ lps plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
-
-ARGUMENTS
-  PLUGIN...  Plugin to install.
-
-FLAGS
-  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
-  -h, --help     Show CLI help.
-  -s, --silent   Silences npm output.
-  -v, --verbose  Show verbose npm output.
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Installs a plugin into lps.
 
-  Uses npm to install plugins.
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/plugin/pull.ts)_
 
-  Installation of a user-installed plugin will override a core plugin.
-
-  Use the LPS_NPM_LOG_LEVEL environment variable to set the npm loglevel.
-  Use the LPS_NPM_REGISTRY environment variable to set the npm registry.
-
-ALIASES
-  $ lps plugins add
-
-EXAMPLES
-  Install a plugin from npm registry.
+## `lps plugin push`
 
-    $ lps plugins add myplugin
-
-  Install a plugin from a github url.
-
-    $ lps plugins add https://github.com/someuser/someplugin
-
-  Install a plugin from a github slug.
-
-    $ lps plugins add someuser/someplugin
-```
-
-## `lps plugins:inspect PLUGIN...`
-
-Displays installation properties of a plugin.
+Sync plugins on WordPress to match loopress.json
 
 ```
 USAGE
-  $ lps plugins inspect PLUGIN...
-
-ARGUMENTS
-  PLUGIN...  [default: .] Plugin to inspect.
+  $ lps plugin push [--password <value>] [--url <value>] [--user <value>] [-d]
 
 FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
+  -d, --dry-run  Show what would change without making changes
 
 GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Displays installation properties of a plugin.
-
-EXAMPLES
-  $ lps plugins inspect myplugin
-```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/inspect.ts)_
-
-## `lps plugins install PLUGIN`
-
-Installs a plugin into lps.
-
-```
-USAGE
-  $ lps plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
-
-ARGUMENTS
-  PLUGIN...  Plugin to install.
-
-FLAGS
-  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
-  -h, --help     Show CLI help.
-  -s, --silent   Silences npm output.
-  -v, --verbose  Show verbose npm output.
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Installs a plugin into lps.
-
-  Uses npm to install plugins.
-
-  Installation of a user-installed plugin will override a core plugin.
-
-  Use the LPS_NPM_LOG_LEVEL environment variable to set the npm loglevel.
-  Use the LPS_NPM_REGISTRY environment variable to set the npm registry.
-
-ALIASES
-  $ lps plugins add
-
-EXAMPLES
-  Install a plugin from npm registry.
-
-    $ lps plugins install myplugin
-
-  Install a plugin from a github url.
-
-    $ lps plugins install https://github.com/someuser/someplugin
-
-  Install a plugin from a github slug.
-
-    $ lps plugins install someuser/someplugin
-```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/install.ts)_
-
-## `lps plugins link PATH`
-
-Links a plugin into the CLI for development.
-
-```
-USAGE
-  $ lps plugins link PATH [-h] [--install] [-v]
-
-ARGUMENTS
-  PATH  [default: .] path to plugin
-
-FLAGS
-  -h, --help          Show CLI help.
-  -v, --verbose
-      --[no-]install  Install dependencies after linking the plugin.
-
-DESCRIPTION
-  Links a plugin into the CLI for development.
-
-  Installation of a linked plugin will override a user-installed or core plugin.
-
-  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
-  command will override the user-installed or core plugin implementation. This is useful for development work.
-
-
-EXAMPLES
-  $ lps plugins link myplugin
-```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/link.ts)_
-
-## `lps plugins remove [PLUGIN]`
-
-Removes a plugin from the CLI.
-
-```
-USAGE
-  $ lps plugins remove [PLUGIN...] [-h] [-v]
-
-ARGUMENTS
-  [PLUGIN...]  plugin to uninstall
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
+  --password=<value>  WordPress application password (fallback; prefer `lps project config`)
+  --url=<value>       WordPress URL (fallback; prefer `lps project config`)
+  --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ lps plugins unlink
-  $ lps plugins remove
+  Sync plugins on WordPress to match loopress.json
 
 EXAMPLES
-  $ lps plugins remove myplugin
-```
-
-## `lps plugins reset`
+  $ lps plugins push
 
-Remove all user-installed and linked plugins.
-
-```
-USAGE
-  $ lps plugins reset [--hard] [--reinstall]
-
-FLAGS
-  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
-  --reinstall  Reinstall all plugins after uninstalling.
+  $ lps plugins push --dry-run
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/reset.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/plugin/push.ts)_
 
-## `lps plugins uninstall [PLUGIN]`
+## `lps plugin require SLUG [VERSION]`
 
-Removes a plugin from the CLI.
+Add a plugin to loopress.json, resolving its latest version from WordPress.org
 
 ```
 USAGE
-  $ lps plugins uninstall [PLUGIN...] [-h] [-v]
+  $ lps plugin require SLUG [VERSION] [--password <value>] [--url <value>] [--user <value>] [-d]
 
 ARGUMENTS
-  [PLUGIN...]  plugin to uninstall
+  SLUG       Plugin slug (WordPress.org)
+  [VERSION]  Version to pin (default: latest)
 
 FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ lps plugins unlink
-  $ lps plugins remove
-
-EXAMPLES
-  $ lps plugins uninstall myplugin
-```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/uninstall.ts)_
-
-## `lps plugins unlink [PLUGIN]`
-
-Removes a plugin from the CLI.
-
-```
-USAGE
-  $ lps plugins unlink [PLUGIN...] [-h] [-v]
+  -d, --dry-run  Show what would be written without making changes
 
-ARGUMENTS
-  [PLUGIN...]  plugin to uninstall
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
+GLOBAL FLAGS
+  --password=<value>  WordPress application password (fallback; prefer `lps project config`)
+  --url=<value>       WordPress URL (fallback; prefer `lps project config`)
+  --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ lps plugins unlink
-  $ lps plugins remove
+  Add a plugin to loopress.json, resolving its latest version from WordPress.org
 
 EXAMPLES
-  $ lps plugins unlink myplugin
-```
-
-## `lps plugins update`
-
-Update installed plugins.
-
-```
-USAGE
-  $ lps plugins update [-h] [-v]
+  $ lps plugins require woocommerce
 
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
+  $ lps plugins require woocommerce 8.9.1
 
-DESCRIPTION
-  Update installed plugins.
+  $ lps plugins require contact-form-7 --dry-run
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/update.ts)_
+_See code: [src/commands/plugin/require.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/plugin/require.ts)_
 
 ## `lps project config`
 
@@ -413,7 +205,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -430,7 +222,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/project/list.ts)_
 
 ## `lps project remove`
 
@@ -447,7 +239,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/project/remove.ts)_
 
 ## `lps project remove-env`
 
@@ -464,7 +256,7 @@ EXAMPLES
   $ lps project remove-env
 ```
 
-_See code: [src/commands/project/remove-env.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/project/remove-env.ts)_
+_See code: [src/commands/project/remove-env.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/project/remove-env.ts)_
 
 ## `lps project switch`
 
@@ -481,7 +273,7 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/project/switch.ts)_
 
 ## `lps project switch-env`
 
@@ -498,15 +290,15 @@ EXAMPLES
   $ lps project switch-env
 ```
 
-_See code: [src/commands/project/switch-env.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/project/switch-env.ts)_
+_See code: [src/commands/project/switch-env.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/project/switch-env.ts)_
 
-## `lps snippets list`
+## `lps snippet list`
 
 List snippets from WordPress
 
 ```
 USAGE
-  $ lps snippets list [--password <value>] [--url <value>] [--user <value>] [-j] [-p code-snippets|wpcode]
+  $ lps snippet list [--password <value>] [--url <value>] [--user <value>] [-j] [-p code-snippets|wpcode]
 
 FLAGS
   -j, --json             Output in JSON format
@@ -529,15 +321,15 @@ EXAMPLES
   $ lps snippets list --plugin wpcode
 ```
 
-_See code: [src/commands/snippets/list.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/snippets/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/snippet/list.ts)_
 
-## `lps snippets pull [PATH]`
+## `lps snippet pull [PATH]`
 
 Pull snippets from WordPress
 
 ```
 USAGE
-  $ lps snippets pull [PATH] [--password <value>] [--url <value>] [--user <value>] [-d] [-p code-snippets|wpcode]
+  $ lps snippet pull [PATH] [--password <value>] [--url <value>] [--user <value>] [-d] [-p code-snippets|wpcode]
 
 ARGUMENTS
   [PATH]  Path to snippets directory (overrides project config)
@@ -565,15 +357,15 @@ EXAMPLES
   $ lps snippets pull --plugin wpcode
 ```
 
-_See code: [src/commands/snippets/pull.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/snippets/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/snippet/pull.ts)_
 
-## `lps snippets push [PATH]`
+## `lps snippet push [PATH]`
 
 Push snippets to WordPress
 
 ```
 USAGE
-  $ lps snippets push [PATH] [--password <value>] [--url <value>] [--user <value>] [-d] [-p code-snippets|wpcode]
+  $ lps snippet push [PATH] [--password <value>] [--url <value>] [--user <value>] [-d] [-p code-snippets|wpcode]
 
 ARGUMENTS
   [PATH]  Path to snippets directory (overrides project config)
@@ -601,15 +393,15 @@ EXAMPLES
   $ lps snippets push --plugin wpcode
 ```
 
-_See code: [src/commands/snippets/push.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/snippets/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/snippet/push.ts)_
 
-## `lps styles pull`
+## `lps style pull`
 
 Pull Global Styles from WordPress
 
 ```
 USAGE
-  $ lps styles pull [--password <value>] [--url <value>] [--user <value>] [-d]
+  $ lps style pull [--password <value>] [--url <value>] [--user <value>] [-d]
 
 FLAGS
   -d, --dryRun  Dry run - show what would happen without making changes
@@ -628,15 +420,15 @@ EXAMPLES
   $ lps styles pull --url http://example.com
 ```
 
-_See code: [src/commands/styles/pull.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/styles/pull.ts)_
+_See code: [src/commands/style/pull.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/style/pull.ts)_
 
-## `lps styles push`
+## `lps style push`
 
 Push Global Styles to WordPress
 
 ```
 USAGE
-  $ lps styles push [--password <value>] [--url <value>] [--user <value>] [-d]
+  $ lps style push [--password <value>] [--url <value>] [--user <value>] [-d]
 
 FLAGS
   -d, --dryRun  Dry run - show what would happen without making changes
@@ -655,5 +447,5 @@ EXAMPLES
   $ lps styles push --url http://example.com
 ```
 
-_See code: [src/commands/styles/push.ts](https://github.com/loopress/loopress/blob/v0.3.0/src/commands/styles/push.ts)_
+_See code: [src/commands/style/push.ts](https://github.com/loopress/loopress/blob/v0.4.0/src/commands/style/push.ts)_
 <!-- commandsstop -->

package/dist/commands/plugin/pull.d.ts

@@ -0,0 +1,12 @@
+import { LoopressCommand } from '../../lib/base.js';
+export default class Pull extends LoopressCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/plugin/pull.js

@@ -0,0 +1,48 @@
+import { Flags } from '@oclif/core';
+import got from 'got';
+import { LoopressCommand } from '../../lib/base.js';
+import { readLocalConfig, writeLocalConfig } from '../../utils/loopress-config.js';
+import { mergePluginManifest } from '../../utils/plugins.js';
+export default class Pull extends LoopressCommand {
+    static description = 'Pull installed plugins from WordPress into loopress.json';
+    static examples = ['$ lps plugins pull', '$ lps plugins pull --dry-run'];
+    static flags = {
+        ...LoopressCommand.baseFlags,
+        'dry-run': Flags.boolean({ char: 'd', description: 'Show what would be written without making changes' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Pull);
+        const dryRun = flags['dry-run'];
+        const { url } = this.siteConfig;
+        this.log(`Pulling plugins from ${url}`);
+        const headers = await this.buildAuthHeaders();
+        const installed = await got.get(`${url}/wp-json/loopress/v1/plugins`, { headers }).json();
+        const incoming = Object.fromEntries(installed.map((p) => [p.slug, p.version]));
+        const localConfig = await readLocalConfig();
+        const { added, merged, updated } = mergePluginManifest(localConfig.plugins ?? {}, incoming);
+        if (dryRun) {
+            this.log(`[dry-run] Would write ${Object.keys(merged).length} plugins to loopress.json`);
+            if (added.length > 0)
+                this.log(`  + ${added.join(', ')}`);
+            if (updated.length > 0) {
+                for (const u of updated)
+                    this.log(`  ~ ${u.slug} (${u.from} → ${u.to})`);
+            }
+            return;
+        }
+        await writeLocalConfig({ ...localConfig, plugins: merged });
+        this.log(`Wrote ${Object.keys(merged).length} plugins to loopress.json`);
+        if (added.length > 0)
+            this.log(`  + Added: ${added.join(', ')}`);
+        for (const u of updated)
+            this.log(`  ~ Updated: ${u.slug} ${u.from} → ${u.to}`);
+        if (Object.keys(merged).length > 0) {
+            await got
+                .post(`${url}/wp-json/loopress/v1/plugins/auto-updates/disable`, {
+                headers,
+                json: { slugs: Object.keys(merged) },
+            })
+                .json();
+        }
+    }
+}

package/dist/commands/plugin/push.d.ts

@@ -0,0 +1,13 @@
+import { LoopressCommand } from '../../lib/base.js';
+export default class Push extends LoopressCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private activatePlugin;
+}

package/dist/commands/plugin/push.js

@@ -0,0 +1,111 @@
+import { confirm } from '@inquirer/prompts';
+import { Flags } from '@oclif/core';
+import got from 'got';
+import { LoopressCommand } from '../../lib/base.js';
+import { readLocalConfig } from '../../utils/loopress-config.js';
+import { diffPlugins } from '../../utils/plugins.js';
+export default class Push extends LoopressCommand {
+    static description = 'Sync plugins on WordPress to match loopress.json';
+    static examples = ['$ lps plugins push', '$ lps plugins push --dry-run'];
+    static flags = {
+        ...LoopressCommand.baseFlags,
+        'dry-run': Flags.boolean({ char: 'd', description: 'Show what would change without making changes' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Push);
+        const dryRun = flags['dry-run'];
+        const { url } = this.siteConfig;
+        const localConfig = await readLocalConfig();
+        const manifest = localConfig.plugins;
+        if (!manifest || Object.keys(manifest).length === 0) {
+            this.error('No plugins found in loopress.json. Run `lps plugins pull` first.');
+        }
+        this.log(`Pushing plugins to ${url}`);
+        const headers = await this.buildAuthHeaders();
+        const installed = await got.get(`${url}/wp-json/loopress/v1/plugins`, { headers }).json();
+        const { drifted, toActivate, toInstall } = diffPlugins(manifest, installed);
+        if (toInstall.length === 0 && toActivate.length === 0 && drifted.length === 0) {
+            this.log('Everything is already in sync.');
+            return;
+        }
+        if (toInstall.length > 0) {
+            this.log(`\nTo install (${toInstall.length}):`);
+            for (const a of toInstall)
+                this.log(`  + ${a.slug} @ ${a.targetVersion}`);
+        }
+        if (toActivate.length > 0) {
+            this.log(`\nTo activate (${toActivate.length}):`);
+            for (const a of toActivate)
+                this.log(`  ↑ ${a.slug}`);
+        }
+        if (drifted.length > 0) {
+            this.log(`\nVersion mismatch (${drifted.length}):`);
+            for (const a of drifted) {
+                this.log(`  ~ ${a.slug}: site has ${a.currentVersion}, manifest wants ${a.targetVersion}`);
+            }
+        }
+        if (dryRun)
+            return;
+        // Install missing plugins and activate them.
+        for (const action of toInstall) {
+            this.log(`\nInstalling ${action.slug} @ ${action.targetVersion}...`);
+            try {
+                const result = await got
+                    .post(`${url}/wp-json/loopress/v1/plugins/install`, {
+                    headers,
+                    json: { slug: action.slug, version: action.targetVersion },
+                })
+                    .json();
+                this.log(`  ✓ ${result.message}`);
+            }
+            catch (error) {
+                this.warn(`  Failed to install ${action.slug}: ${error.message}`);
+                continue;
+            }
+            await this.activatePlugin(url, headers, action.slug);
+        }
+        // Activate installed-but-inactive plugins without prompting.
+        for (const action of toActivate) {
+            this.log(`\nActivating ${action.slug}...`);
+            await this.activatePlugin(url, headers, action.slug);
+        }
+        // Prompt per drifted plugin before syncing.
+        for (const action of drifted) {
+            this.log('');
+            const proceed = await confirm({
+                default: false,
+                message: `${action.slug} is at ${action.currentVersion} on the site but manifest wants ${action.targetVersion}. Sync to ${action.targetVersion}?`,
+            });
+            if (!proceed) {
+                this.log(`  Skipped ${action.slug}`);
+                continue;
+            }
+            this.log(`  Syncing ${action.slug} to ${action.targetVersion}...`);
+            try {
+                const result = await got
+                    .post(`${url}/wp-json/loopress/v1/plugins/install`, {
+                    headers,
+                    json: { slug: action.slug, version: action.targetVersion },
+                })
+                    .json();
+                this.log(`  ✓ ${result.message}`);
+            }
+            catch (error) {
+                this.warn(`  Failed to sync ${action.slug}: ${error.message}`);
+                continue;
+            }
+            await this.activatePlugin(url, headers, action.slug);
+        }
+    }
+    async activatePlugin(url, headers, slug) {
+        try {
+            const result = await got
+                .post(`${url}/wp-json/loopress/v1/plugins/activate`, { headers, json: { slug } })
+                .json();
+            this.log(`  ✓ ${result.message}`);
+        }
+        catch (error) {
+            this.warn(`  Failed to activate ${slug}: ${error.message}`);
+        }
+    }
+}

package/dist/commands/plugin/require.d.ts

@@ -0,0 +1,17 @@
+import { LoopressCommand } from '../../lib/base.js';
+export declare function resolvePluginVersion(slug: string, version: string): Promise<string>;
+export default class Require extends LoopressCommand {
+    static args: {
+        slug: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        version: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/plugin/require.js

@@ -0,0 +1,74 @@
+import { Args, Flags } from '@oclif/core';
+import got from 'got';
+import { LoopressCommand } from '../../lib/base.js';
+import { readLocalConfig, writeLocalConfig } from '../../utils/loopress-config.js';
+const WP_ORG_API = 'https://api.wordpress.org/plugins/info/1.2/';
+export async function resolvePluginVersion(slug, version) {
+    if (version !== 'latest')
+        return version;
+    let info;
+    try {
+        info = await got
+            .get(WP_ORG_API, {
+            searchParams: {
+                action: 'plugin_information',
+                'request[slug]': slug,
+            },
+        })
+            .json();
+    }
+    catch {
+        throw new Error(`Plugin "${slug}" not found on WordPress.org.`);
+    }
+    if (info.error)
+        throw new Error(`Plugin "${slug}" not found on WordPress.org.`);
+    return info.version;
+}
+export default class Require extends LoopressCommand {
+    static args = {
+        slug: Args.string({ description: 'Plugin slug (WordPress.org)', required: true }),
+        version: Args.string({ description: 'Version to pin (default: latest)' }),
+    };
+    static description = 'Add a plugin to loopress.json, resolving its latest version from WordPress.org';
+    static examples = [
+        '$ lps plugins require woocommerce',
+        '$ lps plugins require woocommerce 8.9.1',
+        '$ lps plugins require contact-form-7 --dry-run',
+    ];
+    static flags = {
+        ...LoopressCommand.baseFlags,
+        'dry-run': Flags.boolean({ char: 'd', description: 'Show what would be written without making changes' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Require);
+        const dryRun = flags['dry-run'];
+        const { slug } = args;
+        const requestedVersion = args.version ?? 'latest';
+        this.log(`Resolving ${slug}@${requestedVersion}...`);
+        let resolvedVersion;
+        try {
+            resolvedVersion = await resolvePluginVersion(slug, requestedVersion);
+        }
+        catch (error) {
+            this.error(error.message);
+        }
+        this.log(`Resolved: ${slug}@${resolvedVersion}`);
+        const localConfig = await readLocalConfig();
+        const existing = localConfig.plugins ?? {};
+        if (existing[slug] === resolvedVersion) {
+            this.log(`${slug}@${resolvedVersion} is already in loopress.json — nothing to do.`);
+            return;
+        }
+        const updated = existing[slug] !== undefined;
+        const label = updated ? `${existing[slug]} → ${resolvedVersion}` : resolvedVersion;
+        if (dryRun) {
+            this.log(`[dry-run] Would ${updated ? 'update' : 'add'} ${slug}: ${label}`);
+            return;
+        }
+        await writeLocalConfig({
+            ...localConfig,
+            plugins: { ...existing, [slug]: resolvedVersion },
+        });
+        this.log(`${updated ? 'Updated' : 'Added'} ${slug}: ${label}`);
+    }
+}

package/dist/types/plugin.d.ts

@@ -0,0 +1,15 @@
+export interface InstalledPlugin {
+    active: boolean;
+    file: string;
+    name: string;
+    slug: string;
+    version: string;
+}
+export interface InstallResult {
+    message: string;
+    version: string;
+}
+export interface ActivateResult {
+    message: string;
+}
+export type PluginManifest = Record<string, string>;

package/dist/types/plugin.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/loopress-config.d.ts

@@ -1,6 +1,8 @@
 export interface LoopressLocalConfig {
+    plugins?: Record<string, string>;
     rootDir?: string;
     snippets?: string;
     styles?: string;
 }
 export declare function readLocalConfig(): Promise<LoopressLocalConfig>;
+export declare function writeLocalConfig(config: LoopressLocalConfig): Promise<void>;

package/dist/utils/loopress-config.js

@@ -1,14 +1,19 @@
 import { existsSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 export async function readLocalConfig() {
-    const configPath = join(process.cwd(), 'loopress.config.js');
+    const configPath = join(process.cwd(), 'loopress.json');
     if (!existsSync(configPath))
         return {};
     try {
-        const mod = await import(configPath);
-        return mod.default ?? {};
+        const content = await readFile(configPath, 'utf8');
+        return JSON.parse(content);
     }
     catch {
         return {};
     }
 }
+export async function writeLocalConfig(config) {
+    const configPath = join(process.cwd(), 'loopress.json');
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}

package/dist/utils/plugins.d.ts

@@ -0,0 +1,27 @@
+import { InstalledPlugin, PluginManifest } from '../types/plugin.js';
+export interface PluginDiff {
+    drifted: Array<{
+        currentVersion: string;
+        slug: string;
+        targetVersion: string;
+    }>;
+    toActivate: Array<{
+        slug: string;
+    }>;
+    toInstall: Array<{
+        slug: string;
+        targetVersion: string;
+    }>;
+    upToDate: string[];
+}
+export interface MergeResult {
+    added: string[];
+    merged: PluginManifest;
+    updated: Array<{
+        from: string;
+        slug: string;
+        to: string;
+    }>;
+}
+export declare function mergePluginManifest(existing: PluginManifest, incoming: PluginManifest): MergeResult;
+export declare function diffPlugins(manifest: PluginManifest, installed: InstalledPlugin[]): PluginDiff;

package/dist/utils/plugins.js

@@ -0,0 +1,34 @@
+export function mergePluginManifest(existing, incoming) {
+    const merged = { ...existing, ...incoming };
+    const added = Object.keys(incoming).filter((s) => !(s in existing));
+    const updated = Object.keys(incoming)
+        .filter((s) => s in existing && existing[s] !== incoming[s])
+        .map((s) => ({ from: existing[s], slug: s, to: incoming[s] }));
+    return { added, merged, updated };
+}
+export function diffPlugins(manifest, installed) {
+    const installedMap = new Map(installed.map((p) => [p.slug, p]));
+    const toInstall = [];
+    const toActivate = [];
+    const drifted = [];
+    const upToDate = [];
+    for (const [slug, targetVersion] of Object.entries(manifest)) {
+        const live = installedMap.get(slug);
+        if (!live) {
+            toInstall.push({ slug, targetVersion });
+            continue;
+        }
+        if (live.version === targetVersion) {
+            if (live.active) {
+                upToDate.push(slug);
+            }
+            else {
+                toActivate.push({ slug });
+            }
+        }
+        else {
+            drifted.push({ currentVersion: live.version, slug, targetVersion });
+        }
+    }
+    return { drifted, toActivate, toInstall, upToDate };
+}

package/oclif.manifest.json

@@ -46,6 +46,188 @@
         "logout.js"
       ]
     },
+    "plugin:pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Pull installed plugins from WordPress into loopress.json",
+      "examples": [
+        "$ lps plugins pull",
+        "$ lps plugins pull --dry-run"
+      ],
+      "flags": {
+        "password": {
+          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "user": {
+          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "user",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would be written 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": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "pull.js"
+      ]
+    },
+    "plugin:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Sync plugins on WordPress to match loopress.json",
+      "examples": [
+        "$ lps plugins push",
+        "$ lps plugins push --dry-run"
+      ],
+      "flags": {
+        "password": {
+          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "user": {
+          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "user",
+          "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:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "push.js"
+      ]
+    },
+    "plugin:require": {
+      "aliases": [],
+      "args": {
+        "slug": {
+          "description": "Plugin slug (WordPress.org)",
+          "name": "slug",
+          "required": true
+        },
+        "version": {
+          "description": "Version to pin (default: latest)",
+          "name": "version"
+        }
+      },
+      "description": "Add a plugin to loopress.json, resolving its latest version from WordPress.org",
+      "examples": [
+        "$ lps plugins require woocommerce",
+        "$ lps plugins require woocommerce 8.9.1",
+        "$ lps plugins require contact-form-7 --dry-run"
+      ],
+      "flags": {
+        "password": {
+          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "user": {
+          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "helpGroup": "GLOBAL",
+          "name": "user",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would be written without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:require",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "require.js"
+      ]
+    },
     "project:config": {
       "aliases": [],
       "args": {},
@@ -190,7 +372,7 @@
         "switch.js"
       ]
     },
-    "snippets:list": {
+    "snippet:list": {
       "aliases": [],
       "args": {},
       "description": "List snippets from WordPress",
@@ -247,7 +429,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippets:list",
+      "id": "snippet:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -257,11 +439,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippets",
+        "snippet",
         "list.js"
       ]
     },
-    "snippets:pull": {
+    "snippet:pull": {
       "aliases": [],
       "args": {
         "path": {
@@ -324,7 +506,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippets:pull",
+      "id": "snippet:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -334,11 +516,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippets",
+        "snippet",
         "pull.js"
       ]
     },
-    "snippets:push": {
+    "snippet:push": {
       "aliases": [],
       "args": {
         "path": {
@@ -401,7 +583,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippets:push",
+      "id": "snippet:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -411,11 +593,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippets",
+        "snippet",
         "push.js"
       ]
     },
-    "styles:pull": {
+    "style:pull": {
       "aliases": [],
       "args": {},
       "description": "Pull Global Styles from WordPress",
@@ -458,7 +640,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "styles:pull",
+      "id": "style:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -468,11 +650,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "styles",
+        "style",
         "pull.js"
       ]
     },
-    "styles:push": {
+    "style:push": {
       "aliases": [],
       "args": {},
       "description": "Push Global Styles to WordPress",
@@ -515,7 +697,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "styles:push",
+      "id": "style:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -525,10 +707,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "styles",
+        "style",
         "push.js"
       ]
     }
   },
-  "version": "0.3.0"
+  "version": "0.4.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loopress/cli",
   "description": "CLI tool for syncing WordPress CodeSnippets, styles, and menus via the REST API",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -24,7 +24,7 @@
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4",
     "@types/chai": "^5.2.3",
-    "@types/mocha": "^10",
+    "@types/mocha": "^10.0.10",
     "@types/node": "25.9.3",
     "chai": "^6.2.2",
     "eslint": "^9",
@@ -63,8 +63,7 @@
     "commands": "./dist/commands",
     "helpClass": "./dist/help.js",
     "plugins": [
-      "@oclif/plugin-help",
-      "@oclif/plugin-plugins"
+      "@oclif/plugin-help"
     ],
     "topicSeparator": " "
   },