@loopress/cli 0.5.0 → 0.6.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.5.0 linux-x64 node-v24.17.0
+@loopress/cli/0.6.0 linux-x64 node-v24.17.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -31,13 +31,15 @@ USAGE
 # Commands
 
 <!-- commands -->
+* [`lps composer pull`](#lps-composer-pull)
+* [`lps composer push`](#lps-composer-push)
 * [`lps help [COMMAND]`](#lps-help-command)
 * [`lps init`](#lps-init)
 * [`lps login`](#lps-login)
 * [`lps logout`](#lps-logout)
+* [`lps plugin add SLUG [VERSION]`](#lps-plugin-add-slug-version)
 * [`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)
@@ -48,6 +50,60 @@ USAGE
 * [`lps snippet pull [PATH]`](#lps-snippet-pull-path)
 * [`lps snippet push [PATH]`](#lps-snippet-push-path)
 
+## `lps composer pull`
+
+Pull composer.lock from the WordPress server
+
+```
+USAGE
+  $ lps composer pull [--password <value>] [--url <value>] [--user <value>] [-d]
+
+FLAGS
+  -d, --dry-run  Show what would be written without making changes
+
+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
+  Pull composer.lock from the WordPress server
+
+EXAMPLES
+  $ lps composer pull
+
+  $ lps composer pull --dry-run
+```
+
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/composer/pull.ts)_
+
+## `lps composer push`
+
+Upload composer.json and composer.lock to WordPress and run composer install
+
+```
+USAGE
+  $ lps composer push [--password <value>] [--url <value>] [--user <value>] [-d]
+
+FLAGS
+  -d, --dry-run  Show what would change without making changes
+
+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
+  Upload composer.json and composer.lock to WordPress and run composer install
+
+EXAMPLES
+  $ lps composer push
+
+  $ lps composer push --dry-run
+```
+
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/composer/push.ts)_
+
 ## `lps help [COMMAND]`
 
 Display help for lps.
@@ -66,7 +122,7 @@ DESCRIPTION
   Display help for lps.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.52/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.53/src/commands/help.ts)_
 
 ## `lps init`
 
@@ -83,7 +139,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -100,7 +156,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -117,15 +173,19 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/logout.ts)_
 
-## `lps plugin pull`
+## `lps plugin add SLUG [VERSION]`
 
-Pull installed plugins from WordPress into loopress.json
+Add a plugin to loopress.json (WordPress.org) or run composer require (vendor/package)
 
 ```
 USAGE
-  $ lps plugin pull [--password <value>] [--url <value>] [--user <value>] [-d]
+  $ lps plugin add SLUG [VERSION] [--password <value>] [--url <value>] [--user <value>] [-d]
+
+ARGUMENTS
+  SLUG       Plugin slug (WordPress.org) or Composer package (vendor/package)
+  [VERSION]  Version to pin (default: latest)
 
 FLAGS
   -d, --dry-run  Show what would be written without making changes
@@ -136,26 +196,30 @@ GLOBAL FLAGS
   --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Pull installed plugins from WordPress into loopress.json
+  Add a plugin to loopress.json (WordPress.org) or run composer require (vendor/package)
 
 EXAMPLES
-  $ lps plugins pull
+  $ lps plugin add woocommerce
 
-  $ lps plugins pull --dry-run
+  $ lps plugin add woocommerce 8.9.1
+
+  $ lps plugin add wpackagist-plugin/advanced-custom-fields
+
+  $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/plugin/add.ts)_
 
-## `lps plugin push`
+## `lps plugin pull`
 
-Sync plugins on WordPress to match loopress.json
+Pull installed plugins from WordPress into loopress.json
 
 ```
 USAGE
-  $ lps plugin push [--password <value>] [--url <value>] [--user <value>] [-d]
+  $ lps plugin pull [--password <value>] [--url <value>] [--user <value>] [-d]
 
 FLAGS
-  -d, --dry-run  Show what would change without making changes
+  -d, --dry-run  Show what would be written without making changes
 
 GLOBAL FLAGS
   --password=<value>  WordPress application password (fallback; prefer `lps project config`)
@@ -163,30 +227,26 @@ GLOBAL FLAGS
   --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Sync plugins on WordPress to match loopress.json
+  Pull installed plugins from WordPress into loopress.json
 
 EXAMPLES
-  $ lps plugins push
+  $ lps plugins pull
 
-  $ lps plugins push --dry-run
+  $ lps plugins pull --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/plugin/pull.ts)_
 
-## `lps plugin require SLUG [VERSION]`
+## `lps plugin push`
 
-Add a plugin to loopress.json, resolving its latest version from WordPress.org
+Sync plugins on WordPress to match loopress.json
 
 ```
 USAGE
-  $ lps plugin require SLUG [VERSION] [--password <value>] [--url <value>] [--user <value>] [-d]
-
-ARGUMENTS
-  SLUG       Plugin slug (WordPress.org)
-  [VERSION]  Version to pin (default: latest)
+  $ lps plugin push [--password <value>] [--url <value>] [--user <value>] [-d]
 
 FLAGS
-  -d, --dry-run  Show what would be written without making changes
+  -d, --dry-run  Show what would change without making changes
 
 GLOBAL FLAGS
   --password=<value>  WordPress application password (fallback; prefer `lps project config`)
@@ -194,17 +254,15 @@ GLOBAL FLAGS
   --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Add a plugin to loopress.json, resolving its latest version from WordPress.org
+  Sync plugins on WordPress to match loopress.json
 
 EXAMPLES
-  $ lps plugins require woocommerce
-
-  $ lps plugins require woocommerce 8.9.1
+  $ lps plugins push
 
-  $ lps plugins require contact-form-7 --dry-run
+  $ lps plugins push --dry-run
 ```
 
-_See code: [src/commands/plugin/require.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/plugin/require.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
@@ -221,7 +279,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -238,7 +296,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/list.ts)_
 
 ## `lps project remove`
 
@@ -255,7 +313,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/remove.ts)_
 
 ## `lps project remove-env`
 
@@ -272,7 +330,7 @@ EXAMPLES
   $ lps project remove-env
 ```
 
-_See code: [src/commands/project/remove-env.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/project/remove-env.ts)_
+_See code: [src/commands/project/remove-env.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/remove-env.ts)_
 
 ## `lps project switch`
 
@@ -289,7 +347,7 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/switch.ts)_
 
 ## `lps project switch-env`
 
@@ -306,7 +364,7 @@ EXAMPLES
   $ lps project switch-env
 ```
 
-_See code: [src/commands/project/switch-env.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/project/switch-env.ts)_
+_See code: [src/commands/project/switch-env.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/switch-env.ts)_
 
 ## `lps snippet list`
 
@@ -337,7 +395,7 @@ EXAMPLES
   $ lps snippets list --plugin wpcode
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -373,7 +431,7 @@ EXAMPLES
   $ lps snippets pull --plugin wpcode
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -409,5 +467,5 @@ EXAMPLES
   $ lps snippets push --plugin wpcode
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.5.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/snippet/push.ts)_
 <!-- commandsstop -->

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

@@ -0,0 +1,12 @@
+import { LoopressCommand } from '../../lib/base.js';
+export default class ComposerPull 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/composer/pull.js

@@ -0,0 +1,33 @@
+import { Flags } from '@oclif/core';
+import got from 'got';
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { LoopressCommand } from '../../lib/base.js';
+import { readLocalConfig } from '../../utils/loopress-config.js';
+export default class ComposerPull extends LoopressCommand {
+    static description = 'Pull composer.lock from the WordPress server';
+    static examples = ['$ lps composer pull', '$ lps composer 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(ComposerPull);
+        const dryRun = flags['dry-run'];
+        const { url } = this.siteConfig;
+        this.log(`Pulling composer.lock from ${url}`);
+        const headers = await this.buildAuthHeaders();
+        const { composerLock } = await got
+            .get(`${url}/wp-json/loopress/v1/composer/lock`, { headers })
+            .json();
+        if (dryRun) {
+            this.log('[dry-run] Would write composer.lock');
+            return;
+        }
+        const localConfig = await readLocalConfig();
+        const rootDir = localConfig.rootDir ?? '.';
+        const lockPath = join(process.cwd(), rootDir, 'composer.lock');
+        await writeFile(lockPath, composerLock, 'utf8');
+        this.log(`Wrote composer.lock`);
+    }
+}

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

@@ -0,0 +1,12 @@
+import { PushCommand } from '../../lib/push-command.js';
+export default class ComposerPush extends PushCommand {
+    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/composer/push.js

@@ -0,0 +1,49 @@
+import { Flags } from '@oclif/core';
+import got from 'got';
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { PushCommand } from '../../lib/push-command.js';
+import { readLocalConfig } from '../../utils/loopress-config.js';
+export default class ComposerPush extends PushCommand {
+    static description = 'Upload composer.json and composer.lock to WordPress and run composer install';
+    static examples = ['$ lps composer push', '$ lps composer push --dry-run'];
+    static flags = {
+        ...PushCommand.baseFlags,
+        'dry-run': Flags.boolean({ char: 'd', description: 'Show what would change without making changes' }),
+    };
+    async run() {
+        const { flags } = await this.parse(ComposerPush);
+        const dryRun = flags['dry-run'];
+        this.dryRun = dryRun;
+        const { url } = this.siteConfig;
+        const localConfig = await readLocalConfig();
+        const rootDir = localConfig.rootDir ?? '.';
+        const composerJsonPath = join(process.cwd(), rootDir, 'composer.json');
+        const composerLockPath = join(process.cwd(), rootDir, 'composer.lock');
+        if (!existsSync(composerJsonPath)) {
+            this.error(`No composer.json found at ${composerJsonPath}`);
+        }
+        const composerJsonRaw = await readFile(composerJsonPath, 'utf8');
+        const parsed = JSON.parse(composerJsonRaw);
+        const packageCount = Object.keys(parsed.require ?? {}).length;
+        const hasLock = existsSync(composerLockPath);
+        const composerLockRaw = hasLock ? await readFile(composerLockPath, 'utf8') : null;
+        this.log(`Pushing composer.json (${packageCount} ${packageCount === 1 ? 'package' : 'packages'}) to ${url}`);
+        if (composerLockRaw) {
+            this.log('  + composer.lock included (reproducible install)');
+        }
+        else {
+            this.warn('No composer.lock found. The server will resolve versions freely.');
+        }
+        if (dryRun)
+            return;
+        const headers = await this.buildAuthHeaders();
+        await got.post(`${url}/wp-json/loopress/v1/composer/sync`, {
+            headers,
+            json: { composerJson: composerJsonRaw, composerLock: composerLockRaw },
+        });
+        this.log('composer install completed on the server.');
+        await this.recordSuccess();
+    }
+}

package/dist/commands/plugin/{require.d.ts → add.d.ts}

@@ -1,6 +1,6 @@
 import { LoopressCommand } from '../../lib/base.js';
 export declare function resolvePluginVersion(slug: string, version: string): Promise<string>;
-export default class Require extends LoopressCommand {
+export default class Add 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>>;
@@ -14,4 +14,6 @@ export default class Require extends LoopressCommand {
         user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
+    private requireComposerPackage;
+    private requireWpOrgPlugin;
 }

package/dist/commands/plugin/{require.js → add.js}

@@ -1,5 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import got from 'got';
+import { spawnSync } from 'node:child_process';
 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/';
@@ -24,26 +25,46 @@ export async function resolvePluginVersion(slug, version) {
         throw new Error(`Plugin "${slug}" not found on WordPress.org.`);
     return info.version;
 }
-export default class Require extends LoopressCommand {
+export default class Add extends LoopressCommand {
     static args = {
-        slug: Args.string({ description: 'Plugin slug (WordPress.org)', required: true }),
+        slug: Args.string({ description: 'Plugin slug (WordPress.org) or Composer package (vendor/package)', 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 description = 'Add a plugin to loopress.json (WordPress.org) or run composer require (vendor/package)';
     static examples = [
-        '$ lps plugins require woocommerce',
-        '$ lps plugins require woocommerce 8.9.1',
-        '$ lps plugins require contact-form-7 --dry-run',
+        '$ lps plugin add woocommerce',
+        '$ lps plugin add woocommerce 8.9.1',
+        '$ lps plugin add wpackagist-plugin/advanced-custom-fields',
+        '$ lps plugin add 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 { args, flags } = await this.parse(Add);
         const dryRun = flags['dry-run'];
         const { slug } = args;
         const requestedVersion = args.version ?? 'latest';
+        if (slug.includes('/')) {
+            await this.requireComposerPackage(slug, requestedVersion, dryRun);
+            return;
+        }
+        await this.requireWpOrgPlugin(slug, requestedVersion, dryRun);
+    }
+    async requireComposerPackage(pkg, version, dryRun) {
+        const composerArg = version === 'latest' ? pkg : `${pkg}:${version}`;
+        this.log(`Running: composer require ${composerArg}`);
+        if (dryRun) {
+            this.log(`[dry-run] Would run: composer require ${composerArg}`);
+            return;
+        }
+        const result = spawnSync('composer', ['require', composerArg], { stdio: 'inherit' });
+        if (result.status !== 0) {
+            this.error('composer require failed. Make sure Composer is installed and accessible.');
+        }
+    }
+    async requireWpOrgPlugin(slug, requestedVersion, dryRun) {
         this.log(`Resolving ${slug}@${requestedVersion}...`);
         let resolvedVersion;
         try {
@@ -56,7 +77,7 @@ export default class Require extends LoopressCommand {
         const localConfig = await readLocalConfig();
         const existing = localConfig.plugins ?? {};
         if (existing[slug] === resolvedVersion) {
-            this.log(`${slug}@${resolvedVersion} is already in loopress.json — nothing to do.`);
+            this.log(`${slug}@${resolvedVersion} is already in loopress.json, nothing to do.`);
             return;
         }
         const updated = existing[slug] !== undefined;

package/dist/commands/plugin/pull.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core';
 import got from 'got';
 import { LoopressCommand } from '../../lib/base.js';
+import { getComposerManagedSlugs, readComposerJson } from '../../utils/composer.js';
 import { readLocalConfig, writeLocalConfig } from '../../utils/loopress-config.js';
 import { mergePluginManifest } from '../../utils/plugins.js';
 export default class Pull extends LoopressCommand {
@@ -17,7 +18,15 @@ export default class Pull extends LoopressCommand {
         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 composerJson = await readComposerJson();
+        const composerSlugs = composerJson ? getComposerManagedSlugs(composerJson) : [];
+        const incoming = Object.fromEntries(installed.filter((p) => !composerSlugs.includes(p.slug)).map((p) => [p.slug, p.version]));
+        if (composerSlugs.length > 0) {
+            const found = installed.filter((p) => composerSlugs.includes(p.slug)).map((p) => p.slug);
+            if (found.length > 0) {
+                this.log(`Skipping ${found.length} Composer-managed ${found.length === 1 ? 'plugin' : 'plugins'}: ${found.join(', ')}`);
+            }
+        }
         const localConfig = await readLocalConfig();
         const { added, merged, updated } = mergePluginManifest(localConfig.plugins ?? {}, incoming);
         if (dryRun) {

package/dist/commands/plugin/push.js

@@ -2,6 +2,7 @@ import { confirm } from '@inquirer/prompts';
 import { Flags } from '@oclif/core';
 import got from 'got';
 import { PushCommand } from '../../lib/push-command.js';
+import { getComposerManagedSlugs, readComposerJson } from '../../utils/composer.js';
 import { readLocalConfig } from '../../utils/loopress-config.js';
 import { diffPlugins } from '../../utils/plugins.js';
 export default class Push extends PushCommand {
@@ -21,10 +22,18 @@ export default class Push extends PushCommand {
         if (!manifest || Object.keys(manifest).length === 0) {
             this.error('No plugins found in loopress.json. Run `lps plugins pull` first.');
         }
+        const composerJson = await readComposerJson();
+        const composerSlugs = composerJson ? getComposerManagedSlugs(composerJson) : [];
+        const filteredManifest = Object.fromEntries(Object.entries(manifest).filter(([slug]) => !composerSlugs.includes(slug)));
+        const skipped = composerSlugs.filter((slug) => slug in manifest);
+        if (skipped.length > 0) {
+            this.log(`Skipping ${skipped.length} Composer-managed ${skipped.length === 1 ? 'plugin' : 'plugins'}: ${skipped.join(', ')}`);
+            this.log('Run `lps composer push` to deploy them.');
+        }
         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);
+        const { drifted, toActivate, toInstall } = diffPlugins(filteredManifest, installed);
         if (toInstall.length === 0 && toActivate.length === 0 && drifted.length === 0) {
             this.log('Everything is already in sync.');
             return;

package/dist/utils/composer.d.ts

@@ -0,0 +1,7 @@
+export interface ComposerJson {
+    require?: Record<string, string>;
+    'require-dev'?: Record<string, string>;
+}
+export declare function readComposerJson(): Promise<ComposerJson | null>;
+export declare function readComposerLock(): Promise<null | string>;
+export declare function getComposerManagedSlugs(composerJson: ComposerJson): string[];

package/dist/utils/composer.js

@@ -0,0 +1,33 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function readComposerJson() {
+    const path = join(process.cwd(), 'composer.json');
+    if (!existsSync(path))
+        return null;
+    try {
+        const content = await readFile(path, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export async function readComposerLock() {
+    const path = join(process.cwd(), 'composer.lock');
+    if (!existsSync(path))
+        return null;
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+// Returns WordPress plugin slugs declared as wpackagist-plugin/* in composer.json
+export function getComposerManagedSlugs(composerJson) {
+    const packages = { ...composerJson.require, ...composerJson['require-dev'] };
+    return Object.keys(packages)
+        .filter((pkg) => pkg.startsWith('wpackagist-plugin/'))
+        .map((pkg) => pkg.slice('wpackagist-plugin/'.length));
+}

package/oclif.manifest.json

@@ -69,13 +69,13 @@
         "logout.js"
       ]
     },
-    "plugin:pull": {
+    "composer:pull": {
       "aliases": [],
       "args": {},
-      "description": "Pull installed plugins from WordPress into loopress.json",
+      "description": "Pull composer.lock from the WordPress server",
       "examples": [
-        "$ lps plugins pull",
-        "$ lps plugins pull --dry-run"
+        "$ lps composer pull",
+        "$ lps composer pull --dry-run"
       ],
       "flags": {
         "password": {
@@ -112,7 +112,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:pull",
+      "id": "composer:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -122,17 +122,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
+        "composer",
         "pull.js"
       ]
     },
-    "plugin:push": {
+    "composer:push": {
       "aliases": [],
       "args": {},
-      "description": "Sync plugins on WordPress to match loopress.json",
+      "description": "Upload composer.json and composer.lock to WordPress and run composer install",
       "examples": [
-        "$ lps plugins push",
-        "$ lps plugins push --dry-run"
+        "$ lps composer push",
+        "$ lps composer push --dry-run"
       ],
       "flags": {
         "password": {
@@ -169,7 +169,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:push",
+      "id": "composer:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -178,15 +178,15 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
+        "composer",
         "push.js"
       ]
     },
-    "plugin:require": {
+    "plugin:add": {
       "aliases": [],
       "args": {
         "slug": {
-          "description": "Plugin slug (WordPress.org)",
+          "description": "Plugin slug (WordPress.org) or Composer package (vendor/package)",
           "name": "slug",
           "required": true
         },
@@ -195,11 +195,12 @@
           "name": "version"
         }
       },
-      "description": "Add a plugin to loopress.json, resolving its latest version from WordPress.org",
+      "description": "Add a plugin to loopress.json (WordPress.org) or run composer require (vendor/package)",
       "examples": [
-        "$ lps plugins require woocommerce",
-        "$ lps plugins require woocommerce 8.9.1",
-        "$ lps plugins require contact-form-7 --dry-run"
+        "$ lps plugin add woocommerce",
+        "$ lps plugin add woocommerce 8.9.1",
+        "$ lps plugin add wpackagist-plugin/advanced-custom-fields",
+        "$ lps plugin add contact-form-7 --dry-run"
       ],
       "flags": {
         "password": {
@@ -236,7 +237,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:require",
+      "id": "plugin:add",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -247,116 +248,53 @@
         "dist",
         "commands",
         "plugin",
-        "require.js"
-      ]
-    },
-    "project:config": {
-      "aliases": [],
-      "args": {},
-      "description": "Add or update a WordPress project environment",
-      "examples": [
-        "$ lps project config"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:config",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "config.js"
-      ]
-    },
-    "project:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List configured WordPress projects",
-      "examples": [
-        "$ lps project list"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:list",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "list.js"
-      ]
-    },
-    "project:remove-env": {
-      "aliases": [],
-      "args": {},
-      "description": "Remove one or more environments from the current project",
-      "examples": [
-        "$ lps project remove-env"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:remove-env",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "remove-env.js"
-      ]
-    },
-    "project:remove": {
-      "aliases": [],
-      "args": {},
-      "description": "Remove one or more WordPress project configurations",
-      "examples": [
-        "$ lps project remove"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:remove",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "remove.js"
+        "add.js"
       ]
     },
-    "project:switch-env": {
+    "plugin:pull": {
       "aliases": [],
       "args": {},
-      "description": "Switch the active environment within the current project",
+      "description": "Pull installed plugins from WordPress into loopress.json",
       "examples": [
-        "$ lps project switch-env"
+        "$ lps plugins pull",
+        "$ lps plugins pull --dry-run"
       ],
-      "flags": {},
+      "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": "project:switch-env",
+      "id": "plugin:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -366,32 +304,64 @@
       "relativePath": [
         "dist",
         "commands",
-        "project",
-        "switch-env.js"
+        "plugin",
+        "pull.js"
       ]
     },
-    "project:switch": {
+    "plugin:push": {
       "aliases": [],
       "args": {},
-      "description": "Switch the active project",
+      "description": "Sync plugins on WordPress to match loopress.json",
       "examples": [
-        "$ lps project switch"
+        "$ lps plugins push",
+        "$ lps plugins push --dry-run"
       ],
-      "flags": {},
+      "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": "project:switch",
+      "id": "plugin:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "project",
-        "switch.js"
+        "plugin",
+        "push.js"
       ]
     },
     "snippet:list": {
@@ -614,7 +584,151 @@
         "snippet",
         "push.js"
       ]
+    },
+    "project:config": {
+      "aliases": [],
+      "args": {},
+      "description": "Add or update a WordPress project environment",
+      "examples": [
+        "$ lps project config"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:config",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "config.js"
+      ]
+    },
+    "project:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List configured WordPress projects",
+      "examples": [
+        "$ lps project list"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:list",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "list.js"
+      ]
+    },
+    "project:remove-env": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove one or more environments from the current project",
+      "examples": [
+        "$ lps project remove-env"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:remove-env",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "remove-env.js"
+      ]
+    },
+    "project:remove": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove one or more WordPress project configurations",
+      "examples": [
+        "$ lps project remove"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:remove",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "remove.js"
+      ]
+    },
+    "project:switch-env": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch the active environment within the current project",
+      "examples": [
+        "$ lps project switch-env"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:switch-env",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "switch-env.js"
+      ]
+    },
+    "project:switch": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch the active project",
+      "examples": [
+        "$ lps project switch"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:switch",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "switch.js"
+      ]
     }
   },
-  "version": "0.5.0"
+  "version": "0.6.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.5.0",
+  "version": "0.6.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -13,7 +13,7 @@
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
     "@oclif/core": "^4.11.11",
-    "@oclif/plugin-help": "^6.2.52",
+    "@oclif/plugin-help": "^6.2.53",
     "@oclif/plugin-plugins": "^5.4.80",
     "glob": "13.0.6",
     "got": "^15.0.7",
@@ -27,12 +27,12 @@
     "eslint": "^9",
     "eslint-config-oclif": "^6.0.174",
     "eslint-config-prettier": "^10",
-    "oclif": "^4.23.22",
-    "prettier": "3.9.1",
+    "oclif": "^4.23.24",
+    "prettier": "3.9.4",
     "shx": "^0.4.0",
     "tsx": "4.22.4",
     "typescript": "^6.0.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.9"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -48,6 +48,10 @@
   ],
   "license": "MPL-2.0",
   "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./schema": "./loopress.schema.json"
+  },
   "type": "module",
   "oclif": {
     "bin": "lps",