prpm 1.2.1 → 2.1.0

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-capabilities.schema.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/format-capabilities.json",
+  "title": "Format Capabilities Schema",
+  "description": "Schema defining format capability matrix for PRPM converters - which subtypes each format supports and progressive disclosure fallbacks",
+  "type": "object",
+  "required": ["version", "formats", "agentsMdSupport"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema version for format capabilities",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief description of this capabilities file"
+    },
+    "lastVerified": {
+      "type": "string",
+      "description": "Date when capabilities were last verified against official documentation (YYYY-MM-DD)",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+    },
+    "verificationSources": {
+      "type": "object",
+      "description": "URLs to official documentation for each format",
+      "additionalProperties": {
+        "type": "string",
+        "format": "uri"
+      }
+    },
+    "formats": {
+      "type": "object",
+      "description": "Map of format names to their capability configurations",
+      "additionalProperties": {
+        "$ref": "#/definitions/FormatCapability"
+      }
+    },
+    "agentsMdSupport": {
+      "type": "object",
+      "description": "Special section documenting which formats support agents.md for progressive disclosure",
+      "required": ["description", "formats"],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Explanation of agents.md support"
+        },
+        "formats": {
+          "type": "array",
+          "description": "List of format names that support agents.md",
+          "items": {
+            "type": "string"
+          }
+        },
+        "notes": {
+          "type": "string",
+          "description": "Additional notes about agents.md support"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "FormatCapability": {
+      "type": "object",
+      "required": ["name", "supportsSkills", "supportsPlugins", "supportsExtensions", "supportsAgents", "supportsAgentsMd"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Display name for the format"
+        },
+        "supportsSkills": {
+          "type": "boolean",
+          "description": "Whether this format natively supports skill packages"
+        },
+        "supportsPlugins": {
+          "type": "boolean",
+          "description": "Whether this format natively supports plugin packages"
+        },
+        "supportsExtensions": {
+          "type": "boolean",
+          "description": "Whether this format natively supports extension packages"
+        },
+        "supportsAgents": {
+          "type": "boolean",
+          "description": "Whether this format natively supports agent packages"
+        },
+        "supportsAgentsMd": {
+          "type": "boolean",
+          "description": "Whether this format intelligently supports agents.md for progressive disclosure"
+        },
+        "markdownFallback": {
+          "type": "string",
+          "description": "Recommended markdown filename for fallback when advanced features aren't supported"
+        },
+        "notes": {
+          "type": "string",
+          "description": "Additional notes about format capabilities"
+        }
+      }
+    }
+  }
+}

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-extension.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/gemini/extension.json",
+  "title": "Gemini CLI Extension Format",
+  "description": "JSON Schema for Gemini CLI Extensions (gemini-extension.json)",
+  "type": "object",
+  "required": ["name", "version"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "Unique extension name (lowercase with dashes)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?$",
+      "description": "Extension version (semver)"
+    },
+    "description": {
+      "type": "string",
+      "description": "Extension description"
+    },
+    "author": {
+      "type": "string",
+      "description": "Extension author"
+    },
+    "mcpServers": {
+      "type": "object",
+      "description": "MCP server configurations",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "command": {
+            "type": "string",
+            "description": "Command to run the MCP server"
+          },
+          "args": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Command arguments"
+          },
+          "env": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Environment variables"
+          },
+          "disabled": {
+            "type": "boolean",
+            "description": "Whether the server is disabled"
+          }
+        },
+        "required": ["command"]
+      }
+    },
+    "contextFileName": {
+      "type": "string",
+      "description": "Name of the context file (e.g., GEMINI.md)"
+    },
+    "excludeTools": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "List of tools to exclude from the model"
+    },
+    "experimentalSettings": {
+      "type": "object",
+      "description": "Experimental Gemini CLI settings",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": 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"
+    }
+  ]
+}