@dragonflymcp/plugin 1.0.0

package/templates/schemas/sync-schema.json

@@ -0,0 +1,196 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zen.wysiwid.dev/schemas/sync.json",
+  "title": "Zen Synchronization Rules",
+  "description": "Schema for Zen WYSIWID synchronization YAML files",
+  "type": "object",
+  "required": ["name", "description", "rules"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Name of this synchronization set"
+    },
+    "description": {
+      "type": "string",
+      "description": "Description of what this synchronization set does"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "rules": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/syncRule" },
+      "minItems": 1
+    }
+  },
+  "definitions": {
+    "syncRule": {
+      "type": "object",
+      "required": ["id", "name", "when", "then"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Unique identifier for this rule"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable name"
+        },
+        "description": {
+          "type": "string"
+        },
+        "priority": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Higher priority rules execute first"
+        },
+        "parallel": {
+          "type": "boolean",
+          "default": false,
+          "description": "Can run in parallel with other rules"
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "when": { "$ref": "#/definitions/whenClause" },
+        "where": { "$ref": "#/definitions/whereClause" },
+        "then": { "$ref": "#/definitions/thenClause" },
+        "error_handling": { "$ref": "#/definitions/errorHandling" }
+      }
+    },
+    "whenClause": {
+      "type": "object",
+      "required": ["concept", "action", "status"],
+      "properties": {
+        "concept": {
+          "type": "string",
+          "description": "Concept that triggers this rule"
+        },
+        "action": {
+          "type": "string",
+          "description": "Action that triggers this rule"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["completed", "failed", "blocked", "any"],
+          "description": "Status that triggers this rule"
+        }
+      }
+    },
+    "whereClause": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Query expression to evaluate"
+        },
+        "timeout": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Timeout in seconds"
+        }
+      }
+    },
+    "thenClause": {
+      "type": "object",
+      "required": ["concept", "action"],
+      "properties": {
+        "concept": {
+          "type": "string",
+          "description": "Concept to invoke"
+        },
+        "action": {
+          "type": "string",
+          "description": "Action to invoke"
+        },
+        "model": {
+          "type": "string",
+          "enum": ["haiku", "sonnet", "opus"],
+          "description": "Model override (optional)"
+        },
+        "inputs": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Input parameters"
+        }
+      }
+    },
+    "errorHandling": {
+      "type": "object",
+      "properties": {
+        "on_error": {
+          "type": "string",
+          "enum": ["retry", "skip", "fail", "escalate"],
+          "default": "fail"
+        },
+        "max_retries": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0
+        },
+        "backoff_ms": {
+          "type": "integer",
+          "minimum": 100,
+          "default": 1000
+        },
+        "fallback": { "$ref": "#/definitions/thenClause" },
+        "mcp_connection_failed": { "$ref": "#/definitions/mcpErrorHandler" },
+        "mcp_tool_not_found": { "$ref": "#/definitions/mcpErrorHandler" },
+        "mcp_rate_limited": { "$ref": "#/definitions/mcpErrorHandler" },
+        "mcp_response_error": { "$ref": "#/definitions/mcpErrorHandler" }
+      }
+    },
+    "mcpErrorHandler": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["transient", "permanent"],
+          "description": "Error classification for retry decisions"
+        },
+        "action": {
+          "type": "string",
+          "enum": ["retry", "skip", "fail", "escalate"],
+          "default": "retry"
+        },
+        "max_retries": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 2
+        },
+        "backoff_ms": {
+          "type": "integer",
+          "minimum": 100,
+          "default": 1000
+        },
+        "set_flag": {
+          "type": "string",
+          "description": "Flag to set when this error occurs"
+        },
+        "fallback": {
+          "type": "string",
+          "description": "Alternative sync rule ID to invoke"
+        },
+        "reason": {
+          "type": "string",
+          "description": "Human-readable reason for logging"
+        },
+        "on_exhausted": {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "enum": ["skip", "fail", "escalate"]
+            },
+            "set_flag": { "type": "string" },
+            "reason": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/templates/schemas/task.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Zen Task Schema",
+  "description": "Schema for task tracking in koan/tasks/",
+  "type": "object",
+  "required": ["task_id", "title", "status", "priority", "type", "created_at"],
+  "properties": {
+    "task_id": {
+      "type": "string",
+      "pattern": "^task-[0-9]{3,}$",
+      "description": "Unique task identifier"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200,
+      "description": "Brief task title"
+    },
+    "description": {
+      "type": "string",
+      "description": "Detailed task description"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["todo", "in_progress", "done", "blocked"],
+      "description": "Current task status"
+    },
+    "priority": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "critical"],
+      "description": "Task priority level"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["feature", "bug", "chore", "spike", "refactor"],
+      "description": "Type of work"
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 creation timestamp"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 last update timestamp"
+    },
+    "provenance": {
+      "type": "object",
+      "properties": {
+        "story_id": { "type": ["string", "null"] },
+        "architecture_id": { "type": ["string", "null"] },
+        "implementation_id": { "type": ["string", "null"] },
+        "review_id": { "type": ["string", "null"] }
+      },
+      "description": "Links to Zen workflow artifacts"
+    },
+    "subtasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "status"],
+        "properties": {
+          "id": { "type": "string" },
+          "title": { "type": "string" },
+          "status": {
+            "type": "string",
+            "enum": ["todo", "in_progress", "done"]
+          }
+        }
+      },
+      "description": "List of subtasks for progress tracking"
+    },
+    "git": {
+      "type": "object",
+      "properties": {
+        "branch": { "type": ["string", "null"] },
+        "commits": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "pull_request": { "type": ["string", "null"] }
+      },
+      "description": "Git integration metadata"
+    },
+    "ai_metadata": {
+      "type": "object",
+      "properties": {
+        "concept_name": { "type": ["string", "null"] },
+        "model_used": {
+          "type": ["string", "null"],
+          "enum": ["haiku", "sonnet", "opus", null]
+        },
+        "cost_usd": { "type": ["number", "null"] },
+        "context_tokens": { "type": ["integer", "null"] }
+      },
+      "description": "AI-related metadata from Claude"
+    },
+    "labels": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Labels for filtering and categorization"
+    },
+    "assignee": {
+      "type": ["string", "null"],
+      "description": "Assigned person or team"
+    },
+    "due_date": {
+      "type": ["string", "null"],
+      "format": "date",
+      "description": "Optional due date"
+    },
+    "notes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["timestamp", "content"],
+        "properties": {
+          "timestamp": { "type": "string", "format": "date-time" },
+          "content": { "type": "string" },
+          "author": { "type": "string" }
+        }
+      },
+      "description": "Notes and comments on the task"
+    }
+  }
+}

