@openplanr/protocol 0.2.0

package/schemas/v1.12.0/enterprise-review-thread.schema.json

@@ -0,0 +1,278 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.12.0/enterprise-review-thread.schema.json",
+  "x-openplanr-contract": {
+    "id": "enterprise-review-thread",
+    "version": "1.12.0"
+  },
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "openplanr-enterprise-review-thread"
+    },
+    "schemaVersion": {
+      "const": "1.0.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "organizationId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "projectId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "artifactId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "anchor": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "revisionId": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+        },
+        "elementId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^[^\\s\\u0000-\\u001f\\u007f]+$"
+        },
+        "screenId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^[^\\s\\u0000-\\u001f\\u007f]+$"
+        },
+        "frameId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^[^\\s\\u0000-\\u001f\\u007f]+$"
+        },
+        "x": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "y": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      },
+      "required": [
+        "revisionId"
+      ],
+      "anyOf": [
+        {
+          "required": [
+            "elementId"
+          ]
+        },
+        {
+          "required": [
+            "screenId",
+            "frameId"
+          ]
+        },
+        {
+          "required": [
+            "x",
+            "y"
+          ]
+        }
+      ],
+      "allOf": [
+        {
+          "if": {
+            "required": [
+              "x"
+            ]
+          },
+          "then": {
+            "required": [
+              "y"
+            ]
+          }
+        },
+        {
+          "if": {
+            "required": [
+              "y"
+            ]
+          },
+          "then": {
+            "required": [
+              "x"
+            ]
+          }
+        },
+        {
+          "if": {
+            "required": [
+              "frameId"
+            ]
+          },
+          "then": {
+            "required": [
+              "screenId"
+            ]
+          }
+        }
+      ]
+    },
+    "category": {
+      "enum": [
+        "question",
+        "suggestion",
+        "change-request",
+        "blocker"
+      ]
+    },
+    "status": {
+      "enum": [
+        "open",
+        "addressed",
+        "resolved"
+      ]
+    },
+    "authorId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "body": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 16384
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+    },
+    "replies": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+          },
+          "authorId": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+          },
+          "body": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 16384
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+          }
+        },
+        "required": [
+          "id",
+          "authorId",
+          "body",
+          "createdAt"
+        ]
+      },
+      "maxItems": 10000
+    },
+    "assigneeId": {
+      "anyOf": [
+        {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "addressedRevisionId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "resolvedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+    }
+  },
+  "required": [
+    "kind",
+    "schemaVersion",
+    "id",
+    "organizationId",
+    "projectId",
+    "artifactId",
+    "anchor",
+    "category",
+    "status",
+    "authorId",
+    "body",
+    "createdAt",
+    "updatedAt",
+    "replies"
+  ],
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "addressed"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "addressedRevisionId"
+        ],
+        "not": {
+          "required": [
+            "resolvedAt"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "resolved"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "resolvedAt"
+        ]
+      },
+      "else": {
+        "not": {
+          "required": [
+            "resolvedAt"
+          ]
+        }
+      }
+    }
+  ]
+}

package/schemas/v1.12.0/enterprise-sync-state.schema.json

