prpm 0.1.8 → 0.1.10

package/dist/commands/init.js

@@ -63,12 +63,12 @@ const FORMAT_EXAMPLES = {
         files: ['.windsurf/rules', 'README.md'],
     },
     copilot: {
-        description: 'GitHub Copilot instructions',
-        files: ['.github/copilot-instructions.md', 'README.md'],
+        description: 'GitHub Copilot (repository-wide, path-specific, and chat modes)',
+        files: ['.github/copilot-instructions.md', '.github/instructions/typescript.instructions.md', '.github/chatmodes/code-reviewer.chatmode.md', 'README.md'],
     },
     kiro: {
-        description: 'Kiro steering files',
-        files: ['.kiro/steering/example.md', 'README.md'],
+        description: 'Kiro steering files and hooks',
+        files: ['.kiro/steering/example.md', '.kiro/hooks/example-hook.kiro.hook', 'README.md'],
     },
     'agents.md': {
         description: 'OpenAI agents.md project instructions',
@@ -145,31 +145,49 @@ Add your Windsurf AI coding rules here.
 `,
     },
     copilot: {
-        '.github/copilot-instructions.md': `---
-applyTo:
-  - "**/*.ts"
-  - "**/*.tsx"
----
+        '.github/copilot-instructions.md': `# GitHub Copilot Repository-Wide Instructions
 
-# GitHub Copilot Instructions
-
-Add your GitHub Copilot instructions here.
+These instructions apply to all files in this repository.
 
 ## Code Standards
 
 - Use TypeScript strict mode
 - Follow ESLint rules
-- Write JSDoc comments
+- Write JSDoc comments for public APIs
 
 ## Patterns to Follow
 
 - Use async/await for asynchronous operations
 - Implement error handling with try/catch
 - Export named functions instead of default exports
+- Write unit tests for all new features
+`,
+        '.github/instructions/typescript.instructions.md': `---
+applyTo:
+  - "**/*.ts"
+  - "**/*.tsx"
+---
+
+# TypeScript-Specific Instructions
+
+These instructions apply only to TypeScript files.
+
+## Type Safety
+
+- Use strict null checks
+- Avoid 'any' type - use 'unknown' or specific types
+- Define interfaces for all object shapes
+- Use type guards for runtime type checking
+
+## Patterns
+
+- Prefer const over let
+- Use template literals for string concatenation
+- Destructure objects and arrays when appropriate
 `,
-        '.github/chatmodes/example.chatmode.md': `---
-name: Example Chat Mode
-description: Example custom chat mode for GitHub Copilot
+        '.github/chatmodes/code-reviewer.chatmode.md': `---
+name: Code Reviewer
+description: Expert code reviewer focusing on best practices, security, and maintainability
 ---
 
 # Example Chat Mode
@@ -221,6 +239,23 @@ Describe the context where this steering file applies.
 
 Provide examples of correct patterns.
 `,
+        '.kiro/hooks/example-hook.kiro.hook': `{
+  "enabled": false,
+  "name": "Example Hook",
+  "description": "Example Kiro hook - disabled by default. Replace with your actual hook logic.",
+  "version": "1",
+  "when": {
+    "type": "fileEdited",
+    "patterns": [
+      "**/*.ts",
+      "**/*.tsx"
+    ]
+  },
+  "then": {
+    "type": "askAgent",
+    "prompt": "A file has been modified. Please review it for best practices:\\n1. Check for code quality issues\\n2. Verify error handling\\n3. Suggest improvements\\n4. Ensure tests are updated"
+  }
+}`,
     },
     'agents.md': {
         'agents.md': `# Project Coding Guidelines

package/dist/commands/install.js

@@ -37,6 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 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");
@@ -61,6 +62,7 @@ function getPackageIcon(format, subtype) {
         'collection': '📦',
         'chatmode': '💬',
         'tool': '🔧',
+        'hook': '🪝',
     };
     // Format-specific icons for rules/defaults
     const formatIcons = {
@@ -100,6 +102,7 @@ function getPackageLabel(format, subtype) {
         'collection': 'Collection',
         'chatmode': 'Chat Mode',
         'tool': 'Tool',
+        'hook': 'Hook',
     };
     const formatLabel = formatLabels[format];
     const subtypeLabel = subtypeLabels[subtype];
@@ -159,8 +162,8 @@ async function handleInstall(packageSpec, options) {
             // Normal mode - use specified version or locked version or latest
             version = options.version || specVersion || lockedVersion || 'latest';
         }
-        // Check if package is already installed
-        if (lockfile && lockfile.packages[packageId]) {
+        // 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
@@ -301,6 +304,7 @@ async function handleInstall(packageSpec, options) {
             const packageName = (0, filesystem_1.stripAuthorNamespace)(packageId);
             // For Claude skills, use SKILL.md filename in the package directory
             // For agents.md, use package-name/AGENTS.md directory structure
+            // For Copilot, use official naming conventions
             // For other formats, use package name as filename
             if (effectiveFormat === 'claude' && effectiveSubtype === 'skill') {
                 destPath = `${destDir}/SKILL.md`;
@@ -308,6 +312,21 @@ async function handleInstall(packageSpec, options) {
             else if (effectiveFormat === 'agents.md') {
                 destPath = `${destDir}/${packageName}/AGENTS.md`;
             }
+            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}`;
             }
@@ -337,10 +356,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
@@ -366,6 +389,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"
@@ -385,10 +410,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)();
@@ -434,7 +507,7 @@ async function handleInstall(packageSpec, options) {
             error,
             duration: Date.now() - startTime,
             data: {
-                packageId: packageSpec.split('@')[0],
+                packageId: packageSpec ? packageSpec.split('@')[0] : 'lockfile',
                 version: options.version || 'latest',
                 convertTo: options.as,
             },
@@ -530,11 +603,65 @@ function detectProjectFormat() {
         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) {
+            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);
+        }
+        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}...`);
+                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
+                });
+                successCount++;
+            }
+            catch (error) {
+                failCount++;
+                console.error(`  ❌ Failed to install ${packageId}: ${error}`);
+            }
+        }
+        console.log(`\n✅ Installed ${successCount}/${packageIds.length} packages`);
+        if (failCount > 0) {
+            console.error(`❌ ${failCount} package${failCount === 1 ? '' : 's'} failed to install`);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(`❌ Failed to install from lockfile: ${error}`);
+        process.exit(1);
+    }
+}
 function createInstallCommand() {
     const command = new commander_1.Command('install');
     command
-        .description('Install a package from the registry')
-        .argument('<package>', 'Package to install (e.g., react-rules or react-rules@1.2.0)')
+        .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')
@@ -553,6 +680,16 @@ function createInstallCommand() {
             console.log('   prpm install my-package                   # Install in native format');
             process.exit(1);
         }
+        // If no package specified, install from lockfile
+        if (!packageSpec) {
+            await installFromLockfile({
+                as: convertTo,
+                subtype: options.subtype,
+                frozenLockfile: options.frozenLockfile
+            });
+            process.exit(0);
+            return;
+        }
         await handleInstall(packageSpec, {
             version: options.version,
             as: convertTo,

package/dist/commands/publish.js

@@ -254,6 +254,28 @@ function normalizeFilePaths(files) {
         }
     });
 }
