cann-workbench 0.0.0-stage → 0.0.2-alpha

package/skills/task-agents/sidebar-contracts.schema.json

@@ -0,0 +1,4168 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:cann:sidebar:contracts:1",
+  "title": "CANN sidebar and interaction contracts (design draft; not wired into runtime)",
+  "oneOf": [
+    {
+      "$ref": "#/$defs/Snapshot"
+    },
+    {
+      "$ref": "#/$defs/Interaction"
+    }
+  ],
+  "$defs": {
+    "Evidence": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "kind": {
+          "enum": [
+            "source",
+            "spec",
+            "log",
+            "test",
+            "profile",
+            "report",
+            "diff"
+          ]
+        },
+        "digest": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "path",
+        "kind",
+        "digest"
+      ],
+      "additionalProperties": false
+    },
+    "Metric": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "unit": {
+          "enum": [
+            "us",
+            "ms",
+            "s",
+            "%",
+            "bytes",
+            "count",
+            "x",
+            "ratio"
+          ]
+        },
+        "direction": {
+          "enum": [
+            "lower",
+            "higher",
+            "contextual"
+          ]
+        },
+        "evidenceIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "id",
+        "value",
+        "unit",
+        "direction",
+        "evidenceIds"
+      ],
+      "additionalProperties": false
+    },
+    "Tensor": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "shape": {
+          "type": "array",
+          "items": {
+            "type": [
+              "integer",
+              "string"
+            ]
+          }
+        },
+        "dtype": {
+          "type": "string"
+        },
+        "layout": {
+          "type": "string"
+        },
+        "constraints": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "name",
+        "shape",
+        "dtype",
+        "layout",
+        "constraints"
+      ],
+      "additionalProperties": false
+    },
+    "TestResult": {
+      "type": "object",
+      "properties": {
+        "caseId": {
+          "type": "string"
+        },
+        "status": {
+          "enum": [
+            "passed",
+            "failed",
+            "not-run",
+            "skipped"
+          ]
+        },
+        "maxAbsError": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "maxRelError": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "evidenceIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "caseId",
+        "status",
+        "maxAbsError",
+        "maxRelError",
+        "evidenceIds"
+      ],
+      "additionalProperties": false
+    },
+    "Gate": {
+      "type": "object",
+      "properties": {
+        "gateId": {
+          "type": "string"
+        },
+        "result": {
+          "enum": [
+            "passed",
+            "failed",
+            "pending"
+          ]
+        },
+        "findings": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "evidenceIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "gateId",
+        "result",
+        "findings",
+        "evidenceIds"
+      ],
+      "additionalProperties": false
+    },
+    "StageState": {
+      "enum": [
+        "pending",
+        "active",
+        "completed",
+        "failed",
+        "skipped"
+      ]
+    },
+    "TaskStatus": {
+      "enum": [
+        "pending",
+        "running",
+        "blocked",
+        "completed",
+        "failed"
+      ]
+    },
+    "Summary": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "status": {
+          "$ref": "#/$defs/TaskStatus"
+        },
+        "currentNodeIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "blockedReason": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "title",
+        "status",
+        "currentNodeIds",
+        "blockedReason"
+      ],
+      "additionalProperties": false
+    },
+    "Requirements": {
+      "type": "object",
+      "properties": {
+        "operatorName": {
+          "type": "string"
+        },
+        "requirements": {
+          "type": "string"
+        },
+        "targetChip": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "developmentMode": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "skillId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "operatorName",
+        "requirements",
+        "targetChip",
+        "developmentMode",
+        "skillId"
+      ],
+      "additionalProperties": false
+    },
+    "Scope": {
+      "type": "object",
+      "properties": {
+        "goal": {
+          "type": "string"
+        },
+        "sourcePath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "casesPath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "targetChip": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "target": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "profileCommand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "goal",
+        "sourcePath",
+        "casesPath",
+        "targetChip",
+        "target",
+        "profileCommand"
+      ],
+      "additionalProperties": false
+    },
+    "Interface": {
+      "type": "object",
+      "properties": {
+        "inputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Tensor"
+          }
+        },
+        "outputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Tensor"
+          }
+        },
+        "scalarParameters": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "dtype": {
+                "type": "string"
+              },
+              "default": {
+                "type": [
+                  "string",
+                  "number",
+                  "boolean",
+                  "null"
+                ]
+              },
+              "constraints": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "name",
+              "dtype",
+              "default",
+              "constraints"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "shapePolicy": {
+          "type": "string"
+        },
+        "layout": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "inputs",
+        "outputs",
+        "scalarParameters",
+        "shapePolicy",
+        "layout"
+      ],
+      "additionalProperties": false
+    },
+    "Compilation": {
+      "type": "object",
+      "properties": {
+        "sourcePath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "entryFunction": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "targetChip": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "compilerOptions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "numStages": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 1
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "numWarps": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 1
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "autotune": {
+          "type": "boolean"
+        },
+        "autotuneKeys": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "launchGrid": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "sourcePath",
+        "entryFunction",
+        "targetChip",
+        "compilerOptions",
+        "numStages",
+        "numWarps",
+        "autotune",
+        "autotuneKeys",
+        "launchGrid"
+      ],
+      "additionalProperties": false
+    },
+    "Tiling": {
+      "type": "object",
+      "properties": {
+        "tilingStrategy": {
+          "type": "string"
+        },
+        "tilingDimensions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "axis": {
+                "type": "string"
+              },
+              "size": {
+                "type": [
+                  "integer",
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "axis",
+              "size"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "registerBudget": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "sharedMemoryBudget": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "reusePlan": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "tilingStrategy",
+        "tilingDimensions",
+        "registerBudget",
+        "sharedMemoryBudget",
+        "reusePlan"
+      ],
+      "additionalProperties": false
+    },
+    "Implementation": {
+      "type": "object",
+      "properties": {
+        "sourcePath": {
+          "type": "string"
+        },
+        "entryFunction": {
+          "type": "string"
+        },
+        "buildCommand": {
+          "type": "string"
+        },
+        "compilerOptions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "sourcePath",
+        "entryFunction",
+        "buildCommand",
+        "compilerOptions"
+      ],
+      "additionalProperties": false
+    },
+    "Validation": {
+      "type": "object",
+      "properties": {
+        "buildCommand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "testCommand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "accuracyThreshold": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "testCases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "results": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TestResult"
+          }
+        }
+      },
+      "required": [
+        "buildCommand",
+        "testCommand",
+        "accuracyThreshold",
+        "testCases",
+        "results"
+      ],
+      "additionalProperties": false
+    },
+    "PerformanceTarget": {
+      "type": "object",
+      "properties": {
+        "baselineMetric": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/Metric"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "targetMetric": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/Metric"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "profileCommand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "regressionPolicy": {
+          "enum": [
+            "block",
+            "warn"
+          ]
+        }
+      },
+      "required": [
+        "baselineMetric",
+        "targetMetric",
+        "profileCommand",
+        "regressionPolicy"
+      ],
+      "additionalProperties": false
+    },
+    "Artifacts": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Evidence"
+          }
+        }
+      },
+      "required": [
+        "items"
+      ],
+      "additionalProperties": false
+    },
+    "ReportHeader": {
+      "type": "object",
+      "properties": {
+        "reportId": {
+          "type": "string"
+        },
+        "caseName": {
+          "type": "string"
+        },
+        "source": {
+          "enum": [
+            "npu-compute",
+            "simulator"
+          ]
+        },
+        "set": {
+          "type": "string"
+        },
+        "collectedAt": {
+          "type": "string"
+        },
+        "baselineId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "measurementFingerprint": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "reportId",
+        "caseName",
+        "source",
+        "set",
+        "collectedAt",
+        "baselineId",
+        "measurementFingerprint"
+      ],
+      "additionalProperties": false
+    },
+    "Metrics": {
+      "type": "object",
+      "properties": {
+        "reportId": {
+          "type": "string"
+        },
+        "values": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Metric"
+          }
+        },
+        "baselineDurationUs": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "speedup": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "reportId",
+        "values",
+        "baselineDurationUs",
+        "speedup"
+      ],
+      "additionalProperties": false
+    },
+    "Span": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "lane": {
+          "type": "string"
+        },
+        "startUs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "endUs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "parentId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "label",
+        "lane",
+        "startUs",
+        "endUs",
+        "parentId"
+      ],
+      "additionalProperties": false
+    },
+    "Timeline": {
+      "type": "object",
+      "properties": {
+        "reportId": {
+          "type": "string"
+        },
+        "traceId": {
+          "type": "string"
+        },
+        "clockId": {
+          "type": "string"
+        },
+        "originUs": {
+          "type": "number"
+        },
+        "kind": {
+          "enum": [
+            "pipe-trace",
+            "flamegraph"
+          ]
+        },
+        "spans": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Span"
+          }
+        },
+        "baselineReportId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "reportId",
+        "traceId",
+        "clockId",
+        "originUs",
+        "kind",
+        "spans",
+        "baselineReportId"
+      ],
+      "additionalProperties": false
+    },
+    "CheckFinding": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "kind": {
+          "enum": [
+            "mem",
+            "sync",
+            "init",
+            "race"
+          ]
+        },
+        "severity": {
+          "enum": [
+            "error",
+            "warning",
+            "info"
+          ]
+        },
+        "file": {
+          "type": "string"
+        },
+        "line": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "message": {
+          "type": "string"
+        },
+        "status": {
+          "enum": [
+            "open",
+            "fixed-replay-pending"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "kind",
+        "severity",
+        "file",
+        "line",
+        "message",
+        "status"
+      ],
+      "additionalProperties": false
+    },
+    "Checks": {
+      "type": "object",
+      "properties": {
+        "reportId": {
+          "type": "string"
+        },
+        "passed": {
+          "type": "boolean"
+        },
+        "source": {
+          "type": "string"
+        },
+        "findings": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/CheckFinding"
+          }
+        }
+      },
+      "required": [
+        "reportId",
+        "passed",
+        "source",
+        "findings"
+      ],
+      "additionalProperties": false
+    },
+    "VerdictFinding": {
+      "type": "object",
+      "properties": {
+        "ruleId": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "severity": {
+          "enum": [
+            "critical",
+            "moderate",
+            "light"
+          ]
+        },
+        "confidence": {
+          "enum": [
+            "HIGH",
+            "MEDIUM",
+            "LOW"
+          ]
+        },
+        "evidenceIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "counterEvidence": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "note": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "note"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "speedupRange": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "mechanismRefs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "ruleId",
+        "name",
+        "severity",
+        "confidence",
+        "evidenceIds",
+        "counterEvidence",
+        "speedupRange",
+        "mechanismRefs"
+      ],
+      "additionalProperties": false
+    },
+    "Verdict": {
+      "type": "object",
+      "properties": {
+        "reportId": {
+          "type": "string"
+        },
+        "soc": {
+          "type": "string"
+        },
+        "verdict": {
+          "enum": [
+            "GOOD",
+            "NEEDS_OPTIMIZATION",
+            "NEAR_LIMIT",
+            "NO_BOUND_FOUND",
+            "INSUFFICIENT_DATA"
+          ]
+        },
+        "headline": {
+          "type": "string"
+        },
+        "findings": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/VerdictFinding"
+          }
+        },
+        "recommendedNext": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "reportId",
+        "soc",
+        "verdict",
+        "headline",
+        "findings",
+        "recommendedNext"
+      ],
+      "additionalProperties": false
+    },
+    "Comparison": {
+      "type": "object",
+      "properties": {
+        "baselineId": {
+          "type": "string"
+        },
+        "reportId": {
+          "type": "string"
+        },
+        "comparable": {
+          "type": "boolean"
+        },
+        "mismatchReasons": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "values": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "metricId": {
+                "type": "string"
+              },
+              "unit": {
+                "type": "string"
+              },
+              "baseline": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "current": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "delta": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "changePct": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "metricId",
+              "unit",
+              "baseline",
+              "current",
+              "delta",
+              "changePct"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "decision": {
+          "enum": [
+            "KEEP",
+            "REVERT",
+            "REPEAT",
+            "INCOMPARABLE",
+            "UNDECIDED"
+          ]
+        }
+      },
+      "required": [
+        "baselineId",
+        "reportId",
+        "comparable",
+        "mismatchReasons",
+        "values",
+        "decision"
+      ],
+      "additionalProperties": false
+    },
+    "EvidencePaths": {
+      "type": "object",
+      "properties": {
+        "scopePath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "manifestPath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "baselinePath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "verdictPath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "candidatePath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "diffAuditPath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "comparisonPath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "reportPath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "scopePath",
+        "manifestPath",
+        "baselinePath",
+        "verdictPath",
+        "candidatePath",
+        "diffAuditPath",
+        "comparisonPath",
+        "reportPath"
+      ],
+      "additionalProperties": false
+    },
+    "GenericOperatorStage": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "contract": {
+          "const": "operator.stage/1"
+        },
+        "state": {
+          "$ref": "#/$defs/StageState"
+        },
+        "summary": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Evidence"
+          }
+        },
+        "data": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "goal": {
+                  "type": "string"
+                },
+                "commands": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "results": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "openQuestions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "goal",
+                "commands",
+                "results",
+                "openQuestions"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "contract",
+        "state",
+        "summary",
+        "evidence",
+        "data"
+      ],
+      "additionalProperties": false
+    },
+    "Workflow": {
+      "type": "object",
+      "properties": {
+        "definitionId": {
+          "type": "string"
+        },
+        "definitionVersion": {
+          "type": "string"
+        },
+        "nodes": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "review-delivery"
+                  },
+                  "contract": {
+                    "const": "operator.review-delivery/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/operator.review-delivery"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "optimization"
+                  },
+                  "contract": {
+                    "const": "operator.optimization/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/operator.optimization"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "diagnosis"
+                  },
+                  "contract": {
+                    "const": "operator.diagnosis/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/operator.diagnosis"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "verification"
+                  },
+                  "contract": {
+                    "const": "operator.verification/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/operator.verification"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "implementation"
+                  },
+                  "contract": {
+                    "const": "operator.implementation/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/operator.implementation"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "technical-design"
+                  },
+                  "contract": {
+                    "const": "operator.technical-design/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/operator.technical-design"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "requirements-analysis"
+                  },
+                  "contract": {
+                    "const": "operator.requirements-analysis/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/operator.requirements-analysis"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "$ref": "#/$defs/GenericOperatorStage"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "baseline"
+                  },
+                  "contract": {
+                    "const": "perf.baseline/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/perf.baseline"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "analysis"
+                  },
+                  "contract": {
+                    "const": "perf.analysis/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/perf.analysis"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "experiment"
+                  },
+                  "contract": {
+                    "const": "perf.experiment/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/perf.experiment"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "const": "verification"
+                  },
+                  "contract": {
+                    "const": "perf.verification/1"
+                  },
+                  "state": {
+                    "$ref": "#/$defs/StageState"
+                  },
+                  "summary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "evidence": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/Evidence"
+                    }
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/$defs/perf.verification"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "contract",
+                  "state",
+                  "summary",
+                  "evidence",
+                  "data"
+                ],
+                "additionalProperties": false
+              }
+            ]
+          }
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "from": {
+                "type": "string"
+              },
+              "to": {
+                "type": "string"
+              },
+              "kind": {
+                "enum": [
+                  "sequential",
+                  "conditional",
+                  "feedback",
+                  "retry"
+                ]
+              },
+              "condition": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "from",
+              "to",
+              "kind",
+              "condition"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "definitionId",
+        "definitionVersion",
+        "nodes",
+        "edges"
+      ],
+      "additionalProperties": false
+    },
+    "Component": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "task.summary/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Summary"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "operator.requirements/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Requirements"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "operator.interface/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Interface"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "operator.compilation/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Compilation"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "operator.tiling/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Tiling"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "operator.implementation/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Implementation"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "operator.validation/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Validation"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "operator.performance-target/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/PerformanceTarget"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "task.artifacts/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Artifacts"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "task.workflow/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Workflow"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "performance.scope/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Scope"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "performance.header/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/ReportHeader"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "performance.metrics/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Metrics"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "performance.timeline/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Timeline"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "performance.checks/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Checks"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "performance.verdict/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Verdict"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "performance.comparison/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/Comparison"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "contract": {
+              "const": "performance.evidence/1"
+            },
+            "availability": {
+              "enum": [
+                "ready",
+                "empty",
+                "error"
+              ]
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/EvidencePaths"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "contract",
+            "availability",
+            "data",
+            "error"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "Snapshot": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "const": "cann.sidebar.snapshot/1"
+        },
+        "taskId": {
+          "type": "string"
+        },
+        "mainSessionId": {
+          "type": "string"
+        },
+        "workspaceId": {
+          "type": "string"
+        },
+        "definitionId": {
+          "type": "string"
+        },
+        "definitionVersion": {
+          "type": "string"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "updatedAt": {
+          "type": "string"
+        },
+        "components": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Component"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "taskId",
+        "mainSessionId",
+        "workspaceId",
+        "definitionId",
+        "definitionVersion",
+        "revision",
+        "updatedAt",
+        "components"
+      ],
+      "additionalProperties": false
+    },
+    "Interaction": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "const": "cann.sidebar.interaction/1"
+        },
+        "eventId": {
+          "type": "string"
+        },
+        "taskId": {
+          "type": "string"
+        },
+        "mainSessionId": {
+          "type": "string"
+        },
+        "workspaceId": {
+          "type": "string"
+        },
+        "componentId": {
+          "type": "string"
+        },
+        "snapshotRevision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "naturalLanguage": {
+          "type": "string"
+        },
+        "templateId": {
+          "type": "string"
+        },
+        "locale": {
+          "enum": [
+            "zh",
+            "en"
+          ]
+        },
+        "action": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "const": "timeline.measure"
+                },
+                "data": {
+                  "type": "object",
+                  "properties": {
+                    "reportId": {
+                      "type": "string"
+                    },
+                    "traceId": {
+                      "type": "string"
+                    },
+                    "clockId": {
+                      "type": "string"
+                    },
+                    "selection": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "spanId": {
+                            "type": "string"
+                          },
+                          "boundary": {
+                            "enum": [
+                              "start",
+                              "end"
+                            ]
+                          },
+                          "timestampUs": {
+                            "type": "number",
+                            "minimum": 0
+                          }
+                        },
+                        "required": [
+                          "spanId",
+                          "boundary",
+                          "timestampUs"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "minItems": 2,
+                      "maxItems": 2
+                    },
+                    "operation": {
+                      "enum": [
+                        "elapsed",
+                        "gap"
+                      ]
+                    },
+                    "elapsedUs": {
+                      "type": "number",
+                      "minimum": 0
+                    }
+                  },
+                  "required": [
+                    "reportId",
+                    "traceId",
+                    "clockId",
+                    "selection",
+                    "operation",
+                    "elapsedUs"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "type",
+                "data"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "const": "metrics.explain"
+                },
+                "data": {
+                  "type": "object",
+                  "properties": {
+                    "reportId": {
+                      "type": "string"
+                    },
+                    "metric": {
+                      "$ref": "#/$defs/Metric"
+                    }
+                  },
+                  "required": [
+                    "reportId",
+                    "metric"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "type",
+                "data"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "const": "comparison.explain"
+                },
+                "data": {
+                  "type": "object",
+                  "properties": {
+                    "baselineId": {
+                      "type": "string"
+                    },
+                    "reportId": {
+                      "type": "string"
+                    },
+                    "metricIds": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "baselineId",
+                    "reportId",
+                    "metricIds"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "type",
+                "data"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "const": "checks.explain"
+                },
+                "data": {
+                  "type": "object",
+                  "properties": {
+                    "reportId": {
+                      "type": "string"
+                    },
+                    "findingIds": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "reportId",
+                    "findingIds"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "type",
+                "data"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "const": "verdict.explain"
+                },
+                "data": {
+                  "type": "object",
+                  "properties": {
+                    "reportId": {
+                      "type": "string"
+                    },
+                    "ruleIds": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "reportId",
+                    "ruleIds"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "type",
+                "data"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "const": "workflow.explain"
+                },
+                "data": {
+                  "type": "object",
+                  "properties": {
+                    "nodeId": {
+                      "type": "string"
+                    },
+                    "evidenceIds": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "nodeId",
+                    "evidenceIds"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "type",
+                "data"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "const": "artifact.explain"
+                },
+                "data": {
+                  "type": "object",
+                  "properties": {
+                    "evidenceIds": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "evidenceIds"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "type",
+                "data"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        }
+      },
+      "required": [
+        "schema",
+        "eventId",
+        "taskId",
+        "mainSessionId",
+        "workspaceId",
+        "componentId",
+        "snapshotRevision",
+        "createdAt",
+        "naturalLanguage",
+        "templateId",
+        "locale",
+        "action"
+      ],
+      "additionalProperties": false
+    },
+    "operator.requirements-analysis": {
+      "type": "object",
+      "properties": {
+        "operatorName": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "mathDefinition": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "inputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Tensor"
+          }
+        },
+        "outputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Tensor"
+          }
+        },
+        "constraints": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "acceptanceCriteria": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "openQuestions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "operatorName",
+        "mathDefinition",
+        "inputs",
+        "outputs",
+        "constraints",
+        "acceptanceCriteria",
+        "openQuestions"
+      ],
+      "additionalProperties": false
+    },
+    "operator.technical-design": {
+      "type": "object",
+      "properties": {
+        "approach": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "implementationLanguage": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "apiRefs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tilingPlan": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "dataMovement": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "testPlan": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "risks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "approach",
+        "implementationLanguage",
+        "apiRefs",
+        "tilingPlan",
+        "dataMovement",
+        "testPlan",
+        "risks"
+      ],
+      "additionalProperties": false
+    },
+    "operator.implementation": {
+      "type": "object",
+      "properties": {
+        "files": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "entryFunction": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "buildCommand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "compilerOptions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "completedItems": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "remainingItems": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "files",
+        "entryFunction",
+        "buildCommand",
+        "compilerOptions",
+        "completedItems",
+        "remainingItems"
+      ],
+      "additionalProperties": false
+    },
+    "operator.verification": {
+      "type": "object",
+      "properties": {
+        "buildCommand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "testCommand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "exitCode": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "results": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TestResult"
+          }
+        },
+        "logEvidenceIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "buildCommand",
+        "testCommand",
+        "exitCode",
+        "results",
+        "logEvidenceIds"
+      ],
+      "additionalProperties": false
+    },
+    "operator.diagnosis": {
+      "type": "object",
+      "properties": {
+        "symptom": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "hypotheses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "rootCause": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "absTolerance": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "relTolerance": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "fixEvidenceIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "regressionResults": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TestResult"
+          }
+        }
+      },
+      "required": [
+        "symptom",
+        "hypotheses",
+        "rootCause",
+        "absTolerance",
+        "relTolerance",
+        "fixEvidenceIds",
+        "regressionResults"
+      ],
+      "additionalProperties": false
+    },
+    "operator.optimization": {
+      "type": "object",
+      "properties": {
+        "reportId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "baselineId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "measurementFingerprint": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "bottlenecks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "changes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "conclusions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "missingEvidence": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "reportId",
+        "baselineId",
+        "measurementFingerprint",
+        "bottlenecks",
+        "changes",
+        "conclusions",
+        "missingEvidence"
+      ],
+      "additionalProperties": false
+    },
+    "operator.review-delivery": {
+      "type": "object",
+      "properties": {
+        "deliveredItems": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "documents": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "validationEvidenceIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "limitations": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "remainingIssues": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "deliveredItems",
+        "documents",
+        "validationEvidenceIds",
+        "limitations",
+        "remainingIssues"
+      ],
+      "additionalProperties": false
+    },
+    "PerformanceAccuracyCheck": {
+      "type": "object",
+      "properties": {
+        "command": {
+          "type": "string"
+        },
+        "fullSuite": {
+          "type": "boolean"
+        },
+        "results": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TestResult"
+          }
+        },
+        "gate": {
+          "$ref": "#/$defs/Gate"
+        }
+      },
+      "required": [
+        "command",
+        "fullSuite",
+        "results",
+        "gate"
+      ],
+      "additionalProperties": false
+    },
+    "PerformanceAccuracyRecovery": {
+      "type": "object",
+      "properties": {
+        "failedCaseIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "rootCause": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "fixEvidenceIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "regressionResults": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TestResult"
+          }
+        },
+        "canResumeTuning": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "failedCaseIds",
+        "rootCause",
+        "fixEvidenceIds",
+        "regressionResults",
+        "canResumeTuning"
+      ],
+      "additionalProperties": false
+    },
+    "perf.baseline": {
+      "type": "object",
+      "properties": {
+        "goal": {
+          "type": "string"
+        },
+        "scopeEvidenceId": {
+          "type": "string"
+        },
+        "manifestEvidenceId": {
+          "type": "string"
+        },
+        "stopConditions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "measurementFingerprint": {
+          "type": "string"
+        },
+        "accuracy": {
+          "$ref": "#/$defs/PerformanceAccuracyCheck"
+        },
+        "recovery": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/PerformanceAccuracyRecovery"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "reportId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "baselineId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "immutableDigest": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "sampleCount": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 1
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "noisePct": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "iteration": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "expectedResult": {
+          "anyOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "text": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "source": {
+                  "const": "user"
+                }
+              },
+              "required": [
+                "text",
+                "source"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        }
+      },
+      "required": [
+        "goal",
+        "scopeEvidenceId",
+        "manifestEvidenceId",
+        "stopConditions",
+        "measurementFingerprint",
+        "accuracy",
+        "reportId",
+        "baselineId",
+        "immutableDigest",
+        "sampleCount",
+        "noisePct"
+      ],
+      "additionalProperties": false
+    },
+    "perf.analysis": {
+      "type": "object",
+      "properties": {
+        "verdictReportId": {
+          "type": "string"
+        },
+        "verdictEvidenceId": {
+          "type": "string"
+        },
+        "bottleneckRuleIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "missingEvidence": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "reproductionCommand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "hypotheses": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "cause": {
+                "type": "string"
+              },
+              "prediction": {
+                "type": "string"
+              },
+              "evidenceIds": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "state": {
+                "enum": [
+                  "untested",
+                  "supported",
+                  "rejected"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "cause",
+              "prediction",
+              "evidenceIds",
+              "state"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "candidates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "mechanismRef": {
+                "type": "string"
+              },
+              "hypothesis": {
+                "type": "string"
+              },
+              "preconditions": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "expectedMetricIds": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "rollbackPlan": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "mechanismRef",
+              "hypothesis",
+              "preconditions",
+              "expectedMetricIds",
+              "rollbackPlan"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "selectedCandidateId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "experimentPlan": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "iteration": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "required": [
+        "verdictReportId",
+        "verdictEvidenceId",
+        "bottleneckRuleIds",
+        "missingEvidence",
+        "candidates",
+        "selectedCandidateId"
+      ],
+      "additionalProperties": false
+    },
+    "perf.experiment": {
+      "type": "object",
+      "properties": {
+        "candidateId": {
+          "type": "string"
+        },
+        "mechanismRef": {
+          "type": "string"
+        },
+        "changedFiles": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "diffAuditEvidenceId": {
+          "type": "string"
+        },
+        "scopePassed": {
+          "type": "boolean"
+        },
+        "reviewGate": {
+          "$ref": "#/$defs/Gate"
+        },
+        "diffGate": {
+          "$ref": "#/$defs/Gate"
+        },
+        "accuracyGate": {
+          "$ref": "#/$defs/Gate"
+        },
+        "comparison": {
+          "$ref": "#/$defs/Comparison"
+        },
+        "noisePct": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "measurementFingerprint": {
+          "type": "string"
+        },
+        "precisionPassed": {
+          "type": "boolean"
+        },
+        "iteration": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "required": [
+        "candidateId",
+        "mechanismRef",
+        "changedFiles",
+        "diffAuditEvidenceId",
+        "scopePassed",
+        "reviewGate",
+        "diffGate",
+        "accuracyGate",
+        "comparison",
+        "noisePct",
+        "measurementFingerprint",
+        "precisionPassed"
+      ],
+      "additionalProperties": false
+    },
+    "perf.verification": {
+      "type": "object",
+      "properties": {
+        "comparison": {
+          "$ref": "#/$defs/Comparison"
+        },
+        "noisePct": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "measurementFingerprint": {
+          "type": "string"
+        },
+        "precisionPassed": {
+          "type": "boolean"
+        },
+        "reportEvidenceId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "decision": {
+          "enum": [
+            "KEEP",
+            "REVERT",
+            "REPEAT",
+            "INCOMPARABLE",
+            "UNDECIDED"
+          ]
+        },
+        "conclusions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "limitations": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "experienceRefs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "cleanupItems": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "iteration": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "required": [
+        "comparison",
+        "noisePct",
+        "measurementFingerprint",
+        "precisionPassed",
+        "reportEvidenceId",
+        "decision",
+        "conclusions",
+        "limitations",
+        "experienceRefs"
+      ],
+      "additionalProperties": false
+    }
+  }
+}