prpm 1.2.1 → 2.0.1

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

@@ -0,0 +1,103 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/droid/hook.json",
+  "$comment": "https://docs.factory.ai/cli/configuration/hooks",
+  "title": "Factory Droid Hook Format",
+  "description": "JSON Schema for Factory Droid Hooks - defined in settings.json files. Valid hook events: PreToolUse (runs before tool calls, can block them), PostToolUse (runs after tool calls complete), UserPromptSubmit (runs when user submits a prompt, before Droid processes it), Notification (runs when Droid sends notifications), Stop (runs when Droid finishes responding), SubagentStop (runs when sub-droid tasks complete), PreCompact (runs before Droid runs a compact operation), SessionStart (runs when Droid starts a new session or resumes an existing session), SessionEnd (runs when Droid session ends)",
+  "type": "object",
+  "required": ["hooks"],
+  "properties": {
+    "hooks": {
+      "type": "object",
+      "description": "Hook configurations organized by event type. Each key must be a valid hook event name.",
+      "patternProperties": {
+        "^(PreToolUse|PostToolUse|Notification|UserPromptSubmit|Stop|SubagentStop|PreCompact|SessionStart|SessionEnd)$": {
+          "type": "array",
+          "description": "Array of hook configurations for this event. PreToolUse: runs before tool calls (can block them). PostToolUse: runs after tool calls complete. UserPromptSubmit: runs when user submits a prompt, before Droid processes it. Notification: runs when Droid sends notifications. Stop: runs when Droid finishes responding. SubagentStop: runs when sub-droid tasks complete. PreCompact: runs before Droid runs a compact operation. SessionStart: runs when Droid starts a new session or resumes an existing session. SessionEnd: runs when Droid session ends.",
+          "items": {
+            "type": "object",
+            "required": ["hooks"],
+            "properties": {
+              "matcher": {
+                "type": "string",
+                "description": "Pattern for tool names. Supports exact strings, regex, or '*' for all tools. Optional for most events."
+              },
+              "hooks": {
+                "type": "array",
+                "description": "Array of commands to execute",
+                "minItems": 1,
+                "items": {
+                  "type": "object",
+                  "required": ["type", "command"],
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": ["command"],
+                      "description": "Hook type (currently only 'command' is supported)"
+                    },
+                    "command": {
+                      "type": "string",
+                      "description": "Bash command to run. Supports $FACTORY_PROJECT_DIR variable."
+                    },
+                    "timeout": {
+                      "type": "number",
+                      "description": "Execution limit in seconds (defaults to 60)",
+                      "default": 60,
+                      "minimum": 1
+                    }
+                  }
+                }
+              },
+              "description": {
+                "type": "string",
+                "description": "Optional description for plugin hooks"
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "examples": [
+    {
+      "hooks": {
+        "PreToolUse": [
+          {
+            "matcher": "write",
+            "hooks": [
+              {
+                "type": "command",
+                "command": "prettier --write \"$FACTORY_PROJECT_DIR/src/**/*.ts\"",
+                "timeout": 30
+              }
+            ]
+          }
+        ],
+        "PostToolUse": [
+          {
+            "matcher": "*",
+            "hooks": [
+              {
+                "type": "command",
+                "command": "git add .",
+                "timeout": 60
+              }
+            ]
+          }
+        ],
+        "SessionStart": [
+          {
+            "matcher": "startup",
+            "hooks": [
+              {
+                "type": "command",
+                "command": "echo 'Session started at $(date)' >> $FACTORY_PROJECT_DIR/.factory/session.log"
+              }
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}

package/dist/schemas/droid-skill.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/droid/skill.json",
+  "$comment": "https://docs.factory.ai/cli/configuration/skills",
+  "title": "Factory Droid Skill Format",
+  "description": "JSON Schema for Factory Droid Skills - SKILL.md files stored in .factory/skills/<skill-name>/",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Unique identifier for the skill (kebab-case recommended)"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief explanation of what the skill does and when to use it"
+        },
+        "allowed-tools": {
+          "type": "array",
+          "description": "Reserved for future use. Safe to omit.",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Skill workflow and instructions as markdown"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "api-integration",
+        "description": "Integrate a new API endpoint with proper error handling"
+      },
+      "content": "# API Integration Skill\n\n## Steps\n\n1. Define the API endpoint specification\n2. Create the service layer function\n3. Add error handling and validation\n4. Write unit tests\n5. Update API documentation\n\n## Success Criteria\n\n- All tests pass\n- Error handling covers edge cases\n- Documentation is updated"
+    }
+  ]
+}

package/dist/schemas/droid-slash-command.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/droid/slash-command.json",
+  "$comment": "https://docs.factory.ai/cli/configuration/custom-slash-commands",
+  "title": "Factory Droid Slash Command Format",
+  "description": "JSON Schema for Factory Droid Slash Commands - markdown files stored in .factory/commands/",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Overrides the generated summary shown in slash suggestions"
+        },
+        "argument-hint": {
+          "type": "string",
+          "description": "Appends inline usage hints (e.g., /code-review <branch-name>)"
+        },
+        "allowed-tools": {
+          "type": "array",
+          "description": "Reserved for future use. Safe to omit.",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Command instructions and workflow as markdown"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "description": "Review code for a specific branch",
+        "argument-hint": "<branch-name>"
+      },
+      "content": "# Code Review Command\n\nReview the code changes in the specified branch.\n\n## Instructions\n\n1. Compare branch with main\n2. Check for code quality issues\n3. Suggest improvements"
+    },
+    {
+      "frontmatter": {
+        "description": "Run tests for a specific file",
+        "argument-hint": "<file-path>",
+        "allowed-tools": ["bash", "read"]
+      },
+      "content": "Run tests for the specified file and report results."
+    }
+  ]
+}

package/dist/schemas/droid.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/droid.json",
+  "$comment": "https://docs.factory.ai/cli/configuration",
+  "title": "Factory Droid Format",
+  "description": "JSON Schema for Factory Droid Skills, Hooks, and Slash Commands",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Unique identifier for the skill/command"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief explanation of the skill's purpose"
+        },
+        "argument-hint": {
+          "type": "string",
+          "description": "Optional usage hint for slash commands"
+        },
+        "allowed-tools": {
+          "type": "array",
+          "description": "Reserved for future use",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Body content as markdown"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["skill", "slash-command", "hook"],
+      "description": "The type of Factory Droid artifact"
+    }
+  }
+}