+/**
+ * Predict what the scoped package name will be after publishing
+ * This matches the server-side logic in packages.ts
+ */
+function predictScopedPackageName(manifestName, username, organization) {
+    const usernameLowercase = username.toLowerCase();
+    // If organization is specified, use @org-name/
+    if (organization) {
+        const orgNameLowercase = organization.toLowerCase();
+        const expectedPrefix = `@${orgNameLowercase}/`;
+        if (!manifestName.startsWith(expectedPrefix)) {
+            return `${expectedPrefix}${manifestName}`;
+        }
+        return manifestName;
+    }
+    // If package name doesn't already have a scope, add @username/
+    if (!manifestName.startsWith('@')) {
+        return `@${usernameLowercase}/${manifestName}`;
+    }
+    // Package already has a scope, return as-is
+    return manifestName;
+}
 /**
  * Create tarball from current directory
  */
@@ -442,6 +464,7 @@ async function handlePublish(options) {
                     console.log('');
                 }
                 let selectedOrgId;
+                let selectedOrgName;
                 // Check if organization is specified in manifest
                 if (manifest.organization && userInfo) {
                     const orgFromManifest = userInfo.organizations?.find((org) => org.name === manifest.organization || org.id === manifest.organization);
@@ -454,9 +477,12 @@ async function handlePublish(options) {
                             `Your role: ${orgFromManifest.role}. Required: owner, admin, or maintainer`);
                     }
                     selectedOrgId = orgFromManifest.id;
+                    selectedOrgName = orgFromManifest.name;
                 }
+                // Predict what the scoped package name will be
+                const scopedPackageName = predictScopedPackageName(manifest.name, userInfo?.username || config.username || 'unknown', selectedOrgName || manifest.organization);
                 console.log(`   Source: ${source}`);
-                console.log(`   Package: ${manifest.name}@${manifest.version}`);
+                console.log(`   Package: ${scopedPackageName}@${manifest.version}`);
                 console.log(`   Format: ${manifest.format} | Subtype: ${manifest.subtype}`);
                 console.log(`   Description: ${manifest.description}`);
                 console.log(`   Access: ${manifest.private ? 'private' : 'public'}`);
@@ -480,7 +506,7 @@ async function handlePublish(options) {
                     manifest.license_url = licenseInfo.url || undefined;
                 }
                 // Validate and warn about license (optional - will extract if present)
-                (0, license_extractor_1.validateLicenseInfo)(licenseInfo, manifest.name);
+                (0, license_extractor_1.validateLicenseInfo)(licenseInfo, scopedPackageName);
                 console.log('');
                 // Extract content snippet
                 console.log('📝 Extracting content snippet...');
