cann-workbench 0.0.0-stage → 0.0.2-alpha

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

@@ -0,0 +1,971 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema": {
+      "type": "string",
+      "const": "cann.sidebar.selection/1"
+    },
+    "eventId": {
+      "type": "string",
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+    },
+    "taskId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "mainSessionId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "workspaceId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "taskUpdatedAt": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "reportDigest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "baselineDigest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "action": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "component.explain"
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "event": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "$ref": "#/$defs/__schema0"
+                  }
+                },
+                "selection": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "$ref": "#/$defs/__schema1"
+                  }
+                }
+              },
+              "required": [
+                "event",
+                "selection"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "type",
+            "data"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "workflow.explain"
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "node": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "title": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "en": {
+                              "type": "string"
+                            },
+                            "zh": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "en"
+                          ],
+                          "additionalProperties": {
+                            "type": "string"
+                          }
+                        }
+                      ]
+                    },
+                    "kind": {
+                      "type": "string",
+                      "enum": [
+                        "intent",
+                        "spec",
+                        "implement",
+                        "build",
+                        "test",
+                        "debug",
+                        "profile",
+                        "optimize",
+                        "review",
+                        "package",
+                        "custom"
+                      ]
+                    },
+                    "phase": {
+                      "type": "string",
+                      "enum": [
+                        "planning",
+                        "implementation",
+                        "validation",
+                        "tuning",
+                        "review",
+                        "delivery"
+                      ]
+                    },
+                    "description": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "en": {
+                              "type": "string"
+                            },
+                            "zh": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "en"
+                          ],
+                          "additionalProperties": {
+                            "type": "string"
+                          }
+                        }
+                      ]
+                    },
+                    "required": {
+                      "type": "boolean"
+                    },
+                    "retryable": {
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "title",
+                    "kind",
+                    "phase"
+                  ]
+                },
+                "result": {
+                  "type": "object",
+                  "properties": {
+                    "nodeId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 200
+                    },
+                    "state": {
+                      "type": "string",
+                      "enum": [
+                        "pending",
+                        "active",
+                        "completed",
+                        "failed",
+                        "skipped"
+                      ]
+                    },
+                    "summary": {
+                      "type": "string"
+                    },
+                    "structured": {
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {
+                        "$ref": "#/$defs/__schema2"
+                      }
+                    },
+                    "evidence": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "enteredAt": {
+                      "type": "string"
+                    },
+                    "settledAt": {
+                      "type": "string"
+                    },
+                    "attempt": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "nodeId",
+                    "state"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "node",
+                "result"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "type",
+            "data"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "metrics.explain"
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "reportId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "metric": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 200
+                    },
+                    "value": {
+                      "type": "number"
+                    },
+                    "unit": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "value",
+                    "unit"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "reportId",
+                "metric"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "type",
+            "data"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "timeline.measure"
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "reportId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "traceId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "clockId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "operation": {
+                  "type": "string",
+                  "const": "elapsed"
+                },
+                "elapsedUs": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "selection": {
+                  "minItems": 2,
+                  "maxItems": 2,
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "spanId": {
+                        "type": "string"
+                      },
+                      "boundary": {
+                        "type": "string",
+                        "enum": [
+                          "start",
+                          "end"
+                        ]
+                      },
+                      "timestampUs": {
+                        "type": "number",
+                        "minimum": 0
+                      }
+                    },
+                    "required": [
+                      "spanId",
+                      "boundary",
+                      "timestampUs"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "reportId",
+                "traceId",
+                "clockId",
+                "operation",
+                "elapsedUs",
+                "selection"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "type",
+            "data"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "checks.explain"
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "reportId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "findings": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "finding_id": {
+                        "type": "string"
+                      },
+                      "kind": {
+                        "type": "string",
+                        "enum": [
+                          "mem",
+                          "sync",
+                          "init",
+                          "race"
+                        ]
+                      },
+                      "severity": {
+                        "type": "string",
+                        "enum": [
+                          "error",
+                          "warning",
+                          "info"
+                        ]
+                      },
+                      "file": {
+                        "type": "string"
+                      },
+                      "line": {
+                        "type": "number",
+                        "minimum": 0
+                      },
+                      "message": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "open",
+                          "fixed-replay-pending"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "finding_id",
+                      "kind",
+                      "severity",
+                      "file",
+                      "line",
+                      "message",
+                      "status"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "reportId",
+                "findings"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "type",
+            "data"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "verdict.explain"
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "reportId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "verdict": {
+                  "type": "object",
+                  "properties": {
+                    "schema": {
+                      "type": "string",
+                      "const": "opstune.verdict/1.0"
+                    },
+                    "report_id": {
+                      "type": "string"
+                    },
+                    "soc": {
+                      "type": "string"
+                    },
+                    "verdict": {
+                      "type": "string",
+                      "enum": [
+                        "GOOD",
+                        "NEEDS_OPTIMIZATION",
+                        "NEAR_LIMIT",
+                        "NO_BOUND_FOUND",
+                        "INSUFFICIENT_DATA"
+                      ]
+                    },
+                    "headline": {
+                      "type": "string"
+                    },
+                    "recommended_next": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "findings": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "rule_id": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "severity": {
+                            "type": "string",
+                            "enum": [
+                              "critical",
+                              "moderate",
+                              "light"
+                            ]
+                          },
+                          "confidence": {
+                            "type": "string",
+                            "enum": [
+                              "HIGH",
+                              "MEDIUM",
+                              "LOW"
+                            ]
+                          },
+                          "evidence": {
+                            "type": "object",
+                            "propertyNames": {
+                              "type": "string"
+                            },
+                            "additionalProperties": {
+                              "type": "number"
+                            }
+                          },
+                          "counter_evidence": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "id": {
+                                  "type": "string"
+                                },
+                                "note": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "id",
+                                "note"
+                              ]
+                            }
+                          },
+                          "speedup_range": {
+                            "type": "string"
+                          },
+                          "mechanism_refs": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        },
+                        "required": [
+                          "rule_id",
+                          "name",
+                          "severity",
+                          "confidence",
+                          "evidence",
+                          "counter_evidence",
+                          "speedup_range",
+                          "mechanism_refs"
+                        ]
+                      }
+                    }
+                  },
+                  "required": [
+                    "schema",
+                    "report_id",
+                    "soc",
+                    "verdict",
+                    "headline",
+                    "recommended_next",
+                    "findings"
+                  ]
+                }
+              },
+              "required": [
+                "reportId",
+                "verdict"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "type",
+            "data"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "comparison.explain"
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "reportId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "baselineId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "current": {
+                  "type": "object",
+                  "properties": {
+                    "task_duration_us": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "mte2_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "mte3_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "cube_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "vec_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "scalar_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "fixpipe_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "l2_bw_pct_of_peak": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "pipe_trace": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pipe": {
+                            "type": "string"
+                          },
+                          "start_us": {
+                            "type": "number",
+                            "minimum": 0
+                          },
+                          "end_us": {
+                            "type": "number",
+                            "minimum": 0
+                          }
+                        },
+                        "required": [
+                          "pipe",
+                          "start_us",
+                          "end_us"
+                        ]
+                      }
+                    }
+                  },
+                  "required": [
+                    "task_duration_us",
+                    "mte2_ratio",
+                    "mte3_ratio",
+                    "cube_ratio",
+                    "vec_ratio",
+                    "scalar_ratio",
+                    "fixpipe_ratio",
+                    "l2_bw_pct_of_peak",
+                    "pipe_trace"
+                  ]
+                },
+                "baseline": {
+                  "type": "object",
+                  "properties": {
+                    "task_duration_us": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "mte2_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "mte3_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "cube_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "vec_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "scalar_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "fixpipe_ratio": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "l2_bw_pct_of_peak": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "pipe_trace": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pipe": {
+                            "type": "string"
+                          },
+                          "start_us": {
+                            "type": "number",
+                            "minimum": 0
+                          },
+                          "end_us": {
+                            "type": "number",
+                            "minimum": 0
+                          }
+                        },
+                        "required": [
+                          "pipe",
+                          "start_us",
+                          "end_us"
+                        ]
+                      }
+                    }
+                  },
+                  "required": [
+                    "task_duration_us",
+                    "mte2_ratio",
+                    "mte3_ratio",
+                    "cube_ratio",
+                    "vec_ratio",
+                    "scalar_ratio",
+                    "fixpipe_ratio",
+                    "l2_bw_pct_of_peak",
+                    "pipe_trace"
+                  ]
+                },
+                "measurement": {
+                  "type": "object",
+                  "properties": {
+                    "current": {
+                      "type": "object",
+                      "properties": {
+                        "source": {
+                          "type": "string",
+                          "enum": [
+                            "npu-compute",
+                            "simulator"
+                          ]
+                        },
+                        "set": {
+                          "type": "string"
+                        },
+                        "case_dir": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "source",
+                        "set",
+                        "case_dir"
+                      ]
+                    },
+                    "baseline": {
+                      "type": "object",
+                      "properties": {
+                        "source": {
+                          "type": "string",
+                          "enum": [
+                            "npu-compute",
+                            "simulator"
+                          ]
+                        },
+                        "set": {
+                          "type": "string"
+                        },
+                        "case_dir": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "source",
+                        "set",
+                        "case_dir"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "current",
+                    "baseline"
+                  ],
+                  "additionalProperties": false
+                },
+                "instruction": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "reportId",
+                "baselineId",
+                "current",
+                "baseline",
+                "measurement",
+                "instruction"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "type",
+            "data"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "required": [
+    "schema",
+    "eventId",
+    "taskId",
+    "mainSessionId",
+    "workspaceId",
+    "taskUpdatedAt",
+    "action"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "__schema0": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema0"
+          }
+        },
+        {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/__schema0"
+          }
+        }
+      ]
+    },
+    "__schema1": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema1"
+          }
+        },
+        {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/__schema1"
+          }
+        }
+      ]
+    },
+    "__schema2": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema2"
+          }
+        },
+        {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/__schema2"
+          }
+        }
+      ]
+    }
+  },
+  "title": "Model-facing sidebar selections; component events follow visuals/contracts.schema.json"
+}