@openplanr/protocol 0.2.0

package/schemas/v1.1.0/artifact-review.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/artifact-review.schema.json",
+  "title": "OpenPlanr immutable artifact review",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "reviewId", "reviewOf", "decision", "overall", "pins"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "reviewId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "reviewOf": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "decision": { "type": "string", "enum": ["pending", "approved", "changes_requested"] },
+    "overall": { "type": "string", "maxLength": 65536 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "pins": {
+      "type": "array",
+      "maxItems": 10000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "author", "artifactId", "region", "viewport", "intent", "status", "comment", "replies", "createdAt", "updatedAt"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+          "author": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+              "name": { "type": "string", "minLength": 1, "maxLength": 256 }
+            }
+          },
+          "artifactId": { "type": "string", "minLength": 1, "maxLength": 128 },
+          "variant": { "type": "string", "minLength": 1, "maxLength": 128 },
+          "region": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["x", "y", "w", "h"],
+            "properties": {
+              "x": { "type": "number", "minimum": 0, "maximum": 1 },
+              "y": { "type": "number", "minimum": 0, "maximum": 1 },
+              "w": { "type": "number", "minimum": 0, "maximum": 1 },
+              "h": { "type": "number", "minimum": 0, "maximum": 1 }
+            }
+          },
+          "viewport": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["width", "height"],
+            "properties": {
+              "width": { "type": "integer", "minimum": 1, "maximum": 16384 },
+              "height": { "type": "integer", "minimum": 1, "maximum": 262144 }
+            }
+          },
+          "anchor": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["planrId"],
+            "properties": {
+              "planrId": { "type": "string", "minLength": 1, "maxLength": 512 },
+              "screen": { "type": "string", "minLength": 1, "maxLength": 128 }
+            }
+          },
+          "intent": { "type": "string", "enum": ["fix", "improve", "question"] },
+          "status": { "type": "string", "enum": ["open", "addressed", "resolved"] },
+          "comment": { "type": "string", "minLength": 1, "maxLength": 65536 },
+          "replies": {
+            "type": "array",
+            "maxItems": 10000,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "author", "comment", "createdAt"],
+              "properties": {
+                "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "author": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["name"],
+                  "properties": {
+                    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                    "name": { "type": "string", "minLength": 1, "maxLength": 256 }
+                  }
+                },
+                "comment": { "type": "string", "minLength": 1, "maxLength": 65536 },
+                "createdAt": { "type": "string", "format": "date-time" }
+              }
+            }
+          },
+          "createdAt": { "type": "string", "format": "date-time" },
+          "updatedAt": { "type": "string", "format": "date-time" }
+        }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/artifact-room-descriptor.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/artifact-room-descriptor.schema.json",
+  "title": "OpenPlanr signed live-room descriptor",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocolVersion", "roomId", "reviewOf", "ownerKey", "capabilities", "createdAt"],
+  "properties": {
+    "schemaVersion": { "const": "2.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "roomId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{16,128}$" },
+    "reviewOf": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "ownerKey": { "$ref": "#/$defs/publicKey" },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reviewer", "owner", "management"],
+      "properties": {
+        "reviewer": { "const": "reviewer-write" },
+        "owner": { "const": "owner-verdict" },
+        "management": { "const": "room-management" }
+      }
+    },
+    "createdAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "publicKey": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["algorithm", "encoding", "keyId", "value"],
+      "properties": {
+        "algorithm": { "const": "ECDSA-P256-SHA256" },
+        "encoding": { "const": "spki-base64url" },
+        "keyId": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "value": { "type": "string", "pattern": "^[A-Za-z0-9_-]{64,342}$" }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/artifact-room-event.schema.json

@@ -0,0 +1,184 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/artifact-room-event.schema.json",
+  "title": "OpenPlanr encrypted artifact-room event plaintext",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "eventId", "roomId", "reviewOf", "kind", "createdAt", "payload"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "eventId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" },
+    "roomId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{16,128}$" },
+    "reviewOf": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "kind": { "enum": ["pin", "reply", "pin_status", "recommendation", "owner_decision", "review_snapshot"] },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "payload": { "type": "object" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "kind": { "const": "pin" } } },
+      "then": { "properties": { "payload": { "$ref": "#/$defs/pin" } } }
+    },
+    {
+      "if": { "properties": { "kind": { "const": "reply" } } },
+      "then": {
+        "properties": {
+          "payload": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["pinId", "reply"],
+            "properties": {
+              "pinId": { "type": "string", "minLength": 1, "maxLength": 128 },
+              "reply": { "$ref": "#/$defs/reply" }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "kind": { "const": "pin_status" } } },
+      "then": {
+        "properties": {
+          "payload": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["pinId", "status"],
+            "properties": {
+              "pinId": { "type": "string", "minLength": 1, "maxLength": 128 },
+              "status": { "enum": ["open", "addressed", "resolved"] }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "kind": { "const": "recommendation" } } },
+      "then": {
+        "properties": {
+          "payload": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["author", "decision", "overall"],
+            "properties": {
+              "author": { "$ref": "#/$defs/author" },
+              "decision": { "enum": ["pending", "approved", "changes_requested"] },
+              "overall": { "type": "string", "maxLength": 65536 }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "kind": { "const": "owner_decision" } } },
+      "then": {
+        "properties": {
+          "payload": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["decision"],
+            "properties": {
+              "decision": { "enum": ["approved", "changes_requested"] },
+              "overall": { "type": "string", "maxLength": 65536 }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "kind": { "const": "review_snapshot" } } },
+      "then": {
+        "properties": {
+          "payload": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["review"],
+            "properties": { "review": { "$ref": "#/$defs/review" } }
+          }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "author": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "name": { "type": "string", "minLength": 1, "maxLength": 256 }
+      }
+    },
+    "reply": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "author", "comment", "createdAt"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "author": { "$ref": "#/$defs/author" },
+        "comment": { "type": "string", "minLength": 1, "maxLength": 65536 },
+        "createdAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "pin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "author", "artifactId", "region", "viewport", "intent", "status", "comment", "replies", "createdAt", "updatedAt"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "author": { "$ref": "#/$defs/author" },
+        "artifactId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "variant": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "region": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["x", "y", "w", "h"],
+          "properties": {
+            "x": { "type": "number", "minimum": 0, "maximum": 1 },
+            "y": { "type": "number", "minimum": 0, "maximum": 1 },
+            "w": { "type": "number", "minimum": 0, "maximum": 1 },
+            "h": { "type": "number", "minimum": 0, "maximum": 1 }
+          }
+        },
+        "viewport": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["width", "height"],
+          "properties": {
+            "width": { "type": "integer", "minimum": 1, "maximum": 16384 },
+            "height": { "type": "integer", "minimum": 1, "maximum": 262144 }
+          }
+        },
+        "anchor": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["planrId"],
+          "properties": {
+            "planrId": { "type": "string", "minLength": 1, "maxLength": 512 },
+            "screen": { "type": "string", "minLength": 1, "maxLength": 128 }
+          }
+        },
+        "intent": { "enum": ["fix", "improve", "question"] },
+        "status": { "enum": ["open", "addressed", "resolved"] },
+        "comment": { "type": "string", "minLength": 1, "maxLength": 65536 },
+        "replies": { "type": "array", "maxItems": 10000, "items": { "$ref": "#/$defs/reply" } },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "review": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "reviewId", "reviewOf", "decision", "overall", "pins"],
+      "properties": {
+        "schemaVersion": { "const": "1.0.0" },
+        "reviewId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "reviewOf": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "decision": { "enum": ["pending", "approved", "changes_requested"] },
+        "overall": { "type": "string", "maxLength": 65536 },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" },
+        "pins": { "type": "array", "maxItems": 10000, "items": { "$ref": "#/$defs/pin" } }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/artifact-room-signed-event.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/artifact-room-signed-event.schema.json",
+  "title": "OpenPlanr signed live-room ciphertext event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "protocolVersion", "roomId", "eventId", "sequence", "predecessor", "kind",
+    "reviewOf", "authorRole", "authorKey", "capability", "createdAt", "iv", "ciphertext",
+    "plaintextDigest", "ciphertextDigest", "signature"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "2.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "roomId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{16,128}$" },
+    "eventId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" },
+    "sequence": { "type": "integer", "minimum": 1 },
+    "predecessor": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "kind": { "enum": ["pin", "reply", "pin_status", "recommendation", "owner_decision", "review_snapshot"] },
+    "reviewOf": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "authorRole": { "enum": ["reviewer", "owner"] },
+    "authorKey": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["algorithm", "encoding", "keyId", "value"],
+      "properties": {
+        "algorithm": { "const": "ECDSA-P256-SHA256" },
+        "encoding": { "const": "spki-base64url" },
+        "keyId": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "value": { "type": "string", "pattern": "^[A-Za-z0-9_-]{64,342}$" }
+      }
+    },
+    "capability": { "enum": ["reviewer-write", "owner-verdict"] },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "iv": { "type": "string", "pattern": "^[A-Za-z0-9_-]{16}$" },
+    "ciphertext": { "type": "string", "pattern": "^[A-Za-z0-9_-]+$" },
+    "plaintextDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "ciphertextDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "signature": { "type": "string", "pattern": "^[A-Za-z0-9_-]{86,107}$" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "authorRole": { "const": "owner" } }, "required": ["authorRole"] },
+      "then": {
+        "properties": {
+          "capability": { "const": "owner-verdict" },
+          "kind": { "enum": ["owner_decision", "review_snapshot"] }
+        }
+      },
+      "else": {
+        "properties": {
+          "capability": { "const": "reviewer-write" },
+          "kind": { "enum": ["pin", "reply", "pin_status", "recommendation"] }
+        }
+      }
+    }
+  ]
+}

