@coldtea/pr-lens-schema 0.1.0

package/json-schema/patch-doc.schema.json

@@ -0,0 +1,1383 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/coldteadotai/pr-lens/main/packages/schema/json-schema/patch-doc.schema.json",
+  "title": "PR Lens patch document",
+  "version": "0.1.0",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^0\\.1\\.\\d+$",
+      "description": "Contract version the document targets. Current: 0.1.0."
+    },
+    "kind": {
+      "type": "string",
+      "const": "patch"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+    },
+    "summary": {
+      "description": "Why the map is changing, in prose.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000
+    },
+    "target": {
+      "type": "object",
+      "properties": {
+        "graphId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+          "description": "Id of the stored graph being patched."
+        },
+        "fromSha": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$",
+          "description": "Commit the stored graph reflects before the operations run."
+        },
+        "toSha": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$",
+          "description": "Commit it reflects once they have."
+        }
+      },
+      "required": [
+        "graphId",
+        "fromSha",
+        "toSha"
+      ],
+      "additionalProperties": false,
+      "description": "Which stored graph these operations belong to, and which commits they carry it between. All three are required, and the commits must differ: they are what stops a patch landing on the wrong map, on a stale one, or twice."
+    },
+    "ops": {
+      "minItems": 1,
+      "maxItems": 512,
+      "type": "array",
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "add_lane"
+              },
+              "lane": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Stable identifier, unique within its collection in a document."
+                  },
+                  "label": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "Short display label."
+                  },
+                  "subtitle": {
+                    "description": "Secondary line in the lane header, e.g. the platform.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120
+                  },
+                  "order": {
+                    "description": "Left-to-right placement. Ties fall back to array order.",
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 64
+                  },
+                  "delta": {
+                    "description": "Set only when the lane itself is new or gone.",
+                    "type": "string",
+                    "enum": [
+                      "added",
+                      "modified",
+                      "removed",
+                      "unchanged"
+                    ]
+                  },
+                  "summary": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2000,
+                    "description": "One or two sentences of plain prose. No markdown headings."
+                  }
+                },
+                "required": [
+                  "id",
+                  "label"
+                ],
+                "additionalProperties": false,
+                "description": "A grouping band of the diagram. Every node belongs to exactly one lane."
+              }
+            },
+            "required": [
+              "op",
+              "lane"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "update_lane"
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                "description": "Stable identifier, unique within its collection in a document."
+              },
+              "patch": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "Short display label."
+                  },
+                  "subtitle": {
+                    "description": "Secondary line in the lane header, e.g. the platform.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120
+                  },
+                  "order": {
+                    "description": "Left-to-right placement. Ties fall back to array order.",
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 64
+                  },
+                  "delta": {
+                    "description": "Set only when the lane itself is new or gone.",
+                    "type": "string",
+                    "enum": [
+                      "added",
+                      "modified",
+                      "removed",
+                      "unchanged"
+                    ]
+                  },
+                  "summary": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2000,
+                    "description": "One or two sentences of plain prose. No markdown headings."
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "op",
+              "id",
+              "patch"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "remove_lane"
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                "description": "Stable identifier, unique within its collection in a document."
+              }
+            },
+            "required": [
+              "op",
+              "id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "add_node"
+              },
+              "node": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Stable identifier, unique within its collection in a document."
+                  },
+                  "label": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "Short display label."
+                  },
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "service",
+                      "app",
+                      "module",
+                      "function",
+                      "route",
+                      "job",
+                      "queue",
+                      "datastore",
+                      "cache",
+                      "external",
+                      "ui",
+                      "config",
+                      "test",
+                      "package",
+                      "other"
+                    ]
+                  },
+                  "delta": {
+                    "type": "string",
+                    "enum": [
+                      "added",
+                      "modified",
+                      "removed",
+                      "unchanged"
+                    ],
+                    "description": "Change state relative to the base commit."
+                  },
+                  "lane": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Id of the lane this node sits in."
+                  },
+                  "group": {
+                    "description": "Optional sub-cluster within the lane, e.g. a package.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$"
+                  },
+                  "subtitle": {
+                    "description": "Secondary line on the card, e.g. a symbol signature.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120
+                  },
+                  "summary": {
+                    "description": "Body text for this node's drill-down section.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2000
+                  },
+                  "files": {
+                    "default": [],
+                    "description": "Backing source locations, used to build diff permalinks.",
+                    "maxItems": 64,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "path": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 1024,
+                          "pattern": "^(?!\\/)(?![A-Za-z]:)(?!.*\\\\)(?!.*(?:^|\\/)\\.\\.(?:\\/|$)).+$",
+                          "description": "Repository-relative path, POSIX separators."
+                        },
+                        "startLine": {
+                          "description": "1-based first line.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 9007199254740991
+                        },
+                        "endLine": {
+                          "description": "1-based last line, inclusive.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 9007199254740991
+                        },
+                        "revision": {
+                          "description": "Which side of the diff the lines refer to. Defaults to head.",
+                          "type": "string",
+                          "enum": [
+                            "head",
+                            "base"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "path"
+                      ],
+                      "additionalProperties": false,
+                      "dependentRequired": {
+                        "endLine": [
+                          "startLine"
+                        ]
+                      },
+                      "description": "A file (and optional line range) backing an element."
+                    }
+                  },
+                  "badges": {
+                    "default": [],
+                    "description": "Extra chips on the card, beyond the delta badge the renderer adds.",
+                    "maxItems": 6,
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 120,
+                      "description": "Short display label."
+                    }
+                  }
+                },
+                "required": [
+                  "id",
+                  "label",
+                  "kind",
+                  "delta",
+                  "lane"
+                ],
+                "additionalProperties": false,
+                "description": "A node in the architecture graph."
+              }
+            },
+            "required": [
+              "op",
+              "node"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "update_node"
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                "description": "Stable identifier, unique within its collection in a document."
+              },
+              "patch": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "Short display label."
+                  },
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "service",
+                      "app",
+                      "module",
+                      "function",
+                      "route",
+                      "job",
+                      "queue",
+                      "datastore",
+                      "cache",
+                      "external",
+                      "ui",
+                      "config",
+                      "test",
+                      "package",
+                      "other"
+                    ]
+                  },
+                  "delta": {
+                    "type": "string",
+                    "enum": [
+                      "added",
+                      "modified",
+                      "removed",
+                      "unchanged"
+                    ],
+                    "description": "Change state relative to the base commit."
+                  },
+                  "lane": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Id of the lane this node sits in."
+                  },
+                  "group": {
+                    "description": "Optional sub-cluster within the lane, e.g. a package.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$"
+                  },
+                  "subtitle": {
+                    "description": "Secondary line on the card, e.g. a symbol signature.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120
+                  },
+                  "summary": {
+                    "description": "Body text for this node's drill-down section.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2000
+                  },
+                  "files": {
+                    "default": [],
+                    "description": "Backing source locations, used to build diff permalinks.",
+                    "maxItems": 64,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "path": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 1024,
+                          "pattern": "^(?!\\/)(?![A-Za-z]:)(?!.*\\\\)(?!.*(?:^|\\/)\\.\\.(?:\\/|$)).+$",
+                          "description": "Repository-relative path, POSIX separators."
+                        },
+                        "startLine": {
+                          "description": "1-based first line.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 9007199254740991
+                        },
+                        "endLine": {
+                          "description": "1-based last line, inclusive.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 9007199254740991
+                        },
+                        "revision": {
+                          "description": "Which side of the diff the lines refer to. Defaults to head.",
+                          "type": "string",
+                          "enum": [
+                            "head",
+                            "base"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "path"
+                      ],
+                      "additionalProperties": false,
+                      "dependentRequired": {
+                        "endLine": [
+                          "startLine"
+                        ]
+                      },
+                      "description": "A file (and optional line range) backing an element."
+                    }
+                  },
+                  "badges": {
+                    "default": [],
+                    "description": "Extra chips on the card, beyond the delta badge the renderer adds.",
+                    "maxItems": 6,
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 120,
+                      "description": "Short display label."
+                    }
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "op",
+              "id",
+              "patch"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "remove_node"
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                "description": "Stable identifier, unique within its collection in a document."
+              }
+            },
+            "required": [
+              "op",
+              "id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "add_edge"
+              },
+              "edge": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Stable identifier, unique within its collection in a document."
+                  },
+                  "from": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Source node id."
+                  },
+                  "to": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Target node id."
+                  },
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "call",
+                      "http",
+                      "rpc",
+                      "event",
+                      "queue",
+                      "data",
+                      "dependency",
+                      "render",
+                      "other"
+                    ]
+                  },
+                  "delta": {
+                    "type": "string",
+                    "enum": [
+                      "added",
+                      "modified",
+                      "removed",
+                      "unchanged"
+                    ],
+                    "description": "Change state relative to the base commit."
+                  },
+                  "label": {
+                    "description": "Text on the edge, e.g. a payload size or protocol.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120
+                  },
+                  "emphasis": {
+                    "default": "normal",
+                    "type": "string",
+                    "enum": [
+                      "normal",
+                      "hero",
+                      "muted"
+                    ]
+                  },
+                  "animated": {
+                    "default": false,
+                    "description": "Render a travelling pulse along this edge in the architecture lens.",
+                    "type": "boolean"
+                  },
+                  "summary": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2000,
+                    "description": "One or two sentences of plain prose. No markdown headings."
+                  },
+                  "files": {
+                    "default": [],
+                    "maxItems": 32,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "path": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 1024,
+                          "pattern": "^(?!\\/)(?![A-Za-z]:)(?!.*\\\\)(?!.*(?:^|\\/)\\.\\.(?:\\/|$)).+$",
+                          "description": "Repository-relative path, POSIX separators."
+                        },
+                        "startLine": {
+                          "description": "1-based first line.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 9007199254740991
+                        },
+                        "endLine": {
+                          "description": "1-based last line, inclusive.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 9007199254740991
+                        },
+                        "revision": {
+                          "description": "Which side of the diff the lines refer to. Defaults to head.",
+                          "type": "string",
+                          "enum": [
+                            "head",
+                            "base"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "path"
+                      ],
+                      "additionalProperties": false,
+                      "dependentRequired": {
+                        "endLine": [
+                          "startLine"
+                        ]
+                      },
+                      "description": "A file (and optional line range) backing an element."
+                    }
+                  }
+                },
+                "required": [
+                  "id",
+                  "from",
+                  "to",
+                  "kind",
+                  "delta"
+                ],
+                "additionalProperties": false,
+                "description": "A directed connection between two nodes."
+              }
+            },
+            "required": [
+              "op",
+              "edge"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "update_edge"
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                "description": "Stable identifier, unique within its collection in a document."
+              },
+              "patch": {
+                "type": "object",
+                "properties": {
+                  "from": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Source node id."
+                  },
+                  "to": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Target node id."
+                  },
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "call",
+                      "http",
+                      "rpc",
+                      "event",
+                      "queue",
+                      "data",
+                      "dependency",
+                      "render",
+                      "other"
+                    ]
+                  },
+                  "delta": {
+                    "type": "string",
+                    "enum": [
+                      "added",
+                      "modified",
+                      "removed",
+                      "unchanged"
+                    ],
+                    "description": "Change state relative to the base commit."
+                  },
+                  "label": {
+                    "description": "Text on the edge, e.g. a payload size or protocol.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120
+                  },
+                  "emphasis": {
+                    "default": "normal",
+                    "type": "string",
+                    "enum": [
+                      "normal",
+                      "hero",
+                      "muted"
+                    ]
+                  },
+                  "animated": {
+                    "default": false,
+                    "description": "Render a travelling pulse along this edge in the architecture lens.",
+                    "type": "boolean"
+                  },
+                  "summary": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2000,
+                    "description": "One or two sentences of plain prose. No markdown headings."
+                  },
+                  "files": {
+                    "default": [],
+                    "maxItems": 32,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "path": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 1024,
+                          "pattern": "^(?!\\/)(?![A-Za-z]:)(?!.*\\\\)(?!.*(?:^|\\/)\\.\\.(?:\\/|$)).+$",
+                          "description": "Repository-relative path, POSIX separators."
+                        },
+                        "startLine": {
+                          "description": "1-based first line.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 9007199254740991
+                        },
+                        "endLine": {
+                          "description": "1-based last line, inclusive.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 9007199254740991
+                        },
+                        "revision": {
+                          "description": "Which side of the diff the lines refer to. Defaults to head.",
+                          "type": "string",
+                          "enum": [
+                            "head",
+                            "base"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "path"
+                      ],
+                      "additionalProperties": false,
+                      "dependentRequired": {
+                        "endLine": [
+                          "startLine"
+                        ]
+                      },
+                      "description": "A file (and optional line range) backing an element."
+                    }
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "op",
+              "id",
+              "patch"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "remove_edge"
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                "description": "Stable identifier, unique within its collection in a document."
+              }
+            },
+            "required": [
+              "op",
+              "id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "add_flow"
+              },
+              "flow": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                    "description": "Stable identifier, unique within its collection in a document."
+                  },
+                  "title": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "Short display label."
+                  },
+                  "summary": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2000,
+                    "description": "One or two sentences of plain prose. No markdown headings."
+                  },
+                  "delta": {
+                    "default": "modified",
+                    "type": "string",
+                    "enum": [
+                      "added",
+                      "modified",
+                      "removed",
+                      "unchanged"
+                    ],
+                    "description": "Change state relative to the base commit."
+                  },
+                  "participants": {
+                    "minItems": 2,
+                    "maxItems": 12,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "node": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128,
+                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                          "description": "Id of the graph node this column represents."
+                        },
+                        "label": {
+                          "description": "Shorter name for the column when the node label is long.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 120
+                        }
+                      },
+                      "required": [
+                        "node"
+                      ],
+                      "additionalProperties": false,
+                      "description": "A column in the sequence diagram, ordered by array position."
+                    }
+                  },
+                  "messages": {
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128,
+                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                          "description": "Stable identifier, unique within its collection in a document."
+                        },
+                        "from": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128,
+                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                          "description": "Participant node id the message originates from."
+                        },
+                        "to": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128,
+                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                          "description": "Participant node id the message arrives at. Equals `from` when kind is self."
+                        },
+                        "label": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 120,
+                          "description": "Short display label."
+                        },
+                        "kind": {
+                          "default": "sync",
+                          "type": "string",
+                          "enum": [
+                            "sync",
+                            "async",
+                            "return",
+                            "self"
+                          ]
+                        },
+                        "delta": {
+                          "type": "string",
+                          "enum": [
+                            "added",
+                            "modified",
+                            "removed",
+                            "unchanged"
+                          ],
+                          "description": "Change state relative to the base commit."
+                        },
+                        "animated": {
+                          "default": true,
+                          "description": "Whether the data-flow lens pulses this step.",
+                          "type": "boolean"
+                        },
+                        "repeat": {
+                          "description": "Times the step occurs per run, e.g. 4 batched requests.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 1000000
+                        },
+                        "note": {
+                          "description": "Aside rendered beside the step in the drill-down.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 2000
+                        },
+                        "files": {
+                          "default": [],
+                          "maxItems": 32,
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "path": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 1024,
+                                "pattern": "^(?!\\/)(?![A-Za-z]:)(?!.*\\\\)(?!.*(?:^|\\/)\\.\\.(?:\\/|$)).+$",
+                                "description": "Repository-relative path, POSIX separators."
+                              },
+                              "startLine": {
+                                "description": "1-based first line.",
+                                "type": "integer",
+                                "minimum": 1,
+                                "maximum": 9007199254740991
+                              },
+                              "endLine": {
+                                "description": "1-based last line, inclusive.",
+                                "type": "integer",
+                                "minimum": 1,
+                                "maximum": 9007199254740991
+                              },
+                              "revision": {
+                                "description": "Which side of the diff the lines refer to. Defaults to head.",
+                                "type": "string",
+                                "enum": [
+                                  "head",
+                                  "base"
+                                ]
+                              }
+                            },
+                            "required": [
+                              "path"
+                            ],
+                            "additionalProperties": false,
+                            "dependentRequired": {
+                              "endLine": [
+                                "startLine"
+                              ]
+                            },
+                            "description": "A file (and optional line range) backing an element."
+                          }
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "from",
+                        "to",
+                        "label",
+                        "delta"
+                      ],
+                      "additionalProperties": false,
+                      "description": "One ordered step in a flow."
+                    },
+                    "description": "Ordered by array position."
+                  }
+                },
+                "required": [
+                  "id",
+                  "title",
+                  "participants",
+                  "messages"
+                ],
+                "additionalProperties": false,
+                "description": "An ordered message sequence for the data-flow lens."
+              }
+            },
+            "required": [
+              "op",
+              "flow"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "update_flow"
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                "description": "Stable identifier, unique within its collection in a document."
+              },
+              "patch": {
+                "type": "object",
+                "properties": {
+                  "title": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "Short display label."
+                  },
+                  "summary": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2000,
+                    "description": "One or two sentences of plain prose. No markdown headings."
+                  },
+                  "delta": {
+                    "default": "modified",
+                    "type": "string",
+                    "enum": [
+                      "added",
+                      "modified",
+                      "removed",
+                      "unchanged"
+                    ],
+                    "description": "Change state relative to the base commit."
+                  },
+                  "participants": {
+                    "minItems": 2,
+                    "maxItems": 12,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "node": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128,
+                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                          "description": "Id of the graph node this column represents."
+                        },
+                        "label": {
+                          "description": "Shorter name for the column when the node label is long.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 120
+                        }
+                      },
+                      "required": [
+                        "node"
+                      ],
+                      "additionalProperties": false,
+                      "description": "A column in the sequence diagram, ordered by array position."
+                    }
+                  },
+                  "messages": {
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128,
+                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                          "description": "Stable identifier, unique within its collection in a document."
+                        },
+                        "from": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128,
+                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                          "description": "Participant node id the message originates from."
+                        },
+                        "to": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128,
+                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                          "description": "Participant node id the message arrives at. Equals `from` when kind is self."
+                        },
+                        "label": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 120,
+                          "description": "Short display label."
+                        },
+                        "kind": {
+                          "default": "sync",
+                          "type": "string",
+                          "enum": [
+                            "sync",
+                            "async",
+                            "return",
+                            "self"
+                          ]
+                        },
+                        "delta": {
+                          "type": "string",
+                          "enum": [
+                            "added",
+                            "modified",
+                            "removed",
+                            "unchanged"
+                          ],
+                          "description": "Change state relative to the base commit."
+                        },
+                        "animated": {
+                          "default": true,
+                          "description": "Whether the data-flow lens pulses this step.",
+                          "type": "boolean"
+                        },
+                        "repeat": {
+                          "description": "Times the step occurs per run, e.g. 4 batched requests.",
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 1000000
+                        },
+                        "note": {
+                          "description": "Aside rendered beside the step in the drill-down.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 2000
+                        },
+                        "files": {
+                          "default": [],
+                          "maxItems": 32,
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "path": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 1024,
+                                "pattern": "^(?!\\/)(?![A-Za-z]:)(?!.*\\\\)(?!.*(?:^|\\/)\\.\\.(?:\\/|$)).+$",
+                                "description": "Repository-relative path, POSIX separators."
+                              },
+                              "startLine": {
+                                "description": "1-based first line.",
+                                "type": "integer",
+                                "minimum": 1,
+                                "maximum": 9007199254740991
+                              },
+                              "endLine": {
+                                "description": "1-based last line, inclusive.",
+                                "type": "integer",
+                                "minimum": 1,
+                                "maximum": 9007199254740991
+                              },
+                              "revision": {
+                                "description": "Which side of the diff the lines refer to. Defaults to head.",
+                                "type": "string",
+                                "enum": [
+                                  "head",
+                                  "base"
+                                ]
+                              }
+                            },
+                            "required": [
+                              "path"
+                            ],
+                            "additionalProperties": false,
+                            "dependentRequired": {
+                              "endLine": [
+                                "startLine"
+                              ]
+                            },
+                            "description": "A file (and optional line range) backing an element."
+                          }
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "from",
+                        "to",
+                        "label",
+                        "delta"
+                      ],
+                      "additionalProperties": false,
+                      "description": "One ordered step in a flow."
+                    },
+                    "description": "Ordered by array position."
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "op",
+              "id",
+              "patch"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "remove_flow"
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
+                "description": "Stable identifier, unique within its collection in a document."
+              }
+            },
+            "required": [
+              "op",
+              "id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "op": {
+                "type": "string",
+                "const": "set_stats"
+              },
+              "stats": {
+                "type": "object",
+                "properties": {
+                  "filesChanged": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "additions": {
+                    "description": "Lines added across the diff.",
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "deletions": {
+                    "description": "Lines removed across the diff.",
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "chips": {
+                    "default": [],
+                    "maxItems": 8,
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "label": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 120,
+                          "description": "Short display label."
+                        },
+                        "value": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 32
+                        },
+                        "tone": {
+                          "default": "neutral",
+                          "type": "string",
+                          "enum": [
+                            "neutral",
+                            "added",
+                            "modified",
+                            "removed",
+                            "hero"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "label",
+                        "value"
+                      ],
+                      "additionalProperties": false,
+                      "description": "A headline chip above the diagram."
+                    }
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Headline numbers for the comment header."
+              }
+            },
+            "required": [
+              "op",
+              "stats"
+            ],
+            "additionalProperties": false
+          }
+        ],
+        "description": "A single change to a stored graph document."
+      },
+      "description": "Applied in array order."
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "kind",
+    "target",
+    "ops"
+  ],
+  "additionalProperties": false,
+  "description": "A PR Lens patch document."
+}