package/dist/schemas/format-registry.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/format-registry.json",
+  "title": "PRPM Format Registry",
+  "description": "Central registry defining all supported AI editor formats, their directory structures, file patterns, and scanning configurations",
+  "type": "object",
+  "required": ["version", "formats"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema version for format registry"
+    },
+    "formats": {
+      "type": "object",
+      "description": "Map of format names to their configurations",
+      "additionalProperties": {
+        "$ref": "#/definitions/FormatConfig"
+      }
+    }
+  },
+  "definitions": {
+    "FormatConfig": {
+      "type": "object",
+      "required": ["name", "subtypes"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Display name for the format"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief description of the format"
+        },
+        "documentationUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL to official documentation"
+        },
+        "subtypes": {
+          "type": "object",
+          "description": "Map of subtype names to their configurations",
+          "additionalProperties": {
+            "$ref": "#/definitions/SubtypeConfig"
+          }
+        },
+        "rootFiles": {
+          "type": "array",
+          "description": "Root-level files that indicate this format (e.g., .cursorrules)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "defaultSubtype": {
+          "type": "string",
+          "description": "Default subtype to use when an unknown subtype is requested for this format"
+        }
+      }
+    },
+    "SubtypeConfig": {
+      "type": "object",
+      "required": ["directory", "filePatterns"],
+      "properties": {
+        "directory": {
+          "type": "string",
+          "description": "Directory path relative to project root where packages are stored"
+        },
+        "scanDirectory": {
+          "type": "string",
+          "description": "Directory to scan if different from install directory (e.g., Claude hooks)"
+        },
+        "filePatterns": {
+          "type": "array",
+          "description": "Glob patterns for matching package files (e.g., *.md, *.mdc, SKILL.md)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "nested": {
+          "type": "boolean",
+          "description": "Whether packages are in subdirectories (e.g., .claude/skills/skill-name/)",
+          "default": false
+        },
+        "nestedIndicator": {
+          "type": "string",
+          "description": "File that indicates a valid package in nested mode (e.g., SKILL.md)"
+        },
+        "fileExtension": {
+          "type": "string",
+          "description": "Default file extension for this format (e.g., .md, .mdc, .toml)"
+        },
+        "usesPackageSubdirectory": {
+          "type": "boolean",
+          "description": "Whether directory path includes package name (e.g., .claude/skills/{name})",
+          "default": false
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/gemini-md.json",
+  "$comment": "https://geminicli.com/docs/cli/gemini-md/#_top",
+  "title": "GEMINI.md Format",
+  "description": "JSON Schema for GEMINI.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, persona definitions, coding style guides, and best practices. No frontmatter allowed. Supports @file.md syntax for importing other files."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "content": "# General Instructions\n\nYou are a helpful coding assistant.\n\n## Coding Style\n\n- Use TypeScript strict mode\n- Follow functional programming patterns\n- Write comprehensive tests"
+    },
+    {
+      "content": "# Project Context\n\nThis is a Next.js application with TypeScript.\n\n## Architecture\n\n- App Router (not Pages Router)\n- Server Components by default\n- Client Components only when needed\n\n## Database\n\nPostgreSQL with Prisma ORM"
+    }
+  ]
+}

