prpm 0.2.0 → 1.0.0

package/dist/commands/install.js

@@ -1,829 +0,0 @@
-"use strict";
-/**
- * Install command - Install packages from registry
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleInstall = handleInstall;
-exports.installFromLockfile = installFromLockfile;
-exports.createInstallCommand = createInstallCommand;
-const commander_1 = require("commander");
-const registry_client_1 = require("@pr-pm/registry-client");
-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 prompts_1 = require("../core/prompts");
-const path_1 = __importDefault(require("path"));
-const lockfile_1 = require("../core/lockfile");
-const cursor_config_1 = require("../core/cursor-config");
-const claude_config_1 = require("../core/claude-config");
-/**
- * Get icon for package format and subtype
- */
-function getPackageIcon(format, subtype) {
-    // Subtype icons take precedence
-    const subtypeIcons = {
-        'skill': '🎓',
-        'agent': '🤖',
-        'slash-command': '⚡',
-        'rule': '📋',
-        'prompt': '💬',
-        'collection': '📦',
-        'chatmode': '💬',
-        'tool': '🔧',
-        'hook': '🪝',
-    };
-    // Format-specific icons for rules/defaults
-    const formatIcons = {
-        'claude': '🤖',
-        'cursor': '📋',
-        'windsurf': '🌊',
-        'continue': '➡️',
-        'copilot': '✈️',
-        'kiro': '🎯',
-        'mcp': '🔗',
-        'agents.md': '📝',
-        'generic': '📦',
-    };
-    return subtypeIcons[subtype] || formatIcons[format] || '📦';
-}
-/**
- * Get human-readable label for package format and subtype
- */
-function getPackageLabel(format, subtype) {
-    const formatLabels = {
-        'claude': 'Claude',
-        'cursor': 'Cursor',
-        'windsurf': 'Windsurf',
-        'continue': 'Continue',
-        'copilot': 'GitHub Copilot',
-        'kiro': 'Kiro',
-        'mcp': 'MCP',
-        'agents.md': 'Agents.md',
-        'generic': '',
-    };
-    const subtypeLabels = {
-        'skill': 'Skill',
-        'agent': 'Agent',
-        'slash-command': 'Slash Command',
-        'rule': 'Rule',
-        'prompt': 'Prompt',
-        'collection': 'Collection',
-        'chatmode': 'Chat Mode',
-        'tool': 'Tool',
-        'hook': 'Hook',
-    };
-    const formatLabel = formatLabels[format];
-    const subtypeLabel = subtypeLabels[subtype];
-    if (format === 'generic') {
-        return subtypeLabel;
-    }
-    return `${formatLabel} ${subtypeLabel}`;
-}
-async function handleInstall(packageSpec, options) {
-    const startTime = Date.now();
-    let success = false;
-    let error;
-    try {
-        // Check if this is explicitly a collection install (collections/name)
-        if (packageSpec.startsWith('collections/')) {
-            const collectionId = packageSpec.replace('collections/', '');
-            console.log(`📥 Installing ${collectionId}@latest...`);
-            const { handleCollectionInstall } = await Promise.resolve().then(() => __importStar(require('./collections.js')));
-            return await handleCollectionInstall(collectionId, {
-                format: options.as,
-                skipOptional: false,
-                dryRun: false,
-            });
-        }
-        // Parse package spec (e.g., "react-rules" or "react-rules@1.2.0" or "@pr-pm/pkg@1.0.0")
-        // For scoped packages (@scope/name), the first @ is part of the package name
-        let packageId;
-        let specVersion;
-        if (packageSpec.startsWith('@')) {
-            // Scoped package: @scope/name or @scope/name@version
-            const match = packageSpec.match(/^(@[^/]+\/[^@]+)(?:@(.+))?$/);
-            if (!match) {
-                throw new Error('Invalid package spec format. Use: @scope/package or @scope/package@version');
-            }
-            packageId = match[1];
-            specVersion = match[2];
-        }
-        else {
-            // Unscoped package: name or name@version
-            const parts = packageSpec.split('@');
-            packageId = parts[0];
-            specVersion = parts[1];
-        }
-        // Read existing lock file
-        const lockfile = await (0, lockfile_1.readLockfile)();
-        const lockedVersion = (0, lockfile_1.getLockedVersion)(lockfile, packageId);
-        // Determine version to install
-        let version;
-        if (options.frozenLockfile) {
-            // Frozen lockfile mode - must use exact locked version
-            if (!lockedVersion) {
-                throw new Error(`Package ${packageId} not found in lock file. Run without --frozen-lockfile to update.`);
-            }
-            version = lockedVersion;
-        }
-        else {
-            // Normal mode - use specified version or locked version or latest
-            version = options.version || specVersion || lockedVersion || 'latest';
-        }
-        // Check if package is already installed (skip if --force option is set)
-        if (!options.force && lockfile && lockfile.packages[packageId]) {
-            const installedPkg = lockfile.packages[packageId];
-            const requestedVersion = options.version || specVersion;
-            // If no specific version requested, or same version requested
-            if (!requestedVersion || requestedVersion === 'latest' || requestedVersion === installedPkg.version) {
-                console.log(`\n✨ Package already installed!`);
-                console.log(`   📦 ${packageId}@${installedPkg.version}`);
-                console.log(`   🔄 Format: ${installedPkg.format || 'unknown'} | Subtype: ${installedPkg.subtype || 'unknown'}`);
-                console.log(`\n💡 To reinstall or upgrade:`);
-                console.log(`   prpm upgrade ${packageId}     # Upgrade to latest version`);
-                console.log(`   prpm uninstall ${packageId}   # Uninstall first, then install`);
-                success = true;
-                return;
-            }
-            else if (requestedVersion !== installedPkg.version) {
-                // Different version requested - allow upgrade/downgrade
-                console.log(`📦 Upgrading ${packageId}: ${installedPkg.version} → ${requestedVersion}`);
-            }
-        }
-        console.log(`📥 Installing ${packageId}@${version}...`);
-        const config = await (0, user_config_1.getConfig)();
-        const client = (0, registry_client_1.getRegistryClient)(config);
-        // Check if this is a collection first (by trying to fetch it)
-        // Collections can be: name, scope/name, or @scope/name
-        let isCollection = false;
-        try {
-            // Try to parse as collection
-            let scope;
-            let name_slug;
-            const matchWithScope = packageId.match(/^@?([^/]+)\/([^/@]+)$/);
-            if (matchWithScope) {
-                [, scope, name_slug] = matchWithScope;
-            }
-            else {
-                // No scope, assume 'collection' scope
-                scope = 'collection';
-                name_slug = packageId;
-            }
-            // Try to fetch as collection
-            await client.getCollection(scope, name_slug, version === 'latest' ? undefined : version);
-            isCollection = true;
-            // If successful, delegate to collection install handler
-            const { handleCollectionInstall } = await Promise.resolve().then(() => __importStar(require('./collections.js')));
-            return await handleCollectionInstall(packageId, {
-                format: options.as,
-                skipOptional: false,
-                dryRun: false,
-            });
-        }
-        catch (err) {
-            // Not a collection, continue with package install
-            isCollection = false;
-        }
-        // Get package info
-        const pkg = await client.getPackage(packageId);
-        const typeIcon = getPackageIcon(pkg.format, pkg.subtype);
-        const typeLabel = getPackageLabel(pkg.format, pkg.subtype);
-        console.log(`   ${pkg.name} ${pkg.official ? '🏅' : ''}`);
-        console.log(`   ${pkg.description || 'No description'}`);
-        console.log(`   ${typeIcon} Type: ${typeLabel}`);
-        // Check if this is a Claude hook and show informational message
-        if (pkg.format === 'claude' && pkg.subtype === 'hook') {
-            // Only show detailed warning if not part of a collection (to avoid spam)
-            if (!options.fromCollection) {
-                console.log(`\n📌 Installing Claude Hook`);
-                console.log(`   ⚠️  Note: Hooks execute shell commands automatically.`);
-                console.log(`   📖 Review the hook configuration in .claude/settings.json after installation.`);
-                console.log();
-            }
-            else {
-                // Brief message for collection installs
-                console.log(`   🪝 Hook (merges into .claude/settings.json)`);
-            }
-        }
-        // Determine format preference with priority order:
-        // 1. CLI --as flag (highest priority)
-        // 2. defaultFormat from .prpmrc config
-        // 3. Auto-detection based on existing directories
-        // 4. Package native format (fallback)
-        let format = options.as;
-        if (!format) {
-            // Check for config default format
-            if (config.defaultFormat) {
-                format = config.defaultFormat;
-                console.log(`   ⚙️  Using default format from config: ${format}`);
-            }
-            else {
-                // Auto-detect format based on existing directories
-                const detectedFormat = await (0, filesystem_1.autoDetectFormat)();
-                if (detectedFormat) {
-                    format = detectedFormat;
-                    console.log(`   🔍 Auto-detected ${format} format (found .${format}/ directory)`);
-                }
-                else {
-                    // No config or detection, use package's native format
-                    format = pkg.format;
-                }
-            }
-        }
-        // Special handling for Claude packages: default to CLAUDE.md if it doesn't exist
-        // BUT only for packages that are generic rules (not skills, agents, or commands)
-        if (!options.as && pkg.format === 'claude' && pkg.subtype === 'rule') {
-            const claudeMdExists = await (0, filesystem_1.fileExists)('CLAUDE.md');
-            if (!claudeMdExists) {
-                // CLAUDE.md doesn't exist, install as CLAUDE.md (recommended format for Claude Code)
-                format = 'claude-md';
-                console.log(`   💡 Installing as CLAUDE.md (recommended for Claude Code)`);
-                console.log(`      To install as skill instead, use: prpm install ${packageId} --as claude`);
-            }
-            else {
-                // CLAUDE.md already exists, install as skill to avoid overwriting
-                console.log(`   ℹ️  CLAUDE.md already exists, installing as skill in .claude/skills/`);
-            }
-        }
-        if (options.as && format !== 'canonical') {
-            console.log(`   🔄 Converting to ${format} format...`);
-        }
-        // Determine version to install
-        let tarballUrl;
-        let actualVersion;
-        if (version === 'latest') {
-            if (!pkg.latest_version) {
-                throw new Error('No versions available for this package');
-            }
-            tarballUrl = pkg.latest_version.tarball_url;
-            actualVersion = pkg.latest_version.version;
-            console.log(`   📦 Installing version ${pkg.latest_version.version}`);
-        }
-        else {
-            const versionInfo = await client.getPackageVersion(packageId, version);
-            tarballUrl = versionInfo.tarball_url;
-            actualVersion = version;
-            console.log(`   📦 Installing version ${version}`);
-        }
-        // Download package in requested format
-        console.log(`   ⬇️  Downloading...`);
-        const tarball = await client.downloadPackage(tarballUrl, { format });
-        // Extract tarball and save files
-        console.log(`   📂 Extracting...`);
-        // Determine effective format and subtype (from conversion or package native format)
-        const effectiveFormat = format || pkg.format;
-        const effectiveSubtype = options.subtype || pkg.subtype;
-        // Extract all files from tarball
-        const extractedFiles = await extractTarball(tarball, packageId);
-        const locationOverride = options.location?.trim();
-        if (locationOverride && effectiveFormat !== 'agents.md') {
-            console.log(`   ⚠️  --location option currently only applies to Agents.md installs. Ignoring for ${effectiveFormat}.`);
-        }
-        // Track where files were saved for user feedback
-        let destPath;
-        let fileCount = 0;
-        let hookMetadata = undefined;
-        // Special handling for CLAUDE.md format (goes in project root)
-        if (format === 'claude-md') {
-            if (extractedFiles.length !== 1) {
-                throw new Error('CLAUDE.md format only supports single-file packages');
-            }
-            let mainFile = extractedFiles[0].content;
-            destPath = 'CLAUDE.md';
-            await (0, filesystem_1.saveFile)(destPath, mainFile);
-            fileCount = 1;
-        }
-        // Check if this is a multi-file package
-        else if (extractedFiles.length === 1) {
-            const destDir = (0, filesystem_1.getDestinationDir)(effectiveFormat, effectiveSubtype, pkg.name);
-            // Single file package
-            let mainFile = extractedFiles[0].content;
-            // Determine file extension based on effective format
-            // Cursor rules use .mdc, but slash commands and other files use .md
-            const fileExtension = (effectiveFormat === 'cursor' && format === 'cursor') ? 'mdc' : 'md';
-            const packageName = (0, filesystem_1.stripAuthorNamespace)(packageId);
-            // For Claude skills, use SKILL.md filename in the package directory
-            // For agents.md, always install as AGENTS.md in the project root
-            // For Copilot, use official naming conventions
-            // For other formats, use package name as filename
-            if (effectiveFormat === 'claude' && effectiveSubtype === 'skill') {
-                destPath = `${destDir}/SKILL.md`;
-            }
-            else if (effectiveFormat === 'claude' && effectiveSubtype === 'hook') {
-                // Claude hooks are merged into settings.json
-                destPath = `${destDir}/settings.json`;
-            }
-            else if (effectiveFormat === 'agents.md') {
-                let targetPath = 'AGENTS.md';
-                if (locationOverride) {
-                    targetPath = path_1.default.join(locationOverride, 'AGENTS.override.md');
-                    console.log(`   📁 Installing Agents.md package to custom location: ${targetPath}`);
-                }
-                destPath = targetPath;
-                if (await (0, filesystem_1.fileExists)(destPath)) {
-                    if (options.force) {
-                        console.log(`   ⚠️  ${destPath} already exists - overwriting (forced).`);
-                    }
-                    else {
-                        console.log(`   ⚠️  ${destPath} already exists.`);
-                        const overwrite = await (0, prompts_1.promptYesNo)(`   Overwrite existing ${destPath}? (y/N): `, `   ⚠️  Non-interactive terminal detected. Remove or rename ${destPath} to continue.`);
-                        if (!overwrite) {
-                            console.log(`   🚫 Skipping install to avoid overwriting ${destPath}`);
-                            success = true;
-                            return;
-                        }
-                    }
-                }
-            }
-            else if (effectiveFormat === 'copilot') {
-                // Official GitHub Copilot naming conventions
-                if (effectiveSubtype === 'chatmode') {
-                    // Chat modes: .github/chatmodes/NAME.chatmode.md
-                    destPath = `${destDir}/${packageName}.chatmode.md`;
-                }
-                else {
-                    // Path-specific instructions: .github/instructions/NAME.instructions.md
-                    destPath = `${destDir}/${packageName}.instructions.md`;
-                }
-            }
-            else if (effectiveFormat === 'kiro' && effectiveSubtype === 'hook') {
-                // Kiro hooks use .kiro.hook extension (JSON files)
-                destPath = `${destDir}/${packageName}.kiro.hook`;
-            }
-            else {
-                destPath = `${destDir}/${packageName}.${fileExtension}`;
-            }
-            // Handle cursor format - add header if missing for .mdc files
-            if (format === 'cursor' && effectiveFormat === 'cursor') {
-                if (!(0, cursor_config_1.hasMDCHeader)(mainFile)) {
-                    console.log(`   ⚠️  Adding missing MDC header...`);
-                    mainFile = (0, cursor_config_1.addMDCHeader)(mainFile, pkg.description);
-                }
-                // Apply cursor config if available
-                if (config.cursor) {
-                    console.log(`   ⚙️  Applying cursor config...`);
-                    mainFile = (0, cursor_config_1.applyCursorConfig)(mainFile, config.cursor);
-                }
-            }
-            // Apply Claude config if downloading in Claude format
-            if (format === 'claude' && (0, claude_config_1.hasClaudeHeader)(mainFile)) {
-                if (config.claude) {
-                    console.log(`   ⚙️  Applying Claude agent config...`);
-                    mainFile = (0, claude_config_1.applyClaudeConfig)(mainFile, config.claude);
-                }
-            }
-            // Special handling for Claude hooks - merge into settings.json
-            if (effectiveFormat === 'claude' && effectiveSubtype === 'hook') {
-                const { readFile } = await Promise.resolve().then(() => __importStar(require('fs/promises')));
-                // Parse the hook configuration from the downloaded file
-                let hookConfig;
-                try {
-                    hookConfig = JSON.parse(mainFile);
-                }
-                catch (err) {
-                    throw new Error(`Invalid hook configuration: ${err}. Hook file must be valid JSON.`);
-                }
-                // Generate unique hook ID for this installation
-                const hookId = `${packageId}@${actualVersion || version}`;
-                // Read existing settings.json if it exists
-                let existingSettings = { hooks: {} };
-                if (await (0, filesystem_1.fileExists)(destPath)) {
-                    try {
-                        const existingContent = await readFile(destPath, 'utf-8');
-                        existingSettings = JSON.parse(existingContent);
-                        if (!existingSettings.hooks) {
-                            existingSettings.hooks = {};
-                        }
-                    }
-                    catch (err) {
-                        console.log(`   ⚠️  Warning: Could not parse existing settings.json, creating new one.`);
-                        existingSettings = { hooks: {} };
-                    }
-                }
-                // Track which events this hook adds to
-                const events = [];
-                // Merge the new hook configuration
-                // Assume the downloaded file contains a hooks object
-                if (hookConfig.hooks) {
-                    for (const [event, eventHooks] of Object.entries(hookConfig.hooks)) {
-                        if (!existingSettings.hooks[event]) {
-                            existingSettings.hooks[event] = [];
-                        }
-                        // Add hook ID to each hook config for tracking
-                        const hooksWithId = eventHooks.map(hook => ({
-                            ...hook,
-                            __prpm_hook_id: hookId, // Internal tracking ID
-                        }));
-                        // Add new hooks to the event
-                        existingSettings.hooks[event] = [
-                            ...existingSettings.hooks[event],
-                            ...hooksWithId
-                        ];
-                        events.push(event);
-                    }
-                    console.log(`   ✓ Merged hook configuration into settings.json`);
-                    // Store metadata for lockfile
-                    hookMetadata = { events, hookId };
-                }
-                mainFile = JSON.stringify(existingSettings, null, 2);
-            }
-            await (0, filesystem_1.saveFile)(destPath, mainFile);
-            fileCount = 1;
-        }
-        else {
-            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
-                : 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
-            if (effectiveFormat === 'claude' && effectiveSubtype === 'skill') {
-                const skillMdIndex = extractedFiles.findIndex(f => f.name === 'SKILL.md' || f.name.endsWith('/SKILL.md'));
-                if (skillMdIndex === -1) {
-                    // SKILL.md not found, look for common variations and auto-rename
-                    const skillFileIndex = extractedFiles.findIndex(f => f.name.toLowerCase().endsWith('skill.md') ||
-                        (f.name.endsWith('.md') && extractedFiles.length === 1) // Single .md file
-                    );
-                    if (skillFileIndex !== -1) {
-                        const oldName = extractedFiles[skillFileIndex].name;
-                        const basePath = oldName.substring(0, oldName.lastIndexOf('/') + 1);
-                        const newName = basePath + 'SKILL.md';
-                        console.log(`   ⚠️  Auto-fixing skill filename: ${oldName} → ${newName}`);
-                        console.log(`      (Claude skills must be named SKILL.md per official documentation)`);
-                        extractedFiles[skillFileIndex].name = newName;
-                    }
-                    else {
-                        throw new Error('Claude skills must contain a SKILL.md file. ' +
-                            'According to Claude documentation, skills must have a file named SKILL.md in their directory. ' +
-                            'No suitable file found to rename. Please update the package to follow this requirement.');
-                    }
-                }
-            }
-            // 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"
-                //          ".claude/skills/agent-builder/SKILL.md" → "SKILL.md"
-                // Find the common prefix (the package's root directory in the tarball)
-                const pathParts = file.name.split('/');
-                // For Claude skills, the tarball structure is typically: .claude/skills/package-name/...
-                // We want to strip everything up to and including the package-name directory
-                let relativeFileName = file.name;
-                // Find the skills directory index
-                const skillsDirIndex = pathParts.indexOf('skills');
-                if (skillsDirIndex !== -1 && pathParts.length > skillsDirIndex + 2) {
-                    // Skip: .claude/skills/package-name/ and keep the rest
-                    relativeFileName = pathParts.slice(skillsDirIndex + 2).join('/');
-                }
-                else if (pathParts.length > 1) {
-                    // Fallback: just take the filename (last part)
-                    relativeFileName = pathParts[pathParts.length - 1];
-                }
-                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)();
-        (0, lockfile_1.addToLockfile)(updatedLockfile, packageId, {
-            version: actualVersion || version,
-            tarballUrl,
-            format: pkg.format, // Preserve original package format
-            subtype: pkg.subtype, // Preserve original package subtype
-            installedPath: destPath,
-            fromCollection: options.fromCollection,
-            hookMetadata, // Track hook installation metadata for uninstall
-        });
-        (0, lockfile_1.setPackageIntegrity)(updatedLockfile, packageId, tarball);
-        await (0, lockfile_1.writeLockfile)(updatedLockfile);
-        // Update lockfile (already done above via addToLockfile + writeLockfile)
-        // No need to call addPackage again as it would be redundant
-        // Track download analytics
-        await client.trackDownload(packageId, {
-            version: actualVersion || version,
-            client: 'cli',
-            format,
-        });
-        // Display the incremented download count
-        const newDownloadCount = pkg.total_downloads + 1;
-        console.log(`\n✅ Successfully installed ${packageId}`);
-        console.log(`   📁 Saved to: ${destPath}`);
-        console.log(`   🔒 Lock file updated`);
-        console.log(`\n💡 This package has been downloaded ${newDownloadCount.toLocaleString()} times`);
-        success = true;
-    }
-    catch (err) {
-        error = err instanceof Error ? err.message : String(err);
-        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({
-            command: 'install',
-            success,
-            error,
-            duration: Date.now() - startTime,
-            data: {
-                packageId: packageSpec ? packageSpec.split('@')[0] : 'lockfile',
-                version: options.version || 'latest',
-                convertTo: options.as,
-            },
-        });
-        await telemetry_1.telemetry.shutdown();
-    }
-}
-async function extractTarball(tarball, packageId) {
-    const files = [];
-    const zlib = await Promise.resolve().then(() => __importStar(require('zlib')));
-    const fs = await Promise.resolve().then(() => __importStar(require('fs')));
-    const os = await Promise.resolve().then(() => __importStar(require('os')));
-    return new Promise((resolve, reject) => {
-        // Decompress gzip first
-        zlib.gunzip(tarball, async (err, result) => {
-            if (err) {
-                reject(err);
-                return;
-            }
-            // Check if this is a tar archive by looking for tar header
-            const isTar = result.length > 257 && result.toString('utf-8', 257, 262) === 'ustar';
-            if (!isTar) {
-                // Not a tar archive, treat as single gzipped file
-                files.push({
-                    name: `${packageId}.md`,
-                    content: result.toString('utf-8')
-                });
-                resolve(files);
-                return;
-            }
-            // Create temp directory for extraction
-            const tmpDir = await fs.promises.mkdtemp(path_1.default.join(os.tmpdir(), 'prpm-'));
-            try {
-                // Write tar data to temp file
-                const tarPath = path_1.default.join(tmpDir, 'package.tar');
-                await fs.promises.writeFile(tarPath, result);
-                // Extract using tar library
-                await tar.extract({
-                    file: tarPath,
-                    cwd: tmpDir,
-                });
-                // Read all extracted files
-                const extractedFiles = await fs.promises.readdir(tmpDir, { withFileTypes: true, recursive: true });
-                // Files to exclude from package content (metadata files)
-                const excludeFiles = ['package.tar', 'prpm.json', 'README.md', 'LICENSE', 'LICENSE.txt', 'LICENSE.md'];
-                for (const entry of extractedFiles) {
-                    if (entry.isFile() && !excludeFiles.includes(entry.name)) {
-                        const filePath = path_1.default.join(entry.path || tmpDir, entry.name);
-                        const content = await fs.promises.readFile(filePath, 'utf-8');
-                        const relativePath = path_1.default.relative(tmpDir, filePath);
-                        files.push({
-                            name: relativePath,
-                            content
-                        });
-                    }
-                }
-                if (files.length === 0) {
-                    // No files found, fall back to single file
-                    files.push({
-                        name: `${packageId}.md`,
-                        content: result.toString('utf-8')
-                    });
-                }
-                // Cleanup
-                await fs.promises.rm(tmpDir, { recursive: true, force: true });
-                resolve(files);
-            }
-            catch (tarErr) {
-                // Cleanup and fall back to single file
-                await fs.promises.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
-                files.push({
-                    name: `${packageId}.md`,
-                    content: result.toString('utf-8')
-                });
-                resolve(files);
-            }
-        });
-    });
-}
-/**
- * Detect project format from existing directories
- */
-function detectProjectFormat() {
-    const fs = require('fs');
-    if (fs.existsSync('.cursor/rules') || fs.existsSync('.cursor'))
-        return 'cursor';
-    if (fs.existsSync('.claude/agents') || fs.existsSync('.claude'))
-        return 'claude';
-    if (fs.existsSync('.continue'))
-        return 'continue';
-    if (fs.existsSync('.windsurf'))
-        return 'windsurf';
-    return null;
-}
-/**
- * Install all packages from prpm.lock
- */
-async function installFromLockfile(options) {
-    try {
-        // Read lockfile
-        const lockfile = await (0, lockfile_1.readLockfile)();
-        if (!lockfile) {
-            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) {
-            console.log('✅ No packages to install (prpm.lock is empty)');
-            return;
-        }
-        console.log(`📦 Installing ${packageIds.length} package${packageIds.length === 1 ? '' : 's'} from prpm.lock...\n`);
-        let successCount = 0;
-        let failCount = 0;
-        // Install each package from lockfile
-        for (const packageId of packageIds) {
-            const lockEntry = lockfile.packages[packageId];
-            try {
-                // Extract package spec (strip version if present in packageId)
-                const packageSpec = packageId.includes('@') && !packageId.startsWith('@')
-                    ? packageId.substring(0, packageId.lastIndexOf('@'))
-                    : packageId;
-                console.log(`  Installing ${packageId}...`);
-                let locationOverride = options.location;
-                if (!locationOverride && lockEntry.format === 'agents.md' && lockEntry.installedPath) {
-                    const baseName = path_1.default.basename(lockEntry.installedPath);
-                    if (baseName === 'AGENTS.override.md') {
-                        locationOverride = path_1.default.dirname(lockEntry.installedPath);
-                    }
-                    else if (baseName !== 'AGENTS.md') {
-                        // If the lockfile contains a non-standard filename, honor its directory
-                        locationOverride = path_1.default.dirname(lockEntry.installedPath);
-                    }
-                }
-                await handleInstall(packageSpec, {
-                    version: lockEntry.version,
-                    as: options.as || lockEntry.format,
-                    subtype: options.subtype || lockEntry.subtype,
-                    frozenLockfile: options.frozenLockfile,
-                    force: true, // Force reinstall when installing from lockfile
-                    location: locationOverride,
-                });
-                successCount++;
-            }
-            catch (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) {
-            throw new errors_1.CLIError(`❌ ${failCount} package${failCount === 1 ? '' : 's'} failed to install`, 1);
-        }
-    }
-    catch (error) {
-        if (error instanceof errors_1.CLIError) {
-            throw error;
-        }
-        throw new errors_1.CLIError(`❌ Failed to install from lockfile: ${error}`, 1);
-    }
-}
-function createInstallCommand() {
-    const command = new commander_1.Command('install');
-    command
-        .description('Install a package from the registry, or install all packages from prpm.lock if no package specified')
-        .argument('[package]', 'Package to install (e.g., react-rules or react-rules@1.2.0). If omitted, installs all packages from prpm.lock')
-        .option('--version <version>', 'Specific version to install')
-        .option('--as <format>', 'Convert and install in specific format (cursor, claude, continue, windsurf, copilot, kiro, agents.md, canonical)')
-        .option('--format <format>', 'Alias for --as')
-        .option('--location <path>', 'Custom location for installed files (currently supports Agents.md)')
-        .option('--subtype <subtype>', 'Specify subtype when converting (skill, agent, rule, etc.)')
-        .option('--frozen-lockfile', 'Fail if lock file needs to be updated (for CI)')
-        .action(async (packageSpec, options) => {
-        // 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)) {
-            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) {
-            await installFromLockfile({
-                as: convertTo,
-                subtype: options.subtype,
-                frozenLockfile: options.frozenLockfile,
-                location: options.location,
-            });
-            return;
-        }
-        await handleInstall(packageSpec, {
-            version: options.version,
-            as: convertTo,
-            subtype: options.subtype,
-            frozenLockfile: options.frozenLockfile,
-            location: options.location,
-        });
-    });
-    return command;
-}