prpm 1.0.3 → 1.0.4

package/dist/schemas/claude.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/claude.schema.json",
+  "title": "Claude Code Format",
+  "description": "JSON Schema for Claude Code agents, skills, and slash commands format",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "YAML frontmatter enclosed in --- markers",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Identifier/slug for the agent/skill/command (e.g., 'code-reviewer', 'refactor-helper')"
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of what this does"
+        },
+        "allowed-tools": {
+          "type": "string",
+          "description": "Comma-separated list of available tools (e.g., 'Read, Write, Bash, WebSearch')",
+          "pattern": "^[A-Za-z]+(,\\s*[A-Za-z]+)*$"
+        },
+        "model": {
+          "type": "string",
+          "enum": ["sonnet", "opus", "haiku", "inherit"],
+          "description": "Claude model to use for this agent"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content following the frontmatter. Should include H1 title (can include emoji icon), persona instructions, guidelines, examples, etc."
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "code-reviewer",
+        "description": "Reviews code for best practices",
+        "allowed-tools": "Read, Grep, Bash",
+        "model": "sonnet"
+      },
+      "content": "# 🔍 Code Reviewer\n\nYou are an expert code reviewer.\n\n## Instructions\n\n- Check for code smells\n- Verify test coverage"
+    }
+  ]
+}

package/dist/schemas/continue.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/continue.schema.json",
+  "title": "Continue Rules Format",
+  "description": "JSON Schema for Continue rules format - markdown with optional YAML frontmatter or YAML configuration",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "YAML frontmatter for metadata and file matching",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Display name/title for the rule (required)"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of when the rule should be used (agents may read this)"
+        },
+        "globs": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Single glob pattern to match files (e.g., '**/*.{ts,tsx}')"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Array of glob patterns to match files"
+            }
+          ]
+        },
+        "regex": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Single regex pattern to match file content"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Array of regex patterns to match file content"
+            }
+          ]
+        },
+        "alwaysApply": {
+          "type": "boolean",
+          "description": "Inclusion behavior: true = Always included. false = Included if globs match OR agent decides. undefined/omitted = Included if no globs specified OR globs match."
+        },
+        "version": {
+          "type": "string",
+          "description": "Rule version (for YAML format)"
+        },
+        "schema": {
+          "type": "string",
+          "description": "Schema version (for YAML format)"
+        }
+      }
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content with rules and guidelines"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "General Guidelines"
+      },
+      "content": "# General Guidelines\n\n- Write clean code\n- Add tests"
+    },
+    {
+      "frontmatter": {
+        "name": "Documentation Standards",
+        "globs": "docs/**/*.{md,mdx}",
+        "alwaysApply": false,
+        "description": "Standards for writing and maintaining documentation"
+      },
+      "content": "# Documentation Standards\n\n## Structure\n\n- Follow consistent heading hierarchy"
+    },
+    {
+      "frontmatter": {
+        "name": "React Component Standards",
+        "regex": "^import React",
+        "globs": ["**/*.tsx", "**/*.jsx"],
+        "alwaysApply": false
+      },
+      "content": "# React Component Standards\n\n## Component Structure\n\n- Use functional components with hooks"
+    }
+  ]
+}

package/dist/schemas/copilot.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/copilot.schema.json",
+  "title": "GitHub Copilot Instructions Format",
+  "description": "JSON Schema for GitHub Copilot instructions (.github/copilot-instructions.md or .github/instructions/*.instructions.md)",
+  "type": "object",
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "Optional YAML frontmatter for path-specific instructions (required for path-specific files)",
+      "properties": {
+        "applyTo": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Single glob pattern or comma-separated patterns (e.g., 'app/models/**/*.rb' or '**/*.ts,**/*.tsx'). Use '**', '*', or '**/*' for all files."
+            },
+            {
+              "type": "array",
+              "description": "Multiple glob patterns as array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "excludeAgent": {
+          "type": "string",
+          "enum": ["code-review", "coding-agent"],
+          "description": "Prevent file from being used by specific agent. 'code-review': only used by coding agent. 'coding-agent': only used by code review."
+        },
+        "subtype": {
+          "type": "string",
+          "enum": ["rule", "tool", "chatmode"],
+          "description": "Type of Copilot instruction (PRPM extension)"
+        }
+      }
+    },
+    "content": {
+      "type": "string",
+      "description": "Natural language markdown instructions. Whitespace between instructions is ignored. Simple, clear, and actionable."
+    }
+  },
+  "required": ["content"],
+  "examples": [
+    {
+      "content": "# API Development Guidelines\n\nFollow REST best practices.\n\n## Principles\n\n- Use semantic HTTP methods\n- Return appropriate status codes"
+    },
+    {
+      "frontmatter": {
+        "applyTo": "app/models/**/*.rb"
+      },
+      "content": "# Model Guidelines\n\nThese rules apply only to Ruby model files."
+    },
+    {
+      "frontmatter": {
+        "applyTo": "**/*.ts,**/*.tsx"
+      },
+      "content": "# TypeScript Guidelines\n\nThese rules apply to all TypeScript files using comma-separated patterns."
+    },
+    {
+      "frontmatter": {
+        "applyTo": ["src/api/**/*.ts", "src/services/**/*.ts"]
+      },
+      "content": "# API Guidelines\n\nThese rules apply to API files using array of patterns."
+    },
+    {
+      "frontmatter": {
+        "applyTo": "**",
+        "excludeAgent": "code-review"
+      },
+      "content": "# Coding Agent Only\n\nThese instructions are only used by the Copilot coding agent, not code review."
+    }
+  ]
+}

