glasspane-mcp 0.1.0

package/schemas/schemas/evidence-pack.schema.json

@@ -0,0 +1,359 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.iterate.dev/evidence-pack-0.1.json",
+  "title": "EvidencePack",
+  "description": "GlassPane P0 evidence package (schema v0.1-draft). C35 dual-language contract: this JSON Schema is the single source of truth; Swift Codable and TS zod bindings must stay in sync via the shared truth fixtures.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "operationId",
+    "createdAt",
+    "attribution",
+    "circuitBreaker",
+    "signals"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "glasspane.evidence/0.1"
+    },
+    "operationId": {
+      "type": "string",
+      "pattern": "^op_[0-9A-HJKMNP-TV-Z]{26}$"
+    },
+    "createdAt": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
+    },
+    "attribution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["level", "contaminated"],
+      "properties": {
+        "level": {
+          "enum": ["soft", "strong", "weak"]
+        },
+        "contaminated": {
+          "type": "boolean"
+        }
+      }
+    },
+    "circuitBreaker": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["level"],
+      "properties": {
+        "level": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 3
+        },
+        "reason": {
+          "type": "string"
+        }
+      }
+    },
+    "signals": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["act", "handlerProbe", "stateDiff"],
+      "properties": {
+        "act": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["selector", "action", "actConfirmed"],
+          "properties": {
+            "selector": {
+              "$ref": "#/$defs/selector"
+            },
+            "action": {
+              "enum": [
+                "press",
+                "increment",
+                "decrement",
+                "showMenu",
+                "confirm",
+                "cancel",
+                "pick"
+              ]
+            },
+            "actConfirmed": {
+              "type": "boolean"
+            }
+          }
+        },
+        "axEvent": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "treeDigestBefore",
+            "treeDigestAfter",
+            "nodeCount",
+            "axChanged",
+            "latencyMs"
+          ],
+          "properties": {
+            "treeDigestBefore": {
+              "$ref": "#/$defs/treeDigest"
+            },
+            "treeDigestAfter": {
+              "$ref": "#/$defs/treeDigest"
+            },
+            "nodeCount": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "axChanged": {
+              "type": "boolean"
+            },
+            "latencyMs": {
+              "type": "number",
+              "minimum": 0
+            }
+          }
+        },
+        "handlerProbe": {
+          "oneOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/handlerProbeSignal" }
+          ]
+        },
+        "stateDiff": {
+          "oneOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/stateDiffSignal" }
+          ]
+        },
+        "pixelDiff": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["changedPixelRatio", "bounds", "windowId"],
+          "properties": {
+            "changedPixelRatio": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "bounds": {
+              "oneOf": [
+                { "$ref": "#/$defs/bounds" },
+                { "type": "null" }
+              ]
+            },
+            "windowId": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "responsiveness": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["responsive", "pingMs"],
+          "properties": {
+            "responsive": {
+              "type": "boolean"
+            },
+            "pingMs": {
+              "type": "number",
+              "minimum": 0
+            }
+          }
+        },
+        "crash": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["processAliveBefore", "processAliveAfter"],
+          "properties": {
+            "processAliveBefore": {
+              "type": "boolean"
+            },
+            "processAliveAfter": {
+              "type": "boolean"
+            }
+          }
+        }
+      }
+    },
+    "assertion": {
+      "oneOf": [
+        { "$ref": "#/$defs/assertion" },
+        { "type": "null" }
+      ]
+    },
+    "diagnosis": {
+      "oneOf": [
+        { "$ref": "#/$defs/diagnosis" },
+        { "type": "null" }
+      ]
+    }
+  },
+  "$defs": {
+    "selector": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["role"],
+      "properties": {
+        "role": {
+          "type": "string",
+          "maxLength": 512
+        },
+        "title": {
+          "type": "string",
+          "maxLength": 512
+        },
+        "identifier": {
+          "type": "string",
+          "maxLength": 512
+        }
+      }
+    },
+    "treeDigest": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{32}$"
+    },
+    "handlerProbeSignal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["probeVersion", "hitCount", "handlers", "lateCount"],
+      "properties": {
+        "probeVersion": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "hitCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "handlers": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["file", "line"],
+            "properties": {
+              "file": { "type": "string", "minLength": 1, "maxLength": 512 },
+              "line": { "type": "integer", "minimum": 0 }
+            }
+          }
+        },
+        "lateCount": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "stateDiffSignal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "changed", "entries"],
+      "properties": {
+        "source": {
+          "enum": ["z1-macro", "z2-mirror", "z3-kvc"]
+        },
+        "changed": {
+          "type": "boolean"
+        },
+        "entries": {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["key", "before", "after"],
+            "properties": {
+              "key": { "type": "string", "minLength": 1, "maxLength": 512 },
+              "before": { "type": "string", "maxLength": 1024 },
+              "after": { "type": "string", "maxLength": 1024 }
+            }
+          }
+        }
+      }
+    },
+    "bounds": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["x", "y", "width", "height"],
+      "properties": {
+        "x": { "type": "number" },
+        "y": { "type": "number" },
+        "width": { "type": "number" },
+        "height": { "type": "number" }
+      }
+    },
+    "assertion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "selector",
+        "property",
+        "expected",
+        "actual",
+        "passed"
+      ],
+      "properties": {
+        "kind": {
+          "const": "element_property"
+        },
+        "selector": {
+          "$ref": "#/$defs/selector"
+        },
+        "property": {
+          "enum": ["title", "value", "role", "enabled", "focused"]
+        },
+        "expected": {
+          "anyOf": [
+            { "type": "string" },
+            { "type": "boolean" }
+          ]
+        },
+        "actual": {
+          "anyOf": [
+            { "type": "string" },
+            { "type": "boolean" }
+          ]
+        },
+        "passed": {
+          "type": "boolean"
+        }
+      }
+    },
+    "diagnosis": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["class", "report"],
+      "properties": {
+        "class": {
+          "enum": [
+            "T0",
+            "T1",
+            "T2",
+            "T3",
+            "T4",
+            "T5",
+            "T6",
+            "T7",
+            "T8",
+            "T9",
+            "NO_ANOMALY",
+            "INCONCLUSIVE"
+          ]
+        },
+        "report": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "anomaly", "evidence", "next"],
+          "properties": {
+            "path": { "type": "string" },
+            "anomaly": { "type": "string" },
+            "evidence": { "type": "string" },
+            "next": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/schemas/recipe-config.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.iterate.dev/recipe-config-0.1-draft.json",
+  "title": "RecipeConfig",
+  "description": "Recipe configuration contract (P0 landing of the shared recipe validator, R35). A recipe is a named ordered sequence of engine primitives; step params are validated by the corresponding tool contracts, not by this schema.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "name", "steps"],
+  "properties": {
+    "schemaVersion": {
+      "const": "glasspane.recipe/0.1-draft"
+    },
+    "name": {
+      "type": "string",
+      "maxLength": 256
+    },
+    "steps": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["kind", "params"],
+        "properties": {
+          "kind": {
+            "enum": ["act", "observe", "assert", "diagnose"]
+          },
+          "params": {
+            "type": "object"
+          }
+        }
+      }
+    }
+  }
+}