prpm 1.2.1 → 2.1.0

package/dist/schemas/agents-md.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/agents-md.json",
+  "$comment": "https://docs.factory.ai/cli/configuration/agents-md",
+  "title": "agents.md Format",
+  "description": "JSON Schema for agents.md format - plain markdown project-specific AI instructions (NO frontmatter)",
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "content": {
+      "type": "string",
+      "description": "Plain markdown content with project-specific instructions, architecture notes, conventions, etc. No frontmatter allowed."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "content": "# Backend Guidelines\n\n## Architecture\n\nWe use a clean architecture pattern.\n\n## Database\n\nPostgreSQL with Prisma ORM.\n\n## Coding Standards\n\n- Use TypeScript strict mode\n- Write unit tests for all services"
+    },
+    {
+      "content": "# Project Context\n\nThis is a React + TypeScript web application.\n\n## Stack\n\n- React 18\n- TypeScript 5\n- Vite\n- Tailwind CSS"
+    }
+  ]
+}

package/dist/schemas/aider.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/aider.json",
+  "$comment": "https://aider.chat/docs/usage/conventions.html",
+  "title": "Aider CONVENTIONS.md Format",
+  "description": "JSON Schema for Aider CONVENTIONS.md format - plain markdown coding conventions (NO frontmatter)",
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "content": {
+      "type": "string",
+      "description": "Plain markdown content with coding conventions, standards, and project-specific guidelines. No frontmatter allowed."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "content": "# Coding Conventions\n\n## Python\n\n- Follow PEP 8\n- Use type hints\n- Write docstrings for all functions\n\n## Testing\n\n- Use pytest\n- Aim for 80% coverage"
+    },
+    {
+      "content": "# Project Standards\n\n## Code Review\n\n- All PRs need approval\n- Run linters before committing\n\n## Documentation\n\n- Update README for new features"
+    }
+  ]
+}

package/dist/schemas/canonical.schema.json