package/templates/schemas/tree-of-thoughts.schema.json

@@ -0,0 +1,175 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Tree of Thoughts",
+  "description": "Schema for Tree-of-Thoughts exploration output",
+  "type": "object",
+  "required": ["tree_id", "problem", "exploration", "selected_path", "rationale", "status"],
+  "properties": {
+    "tree_id": {
+      "type": "string",
+      "pattern": "^tot-[0-9]{3,}$",
+      "description": "Unique identifier for this exploration"
+    },
+    "problem": {
+      "type": "string",
+      "minLength": 10,
+      "description": "The problem being explored"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "exploration": {
+      "type": "object",
+      "required": ["root", "branches"],
+      "properties": {
+        "root": {
+          "type": "string",
+          "description": "Root node description"
+        },
+        "branches": {
+          "type": "array",
+          "minItems": 2,
+          "items": {
+            "$ref": "#/definitions/branch"
+          }
+        }
+      }
+    },
+    "selected_path": {
+      "type": "object",
+      "required": ["branch", "path_description"],
+      "properties": {
+        "branch": {
+          "type": "string",
+          "description": "ID of selected branch"
+        },
+        "sub_branch": {
+          "type": "string",
+          "description": "ID of selected sub-branch if any"
+        },
+        "path_description": {
+          "type": "string",
+          "minLength": 10,
+          "description": "Human-readable path description"
+        }
+      }
+    },
+    "rationale": {
+      "type": "string",
+      "minLength": 100,
+      "description": "Detailed explanation of why this path was selected"
+    },
+    "uncertainties": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Remaining uncertainties about the decision"
+    },
+    "confidence": {
+      "type": "string",
+      "enum": ["high", "medium", "low"],
+      "description": "Confidence level in the selected path"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["exploring", "complete", "needs_more_info"],
+      "description": "Current status of the exploration"
+    }
+  },
+  "definitions": {
+    "branch": {
+      "type": "object",
+      "required": ["id", "name", "description", "evaluation", "status"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Branch identifier (e.g., A, B, C)"
+        },
+        "name": {
+          "type": "string",
+          "description": "Short name for the approach"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of this reasoning path"
+        },
+        "evaluation": {
+          "type": "object",
+          "required": ["feasibility", "fit", "overall"],
+          "properties": {
+            "feasibility": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 10
+            },
+            "consequences": {
+              "type": "string"
+            },
+            "risks": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "fit": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 10
+            },
+            "overall": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 10
+            }
+          }
+        },
+        "sub_branches": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/sub_branch"
+          }
+        },
+        "status": {
+          "type": "string",
+          "enum": ["promising", "pruned", "exploring"]
+        },
+        "prune_reason": {
+          "type": "string",
+          "description": "Required if status is pruned"
+        }
+      }
+    },
+    "sub_branch": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "evaluation": {
+          "type": "object",
+          "properties": {
+            "feasibility": {
+              "type": "number"
+            },
+            "overall": {
+              "type": "number"
+            }
+          }
+        },
+        "outcome": {
+          "type": "string",
+          "description": "Expected outcome if this path is taken"
+        }
+      }
+    }
+  }
+}

