@curdx/flow 2.1.0 → 2.2.3

package/schemas/plugin-manifest.schema.json

@@ -0,0 +1,436 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://curdx-flow.dev/schemas/plugin-manifest.schema.json",
+  "title": "CurdX-Flow Claude Code Plugin Manifest",
+  "description": "Project-local schema for .claude-plugin/plugin.json.",
+  "type": "object",
+  "required": ["name"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$"
+    },
+    "description": { "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": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } }
+      ]
+    },
+    "commands": {
+      "oneOf": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } }
+      ]
+    },
+    "agents": {
+      "oneOf": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } }
+      ]
+    },
+    "hooks": {
+      "oneOf": [
+        { "$ref": "#/definitions/pluginRelativePath" },
+        { "type": "array", "items": { "$ref": "#/definitions/pluginRelativePath" } },
+        { "$ref": "#/definitions/inlineHooksConfig" }
+      ]
+    },
+    "mcpServers": {
+      "oneOf": [
+        { "$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": {
+        "oneOf": [
+          { "type": "string" },
+          {
+            "type": "object",
+            "required": ["name"],
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9-]*$"
+              },
+              "version": { "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

@@ -0,0 +1,177 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://curdx-flow.dev/schemas/skill-frontmatter.schema.json",
+  "title": "CurdX-Flow Skill Frontmatter",
+  "description": "Supported YAML frontmatter fields for skills/<name>/SKILL.md.",
+  "type": "object",
+  "required": ["name", "description"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "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. Counts toward the same 1536-character listing cap."
+    },
+    "argument-hint": {
+      "type": "string"
+    },
+    "arguments": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ]
+    },
+    "disable-model-invocation": {
+      "type": "boolean"
+    },
+    "user-invocable": {
+      "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": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ]
+    },
+    "model": {
+      "type": "string"
+    },
+    "effort": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "xhigh", "max"]
+    },
+    "context": {
+      "type": "string",
+      "enum": ["fork"]
+    },
+    "agent": {
+      "type": "string"
+    },
+    "hooks": {
+      "$ref": "#/definitions/skillHooks"
+    },
+    "paths": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ]
+    },
+    "shell": {
+      "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"] }
+        }
+      ]
+    }
+  }
+}