@loopress/cli 0.16.0 → 0.17.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.16.0 linux-x64 node-v24.18.0
+@loopress/cli/0.17.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -66,6 +66,9 @@ report.
 * [`lps project push`](#lps-project-push)
 * [`lps project remove`](#lps-project-remove)
 * [`lps project switch`](#lps-project-switch)
+* [`lps seo list`](#lps-seo-list)
+* [`lps seo pull [PATH]`](#lps-seo-pull-path)
+* [`lps seo push [PATH]`](#lps-seo-push-path)
 * [`lps snippet list`](#lps-snippet-list)
 * [`lps snippet publish [PATH]`](#lps-snippet-publish-path)
 * [`lps snippet pull [PATH]`](#lps-snippet-pull-path)
@@ -96,7 +99,7 @@ EXAMPLES
   $ lps acf list --type field-groups
 ```
 
-_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/acf/list.ts)_
+_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/acf/list.ts)_
 
 ## `lps acf pull [PATH]`
 
@@ -123,7 +126,7 @@ EXAMPLES
   $ lps acf pull --type field-groups
 ```
 
-_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/acf/pull.ts)_
+_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/acf/pull.ts)_
 
 ## `lps acf push [PATH]`
 
@@ -150,7 +153,7 @@ EXAMPLES
   $ lps acf push --type field-groups
 ```
 
-_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/acf/push.ts)_
+_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/acf/push.ts)_
 
 ## `lps composer init`
 
@@ -172,7 +175,7 @@ EXAMPLES
   $ lps composer init --dry-run
 ```
 
-_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/composer/init.ts)_
+_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/composer/init.ts)_
 
 ## `lps composer pull`
 
@@ -194,7 +197,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
@@ -216,7 +219,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/composer/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -253,7 +256,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -270,7 +273,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -287,7 +290,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/logout.ts)_
 
 ## `lps plugin add SLUG`
 
@@ -312,7 +315,7 @@ EXAMPLES
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/plugin/add.ts)_
 
 ## `lps plugin pull`
 
@@ -334,7 +337,7 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
@@ -356,7 +359,7 @@ EXAMPLES
   $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
@@ -374,7 +377,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -391,7 +394,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/list.ts)_
 
 ## `lps project pull`
 
@@ -408,7 +411,7 @@ EXAMPLES
   $ lps project pull
 ```
 
-_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/project/pull.ts)_
+_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/pull.ts)_
 
 ## `lps project push`
 
@@ -425,7 +428,7 @@ EXAMPLES
   $ lps project push
 ```
 
-_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/project/push.ts)_
+_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/push.ts)_
 
 ## `lps project remove`
 
@@ -442,7 +445,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/remove.ts)_
 
 ## `lps project switch`
 
@@ -459,7 +462,80 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/switch.ts)_
+
+## `lps seo list`
+
+List posts with SEO meta, and redirects if supported by the active SEO plugin, on WordPress
+
+```
+USAGE
+  $ lps seo list [-j] [--post-type <value>...]
+
+FLAGS
+  -j, --json                  Output in JSON format
+      --post-type=<value>...  Limit to specific post types
+
+DESCRIPTION
+  List posts with SEO meta, and redirects if supported by the active SEO plugin, on WordPress
+
+EXAMPLES
+  $ lps seo list
+
+  $ lps seo list --post-type post
+```
+
+_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/seo/list.ts)_
+
+## `lps seo pull [PATH]`
+
+Pull SEO settings, post meta, and (if supported) redirects from WordPress
+
+```
+USAGE
+  $ lps seo pull [PATH] [-d] [--post-type <value>...]
+
+ARGUMENTS
+  [PATH]  Path to SEO directory (overrides project config)
+
+FLAGS
+  -d, --dry-run               Show what would change without making changes
+      --post-type=<value>...  Limit post meta to specific post types
+
+DESCRIPTION
+  Pull SEO settings, post meta, and (if supported) redirects from WordPress
+
+EXAMPLES
+  $ lps seo pull
+
+  $ lps seo pull --post-type post --post-type page
+```
+
+_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/seo/pull.ts)_
+
+## `lps seo push [PATH]`
+
+Push SEO settings, post meta, and redirects to WordPress. Local redirect files created remotely are renamed on disk to the `<id>-<slug>` convention. Fails clearly per file if the active SEO plugin does not support redirects.
+
+```
+USAGE
+  $ lps seo push [PATH] [-d]
+
+ARGUMENTS
+  [PATH]  Path to SEO directory (overrides project config)
+
+FLAGS
+  -d, --dry-run  Show what would change without making changes
+
+DESCRIPTION
+  Push SEO settings, post meta, and redirects to WordPress. Local redirect files created remotely are renamed on disk to
+  the `<id>-<slug>` convention. Fails clearly per file if the active SEO plugin does not support redirects.
+
+EXAMPLES
+  $ lps seo push
+```
+
+_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/seo/push.ts)_
 
 ## `lps snippet list`
 
