@loopress/cli 0.11.0 → 0.13.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.11.0 linux-x64 node-v24.18.0
+@loopress/cli/0.13.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -61,6 +61,7 @@ report.
 * [`lps project switch`](#lps-project-switch)
 * [`lps project sync`](#lps-project-sync)
 * [`lps snippet list`](#lps-snippet-list)
+* [`lps snippet publish [PATH]`](#lps-snippet-publish-path)
 * [`lps snippet pull [PATH]`](#lps-snippet-pull-path)
 * [`lps snippet push [PATH]`](#lps-snippet-push-path)
 * [`lps status`](#lps-status)
@@ -85,7 +86,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
@@ -107,7 +108,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/composer/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -144,7 +145,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -161,7 +162,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -178,7 +179,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/logout.ts)_
 
 ## `lps plugin add SLUG [VERSION]`
 
@@ -206,7 +207,7 @@ EXAMPLES
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/plugin/add.ts)_
 
 ## `lps plugin pull`
 
@@ -228,7 +229,7 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
@@ -250,24 +251,25 @@ EXAMPLES
   $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
-Add or update a WordPress project environment
+Add or update a WordPress project environment. By default, authorizes via WordPress in your browser; manual username/Application Password entry is available as a fallback.
 
 ```
 USAGE
   $ lps project config
 
 DESCRIPTION
-  Add or update a WordPress project environment
+  Add or update a WordPress project environment. By default, authorizes via WordPress in your browser; manual
+  username/Application Password entry is available as a fallback.
 
 EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -284,7 +286,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/project/list.ts)_
 
 ## `lps project remove`
 
@@ -301,7 +303,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/project/remove.ts)_
 
 ## `lps project switch`
 
@@ -318,7 +320,7 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/project/switch.ts)_
 
 ## `lps project sync`
 
@@ -335,7 +337,7 @@ EXAMPLES
   $ lps project sync
 ```
 
-_See code: [src/commands/project/sync.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/project/sync.ts)_
+_See code: [src/commands/project/sync.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/project/sync.ts)_
 
 ## `lps snippet list`
 
@@ -355,7 +357,30 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/snippet/list.ts)_
+
+## `lps snippet publish [PATH]`
+
+Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.
+
+```
+USAGE
+  $ lps snippet publish [PATH]
+
+ARGUMENTS
+  [PATH]  Path to snippets directory (overrides project config)
+
+DESCRIPTION
+  Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress
+  site.
+
+EXAMPLES
+  $ lps snippet publish
+
+  $ lps snippet publish --path ./snippets
+```
+
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -380,7 +405,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -406,7 +431,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -423,5 +448,5 @@ EXAMPLES
   $ lps status
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.11.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.13.0/src/commands/status.ts)_
 <!-- commandsstop -->

package/dist/commands/login.d.ts

@@ -3,6 +3,5 @@ export default class Login extends Command {
     static description: string;
     static examples: string[];
     run(): Promise<void>;
-    private openBrowser;
     private waitForCallback;
 }

package/dist/commands/login.js

@@ -1,9 +1,7 @@
 import { Command } from '@oclif/core';
-import { exec } from 'node:child_process';
-import { createServer } from 'node:http';
 import { authManager } from '../config/auth.manager.js';
+import { renderResultPage, waitForLocalCallback } from '../lib/local-callback-server.js';
 const CONSOLE_URL = 'https://console.loopress.dev';
-const TIMEOUT_MS = 5 * 60 * 1000;
 export default class Login extends Command {
     static description = 'Log in to the Loopress console';
     static examples = ['$ lps login'];
@@ -12,95 +10,28 @@ export default class Login extends Command {
         authManager.setAuth({ email, savedAt: new Date().toISOString(), token });
         this.log(`\nLogged in${email ? ` as ${email}` : ''}. You're all set!`);
     }
-    openBrowser(url) {
-        const cmds = {
-            darwin: `open "${url}"`,
-            linux: `xdg-open "${url}"`,
-            win32: `start "" "${url}"`,
-        };
-        const cmd = cmds[process.platform];
-        if (cmd)
-            exec(cmd);
-    }
     waitForCallback() {
-        return new Promise((resolve, reject) => {
-            const server = createServer((req, res) => {
-                try {
-                    const url = new URL(req.url ?? '/', 'http://localhost');
-                    const token = url.searchParams.get('token');
-                    const email = url.searchParams.get('email') ?? undefined;
-                    if (!token) {
-                        res.writeHead(400, { 'Content-Type': 'text/plain' });
-                        res.end('Missing token');
-                        return;
-                    }
-                    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-                    res.end(SUCCESS_PAGE);
-                    clearTimeout(timer);
-                    server.close();
-                    resolve({ email, token });
-                }
-                catch (error) {
-                    res.writeHead(500);
-                    res.end('Internal error');
-                    server.close();
-                    reject(error);
+        return waitForLocalCallback({
+            buildUrl: (callbackBaseUrl) => `${CONSOLE_URL}/cli-auth?callbackUrl=${encodeURIComponent(`${callbackBaseUrl}/callback`)}`,
+            handleRequest(url, { resolveWithPage, respondBadRequest }) {
+                const token = url.searchParams.get('token');
+                const email = url.searchParams.get('email') ?? undefined;
+                if (!token) {
+                    respondBadRequest('Missing token');
+                    return;
                 }
-            });
-            server.on('error', (err) => {
-                clearTimeout(timer);
-                reject(err);
-            });
-            const timer = setTimeout(() => {
-                server.close();
-                reject(new Error('Login timed out after 5 minutes. Please try again.'));
-            }, TIMEOUT_MS);
-            server.listen(0, '127.0.0.1', () => {
-                const { port } = server.address();
-                const callbackUrl = `http://localhost:${port}/callback`;
-                const loginUrl = `${CONSOLE_URL}/cli-auth?callbackUrl=${encodeURIComponent(callbackUrl)}`;
-                this.log('Opening Loopress console in your browser...');
-                this.log(`\nIf it doesn't open automatically, visit:\n${loginUrl}\n`);
-                this.openBrowser(loginUrl);
-            });
+                resolveWithPage(SUCCESS_PAGE, { email, token });
+            },
+            log: (message) => this.log(message),
+            openingMessage: 'Opening Loopress console in your browser...',
+            timeoutMessage: 'Login timed out after 5 minutes. Please try again.',
         });
     }
 }
-const SUCCESS_PAGE = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Loopress: Logged in</title>
-  <style>
-    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
-    body {
-      font-family: system-ui, -apple-system, sans-serif;
-      background: #f0fdf4;
-      display: flex;
-      align-items: center;
-      justify-content: center;
-      min-height: 100dvh;
-    }
-    .card {
-      background: #fff;
-      border-radius: 16px;
-      padding: 2.5rem 3rem;
-      text-align: center;
-      box-shadow: 0 4px 32px rgba(0, 0, 0, .08);
-      max-width: 420px;
-      width: 90%;
-    }
-    .icon { font-size: 3rem; margin-bottom: 1rem; }
-    h1 { color: #15803d; font-size: 1.5rem; margin-bottom: .5rem; }
-    p { color: #6b7280; font-size: .95rem; line-height: 1.5; }
-  </style>
-</head>
-<body>
-  <div class="card">
-    <div class="icon">✅</div>
-    <h1>Login successful!</h1>
-    <p>You can close this tab and return to your terminal.</p>
-  </div>
-</body>
-</html>`;
+const SUCCESS_PAGE = renderResultPage({
+    background: '#f0fdf4',
+    heading: 'Login successful!',
+    headingColor: '#15803d',
+    icon: '✅',
+    tabTitle: 'Logged in',
+});

package/dist/commands/project/config.d.ts

@@ -3,5 +3,7 @@ export default class Config extends Command {
     static description: string;
     static examples: string[];
     run(): Promise<void>;
+    private promptManualCredentials;
+    private resolveCredentials;
     private resolveProject;
 }

package/dist/commands/project/config.js

@@ -1,9 +1,13 @@
 import { confirm, input, password as passwordPrompt, select } from '@inquirer/prompts';
 import { Command } from '@oclif/core';
 import { configManager } from '../../config/project-config.manager.js';
+import { authorizeWithBrowser } from '../../lib/wp-authorize-flow.js';
+import { diagnoseWpSite } from '../../lib/wp-site-diagnostic.js';
 const NEW_PROJECT = '__new__';
+const AUTH_BROWSER = 'browser';
+const AUTH_MANUAL = 'manual';
 export default class Config extends Command {
-    static description = 'Add or update a WordPress project environment';
+    static description = 'Add or update a WordPress project environment. By default, authorizes via WordPress in your browser; manual username/Application Password entry is available as a fallback.';
     static examples = ['$ lps project config'];
     async run() {
         await this.parse(Config);
@@ -34,7 +38,7 @@ export default class Config extends Command {
                 return;
             }
         }
-        const url = await input({
+        const rawUrl = await input({
             message: 'WordPress URL',
             validate(value) {
                 try {
@@ -49,15 +53,8 @@ export default class Config extends Command {
                 }
             },
         });
-        const user = await input({
-            message: 'Username',
-            validate: (value) => (value.trim().length > 0 ? true : 'Username cannot be empty'),
-        });
-        const appPassword = await passwordPrompt({
-            mask: '*',
-            message: 'Application password',
-            validate: (value) => (value.trim().length > 0 ? true : 'Application password cannot be empty'),
-        });
+        const url = rawUrl.replace(/\/+$/, '');
+        const { appPassword, user } = await this.resolveCredentials(url);
         const token = `${user}:${appPassword}`;
         const env = {
             addedAt: new Date().toISOString(),
@@ -79,6 +76,43 @@ export default class Config extends Command {
         this.log(`✓ "${projectName}/${envName}" configured`);
         this.log('→ Run `lps project switch` to change the active project or environment');
     }
+    async promptManualCredentials() {
+        const user = await input({
+            message: 'Username',
+            validate: (value) => (value.trim().length > 0 ? true : 'Username cannot be empty'),
+        });
+        const appPassword = await passwordPrompt({
+            mask: '*',
+            message: 'Application password',
+            validate: (value) => (value.trim().length > 0 ? true : 'Application password cannot be empty'),
+        });
+        return { appPassword, user };
+    }
+    async resolveCredentials(url) {
+        const authMode = await select({
+            choices: [
+                { name: 'Authorize in my browser (recommended)', value: AUTH_BROWSER },
+                { name: 'Enter credentials manually', value: AUTH_MANUAL },
+            ],
+            message: 'How do you want to authenticate?',
+        });
+        if (authMode === AUTH_MANUAL) {
+            return this.promptManualCredentials();
+        }
+        const diagnostic = await diagnoseWpSite(url);
+        if (!diagnostic.ok) {
+            this.warn(`${diagnostic.reason}\nFalling back to manual credential entry.`);
+            return this.promptManualCredentials();
+        }
+        try {
+            const { password, userLogin } = await authorizeWithBrowser(url, (message) => this.log(message));
+            return { appPassword: password, user: userLogin };
+        }
+        catch (error) {
+            this.warn(`${error.message}\nFalling back to manual credential entry.`);
+            return this.promptManualCredentials();
+        }
+    }
     async resolveProject() {
         const projects = configManager.listProjects();
         if (projects.length > 0) {

package/dist/commands/project/sync.js

@@ -184,12 +184,22 @@ export default class Sync extends Command {
         return { action: 'create', project };
     }
     pullProject(apiProject, task) {
-        const environments = {};
+        // Reuse a local project already linked to this API project instead of always minting a
+        // new one: otherwise every sync run that can't "claim" an existing link (e.g. after the
+        // local config was reset or desynced from the API) creates yet another duplicate entry.
+        const existing = configManager.findProjectByApiId(apiProject.id);
+        const environments = { ...existing?.environments };
         for (const env of apiProject.environments) {
-            environments[env.name] = { addedAt: env.createdAt, apiEnvironmentId: env.id, name: env.name, url: env.url };
-        }
-        configManager.setProject(configManager.createProjectId(apiProject.name), {
-            addedAt: apiProject.createdAt,
+            environments[env.name] = {
+                ...environments[env.name],
+                addedAt: environments[env.name]?.addedAt ?? env.createdAt,
+                apiEnvironmentId: env.id,
+                name: env.name,
+                url: env.url,
+            };
+        }
+        configManager.setProject(existing?.id ?? configManager.createProjectId(apiProject.name), {
+            addedAt: existing?.addedAt ?? apiProject.createdAt,
             apiProjectId: apiProject.id,
             environments,
             name: apiProject.name,

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

@@ -0,0 +1,10 @@
+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>;
+    private toPayload;
+}

package/dist/commands/snippet/publish.js

@@ -0,0 +1,74 @@
+import { Args, Command } from '@oclif/core';
+import { join } from 'node:path';
+import slugify from 'slugify';
+import { authManager } from '../../config/auth.manager.js';
+import { configManager } from '../../config/project-config.manager.js';
+import { ApiClient } from '../../lib/api-client.js';
+import { loadSnippets } from '../../lib/load-snippets.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 a project
+// publishing its snippets for sharing doesn't need one, a pure "library" project 
+// may have zero environments configured at all.
+export default class Publish extends Command {
+    static args = {
+        path: Args.string({ description: 'Path to snippets directory (overrides project config)' }),
+    };
+    static description = 'Publish snippets to your Loopress account so they can be deployed to other projects. Does not touch any WordPress site.';
+    static examples = ['$ lps snippet publish', '$ lps snippet publish --path ./snippets'];
+    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 sync\` first.`);
+        }
+        const path = args.path ?? join(localConfig.rootDir ?? '.', localConfig.snippetsDir ?? 'snippets');
+        this.log(`Publishing snippets from ${path}`);
+        let snippets;
+        try {
+            snippets = await loadSnippets(path);
+        }
+        catch (error) {
+            this.error(error.message);
+        }
+        const api = new ApiClient(token);
+        try {
+            await api.post(`projects/${project.apiProjectId}/snippets/publish`, {
+                snippets: snippets.map((snippet) => this.toPayload(snippet)),
+            });
+        }
+        catch (error) {
+            this.error(error.message);
+        }
+        this.log(`Published ${snippets.length} snippet${snippets.length === 1 ? '' : 's'} to your Loopress account.`);
+    }
+    toPayload(snippet) {
+        return {
+            active: snippet.active,
+            code: snippet.code,
+            insertMethod: snippet.insertMethod,
+            location: snippet.location,
+            name: snippet.name,
+            priority: snippet.priority,
+            shortcodeAttributes: snippet.shortcodeAttributes,
+            // Derived from the snippet's name rather than its on-disk filename: the same
+            // slugification `push`/`pull` already use for the canonical `<id>-<slug>` filename
+            // convention, so it stays stable even for a not-yet-pushed file with an arbitrary name.
+            slug: slugify(snippet.name, { lower: true, strict: true }),
+            tags: snippet.tags,
+            type: snippet.type,
+        };
+    }
+}

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

@@ -12,4 +12,5 @@ export default class Pull extends LoopressCommand {
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    private findOrphanedFiles;
 }

package/dist/commands/snippet/pull.js

@@ -1,7 +1,7 @@
 import { Args } from '@oclif/core';
 import { Listr } from 'listr2';
-import { mkdir, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
+import { mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import { extname, join } from 'node:path';
 import slugify from 'slugify';
 import { LoopressCommand } from '../../lib/base.js';
 import { normalizeSnippet, SNIPPETS_ENDPOINT } from '../../utils/snippet-format.js';
@@ -55,13 +55,20 @@ export default class Pull extends LoopressCommand {
         this.log(`Snippets path: ${path}`);
         const remoteList = await this.wp.get(SNIPPETS_ENDPOINT);
         const snippets = remoteList.map((r) => normalizeSnippet(r));
+        const pullable = snippets.filter((snippet) => snippet.name.trim());
+        const skipped = snippets.length - pullable.length;
+        // Files following the `<id>-<slug>` convention whose id is no longer in the current
+        // remote list belong to a snippet that was deleted on WordPress. Left on disk, they'd
+        // silently come back to life the next time `snippet push` runs.
+        const orphans = await this.findOrphanedFiles(path, new Set(pullable.map((snippet) => snippet.id)));
         if (this.dryRun) {
             this.log(`[dry-run] Would pull ${snippets.length} snippet${snippets.length === 1 ? '' : 's'} to ${path}`);
+            if (orphans.length > 0) {
+                this.log(`[dry-run] Would remove ${orphans.length} local file${orphans.length === 1 ? '' : 's'} whose snippet no longer exists on WordPress: ${orphans.join(', ')}`);
+            }
             return;
         }
         await mkdir(path, { recursive: true });
-        const pullable = snippets.filter((snippet) => snippet.name.trim());
-        const skipped = snippets.length - pullable.length;
         await new Listr(pullable.map((snippet) => ({
             async task(_ctx, task) {
                 const ext = EXTENSIONS[snippet.type];
@@ -73,9 +80,36 @@ export default class Pull extends LoopressCommand {
             },
             title: `Pull ${snippet.name}`,
         }))).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 snippet no longer exists on WordPress: ${orphans.join(', ')}`);
+        }
         this.log(`Pulled ${pullable.length} snippet${pullable.length === 1 ? '' : 's'} to ${path}`);
         if (skipped > 0) {
             this.warn(`${skipped} snippet${skipped === 1 ? '' : 's'} skipped because they have no name`);
         }
     }
+    // Only ever matches files already following the `<id>-<slug>` convention that `snippet
+    // pull`/`push` themselves produce, so a hand-created file without a numeric prefix is
+    // never at risk of being picked up here.
+    async findOrphanedFiles(path, keepIds) {
+        let files;
+        try {
+            files = await readdir(path);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        const knownExtensions = new Set(['json', ...Object.values(EXTENSIONS)]);
+        return files.filter((file) => {
+            const ext = extname(file).slice(1);
+            if (!knownExtensions.has(ext))
+                return false;
+            const match = /^(\d+)-/.exec(file);
+            return match !== null && !keepIds.has(Number(match[1]));
+        });
+    }
 }