@loopress/cli 0.21.0 → 0.22.0

package/dist/commands/push.js

@@ -0,0 +1,57 @@
+import { LoopressCommand } from '../lib/base.js';
+import { guardProductionPush } from '../lib/guard-production-push.js';
+import { pluralize } from '../utils/pluralize.js';
+// Dependency-ish order: code first (plugins, composer), then the ACF definitions content
+// relies on, then content itself.
+const PUSH_TARGETS = [
+    { commandId: 'plugin:push', label: 'plugins' },
+    { commandId: 'composer:push', label: 'composer' },
+    { commandId: 'acf:push', label: 'ACF' },
+    { commandId: 'api:push', label: 'API routes' },
+    { commandId: 'form:push', label: 'forms' },
+    { commandId: 'page:push', label: 'pages' },
+    { commandId: 'seo:push', label: 'SEO' },
+    { commandId: 'snippet:push', label: 'snippets' },
+];
+export default class Push extends LoopressCommand {
+    static description = 'Push all local content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, to WordPress';
+    static examples = ['$ lps push', '$ lps push --env staging', '$ lps push --dry-run'];
+    static flags = {
+        ...LoopressCommand.dryRunFlag,
+        ...LoopressCommand.yesFlag,
+    };
+    failedCount = 0;
+    async run() {
+        await this.guardProductionPush();
+        const argv = this.buildArgv();
+        for (const target of PUSH_TARGETS) {
+            this.log(`\n→ Pushing ${target.label}...`);
+            try {
+                await this.config.runCommand(target.commandId, argv);
+                this.log(`✓ ${target.label} pushed`);
+            }
+            catch (error) {
+                this.failedCount++;
+                this.log(`✗ ${target.label} failed: ${error.message}`);
+            }
+        }
+        if (this.failedCount > 0) {
+            this.error(`${pluralize(this.failedCount, 'resource')} failed to push.`);
+        }
+        this.log('\nAll resources pushed.');
+    }
+    // Every delegated push always gets --yes: either this command's own guard already confirmed
+    // production once above, or the target isn't production and there's nothing to confirm.
+    // Without this, each of the 8 delegated commands would re-run its own production guard.
+    buildArgv() {
+        const argv = ['--env', this.siteConfig.name, '--yes'];
+        if (this.dryRun)
+            argv.push('--dry-run');
+        return argv;
+    }
+    // Guards once here (shared with PushCommand, lib/push-command.ts) rather than once per
+    // delegated command.
+    async guardProductionPush() {
+        await guardProductionPush({ dryRun: this.dryRun, error: (message) => this.error(message), siteConfig: this.siteConfig, yes: this.yes });
+    }
+}

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

@@ -1,11 +1,18 @@
 import { LoopressCommand } from '../../lib/base.js';
+import { type SeoPostMeta, type SeoRedirect } from '../../utils/seo-format.js';
+type ListResult = {
+    postMeta: Record<string, SeoPostMeta[]>;
+    redirects: SeoRedirect[] | undefined;
+    redirectsUnsupported: string | undefined;
+};
 export default class List extends LoopressCommand {
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'post-type': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<void>;
+    run(): Promise<ListResult>;
     private fetchRedirects;
 }
+export {};

package/dist/commands/seo/list.js

