@loopress/cli 0.14.0 → 0.15.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.14.0 linux-x64 node-v24.18.0
+@loopress/cli/0.15.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -58,9 +58,10 @@ report.
 * [`lps plugin push`](#lps-plugin-push)
 * [`lps project config`](#lps-project-config)
 * [`lps project list`](#lps-project-list)
+* [`lps project pull`](#lps-project-pull)
+* [`lps project push`](#lps-project-push)
 * [`lps project remove`](#lps-project-remove)
 * [`lps project switch`](#lps-project-switch)
-* [`lps project sync`](#lps-project-sync)
 * [`lps snippet list`](#lps-snippet-list)
 * [`lps snippet publish [PATH]`](#lps-snippet-publish-path)
 * [`lps snippet pull [PATH]`](#lps-snippet-pull-path)
@@ -89,7 +90,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
@@ -111,7 +112,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/composer/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -148,7 +149,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -165,7 +166,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -182,7 +183,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/logout.ts)_
 
 ## `lps plugin add SLUG`
 
@@ -207,7 +208,7 @@ EXAMPLES
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/plugin/add.ts)_
 
 ## `lps plugin pull`
 
@@ -229,7 +230,7 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
@@ -251,7 +252,7 @@ EXAMPLES
   $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
@@ -269,7 +270,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -286,58 +287,75 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/project/list.ts)_
 
-## `lps project remove`
+## `lps project pull`
 
-Remove one or more WordPress projects or environments
+Pull projects and environments from your Loopress account that are not configured locally yet
 
 ```
 USAGE
-  $ lps project remove
+  $ lps project pull
 
 DESCRIPTION
-  Remove one or more WordPress projects or environments
+  Pull projects and environments from your Loopress account that are not configured locally yet
 
 EXAMPLES
-  $ lps project remove
+  $ lps project pull
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/project/pull.ts)_
 
-## `lps project switch`
+## `lps project push`
 
-Switch the active project and environment
+Push locally configured projects, environments and credentials to your Loopress account
 
 ```
 USAGE
-  $ lps project switch
+  $ lps project push
 
 DESCRIPTION
-  Switch the active project and environment
+  Push locally configured projects, environments and credentials to your Loopress account
 
 EXAMPLES
-  $ lps project switch
+  $ lps project push
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/project/push.ts)_
 
-## `lps project sync`
+## `lps project remove`
 
-Sync locally configured projects and environments with your Loopress account
+Remove one or more WordPress projects or environments
 
 ```
 USAGE
-  $ lps project sync
+  $ lps project remove
 
 DESCRIPTION
-  Sync locally configured projects and environments with your Loopress account
+  Remove one or more WordPress projects or environments
 
 EXAMPLES
-  $ lps project sync
+  $ lps project remove
+```
+
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/project/remove.ts)_
+
+## `lps project switch`
+
+Switch the active project and environment
+
+```
+USAGE
+  $ lps project switch
+
+DESCRIPTION
+  Switch the active project and environment
+
+EXAMPLES
+  $ lps project switch
 ```
 
-_See code: [src/commands/project/sync.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/sync.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/project/switch.ts)_
 
 ## `lps snippet list`
 
@@ -357,7 +375,7 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet publish [PATH]`
 
@@ -380,7 +398,7 @@ EXAMPLES
   $ lps snippet publish --path ./snippets
 ```
 
-_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/snippet/publish.ts)_
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -405,7 +423,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -431,7 +449,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -448,7 +466,7 @@ EXAMPLES
   $ lps status
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/status.ts)_
 
 ## `lps telemetry disable`
 
@@ -465,7 +483,7 @@ EXAMPLES
   $ lps telemetry disable
 ```
 
-_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/telemetry/disable.ts)_
+_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/telemetry/disable.ts)_
 
 ## `lps telemetry enable`
 
@@ -482,5 +500,5 @@ EXAMPLES
   $ lps telemetry enable
 ```
 
-_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/telemetry/enable.ts)_
+_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.15.0/src/commands/telemetry/enable.ts)_
 <!-- commandsstop -->

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

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default class Pull extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private fetchApiProjects;
+    private pullProject;
+}

package/dist/commands/project/pull.js

@@ -0,0 +1,69 @@
+import { Command } from '@oclif/core';
+import { Listr } from 'listr2';
+import { authManager } from '../../config/auth.manager.js';
+import { configManager } from '../../config/project-config.manager.js';
+import { ApiClient } from '../../lib/api-client.js';
+export default class Pull extends Command {
+    static description = 'Pull projects and environments from your Loopress account that are not configured locally yet';
+    static examples = ['$ lps project pull'];
+    async run() {
+        await this.parse(Pull);
+        const token = authManager.getAuth()?.token;
+        if (!token) {
+            this.error('Not logged in. Run `lps login` first.');
+        }
+        const api = new ApiClient(token);
+        const apiProjects = await this.fetchApiProjects(api);
+        const linkedApiProjectIds = new Set(configManager
+            .listProjects()
+            .map((project) => project.apiProjectId)
+            .filter((id) => id !== undefined));
+        const newApiProjects = apiProjects.filter((apiProject) => !linkedApiProjectIds.has(apiProject.id));
+        let projectCount = 0;
+        let environmentCount = 0;
+        if (newApiProjects.length > 0) {
+            await new Listr(newApiProjects.map((apiProject) => ({
+                task: (_ctx, task) => {
+                    this.pullProject(apiProject, task);
+                    projectCount++;
+                    environmentCount += apiProject.environments.length;
+                },
+                title: `Pull project "${apiProject.name}" from the API`,
+            })), { concurrent: false, exitOnError: false }).run();
+        }
+        this.log(`\n✓ Pulled ${projectCount} project${projectCount === 1 ? '' : 's'}, ${environmentCount} environment${environmentCount === 1 ? '' : 's'} from your Loopress account`);
+    }
+    async fetchApiProjects(api) {
+        try {
+            return await api.get('projects');
+        }
+        catch (error) {
+            this.error(`Could not fetch projects from the API: ${error.message}`);
+        }
+    }
+    // Reuse a local project already linked to this API project instead of always minting a new
+    // one: otherwise every pull that can't "claim" an existing link (e.g. after the local config
+    // was reset or desynced from the API) creates yet another duplicate entry.
+    pullProject(apiProject, task) {
+        const existing = configManager.findProjectByApiId(apiProject.id);
+        const environments = { ...existing?.environments };
+        for (const env of apiProject.environments) {
+            environments[env.name] = {
+                ...environments[env.name],
+                addedAt: environments[env.name]?.addedAt ?? env.createdAt,
+                apiEnvironmentId: env.id,
+                name: env.name,
+                url: env.url,
+            };
+        }
+        configManager.setProject(existing?.id ?? configManager.createProjectId(apiProject.name), {
+            addedAt: existing?.addedAt ?? apiProject.createdAt,
+            apiProjectId: apiProject.id,
+            environments,
+            name: apiProject.name,
+        });
+        const envCount = apiProject.environments.length;
+        if (task)
+            task.output = `Pulled with ${envCount} environment${envCount === 1 ? '' : 's'}`;
+    }
+}

package/dist/commands/project/{sync.d.ts → push.d.ts}

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-export default class Sync extends Command {
+export default class Push extends Command {
     static description: string;
     static examples: string[];
     run(): Promise<void>;
@@ -8,6 +8,5 @@ export default class Sync extends Command {
     private fetchApiProjects;
     private planEnvironment;
     private planProject;
-    private pullProject;
     private pushCredentials;
 }

package/dist/commands/project/{sync.js → push.js}

@@ -5,11 +5,11 @@ import slugify from 'slugify';
 import { authManager } from '../../config/auth.manager.js';
 import { configManager } from '../../config/project-config.manager.js';
 import { ApiClient } from '../../lib/api-client.js';
-export default class Sync extends Command {
-    static description = 'Sync locally configured projects and environments with your Loopress account';
-    static examples = ['$ lps project sync'];
+export default class Push extends Command {
+    static description = 'Push locally configured projects, environments and credentials to your Loopress account';
+    static examples = ['$ lps project push'];
     async run() {
-        await this.parse(Sync);
+        await this.parse(Push);
         const token = authManager.getAuth()?.token;
         if (!token) {
             this.error('Not logged in. Run `lps login` first.');
@@ -77,22 +77,11 @@ export default class Sync extends Command {
                     await this.pushCredentials(api, plan.apiProjectId, envPlan.apiEnvironmentId, envPlan.env);
                 }
                 catch (error) {
-                    this.warn(`Failed to sync "${plan.project.name}/${envPlan.env.name}": ${error.message}`);
+                    this.warn(`Failed to push "${plan.project.name}/${envPlan.env.name}": ${error.message}`);
                 }
             }
         }
-        const newApiProjects = apiProjects.filter((candidate) => !claimedProjectIds.has(candidate.id));
-        if (newApiProjects.length > 0) {
-            await new Listr(newApiProjects.map((apiProject) => ({
-                task: async (_ctx, task) => {
-                    this.pullProject(apiProject, task);
-                    projectCount++;
-                    environmentCount += apiProject.environments.length;
-                },
-                title: `Pull project "${apiProject.name}" from the API`,
-            })), { concurrent: false, exitOnError: false }).run();
-        }
-        this.log(`\n✓ Synced ${projectCount} project${projectCount === 1 ? '' : 's'}, ${environmentCount} environment${environmentCount === 1 ? '' : 's'} with your Loopress account`);
+        this.log(`\n✓ Pushed ${projectCount} project${projectCount === 1 ? '' : 's'}, ${environmentCount} environment${environmentCount === 1 ? '' : 's'} to your Loopress account`);
     }
     async applyEnvironment(api, apiProjectId, envPlan, task) {
         try {
@@ -111,7 +100,7 @@ export default class Sync extends Command {
                 task.output = envPlan.action === 'create' ? 'Created on the API' : 'Linked to the API';
         }
         catch (error) {
-            const message = `Failed to sync "${envPlan.env.name}": ${error.message}`;
+            const message = `Failed to push "${envPlan.env.name}": ${error.message}`;
             if (task)
                 task.output = message;
             throw error;
@@ -131,7 +120,7 @@ export default class Sync extends Command {
                 task.output = plan.action === 'create' ? 'Created on the API' : 'Linked to the API';
         }
         catch (error) {
-            const message = `Failed to sync project "${plan.project.name}": ${error.message}`;
+            const message = `Failed to push project "${plan.project.name}": ${error.message}`;
             if (task)
                 task.output = message;
             throw error;
@@ -183,31 +172,6 @@ export default class Sync extends Command {
         }
         return { action: 'create', project };
     }
-    pullProject(apiProject, task) {
-        // Reuse a local project already linked to this API project instead of always minting a
-        // new one: otherwise every sync run that can't "claim" an existing link (e.g. after the
-        // local config was reset or desynced from the API) creates yet another duplicate entry.
-        const existing = configManager.findProjectByApiId(apiProject.id);
-        const environments = { ...existing?.environments };
-        for (const env of apiProject.environments) {
-            environments[env.name] = {
-                ...environments[env.name],
-                addedAt: environments[env.name]?.addedAt ?? env.createdAt,
-                apiEnvironmentId: env.id,
-                name: env.name,
-                url: env.url,
-            };
-        }
-        configManager.setProject(existing?.id ?? configManager.createProjectId(apiProject.name), {
-            addedAt: existing?.addedAt ?? apiProject.createdAt,
-            apiProjectId: apiProject.id,
-            environments,
-            name: apiProject.name,
-        });
-        const envCount = apiProject.environments.length;
-        if (task)
-            task.output = `Pulled with ${envCount} environment${envCount === 1 ? '' : 's'}`;
-    }
     async pushCredentials(api, apiProjectId, apiEnvironmentId, env) {
         if (!env.token)
             return;

package/dist/commands/snippet/publish.js

@@ -32,7 +32,7 @@ export default class Publish extends Command {
             this.error(`Project "${projectId}" (from loopress.json) not found. Run \`lps project config\` to configure it.`);
         }
         if (!project.apiProjectId) {
-            this.error(`Project "${project.name}" is not linked to your Loopress account yet. Run \`lps project sync\` first.`);
+            this.error(`Project "${project.name}" is not linked to your Loopress account yet. Run \`lps project push\` first.`);
         }
         const path = args.path ?? join(localConfig.rootDir ?? '.', localConfig.snippetsDir ?? 'snippets');
         this.log(`Publishing snippets from ${path}`);

package/dist/config/project-config.manager.js

@@ -24,10 +24,10 @@ export class ProjectConfigManager {
             mkdirSync(dir, { recursive: true });
         }
     }
-    // Looks up a local project already linked to a given API project, regardless of whether
-    // it was "claimed" in the current sync run. Used by `project sync` to avoid minting a new
-    // local project every time it pulls an API project whose local link was lost (e.g. after
-    // a reset or partial config corruption), which otherwise accumulates duplicate entries.
+    // Looks up a local project already linked to a given API project. Used by `project pull` to
+    // avoid minting a new local project every time it pulls an API project whose local link was
+    // lost (e.g. after a reset or partial config corruption), which otherwise accumulates
+    // duplicate entries.
     findProjectByApiId(apiProjectId) {
         const config = this.readConfig();
         for (const [id, project] of Object.entries(config.projects)) {

package/dist/hooks/finally.js

@@ -1,4 +1,4 @@
-import { isTelemetryDisabled, resolveEnvironment, runtimeContext, SENTRY_DSN } from '../lib/sentry.js';
+import { isTelemetryDisabled, redactArgv, resolveEnvironment, runtimeContext, SENTRY_DSN, } from '../lib/sentry.js';
 // oclif has no `command_error` hook (checked @oclif/core@4.11.11's hooks.d.ts). `finally`
 // is the closest equivalent: it always runs at the end of the CLI lifecycle and carries
 // the error, if any, so it's where we report crashes before the process exits.
@@ -15,10 +15,15 @@ const hook = async function (options) {
             dsn: SENTRY_DSN,
             environment: resolveEnvironment(),
             release: this.config.version,
+            // Node defaults `server_name` to os.hostname(), which is often the user's real name
+            // (e.g. "jane-doe-macbook-pro"). sendDefaultPii covers IP addresses and similar, off by
+            // default but set explicitly since this reports from users' own machines.
+            sendDefaultPii: false,
+            serverName: 'loopress',
         });
         Sentry.captureException(options.error, {
             contexts: { runtime: runtimeContext() },
-            extra: { argv: options.argv },
+            extra: { argv: redactArgv(options.argv) },
             tags: { command: options.id },
         });
         await Sentry.flush(2000);

package/dist/lib/sentry.d.ts

@@ -5,3 +5,4 @@ export declare function runtimeContext(): {
     node: string;
     os: string;
 };
+export declare function redactArgv(argv: string[]): string[];

package/dist/lib/sentry.js

@@ -20,3 +20,14 @@ export function runtimeContext() {
         os: `${platform()} ${release()}`,
     };
 }
+// Positional args and flag values can carry WordPress URLs, usernames, application passwords,
+// or tokens (e.g. `lps login --token xxx`, `lps project config <url>`). Only flag names are
+// safe to report, they help tell which code path crashed without leaking what was passed to it.
+export function redactArgv(argv) {
+    return argv.map((arg) => {
+        if (!arg.startsWith('-'))
+            return '[REDACTED]';
+        const eqIndex = arg.indexOf('=');
+        return eqIndex === -1 ? arg : arg.slice(0, eqIndex);
+    });
+}

package/dist/types/global-config.generated.d.ts

@@ -30,7 +30,7 @@ export interface ProjectConfig {
      */
     addedAt: string;
     /**
-     * Id of the matching project on the Loopress API, once synced via `lps project sync`.
+     * Id of the matching project on the Loopress API, once pushed via `lps project push`.
      */
     apiProjectId?: string;
     /**
@@ -50,7 +50,7 @@ export interface EnvironmentConfig {
      */
     addedAt: string;
     /**
-     * Id of the matching environment on the Loopress API, once synced via `lps project sync`.
+     * Id of the matching environment on the Loopress API, once pushed via `lps project push`.
      */
     apiEnvironmentId?: string;
     /**

package/oclif.manifest.json

@@ -113,26 +113,25 @@
         "status.js"
       ]
     },
-    "composer:pull": {
+    "snippet:list": {
       "aliases": [],
       "args": {},
-      "description": "Pull composer.lock from WordPress",
+      "description": "List snippets from WordPress",
       "examples": [
-        "$ lps composer pull",
-        "$ lps composer pull --dry-run"
+        "$ lps snippet list"
       ],
       "flags": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
+        "json": {
+          "char": "j",
+          "description": "Output in JSON format",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "composer:pull",
+      "id": "snippet:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -150,96 +149,52 @@
       "relativePath": [
         "dist",
         "commands",
-        "composer",
-        "pull.js"
-      ]
-    },
-    "composer:push": {
-      "aliases": [],
-      "args": {},
-      "description": "Push composer.json and composer.lock to WordPress and run composer install",
-      "examples": [
-        "$ lps composer push",
-        "$ lps composer push --dry-run"
-      ],
-      "flags": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "composer:push",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "composer",
-        "push.js"
+        "snippet",
+        "list.js"
       ]
     },
-    "plugin:add": {
+    "snippet:publish": {
       "aliases": [],
       "args": {
-        "slug": {
-          "description": "Plugin slug on WordPress.org",
-          "name": "slug",
-          "required": true
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
         }
       },
-      "description": "Add a WordPress.org plugin to loopress.json",
+      "description": "Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.",
       "examples": [
-        "$ lps plugin add woocommerce",
-        "$ lps plugin add contact-form-7 --dry-run"
+        "$ lps snippet publish",
+        "$ lps snippet publish --path ./snippets"
       ],
-      "flags": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:add",
+      "id": "snippet:publish",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "dryRunFlag": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
-        "add.js"
+        "snippet",
+        "publish.js"
       ]
     },
-    "plugin:pull": {
+    "snippet:pull": {
       "aliases": [],
-      "args": {},
-      "description": "Pull installed plugins from WordPress into loopress.json",
+      "args": {
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Pull snippets from WordPress",
       "examples": [
-        "$ lps plugin pull",
-        "$ lps plugin pull --dry-run"
+        "$ lps snippet pull",
+        "$ lps snippet pull --path ./snippets"
       ],
       "flags": {
         "dry-run": {
@@ -252,7 +207,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:pull",
+      "id": "snippet:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -270,17 +225,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
+        "snippet",
         "pull.js"
       ]
     },
-    "plugin:push": {
+    "snippet:push": {
       "aliases": [],
-      "args": {},
-      "description": "Push plugins to WordPress to match loopress.json",
+      "args": {
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.",
       "examples": [
-        "$ lps plugin push",
-        "$ lps plugin push --dry-run"
+        "$ lps snippet push",
+        "$ lps snippet push --path ./snippets"
       ],
       "flags": {
         "dry-run": {
@@ -293,7 +253,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:push",
+      "id": "snippet:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -302,7 +262,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
+        "snippet",
         "push.js"
       ]
     },
@@ -354,17 +314,17 @@
         "list.js"
       ]
     },
-    "project:remove": {
+    "project:pull": {
       "aliases": [],
       "args": {},
-      "description": "Remove one or more WordPress projects or environments",
+      "description": "Pull projects and environments from your Loopress account that are not configured locally yet",
       "examples": [
-        "$ lps project remove"
+        "$ lps project pull"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:remove",
+      "id": "project:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -375,20 +335,20 @@
         "dist",
         "commands",
         "project",
-        "remove.js"
+        "pull.js"
       ]
     },
-    "project:switch": {
+    "project:push": {
       "aliases": [],
       "args": {},
-      "description": "Switch the active project and environment",
+      "description": "Push locally configured projects, environments and credentials to your Loopress account",
       "examples": [
-        "$ lps project switch"
+        "$ lps project push"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:switch",
+      "id": "project:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -399,20 +359,20 @@
         "dist",
         "commands",
         "project",
-        "switch.js"
+        "push.js"
       ]
     },
-    "project:sync": {
+    "project:remove": {
       "aliases": [],
       "args": {},
-      "description": "Sync locally configured projects and environments with your Loopress account",
+      "description": "Remove one or more WordPress projects or environments",
       "examples": [
-        "$ lps project sync"
+        "$ lps project remove"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:sync",
+      "id": "project:remove",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -423,91 +383,87 @@
         "dist",
         "commands",
         "project",
-        "sync.js"
+        "remove.js"
       ]
     },
-    "snippet:list": {
+    "project:switch": {
       "aliases": [],
       "args": {},
-      "description": "List snippets from WordPress",
+      "description": "Switch the active project and environment",
       "examples": [
-        "$ lps snippet list"
+        "$ lps project switch"
       ],
-      "flags": {
-        "json": {
-          "char": "j",
-          "description": "Output in JSON format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:list",
+      "id": "project:switch",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "dryRunFlag": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
-        "list.js"
+        "project",
+        "switch.js"
       ]
     },
-    "snippet:publish": {
+    "plugin:add": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to snippets directory (overrides project config)",
-          "name": "path"
+        "slug": {
+          "description": "Plugin slug on WordPress.org",
+          "name": "slug",
+          "required": true
         }
       },
-      "description": "Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.",
+      "description": "Add a WordPress.org plugin to loopress.json",
       "examples": [
-        "$ lps snippet publish",
-        "$ lps snippet publish --path ./snippets"
+        "$ lps plugin add woocommerce",
+        "$ lps plugin add contact-form-7 --dry-run"
       ],
-      "flags": {},
+      "flags": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:publish",
+      "id": "plugin:add",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
-        "publish.js"
+        "plugin",
+        "add.js"
       ]
     },
-    "snippet:pull": {
+    "plugin:pull": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to snippets directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Pull snippets from WordPress",
+      "args": {},
+      "description": "Pull installed plugins from WordPress into loopress.json",
       "examples": [
-        "$ lps snippet pull",
-        "$ lps snippet pull --path ./snippets"
+        "$ lps plugin pull",
+        "$ lps plugin pull --dry-run"
       ],
       "flags": {
         "dry-run": {
@@ -520,7 +476,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:pull",
+      "id": "plugin:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -538,22 +494,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
+        "plugin",
         "pull.js"
       ]
     },
-    "snippet:push": {
+    "plugin:push": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to snippets directory (overrides project config)",
-          "name": "path"
-        }
-      },
-      "description": "Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.",
+      "args": {},
+      "description": "Push plugins to WordPress to match loopress.json",
       "examples": [
-        "$ lps snippet push",
-        "$ lps snippet push --path ./snippets"
+        "$ lps plugin push",
+        "$ lps plugin push --dry-run"
       ],
       "flags": {
         "dry-run": {
@@ -566,7 +517,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "snippet:push",
+      "id": "plugin:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -575,7 +526,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "snippet",
+        "plugin",
         "push.js"
       ]
     },
@@ -626,7 +577,80 @@
         "telemetry",
         "enable.js"
       ]
+    },
+    "composer:pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Pull composer.lock from WordPress",
+      "examples": [
+        "$ lps composer pull",
+        "$ lps composer pull --dry-run"
+      ],
+      "flags": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "composer:pull",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "composer",
+        "pull.js"
+      ]
+    },
+    "composer:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Push composer.json and composer.lock to WordPress and run composer install",
+      "examples": [
+        "$ lps composer push",
+        "$ lps composer push --dry-run"
+      ],
+      "flags": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "composer:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "composer",
+        "push.js"
+      ]
     }
   },
-  "version": "0.14.0"
+  "version": "0.15.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loopress/cli",
   "description": "CLI tool for syncing WordPress code snippets, plugins, and Composer dependencies via the REST API",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",

package/schemas/global-config.schema.json

@@ -50,7 +50,7 @@
         },
         "apiProjectId": {
           "type": "string",
-          "description": "Id of the matching project on the Loopress API, once synced via `lps project sync`."
+          "description": "Id of the matching project on the Loopress API, once pushed via `lps project push`."
         },
         "environments": {
           "type": "object",
@@ -87,7 +87,7 @@
         },
         "apiEnvironmentId": {
           "type": "string",
-          "description": "Id of the matching environment on the Loopress API, once synced via `lps project sync`."
+          "description": "Id of the matching environment on the Loopress API, once pushed via `lps project push`."
         },
         "name": {
           "type": "string",