package/dist/schemas/cursor-command.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/cursor-command.schema.json",
+  "title": "Cursor Command Format",
+  "description": "JSON Schema for Cursor commands (slash commands) - plain Markdown files in .cursor/commands/",
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "content": {
+      "type": "string",
+      "description": "Plain Markdown content describing what the command should do. No frontmatter supported."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "content": "# Review Code\n\nReview the selected code for:\n- Code quality and best practices\n- Potential bugs or edge cases\n- Performance improvements\n- Security vulnerabilities\n\nProvide specific, actionable feedback."
+    },
+    {
+      "content": "# Generate Tests\n\nGenerate comprehensive unit tests for the selected code.\n\nInclude:\n- Happy path test cases\n- Edge cases and error handling\n- Mock external dependencies\n- Follow existing test patterns in the project"
+    },
+    {
+      "content": "# Explain Code\n\nProvide a clear explanation of what the selected code does.\n\nInclude:\n- High-level purpose\n- Step-by-step breakdown\n- Any non-obvious behavior\n- Dependencies and side effects"
+    }
+  ]
+}

package/dist/schemas/cursor.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/cursor.schema.json",
+  "title": "Cursor Rules Format",
+  "description": "JSON Schema for Cursor .cursor/rules format with MDC (Markdown Components) frontmatter",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "YAML frontmatter enclosed in --- markers",
+      "required": ["description"],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of what this rule does (REQUIRED by Cursor). Used by AI to determine relevance for 'Apply Intelligently' type."
+        },
+        "globs": {
+          "type": "array",
+          "description": "File patterns to apply this rule to. When specified, creates 'Apply to Specific Files' rule type.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "alwaysApply": {
+          "type": "boolean",
+          "description": "Whether to apply this rule to all files. true = 'Always Apply' type, false (default) = 'Apply Intelligently' or file-specific based on globs.",
+          "default": false
+        },
+        "name": {
+          "type": "string",
+          "description": "Package identifier (PRPM extension, ignored by Cursor)"
+        },
+        "tags": {
+          "type": "array",
+          "description": "Categorization tags (PRPM extension, ignored by Cursor)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "agentType": {
+          "type": "string",
+          "enum": ["agent"],
+          "description": "Marks as agent subtype (PRPM extension for round-trip conversion)"
+        },
+        "skillType": {
+          "type": "string",
+          "enum": ["skill"],
+          "description": "Marks as skill subtype (PRPM extension for round-trip conversion)"
+        },
+        "commandType": {
+          "type": "string",
+          "enum": ["slash-command"],
+          "description": "Marks as slash command subtype (PRPM extension for round-trip conversion)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content following the frontmatter. Standard markdown with headings, lists, code blocks, etc."
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "description": "Core coding standards that apply to all files",
+        "alwaysApply": true
+      },
+      "content": "# Core Coding Standards\n\nThese standards apply to every chat session.\n\n- Write self-documenting code\n- Keep functions under 50 lines"
+    },
+    {
+      "frontmatter": {
+        "description": "RPC Service boilerplate patterns and conventions",
+        "alwaysApply": false
+      },
+      "content": "# RPC Service Patterns\n\nAgent will include this when it detects RPC service context.\n\n- Use internal RPC pattern\n- Use snake_case for service names"
+    },
+    {
+      "frontmatter": {
+        "description": "React component development standards",
+        "globs": ["src/**/*.tsx", "src/**/*.jsx"],
+        "alwaysApply": false
+      },
+      "content": "# React Component Standards\n\nApplied only to React component files.\n\n- Use functional components with hooks"
+    }
+  ]
+}

