@loopress/cli 0.6.0 → 0.8.0

package/oclif.manifest.json

@@ -26,7 +26,7 @@
     "login": {
       "aliases": [],
       "args": {},
-      "description": "Log in to Loopress via the console",
+      "description": "Log in to the Loopress console",
       "examples": [
         "$ lps login"
       ],
@@ -49,7 +49,7 @@
     "logout": {
       "aliases": [],
       "args": {},
-      "description": "Log out from Loopress console",
+      "description": "Log out from the Loopress console",
       "examples": [
         "$ lps logout"
       ],
@@ -69,17 +69,40 @@
         "logout.js"
       ]
     },
+    "status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show which WordPress project and environment commands will target",
+      "examples": [
+        "$ lps status"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "status",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "status.js"
+      ]
+    },
     "composer:pull": {
       "aliases": [],
       "args": {},
-      "description": "Pull composer.lock from the WordPress server",
+      "description": "Pull composer.lock from WordPress",
       "examples": [
         "$ lps composer pull",
         "$ lps composer pull --dry-run"
       ],
       "flags": {
         "password": {
-          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "description": "WordPress application password (overrides project config, requires --user)",
           "helpGroup": "GLOBAL",
           "name": "password",
           "hasDynamicHelp": false,
@@ -87,7 +110,7 @@
           "type": "option"
         },
         "url": {
-          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "description": "WordPress URL (overrides project config)",
           "helpGroup": "GLOBAL",
           "name": "url",
           "hasDynamicHelp": false,
@@ -95,7 +118,7 @@
           "type": "option"
         },
         "user": {
-          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "description": "WordPress username (overrides project config, requires --password)",
           "helpGroup": "GLOBAL",
           "name": "user",
           "hasDynamicHelp": false,
@@ -104,7 +127,7 @@
         },
         "dry-run": {
           "char": "d",
-          "description": "Show what would be written without making changes",
+          "description": "Show what would change without making changes",
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
@@ -118,6 +141,14 @@
       "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",
@@ -129,14 +160,14 @@
     "composer:push": {
       "aliases": [],
       "args": {},
-      "description": "Upload composer.json and composer.lock to WordPress and run composer install",
+      "description": "Push composer.json and composer.lock to WordPress and run composer install",
       "examples": [
         "$ lps composer push",
         "$ lps composer push --dry-run"
       ],
       "flags": {
         "password": {
-          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "description": "WordPress application password (overrides project config, requires --user)",
           "helpGroup": "GLOBAL",
           "name": "password",
           "hasDynamicHelp": false,
@@ -144,7 +175,7 @@
           "type": "option"
         },
         "url": {
-          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "description": "WordPress URL (overrides project config)",
           "helpGroup": "GLOBAL",
           "name": "url",
           "hasDynamicHelp": false,
@@ -152,7 +183,7 @@
           "type": "option"
         },
         "user": {
-          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "description": "WordPress username (overrides project config, requires --password)",
           "helpGroup": "GLOBAL",
           "name": "user",
           "hasDynamicHelp": false,
@@ -186,7 +217,7 @@
       "aliases": [],
       "args": {
         "slug": {
-          "description": "Plugin slug (WordPress.org) or Composer package (vendor/package)",
+          "description": "Plugin slug on WordPress.org",
           "name": "slug",
           "required": true
         },
@@ -195,16 +226,15 @@
           "name": "version"
         }
       },
-      "description": "Add a plugin to loopress.json (WordPress.org) or run composer require (vendor/package)",
+      "description": "Add a WordPress.org plugin to loopress.json",
       "examples": [
         "$ 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": {
-          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "description": "WordPress application password (overrides project config, requires --user)",
           "helpGroup": "GLOBAL",
           "name": "password",
           "hasDynamicHelp": false,
@@ -212,7 +242,7 @@
           "type": "option"
         },
         "url": {
-          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "description": "WordPress URL (overrides project config)",
           "helpGroup": "GLOBAL",
           "name": "url",
           "hasDynamicHelp": false,
@@ -220,7 +250,7 @@
           "type": "option"
         },
         "user": {
-          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "description": "WordPress username (overrides project config, requires --password)",
           "helpGroup": "GLOBAL",
           "name": "user",
           "hasDynamicHelp": false,
@@ -229,7 +259,7 @@
         },
         "dry-run": {
           "char": "d",
-          "description": "Show what would be written without making changes",
+          "description": "Show what would change without making changes",
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
@@ -243,6 +273,14 @@
       "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",
@@ -256,12 +294,12 @@
       "args": {},
       "description": "Pull installed plugins from WordPress into loopress.json",
       "examples": [
-        "$ lps plugins pull",
-        "$ lps plugins pull --dry-run"
+        "$ lps plugin pull",
+        "$ lps plugin pull --dry-run"
       ],
       "flags": {
         "password": {
-          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "description": "WordPress application password (overrides project config, requires --user)",
           "helpGroup": "GLOBAL",
           "name": "password",
           "hasDynamicHelp": false,
@@ -269,7 +307,7 @@
           "type": "option"
         },
         "url": {
-          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "description": "WordPress URL (overrides project config)",
           "helpGroup": "GLOBAL",
           "name": "url",
           "hasDynamicHelp": false,
@@ -277,7 +315,7 @@
           "type": "option"
         },
         "user": {
-          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "description": "WordPress username (overrides project config, requires --password)",
           "helpGroup": "GLOBAL",
           "name": "user",
           "hasDynamicHelp": false,
@@ -286,7 +324,7 @@
         },
         "dry-run": {
           "char": "d",
-          "description": "Show what would be written without making changes",
+          "description": "Show what would change without making changes",
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
@@ -300,6 +338,14 @@
       "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",
@@ -311,14 +357,14 @@
     "plugin:push": {
       "aliases": [],
       "args": {},
-      "description": "Sync plugins on WordPress to match loopress.json",
+      "description": "Push plugins to WordPress to match loopress.json",
       "examples": [
-        "$ lps plugins push",
-        "$ lps plugins push --dry-run"
+        "$ lps plugin push",
+        "$ lps plugin push --dry-run"
       ],
       "flags": {
         "password": {
-          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "description": "WordPress application password (overrides project config, requires --user)",
           "helpGroup": "GLOBAL",
           "name": "password",
           "hasDynamicHelp": false,
@@ -326,7 +372,7 @@
           "type": "option"
         },
         "url": {
-          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "description": "WordPress URL (overrides project config)",
           "helpGroup": "GLOBAL",
           "name": "url",
           "hasDynamicHelp": false,
@@ -334,7 +380,7 @@
           "type": "option"
         },
         "user": {
-          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "description": "WordPress username (overrides project config, requires --password)",
           "helpGroup": "GLOBAL",
           "name": "user",
           "hasDynamicHelp": false,
@@ -369,13 +415,13 @@
       "args": {},
       "description": "List snippets from WordPress",
       "examples": [
-        "$ lps snippets list",
-        "$ lps snippets list --url http://example.com",
-        "$ lps snippets list --plugin wpcode"
+        "$ lps snippet list",
+        "$ lps snippet list --url http://example.com",
+        "$ lps snippet list --plugin wpcode"
       ],
       "flags": {
         "password": {
-          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "description": "WordPress application password (overrides project config, requires --user)",
           "helpGroup": "GLOBAL",
           "name": "password",
           "hasDynamicHelp": false,
@@ -383,7 +429,7 @@
           "type": "option"
         },
         "url": {
-          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "description": "WordPress URL (overrides project config)",
           "helpGroup": "GLOBAL",
           "name": "url",
           "hasDynamicHelp": false,
@@ -391,7 +437,7 @@
           "type": "option"
         },
         "user": {
-          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "description": "WordPress username (overrides project config, requires --password)",
           "helpGroup": "GLOBAL",
           "name": "user",
           "hasDynamicHelp": false,
@@ -426,6 +472,14 @@
       "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",
@@ -444,14 +498,14 @@
       },
       "description": "Pull snippets from WordPress",
       "examples": [
-        "$ lps snippets pull",
-        "$ lps snippets pull --url http://example.com",
-        "$ lps snippets pull --path ./snippets",
-        "$ lps snippets pull --plugin wpcode"
+        "$ lps snippet pull",
+        "$ lps snippet pull --url http://example.com",
+        "$ lps snippet pull --path ./snippets",
+        "$ lps snippet pull --plugin wpcode"
       ],
       "flags": {
         "password": {
-          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "description": "WordPress application password (overrides project config, requires --user)",
           "helpGroup": "GLOBAL",
           "name": "password",
           "hasDynamicHelp": false,
@@ -459,7 +513,7 @@
           "type": "option"
         },
         "url": {
-          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "description": "WordPress URL (overrides project config)",
           "helpGroup": "GLOBAL",
           "name": "url",
           "hasDynamicHelp": false,
@@ -467,17 +521,17 @@
           "type": "option"
         },
         "user": {
-          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "description": "WordPress username (overrides project config, requires --password)",
           "helpGroup": "GLOBAL",
           "name": "user",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dryRun": {
+        "dry-run": {
           "char": "d",
-          "description": "Dry run - show what would happen without making changes",
-          "name": "dryRun",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         },
@@ -502,6 +556,14 @@
       "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",
@@ -518,16 +580,16 @@
           "name": "path"
         }
       },
-      "description": "Push snippets to WordPress",
+      "description": "Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.",
       "examples": [
-        "$ lps snippets push",
-        "$ lps snippets push --url http://example.com",
-        "$ lps snippets push --path ./snippets",
-        "$ lps snippets push --plugin wpcode"
+        "$ lps snippet push",
+        "$ lps snippet push --url http://example.com",
+        "$ lps snippet push --path ./snippets",
+        "$ lps snippet push --plugin wpcode"
       ],
       "flags": {
         "password": {
-          "description": "WordPress application password (fallback; prefer `lps project config`)",
+          "description": "WordPress application password (overrides project config, requires --user)",
           "helpGroup": "GLOBAL",
           "name": "password",
           "hasDynamicHelp": false,
@@ -535,7 +597,7 @@
           "type": "option"
         },
         "url": {
-          "description": "WordPress URL (fallback; prefer `lps project config`)",
+          "description": "WordPress URL (overrides project config)",
           "helpGroup": "GLOBAL",
           "name": "url",
           "hasDynamicHelp": false,
@@ -543,17 +605,17 @@
           "type": "option"
         },
         "user": {
-          "description": "WordPress username (fallback; prefer `lps project config`)",
+          "description": "WordPress username (overrides project config, requires --password)",
           "helpGroup": "GLOBAL",
           "name": "user",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dryRun": {
+        "dry-run": {
           "char": "d",
-          "description": "Dry run - show what would happen without making changes",
-          "name": "dryRun",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         },
@@ -633,34 +695,10 @@
         "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",
+      "description": "Remove one or more WordPress projects or environments",
       "examples": [
         "$ lps project remove"
       ],
@@ -681,34 +719,10 @@
         "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",
+      "description": "Switch the active project and environment",
       "examples": [
         "$ lps project switch"
       ],
@@ -730,5 +744,5 @@
       ]
     }
   },
-  "version": "0.6.0"
+  "version": "0.8.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.6.0",
+  "description": "CLI tool for syncing WordPress code snippets, plugins, and Composer dependencies via the REST API",
+  "version": "0.8.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -17,13 +17,16 @@
     "@oclif/plugin-plugins": "^5.4.80",
     "glob": "13.0.6",
     "got": "^15.0.7",
-    "slugify": "^1.6.9"
+    "slugify": "^1.6.9",
+    "write-file-atomic": "^5.0.1"
   },
   "devDependencies": {
     "@eslint/compat": "2.1.0",
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4.1.20",
     "@types/node": "26.0.1",
+    "@types/write-file-atomic": "^4.0.3",
+    "@vitest/coverage-v8": "4.1.9",
     "eslint": "^9",
     "eslint-config-oclif": "^6.0.174",
     "eslint-config-prettier": "^10",
@@ -65,7 +68,21 @@
     "plugins": [
       "@oclif/plugin-help"
     ],
-    "topicSeparator": " "
+    "topicSeparator": " ",
+    "topics": {
+      "composer": {
+        "description": "Sync composer.json and composer.lock between your project and WordPress"
+      },
+      "plugin": {
+        "description": "Manage WordPress.org plugins tracked in loopress.json"
+      },
+      "project": {
+        "description": "Manage WordPress project and environment configurations"
+      },
+      "snippet": {
+        "description": "Manage WordPress code snippets"
+      }
+    }
   },
   "repository": {
     "type": "git",

package/dist/commands/project/remove-env.js

@@ -1,33 +0,0 @@
-import { checkbox } from '@inquirer/prompts';
-import { Command } from '@oclif/core';
-import { configManager } from '../../config/project-config.manager.js';
-export default class RemoveEnv extends Command {
-    static description = 'Remove one or more environments from the current project';
-    static examples = ['$ lps project remove-env'];
-    async run() {
-        await this.parse(RemoveEnv);
-        const project = configManager.getCurrentProject();
-        if (!project) {
-            this.error('No project configured. Run `lps project config` first.');
-        }
-        const envs = configManager.listEnvironments(project.name);
-        if (envs.length === 0) {
-            this.error('No environments configured.');
-        }
-        const chosen = await checkbox({
-            choices: envs.map((env) => ({
-                name: `${env.isCurrent ? '●' : '○'} ${env.name.padEnd(20)} ${env.url}${env.isCurrent ? ' [current]' : ''}`,
-                value: env.name,
-            })),
-            message: 'Select environments to remove',
-        });
-        if (chosen.length === 0) {
-            this.log('Nothing removed.');
-            return;
-        }
-        for (const envName of chosen) {
-            configManager.removeEnvironment(project.name, envName);
-        }
-        this.log(`✓ Removed: ${chosen.join(', ')}`);
-    }
-}

package/dist/commands/project/switch-env.d.ts

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

package/dist/commands/project/switch-env.js

@@ -1,33 +0,0 @@
-import { select } from '@inquirer/prompts';
-import { Command } from '@oclif/core';
-import { configManager } from '../../config/project-config.manager.js';
-export default class SwitchEnv extends Command {
-    static description = 'Switch the active environment within the current project';
-    static examples = ['$ lps project switch-env'];
-    async run() {
-        await this.parse(SwitchEnv);
-        const project = configManager.getCurrentProject();
-        if (!project) {
-            this.error('No project configured. Run `lps project config` first.');
-        }
-        const envs = configManager.listEnvironments(project.name);
-        if (envs.length === 0) {
-            this.error('No environments configured for this project.');
-        }
-        if (envs.length === 1) {
-            configManager.setCurrentEnv(project.name, envs[0].name);
-            this.log(`✓ Switched to "${project.name}/${envs[0].name}"`);
-            return;
-        }
-        const chosen = await select({
-            choices: envs.map((env) => ({
-                name: `${env.isCurrent ? '●' : '○'} ${env.name.padEnd(20)} ${env.url}${env.isCurrent ? ' [current]' : ''}`,
-                value: env.name,
-            })),
-            default: envs.find((e) => e.isCurrent)?.name,
-            message: `Select environment for "${project.name}"`,
-        });
-        configManager.setCurrentEnv(project.name, chosen);
-        this.log(`✓ Switched to "${project.name}/${chosen}"`);
-    }
-}

package/dist/types/menu.d.ts

@@ -1,7 +0,0 @@
-export interface NavMenu {
-    [key: string]: any;
-    description?: string;
-    id: number;
-    name: string;
-    slug: string;
-}