package/templates/schemas/verification.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Verification",
+  "description": "Schema for multi-agent verification output",
+  "type": "object",
+  "required": ["verification_id", "pass", "reviewer", "issues", "summary", "recommendation"],
+  "properties": {
+    "verification_id": {
+      "type": "string",
+      "pattern": "^verify-[0-9]{3,}$",
+      "description": "Unique identifier for this verification"
+    },
+    "pass": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Which verification pass this is"
+    },
+    "total_passes": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Total number of verification passes"
+    },
+    "reviewer": {
+      "type": "string",
+      "description": "Identifier for the reviewer/agent"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "target": {
+      "type": "object",
+      "properties": {
+        "concept": {
+          "type": "string",
+          "enum": ["architecture", "implementation", "quality"]
+        },
+        "id": {
+          "type": "string"
+        }
+      }
+    },
+    "issues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "severity", "dimension", "title", "description", "evidence"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^V[0-9]{3}$"
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["critical", "major", "minor", "suggestion"]
+          },
+          "dimension": {
+            "type": "string",
+            "enum": ["requirements", "security", "performance", "maintainability", "integration", "correctness", "quality"],
+            "description": "Which review dimension this falls under"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 5
+          },
+          "description": {
+            "type": "string",
+            "minLength": 20
+          },
+          "evidence": {
+            "type": "string",
+            "minLength": 10,
+            "description": "Evidence from the artifact being reviewed"
+          },
+          "recommendation": {
+            "type": "string",
+            "description": "How to fix this issue"
+          },
+          "file": {
+            "type": "string",
+            "description": "File path if applicable"
+          },
+          "line": {
+            "type": "integer",
+            "description": "Line number if applicable"
+          }
+        }
+      }
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 20,
+      "description": "Overall summary of findings"
+    },
+    "recommendation": {
+      "type": "string",
+      "enum": ["block", "revise", "approve_with_notes", "approve"],
+      "description": "Overall recommendation"
+    },
+    "confidence": {
+      "type": "string",
+      "enum": ["high", "medium", "low"],
+      "description": "Confidence in this review"
+    }
+  }
+}