package/schemas/v1.1.0/artifact-theme.schema.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/artifact-theme.schema.json",
+  "title": "OpenPlanr artifact review theme registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "name", "typography", "layout", "themes"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "name": { "const": "OpenPlanr Artifact Review" },
+    "typography": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["display", "body", "mono"],
+      "properties": {
+        "display": { "const": "Outfit" },
+        "body": { "const": "DM Sans" },
+        "mono": { "const": "Source Code Pro" }
+      }
+    },
+    "layout": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "toolbarHeight",
+        "reviewRailWidth",
+        "radiusSmall",
+        "radiusMedium",
+        "radiusLarge",
+        "motionFastMs",
+        "motionBaseMs"
+      ],
+      "properties": {
+        "toolbarHeight": { "const": 48 },
+        "reviewRailWidth": { "const": 344 },
+        "radiusSmall": { "type": "integer", "minimum": 0, "maximum": 32 },
+        "radiusMedium": { "type": "integer", "minimum": 0, "maximum": 32 },
+        "radiusLarge": { "type": "integer", "minimum": 0, "maximum": 32 },
+        "motionFastMs": { "type": "integer", "minimum": 120, "maximum": 200 },
+        "motionBaseMs": { "type": "integer", "minimum": 120, "maximum": 200 }
+      }
+    },
+    "themes": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["dark", "light"],
+      "properties": {
+        "dark": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "background",
+            "chrome",
+            "panel",
+            "raised",
+            "stage",
+            "rule",
+            "text",
+            "textMuted",
+            "primary",
+            "primaryStrong",
+            "warning",
+            "danger",
+            "onDanger",
+            "question",
+            "onQuestion",
+            "resolved",
+            "onResolved",
+            "onImprove"
+          ],
+          "properties": {
+            "background": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "chrome": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "panel": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "raised": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "stage": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "rule": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "text": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "textMuted": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "primary": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "primaryStrong": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "warning": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "danger": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "onDanger": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "question": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "onQuestion": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "resolved": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "onResolved": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "onImprove": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" }
+          }
+        },
+        "light": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "background",
+            "chrome",
+            "panel",
+            "raised",
+            "stage",
+            "rule",
+            "text",
+            "textMuted",
+            "primary",
+            "primaryStrong",
+            "warning",
+            "danger",
+            "onDanger",
+            "question",
+            "onQuestion",
+            "resolved",
+            "onResolved",
+            "onImprove"
+          ],
+          "properties": {
+            "background": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "chrome": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "panel": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "raised": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "stage": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "rule": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "text": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "textMuted": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "primary": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "primaryStrong": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "warning": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "danger": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "onDanger": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "question": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "onQuestion": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "resolved": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "onResolved": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" },
+            "onImprove": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/browser-qa-gate.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/browser-qa-gate.schema.json",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "candidateRevision", "candidateDigest", "requirementDigest", "required", "status", "sessionBindingDigest", "resultDigest", "recordDigest"],
+  "properties": {
+    "kind": { "const": "browser-qa-gate" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "1.1.0" },
+    "candidateRevision": { "type": "integer", "minimum": 1, "maximum": 2 },
+    "candidateDigest": { "$ref": "#/$defs/digest" }, "requirementDigest": { "$ref": "#/$defs/digest" }, "required": { "type": "boolean" },
+    "status": { "enum": ["passed", "failed", "blocked", "skipped"] },
+    "sessionBindingDigest": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "resultDigest": { "$ref": "#/$defs/digest" },
+    "custodyVersion": { "const": "1.0.0" },
+    "attestationHostId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,127}$" },
+    "attestationHostVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "attestationDigest": { "$ref": "#/$defs/digest" },
+    "evidenceBundleDigest": { "$ref": "#/$defs/digest" },
+    "recordDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }
+}

