@loopress/cli 0.15.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.15.0 linux-x64 node-v24.18.0
+@loopress/cli/0.17.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -47,6 +47,10 @@ report.
 # Commands
 
 <!-- commands -->
+* [`lps acf list`](#lps-acf-list)
+* [`lps acf pull [PATH]`](#lps-acf-pull-path)
+* [`lps acf push [PATH]`](#lps-acf-push-path)
+* [`lps composer init`](#lps-composer-init)
 * [`lps composer pull`](#lps-composer-pull)
 * [`lps composer push`](#lps-composer-push)
 * [`lps help [COMMAND]`](#lps-help-command)
@@ -62,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)
@@ -70,9 +77,109 @@ report.
 * [`lps telemetry disable`](#lps-telemetry-disable)
 * [`lps telemetry enable`](#lps-telemetry-enable)
 
+## `lps acf list`
+
+List ACF field groups, post types, taxonomies, and options pages from WordPress
+
+```
+USAGE
+  $ lps acf list [-j] [--type field-groups|post-types|taxonomies|options-pages...]
+
+FLAGS
+  -j, --json              Output in JSON format
+      --type=<option>...  Limit to specific ACF object types
+                          <options: field-groups|post-types|taxonomies|options-pages>
+
+DESCRIPTION
+  List ACF field groups, post types, taxonomies, and options pages from WordPress
+
+EXAMPLES
+  $ lps acf list
+
+  $ lps acf list --type field-groups
+```
+
+_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]`
+
+Pull ACF field groups, post types, taxonomies, and options pages from WordPress
+
+```
+USAGE
+  $ lps acf pull [PATH] [-d] [--type field-groups|post-types|taxonomies|options-pages...]
+
+ARGUMENTS
+  [PATH]  Path to ACF directory (overrides project config)
+
+FLAGS
+  -d, --dry-run           Show what would change without making changes
+      --type=<option>...  Limit to specific ACF object types
+                          <options: field-groups|post-types|taxonomies|options-pages>
+
+DESCRIPTION
+  Pull ACF field groups, post types, taxonomies, and options pages from WordPress
+
+EXAMPLES
+  $ lps acf pull
+
+  $ lps acf pull --type field-groups
+```
+
+_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]`
+
+Push ACF field groups, post types, taxonomies, and options pages to WordPress
+
+```
+USAGE
+  $ lps acf push [PATH] [-d] [--type field-groups|post-types|taxonomies|options-pages...]
+
+ARGUMENTS
+  [PATH]  Path to ACF directory (overrides project config)
+
+FLAGS
+  -d, --dry-run           Show what would change without making changes
+      --type=<option>...  Limit to specific ACF object types
+                          <options: field-groups|post-types|taxonomies|options-pages>
+
+DESCRIPTION
+  Push ACF field groups, post types, taxonomies, and options pages to WordPress
+
+EXAMPLES
+  $ lps acf push
+
+  $ lps acf push --type field-groups
+```
+
+_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/acf/push.ts)_
+
+## `lps composer init`
+
+Create a composer.json wired to WPackagist for installing WordPress.org plugins and themes
+
+```
+USAGE
+  $ lps composer init [-d]
+
+FLAGS
+  -d, --dry-run  Show what would change without making changes
+
+DESCRIPTION
+  Create a composer.json wired to WPackagist for installing WordPress.org plugins and themes
+
+EXAMPLES
+  $ lps composer init
+
+  $ lps composer init --dry-run
+```
+
+_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/composer/init.ts)_
+
 ## `lps composer pull`
 
-Pull composer.lock from WordPress
+Pull composer.json and composer.lock from WordPress
 
 ```
 USAGE
@@ -82,7 +189,7 @@ FLAGS
   -d, --dry-run  Show what would change without making changes
 
 DESCRIPTION
-  Pull composer.lock from WordPress
+  Pull composer.json and composer.lock from WordPress
 
 EXAMPLES
   $ lps composer pull
@@ -90,7 +197,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -112,7 +219,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.15.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]`
 
@@ -149,7 +256,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -166,7 +273,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -183,7 +290,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -208,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.15.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`
 
@@ -230,7 +337,7 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -252,7 +359,7 @@ EXAMPLES
   $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -270,7 +377,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -287,7 +394,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -304,7 +411,7 @@ EXAMPLES
   $ lps project pull
 ```
 
-_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -321,7 +428,7 @@ EXAMPLES
   $ lps project push
 ```
 
-_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -338,7 +445,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -355,7 +462,80 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -375,7 +555,7 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.15.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]`
 
@@ -398,7 +578,7 @@ EXAMPLES
   $ lps snippet publish --path ./snippets
 ```
 
-_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.15.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]`
 
@@ -423,7 +603,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.15.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]`
 
@@ -449,7 +629,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -466,7 +646,7 @@ EXAMPLES
   $ lps status
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -483,7 +663,7 @@ EXAMPLES
   $ lps telemetry disable
 ```
 
-_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.15.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`
 
@@ -500,5 +680,5 @@ EXAMPLES
   $ lps telemetry enable
 ```
 
-_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.15.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/acf/list.d.ts

@@ -0,0 +1,10 @@
+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>;
+        type: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/acf/list.js

@@ -0,0 +1,36 @@
+import { Flags } from '@oclif/core';
+import { LoopressCommand } from '../../lib/base.js';
+import { ACF_OBJECT_TYPES, acfEndpoint, getAcfKey } from '../../utils/acf-format.js';
+export default class List extends LoopressCommand {
+    static description = 'List ACF field groups, post types, taxonomies, and options pages from WordPress';
+    static examples = ['$ lps acf list', '$ lps acf list --type field-groups'];
+    static flags = {
+        json: Flags.boolean({ char: 'j', description: 'Output in JSON format' }),
+        type: Flags.string({ description: 'Limit to specific ACF object types', multiple: true, options: ACF_OBJECT_TYPES }),
+    };
+    async run() {
+        const { flags } = await this.parse(List);
+        const types = (flags.type && flags.type.length > 0 ? flags.type : ACF_OBJECT_TYPES);
+        const byType = {};
+        for (const type of types) {
+            byType[type] = await this.wp.get(acfEndpoint(type));
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(byType, null, 2));
+            return;
+        }
+        for (const type of types) {
+            const objects = byType[type];
+            this.log(`${type} (${objects.length}):`);
+            if (objects.length === 0) {
+                this.log('  (none)');
+                this.log('');
+                continue;
+            }
+            for (const object of objects) {
+                this.log(`  ${getAcfKey(object) ?? '(no key)'}. ${String(object.title ?? '(untitled)')}`);
+            }
+            this.log('');
+        }
+    }
+}

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

@@ -0,0 +1,15 @@
+import { LoopressCommand } from '../../lib/base.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: {
+        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 pullType;
+}

package/dist/commands/acf/pull.js

@@ -0,0 +1,80 @@
+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 { LoopressCommand } from '../../lib/base.js';
+import { ACF_OBJECT_TYPES, acfEndpoint, getAcfKey } from '../../utils/acf-format.js';
+export default class Pull extends LoopressCommand {
+    static args = {
+        path: Args.string({ description: 'Path to ACF directory (overrides project config)' }),
+    };
+    static description = 'Pull ACF field groups, post types, taxonomies, and options pages from WordPress';
+    static examples = ['$ lps acf pull', '$ lps acf pull --type field-groups'];
+    static flags = {
+        ...LoopressCommand.dryRunFlag,
+        type: Flags.string({ description: 'Limit to specific ACF object types', multiple: true, options: ACF_OBJECT_TYPES }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Pull);
+        const { url } = this.siteConfig;
+        const path = this.resolveAcfPath(args.path);
+        const types = (flags.type && flags.type.length > 0 ? flags.type : ACF_OBJECT_TYPES);
+        this.log(`Pulling ACF configuration from ${url}`);
+        this.log(`ACF path: ${path}`);
+        for (const type of types) {
+            await this.pullType(type, path);
+        }
+    }
+    // Every file in a type's subdirectory is unambiguously `<key>.json` — unlike snippets, ACF
+    // objects have no numeric-id/slug filename convention. `key` is the stable identity ACF
+    // itself already uses for this (see its own Local JSON mechanism), so orphan detection is a
+    // plain set difference, no regex/extension juggling needed.
+    async findOrphanedFiles(dir, keepKeys) {
+        let files;
+        try {
+            files = await readdir(dir);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        return files.filter((file) => extname(file) === '.json' && !keepKeys.has(file.slice(0, -'.json'.length)));
+    }
+    async pullType(type, basePath) {
+        const dir = join(basePath, type);
+        const remoteList = await this.wp.get(acfEndpoint(type));
+        const withKey = remoteList.filter((object) => getAcfKey(object) !== null);
+        const skipped = remoteList.length - withKey.length;
+        const orphans = await this.findOrphanedFiles(dir, new Set(withKey.map((object) => getAcfKey(object))));
+        if (this.dryRun) {
+            this.log(`[dry-run] Would pull ${withKey.length} ${type} 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 (withKey.length > 0)
+            await mkdir(dir, { recursive: true });
+        await new Listr(withKey.map((object) => {
+            const key = getAcfKey(object);
+            return {
+                async task(_ctx, task) {
+                    await writeFile(join(dir, `${key}.json`), JSON.stringify(object, null, 2) + '\n');
+                    task.output = `Pulled: ${key}`;
+                },
+                title: `Pull ${key}`,
+            };
+        })).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 ${withKey.length} ${type} to ${dir}`);
+        if (skipped > 0) {
+            this.warn(`${skipped} ${type} skipped because they have no key`);
+        }
+    }
+}

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

@@ -0,0 +1,17 @@
+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: {
+        type: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    private failedCount;
+    run(): Promise<void>;
+    private loadObjects;
+    private pushObject;
+    private pushType;
+}

package/dist/commands/acf/push.js

@@ -0,0 +1,108 @@
+import { Args, Flags } from '@oclif/core';
+import { Listr } from 'listr2';
+import { readdir, readFile } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+import { PushCommand } from '../../lib/push-command.js';
+import { ACF_OBJECT_TYPES, acfEndpoint, getAcfKey } from '../../utils/acf-format.js';
+export default class Push extends PushCommand {
+    static args = {
+        path: Args.string({ description: 'Path to ACF directory (overrides project config)' }),
+    };
+    static description = 'Push ACF field groups, post types, taxonomies, and options pages to WordPress';
+    static examples = ['$ lps acf push', '$ lps acf push --type field-groups'];
+    static flags = {
+        ...PushCommand.dryRunFlag,
+        type: Flags.string({ description: 'Limit to specific ACF object types', multiple: true, options: ACF_OBJECT_TYPES }),
+    };
+    failedCount = 0;
+    async run() {
+        const { args, flags } = await this.parse(Push);
+        const { url } = this.siteConfig;
+        const path = this.resolveAcfPath(args.path);
+        const types = (flags.type && flags.type.length > 0 ? flags.type : ACF_OBJECT_TYPES);
+        this.log(`Pushing ACF configuration to ${url}`);
+        this.log(`ACF path: ${path}`);
+        for (const type of types) {
+            await this.pushType(type, path);
+        }
+        if (this.failedCount > 0) {
+            this.error(`${this.failedCount} ACF object${this.failedCount === 1 ? '' : 's'} failed to push.`);
+        }
+        if (this.dryRun)
+            return;
+        await this.recordSuccess();
+        this.log('All ACF objects pushed.');
+    }
+    // One object's file is read in isolation: a corrupted or hand-broken JSON file (or one
+    // missing/emptying its "key") must only skip that object, not abort loading the rest of
+    // the type's directory — same principle as loadSnippets() for the snippet feature.
+    async loadObjects(dir) {
+        let files;
+        try {
+            files = await readdir(dir);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        const objects = [];
+        for (const file of files) {
+            if (extname(file) !== '.json')
+                continue;
+            const filePath = join(dir, file);
+            let parsed;
+            try {
+                parsed = JSON.parse(await readFile(filePath, 'utf8'));
+            }
+            catch (error) {
+                this.warn(`Skipping "${filePath}": ${error.message}`);
+                continue;
+            }
+            if (typeof parsed !== 'object' || parsed === null || getAcfKey(parsed) === null) {
+                this.warn(`Skipping "${filePath}": missing or invalid "key"`);
+                continue;
+            }
+            objects.push(parsed);
+        }
+        return objects;
+    }
+    // Throwing on failure (rather than returning a boolean) is what lets Listr mark the task as
+    // failed (red cross) instead of completed; `exitOnError: false` on the task list still lets
+    // sibling objects push regardless. POST alone covers create-or-update (the controller resolves
+    // that server-side via the object's `key`), unlike snippet push there's no numeric-id PUT/404
+    // fallback dance, and no rename-on-push step since `key` is permanently stable.
+    async pushObject(type, object, task) {
+        const key = getAcfKey(object) ?? '(unknown)';
+        if (this.dryRun) {
+            if (task)
+                task.output = `[dry-run] Would push: ${key}`;
+            return;
+        }
+        try {
+            await this.wp.post(acfEndpoint(type), object);
+            if (task)
+                task.output = `Pushed: ${key}`;
+        }
+        catch (error) {
+            const message = `Failed to push ${key}: ${error.message}`;
+            if (task)
+                task.output = message;
+            else
+                this.warn(`  ${message}`);
+            this.failedCount++;
+            throw error;
+        }
+    }
+    async pushType(type, basePath) {
+        const dir = join(basePath, type);
+        const objects = await this.loadObjects(dir);
+        if (objects.length === 0)
+            return;
+        this.log(`Found ${objects.length} ${type} to push`);
+        await new Listr(objects.map((object) => ({
+            task: async (_ctx, task) => this.pushObject(type, object, task),
+            title: `Push ${getAcfKey(object) ?? '(unknown)'}`,
+        })), { concurrent: false, exitOnError: false }).run();
+    }
+}

package/dist/commands/composer/init.d.ts

@@ -0,0 +1,9 @@
+import { LoopressCommand } from '../../lib/base.js';
+export default class ComposerInit extends LoopressCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}