@loopress/cli 0.27.0 → 0.29.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/pull.js

@@ -2,9 +2,9 @@ import { confirm } from '@inquirer/prompts';
 import { Args } from '@oclif/core';
 import { Buffer } from 'node:buffer';
 import { existsSync } from 'node:fs';
-import { mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
-import { APP_CONFIG_FILENAME } from '../../lib/app-manifest.js';
+import { APP_CONFIG_FILENAME, parseAppConfig } from '../../lib/app-manifest.js';
 import { LoopressCommand } from '../../lib/base.js';
 import { isInteractive } from '../../lib/interactive.js';
 import { pluralize } from '../../utils/pluralize.js';
@@ -60,14 +60,27 @@ export default class Pull extends LoopressCommand {
     }
     async pullApp(path, name) {
         const manifest = await this.wp.get(`loopress/v1/apps/${name}/manifest`);
-        const distDir = join(path, name, 'dist');
+        const appDir = join(path, name);
+        const configPath = join(appDir, APP_CONFIG_FILENAME);
+        // WordPress doesn't know where the app builds to (assetsDir) or whether its entry is explicit:
+        // keep what the local config says, only refresh what the server is the source of truth for.
+        const local = existsSync(configPath) ? parseAppConfig(await readFile(configPath, 'utf8'), appDir) : {};
+        const assetsDir = local.assetsDir ?? 'dist';
+        const distDir = join(appDir, assetsDir);
         for (const file of manifest.files) {
             const { content } = await this.wp.get(`loopress/v1/apps/${name}/asset?path=${encodeURIComponent(file.path)}`);
             const target = join(distDir, file.path);
             await mkdir(dirname(target), { recursive: true });
             await writeFile(target, Buffer.from(content, 'base64'));
         }
-        await writeFile(join(path, name, APP_CONFIG_FILENAME), JSON.stringify({ assetsDir: 'dist', mountSelector: manifest.mountSelector, name: manifest.name, routing: manifest.routing }, null, 2) + '\n');
+        await writeFile(configPath, JSON.stringify({
+            ...local,
+            assetsDir,
+            crossOrigin: manifest.crossOrigin ?? undefined, // dropped by JSON.stringify when unset
+            mountSelector: manifest.mountSelector,
+            name: manifest.name,
+            routing: manifest.routing,
+        }, null, 2) + '\n');
         this.log(`  ${name}: ${pluralize(manifest.files.length, 'file')} (build ${manifest.buildId})`);
         return { files: manifest.files.length, name };
     }

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

@@ -18,11 +18,14 @@ export default class Push extends PushCommand {
     static flags: {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        build: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    private build;
     run(): Promise<PushResult>;
     private appDirNames;
     private pushApp;
     private remoteFiles;
     private uploadAsset;
+    private warnIfCrossOriginIgnored;
 }
 export {};

package/dist/commands/app/push.js

@@ -1,7 +1,8 @@
-import { Args } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import { existsSync } from 'node:fs';
 import { readdir, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { buildApp } from '../../lib/app-build.js';
 import { APP_CONFIG_FILENAME, diffFiles, loadAppManifest, } from '../../lib/app-manifest.js';
 import { PushCommand } from '../../lib/push-command.js';
 import { isNotFoundError } from '../../lib/wp-client.js';
@@ -10,15 +11,22 @@ export default class Push extends PushCommand {
     static args = {
         name: Args.string({ description: 'Push only this app (defaults to every app in the directory)' }),
     };
-    static description = 'Push built single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a built dist/ folder. Only files whose content changed are uploaded.';
+    static description = 'Build and push single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a dist/ folder. When the app has a package.json with a `build` script, it runs first (use --no-build to skip it). Only files whose content changed are uploaded.';
     static enableJsonFlag = true;
-    static examples = ['$ lps app push', '$ lps app push search'];
+    static examples = ['$ lps app push', '$ lps app push search', '$ lps app push --no-build'];
     static flags = {
+        build: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: "Run the app's package.json build script before pushing",
+        }),
         ...PushCommand.dryRunFlag,
         ...PushCommand.yesFlag,
     };
+    build = true;
     async run() {
-        const { args } = await this.parse(Push);
+        const { args, flags } = await this.parse(Push);
+        this.build = flags.build;
         const { url } = this.siteConfig;
         const path = this.resolveAppsPath();
         this.log(`Pushing apps to ${url}`);
@@ -55,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)}).`);
@@ -71,6 +79,13 @@ export default class Push extends PushCommand {
         let manifest;
         let distDir;
         try {
+            // Built on dry runs too: the preview diffs dist/, so a stale one would make it lie.
+            if (this.build) {
+                await buildApp(appDir, (command) => {
+                    if (task)
+                        task.output = `${dirName}: building (${command})`;
+                });
+            }
             ;
             ({ distDir, manifest } = await loadAppManifest(appDir, dirName));
         }
@@ -93,12 +108,14 @@ export default class Push extends PushCommand {
                 task.output = `${manifest.name}: uploading ${file.path} (${index + 1}/${changed.length})`;
             await this.uploadAsset(manifest.name, distDir, file);
         }
+        let committed;
         try {
-            await this.wp.post(`loopress/v1/apps/${manifest.name}/commit`, manifest);
+            committed = await this.wp.post(`loopress/v1/apps/${manifest.name}/commit`, manifest);
         }
         catch (error) {
             this.reportTaskFailure(`${manifest.name}: commit failed: ${error.message}`, error, task);
         }
+        this.warnIfCrossOriginIgnored(manifest, committed);
         if (task) {
             task.output =
                 changed.length === 0
@@ -127,4 +144,11 @@ export default class Push extends PushCommand {
             this.reportTaskFailure(`${name}: failed to upload ${file.path}: ${error.message}`, error);
         }
     }
+    // An older plugin, or an app .htaccess the site owner manages, commits the build without the
+    // policy: say so rather than let the app look protected when it is not.
+    warnIfCrossOriginIgnored(manifest, committed) {
+        if (manifest.crossOrigin && committed?.crossOrigin !== manifest.crossOrigin) {
+            this.warn(`${manifest.name}: crossOrigin "${manifest.crossOrigin}" was not applied: either the Loopress plugin on this site is too old (update it, then push again) or wp-content/loopress/apps/${manifest.name}/.htaccess is managed by hand and was left untouched.`);
+        }
+    }
 }

package/dist/commands/composer/push.js

@@ -3,27 +3,9 @@ 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 { isLocalEnvironment, isTimeoutError } from '../../lib/wp-client.js';
+import { requireToInstall, toIntent } from '../../utils/composer.js';
 import { parseCollisions, SYNC_TIMEOUT_MS, } from '../../utils/plugin-sync.js';
-// Split a composer.json `require` map into the three intent namespaces the sync endpoint
-// understands. `composer/installers` is owned by the server scaffold, never sent.
-function toIntent(require) {
-    const intent = { libraries: {}, plugins: {}, themes: {} };
-    for (const [name, constraint] of Object.entries(require)) {
-        if (name === 'composer/installers')
-            continue;
-        if (name.startsWith('wpackagist-plugin/')) {
-            intent.plugins[name.slice('wpackagist-plugin/'.length)] = constraint;
-        }
-        else if (name.startsWith('wpackagist-theme/')) {
-            intent.themes[name.slice('wpackagist-theme/'.length)] = constraint;
-        }
-        else {
-            intent.libraries[name] = constraint;
-        }
-    }
-    return intent;
-}
 export default class ComposerPush extends PushCommand {
     static description = 'Push composer.json to WordPress and run Composer to resolve and install dependencies';
     static enableJsonFlag = true;
@@ -43,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/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, 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, SEO, 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/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,17 +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' },
-];
 export default class Init extends Command {
     static description = 'Initialize a loopress.json config file in the current directory';
     static examples = ['$ lps init'];
@@ -46,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;
@@ -81,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/option/pull.js

@@ -56,19 +56,19 @@ export default class Pull extends LoopressCommand {
     }
     // Returns the refreshed option (and writes it to disk), or null when the tracked name is a
     // 404 on this environment: absent, not a failure (see the orphan reconciliation in run()).
-    // readonly is a local policy flag with no WordPress counterpart, always preserved from the
-    // existing file rather than overwritten by the pulled value.
+    // readonly and refs are local declarations with no WordPress counterpart, always preserved
+    // from the existing file rather than overwritten by the pulled value.
     async pullOption(dir, option) {
         let remote;
         try {
-            remote = await this.wp.get(optionEndpoint(option.name));
+            remote = await this.wp.get(optionEndpoint(option.name, option.refs));
         }
         catch (error) {
             if (isNotFoundError(error))
                 return null;
             throw error;
         }
-        const local = { ...remote, readonly: option.readonly };
+        const local = { ...remote, readonly: option.readonly, refs: option.refs };
         await writeFile(join(dir, optionFileName(option.name)), JSON.stringify(local, null, 2) + '\n');
         return local;
     }

package/dist/commands/option/push.js

@@ -78,6 +78,8 @@ export default class Push extends PushCommand {
             // create): falls back to today's unconditional write, same as before this existed.
             const expectedRevision = await this.currentRevision(option.name);
             const body = { autoload: option.autoload, value: option.value };
+            if (option.refs)
+                body.refs = option.refs;
             if (expectedRevision !== undefined)
                 body.expectedRevision = expectedRevision;
             await this.wp.put(optionEndpoint(option.name), body);

package/dist/commands/page/push.js

@@ -1,5 +1,6 @@
 import { Args } from '@oclif/core';
 import { PushCommand } from '../../lib/push-command.js';
+import { getResourceStateProvider } from '../../lib/resource-state.js';
 import { formatPageProblems, frontPageNote, PAGES_ENDPOINT, readLocalPages } from '../../utils/page-format.js';
 import { pluralize } from '../../utils/pluralize.js';
 import { resolveResourceDir } from '../../utils/resource-dirs.js';
@@ -28,6 +29,8 @@ export default class Push extends PushCommand {
             this.error(`No page "${args.slug}" in ${path} (expected ${args.slug}.html).`);
         }
         this.log(`Found ${pluralize(selected.length, 'page')} to push`);
+        if (this.dryRun)
+            await this.previewRemote(getResourceStateProvider('page'), path);
         const pushed = [];
         await this.runPushTasks(selected, (page) => page.slug, async (page, task) => {
             await this.pushPage(page, task);

package/dist/commands/plugin/add.js

@@ -1,5 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import { LoopressCommand } from '../../lib/base.js';
+import { pinVersion } from '../../types/plugin.js';
 import { writeLocalConfig } from '../../utils/loopress-config.js';
 import { isExactVersion } from '../../utils/version.js';
 export default class Add extends LoopressCommand {
@@ -25,18 +26,20 @@ export default class Add extends LoopressCommand {
             this.error(`--version must be an exact version like 9.4.2, not a Composer constraint. Got "${version}".`);
         }
         const existing = this.localConfig.plugins ?? {};
-        if (existing[slug] === version) {
+        const current = existing[slug];
+        if (current !== undefined && pinVersion(current) === version) {
             this.log(`${slug} is already pinned to ${version} in loopress.json, nothing to do.`);
             return { slug, status: 'unchanged', version };
         }
-        const isUpdated = existing[slug] !== undefined;
+        const isUpdated = current !== undefined;
         if (this.dryRun) {
             this.log(`[dry-run] Would ${isUpdated ? 'update' : 'add'} ${slug} (${version}) in loopress.json`);
             return { slug, status: 'dry-run', version };
         }
         await writeLocalConfig({
             ...this.localConfig,
-            plugins: { ...existing, [slug]: version },
+            // Re-pinning a plugin recorded as inactive keeps it inactive.
+            plugins: { ...existing, [slug]: typeof current === 'object' ? { ...current, version } : version },
         });
         this.log(`${isUpdated ? 'Updated' : 'Added'} ${slug} (${version}). Run \`lps plugin push\` to apply.`);
         return { slug, status: isUpdated ? 'updated' : 'added', version };