@loopress/cli 0.17.0 → 0.18.0

package/README.md

@@ -1,10 +1,10 @@
 # Loopress
 
-A new CLI generated with oclif
+CLI to interact with the Loopress ecosystem
 
 [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
-[![Version](https://img.shields.io/npm/v/mynewcli.svg)](https://npmjs.org/package/mynewcli)
-[![Downloads/week](https://img.shields.io/npm/dw/mynewcli.svg)](https://npmjs.org/package/mynewcli)
+[![Version](https://img.shields.io/npm/v/@loopress/cli.svg)](https://www.npmjs.com/package/@loopress/cli)
+[![Downloads/week](https://img.shields.io/npm/dw/@loopress/cli.svg)](https://npmjs.org/package/@loopress/cli)
 
 <!-- toc -->
 * [Loopress](#loopress)
@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.17.0 linux-x64 node-v24.18.0
+@loopress/cli/0.18.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -50,9 +50,15 @@ report.
 * [`lps acf list`](#lps-acf-list)
 * [`lps acf pull [PATH]`](#lps-acf-pull-path)
 * [`lps acf push [PATH]`](#lps-acf-push-path)
+* [`lps api list`](#lps-api-list)
+* [`lps api pull [PATH]`](#lps-api-pull-path)
+* [`lps api push [PATH]`](#lps-api-push-path)
 * [`lps composer init`](#lps-composer-init)
 * [`lps composer pull`](#lps-composer-pull)
 * [`lps composer push`](#lps-composer-push)
+* [`lps form list`](#lps-form-list)
+* [`lps form pull [PATH]`](#lps-form-pull-path)
+* [`lps form push [PATH]`](#lps-form-push-path)
 * [`lps help [COMMAND]`](#lps-help-command)
 * [`lps init`](#lps-init)
 * [`lps login`](#lps-login)
@@ -99,7 +105,7 @@ EXAMPLES
   $ lps acf list --type field-groups
 ```
 
-_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/acf/list.ts)_
+_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/acf/list.ts)_
 
 ## `lps acf pull [PATH]`
 
@@ -126,7 +132,7 @@ EXAMPLES
   $ lps acf pull --type field-groups
 ```
 
-_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/acf/pull.ts)_
+_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/acf/pull.ts)_
 
 ## `lps acf push [PATH]`
 
@@ -153,7 +159,77 @@ EXAMPLES
   $ lps acf push --type field-groups
 ```
 
-_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/acf/push.ts)_
+_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/acf/push.ts)_
+
+## `lps api list`
+
+List custom API route files from WordPress
+
+```
+USAGE
+  $ lps api list [-j]
+
+FLAGS
+  -j, --json  Output in JSON format
+
+DESCRIPTION
+  List custom API route files from WordPress
+
+EXAMPLES
+  $ lps api list
+```
+
+_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/api/list.ts)_
+
+## `lps api pull [PATH]`
+
+Pull custom API route files from WordPress
+
+```
+USAGE
+  $ lps api pull [PATH] [-d]
+
+ARGUMENTS
+  [PATH]  Path to api directory (overrides project config)
+
+FLAGS
+  -d, --dry-run  Show what would change without making changes
+
+DESCRIPTION
+  Pull custom API route files from WordPress
+
+EXAMPLES
+  $ lps api pull
+
+  $ lps api pull --path ./api
+```
+
+_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/api/pull.ts)_
+
+## `lps api push [PATH]`
+
+Push custom API route files to WordPress
+
+```
+USAGE
+  $ lps api push [PATH] [-d]
+
+ARGUMENTS
+  [PATH]  Path to api directory (overrides project config)
+
+FLAGS
+  -d, --dry-run  Show what would change without making changes
+
+DESCRIPTION
+  Push custom API route files to WordPress
+
+EXAMPLES
+  $ lps api push
+
+  $ lps api push --path ./api
+```
+
+_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/api/push.ts)_
 
 ## `lps composer init`
 
@@ -175,7 +251,7 @@ EXAMPLES
   $ lps composer init --dry-run
 ```
 
-_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/composer/init.ts)_
+_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/composer/init.ts)_
 
 ## `lps composer pull`
 
@@ -197,7 +273,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
@@ -219,7 +295,74 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/composer/push.ts)_
+
+## `lps form list`
+
+List forms from WordPress
+
+```
+USAGE
+  $ lps form list [-j]
+
+FLAGS
+  -j, --json  Output in JSON format
+
+DESCRIPTION
+  List forms from WordPress
+
+EXAMPLES
+  $ lps form list
+```
+
+_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/form/list.ts)_
+
+## `lps form pull [PATH]`
+
+Pull forms from WordPress
+
+```
+USAGE
+  $ lps form pull [PATH] [-d]
+
+ARGUMENTS
+  [PATH]  Path to forms directory (overrides project config)
+
+FLAGS
+  -d, --dry-run  Show what would change without making changes
+
+DESCRIPTION
+  Pull forms from WordPress
+
+EXAMPLES
+  $ lps form pull
+```
+
+_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/form/pull.ts)_
+
+## `lps form push [PATH]`
+
+Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json` convention.
+
+```
+USAGE
+  $ lps form push [PATH] [-d]
+
+ARGUMENTS
+  [PATH]  Path to forms directory (overrides project config)
+
+FLAGS
+  -d, --dry-run  Show what would change without making changes
+
+DESCRIPTION
+  Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json`
+  convention.
+
+EXAMPLES
+  $ lps form push
+```
+
+_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/form/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -256,7 +399,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -273,7 +416,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -290,7 +433,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/logout.ts)_
 
 ## `lps plugin add SLUG`
 
@@ -315,7 +458,7 @@ EXAMPLES
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/plugin/add.ts)_
 
 ## `lps plugin pull`
 
@@ -337,7 +480,7 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
@@ -359,7 +502,7 @@ EXAMPLES
   $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
@@ -377,7 +520,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -394,7 +537,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/project/list.ts)_
 
 ## `lps project pull`
 
@@ -411,7 +554,7 @@ EXAMPLES
   $ lps project pull
 ```
 
-_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/pull.ts)_
+_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/project/pull.ts)_
 
 ## `lps project push`
 
@@ -428,7 +571,7 @@ EXAMPLES
   $ lps project push
 ```
 
-_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/push.ts)_
+_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/project/push.ts)_
 
 ## `lps project remove`
 
@@ -445,7 +588,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/project/remove.ts)_
 
 ## `lps project switch`
 
@@ -462,7 +605,7 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/project/switch.ts)_
 
 ## `lps seo list`
 
@@ -485,7 +628,7 @@ EXAMPLES
   $ lps seo list --post-type post
 ```
 
-_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/seo/list.ts)_
+_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/seo/list.ts)_
 
 ## `lps seo pull [PATH]`
 
@@ -511,7 +654,7 @@ EXAMPLES
   $ lps seo pull --post-type post --post-type page
 ```
 
-_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/seo/pull.ts)_
+_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/seo/pull.ts)_
 
 ## `lps seo push [PATH]`
 
@@ -535,7 +678,7 @@ EXAMPLES
   $ lps seo push
 ```
 
-_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/seo/push.ts)_
+_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/seo/push.ts)_
 
 ## `lps snippet list`
 
@@ -555,7 +698,7 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet publish [PATH]`
 
@@ -578,7 +721,7 @@ EXAMPLES
   $ lps snippet publish --path ./snippets
 ```
 
-_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/snippet/publish.ts)_
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -603,7 +746,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -629,7 +772,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -646,7 +789,7 @@ EXAMPLES
   $ lps status
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/status.ts)_
 
 ## `lps telemetry disable`
 
@@ -663,7 +806,7 @@ EXAMPLES
   $ lps telemetry disable
 ```
 
-_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/telemetry/disable.ts)_
+_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/telemetry/disable.ts)_
 
 ## `lps telemetry enable`
 
@@ -680,5 +823,5 @@ EXAMPLES
   $ lps telemetry enable
 ```
 
-_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.17.0/src/commands/telemetry/enable.ts)_
+_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.18.0/src/commands/telemetry/enable.ts)_
 <!-- commandsstop -->

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

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

package/dist/commands/api/list.js

@@ -0,0 +1,26 @@
+import { Flags } from '@oclif/core';
+import { LoopressCommand } from '../../lib/base.js';
+export default class List extends LoopressCommand {
+    static description = 'List custom API route files from WordPress';
+    static examples = ['$ lps api list'];
+    static flags = {
+        json: Flags.boolean({ char: 'j', description: 'Output in JSON format' }),
+    };
+    async run() {
+        const { flags } = await this.parse(List);
+        const files = await this.wp.get('loopress/v1/api-files');
+        if (flags.json) {
+            this.log(JSON.stringify(files, null, 2));
+            return;
+        }
+        if (files.length === 0) {
+            this.log('No API route files found');
+            return;
+        }
+        this.log(`Found ${files.length} route file${files.length === 1 ? '' : 's'}:`);
+        this.log('');
+        for (const file of files) {
+            this.log(`  ${file.filename}`);
+        }
+    }
+}

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

@@ -0,0 +1,13 @@
+import { LoopressCommand } from '../../lib/base.js';
+export default class Pull extends LoopressCommand {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private findOrphanedFiles;
+}

package/dist/commands/api/pull.js

@@ -0,0 +1,64 @@
+import { Args } from '@oclif/core';
+import { Listr } from 'listr2';
+import { mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { LoopressCommand } from '../../lib/base.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 examples = ['$ lps api pull', '$ lps api pull --path ./api'];
+    static flags = {
+        ...LoopressCommand.dryRunFlag,
+    };
+    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');
+        // Files following the `<filename>.php` convention no longer present remotely belong to
+        // a route deleted on WordPress. Left on disk, they'd silently come back to life the next
+        // time `api push` runs (see obsidian/Product/Push Deletion Rules.md: push itself stays
+        // additive-only, but pull already cleans up locally, same as `snippet pull`).
+        const orphans = await this.findOrphanedFiles(path, new Set(files.map((file) => file.filename)));
+        if (this.dryRun) {
+            this.log(`[dry-run] Would pull ${files.length} route file${files.length === 1 ? '' : 's'} to ${path}`);
+            if (orphans.length > 0) {
+                this.log(`[dry-run] Would remove ${orphans.length} local file${orphans.length === 1 ? '' : 's'} whose route no longer exists on WordPress: ${orphans.join(', ')}`);
+            }
+            return;
+        }
+        await mkdir(path, { recursive: true });
+        await new Listr(files.map((file) => ({
+            async task(_ctx, task) {
+                await writeFile(join(path, `${file.filename}.php`), file.content);
+                task.output = `Pulled: ${file.filename}`;
+            },
+            title: `Pull ${file.filename}`,
+        }))).run();
+        for (const file of orphans)
+            await rm(join(path, file), { force: true });
+        if (orphans.length > 0) {
+            this.warn(`Removed ${orphans.length} local file${orphans.length === 1 ? '' : 's'} whose route no longer exists on WordPress: ${orphans.join(', ')}`);
+        }
+        this.log(`Pulled ${files.length} route file${files.length === 1 ? '' : 's'} to ${path}`);
+    }
+    // Only ever matches `.php` files already following the flat `<filename>.php` convention
+    // that `api pull`/`push` themselves produce, so a hand-created non-.php file is never at
+    // risk of being picked up here.
+    async findOrphanedFiles(path, keepFilenames) {
+        let entries;
+        try {
+            entries = await readdir(path);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        return entries.filter((entry) => entry.endsWith('.php') && !keepFilenames.has(entry.slice(0, -4)));
+    }
+}

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

@@ -0,0 +1,15 @@
+import { PushCommand } from '../../lib/push-command.js';
+export default class Push extends PushCommand {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    private failedCount;
+    run(): Promise<void>;
+    private loadFiles;
+    private pushFile;
+}

package/dist/commands/api/push.js

@@ -0,0 +1,76 @@
+import { Args } from '@oclif/core';
+import { Listr } from 'listr2';
+import { readdir, readFile } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+import { PushCommand } from '../../lib/push-command.js';
+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 examples = ['$ lps api push', '$ lps api push --path ./api'];
+    static flags = {
+        ...PushCommand.dryRunFlag,
+    };
+    failedCount = 0;
+    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 ${files.length} route file${files.length === 1 ? '' : 's'} to push`);
+        await new Listr(files.map((file) => ({
+            task: async (_ctx, task) => this.pushFile(file, task),
+            title: `Push ${file.filename}`,
+        })), { concurrent: false, exitOnError: false }).run();
+        if (this.failedCount > 0) {
+            this.error(`${this.failedCount} route file${this.failedCount === 1 ? '' : 's'} failed to push.`);
+        }
+        if (this.dryRun)
+            return;
+        await this.recordSuccess();
+        this.log('All API routes pushed.');
+    }
+    async loadFiles(path) {
+        let entries;
+        try {
+            entries = await readdir(path);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        const files = [];
+        for (const entry of entries) {
+            if (extname(entry) !== '.php')
+                continue;
+            const content = await readFile(join(path, entry), 'utf8');
+            files.push({ content, filename: entry.slice(0, -4) });
+        }
+        return files;
+    }
+    async pushFile(file, task) {
+        if (this.dryRun) {
+            if (task)
+                task.output = `[dry-run] Would push: ${file.filename}`;
+            return;
+        }
+        try {
+            await this.wp.put(`loopress/v1/api-files/${file.filename}`, { content: file.content });
+            if (task)
+                task.output = `Pushed: ${file.filename}`;
+        }
+        catch (error) {
+            const message = `Failed to push ${file.filename}: ${error.message}`;
+            if (task)
+                task.output = message;
+            else
+                this.warn(`  ${message}`);
+            this.failedCount++;
+            throw error;
+        }
+    }
+}

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

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

package/dist/commands/form/list.js

@@ -0,0 +1,26 @@
+import { Flags } from '@oclif/core';
+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 examples = ['$ lps form list'];
+    static flags = {
+        json: Flags.boolean({ char: 'j', description: 'Output in JSON format' }),
+    };
+    async run() {
+        const { flags } = await this.parse(List);
+        const forms = await this.wp.get(FORM_ENDPOINT);
+        if (flags.json) {
+            this.log(JSON.stringify(forms, null, 2));
+            return;
+        }
+        this.log(`Forms (${forms.length}):`);
+        if (forms.length === 0) {
+            this.log('  (none)');
+            return;
+        }
+        for (const form of forms) {
+            this.log(`  ${getFormId(form) ?? '(no id)'}. ${getFormTitle(form)}`);
+        }
+    }
+}

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

@@ -0,0 +1,14 @@
+import { LoopressCommand } from '../../lib/base.js';
+export default class Pull extends LoopressCommand {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private findOrphanedFiles;
+}
+export declare function slug(title: string): string;