@loopress/cli 0.28.0 → 0.30.0

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

@@ -1,15 +1,23 @@
 import { LoopressCommand } from '../../lib/base.js';
+import { type AcfObjectType } from '../../utils/acf-format.js';
+type AcfPullResult = {
+    path: string;
+    status: 'dry-run' | 'success';
+    types: AcfObjectType[];
+};
 export default class Pull extends LoopressCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
         type: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<AcfPullResult>;
     private pullType;
 }
+export {};

package/dist/commands/acf/pull.js

@@ -9,6 +9,7 @@ export default class Pull extends LoopressCommand {
         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 enableJsonFlag = true;
     static examples = ['$ lps acf pull', '$ lps acf pull --type field-groups'];
     static flags = {
         ...LoopressCommand.dryRunFlag,
@@ -25,6 +26,7 @@ export default class Pull extends LoopressCommand {
         for (const type of types) {
             await this.pullType(type, path);
         }
+        return { path, status: this.dryRun ? 'dry-run' : 'success', types };
     }
     async pullType(type, basePath) {
         const dir = join(basePath, type);

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

@@ -1,18 +1,26 @@
 import { PushCommand } from '../../lib/push-command.js';
+import { type AcfObjectType } from '../../utils/acf-format.js';
+type AcfPushResult = {
+    path: string;
+    status: 'dry-run' | 'success';
+    types: AcfObjectType[];
+};
 export default class Push extends PushCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
         type: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<AcfPushResult>;
     private currentRevision;
     private loadObjects;
     private pushObject;
     private pushType;
 }
+export {};

package/dist/commands/acf/push.js

@@ -11,6 +11,7 @@ export default class Push extends PushCommand {
         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 enableJsonFlag = true;
     static examples = ['$ lps acf push', '$ lps acf push --type field-groups'];
     static flags = {
         ...PushCommand.dryRunFlag,
@@ -34,9 +35,10 @@ export default class Push extends PushCommand {
             this.error(`${pluralize(this.failedCount, 'ACF object')} failed to push.`);
         }
         if (this.dryRun)
-            return;
+            return { path, status: 'dry-run', types };
         await this.recordSuccess();
         this.log('All ACF objects pushed.');
+        return { path, status: 'success', types };
     }
     async currentRevision(type, key) {
         try {

package/dist/commands/api/publish.js

@@ -16,7 +16,7 @@ export default class Publish extends Command {
         path: Args.string({ description: 'Path to api directory (overrides project config)' }),
     };
     static description = 'Publish custom API routes to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.';
-    static examples = ['$ lps api publish', '$ lps api publish --path ./api'];
+    static examples = ['$ lps api publish', '$ lps api publish ./api'];
     async run() {
         const { args } = await this.parse(Publish);
         const { apiProjectId, localConfig, token } = await resolveLinkedProject((message) => this.error(message));

package/dist/commands/app/push.js

@@ -63,7 +63,7 @@ export default class Push extends PushCommand {
             .filter((entry) => entry.isDirectory())
             .map((entry) => entry.name)
             .filter((name) => existsSync(join(path, name, APP_CONFIG_FILENAME)))
-            .sort((a, b) => a.localeCompare(b));
+            .toSorted((a, b) => a.localeCompare(b));
         if (only) {
             if (!names.includes(only)) {
                 this.error(`No app "${only}" in ${path} (looked for ${join(only, APP_CONFIG_FILENAME)}).`);

package/dist/commands/composer/push.js

@@ -3,8 +3,8 @@ import { existsSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { PushCommand } from '../../lib/push-command.js';
-import { isTimeoutError } from '../../lib/wp-client.js';
-import { toIntent } from '../../utils/composer.js';
+import { isLocalEnvironment, isTimeoutError } from '../../lib/wp-client.js';
+import { requireToInstall, toIntent } from '../../utils/composer.js';
 import { parseCollisions, SYNC_TIMEOUT_MS, } from '../../utils/plugin-sync.js';
 export default class ComposerPush extends PushCommand {
     static description = 'Push composer.json to WordPress and run Composer to resolve and install dependencies';
@@ -25,7 +25,7 @@ export default class ComposerPush extends PushCommand {
             this.error(`No composer.json found at ${composerJsonPath}. Run \`lps composer init\` first.`);
         }
         const parsed = JSON.parse(await readFile(composerJsonPath, 'utf8'));
-        const require = parsed.require ?? {};
+        const require = requireToInstall(parsed, isLocalEnvironment(this.siteConfig.name));
         const packageCount = Object.keys(require).length;
         const intent = toIntent(require);
         const hasLock = existsSync(composerLockPath);

package/dist/commands/cpt/diff.js

@@ -0,0 +1,5 @@
+import { resourceDiffCommand } from '../../lib/diff-command.js';
+export default resourceDiffCommand('cpt', {
+    description: 'Show what differs in custom post types between your local cpt/ files and a WordPress environment, or between two environments',
+    pathNoun: 'cpt directory',
+});

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

@@ -0,0 +1,2 @@
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/declared-type-command.js").DeclaredListCommand>;
+export default _default;

package/dist/commands/cpt/list.js

@@ -0,0 +1,4 @@
+import { declaredListCommand } from '../../lib/declared-type-command.js';
+import { CPT_SPEC } from '../../utils/declared-type-format.js';
+export default declaredListCommand(CPT_SPEC, 'List the post types registered on WordPress and where each comes from (Loopress, WordPress, ACF, CPT UI, a theme or plugin). ' +
+    'Only Loopress ones are pulled and pushed.', (count) => `${count} published`);

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

@@ -0,0 +1,2 @@
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/declared-type-command.js").DeclaredPullCommand>;
+export default _default;

package/dist/commands/cpt/pull.js

@@ -0,0 +1,4 @@
+import { declaredPullCommand } from '../../lib/declared-type-command.js';
+import { CPT_SPEC } from '../../utils/declared-type-format.js';
+export default declaredPullCommand(CPT_SPEC, 'Pull the custom post types Loopress manages on WordPress into cpt/<slug>.json files. ' +
+    'Post types registered by a theme or another plugin are never pulled, see `lps cpt list`.');

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

@@ -0,0 +1,2 @@
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/declared-type-command.js").DeclaredPushCommand>;
+export default _default;

package/dist/commands/cpt/push.js

@@ -0,0 +1,4 @@
+import { declaredPushCommand } from '../../lib/declared-type-command.js';
+import { CPT_SPEC } from '../../utils/declared-type-format.js';
+export default declaredPushCommand(CPT_SPEC, 'Push local custom post types (cpt/<slug>.json, register_post_type() arguments) to WordPress. ' +
+    'Create or update only, never deletes a post type: use `lps cpt rm` for that.');

package/dist/commands/cpt/rm.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/declared-type-command.js").DeclaredRmCommand>;
+export default _default;

package/dist/commands/cpt/rm.js

@@ -0,0 +1,3 @@
+import { declaredRmCommand } from '../../lib/declared-type-command.js';
+import { CPT_SPEC } from '../../utils/declared-type-format.js';
+export default declaredRmCommand(CPT_SPEC, 'Stop registering a Loopress custom post type on WordPress. Its posts are kept in the database, hidden until the post type is pushed again.', "Its posts are kept in the database, hidden until it's pushed again.");

package/dist/commands/cpt/rollback.js

@@ -0,0 +1,5 @@
+import { resourceRollbackCommand } from '../../lib/rollback-command.js';
+export default resourceRollbackCommand('cpt', {
+    description: 'Restore custom post types to a snapshot taken automatically before an earlier `lps cpt push`',
+    pathNoun: 'cpt directory',
+});

package/dist/commands/dev.js

@@ -48,18 +48,28 @@ export default class Dev extends Command {
     }
     // Sequential on purpose (see notes technique: parallelizing push is out of scope). A failed
     // push is logged and swallowed here, never thrown, so one bad batch can't take the watcher down.
+    // Types sharing a command run it once: templates, parts, css and blocks all rewrite the whole
+    // child theme through `theme:template:push`.
     async pushBatch(changesByType, targets) {
+        const byCommand = new Map();
         for (const [type, paths] of changesByType) {
             const target = targets.find((t) => t.type === type);
             if (!target)
                 continue;
-            this.log(`\n→ ${type} changed (${paths.map((path) => basename(path)).join(', ')}), pushing to local...`);
+            const batch = byCommand.get(target.commandId) ?? { paths: [], types: [] };
+            batch.types.push(type);
+            batch.paths.push(...paths);
+            byCommand.set(target.commandId, batch);
+        }
+        for (const [commandId, { paths, types }] of byCommand) {
+            const label = types.join(', ');
+            this.log(`\n→ ${label} changed (${paths.map((path) => basename(path)).join(', ')}), pushing to local...`);
             try {
-                await this.config.runCommand(target.commandId, ['--env', 'local']);
-                this.log(`✓ ${type} synced`);
+                await this.config.runCommand(commandId, ['--env', 'local']);
+                this.log(`✓ ${label} synced`);
             }
             catch (error) {
-                this.log(`✗ ${type} failed: ${error.message}`);
+                this.log(`✗ ${label} failed: ${error.message}`);
             }
         }
     }

package/dist/commands/diff.js

@@ -7,7 +7,7 @@ const RESOURCES = [...RESOURCE_STATE_PROVIDERS.map((provider) => provider.resour
 export default class Diff extends DiffCommand {
     static description = [
         'Show what differs between your local tracked files and a WordPress environment, or between two environments.',
-        'Covers snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, SEO, Options, Menus, Theme styles, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`.',
+        'Covers snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, Options, Menus, Theme styles, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`.',
         'Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.',
     ].join(' ');
     static enableJsonFlag = true;

package/dist/commands/doctor.d.ts

@@ -19,6 +19,7 @@ export default class Doctor extends LoopressCommand {
     private readonly checks;
     run(): Promise<DoctorResult>;
     private check;
+    private checkLeftoverTempAdmins;
     private out;
     private reportPluginVersion;
 }

package/dist/commands/doctor.js

@@ -1,6 +1,7 @@
 import { configManager } from '../config/project-config.manager.js';
 import { LoopressCommand } from '../lib/base.js';
-import { isNotFoundError } from '../lib/wp-client.js';
+import { findTempAdmins } from '../lib/temp-admin.js';
+import { isForbiddenError, isNotFoundError } from '../lib/wp-client.js';
 import { diagnoseWpSite } from '../lib/wp-site-diagnostic.js';
 import { pluralize } from '../utils/pluralize.js';
 export default class Doctor extends LoopressCommand {
@@ -32,7 +33,10 @@ export default class Doctor extends LoopressCommand {
                 await this.check('Loopress plugin installed (loopress/v1 endpoints)', async () => this.wp.get('loopress/v1'));
                 // wp/v2/users/me is WordPress core and requires authentication, so it validates the
                 // application password without depending on any Loopress feature.
-                await this.check('Credentials accepted (authenticated request)', async () => this.wp.get('wp/v2/users/me'));
+                const isAuthenticated = await this.check('Credentials accepted (authenticated request)', async () => this.wp.get('wp/v2/users/me'));
+                // Skipped when the credentials were just rejected: it would only repeat that same 401.
+                if (isAuthenticated)
+                    await this.checkLeftoverTempAdmins();
                 pluginVersion = await this.reportPluginVersion();
             }
             else {
@@ -72,6 +76,30 @@ export default class Doctor extends LoopressCommand {
             return false;
         }
     }
+    // Report only, never deletes: a doctor run shouldn't change the site. A leftover is a live
+    // administrator with a password nobody holds, so it fails the run. Credentials without
+    // `list_users` can't look, which is informational, not a failure: nothing was found wrong.
+    async checkLeftoverTempAdmins() {
+        let lookup;
+        try {
+            lookup = { leftovers: await findTempAdmins(this.wp) };
+        }
+        catch (error) {
+            lookup = { error };
+        }
+        if ('error' in lookup && isForbiddenError(lookup.error)) {
+            this.out('- Leftover temporary admin accounts: not checked, these credentials cannot list users.');
+            return;
+        }
+        await this.check('No leftover temporary admin accounts', async () => {
+            if ('error' in lookup)
+                throw lookup.error;
+            if (lookup.leftovers.length > 0) {
+                const names = lookup.leftovers.map((admin) => admin.username).join(', ');
+                throw new Error(`Found ${names}, left by an interrupted Loopress Full install. Re-run \`lps project config\` to remove them, or delete them in wp-admin > Users.`);
+            }
+        });
+    }
     out(message) {
         if (!this.jsonEnabled())
             this.log(message);

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

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

package/dist/commands/form/pull.js

@@ -11,6 +11,7 @@ export default class Pull extends LoopressCommand {
         path: Args.string({ description: 'Path to forms directory (overrides project config)' }),
     };
     static description = 'Pull forms from WordPress';
+    static enableJsonFlag = true;
     static examples = ['$ lps form pull'];
     static flags = {
         ...LoopressCommand.dryRunFlag,
@@ -46,9 +47,10 @@ export default class Pull extends LoopressCommand {
             },
         });
         if (this.dryRun)
-            return;
+            return { orphans, path, skipped, status: 'dry-run' };
         if (skipped > 0) {
             this.warn(`${pluralize(skipped, 'form')} skipped because they have no id`);
         }
+        return { orphans, path, skipped, status: 'success' };
     }
 }

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

@@ -1,9 +1,14 @@
 import { PushCommand } from '../../lib/push-command.js';
+type FormPushResult = {
+    path: string;
+    status: 'dry-run' | 'success';
+};
 export default class Push extends PushCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
         'allow-notifications': import("@oclif/core/interfaces").BooleanFlag<boolean>;
@@ -11,9 +16,10 @@ export default class Push extends PushCommand {
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     private allowNotifications;
-    run(): Promise<void>;
+    run(): Promise<FormPushResult>;
     private currentRevision;
     private ensureCanonicalFilename;
     private loadFiles;
     private pushForm;
 }
+export {};

package/dist/commands/form/push.js

@@ -14,6 +14,7 @@ export default class Push extends PushCommand {
         path: Args.string({ description: 'Path to forms directory (overrides project config)' }),
     };
     static description = 'Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json` convention.';
+    static enableJsonFlag = true;
     static examples = ['$ lps form push', '$ lps form push --allow-notifications'];
     static flags = {
         ...PushCommand.dryRunFlag,
@@ -41,9 +42,10 @@ export default class Push extends PushCommand {
             this.error(`${pluralize(this.failedCount, 'form')} failed to push.`);
         }
         if (this.dryRun)
-            return;
+            return { path, status: 'dry-run' };
         await this.recordSuccess();
         this.log('All forms pushed.');
+        return { path, status: 'success' };
     }
     async currentRevision(id) {
         try {

package/dist/commands/init.js

@@ -1,4 +1,4 @@
-import { checkbox, confirm, input, select } from '@inquirer/prompts';
+import { confirm, input, select } from '@inquirer/prompts';
 import { Command } from '@oclif/core';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
@@ -11,19 +11,6 @@ const SNIPPET_PROVIDERS = [
     { name: 'Code Snippets', slug: 'code-snippets' },
     { name: 'WPCode', slug: 'insert-headers-and-footers' },
 ];
-// Default directory per optional feature, matching the resolve*Path defaults in lib/base.ts.
-const FEATURES = [
-    { dir: 'acf', key: 'acfDir', label: 'ACF' },
-    { dir: 'seo', key: 'seoDir', label: 'SEO' },
-    { dir: 'menus', key: 'menuDir', label: 'Menus' },
-    { dir: 'forms', key: 'formDir', label: 'Forms' },
-    { dir: 'api', key: 'apiDir', label: 'Custom API routes' },
-    { dir: 'hooks', key: 'hooksDir', label: 'Hooks (actions, filters, cron)' },
-    { dir: 'apps', key: 'appsDir', label: 'Single-page apps' },
-    { dir: 'pages', key: 'pageDir', label: 'Static pages' },
-    { dir: 'templates', key: 'templateDir', label: 'Block templates' },
-    { dir: 'parts', key: 'partDir', label: 'Block template parts' },
-];
 export default class Init extends Command {
     static description = 'Initialize a loopress.json config file in the current directory';
     static examples = ['$ lps init'];
@@ -48,27 +35,13 @@ export default class Init extends Command {
             default: '.',
             message: 'Root directory',
         });
-        const snippetsDir = await input({
-            default: 'snippets',
-            message: 'Snippets directory (relative to root)',
-        });
-        const features = await checkbox({
-            choices: FEATURES.map((feature) => ({ name: `${feature.label} (${feature.dir}/)`, value: feature.key })),
-            message: 'Other features to configure directories for (optional)',
-        });
         const providerChoice = await select({
             choices: [...SNIPPET_PROVIDERS.map((p) => ({ name: p.name, value: p.slug })), { name: 'None / already installed', value: '__none__' }],
             message: 'Snippet provider',
         });
-        const config = {
-            projectId,
-            rootDir,
-            snippetsDir,
-        };
-        for (const feature of FEATURES) {
-            if (features.includes(feature.key))
-                config[feature.key] = feature.dir;
-        }
+        // Resource directories are left out on purpose: every command falls back to its default
+        // (utils/resource-dirs.ts), and a custom name is a one-line edit in loopress.json.
+        const config = { projectId, rootDir };
         await writeLocalConfig(config);
         const isGitattributesUpdated = await ensureLfGitattributes();
         let isProviderAdded = false;
@@ -83,19 +56,14 @@ export default class Init extends Command {
         }
         this.log(`\n✓ loopress.json created`);
         this.log(`  Project:  ${projectLabel}`);
-        this.log(`  Snippets: ${join(rootDir, snippetsDir)}`);
-        for (const feature of FEATURES) {
-            if (features.includes(feature.key)) {
-                this.log(`  ${feature.label}:${' '.repeat(Math.max(1, 9 - feature.label.length))}${join(rootDir, feature.dir)}`);
-            }
-        }
+        this.log(`  Root:     ${rootDir}`);
         if (isProviderAdded) {
             this.log(`  Plugin:   ${providerChoice}`);
         }
         if (isGitattributesUpdated) {
             this.log('✓ .gitattributes: LF line endings, so files match across macOS, Linux and Windows');
         }
-        this.log('\n→ Next: run `lps snippet pull` to fetch what is already on the site, or `lps doctor` to verify the connection.');
+        this.log('\n→ Next: run `lps pull` to fetch what is already on the site, or `lps doctor` to verify the connection.');
     }
     // When nothing is configured yet, the useful path is configuring a project right here, not
     // typing a project ID that points at nothing. Manual entry stays available as an explicit

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

@@ -1,15 +1,21 @@
 import { LoopressCommand } from '../../lib/base.js';
+type MenuPullResult = {
+    path: string;
+    status: 'dry-run' | 'success';
+};
 export default class Pull extends LoopressCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<MenuPullResult>;
     private pullLocations;
     private pullMenus;
 }
+export {};

package/dist/commands/menu/pull.js

@@ -12,6 +12,7 @@ export default class Pull extends LoopressCommand {
         path: Args.string({ description: 'Path to menus directory (overrides project config)' }),
     };
     static description = 'Pull nav menus and the active theme menu locations from WordPress';
+    static enableJsonFlag = true;
     static examples = ['$ lps menu pull'];
     static flags = {
         ...LoopressCommand.dryRunFlag,
@@ -25,6 +26,7 @@ export default class Pull extends LoopressCommand {
         this.log(`Menus path: ${path}`);
         await this.pullMenus(path);
         await this.pullLocations(path);
+        return { path, status: this.dryRun ? 'dry-run' : 'success' };
     }
     async pullLocations(basePath) {
         const file = join(basePath, `${LOCATIONS_FILE_BASENAME}.json`);

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

@@ -1,17 +1,23 @@
 import { PushCommand } from '../../lib/push-command.js';
+type MenuPushResult = {
+    path: string;
+    status: 'dry-run' | 'success';
+};
 export default class Push extends PushCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<MenuPushResult>;
     private currentRevision;
     private pushLocations;
     private pushMenuFile;
     private pushMenus;
 }
+export {};

package/dist/commands/menu/push.js

@@ -15,6 +15,7 @@ export default class Push extends PushCommand {
         path: Args.string({ description: 'Path to menus directory (overrides project config)' }),
     };
     static description = 'Push local nav menus and the active theme menu locations to WordPress. Each menu\'s post_type/taxonomy items are resolved by slug on the target environment, never by a raw id; an item whose target does not exist there fails the whole menu rather than guessing.';
+    static enableJsonFlag = true;
     static examples = ['$ lps menu push'];
     static flags = {
         ...PushCommand.dryRunFlag,
@@ -35,9 +36,10 @@ export default class Push extends PushCommand {
             this.error(`${pluralize(this.failedCount, 'menu')} failed to push.`);
         }
         if (this.dryRun)
-            return;
+            return { path, status: 'dry-run' };
         await this.recordSuccess();
         this.log('All nav menus pushed.');
+        return { path, status: 'success' };
     }
     async currentRevision(slug) {
         try {

package/dist/commands/meta/diff.d.ts

@@ -0,0 +1,2 @@
+declare const _default: typeof import("../../lib/diff-command.js").DiffCommand;
+export default _default;

package/dist/commands/meta/diff.js

@@ -0,0 +1,5 @@
+import { resourceDiffCommand } from '../../lib/diff-command.js';
+export default resourceDiffCommand('meta', {
+    description: 'Show what differs in post meta keys between your local meta/ files and a WordPress environment, or between two environments',
+    pathNoun: 'meta directory',
+});

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

@@ -0,0 +1,19 @@
+import { LoopressCommand } from '../../lib/base.js';
+type RegisteredMetaKey = {
+    acf: boolean;
+    conflict: boolean;
+    key: string;
+    managed: boolean;
+    postType: string;
+    showInRest: boolean;
+    single: boolean;
+    source: 'loopress' | 'other';
+    type: string;
+};
+export default class MetaList extends LoopressCommand {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<RegisteredMetaKey[]>;
+}
+export {};

package/dist/commands/meta/list.js

@@ -0,0 +1,21 @@
+import { LoopressCommand } from '../../lib/base.js';
+import { META_SPEC } from '../../utils/declared-type-format.js';
+export default class MetaList extends LoopressCommand {
+    static description = 'List the meta keys registered for each post type on WordPress (with register_post_meta()), and whether Loopress declares them. ' +
+        'Only Loopress ones are pulled and pushed.';
+    static enableJsonFlag = true;
+    static examples = ['$ lps meta list'];
+    async run() {
+        const keys = await this.wp.get(META_SPEC.registeredEndpoint);
+        for (const meta of keys) {
+            const source = meta.source === 'loopress' ? 'Loopress' : 'theme or plugin';
+            const rest = meta.showInRest ? ', in REST' : '';
+            const acf = meta.acf ? ', same name as an ACF field' : '';
+            this.log(`${meta.postType}.${meta.key} (${meta.type}): ${source}${rest}${acf}`);
+            if (meta.conflict) {
+                this.warn(`${meta.postType}.${meta.key}: declared in meta/ but already registered by a theme or plugin, the Loopress version is skipped`);
+            }
+        }
+        return keys;
+    }
+}

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

@@ -0,0 +1,2 @@
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/declared-type-command.js").DeclaredPullCommand>;
+export default _default;

package/dist/commands/meta/pull.js

@@ -0,0 +1,4 @@
+import { declaredPullCommand } from '../../lib/declared-type-command.js';
+import { META_SPEC } from '../../utils/declared-type-format.js';
+export default declaredPullCommand(META_SPEC, 'Pull the post meta keys Loopress manages on WordPress into meta/<post-type>.json files, never their values. ' +
+    'Keys registered by a theme or another plugin are never pulled, see `lps meta list`.');

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

@@ -0,0 +1,2 @@
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/declared-type-command.js").DeclaredPushCommand>;
+export default _default;

package/dist/commands/meta/push.js

@@ -0,0 +1,4 @@
+import { declaredPushCommand } from '../../lib/declared-type-command.js';
+import { META_SPEC } from '../../utils/declared-type-format.js';
+export default declaredPushCommand(META_SPEC, 'Push local post meta keys (meta/<post-type>.json, each key mapped to its register_post_meta() arguments) to WordPress. ' +
+    'Create or update only, never deletes (use `lps meta rm`), never touches meta values.');

package/dist/commands/meta/rm.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/declared-type-command.js").DeclaredRmCommand>;
+export default _default;