@curdx/flow 2.2.0 → 2.2.3

package/schemas/plugin-manifest.schema.json

@@ -4,8 +4,8 @@
   "title": "CurdX-Flow Claude Code Plugin Manifest",
   "description": "Project-local schema for .claude-plugin/plugin.json.",
   "type": "object",
-  "required": ["name", "version", "description"],
-  "additionalProperties": true,
+  "required": ["name"],
+  "additionalProperties": false,
   "properties": {
     "name": {
       "type": "string",
@@ -16,35 +16,80 @@
       "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$"
     },
     "description": { "type": "string" },
-    "author": { "type": "object" },
-    "homepage": { "type": "string" },
-    "repository": { "type": "string" },
-    "license": { "type": "string" },
-    "keywords": { "type": "array", "items": { "type": "string" } },
+    "author": { "$ref": "#/definitions/authorMetadata" },
+    "homepage": { "type": "string", "minLength": 1 },
+    "repository": { "type": "string", "minLength": 1 },
+    "license": { "type": "string", "minLength": 1 },
+    "keywords": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
     "skills": {
       "oneOf": [
-        { "type": "string" },
-        { "type": "array", "items": { "type": "string" } }
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } }
+      ]
+    },
+    "commands": {
+      "oneOf": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } }
       ]
     },
     "agents": {
       "oneOf": [
-        { "type": "string" },
-        { "type": "array", "items": { "type": "string" } }
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } }
       ]
     },
     "hooks": {
       "oneOf": [
-        { "type": "string" },
-        { "type": "object" }
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } },
+        { "$ref": "#/definitions/inlineHooksConfig" }
       ]
     },
     "mcpServers": {
       "oneOf": [
-        { "type": "string" },
-        { "type": "object" }
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } },
+        { "$ref": "#/definitions/inlineMcpServersConfig" }
+      ]
+    },
+    "outputStyles": {
+      "oneOf": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } }
       ]
     },
+    "themes": {
+      "oneOf": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } }
+      ]
+    },
+    "lspServers": {
+      "oneOf": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } },
+        { "$ref": "#/definitions/inlineLspServersConfig" }
+      ]
+    },
+    "monitors": {
+      "oneOf": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/monitorEntry" } }
+      ]
+    },
+    "userConfig": {
+      "type": "object",
+      "propertyNames": { "$ref": "#/definitions/userConfigKey" },
+      "additionalProperties": { "$ref": "#/definitions/userConfigOption" }
+    },
+    "channels": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/channelEntry" }
+    },
     "dependencies": {
       "type": "array",
       "items": {
@@ -53,14 +98,339 @@
           {
             "type": "object",
             "required": ["name"],
+            "additionalProperties": false,
             "properties": {
-              "name": { "type": "string" },
+              "name": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9-]*$"
+              },
               "version": { "type": "string" },
-              "marketplace": { "type": "string" }
+              "marketplace": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9-]*$"
+              }
             }
           }
         ]
       }
     }