@@ -3,9 +3,9 @@ import { LoopressCommand } from '../../lib/base.js';
 import { DEFAULT_POST_TYPES, SEO_REDIRECTS_ENDPOINT, seoPostMetaEndpoint } from '../../utils/seo-format.js';
 export default class List extends LoopressCommand {
     static description = 'List posts with SEO meta, and redirects if supported by the active SEO plugin, on WordPress';
+    static enableJsonFlag = true;
     static examples = ['$ lps seo list', '$ lps seo list --post-type post'];
     static flags = {
-        json: Flags.boolean({ char: 'j', description: 'Output in JSON format' }),
         'post-type': Flags.string({ description: 'Limit to specific post types', multiple: true }),
     };
     async run() {
@@ -16,10 +16,6 @@ export default class List extends LoopressCommand {
             byType[postType] = await this.wp.get(seoPostMetaEndpoint(postType));
         }
         const { redirects, unsupportedReason } = await this.fetchRedirects();
-        if (flags.json) {
-            this.log(JSON.stringify({ postMeta: byType, redirects: redirects ?? undefined, redirectsUnsupported: unsupportedReason }, null, 2));
-            return;
-        }
         for (const postType of postTypes) {
             const posts = byType[postType];
             this.log(`${postType} (${posts.length}):`);
@@ -35,16 +31,18 @@ export default class List extends LoopressCommand {
         }
         if (unsupportedReason) {
             this.log(`redirects: ${unsupportedReason}`);
-            return;
+            return { postMeta: byType, redirects: undefined, redirectsUnsupported: unsupportedReason };
         }
         this.log(`redirects (${redirects.length}):`);
-        if (redirects.length === 0) {
-            this.log('  (none)');
-            return;
+        if (redirects.length > 0) {
+            for (const redirect of redirects) {
+                this.log(`  ${redirect.id}. [${redirect.status}] ${redirect.headerCode} -> ${redirect.urlTo}`);
+            }
         }
-        for (const redirect of redirects) {
-            this.log(`  ${redirect.id}. [${redirect.status}] ${redirect.headerCode} -> ${redirect.urlTo}`);
+        else {
+            this.log('  (none)');
         }
+        return { postMeta: byType, redirects: redirects, redirectsUnsupported: undefined };
     }
     // Redirects are only supported by some SeoProvider backends (RankMath, not Yoast); reported
     // as a line in the listing rather than failing the whole command, since post meta above may

package/dist/commands/seo/pull.js

@@ -1,5 +1,4 @@
 import { Args, Flags } from '@oclif/core';
-import { Listr } from 'listr2';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { LoopressCommand } from '../../lib/base.js';
@@ -36,24 +35,13 @@ export default class Pull extends LoopressCommand {
             extensions: ['.json'],
             key: basenameKey,
         });
-        if (this.dryRun) {
-            this.log(`[dry-run] Would pull ${remote.length} ${postType} post-meta file(s) to ${dir}`);
-            if (orphans.length > 0) {
-                this.log(`[dry-run] Would remove ${orphans.length} local file${orphans.length === 1 ? '' : 's'} in ${dir} no longer present on WordPress: ${orphans.join(', ')}`);
-            }
-            return;
-        }
-        if (remote.length > 0)
-            await mkdir(dir, { recursive: true });
-        await new Listr(remote.map((post) => ({
-            async task(_ctx, task) {
-                await writeFile(join(dir, `${post.slug}.json`), JSON.stringify(post, null, 2) + '\n');
-                task.output = `Pulled: ${post.slug}`;
-            },
-            title: `Pull ${post.slug}`,
-        }))).run();
-        await this.removeOrphanedFiles(dir, orphans, `in ${dir} no longer present on WordPress`);
-        this.log(`Pulled ${remote.length} ${postType} post-meta file(s) to ${dir}`);
+        await this.pullDirectory(dir, remote, orphans, {
+            dryRunMessage: `Would pull ${remote.length} ${postType} post-meta file(s) to ${dir}`,
+            orphanReason: `in ${dir} no longer present on WordPress`,
+            pulledMessage: `Pulled ${remote.length} ${postType} post-meta file(s) to ${dir}`,
+            title: (post) => post.slug,
+            write: async (post, writeDir) => writeFile(join(writeDir, `${post.slug}.json`), JSON.stringify(post, null, 2) + '\n'),
+        });
     }
     // Redirects are only supported by some SeoProvider backends (RankMath, not Yoast). Unlike
     // push (which must fail loudly if the user has local redirect files that can't be synced),
@@ -73,24 +61,13 @@ export default class Pull extends LoopressCommand {
             extensions: ['.json'],
             key: numericPrefixKey,
         });
-        if (this.dryRun) {
-            this.log(`[dry-run] Would pull ${remote.length} redirect(s) to ${dir}`);
-            if (orphans.length > 0) {
-                this.log(`[dry-run] Would remove ${orphans.length} local file${orphans.length === 1 ? '' : 's'} in ${dir} no longer present on WordPress: ${orphans.join(', ')}`);
-            }
-            return;
-        }
-        if (remote.length > 0)
-            await mkdir(dir, { recursive: true });
-        await new Listr(remote.map((redirect) => ({
-            async task(_ctx, task) {
-                await writeFile(join(dir, `${redirectFileBase(redirect)}.json`), JSON.stringify(redirect, null, 2) + '\n');
-                task.output = `Pulled: redirect #${redirect.id}`;
-            },
-            title: `Pull redirect #${redirect.id}`,
-        }))).run();
-        await this.removeOrphanedFiles(dir, orphans, `in ${dir} no longer present on WordPress`);
-        this.log(`Pulled ${remote.length} redirect(s) to ${dir}`);
+        await this.pullDirectory(dir, remote, orphans, {
+            dryRunMessage: `Would pull ${remote.length} redirect(s) to ${dir}`,
+            orphanReason: `in ${dir} no longer present on WordPress`,
+            pulledMessage: `Pulled ${remote.length} redirect(s) to ${dir}`,
+            title: (redirect) => `redirect #${redirect.id}`,
+            write: async (redirect, writeDir) => writeFile(join(writeDir, `${redirectFileBase(redirect)}.json`), JSON.stringify(redirect, null, 2) + '\n'),
+        });
     }
     async pullSettings(basePath) {
         const file = join(basePath, 'settings.json');

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.js

@@ -1,4 +1,5 @@
 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';
@@ -11,7 +12,7 @@ export default class List extends LoopressCommand {
             this.log('No snippets found');
             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}`);

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.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 = {
@@ -42,28 +42,23 @@ export default class Pull extends LoopressCommand {
             key: numericPrefixKey,
         });
         const pulled = pullable.map((snippet) => ({ id: snippet.id, name: snippet.name }));
-        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 { orphans, pulled, skipped, status: 'dry-run' };
-        }
-        await mkdir(path, { recursive: true });
-        await new Listr(pullable.map((snippet) => ({
-            async task(_ctx, task) {
+        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}`,
-        })), { renderer: this.jsonEnabled() ? 'silent' : 'default' }).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.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 {
@@ -25,17 +25,14 @@ 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`);
+        this.log(`Found ${pluralize(snippets.length, 'snippet')} to push`);
         const pushed = [];
-        await new Listr(snippets.map((snippet) => ({
-            task: async (_ctx, task) => {
-                const id = await this.pushSnippet(snippet, task);
-                pushed.push({ id, name: snippet.name });
-            },
-            title: `Push ${snippet.name}`,
-        })), { concurrent: false, exitOnError: false, renderer: this.jsonEnabled() ? 'silent' : 'default' }).run();
+        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 { pushed, status: 'dry-run' };
@@ -93,28 +90,22 @@ export default class Push extends PushCommand {
         }
         try {
             const payload = this.toPayload(snippet);
+            // 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 (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);
-                    id = created.id;
-                    await this.ensureCanonicalFilename(snippet, created.id, created.name);
-                }
+            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);
-                id = created.id;
-                await this.ensureCanonicalFilename(snippet, created.id, created.name);
+                await this.ensureCanonicalFilename(snippet, snippet.id, snippet.name);
             }
             if (task)
                 task.output = `Pushed: ${snippet.name}`;

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/lib/base.d.ts

@@ -22,6 +22,14 @@ export declare abstract class LoopressCommand extends Command {
     protected get wp(): WpClient;
     init(): Promise<void>;
     protected maybeAutoRotate(): Promise<void>;
+    protected pullDirectory<T>(dir: string, items: T[], orphans: string[], options: {
+        alwaysCreateDir?: boolean;
+        dryRunMessage: string;
+        orphanReason: string;
+        pulledMessage: string;
+        title: (item: T) => string;
+        write: (item: T, dir: string) => Promise<void>;
+    }): Promise<void>;
     protected removeOrphanedFiles(dir: string, orphans: string[], reason: string): Promise<void>;
     protected resolveAcfPath(override?: string): string;
     protected resolveApiPath(override?: string): string;
@@ -31,4 +39,5 @@ export declare abstract class LoopressCommand extends Command {
     protected resolveSnippetsPath(override?: string): string;
     private pickEnvironment;
     private resolveEnvironment;
+    private resolveEnvironmentForConfiguredProject;
 }