@dragonflymcp/plugin 1.0.0

package/templates/schemas/planning.schema.json

@@ -0,0 +1,243 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Planning",
+  "description": "Schema for Chain-of-Thought planning output",
+  "type": "object",
+  "required": [
+    "plan_id",
+    "objective",
+    "timestamp",
+    "step_1_decomposition",
+    "step_2_constraints",
+    "step_3_unknowns",
+    "step_4_options",
+    "step_5_evaluation",
+    "step_6_success_criteria",
+    "status"
+  ],
+  "properties": {
+    "plan_id": {
+      "type": "string",
+      "pattern": "^plan-[0-9]{3,}$",
+      "description": "Unique identifier for this plan"
+    },
+    "objective": {
+      "type": "string",
+      "minLength": 10,
+      "description": "What this plan is for"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "step_1_decomposition": {
+      "type": "object",
+      "required": ["main_problem", "sub_problems"],
+      "properties": {
+        "main_problem": {
+          "type": "string",
+          "minLength": 10
+        },
+        "sub_problems": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["name", "description"],
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string"
+              },
+              "dependencies": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "scope_boundary": {
+          "type": "string",
+          "description": "What is in and out of scope"
+        }
+      }
+    },
+    "step_2_constraints": {
+      "type": "object",
+      "properties": {
+        "technical": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "performance": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "cost": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "quality": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "business": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "step_3_unknowns": {
+      "type": "object",
+      "required": ["assumptions"],
+      "properties": {
+        "missing_information": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "assumptions": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          },
+          "description": "Explicit assumptions being made"
+        },
+        "risks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "clarifications_needed": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "step_4_options": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["name", "description", "trade_offs", "risk_level"],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "trade_offs": {
+            "type": "object",
+            "required": ["pros", "cons"],
+            "properties": {
+              "pros": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "string"
+                }
+              },
+              "cons": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "fit_with_constraints": {
+            "type": "string",
+            "enum": ["High", "Medium", "Low"]
+          },
+          "risk_level": {
+            "type": "string",
+            "enum": ["High", "Medium", "Low"]
+          }
+        }
+      }
+    },
+    "step_5_evaluation": {
+      "type": "object",
+      "required": ["recommendation", "rationale"],
+      "properties": {
+        "scoring": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object"
+          }
+        },
+        "recommendation": {
+          "type": "string",
+          "minLength": 3,
+          "description": "The recommended option"
+        },
+        "rationale": {
+          "type": "string",
+          "minLength": 50,
+          "description": "Why this option is recommended"
+        },
+        "would_change_if": {
+          "type": "string",
+          "description": "Conditions that would change the recommendation"
+        }
+      }
+    },
+    "step_6_success_criteria": {
+      "type": "object",
+      "required": ["acceptance_conditions"],
+      "properties": {
+        "metrics": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "acceptance_conditions": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "confidence": {
+      "type": "string",
+      "enum": ["high", "medium", "low"],
+      "description": "Confidence level in this plan"
+    },
+    "blockers": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Issues that must be resolved before proceeding"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "ready", "needs_clarification", "blocked"],
+      "description": "Current status of the plan"
+    }
+  }
+}

package/templates/schemas/provenance.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zen.dev/schemas/provenance.schema.json",
+  "title": "Zen Provenance Schema",
+  "description": "Schema for action provenance files in koan/provenance/actions/",
+  "type": "object",
+  "required": ["action_id", "concept", "action", "status", "timestamp"],
+  "properties": {
+    "action_id": {
+      "type": "string",
+      "pattern": "^act-[0-9]{3,}$",
+      "description": "Unique action identifier"
+    },
+    "concept": {
+      "type": "string",
+      "enum": ["story", "architecture", "implementation", "quality", "version", "context", "retrospective"],
+      "description": "Which concept performed this action"
+    },
+    "action": {
+      "type": "string",
+      "description": "The action performed (create, design, review, etc.)"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["started", "completed", "failed", "blocked"],
+      "description": "Outcome of the action"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the action occurred"
+    },
+    "model": {
+      "type": "string",
+      "enum": ["haiku", "sonnet", "opus"],
+      "description": "Which AI model was used"
+    },
+    "triggered_by": {
+      "type": ["string", "null"],
+      "description": "Parent action ID or null if user-initiated"
+    },
+    "flow_id": {
+      "type": "string",
+      "pattern": "^flow-",
+      "description": "Workflow this action belongs to"
+    },
+    "sync_rule_id": {
+      "type": ["string", "null"],
+      "description": "Sync rule that triggered this action"
+    },
+    "inputs": {
+      "type": "object",
+      "description": "Inputs provided to this action"
+    },
+    "outputs": {
+      "type": "object",
+      "description": "Outputs produced by this action",
+      "properties": {
+        "artifact_id": {
+          "type": "string",
+          "description": "ID of produced artifact (story, arch, impl, etc.)"
+        },
+        "artifact_type": {
+          "type": "string"
+        },
+        "artifact_path": {
+          "type": "string"
+        }
+      }
+    },
+    "cost": {
+      "type": "object",
+      "properties": {
+        "input_tokens": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "output_tokens": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "total_tokens": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "cost_usd": {
+          "type": "number",
+          "minimum": 0
+        }
+      }
+    },
+    "duration_ms": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "How long the action took"
+    },
+    "error": {
+      "type": ["object", "null"],
+      "properties": {
+        "type": { "type": "string" },
+        "message": { "type": "string" },
+        "recoverable": { "type": "boolean" }
+      },
+      "description": "Error details if action failed"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Additional metadata"
+    }
+  }
+}