+  },
+  "definitions": {
+    "authorMetadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "email": { "type": "string", "minLength": 1 },
+        "url": { "type": "string", "minLength": 1 }
+      }
+    },
+    "inlineHooksConfig": {
+      "type": "object",
+      "required": ["hooks"],
+      "additionalProperties": false,
+      "properties": {
+        "hooks": {
+          "type": "object",
+          "propertyNames": {
+            "enum": [
+              "SessionStart",
+              "InstructionsLoaded",
+              "UserPromptSubmit",
+              "UserPromptExpansion",
+              "PreToolUse",
+              "PermissionRequest",
+              "PostToolUse",
+              "PostToolUseFailure",
+              "PostToolBatch",
+              "PermissionDenied",
+              "Notification",
+              "SubagentStart",
+              "SubagentStop",
+              "TaskCreated",
+              "TaskCompleted",
+              "Stop",
+              "StopFailure",
+              "TeammateIdle",
+              "ConfigChange",
+              "CwdChanged",
+              "FileChanged",
+              "WorktreeCreate",
+              "WorktreeRemove",
+              "PreCompact",
+              "PostCompact",
+              "Elicitation",
+              "ElicitationResult",
+              "SessionEnd"
+            ]
+          },
+          "additionalProperties": {
+            "type": "array",
+            "items": { "$ref": "#/definitions/hookMatcherGroup" }
+          }
+        }
+      }
+    },
+    "inlineMcpServersConfig": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/definitions/mcpServerEntry" }
+    },
+    "pluginRelativePath": {
+      "type": "string",
+      "pattern": "^\\./(?!\\.\\.?(?:/|$))(?!.*(?:^|/)\\.\\.(?:/|$)).+"
+    },
+    "inlineLspServersConfig": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/definitions/lspServerEntry" }
+    },
+    "hookMatcherGroup": {
+      "type": "object",
+      "required": ["hooks"],
+      "additionalProperties": false,
+      "properties": {
+        "matcher": { "type": "string" },
+        "hooks": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/hookHandler" }
+        }
+      }
+    },
+    "mcpServerEntry": {
+      "oneOf": [
+        { "$ref": "#/definitions/mcpStdioServerEntry" },
+        { "$ref": "#/definitions/mcpHttpServerEntry" },
+        { "$ref": "#/definitions/mcpSseServerEntry" }
+      ]
+    },
+    "mcpStdioServerEntry": {
+      "type": "object",
+      "required": ["command"],
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["stdio"]
+        },
+        "command": { "type": "string", "minLength": 1 },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "cwd": { "type": "string", "minLength": 1 }
+      }
+    },
+    "mcpHttpServerEntry": {
+      "type": "object",
+      "required": ["type", "url"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "const": "http" },
+        "url": { "type": "string", "minLength": 1 },
+        "headers": { "$ref": "#/definitions/mcpHeaders" },
+        "oauth": { "$ref": "#/definitions/mcpOauthConfig" },
+        "headersHelper": { "type": "string", "minLength": 1 }
+      }
+    },
+    "mcpSseServerEntry": {
+      "type": "object",
+      "required": ["type", "url"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "const": "sse" },
+        "url": { "type": "string", "minLength": 1 },
+        "headers": { "$ref": "#/definitions/mcpHeaders" },
+        "oauth": { "$ref": "#/definitions/mcpOauthConfig" },
+        "headersHelper": { "type": "string", "minLength": 1 }
+      }
+    },
+    "mcpHeaders": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "mcpOauthConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "authServerMetadataUrl": { "type": "string", "minLength": 1 },
+        "scopes": { "type": "string", "minLength": 1 }
+      }
+    },
+    "lspServerEntry": {
+      "type": "object",
+      "required": ["command", "extensionToLanguage"],
+      "additionalProperties": false,
+      "properties": {
+        "command": { "type": "string", "minLength": 1 },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "extensionToLanguage": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^\\."
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "transport": {
+          "type": "string",
+          "enum": ["stdio", "socket"]
+        },
+        "env": { "type": "object" },
+        "initializationOptions": { "type": "object" },
+        "settings": { "type": "object" },
+        "workspaceFolder": { "type": "string", "minLength": 1 },
+        "startupTimeout": { "type": "integer", "minimum": 1 },
+        "shutdownTimeout": { "type": "integer", "minimum": 1 },
+        "restartOnCrash": { "type": "boolean" },
+        "maxRestarts": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "hookHandler": {
+      "type": "object",
+      "required": ["type"],
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["command", "http", "mcp_tool", "prompt", "agent"]
+        },
+        "if": { "type": "string" },
+        "timeout": { "type": "integer", "minimum": 1 },
+        "statusMessage": { "type": "string" },
+        "async": { "type": "boolean" },
+        "asyncRewake": { "type": "boolean" },
+        "once": { "type": "boolean" },
+        "command": { "type": "string" },
+        "shell": {
+          "type": "string",
+          "enum": ["bash", "powershell"]
+        },
+        "url": { "type": "string" },
+        "headers": { "type": "object" },
+        "allowedEnvVars": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "server": { "type": "string" },
+        "tool": { "type": "string" },
+        "input": { "type": "object" },
+        "prompt": { "type": "string" },
+        "model": { "type": "string" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "command" } } },
+          "then": { "required": ["command"] }
+        },
+        {
+          "if": { "properties": { "type": { "const": "http" } } },
+          "then": { "required": ["url"] }
+        },
+        {
+          "if": { "properties": { "type": { "const": "mcp_tool" } } },
+          "then": { "required": ["server", "tool"] }
+        },
+        {
+          "if": { "properties": { "type": { "enum": ["prompt", "agent"] } } },
+          "then": { "required": ["prompt"] }
+        }
+      ]
+    },
+    "monitorEntry": {
+      "type": "object",
+      "required": ["name", "command", "description"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "command": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "minLength": 1 },
+        "when": {
+          "type": "string",
+          "pattern": "^(always|on-skill-invoke:[A-Za-z0-9][A-Za-z0-9-]{0,63})$"
+        }
+      }
+    },
+    "userConfigKey": {
+      "type": "string",
+      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+    },
+    "userConfigOption": {
+      "type": "object",
+      "required": ["type", "title", "description"],
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["string", "number", "boolean", "directory", "file"]
+        },
+        "title": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "minLength": 1 },
+        "sensitive": { "type": "boolean" },
+        "required": { "type": "boolean" },
+        "default": {},
+        "multiple": { "type": "boolean" },
+        "min": { "type": "number" },
+        "max": { "type": "number" }
+      },
+      "allOf": [
+        {
+          "if": {
+            "not": {
+              "properties": { "type": { "const": "string" } },
+              "required": ["type"]
+            }
+          },
+          "then": {
+            "not": { "required": ["multiple"] }
+          }
+        },
+        {
+          "if": {
+            "not": {
+              "properties": { "type": { "const": "number" } },
+              "required": ["type"]
+            }
+          },
+          "then": {
+            "not": {
+              "anyOf": [
+                { "required": ["min"] },
+                { "required": ["max"] }
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "channelEntry": {
+      "type": "object",
+      "required": ["server"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "server": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": { "type": "string" },
+        "userConfig": {
+          "type": "object",
+          "propertyNames": { "$ref": "#/definitions/userConfigKey" },
+          "additionalProperties": { "$ref": "#/definitions/userConfigOption" }
+        }
+      }
+    }
   }
 }

package/schemas/plugin-settings.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://curdx-flow.dev/schemas/plugin-settings.schema.json",
+  "title": "CurdX-Flow Claude Code Plugin Settings",
+  "description": "Supported plugin-root settings.json fields. Official plugin settings currently support only agent and subagentStatusLine.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "agent": {
+      "type": "string",
+      "minLength": 1
+    },
+    "subagentStatusLine": {
+      "type": "object",
+      "required": ["type", "command"],
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "command"
+        },
+        "command": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}

package/schemas/skill-frontmatter.schema.json

@@ -14,11 +14,11 @@
     "description": {
       "type": "string",
       "minLength": 1,
-      "description": "Concise trigger summary. Keep detailed trigger phrases in when_to_use."
+      "description": "Concise trigger summary. Front-load the key use case. Combined description + when_to_use text is truncated at 1536 characters in Claude Code's skill listing."
     },
     "when_to_use": {
       "type": "string",
-      "description": "Additional trigger phrases appended to description in the skill listing."
+      "description": "Additional trigger phrases appended to description in the skill listing. Counts toward the same 1536-character listing cap."
     },
     "argument-hint": {
       "type": "string"
@@ -33,7 +33,8 @@
       "type": "boolean"
     },
     "user-invocable": {
-      "type": "boolean"
+      "type": "boolean",
+      "description": "Controls whether the skill appears in the slash menu. Does not block model invocation; use disable-model-invocation for that."
     },
     "allowed-tools": {
       "oneOf": [
@@ -56,7 +57,7 @@
       "type": "string"
     },
     "hooks": {
-      "type": "object"
+      "$ref": "#/definitions/skillHooks"
     },
     "paths": {
       "oneOf": [
@@ -68,5 +69,109 @@
       "type": "string",
       "enum": ["bash", "powershell"]
     }
+  },
+  "definitions": {
+    "skillHooks": {
+      "type": "object",
+      "propertyNames": {
+        "enum": [
+          "SessionStart",
+          "InstructionsLoaded",
+          "UserPromptSubmit",
+          "UserPromptExpansion",
+          "PreToolUse",
+          "PermissionRequest",
+          "PostToolUse",
+          "PostToolUseFailure",
+          "PostToolBatch",
+          "PermissionDenied",
+          "Notification",
+          "SubagentStart",
+          "SubagentStop",
+          "TaskCreated",
+          "TaskCompleted",
+          "Stop",
+          "StopFailure",
+          "TeammateIdle",
+          "ConfigChange",
+          "CwdChanged",
+          "FileChanged",
+          "WorktreeCreate",
+          "WorktreeRemove",
+          "PreCompact",
+          "PostCompact",
+          "Elicitation",
+          "ElicitationResult",
+          "SessionEnd"
+        ]
+      },
+      "additionalProperties": {
+        "type": "array",
+        "items": { "$ref": "#/definitions/matcherGroup" }
+      }
+    },
+    "matcherGroup": {
+      "type": "object",
+      "required": ["hooks"],
+      "additionalProperties": false,
+      "properties": {
+        "matcher": { "type": "string" },
+        "hooks": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/hookHandler" }
+        }
+      }
+    },
+    "hookHandler": {
+      "type": "object",
+      "required": ["type"],
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["command", "http", "mcp_tool", "prompt", "agent"]
+        },
+        "if": { "type": "string" },
+        "timeout": { "type": "integer", "minimum": 1 },
+        "statusMessage": { "type": "string" },
+        "async": { "type": "boolean" },
+        "asyncRewake": { "type": "boolean" },
+        "once": { "type": "boolean" },
+        "command": { "type": "string" },
+        "shell": {
+          "type": "string",
+          "enum": ["bash", "powershell"]
+        },
+        "url": { "type": "string" },
+        "headers": { "type": "object" },
+        "allowedEnvVars": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "server": { "type": "string" },
+        "tool": { "type": "string" },
+        "input": { "type": "object" },
+        "prompt": { "type": "string" },
+        "model": { "type": "string" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "command" } } },
+          "then": { "required": ["command"] }
+        },
+        {
+          "if": { "properties": { "type": { "const": "http" } } },
+          "then": { "required": ["url"] }
+        },
+        {
+          "if": { "properties": { "type": { "const": "mcp_tool" } } },
+          "then": { "required": ["server", "tool"] }
+        },
+        {
+          "if": { "properties": { "type": { "enum": ["prompt", "agent"] } } },
+          "then": { "required": ["prompt"] }
+        }
+      ]
+    }
   }
 }