@@ -0,0 +1,435 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/canonical.json",
+  "title": "PRPM Canonical Package Format",
+  "description": "Universal intermediate format for AI prompt packages that can be converted to any editor-specific format",
+  "type": "object",
+  "required": ["id", "version", "name", "description", "author", "tags", "format", "subtype", "content"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique identifier for the package"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (e.g., '1.0.0')"
+    },
+    "name": {
+      "type": "string",
+      "description": "Package identifier/slug (used in frontmatter)"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable description"
+    },
+    "author": {
+      "type": "string",
+      "description": "Package author"
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Categorization tags"
+    },
+    "format": {
+      "type": "string",
+      "enum": ["cursor", "claude", "claude-plugin", "continue", "windsurf", "copilot", "kiro", "agents.md", "generic", "mcp", "gemini", "opencode", "ruler", "droid", "trae", "aider", "zencoder", "replit"],
+      "description": "Source format this was parsed from"
+    },
+    "subtype": {
+      "type": "string",
+      "enum": ["rule", "agent", "skill", "slash-command", "prompt", "workflow", "tool", "template", "collection", "chatmode", "hook", "plugin", "server"],
+      "description": "Subtype classification"
+    },
+    "content": {
+      "type": "object",
+      "required": ["format", "version", "sections"],
+      "properties": {
+        "format": {
+          "type": "string",
+          "const": "canonical"
+        },
+        "version": {
+          "type": "string",
+          "const": "1.0"
+        },
+        "sections": {
+          "type": "array",
+          "description": "Content sections in semantic format",
+          "items": {
+            "oneOf": [
+              {
+                "$ref": "#/definitions/MetadataSection"
+              },
+              {
+                "$ref": "#/definitions/InstructionsSection"
+              },
+              {
+                "$ref": "#/definitions/RulesSection"
+              },
+              {
+                "$ref": "#/definitions/ExamplesSection"
+              },
+              {
+                "$ref": "#/definitions/ToolsSection"
+              },
+              {
+                "$ref": "#/definitions/PersonaSection"
+              },
+              {
+                "$ref": "#/definitions/ContextSection"
+              },
+              {
+                "$ref": "#/definitions/CustomSection"
+              }
+            ]
+          }
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Extracted metadata for easier access",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Display title (from H1 or frontmatter)"
+        },
+        "description": {
+          "type": "string"
+        },
+        "icon": {
+          "type": "string",
+          "description": "Emoji icon"
+        },
+        "version": {
+          "type": "string"
+        },
+        "author": {
+          "type": "string"
+        },
+        "globs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "alwaysApply": {
+          "type": "boolean"
+        },
+        "claudeAgent": {
+          "type": "object",
+          "properties": {
+            "model": {
+              "type": "string",
+              "enum": ["sonnet", "opus", "haiku", "inherit"]
+            }
+          }
+        },
+        "copilotConfig": {
+          "type": "object",
+          "properties": {
+            "instructionName": {
+              "type": "string"
+            },
+            "applyTo": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          }
+        },
+        "kiroConfig": {
+          "type": "object",
+          "properties": {
+            "filename": {
+              "type": "string"
+            },
+            "inclusion": {
+              "type": "string",
+              "enum": ["always", "fileMatch", "manual"]
+            },
+            "fileMatchPattern": {
+              "type": "string"
+            },
+            "domain": {
+              "type": "string"
+            },
+            "foundationalType": {
+              "type": "string",
+              "enum": ["product", "tech", "structure"]
+            }
+          }
+        },
+        "agentsMdConfig": {
+          "type": "object",
+          "properties": {
+            "project": {
+              "type": "string"
+            },
+            "scope": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "sourceFormat": {
+      "type": "string",
+      "enum": ["cursor", "claude", "claude-plugin", "continue", "windsurf", "copilot", "kiro", "agents.md", "generic", "mcp", "gemini", "opencode", "ruler", "droid", "trae", "aider", "zencoder", "replit"],
+      "description": "Original format this was parsed from"
+    },
+    "sourceUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Source URL if imported"
+    },
+    "official": {
+      "type": "boolean",
+      "description": "Official package from cursor.directory, claude.ai, etc."
+    },
+    "verified": {
+      "type": "boolean",
+      "description": "Verified by PRPM team"
+    },
+    "karenScore": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 100,
+      "description": "Quality score from Karen"
+    }
+  },
+  "definitions": {
+    "MetadataSection": {
+      "type": "object",
+      "required": ["type", "data"],
+      "properties": {
+        "type": {
+          "const": "metadata"
+        },
+        "data": {
+          "type": "object",
+          "required": ["title", "description"],
+          "properties": {
+            "title": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            },
+            "icon": {
+              "type": "string"
+            },
+            "version": {
+              "type": "string"
+            },
+            "author": {
+              "type": "string"
+            },
+            "claudeAgent": {
+              "type": "object",
+              "properties": {
+                "model": {
+                  "type": "string",
+                  "enum": ["sonnet", "opus", "haiku", "inherit"]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "InstructionsSection": {
+      "type": "object",
+      "required": ["type", "title", "content"],
+      "properties": {
+        "type": {
+          "const": "instructions"
+        },
+        "title": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["high", "medium", "low"]
+        }
+      }
+    },
+    "RulesSection": {
+      "type": "object",
+      "required": ["type", "title", "items"],
+      "properties": {
+        "type": {
+          "const": "rules"
+        },
+        "title": {
+          "type": "string"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["content"],
+            "properties": {
+              "content": {
+                "type": "string"
+              },
+              "rationale": {
+                "type": "string"
+              },
+              "examples": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "ordered": {
+          "type": "boolean",
+          "description": "Whether rules should be numbered"
+        }
+      }
+    },
+    "ExamplesSection": {
+      "type": "object",
+      "required": ["type", "title", "examples"],
+      "properties": {
+        "type": {
+          "const": "examples"
+        },
+        "title": {
+          "type": "string"
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["description", "code"],
+            "properties": {
+              "description": {
+                "type": "string"
+              },
+              "code": {
+                "type": "string"
+              },
+              "language": {
+                "type": "string"
+              },
+              "good": {
+                "type": "boolean",
+                "description": "Is this a good or bad example?"
+              }
+            }
+          }
+        }
+      }
+    },
+    "ToolsSection": {
+      "type": "object",
+      "required": ["type", "tools"],
+      "properties": {
+        "type": {
+          "const": "tools"
+        },
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    },
+    "PersonaSection": {
+      "type": "object",
+      "required": ["type", "data"],
+      "properties": {
+        "type": {
+          "const": "persona"
+        },
+        "data": {
+          "type": "object",
+          "required": ["role"],
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "role": {
+              "type": "string"
+            },
+            "icon": {
+              "type": "string"
+            },
+            "style": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "expertise": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "ContextSection": {
+      "type": "object",
+      "required": ["type", "title", "content"],
+      "properties": {
+        "type": {
+          "const": "context"
+        },
+        "title": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        }
+      }
+    },
+    "CustomSection": {
+      "type": "object",
+      "required": ["type", "content"],
+      "properties": {
+        "type": {
+          "const": "custom"
+        },
+        "editorType": {
+          "type": "string",
+          "enum": ["cursor", "claude", "claude-plugin", "continue", "windsurf", "copilot", "kiro", "agents.md", "mcp", "gemini", "opencode", "ruler", "droid", "trae", "aider", "zencoder", "replit"]
+        },
+        "title": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        },
+        "metadata": {
+          "type": "object"
+        }
+      }
+    }
+  }
+}

package/dist/schemas/claude-agent.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/agent.json",
+  "$comment": "https://code.claude.com/docs/en/sub-agents",
+  "title": "Claude Agent Format",
+  "description": "JSON Schema for Claude Code Agents - long-running assistants with tool access",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]+$",
+          "maxLength": 64,
+          "description": "Unique identifier using lowercase letters and hyphens"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Natural language description of the subagent's purpose"
+        },
+        "tools": {
+          "type": "string",
+          "description": "Comma-separated list of specific tools. If omitted, inherits all tools from the main thread"
+        },
+        "model": {
+          "type": "string",
+          "enum": ["sonnet", "opus", "haiku", "inherit"],
+          "description": "Model to use for this subagent. Can be a model alias (sonnet, opus, haiku) or 'inherit' to use the main conversation's model. If omitted, defaults to the configured subagent model"
+        },
+        "permissionMode": {
+          "type": "string",
+          "enum": ["default", "acceptEdits", "bypassPermissions", "plan", "ignore"],
+          "description": "Permission mode for the subagent. Controls how the subagent handles permission requests"
+        },
+        "skills": {
+          "type": "string",
+          "description": "Comma-separated list of skill names to auto-load when the subagent starts. Skills are loaded into the subagent's context automatically"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content with H1 title (can include emoji icon), persona, instructions, and examples"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "code-reviewer",
+        "description": "Reviews code for best practices and potential issues",
+        "tools": "Read, Grep, Bash",
+        "model": "sonnet"
+      },
+      "content": "# 🔍 Code Reviewer\n\nYou are an expert code reviewer with deep knowledge of software engineering principles.\n\n## Instructions\n\n- Check for code smells and anti-patterns\n- Verify test coverage"
+    }
+  ]
+}

package/dist/schemas/claude-hook.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/hook.json",
+  "$comment": "https://code.claude.com/docs/en/hooks",
+  "title": "Claude Hook Format",
+  "description": "JSON Schema for Claude Code Hooks - executable code triggered by events. Valid hook events: PreToolUse (blocks the tool call, shows stderr to Claude), PermissionRequest (denies the permission, shows stderr to Claude), PostToolUse (shows stderr to Claude, tool already ran), Notification (shows stderr to user only), UserPromptSubmit (blocks prompt processing, erases prompt, shows stderr to user only), Stop (blocks stoppage, shows stderr to Claude), SubagentStop (blocks stoppage, shows stderr to Claude subagent), PreCompact (shows stderr to user only), SessionStart (shows stderr to user only), SessionEnd (shows stderr to user only)",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]+$",
+          "maxLength": 64,
+          "description": "Hook identifier (lowercase letters, numbers, hyphens only)"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Brief overview of what the hook does"
+        },
+        "event": {
+          "type": "string",
+          "enum": [
+            "PreToolUse",
+            "PermissionRequest",
+            "PostToolUse",
+            "UserPromptSubmit",
+            "Notification",
+            "Stop",
+            "SubagentStop",
+            "PreCompact",
+            "SessionStart",
+            "SessionEnd"
+          ],
+          "description": "Event that triggers this hook. PreToolUse: blocks the tool call, shows stderr to Claude. PermissionRequest: denies the permission, shows stderr to Claude. PostToolUse: shows stderr to Claude (tool already ran). Notification: shows stderr to user only. UserPromptSubmit: blocks prompt processing, erases prompt, shows stderr to user only. Stop: blocks stoppage, shows stderr to Claude. SubagentStop: blocks stoppage, shows stderr to Claude subagent. PreCompact: shows stderr to user only. SessionStart: shows stderr to user only. SessionEnd: shows stderr to user only."
+        },
+        "language": {
+          "type": "string",
+          "enum": ["bash", "typescript", "javascript", "python", "binary"],
+          "description": "Programming language of the hook"
+        },
+        "hookType": {
+          "type": "string",
+          "const": "hook",
+          "description": "Explicit marker for round-trip conversion"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown documentation with hook source code in code blocks"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "session-logger",
+        "description": "Logs session start/end times for tracking",
+        "event": "SessionStart",
+        "language": "bash"
+      },
+      "content": "# Session Logger Hook\n\nLogs Claude Code session activity for tracking and debugging.\n\n## Source Code\n\n```bash\n#!/bin/bash\necho \"Session started at $(date)\" >> ~/.claude/session.log\n```"
+    }
+  ]
+}