package/schemas/v1.1.0/browser-qa-result.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/browser-qa-result.schema.json",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "candidateDigest", "requirementDigest", "status", "signedIn", "sessionId", "origin", "routeIds", "formIds", "viewports", "accessibility", "console", "network", "screenshots", "traces", "failures"],
+  "properties": {
+    "kind": { "const": "browser-qa-result" }, "schemaVersion": { "const": "1.0.0" },
+    "candidateDigest": { "$ref": "#/$defs/digest" }, "requirementDigest": { "$ref": "#/$defs/digest" },
+    "status": { "enum": ["passed", "failed", "unavailable", "skipped"] }, "signedIn": { "type": "boolean" },
+    "sessionId": { "type": ["string", "null"], "pattern": "^bqs_[a-f0-9]{32}$" },
+    "origin": { "type": "string", "minLength": 1, "maxLength": 2048 },
+    "routeIds": { "$ref": "#/$defs/ids" }, "formIds": { "$ref": "#/$defs/ids" },
+    "viewports": { "type": "array", "maxItems": 32, "items": { "type": "object", "additionalProperties": false, "required": ["id", "width", "height", "horizontalOverflow"], "properties": { "id": { "$ref": "#/$defs/id" }, "width": { "type": "integer", "minimum": 240, "maximum": 7680 }, "height": { "type": "integer", "minimum": 240, "maximum": 7680 }, "horizontalOverflow": { "type": "boolean" } } } },
+    "accessibility": { "$ref": "#/$defs/countEvidence" }, "console": { "$ref": "#/$defs/countEvidence" }, "network": { "$ref": "#/$defs/countEvidence" },
+    "screenshots": { "$ref": "#/$defs/evidence" }, "traces": { "$ref": "#/$defs/evidence" },
+    "failures": { "type": "array", "maxItems": 128, "items": { "type": "object", "additionalProperties": false, "required": ["code", "messageDigest"], "properties": { "code": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,63}$" }, "messageDigest": { "$ref": "#/$defs/digest" } } } }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,127}$" },
+    "ids": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "countEvidence": { "type": "object", "additionalProperties": false, "required": ["failureCount", "evidenceDigest"], "properties": { "failureCount": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "evidenceDigest": { "$ref": "#/$defs/digest" } } },
+    "evidence": { "type": "array", "maxItems": 256, "items": { "type": "object", "additionalProperties": false, "required": ["id", "contentDigest"], "properties": { "id": { "$ref": "#/$defs/id" }, "contentDigest": { "$ref": "#/$defs/digest" } } } }
+  }
+}

package/schemas/v1.1.0/browser-qa-session.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/browser-qa-session.schema.json",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "sessionId", "suppliedAt", "expiresAt", "signedIn", "custody", "persisted"],
+  "properties": {
+    "kind": { "const": "browser-qa-session" }, "schemaVersion": { "const": "1.0.0" },
+    "sessionId": { "type": "string", "pattern": "^bqs_[a-f0-9]{32}$" },
+    "suppliedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" },
+    "signedIn": { "type": "boolean" }, "custody": { "const": "external-ephemeral" }, "persisted": { "const": false }
+  }
+}

