@loopress/cli 0.31.0 → 0.32.1

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

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

package/dist/commands/acf/diff.js

@@ -1,5 +1,7 @@
 import { resourceDiffCommand } from '../../lib/diff-command.js';
-export default resourceDiffCommand('acf', {
+const Command = resourceDiffCommand('acf', {
     description: 'Show what differs in ACF field groups, post types, taxonomies, and options pages between your local files and a WordPress environment, or between two environments',
     pathNoun: 'ACF directory',
 });
+Command.aliases = ['scf:diff'];
+export default Command;

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

@@ -1,5 +1,6 @@
 import { LoopressCommand } from '../../lib/base.js';
 export default class List extends LoopressCommand {
+    static aliases: string[];
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];

package/dist/commands/acf/list.js

@@ -2,7 +2,8 @@ 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 aliases = ['scf:list'];
+    static description = 'List ACF field groups, post types, taxonomies, and options pages currently on WordPress';
     static enableJsonFlag = true;
     static examples = ['$ lps acf list', '$ lps acf list --type field-groups'];
     static flags = {

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

@@ -6,6 +6,7 @@ type AcfPullResult = {
     types: AcfObjectType[];
 };
 export default class Pull extends LoopressCommand {
+    static aliases: string[];
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };

package/dist/commands/acf/pull.js

@@ -5,10 +5,11 @@ import { LoopressCommand } from '../../lib/base.js';
 import { basenameKey, findOrphanedFiles } from '../../lib/find-orphaned-files.js';
 import { ACF_OBJECT_TYPES, acfEndpoint, getAcfKey } from '../../utils/acf-format.js';
 export default class Pull extends LoopressCommand {
+    static aliases = ['scf:pull'];
     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 description = 'Pull ACF field groups, post types, taxonomies, and options pages from WordPress into local files';
     static enableJsonFlag = true;
     static examples = ['$ lps acf pull', '$ lps acf pull --type field-groups'];
     static flags = {

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

@@ -1,11 +1,16 @@
-import { PushCommand } from '../../lib/push-command.js';
-import { type AcfObjectType } from '../../utils/acf-format.js';
+import { type PushChange, PushCommand } from '../../lib/push-command.js';
+import { acfFieldChanges, type AcfObjectType } from '../../utils/acf-format.js';
+type AcfChange = PushChange & {
+    fields?: ReturnType<typeof acfFieldChanges>;
+};
 type AcfPushResult = {
+    changes?: AcfChange[];
     path: string;
     status: 'dry-run' | 'success';
     types: AcfObjectType[];
 };
 export default class Push extends PushCommand {
+    static aliases: string[];
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };

package/dist/commands/acf/push.js

@@ -4,13 +4,14 @@ import { loadFiles } from '../../lib/load-files.js';
 import { PushCommand } from '../../lib/push-command.js';
 import { getResourceStateProvider } from '../../lib/resource-state.js';
 import { isNotFoundError } from '../../lib/wp-client.js';
-import { ACF_OBJECT_TYPES, acfEndpoint, acfObjectEndpoint, getAcfKey } from '../../utils/acf-format.js';
+import { ACF_OBJECT_TYPES, acfEndpoint, acfFieldChanges, acfObjectEndpoint, getAcfKey } from '../../utils/acf-format.js';
 import { pluralize } from '../../utils/pluralize.js';
 export default class Push extends PushCommand {
+    static aliases = ['scf:push'];
     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 description = 'Push local 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 = {
@@ -35,8 +36,15 @@ export default class Push extends PushCommand {
         if (this.failedCount > 0) {
             this.error(`${pluralize(this.failedCount, 'ACF object')} failed to push.`);
         }
-        if (this.dryRun)
-            return { path, status: 'dry-run', types };
+        if (this.dryRun) {
+            const states = this.previewStates;
+            const changes = this.previewChanges.map((change) => {
+                if (!states || change.status !== 'changed' || !change.id.startsWith('field-groups/'))
+                    return change;
+                return { ...change, fields: acfFieldChanges(states.remote.get(change.id), states.local.get(change.id)) };
+            });
+            return { changes, path, status: 'dry-run', types };
+        }
         await this.recordSuccess();
         this.log('All ACF objects pushed.');
         return { path, status: 'success', types };

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

@@ -1,2 +1,2 @@
-declare const _default: typeof import("../../lib/base.js").LoopressCommand;
-export default _default;
+declare const Command: typeof import("../../lib/base.js").LoopressCommand;
+export default Command;

package/dist/commands/acf/rollback.js

@@ -1,5 +1,7 @@
 import { resourceRollbackCommand } from '../../lib/rollback-command.js';
-export default resourceRollbackCommand('acf', {
+const Command = resourceRollbackCommand('acf', {
     description: 'Restore ACF field groups, post types, taxonomies, and options pages to a snapshot taken automatically before an earlier `lps acf push`',
     pathNoun: 'ACF directory',
 });
+Command.aliases = ['scf:rollback'];
+export default Command;

package/dist/commands/composer/pull.js

@@ -10,7 +10,7 @@ function isMissingComposerLock(error) {
     return isApplicative404(error, 'composer.lock not found');
 }
 export default class ComposerPull extends LoopressCommand {
-    static description = 'Pull composer.json and composer.lock from WordPress';
+    static description = 'Pull composer.json and composer.lock from WordPress into local files';
     static enableJsonFlag = true;
     static examples = ['$ lps composer pull', '$ lps composer pull --dry-run'];
     static flags = {

package/dist/commands/diff.d.ts

@@ -9,5 +9,6 @@ export default class Diff extends DiffCommand {
         against: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<DiffJson>;
+    private projectUses;
     private selectResources;
 }

package/dist/commands/diff.js

@@ -1,13 +1,15 @@
 import { Flags } from '@oclif/core';
 import { DiffCommand } from '../lib/diff-command.js';
 import { RESOURCE_STATE_PROVIDERS } from '../lib/resource-state.js';
+import { projectUses, resolveResourceDir } from '../utils/resource-dirs.js';
+import { globalStylesFiles } from '../utils/theme-styles-format.js';
 // Everything `lps diff` can compare, in report order. Composer isn't a directory-backed
 // provider (see resource-state.ts) so it's named here explicitly.
 const RESOURCES = [...RESOURCE_STATE_PROVIDERS.map((provider) => provider.resource), 'composer'];
 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, 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, menus, custom post types, taxonomies, post meta, roles, block patterns, options, 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;
@@ -27,12 +29,21 @@ export default class Diff extends DiffCommand {
         const { flags } = await this.parse(Diff);
         const sides = this.resolveSides(flags.against);
         const selected = this.selectResources(flags.only, flags.skip);
+        const providers = RESOURCE_STATE_PROVIDERS.filter((provider) => selected.has(provider.resource));
         const targets = [
-            ...RESOURCE_STATE_PROVIDERS.filter((provider) => selected.has(provider.resource)).map((provider) => this.providerTarget(provider, sides)),
+            ...(await Promise.all(providers.map(async (provider) => ({ ...this.providerTarget(provider, sides), optional: !(await this.projectUses(provider)) })))),
             ...(selected.has('composer') ? [this.composerTarget(sides)] : []),
         ];
         return this.report(targets, sides);
     }
+    // Tells apart a resource the project doesn't use from one it does, for the ones a site can lack:
+    // a plugin-backed resource without its directory, Global Styles without a tracked file.
+    async projectUses(provider) {
+        if (provider.dirKind === 'themeStyles') {
+            return (await globalStylesFiles(resolveResourceDir('themeStyles', this.localConfig))).length > 0;
+        }
+        return projectUses(provider.dirKind, this.localConfig);
+    }
     // `--only` narrows the default set, `--skip` then removes from whatever that set is, same
     // precedence a combined `--only=a,b --skip=b` reads as (mirrors dev-watch's resolveResourceTypes).
     selectResources(only, skip) {

package/dist/commands/doctor.js

@@ -6,7 +6,7 @@ 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 {
-    static description = 'Diagnose connectivity, plugin and credential problems for the targeted environment';
+    static description = 'Diagnose connectivity, plugin, credential and hook problems for the targeted environment';
     static enableJsonFlag = true;
     static examples = ['$ lps doctor', '$ lps doctor --env production'];
     checks = [];

package/dist/commands/form/list.js

@@ -1,7 +1,7 @@
 import { LoopressCommand } from '../../lib/base.js';
 import { FORM_ENDPOINT, getFormId, getFormTitle } from '../../utils/form-format.js';
 export default class List extends LoopressCommand {
-    static description = 'List forms from WordPress';
+    static description = 'List forms currently on WordPress';
     static enableJsonFlag = true;
     static examples = ['$ lps form list'];
     async run() {

package/dist/commands/form/pull.js

@@ -10,7 +10,7 @@ export default class Pull extends LoopressCommand {
     static args = {
         path: Args.string({ description: 'Path to forms directory (overrides project config)' }),
     };
-    static description = 'Pull forms from WordPress';
+    static description = 'Pull forms from WordPress into local files';
     static enableJsonFlag = true;
     static examples = ['$ lps form pull'];
     static flags = {

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

@@ -1,5 +1,6 @@
-import { PushCommand } from '../../lib/push-command.js';
+import { type PushChange, PushCommand } from '../../lib/push-command.js';
 type FormPushResult = {
+    changes?: PushChange[];
     path: string;
     status: 'dry-run' | 'success';
 };

package/dist/commands/form/push.js

@@ -13,7 +13,7 @@ export default class Push extends PushCommand {
     static args = {
         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 description = 'Push local form files 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 = {
@@ -42,7 +42,7 @@ export default class Push extends PushCommand {
             this.error(`${pluralize(this.failedCount, 'form')} failed to push.`);
         }
         if (this.dryRun)
-            return { path, status: 'dry-run' };
+            return { changes: this.previewChanges, path, status: 'dry-run' };
         await this.recordSuccess();
         this.log('All forms pushed.');
         return { path, status: 'success' };

package/dist/commands/init.js

@@ -5,12 +5,6 @@ import { join } from 'node:path';
 import { configManager } from '../config/project-config.manager.js';
 import { isInteractive } from '../lib/interactive.js';
 import { ensureLfGitattributes, writeLocalConfig } from '../utils/loopress-config.js';
-// WordPress.org slugs for the two snippet plugins the Loopress WordPress plugin supports
-// (see SnippetModule.php, which wires up both providers and auto-detects the active one).
-const SNIPPET_PROVIDERS = [
-    { name: 'Code Snippets', slug: 'code-snippets' },
-    { name: 'WPCode', slug: 'insert-headers-and-footers' },
-];
 export default class Init extends Command {
     static description = 'Initialize a loopress.json config file in the current directory';
     static examples = ['$ lps init'];
@@ -35,31 +29,14 @@ export default class Init extends Command {
             default: '.',
             message: 'Root directory',
         });
-        const providerChoice = await select({
-            choices: [...SNIPPET_PROVIDERS.map((p) => ({ name: p.name, value: p.slug })), { name: 'None / already installed', value: '__none__' }],
-            message: 'Snippet provider',
-        });
         // 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;
-        if (providerChoice !== '__none__') {
-            try {
-                await this.config.runCommand('plugin:add', [providerChoice]);
-                isProviderAdded = true;
-            }
-            catch (error) {
-                this.warn(error.message);
-            }
-        }
         this.log(`\n✓ loopress.json created`);
         this.log(`  Project:  ${projectLabel}`);
         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');
         }

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

@@ -1,5 +1,6 @@
-import { PushCommand } from '../../lib/push-command.js';
+import { type PushChange, PushCommand } from '../../lib/push-command.js';
 type MenuPushResult = {
+    changes?: PushChange[];
     path: string;
     status: 'dry-run' | 'success';
 };

package/dist/commands/menu/push.js

@@ -36,7 +36,7 @@ export default class Push extends PushCommand {
             this.error(`${pluralize(this.failedCount, 'menu')} failed to push.`);
         }
         if (this.dryRun)
-            return { path, status: 'dry-run' };
+            return { changes: this.previewChanges, path, status: 'dry-run' };
         await this.recordSuccess();
         this.log('All nav menus pushed.');
         return { path, status: 'success' };

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

@@ -1,5 +1,6 @@
-import { PushCommand } from '../../lib/push-command.js';
+import { type PushChange, PushCommand } from '../../lib/push-command.js';
 type PushResult = {
+    changes?: PushChange[];
     pushed: string[];
     skipped: string[];
     status: 'dry-run' | 'success';

package/dist/commands/option/push.js

@@ -50,7 +50,7 @@ export default class Push extends PushCommand {
         }
         const skippedNames = skipped.map((option) => option.name);
         if (this.dryRun)
-            return { pushed, skipped: skippedNames, status: 'dry-run' };
+            return { changes: this.previewChanges, pushed, skipped: skippedNames, status: 'dry-run' };
         await this.recordSuccess();
         this.log('All options pushed.');
         return { pushed, skipped: skippedNames, status: 'success' };

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

@@ -1,5 +1,6 @@
-import { PushCommand } from '../../lib/push-command.js';
+import { type PushChange, PushCommand } from '../../lib/push-command.js';
 type PushResult = {
+    changes?: PushChange[];
     pushed: string[];
     status: 'dry-run' | 'success';
 };
@@ -14,7 +15,9 @@ export default class Push extends PushCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    private readonly unmanaged;
     run(): Promise<PushResult>;
+    private adoptUnmanaged;
     private pushPage;
 }
 export {};

package/dist/commands/page/push.js

@@ -1,6 +1,9 @@
+import { confirm } from '@inquirer/prompts';
 import { Args } from '@oclif/core';
+import { isInteractive } from '../../lib/interactive.js';
 import { PushCommand } from '../../lib/push-command.js';
 import { getResourceStateProvider } from '../../lib/resource-state.js';
+import { isConflictCode } from '../../lib/wp-client.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';
@@ -8,13 +11,15 @@ export default class Push extends PushCommand {
     static args = {
         slug: Args.string({ description: 'Push only this page (its file name without .html). Pushes every page when omitted.' }),
     };
-    static description = 'Push static HTML pages (pages/<slug>.html) to WordPress. The `status` header (draft or publish, draft by default) is applied on every push.';
+    static description = 'Push local static HTML pages (pages/<slug>.html) to WordPress, or only one when a slug is given. The `status` header (draft or publish, draft by default) is applied on every push.';
     static enableJsonFlag = true;
-    static examples = ['$ lps page push', '$ lps page push legal-notice', '$ lps page push --dry-run'];
+    static examples = ['$ lps page push', '$ lps page push legal-notice', '$ lps page push --dry-run', '$ lps page push about --overwrite'];
     static flags = {
         ...PushCommand.dryRunFlag,
         ...PushCommand.yesFlag,
     };
+    // Pages the site refused because a same-slug page exists there that Loopress didn't create.
+    unmanaged = [];
     async run() {
         const { args } = await this.parse(Push);
         const path = resolveResourceDir('page', this.localConfig);
@@ -33,31 +38,58 @@ export default class Push extends PushCommand {
         const beforeState = await this.captureBeforePushState(provider, path, args.slug === undefined ? undefined : (id) => id === args.slug);
         const pushed = [];
         await this.runPushTasks(selected, (page) => page.slug, async (page, task) => {
-            await this.pushPage(page, task);
-            pushed.push(page.slug);
+            if (await this.pushPage(page, task))
+                pushed.push(page.slug);
         });
+        await this.adoptUnmanaged(pushed);
         await this.writeAfterPushSnapshot(provider, path, beforeState);
         if (this.failedCount > 0) {
             this.error(`${pluralize(this.failedCount, 'page')} failed to push.`);
         }
         if (this.dryRun)
-            return { pushed, status: 'dry-run' };
+            return { changes: this.previewChanges, pushed, status: 'dry-run' };
         await this.recordSuccess();
         this.log('All pages pushed.');
         return { pushed, status: 'success' };
     }
-    async pushPage(page, task) {
+    // One prompt for every page the first pass set aside, then a second pass that takes them over.
+    // Without a terminal to ask in, they count as failed: CI must opt in with --overwrite.
+    async adoptUnmanaged(pushed) {
+        if (this.unmanaged.length === 0)
+            return;
+        const slugs = this.unmanaged.map((page) => page.slug);
+        this.warn(`Already on ${this.siteConfig.url} but not created by Loopress: ${slugs.join(', ')}. ` +
+            'Taking them over keeps their URL and ID, and shows your file instead of their current content (saved as a WordPress revision first). ' +
+            'Pass --overwrite to take them over.');
+        if (!isInteractive() || !(await confirm({ default: false, message: `Take over ${pluralize(slugs.length, 'page')}?` }))) {
+            this.failedCount += slugs.length;
+            return;
+        }
+        await this.runPushTasks(this.unmanaged, (page) => page.slug, async (page, task) => {
+            if (await this.pushPage(page, task, true))
+                pushed.push(page.slug);
+        });
+    }
+    // Resolves false when the page was set aside for adoptUnmanaged instead of pushed.
+    async pushPage(page, task, adopt = this.overwrite) {
         if (this.dryRun) {
             if (task)
                 task.output = `[dry-run] Would push: ${page.slug} (${page.status})`;
-            return;
+            return true;
         }
         try {
-            const result = await this.wp.put(PAGES_ENDPOINT, page);
+            const result = await this.wp.put(PAGES_ENDPOINT, adopt ? { ...page, adopt } : page);
             if (task)
                 task.output = `Pushed: ${page.slug} (${result.status}) ${result.link}${frontPageNote(result)}`;
+            return true;
         }
         catch (error) {
+            if (!adopt && isConflictCode(error, 'loopress_page_not_managed')) {
+                this.unmanaged.push(page);
+                // skip(): Listr's own "skipped" mark, not the green check of a page that was pushed.
+                task?.skip?.(`${page.slug} already exists on the site, not created by Loopress`);
+                return false;
+            }
             this.reportTaskFailure(`Failed to push ${page.slug}: ${error.message}`, error, task);
         }
     }

package/dist/commands/pattern/push.js

@@ -1,4 +1,4 @@
 import { declaredPushCommand } from '../../lib/declared-type-command.js';
 import { PATTERN_SPEC } from '../../utils/declared-type-format.js';
 export default declaredPushCommand(PATTERN_SPEC, 'Push local block patterns (patterns/<slug>.html, block markup under a title/categories header) to WordPress, ' +
-    'registered as loopress/<slug>. Create or update only, never deletes a pattern (use `lps pattern rm`).');
+    'registered as loopress/<slug> and referenced with <!-- wp:pattern {"slug":"loopress/<slug>"} /-->. Create or update only, never deletes a pattern (use `lps pattern rm`).');

package/dist/commands/pattern/rm.js

@@ -1,3 +1,3 @@
 import { declaredRmCommand } from '../../lib/declared-type-command.js';
 import { PATTERN_SPEC } from '../../utils/declared-type-format.js';
-export default declaredRmCommand(PATTERN_SPEC, 'Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already inserted in posts stay.', 'A wp:pattern reference to it renders nothing until it is pushed again, copies already inserted in posts stay.');
+export default declaredRmCommand(PATTERN_SPEC, 'Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing until it is pushed again, copies already inserted in posts stay.', 'A wp:pattern reference to it renders nothing until it is pushed again, copies already inserted in posts stay.');

package/dist/commands/plugin/audit.js

@@ -6,7 +6,7 @@ import { compareVersions } from '../../utils/version.js';
 const WPVULN_BASE = 'https://www.wpvulnerability.net/plugin';
 const WPORG_INFO = 'https://api.wordpress.org/plugins/info/1.2/';
 export default class Audit extends LoopressCommand {
-    static description = 'Check the plugins in loopress.json for known vulnerabilities and health issues';
+    static description = 'Check the plugins in loopress.json for known vulnerabilities (wpvulnerability.net) and health issues';
     static enableJsonFlag = true;
     static examples = ['$ lps plugin audit'];
     static flags = {};

package/dist/commands/plugin/push.js

@@ -20,7 +20,7 @@ const IN_SYNC = {
     status: 'in-sync',
 };
 export default class Push extends PushCommand {
-    static description = 'Install plugins on WordPress to match loopress.json (or composer.json), via Composer + WPackagist';
+    static description = 'Install WordPress.org plugins on WordPress to match loopress.json (active state included) or composer.json, via Composer + WPackagist';
     static enableJsonFlag = true;
     static examples = ['$ lps plugin push', '$ lps plugin push --dry-run', '$ lps plugin push --force --prune'];
     static flags = {

package/dist/commands/plugin/status.js

@@ -4,7 +4,7 @@ import { LoopressCommand } from '../../lib/base.js';
 import { isNotFoundError } from '../../lib/wp-client.js';
 import { diffPlugins, lockedWpackagistSlugs, parseInstalledPlugins } from '../../utils/plugins.js';
 export default class Status extends LoopressCommand {
-    static description = 'Compare the plugins on WordPress against loopress.json and report drift';
+    static description = 'Compare the plugins on WordPress against loopress.json and report drift (missing, wrong version, inactive, untracked)';
     static enableJsonFlag = true;
     static examples = ['$ lps plugin status'];
     static flags = {};

package/dist/commands/pull.d.ts

@@ -18,6 +18,6 @@ export default class Pull extends LoopressCommand {
     private failedCount;
     run(): Promise<PullResult>;
     private buildArgv;
-    private usesResource;
+    private globalStylesSkipNote;
 }
 export {};

package/dist/commands/pull.js

@@ -1,12 +1,9 @@
-import { existsSync } from 'node:fs';
-import { resolve } from 'node:path';
 import { LoopressCommand } from '../lib/base.js';
 import { stdoutToStderr } from '../lib/json-delegation.js';
+import { INTEGRATION_MISSING } from '../lib/plugin-detection.js';
 import { pluralize } from '../utils/pluralize.js';
-import { resolveResourceDir } from '../utils/resource-dirs.js';
-// How the plugin reports its integration missing: "ACF is not active", "No supported form
-// plugin is active", "No supported snippet plugin is active".
-const PLUGIN_MISSING = /\bis not active\b|\bNo supported .+ plugin is active\b/;
+import { projectUses, resolveResourceDir } from '../utils/resource-dirs.js';
+import { globalStylesSkipNote } from '../utils/theme-styles-format.js';
 // composer before plugins: when a composer.json exists, `plugin:pull` merges the live plugins
 // into it, so it must run on the freshly pulled one or `composer:pull` would overwrite its work. The rest write to independent
 // directories and their order does not matter, it mirrors `lps push` for familiarity.
@@ -22,12 +19,15 @@ const PULL_TARGETS = [
     { commandId: 'hook:pull', label: 'hooks', supportsYes: true },
     { commandId: 'form:pull', label: 'forms', needsPlugin: 'form', supportsYes: true },
     { commandId: 'pattern:pull', label: 'patterns', supportsYes: true },
+    // Templates and parts have no pull. Global Styles are pulled only once the project tracks them,
+    // see globalStylesSkipNote.
+    { commandId: 'theme:style:pull', label: 'Global Styles' },
     { commandId: 'menu:pull', label: 'menus', supportsYes: true },
     { commandId: 'option:pull', label: 'options', supportsYes: true },
     { commandId: 'snippet:pull', label: 'snippets', needsPlugin: 'snippets', supportsYes: true },
 ];
 export default class Pull extends LoopressCommand {
-    static description = 'Pull all content, plugins, composer dependencies, post types, taxonomies, post meta, roles, ACF, API routes, hooks, forms, patterns, menus, options, and snippets, from WordPress';
+    static description = 'Pull every tracked resource from WordPress into local files in one run: composer dependencies, plugins, post types, taxonomies, post meta, roles, ACF, API routes, hooks, forms, patterns, Global Styles, menus, options, and snippets';
     static enableJsonFlag = true;
     static examples = ['$ lps pull', '$ lps pull --env staging', '$ lps pull --dry-run'];
     static flags = {
@@ -39,6 +39,12 @@ export default class Pull extends LoopressCommand {
         const results = [];
         this.warnRemovedSeoModule();
         for (const target of PULL_TARGETS) {
+            const skipNote = target.commandId === 'theme:style:pull' ? await this.globalStylesSkipNote() : undefined;
+            if (skipNote) {
+                this.log(`\n→ ${target.label}: ${skipNote}`);
+                results.push({ label: target.label, status: 'skipped' });
+                continue;
+            }
             this.log(`\n→ Pulling ${target.label}...`);
             try {
                 await stdoutToStderr(this.jsonEnabled(), async () => this.config.runCommand(target.commandId, this.buildArgv(target)));
@@ -50,7 +56,7 @@ export default class Pull extends LoopressCommand {
                 // A site without ACF (or a form or snippet plugin) is the common case, not a failure,
                 // as long as the project doesn't use that resource: a vanilla site must pull, and a
                 // promote must not stop on it. A project that does use it still fails.
-                if (target.needsPlugin && PLUGIN_MISSING.test(message) && !this.usesResource(target.needsPlugin)) {
+                if (target.needsPlugin && INTEGRATION_MISSING.test(message) && !projectUses(target.needsPlugin, this.localConfig)) {
                     // oclif's catch already set exitCode to 1 for the sub-command; a real failure still
                     // exits non-zero through the this.error() below.
                     process.exitCode = undefined;
@@ -82,7 +88,13 @@ export default class Pull extends LoopressCommand {
             argv.push('--yes');
         return argv;
     }
-    usesResource(kind) {
-        return existsSync(resolve(resolveResourceDir(kind, this.localConfig)));
+    // The site unreachable or the theme list refused: let the step run and report it itself.
+    async globalStylesSkipNote() {
+        try {
+            return await globalStylesSkipNote(this.wp, resolveResourceDir('themeStyles', this.localConfig), 'pull');
+        }
+        catch {
+            return undefined;
+        }
     }
 }

package/dist/commands/push.d.ts

@@ -2,6 +2,7 @@ import { LoopressCommand } from '../lib/base.js';
 type PushTargetResult = {
     error?: string;
     label: string;
+    result?: unknown;
     status: 'failed' | 'pushed' | 'skipped';
 };
 type PushResult = {
@@ -20,6 +21,7 @@ export default class Push extends LoopressCommand {
     private buildArgv;
     private composerDeclaresPlugins;
     private composerJsonPath;
+    private globalStylesSkipNote;
     private guardProductionPush;
     private skippedTargets;
 }