package/templates/schemas/retrospective.schema.json

@@ -0,0 +1,174 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Retrospective",
+  "description": "Schema for retrospective analysis following the Reflexion pattern",
+  "type": "object",
+  "required": ["retro_id", "flow_id", "timestamp", "trigger", "failure_analysis", "learnings", "recommendations", "status"],
+  "properties": {
+    "retro_id": {
+      "type": "string",
+      "pattern": "^retro-[0-9]{3,}$",
+      "description": "Unique identifier for this retrospective"
+    },
+    "flow_id": {
+      "type": "string",
+      "pattern": "^flow-[0-9]{4}-[0-9]{2}-[0-9]{2}-[0-9]{2}h[0-9]{2}m[0-9]{2}s$",
+      "description": "ID of the flow that failed"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When this retrospective was created"
+    },
+    "trigger": {
+      "type": "object",
+      "required": ["concept", "action", "status"],
+      "properties": {
+        "concept": {
+          "type": "string",
+          "enum": ["story", "architecture", "implementation", "quality", "version"],
+          "description": "Which concept triggered the retrospective"
+        },
+        "action": {
+          "type": "string",
+          "description": "Which action failed"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["rejected", "failed", "blocked"],
+          "description": "The failure status that triggered analysis"
+        }
+      }
+    },
+    "failure_analysis": {
+      "type": "object",
+      "required": ["what_happened", "root_causes"],
+      "properties": {
+        "what_happened": {
+          "type": "string",
+          "minLength": 50,
+          "description": "Clear description of the failure"
+        },
+        "root_causes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["category", "description", "evidence"],
+            "properties": {
+              "category": {
+                "type": "string",
+                "enum": ["requirements", "architecture", "implementation", "process", "external"],
+                "description": "Category of the root cause"
+              },
+              "description": {
+                "type": "string",
+                "minLength": 20,
+                "description": "What the root cause is"
+              },
+              "evidence": {
+                "type": "string",
+                "minLength": 10,
+                "description": "Evidence supporting this root cause"
+              },
+              "why_chain": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "5 Whys analysis chain"
+              }
+            }
+          }
+        },
+        "contributing_factors": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Additional factors that contributed to failure"
+        }
+      }
+    },
+    "learnings": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "insight", "applies_to", "action"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^L[0-9]{3}$",
+            "description": "Unique learning identifier"
+          },
+          "insight": {
+            "type": "string",
+            "minLength": 20,
+            "description": "The actionable insight learned"
+          },
+          "applies_to": {
+            "type": "string",
+            "enum": ["story", "architecture", "implementation", "quality", "version", "workflow"],
+            "description": "Which concept this learning applies to"
+          },
+          "action": {
+            "type": "string",
+            "minLength": 10,
+            "description": "Concrete action to implement this learning"
+          },
+          "priority": {
+            "type": "string",
+            "enum": ["high", "medium", "low"],
+            "description": "Priority of implementing this learning"
+          }
+        }
+      }
+    },
+    "recommendations": {
+      "type": "object",
+      "required": ["immediate", "future"],
+      "properties": {
+        "immediate": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          },
+          "description": "Actions to take right now"
+        },
+        "future": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Changes to prevent recurrence"
+        }
+      }
+    },
+    "status": {
+      "type": "string",
+      "enum": ["analyzing", "analyzed", "applied"],
+      "description": "Current status of the retrospective"
+    },
+    "applied_learnings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "learning_id": {
+            "type": "string"
+          },
+          "applied_to": {
+            "type": "string"
+          },
+          "applied_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "description": "Track which learnings have been applied"
+    }
+  }
+}