package/schemas/v1.1.0/ecosystem-manifest.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/ecosystem-manifest.schema.json",
+  "title": "OpenPlanr resolved ecosystem compatibility manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "generatedAt", "protocol", "components", "adapters"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["current", "supported"],
+      "properties": {
+        "current": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+        "supported": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "components": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cli", "pipeline", "skills", "marketplace"],
+      "properties": {
+        "cli": { "type": "object", "additionalProperties": false, "required": ["version", "pipelineRange"], "properties": { "version": { "type": "string" }, "pipelineRange": { "type": "string" } } },
+        "pipeline": { "type": "object", "additionalProperties": false, "required": ["version", "cliRange"], "properties": { "version": { "type": "string" }, "cliRange": { "type": "string" } } },
+        "skills": { "type": "object", "additionalProperties": false, "required": ["version", "cliRange"], "properties": { "version": { "type": "string" }, "cliRange": { "type": "string" } } },
+        "marketplace": { "type": "object", "additionalProperties": false, "required": ["version"], "properties": { "version": { "type": "string" } } }
+      }
+    },
+    "adapters": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["runtime", "version", "capabilityLevel", "pipelineRange"],
+        "properties": {
+          "runtime": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "version": { "type": "string" },
+          "capabilityLevel": { "type": "string", "enum": ["artifact", "workflow", "product"] },
+          "pipelineRange": { "type": "string" }
+        }
+      }
+    }
+  }
+}