@loopress/cli 0.12.0 → 0.14.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.12.0 linux-x64 node-v24.18.0
+@loopress/cli/0.14.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -35,8 +35,9 @@ Loopress sends crash reports to our Sentry project so we can find and fix bugs.
 
 To opt out, either:
 
-- set `LOOPRESS_TELEMETRY_DISABLED=1`, or
-- pass `--no-error-reporting` on the command.
+- run `lps telemetry disable` (persists across all future commands), or
+- set `LOOPRESS_TELEMETRY_DISABLED=1` (overrides the persisted preference for a single run,
+  useful in CI).
 
 A crash report includes the command name, its flags/args as typed, your Node.js
 version, and OS. WordPress credentials are configured via `lps project config`
@@ -52,7 +53,7 @@ report.
 * [`lps init`](#lps-init)
 * [`lps login`](#lps-login)
 * [`lps logout`](#lps-logout)
-* [`lps plugin add SLUG [VERSION]`](#lps-plugin-add-slug-version)
+* [`lps plugin add SLUG`](#lps-plugin-add-slug)
 * [`lps plugin pull`](#lps-plugin-pull)
 * [`lps plugin push`](#lps-plugin-push)
 * [`lps project config`](#lps-project-config)
@@ -61,9 +62,12 @@ report.
 * [`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)
 * [`lps snippet push [PATH]`](#lps-snippet-push-path)
 * [`lps status`](#lps-status)
+* [`lps telemetry disable`](#lps-telemetry-disable)
+* [`lps telemetry enable`](#lps-telemetry-enable)
 
 ## `lps composer pull`
 
@@ -85,7 +89,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
@@ -107,7 +111,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/composer/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -144,7 +148,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -161,7 +165,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -178,19 +182,18 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/logout.ts)_
 
-## `lps plugin add SLUG [VERSION]`
+## `lps plugin add SLUG`
 
 Add a WordPress.org plugin to loopress.json
 
 ```
 USAGE
-  $ lps plugin add SLUG [VERSION] [-d]
+  $ lps plugin add SLUG [-d]
 
 ARGUMENTS
-  SLUG       Plugin slug on WordPress.org
-  [VERSION]  Version to pin (default: latest)
+  SLUG  Plugin slug on WordPress.org
 
 FLAGS
   -d, --dry-run  Show what would change without making changes
@@ -201,12 +204,10 @@ DESCRIPTION
 EXAMPLES
   $ lps plugin add woocommerce
 
-  $ lps plugin add woocommerce 8.9.1
-
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/plugin/add.ts)_
 
 ## `lps plugin pull`
 
@@ -228,7 +229,7 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
@@ -250,24 +251,25 @@ EXAMPLES
   $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
-Add or update a WordPress project environment
+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.
 
 ```
 USAGE
   $ lps project config
 
 DESCRIPTION
-  Add or update a WordPress project environment
+  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
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -284,7 +286,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/list.ts)_
 
 ## `lps project remove`
 
@@ -301,7 +303,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/remove.ts)_
 
 ## `lps project switch`
 
@@ -318,7 +320,7 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/switch.ts)_
 
 ## `lps project sync`
 
@@ -335,7 +337,7 @@ EXAMPLES
   $ lps project sync
 ```
 
-_See code: [src/commands/project/sync.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/sync.ts)_
+_See code: [src/commands/project/sync.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/project/sync.ts)_
 
 ## `lps snippet list`
 
@@ -355,7 +357,30 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/snippet/list.ts)_
+
+## `lps snippet publish [PATH]`
+
+Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.
+
+```
+USAGE
+  $ lps snippet publish [PATH]
+
+ARGUMENTS
+  [PATH]  Path to snippets directory (overrides project config)
+
+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
+```
+
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -380,7 +405,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -406,7 +431,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -423,5 +448,39 @@ EXAMPLES
   $ lps status
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.14.0/src/commands/status.ts)_
+
+## `lps telemetry disable`
+
+Disable error reporting to Sentry
+
+```
+USAGE
+  $ lps telemetry disable
+
+DESCRIPTION
+  Disable error reporting to Sentry
+
+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)_
+
+## `lps telemetry enable`
+
+Enable error reporting to Sentry
+
+```
+USAGE
+  $ lps telemetry enable
+
+DESCRIPTION
+  Enable error reporting to Sentry
+
+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)_
 <!-- commandsstop -->

package/dist/commands/init.js

@@ -3,7 +3,7 @@ import { Command } from '@oclif/core';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { configManager } from '../config/project-config.manager.js';
-import { readLocalConfig, writeLocalConfig } from '../utils/loopress-config.js';
+import { writeLocalConfig } from '../utils/loopress-config.js';
 // WordPress.org slugs for the two snippet plugins the Loopress WordPress plugin supports
 // (see SnippetModule.php, which wires up both providers and auto-detects the active one).
 const SNIPPET_PROVIDERS = [
@@ -76,11 +76,11 @@ export default class Init extends Command {
             snippetsDir,
         };
         await writeLocalConfig(config);
-        let providerVersion;
+        let providerAdded = false;
         if (providerChoice !== '__none__') {
             try {
                 await this.config.runCommand('plugin:add', [providerChoice]);
-                providerVersion = (await readLocalConfig()).plugins?.[providerChoice];
+                providerAdded = true;
             }
             catch (error) {
                 this.warn(error.message);
@@ -89,8 +89,8 @@ export default class Init extends Command {
         this.log(`\n✓ loopress.json created`);
         this.log(`  Project:  ${projectLabel}`);
         this.log(`  Snippets: ${join(rootDir, snippetsDir)}`);
-        if (providerChoice !== '__none__' && providerVersion) {
-            this.log(`  Plugin:   ${providerChoice}@${providerVersion}`);
+        if (providerAdded) {
+            this.log(`  Plugin:   ${providerChoice}`);
         }
     }
 }

package/dist/commands/login.d.ts

@@ -3,6 +3,5 @@ export default class Login extends Command {
     static description: string;
     static examples: string[];
     run(): Promise<void>;
-    private openBrowser;
     private waitForCallback;
 }

package/dist/commands/login.js

@@ -1,9 +1,7 @@
 import { Command } from '@oclif/core';
-import { exec } from 'node:child_process';
-import { createServer } from 'node:http';
 import { authManager } from '../config/auth.manager.js';
+import { renderResultPage, waitForLocalCallback } from '../lib/local-callback-server.js';
 const CONSOLE_URL = 'https://console.loopress.dev';
-const TIMEOUT_MS = 5 * 60 * 1000;
 export default class Login extends Command {
     static description = 'Log in to the Loopress console';
     static examples = ['$ lps login'];
@@ -12,95 +10,28 @@ export default class Login extends Command {
         authManager.setAuth({ email, savedAt: new Date().toISOString(), token });
         this.log(`\nLogged in${email ? ` as ${email}` : ''}. You're all set!`);
     }
-    openBrowser(url) {
-        const cmds = {
-            darwin: `open "${url}"`,
-            linux: `xdg-open "${url}"`,
-            win32: `start "" "${url}"`,
-        };
-        const cmd = cmds[process.platform];
-        if (cmd)
-            exec(cmd);
-    }
     waitForCallback() {
-        return new Promise((resolve, reject) => {
-            const server = createServer((req, res) => {
-                try {
-                    const url = new URL(req.url ?? '/', 'http://localhost');
-                    const token = url.searchParams.get('token');
-                    const email = url.searchParams.get('email') ?? undefined;
-                    if (!token) {
-                        res.writeHead(400, { 'Content-Type': 'text/plain' });
-                        res.end('Missing token');
-                        return;
-                    }
-                    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-                    res.end(SUCCESS_PAGE);
-                    clearTimeout(timer);
-                    server.close();
-                    resolve({ email, token });
-                }
-                catch (error) {
-                    res.writeHead(500);
-                    res.end('Internal error');
-                    server.close();
-                    reject(error);
+        return waitForLocalCallback({
+            buildUrl: (callbackBaseUrl) => `${CONSOLE_URL}/cli-auth?callbackUrl=${encodeURIComponent(`${callbackBaseUrl}/callback`)}`,
+            handleRequest(url, { resolveWithPage, respondBadRequest }) {
+                const token = url.searchParams.get('token');
+                const email = url.searchParams.get('email') ?? undefined;
+                if (!token) {
+                    respondBadRequest('Missing token');
+                    return;
                 }
-            });
-            server.on('error', (err) => {
-                clearTimeout(timer);
-                reject(err);
-            });
-            const timer = setTimeout(() => {
-                server.close();
-                reject(new Error('Login timed out after 5 minutes. Please try again.'));
-            }, TIMEOUT_MS);
-            server.listen(0, '127.0.0.1', () => {
-                const { port } = server.address();
-                const callbackUrl = `http://localhost:${port}/callback`;
-                const loginUrl = `${CONSOLE_URL}/cli-auth?callbackUrl=${encodeURIComponent(callbackUrl)}`;
-                this.log('Opening Loopress console in your browser...');
-                this.log(`\nIf it doesn't open automatically, visit:\n${loginUrl}\n`);
-                this.openBrowser(loginUrl);
-            });
+                resolveWithPage(SUCCESS_PAGE, { email, token });
+            },
+            log: (message) => this.log(message),
+            openingMessage: 'Opening Loopress console in your browser...',
+            timeoutMessage: 'Login timed out after 5 minutes. Please try again.',
         });
     }
 }
-const SUCCESS_PAGE = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Loopress: Logged in</title>
-  <style>
-    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
-    body {
-      font-family: system-ui, -apple-system, sans-serif;
-      background: #f0fdf4;
-      display: flex;
-      align-items: center;
-      justify-content: center;
-      min-height: 100dvh;
-    }
-    .card {
-      background: #fff;
-      border-radius: 16px;
-      padding: 2.5rem 3rem;
-      text-align: center;
-      box-shadow: 0 4px 32px rgba(0, 0, 0, .08);
-      max-width: 420px;
-      width: 90%;
-    }
-    .icon { font-size: 3rem; margin-bottom: 1rem; }
-    h1 { color: #15803d; font-size: 1.5rem; margin-bottom: .5rem; }
-    p { color: #6b7280; font-size: .95rem; line-height: 1.5; }
-  </style>
-</head>
-<body>
-  <div class="card">
-    <div class="icon">✅</div>
-    <h1>Login successful!</h1>
-    <p>You can close this tab and return to your terminal.</p>
-  </div>
-</body>
-</html>`;
+const SUCCESS_PAGE = renderResultPage({
+    background: '#f0fdf4',
+    heading: 'Login successful!',
+    headingColor: '#15803d',
+    icon: '✅',
+    tabTitle: 'Logged in',
+});

package/dist/commands/plugin/add.d.ts

@@ -1,9 +1,7 @@
 import { LoopressCommand } from '../../lib/base.js';
-export declare function resolvePluginVersion(slug: string, version: string): Promise<string>;
 export default class Add extends LoopressCommand {
     static args: {
         slug: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-        version: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];

package/dist/commands/plugin/add.js

@@ -1,73 +1,32 @@
 import { Args } from '@oclif/core';
-import got from 'got';
 import { LoopressCommand } from '../../lib/base.js';
 import { writeLocalConfig } from '../../utils/loopress-config.js';
-const WP_ORG_API = 'https://api.wordpress.org/plugins/info/1.2/';
-const WP_ORG_TIMEOUT_MS = 10_000;
-export async function resolvePluginVersion(slug, version) {
-    if (version !== 'latest')
-        return version;
-    let info;
-    try {
-        info = await got
-            .get(WP_ORG_API, {
-            searchParams: {
-                action: 'plugin_information',
-                'request[slug]': slug,
-            },
-            timeout: { request: WP_ORG_TIMEOUT_MS },
-        })
-            .json();
-    }
-    catch {
-        throw new Error(`Plugin "${slug}" not found on WordPress.org.`);
-    }
-    if (info.error)
-        throw new Error(`Plugin "${slug}" not found on WordPress.org.`);
-    return info.version;
-}
 export default class Add extends LoopressCommand {
     static args = {
         slug: Args.string({ description: 'Plugin slug on WordPress.org', required: true }),
-        version: Args.string({ description: 'Version to pin (default: latest)' }),
     };
     static description = 'Add a WordPress.org plugin to loopress.json';
-    static examples = [
-        '$ lps plugin add woocommerce',
-        '$ lps plugin add woocommerce 8.9.1',
-        '$ lps plugin add contact-form-7 --dry-run',
-    ];
+    static examples = ['$ lps plugin add woocommerce', '$ lps plugin add contact-form-7 --dry-run'];
     static flags = {
         ...LoopressCommand.dryRunFlag,
     };
     async run() {
         const { args } = await this.parse(Add);
         const { slug } = args;
-        const requestedVersion = args.version ?? 'latest';
-        this.log(`Resolving ${slug}@${requestedVersion}...`);
-        let resolvedVersion;
-        try {
-            resolvedVersion = await resolvePluginVersion(slug, requestedVersion);
-        }
-        catch (error) {
-            this.error(error.message);
-        }
-        this.log(`Resolved: ${slug}@${resolvedVersion}`);
         const existing = this.localConfig.plugins ?? {};
-        if (existing[slug] === resolvedVersion) {
-            this.log(`${slug}@${resolvedVersion} is already in loopress.json, nothing to do.`);
+        if (existing[slug] === 'latest') {
+            this.log(`${slug} is already in loopress.json, nothing to do.`);
             return;
         }
         const updated = existing[slug] !== undefined;
-        const label = updated ? `${existing[slug]} → ${resolvedVersion}` : resolvedVersion;
         if (this.dryRun) {
-            this.log(`[dry-run] Would ${updated ? 'update' : 'add'} ${slug}: ${label}`);
+            this.log(`[dry-run] Would ${updated ? 'update' : 'add'} ${slug} in loopress.json`);
             return;
         }
         await writeLocalConfig({
             ...this.localConfig,
-            plugins: { ...existing, [slug]: resolvedVersion },
+            plugins: { ...existing, [slug]: 'latest' },
         });
-        this.log(`${updated ? 'Updated' : 'Added'} ${slug}: ${label}`);
+        this.log(`${updated ? 'Updated' : 'Added'} ${slug}`);
     }
 }

package/dist/commands/plugin/pull.js

@@ -1,7 +1,7 @@
 import { LoopressCommand } from '../../lib/base.js';
 import { getComposerManagedSlugs, readComposerJson } from '../../utils/composer.js';
 import { writeLocalConfig } from '../../utils/loopress-config.js';
-import { mergePluginManifest } from '../../utils/plugins.js';
+import { mergePluginManifest, parseInstalledPlugins } from '../../utils/plugins.js';
 export default class Pull extends LoopressCommand {
     static description = 'Pull installed plugins from WordPress into loopress.json';
     static examples = ['$ lps plugin pull', '$ lps plugin pull --dry-run'];
@@ -11,10 +11,11 @@ export default class Pull extends LoopressCommand {
     async run() {
         const { url } = this.siteConfig;
         this.log(`Pulling plugins from ${url}`);
-        const installed = await this.wp.get('loopress/v1/plugins');
+        const raw = await this.wp.get('wp/v2/plugins');
+        const installed = parseInstalledPlugins(raw);
         const composerJson = await readComposerJson();
         const composerSlugs = composerJson ? getComposerManagedSlugs(composerJson) : [];
-        const incoming = Object.fromEntries(installed.filter((p) => !composerSlugs.includes(p.slug)).map((p) => [p.slug, p.version]));
+        const incoming = Object.fromEntries(installed.filter((p) => !composerSlugs.includes(p.slug)).map((p) => [p.slug, 'latest']));
         if (composerSlugs.length > 0) {
             const found = installed.filter((p) => composerSlugs.includes(p.slug)).map((p) => p.slug);
             if (found.length > 0) {
@@ -38,8 +39,5 @@ export default class Pull extends LoopressCommand {
             this.log(`  + Added: ${added.join(', ')}`);
         for (const u of updated)
             this.log(`  ~ Updated: ${u.slug} ${u.from} → ${u.to}`);
-        if (Object.keys(merged).length > 0) {
-            await this.wp.post('loopress/v1/plugins/auto-updates/disable', { slugs: Object.keys(merged) });
-        }
     }
 }

package/dist/commands/plugin/push.d.ts

@@ -8,7 +8,6 @@ export default class Push extends PushCommand {
     private failedCount;
     run(): Promise<void>;
     private activatePlugin;
-    private installAndActivate;
+    private installPlugin;
     private performPluginAction;
-    private syncDrifted;
 }