@@ -479,7 +555,7 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet publish [PATH]`
 
@@ -502,7 +578,7 @@ EXAMPLES
   $ lps snippet publish --path ./snippets
 ```
 
-_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/snippet/publish.ts)_
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -527,7 +603,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -553,7 +629,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -570,7 +646,7 @@ EXAMPLES
   $ lps status
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/status.ts)_
 
 ## `lps telemetry disable`
 
@@ -587,7 +663,7 @@ EXAMPLES
   $ lps telemetry disable
 ```
 
-_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/telemetry/disable.ts)_
+_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/telemetry/disable.ts)_
 
 ## `lps telemetry enable`
 
@@ -604,5 +680,5 @@ EXAMPLES
   $ lps telemetry enable
 ```
 
-_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.16.0/src/commands/telemetry/enable.ts)_
+_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/telemetry/enable.ts)_
 <!-- commandsstop -->

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

@@ -0,0 +1,11 @@
+import { LoopressCommand } from '../../lib/base.js';
+export default class List extends LoopressCommand {
+    static description: string;
+    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>;
+    private fetchRedirects;
+}

package/dist/commands/seo/list.js

@@ -0,0 +1,60 @@
+import { Flags } from '@oclif/core';
+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 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() {
+        const { flags } = await this.parse(List);
+        const postTypes = flags['post-type'] && flags['post-type'].length > 0 ? flags['post-type'] : [...DEFAULT_POST_TYPES];
+        const byType = {};
+        for (const postType of postTypes) {
+            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}):`);
+            if (posts.length === 0) {
+                this.log('  (none)');
+                this.log('');
+                continue;
+            }
+            for (const post of posts) {
+                this.log(`  ${post.slug}. ${post.title}`);
+            }
+            this.log('');
+        }
+        if (unsupportedReason) {
+            this.log(`redirects: ${unsupportedReason}`);
+            return;
+        }
+        this.log(`redirects (${redirects.length}):`);
+        if (redirects.length === 0) {
+            this.log('  (none)');
+            return;
+        }
+        for (const redirect of redirects) {
+            this.log(`  ${redirect.id}. [${redirect.status}] ${redirect.headerCode} -> ${redirect.urlTo}`);
+        }
+    }
+    // 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
+    // well have succeeded.
+    async fetchRedirects() {
+        try {
+            return { redirects: await this.wp.get(SEO_REDIRECTS_ENDPOINT), unsupportedReason: undefined };
+        }
+        catch (error) {
+            return { redirects: null, unsupportedReason: error.message };
+        }
+    }
+}

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

@@ -0,0 +1,19 @@
+import { LoopressCommand } from '../../lib/base.js';
+import { SeoRedirect } from '../../utils/seo-format.js';
+export default class Pull extends LoopressCommand {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'post-type': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private findOrphanedFiles;
+    private pullPostMeta;
+    private pullRedirects;
+    private pullSettings;
+}
+export declare function redirectFileBase(redirect: SeoRedirect): string;

package/dist/commands/seo/pull.js

@@ -0,0 +1,134 @@
+import { Args, Flags } from '@oclif/core';
+import { Listr } from 'listr2';
+import { mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+import slugify from 'slugify';
+import { LoopressCommand } from '../../lib/base.js';
+import { DEFAULT_POST_TYPES, SEO_REDIRECTS_ENDPOINT, SEO_SETTINGS_ENDPOINT, seoPostMetaEndpoint, } from '../../utils/seo-format.js';
+export default class Pull extends LoopressCommand {
+    static args = {
+        path: Args.string({ description: 'Path to SEO directory (overrides project config)' }),
+    };
+    static description = 'Pull SEO settings, post meta, and (if supported) redirects from WordPress';
+    static examples = ['$ lps seo pull', '$ lps seo pull --post-type post --post-type page'];
+    static flags = {
+        ...LoopressCommand.dryRunFlag,
+        'post-type': Flags.string({ description: 'Limit post meta to specific post types', multiple: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Pull);
+        const { url } = this.siteConfig;
+        const path = this.resolveSeoPath(args.path);
+        const postTypes = flags['post-type'] && flags['post-type'].length > 0 ? flags['post-type'] : [...DEFAULT_POST_TYPES];
+        this.log(`Pulling SEO configuration from ${url}`);
+        this.log(`SEO path: ${path}`);
+        await this.pullSettings(path);
+        for (const postType of postTypes) {
+            await this.pullPostMeta(postType, path);
+        }
+        await this.pullRedirects(path);
+    }
+    // Shared by post-meta (`<slug>.json`) and redirects (`<id>-<slug>.json`) directories: a local
+    // file whose identity is no longer in the current remote list belongs to something deleted on
+    // WordPress. Left on disk, it would silently come back to life on the next `seo push`.
+    async findOrphanedFiles(dir, keepKeys, numericIdPrefix) {
+        let files;
+        try {
+            files = await readdir(dir);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        return files.filter((file) => {
+            if (extname(file) !== '.json')
+                return false;
+            if (numericIdPrefix) {
+                const match = /^(\d+)-/.exec(file);
+                return match !== null && !keepKeys.has(match[1]);
+            }
+            return !keepKeys.has(file.slice(0, -'.json'.length));
+        });
+    }
+    async pullPostMeta(postType, basePath) {
+        const dir = join(basePath, 'post-meta', postType);
+        const remote = await this.wp.get(seoPostMetaEndpoint(postType));
+        const orphans = await this.findOrphanedFiles(dir, new Set(remote.map((post) => post.slug)), false);
+        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();
+        for (const file of orphans)
+            await rm(join(dir, file), { force: true });
+        if (orphans.length > 0) {
+            this.warn(`Removed ${orphans.length} local file${orphans.length === 1 ? '' : 's'} in ${dir} no longer present on WordPress: ${orphans.join(', ')}`);
+        }
+        this.log(`Pulled ${remote.length} ${postType} post-meta file(s) to ${dir}`);
+    }
+    // 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),
+    // pull degrades gracefully here: the active plugin never supporting redirects isn't an error
+    // in the same sense a deleted-on-WordPress file is, there's simply nothing to pull.
+    async pullRedirects(basePath) {
+        const dir = join(basePath, 'redirects');
+        let remote;
+        try {
+            remote = await this.wp.get(SEO_REDIRECTS_ENDPOINT);
+        }
+        catch (error) {
+            this.warn(`Skipping redirects: ${error.message}`);
+            return;
+        }
+        const orphans = await this.findOrphanedFiles(dir, new Set(remote.map((redirect) => String(redirect.id))), true);
+        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();
+        for (const file of orphans)
+            await rm(join(dir, file), { force: true });
+        if (orphans.length > 0) {
+            this.warn(`Removed ${orphans.length} local file${orphans.length === 1 ? '' : 's'} in ${dir} no longer present on WordPress: ${orphans.join(', ')}`);
+        }
+        this.log(`Pulled ${remote.length} redirect(s) to ${dir}`);
+    }
+    async pullSettings(basePath) {
+        const file = join(basePath, 'settings.json');
+        const settings = await this.wp.get(SEO_SETTINGS_ENDPOINT);
+        if (this.dryRun) {
+            this.log(`[dry-run] Would pull settings to ${file}`);
+            return;
+        }
+        await mkdir(basePath, { recursive: true });
+        await writeFile(file, JSON.stringify(settings, null, 2) + '\n');
+        this.log(`Pulled settings to ${file}`);
+    }
+}
+export function redirectFileBase(redirect) {
+    const slug = slugify(redirect.urlTo || 'redirect', { lower: true, strict: true });
+    return `${redirect.id}-${slug || 'redirect'}`;
+}

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

@@ -0,0 +1,20 @@
+import { PushCommand } from '../../lib/push-command.js';
+export default class Push extends PushCommand {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    private failedCount;
+    run(): Promise<void>;
+    private jsonFilesIn;
+    private pushPostMeta;
+    private pushPostMetaFile;
+    private pushRedirectFile;
+    private pushRedirects;
+    private pushSettings;
+    private renameToCanonical;
+}

package/dist/commands/seo/push.js

@@ -0,0 +1,171 @@
+import { Args } from '@oclif/core';
+import { Listr } from 'listr2';
+import { readdir, 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 { SEO_REDIRECTS_ENDPOINT, SEO_SETTINGS_ENDPOINT, seoPostMetaEndpoint, seoRedirectEndpoint, } from '../../utils/seo-format.js';
+import { redirectFileBase } from './pull.js';
+export default class Push extends PushCommand {
+    static args = {
+        path: Args.string({ description: 'Path to SEO directory (overrides project config)' }),
+    };
+    static description = 'Push SEO settings, post meta, and redirects to WordPress. Local redirect files created remotely are renamed on disk to the `<id>-<slug>` convention. Fails clearly per file if the active SEO plugin does not support redirects.';
+    static examples = ['$ lps seo push'];
+    static flags = {
+        ...PushCommand.dryRunFlag,
+    };
+    failedCount = 0;
+    async run() {
+        const { args } = await this.parse(Push);
+        const { url } = this.siteConfig;
+        const path = this.resolveSeoPath(args.path);
+        this.log(`Pushing SEO configuration to ${url}`);
+        this.log(`SEO path: ${path}`);
+        await this.pushSettings(path);
+        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.`);
+        }
+        if (this.dryRun)
+            return;
+        await this.recordSuccess();
+        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;
+        }
+    }
+    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;
+        }
+        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();
+        }
+    }
+    async pushPostMetaFile(postType, filePath, task) {
+        if (this.dryRun) {
+            if (task)
+                task.output = `[dry-run] Would push: ${filePath}`;
+            return;
+        }
+        try {
+            const post = JSON.parse(await readFile(filePath, 'utf8'));
+            await this.wp.post(seoPostMetaEndpoint(postType), { meta: post.meta, slug: post.slug });
+            if (task)
+                task.output = `Pushed: ${post.slug}`;
+        }
+        catch (error) {
+            const message = `Failed to push ${filePath}: ${error.message}`;
+            if (task)
+                task.output = message;
+            else
+                this.warn(`  ${message}`);
+            this.failedCount++;
+            throw error;
+        }
+    }
+    async pushRedirectFile(filePath, task) {
+        if (this.dryRun) {
+            if (task)
+                task.output = `[dry-run] Would push: ${filePath}`;
+            return;
+        }
+        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);
+            if (task)
+                task.output = `Pushed: redirect #${created.id}`;
+        }
+        catch (error) {
+            const message = `Failed to push ${filePath}: ${error.message}`;
+            if (task)
+                task.output = message;
+            else
+                this.warn(`  ${message}`);
+            this.failedCount++;
+            throw error;
+        }
+    }
+    async pushRedirects(basePath) {
+        const dir = join(basePath, 'redirects');
+        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();
+    }
+    async pushSettings(basePath) {
+        const file = join(basePath, 'settings.json');
+        let raw;
+        try {
+            raw = await readFile(file, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+        if (this.dryRun) {
+            this.log(`[dry-run] Would push: ${file}`);
+            return;
+        }
+        try {
+            await this.wp.put(SEO_SETTINGS_ENDPOINT, JSON.parse(raw));
+            this.log(`Pushed: ${file}`);
+        }
+        catch (error) {
+            this.failedCount++;
+            this.warn(`Failed to push ${file}: ${error.message}`);
+        }
+    }
+    async renameToCanonical(filePath, redirect) {
+        const dir = dirname(filePath);
+        const canonicalPath = join(dir, `${redirectFileBase(redirect)}.json`);
+        await writeFile(canonicalPath, JSON.stringify(redirect, null, 2) + '\n');
+        if (canonicalPath !== filePath)
+            await rm(filePath, { force: true });
+    }
+}

package/dist/lib/base.d.ts

@@ -14,6 +14,7 @@ export declare abstract class LoopressCommand extends Command {
     protected get wp(): WpClient;
     init(): Promise<void>;
     protected resolveAcfPath(override?: string): string;
+    protected resolveSeoPath(override?: string): string;
     protected resolveSnippetsPath(override?: string): string;
     private resolveEnvironment;
 }

package/dist/lib/base.js

@@ -40,6 +40,11 @@ export class LoopressCommand extends Command {
             return override;
         return join(this.rootDir, this.localConfig.acfDir ?? 'acf');
     }
+    resolveSeoPath(override) {
+        if (override)
+            return override;
+        return join(this.rootDir, this.localConfig.seoDir ?? 'seo');
+    }
     resolveSnippetsPath(override) {
         if (override)
             return override;

package/dist/types/project-config.generated.d.ts

@@ -15,6 +15,10 @@ export interface LoopressProjectConfiguration {
      * Directory where ACF field groups, post types, taxonomies and options pages are read from and written to, relative to rootDir.
      */
     acfDir?: string;
+    /**
+     * Directory where SEO settings, post meta, and redirects (RankMath and Yoast SEO, whichever is active) are read from and written to, relative to rootDir.
+     */
+    seoDir?: string;
     /**
      * Project identifier from the global Loopress config. When set, takes precedence over the currently active project in the global config.
      */

package/dist/utils/seo-format.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_POST_TYPES: readonly ["post", "page"];
+export declare const SEO_SETTINGS_ENDPOINT = "loopress/v1/seo/settings";
+export declare const SEO_REDIRECTS_ENDPOINT = "loopress/v1/seo/redirects";
+export declare function seoRedirectEndpoint(id: number): string;
+export declare function seoPostMetaEndpoint(postType: string): string;
+export interface SeoPostMeta {
+    meta: Record<string, unknown>;
+    slug: string;
+    title: string;
+}
+export interface SeoRedirect {
+    createdAt: null | string;
+    headerCode: number;
+    hits: number;
+    id: number;
+    sources: unknown;
+    status: string;
+    updatedAt: null | string;
+    urlTo: string;
+}

package/dist/utils/seo-format.js

@@ -0,0 +1,10 @@
+// Post types synced by `lps seo pull` when --post-type isn't given.
+export const DEFAULT_POST_TYPES = ['post', 'page'];
+export const SEO_SETTINGS_ENDPOINT = 'loopress/v1/seo/settings';
+export const SEO_REDIRECTS_ENDPOINT = 'loopress/v1/seo/redirects';
+export function seoRedirectEndpoint(id) {
+    return `${SEO_REDIRECTS_ENDPOINT}/${id}`;
+}
+export function seoPostMetaEndpoint(postType) {
+    return `loopress/v1/seo/post-meta/${postType}`;
+}

package/oclif.manifest.json

@@ -390,6 +390,263 @@
         "push.js"
       ]
     },
+    "plugin:add": {
+      "aliases": [],
+      "args": {
+        "slug": {
+          "description": "Plugin slug on WordPress.org",
+          "name": "slug",
+          "required": true
+        }
+      },
+      "description": "Add a WordPress.org plugin to loopress.json",
+      "examples": [
+        "$ lps plugin add woocommerce",
+        "$ lps plugin add contact-form-7 --dry-run"
+      ],
+      "flags": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:add",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "add.js"
+      ]
+    },
+    "plugin:pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Pull installed plugins from WordPress into loopress.json",
+      "examples": [
+        "$ lps plugin pull",
+        "$ lps plugin pull --dry-run"
+      ],
+      "flags": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:pull",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "pull.js"
+      ]
+    },
+    "plugin:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Push plugins to WordPress to match loopress.json",
+      "examples": [
+        "$ lps plugin push",
+        "$ lps plugin push --dry-run"
+      ],
+      "flags": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "push.js"
+      ]
+    },
+    "seo:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List posts with SEO meta, and redirects if supported by the active SEO plugin, on WordPress",
+      "examples": [
+        "$ lps seo list",
+        "$ lps seo list --post-type post"
+      ],
+      "flags": {
+        "json": {
+          "char": "j",
+          "description": "Output in JSON format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "post-type": {
+          "description": "Limit to specific post types",
+          "name": "post-type",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "seo:list",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "seo",
+        "list.js"
+      ]
+    },
+    "seo:pull": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to SEO directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Pull SEO settings, post meta, and (if supported) redirects from WordPress",
+      "examples": [
+        "$ lps seo pull",
+        "$ lps seo pull --post-type post --post-type page"
+      ],
+      "flags": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "post-type": {
+          "description": "Limit post meta to specific post types",
+          "name": "post-type",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "seo:pull",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "dryRunFlag": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "seo",
+        "pull.js"
+      ]
+    },
+    "seo:push": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to SEO directory (overrides project config)",
+          "name": "path"
+        }
+      },
+      "description": "Push SEO settings, post meta, and redirects to WordPress. Local redirect files created remotely are renamed on disk to the `<id>-<slug>` convention. Fails clearly per file if the active SEO plugin does not support redirects.",
+      "examples": [
+        "$ lps seo push"
+      ],
+      "flags": {
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would change without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "seo:push",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "seo",
+        "push.js"
+      ]
+    },
     "project:config": {
       "aliases": [],
       "args": {},
@@ -687,126 +944,6 @@
         "push.js"
       ]
     },
