@loopress/cli 0.10.0 → 0.12.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.10.0 linux-x64 node-v24.18.0
+@loopress/cli/0.12.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -59,6 +59,7 @@ report.
 * [`lps project list`](#lps-project-list)
 * [`lps project remove`](#lps-project-remove)
 * [`lps project switch`](#lps-project-switch)
+* [`lps project sync`](#lps-project-sync)
 * [`lps snippet list`](#lps-snippet-list)
 * [`lps snippet pull [PATH]`](#lps-snippet-pull-path)
 * [`lps snippet push [PATH]`](#lps-snippet-push-path)
@@ -84,7 +85,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
@@ -106,7 +107,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/composer/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -143,7 +144,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -160,7 +161,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -177,7 +178,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/logout.ts)_
 
 ## `lps plugin add SLUG [VERSION]`
 
@@ -205,7 +206,7 @@ EXAMPLES
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/plugin/add.ts)_
 
 ## `lps plugin pull`
 
@@ -227,7 +228,7 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
@@ -249,7 +250,7 @@ EXAMPLES
   $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
@@ -266,7 +267,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -283,7 +284,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/list.ts)_
 
 ## `lps project remove`
 
@@ -300,7 +301,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/remove.ts)_
 
 ## `lps project switch`
 
@@ -317,7 +318,24 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/switch.ts)_
+
+## `lps project sync`
+
+Sync locally configured projects and environments with your Loopress account
+
+```
+USAGE
+  $ lps project sync
+
+DESCRIPTION
+  Sync locally configured projects and environments with your Loopress account
+
+EXAMPLES
+  $ lps project sync
+```
+
+_See code: [src/commands/project/sync.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/project/sync.ts)_
 
 ## `lps snippet list`
 
@@ -325,23 +343,19 @@ List snippets from WordPress
 
 ```
 USAGE
-  $ lps snippet list [-j] [-p code-snippets|wpcode]
+  $ lps snippet list [-j]
 
 FLAGS
-  -j, --json             Output in JSON format
-  -p, --plugin=<option>  WordPress snippet plugin to target (overrides loopress.json)
-                         <options: code-snippets|wpcode>
+  -j, --json  Output in JSON format
 
 DESCRIPTION
   List snippets from WordPress
 
 EXAMPLES
   $ lps snippet list
-
-  $ lps snippet list --plugin wpcode
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -349,15 +363,13 @@ Pull snippets from WordPress
 
 ```
 USAGE
-  $ lps snippet pull [PATH] [-d] [-p code-snippets|wpcode]
+  $ lps snippet pull [PATH] [-d]
 
 ARGUMENTS
   [PATH]  Path to snippets directory (overrides project config)
 
 FLAGS
-  -d, --dry-run          Show what would change without making changes
-  -p, --plugin=<option>  WordPress snippet plugin to target (overrides loopress.json)
-                         <options: code-snippets|wpcode>
+  -d, --dry-run  Show what would change without making changes
 
 DESCRIPTION
   Pull snippets from WordPress
@@ -366,11 +378,9 @@ EXAMPLES
   $ lps snippet pull
 
   $ lps snippet pull --path ./snippets
-
-  $ lps snippet pull --plugin wpcode
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -378,15 +388,13 @@ Push snippets to WordPress. Local snippet files created or updated remotely are
 
 ```
 USAGE
-  $ lps snippet push [PATH] [-d] [-p code-snippets|wpcode]
+  $ lps snippet push [PATH] [-d]
 
 ARGUMENTS
   [PATH]  Path to snippets directory (overrides project config)
 
 FLAGS
-  -d, --dry-run          Show what would change without making changes
-  -p, --plugin=<option>  WordPress snippet plugin to target (overrides loopress.json)
-                         <options: code-snippets|wpcode>
+  -d, --dry-run  Show what would change without making changes
 
 DESCRIPTION
   Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>`
@@ -396,11 +404,9 @@ EXAMPLES
   $ lps snippet push
 
   $ lps snippet push --path ./snippets
-
-  $ lps snippet push --plugin wpcode
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -417,5 +423,5 @@ EXAMPLES
   $ lps status
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.10.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.12.0/src/commands/status.ts)_
 <!-- commandsstop -->

package/dist/commands/init.js

@@ -3,7 +3,13 @@ import { Command } from '@oclif/core';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { configManager } from '../config/project-config.manager.js';
-import { writeLocalConfig } from '../utils/loopress-config.js';
+import { readLocalConfig, writeLocalConfig } from '../utils/loopress-config.js';
+// WordPress.org slugs for the two snippet plugins the Loopress WordPress plugin supports
+// (see SnippetModule.php, which wires up both providers and auto-detects the active one).
+const SNIPPET_PROVIDERS = [
+    { name: 'Code Snippets', slug: 'code-snippets' },
+    { name: 'WPCode', slug: 'insert-headers-and-footers' },
+];
 export default class Init extends Command {
     static description = 'Initialize a loopress.json config file in the current directory';
     static examples = ['$ lps init'];
@@ -52,13 +58,6 @@ export default class Init extends Command {
             });
             projectLabel = projectId;
         }
