@loopress/cli 0.23.0 → 0.24.1

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

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

package/dist/commands/acf/diff.js

@@ -0,0 +1,5 @@
+import { resourceDiffCommand } from '../../lib/diff-command.js';
+export default 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',
+});

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

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

package/dist/commands/api/diff.js

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

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

@@ -1,12 +1,2 @@
-import { LoopressCommand } from '../../lib/base.js';
-type ApiFile = {
-    content: string;
-    filename: string;
-};
-export default class List extends LoopressCommand {
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    run(): Promise<ApiFile[]>;
-}
-export {};
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/php-files-command.js").ListFilesCommand>;
+export default _default;

package/dist/commands/api/list.js

@@ -1,20 +1,2 @@
-import { LoopressCommand } from '../../lib/base.js';
-import { pluralize } from '../../utils/pluralize.js';
-export default class List extends LoopressCommand {
-    static description = 'List custom API route files from WordPress';
-    static enableJsonFlag = true;
-    static examples = ['$ lps api list'];
-    async run() {
-        const files = await this.wp.get('loopress/v1/api-files');
-        if (files.length === 0) {
-            this.log('No API route files found');
-            return files;
-        }
-        this.log(`Found ${pluralize(files.length, 'route file')}:`);
-        this.log('');
-        for (const file of files) {
-            this.log(`  ${file.filename}`);
-        }
-        return files;
-    }
-}
+import { API_FILES_RESOURCE, resourceListCommand } from '../../lib/php-files-command.js';
+export default resourceListCommand(API_FILES_RESOURCE);

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

@@ -1,20 +1,2 @@
-import { LoopressCommand } from '../../lib/base.js';
-type PullResult = {
-    orphans: string[];
-    pulled: 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<PullResult>;
-}
-export {};
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/php-files-command.js").PullFilesCommand>;
+export default _default;

package/dist/commands/api/pull.js