package/schemas/spec-state.schema.json

@@ -44,7 +44,6 @@
         "execute",
         "verify",
         "review",
-        "ship",
         "completed"
       ]
     },
@@ -57,8 +56,7 @@
         "tasks": { "$ref": "#/definitions/phaseStatus" },
         "execute": { "$ref": "#/definitions/phaseStatus" },
         "verify": { "$ref": "#/definitions/phaseStatus" },
-        "review": { "$ref": "#/definitions/phaseStatus" },
-        "ship": { "$ref": "#/definitions/phaseStatus" }
+        "review": { "$ref": "#/definitions/phaseStatus" }
       }
     },
     "execute_state": {
@@ -73,7 +71,34 @@
         "total_tasks": { "type": "integer", "minimum": 0 },
         "task_iteration": { "type": "integer", "minimum": 1 },
         "global_iteration": { "type": "integer", "minimum": 1 },
-        "failed_attempts": { "type": "integer", "minimum": 0 }
+        "failed_attempts": { "type": "integer", "minimum": 0 },
+        "recovery_mode": {
+          "type": "string",
+          "enum": ["manual", "fix-task"],
+          "default": "manual"
+        },
+        "max_fix_tasks_per_original": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5,
+          "default": 2
+        },
+        "fix_task_map": {
+          "type": "object",
+          "description": "Per-original-task recovery attempts created by fix-task mode.",
+          "additionalProperties": {
+            "type": "object",
+            "required": ["attempts", "fix_task_ids"],
+            "properties": {
+              "attempts": { "type": "integer", "minimum": 0 },
+              "fix_task_ids": {
+                "type": "array",
+                "items": { "type": "string" }
+              },
+              "last_error": { "type": "string" }
+            }
+          }
+        }
       }
     },
     "decisions": {

package/settings.json

@@ -0,0 +1,6 @@
+{
+  "subagentStatusLine": {
+    "type": "command",
+    "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/subagent-statusline.sh"
+  }
+}