prpm 2.1.2 → 2.1.3

package/dist/index.js

@@ -12805,15 +12805,17 @@ var init_format_registry = __esm({
             },
             skill: {
               directory: ".openskills",
-              filePatterns: ["*.md"],
+              filePatterns: ["SKILL.md"],
               nested: true,
+              nestedIndicator: "SKILL.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             },
             agent: {
               directory: ".openagents",
-              filePatterns: ["*.md"],
+              filePatterns: ["AGENT.md"],
               nested: true,
+              nestedIndicator: "AGENT.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             }
@@ -12829,21 +12831,23 @@ var init_format_registry = __esm({
               fileExtension: ".md"
             },
             "slash-command": {
-              directory: ".",
-              filePatterns: ["AGENTS.md"],
+              directory: ".opencommands",
+              filePatterns: ["*.md"],
               fileExtension: ".md"
             },
             skill: {
               directory: ".openskills",
-              filePatterns: ["*.md"],
+              filePatterns: ["SKILL.md"],
               nested: true,
+              nestedIndicator: "SKILL.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             },
             agent: {
               directory: ".openagents",
-              filePatterns: ["*.md"],
+              filePatterns: ["AGENT.md"],
               nested: true,
+              nestedIndicator: "AGENT.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             }
@@ -12861,15 +12865,17 @@ var init_format_registry = __esm({
             },
             skill: {
               directory: ".openskills",
-              filePatterns: ["*.md"],
+              filePatterns: ["SKILL.md"],
               nested: true,
+              nestedIndicator: "SKILL.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             },
             agent: {
               directory: ".openagents",
-              filePatterns: ["*.md"],
+              filePatterns: ["AGENT.md"],
               nested: true,
+              nestedIndicator: "AGENT.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             }
@@ -12887,15 +12893,17 @@ var init_format_registry = __esm({
             },
             skill: {
               directory: ".openskills",
-              filePatterns: ["*.md"],
+              filePatterns: ["SKILL.md"],
               nested: true,
+              nestedIndicator: "SKILL.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             },
             agent: {
               directory: ".openagents",
-              filePatterns: ["*.md"],
+              filePatterns: ["AGENT.md"],
               nested: true,
+              nestedIndicator: "AGENT.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             }
@@ -12913,15 +12921,17 @@ var init_format_registry = __esm({
             },
             skill: {
               directory: ".openskills",
-              filePatterns: ["*.md"],
+              filePatterns: ["SKILL.md"],
               nested: true,
+              nestedIndicator: "SKILL.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             },
             agent: {
               directory: ".openagents",
-              filePatterns: ["*.md"],
+              filePatterns: ["AGENT.md"],
               nested: true,
+              nestedIndicator: "AGENT.md",
               usesPackageSubdirectory: true,
               fileExtension: ".md"
             }
@@ -13591,9 +13601,22 @@ var init_types = __esm({
 // src/core/agents-md-progressive.ts
 function generateSkillXML(entry) {
   const resourceType = entry.resourceType || "skill";
-  const tag = resourceType === "agent" ? "agent" : "skill";
-  const mainFile = entry.mainFile || (resourceType === "agent" ? "AGENT.md" : "SKILL.md");
-  const fullPath = import_path10.default.join(entry.skillPath, mainFile);
+  let tag;
+  let mainFile;
+  let fullPath;
+  if (resourceType === "command") {
+    tag = "command";
+    mainFile = entry.mainFile || `${entry.name}.md`;
+    fullPath = import_path10.default.join(entry.skillPath, mainFile);
+  } else if (resourceType === "agent") {
+    tag = "agent";
+    mainFile = entry.mainFile || "AGENT.md";
+    fullPath = import_path10.default.join(entry.skillPath, mainFile);
+  } else {
+    tag = "skill";
+    mainFile = entry.mainFile || "SKILL.md";
+    fullPath = import_path10.default.join(entry.skillPath, mainFile);
+  }
   const activation = entry.eager ? "eager" : "lazy";
   return `<${tag} activation="${activation}">
 <name>${escapeXML(entry.name)}</name>
@@ -13657,6 +13680,26 @@ Usage notes:
 
 <available_agents>`;
 }
+function generateCommandsSystemHeader() {
+  return `<commands_system priority="1">
+<usage>
+Commands are reusable workflows that can be invoked by the user or triggered by context.
+
+How to use commands:
+- When a user explicitly asks for a command (e.g., "run build-actions" or "/build-actions")
+- Or when the task context matches a command's description
+- Load the command: Bash("cat <path>")
+- Follow the instructions in the loaded command file
+- Example: Bash("cat .opencommands/build-actions.md")
+
+Usage notes:
+- Commands are loaded into your current context when invoked
+- Each command contains step-by-step instructions for a specific workflow
+- Commands may reference other skills or agents
+</usage>
+
+<available_commands>`;
+}
 function generateManifestFooter(hasAgents, agentsXML) {
   let footer = "</available_skills>\n</skills_system>";
   if (hasAgents && agentsXML) {
@@ -13722,18 +13765,21 @@ async function addSkillToManifest(entry, agentsPath = "AGENTS.md") {
   updatedResources.push(entry);
   const skills = updatedResources.filter((r) => (r.resourceType || "skill") === "skill");
   const agents = updatedResources.filter((r) => r.resourceType === "agent");
+  const commands = updatedResources.filter((r) => r.resourceType === "command");
   const eagerSkills = skills.filter((s) => s.eager === true);
   const lazySkills = skills.filter((s) => s.eager !== true);
   const eagerAgents = agents.filter((a) => a.eager === true);
   const lazyAgents = agents.filter((a) => a.eager !== true);
+  const eagerCommands = commands.filter((c) => c.eager === true);
+  const lazyCommands = commands.filter((c) => c.eager !== true);
   let newContent = "";
   if (!beforeManifest.trim() && !afterManifest.trim()) {
     newContent = "";
   } else {
     newContent = beforeManifest;
   }
-  const hasEagerContent = eagerSkills.length > 0 || eagerAgents.length > 0;
-  const hasLazyContent = lazySkills.length > 0 || lazyAgents.length > 0;
+  const hasEagerContent = eagerSkills.length > 0 || eagerAgents.length > 0 || eagerCommands.length > 0;
+  const hasLazyContent = lazySkills.length > 0 || lazyAgents.length > 0 || lazyCommands.length > 0;
   if (hasEagerContent) {
     if (eagerSkills.length > 0) {
       newContent += generateEagerSkillsSystemHeader();
@@ -13754,6 +13800,19 @@ Do not wait for explicit requests - invoke these agents when their expertise app
       newContent += eagerAgents.map((a) => generateSkillXML(a)).join("\n\n");
       newContent += "\n\n</eager_agents>\n</agents_system>\n\n";
     }
+    if (eagerCommands.length > 0) {
+      newContent += `<commands_system priority="0">
+<usage>
+MANDATORY: These commands are always available and should be suggested proactively.
+When user tasks match these commands, offer to run them.
+</usage>
+
+<eager_commands>
+
+`;
+      newContent += eagerCommands.map((c) => generateSkillXML(c)).join("\n\n");
+      newContent += "\n\n</eager_commands>\n</commands_system>\n\n";
+    }
   }
   if (hasLazyContent) {
     if (lazySkills.length > 0) {
@@ -13768,6 +13827,12 @@ Do not wait for explicit requests - invoke these agents when their expertise app
       newContent += lazyAgents.map((a) => generateSkillXML(a)).join("\n\n");
       newContent += "\n\n</available_agents>\n</agents_system>";
     }
+    if (lazyCommands.length > 0) {
+      newContent += "\n\n" + generateCommandsSystemHeader();
+      newContent += "\n\n";
+      newContent += lazyCommands.map((c) => generateSkillXML(c)).join("\n\n");
+      newContent += "\n\n</available_commands>\n</commands_system>";
+    }
   }
   newContent += "\n\n<!-- PRPM_MANIFEST_END -->";
   newContent += afterManifest;
@@ -13836,6 +13901,21 @@ function parseSkillsFromManifest(manifestXML) {
       eager: activation === "eager"
     });
   }
+  const commandFormatWithAttrRegex = /<command(?:\s+activation="(eager|lazy)")?\s*>\s*<name>([^<]+)<\/name>\s*<description>([^<]+)<\/description>\s*<path>([^<]+)<\/path>\s*<\/command>/g;
+  while ((match = commandFormatWithAttrRegex.exec(manifestXML)) !== null) {
+    const [, activation, name, description, fullPath] = match;
+    const pathParts = fullPath.trim().split("/");
+    const mainFile = pathParts[pathParts.length - 1];
+    const dir = pathParts.slice(0, -1).join("/");
+    resources.push({
+      name: unescapeXML(name.trim()),
+      description: unescapeXML(description.trim()),
+      skillPath: dir,
+      mainFile,
+      resourceType: "command",
+      eager: activation === "eager"
+    });
+  }
   if (resources.length === 0) {
     const legacyRegex = /<skill\s+name="([^"]+)"\s+path="([^"]+)">([^<]*)<\/skill>/g;
     while ((match = legacyRegex.exec(manifestXML)) !== null) {
@@ -16423,7 +16503,7 @@ function findMainFile(files, format, subtype) {
   return null;
 }
 async function handleInstall(packageSpec, options) {
-  var _a;
+  var _a, _b;
   const startTime = Date.now();
   let success = false;
   let error;
@@ -16934,13 +17014,16 @@ This could indicate:
         destPath = `${destDir}/SKILL.md`;
       } else if (effectiveFormat === "claude" && effectiveSubtype === "hook") {
         destPath = `${destDir}/settings.json`;
-      } else if (effectiveFormat === "agents.md" || effectiveFormat === "gemini.md" || effectiveFormat === "claude.md") {
+      } else if (effectiveFormat === "agents.md" || effectiveFormat === "gemini.md" || effectiveFormat === "claude.md" || effectiveFormat === "codex") {
         if (effectiveSubtype === "skill") {
           destPath = `${destDir}/SKILL.md`;
           console.log(`   \u{1F4E6} Installing skill to ${destDir}/ for progressive disclosure`);
         } else if (effectiveSubtype === "agent") {
           destPath = `${destDir}/AGENT.md`;
           console.log(`   \u{1F916} Installing agent to ${destDir}/ for progressive disclosure`);
+        } else if (effectiveSubtype === "slash-command") {
+          destPath = `${destDir}/${packageName}.md`;
+          console.log(`   \u26A1 Installing command to ${destDir}/ for progressive disclosure`);
         } else {
           const manifestFilename = getManifestFilename(effectiveFormat);
           let targetPath = manifestFilename;
@@ -17150,17 +17233,13 @@ ${afterFrontmatter}`;
       "aider",
       // Uses CONVENTIONS.md
       "codex",
-      // Uses AGENTS.md (no native skills)
-      "cursor",
-      // Uses AGENTS.md (no native skills)
+      // Uses AGENTS.md (no native skills/agents)
       "copilot",
-      // Uses AGENTS.md (no native skills)
+      // Uses AGENTS.md (no native skills/agents)
       "kiro",
       // Uses AGENTS.md (no native skills)
       "opencode",
       // Uses AGENTS.md (no native skills)
-      "ruler",
-      // Uses AGENTS.md (no native skills)
       "replit",
       // Uses AGENTS.md (no native skills)
       "zed",
@@ -17168,14 +17247,26 @@ ${afterFrontmatter}`;
       "generic"
       // Uses AGENTS.md (fallback format)
     ];
-    if (progressiveDisclosureFormats.includes(effectiveFormat) && (effectiveSubtype === "skill" || effectiveSubtype === "agent") && !options.noAppend) {
+    const partialNativeSupport = {
+      "cursor": ["agent"]
+      // Cursor has native rules/commands but no native agents
+    };
+    const needsProgressiveDisclosure = progressiveDisclosureFormats.includes(effectiveFormat) && (effectiveSubtype === "skill" || effectiveSubtype === "agent" || effectiveSubtype === "slash-command") || ((_b = partialNativeSupport[effectiveFormat]) == null ? void 0 : _b.includes(effectiveSubtype));
+    if (needsProgressiveDisclosure && !options.noAppend) {
       if (!destDir) {
         throw new Error("Internal error: destDir not set for progressive disclosure installation");
       }
       const manifestPath = options.manifestFile || getManifestFilename(effectiveFormat);
       const resourceName = stripAuthorNamespace2(packageId);
-      const resourceType = effectiveSubtype;
-      const mainFile = resourceType === "agent" ? "AGENT.md" : "SKILL.md";
+      const resourceType = effectiveSubtype === "slash-command" ? "command" : effectiveSubtype;
+      let mainFile;
+      if (resourceType === "command") {
+        mainFile = `${resourceName}.md`;
+      } else if (resourceType === "agent") {
+        mainFile = "AGENT.md";
+      } else {
+        mainFile = "SKILL.md";
+      }
       let resolvedEager;
       if (options.eager !== void 0) {
         resolvedEager = options.eager;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "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": "^2.1.2",
-    "@pr-pm/registry-client": "^2.3.2",
-    "@pr-pm/types": "^2.1.2",
+    "@pr-pm/converters": "^2.1.3",
+    "@pr-pm/registry-client": "^2.3.3",
+    "@pr-pm/types": "^2.1.3",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",