@loopress/cli 0.6.0 → 0.7.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.6.0 linux-x64 node-v24.17.0
+@loopress/cli/0.7.0 linux-x64 node-v24.18.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -43,16 +43,15 @@ USAGE
 * [`lps project config`](#lps-project-config)
 * [`lps project list`](#lps-project-list)
 * [`lps project remove`](#lps-project-remove)
-* [`lps project remove-env`](#lps-project-remove-env)
 * [`lps project switch`](#lps-project-switch)
-* [`lps project switch-env`](#lps-project-switch-env)
 * [`lps snippet list`](#lps-snippet-list)
 * [`lps snippet pull [PATH]`](#lps-snippet-pull-path)
 * [`lps snippet push [PATH]`](#lps-snippet-push-path)
+* [`lps status`](#lps-status)
 
 ## `lps composer pull`
 
-Pull composer.lock from the WordPress server
+Pull composer.lock from WordPress
 
 ```
 USAGE
@@ -67,7 +66,7 @@ GLOBAL FLAGS
   --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Pull composer.lock from the WordPress server
+  Pull composer.lock from WordPress
 
 EXAMPLES
   $ lps composer pull
@@ -75,11 +74,11 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
-Upload composer.json and composer.lock to WordPress and run composer install
+Push composer.json and composer.lock to WordPress and run composer install
 
 ```
 USAGE
@@ -94,7 +93,7 @@ GLOBAL FLAGS
   --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Upload composer.json and composer.lock to WordPress and run composer install
+  Push composer.json and composer.lock to WordPress and run composer install
 
 EXAMPLES
   $ lps composer push
@@ -102,7 +101,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/composer/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -139,52 +138,52 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/init.ts)_
 
 ## `lps login`
 
-Log in to Loopress via the console
+Log in to the Loopress console
 
 ```
 USAGE
   $ lps login
 
 DESCRIPTION
-  Log in to Loopress via the console
+  Log in to the Loopress console
 
 EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/login.ts)_
 
 ## `lps logout`
 
-Log out from Loopress console
+Log out from the Loopress console
 
 ```
 USAGE
   $ lps logout
 
 DESCRIPTION
-  Log out from Loopress console
+  Log out from the Loopress console
 
 EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/logout.ts)_
 
 ## `lps plugin add SLUG [VERSION]`
 
-Add a plugin to loopress.json (WordPress.org) or run composer require (vendor/package)
+Add a WordPress.org plugin to loopress.json
 
 ```
 USAGE
   $ lps plugin add SLUG [VERSION] [--password <value>] [--url <value>] [--user <value>] [-d]
 
 ARGUMENTS
-  SLUG       Plugin slug (WordPress.org) or Composer package (vendor/package)
+  SLUG       Plugin slug on WordPress.org
   [VERSION]  Version to pin (default: latest)
 
 FLAGS
@@ -196,19 +195,17 @@ GLOBAL FLAGS
   --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Add a plugin to loopress.json (WordPress.org) or run composer require (vendor/package)
+  Add a WordPress.org plugin to loopress.json
 
 EXAMPLES
   $ lps plugin add woocommerce
 
   $ lps plugin add woocommerce 8.9.1
 
-  $ lps plugin add wpackagist-plugin/advanced-custom-fields
-
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/plugin/add.ts)_
 
 ## `lps plugin pull`
 
@@ -230,16 +227,16 @@ DESCRIPTION
   Pull installed plugins from WordPress into loopress.json
 
 EXAMPLES
-  $ lps plugins pull
+  $ lps plugin pull
 
-  $ lps plugins pull --dry-run
+  $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
-Sync plugins on WordPress to match loopress.json
+Push plugins to WordPress to match loopress.json
 
 ```
 USAGE
@@ -254,15 +251,15 @@ GLOBAL FLAGS
   --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Sync plugins on WordPress to match loopress.json
+  Push plugins to WordPress to match loopress.json
 
 EXAMPLES
-  $ lps plugins push
+  $ lps plugin push
 
-  $ lps plugins push --dry-run
+  $ lps plugin push --dry-run
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/plugin/push.ts)_
 
 ## `lps project config`
 
@@ -279,7 +276,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -296,75 +293,41 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/project/list.ts)_
 
 ## `lps project remove`
 
-Remove one or more WordPress project configurations
+Remove one or more WordPress projects or environments
 
 ```
 USAGE
   $ lps project remove
 
 DESCRIPTION
-  Remove one or more WordPress project configurations
+  Remove one or more WordPress projects or environments
 
 EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/remove.ts)_
-
-## `lps project remove-env`
-
-Remove one or more environments from the current project
-
-```
-USAGE
-  $ lps project remove-env
-
-DESCRIPTION
-  Remove one or more environments from the current project
-
-EXAMPLES
-  $ lps project remove-env
-```
-
-_See code: [src/commands/project/remove-env.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/remove-env.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/project/remove.ts)_
 
 ## `lps project switch`
 
-Switch the active project
+Switch the active project and environment
 
 ```
 USAGE
   $ lps project switch
 
 DESCRIPTION
-  Switch the active project
+  Switch the active project and environment
 
 EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/switch.ts)_
-
-## `lps project switch-env`
-
-Switch the active environment within the current project
-
-```
-USAGE
-  $ lps project switch-env
-
-DESCRIPTION
-  Switch the active environment within the current project
-
-EXAMPLES
-  $ lps project switch-env
-```
-
-_See code: [src/commands/project/switch-env.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/project/switch-env.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/project/switch.ts)_
 
 ## `lps snippet list`
 
@@ -388,14 +351,14 @@ DESCRIPTION
   List snippets from WordPress
 
 EXAMPLES
-  $ lps snippets list
+  $ lps snippet list
 
-  $ lps snippets list --url http://example.com
+  $ lps snippet list --url http://example.com
 
-  $ lps snippets list --plugin wpcode
+  $ lps snippet list --plugin wpcode
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -409,7 +372,7 @@ ARGUMENTS
   [PATH]  Path to snippets directory (overrides project config)
 
 FLAGS
-  -d, --dryRun           Dry run - show what would happen without making changes
+  -d, --dry-run          Show what would be written without making changes
   -p, --plugin=<option>  WordPress snippet plugin to target (overrides loopress.json)
                          <options: code-snippets|wpcode>
 
@@ -422,20 +385,20 @@ DESCRIPTION
   Pull snippets from WordPress
 
 EXAMPLES
-  $ lps snippets pull
+  $ lps snippet pull
 
-  $ lps snippets pull --url http://example.com
+  $ lps snippet pull --url http://example.com
 
-  $ lps snippets pull --path ./snippets
+  $ lps snippet pull --path ./snippets
 
-  $ lps snippets pull --plugin wpcode
+  $ lps snippet pull --plugin wpcode
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
-Push snippets to WordPress
+Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.
 
 ```
 USAGE
@@ -445,7 +408,7 @@ ARGUMENTS
   [PATH]  Path to snippets directory (overrides project config)
 
 FLAGS
-  -d, --dryRun           Dry run - show what would happen without making changes
+  -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>
 
@@ -455,17 +418,35 @@ GLOBAL FLAGS
   --user=<value>      WordPress username (fallback; prefer `lps project config`)
 
 DESCRIPTION
-  Push snippets to WordPress
+  Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>`
+  convention.
 
 EXAMPLES
-  $ lps snippets push
+  $ lps snippet push
+
+  $ lps snippet push --url http://example.com
 
-  $ lps snippets push --url http://example.com
+  $ lps snippet push --path ./snippets
+
+  $ lps snippet push --plugin wpcode
+```
 
-  $ lps snippets push --path ./snippets
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/snippet/push.ts)_
 
-  $ lps snippets push --plugin wpcode
+## `lps status`
+
+Show which WordPress project and environment commands will target
+
+```
+USAGE
+  $ lps status
+
+DESCRIPTION
+  Show which WordPress project and environment commands will target
+
+EXAMPLES
+  $ lps status
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.6.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.7.0/src/commands/status.ts)_
 <!-- commandsstop -->

package/dist/commands/composer/pull.js

@@ -5,7 +5,7 @@ import { join } from 'node:path';
 import { LoopressCommand } from '../../lib/base.js';
 import { readLocalConfig } from '../../utils/loopress-config.js';
 export default class ComposerPull extends LoopressCommand {
-    static description = 'Pull composer.lock from the WordPress server';
+    static description = 'Pull composer.lock from WordPress';
     static examples = ['$ lps composer pull', '$ lps composer pull --dry-run'];
     static flags = {
         ...LoopressCommand.baseFlags,

package/dist/commands/composer/push.js

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 import { PushCommand } from '../../lib/push-command.js';
 import { readLocalConfig } from '../../utils/loopress-config.js';
 export default class ComposerPush extends PushCommand {
-    static description = 'Upload composer.json and composer.lock to WordPress and run composer install';
+    static description = 'Push composer.json and composer.lock to WordPress and run composer install';
     static examples = ['$ lps composer push', '$ lps composer push --dry-run'];
     static flags = {
         ...PushCommand.baseFlags,

package/dist/commands/init.js

@@ -22,19 +22,27 @@ export default class Init extends Command {
         }
         const projects = configManager.listProjects();
         let projectId;
+        let projectLabel;
         if (projects.length > 0) {
             const choices = [
-                ...projects.map((p) => ({ name: p.name, value: p.name })),
+                ...projects.map((p) => ({ name: p.name, value: p.id })),
                 { name: 'Enter a project ID manually', value: '__manual__' },
             ];
             const choice = await select({
                 choices,
                 message: 'WordPress project',
             });
-            projectId = choice === '__manual__' ? (await input({
-                message: 'Project ID',
-                validate: (value) => (value.trim().length > 0 ? true : 'Project ID cannot be empty'),
-            })) : choice;
+            if (choice === '__manual__') {
+                projectId = await input({
+                    message: 'Project ID',
+                    validate: (value) => (value.trim().length > 0 ? true : 'Project ID cannot be empty'),
+                });
+                projectLabel = projectId;
+            }
+            else {
+                projectId = choice;
+                projectLabel = projects.find((p) => p.id === choice).name;
+            }
         }
         else {
             this.log('No projects configured yet. Run `lps project config` to add one first.');
@@ -42,6 +50,7 @@ export default class Init extends Command {
                 message: 'Project ID',
                 validate: (value) => (value.trim().length > 0 ? true : 'Project ID cannot be empty'),
             });
+            projectLabel = projectId;
         }
         const snippetPlugin = await select({
             choices: [
@@ -66,7 +75,7 @@ export default class Init extends Command {
         };
         await writeLocalConfig(config);
         this.log(`\n✓ loopress.json created`);
-        this.log(`  Project:  ${projectId}`);
+        this.log(`  Project:  ${projectLabel}`);
         this.log(`  Plugin:   ${snippetPlugin}`);
         this.log(`  Snippets: ${join(rootDir, snippetsDir)}`);
     }

package/dist/commands/login.js

@@ -5,7 +5,7 @@ import { authManager } from '../config/auth.manager.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 Loopress via the console';
+    static description = 'Log in to the Loopress console';
     static examples = ['$ lps login'];
     async run() {
         const { email, token } = await this.waitForCallback();

package/dist/commands/logout.js

@@ -1,7 +1,7 @@
 import { Command } from '@oclif/core';
 import { authManager } from '../config/auth.manager.js';
 export default class Logout extends Command {
-    static description = 'Log out from Loopress console';
+    static description = 'Log out from the Loopress console';
     static examples = ['$ lps logout'];
     async run() {
         const auth = authManager.getAuth();

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

@@ -14,6 +14,4 @@ export default class Add extends LoopressCommand {
         user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
-    private requireComposerPackage;
-    private requireWpOrgPlugin;
 }

package/dist/commands/plugin/add.js

@@ -1,6 +1,5 @@
 import { Args, Flags } from '@oclif/core';
 import got from 'got';
-import { spawnSync } from 'node:child_process';
 import { LoopressCommand } from '../../lib/base.js';
 import { readLocalConfig, writeLocalConfig } from '../../utils/loopress-config.js';
 const WP_ORG_API = 'https://api.wordpress.org/plugins/info/1.2/';
@@ -27,14 +26,13 @@ export async function resolvePluginVersion(slug, version) {
 }
 export default class Add extends LoopressCommand {
     static args = {
-        slug: Args.string({ description: 'Plugin slug (WordPress.org) or Composer package (vendor/package)', required: true }),
+        slug: Args.string({ description: 'Plugin slug on WordPress.org', required: true }),
         version: Args.string({ description: 'Version to pin (default: latest)' }),
     };
-    static description = 'Add a plugin to loopress.json (WordPress.org) or run composer require (vendor/package)';
+    static description = 'Add a WordPress.org plugin to loopress.json';
     static examples = [
         '$ lps plugin add woocommerce',
         '$ lps plugin add woocommerce 8.9.1',
-        '$ lps plugin add wpackagist-plugin/advanced-custom-fields',
         '$ lps plugin add contact-form-7 --dry-run',
     ];
     static flags = {
@@ -46,25 +44,6 @@ export default class Add extends LoopressCommand {
         const dryRun = flags['dry-run'];
         const { slug } = args;
         const requestedVersion = args.version ?? 'latest';
-        if (slug.includes('/')) {
-            await this.requireComposerPackage(slug, requestedVersion, dryRun);
-            return;
-        }
-        await this.requireWpOrgPlugin(slug, requestedVersion, dryRun);
-    }
-    async requireComposerPackage(pkg, version, dryRun) {
-        const composerArg = version === 'latest' ? pkg : `${pkg}:${version}`;
-        this.log(`Running: composer require ${composerArg}`);
-        if (dryRun) {
-            this.log(`[dry-run] Would run: composer require ${composerArg}`);
-            return;
-        }
-        const result = spawnSync('composer', ['require', composerArg], { stdio: 'inherit' });
-        if (result.status !== 0) {
-            this.error('composer require failed. Make sure Composer is installed and accessible.');
-        }
-    }
-    async requireWpOrgPlugin(slug, requestedVersion, dryRun) {
         this.log(`Resolving ${slug}@${requestedVersion}...`);
         let resolvedVersion;
         try {

package/dist/commands/plugin/pull.js

@@ -6,7 +6,7 @@ import { readLocalConfig, writeLocalConfig } from '../../utils/loopress-config.j
 import { mergePluginManifest } from '../../utils/plugins.js';
 export default class Pull extends LoopressCommand {
     static description = 'Pull installed plugins from WordPress into loopress.json';
-    static examples = ['$ lps plugins pull', '$ lps plugins pull --dry-run'];
+    static examples = ['$ lps plugin pull', '$ lps plugin pull --dry-run'];
     static flags = {
         ...LoopressCommand.baseFlags,
         'dry-run': Flags.boolean({ char: 'd', description: 'Show what would be written without making changes' }),

package/dist/commands/plugin/push.js

@@ -6,8 +6,8 @@ import { getComposerManagedSlugs, readComposerJson } from '../../utils/composer.
 import { readLocalConfig } from '../../utils/loopress-config.js';
 import { diffPlugins } from '../../utils/plugins.js';
 export default class Push extends PushCommand {
-    static description = 'Sync plugins on WordPress to match loopress.json';
-    static examples = ['$ lps plugins push', '$ lps plugins push --dry-run'];
+    static description = 'Push plugins to WordPress to match loopress.json';
+    static examples = ['$ lps plugin push', '$ lps plugin push --dry-run'];
     static flags = {
         ...PushCommand.baseFlags,
         'dry-run': Flags.boolean({ char: 'd', description: 'Show what would change without making changes' }),
@@ -20,7 +20,7 @@ export default class Push extends PushCommand {
         const localConfig = await readLocalConfig();
         const manifest = localConfig.plugins;
         if (!manifest || Object.keys(manifest).length === 0) {
-            this.error('No plugins found in loopress.json. Run `lps plugins pull` first.');
+            this.error('No plugins found in loopress.json. Run `lps plugin pull` first.');
         }
         const composerJson = await readComposerJson();
         const composerSlugs = composerJson ? getComposerManagedSlugs(composerJson) : [];

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

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

package/dist/commands/project/config.js

@@ -1,20 +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';
+const NEW_PROJECT = '__new__';
 export default class Config extends Command {
     static description = 'Add or update a WordPress project environment';
     static examples = ['$ lps project config'];
     async run() {
         await this.parse(Config);
-        const projectName = await input({
-            message: 'Project name (identifier, no spaces)',
-            validate(value) {
-                if (!/^[a-z0-9_-]+$/.test(value)) {
-                    return 'Name must be lowercase with only letters, numbers, - and _';
-                }
-                return true;
-            },
-        });
+        const { projectId, projectName } = await this.resolveProject();
         const envChoice = await select({
             choices: [
                 { name: 'local', value: 'local' },
@@ -30,8 +23,7 @@ export default class Config extends Command {
                 validate: (value) => (value.trim().length > 0 ? true : 'Name cannot be empty'),
             })
             : envChoice;
-        const existingProject = configManager.getProject(projectName);
-        const existingEnv = existingProject?.environments[envName];
+        const existingEnv = configManager.getEnvironment(projectId, envName);
         if (existingEnv) {
             const overwrite = await confirm({
                 default: false,
@@ -73,20 +65,47 @@ export default class Config extends Command {
             token,
             url,
         };
-        if (existingProject) {
-            configManager.setEnvironment(projectName, envName, env);
+        if (configManager.getProject(projectId)) {
+            configManager.setEnvironment(projectId, envName, env);
         }
         else {
             const project = {
                 addedAt: new Date().toISOString(),
-                currentEnv: envName,
                 environments: { [envName]: env },
                 name: projectName,
             };
-            configManager.setProject(projectName, project);
+            configManager.setProject(projectId, project);
         }
         this.log(`✓ "${projectName}/${envName}" configured`);
-        this.log('→ Run `lps project switch` to change active project');
-        this.log('→ Run `lps project switch-env` to change active environment');
+        this.log('→ Run `lps project switch` to change the active project or environment');
+    }
+    async resolveProject() {
+        const projects = configManager.listProjects();
+        if (projects.length > 0) {
+            const choice = await select({
+                choices: [
+                    ...projects.map((project) => ({ name: project.name, value: project.id })),
+                    { name: 'Add a new project…', value: NEW_PROJECT },
+                ],
+                message: 'Project',
+            });
+            if (choice !== NEW_PROJECT) {
+                const project = projects.find((p) => p.id === choice);
+                return { projectId: project.id, projectName: project.name };
+            }
+        }
+        const existingNames = new Set(projects.map((project) => project.name.trim().toLowerCase()));
+        const projectName = await input({
+            message: 'Project name',
+            validate(value) {
+                const trimmed = value.trim();
+                if (trimmed.length === 0)
+                    return 'Name cannot be empty';
+                if (existingNames.has(trimmed.toLowerCase()))
+                    return `A project named "${trimmed}" already exists`;
+                return true;
+            },
+        });
+        return { projectId: configManager.createProjectId(), projectName: projectName.trim() };
     }
 }