prpm 0.0.4 → 0.0.6

package/README.md

@@ -20,7 +20,7 @@ brew install prpm
 ```
 
 ### Direct Download
-Download the latest binary from [GitHub Releases](https://github.com/khaliqgant/prompt-package-manager/releases).
+Download the latest binary from [GitHub Releases](https://github.com/pr-pm/prpm/releases).
 
 ## Quick Start
 
@@ -908,10 +908,10 @@ export PRPM_REGISTRY_URL=https://custom-registry.com
 
 ## Support & Resources
 
-- **GitHub**: https://github.com/khaliqgant/prompt-package-manager
-- **Issues**: https://github.com/khaliqgant/prompt-package-manager/issues
+- **GitHub**: https://github.com/pr-pm/prpm
+- **Issues**: https://github.com/pr-pm/prpm/issues
 - **Registry**: https://registry.prpm.dev
-- **Documentation**: https://github.com/khaliqgant/prompt-package-manager#readme
+- **Documentation**: https://github.com/pr-pm/prpm#readme
 
 ## Contributing
 

package/dist/commands/index.js

@@ -169,6 +169,9 @@ async function handleIndex(options = {}) {
         console.error(`❌ Failed to index packages: ${error}`);
         process.exit(1);
     }
+    finally {
+        process.exit(0);
+    }
 }
 /**
  * Create the index command

package/dist/commands/login.js

@@ -115,6 +115,7 @@ async function loginWithOAuth(registryUrl) {
     const userId = `cli_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
     try {
         // Get the Nango connect session from the registry
+        console.log(`   Connecting to: ${registryUrl}`);
         const response = await fetch(`${registryUrl}/api/v1/auth/nango/cli/connect-session`, {
             method: 'POST',
             headers: {
@@ -127,7 +128,8 @@ async function loginWithOAuth(registryUrl) {
             }),
         });
         if (!response.ok) {
-            throw new Error('Failed to get authentication session');
+            const errorText = await response.text().catch(() => 'Unable to read error response');
+            throw new Error(`Failed to get authentication session (${response.status}): ${errorText}`);
         }
         const responseData = await response.json();
         const { connectSessionToken } = responseData;
@@ -156,6 +158,15 @@ async function loginWithOAuth(registryUrl) {
         return { token: result.token, username: result.username || 'unknown' };
     }
     catch (error) {
+        if (error instanceof Error) {
+            // Check for common network errors
+            if (error.message.includes('ECONNREFUSED')) {
+                throw new Error(`Cannot connect to registry at ${registryUrl}. Is the registry running?`);
+            }
+            else if (error.message.includes('ENOTFOUND') || error.message.includes('getaddrinfo')) {
+                throw new Error(`Cannot resolve registry hostname: ${registryUrl}. Check your internet connection.`);
+            }
+        }
         throw new Error(`Authentication failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
 }
@@ -172,22 +183,15 @@ async function pollForAuthentication(registryUrl, userId) {
                 const { authenticated, connectionId } = await response.json();
                 if (authenticated && connectionId) {
                     // Authentication completed, get the JWT token
-                    const callbackResponse = await fetch(`${registryUrl}/api/v1/auth/nango/callback`, {
-                        method: 'POST',
-                        headers: {
-                            'Content-Type': 'application/json',
-                        },
-                        body: JSON.stringify({
-                            connectionId,
-                            redirectUrl: '/cli-success',
-                        }),
-                    });
-                    if (callbackResponse.ok) {
-                        const result = await callbackResponse.json();
-                        return {
-                            token: result.token,
-                            username: result.username,
-                        };
+                    const statusResponse = await fetch(`${registryUrl}/api/v1/auth/nango/status/${connectionId}`);
+                    if (statusResponse.ok) {
+                        const result = await statusResponse.json();
+                        if (result.ready && result.token) {
+                            return {
+                                token: result.token,
+                                username: result.username,
+                            };
+                        }
                     }
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Prompt Package Manager CLI - Install and manage prompt-based files",
   "main": "dist/index.js",
   "bin": {
@@ -30,13 +30,13 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/khaliqgant/prompt-package-manager.git",
+    "url": "git+https://github.com/pr-pm/prpm.git",
     "directory": "packages/cli"
   },
   "bugs": {
-    "url": "https://github.com/khaliqgant/prompt-package-manager/issues"
+    "url": "https://github.com/pr-pm/prpm/issues"
   },
-  "homepage": "https://github.com/khaliqgant/prompt-package-manager#readme",
+  "homepage": "https://github.com/pr-pm/prpm#readme",
   "author": "khaliqgant",
   "license": "MIT",
   "dependencies": {
@@ -65,6 +65,7 @@
   },
   "files": [
     "dist",
+    "schemas",
     "README.md",
     "LICENSE"
   ],

package/schemas/README.md

@@ -0,0 +1,197 @@
+# PRPM Manifest Schema
+
+This directory contains the JSON Schema for validating `prpm.json` manifest files.
+
+## Schema File
+
+**Location**: `prpm-manifest.schema.json`
+
+**Schema URL**: `https://prpm.dev/schemas/manifest.json`
+
+## Alternative: marketplace.json
+
+PRPM also supports Claude's `marketplace.json` format as an alternative to `prpm.json`. If you have a `.claude/marketplace.json` file, PRPM will automatically detect and convert it when you run `prpm publish`.
+
+See [marketplace.json documentation](../docs/marketplace-json.md) for details.
+
+## Using the Schema
+
+### In Your Editor (VS Code, etc.)
+
+Add this line to the top of your `prpm.json` file to get autocomplete and validation:
+
+```json
+{
+  "$schema": "https://prpm.dev/schemas/manifest.json",
+  "name": "@username/my-package",
+  "version": "1.0.0",
+  ...
+}
+```
+
+### Programmatic Validation
+
+The schema is automatically used by `prpm publish` to validate your manifest before publishing.
+
+```typescript
+import { validateManifestSchema } from '@prpm/cli/core/schema-validator';
+
+const manifest = {
+  name: 'my-package',
+  version: '1.0.0',
+  description: 'My package description',
+  type: 'claude-skill',
+  files: ['skill.md']
+};
+
+const result = validateManifestSchema(manifest);
+if (!result.valid) {
+  console.error('Validation errors:', result.errors);
+}
+```
+
+### With JSON Schema Validators
+
+You can use any JSON Schema validator (like AJV, jsonschema, etc.):
+
+```javascript
+const Ajv = require('ajv');
+const schema = require('./prpm-manifest.schema.json');
+
+const ajv = new Ajv();
+const validate = ajv.compile(schema);
+
+const valid = validate(manifest);
+if (!valid) {
+  console.log(validate.errors);
+}
+```
+
+## Schema Features
+
+### Required Fields
+
+- `name` - Package name (lowercase, alphanumeric, hyphens)
+- `version` - Semver version (e.g., `1.0.0`)
+- `description` - Description (10-500 characters)
+- `type` - Package type (`cursor`, `claude-skill`, `collection`, etc.)
+
+### File Formats
+
+The schema supports two formats for the `files` array:
+
+#### Simple Format (strings)
+```json
+{
+  "files": ["skill.md", "README.md", "LICENSE"]
+}
+```
+
+#### Enhanced Format (objects with metadata)
+```json
+{
+  "files": [
+    {
+      "path": ".claude/skills/tdd.md",
+      "type": "claude-skill",
+      "name": "Test-Driven Development",
+      "description": "TDD workflow guide",
+      "tags": ["testing", "tdd"]
+    }
+  ]
+}
+```
+
+### Validation Rules
+
+#### Package Name
+- Pattern: `^(@[a-z0-9-]+\/)?[a-z0-9-]+$`
+- Examples: `react-rules`, `@username/package`
+- No uppercase, spaces, or special characters
+
+#### Version
+- Must be valid semver: `MAJOR.MINOR.PATCH`
+- Supports prerelease: `1.0.0-beta.1`
+- Supports build metadata: `1.0.0+20130313144700`
+
+#### Description
+- Minimum length: 10 characters
+- Maximum length: 500 characters
+
+#### Type
+Valid types:
+- `cursor` - Cursor IDE rules
+- `claude` - Claude AI prompts
+- `claude-skill` - Claude Code skills
+- `claude-agent` - Claude Code agents
+- `claude-slash-command` - Claude Code slash commands
+- `continue` - Continue IDE rules
+- `windsurf` - Windsurf IDE rules
+- `generic` - Generic prompts
+- `collection` - Mixed types (use only when files have multiple distinct types)
+
+#### Tags & Keywords
+- `tags`: Maximum 10 items
+- `keywords`: Maximum 20 items
+- Must be unique within array
+
+#### URLs
+The following fields must be valid URLs:
+- `repository`
+- `homepage`
+- `documentation`
+- `author.url`
+
+#### Email
+`author.email` must be valid email format
+
+## Examples
+
+See the `examples/` directory for complete manifest examples:
+
+1. **Simple Package**: `examples/simple-package/prpm.json`
+2. **Multi-File Same Type**: `examples/multi-file-single-type/prpm.json`
+3. **Collection Package**: `examples/collection-package/prpm.json`
+4. **Claude Skills**: `examples/claude-skills-multi-file/prpm.json`
+
+## Schema Updates
+
+When updating the schema:
+
+1. **Edit** `prpm-manifest.schema.json`
+2. **Test** with `npm test -- schema-validator`
+3. **Update** this README if adding new features
+4. **Version** the schema (update `$id` if making breaking changes)
+5. **Document** any new validation rules
+
+## Validation Errors
+
+Common validation errors and how to fix them:
+
+### "Missing required field: X"
+Add the required field to your manifest.
+
+### "Pattern mismatch" (name)
+Package names must be lowercase alphanumeric with hyphens only. No spaces or special characters.
+
+### "Pattern mismatch" (version)
+Version must be valid semver (e.g., `1.0.0`, not `1.0` or `v1.0.0`).
+
+### "minLength" (description)
+Description must be at least 10 characters.
+
+### "enum" (type)
+Type must be one of the allowed values. Check for typos.
+
+### "oneOf" (files)
+Files array must be consistently either all strings OR all objects, not mixed.
+
+### "format" (email/uri)
+Email or URL is not in valid format. Check for typos and ensure proper formatting.
+
+## Related Files
+
+- **Validator**: `../src/core/schema-validator.ts`
+- **Tests**: `../src/__tests__/schema-validator.test.ts`
+- **Publish Command**: `../src/commands/publish.ts`
+- **Documentation**: `../docs/enhanced-manifest.md`

package/schemas/prpm-manifest.schema.json

@@ -0,0 +1,307 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/manifest.json",
+  "title": "PRPM Package Manifest",
+  "description": "Schema for PRPM package manifest (prpm.json)",
+  "type": "object",
+  "required": ["name", "version", "description", "type"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Package name in format: package-name or @scope/package-name",
+      "pattern": "^(@[a-z0-9-]+\\/)?[a-z0-9-]+$",
+      "minLength": 1,
+      "maxLength": 214,
+      "examples": [
+        "react-rules",
+        "@community/testing-skills",
+        "@company/cursor-rules"
+      ]
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version (semver)",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?(\\+[a-zA-Z0-9.-]+)?$",
+      "examples": ["1.0.0", "2.1.3", "1.0.0-beta.1"]
+    },
+    "description": {
+      "type": "string",
+      "description": "Package description",
+      "minLength": 10,
+      "maxLength": 500
+    },
+    "type": {
+      "type": "string",
+      "description": "Package type. Use 'collection' only if files contain multiple distinct types.",
+      "enum": [
+        "cursor",
+        "claude",
+        "claude-skill",
+        "claude-agent",
+        "claude-slash-command",
+        "continue",
+        "windsurf",
+        "generic",
+        "collection"
+      ]
+    },
+    "author": {
+      "description": "Package author",
+      "oneOf": [
+        {
+          "type": "string",
+          "examples": ["John Doe", "Jane Smith"]
+        },
+        {
+          "type": "object",
+          "required": ["name"],
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "Author name"
+            },
+            "email": {
+              "type": "string",
+              "format": "email",
+              "description": "Author email"
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "description": "Author URL"
+            }
+          }
+        }
+      ]
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier",
+      "examples": ["MIT", "Apache-2.0", "GPL-3.0", "BSD-3-Clause"]
+    },
+    "repository": {
+      "type": "string",
+      "format": "uri",
+      "description": "Repository URL",
+      "examples": ["https://github.com/username/repo"]
+    },
+    "homepage": {
+      "type": "string",
+      "format": "uri",
+      "description": "Package homepage URL"
+    },
+    "documentation": {
+      "type": "string",
+      "format": "uri",
+      "description": "Documentation URL"
+    },
+    "tags": {
+      "type": "array",
+      "description": "Package tags for categorization",
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 10,
+      "uniqueItems": true,
+      "examples": [["productivity", "coding"], ["testing", "quality"]]
+    },
+    "keywords": {
+      "type": "array",
+      "description": "Search keywords",
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 20,
+      "uniqueItems": true,
+      "examples": [["ai", "prompts", "development"]]
+    },
+    "category": {
+      "type": "string",
+      "description": "Package category",
+      "examples": ["development", "productivity", "testing"]
+    },
+    "files": {
+      "description": "Files to include in package. Can be simple paths or enhanced file objects with metadata.",
+      "oneOf": [
+        {
+          "type": "array",
+          "description": "Simple format: array of file paths",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "examples": [
+            ["skill.md", "README.md"],
+            [".cursor/rules/react.mdc", "LICENSE"]
+          ]
+        },
+        {
+          "type": "array",
+          "description": "Enhanced format: array of file objects with metadata",
+          "items": {
+            "type": "object",
+            "required": ["path", "type"],
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "Relative path to file",
+                "examples": [
+                  ".claude/skills/tdd.md",
+                  ".cursor/rules/react.mdc",
+                  ".continue/rules/python.json"
+                ]
+              },
+              "type": {
+                "type": "string",
+                "description": "File type (determines where it will be installed)",
+                "enum": [
+                  "cursor",
+                  "claude",
+                  "claude-skill",
+                  "claude-agent",
+                  "claude-slash-command",
+                  "continue",
+                  "windsurf",
+                  "generic"
+                ]
+              },
+              "name": {
+                "type": "string",
+                "description": "Display name for this file",
+                "examples": ["React Rules", "Test-Driven Development"]
+              },
+              "description": {
+                "type": "string",
+                "description": "Description of what this file does"
+              },
+              "tags": {
+                "type": "array",
+                "description": "File-specific tags",
+                "items": {
+                  "type": "string"
+                },
+                "uniqueItems": true,
+                "examples": [["react", "typescript"], ["testing", "tdd"]]
+              }
+            },
+            "additionalProperties": false
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "main": {
+      "type": "string",
+      "description": "Main entry file (for single-file packages)",
+      "examples": ["index.md", "skill.md"]
+    },
+    "dependencies": {
+      "type": "object",
+      "description": "Package dependencies",
+      "patternProperties": {
+        "^(@[a-z0-9-]+\\/)?[a-z0-9-]+$": {
+          "type": "string",
+          "pattern": "^(\\^|~)?\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?(\\+[a-zA-Z0-9.-]+)?$"
+        }
+      },
+      "additionalProperties": false,
+      "examples": [
+        {
+          "@pr-pm/utils": "^1.0.0",
+          "common-rules": "~2.1.0"
+        }
+      ]
+    },
+    "peerDependencies": {
+      "type": "object",
+      "description": "Peer dependencies (packages that should be installed alongside)",
+      "patternProperties": {
+        "^(@[a-z0-9-]+\\/)?[a-z0-9-]+$": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "engines": {
+      "type": "object",
+      "description": "Required engine versions",
+      "properties": {
+        "prpm": {
+          "type": "string",
+          "description": "Required PRPM version"
+        },
+        "node": {
+          "type": "string",
+          "description": "Required Node.js version"
+        }
+      },
+      "additionalProperties": false,
+      "examples": [
+        {
+          "prpm": ">=1.0.0",
+          "node": ">=18.0.0"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "name": "@username/simple-package",
+      "version": "1.0.0",
+      "description": "A simple package with basic files",
+      "type": "claude-skill",
+      "author": "Your Name",
+      "license": "MIT",
+      "files": ["skill.md", "README.md"]
+    },
+    {
+      "name": "@username/cursor-rules",
+      "version": "1.0.0",
+      "description": "Multiple Cursor rules for different languages",
+      "type": "cursor",
+      "author": {
+        "name": "Your Name",
+        "email": "you@example.com"
+      },
+      "license": "MIT",
+      "repository": "https://github.com/username/cursor-rules",
+      "tags": ["cursor", "rules", "multi-language"],
+      "files": [
+        {
+          "path": ".cursor/rules/typescript.mdc",
+          "type": "cursor",
+          "name": "TypeScript Rules",
+          "tags": ["typescript", "frontend"]
+        },
+        {
+          "path": ".cursor/rules/python.mdc",
+          "type": "cursor",
+          "name": "Python Rules",
+          "tags": ["python", "backend"]
+        }
+      ]
+    },
+    {
+      "name": "@community/testing-suite",
+      "version": "2.0.0",
+      "description": "Complete testing suite with skills and agents",
+      "type": "collection",
+      "author": "Community",
+      "license": "MIT",
+      "tags": ["testing", "quality"],
+      "files": [
+        {
+          "path": ".claude/skills/tdd.md",
+          "type": "claude-skill",
+          "name": "Test-Driven Development"
+        },
+        {
+          "path": ".claude/agents/test-generator.md",
+          "type": "claude-agent",
+          "name": "Test Generator"
+        }
+      ]
+    }
+  ]
+}