chore: release 2.1.0

.gitignore

@@ -8,3 +8,4 @@ node_modules/
 **/build/
 *.xcuserstate
 .DS_Store
+docs/superpowers

Contract/v2/Fixtures/invalid/relation-type-not-namespaced.json

@@ -0,0 +1,6 @@
+{
+  "type": "backingLayer",
+  "sourceNodeID": "node:view:1",
+  "targetNodeID": "node:layer:1",
+  "extensions": { "vendor.graph.confidence": 1 }
+}

Fixtures/v2/valid/handshake-response.json → Contract/v2/Fixtures/valid/handshake-response.json

@@ -18,6 +18,7 @@
       "attributePatchDiscovery",
       "attributePatching",
       "requestCancellation",
+      "uiGraphRelations",
       "vendor.experimentalInspection"
     ]
   }

Fixtures/v2/valid/hierarchy-snapshot-response.json → Contract/v2/Fixtures/valid/hierarchy-snapshot-response.json

@@ -92,6 +92,14 @@
           }
         ]
       }
+    ],
+    "relations": [
+      {
+        "type": "vendor.graph.related",
+        "sourceNodeID": "node:window:0",
+        "targetNodeID": "node:label:1",
+        "extensions": {}
+      }
     ]
   }
 }

Contract/v2/Fixtures/valid/node-relation.json

@@ -0,0 +1,6 @@
+{
+  "type": "vendor.graph.related",
+  "sourceNodeID": "node:view:1",
+  "targetNodeID": "node:layer:1",
+  "extensions": { "vendor.graph.confidence": 1 }
+}

PROTOCOL-2.0.md → Contract/v2/PROTOCOL.md

@@ -12,7 +12,7 @@ ADB, screenshots, CLI commands, MCP tools, UIKit, Auto Layout, Android View, or
 Compose implementation details. A transport only needs to provide a reliable,
 ordered byte stream.
 
-`PROTOCOL-2.0.md`, `Schemas/v2`, and `Fixtures/v2/manifest.json` are normative.
+`Contract/v2/PROTOCOL.md`, `Contract/v2/Schemas`, and `Contract/v2/manifest.json` are normative.
 Swift and Kotlin source code are implementations of this contract, not its
 definition.
 
@@ -201,6 +201,19 @@ Visibility keeps independent causes instead of overloading one Boolean:
 ancestor, has effective opacity greater than `0.01`, intersects the viewport,
 and is not fully clipped by an ancestor.
 
+### 8.3 UI graph relations
+
+The `uiGraphRelations` capability advertises that hierarchy snapshots may
+contain an optional `relations` member. Each directed relation contains an open
+namespaced `type`, a `sourceNodeID`, a `targetNodeID`, and namespaced
+`extensions`. Relation types remain producer-owned vocabulary rather than a
+closed Protocol enum.
+
+The Runtime reports observed relations between captured nodes. It does not
+duplicate hierarchy parent/child edges in `relations`. When either the
+`uiGraphRelations` capability or the optional member is absent, the Host must
+not infer that any cross-tree relation exists.
+
 ## 9. Node details and attributes
 
 Node detail is grouped into sections. Section categories and attribute
@@ -439,7 +452,7 @@ not reproduce Swift type names or Swift coding behavior.
 
 ## 15. Conformance assets
 
-Schemas use JSON Schema Draft 2020-12. `Fixtures/v2/manifest.json` lists every
+Schemas use JSON Schema Draft 2020-12. `Contract/v2/manifest.json` lists every
 method, Schema reference, valid Fixture, invalid Fixture, expected outcome, and
 rejection reason. A conforming implementation must:
 

Schemas/v2/conformance-manifest.schema.json → Contract/v2/Schemas/conformance-manifest.schema.json

@@ -3,12 +3,21 @@
   "$id": "https://astrolabe.dev/schemas/v2/conformance-manifest.schema.json",
   "title": "Astrolabe Protocol 2.0 Conformance Manifest",
   "type": "object",
-  "required": ["schemaVersion", "wireProtocolVersion", "methods", "cases"],
+  "required": ["schemaVersion", "wireProtocolVersion", "fixtureRoots", "methods", "cases"],
   "properties": {
-    "schemaVersion": { "const": 1 },
+    "schemaVersion": { "const": 2 },
     "wireProtocolVersion": {
       "$ref": "https://astrolabe.dev/schemas/v2/common.schema.json#/$defs/protocolVersion"
     },
+    "fixtureRoots": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^(?!.*\\/\\.\\.?($|\\/))Contract/v2/Fixtures/(valid|invalid)(?:/[^/]+)*$"
+      }
+    },
     "methods": {
       "type": "array",
       "minItems": 1,
@@ -32,7 +41,7 @@
         "required": ["name", "fixture", "schema", "expectation"],
         "properties": {
           "name": { "type": "string", "minLength": 1 },
-          "fixture": { "type": "string", "pattern": "^Fixtures/v2/(valid|invalid)/.+\\.json$" },
+          "fixture": { "type": "string", "pattern": "^Contract/v2/Fixtures/(valid|invalid)/.+\\.json$" },
           "schema": { "type": "string", "format": "uri-reference" },
           "expectation": { "enum": ["valid", "invalid"] },
           "semanticRule": { "enum": ["ascendingProtocolRange", "derivedVisibility"] },

Schemas/v2/inspection.schema.json → Contract/v2/Schemas/inspection.schema.json

@@ -222,6 +222,24 @@
         }
       }
     },
+    "nodeRelation": {
+      "type": "object",
+      "required": ["type", "sourceNodeID", "targetNodeID", "extensions"],
+      "properties": {
+        "type": {
+          "$ref": "https://astrolabe.dev/schemas/v2/common.schema.json#/$defs/namespacedIdentifier"
+        },
+        "sourceNodeID": {
+          "$ref": "https://astrolabe.dev/schemas/v2/common.schema.json#/$defs/opaqueIdentifier"
+        },
+        "targetNodeID": {
+          "$ref": "https://astrolabe.dev/schemas/v2/common.schema.json#/$defs/opaqueIdentifier"
+        },
+        "extensions": {
+          "$ref": "https://astrolabe.dev/schemas/v2/common.schema.json#/$defs/extensionMap"
+        }
+      }
+    },
     "hierarchySnapshotPayload": {
       "type": "object",
       "required": [
@@ -255,6 +273,10 @@
           "type": "array",
           "items": { "$ref": "#/$defs/node" }
         },
+        "relations": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/nodeRelation" }
+        },
         "extensions": {
           "$ref": "https://astrolabe.dev/schemas/v2/common.schema.json#/$defs/extensionMap"
         }