@loopress/cli 0.19.0 → 0.20.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.19.0 linux-x64 node-v24.18.0
+@loopress/cli/0.20.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -51,6 +51,7 @@ report.
 * [`lps acf pull [PATH]`](#lps-acf-pull-path)
 * [`lps acf push [PATH]`](#lps-acf-push-path)
 * [`lps api list`](#lps-api-list)
+* [`lps api publish [PATH]`](#lps-api-publish-path)
 * [`lps api pull [PATH]`](#lps-api-pull-path)
 * [`lps api push [PATH]`](#lps-api-push-path)
 * [`lps composer init`](#lps-composer-init)
@@ -64,6 +65,9 @@ report.
 * [`lps init`](#lps-init)
 * [`lps login`](#lps-login)
 * [`lps logout`](#lps-logout)
+* [`lps page list`](#lps-page-list)
+* [`lps page pull [PATH]`](#lps-page-pull-path)
+* [`lps page push [PATH]`](#lps-page-push-path)
 * [`lps plugin add SLUG`](#lps-plugin-add-slug)
 * [`lps plugin pull`](#lps-plugin-pull)
 * [`lps plugin push`](#lps-plugin-push)
@@ -72,6 +76,7 @@ report.
 * [`lps project pull`](#lps-project-pull)
 * [`lps project push`](#lps-project-push)
 * [`lps project remove`](#lps-project-remove)
+* [`lps project rotate`](#lps-project-rotate)
 * [`lps project switch`](#lps-project-switch)
 * [`lps seo list`](#lps-seo-list)
 * [`lps seo pull [PATH]`](#lps-seo-pull-path)
@@ -107,7 +112,7 @@ EXAMPLES
   $ lps acf list --type field-groups
 ```
 
-_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/acf/list.ts)_
+_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/acf/list.ts)_
 
 ## `lps acf pull [PATH]`
 
@@ -136,7 +141,7 @@ EXAMPLES
   $ lps acf pull --type field-groups
 ```
 
-_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/acf/pull.ts)_
+_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/acf/pull.ts)_
 
 ## `lps acf push [PATH]`
 
@@ -165,7 +170,7 @@ EXAMPLES
   $ lps acf push --type field-groups
 ```
 
-_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/acf/push.ts)_
+_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/acf/push.ts)_
 
 ## `lps api list`
 
@@ -186,7 +191,30 @@ EXAMPLES
   $ lps api list
 ```
 
-_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/api/list.ts)_
+_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/api/list.ts)_
+
+## `lps api publish [PATH]`
+
+Publish custom API routes to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.
+
+```
+USAGE
+  $ lps api publish [PATH]
+
+ARGUMENTS
+  [PATH]  Path to api directory (overrides project config)
+
+DESCRIPTION
+  Publish custom API routes to your Loopress account so they can be deployed to other projects. Does not touch any
+  WordPress site.
+
+EXAMPLES
+  $ lps api publish
+
+  $ lps api publish --path ./api
+```
+
+_See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/api/publish.ts)_
 
 ## `lps api pull [PATH]`
 
@@ -213,7 +241,7 @@ EXAMPLES
   $ lps api pull --path ./api
 ```
 
-_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/api/pull.ts)_
+_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/api/pull.ts)_
 
 ## `lps api push [PATH]`
 
@@ -240,7 +268,7 @@ EXAMPLES
   $ lps api push --path ./api
 ```
 
-_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/api/push.ts)_
+_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/api/push.ts)_
 
 ## `lps composer init`
 
@@ -263,7 +291,7 @@ EXAMPLES
   $ lps composer init --dry-run
 ```
 
-_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/composer/init.ts)_
+_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/composer/init.ts)_
 
 ## `lps composer pull`
 
@@ -286,7 +314,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
@@ -310,7 +338,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/composer/push.ts)_
 
 ## `lps doctor`
 
@@ -332,7 +360,7 @@ EXAMPLES
   $ lps doctor --env production
 ```
 
-_See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/doctor.ts)_
+_See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/doctor.ts)_
 
 ## `lps form list`
 
@@ -353,7 +381,7 @@ EXAMPLES
   $ lps form list
 ```
 
-_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/form/list.ts)_
+_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/form/list.ts)_
 
 ## `lps form pull [PATH]`
 
@@ -378,7 +406,7 @@ EXAMPLES
   $ lps form pull
 ```
 
-_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/form/pull.ts)_
+_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/form/pull.ts)_
 
 ## `lps form push [PATH]`
 
@@ -404,7 +432,7 @@ EXAMPLES
   $ lps form push
 ```
 
-_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/form/push.ts)_
+_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/form/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -424,7 +452,7 @@ DESCRIPTION
   Display help for lps.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.53/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.55/src/commands/help.ts)_
 
 ## `lps init`
 
@@ -441,7 +469,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -458,7 +486,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -475,7 +503,78 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/logout.ts)_
+
+## `lps page list`
+
+List pages from WordPress
+
+```
+USAGE
+  $ lps page list [--env <value>] [-j]
+
+FLAGS
+  -j, --json         Output in JSON format
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+DESCRIPTION
+  List pages from WordPress
+
+EXAMPLES
+  $ lps page list
+```
+
+_See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/page/list.ts)_
+
+## `lps page pull [PATH]`
+
+Pull pages from WordPress
+
+```
+USAGE
+  $ lps page pull [PATH] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  [PATH]  Path to pages directory (overrides project config)
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+DESCRIPTION
+  Pull pages from WordPress
+
+EXAMPLES
+  $ lps page pull
+```
+
+_See code: [src/commands/page/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/page/pull.ts)_
+
+## `lps page push [PATH]`
+
+Push pages to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.
+
+```
+USAGE
+  $ lps page push [PATH] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  [PATH]  Path to pages directory (overrides project config)
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+DESCRIPTION
+  Push pages to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.
+
+EXAMPLES
+  $ lps page push
+```
+
+_See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/page/push.ts)_
 
 ## `lps plugin add SLUG`
 
@@ -501,7 +600,7 @@ EXAMPLES
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/plugin/add.ts)_
 
 ## `lps plugin pull`
 
@@ -524,7 +623,7 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
@@ -548,7 +647,7 @@ EXAMPLES
   $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
@@ -566,7 +665,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -583,7 +682,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/project/list.ts)_
 
 ## `lps project pull`
 
@@ -600,7 +699,7 @@ EXAMPLES
   $ lps project pull
 ```
 
-_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/project/pull.ts)_
+_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/project/pull.ts)_
 
 ## `lps project push`
 
@@ -620,7 +719,7 @@ EXAMPLES
   $ lps project push
 ```
 
-_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/project/push.ts)_
+_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/project/push.ts)_
 
 ## `lps project remove`
 
@@ -637,7 +736,29 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/project/remove.ts)_
+
+## `lps project rotate`
+
+Rotate the WordPress application password for the current (or --env) environment
+
+```
+USAGE
+  $ lps project rotate [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+DESCRIPTION
+  Rotate the WordPress application password for the current (or --env) environment
+
+EXAMPLES
+  $ lps project rotate
+
+  $ lps project rotate --env staging
+```
+
+_See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/project/rotate.ts)_
 
 ## `lps project switch`
 
@@ -654,7 +775,7 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/project/switch.ts)_
 
 ## `lps seo list`
 
@@ -678,7 +799,7 @@ EXAMPLES
   $ lps seo list --post-type post
 ```
 
-_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/seo/list.ts)_
+_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/seo/list.ts)_
 
 ## `lps seo pull [PATH]`
 
@@ -706,7 +827,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.19.0/src/commands/seo/pull.ts)_
+_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/seo/pull.ts)_
 
 ## `lps seo push [PATH]`
 
@@ -732,7 +853,7 @@ EXAMPLES
   $ lps seo push
 ```
 
-_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/seo/push.ts)_
+_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/seo/push.ts)_
 
 ## `lps snippet list`
 
@@ -753,7 +874,7 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet publish [PATH]`
 
@@ -776,7 +897,7 @@ EXAMPLES
   $ lps snippet publish --path ./snippets
 ```
 
-_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/snippet/publish.ts)_
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -803,7 +924,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -831,7 +952,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -853,7 +974,7 @@ EXAMPLES
   $ lps status --env staging
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/status.ts)_
 
 ## `lps telemetry disable`
 
@@ -870,7 +991,7 @@ EXAMPLES
   $ lps telemetry disable
 ```
 
-_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/telemetry/disable.ts)_
+_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/telemetry/disable.ts)_
 
 ## `lps telemetry enable`
 
@@ -887,5 +1008,5 @@ EXAMPLES
   $ lps telemetry enable
 ```
 
-_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.19.0/src/commands/telemetry/enable.ts)_
+_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.20.0/src/commands/telemetry/enable.ts)_
 <!-- commandsstop -->

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

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class Publish extends Command {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/api/publish.js

@@ -0,0 +1,60 @@
+import { Args, Command } from '@oclif/core';
+import { basename, join } from 'node:path';
+import { authManager } from '../../config/auth.manager.js';
+import { configManager } from '../../config/project-config.manager.js';
+import { ApiClient } from '../../lib/api-client.js';
+import { loadFiles } from '../../lib/load-files.js';
+import { readLocalConfig } from '../../utils/loopress-config.js';
+// Publishes to the Loopress api (not a WordPress site), so this does not extend
+// `LoopressCommand`/`PushCommand`: those force an environment to be resolved, but publishing
+// for cross-project sharing doesn't need one, same reasoning as `snippet publish`. An API route
+// is a special case of the same publish/deploy rules as snippets and ACF (see
+// obsidian/Product/API and Console Backlog.md, US-18): a `push` (direct to WordPress, this
+// project's own site) and a `publish` (to the cloud, deployable to other projects) are two
+// separate, coexisting paths.
+export default class Publish extends Command {
+    static args = {
+        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'];
+    async run() {
+        const { args } = await this.parse(Publish);
+        const token = process.env.LOOPRESS_TOKEN ?? authManager.getAuth()?.token;
+        if (!token) {
+            this.error('Not logged in. Run `lps login` first.');
+        }
+        const localConfig = await readLocalConfig();
+        const projectId = localConfig.projectId ?? configManager.getCurrentProject()?.id;
+        if (!projectId) {
+            this.error('No project configured. Run `lps project config` first.');
+        }
+        const project = configManager.getProject(projectId);
+        if (!project) {
+            this.error(`Project "${projectId}" (from loopress.json) not found. Run \`lps project config\` to configure it.`);
+        }
+        if (!project.apiProjectId) {
+            this.error(`Project "${project.name}" is not linked to your Loopress account yet. Run \`lps project push\` first.`);
+        }
+        const path = args.path ?? join(localConfig.rootDir ?? '.', localConfig.apiDir ?? 'api');
+        this.log(`Publishing API routes from ${path}`);
+        const files = await loadFiles(path, {
+            extension: '.php',
+            onSkip: (message) => this.warn(message),
+            parse: (raw, filePath) => ({ code: raw, filename: basename(filePath, '.php') }),
+        });
+        const api = new ApiClient(token);
+        try {
+            await api.post(`projects/${project.apiProjectId}/api-routes/publish/upsert`, {
+                routes: files,
+            });
+            await api.post(`projects/${project.apiProjectId}/api-routes/publish/prune`, {
+                filenames: files.map((file) => file.filename),
+            });
+        }
+        catch (error) {
+            this.error(error.message);
+        }
+        this.log(`Published ${files.length} route${files.length === 1 ? '' : 's'} to your Loopress account.`);
+    }
+}

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

@@ -12,4 +12,5 @@ export default class Push extends PushCommand {
     run(): Promise<void>;
     private loadFiles;
     private pushFile;
+    private syncApiRoutes;
 }

package/dist/commands/api/push.js

@@ -1,6 +1,8 @@
 import { Args } from '@oclif/core';
 import { Listr } from 'listr2';
 import { basename } 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';
 // Mirrors the server's own allowlist (wordpress-plugin ApiFilesController::FILENAME_PATTERN):
@@ -39,6 +41,7 @@ export default class Push extends PushCommand {
         if (this.dryRun)
             return;
         await this.recordSuccess();
+        await this.syncApiRoutes(files.map((file) => file.filename));
         this.log('All API routes pushed.');
     }
     async loadFiles(path) {
@@ -67,4 +70,20 @@ export default class Push extends PushCommand {
             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
+        }
+    }
 }

