prpm 0.1.7 → 0.1.9

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}`;
             }
@@ -367,7 +386,25 @@ async function handleInstall(packageSpec, options) {
                 }
             }
             for (const file of extractedFiles) {
-                const filePath = `${packageDir}/${file.name}`;
+                // 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];
+                }
+                const filePath = `${packageDir}/${relativeFileName}`;
                 await (0, filesystem_1.saveFile)(filePath, file.content);
                 fileCount++;
             }
@@ -416,7 +453,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,
             },
@@ -512,11 +549,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')
@@ -535,6 +626,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/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/commands/uninstall.js

@@ -27,40 +27,24 @@ async function handleUninstall(name) {
         const packageName = (0, filesystem_1.stripAuthorNamespace)(name);
         const destDir = (0, filesystem_1.getDestinationDir)(format, subtype, packageName);
         const fileExtension = pkg.format === 'cursor' ? 'mdc' : 'md';
-        // For Claude skills, check the directory structure first (since they use SKILL.md)
+        // For Claude skills, delete the entire directory (may contain multiple files)
         if (format === 'claude' && subtype === 'skill') {
-            // Claude skills are in .claude/skills/${packageName}/ with SKILL.md file
-            const skillPath = `${destDir}/SKILL.md`;
-            if (await (0, filesystem_1.fileExists)(skillPath)) {
-                // Delete the SKILL.md file
-                await (0, filesystem_1.deleteFile)(skillPath);
-                console.log(`   🗑️  Deleted file: ${skillPath}`);
-                // If the directory is empty or only contains SKILL.md, delete the directory too
-                try {
-                    const dirContents = await fs_1.promises.readdir(destDir);
-                    if (dirContents.length === 0) {
-                        await fs_1.promises.rmdir(destDir);
-                        console.log(`   🗑️  Deleted empty directory: ${destDir}`);
-                    }
-                }
-                catch (error) {
-                    // Directory doesn't exist or can't be deleted, that's okay
+            // Claude skills are in .claude/skills/${packageName}/ directory
+            // Delete the entire directory (includes SKILL.md, EXAMPLES.md, docs/, etc.)
+            try {
+                const stats = await fs_1.promises.stat(destDir);
+                if (stats.isDirectory()) {
+                    await fs_1.promises.rm(destDir, { recursive: true, force: true });
+                    console.log(`   🗑️  Deleted directory: ${destDir}`);
                 }
             }
-            else {
-                // Try the whole directory
-                try {
-                    const stats = await fs_1.promises.stat(destDir);
-                    if (stats.isDirectory()) {
-                        await fs_1.promises.rm(destDir, { recursive: true, force: true });
-                        console.log(`   🗑️  Deleted directory: ${destDir}`);
-                    }
+            catch (error) {
+                const err = error;
+                if (err.code === 'ENOENT') {
+                    console.warn(`   ⚠️  Skill directory not found: ${destDir}`);
                 }
-                catch (error) {
-                    const err = error;
-                    if (err.code !== 'ENOENT') {
-                        console.warn(`   ⚠️  Could not delete package files: ${err.message}`);
-                    }
+                else {
+                    console.warn(`   ⚠️  Could not delete skill directory: ${err.message}`);
                 }
             }
         }

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.7",
+  "version": "0.1.9",
   "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.5",
-    "@pr-pm/types": "^0.2.6",
+    "@pr-pm/registry-client": "^1.3.7",
+    "@pr-pm/types": "^0.2.8",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",