@loopress/cli 0.12.0 → 0.14.0

package/oclif.manifest.json

@@ -193,16 +193,11 @@
           "description": "Plugin slug on WordPress.org",
           "name": "slug",
           "required": true
-        },
-        "version": {
-          "description": "Version to pin (default: latest)",
-          "name": "version"
         }
       },
       "description": "Add a WordPress.org plugin to loopress.json",
       "examples": [
         "$ lps plugin add woocommerce",
-        "$ lps plugin add woocommerce 8.9.1",
         "$ lps plugin add contact-form-7 --dry-run"
       ],
       "flags": {
@@ -311,6 +306,126 @@
         "push.js"
       ]
     },
+    "project:config": {
+      "aliases": [],
+      "args": {},
+      "description": "Add or update a WordPress project environment. By default, authorizes via WordPress in your browser; manual username/Application Password entry is available as a fallback.",
+      "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"
+      ]
+    },
+    "project:sync": {
+      "aliases": [],
+      "args": {},
+      "description": "Sync locally configured projects and environments with your Loopress account",
+      "examples": [
+        "$ lps project sync"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:sync",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "sync.js"
+      ]
+    },
     "snippet:list": {
       "aliases": [],
       "args": {},
@@ -351,6 +466,36 @@
         "list.js"
       ]
     },
+    "snippet:publish": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to snippets directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.",
+      "examples": [
+        "$ lps snippet publish",
+        "$ lps snippet publish --path ./snippets"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "snippet:publish",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "snippet",
+        "publish.js"
+      ]
+    },
     "snippet:pull": {
       "aliases": [],
       "args": {
@@ -434,17 +579,17 @@
         "push.js"
       ]
     },
-    "project:config": {
+    "telemetry:disable": {
       "aliases": [],
       "args": {},
-      "description": "Add or update a WordPress project environment",
+      "description": "Disable error reporting to Sentry",
       "examples": [
-        "$ lps project config"
+        "$ lps telemetry disable"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:config",
+      "id": "telemetry:disable",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -454,21 +599,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "project",
-        "config.js"
+        "telemetry",
+        "disable.js"
       ]
     },
-    "project:list": {
+    "telemetry:enable": {
       "aliases": [],
       "args": {},
-      "description": "List configured WordPress projects",
+      "description": "Enable error reporting to Sentry",
       "examples": [
-        "$ lps project list"
+        "$ lps telemetry enable"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:list",
+      "id": "telemetry:enable",
       "pluginAlias": "@loopress/cli",
       "pluginName": "@loopress/cli",
       "pluginType": "core",
@@ -478,82 +623,10 @@
       "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"
-      ]
-    },
-    "project:sync": {
-      "aliases": [],
-      "args": {},
-      "description": "Sync locally configured projects and environments with your Loopress account",
-      "examples": [
-        "$ lps project sync"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:sync",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "sync.js"
+        "telemetry",
+        "enable.js"
       ]
     }
   },
-  "version": "0.12.0"
+  "version": "0.14.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.12.0",
+  "version": "0.14.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -19,6 +19,7 @@
     "glob": "13.0.6",
     "got": "^15.0.7",
     "listr2": "^10.2.2",
+    "open": "^10.2.0",
     "slugify": "^1.6.9",
     "write-file-atomic": "^5.0.1"
   },
@@ -94,6 +95,9 @@
       },
       "snippet": {
         "description": "Manage WordPress code snippets"
+      },
+      "telemetry": {
+        "description": "Manage error reporting preferences"
       }
     }
   },
@@ -109,6 +113,7 @@
     "prewatch": "pnpm run schema:types",
     "watch": "tsc -b --watch",
     "build": "shx rm -rf dist && pnpm run schema:types && tsc -b",
+    "prelint": "pnpm run schema:types",
     "lint": "eslint",
     "pretest": "pnpm run schema:types",
     "posttest": "pnpm run lint",
@@ -116,7 +121,7 @@
     "test": "vitest run",
     "pretest:mutation": "pnpm run schema:types",
     "test:mutation": "stryker run",
-    "version": "oclif readme && git add README.md",
+    "version": "oclif manifest && oclif readme && git add README.md oclif.manifest.json",
     "format": "prettier . --write"
   }
 }

package/schemas/global-config.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://loopress.dev/schema/global-config.json",
   "title": "Loopress global configuration",
-  "description": "Global CLI state stored at ~/.loopress/config.json: known projects, their environments, and which one is currently active.",
+  "description": "Global CLI state stored at $XDG_CONFIG_HOME/loopress/config.json (or ~/.config/loopress/config.json): known projects, their environments, and which one is currently active.",
   "type": "object",
   "additionalProperties": false,
   "required": ["currentProject", "projects"],
@@ -15,6 +15,10 @@
       "type": "object",
       "description": "Known projects, keyed by project id.",
       "additionalProperties": {"$ref": "#/definitions/ProjectConfig"}
+    },
+    "telemetry": {
+      "description": "User preferences for error reporting, set via `lps telemetry disable`/`lps telemetry enable`.",
+      "$ref": "#/definitions/TelemetryConfig"
     }
   },
   "definitions": {
@@ -59,6 +63,18 @@
         }
       }
     },
+    "TelemetryConfig": {
+      "title": "TelemetryConfig",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["disabled"],
+      "properties": {
+        "disabled": {
+          "type": "boolean",
+          "description": "Whether error reporting to Sentry is disabled."
+        }
+      }
+    },
     "EnvironmentConfig": {
       "title": "EnvironmentConfig",
       "type": "object",

package/schemas/project-config.schema.json

@@ -25,15 +25,14 @@
     },
     "plugins": {
       "type": "object",
-      "description": "Pinned plugin versions. Keys are WordPress.org plugin slugs, values are version constraints.",
+      "description": "WordPress.org plugins managed by Loopress. Keys are plugin slugs; values are written as \"latest\" since installs go through WordPress's native plugin API, which only installs the current version. Older files may still have a pinned version string here from before this was the case; it is read but no longer acted on.",
       "additionalProperties": {
         "type": "string",
-        "description": "Version to pin. Use an exact version (e.g. \"8.9.1\") or \"latest\".",
-        "examples": ["8.9.1", "latest"]
+        "examples": ["latest"]
       },
       "examples": [
         {
-          "woocommerce": "8.9.1",
+          "woocommerce": "latest",
           "contact-form-7": "latest"
         }
       ]