-        const snippetPlugin = await select({
-            choices: [
-                { name: 'WPCode', value: 'wpcode' },
-                { name: 'Code Snippets', value: 'code-snippets' },
-            ],
-            message: 'Snippet plugin',
-        });
         const rootDir = await input({
             default: '.',
             message: 'Root directory',
@@ -67,16 +66,31 @@ export default class Init extends Command {
             default: 'snippets',
             message: 'Snippets directory (relative to root)',
         });
+        const providerChoice = await select({
+            choices: [...SNIPPET_PROVIDERS.map((p) => ({ name: p.name, value: p.slug })), { name: 'None / already installed', value: '__none__' }],
+            message: 'Snippet provider',
+        });
         const config = {
             projectId,
             rootDir,
-            snippetPlugin: snippetPlugin,
             snippetsDir,
         };
         await writeLocalConfig(config);
+        let providerVersion;
+        if (providerChoice !== '__none__') {
+            try {
+                await this.config.runCommand('plugin:add', [providerChoice]);
+                providerVersion = (await readLocalConfig()).plugins?.[providerChoice];
+            }
+            catch (error) {
+                this.warn(error.message);
+            }
+        }
         this.log(`\n✓ loopress.json created`);
         this.log(`  Project:  ${projectLabel}`);
-        this.log(`  Plugin:   ${snippetPlugin}`);
         this.log(`  Snippets: ${join(rootDir, snippetsDir)}`);
+        if (providerChoice !== '__none__' && providerVersion) {
+            this.log(`  Plugin:   ${providerChoice}@${providerVersion}`);
+        }
     }
 }

package/dist/commands/project/config.js

@@ -106,6 +106,6 @@ export default class Config extends Command {
                 return true;
             },
         });
-        return { projectId: configManager.createProjectId(), projectName: projectName.trim() };
+        return { projectId: configManager.createProjectId(projectName.trim()), projectName: projectName.trim() };
     }
 }

package/dist/commands/project/remove.js