@@ -1,53 +1,2 @@
-import { Args } from '@oclif/core';
-import { mkdir, writeFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { LoopressCommand } from '../../lib/base.js';
-import { basenameKey, findOrphanedFiles } from '../../lib/find-orphaned-files.js';
-import { pluralize } from '../../utils/pluralize.js';
-export default class Pull extends LoopressCommand {
-    static args = {
-        path: Args.string({ description: 'Path to api directory (overrides project config)' }),
-    };
-    static description = 'Pull custom API route files from WordPress';
-    static enableJsonFlag = true;
-    static examples = ['$ lps api pull', '$ lps api pull --path ./api'];
-    static flags = {
-        ...LoopressCommand.dryRunFlag,
-        ...LoopressCommand.yesFlag,
-    };
-    async run() {
-        const { args } = await this.parse(Pull);
-        const { url } = this.siteConfig;
-        const path = this.resolveApiPath(args.path);
-        this.log(`Pulling API routes from ${url}`);
-        this.log(`API path: ${path}`);
-        const files = await this.wp.get('loopress/v1/api-files');
-        // A `<filename>.php` no longer present remotely belongs to a route deleted on WordPress
-        // (push itself stays additive-only, but pull already cleans up locally, same as
-        // `snippet pull`).
-        const orphans = await findOrphanedFiles(path, new Set(files.map((file) => file.filename)), {
-            extensions: ['.php'],
-            key: basenameKey,
-            recursive: true,
-        });
-        const pulled = files.map((file) => file.filename);
-        await this.pullDirectory(path, files, orphans, {
-            alwaysCreateDir: true,
-            dryRunMessage: `Would pull ${pluralize(files.length, 'route file')} to ${path}`,
-            orphanReason: 'whose route no longer exists on WordPress',
-            pulledMessage: `Pulled ${pluralize(files.length, 'route file')} to ${path}`,
-            title: (file) => file.filename,
-            async write(file, writeDir) {
-                const filePath = join(writeDir, `${file.filename}.php`);
-                // filename can contain '/' (a path-param route, e.g. invoice-pdf/[order_id]):
-                // writeFile() doesn't create parent directories on its own the way mkdir()'s
-                // recursive option does above for the top-level path.
-                await mkdir(dirname(filePath), { recursive: true });
-                await writeFile(filePath, file.content);
-            },
-        });
-        if (this.dryRun)
-            return { orphans, pulled, status: 'dry-run' };
-        return { orphans, pulled, status: 'success' };
-    }
-}
+import { API_FILES_RESOURCE, resourcePullCommand } from '../../lib/php-files-command.js';
+export default resourcePullCommand(API_FILES_RESOURCE);

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

@@ -1,22 +1,2 @@
-import { PushCommand } from '../../lib/push-command.js';
-type PushResult = {
-    pushed: 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<PushResult>;
-    private loadFiles;
-    private pushFile;
-    private syncApiRoutes;
-}
-export {};
+declare const _default: import("../../lib/php-files-command.js").CommandClass<import("../../lib/php-files-command.js").PushFilesCommand>;
+export default _default;

package/dist/commands/api/push.js

@@ -1,116 +1,2 @@
-import { Args } from '@oclif/core';
-import { relative, sep } from 'node:path';
-import { authManager } from '../../config/auth.manager.js';
-import { ApiClient } from '../../lib/api-client.js';
-import { loadFiles as loadDirectoryFiles } from '../../lib/load-files.js';
-import { PushCommand } from '../../lib/push-command.js';
-import { pluralize } from '../../utils/pluralize.js';
-// Mirrors the server's own allowlist (wordpress-plugin ApiFilesController::isValidFilename()):
-// filename is sent as a body param (not a URL path segment: a nested path can contain '/' and
-// '[]', and depending on a server to handle a percent-encoded slash in a URL path correctly is
-// exactly the kind of hosting-environment variance Loopress can't assume away), but validating
-// client-side first still turns a malformed name into an accurate error and skips a network
-// round-trip that could only ever fail.
-const FILENAME_PATTERN = /^(?:[a-z0-9-]+|\[[A-Za-z_]\w*\])(?:\/(?:[a-z0-9-]+|\[[A-Za-z_]\w*\]))*$/;
-// Mirrors the server's own check (wordpress-plugin FileWriter::DECLARE_PATTERN /
-// withGuard()): the server rejects both an absent declare(strict_types=1); and one that
-// appears more than once (it needs a single unambiguous insertion point for the ABSPATH
-// guard). Matching that "exactly once" rule here too, not just presence, so a file that
-// would still fail server-side doesn't falsely pass this earlier check.
-const DECLARE_PATTERN = /declare\s*\(\s*strict_types\s*=\s*1\s*\)\s*;/g;
-export default class Push extends PushCommand {
-    static args = {
-        path: Args.string({ description: 'Path to api directory (overrides project config)' }),
-    };
-    static description = 'Push custom API route files to WordPress';
-    static enableJsonFlag = true;
-    static examples = ['$ lps api push', '$ lps api push --path ./api'];
-    static flags = {
-        ...PushCommand.dryRunFlag,
-        ...PushCommand.yesFlag,
-    };
-    async run() {
-        const { args } = await this.parse(Push);
-        const { url } = this.siteConfig;
-        const path = this.resolveApiPath(args.path);
-        this.log(`Pushing API routes to ${url}`);
-        this.log(`API path: ${path}`);
-        const files = await this.loadFiles(path);
-        this.log(`Found ${pluralize(files.length, 'route file')} to push`);
-        const pushed = [];
-        await this.runPushTasks(files, (file) => file.filename, async (file, task) => {
-            await this.pushFile(file, task);
-            pushed.push(file.filename);
-        });
-        if (this.failedCount > 0) {
-            this.error(`${pluralize(this.failedCount, 'route file')} failed to push.`);
-        }
-        if (this.dryRun)
-            return { pushed, status: 'dry-run' };
-        await this.recordSuccess();
-        await this.syncApiRoutes(files.map((file) => file.filename));
-        this.log('All API routes pushed.');
-        return { pushed, status: 'success' };
-    }
-    async loadFiles(path) {
-        return loadDirectoryFiles(path, {
-            extension: '.php',
-            onSkip: (message) => { this.warn(message); },
-            // relative()'s separator is OS-specific ('\\' on Windows); the server only ever expects
-            // '/', same as any URL or import path.
-            parse: (raw, filePath) => ({
-                content: raw,
-                filename: relative(path, filePath).slice(0, -'.php'.length).split(sep).join('/'),
-            }),
-            recursive: true,
-        });
-    }
-    async pushFile(file, task) {
-        if (!FILENAME_PATTERN.test(file.filename)) {
-            const message = `Invalid filename "${file.filename}": each path segment must be lowercase letters, digits, and hyphens, or a bracketed dynamic segment like "[order_id]" (e.g. "invoice-pdf/[order_id].php")`;
-            this.reportTaskFailure(message, new Error(message), task);
-        }
-        const declareCount = file.content.match(DECLARE_PATTERN)?.length ?? 0;
-        if (declareCount !== 1) {
-            const reason = declareCount === 0 ? 'is missing' : 'appears more than once';
-            const message = `${file.filename}.php: "declare(strict_types=1);" ${reason}, it must appear exactly once as the first statement`;
-            this.reportTaskFailure(message, new Error(message), task);
-        }
-        if (this.dryRun) {
-            if (task)
-                task.output = `[dry-run] Would push: ${file.filename}`;
-            return;
-        }
-        try {
-            const result = await this.wp.put('loopress/v1/api-files', {
-                content: file.content,
-                filename: file.filename,
-            });
-            if (task) {
-                task.output =
-                    result.syntax_check === 'skipped'
-                        ? `Pushed: ${file.filename} (syntax check skipped, unavailable on this host)`
-                        : `Pushed: ${file.filename}`;
-            }
-        }
-        catch (error) {
-            this.reportTaskFailure(`Failed to push ${file.filename}: ${error.message}`, error, task);
-        }
-    }
-    // Best-effort report of the current file list to the Loopress cloud, purely for console
-    // visibility (see obsidian/Product/API and Console Backlog.md, US-18): the routes are already
-    // live on WordPress by this point, this can never block or fail the push itself, same
-    // reasoning as `recordDeployment` in PushCommand.
-    async syncApiRoutes(filenames) {
-        const token = process.env.LOOPRESS_TOKEN ?? authManager.getAuth()?.token;
-        const environmentId = this.siteConfig.apiEnvironmentId;
-        if (!token || !environmentId)
-            return;
-        try {
-            await new ApiClient(token).put('api-routes', { environmentId, filenames });
-        }
-        catch {
-            // non-blocking: reporting the route list must never interrupt the push flow
-        }
-    }
-}
+import { API_FILES_RESOURCE, resourcePushCommand } from '../../lib/php-files-command.js';
+export default resourcePushCommand(API_FILES_RESOURCE);

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

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

package/dist/commands/api/rm.js

@@ -0,0 +1,2 @@
+import { API_FILES_RESOURCE, resourceRmCommand } from '../../lib/php-files-command.js';
+export default resourceRmCommand(API_FILES_RESOURCE);

package/dist/commands/composer/pull.js

@@ -1,23 +1,13 @@
 import { writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { LoopressCommand } from '../../lib/base.js';
-import { isNotFoundError } from '../../lib/wp-client.js';
-// Narrower than isNotFoundError(): a bare 404 also covers the route being absent (plugin not
-// installed, or an edition/version predating Composer support), which must still surface the
-// normal "is the plugin installed?" guidance rather than being read as "no lock yet".
+import { isApplicative404 } from '../../lib/wp-client.js';
+// A site that never had Composer dependencies pushed has no composer.lock yet: the Loopress
+// controller answers that specific 404 with `{"error": "composer.lock not found"}`. Any other
+// 404 (route absent because the plugin isn't installed or predates Composer support) must
+// still surface the normal "is the plugin installed?" guidance instead of being swallowed.
 function isMissingComposerLock(error) {
-    if (!isNotFoundError(error))
-        return false;
-    const body = error.cause?.response?.body;
-    if (!body)
-        return false;
-    try {
-        const parsed = JSON.parse(body);
-        return parsed.error === 'composer.lock not found';
-    }
-    catch {
-        return false;
-    }
+    return isApplicative404(error, 'composer.lock not found');
 }
 export default class ComposerPull extends LoopressCommand {
     static description = 'Pull composer.json and composer.lock from WordPress';

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

@@ -1,6 +1,8 @@
 import { PushCommand } from '../../lib/push-command.js';
+import { type LockDriftEntry } from '../../utils/plugin-sync.js';
 type PushResult = {
     hasLock: boolean;
+    lockDrift: LockDriftEntry[];
     packageCount: number;
     status: 'dry-run' | 'success';
 };
@@ -14,5 +16,6 @@ export default class ComposerPush extends PushCommand {
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<PushResult>;
+    private reportLockDrift;
 }
 export {};

package/dist/commands/composer/push.js

@@ -4,7 +4,7 @@ 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 { parseCollisions, SYNC_TIMEOUT_MS } from '../../utils/plugin-sync.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) {
@@ -25,7 +25,7 @@ function toIntent(require) {
     return intent;
 }
 export default class ComposerPush extends PushCommand {
-    static description = 'Push composer.json (and composer.lock, if present) to WordPress and run Composer';
+    static description = 'Push composer.json to WordPress and run Composer to resolve and install dependencies';
     static enableJsonFlag = true;
     static examples = ['$ lps composer push', '$ lps composer push --dry-run'];
     static flags = {
@@ -47,14 +47,16 @@ export default class ComposerPush extends PushCommand {
         const packageCount = Object.keys(require).length;
         const intent = toIntent(require);
         const hasLock = existsSync(composerLockPath);
+        // The server resolves composer.json itself; it never installs from this lock (a crafted
+        // lock could point package downloads at arbitrary hosts). It is sent only so the server
+        // can report which pinned versions its own resolution moved. `lps composer pull` brings
+        // the resolved lock back.
         const lock = hasLock ? await readFile(composerLockPath, 'utf8') : null;
         this.log(`Pushing composer.json (${packageCount} ${packageCount === 1 ? 'package' : 'packages'}) to ${url}`);
         if (lock)
-            this.log('  + composer.lock included (reproducible install)');
-        else
-            this.warn('No composer.lock found. The server will resolve versions freely.');
+            this.log('  + composer.lock sent for drift comparison (the server resolves versions from composer.json)');
         if (this.dryRun)
-            return { hasLock, packageCount, status: 'dry-run' };
+            return { hasLock, lockDrift: [], packageCount, status: 'dry-run' };
         this.log('Running Composer on the server, this can take a few minutes...');
         let response;
         try {
@@ -72,7 +74,22 @@ export default class ComposerPush extends PushCommand {
         if (response.output.trim())
             this.log(response.output.trim());
         this.log('Composer run completed on the server.');
+        const lockDrift = response.lockDrift ?? [];
+        this.reportLockDrift(lockDrift);
         await this.recordSuccess();
-        return { hasLock, packageCount, status: 'success' };
+        return { hasLock, lockDrift, packageCount, status: 'success' };
+    }
+    // The server resolves composer.json from scratch and never installs from the uploaded lock,
+    // so a project that committed a lock can see versions move. Spell out exactly what changed
+    // and point at `lps composer pull` to bring the resolved lock back locally.
+    reportLockDrift(lockDrift) {
+        if (lockDrift.length === 0)
+            return;
+        this.log('');
+        this.log(`The server resolved ${lockDrift.length} ${lockDrift.length === 1 ? 'package' : 'packages'} to a different version than your local composer.lock:`);
+        for (const { from, name, to } of lockDrift) {
+            this.log(`  ${name}: ${from ?? '(absent)'} -> ${to ?? '(removed)'}`);
+        }
+        this.log('Run `lps composer pull` to update your local composer.json and composer.lock.');
     }
 }

package/dist/commands/dev.js

@@ -9,7 +9,7 @@ const DEBOUNCE_MS = 400;
 const IGNORED = /(?:(^|[/\\])(\.git|node_modules|\.DS_Store)(?:[/\\]|$))|(?:\.swp$)/;
 export default class Dev extends Command {
     static description = 'Watch project files and push changes to the local WordPress instance as they happen. Always targets the "local" environment, run `lps snippet push` etc. directly for any other environment.';
-    static examples = ['$ lps dev', '$ lps dev --only=snippets,pages', '$ lps dev --skip=plugins'];
+    static examples = ['$ lps dev', '$ lps dev --only=snippets,api', '$ lps dev --skip=plugins'];
     static flags = {
         only: Flags.string({ description: `Only watch these resource types (comma-separated): ${RESOURCE_TYPES.join(', ')}` }),
         skip: Flags.string({ description: `Skip these resource types (comma-separated): ${RESOURCE_TYPES.join(', ')}` }),

package/dist/commands/diff.d.ts

@@ -0,0 +1,13 @@
+import { DiffCommand, type DiffJson } from '../lib/diff-command.js';
+export default class Diff extends DiffCommand {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        only: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        skip: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        against: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<DiffJson>;
+    private selectResources;
+}

package/dist/commands/diff.js

@@ -0,0 +1,42 @@
+import { Flags } from '@oclif/core';
+import { DiffCommand } from '../lib/diff-command.js';
+import { RESOURCE_STATE_PROVIDERS } from '../lib/resource-state.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, SEO, 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;
+    static examples = [
+        '$ lps diff',
+        '$ lps diff --env staging',
+        '$ lps diff --env staging --against production',
+        '$ lps diff --only snippet --only acf',
+        '$ lps diff --skip composer',
+    ];
+    static flags = {
+        ...DiffCommand.againstFlag,
+        only: Flags.string({ description: 'Only compare these resources', multiple: true, options: [...RESOURCES] }),
+        skip: Flags.string({ description: 'Compare every resource except these', multiple: true, options: [...RESOURCES] }),
+    };
+    async run() {
+        const { flags } = await this.parse(Diff);
+        const sides = this.resolveSides(flags.against);
+        const selected = this.selectResources(flags.only, flags.skip);
+        const targets = [
+            ...RESOURCE_STATE_PROVIDERS.filter((provider) => selected.has(provider.resource)).map((provider) => this.providerTarget(provider, sides)),
+            ...(selected.has('composer') ? [this.composerTarget(sides)] : []),
+        ];
+        return this.report(targets, sides);
+    }
+    // `--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) {
+        const base = only && only.length > 0 ? only : RESOURCES;
+        return new Set(base.filter((resource) => !(skip ?? []).includes(resource)));
+    }
+}

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

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

package/dist/commands/form/diff.js

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

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

@@ -6,9 +6,11 @@ export default class Push extends PushCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        'allow-notifications': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    private allowNotifications;
     run(): Promise<void>;
     private ensureCanonicalFilename;
     private loadFiles;

package/dist/commands/form/push.js

@@ -1,4 +1,4 @@
-import { Args } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import { readFile, rename } from 'node:fs/promises';
 import { dirname, extname, join } from 'node:path';
 import { PushCommand } from '../../lib/push-command.js';
@@ -12,15 +12,21 @@ 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 examples = ['$ lps form push'];
+    static examples = ['$ lps form push', '$ lps form push --allow-notifications'];
     static flags = {
         ...PushCommand.dryRunFlag,
         ...PushCommand.yesFlag,
+        'allow-notifications': Flags.boolean({
+            default: false,
+            description: "Also push each form's notification and confirmation settings (recipients, sender, messages). Off by default: the server keeps its own so a stray push can't redirect submissions.",
+        }),
     };
+    allowNotifications = false;
     async run() {
-        const { args } = await this.parse(Push);
+        const { args, flags } = await this.parse(Push);
         const { url } = this.siteConfig;
         const path = this.resolveFormPath(args.path);
+        this.allowNotifications = flags['allow-notifications'];
         this.log(`Pushing forms to ${url}`);
         this.log(`Forms path: ${path}`);
         const files = await this.loadFiles(path);
@@ -78,9 +84,10 @@ export default class Push extends PushCommand {
         }
         try {
             const id = getFormId(data);
+            const payload = this.allowNotifications ? { ...data, allowNotifications: true } : data;
             const { body, created } = await putOrCreate(this.wp, {
                 id,
-                payload: data,
+                payload,
                 postEndpoint: FORM_ENDPOINT,
                 putEndpoint: (formId) => `${FORM_ENDPOINT}/${formId}`,
             });

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

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

package/dist/commands/hook/diff.js

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

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

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

package/dist/commands/hook/list.js

@@ -0,0 +1,2 @@
+import { HOOK_FILES_RESOURCE, resourceListCommand } from '../../lib/php-files-command.js';
+export default resourceListCommand(HOOK_FILES_RESOURCE);

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

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

package/dist/commands/hook/pull.js

@@ -0,0 +1,2 @@
+import { HOOK_FILES_RESOURCE, resourcePullCommand } from '../../lib/php-files-command.js';
+export default resourcePullCommand(HOOK_FILES_RESOURCE);

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

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

package/dist/commands/hook/push.js

@@ -0,0 +1,2 @@
+import { HOOK_FILES_RESOURCE, resourcePushCommand } from '../../lib/php-files-command.js';
+export default resourcePushCommand(HOOK_FILES_RESOURCE);

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

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

package/dist/commands/hook/rm.js

@@ -0,0 +1,2 @@
+import { HOOK_FILES_RESOURCE, resourceRmCommand } from '../../lib/php-files-command.js';
+export default resourceRmCommand(HOOK_FILES_RESOURCE);

package/dist/commands/init.js

@@ -16,8 +16,8 @@ const FEATURES = [
     { dir: 'acf', key: 'acfDir', label: 'ACF' },
     { dir: 'seo', key: 'seoDir', label: 'SEO' },
     { dir: 'forms', key: 'formDir', label: 'Forms' },
-    { dir: 'pages', key: 'pageDir', label: 'Pages' },
     { 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' },
 ];
 export default class Init extends Command {

package/dist/commands/login.js

@@ -13,8 +13,9 @@ export default class Login extends Command {
     }
     async waitForCallback() {
         return waitForLocalCallback({
-            buildUrl(callbackBaseUrl) {
-                const callbackUrl = encodeURIComponent(`${callbackBaseUrl}/callback`);
+            allowedOrigins: [CONSOLE_URL],
+            buildUrl(callbackBaseUrl, state) {
+                const callbackUrl = encodeURIComponent(`${callbackBaseUrl}/callback?state=${state}`);
                 return `${CONSOLE_URL}/cli-auth?callbackUrl=${callbackUrl}`;
             },
             handleRequest(url, { resolveWithPage, respondBadRequest }) {

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

@@ -0,0 +1,15 @@
+import { LoopressCommand } from '../../lib/base.js';
+import { type LocalOption } from '../../utils/option-format.js';
+export default class Add extends LoopressCommand {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<LocalOption>;
+}