package/dist/commands/init.js

@@ -16,6 +16,7 @@ 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' },
 ];
 export default class Init extends Command {

package/dist/commands/page/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/page/list.js

@@ -0,0 +1,26 @@
+import { Flags } from '@oclif/core';
+import { LoopressCommand } from '../../lib/base.js';
+import { getPageId, getPageTitle, PAGE_ENDPOINT, PAGE_LIST_QUERY } from '../../utils/page-format.js';
+export default class List extends LoopressCommand {
+    static description = 'List pages from WordPress';
+    static examples = ['$ lps page list'];
+    static flags = {
+        json: Flags.boolean({ char: 'j', description: 'Output in JSON format' }),
+    };
+    async run() {
+        const { flags } = await this.parse(List);
+        const pages = await this.wp.get(`${PAGE_ENDPOINT}?${PAGE_LIST_QUERY}`);
+        if (flags.json) {
+            this.log(JSON.stringify(pages, null, 2));
+            return;
+        }
+        this.log(`Pages (${pages.length}):`);
+        if (pages.length === 0) {
+            this.log('  (none)');
+            return;
+        }
+        for (const page of pages) {
+            this.log(`  ${getPageId(page) ?? '(no id)'}. ${getPageTitle(page)}`);
+        }
+    }
+}

package/dist/commands/page/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: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}