@cleocode/mcp-server 0.86.0

package/schemas/index.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "CLEO MCP Schema Registry",
+  "description": "Registry of all request and response schemas for 98 MCP operations",
+  "version": "1.0.0",
+  "domains": {
+    "tasks": {
+      "queries": [
+        "get",
+        "list",
+        "find",
+        "exists",
+        "tree",
+        "blockers",
+        "deps",
+        "analyze",
+        "next"
+      ],
+      "mutations": [
+        "create",
+        "update",
+        "complete",
+        "delete",
+        "archive",
+        "unarchive",
+        "reparent",
+        "promote",
+        "reorder",
+        "reopen"
+      ]
+    },
+    "session": {
+      "queries": [
+        "status",
+        "list",
+        "show",
+        "focus.get",
+        "history"
+      ],
+      "mutations": [
+        "start",
+        "end",
+        "resume",
+        "suspend",
+        "focus.set",
+        "focus.clear",
+        "gc"
+      ]
+    },
+    "orchestrate": {
+      "queries": [
+        "status",
+        "next",
+        "ready",
+        "analyze",
+        "context",
+        "waves",
+        "skill.list"
+      ],
+      "mutations": [
+        "startup",
+        "spawn",
+        "validate",
+        "parallel.start",
+        "parallel.end"
+      ]
+    },
+    "research": {
+      "queries": [
+        "show",
+        "list",
+        "query",
+        "pending",
+        "stats",
+        "manifest.read"
+      ],
+      "mutations": [
+        "inject",
+        "link",
+        "manifest.append",
+        "manifest.archive"
+      ]
+    },
+    "lifecycle": {
+      "queries": [
+        "check",
+        "status",
+        "history",
+        "gates",
+        "prerequisites"
+      ],
+      "mutations": [
+        "progress",
+        "skip",
+        "reset",
+        "gate.pass",
+        "gate.fail"
+      ]
+    },
+    "validate": {
+      "queries": [
+        "schema",
+        "protocol",
+        "task",
+        "manifest",
+        "output",
+        "compliance.summary",
+        "compliance.violations",
+        "test.status",
+        "test.coverage"
+      ],
+      "mutations": [
+        "compliance.record",
+        "test.run"
+      ]
+    },
+    "release": {
+      "queries": [],
+      "mutations": [
+        "prepare",
+        "changelog",
+        "commit",
+        "tag",
+        "push",
+        "gates.run",
+        "rollback"
+      ]
+    },
+    "system": {
+      "queries": [
+        "version",
+        "doctor",
+        "config.get",
+        "stats",
+        "context"
+      ],
+      "mutations": [
+        "init",
+        "config.set",
+        "backup",
+        "restore",
+        "migrate",
+        "sync",
+        "cleanup"
+      ]
+    }
+  },
+  "summary": {
+    "total_operations": 98,
+    "total_queries": 45,
+    "total_mutations": 53,
+    "domains": 8
+  },
+  "common_schemas": [
+    "common/meta.schema.json",
+    "common/error.schema.json",
+    "common/pagination.schema.json"
+  ]
+}

package/schemas/requests/lifecycle/check.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.check request",
+  "description": "Check stage prerequisites",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    },
+    "targetStage": {
+      "type": "string",
+      "enum": ["research", "consensus", "specification", "decomposition", "implementation", "validation", "testing", "release"],
+      "description": "Target stage"
+    }
+  },
+  "required": ["taskId", "targetStage"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/gate.fail.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.gate.fail request",
+  "description": "Mark gate as failed",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    },
+    "gateName": {
+      "type": "string",
+      "enum": ["implemented", "testsPassed", "qaPassed", "cleanupDone", "securityPassed", "documented"],
+      "description": "Gate name"
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 10,
+      "description": "Failure reason"
+    }
+  },
+  "required": ["taskId", "gateName", "reason"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/gate.pass.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.gate.pass request",
+  "description": "Mark gate as passed",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    },
+    "gateName": {
+      "type": "string",
+      "enum": ["implemented", "testsPassed", "qaPassed", "cleanupDone", "securityPassed", "documented"],
+      "description": "Gate name"
+    },
+    "agent": {
+      "type": "string",
+      "description": "Agent that passed gate"
+    },
+    "notes": {
+      "type": "string",
+      "description": "Pass notes"
+    }
+  },
+  "required": ["taskId", "gateName", "agent"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/gates.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.gates request",
+  "description": "All gate statuses",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    }
+  },
+  "required": ["taskId"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/history.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.history request",
+  "description": "Stage transition history",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    }
+  },
+  "required": ["taskId"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/prerequisites.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.prerequisites request",
+  "description": "Required prior stages",
+  "type": "object",
+  "properties": {
+    "targetStage": {
+      "type": "string",
+      "enum": ["research", "consensus", "specification", "decomposition", "implementation", "validation", "testing", "release"],
+      "description": "Target stage"
+    }
+  },
+  "required": ["targetStage"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/progress.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.progress request",
+  "description": "Record stage completion",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    },
+    "stage": {
+      "type": "string",
+      "enum": ["research", "consensus", "specification", "decomposition", "implementation", "validation", "testing", "release"],
+      "description": "Stage name"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["completed", "skipped", "pending"],
+      "description": "Stage status"
+    },
+    "notes": {
+      "type": "string",
+      "description": "Progress notes"
+    }
+  },
+  "required": ["taskId", "stage", "status"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/reset.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.reset request",
+  "description": "Reset stage (emergency)",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    },
+    "stage": {
+      "type": "string",
+      "enum": ["research", "consensus", "specification", "decomposition", "implementation", "validation", "testing", "release"],
+      "description": "Stage to reset"
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 20,
+      "description": "Reason for reset (logged for audit)"
+    }
+  },
+  "required": ["taskId", "stage", "reason"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/skip.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.skip request",
+  "description": "Skip optional stage",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    },
+    "stage": {
+      "type": "string",
+      "enum": ["consensus"],
+      "description": "Stage to skip (only optional stages)"
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 10,
+      "description": "Reason for skipping"
+    }
+  },
+  "required": ["taskId", "stage", "reason"],
+  "additionalProperties": false
+}