package/dist/schemas/kiro-hooks.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/kiro-hooks.schema.json",
+  "title": "Kiro Hooks Format",
+  "description": "JSON Schema for Kiro hook configuration files (.kiro/hooks/*.json) - event-driven automations",
+  "type": "object",
+  "required": ["name", "description", "version", "when", "then"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Human-readable name for the hook",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string",
+      "description": "Explanation of what this hook does",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "description": "Hook version (typically '1')",
+      "pattern": "^[0-9]+$"
+    },
+    "when": {
+      "type": "object",
+      "description": "Event trigger configuration",
+      "required": ["type", "patterns"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["fileCreated", "fileModified", "fileDeleted"],
+          "description": "Type of file system event to trigger on"
+        },
+        "patterns": {
+          "type": "array",
+          "description": "Glob patterns to match files",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        }
+      }
+    },
+    "then": {
+      "type": "object",
+      "description": "Action to take when event occurs",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["askAgent", "runCommand"],
+          "description": "Type of action to perform"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Prompt for askAgent action type"
+        },
+        "command": {
+          "type": "string",
+          "description": "Shell command for runCommand action type"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "askAgent"
+              }
+            }
+          },
+          "then": {
+            "required": ["prompt"]
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "runCommand"
+              }
+            }
+          },
+          "then": {
+            "required": ["command"]
+          }
+        }
+      ]
+    }
+  },
+  "examples": [
+    {
+      "name": "Auto Test Files",
+      "description": "Creates test files for new components",
+      "version": "1",
+      "when": {
+        "type": "fileCreated",
+        "patterns": ["src/components/**/*.tsx"]
+      },
+      "then": {
+        "type": "askAgent",
+        "prompt": "A new component was created. Create a corresponding test file."
+      }
+    },
+    {
+      "name": "Lint on Save",
+      "description": "Runs linter when files are modified",
+      "version": "1",
+      "when": {
+        "type": "fileModified",
+        "patterns": ["src/**/*.ts", "src/**/*.tsx"]
+      },
+      "then": {
+        "type": "runCommand",
+        "command": "npm run lint"
+      }
+    }
+  ]
+}

package/dist/schemas/kiro-steering.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/kiro-steering.schema.json",
+  "title": "Kiro Steering Files Format",
+  "description": "JSON Schema for Kiro steering files (.kiro/steering/*.md) - context-aware instructions with optional frontmatter (defaults to 'always' inclusion)",
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "Optional YAML frontmatter enclosed in --- markers. If omitted, file defaults to 'always' inclusion mode.",
+      "properties": {
+        "inclusion": {
+          "type": "string",
+          "enum": ["always", "fileMatch", "manual"],
+          "default": "always",
+          "description": "When to include this steering file: always (all contexts, default), fileMatch (specific files), manual (user-triggered)"
+        },
+        "fileMatchPattern": {
+          "type": "string",
+          "description": "Glob pattern for fileMatch inclusion mode (REQUIRED if inclusion is fileMatch)"
+        },
+        "domain": {
+          "type": "string",
+          "description": "Domain or topic for organization (e.g., 'testing', 'api', 'security')"
+        },
+        "foundationalType": {
+          "type": "string",
+          "enum": ["product", "tech", "structure"],
+          "description": "Type of foundational file (product.md, tech.md, structure.md)"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "inclusion": {
+                "const": "fileMatch"
+              }
+            }
+          },
+          "then": {
+            "required": ["fileMatchPattern"]
+          }
+        }
+      ]
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content following the frontmatter (or entire file if no frontmatter). Should include H1 title, guidelines, rules, examples."
+    }
+  },
+  "examples": [
+    {
+      "content": "# Testing Guidelines\n\nAlways write tests first.\n\n## Principles\n\n- Test edge cases\n- Mock external dependencies"
+    },
+    {
+      "frontmatter": {
+        "inclusion": "always",
+        "domain": "Testing"
+      },
+      "content": "# Testing Guidelines\n\nAlways write tests first.\n\n## Principles\n\n- Test edge cases\n- Mock external dependencies"
+    },
+    {
+      "frontmatter": {
+        "inclusion": "fileMatch",
+        "fileMatchPattern": "**/*.test.ts",
+        "domain": "Testing"
+      },
+      "content": "# Test File Guidelines\n\nRules specific to test files."
+    }
+  ]
+}

package/dist/schemas/windsurf.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/windsurf.schema.json",
+  "title": "Windsurf Rules Format",
+  "description": "JSON Schema for Windsurf .windsurf/rules format - plain markdown without frontmatter",
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "content": {
+      "type": "string",
+      "description": "Plain markdown content. No frontmatter. Maximum 12,000 characters.",
+      "maxLength": 12000
+    }
+  },
+  "examples": [
+    {
+      "content": "# React Best Practices\n\n## Core Principles\n\n- Use functional components\n- Keep components small and focused"
+    }
+  ],
+  "additionalProperties": false
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Prompt Package Manager CLI - Install and manage prompt-based files",
   "main": "dist/index.js",
   "bin": {
@@ -45,9 +45,9 @@
   "license": "MIT",
   "dependencies": {
     "@octokit/rest": "^22.0.0",
-    "@pr-pm/converters": "^1.0.3",
-    "@pr-pm/registry-client": "^2.0.3",
-    "@pr-pm/types": "^1.0.3",
+    "@pr-pm/converters": "^1.0.4",
+    "@pr-pm/registry-client": "^2.0.4",
+    "@pr-pm/types": "^1.0.4",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",