@loopress/cli 0.21.0 → 0.23.0

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/theme/add.d.ts

@@ -0,0 +1,13 @@
+import { LoopressCommand } from '../../lib/base.js';
+export default class Add extends LoopressCommand {
+    static args: {
+        slug: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        version: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/theme/add.js

@@ -0,0 +1,35 @@
+import { Args, Flags } from '@oclif/core';
+import { LoopressCommand } from '../../lib/base.js';
+import { writeLocalConfig } from '../../utils/loopress-config.js';
+import { isExactVersion } from '../../utils/version.js';
+export default class Add extends LoopressCommand {
+    static args = {
+        slug: Args.string({ description: 'Theme slug on WordPress.org', required: true }),
+    };
+    static description = 'Add a WordPress.org theme to loopress.json';
+    static examples = ['$ lps theme add generatepress', '$ lps theme add generatepress --version 3.4.0'];
+    static flags = {
+        ...LoopressCommand.dryRunFlag,
+        version: Flags.string({ description: 'Exact version to pin (default: "latest")' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Add);
+        const { slug } = args;
+        const version = flags.version ?? 'latest';
+        if (version !== 'latest' && !isExactVersion(version)) {
+            this.error(`--version must be an exact version like 3.4.0, not a Composer constraint. Got "${version}".`);
+        }
+        const existing = this.localConfig.themes ?? {};
+        if (existing[slug] === version) {
+            this.log(`${slug} is already pinned to ${version}, nothing to do.`);
+            return;
+        }
+        const isUpdated = existing[slug] !== undefined;
+        if (this.dryRun) {
+            this.log(`[dry-run] Would ${isUpdated ? 'update' : 'add'} ${slug} (${version})`);
+            return;
+        }
+        await writeLocalConfig({ ...this.localConfig, themes: { ...existing, [slug]: version } });
+        this.log(`${isUpdated ? 'Updated' : 'Added'} ${slug} (${version}). Run \`lps theme push\` to apply.`);
+    }
+}

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

@@ -0,0 +1,21 @@
+import { LoopressCommand } from '../../lib/base.js';
+type PullResult = {
+    added: string[];
+    merged: Record<string, string>;
+    status: 'composer-managed' | 'dry-run' | 'success';
+    updated: Array<{
+        from: string;
+        slug: string;
+        to: string;
+    }>;
+};
+export default class Pull extends LoopressCommand {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<PullResult>;
+}
+export {};

package/dist/commands/theme/pull.js

@@ -0,0 +1,37 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { LoopressCommand } from '../../lib/base.js';
+import { writeLocalConfig } from '../../utils/loopress-config.js';
+import { mergePluginManifest } from '../../utils/plugins.js';
+import { parseInstalledThemes } from '../../utils/themes.js';
+export default class Pull extends LoopressCommand {
+    static description = 'Pull installed themes from WordPress into loopress.json, pinned to their live versions';
+    static enableJsonFlag = true;
+    static examples = ['$ lps theme pull'];
+    static flags = {
+        ...LoopressCommand.dryRunFlag,
+    };
+    async run() {
+        const { url } = this.siteConfig;
+        if (existsSync(join(process.cwd(), this.rootDir, 'composer.json'))) {
+            this.warn('This project has a composer.json, which is authoritative. Run `lps composer pull` instead.');
+            return { added: [], merged: this.localConfig.themes ?? {}, status: 'composer-managed', updated: [] };
+        }
+        this.log(`Pulling themes from ${url}`);
+        const raw = await this.wp.get('wp/v2/themes');
+        const installed = parseInstalledThemes(raw);
+        const incoming = Object.fromEntries(installed.map((t) => [t.slug, t.version]));
+        const { added, merged, updated } = mergePluginManifest(this.localConfig.themes ?? {}, incoming);
+        if (this.dryRun) {
+            this.log(`[dry-run] Would write ${Object.keys(merged).length} themes to loopress.json`);
+            return { added, merged, status: 'dry-run', updated };
+        }
+        await writeLocalConfig({ ...this.localConfig, themes: merged });
+        this.log(`Wrote ${Object.keys(merged).length} themes to loopress.json`);
+        if (added.length > 0)
+            this.log(`  + Added: ${added.join(', ')}`);
+        for (const u of updated)
+            this.log(`  ~ Updated: ${u.slug} ${u.from} → ${u.to}`);
+        return { added, merged, status: 'success', updated };
+    }
+}

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

@@ -0,0 +1,23 @@
+import { PushCommand } from '../../lib/push-command.js';
+type PushResult = {
+    installed: string[];
+    pinned: string[];
+    removed: string[];
+    status: 'composer-managed' | 'dry-run' | 'in-sync' | 'success';
+};
+export default class Push extends PushCommand {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<PushResult>;
+    private confirmRemovals;
+    private fetchInstanceLock;
+    private guardForce;
+    private sync;
+}
+export {};