@@ -17,13 +17,14 @@ export default class Remove extends Command {
             const currentMarker = project.isCurrent ? ' [current]' : '';
             targets.push({ kind: 'project', projectId: project.id, projectName: project.name });
             const projectChoice = {
-                name: `${project.isCurrent ? '●' : '○'} ${project.name.padEnd(20)} (${envLabel})${currentMarker}`,
+                description: 'Also removes all its environments below.',
+                name: `${project.name.padEnd(20)} (${envLabel})${currentMarker}`,
                 value: String(targets.length - 1),
             };
             const envChoices = configManager.listEnvironments(project.id).map((env) => {
                 targets.push({ env: env.name, kind: 'env', projectId: project.id, projectName: project.name });
                 return {
-                    name: `    ${env.isCurrent ? '●' : '○'} ${env.name.padEnd(20)} ${env.url}${env.isCurrent ? ' [current]' : ''}`,
+                    name: `    ${env.name.padEnd(20)} ${env.url}${env.isCurrent ? ' [current]' : ''}`,
                     value: String(targets.length - 1),
                 };
             });

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

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

package/dist/commands/project/switch.js

@@ -1,6 +1,7 @@
-import { select } from '@inquirer/prompts';
-import { Command } from '@oclif/core';
+import { select, Separator } from '@inquirer/prompts';
+import { Command, ux } from '@oclif/core';
 import { configManager } from '../../config/project-config.manager.js';
+const c = ux.colorize;
 export default class Switch extends Command {
     static description = 'Switch the active project and environment';
     static examples = ['$ lps project switch'];
@@ -10,44 +11,37 @@ export default class Switch extends Command {
         if (projects.length === 0) {
             this.error('No projects configured. Run `lps project config` first.');
         }
-        const { id: projectId, name: projectName } = await this.resolveProject(projects);
-        const envName = await this.resolveEnvironment(projectId, projectName);
+        const { envName, projectId, projectName } = await this.resolveSelection(projects);
         configManager.setCurrent(projectId, envName);
         this.log(`✓ Switched to "${projectName}/${envName}"`);
     }
-    async resolveEnvironment(projectId, projectName) {
-        const envs = configManager.listEnvironments(projectId);
-        if (envs.length === 0) {
-            this.error(`No environments configured for "${projectName}". Run \`lps project config\` first.`);
+    async resolveSelection(projects) {
+        const groups = projects
+            .map((project) => ({ envs: configManager.listEnvironments(project.id), project }))
+            .filter(({ envs }) => envs.length > 0);
+        if (groups.length === 0) {
+            this.error('No environments configured. Run `lps project config` first.');
         }
-        if (envs.length === 1)
-            return envs[0].name;
-        return select({
-            choices: envs.map((env) => ({
-                name: `${env.isCurrent ? '●' : '○'} ${env.name.padEnd(20)} ${env.url}${env.isCurrent ? ' [current]' : ''}`,
-                value: env.name,
+        const entries = groups.flatMap(({ envs, project }) => envs.map((env) => ({ env, project })));
+        if (entries.length === 1) {
+            const { env, project } = entries[0];
+            return { envName: env.name, projectId: project.id, projectName: project.name };
+        }
+        const choices = groups.flatMap(({ envs, project }) => [
+            new Separator(project.isCurrent ? c('green', `─── ${project.name} ───`) : c('dim', `─── ${project.name} ───`)),
+            ...envs.map((env) => ({
+                name: `${env.name.padEnd(20)} ${env.url}${env.isCurrent ? ' [current]' : ''}`,
+                value: `${project.id}::${env.name}`,
             })),
-            default: envs.find((env) => env.isCurrent)?.name,
-            message: `Select environment for "${projectName}"`,
-        });
-    }
-    async resolveProject(projects) {
-        if (projects.length === 1)
-            return { id: projects[0].id, name: projects[0].name };
+        ]);
+        const current = entries.find(({ env }) => env.isCurrent);
         const chosen = await select({
-            choices: projects.map((project) => {
-                const envCount = Object.keys(project.environments).length;
-                const envLabel = `${envCount} env${envCount > 1 ? 's' : ''}`;
-                const currentMarker = project.isCurrent ? ' [current]' : '';
-                return {
-                    name: `${project.isCurrent ? '●' : '○'} ${project.name.padEnd(20)} (${envLabel})${currentMarker}`,
-                    value: project.id,
-                };
-            }),
-            default: projects.find((project) => project.isCurrent)?.id,
-            message: 'Select active project',
+            choices,
+            default: current && `${current.project.id}::${current.env.name}`,
+            message: 'Select project / environment',
         });
-        const project = projects.find((p) => p.id === chosen);
-        return { id: project.id, name: project.name };
+        const [projectId, envName] = chosen.split('::');
+        const { project } = groups.find((group) => group.project.id === projectId);
+        return { envName, projectId, projectName: project.name };
     }
 }

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

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class Sync extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private applyEnvironment;
+    private applyProject;
+    private fetchApiProjects;
+    private planEnvironment;
+    private planProject;
+    private pullProject;
+    private pushCredentials;
+}

package/dist/commands/project/sync.js

@@ -0,0 +1,220 @@
+import { confirm } from '@inquirer/prompts';
+import { Command } from '@oclif/core';
+import { Listr } from 'listr2';
+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';
+export default class Sync extends Command {
+    static description = 'Sync locally configured projects and environments with your Loopress account';
+    static examples = ['$ lps project sync'];
+    async run() {
+        await this.parse(Sync);
+        const token = authManager.getAuth()?.token;
+        if (!token) {
+            this.error('Not logged in. Run `lps login` first.');
+        }
+        const projects = configManager.listProjects();
+        if (projects.length === 0) {
+            this.log('No projects configured. Run `lps project config` first.');
+            return;
+        }
+        const api = new ApiClient(token);
+        const apiProjects = await this.fetchApiProjects(api);
+        const claimedProjectIds = new Set();
+        const envPlansByProject = new Map();
+        const projectPlans = [];
+        for (const project of projects) {
+            const plan = await this.planProject(project, apiProjects, claimedProjectIds);
+            projectPlans.push(plan);
+            const apiProject = plan.apiProjectId ? apiProjects.find((candidate) => candidate.id === plan.apiProjectId) : undefined;
+            const claimedEnvironmentIds = new Set();
+            const envPlans = [];
+            for (const env of configManager.listEnvironments(project.id)) {
+                envPlans.push(plan.action === 'create'
+                    ? { action: 'create', env, projectId: project.id }
+                    : await this.planEnvironment(env, project.id, apiProject, claimedEnvironmentIds));
+            }
+            envPlansByProject.set(project.id, envPlans);
+        }
+        let projectCount = projectPlans.filter((plan) => plan.action === 'synced').length;
+        let environmentCount = [...envPlansByProject.values()].flat().filter((plan) => plan.action === 'synced').length;
+        const projectsNeedingWork = projectPlans.filter((plan) => plan.action !== 'synced');
+        if (projectsNeedingWork.length > 0) {
+            await new Listr(projectsNeedingWork.map((plan) => ({
+                task: async (_ctx, task) => {
+                    await this.applyProject(api, plan, task);
+                    projectCount++;
+                },
+                title: plan.action === 'create'
+                    ? `Create project "${plan.project.name}" on the API`
+                    : `Link project "${plan.project.name}" to the API`,
+            })), { concurrent: false, exitOnError: false }).run();
+        }
+        const envsNeedingWork = projectPlans
+            .filter((plan) => Boolean(plan.apiProjectId))
+            .flatMap((plan) => (envPlansByProject.get(plan.project.id) ?? [])
+            .filter((envPlan) => envPlan.action !== 'synced')
+            .map((envPlan) => ({ apiProjectId: plan.apiProjectId, envPlan, projectName: plan.project.name })));
+        if (envsNeedingWork.length > 0) {
+            await new Listr(envsNeedingWork.map(({ apiProjectId, envPlan, projectName }) => ({
+                task: async (_ctx, task) => {
+                    await this.applyEnvironment(api, apiProjectId, envPlan, task);
+                    environmentCount++;
+                },
+                title: envPlan.action === 'create'
+                    ? `Create environment "${envPlan.env.name}" on "${projectName}"`
+                    : `Link environment "${envPlan.env.name}" on "${projectName}"`,
+            })), { concurrent: false, exitOnError: false }).run();
+        }
+        for (const plan of projectPlans) {
+            if (!plan.apiProjectId)
+                continue;
+            for (const envPlan of envPlansByProject.get(plan.project.id) ?? []) {
+                if (!envPlan.apiEnvironmentId || !envPlan.env.token)
+                    continue;
+                try {
+                    await this.pushCredentials(api, plan.apiProjectId, envPlan.apiEnvironmentId, envPlan.env);
+                }
+                catch (error) {
+                    this.warn(`Failed to sync "${plan.project.name}/${envPlan.env.name}": ${error.message}`);
+                }
+            }
+        }
+        const newApiProjects = apiProjects.filter((candidate) => !claimedProjectIds.has(candidate.id));
+        if (newApiProjects.length > 0) {
+            await new Listr(newApiProjects.map((apiProject) => ({
+                task: async (_ctx, task) => {
+                    this.pullProject(apiProject, task);
+                    projectCount++;
+                    environmentCount += apiProject.environments.length;
+                },
+                title: `Pull project "${apiProject.name}" from the API`,
+            })), { concurrent: false, exitOnError: false }).run();
+        }
+        this.log(`\n✓ Synced ${projectCount} project${projectCount === 1 ? '' : 's'}, ${environmentCount} environment${environmentCount === 1 ? '' : 's'} with your Loopress account`);
+    }
+    async applyEnvironment(api, apiProjectId, envPlan, task) {
+        try {
+            if (envPlan.action === 'create') {
+                const created = await api.post(`projects/${apiProjectId}/environments`, {
+                    name: envPlan.env.name,
+                    url: envPlan.env.url,
+                });
+                envPlan.apiEnvironmentId = created.id;
+            }
+            if (!envPlan.apiEnvironmentId) {
+                throw new Error(`No API environment id resolved for "${envPlan.env.name}" (action: ${envPlan.action})`);
+            }
+            configManager.setEnvironmentApiId(envPlan.projectId, envPlan.env.name, envPlan.apiEnvironmentId);
+            if (task)
+                task.output = envPlan.action === 'create' ? 'Created on the API' : 'Linked to the API';
+        }
+        catch (error) {
+            const message = `Failed to sync "${envPlan.env.name}": ${error.message}`;
+            if (task)
+                task.output = message;
+            throw error;
+        }
+    }
+    async applyProject(api, plan, task) {
+        try {
+            if (plan.action === 'create') {
+                const created = await api.post('projects', { name: plan.project.name });
+                plan.apiProjectId = created.id;
+            }
+            if (!plan.apiProjectId) {
+                throw new Error(`No API project id resolved for "${plan.project.name}" (action: ${plan.action})`);
+            }
+            configManager.setProjectApiId(plan.project.id, plan.apiProjectId);
+            if (task)
+                task.output = plan.action === 'create' ? 'Created on the API' : 'Linked to the API';
+        }
+        catch (error) {
+            const message = `Failed to sync project "${plan.project.name}": ${error.message}`;
+            if (task)
+                task.output = message;
+            throw error;
+        }
+    }
+    async fetchApiProjects(api) {
+        try {
+            return await api.get('projects');
+        }
+        catch (error) {
+            this.warn(`Could not fetch existing projects from the API, will create everything as new: ${error.message}`);
+            return [];
+        }
+    }
+    async planEnvironment(env, projectId, apiProject, claimedEnvironmentIds) {
+        if (env.apiEnvironmentId) {
+            claimedEnvironmentIds.add(env.apiEnvironmentId);
+            return { action: 'synced', apiEnvironmentId: env.apiEnvironmentId, env, projectId };
+        }
+        const match = apiProject?.environments.find((candidate) => candidate.name === env.name && !claimedEnvironmentIds.has(candidate.id));
+        if (match) {
+            const link = await confirm({
+                default: true,
+                message: `Environment "${env.name}" already exists on "${apiProject?.name}". Link to it instead of creating a new one?`,
+            });
+            if (link) {
+                claimedEnvironmentIds.add(match.id);
+                return { action: 'link', apiEnvironmentId: match.id, env, projectId };
+            }
+        }
+        return { action: 'create', env, projectId };
+    }
+    async planProject(project, apiProjects, claimedProjectIds) {
+        if (project.apiProjectId) {
+            claimedProjectIds.add(project.apiProjectId);
+            return { action: 'synced', apiProjectId: project.apiProjectId, project };
+        }
+        const slug = slugify(project.name, { lower: true, strict: true });
+        const match = apiProjects.find((candidate) => candidate.slug === slug && !claimedProjectIds.has(candidate.id));
+        if (match) {
+            const link = await confirm({
+                default: true,
+                message: `A project named "${project.name}" already exists on your account. Link to it instead of creating a new one?`,
+            });
+            if (link) {
+                claimedProjectIds.add(match.id);
+                return { action: 'link', apiProjectId: match.id, project };
+            }
+        }
+        return { action: 'create', project };
+    }
+    pullProject(apiProject, task) {
+        // 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] = {
+                ...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,
+        });
+        const envCount = apiProject.environments.length;
+        if (task)
+            task.output = `Pulled with ${envCount} environment${envCount === 1 ? '' : 's'}`;
+    }
+    async pushCredentials(api, apiProjectId, apiEnvironmentId, env) {
+        if (!env.token)
+            return;
+        const [username, ...rest] = env.token.split(':');
+        await api.put(`projects/${apiProjectId}/environments/${apiEnvironmentId}/credentials`, {
+            password: rest.join(':'),
+            username,
+        });
+    }
+}

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

@@ -3,7 +3,6 @@ export default class List extends LoopressCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        plugin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;