package/schemas/requests/lifecycle/status.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lifecycle.status request",
+  "description": "Current lifecycle state",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID (mutually exclusive with epicId)"
+    },
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID (mutually exclusive with taskId)"
+    }
+  },
+  "oneOf": [
+    {"required": ["taskId"]},
+    {"required": ["epicId"]}
+  ],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/analyze.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.analyze request",
+  "description": "Dependency analysis",
+  "type": "object",
+  "properties": {
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID"
+    }
+  },
+  "required": ["epicId"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/context.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.context request",
+  "description": "Context usage check",
+  "type": "object",
+  "properties": {
+    "tokens": {
+      "type": "integer",
+      "description": "Current token count for budget check"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/next.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.next request",
+  "description": "Next task to spawn",
+  "type": "object",
+  "properties": {
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID"
+    }
+  },
+  "required": ["epicId"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/parallel.end.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.parallel.end request",
+  "description": "End parallel wave",
+  "type": "object",
+  "properties": {
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID"
+    },
+    "wave": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Wave number"
+    }
+  },
+  "required": ["epicId", "wave"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/parallel.start.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.parallel.start request",
+  "description": "Start parallel wave",
+  "type": "object",
+  "properties": {
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID"
+    },
+    "wave": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Wave number"
+    }
+  },
+  "required": ["epicId", "wave"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/ready.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.ready request",
+  "description": "Parallel-safe tasks",
+  "type": "object",
+  "properties": {
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID"
+    }
+  },
+  "required": ["epicId"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/skill.list.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.skill.list request",
+  "description": "Available skills",
+  "type": "object",
+  "properties": {
+    "filter": {
+      "type": "string",
+      "description": "Filter by skill name or tag"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/spawn.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.spawn request",
+  "description": "Generate spawn prompt",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID to spawn"
+    },
+    "skill": {
+      "type": "string",
+      "description": "Skill name (optional, auto-detected if omitted)"
+    },
+    "model": {
+      "type": "string",
+      "enum": ["sonnet", "opus", "haiku"],
+      "default": "sonnet",
+      "description": "Model preference"
+    }
+  },
+  "required": ["taskId"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/startup.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.startup request",
+  "description": "Initialize orchestration",
+  "type": "object",
+  "properties": {
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID"
+    }
+  },
+  "required": ["epicId"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/status.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.status request",
+  "description": "Orchestrator status",
+  "type": "object",
+  "properties": {
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID"
+    }
+  },
+  "required": ["epicId"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/validate.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.validate request",
+  "description": "Validate spawn readiness",
+  "type": "object",
+  "properties": {
+    "taskId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Task ID"
+    }
+  },
+  "required": ["taskId"],
+  "additionalProperties": false
+}

package/schemas/requests/orchestrate/waves.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "orchestrate.waves request",
+  "description": "Wave computation",
+  "type": "object",
+  "properties": {
+    "epicId": {
+      "type": "string",
+      "pattern": "^T[0-9]+$",
+      "description": "Epic ID"
+    }
+  },
+  "required": ["epicId"],
+  "additionalProperties": false
+}

package/schemas/requests/release/changelog.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "release.changelog request",
+  "description": "Generate changelog",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Version"
+    },
+    "sections": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["features", "fixes", "breaking", "docs", "chore"]
+      },
+      "description": "Changelog sections to include"
+    }
+  },
+  "required": ["version"],
+  "additionalProperties": false
+}

package/schemas/requests/release/commit.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "release.commit request",
+  "description": "Create release commit",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Version"
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Files to include (default: VERSION, CHANGELOG.md, README.md)"
+    }
+  },
+  "required": ["version"],
+  "additionalProperties": false
+}

package/schemas/requests/release/gates.run.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "release.gates.run request",
+  "description": "Run release gates",
+  "type": "object",
+  "properties": {
+    "gates": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["tests", "lint", "security", "docs"]
+      },
+      "description": "Gates to run (default: all)"
+    }
+  },
+  "additionalProperties": false
+}