@@ -488,7 +514,7 @@ async function handlePublish(options) {
                 if (snippet) {
                     manifest.snippet = snippet;
                 }
-                (0, snippet_extractor_1.validateSnippet)(snippet, manifest.name);
+                (0, snippet_extractor_1.validateSnippet)(snippet, scopedPackageName);
                 console.log('');
                 // Create tarball
                 console.log('📦 Creating package tarball...');
@@ -509,7 +535,7 @@ async function handlePublish(options) {
                 if (options.dryRun) {
                     console.log('✅ Dry run successful! Package is ready to publish.');
                     publishedPackages.push({
-                        name: manifest.name,
+                        name: scopedPackageName,
                         version: manifest.version,
                         url: ''
                     });
@@ -537,7 +563,8 @@ async function handlePublish(options) {
                     // Default to registry URL for unknown environments
                     webappUrl = registryUrl;
                 }
-                const packageUrl = `${webappUrl}/packages/${encodeURIComponent(manifest.name)}`;
+                // Use the name returned from the API (which includes auto-prefixed scope)
+                const packageUrl = `${webappUrl}/packages/${encodeURIComponent(result.name)}`;
                 console.log('');
                 console.log('✅ Package published successfully!');
                 console.log('');
@@ -545,16 +572,20 @@ async function handlePublish(options) {
                 console.log(`   Install: prpm install ${result.name}`);
                 console.log('');
                 publishedPackages.push({
-                    name: manifest.name,
+                    name: result.name, // Use scoped name from server
                     version: result.version,
                     url: packageUrl
                 });
             }
             catch (err) {
                 const pkgError = err instanceof Error ? err.message : String(err);
-                console.error(`\n❌ Failed to publish ${manifest.name}: ${pkgError}\n`);
+                // Try to use scoped name if we have user info, otherwise fall back to manifest name
+                const displayName = userInfo
+                    ? predictScopedPackageName(manifest.name, userInfo.username, manifest.organization)
+                    : manifest.name;
+                console.error(`\n❌ Failed to publish ${displayName}: ${pkgError}\n`);
                 failedPackages.push({
-                    name: manifest.name,
+                    name: displayName,
                     error: pkgError
                 });
             }

package/dist/commands/search.js

@@ -57,6 +57,7 @@ function getPackageIcon(format, subtype) {
         'collection': '📦',
         'chatmode': '💬',
         'tool': '🔧',
+        'hook': '🪝',
     };
     // Format-specific icons for rules/defaults
     const formatIcons = {
@@ -96,6 +97,7 @@ function getPackageLabel(format, subtype) {
         'collection': 'Collection',
         'chatmode': 'Chat Mode',
         'tool': 'Tool',
+        'hook': 'Hook',
     };
     const formatLabel = formatLabels[format];
     const subtypeLabel = subtypeLabels[subtype];
@@ -404,7 +406,7 @@ function createSearchCommand() {
         .description('Search for packages in the registry')
         .argument('[query]', 'Search query (optional when using --format/--subtype or --author)')
         .option('--format <format>', 'Filter by package format (cursor, claude, continue, windsurf, copilot, kiro, agents.md, generic, mcp)')
-        .option('--subtype <subtype>', 'Filter by package subtype (rule, agent, skill, slash-command, prompt, workflow, tool, template, collection)')
+        .option('--subtype <subtype>', 'Filter by package subtype (rule, agent, skill, slash-command, prompt, workflow, tool, template, collection, chatmode, hook)')
         .option('--author <username>', 'Filter by author username')
         .option('--language <language>', 'Filter by programming language (javascript, typescript, python, etc.)')
         .option('--framework <framework>', 'Filter by framework (react, nextjs, django, etc.)')

package/dist/core/filesystem.js

@@ -54,8 +54,20 @@ function getDestinationDir(format, subtype, name) {
         case 'windsurf':
             return '.windsurf/rules';
         case 'copilot':
+            // Copilot has different locations based on subtype:
+            // - Repository-wide instructions: .github/copilot-instructions.md
+            // - Path-specific instructions: .github/instructions/*.instructions.md
+            // - Chat modes: .github/chatmodes/*.chatmode.md
+            if (subtype === 'chatmode')
+                return '.github/chatmodes';
+            // Default to path-specific instructions directory
             return '.github/instructions';
         case 'kiro':
+            // Kiro has different locations based on subtype:
+            // - Steering files: .kiro/steering/*.md
+            // - Hooks: .kiro/hooks/*.kiro.hook (JSON files)
+            if (subtype === 'hook')
+                return '.kiro/hooks';
             return '.kiro/steering';
         case 'agents.md':
             return '.agents';

package/dist/types.js

@@ -32,4 +32,5 @@ exports.SUBTYPES = [
     'collection',
     'chatmode',
     'tool',
+    'hook',
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Prompt Package Manager CLI - Install and manage prompt-based files",
   "main": "dist/index.js",
   "bin": {
@@ -45,8 +45,8 @@
   "license": "MIT",
   "dependencies": {
     "@octokit/rest": "^22.0.0",
-    "@pr-pm/registry-client": "^1.3.6",
-    "@pr-pm/types": "^0.2.7",
+    "@pr-pm/registry-client": "^1.3.8",
+    "@pr-pm/types": "^0.2.9",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",