@loopress/cli 0.5.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,13 +69,36 @@
         "logout.js"
       ]
     },
-    "plugin:pull": {
+    "status": {
       "aliases": [],
       "args": {},
-      "description": "Pull installed plugins from WordPress into loopress.json",
+      "description": "Show which WordPress project and environment commands will target",
       "examples": [
-        "$ lps plugins pull",
-        "$ lps plugins pull --dry-run"
+        "$ 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 WordPress",
+      "examples": [
+        "$ lps composer pull",
+        "$ lps composer pull --dry-run"
       ],
       "flags": {
         "password": {
@@ -112,7 +135,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:pull",
+      "id": "composer:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -122,17 +145,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
+        "composer",
         "pull.js"
       ]
     },
-    "plugin:push": {
+    "composer:push": {
       "aliases": [],
       "args": {},
-      "description": "Sync plugins on WordPress to match loopress.json",
+      "description": "Push 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 +192,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:push",
+      "id": "composer:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -178,15 +201,15 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
+        "composer",
         "push.js"
       ]
     },
-    "plugin:require": {
+    "plugin:add": {
       "aliases": [],
       "args": {
         "slug": {
-          "description": "Plugin slug (WordPress.org)",
+          "description": "Plugin slug on WordPress.org",
           "name": "slug",
           "required": true
         },
@@ -195,11 +218,11 @@
           "name": "version"
         }
       },
-      "description": "Add a plugin to loopress.json, resolving its latest version from WordPress.org",
+      "description": "Add a WordPress.org plugin to loopress.json",
       "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 contact-form-7 --dry-run"
       ],
       "flags": {
         "password": {
@@ -236,7 +259,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:require",
+      "id": "plugin:add",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -247,20 +270,53 @@
         "dist",
         "commands",
         "plugin",
-        "require.js"
+        "add.js"
       ]
     },
-    "project:config": {
+    "plugin:pull": {
       "aliases": [],
       "args": {},
-      "description": "Add or update a WordPress project environment",
+      "description": "Pull installed plugins from WordPress into loopress.json",
       "examples": [
-        "$ lps project config"
+        "$ lps plugin pull",
+        "$ lps plugin 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:config",
+      "id": "plugin:pull",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -270,45 +326,77 @@
       "relativePath": [
         "dist",
         "commands",
-        "project",
-        "config.js"
+        "plugin",
+        "pull.js"
       ]
     },
-    "project:list": {
+    "plugin:push": {
       "aliases": [],
       "args": {},
-      "description": "List configured WordPress projects",
+      "description": "Push plugins to WordPress to match loopress.json",
       "examples": [
-        "$ lps project list"
+        "$ lps plugin push",
+        "$ lps plugin 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:list",
+      "id": "plugin:push",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "project",
-        "list.js"
+        "plugin",
+        "push.js"
       ]
     },
-    "project:remove-env": {
+    "project:config": {
       "aliases": [],
       "args": {},
-      "description": "Remove one or more environments from the current project",
+      "description": "Add or update a WordPress project environment",
       "examples": [
-        "$ lps project remove-env"
+        "$ lps project config"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:remove-env",
+      "id": "project:config",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -319,20 +407,20 @@
         "dist",
         "commands",
         "project",
-        "remove-env.js"
+        "config.js"
       ]
     },
-    "project:remove": {
+    "project:list": {
       "aliases": [],
       "args": {},
-      "description": "Remove one or more WordPress project configurations",
+      "description": "List configured WordPress projects",
       "examples": [
-        "$ lps project remove"
+        "$ lps project list"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:remove",
+      "id": "project:list",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -343,20 +431,20 @@
         "dist",
         "commands",
         "project",
-        "remove.js"
+        "list.js"
       ]
     },
-    "project:switch-env": {
+    "project:remove": {
       "aliases": [],
       "args": {},
-      "description": "Switch the active environment within the current project",
+      "description": "Remove one or more WordPress projects or environments",
       "examples": [
-        "$ lps project switch-env"
+        "$ lps project remove"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:switch-env",
+      "id": "project:remove",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -367,13 +455,13 @@
         "dist",
         "commands",
         "project",
-        "switch-env.js"
+        "remove.js"
       ]
     },
     "project:switch": {
       "aliases": [],
       "args": {},
-      "description": "Switch the active project",
+      "description": "Switch the active project and environment",
       "examples": [
         "$ lps project switch"
       ],
@@ -399,9 +487,9 @@
       "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": {
@@ -474,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": {
@@ -504,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"
         },
@@ -548,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": {
@@ -580,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"
         },
@@ -616,5 +704,5 @@
       ]
     }
   },
-  "version": "0.5.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.5.0",
+  "version": "0.7.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",
@@ -24,15 +24,16 @@
     "@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",
-    "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 +49,10 @@
   ],
   "license": "MPL-2.0",
   "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./schema": "./loopress.schema.json"
+  },
   "type": "module",
   "oclif": {
     "bin": "lps",
@@ -61,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.d.ts

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

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.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}"`);
-    }
-}