@@ -0,0 +1,169 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.12.0/enterprise-sync-state.schema.json",
+  "x-openplanr-contract": {
+    "id": "enterprise-sync-state",
+    "version": "1.12.0"
+  },
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "kind": {
+      "const": "openplanr-enterprise-sync-state"
+    },
+    "schemaVersion": {
+      "const": "1.0.0"
+    },
+    "organizationId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "projectId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "repositoryId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "direction": {
+      "enum": [
+        "push",
+        "pull"
+      ]
+    },
+    "status": {
+      "enum": [
+        "preview",
+        "pending",
+        "synchronized",
+        "failed",
+        "conflicted"
+      ]
+    },
+    "scope": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+      },
+      "maxItems": 10000,
+      "uniqueItems": true
+    },
+    "cursor": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "maxLength": 2048
+    },
+    "operationId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "artifactId": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+          },
+          "baseRevisionId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "revisionId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "contentDigest": {
+            "type": "string",
+            "minLength": 64,
+            "maxLength": 64,
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "action": {
+            "enum": [
+              "create",
+              "update",
+              "unchanged",
+              "conflict"
+            ]
+          }
+        },
+        "required": [
+          "artifactId",
+          "baseRevisionId",
+          "revisionId",
+          "contentDigest",
+          "action"
+        ]
+      },
+      "maxItems": 10000
+    },
+    "issues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+          },
+          "artifactId": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}(?![\\s\\S])"
+          },
+          "message": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 16384
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ]
+      },
+      "maxItems": 1000
+    }
+  },
+  "required": [
+    "kind",
+    "schemaVersion",
+    "organizationId",
+    "projectId",
+    "repositoryId",
+    "direction",
+    "status",
+    "scope",
+    "cursor",
+    "operationId",
+    "updatedAt",
+    "items",
+    "issues"
+  ]
+}

package/schemas/v1.2.0/adapter-registry.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.2.0/adapter-registry.schema.json",
+  "title": "OpenPlanr Protocol v1.2 runtime adapter registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "pipelineVersion", "adapters"],
+  "properties": {
+    "kind": { "const": "adapter-registry" },
+    "schemaVersion": { "const": "1.1.0" },
+    "protocolVersion": { "const": "1.2.0" },
+    "pipelineVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "adapters": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "version", "capabilityLevel", "installScopes", "entrypoints", "capabilities", "assets", "healthChecks", "drivers"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$" },
+          "capabilityLevel": { "type": "string", "enum": ["artifact", "workflow", "product"] },
+          "installScopes": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "type": "string", "enum": ["user", "project"] }
+          },
+          "entrypoints": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["plan", "ship", "artifact", "operate"],
+            "properties": {
+              "plan": { "type": "string", "minLength": 1 },
+              "design": { "type": "string", "minLength": 1 },
+              "ship": { "type": "string", "minLength": 1 },
+              "dashboard": { "type": "string", "minLength": 1 },
+              "artifact": { "type": "string", "minLength": 1 },
+              "operate": { "type": "string", "minLength": 1 },
+              "sync": { "type": "string", "minLength": 1 },
+              "doctor": { "type": "string", "minLength": 1 }
+            }
+          },
+          "capabilities": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["subagents", "hooks", "toolIsolation", "parallelDispatch", "parallelDispatchMode", "headlessBridge", "artifactReview", "operatingBoard", "operatingAdvisorDispatch", "interactiveQuestions"],
+            "properties": {
+              "subagents": { "type": "string", "enum": ["native", "advisory", "sequential", "dynamic"] },
+              "hooks": { "type": "boolean" },
+              "toolIsolation": { "type": "string", "enum": ["enforced", "advisory", "none"] },
+              "parallelDispatch": { "type": "boolean" },
+              "parallelDispatchMode": { "type": "string", "enum": ["native", "host", "sequential", "dynamic"] },
+              "headlessBridge": { "type": "boolean" },
+              "artifactReview": { "type": "boolean" },
+              "operatingBoard": { "type": "boolean" },
+              "operatingAdvisorDispatch": {
+                "type": "string",
+                "enum": ["native-isolated", "native-bounded", "structured-provider"]
+              },
+              "interactiveQuestions": { "type": "string", "enum": ["native", "chat", "terminal", "none"] }
+            }
+          },
+          "assets": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+          "healthChecks": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+          "drivers": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["install", "migrate", "rollback", "uninstall"],
+            "properties": {
+              "install": { "type": "string", "minLength": 1 },
+              "migrate": { "type": "string", "minLength": 1 },
+              "rollback": { "type": "string", "minLength": 1 },
+              "uninstall": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    }
+  }
+}