agentic-qe 3.7.8 → 3.7.10

package/.claude/skills/qe-quality-assessment/schemas/output.json

@@ -1,550 +1,550 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agentic-qe.dev/schemas/qe-quality-assessment-output.json",
-  "title": "AQE Quality Assessment Skill Output Schema",
-  "description": "Schema for quality assessment skill output validation. Includes quality gates, scores, trends, and risk assessment for deployment readiness.",
-  "type": "object",
-  "required": ["skillName", "version", "timestamp", "status", "trustTier", "output"],
-  "properties": {
-    "skillName": {
-      "type": "string",
-      "const": "qe-quality-assessment",
-      "description": "Must be 'qe-quality-assessment'"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9]+)?$",
-      "description": "Semantic version of the skill"
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp of output generation"
-    },
-    "status": {
-      "type": "string",
-      "enum": ["success", "partial", "failed", "skipped"],
-      "description": "Overall execution status"
-    },
-    "trustTier": {
-      "type": "integer",
-      "const": 3,
-      "description": "Trust tier 3 indicates full validation with eval suite"
-    },
-    "output": {
-      "type": "object",
-      "required": ["summary", "qualityGates", "scores"],
-      "properties": {
-        "summary": {
-          "type": "string",
-          "minLength": 50,
-          "maxLength": 2000,
-          "description": "Human-readable summary of quality assessment"
-        },
-        "qualityGates": {
-          "$ref": "#/$defs/qualityGates",
-          "description": "Quality gate evaluation results"
-        },
-        "scores": {
-          "$ref": "#/$defs/qualityScores",
-          "description": "Quality dimension scores"
-        },
-        "trends": {
-          "$ref": "#/$defs/qualityTrends",
-          "description": "Historical trends and comparison data"
-        },
-        "riskAssessment": {
-          "$ref": "#/$defs/riskAssessment",
-          "description": "Deployment risk assessment"
-        },
-        "recommendations": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/recommendation"
-          },
-          "maxItems": 50,
-          "description": "Prioritized quality improvement recommendations"
-        },
-        "metrics": {
-          "$ref": "#/$defs/qualityMetrics",
-          "description": "Detailed quality metrics"
-        },
-        "artifacts": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/artifact"
-          },
-          "maxItems": 20,
-          "description": "Generated quality reports and artifacts"
-        },
-        "deploymentReadiness": {
-          "$ref": "#/$defs/deploymentReadiness",
-          "description": "Deployment readiness evaluation"
-        }
-      }
-    },
-    "metadata": {
-      "$ref": "#/$defs/metadata"
-    },
-    "validation": {
-      "$ref": "#/$defs/validationResult"
-    },
-    "learning": {
-      "$ref": "#/$defs/learningData"
-    }
-  },
-  "$defs": {
-    "qualityGates": {
-      "type": "object",
-      "required": ["overallStatus", "gates"],
-      "properties": {
-        "overallStatus": {
-          "type": "string",
-          "enum": ["pass", "fail", "warn"],
-          "description": "Overall quality gate status"
-        },
-        "gates": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/qualityGate"
-          },
-          "minItems": 1,
-          "description": "Individual gate evaluations"
-        },
-        "blocking": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Names of gates that are blocking"
-        }
-      }
-    },
-    "qualityGate": {
-      "type": "object",
-      "required": ["name", "status", "value", "threshold"],
-      "properties": {
-        "name": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 100,
-          "description": "Gate name (e.g., coverage, complexity, vulnerabilities)"
-        },
-        "status": {
-          "type": "string",
-          "enum": ["pass", "fail", "warn", "skip"],
-          "description": "Gate status"
-        },
-        "value": {
-          "type": "number",
-          "description": "Actual measured value"
-        },
-        "threshold": {
-          "type": "number",
-          "description": "Threshold for pass/fail"
-        },
-        "operator": {
-          "type": "string",
-          "enum": [">=", "<=", ">", "<", "=="],
-          "default": ">=",
-          "description": "Comparison operator"
-        },
-        "blocking": {
-          "type": "boolean",
-          "default": false,
-          "description": "Whether this gate blocks deployment"
-        },
-        "description": {
-          "type": "string",
-          "description": "Gate description"
-        }
-      }
-    },
-    "qualityScores": {
-      "type": "object",
-      "required": ["overall"],
-      "properties": {
-        "overall": {
-          "$ref": "#/$defs/scoreValue",
-          "description": "Overall quality score"
-        },
-        "testCoverage": {
-          "$ref": "#/$defs/scoreValue",
-          "description": "Test coverage score"
-        },
-        "codeQuality": {
-          "$ref": "#/$defs/scoreValue",
-          "description": "Code quality score"
-        },
-        "security": {
-          "$ref": "#/$defs/scoreValue",
-          "description": "Security score"
-        },
-        "reliability": {
-          "$ref": "#/$defs/scoreValue",
-          "description": "Reliability score"
-        },
-        "maintainability": {
-          "$ref": "#/$defs/scoreValue",
-          "description": "Maintainability score"
-        },
-        "documentation": {
-          "$ref": "#/$defs/scoreValue",
-          "description": "Documentation score"
-        },
-        "performance": {
-          "$ref": "#/$defs/scoreValue",
-          "description": "Performance score"
-        }
-      }
-    },
-    "scoreValue": {
-      "type": "object",
-      "required": ["value", "max"],
-      "properties": {
-        "value": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 100,
-          "description": "Score value (0-100)"
-        },
-        "max": {
-          "type": "number",
-          "const": 100
-        },
-        "grade": {
-          "type": "string",
-          "pattern": "^[A-F][+-]?$",
-          "description": "Letter grade"
-        },
-        "weight": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Weight in overall score"
-        }
-      }
-    },
-    "qualityTrends": {
-      "type": "object",
-      "properties": {
-        "direction": {
-          "type": "string",
-          "enum": ["improving", "stable", "declining", "unknown"],
-          "description": "Overall trend direction"
-        },
-        "comparison": {
-          "type": "object",
-          "properties": {
-            "previousScore": {
-              "type": "number",
-              "minimum": 0,
-              "maximum": 100
-            },
-            "currentScore": {
-              "type": "number",
-              "minimum": 0,
-              "maximum": 100
-            },
-            "delta": {
-              "type": "number",
-              "description": "Score change"
-            },
-            "period": {
-              "type": "string",
-              "description": "Comparison period"
-            }
-          }
-        },
-        "history": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "timestamp": {
-                "type": "string",
-                "format": "date-time"
-              },
-              "score": {
-                "type": "number",
-                "minimum": 0,
-                "maximum": 100
-              }
-            }
-          },
-          "maxItems": 30,
-          "description": "Historical scores"
-        },
-        "alerts": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Trend-related alerts"
-        }
-      }
-    },
-    "riskAssessment": {
-      "type": "object",
-      "required": ["level"],
-      "properties": {
-        "level": {
-          "type": "string",
-          "enum": ["critical", "high", "medium", "low", "minimal"],
-          "description": "Overall risk level"
-        },
-        "score": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 100,
-          "description": "Risk score (0=minimal, 100=critical)"
-        },
-        "factors": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/riskFactor"
-          },
-          "description": "Risk factors identified"
-        },
-        "mitigations": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Recommended risk mitigations"
-        }
-      }
-    },
-    "riskFactor": {
-      "type": "object",
-      "required": ["name", "severity"],
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Risk factor name"
-        },
-        "severity": {
-          "type": "string",
-          "enum": ["critical", "high", "medium", "low"],
-          "description": "Severity level"
-        },
-        "description": {
-          "type": "string",
-          "description": "Risk description"
-        },
-        "impact": {
-          "type": "string",
-          "description": "Potential impact"
-        }
-      }
-    },
-    "recommendation": {
-      "type": "object",
-      "required": ["id", "title", "priority"],
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^REC-\\d{3,6}$",
-          "description": "Recommendation ID"
-        },
-        "title": {
-          "type": "string",
-          "minLength": 10,
-          "maxLength": 200
-        },
-        "description": {
-          "type": "string",
-          "maxLength": 2000
-        },
-        "priority": {
-          "type": "string",
-          "enum": ["critical", "high", "medium", "low"]
-        },
-        "effort": {
-          "type": "string",
-          "enum": ["trivial", "low", "medium", "high", "major"]
-        },
-        "impact": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 10,
-          "description": "Expected quality impact (1-10)"
-        },
-        "category": {
-          "type": "string",
-          "description": "Quality dimension affected"
-        }
-      }
-    },
-    "qualityMetrics": {
-      "type": "object",
-      "properties": {
-        "coverage": {
-          "type": "object",
-          "properties": {
-            "statement": { "type": "number", "minimum": 0, "maximum": 100 },
-            "branch": { "type": "number", "minimum": 0, "maximum": 100 },
-            "function": { "type": "number", "minimum": 0, "maximum": 100 },
-            "line": { "type": "number", "minimum": 0, "maximum": 100 }
-          }
-        },
-        "complexity": {
-          "type": "object",
-          "properties": {
-            "cyclomaticAvg": { "type": "number", "minimum": 0 },
-            "cyclomaticMax": { "type": "number", "minimum": 0 },
-            "cognitiveAvg": { "type": "number", "minimum": 0 },
-            "cognitiveMax": { "type": "number", "minimum": 0 }
-          }
-        },
-        "maintainability": {
-          "type": "object",
-          "properties": {
-            "index": { "type": "number", "minimum": 0, "maximum": 100 },
-            "duplication": { "type": "number", "minimum": 0, "maximum": 100 },
-            "techDebtRatio": { "type": "number", "minimum": 0 }
-          }
-        },
-        "issues": {
-          "type": "object",
-          "properties": {
-            "bugs": { "type": "integer", "minimum": 0 },
-            "vulnerabilities": { "type": "integer", "minimum": 0 },
-            "codeSmells": { "type": "integer", "minimum": 0 },
-            "securityHotspots": { "type": "integer", "minimum": 0 }
-          }
-        },
-        "filesAnalyzed": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "linesOfCode": {
-          "type": "integer",
-          "minimum": 0
-        }
-      }
-    },
-    "deploymentReadiness": {
-      "type": "object",
-      "required": ["status", "recommendation"],
-      "properties": {
-        "status": {
-          "type": "string",
-          "enum": ["go", "conditional", "no-go"],
-          "description": "Deployment recommendation"
-        },
-        "recommendation": {
-          "type": "string",
-          "description": "Deployment recommendation details"
-        },
-        "criteria": {
-          "type": "object",
-          "properties": {
-            "testsPass": { "type": "boolean" },
-            "coverageMet": { "type": "boolean" },
-            "noVulnerabilities": { "type": "boolean" },
-            "performanceOk": { "type": "boolean" },
-            "documentationComplete": { "type": "boolean" }
-          }
-        },
-        "blockers": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Blocking issues"
-        }
-      }
-    },
-    "artifact": {
-      "type": "object",
-      "required": ["type", "path"],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": ["report", "dashboard", "data", "log"]
-        },
-        "path": {
-          "type": "string",
-          "maxLength": 500
-        },
-        "format": {
-          "type": "string",
-          "enum": ["json", "html", "md", "txt", "csv"]
-        },
-        "description": {
-          "type": "string",
-          "maxLength": 500
-        }
-      }
-    },
-    "metadata": {
-      "type": "object",
-      "properties": {
-        "executionTimeMs": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "toolsUsed": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "agentId": {
-          "type": "string",
-          "pattern": "^qe-[a-z][a-z0-9-]*$"
-        },
-        "targetPath": {
-          "type": "string"
-        },
-        "environment": {
-          "type": "string",
-          "enum": ["development", "staging", "production", "ci"]
-        }
-      }
-    },
-    "validationResult": {
-      "type": "object",
-      "properties": {
-        "schemaValid": { "type": "boolean" },
-        "contentValid": { "type": "boolean" },
-        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
-        "warnings": {
-          "type": "array",
-          "items": { "type": "string" },
-          "maxItems": 20
-        },
-        "errors": {
-          "type": "array",
-          "items": { "type": "string" },
-          "maxItems": 20
-        }
-      }
-    },
-    "learningData": {
-      "type": "object",
-      "properties": {
-        "patternsDetected": {
-          "type": "array",
-          "items": { "type": "string" },
-          "maxItems": 20
-        },
-        "reward": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        },
-        "qualityPatterns": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "pattern": { "type": "string" },
-              "frequency": { "type": "integer" },
-              "impact": { "type": "string" }
-            }
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentic-qe.dev/schemas/qe-quality-assessment-output.json",
+  "title": "AQE Quality Assessment Skill Output Schema",
+  "description": "Schema for quality assessment skill output validation. Includes quality gates, scores, trends, and risk assessment for deployment readiness.",
+  "type": "object",
+  "required": ["skillName", "version", "timestamp", "status", "trustTier", "output"],
+  "properties": {
+    "skillName": {
+      "type": "string",
+      "const": "qe-quality-assessment",
+      "description": "Must be 'qe-quality-assessment'"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9]+)?$",
+      "description": "Semantic version of the skill"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of output generation"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["success", "partial", "failed", "skipped"],
+      "description": "Overall execution status"
+    },
+    "trustTier": {
+      "type": "integer",
+      "const": 3,
+      "description": "Trust tier 3 indicates full validation with eval suite"
+    },
+    "output": {
+      "type": "object",
+      "required": ["summary", "qualityGates", "scores"],
+      "properties": {
+        "summary": {
+          "type": "string",
+          "minLength": 50,
+          "maxLength": 2000,
+          "description": "Human-readable summary of quality assessment"
+        },
+        "qualityGates": {
+          "$ref": "#/$defs/qualityGates",
+          "description": "Quality gate evaluation results"
+        },
+        "scores": {
+          "$ref": "#/$defs/qualityScores",
+          "description": "Quality dimension scores"
+        },
+        "trends": {
+          "$ref": "#/$defs/qualityTrends",
+          "description": "Historical trends and comparison data"
+        },
+        "riskAssessment": {
+          "$ref": "#/$defs/riskAssessment",
+          "description": "Deployment risk assessment"
+        },
+        "recommendations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/recommendation"
+          },
+          "maxItems": 50,
+          "description": "Prioritized quality improvement recommendations"
+        },
+        "metrics": {
+          "$ref": "#/$defs/qualityMetrics",
+          "description": "Detailed quality metrics"
+        },
+        "artifacts": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/artifact"
+          },
+          "maxItems": 20,
+          "description": "Generated quality reports and artifacts"
+        },
+        "deploymentReadiness": {
+          "$ref": "#/$defs/deploymentReadiness",
+          "description": "Deployment readiness evaluation"
+        }
+      }
+    },
+    "metadata": {
+      "$ref": "#/$defs/metadata"
+    },
+    "validation": {
+      "$ref": "#/$defs/validationResult"
+    },
+    "learning": {
+      "$ref": "#/$defs/learningData"
+    }
+  },
+  "$defs": {
+    "qualityGates": {
+      "type": "object",
+      "required": ["overallStatus", "gates"],
+      "properties": {
+        "overallStatus": {
+          "type": "string",
+          "enum": ["pass", "fail", "warn"],
+          "description": "Overall quality gate status"
+        },
+        "gates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/qualityGate"
+          },
+          "minItems": 1,
+          "description": "Individual gate evaluations"
+        },
+        "blocking": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Names of gates that are blocking"
+        }
+      }
+    },
+    "qualityGate": {
+      "type": "object",
+      "required": ["name", "status", "value", "threshold"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "description": "Gate name (e.g., coverage, complexity, vulnerabilities)"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pass", "fail", "warn", "skip"],
+          "description": "Gate status"
+        },
+        "value": {
+          "type": "number",
+          "description": "Actual measured value"
+        },
+        "threshold": {
+          "type": "number",
+          "description": "Threshold for pass/fail"
+        },
+        "operator": {
+          "type": "string",
+          "enum": [">=", "<=", ">", "<", "=="],
+          "default": ">=",
+          "description": "Comparison operator"
+        },
+        "blocking": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this gate blocks deployment"
+        },
+        "description": {
+          "type": "string",
+          "description": "Gate description"
+        }
+      }
+    },
+    "qualityScores": {
+      "type": "object",
+      "required": ["overall"],
+      "properties": {
+        "overall": {
+          "$ref": "#/$defs/scoreValue",
+          "description": "Overall quality score"
+        },
+        "testCoverage": {
+          "$ref": "#/$defs/scoreValue",
+          "description": "Test coverage score"
+        },
+        "codeQuality": {
+          "$ref": "#/$defs/scoreValue",
+          "description": "Code quality score"
+        },
+        "security": {
+          "$ref": "#/$defs/scoreValue",
+          "description": "Security score"
+        },
+        "reliability": {
+          "$ref": "#/$defs/scoreValue",
+          "description": "Reliability score"
+        },
+        "maintainability": {
+          "$ref": "#/$defs/scoreValue",
+          "description": "Maintainability score"
+        },
+        "documentation": {
+          "$ref": "#/$defs/scoreValue",
+          "description": "Documentation score"
+        },
+        "performance": {
+          "$ref": "#/$defs/scoreValue",
+          "description": "Performance score"
+        }
+      }
+    },
+    "scoreValue": {
+      "type": "object",
+      "required": ["value", "max"],
+      "properties": {
+        "value": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Score value (0-100)"
+        },
+        "max": {
+          "type": "number",
+          "const": 100
+        },
+        "grade": {
+          "type": "string",
+          "pattern": "^[A-F][+-]?$",
+          "description": "Letter grade"
+        },
+        "weight": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Weight in overall score"
+        }
+      }
+    },
+    "qualityTrends": {
+      "type": "object",
+      "properties": {
+        "direction": {
+          "type": "string",
+          "enum": ["improving", "stable", "declining", "unknown"],
+          "description": "Overall trend direction"
+        },
+        "comparison": {
+          "type": "object",
+          "properties": {
+            "previousScore": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "currentScore": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "delta": {
+              "type": "number",
+              "description": "Score change"
+            },
+            "period": {
+              "type": "string",
+              "description": "Comparison period"
+            }
+          }
+        },
+        "history": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "timestamp": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "score": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              }
+            }
+          },
+          "maxItems": 30,
+          "description": "Historical scores"
+        },
+        "alerts": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Trend-related alerts"
+        }
+      }
+    },
+    "riskAssessment": {
+      "type": "object",
+      "required": ["level"],
+      "properties": {
+        "level": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low", "minimal"],
+          "description": "Overall risk level"
+        },
+        "score": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Risk score (0=minimal, 100=critical)"
+        },
+        "factors": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/riskFactor"
+          },
+          "description": "Risk factors identified"
+        },
+        "mitigations": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Recommended risk mitigations"
+        }
+      }
+    },
+    "riskFactor": {
+      "type": "object",
+      "required": ["name", "severity"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Risk factor name"
+        },
+        "severity": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low"],
+          "description": "Severity level"
+        },
+        "description": {
+          "type": "string",
+          "description": "Risk description"
+        },
+        "impact": {
+          "type": "string",
+          "description": "Potential impact"
+        }
+      }
+    },
+    "recommendation": {
+      "type": "object",
+      "required": ["id", "title", "priority"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^REC-\\d{3,6}$",
+          "description": "Recommendation ID"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 10,
+          "maxLength": 200
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 2000
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low"]
+        },
+        "effort": {
+          "type": "string",
+          "enum": ["trivial", "low", "medium", "high", "major"]
+        },
+        "impact": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "description": "Expected quality impact (1-10)"
+        },
+        "category": {
+          "type": "string",
+          "description": "Quality dimension affected"
+        }
+      }
+    },
+    "qualityMetrics": {
+      "type": "object",
+      "properties": {
+        "coverage": {
+          "type": "object",
+          "properties": {
+            "statement": { "type": "number", "minimum": 0, "maximum": 100 },
+            "branch": { "type": "number", "minimum": 0, "maximum": 100 },
+            "function": { "type": "number", "minimum": 0, "maximum": 100 },
+            "line": { "type": "number", "minimum": 0, "maximum": 100 }
+          }
+        },
+        "complexity": {
+          "type": "object",
+          "properties": {
+            "cyclomaticAvg": { "type": "number", "minimum": 0 },
+            "cyclomaticMax": { "type": "number", "minimum": 0 },
+            "cognitiveAvg": { "type": "number", "minimum": 0 },
+            "cognitiveMax": { "type": "number", "minimum": 0 }
+          }
+        },
+        "maintainability": {
+          "type": "object",
+          "properties": {
+            "index": { "type": "number", "minimum": 0, "maximum": 100 },
+            "duplication": { "type": "number", "minimum": 0, "maximum": 100 },
+            "techDebtRatio": { "type": "number", "minimum": 0 }
+          }
+        },
+        "issues": {
+          "type": "object",
+          "properties": {
+            "bugs": { "type": "integer", "minimum": 0 },
+            "vulnerabilities": { "type": "integer", "minimum": 0 },
+            "codeSmells": { "type": "integer", "minimum": 0 },
+            "securityHotspots": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "filesAnalyzed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "linesOfCode": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "deploymentReadiness": {
+      "type": "object",
+      "required": ["status", "recommendation"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["go", "conditional", "no-go"],
+          "description": "Deployment recommendation"
+        },
+        "recommendation": {
+          "type": "string",
+          "description": "Deployment recommendation details"
+        },
+        "criteria": {
+          "type": "object",
+          "properties": {
+            "testsPass": { "type": "boolean" },
+            "coverageMet": { "type": "boolean" },
+            "noVulnerabilities": { "type": "boolean" },
+            "performanceOk": { "type": "boolean" },
+            "documentationComplete": { "type": "boolean" }
+          }
+        },
+        "blockers": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Blocking issues"
+        }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "required": ["type", "path"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["report", "dashboard", "data", "log"]
+        },
+        "path": {
+          "type": "string",
+          "maxLength": 500
+        },
+        "format": {
+          "type": "string",
+          "enum": ["json", "html", "md", "txt", "csv"]
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 500
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "executionTimeMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "toolsUsed": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "agentId": {
+          "type": "string",
+          "pattern": "^qe-[a-z][a-z0-9-]*$"
+        },
+        "targetPath": {
+          "type": "string"
+        },
+        "environment": {
+          "type": "string",
+          "enum": ["development", "staging", "production", "ci"]
+        }
+      }
+    },
+    "validationResult": {
+      "type": "object",
+      "properties": {
+        "schemaValid": { "type": "boolean" },
+        "contentValid": { "type": "boolean" },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "warnings": {
+          "type": "array",
+          "items": { "type": "string" },
+          "maxItems": 20
+        },
+        "errors": {
+          "type": "array",
+          "items": { "type": "string" },
+          "maxItems": 20
+        }
+      }
+    },
+    "learningData": {
+      "type": "object",
+      "properties": {
+        "patternsDetected": {
+          "type": "array",
+          "items": { "type": "string" },
+          "maxItems": 20
+        },
+        "reward": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "qualityPatterns": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "pattern": { "type": "string" },
+              "frequency": { "type": "integer" },
+              "impact": { "type": "string" }
+            }
+          }
+        }
+      }
+    }
+  }
+}