@loopress/cli 0.20.1 → 0.22.0

package/dist/commands/seo/push.js

@@ -1,9 +1,10 @@
 import { Args } from '@oclif/core';
-import { Listr } from 'listr2';
-import { readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { readFile, rm, writeFile } from 'node:fs/promises';
 import { dirname, extname, join } from 'node:path';
 import { PushCommand } from '../../lib/push-command.js';
-import { isNotFoundError } from '../../lib/wp-client.js';
+import { putOrCreate } from '../../lib/put-or-create.js';
+import { readdirTolerant } from '../../lib/readdir-tolerant.js';
+import { pluralize } from '../../utils/pluralize.js';
 import { redirectFileBase, SEO_REDIRECTS_ENDPOINT, SEO_SETTINGS_ENDPOINT, seoPostMetaEndpoint, seoRedirectEndpoint, } from '../../utils/seo-format.js';
 export default class Push extends PushCommand {
     static args = {
@@ -25,7 +26,7 @@ export default class Push extends PushCommand {
         await this.pushPostMeta(path);
         await this.pushRedirects(path);
         if (this.failedCount > 0) {
-            this.error(`${this.failedCount} SEO item${this.failedCount === 1 ? '' : 's'} failed to push.`);
+            this.error(`${pluralize(this.failedCount, 'SEO item')} failed to push.`);
         }
         if (this.dryRun)
             return;
@@ -33,36 +34,20 @@ export default class Push extends PushCommand {
         this.log('All SEO configuration pushed.');
     }
     async jsonFilesIn(dir) {
-        try {
-            return (await readdir(dir)).filter((file) => extname(file) === '.json');
-        }
-        catch (error) {
-            if (error.code === 'ENOENT')
-                return [];
-            throw error;
-        }
+        return (await readdirTolerant(dir)).filter((file) => extname(file) === '.json');
     }
     async pushPostMeta(basePath) {
         const root = join(basePath, 'post-meta');
-        let postTypeDirs;
-        try {
-            postTypeDirs = (await readdir(root, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
-        }
-        catch (error) {
-            if (error.code === 'ENOENT')
-                return;
-            throw error;
-        }
+        const postTypeDirs = (await readdirTolerant(root, { withFileTypes: true }))
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
         for (const postType of postTypeDirs) {
             const dir = join(root, postType);
             const files = await this.jsonFilesIn(dir);
             if (files.length === 0)
                 continue;
-            this.log(`Found ${files.length} ${postType} post-meta file${files.length === 1 ? '' : 's'} to push`);
-            await new Listr(files.map((file) => ({
-                task: async (_ctx, task) => this.pushPostMetaFile(postType, join(dir, file), task),
-                title: `Push ${file}`,
-            })), { concurrent: false, exitOnError: false }).run();
+            this.log(`Found ${pluralize(files.length, postType + ' post-meta file')} to push`);
+            await this.runPushTasks(files, (file) => file, async (file, task) => this.pushPostMetaFile(postType, join(dir, file), task));
         }
     }
     async pushPostMetaFile(postType, filePath, task) {
@@ -90,24 +75,18 @@ export default class Push extends PushCommand {
         try {
             const redirect = JSON.parse(await readFile(filePath, 'utf8'));
             const payload = { headerCode: redirect.headerCode, sources: redirect.sources, status: redirect.status, urlTo: redirect.urlTo };
-            if (redirect.id) {
-                try {
-                    await this.wp.put(seoRedirectEndpoint(redirect.id), payload);
-                    if (task)
-                        task.output = `Pushed: redirect #${redirect.id}`;
-                    return;
-                }
-                catch (error) {
-                    // The id recorded locally doesn't exist on this site (e.g. a fresh install): create it
-                    // instead of failing, and adopt whatever id the site assigns (same fallback as snippet push).
-                    if (!isNotFoundError(error))
-                        throw error;
-                }
-            }
-            const created = await this.wp.post(SEO_REDIRECTS_ENDPOINT, payload);
-            await this.renameToCanonical(filePath, created);
+            // The id recorded locally may not exist on this site (e.g. a fresh install): putOrCreate
+            // falls back to POST instead of failing, adopting whatever id the site assigns.
+            const { body, created } = await putOrCreate(this.wp, {
+                id: redirect.id ?? null,
+                payload,
+                postEndpoint: SEO_REDIRECTS_ENDPOINT,
+                putEndpoint: (id) => seoRedirectEndpoint(id),
+            });
+            if (created)
+                await this.renameToCanonical(filePath, body);
             if (task)
-                task.output = `Pushed: redirect #${created.id}`;
+                task.output = `Pushed: redirect #${created ? body.id : redirect.id}`;
         }
         catch (error) {
             this.reportTaskFailure(`Failed to push ${filePath}: ${error.message}`, error, task);
@@ -118,11 +97,8 @@ export default class Push extends PushCommand {
         const files = await this.jsonFilesIn(dir);
         if (files.length === 0)
             return;
-        this.log(`Found ${files.length} redirect${files.length === 1 ? '' : 's'} to push`);
-        await new Listr(files.map((file) => ({
-            task: async (_ctx, task) => this.pushRedirectFile(join(dir, file), task),
-            title: `Push ${file}`,
-        })), { concurrent: false, exitOnError: false }).run();
+        this.log(`Found ${pluralize(files.length, 'redirect')} to push`);
+        await this.runPushTasks(files, (file) => file, async (file, task) => this.pushRedirectFile(join(dir, file), task));
     }
     async pushSettings(basePath) {
         const file = join(basePath, 'settings.json');

package/dist/commands/snippet/list.d.ts

@@ -1,9 +1,8 @@
 import { LoopressCommand } from '../../lib/base.js';
+import { type NormalizedSnippet } from '../../utils/snippet-format.js';
 export default class List extends LoopressCommand {
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
-    static flags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
+    run(): Promise<NormalizedSnippet[]>;
 }

package/dist/commands/snippet/list.js

@@ -1,25 +1,18 @@
-import { Flags } from '@oclif/core';
 import { LoopressCommand } from '../../lib/base.js';
+import { pluralize } from '../../utils/pluralize.js';
 import { normalizeSnippet, SNIPPETS_ENDPOINT } from '../../utils/snippet-format.js';
 export default class List extends LoopressCommand {
     static description = 'List snippets from WordPress';
+    static enableJsonFlag = true;
     static examples = ['$ lps snippet list'];
-    static flags = {
-        json: Flags.boolean({ char: 'j', description: 'Output in JSON format' }),
-    };
     async run() {
-        const { flags } = await this.parse(List);
         const remoteList = await this.wp.get(SNIPPETS_ENDPOINT);
         const snippets = remoteList.map((r) => normalizeSnippet(r));
-        if (flags.json) {
-            this.log(JSON.stringify(snippets, null, 2));
-            return;
-        }
         if (snippets.length === 0) {
             this.log('No snippets found');
-            return;
+            return snippets;
         }
-        this.log(`Found ${snippets.length} snippet${snippets.length === 1 ? '' : 's'}:`);
+        this.log(`Found ${pluralize(snippets.length, 'snippet')}:`);
         this.log('');
         for (const snippet of snippets) {
             this.log(`  ${snippet.id}. ${snippet.name}`);
@@ -32,5 +25,6 @@ export default class List extends LoopressCommand {
             }
             this.log('');
         }
+        return snippets;
     }
 }

package/dist/commands/snippet/publish.js

@@ -1,10 +1,9 @@
 import { Args, Command } from '@oclif/core';
 import { join } from 'node:path';
-import { authManager } from '../../config/auth.manager.js';
-import { configManager } from '../../config/project-config.manager.js';
 import { ApiClient } from '../../lib/api-client.js';
 import { loadSnippets } from '../../lib/load-snippets.js';
-import { readLocalConfig } from '../../utils/loopress-config.js';
+import { resolveLinkedProject } from '../../lib/resolve-linked-project.js';
+import { pluralize } from '../../utils/pluralize.js';
 import { toSlug } from '../../utils/to-slug.js';
 // Publishes to the Loopress api (not a WordPress site), so this does not extend
 // `LoopressCommand`/`PushCommand`: those force an environment to be resolved, but a project
@@ -18,22 +17,7 @@ export default class Publish extends Command {
     static examples = ['$ lps snippet publish', '$ lps snippet publish --path ./snippets'];
     async run() {
         const { args } = await this.parse(Publish);
-        const token = process.env.LOOPRESS_TOKEN ?? authManager.getAuth()?.token;
-        if (!token) {
-            this.error('Not logged in. Run `lps login` first.');
-        }
-        const localConfig = await readLocalConfig();
-        const projectId = localConfig.projectId ?? configManager.getCurrentProject()?.id;
-        if (!projectId) {
-            this.error('No project configured. Run `lps project config` first.');
-        }
-        const project = configManager.getProject(projectId);
-        if (!project) {
-            this.error(`Project "${projectId}" (from loopress.json) not found. Run \`lps project config\` to configure it.`);
-        }
-        if (!project.apiProjectId) {
-            this.error(`Project "${project.name}" is not linked to your Loopress account yet. Run \`lps project push\` first.`);
-        }
+        const { apiProjectId, localConfig, token } = await resolveLinkedProject((message) => this.error(message));
         const path = args.path ?? join(localConfig.rootDir ?? '.', localConfig.snippetsDir ?? 'snippets');
         this.log(`Publishing snippets from ${path}`);
         let snippets;
@@ -45,14 +29,14 @@ export default class Publish extends Command {
         }
         const api = new ApiClient(token);
         try {
-            await api.post(`projects/${project.apiProjectId}/snippets/publish`, {
+            await api.post(`projects/${apiProjectId}/snippets/publish`, {
                 snippets: snippets.map((snippet) => this.toPayload(snippet)),
             });
         }
         catch (error) {
             this.error(error.message);
         }
-        this.log(`Published ${snippets.length} snippet${snippets.length === 1 ? '' : 's'} to your Loopress account.`);
+        this.log(`Published ${pluralize(snippets.length, 'snippet')} to your Loopress account.`);
     }
     toPayload(snippet) {
         return {

package/dist/commands/snippet/pull.d.ts

@@ -1,13 +1,25 @@
 import { LoopressCommand } from '../../lib/base.js';
+type PulledSnippet = {
+    id: number;
+    name: string;
+};
+type PullResult = {
+    orphans: string[];
+    pulled: PulledSnippet[];
+    skipped: number;
+    status: 'dry-run' | 'success';
+};
 export default class Pull extends LoopressCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<PullResult>;
 }
+export {};

package/dist/commands/snippet/pull.js

@@ -1,9 +1,9 @@
 import { Args } from '@oclif/core';
-import { Listr } from 'listr2';
-import { mkdir, writeFile } from 'node:fs/promises';
+import { writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { LoopressCommand } from '../../lib/base.js';
 import { findOrphanedFiles, numericPrefixKey } from '../../lib/find-orphaned-files.js';
+import { pluralize } from '../../utils/pluralize.js';
 import { buildMetaFile, buildSnippetFile, normalizeSnippet, SNIPPETS_ENDPOINT } from '../../utils/snippet-format.js';
 import { toSlug } from '../../utils/to-slug.js';
 const EXTENSIONS = {
@@ -18,6 +18,7 @@ export default class Pull extends LoopressCommand {
         path: Args.string({ description: 'Path to snippets directory (overrides project config)' }),
     };
     static description = 'Pull snippets from WordPress';
+    static enableJsonFlag = true;
     static examples = ['$ lps snippet pull', '$ lps snippet pull --path ./snippets'];
     static flags = {
         ...LoopressCommand.dryRunFlag,
@@ -40,28 +41,25 @@ export default class Pull extends LoopressCommand {
             extensions: ['.json', ...Object.values(EXTENSIONS).map((ext) => `.${ext}`)],
             key: numericPrefixKey,
         });
-        if (this.dryRun) {
-            this.log(`[dry-run] Would pull ${snippets.length} snippet${snippets.length === 1 ? '' : 's'} to ${path}`);
-            if (orphans.length > 0) {
-                this.log(`[dry-run] Would remove ${orphans.length} local file${orphans.length === 1 ? '' : 's'} whose snippet no longer exists on WordPress: ${orphans.join(', ')}`);
-            }
-            return;
-        }
-        await mkdir(path, { recursive: true });
-        await new Listr(pullable.map((snippet) => ({
-            async task(_ctx, task) {
+        const pulled = pullable.map((snippet) => ({ id: snippet.id, name: snippet.name }));
+        await this.pullDirectory(path, pullable, orphans, {
+            alwaysCreateDir: true,
+            dryRunMessage: `Would pull ${pluralize(snippets.length, 'snippet')} to ${path}`,
+            orphanReason: 'whose snippet no longer exists on WordPress',
+            pulledMessage: `Pulled ${pluralize(pullable.length, 'snippet')} to ${path}`,
+            title: (snippet) => snippet.name,
+            async write(snippet, writeDir) {
                 const ext = EXTENSIONS[snippet.type];
                 const base = `${snippet.id}-${toSlug(snippet.name)}`;
-                await writeFile(join(path, `${base}.${ext}`), buildSnippetFile(snippet));
-                await writeFile(join(path, `${base}.json`), buildMetaFile(snippet));
-                task.output = `Pulled: ${snippet.name}`;
+                await writeFile(join(writeDir, `${base}.${ext}`), buildSnippetFile(snippet));
+                await writeFile(join(writeDir, `${base}.json`), buildMetaFile(snippet));
             },
-            title: `Pull ${snippet.name}`,
-        }))).run();
-        await this.removeOrphanedFiles(path, orphans, 'whose snippet no longer exists on WordPress');
-        this.log(`Pulled ${pullable.length} snippet${pullable.length === 1 ? '' : 's'} to ${path}`);
+        });
+        if (this.dryRun)
+            return { orphans, pulled, skipped, status: 'dry-run' };
         if (skipped > 0) {
-            this.warn(`${skipped} snippet${skipped === 1 ? '' : 's'} skipped because they have no name`);
+            this.warn(`${pluralize(skipped, 'snippet')} skipped because they have no name`);
         }
+        return { orphans, pulled, skipped, status: 'success' };
     }
 }

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

@@ -1,17 +1,27 @@
 import { PushCommand } from '../../lib/push-command.js';
+type PushedSnippet = {
+    id?: number;
+    name: string;
+};
+type PushResult = {
+    pushed: PushedSnippet[];
+    status: 'dry-run' | 'success';
+};
 export default class Push extends PushCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<PushResult>;
     private ensureCanonicalFilename;
     private loadSnippets;
     private pushSnippet;
     private toPayload;
 }
+export {};

package/dist/commands/snippet/push.js

@@ -1,10 +1,10 @@
 import { Args } from '@oclif/core';
-import { Listr } from 'listr2';
 import { readFile, rename, rm, writeFile } from 'node:fs/promises';
 import { basename, dirname, extname, join } from 'node:path';
 import { loadSnippets as loadSnippetsFromDisk } from '../../lib/load-snippets.js';
 import { PushCommand } from '../../lib/push-command.js';
-import { isNotFoundError } from '../../lib/wp-client.js';
+import { putOrCreate } from '../../lib/put-or-create.js';
+import { pluralize } from '../../utils/pluralize.js';
 import { normalizeSnippet, SNIPPETS_ENDPOINT, stripPhpOpeningTag } from '../../utils/snippet-format.js';
 import { toSlug } from '../../utils/to-slug.js';
 export default class Push extends PushCommand {
@@ -12,6 +12,7 @@ export default class Push extends PushCommand {
         path: Args.string({ description: 'Path to snippets directory (overrides project config)' }),
     };
     static description = 'Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.';
+    static enableJsonFlag = true;
     static examples = ['$ lps snippet push', '$ lps snippet push --path ./snippets'];
     static flags = {
         ...PushCommand.dryRunFlag,
@@ -24,18 +25,20 @@ export default class Push extends PushCommand {
         this.log(`Pushing snippets to ${url}`);
         this.log(`Snippets path: ${path}`);
         const snippets = await this.loadSnippets(path);
-        this.log(`Found ${snippets.length} snippet${snippets.length === 1 ? '' : 's'} to push`);
-        await new Listr(snippets.map((snippet) => ({
-            task: async (_ctx, task) => this.pushSnippet(snippet, task),
-            title: `Push ${snippet.name}`,
-        })), { concurrent: false, exitOnError: false }).run();
+        this.log(`Found ${pluralize(snippets.length, 'snippet')} to push`);
+        const pushed = [];
+        await this.runPushTasks(snippets, (snippet) => snippet.name, async (snippet, task) => {
+            const id = await this.pushSnippet(snippet, task);
+            pushed.push({ id, name: snippet.name });
+        });
         if (this.failedCount > 0) {
-            this.error(`${this.failedCount} snippet${this.failedCount === 1 ? '' : 's'} failed to push.`);
+            this.error(`${pluralize(this.failedCount, 'snippet')} failed to push.`);
         }
         if (this.dryRun)
-            return;
+            return { pushed, status: 'dry-run' };
         await this.recordSuccess();
         this.log('All snippets pushed.');
+        return { pushed, status: 'success' };
     }
     // Renames the local file pair to the `<id>-<slug>` convention used by `snippet pull` whenever
     // it doesn't already match (e.g. a hand-created `demo.php` with no id, or a stale slug after a rename).
@@ -73,7 +76,7 @@ export default class Push extends PushCommand {
     }
     async loadSnippets(path) {
         try {
-            return await loadSnippetsFromDisk(path, (message) => this.warn(message));
+            return await loadSnippetsFromDisk(path, (message) => { this.warn(message); });
         }
         catch (error) {
             this.error(error.message);
@@ -83,32 +86,30 @@ export default class Push extends PushCommand {
         if (this.dryRun) {
             if (task)
                 task.output = `[dry-run] Would push: ${snippet.name}`;
-            return;
+            return snippet.id;
         }
         try {
             const payload = this.toPayload(snippet);
-            if (snippet.id) {
-                try {
-                    await this.wp.put(`${SNIPPETS_ENDPOINT}/${snippet.id}`, payload);
-                    await this.ensureCanonicalFilename(snippet, snippet.id, snippet.name);
-                }
-                catch (error) {
-                    // The id recorded locally doesn't exist on this site (e.g. a fresh install): create it
-                    // instead of failing, and adopt whatever id the site assigns.
-                    if (!isNotFoundError(error))
-                        throw error;
-                    const response = await this.wp.post(SNIPPETS_ENDPOINT, payload);
-                    const created = normalizeSnippet(response);
-                    await this.ensureCanonicalFilename(snippet, created.id, created.name);
-                }
+            // The id recorded locally may not exist on this site (e.g. a fresh install): putOrCreate
+            // falls back to POST instead of failing, adopting whatever id the site assigns.
+            const { body, created } = await putOrCreate(this.wp, {
+                id: snippet.id ?? null,
+                payload,
+                postEndpoint: SNIPPETS_ENDPOINT,
+                putEndpoint: (id) => `${SNIPPETS_ENDPOINT}/${id}`,
+            });
+            let { id } = snippet;
+            if (created) {
+                const createdSnippet = normalizeSnippet(body);
+                id = createdSnippet.id;
+                await this.ensureCanonicalFilename(snippet, createdSnippet.id, createdSnippet.name);
             }
             else {
-                const response = await this.wp.post(SNIPPETS_ENDPOINT, payload);
-                const created = normalizeSnippet(response);
-                await this.ensureCanonicalFilename(snippet, created.id, created.name);
+                await this.ensureCanonicalFilename(snippet, snippet.id, snippet.name);
             }
             if (task)
                 task.output = `Pushed: ${snippet.name}`;
+            return id;
         }
         catch (error) {
             this.reportTaskFailure(`Failed to push ${snippet.name}: ${error.message}`, error, task);

package/dist/commands/status.d.ts

@@ -1,12 +1,24 @@
 import { Command } from '@oclif/core';
+type StatusInfo = {
+    environments?: string[];
+    note?: string;
+    project?: string;
+    url?: string;
+};
+type StatusResult = StatusInfo & {
+    configDir: string;
+    dataDir: string;
+};
 export default class Status extends Command {
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
         env: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<void>;
+    run(): Promise<StatusResult>;
     private reportActiveProject;
     private reportEnvOverride;
     private reportPinnedProject;
 }
+export {};

package/dist/commands/status.js

@@ -4,6 +4,7 @@ import { readLocalConfig } from '../utils/loopress-config.js';
 const c = ux.colorize;
 export default class Status extends Command {
     static description = 'Show which WordPress project and environment commands will target';
+    static enableJsonFlag = true;
     static examples = ['$ lps status', '$ lps status --env staging'];
     static flags = {
         env: Flags.string({ description: 'Show what would be targeted with this environment, as other commands do with --env' }),
@@ -11,40 +12,41 @@ export default class Status extends Command {
     async run() {
         const { flags } = await this.parse(Status);
         const localConfig = await readLocalConfig();
+        let info;
         if (flags.env) {
-            this.reportEnvOverride(localConfig.projectId, flags.env);
+            info = this.reportEnvOverride(localConfig.projectId, flags.env);
         }
         else if (localConfig.projectId) {
-            this.reportPinnedProject(localConfig.projectId);
+            info = this.reportPinnedProject(localConfig.projectId);
         }
         else {
-            this.reportActiveProject();
+            info = this.reportActiveProject();
         }
         this.log('');
         this.log(`Config dir: ${this.config.configDir}`);
         this.log(`Data dir:   ${this.config.dataDir}`);
+        return { ...info, configDir: this.config.configDir, dataDir: this.config.dataDir };
     }
     reportActiveProject() {
         const env = configManager.getCurrentEnv();
-        if (!env) {
-            this.log('No project configured. Run `lps project config` first.');
-            return;
-        }
-        const project = configManager.getCurrentProject();
-        if (!project) {
-            this.log('No project configured. Run `lps project config` first.');
-            return;
+        const project = env ? configManager.getCurrentProject() : undefined;
+        if (!env || !project) {
+            const note = 'No project configured. Run `lps project config` first.';
+            this.log(note);
+            return { note };
         }
         this.log(`Project:  ${project.name} (${env.name})`);
         this.log(`URL:      ${env.url}`);
+        return { project: `${project.name} (${env.name})`, url: env.url };
     }
     // Mirrors base.ts:resolveEnvironment with --env: the targeted project comes from
     // loopress.json when pinned, from the globally active project otherwise.
     reportEnvOverride(pinnedProjectId, envName) {
         const project = pinnedProjectId ? configManager.getProject(pinnedProjectId) : configManager.getCurrentProject();
         if (!project) {
-            this.log('No project configured. Run `lps project config` first.');
-            return;
+            const note = 'No project configured. Run `lps project config` first.';
+            this.log(note);
+            return { note };
         }
         const env = project.environments[envName];
         if (!env) {
@@ -52,29 +54,33 @@ export default class Status extends Command {
         }
         this.log(`Project:  ${project.name} (${env.name}, via --env)`);
         this.log(`URL:      ${env.url}`);
+        return { project: `${project.name} (${env.name}, via --env)`, url: env.url };
     }
     reportPinnedProject(projectId) {
         const project = configManager.getProject(projectId);
         if (!project) {
+            const note = `loopress.json pins project "${projectId}", but it no longer exists. Run \`lps project config\` to configure it.`;
             this.log(`loopress.json pins project "${projectId}", but it no longer exists.`);
             this.log('Run `lps project config` to configure it.');
-            return;
+            return { note };
         }
         const envNames = Object.keys(project.environments);
         if (envNames.length === 0) {
+            const note = 'No environments configured for this project. Run `lps project config` to add one.';
             this.log(`Project:  ${project.name}`);
-            this.log('No environments configured for this project. Run `lps project config` to add one.');
-            return;
+            this.log(note);
+            return { note, project: project.name };
         }
         if (envNames.length === 1) {
             const env = project.environments[envNames[0]];
             this.log(`Project:  ${project.name} (${env.name})`);
             this.log(`URL:      ${env.url}`);
-            return;
+            return { project: `${project.name} (${env.name})`, url: env.url };
         }
         const current = configManager.getCurrentProject();
         const currentEnv = current?.id === projectId ? configManager.getCurrentEnv() : null;
         if (!currentEnv) {
+            const note = `"${project.name}" has multiple environments and isn't the globally active project. Run \`lps project switch\` to pick one.`;
             this.log(`Project:  ${project.name} ${c('yellow', '(ambiguous)')}`);
             this.log(`Environments: ${envNames.join(', ')}`);
             this.log('');
@@ -83,9 +89,10 @@ export default class Status extends Command {
             if (current) {
                 this.log(`(Globally active project right now: "${current.name}")`);
             }
-            return;
+            return { environments: envNames, note, project: project.name };
         }
         this.log(`Project:  ${project.name} (${currentEnv.name})`);
         this.log(`URL:      ${currentEnv.url}`);
+        return { project: `${project.name} (${currentEnv.name})`, url: currentEnv.url };
     }
 }

package/dist/commands/validate.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+import { type ValidateResult } from '../lib/validate-local.js';
+export default class Validate extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<ValidateResult>;
+}

package/dist/commands/validate.js

@@ -0,0 +1,24 @@
+import { Command } from '@oclif/core';
+import { validateLocal } from '../lib/validate-local.js';
+export default class Validate extends Command {
+    static description = 'Check local tracked files are well formed and push-ready, without contacting WordPress';
+    static enableJsonFlag = true;
+    static examples = ['$ lps validate'];
+    async run() {
+        await this.parse(Validate);
+        const result = await validateLocal(process.cwd());
+        if (!this.jsonEnabled()) {
+            for (const problem of result.problems) {
+                this.log(`  ✗ ${problem.file}: ${problem.message}`);
+            }
+            this.log('');
+            this.log(result.valid
+                ? `${result.checked} file(s) checked, no problems found.`
+                : `${result.checked} file(s) checked, ${result.problems.length} problem(s) found.`);
+        }
+        // Non-zero exit for CI without throwing, so `--json` still prints the full report.
+        if (!result.valid)
+            process.exitCode = 1;
+        return result;
+    }
+}

package/dist/config/auth.manager.d.ts

@@ -1,8 +1,8 @@
-export interface ConsoleAuth {
+export type ConsoleAuth = {
     email?: string;
     savedAt: string;
     token: string;
-}
+};
 export declare class AuthManager {
     private dataDir?;
     constructor(dataDir?: string | undefined);

package/dist/config/project-config.manager.d.ts

@@ -1,4 +1,4 @@
-import { EnvironmentConfig, LoopressConfig, ProjectConfig } from '../types/config.js';
+import { type EnvironmentConfig, type LoopressConfig, type ProjectConfig } from '../types/config.js';
 export declare class ProjectConfigManager {
     private configDir?;
     constructor(configDir?: string | undefined);