prpm 0.1.9 → 0.1.11

package/dist/__tests__/e2e/test-helpers.js

@@ -141,6 +141,7 @@ function setupGlobalMocks() {
 }
 /**
  * Mock process.exit to throw instead of exiting
+ * @deprecated No longer needed - commands now throw CLIError instead of calling process.exit
  */
 function mockProcessExit() {
     const mockExit = jest.spyOn(process, 'exit').mockImplementation((code) => {

package/dist/commands/buy-credits.js

@@ -11,6 +11,7 @@ const telemetry_1 = require("../core/telemetry");
 const child_process_1 = require("child_process");
 const util_1 = require("util");
 const webapp_url_1 = require("../utils/webapp-url");
+const errors_1 = require("../core/errors");
 const execAsync = (0, util_1.promisify)(child_process_1.exec);
 /**
  * Make authenticated API call
@@ -102,7 +103,7 @@ async function handleBuyCredits(options) {
             console.error('❌ Authentication required');
             console.log('\n💡 Please login first:');
             console.log('   prpm login');
-            process.exit(1);
+            throw new errors_1.CLIError('❌ Authentication required', 1);
         }
         // Get current balance
         console.log('🔍 Checking current credits balance...');
@@ -122,7 +123,7 @@ async function handleBuyCredits(options) {
             if (!validPackages.includes(options.package)) {
                 console.error(`\n❌ Invalid package: ${options.package}`);
                 console.log('   Valid options: small, medium, large');
-                process.exit(1);
+                throw new errors_1.CLIError(`\n❌ Invalid package: ${options.package}`, 1);
             }
             purchaseUrl += `?package=${options.package}`;
         }
@@ -154,7 +155,7 @@ async function handleBuyCredits(options) {
     catch (err) {
         error = err instanceof Error ? err.message : String(err);
         console.error(`\n❌ Purchase failed: ${error}`);
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Purchase failed: ${error}`, 1);
     }
     finally {
         await telemetry_1.telemetry.track({
@@ -218,7 +219,6 @@ Note: Purchased credits are one-time and never expire, unlike monthly credits.
 `)
         .action(async (options) => {
         await handleBuyCredits(options);
-        process.exit(0);
     });
     return command;
 }

package/dist/commands/catalog.js

@@ -10,6 +10,7 @@ const promises_1 = require("fs/promises");
 const path_1 = require("path");
 const telemetry_1 = require("../core/telemetry");
 const lockfile_1 = require("../core/lockfile");
+const errors_1 = require("../core/errors");
 /**
  * Detect format and subtype from file path and content
  */
@@ -333,7 +334,7 @@ async function handleCatalog(directories, options) {
     catch (err) {
         error = err instanceof Error ? err.message : String(err);
         console.error(`\n❌ Failed to catalog packages: ${error}\n`);
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Failed to catalog packages: ${error}`, 1);
     }
     finally {
         await telemetry_1.telemetry.track({
@@ -360,6 +361,5 @@ function createCatalogCommand() {
         .option('--dry-run', 'Show what would be cataloged without making changes')
         .action(async (directories, options) => {
         await handleCatalog(directories, options);
-        process.exit(0);
     });
 }

package/dist/commands/collections.js

@@ -48,6 +48,7 @@ const user_config_1 = require("../core/user-config");
 const install_1 = require("./install");
 const telemetry_1 = require("../core/telemetry");
 const lockfile_1 = require("../core/lockfile");
+const errors_1 = require("../core/errors");
 /**
  * Search collections by query
  */
@@ -130,7 +131,7 @@ async function handleCollectionsSearch(query, options) {
             error: errorMessage,
             duration: Date.now() - startTime,
         });
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Failed to search collections: ${errorMessage}`, 1);
     }
     finally {
         await telemetry_1.telemetry.shutdown();
@@ -218,7 +219,7 @@ async function handleCollectionsList(options) {
             error: errorMessage,
             duration: Date.now() - startTime,
         });
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Failed to list collections: ${errorMessage}`, 1);
     }
     finally {
         await telemetry_1.telemetry.shutdown();
@@ -338,7 +339,7 @@ async function handleCollectionInfo(collectionSpec) {
             error: errorMessage,
             duration: Date.now() - startTime,
         });
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Failed to get collection info: ${errorMessage}`, 1);
     }
     finally {
         await telemetry_1.telemetry.shutdown();
@@ -355,7 +356,7 @@ async function handleCollectionPublish(manifestPath = './collection.json') {
         // Check authentication
         if (!config.token) {
             console.error('\n❌ Authentication required. Run `prpm login` first.\n');
-            process.exit(1);
+            throw new errors_1.CLIError('\n❌ Authentication required. Run `prpm login` first.', 1);
         }
         console.log('📦 Publishing collection...\n');
         // Read collection manifest
@@ -438,7 +439,7 @@ async function handleCollectionPublish(manifestPath = './collection.json') {
             error: errorMessage,
             duration: Date.now() - startTime,
         });
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Failed to publish collection: ${errorMessage}`, 1);
     }
     finally {
         await telemetry_1.telemetry.shutdown();
@@ -501,14 +502,21 @@ async function handleCollectionInstall(collectionSpec, options) {
             const progress = `${i + 1}/${packages.length}`;
             try {
                 console.log(`\n  ${progress} Installing ${pkg.packageId}@${pkg.version}...`);
-                await (0, install_1.handleInstall)(`${pkg.packageId}@${pkg.version}`, {
-                    as: pkg.format,
+                // Only pass 'as' format if user explicitly requested it via --as flag
+                // Otherwise, let handleInstall auto-detect the format based on existing directories
+                // This ensures collections respect existing .claude or .cursor directories
+                const installOptions = {
                     fromCollection: {
                         scope,
                         name_slug,
                         version: collection.version || version || '1.0.0',
                     },
-                });
+                };
+                // Only set 'as' if user explicitly provided a format
+                if (options.format) {
+                    installOptions.as = options.format;
+                }
+                await (0, install_1.handleInstall)(`${pkg.packageId}@${pkg.version}`, installOptions);
                 console.log(`  ${progress} ✓ ${pkg.packageId}`);
                 installedPackageIds.push(pkg.packageId);
                 packagesInstalled++;
@@ -566,7 +574,7 @@ async function handleCollectionInstall(collectionSpec, options) {
                 failed: packagesFailed,
             },
         });
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Failed to install collection: ${errorMessage}`, 1);
     }
     finally {
         await telemetry_1.telemetry.shutdown();

package/dist/commands/config.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createConfigCommand = createConfigCommand;
 const commander_1 = require("commander");
 const user_config_1 = require("../core/user-config");
+const errors_1 = require("../core/errors");
 /**
  * Get a config value
  */
@@ -14,15 +15,15 @@ async function handleConfigGet(key) {
         const config = await (0, user_config_1.getConfig)();
         const value = config[key];
         if (value === undefined) {
-            console.error(`❌ Config key "${key}" not found`);
-            console.log('\nAvailable keys: registryUrl, telemetryEnabled, token, username');
-            process.exit(1);
+            throw new errors_1.CLIError(`❌ Config key "${key}" not found\n\nAvailable keys: registryUrl, telemetryEnabled, token, username`, 1);
         }
         console.log(value);
     }
     catch (error) {
-        console.error(`❌ Failed to get config: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
+        if (error instanceof errors_1.CLIError) {
+            throw error;
+        }
+        throw new errors_1.CLIError(`❌ Failed to get config: ${error instanceof Error ? error.message : String(error)}`, 1);
     }
 }
 /**
@@ -34,10 +35,7 @@ async function handleConfigSet(key, value) {
         // Validate key
         const validKeys = ['registryUrl', 'telemetryEnabled'];
         if (!validKeys.includes(key)) {
-            console.error(`❌ Cannot set config key "${key}"`);
-            console.log('\nSettable keys: registryUrl, telemetryEnabled');
-            console.log('Note: token and username are set via "prpm login"');
-            process.exit(1);
+            throw new errors_1.CLIError(`❌ Cannot set config key "${key}"\n\nSettable keys: registryUrl, telemetryEnabled\nNote: token and username are set via "prpm login"`, 1);
         }
         // Parse boolean values
         let parsedValue = value;
@@ -49,8 +47,7 @@ async function handleConfigSet(key, value) {
                 parsedValue = false;
             }
             else {
-                console.error(`❌ Invalid boolean value "${value}". Use: true, false, yes, no, 1, or 0`);
-                process.exit(1);
+                throw new errors_1.CLIError(`❌ Invalid boolean value "${value}". Use: true, false, yes, no, 1, or 0`, 1);
             }
         }
         // Update config
@@ -59,8 +56,10 @@ async function handleConfigSet(key, value) {
         console.log(`✅ Set ${key} = ${parsedValue}`);
     }
     catch (error) {
-        console.error(`❌ Failed to set config: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
+        if (error instanceof errors_1.CLIError) {
+            throw error;
+        }
+        throw new errors_1.CLIError(`❌ Failed to set config: ${error instanceof Error ? error.message : String(error)}`, 1);
     }
 }
 /**
@@ -81,8 +80,7 @@ async function handleConfigList() {
         console.log(`Config file: ${configPath}`);
     }
     catch (error) {
-        console.error(`❌ Failed to list config: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
+        throw new errors_1.CLIError(`❌ Failed to list config: ${error instanceof Error ? error.message : String(error)}`, 1);
     }
 }
 /**
@@ -94,8 +92,7 @@ async function handleConfigDelete(key) {
         // Validate key
         const deletableKeys = ['registryUrl', 'telemetryEnabled', 'token', 'username'];
         if (!deletableKeys.includes(key)) {
-            console.error(`❌ Cannot delete config key "${key}"`);
-            process.exit(1);
+            throw new errors_1.CLIError(`❌ Cannot delete config key "${key}"`, 1);
         }
         // Reset to defaults
         if (key === 'registryUrl') {
@@ -114,8 +111,10 @@ async function handleConfigDelete(key) {
         console.log(`✅ Reset ${key} to default value`);
     }
     catch (error) {
-        console.error(`❌ Failed to delete config: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
+        if (error instanceof errors_1.CLIError) {
+            throw error;
+        }
+        throw new errors_1.CLIError(`❌ Failed to delete config: ${error instanceof Error ? error.message : String(error)}`, 1);
     }
 }
 /**
@@ -131,7 +130,6 @@ function createConfigCommand() {
         .description('List all configuration values')
         .action(async () => {
         await handleConfigList();
-        process.exit(0);
     });
     // config get <key>
     command
@@ -139,7 +137,6 @@ function createConfigCommand() {
         .description('Get a configuration value')
         .action(async (key) => {
         await handleConfigGet(key);
-        process.exit(0);
     });
     // config set <key> <value>
     command
@@ -147,7 +144,6 @@ function createConfigCommand() {
         .description('Set a configuration value')
         .action(async (key, value) => {
         await handleConfigSet(key, value);
-        process.exit(0);
     });
     // config delete <key>
     command
@@ -156,12 +152,10 @@ function createConfigCommand() {
         .description('Reset a configuration value to default')
         .action(async (key) => {
         await handleConfigDelete(key);
-        process.exit(0);
     });
     // Default action (show list if no subcommand)
     command.action(async () => {
         await handleConfigList();
-        process.exit(0);
     });
     return command;
 }

package/dist/commands/credits.js

@@ -8,6 +8,7 @@ exports.createCreditsCommand = createCreditsCommand;
 const commander_1 = require("commander");
 const user_config_1 = require("../core/user-config");
 const telemetry_1 = require("../core/telemetry");
+const errors_1 = require("../core/errors");
 /**
  * Make authenticated API call
  */
@@ -112,7 +113,7 @@ async function handleCredits(options) {
             console.error('❌ Authentication required');
             console.log('\n💡 Please login first:');
             console.log('   prpm login');
-            process.exit(1);
+            throw new errors_1.CLIError('❌ Authentication required', 1);
         }
         if (options.history) {
             await showHistory(options.limit || 10);
@@ -130,7 +131,7 @@ async function handleCredits(options) {
     catch (err) {
         error = err instanceof Error ? err.message : String(err);
         console.error(`\n❌ Failed to fetch credits: ${error}`);
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Failed to fetch credits: ${error}`, 1);
     }
     finally {
         await telemetry_1.telemetry.track({
@@ -180,7 +181,6 @@ Get more credits:
             history: options.history,
             limit: options.limit ? parseInt(options.limit, 10) : undefined,
         });
-        process.exit(0);
     });
     return command;
 }

package/dist/commands/index.js

@@ -13,6 +13,7 @@ const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
 const lockfile_1 = require("../core/lockfile");
 const filesystem_1 = require("../core/filesystem");
+const errors_1 = require("../core/errors");
 /**
  * Scan directory for files and return file information
  * Recursively scans subdirectories for Claude skills/agents
@@ -167,10 +168,7 @@ async function handleIndex(options = {}) {
     }
     catch (error) {
         console.error(`❌ Failed to index packages: ${error}`);
-        process.exit(1);
-    }
-    finally {
-        process.exit(0);
+        throw new errors_1.CLIError(`❌ Failed to index packages: ${error}`, 1);
     }
 }
 /**

package/dist/commands/info.js

@@ -9,6 +9,7 @@ const commander_1 = require("commander");
 const registry_client_1 = require("@pr-pm/registry-client");
 const user_config_1 = require("../core/user-config");
 const telemetry_1 = require("../core/telemetry");
+const errors_1 = require("../core/errors");
 async function handleInfo(packageName) {
     const startTime = Date.now();
     let success = false;
@@ -50,12 +51,7 @@ async function handleInfo(packageName) {
     }
     catch (err) {
         error = err instanceof Error ? err.message : String(err);
-        console.error(`\n❌ Failed to fetch package info: ${error}`);
-        console.log(`\n💡 Tips:`);
-        console.log(`   - Check the package ID spelling`);
-        console.log(`   - Search for packages: prpm search <query>`);
-        console.log(`   - View trending: prpm trending`);
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Failed to fetch package info: ${error}\n\n💡 Tips:\n   - Check the package ID spelling\n   - Search for packages: prpm search <query>\n   - View trending: prpm trending`, 1);
     }
     finally {
         await telemetry_1.telemetry.track({
@@ -77,7 +73,6 @@ function createInfoCommand() {
         .argument('<package>', 'Package ID to get information about')
         .action(async (packageId) => {
         await handleInfo(packageId);
-        process.exit(0);
     });
     return command;
 }

package/dist/commands/init.js

@@ -45,6 +45,7 @@ const fs_1 = require("fs");
 const readline = __importStar(require("readline/promises"));
 const process_1 = require("process");
 const types_1 = require("../types");
+const errors_1 = require("../core/errors");
 const FORMAT_EXAMPLES = {
     cursor: {
         description: 'Cursor AI coding rules',
@@ -648,7 +649,9 @@ async function initPackage(options) {
     // Create example files
     if (config.files && config.format && config.name) {
         console.log('Creating example files...\n');
-        await createExampleFiles(config.format, config.files, config.name);
+        // Filter out README.md since createReadme will handle it with proper content
+        const filesToCreate = config.files.filter(f => f !== 'README.md');
+        await createExampleFiles(config.format, filesToCreate, config.name);
         // Create README
         await createReadme(config);
     }
@@ -671,11 +674,10 @@ function createInitCommand() {
         .action(async (options) => {
         try {
             await initPackage(options);
-            process.exit(0);
         }
         catch (error) {
             console.error('\n❌ Error:', error instanceof Error ? error.message : error);
-            process.exit(1);
+            throw new errors_1.CLIError('\n❌ Error: ' + (error instanceof Error ? error.message : error), 1);
         }
     });
     return command;

package/dist/commands/install.js

@@ -45,6 +45,7 @@ const user_config_1 = require("../core/user-config");
 const filesystem_1 = require("../core/filesystem");
 const telemetry_1 = require("../core/telemetry");
 const tar = __importStar(require("tar"));
+const errors_1 = require("../core/errors");
 const lockfile_1 = require("../core/lockfile");
 const cursor_config_1 = require("../core/cursor-config");
 const claude_config_1 = require("../core/claude-config");
@@ -356,10 +357,14 @@ async function handleInstall(packageSpec, options) {
             const destDir = (0, filesystem_1.getDestinationDir)(effectiveFormat, effectiveSubtype, pkg.name);
             // Multi-file package - create directory for package
             // For Claude skills, destDir already includes package name, so use it directly
+            // For Cursor rules converted from Claude skills, use flat structure
             const packageName = (0, filesystem_1.stripAuthorNamespace)(packageId);
+            const isCursorConversion = (effectiveFormat === 'cursor' && pkg.format === 'claude' && pkg.subtype === 'skill');
             const packageDir = (effectiveFormat === 'claude' && effectiveSubtype === 'skill')
                 ? destDir
-                : `${destDir}/${packageName}`;
+                : isCursorConversion
+                    ? destDir // Cursor uses flat structure
+                    : `${destDir}/${packageName}`;
             destPath = packageDir;
             console.log(`   📁 Multi-file package - creating directory: ${packageDir}`);
             // For Claude skills, verify SKILL.md exists
@@ -385,6 +390,8 @@ async function handleInstall(packageSpec, options) {
                     }
                 }
             }
+            // Track JSON files for @reference insertion in Cursor conversion
+            const jsonFiles = [];
             for (const file of extractedFiles) {
                 // Strip the tarball's root directory prefix to preserve subdirectories
                 // Example: ".claude/skills/agent-builder/docs/examples.md" → "docs/examples.md"
@@ -404,10 +411,58 @@ async function handleInstall(packageSpec, options) {
                     // Fallback: just take the filename (last part)
                     relativeFileName = pathParts[pathParts.length - 1];
                 }
-                const filePath = `${packageDir}/${relativeFileName}`;
-                await (0, filesystem_1.saveFile)(filePath, file.content);
+                let fileContent = file.content;
+                let fileName = relativeFileName;
+                // Handle Cursor conversion from Claude skill
+                if (isCursorConversion) {
+                    // Convert SKILL.md to .mdc
+                    if (fileName === 'SKILL.md' || fileName.endsWith('/SKILL.md')) {
+                        fileName = `${packageName}.mdc`;
+                        // Add MDC header if missing
+                        if (!(0, cursor_config_1.hasMDCHeader)(fileContent)) {
+                            console.log(`   ⚠️  Adding MDC header to converted skill...`);
+                            fileContent = (0, cursor_config_1.addMDCHeader)(fileContent, pkg.description);
+                        }
+                        // Apply cursor config if available
+                        if (config.cursor) {
+                            console.log(`   ⚙️  Applying cursor config...`);
+                            fileContent = (0, cursor_config_1.applyCursorConfig)(fileContent, config.cursor);
+                        }
+                    }
+                    // Track JSON files for @reference
+                    else if (fileName.endsWith('.json')) {
+                        // Flatten structure - remove subdirectories
+                        const jsonFileName = fileName.split('/').pop() || fileName;
+                        fileName = jsonFileName;
+                        jsonFiles.push(jsonFileName);
+                    }
+                    // For other files (docs, etc), flatten the structure
+                    else {
+                        fileName = fileName.split('/').pop() || fileName;
+                    }
+                }
+                const filePath = `${packageDir}/${fileName}`;
+                await (0, filesystem_1.saveFile)(filePath, fileContent);
                 fileCount++;
             }
+            // Add @references to .mdc file for JSON files
+            if (isCursorConversion && jsonFiles.length > 0) {
+                const mdcFile = `${packageDir}/${packageName}.mdc`;
+                const { readFile } = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+                let mdcContent = await readFile(mdcFile, 'utf-8');
+                // Find the end of frontmatter (if exists)
+                const frontmatterMatch = mdcContent.match(/^---\n[\s\S]*?\n---\n/);
+                if (frontmatterMatch) {
+                    const frontmatterEnd = frontmatterMatch[0].length;
+                    const beforeFrontmatter = mdcContent.slice(0, frontmatterEnd);
+                    const afterFrontmatter = mdcContent.slice(frontmatterEnd);
+                    // Add @references right after frontmatter
+                    const references = jsonFiles.map(f => `@${f}`).join('\n');
+                    mdcContent = `${beforeFrontmatter}\n${references}\n${afterFrontmatter}`;
+                    await (0, filesystem_1.saveFile)(mdcFile, mdcContent);
+                    console.log(`   ✓ Added ${jsonFiles.length} @reference(s) to ${packageName}.mdc`);
+                }
+            }
         }
         // Update or create lock file
         const updatedLockfile = lockfile || (0, lockfile_1.createLockfile)();
@@ -440,11 +495,7 @@ async function handleInstall(packageSpec, options) {
     }
     catch (err) {
         error = err instanceof Error ? err.message : String(err);
-        console.error(`\n❌ Installation failed: ${error}`);
-        console.log(`\n💡 Tips:`);
-        console.log(`   - Check package name: prpm search <query>`);
-        console.log(`   - Get package info: prpm info <package>`);
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Installation failed: ${error}\n\n💡 Tips:\n   - Check package name: prpm search <query>\n   - Get package info: prpm info <package>`, 1);
     }
     finally {
         await telemetry_1.telemetry.track({
@@ -557,9 +608,7 @@ async function installFromLockfile(options) {
         // Read lockfile
         const lockfile = await (0, lockfile_1.readLockfile)();
         if (!lockfile) {
-            console.error('❌ No prpm.lock file found');
-            console.log('\n💡 Run "prpm install <package>" first to create a lockfile, or initialize a new project with "prpm init"');
-            process.exit(1);
+            throw new errors_1.CLIError('❌ No prpm.lock file found\n\n💡 Run "prpm install <package>" first to create a lockfile, or initialize a new project with "prpm init"', 1);
         }
         const packageIds = Object.keys(lockfile.packages);
         if (packageIds.length === 0) {
@@ -588,19 +637,31 @@ async function installFromLockfile(options) {
                 successCount++;
             }
             catch (error) {
-                failCount++;
-                console.error(`  ❌ Failed to install ${packageId}: ${error}`);
+                // Check if this is a success exit (CLIError with exitCode 0)
+                if (error instanceof errors_1.CLIError && error.exitCode === 0) {
+                    successCount++;
+                }
+                else {
+                    failCount++;
+                    console.error(`  ❌ Failed to install ${packageId}:`);
+                    console.error(`     Type: ${error?.constructor?.name}`);
+                    console.error(`     Message: ${error instanceof Error ? error.message : String(error)}`);
+                    if (error instanceof errors_1.CLIError) {
+                        console.error(`     ExitCode: ${error.exitCode}`);
+                    }
+                }
             }
         }
         console.log(`\n✅ Installed ${successCount}/${packageIds.length} packages`);
         if (failCount > 0) {
-            console.error(`❌ ${failCount} package${failCount === 1 ? '' : 's'} failed to install`);
-            process.exit(1);
+            throw new errors_1.CLIError(`❌ ${failCount} package${failCount === 1 ? '' : 's'} failed to install`, 1);
         }
     }
     catch (error) {
-        console.error(`❌ Failed to install from lockfile: ${error}`);
-        process.exit(1);
+        if (error instanceof errors_1.CLIError) {
+            throw error;
+        }
+        throw new errors_1.CLIError(`❌ Failed to install from lockfile: ${error}`, 1);
     }
 }
 function createInstallCommand() {
@@ -617,14 +678,7 @@ function createInstallCommand() {
         // Support both --as and --format (format is alias for as)
         const convertTo = options.format || options.as;
         if (convertTo && !['cursor', 'claude', 'continue', 'windsurf', 'copilot', 'kiro', 'agents.md', 'canonical'].includes(convertTo)) {
-            console.error('❌ Format must be one of: cursor, claude, continue, windsurf, copilot, kiro, agents.md, canonical');
-            console.log('\n💡 Examples:');
-            console.log('   prpm install my-package --as cursor       # Convert to Cursor format');
-            console.log('   prpm install my-package --format claude   # Convert to Claude format');
-            console.log('   prpm install my-package --format kiro     # Convert to Kiro format');
-            console.log('   prpm install my-package --format agents.md # Convert to Agents.md format');
-            console.log('   prpm install my-package                   # Install in native format');
-            process.exit(1);
+            throw new errors_1.CLIError('❌ Format must be one of: cursor, claude, continue, windsurf, copilot, kiro, agents.md, canonical\n\n💡 Examples:\n   prpm install my-package --as cursor       # Convert to Cursor format\n   prpm install my-package --format claude   # Convert to Claude format\n   prpm install my-package --format kiro     # Convert to Kiro format\n   prpm install my-package --format agents.md # Convert to Agents.md format\n   prpm install my-package                   # Install in native format', 1);
         }
         // If no package specified, install from lockfile
         if (!packageSpec) {
@@ -633,7 +687,6 @@ function createInstallCommand() {
                 subtype: options.subtype,
                 frozenLockfile: options.frozenLockfile
             });
-            process.exit(0);
             return;
         }
         await handleInstall(packageSpec, {
@@ -642,7 +695,6 @@ function createInstallCommand() {
             subtype: options.subtype,
             frozenLockfile: options.frozenLockfile
         });
-        process.exit(0);
     });
     return command;
 }

package/dist/commands/list.js

@@ -13,6 +13,7 @@ const lockfile_1 = require("../core/lockfile");
 const telemetry_1 = require("../core/telemetry");
 const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
+const errors_1 = require("../core/errors");
 /**
  * Get destination directory based on package type
  */
@@ -158,8 +159,7 @@ async function handleList() {
     }
     catch (err) {
         error = err instanceof Error ? err.message : String(err);
-        console.error(`❌ Failed to list packages: ${error}`);
-        process.exit(1);
+        throw new errors_1.CLIError(`❌ Failed to list packages: ${error}`, 1);
     }
     finally {
         // Track telemetry
@@ -184,7 +184,6 @@ function createListCommand() {
         .description('List all installed prompt packages')
         .action(async () => {
         await handleList();
-        process.exit(0);
     });
     return command;
 }

package/dist/commands/login.js

@@ -42,6 +42,7 @@ const commander_1 = require("commander");
 const http_1 = require("http");
 const telemetry_1 = require("../core/telemetry");
 const user_config_1 = require("../core/user-config");
+const errors_1 = require("../core/errors");
 /**
  * Start OAuth callback server
  */
@@ -270,9 +271,7 @@ async function handleLogin(options) {
     }
     catch (err) {
         error = err instanceof Error ? err.message : String(err);
-        console.error(`\n❌ Login failed: ${error}\n`);
-        console.error('💡 Try again or use "prpm login --token YOUR_TOKEN"\n');
-        process.exit(1);
+        throw new errors_1.CLIError(`\n❌ Login failed: ${error}\n\n💡 Try again or use "prpm login --token YOUR_TOKEN"\n`, 1);
     }
     finally {
         // Track telemetry
@@ -297,6 +296,5 @@ function createLoginCommand() {
         .option('--token <token>', 'Login with a personal access token')
         .action(async (options) => {
         await handleLogin(options);
-        process.exit(0);
     });
 }