-    "plugin:add": {
-      "aliases": [],
-      "args": {
-        "slug": {
-          "description": "Plugin slug on WordPress.org",
-          "name": "slug",
-          "required": true
-        }
-      },
-      "description": "Add a WordPress.org plugin to loopress.json",
-      "examples": [
-        "$ lps plugin add woocommerce",
-        "$ lps plugin add contact-form-7 --dry-run"
-      ],
-      "flags": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "plugin:add",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "dryRunFlag": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "plugin",
-        "add.js"
-      ]
-    },
-    "plugin:pull": {
-      "aliases": [],
-      "args": {},
-      "description": "Pull installed plugins from WordPress into loopress.json",
-      "examples": [
-        "$ lps plugin pull",
-        "$ lps plugin pull --dry-run"
-      ],
-      "flags": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "plugin:pull",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "dryRunFlag": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "plugin",
-        "pull.js"
-      ]
-    },
-    "plugin:push": {
-      "aliases": [],
-      "args": {},
-      "description": "Push plugins to WordPress to match loopress.json",
-      "examples": [
-        "$ lps plugin push",
-        "$ lps plugin push --dry-run"
-      ],
-      "flags": {
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would change without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "plugin:push",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "plugin",
-        "push.js"
-      ]
-    },
     "telemetry:disable": {
       "aliases": [],
       "args": {},
@@ -856,5 +993,5 @@
       ]
     }
   },
-  "version": "0.16.0"
+  "version": "0.17.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loopress/cli",
   "description": "CLI tool for syncing WordPress code snippets, plugins, and Composer dependencies via the REST API",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -96,6 +96,9 @@
       "project": {
         "description": "Manage WordPress project and environment configurations"
       },
+      "seo": {
+        "description": "Manage SEO settings, post meta, and redirects (RankMath or Yoast SEO, whichever is active)"
+      },
       "snippet": {
         "description": "Manage WordPress code snippets"
       },

package/schemas/project-config.schema.json

@@ -24,6 +24,11 @@
       "description": "Directory where ACF field groups, post types, taxonomies and options pages are read from and written to, relative to rootDir.",
       "default": "acf"
     },
+    "seoDir": {
+      "type": "string",
+      "description": "Directory where SEO settings, post meta, and redirects (RankMath and Yoast SEO, whichever is active) are read from and written to, relative to rootDir.",
+      "default": "seo"
+    },
     "projectId": {
       "type": "string",
       "description": "Project identifier from the global Loopress config. When set, takes precedence over the currently active project in the global config."