package/dist/schemas/gemini.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/gemini.json",
+  "$comment": "https://geminicli.com/docs/cli/custom-commands/",
+  "title": "Gemini Custom Commands Format",
+  "description": "JSON Schema for Gemini CLI custom commands - TOML files stored in .gemini/commands/",
+  "type": "object",
+  "required": ["prompt"],
+  "properties": {
+    "prompt": {
+      "type": "string",
+      "description": "The instruction text sent to the Gemini model. Can span multiple lines and supports placeholders like {{args}}, !{...} for shell commands, and @{...} for file injection."
+    },
+    "description": {
+      "type": "string",
+      "description": "A brief, single-line explanation of the command's purpose. Appears in /help menu. If omitted, system generates a generic description from filename."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "prompt": "Review the code for potential bugs and suggest improvements.",
+      "description": "Code review assistant"
+    },
+    {
+      "prompt": "Generate unit tests for {{args}}",
+      "description": "Generate unit tests for the specified file"
+    }
+  ]
+}

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

@@ -0,0 +1,146 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/kiro/agent.json",
+  "$comment": "https://kiro.dev/docs/cli/custom-agents/",
+  "title": "Kiro Agent Configuration Format",
+  "description": "JSON Schema for Kiro custom agent configurations (.kiro/agents/*.json) - specialized AI assistants with specific tools and context",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Agent's identifier (optional, defaults to filename)"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable explanation of agent's purpose"
+    },
+    "prompt": {
+      "type": "string",
+      "description": "High-level context for the agent. Can be inline text or reference external markdown files via file:// URI"
+    },
+    "mcpServers": {
+      "type": "object",
+      "description": "Model Context Protocol (MCP) servers configuration",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "command": {
+            "type": "string",
+            "description": "Command to start the MCP server"
+          },
+          "args": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Command-line arguments for the server"
+          },
+          "env": {
+            "type": "object",
+            "additionalProperties": { "type": "string" },
+            "description": "Environment variables for the server"
+          },
+          "timeout": {
+            "type": "number",
+            "description": "Server timeout in milliseconds"
+          }
+        },
+        "required": ["command"]
+      }
+    },
+    "tools": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of available tools (built-in or from MCP servers). Supports wildcards."
+    },
+    "toolAliases": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Rename tools to avoid naming conflicts"
+    },
+    "allowedTools": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Tools that can be used without user permission. Supports wildcards."
+    },
+    "toolsSettings": {
+      "type": "object",
+      "description": "Configure specific tool behaviors",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "allowedPaths": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Allowed file paths for file system tools"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "resources": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Local file resources accessible to the agent (file:// URIs)"
+    },
+    "hooks": {
+      "type": "object",
+      "description": "Commands triggered at specific lifecycle points",
+      "properties": {
+        "agentSpawn": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "userPromptSubmit": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "preToolUse": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "postToolUse": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "stop": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "useLegacyMcpJson": {
+      "type": "boolean",
+      "description": "Include legacy MCP configurations"
+    },
+    "model": {
+      "type": "string",
+      "description": "Specific AI model for the agent"
+    }
+  },
+  "examples": [
+    {
+      "name": "backend-specialist",
+      "description": "Expert in building Express.js APIs with MongoDB",
+      "prompt": "You are a backend developer specializing in Node.js and Express. Focus on API design, database optimization, and security best practices.",
+      "tools": ["fs_read", "fs_write", "execute_bash"],
+      "toolsSettings": {
+        "fs_write": {
+          "allowedPaths": ["src/api/**", "tests/api/**", "server.js", "package.json"]
+        }
+      },
+      "resources": [
+        "file://.kiro/steering/backend-standards.md"
+      ]
+    },
+    {
+      "name": "aws-rust-agent",
+      "description": "Specialized agent for AWS and Rust development",
+      "prompt": "file://./prompts/aws-rust-expert.md",
+      "mcpServers": {
+        "fetch": { "command": "fetch-server", "args": [] },
+        "git": { "command": "git-mcp", "args": [] }
+      },
+      "tools": ["fetch", "git_status", "fs_read", "fs_write"],
+      "allowedTools": ["fetch", "git_status"]
+    }
+  ]
+}

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

@@ -0,0 +1,120 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/kiro/hook.json",
+  "$comment": "https://kiro.dev/docs/hooks/",
+  "title": "Kiro Hook 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"
+      }
+    }
+  ]
+}