@loopress/cli 0.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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;
+}