pi-outpost 0.32.4 → 0.34.0

package/dist/skills/structured-exchange/structured-exchange-3.json

@@ -0,0 +1,1263 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:structured-exchange:3",
+  "title": "Structured exchange envelope v3",
+  "description": "Version 2 plus one kind, the timeline. Every version 2 construct keeps its definition, so a version 2 document means the same thing once its identifier is changed to this one.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "kind",
+    "data"
+  ],
+  "$defs": {
+    "ref": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "localId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "label": {
+      "type": "string",
+      "maxLength": 500
+    },
+    "kind": {
+      "description": "The producing tool's type or stereotype for this thing \u2014 'block', 'sensor', 'requirement', 'power'. Free text, because the vocabulary belongs to the domain and not to this contract; a profile names which domain owns it.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100
+    },
+    "reference": {
+      "description": "Something owned elsewhere, named by the identifier its authority knows it by. Opaque: never parsed, resolved or fetched.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ref"
+      ],
+      "properties": {
+        "ref": {
+          "$ref": "#/$defs/ref"
+        }
+      }
+    },
+    "attributeScalar": {
+      "type": [
+        "string",
+        "number",
+        "boolean",
+        "null"
+      ],
+      "maxLength": 1000
+    },
+    "attributeValue": {
+      "description": "A scalar, an opaque reference, or one flat list of those. Lists never nest and no other object shape is allowed: recursive values would weaken size analysis, generic rendering and deterministic comparison.",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/attributeScalar"
+        },
+        {
+          "$ref": "#/$defs/reference"
+        },
+        {
+          "type": "array",
+          "maxItems": 50,
+          "items": {
+            "oneOf": [
+              {
+                "$ref": "#/$defs/attributeScalar"
+              },
+              {
+                "$ref": "#/$defs/reference"
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "attributes": {
+      "description": "Domain-owned properties of this item. Names belong to the profile's vocabulary; this contract bounds them and reads none of them.",
+      "type": "object",
+      "maxProperties": 50,
+      "propertyNames": {
+        "minLength": 1,
+        "maxLength": 200
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/attributeValue"
+      }
+    },
+    "removeAttributes": {
+      "description": "Attribute names this proposal takes away. Deletion is explicit because null is an ordinary value: a producer that means 'unset' says so here.",
+      "type": "array",
+      "maxItems": 50,
+      "items": {
+        "$ref": "#/$defs/localId"
+      }
+    },
+    "revision": {
+      "description": "The revision an authority knows its state by. Opaque: compared by the authority, never interpreted here.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "position": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 1000000
+    },
+    "location": {
+      "description": "Where this item can be found, as a hint for a reader. Never an identity: locations take no part in endpoint resolution, duplicate detection, or what a proposal addresses, and moving the thing does not change what it is.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "uri"
+      ],
+      "properties": {
+        "uri": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "revision": {
+          "$ref": "#/$defs/revision"
+        },
+        "range": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "startLine",
+            "endLine"
+          ],
+          "description": "A zero-based range inside the resource. Ordering is checked after the schema, which cannot conveniently compare two positions.",
+          "properties": {
+            "startLine": {
+              "$ref": "#/$defs/position"
+            },
+            "startCharacter": {
+              "$ref": "#/$defs/position"
+            },
+            "endLine": {
+              "$ref": "#/$defs/position"
+            },
+            "endCharacter": {
+              "$ref": "#/$defs/position"
+            }
+          }
+        }
+      }
+    },
+    "locations": {
+      "type": "array",
+      "maxItems": 10,
+      "items": {
+        "$ref": "#/$defs/location"
+      }
+    },
+    "artifact": {
+      "description": "A related artifact \u2014 an implementation, a report, a piece of evidence \u2014 named rather than carried. The digest is mandatory so an approval refers to stable bytes even when the URI is not: nothing here is retrieved by validation or by rendering.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "rel",
+        "uri",
+        "sha256"
+      ],
+      "properties": {
+        "rel": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "uri": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "mediaType": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "$ref": "#/$defs/artifact"
+      }
+    },
+    "expect": {
+      "description": "What the producer believes is true of this item right now. A declaration for the receiving authority to check immediately before applying, never a claim this application has established.",
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "container": {
+          "$ref": "#/$defs/localId"
+        },
+        "revision": {
+          "$ref": "#/$defs/revision"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        }
+      }
+    },
+    "elementChange": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "container": {
+          "$ref": "#/$defs/localId"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        },
+        "removeAttributes": {
+          "$ref": "#/$defs/removeAttributes"
+        }
+      }
+    },
+    "edgeChange": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        },
+        "removeAttributes": {
+          "$ref": "#/$defs/removeAttributes"
+        }
+      }
+    },
+    "messageChange": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        },
+        "removeAttributes": {
+          "$ref": "#/$defs/removeAttributes"
+        }
+      }
+    },
+    "rowChange": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "cells": {
+          "$ref": "#/$defs/cells"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        },
+        "removeAttributes": {
+          "$ref": "#/$defs/removeAttributes"
+        }
+      }
+    },
+    "container": {
+      "description": "A named group of elements or participants. Grouping only: relationships connect elements and cross container boundaries freely, and a container carries no relationship of its own.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "label"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        }
+      }
+    },
+    "element": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "set": {
+          "$ref": "#/$defs/elementChange"
+        },
+        "container": {
+          "$ref": "#/$defs/localId"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        },
+        "expect": {
+          "$ref": "#/$defs/expect"
+        },
+        "locations": {
+          "$ref": "#/$defs/locations"
+        },
+        "artifacts": {
+          "$ref": "#/$defs/artifacts"
+        }
+      },
+      "if": {
+        "not": {
+          "required": [
+            "ref"
+          ]
+        }
+      },
+      "then": {
+        "required": [
+          "label"
+        ]
+      }
+    },
+    "edge": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "from",
+        "to"
+      ],
+      "properties": {
+        "from": {
+          "$ref": "#/$defs/localId"
+        },
+        "to": {
+          "$ref": "#/$defs/localId"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "set": {
+          "$ref": "#/$defs/edgeChange"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        },
+        "expect": {
+          "$ref": "#/$defs/expect"
+        },
+        "locations": {
+          "$ref": "#/$defs/locations"
+        },
+        "artifacts": {
+          "$ref": "#/$defs/artifacts"
+        }
+      },
+      "if": {
+        "not": {
+          "required": [
+            "ref"
+          ]
+        }
+      },
+      "then": {
+        "required": [
+          "kind"
+        ]
+      }
+    },
+    "message": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "from",
+        "to"
+      ],
+      "properties": {
+        "from": {
+          "$ref": "#/$defs/localId"
+        },
+        "to": {
+          "$ref": "#/$defs/localId"
+        },
+        "ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "set": {
+          "$ref": "#/$defs/messageChange"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        },
+        "expect": {
+          "$ref": "#/$defs/expect"
+        },
+        "locations": {
+          "$ref": "#/$defs/locations"
+        },
+        "artifacts": {
+          "$ref": "#/$defs/artifacts"
+        }
+      },
+      "if": {
+        "not": {
+          "required": [
+            "ref"
+          ]
+        }
+      },
+      "then": {
+        "required": [
+          "label"
+        ]
+      }
+    },
+    "removal": {
+      "description": "Something to take out of the target, named by the reference the authority knows it by. The other fields describe it and never identify it: they exist so a reader can see what they are approving the removal of.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "ref"
+      ],
+      "properties": {
+        "type": {
+          "enum": [
+            "element",
+            "relationship",
+            "row"
+          ]
+        },
+        "ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "from": {
+          "$ref": "#/$defs/localId"
+        },
+        "to": {
+          "$ref": "#/$defs/localId"
+        }
+      }
+    },
+    "cells": {
+      "type": "array",
+      "items": {
+        "type": [
+          "string",
+          "number",
+          "boolean",
+          "null"
+        ],
+        "maxLength": 1000
+      },
+      "maxItems": 50
+    },
+    "role": {
+      "enum": [
+        "added",
+        "changed",
+        "context",
+        "removed"
+      ]
+    },
+    "dataRow": {
+      "description": "A row of the table. It may carry an identity of its own \u2014 a document-local id, the reference its authority knows it by, and the kind of thing it is \u2014 which is what lets a relation point at it and a patch address it.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "cells"
+      ],
+      "properties": {
+        "cells": {
+          "$ref": "#/$defs/cells"
+        },
+        "role": {
+          "$ref": "#/$defs/role"
+        },
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "set": {
+          "$ref": "#/$defs/rowChange"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        },
+        "expect": {
+          "$ref": "#/$defs/expect"
+        },
+        "locations": {
+          "$ref": "#/$defs/locations"
+        },
+        "artifacts": {
+          "$ref": "#/$defs/artifacts"
+        }
+      }
+    },
+    "structuralRow": {
+      "description": "A heading that organises the table \u2014 a chapter, a section \u2014 rather than a row of data. It spans the table and is not aligned to its columns; it is never inferred from a data row whose cells are empty.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "heading"
+      ],
+      "properties": {
+        "heading": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "depth": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 6
+        },
+        "role": {
+          "$ref": "#/$defs/role"
+        },
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "ref": {
+          "$ref": "#/$defs/ref"
+        }
+      }
+    },
+    "endpoint": {
+      "description": "One end of a relation: a row of this document by its local id, or something outside it by the reference its authority knows. Stated explicitly so an unresolvable local endpoint is an error rather than silently reread as external.",
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "maxProperties": 1,
+      "oneOf": [
+        {
+          "required": [
+            "id"
+          ]
+        },
+        {
+          "required": [
+            "ref"
+          ]
+        }
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "ref": {
+          "$ref": "#/$defs/ref"
+        }
+      }
+    },
+    "relation": {
+      "description": "A relation between rows \u2014 traceability. Carries an opaque kind from the profile's vocabulary, exactly as a relationship between graph elements does; unlike one, an end may leave the document, because the test that verifies a requirement usually lives elsewhere.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "from",
+        "to",
+        "kind"
+      ],
+      "properties": {
+        "from": {
+          "$ref": "#/$defs/endpoint"
+        },
+        "to": {
+          "$ref": "#/$defs/endpoint"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "attributes": {
+          "$ref": "#/$defs/attributes"
+        }
+      }
+    },
+    "viewpoint": {
+      "description": "A named reading of a graph: the concern it frames, and the element and relationship kinds that address it. An inclusion \u2014 showing it shows what it retains and hides the rest, so a kind added to the model later is not shown unannounced. A vocabulary it names no kinds for is left whole. The term is ISO/IEC/IEEE 42010's.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "label",
+        "concern"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "label": {
+          "description": "What a reader selects it by.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "concern": {
+          "description": "What this reading is for \u2014 stated inside every figure drawn for it, so a figure taken out of its report still says what it is a reading of.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "elementKinds": {
+          "description": "Element kinds this viewpoint retains. Absent leaves the element vocabulary whole.",
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/kind"
+          }
+        },
+        "relationshipKinds": {
+          "description": "Relationship kinds this viewpoint retains. Absent leaves the relationship vocabulary whole.",
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/kind"
+          }
+        }
+      }
+    },
+    "calendarDate": {
+      "description": "A calendar date, YYYY-MM-DD. A day, not an instant: no time and no zone, so a position derived from it is the same for every reader.",
+      "type": "string",
+      "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$"
+    },
+    "timelineActivity": {
+      "description": "A duration on a task, drawn as a bar from the start of its start day to the end of its end day.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "start",
+        "end"
+      ],
+      "properties": {
+        "type": {
+          "const": "activity"
+        },
+        "start": {
+          "$ref": "#/$defs/calendarDate"
+        },
+        "end": {
+          "$ref": "#/$defs/calendarDate"
+        },
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "previous": {
+          "description": "Where the activity stood in the plan named by comparedTo.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "start",
+            "end"
+          ],
+          "properties": {
+            "start": {
+              "$ref": "#/$defs/calendarDate"
+            },
+            "end": {
+              "$ref": "#/$defs/calendarDate"
+            }
+          }
+        },
+        "role": {
+          "$ref": "#/$defs/timelineChangeRole"
+        }
+      }
+    },
+    "timelineMilestone": {
+      "description": "A point in time on a task, drawn as a star.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "date"
+      ],
+      "properties": {
+        "type": {
+          "const": "milestone"
+        },
+        "date": {
+          "$ref": "#/$defs/calendarDate"
+        },
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        },
+        "previous": {
+          "description": "Where the milestone stood in the plan named by comparedTo.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "date"
+          ],
+          "properties": {
+            "date": {
+              "$ref": "#/$defs/calendarDate"
+            }
+          }
+        },
+        "role": {
+          "$ref": "#/$defs/timelineChangeRole"
+        }
+      }
+    },
+    "timelineTask": {
+      "description": "A semantic row: a named task holding any number of activities and milestones, in any order.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "id",
+        "label",
+        "items"
+      ],
+      "properties": {
+        "type": {
+          "const": "task"
+        },
+        "id": {
+          "$ref": "#/$defs/localId"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "items": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "$ref": "#/$defs/timelineItem"
+          }
+        },
+        "role": {
+          "$ref": "#/$defs/timelineChangeRole"
+        }
+      }
+    },
+    "timelineSeparator": {
+      "description": "A horizontal divider between groups of tasks, with an optional title. Carries no dates and takes no part in the time axis.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "const": "separator"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        }
+      }
+    },
+    "timelineDependency": {
+      "description": "A Gantt dependency: the successor `to` waits on the predecessor `from`. Endpoints name a task or an item by id; a task stands for the span of its items. Without a type it is finish-to-start.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "from",
+        "to"
+      ],
+      "properties": {
+        "from": {
+          "$ref": "#/$defs/localId"
+        },
+        "to": {
+          "$ref": "#/$defs/localId"
+        },
+        "type": {
+          "enum": [
+            "finish-to-start",
+            "start-to-start",
+            "finish-to-finish",
+            "start-to-finish"
+          ]
+        }
+      }
+    },
+    "timelineItem": {
+      "description": "An activity or a milestone, selected by its type so a refusal speaks about the one it is.",
+      "type": "object",
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "enum": [
+            "activity",
+            "milestone"
+          ]
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "activity"
+              }
+            }
+          },
+          "then": {
+            "$ref": "#/$defs/timelineActivity"
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "milestone"
+              }
+            }
+          },
+          "then": {
+            "$ref": "#/$defs/timelineMilestone"
+          }
+        }
+      ]
+    },
+    "timelineRow": {
+      "description": "A task or a separator, selected by its type so a refusal speaks about the one it is.",
+      "type": "object",
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "enum": [
+            "task",
+            "separator"
+          ]
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "task"
+              }
+            }
+          },
+          "then": {
+            "$ref": "#/$defs/timelineTask"
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "separator"
+              }
+            }
+          },
+          "then": {
+            "$ref": "#/$defs/timelineSeparator"
+          }
+        }
+      ]
+    },
+    "timelineChangeRole": {
+      "description": "In a compared timeline: new since the previous plan, or dropped from it and kept so it can be shown.",
+      "enum": [
+        "added",
+        "removed"
+      ]
+    },
+    "timelinePeriod": {
+      "description": "A span of the calendar the plan runs in \u2014 a closure, holidays. Drawn as a band across every row; constrains nothing.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "start",
+        "end"
+      ],
+      "properties": {
+        "start": {
+          "$ref": "#/$defs/calendarDate"
+        },
+        "end": {
+          "$ref": "#/$defs/calendarDate"
+        },
+        "label": {
+          "$ref": "#/$defs/label"
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        }
+      }
+    },
+    "timelineReference": {
+      "description": "A named day the plan is judged against \u2014 a contractual date, a delivery. Drawn as a line across every row.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "date",
+        "label"
+      ],
+      "properties": {
+        "date": {
+          "$ref": "#/$defs/calendarDate"
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "kind": {
+          "$ref": "#/$defs/kind"
+        }
+      }
+    }
+  },
+  "properties": {
+    "schema": {
+      "const": "urn:structured-exchange:3"
+    },
+    "kind": {
+      "enum": [
+        "graph",
+        "sequence",
+        "table",
+        "timeline"
+      ]
+    },
+    "profile": {
+      "description": "The vocabulary that owns the kinds and attribute names in this document. Opaque: never fetched, executed, or required to be known \u2014 an unknown profile is presented generically, not refused.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "target": {
+      "description": "The artifact this document proposes a change to, and the revision it was prepared against. Its presence is what makes the document a proposal.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ref"
+      ],
+      "properties": {
+        "ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "revision": {
+          "$ref": "#/$defs/revision"
+        }
+      }
+    },
+    "removals": {
+      "type": "array",
+      "maxItems": 500,
+      "items": {
+        "$ref": "#/$defs/removal"
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "maxItems": 50,
+      "items": {
+        "$ref": "#/$defs/artifact"
+      }
+    },
+    "viewpoints": {
+      "description": "Named readings of this document. Only a graph may declare them. Presentation only: selecting one never alters the document.",
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "$ref": "#/$defs/viewpoint"
+      }
+    },
+    "data": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "nodes",
+            "edges"
+          ],
+          "properties": {
+            "nodes": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 500,
+              "items": {
+                "$ref": "#/$defs/element"
+              }
+            },
+            "edges": {
+              "type": "array",
+              "maxItems": 2000,
+              "items": {
+                "$ref": "#/$defs/edge"
+              }
+            },
+            "containers": {
+              "type": "array",
+              "maxItems": 50,
+              "items": {
+                "$ref": "#/$defs/container"
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "participants",
+            "messages"
+          ],
+          "properties": {
+            "participants": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 100,
+              "items": {
+                "$ref": "#/$defs/element"
+              }
+            },
+            "messages": {
+              "type": "array",
+              "maxItems": 1000,
+              "items": {
+                "$ref": "#/$defs/message"
+              }
+            },
+            "containers": {
+              "type": "array",
+              "maxItems": 50,
+              "items": {
+                "$ref": "#/$defs/container"
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "columns",
+            "rows"
+          ],
+          "properties": {
+            "columns": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 50,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "rows": {
+              "type": "array",
+              "maxItems": 5000,
+              "items": {
+                "oneOf": [
+                  {
+                    "$ref": "#/$defs/cells"
+                  },
+                  {
+                    "$ref": "#/$defs/dataRow"
+                  },
+                  {
+                    "$ref": "#/$defs/structuralRow"
+                  }
+                ]
+              }
+            },
+            "relations": {
+              "type": "array",
+              "maxItems": 2000,
+              "items": {
+                "$ref": "#/$defs/relation"
+              }
+            }
+          }
+        },
+        {
+          "description": "A planning timeline: a calendar range and an ordered list of rows. Never coordinates, colours or a current date \u2014 the renderer derives those.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "time",
+            "rows"
+          ],
+          "properties": {
+            "title": {
+              "$ref": "#/$defs/label"
+            },
+            "time": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "start",
+                "end",
+                "scale"
+              ],
+              "properties": {
+                "start": {
+                  "$ref": "#/$defs/calendarDate"
+                },
+                "end": {
+                  "$ref": "#/$defs/calendarDate"
+                },
+                "scale": {
+                  "enum": [
+                    "week",
+                    "month",
+                    "quarter"
+                  ]
+                }
+              }
+            },
+            "rows": {
+              "type": "array",
+              "maxItems": 500,
+              "items": {
+                "$ref": "#/$defs/timelineRow"
+              }
+            },
+            "dependencies": {
+              "type": "array",
+              "maxItems": 2000,
+              "items": {
+                "$ref": "#/$defs/timelineDependency"
+              }
+            },
+            "comparedTo": {
+              "description": "The plan this timeline is compared with. Its presence makes the timeline a comparison: items may then carry previous dates and roles.",
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "label"
+              ],
+              "properties": {
+                "label": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 500
+                },
+                "date": {
+                  "$ref": "#/$defs/calendarDate"
+                }
+              }
+            },
+            "periods": {
+              "type": "array",
+              "maxItems": 100,
+              "items": {
+                "$ref": "#/$defs/timelinePeriod"
+              }
+            },
+            "references": {
+              "type": "array",
+              "maxItems": 50,
+              "items": {
+                "$ref": "#/$defs/timelineReference"
+              }
+            }
+          }
+        }
+      ]
+    }
+  }
+}