@loopress/cli 0.6.0 → 0.7.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,10 +69,33 @@
         "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"
@@ -129,7 +152,7 @@
     "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"
@@ -186,7 +209,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,11 +218,10 @@
           "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": {
@@ -256,8 +278,8 @@
       "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": {
@@ -311,10 +333,10 @@
     "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": {
@@ -364,14 +386,110 @@
         "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": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove one or more WordPress projects or environments",
+      "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": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch the active project and environment",
+      "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"
+      ]
+    },
     "snippet:list": {
       "aliases": [],
       "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": {
@@ -444,10 +562,10 @@
       },
       "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": {
@@ -474,10 +592,10 @@
           "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 be written without making changes",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         },
@@ -518,12 +636,12 @@
           "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": {
@@ -550,10 +668,10 @@
           "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"
         },
@@ -584,151 +702,7 @@
         "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.6.0"
+  "version": "0.7.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",
+  "version": "0.7.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -24,6 +24,7 @@
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4.1.20",
     "@types/node": "26.0.1",
+    "@vitest/coverage-v8": "4.1.9",
     "eslint": "^9",
     "eslint-config-oclif": "^6.0.174",
     "eslint-config-prettier": "^10",
@@ -65,7 +66,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}"`);
-    }
-}